Filament Url Image Uploader Laravel Package

1.0.3 fixed several real bugs but its getChildComponentContainer() override left the field broken in the most common real-world setup — any Filament Resource page (CreateRecord/EditRecord), which conventionally uses a data form state path — and it didn't fully close out the URL-tab validation issue either. This release replaces that approach and fixes what was still broken, verified end-to-end with a permanent Testbench/Livewire test suite (not just unit tests against the component in isolation).

Fixed

• Critical: field crashed on every save inside a real Filament Resource form. 1.0.3's getChildComponentContainer() override built the inner FileUpload/TextInput container with no parentComponent() and no statePath(), so it silently discarded all path context above it (the field's own container path, any Repeater/Section nesting, and critically the form's own root statePath). Since CreateRecord/EditRecord pages bind their form to a data property by convention, the inner fields ended up bound to the bare field name (e.g. image) instead of data.image, and Livewire threw No property found for validation: [image] the moment the form tried to validate — i.e. on every save. Fixed by dropping the container override entirely and going back to Filament's normal, cached child-container resolution, with the inner FileUpload and TextInput renamed to path/url (instead of reusing the parent field's own name) so they no longer collide with the parent's own state path in the first place.
• The "URL Upload" tab's ->url() rule could still block saving a plain file upload. Replaced with a closure rule that only validates URL format when the value is non-blank, and also accepts root-relative paths (Storage::disk(...)->url() can legitimately return one depending on disk config).
• Live preview used the wrong array key format. FileUpload keeps its in-progress state as a UUID-keyed array (e.g. ['9f1c...' => 'images/photo.jpg']), not a [0 => ...]-indexed one. The blade preview (and the field's own dehydration) read the value via $path[0], which silently resolved to null — most visibly when editing a record that already has an image, since that's exactly when FileUpload's hydration hook re-keys the value onto a UUID. Fixed by reading the first element with Arr::first() regardless of key, in both places.

Added

• ->disk(string $disk) — the field previously hardcoded the public disk even though the inner FileUpload supported any disk; both the upload tab and the URL-fetch action now honour it.
• ->maxUrlFetchSize(int $bytes) (default 10 MB) — the "fetch from URL" action now enforces a byte cap on the server-side download, on top of the existing finfo content-type check, and rejects any scheme other than http/https before fetching.
• Larastan/PHPStan (level 5), via composer analyse.
• A permanent Testbench + Livewire test suite (composer test) covering: an existing image surviving a no-op edit-and-save (twice in a row, and across separate page loads); a fresh file upload persisting to disk and to the model attribute; the live preview resolving correctly both right after upload and for an existing image's UUID-keyed hydration state; and the URL tab staying blank without blocking a file-tab save.

Changed

• Documented the field's scope: single image per field, no multiple() support (use one field per image, or a Repeater, if you need several).

Full details in CHANGELOG.md.

Fixed

• ServiceProvider: Removed incorrect hasViewComponent() registration that tried to register a Filament form field (UrlImageUploader) as a Blade view component (Illuminate\View\Component), causing a fatal error when the package was loaded
• ServiceProvider: Removed redundant packageBooted() override that double-registered the views namespace (already handled by ->hasViews())
• UrlImageUploader: Fixed state-path nesting bug — the inner FileUpload::make($fieldName) was resolving to state-path {field}.{field} (e.g. image.image) instead of the correct root-level {field} (image), meaning data was never saved to the right database column
• UrlImageUploader: Added dehydrated(false) to the outer wrapper field so it no longer competes with the inner FileUpload's own dehydration
• UrlImageUploader: Removed broken afterStateUpdated that prematurely stored uploaded files manually (the FileUpload component handles this automatically in beforeStateDehydrated), preventing double file storage
• UrlImageUploader: Removed broken afterStateHydrated that overrode BaseFileUpload's correct UUID-keyed state format with a plain array, breaking the FileUpload display in edit mode
• UrlImageUploader: Added dehydrated(false) to the URL TextInput so the URL value is not persisted to the database
• UrlImageUploader: Fixed URL fetch action — added 10-second HTTP timeout, finfo content-type validation (rejects non-image responses), filename sanitization, and a proper error notification when the URL is empty or invalid
• Blade view: Rewrote the image preview logic to correctly handle all state formats: plain string path, full URL string, [uuid => path] array (FileUpload internal format), and plain [path] array

Added

• PHPUnit test suite with orchestra/testbench integration
• phpunit.xml configuration
• Basic unit tests covering instantiation, directory configuration, and dehydration behaviour