fix: resolve string media keys in the glider component

[awcodes]

Fixes #719.

1. The reported bug: :media="$image" renders a placeholder, :media="(int) $image" renders the image

The reporter had it right in their third comment. Glider::__construct() only matched is_int(), so a string key fell through to handleString(), which reads the value as a path:

$extension = (string) Str::of('10')->afterLast('.'); // "10"

isPreviewable("10") is false, so the component rendered the document placeholder for a perfectly good image. Their data is ['banners' => ["10", "7"]] in a json settings column — no relationship or model override involved, which is what wasn't adding up in the thread. Any id that round-trips through json, a query string or a settings array arrives as a string.

A bare key is now looked up instead of being taken for a path:

if (is_a($media, Media::class)) {
    $this->handleMedia($media);
} elseif (is_int($media) || (is_string($media) && static::isMediaKey($media))) {
    $this->handleId($media);
} elseif (is_string($media) && filled($media)) {
    $this->handleString($media);
}

isMediaKey() matches the key shapes curator issues — digits, plus uuids and ulids, since curator:install --use-uuid writes $table->uuid('id')->primary(). A path always carries an extension, so the two shapes don't overlap; '10.jpg', 'banner.jpg' and 'media/2024/10' all still take the path branch, and there are tests pinning that.

handleInt() is kept as a deprecated delegate to the widened handleId(), so anything extending the component keeps working. A string key that doesn't resolve reaches the fallback, same as an int that doesn't.

2. The placeholder labels everything "PDF"

Worth fixing while in here, and it's half of what the reporter was looking at. resources/views/components/display/document.blade.php declares 'extension' => 'pdf' as its prop default, and glider.blade.php never passed one — so every non-previewable file the glider rendered came out labelled PDF, and the video branch in that component was unreachable. (display/index.blade.php was already doing this correctly with $item->ext.)

MediaDTO now carries ext, populated from all three sources — record, path, and fallback (via its type(), falling back to the source's extension) — and the hardcoded default is gone. A .docx now renders labelled docx.

3. The Glide token error

Docs for this landed in dafd5c2 already, so this is only the error itself. GlideManager::getToken(): string returned config('curator.glide_token') straight, so a checkout that never ran curator:install got:

Awcodes\Curator\Config\GlideManager::getToken(): Return value must be of type string, null returned

It now names the missing variable and the command that generates it. This is exactly the reporter's "1 pc has it, the other doesn't" situation.

Tests

tests/src/Feature/Components/GliderMediaKeyTest.php — 16 cases covering key resolution, the path branch staying put, fallback on an unresolvable string key, extension propagation from each source, and a rendered-html assertion that the placeholder says docx and not pdf. All but the "a path is still treated as a path" no-regression guard fail on 5.x.

composer test is green: 218 passed, PHPStan clean, no Pint or Rector drift.

🤖 Generated with Claude Code