full implementation for block creation + tests

- implemented static creation-function for all modifiable blocks
- implemented append-function to Block-Endpoint
- implemented tests-function, in which all block-creation-functions are tested
- added todo/warning for notion-version-change to test-function

Author: johguentner

src/Endpoints/Block.php

@@ -6,6 +6,7 @@
 use FiveamCode\LaravelNotionApi\Exceptions\NotionException;
 use FiveamCode\LaravelNotionApi\Exceptions\HandlingException;
 use FiveamCode\LaravelNotionApi\Entities\Collections\BlockCollection;
+use FiveamCode\LaravelNotionApi\Entities\Blocks\Block as BaseBlockEntity;
 
 /**
  * Class Block
@@ -33,7 +34,7 @@ public function __construct(Notion $notion, string $blockId)
 
     /**
      * Retrieve block children
-     * url: https://api.notion.com/{version}/blocks/{block_id}/children
+     * url: https://api.notion.com/{version}/blocks/{block_id}/children [get]
      * notion-api-docs: https://developers.notion.com/reference/get-block-children
      *
      * @return BlockCollection
@@ -50,11 +51,37 @@ public function children(): BlockCollection
     }
 
     /**
-     * @return array
+     * Append one Block or an array of Blocks
+     * url: https://api.notion.com/{version}/blocks/{block_id}/children [patch]
+     * notion-api-docs: https://developers.notion.com/reference/patch-block-children
+     *
+     * @return FiveamCode\LaravelNotionApi\Entities\Blocks\Block
      * @throws HandlingException
      */
-    public function create(): array
+    public function append(array|BaseBlockEntity $appendices): BaseBlockEntity
     {
-        throw new HandlingException('Not implemented');
+        if (!is_array($appendices)) {
+            $appendices = [$appendices];
+        }
+        $children = [];
+
+        foreach ($appendices as $block) {
+            array_push($children, [
+                "object" => "block",
+                "type" => $block->getType(),
+                $block->getType() => $block->getRawContent()
+            ]);
+        }
+
+        $body = [
+            "children" => $children
+        ];
+
+        $response = $this->patch(
+            $this->url(Endpoint::BLOCKS . '/' . $this->blockId . '/children' . ""),
+            $body
+        );
+
+        return new BaseBlockEntity($response->json());
     }
 }

src/Entities/Blocks/Block.php

@@ -161,6 +161,10 @@ public function asText() : string
         return $this->text;
     }
 
+    public function setContent($content){
+        $this->content = $content;
+    }
+
     /**
      * @param $rawContent
      * @return Block
@@ -173,6 +177,7 @@ public static function fromResponse($rawContent): Block
         return $block;
     }
 
+
     /**
      * Maps the type of a block to the corresponding package class by converting the type name.
      *

src/Entities/Blocks/BulletedListItem.php

@@ -13,4 +13,15 @@
  */
 class BulletedListItem extends TextBlock
 {
+    public static function create(array|string $textContent): BulletedListItem
+    {
+        $bulletedListItem = new BulletedListItem();    
+        TextBlock::createTextBlock($bulletedListItem, $textContent);
+        return $bulletedListItem;
+    }
+
+    function __construct(array $responseData = null){
+        $this->type = "bulleted_list_item";
+        parent::__construct($responseData);
+    }
 }

src/Entities/Blocks/HeadingOne.php

@@ -13,4 +13,15 @@
  */
 class HeadingOne extends TextBlock
 {
+    public static function create(array|string $textContent): HeadingOne
+    {
+        $headingOne = new HeadingOne();    
+        TextBlock::createTextBlock($headingOne, $textContent);
+        return $headingOne;
+    }
+
+    function __construct(array $responseData = null){
+        $this->type = "heading_1";
+        parent::__construct($responseData);
+    }
 }

src/Entities/Blocks/HeadingThree.php

@@ -13,4 +13,15 @@
  */
 class HeadingThree extends TextBlock
 {
+    public static function create(array|string $textContent): HeadingThree
+    {
+        $headingThree = new HeadingThree();    
+        HeadingThree::createTextBlock($headingThree, $textContent);
+        return $headingThree;
+    }
+
+    function __construct(array $responseData = null){
+        $this->type = "heading_3";
+        parent::__construct($responseData);
+    }
 }

src/Entities/Blocks/HeadingTwo.php

@@ -13,4 +13,15 @@
  */
 class HeadingTwo extends TextBlock
 {
+    public static function create(array|string $textContent): HeadingTwo
+    {
+        $headingTwo = new HeadingTwo();    
+        HeadingTwo::createTextBlock($headingTwo, $textContent);
+        return $headingTwo;
+    }
+
+    function __construct(array $responseData = null){
+        $this->type = "heading_2";
+        parent::__construct($responseData);
+    }
 }

src/Entities/Blocks/NumberedListItem.php

@@ -13,4 +13,15 @@
  */
 class NumberedListItem extends TextBlock
 {
+    public static function create(array|string $textContent): NumberedListItem
+    {
+        $numberedListItem = new NumberedListItem();    
+        TextBlock::createTextBlock($numberedListItem, $textContent);
+        return $numberedListItem;
+    }
+
+    function __construct(array $responseData = null){
+        $this->type = "numbered_list_item";
+        parent::__construct($responseData);
+    }
 }

src/Entities/Blocks/Paragraph.php

@@ -14,4 +14,15 @@
  */
 class Paragraph extends TextBlock
 {
+    public static function create(array|string $textContent): Paragraph
+    {
+        $paragraph = new Paragraph();    
+        TextBlock::createTextBlock($paragraph, $textContent);
+        return $paragraph;
+    }
+
+    function __construct(array $responseData = null){
+        $this->type = "paragraph";
+        parent::__construct($responseData);
+    }
 }

src/Entities/Blocks/TextBlock.php

@@ -3,6 +3,7 @@
 namespace FiveamCode\LaravelNotionApi\Entities\Blocks;
 
 use DateTime;
+use FiveamCode\LaravelNotionApi\Entities\Contracts\Modifiable;
 use Illuminate\Support\Arr;
 use FiveamCode\LaravelNotionApi\Entities\Entity;
 use FiveamCode\LaravelNotionApi\Entities\PropertyItems\RichText;
@@ -12,8 +13,31 @@
  * Class TextBlock
  * @package FiveamCode\LaravelNotionApi\Entities\Blocks
  */
-class TextBlock extends Block
+class TextBlock extends Block implements Modifiable
 {
+    protected static function createTextBlock(TextBlock $textBlock, array|string $textContent): TextBlock
+    {
+        if (is_string($textContent)) {
+            $textContent = [$textContent];
+        }
+
+        $text = [];
+        foreach ($textContent as $textItem) {
+            array_push($text, [
+                "type" => "text",
+                "text" => [
+                    "content" => $textItem
+                ]
+            ]);
+        }
+        
+        $textBlock->rawContent = [
+            "text" => $text
+        ];
+
+        return $textBlock;
+    }
+
     /**
      * 
      */

src/Entities/Blocks/ToDo.php

@@ -13,4 +13,15 @@
  */
 class ToDo extends TextBlock
 {
+    public static function create(array|string $textContent): ToDo
+    {
+        $toDo = new ToDo();    
+        TextBlock::createTextBlock($toDo, $textContent);
+        return $toDo;
+    }
+
+    function __construct(array $responseData = null){
+        $this->type = "to_do";
+        parent::__construct($responseData);
+    }
 }