@syncular/tauri 0.5.0 → 0.5.1

package/README.md

@@ -8,6 +8,11 @@ Install the bridge together with its required Tauri JavaScript API peer:
 bun add @syncular/tauri @tauri-apps/api
 ```
 
+Reactive snapshots use the plugin's independent read-only SQLite path, so
+local Tauri views remain responsive while the native client is syncing over
+HTTP/WebSocket. Mutations, sync, and all durable writes remain serialized on
+the single mutable core owner.
+
 Part of [Syncular](https://syncular.dev) — an offline-first sync framework.
 See the [Syncular repository](https://github.com/syncular/syncular) for docs.
 

package/dist/index.d.ts

@@ -13,8 +13,9 @@
  * Every method forwards to the plugin's `syncular_command` command (the whole
  * command surface in one JSON envelope — `{method, params}`), mirroring the FFI
  * and the conformance shim. `query` uses the dedicated `syncular_query` fast
- * path (one IPC round trip per live-query run — fine at Tauri IPC latency; see
- * the README's pagination note for very large result sets). Client-observable
+ * path; atomic reactive reads use `syncular_query_snapshot`, backed by an
+ * independent read-only SQLite connection so network sync cannot stall local
+ * UI reads. Client-observable
  * events (`change` / `presence`) arrive on
  * the `syncular://event` Tauri event and fan out to the registered listeners.
  *

package/dist/index.js

@@ -13,8 +13,9 @@
  * Every method forwards to the plugin's `syncular_command` command (the whole
  * command surface in one JSON envelope — `{method, params}`), mirroring the FFI
  * and the conformance shim. `query` uses the dedicated `syncular_query` fast
- * path (one IPC round trip per live-query run — fine at Tauri IPC latency; see
- * the README's pagination note for very large result sets). Client-observable
+ * path; atomic reactive reads use `syncular_query_snapshot`, backed by an
+ * independent read-only SQLite connection so network sync cannot stall local
+ * UI reads. Client-observable
  * events (`change` / `presence`) arrive on
  * the `syncular://event` Tauri event and fan out to the registered listeners.
  *
@@ -220,11 +221,15 @@ export class TauriSyncClient {
         return rows.map((r) => decodeRow(r));
     }
     async querySnapshot(spec) {
-        const result = (await this.#command('querySnapshot', {
+        const reply = await this.#tauri.invoke(`${PLUGIN}syncular_query_snapshot`, {
             sql: spec.sql,
             params: (spec.params ?? []).map(encodeParam),
             coverage: spec.coverage ?? [],
-        }));
+        });
+        if (reply.error !== undefined) {
+            throw new TauriSyncError(reply.error.code, reply.error.message);
+        }
+        const result = reply.result;
         return {
             revision: BigInt(result.revision),
             rows: result.rows.map(decodeRow),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/tauri",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Tauri integration for the Syncular client",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -48,12 +48,12 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@syncular/client": "0.5.0"
+    "@syncular/client": "0.5.1"
   },
   "peerDependencies": {
     "@tauri-apps/api": ">=2.0.0"
   },
   "devDependencies": {
-    "@syncular/react": "0.5.0"
+    "@syncular/react": "0.5.1"
   }
 }

package/src/index.ts

@@ -13,8 +13,9 @@
  * Every method forwards to the plugin's `syncular_command` command (the whole
  * command surface in one JSON envelope — `{method, params}`), mirroring the FFI
  * and the conformance shim. `query` uses the dedicated `syncular_query` fast
- * path (one IPC round trip per live-query run — fine at Tauri IPC latency; see
- * the README's pagination note for very large result sets). Client-observable
+ * path; atomic reactive reads use `syncular_query_snapshot`, backed by an
+ * independent read-only SQLite connection so network sync cannot stall local
+ * UI reads. Client-observable
  * events (`change` / `presence`) arrive on
  * the `syncular://event` Tauri event and fan out to the registered listeners.
  *
@@ -320,11 +321,18 @@ export class TauriSyncClient {
   async querySnapshot<Row = SqlRow>(
     spec: QueryReadSpec,
   ): Promise<QuerySnapshot<Row>> {
-    const result = (await this.#command('querySnapshot', {
-      sql: spec.sql,
-      params: (spec.params ?? []).map(encodeParam),
-      coverage: spec.coverage ?? [],
-    })) as {
+    const reply = await this.#tauri.invoke<CommandReply>(
+      `${PLUGIN}syncular_query_snapshot`,
+      {
+        sql: spec.sql,
+        params: (spec.params ?? []).map(encodeParam),
+        coverage: spec.coverage ?? [],
+      },
+    );
+    if (reply.error !== undefined) {
+      throw new TauriSyncError(reply.error.code, reply.error.message);
+    }
+    const result = reply.result as {
       revision: string;
       rows: Record<string, unknown>[];
       coverage: QuerySnapshot['coverage'];