polish page and properties

- add parent information to page
- check end-date of Date property for null
- add "asText" method to Text and Title property

Author: johguentner

src/Entities/Page.php

@@ -18,6 +18,7 @@
 use FiveamCode\LaravelNotionApi\Entities\Properties\Url;
 use FiveamCode\LaravelNotionApi\Exceptions\HandlingException;
 use Illuminate\Support\Arr;
+use Illuminate\Support\Str;
 use Illuminate\Support\Collection;
 
 /**
@@ -55,6 +56,16 @@ class Page extends Entity
      */
     private string $coverType = '';
 
+    /**
+     * @var string
+     */
+    private string $parentId = '';
+
+    /**
+     * @var string
+     */
+    private string $parentType = '';
+
     /**
      * @var string
      */
@@ -122,6 +133,7 @@ protected function setResponseData(array $responseData): void
     private function fillFromRaw(): void
     {
         $this->fillId();
+        $this->fillParent();
         $this->fillObjectType();
         $this->fillProperties();
         $this->fillTitle(); // This has to be called after fillProperties(), since title is provided by properties
@@ -205,6 +217,20 @@ private function fillPageUrl(): void
         }
     }
 
+    private function fillParent(): void
+    {
+        if (Arr::exists($this->responseData, 'parent')) {
+            $this->parentType = $this->responseData['parent']['type'];
+            if (Arr::exists($this->responseData['parent'], 'database_id')) {
+                $this->parentId = $this->responseData['parent']['database_id'];
+            } elseif (Arr::exists($this->responseData['parent'], 'page_id')) {
+                $this->parentId = $this->responseData['parent']['page_id'];
+            } elseif (Arr::exists($this->responseData['parent'], 'workspace')) {
+                $this->parentId = $this->responseData['parent']['workspace'];
+            }
+        }
+    }
+
     /**
      * @param $propertyTitle
      * @param $property
@@ -443,7 +469,7 @@ public function getProperties(): Collection
      */
     public function getProperty(string $propertyKey): ?Property
     {
-        if (! isset($this->propertyMap[$propertyKey])) {
+        if (!isset($this->propertyMap[$propertyKey])) {
             return null;
         }
 
@@ -458,6 +484,22 @@ public function getObjectType(): string
         return $this->objectType;
     }
 
+    /**
+     * @return string
+     */
+    public function getParentId(): string
+    {
+        return $this->parentId;
+    }
+
+    /**
+     * @return string
+     */
+    public function getParentType(): string
+    {
+        return $this->parentType;
+    }
+
     /**
      * @return array
      */

src/Entities/Properties/Date.php

@@ -97,7 +97,7 @@ protected function fillDate(): void
             $richDate->setHasTime($this->isIsoTimeString($startAsIsoString));
         }
 
-        if (Arr::exists($this->rawContent, 'end')) {
+        if (Arr::exists($this->rawContent, 'end') && $this->rawContent['end'] !== null) {
             $endAsIsoString = $this->rawContent['end'];
             $richDate->setEnd(new DateTime($endAsIsoString));
         }

src/Entities/Properties/Text.php

@@ -56,7 +56,7 @@ public static function value($text): Text
     protected function fillFromRaw(): void
     {
         parent::fillFromRaw();
-        if (! is_array($this->rawContent)) {
+        if (!is_array($this->rawContent)) {
             throw HandlingException::instance('The property-type is text, however the raw data-structure does not represent this type (= array of items). Please check the raw response-data.');
         }
 
@@ -77,6 +77,14 @@ public function getContent(): RichText
         return $this->getRichText();
     }
 
+    /**
+     * @return string
+     */
+    public function asText(): string
+    {
+        return $this->getPlainText();
+    }
+
     /**
      * @return RichText
      */

src/Entities/Properties/Title.php

@@ -76,6 +76,14 @@ public function getContent(): RichText
         return $this->getRichText();
     }
 
+    /**
+     * @return string
+     */
+    public function asText(): string
+    {
+        return $this->getPlainText();
+    }
+
     /**
      * @return RichText
      */