Add new optional beta email parser thats based on ImapEngine instead of Webklex

plugins/vendor/directorytree/imapengine/src/Collections/PaginatedCollection.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace DirectoryTree\ImapEngine\Collections;
+
+use DirectoryTree\ImapEngine\Pagination\LengthAwarePaginator;
+use Illuminate\Support\Collection;
+
+/**
+ * @template TKey of array-key
+ * @template TValue
+ *
+ * @template-extends Collection<TKey, TValue>
+ */
+class PaginatedCollection extends Collection
+{
+    /**
+     * The total number of items.
+     */
+    protected int $total = 0;
+
+    /**
+     * Paginate the current collection.
+     *
+     * @return LengthAwarePaginator<TKey, TValue>
+     */
+    public function paginate(int $perPage = 15, ?int $page = null, string $pageName = 'page', bool $prepaginated = false): LengthAwarePaginator
+    {
+        $total = $this->total ?: $this->count();
+
+        $results = ! $prepaginated && $total ? $this->forPage($page, $perPage) : $this;
+
+        return $this->paginator($results, $total, $perPage, $page, $pageName);
+    }
+
+    /**
+     * Create a new length-aware paginator instance.
+     *
+     * @return LengthAwarePaginator<TKey, TValue>
+     */
+    protected function paginator(Collection $items, int $total, int $perPage, ?int $currentPage, string $pageName): LengthAwarePaginator
+    {
+        return new LengthAwarePaginator($items, $total, $perPage, $currentPage, $pageName);
+    }
+
+    /**
+     * Get or set the total amount.
+     */
+    public function total(?int $total = null): ?int
+    {
+        if (is_null($total)) {
+            return $this->total;
+        }
+
+        return $this->total = $total;
+    }
+}