Merge pull request #58 from 5am-code/dev

Dev to Master: v0.6.2

Author: mechelon

.github/workflows/main.yml

@@ -10,7 +10,9 @@ jobs:
       fail-fast: false
       matrix:
         php:
+          - '8.1'
           - '8.0'
+          - '7.4'
         laravel:
           - '8.*'
         testbench:

src/Endpoints/Block.php

@@ -81,8 +81,12 @@ public function children(): BlockCollection
      *
      * @throws HandlingException
      */
-    public function append(array|BlockEntity $appendices): BlockEntity
+    public function append($appendices): BlockEntity
     {
+        if (! is_array($appendices) && ! $appendices instanceof BlockEntity) {
+            throw new HandlingException('$appendices must be an array or instance of BlockEntity');
+        }
+
         if (! is_array($appendices)) {
             $appendices = [$appendices];
         }

src/Entities/Blocks/Block.php

@@ -212,4 +212,11 @@ private static function mapTypeToClass(string $type): string
                 return Block::class;
         }
     }
+
+    protected static function assertValidTextContent($textContent)
+    {
+        if (! is_array($textContent) && ! is_string($textContent)) {
+            throw new HandlingException('$textContent content must be a string or an array.');
+        }
+    }
 }

src/Entities/Blocks/BulletedListItem.php

@@ -7,8 +7,10 @@
  */
 class BulletedListItem extends TextBlock
 {
-    public static function create(array|string $textContent): BulletedListItem
+    public static function create($textContent): BulletedListItem
     {
+        self::assertValidTextContent($textContent);
+
         $bulletedListItem = new BulletedListItem();
         TextBlock::createTextBlock($bulletedListItem, $textContent);
 

src/Entities/Blocks/HeadingOne.php

@@ -7,8 +7,10 @@
  */
 class HeadingOne extends TextBlock
 {
-    public static function create(array|string $textContent): HeadingOne
+    public static function create($textContent): HeadingOne
     {
+        self::assertValidTextContent($textContent);
+
         $headingOne = new HeadingOne();
         TextBlock::createTextBlock($headingOne, $textContent);
 

src/Entities/Blocks/HeadingThree.php

@@ -7,8 +7,10 @@
  */
 class HeadingThree extends TextBlock
 {
-    public static function create(array|string $textContent): HeadingThree
+    public static function create($textContent): HeadingThree
     {
+        self::assertValidTextContent($textContent);
+
         $headingThree = new HeadingThree();
         HeadingThree::createTextBlock($headingThree, $textContent);
 

src/Entities/Blocks/HeadingTwo.php

@@ -7,8 +7,10 @@
  */
 class HeadingTwo extends TextBlock
 {
-    public static function create(array|string $textContent): HeadingTwo
+    public static function create($textContent): HeadingTwo
     {
+        self::assertValidTextContent($textContent);
+
         $headingTwo = new HeadingTwo();
         HeadingTwo::createTextBlock($headingTwo, $textContent);
 

src/Entities/Blocks/NumberedListItem.php

@@ -7,8 +7,10 @@
  */
 class NumberedListItem extends TextBlock
 {
-    public static function create(array|string $textContent): NumberedListItem
+    public static function create($textContent): NumberedListItem
     {
+        self::assertValidTextContent($textContent);
+
         $numberedListItem = new NumberedListItem();
         TextBlock::createTextBlock($numberedListItem, $textContent);
 

src/Entities/Blocks/Paragraph.php

@@ -7,8 +7,10 @@
  */
 class Paragraph extends TextBlock
 {
-    public static function create(array|string $textContent): Paragraph
+    public static function create($textContent): Paragraph
     {
+        self::assertValidTextContent($textContent);
+
         $paragraph = new Paragraph();
         TextBlock::createTextBlock($paragraph, $textContent);
 

src/Entities/Blocks/TextBlock.php

@@ -10,8 +10,10 @@
  */
 class TextBlock extends Block implements Modifiable
 {
-    protected static function createTextBlock(TextBlock $textBlock, array|string $textContent): TextBlock
+    protected static function createTextBlock(TextBlock $textBlock, $textContent): TextBlock
     {
+        self::assertValidTextContent($textContent);
+
         if (is_string($textContent)) {
             $textContent = [$textContent];
         }