add prototypical search-endpoint, allow general EntityCollections

implement collectChildren of EntityCollection as general method for collecting diverse entities at the same time (needed for search).
currently implemented for object-types 'page' and 'database'.

Author: johguentner

src/Endpoints/Search.php

@@ -2,10 +2,75 @@
 
 namespace FiveamCode\LaravelNotionApi\Endpoints;
 
+use FiveamCode\LaravelNotionApi\Entities\Collections\EntityCollection;
+use FiveamCode\LaravelNotionApi\Entities\Collections\PageCollection;
+use Illuminate\Support\Collection;
 use FiveamCode\LaravelNotionApi\Notion;
+use FiveamCode\LaravelNotionApi\Query\Filter;
+use FiveamCode\LaravelNotionApi\Query\Sorting;
+use FiveamCode\LaravelNotionApi\Query\StartCursor;
+use FiveamCode\LaravelNotionApi\Exceptions\WrapperException;
+use Symfony\Component\VarDumper\Cloner\Data;
 
 class Search extends Endpoint
 {
+    private string $searchText;
+    private Collection $filter;
+    private Collection $sorts;
 
-    // toDo: Think about it. 🧐
-}
+
+    public function __construct(Notion $notion, string $searchText = "")
+    {
+        $this->sorts = new Collection();
+        $this->filter = new Collection();
+        $this->searchText = $searchText;
+
+        parent::__construct($notion);
+    }
+
+    public function query(): Collection
+    {
+        $postData = [];
+
+        // if ($this->sorts->isNotEmpty())
+        //     $postData["sort"] = Sorting::sortQuery($this->sorts);
+
+        // if ($this->filter->isNotEmpty())
+        //     $postData["filter"]["or"] = Filter::filterQuery($this->filter); // TODO Compound filters!
+
+        if ($this->startCursor !== null)
+            $postData["start_cursor"] = $this->startCursor;
+
+        if ($this->pageSize !== null)
+            $postData["page_size"] = $this->pageSize;
+
+        if($this->searchText !== null)
+            $postData['query'] = $this->searchText;
+
+
+
+        $response = $this
+            ->post(
+                $this->url(Endpoint::SEARCH),
+                $postData
+            )
+
+            ->json();
+
+        $pageCollection = new EntityCollection($response);
+
+        return $pageCollection->getResults();
+    }
+
+    // public function filterBy(Collection $filter)
+    // {
+    //     $this->filter = $filter;
+    //     return $this;
+    // }
+
+    // public function sortBy(Collection $sorts)
+    // {
+    //     $this->sorts = $sorts;
+    //     return $this;
+    // }
+}

src/Entities/Collections/EntityCollection.php

@@ -2,14 +2,16 @@
 
 namespace FiveamCode\LaravelNotionApi\Entities\Collections;
 
+use FiveamCode\LaravelNotionApi\Entities\Database;
+use FiveamCode\LaravelNotionApi\Entities\Entity;
+use FiveamCode\LaravelNotionApi\Entities\Page;
 use FiveamCode\LaravelNotionApi\Exceptions\WrapperException;
 use FiveamCode\LaravelNotionApi\Notion;
 use Illuminate\Support\Arr;
 use Illuminate\Support\Collection;
 
 
-//TODO:WORK IN PROGRESS
-abstract class EntityCollection
+class EntityCollection
 {
     protected array $responseData = [];
     protected array $rawResults = [];
@@ -20,8 +22,6 @@ public function __construct(array $reponseData = null)
         $this->setResponseData($reponseData);
     }
 
-    protected abstract function collectChildren();
-
     protected function setResponseData(array $reponseData): void
     {
         if (!Arr::exists($reponseData, 'object')) throw WrapperException::instance("invalid json-array: no object given");
@@ -33,6 +33,17 @@ protected function setResponseData(array $reponseData): void
         $this->collectChildren();
     }
 
+    protected function collectChildren(): void
+    {
+        $this->collection = new Collection();
+        foreach ($this->rawResults as $pageChild) {
+            if (Arr::exists($pageChild, 'object')) {
+                if($pageChild['object'] == 'page') $this->collection->add(new Page($pageChild));
+                if($pageChild['object'] == 'database') $this->collection->add(new Database($pageChild));
+            }
+        }
+    }
+
     protected function fillFromRaw()
     {
         $this->fillResult();

src/Notion.php

@@ -134,9 +134,10 @@ public function users(): Users
     /**
      * @return Search
      */
-    public function search(): Search
+    public function search(?string $searchText = ""): Search
     {
-        return new Search($this);
+        $search = new Search($this, $searchText);
+        return $search;
     }
 
     /**