@syncular/tauri 0.15.36 → 0.15.38

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +27 -0
  2. package/package.json +3 -3
package/README.md CHANGED
@@ -13,6 +13,33 @@ local Tauri views remain responsive while the native client is syncing over
13
13
  HTTP/WebSocket. Mutations, sync, and all durable writes remain serialized on
14
14
  the single mutable core owner.
15
15
 
16
+ ## Realtime lifecycle
17
+
18
+ Use the supervisor exported by `@syncular/client` for the WebView host policy:
19
+
20
+ ```ts
21
+ import {
22
+ browserConnectivitySignal,
23
+ documentLifecycleSignal,
24
+ installRealtimeSupervisor,
25
+ } from '@syncular/client';
26
+ import { createTauriSyncClient } from '@syncular/tauri';
27
+
28
+ const client = await createTauriSyncClient({ schema });
29
+ installRealtimeSupervisor(client, {
30
+ connectivity: browserConnectivitySignal(),
31
+ lifecycle: documentLifecycleSignal(),
32
+ protection,
33
+ });
34
+ ```
35
+
36
+ The supervisor performs reconnect, bounded retry, resume catch-up, diagnostics,
37
+ and close cancellation without opening duplicate native sockets. The document
38
+ signal is the portable WebView baseline. Apps that observe native sleep/wake or
39
+ window lifecycle should pass that evidence through the same structural
40
+ `RealtimeSupervisorSignal`; protected apps publish `preflight` before releasing
41
+ keys and `active` only after reactivation. Render local SQLite immediately.
42
+
16
43
  The bridge includes the native core's durable commit-outcome journal:
17
44
  `commitOutcome`, `commitOutcomes`, and `resolveCommitOutcome`. Final results
18
45
  and explicit conflict resolutions survive process restarts; active failures
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@syncular/tauri",
3
- "version": "0.15.36",
3
+ "version": "0.15.38",
4
4
  "description": "Tauri integration for the Syncular client",
5
5
  "license": "Apache-2.0",
6
6
  "author": "Benjamin Kniffler",
@@ -48,12 +48,12 @@
48
48
  "test": "bun test"
49
49
  },
50
50
  "dependencies": {
51
- "@syncular/client": "0.15.36"
51
+ "@syncular/client": "0.15.38"
52
52
  },
53
53
  "peerDependencies": {
54
54
  "@tauri-apps/api": ">=2.0.0"
55
55
  },
56
56
  "devDependencies": {
57
- "@syncular/react": "0.15.36"
57
+ "@syncular/react": "0.15.38"
58
58
  }
59
59
  }