@syncular/tauri 0.2.0 → 0.3.0

package/dist/index.d.ts

@@ -5,7 +5,7 @@
  * The Tauri host runs a REAL Rust syncular client (file DB + native HTTP+WS
  * transport). This module is a thin webview-side proxy that implements the SAME
  * `SyncClientLike` interface the React package normalizes — so the hooks
- * (`useSyncQuery`, `useMutation`, `usePresence`, …) work UNCHANGED against a
+ * (`useRawSql`, `useMutation`, `usePresence`, …) work UNCHANGED against a
  * Tauri app. It is the fourth host of one interface, after the direct
  * `SyncClient`, the worker-leader `SyncClientHandle`, and the multi-tab
  * follower (ROADMAP.md block 1).
@@ -77,6 +77,13 @@ export declare class TauriSyncClient {
     onPresence(listener: (scopeKey: string) => void): () => void;
     query(sql: string, params?: readonly SqlValue[]): Promise<SqlRow[]>;
     mutate(mutations: readonly MutationInput[]): Promise<string>;
+    /**
+     * Replace the native transport's request headers at runtime — the auth
+     * rotation path (RFC 0002 §2.3). Pass the FULL header set (it replaces,
+     * it does not merge). HTTP requests use the new set from the next call;
+     * the realtime socket applies it on its next (re)connect.
+     */
+    setHeaders(headers: Readonly<Record<string, string>>): Promise<void>;
     /** Materialize a `crdt` column's collaborative text — decoded from the
      * stored (server-merged) Yjs bytes. `name` selects the shared text
      * (default `"text"`). An absent row / NULL column is the empty document. */

package/dist/index.js

@@ -5,7 +5,7 @@
  * The Tauri host runs a REAL Rust syncular client (file DB + native HTTP+WS
  * transport). This module is a thin webview-side proxy that implements the SAME
  * `SyncClientLike` interface the React package normalizes — so the hooks
- * (`useSyncQuery`, `useMutation`, `usePresence`, …) work UNCHANGED against a
+ * (`useRawSql`, `useMutation`, `usePresence`, …) work UNCHANGED against a
  * Tauri app. It is the fourth host of one interface, after the direct
  * `SyncClient`, the worker-leader `SyncClientHandle`, and the multi-tab
  * follower (ROADMAP.md block 1).
@@ -72,6 +72,11 @@ function decodeCell(value) {
 function decodeRow(row) {
     const out = {};
     for (const [key, value] of Object.entries(row)) {
+        // Reserved `_sync_*` columns stay engine-internal (parity with the
+        // web client's `query()`), so a `SELECT *` row round-trips straight
+        // into `mutate()` values. Alias (`_sync_version AS v`) to read one.
+        if (key.startsWith('_sync_'))
+            continue;
         out[key] = decodeCell(value);
     }
     return out;
@@ -183,6 +188,18 @@ export class TauriSyncClient {
         }));
         return result.clientCommitId;
     }
+    /**
+     * Replace the native transport's request headers at runtime — the auth
+     * rotation path (RFC 0002 §2.3). Pass the FULL header set (it replaces,
+     * it does not merge). HTTP requests use the new set from the next call;
+     * the realtime socket applies it on its next (re)connect.
+     */
+    async setHeaders(headers) {
+        const reply = await this.#tauri.invoke(`${PLUGIN}syncular_set_headers`, { headers });
+        if (reply.error !== undefined) {
+            throw new TauriSyncError(reply.error.code, reply.error.message);
+        }
+    }
     // -- Native CRDT (SPEC.md §5.10.5; needs the plugin `crdt-yjs` feature) ------
     /** Materialize a `crdt` column's collaborative text — decoded from the
      * stored (server-merged) Yjs bytes. `name` selects the shared text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/tauri",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Tauri integration for the Syncular client",
   "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
@@ -28,7 +28,7 @@
   "exports": {
     ".": {
       "bun": "./src/index.ts",
-      "browser": "./src/index.ts",
+      "browser": "./dist/index.js",
       "import": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
@@ -48,7 +48,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@syncular/client": "0.2.0"
+    "@syncular/client": "0.2.1"
   },
   "peerDependencies": {
     "@tauri-apps/api": ">=2.0.0"
@@ -59,6 +59,6 @@
     }
   },
   "devDependencies": {
-    "@syncular/react": "0.2.0"
+    "@syncular/react": "0.2.1"
   }
 }

package/src/index.ts

@@ -5,7 +5,7 @@
  * The Tauri host runs a REAL Rust syncular client (file DB + native HTTP+WS
  * transport). This module is a thin webview-side proxy that implements the SAME
  * `SyncClientLike` interface the React package normalizes — so the hooks
- * (`useSyncQuery`, `useMutation`, `usePresence`, …) work UNCHANGED against a
+ * (`useRawSql`, `useMutation`, `usePresence`, …) work UNCHANGED against a
  * Tauri app. It is the fourth host of one interface, after the direct
  * `SyncClient`, the worker-leader `SyncClientHandle`, and the multi-tab
  * follower (ROADMAP.md block 1).
@@ -143,6 +143,10 @@ function decodeCell(value: unknown): SqlValue {
 function decodeRow(row: Record<string, unknown>): SqlRow {
   const out: SqlRow = {};
   for (const [key, value] of Object.entries(row)) {
+    // Reserved `_sync_*` columns stay engine-internal (parity with the
+    // web client's `query()`), so a `SELECT *` row round-trips straight
+    // into `mutate()` values. Alias (`_sync_version AS v`) to read one.
+    if (key.startsWith('_sync_')) continue;
     out[key] = decodeCell(value);
   }
   return out;
@@ -284,6 +288,22 @@ export class TauriSyncClient {
     return result.clientCommitId;
   }
 
+  /**
+   * Replace the native transport's request headers at runtime — the auth
+   * rotation path (RFC 0002 §2.3). Pass the FULL header set (it replaces,
+   * it does not merge). HTTP requests use the new set from the next call;
+   * the realtime socket applies it on its next (re)connect.
+   */
+  async setHeaders(headers: Readonly<Record<string, string>>): Promise<void> {
+    const reply = await this.#tauri.invoke<CommandReply>(
+      `${PLUGIN}syncular_set_headers`,
+      { headers },
+    );
+    if (reply.error !== undefined) {
+      throw new TauriSyncError(reply.error.code, reply.error.message);
+    }
+  }
+
   // -- Native CRDT (SPEC.md §5.10.5; needs the plugin `crdt-yjs` feature) ------
 
   /** Materialize a `crdt` column's collaborative text — decoded from the