fix: phpstan & init phpunit

Author: Ark4ne

.github/workflows/php.yml

@@ -43,11 +43,11 @@ jobs:
     - name: Install dependencies
       run: composer require laravel/framework ${{ matrix.laravel_version }} --prefer-dist --no-progress
 
-    - name: PHPUnit
-      run: vendor/bin/phpunit --coverage-clover coverage.xml --configuration phpunit.php${{ matrix.php_version }}.xml.dist
-
     - name: PHPStan
       run: vendor/bin/phpstan analyze
 
+    - name: PHPUnit
+      run: vendor/bin/phpunit --coverage-clover coverage.xml --configuration phpunit.php${{ matrix.php_version }}.xml.dist
+
     - name: Coverage
       run: bash <(curl -s https://codecov.io/bash)

phpunit.php8.4.xml.dist

@@ -0,0 +1,26 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         executionOrder="depends,defects"
+         failOnRisky="true"
+         failOnWarning="true"
+>
+  <testsuites>
+    <testsuite name="Unit">
+      <directory>tests/Unit</directory>
+    </testsuite>
+    <testsuite name="Feature">
+      <directory>tests/Feature</directory>
+    </testsuite>
+  </testsuites>
+  <php>
+    <env name="DB_CONNECTION" value="sqlite"/>
+    <env name="DB_DATABASE" value=":memory:"/>
+  </php>
+  <source>
+    <include>
+      <directory suffix=".php">src</directory>
+    </include>
+  </source>
+</phpunit>

src/Asserts/AssertJsonApiResource.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace Ark4ne\JsonApi\Asserts;
+
+use Ark4ne\JsonApi\Descriptors\Values\Value;
+use Ark4ne\JsonApi\Resources\JsonApiResource;
+use Ark4ne\JsonApi\Support\FakeModel;
+use Ark4ne\JsonApi\Support\Values;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\MissingValue;
+use ReflectionClass;
+
+class AssertJsonApiResource
+{
+    /**
+     * @param class-string<JsonApiResource> $class
+     */
+    public function __construct(protected string $class)
+    {
+    }
+
+    public function assert(): void
+    {
+        $this->itCanGenerateSchema();
+        $this->allAttributesAreLazySet();
+    }
+
+    private function itCanGenerateSchema(): void
+    {
+        try {
+            $this->class::schema();
+        } catch (\Throwable $throwable) {
+            throw new FailGenerateSchema($this->class, $throwable);
+        }
+    }
+
+    private function allAttributesAreLazySet(): void
+    {
+        $reflection = new ReflectionClass($this->class);
+        $instance = $reflection->newInstanceWithoutConstructor();
+        $instance->resource = new FakeModel;
+
+        $method = $reflection->getMethod('toAttributes');
+        $method->setAccessible(true);
+        /** @var iterable<array-key, mixed> $attributes */
+        $attributes = $method->invoke($instance, new Request());
+        $attributes = Values::mergeValues($attributes);
+
+        foreach ($attributes as $key => $attribute) {
+            if (!($attribute instanceof \Closure || $attribute instanceof MissingValue || $attribute instanceof Value)) {
+                throw new EagerSetAttribute($this->class, $key);
+            }
+        }
+    }
+}

src/Asserts/EagerSetAttribute.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Ark4ne\JsonApi\Asserts;
+
+use Throwable;
+
+class EagerSetAttribute extends \Exception
+{
+    public function __construct(string $class, string $key, ?Throwable $previous = null)
+    {
+        parent::__construct("Attribute [$key] on resource [$class] is eager set.", 0, $previous);
+    }
+}

src/Asserts/FailGenerateSchema.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace Ark4ne\JsonApi\Asserts;
+
+use Throwable;
+
+class FailGenerateSchema extends \Exception
+{
+    public function __construct(string $class, ?Throwable $previous = null)
+    {
+        parent::__construct("Can't generate schema for resource [$class].", 0, $previous);
+    }
+}

src/Descriptors/Relations/Relation.php

@@ -65,7 +65,7 @@ public function meta(Closure $meta): static
      * @param bool|null $whenIncluded
      * @return $this
      */
-    public function whenIncluded(bool $whenIncluded = null): static
+    public function whenIncluded(null|bool $whenIncluded = null): static
     {
         if ($whenIncluded === null) {
             $this->whenIncluded ??= true;
@@ -83,7 +83,7 @@ public function whenIncluded(bool $whenIncluded = null): static
      *
      * @return static
      */
-    public function whenLoaded(string $relation = null): self
+    public function whenLoaded(null|string $relation = null): self
     {
         return $this->when(fn(
             Request $request,
@@ -100,7 +100,7 @@ public function whenLoaded(string $relation = null): self
      *
      * @return static
      */
-    public function whenPivotLoaded(string $table, string $accessor = null): self
+    public function whenPivotLoaded(string $table, null|string $accessor = null): self
     {
         return $this->when(fn(
             Request $request,

src/Resources/Concerns/Relationships.php

@@ -60,7 +60,7 @@ private function requestedRelationshipsLoadFromSchema(Request $request, Skeleton
             if ($load && Includes::include($request, $name)) {
                 $include = Includes::through($name, fn() => $this->requestedRelationshipsLoadFromSchema($request, $schema->relationships[$name]));
 
-                $apply = static function ($load, string $pre = null) use (&$loads, &$apply) {
+                $apply = static function ($load, null|string $pre = null) use (&$loads, &$apply) {
                     foreach ((array)$load as $key => $value) {
                         if (is_string($value)) {
                             $loads["$pre.$value"] = [];

src/Resources/Concerns/Schema.php

@@ -21,7 +21,7 @@ trait Schema
      */
     private static array $schemas = [];
 
-    public static function schema(Request $request = null): Skeleton
+    public static function schema(null|Request $request = null): Skeleton
     {
         if (isset(self::$schemas[static::class])) {
             return self::$schemas[static::class];

src/Resources/Concerns/SchemaCollection.php

@@ -8,7 +8,7 @@
 
 trait SchemaCollection
 {
-    public static function schema(Request $request = null): Skeleton
+    public static function schema(null|Request $request = null): Skeleton
     {
         return self::new()->collects::schema($request);
     }

src/Resources/Relationship.php

@@ -100,7 +100,7 @@ public function asCollection(): self
      * @param bool|null $whenIncluded
      * @return $this
      */
-    public function whenIncluded(bool $whenIncluded = null): static
+    public function whenIncluded(null|bool $whenIncluded = null): static
     {
         if ($whenIncluded === null) {
             $this->whenIncluded ??= true;