tests: add PHPStan type tests

Author: JaZo

composer.json

@@ -18,6 +18,7 @@
         "guzzlehttp/guzzle": "^7.3",
         "laravel/pint": "^1.5",
         "php-http/mock-client": "^1.2",
+        "phpstan/phpstan": "^2.1",
         "phpunit/phpunit": "^9.5"
     },
     "suggest": {

phpstan.types.neon.dist

@@ -0,0 +1,5 @@
+parameters:
+  level: max
+  paths:
+    - tests\_mocks
+    - types

types/Item.php

@@ -0,0 +1,13 @@
+<?php
+
+use Swis\JsonApi\Client\Tests\Mocks\Items\ParentItem;
+
+use function PHPStan\Testing\assertType;
+
+$item = new ParentItem;
+
+assertType('Swis\JsonApi\Client\Tests\Mocks\Items\ChildItem|null', $item->child()->getData());
+assertType('Swis\JsonApi\Client\Collection<(int|string), Swis\JsonApi\Client\Tests\Mocks\Items\ChildItem>|null', $item->children()->getData());
+
+assertType('Swis\JsonApi\Client\Interfaces\ItemInterface|null', $item->morph()->getData());
+assertType('Swis\JsonApi\Client\Collection<(int|string), Swis\JsonApi\Client\Interfaces\ItemInterface>|null', $item->morphmany()->getData());

types/Repository.php

@@ -0,0 +1,14 @@
+<?php
+
+use Swis\JsonApi\Client\DocumentClient;
+use Swis\JsonApi\Client\DocumentFactory;
+use Swis\JsonApi\Client\Tests\Mocks\Items\ChildItem;
+use Swis\JsonApi\Client\Tests\Mocks\MockRepository;
+
+use function PHPStan\Testing\assertType;
+
+$repository = new MockRepository(DocumentClient::create(), new DocumentFactory);
+
+assertType('Swis\JsonApi\Client\Interfaces\CollectionDocumentInterface<Swis\JsonApi\Client\Tests\Mocks\Items\ChildItem>', $repository->all());
+assertType('Swis\JsonApi\Client\Interfaces\ItemDocumentInterface<Swis\JsonApi\Client\Tests\Mocks\Items\ChildItem>', $repository->find('foo'));
+assertType('Swis\JsonApi\Client\Interfaces\ItemDocumentInterface<Swis\JsonApi\Client\Tests\Mocks\Items\ChildItem>', $repository->save(new ChildItem));