Current state

app/Http/Resources/ArtworkListResource.php

@@ -0,0 +1,81 @@
+<?php
+namespace App\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Http\Resources\MissingValue;
+
+class ArtworkListResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array for listings (browse feed).
+     */
+    public function toArray($request): array
+    {
+        if ($this instanceof MissingValue || $this->resource instanceof MissingValue) {
+            return [];
+        }
+        // Safe accessor to avoid magic __get which may trigger MissingValue errors
+        $get = function ($key) {
+            $r = $this->resource;
+            if ($r instanceof MissingValue || $r === null) {
+                return null;
+            }
+            if (method_exists($r, 'getAttribute')) {
+                return $r->getAttribute($key);
+            }
+            if (is_array($r)) {
+                return $r[$key] ?? null;
+            }
+            if (is_object($r)) {
+                return $r->{$key} ?? null;
+            }
+            return null;
+        };
+        $primaryCategory = $this->whenLoaded('categories', function () {
+            return $this->categories->sortBy('sort_order')->first();
+        });
+
+        // Normalize MissingValue into null so later checks are straightforward
+        if ($primaryCategory instanceof MissingValue) {
+            $primaryCategory = null;
+        }
+
+        $contentTypeSlug = null;
+        $categoryPath = null;
+        if ($primaryCategory) {
+            $contentTypeSlug = optional($primaryCategory->contentType)->slug ?? null;
+            $categoryPath = $primaryCategory->full_slug_path ?? null;
+        }
+        $slugVal = $get('slug');
+        $webUrl = $contentTypeSlug && $categoryPath && $slugVal
+            ? '/' . strtolower($contentTypeSlug) . '/' . strtolower($categoryPath) . '/' . $slugVal
+            : null;
+
+        return [
+            'slug' => $slugVal,
+            'title' => $get('title'),
+            'description' => $this->when($request->boolean('include_description'), fn() => $get('description')),
+            'dimensions' => [
+                'width' => $get('width'),
+                'height' => $get('height'),
+            ],
+            'thumbnail_url' => $this->when(! empty($get('file_path')), fn() => Storage::url($get('file_path'))),
+            'author' => $this->whenLoaded('user', function () {
+                return [
+                    'name' => $this->user->name ?? null,
+                ];
+            }),
+            'category' => $primaryCategory ? [
+                'slug' => $primaryCategory->slug ?? null,
+                'name' => $primaryCategory->name ?? null,
+                'content_type' => $contentTypeSlug,
+                'url' => $webUrl,
+            ] : null,
+            'urls' => [
+                'web' => $webUrl,
+                'canonical' => $webUrl,
+            ],
+        ];
+    }
+}

app/Http/Resources/ArtworkResource.php

@@ -0,0 +1,64 @@
+<?php
+namespace App\Http\Resources;
+
+use Illuminate\Http\Resources\Json\JsonResource;
+use Illuminate\Support\Facades\Storage;
+use Illuminate\Http\Resources\MissingValue;
+
+class ArtworkResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     */
+    public function toArray($request): array
+    {
+        if ($this instanceof MissingValue || $this->resource instanceof MissingValue) {
+            return [];
+        }
+        $get = function ($key) {
+            $r = $this->resource;
+            if ($r instanceof MissingValue || $r === null) {
+                return null;
+            }
+            // Eloquent model: prefer getAttribute to avoid magic proxies
+            if (method_exists($r, 'getAttribute')) {
+                return $r->getAttribute($key);
+            }
+            if (is_array($r)) {
+                return $r[$key] ?? null;
+            }
+            if (is_object($r)) {
+                return $r->{$key} ?? null;
+            }
+            return null;
+        };
+        return [
+            'slug' => $get('slug'),
+            'title' => $get('title'),
+            'description' => $get('description'),
+            'width' => $get('width'),
+            'height' => $get('height'),
+
+            // File URLs: produce public URLs without exposing internal file_path
+            'file' => [
+                'name' => $get('file_name') ?? null,
+                'url' => $this->when(! empty($get('file_path')), fn() => Storage::url($get('file_path'))),
+                'size' => $get('file_size') ?? null,
+                'mime_type' => $get('mime_type') ?? null,
+            ],
+
+            'categories' => $this->whenLoaded('categories', function () {
+                return $this->categories->map(fn($c) => [
+                    'slug' => $c->slug ?? null,
+                    'name' => $c->name ?? null,
+                ])->values();
+            }),
+
+            'published_at' => $this->whenNotNull($get('published_at') ? $this->published_at->toAtomString() : null),
+
+            'urls' => [
+                'canonical' => $get('canonical_url') ?? null,
+            ],
+        ];
+    }
+}