@syncular/tauri 0.30.6 → 0.30.9

package/README.md

@@ -173,3 +173,16 @@ The snapshot API revision removes the individual `schemaFloor`, `leaseState`,
 `await client.statusSnapshot()`. Collection and outcome reads remain methods.
 React accepts the bridge directly. See the
 [client migration](https://syncular.dev/platform-web/#snapshot-api-migration).
+
+
+## Atomic sparse writes and retained conflicts
+
+The native client accepts mixed `patch`, `upsert` and `delete` operations in one
+`mutate` call. Sparse patches include the primary key and supplied columns.
+Omitted encrypted columns require no key and retain their ciphertext.
+
+Set `retainFailedCommits: true` to preserve rejected aggregate intent across
+pulls and restart. `commitOutcome(id).retainedRows` exposes intended rows and the
+latest authorized server base. Resolve with `resolved_keep_server`, or create a
+reviewed replacement and link it with `superseded`. Scope revocation and local
+security purge remove whole retained aggregates.

package/dist/index.d.ts

@@ -68,6 +68,7 @@ export interface TauriSyncClientConfig {
      * connected instead of falling back to HTTP.
      */
     readonly realtimePolicy?: SyncClientConfig['realtimePolicy'];
+    readonly retainFailedCommits?: boolean;
     /**
      * Portable E2EE keys and declarative per-row key-id columns. Raw keys are
      * encoded into the native command envelope and never sent to the server.
@@ -184,7 +185,8 @@ export declare class TauriSyncClient implements PromiseMethods<ClientSnapshotMet
 /** The error a `{error}` reply surfaces (mirrors the web-client `ClientSyncError`). */
 export declare class TauriSyncError extends Error {
     readonly code: string;
-    constructor(code: string, message: string);
+    readonly details: Readonly<Record<string, unknown>> | undefined;
+    constructor(code: string, message: string, details?: Readonly<Record<string, unknown>>);
 }
 /**
  * Construct the bridge and issue the native `create` (opening/attaching the

package/dist/index.js

@@ -176,7 +176,7 @@ export class TauriSyncClient {
         }
         const reply = await this.#tauri.invoke(`${PLUGIN}syncular_command`, { command: { method, params } });
         if (reply.error !== undefined) {
-            throw new TauriSyncError(reply.error.code, reply.error.message);
+            throw new TauriSyncError(reply.error.code, reply.error.message, reply.error.details ?? undefined);
         }
         return reply.result;
     }
@@ -358,7 +358,7 @@ export class TauriSyncClient {
         this.#requireActive();
         const reply = await this.#tauri.invoke(`${PLUGIN}syncular_query`, { sql, params: (params ?? []).map(encodeParam) });
         if (reply.error !== undefined) {
-            throw new TauriSyncError(reply.error.code, reply.error.message);
+            throw new TauriSyncError(reply.error.code, reply.error.message, reply.error.details ?? undefined);
         }
         const rows = reply.result.rows ?? [];
         return rows.map((r) => decodeRow(r));
@@ -372,7 +372,7 @@ export class TauriSyncClient {
             ...(spec.owner !== undefined ? { owner: spec.owner } : {}),
         });
         if (reply.error !== undefined) {
-            throw new TauriSyncError(reply.error.code, reply.error.message);
+            throw new TauriSyncError(reply.error.code, reply.error.message, reply.error.details ?? undefined);
         }
         const result = reply.result;
         return {
@@ -442,7 +442,7 @@ export class TauriSyncClient {
         this.#requireActive();
         const reply = await this.#tauri.invoke(`${PLUGIN}syncular_set_headers`, { headers });
         if (reply.error !== undefined) {
-            throw new TauriSyncError(reply.error.code, reply.error.message);
+            throw new TauriSyncError(reply.error.code, reply.error.message, reply.error.details ?? undefined);
         }
     }
     // -- Native CRDT (SPEC.md §5.10.5; needs the plugin `crdt-yjs` feature) ------
@@ -599,10 +599,12 @@ function decodeDiagnosticsSnapshot(value, kind) {
 /** The error a `{error}` reply surfaces (mirrors the web-client `ClientSyncError`). */
 export class TauriSyncError extends Error {
     code;
-    constructor(code, message) {
+    details;
+    constructor(code, message, details) {
         super(message);
         this.name = 'TauriSyncError';
         this.code = code;
+        this.details = details;
     }
 }
 function toStringSet(value) {
@@ -720,6 +722,9 @@ export async function createTauriSyncClient(config) {
                 ...(config.database !== undefined ? { database: config.database } : {}),
                 schema: config.schema,
                 ...(config.limits !== undefined ? { limits: config.limits } : {}),
+                ...(config.retainFailedCommits !== undefined
+                    ? { retainFailedCommits: config.retainFailedCommits }
+                    : {}),
                 ...(config.realtimePolicy !== undefined
                     ? { realtimePolicy: config.realtimePolicy }
                     : {}),
@@ -737,7 +742,7 @@ export async function createTauriSyncClient(config) {
     });
     if (reply.error !== undefined) {
         unlisten();
-        throw new TauriSyncError(reply.error.code, reply.error.message);
+        throw new TauriSyncError(reply.error.code, reply.error.message, reply.error.details ?? undefined);
     }
     return client;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@syncular/tauri",
-  "version": "0.30.6",
+  "version": "0.30.9",
   "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.30.6"
+    "@syncular/client": "0.30.9"
   },
   "peerDependencies": {
     "@tauri-apps/api": ">=2.0.0"
   },
   "devDependencies": {
-    "@syncular/react": "0.30.6"
+    "@syncular/react": "0.30.9"
   }
 }

package/src/index.ts

@@ -81,7 +81,11 @@ import {
 /** A driver-protocol reply: `{result}` on success or `{error}` on failure. */
 interface CommandReply {
   readonly result?: unknown;
-  readonly error?: { readonly code: string; readonly message: string };
+  readonly error?: {
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Readonly<Record<string, unknown>> | null;
+  };
 }
 
 /** One event pushed on `syncular://event` (the derived client-observable set). */
@@ -129,6 +133,7 @@ export interface TauriSyncClientConfig {
    * connected instead of falling back to HTTP.
    */
   readonly realtimePolicy?: SyncClientConfig['realtimePolicy'];
+  readonly retainFailedCommits?: boolean;
   /**
    * Portable E2EE keys and declarative per-row key-id columns. Raw keys are
    * encoded into the native command envelope and never sent to the server.
@@ -356,7 +361,11 @@ export class TauriSyncClient implements PromiseMethods<ClientSnapshotMethods> {
       { command: { method, params } },
     );
     if (reply.error !== undefined) {
-      throw new TauriSyncError(reply.error.code, reply.error.message);
+      throw new TauriSyncError(
+        reply.error.code,
+        reply.error.message,
+        reply.error.details ?? undefined,
+      );
     }
     return reply.result;
   }
@@ -566,7 +575,11 @@ export class TauriSyncClient implements PromiseMethods<ClientSnapshotMethods> {
       { sql, params: (params ?? []).map(encodeParam) },
     );
     if (reply.error !== undefined) {
-      throw new TauriSyncError(reply.error.code, reply.error.message);
+      throw new TauriSyncError(
+        reply.error.code,
+        reply.error.message,
+        reply.error.details ?? undefined,
+      );
     }
     const rows = (reply.result as { rows?: unknown[] }).rows ?? [];
     return rows.map((r) => decodeRow(r as Record<string, unknown>));
@@ -586,7 +599,11 @@ export class TauriSyncClient implements PromiseMethods<ClientSnapshotMethods> {
       },
     );
     if (reply.error !== undefined) {
-      throw new TauriSyncError(reply.error.code, reply.error.message);
+      throw new TauriSyncError(
+        reply.error.code,
+        reply.error.message,
+        reply.error.details ?? undefined,
+      );
     }
     const result = reply.result as {
       revision: string;
@@ -702,7 +719,11 @@ export class TauriSyncClient implements PromiseMethods<ClientSnapshotMethods> {
       { headers },
     );
     if (reply.error !== undefined) {
-      throw new TauriSyncError(reply.error.code, reply.error.message);
+      throw new TauriSyncError(
+        reply.error.code,
+        reply.error.message,
+        reply.error.details ?? undefined,
+      );
     }
   }
 
@@ -930,10 +951,16 @@ function decodeDiagnosticsSnapshot(
 /** The error a `{error}` reply surfaces (mirrors the web-client `ClientSyncError`). */
 export class TauriSyncError extends Error {
   readonly code: string;
-  constructor(code: string, message: string) {
+  readonly details: Readonly<Record<string, unknown>> | undefined;
+  constructor(
+    code: string,
+    message: string,
+    details?: Readonly<Record<string, unknown>>,
+  ) {
     super(message);
     this.name = 'TauriSyncError';
     this.code = code;
+    this.details = details;
   }
 }
 
@@ -1067,6 +1094,9 @@ export async function createTauriSyncClient(
         ...(config.database !== undefined ? { database: config.database } : {}),
         schema: config.schema,
         ...(config.limits !== undefined ? { limits: config.limits } : {}),
+        ...(config.retainFailedCommits !== undefined
+          ? { retainFailedCommits: config.retainFailedCommits }
+          : {}),
         ...(config.realtimePolicy !== undefined
           ? { realtimePolicy: config.realtimePolicy }
           : {}),
@@ -1084,7 +1114,11 @@ export async function createTauriSyncClient(
   });
   if (reply.error !== undefined) {
     unlisten();
-    throw new TauriSyncError(reply.error.code, reply.error.message);
+    throw new TauriSyncError(
+      reply.error.code,
+      reply.error.message,
+      reply.error.details ?? undefined,
+    );
   }
 
   return client;