Falai/storage
@webframp/falai/storagev2026.09.10.4
01README
fal.ai Storage — file ACLs, signed URLs, storage settings
02Release Notes
2026.09.10.4
Fixed:
- Resource instance names for get/update methods with two or more path
parameters (e.g.
get_app_queue_info(owner, name),get_workflow(username, workflow_name)) were built by joining raw values with"_". Two distinct owner/name pairs that split differently around an underscore (e.g."john"/"doe_app"and"john_doe"/"app") produced the identical instance name and collided. Multi-param instance names are now derived from a hash of the JSON-encoded parameter tuple, which delimits each part unambiguously.
Upgrade note: No schema changes. All fixes are internal to method execution; existing stored resources are unaffected.
03Models
@webframp/falai/storagev2026.09.10.4falai/storage.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| apiToken? | string | fal.ai API key; overrides the FAL_KEY environment variable. Wire with a vault.get(...) expression to source it from a vault. |
fn get_storage_file_acl(url?: string)
Get file ACL
| Argument | Type | Description |
|---|---|---|
| url? | string | Full URL of the fal CDN file, as returned by the upload APIs (https://v3.fal.media/files/b/<id>/<filename>). Must not contain query parameters. |
fn set_storage_file_acl(url?: string, default: enum, rules?: array)
Set file ACL
| Argument | Type | Description |
|---|---|---|
| url? | string | Full URL of the fal CDN file, as returned by the upload APIs (https://v3.fal.media/files/b/<id>/<filename>). Must not contain query parameters. |
| default | enum | Fallback decision when no user-specific rule matches |
| rules? | array | User-specific overrides to the default decision |
fn sign_storage_file_url(url?: string, expiration_seconds: number)
Sign file URL
| Argument | Type | Description |
|---|---|---|
| url? | string | Full URL of the fal CDN file, as returned by the upload APIs (https://v3.fal.media/files/b/<id>/<filename>). Must not contain query parameters. |
| expiration_seconds | number | How long the signed URL stays valid, in seconds (max 7 days) |
fn get_storage_settings()
Get storage settings
fn update_storage_settings(expiration_duration_seconds?: number, initial_acl?: object)
Update storage settings
| Argument | Type | Description |
|---|---|---|
| expiration_duration_seconds? | number | Seconds after which newly uploaded files automatically expire and are deleted... |
| initial_acl? | object |
Resources
get_storage_file_acl(infinite)— Get file ACL
set_storage_file_acl(infinite)— Set file ACL
sign_storage_file_url(infinite)— Sign file URL
storage_settings(infinite)— Get storage settings
04Stats
A
100 / 100
Downloads
0
Archive size
15.6 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
05Platforms
06Labels