# What changed in @fal-ai/client

> 14 changes in @fal-ai/client 1 from its official release notes, upgrade guides and advisories: 4 new APIs and options. Each one cited. Sources checked 2026-11-04. HTML: https://unstale.sh/npm/@fal-ai/client/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @fal-ai/client 1

### New APIs and options

- Lifecycle ACL options are exposed in storage settings. (1.9.6) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.9.6)
- Adds tokenProvider for the realtime API. (1.9.0) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.9.0)
- Adds user-defined timeouts, allowing developers to configure timeout behavior. (1.8.4) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.8.4)
- Realtime introduces resultType="json" for requesting JSON results. (1.8.3) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.8.3)

### Behavior and default changes

- Proxy middleware can now be used in non-browser runtimes. (1.10.0) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.10.0)
- Realtime now supports live references. (1.9.6) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.9.6)
- Realtime tokens refresh in the background without dropping the WebSocket connection. (1.9.4) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.9.4)

### Fixes and other changes

- Retries Node-level transport errors in subscribe and dispatch. (1.10.1) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.10.1)
- The connection closed transition now expires the token. (1.9.6) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.9.6)
- Fixed token expiration when a realtime connection transitions to closed. (1.9.5) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.9.5)
- The client now uses rest.fal.ai. (1.9.3) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.9.4), [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.9.3)
- TokenProvider now receives a normalized app+path. (1.9.2) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.9.2)
- Auth state machine sends are deferred to avoid nested onChange corruption. (1.9.1) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.9.1)
- Restores support for running the client on Node 18+. (1.8.5) — [release notes](https://github.com/fal-ai/fal-js/releases/tag/client-v1.8.5)