refactor: remove unused can method and related documentation from Relation.php

Author: Ark4ne

readme.md

@@ -331,20 +331,6 @@ protected function toRelationships(Request $request): array
 }
 ```
 
-#### Laravel policy on relationships
-_**@see** [laravel: authorizing-actions-via-gates](https://laravel.com/docs/12.x/authorization#authorizing-actions-via-gates)_
-
-Apply laravel policy on relationships.
-
-```php
-protected function toRelationships(Request $request): array
-{
-    return [
-        'posts' => $this->many(PostResource::class)
-            ->can('viewAny.post')
-    ];
-}
-```
 
 ### toLinks
 _**@see** [{json:api}: resource-linkage](https://jsonapi.org/format/#document-resource-object-links)_

src/Descriptors/Relations/Relation.php

@@ -7,7 +7,6 @@
 use Ark4ne\JsonApi\Support\Includes;
 use Ark4ne\JsonApi\Traits\HasRelationLoad;
 use Closure;
-use Illuminate\Contracts\Auth\Access\Gate;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Http\Request;
 use Illuminate\Http\Resources\MissingValue;
@@ -64,24 +63,6 @@ public function meta(Closure $meta): static
         return $this;
     }
 
-    /**
-     * @param iterable<mixed>|string $abilities Abilities to check
-     * @param array<mixed> $arguments Arguments to pass to the policy method, the model is always the first argument
-     * @param string $gateClass Gate class to use, defaults to the default Gate implementation
-     * @return static
-     */
-    public function can(iterable|string $abilities, array $arguments = [], string $gateClass = Gate::class): static
-    {
-        return $this->when(fn(
-            Request $request,
-            Model   $model,
-            string  $attribute
-        ) => app($gateClass)
-            ->forUser($request->user())
-            ->allows($abilities, [$model, ...$arguments])
-        );
-    }
-
     /**
      * @param bool|null $whenIncluded
      * @return static