fix: repair uc relationships, improve retreiving uuids

Author: Baspa

composer.json

@@ -74,6 +74,7 @@
             "Backstage\\Fields\\": "packages/fields/src/",
             "Backstage\\Fields\\Database\\Factories\\": "packages/fields/database/factories/",
             "Backstage\\Media\\": "packages/media/src/",
+            "Backstage\\UploadcareField\\": "packages/uploadcare-field/src/",
             "Backstage\\Database\\Factories\\": "database/factories/",
             "Backstage\\Database\\Seeders\\": "database/seeders/"
         },
@@ -83,7 +84,8 @@
     },
     "autoload-dev": {
         "psr-4": {
-            "Backstage\\Tests\\": "tests/"
+            "Backstage\\Tests\\": "tests/",
+            "Backstage\\UploadcareField\\Tests\\": "packages/uploadcare-field/tests/"
         }
     },
     "scripts": {

packages/filament-uploadcare-field/src/Forms/Components/Uploadcare.php

@@ -282,6 +282,28 @@ public function getState(): mixed
     {
         $state = parent::getState();
 
+        // Handle double-encoded JSON or JSON strings
+        if (is_string($state) && json_validate($state)) {
+            $state = json_decode($state, true);
+        }
+
+        // Resolve Backstage Media ULIDs (26-char) into Uploadcare CDN URLs / UUIDs,
+        // so the widget can show a preview even when the database stores ULIDs.
+        if (is_array($state) && ! empty($state) && self::isListOfUlids($state)) {
+            $resolved = self::resolveUlidsToUploadcareState($state);
+            if (! empty($resolved)) {
+                $state = $resolved;
+            }
+        }
+
+        // Handle array of file objects (extract UUIDs / URLs)
+        if (is_array($state) && ! empty($state)) {
+             $values = self::extractValues($state);
+             if (! empty($values)) {
+                 $state = $values;
+             }
+        }
+
         if ($state === '[]' || $state === '""' || $state === null || $state === '') {
             return null;
         }
@@ -298,6 +320,102 @@ public function getState(): mixed
         return $state;
     }
 
+    private static function isListOfUlids(array $state): bool
+    {
+        if (! isset($state[0]) || ! is_string($state[0])) {
+            return false;
+        }
+
+        return (bool) preg_match('/^[0-9A-HJKMNP-TV-Z]{26}$/i', $state[0]);
+    }
+
+    private static function extractUuidFromString(string $value): ?string
+    {
+        if (preg_match('/([a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})/i', $value, $matches)) {
+            return $matches[1];
+        }
+
+        return null;
+    }
+
+    private static function resolveUlidsToUploadcareState(array $ulids): array
+    {
+        $mediaModel = config('backstage.media.model', \Backstage\Media\Models\Media::class);
+
+        if (! is_string($mediaModel) || ! class_exists($mediaModel)) {
+            return [];
+        }
+
+        $mediaItems = $mediaModel::whereIn('ulid', array_filter($ulids, 'is_string'))
+            ->get()
+            ->keyBy('ulid');
+
+        $resolved = [];
+
+        foreach ($ulids as $ulid) {
+            if (! is_string($ulid)) {
+                continue;
+            }
+
+            $media = $mediaItems->get($ulid);
+            if (! $media) {
+                continue;
+            }
+
+            $metadata = $media->metadata ?? null;
+            if (is_string($metadata)) {
+                $metadata = json_decode($metadata, true);
+            }
+            $metadata = is_array($metadata) ? $metadata : [];
+
+            $editMeta = $media->edit ?? null;
+            if (is_string($editMeta)) {
+                $editMeta = json_decode($editMeta, true);
+            }
+            if (is_array($editMeta)) {
+                $metadata = array_merge($metadata, $editMeta);
+            }
+
+            $cdnUrl = $metadata['cdnUrl'] ?? ($metadata['fileInfo']['cdnUrl'] ?? null);
+            $uuid = $metadata['uuid'] ?? ($metadata['fileInfo']['uuid'] ?? null);
+
+            if (! $uuid && is_string($media->filename ?? null)) {
+                $uuid = self::extractUuidFromString($media->filename);
+            }
+            if (! $uuid && is_string($cdnUrl)) {
+                $uuid = self::extractUuidFromString($cdnUrl);
+            }
+
+            if ((! $cdnUrl || ! filter_var($cdnUrl, FILTER_VALIDATE_URL)) && $uuid) {
+                $cdnUrl = 'https://ucarecdn.com/' . $uuid . '/';
+            }
+
+            if (is_string($cdnUrl) && filter_var($cdnUrl, FILTER_VALIDATE_URL)) {
+                $resolved[] = $cdnUrl;
+            } elseif ($uuid) {
+                $resolved[] = $uuid;
+            }
+        }
+
+        return $resolved;
+    }
+
+    private static function extractValues(array $state): array
+    {
+        $keys = ['cdnUrl', 'ucarecdn', 'uuid', 'filename'];
+
+        foreach ($keys as $key) {
+            $values = \Illuminate\Support\Arr::pluck($state, $key);
+            $filtered = array_filter($values);
+            
+            if (! empty($filtered)) {
+                return array_values($filtered);
+            }
+        }
+
+        return [];
+    }
+
     private function transformUrls($value, string $from, string $to): mixed
     {
         $decodeIfJson = function ($v) use (&$decodeIfJson) {