Add JsonApi facade & JsonApiable contract interface

Author: d8vjork

src/Contracts/JsonApiable.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace SkoreLabs\JsonApi\Contracts;
+
+interface JsonApiable
+{
+    /**
+     * Get a custom resource type for JSON:API formatting.
+     * 
+     * @return string 
+     */
+    public function resourceType(): string;
+}

src/Http/Resources/JsonApiResource.php

@@ -6,6 +6,7 @@
 use Illuminate\Http\Resources\MissingValue;
 use Illuminate\Support\Str;
 use SkoreLabs\JsonApi\Concerns\HasConfig;
+use SkoreLabs\JsonApi\Support\JsonApi;
 
 class JsonApiResource extends JsonResource
 {
@@ -81,7 +82,7 @@ public function getResourceIdentifier()
     {
         return [
             $this->resource->getKeyName() => (string) $this->resource->getKey(),
-            'type'                        => Str::snake(class_basename($this->resource)),
+            'type'                        => JsonApi::getResourceType($this->resource),
         ];
     }
 

src/Support/Facades/JsonApi.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace SkoreLabs\JsonApi\Support\Facades;
+
+use Illuminate\Support\Facades\Facade;
+
+class JsonApi extends Facade
+{
+    protected static function getFacadeAccessor()
+    {
+        return 'json-api';
+    }
+}

src/Support/JsonApi.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace SkoreLabs\JsonApi\Support;
+
+use Illuminate\Contracts\Pagination\LengthAwarePaginator;
+use Illuminate\Support\Collection;
+use SkoreLabs\JsonApi\Contracts\JsonApiable;
+use SkoreLabs\JsonApi\Http\Resources\JsonApiCollection;
+use SkoreLabs\JsonApi\Http\Resources\JsonApiResource;
+use Illuminate\Support\Str;
+
+class JsonApi
+{
+    /**
+     * Format the input contents to JSON:API.
+     * 
+     * @param mixed $value 
+     * @return \SkoreLabs\JsonApi\Http\Resources\JsonApiResource 
+     */
+    public static function format($value)
+    {
+        if ($value instanceof LengthAwarePaginator || $value instanceof Collection) {
+            return JsonApiCollection::make($value);
+        }
+
+        return JsonApiResource::make($value);
+    }
+
+    /**
+     * Get resource type from a model.
+     * 
+     * @param \Illuminate\Database\Eloquent\Model|string $model 
+     * @return string 
+     */
+    public static function getResourceType($model)
+    {
+        if ($model instanceof JsonApiable) {
+            return $model->resourceType();
+        }
+
+        return Str::snake(class_basename(is_string($model) ? $model : $model::class));
+    }
+}