spectrum-ts v4.0.0

Breaking Changes

Streaming Fusor now uses WebSockets instead of gRPC. If you customized the streaming endpoint, replace SPECTRUM_FUSOR_GRPC_URL / endpoint with SPECTRUM_FUSOR_WS_URL / websocketEndpoint.

Streaming mode now needs a runtime with a global WebSocket, such as Bun, Node 22+, browsers, or edge workers. Webhook-only apps are not affected.

New Features

app.messages now connects over Fusor’s fusor.v1.json WebSocket protocol, keeping the same message pipeline while making streaming easier to run outside gRPC-heavy environments. ✨

The Fusor docs now include the WebSocket protocol details, including init frames, replies, heartbeats, close codes, auth, and reconnect behavior.

Improvement

Removed the gRPC client dependencies from spectrum-ts, which makes the package lighter and avoids gRPC tooling for streaming users.

The new stream client handles heartbeats, reconnect backoff, token refresh after auth failures, and only sends replies when Fusor asks for one.

---

Version: 4.0.0