Changelog
All notable changes to tauri-plugin-centrifugo and tauri-plugin-centrifugo-api.
All notable changes to this project will be documented in this file. See standard-version for commit guidelines.
Unreleased
0.2.1 - 2026-11-09
Fixed
centrifugo:defaultnow includesallow-provide-token,allow-add-subscription-with-optionsandallow-remove-all-subscriptions; with only the default set,provideToken(the token bridge),addSubscriptionWithOptionsandremoveAllSubscriptionswere denied.- Event listeners (
onConnected,onPublication, ...) get the whole Tauri event again ({ event, payload, id }, as typed and as in 0.1.x). 0.2.0 passed only the payload, soonMessage,onChannelMessage,onAnyMessage,onPublicationRawJson,onServerPublicationRawJsonandhelpers.subscribeToChannel(s)threw on every publication. Code written for 0.2.0 that readse.channelmust reade.payload.channel.
Removed
- Stale
allow-/deny-start-connectionandallow-/deny-stop-connectionpermissions (no such commands).
Added
- Documentation site: https://s00d.github.io/tauri-plugin-centrifugo/
0.2.0 - 2026-11-08
Changed
- Breaking: the client is now the official Rust SDK
centrifuge-clientinstead of the internal engine. Its modules (client,config,protocol, ...) are no longer re-exported; the SDK is available astauri_plugin_centrifugo::centrifuge. - The connection token callback (
need_token) is installed only whentokenis set orrequestToken: true; anonymous connections no longer wait for the frontend. refreshanswers a pendingneed_token(else sets the token for the next connect);subRefreshanswersneed_sub_token. The SDK refreshes tokens itself before they expire.subscribedevent carrieswasRecovering,recovered,streamPosition;connecting/disconnectedcarrycode/reason.- guest-js is built with Vite 8 and TypeScript 6; dual ESM/CJS types; checked with publint and attw.
Added
StartConfig.httpStreamUrl(HTTP-streaming fallback),headers,requestToken.SubscribeOptions.delta(fossil) andsince(resume from a saved position).need_sub_token,join,leaveevents;onNeedSubTokenhelper.- Android:
wss://works out of the box (Mozilla roots viawebpki-roots). - End-to-end tests against a real Centrifugo, CI on Linux, macOS and Windows, Android build check.
Deprecated
ping(resolves when connected; the SDK pings by itself).- Map publish fields (
type/key/removed) and track/untrack sub refresh fields: rejected withNot supported.
Fixed
- A newer token request no longer makes the previous one fail as unauthorized (which disconnected the client for good).
- Example app: endless log loop (
attachConsole+ console forwarding) that froze the UI on Android; autocorrect on inputs.
0.1.x
Added
- Initial release of Tauri Plugin Centrifugo
- Real-time communication with Centrifugo server
- WebSocket support with JSON and Protobuf protocols
- Channel subscription management
- JWT authentication support
- Event-driven architecture for connection state and messages
- Cross-platform support (desktop and mobile)
- TypeScript/JavaScript API bindings
- Example Svelte application
Changed
- N/A
Deprecated
- N/A
Removed
- N/A
Fixed
- N/A
Security
- N/A