@syncular/tauri 0.22.0 → 0.24.0

package/dist/index.d.ts

@@ -28,7 +28,7 @@ import type { ClientSnapshotMethods, PromiseMethods } from '@syncular/client';
  * `invoke`/`listen` either from its ESM entry points, from the ambient
  * `window.__TAURI__`, or via injected doubles (tests).
  */
-import type { ClientChangeListener, ClientDiagnosticsListener, ClientDiagnosticsRequest, ClientDiagnosticsSnapshot, CommitOutcome, CommitOutcomeQuery, ConflictRecord, EncryptionKeyringConfig, InvalidationListener, LocalDataPurgeInput, LocalDataPurgeResult, LocalDataRebootstrapInput, LocalDataRebootstrapResult, MutationInput, PresencePeer, QueryReadSpec, QuerySnapshot, RejectionRecord, ResolveCommitOutcomeInput, SecurityLifecycle, SqlRow, SqlValue, SyncStatusSnapshot, WindowBase, WindowState } from '@syncular/client';
+import type { ClientChangeListener, ClientDiagnosticsListener, ClientDiagnosticsRequest, ClientDiagnosticsSnapshot, CommitOutcome, CommitOutcomeQuery, ConflictRecord, EncryptionKeyringConfig, InvalidationListener, LocalDataPurgeInput, LocalDataPurgeResult, LocalDataRebootstrapInput, LocalDataRebootstrapResult, MutationInput, PresencePeer, PreviousVersionAudit, PreviousVersionReadSpec, PreviousVersionSnapshot, QueryReadSpec, QuerySnapshot, RejectionRecord, ResolveCommitOutcomeInput, SecurityLifecycle, SqlRow, SqlValue, SyncClientConfig, SyncStatusSnapshot, WindowBase, WindowState } from '@syncular/client';
 /** One event pushed on `syncular://event` (the derived client-observable set). */
 interface SyncularEvent {
     readonly type: string;
@@ -62,6 +62,12 @@ export interface TauriSyncClientConfig {
     readonly encryption?: EncryptionKeyringConfig;
     /** Open the native replica behind the fail-closed security gate. */
     readonly securityPreflight?: boolean;
+    /**
+     * RFC 0005 previous-version context, forwarded to the native `create`. The
+     * Rust create handler must read this key to enable capture; while it does
+     * not, the native core treats the feature as off (default-off).
+     */
+    readonly previousVersionContext?: SyncClientConfig['previousVersionContext'];
     /**
      * The Tauri primitives. Omit in a real Tauri webview to auto-resolve from
      * `@tauri-apps/api` (peer dep) or the ambient `window.__TAURI__`; inject in
@@ -114,6 +120,12 @@ export declare class TauriSyncClient implements PromiseMethods<ClientSnapshotMet
     }): Promise<string>;
     purgeLocalData(input: LocalDataPurgeInput): Promise<LocalDataPurgeResult>;
     rebootstrapLocalData(input: LocalDataRebootstrapInput): Promise<LocalDataRebootstrapResult>;
+    previousVersionSnapshot(spec: PreviousVersionReadSpec): Promise<PreviousVersionSnapshot>;
+    previousVersionAudit(): Promise<PreviousVersionAudit | undefined>;
+    previousVersionDiscard(): Promise<{
+        present: boolean;
+        discarded: boolean;
+    }>;
     /**
      * Replace the native transport's request headers at runtime — the auth
      * rotation path. Pass the FULL header set (it replaces,

package/dist/index.js

@@ -2,7 +2,7 @@ import { ProgressEmitter, } from '@syncular/client';
 // -- Types the bridge speaks (structurally the web-client's) -----------------
 // Most imports stay type-only; the stable preflight error code is shared at
 // runtime so every host surfaces byte-identical policy evidence.
-import { decodeLocalDataRebootstrapResult, SECURITY_PREFLIGHT_REQUIRED_CODE, withClientDiagnosticsHost, } from '@syncular/client';
+import { decodeLocalDataRebootstrapResult, decodePreviousVersionAuditResult, decodePreviousVersionDiscardResult, decodePreviousVersionSnapshot, SECURITY_PREFLIGHT_REQUIRED_CODE, withClientDiagnosticsHost, } from '@syncular/client';
 /** The plugin's Tauri event name — mirror of `tauri-plugin-syncular`. */
 export const SYNCULAR_EVENT = 'syncular://event';
 const PLUGIN = 'plugin:syncular|';
@@ -94,6 +94,25 @@ function decodeRow(row) {
     }
     return out;
 }
+/**
+ * Decode the JSON cell envelopes in an RFC 0005 snapshot reply's rows before
+ * the strict bridge decoder sees them; a malformed reply is passed through
+ * untouched so `decodePreviousVersionSnapshot` rejects it.
+ */
+function decodeSnapshotRows(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+        return value;
+    }
+    const source = value;
+    if (!Array.isArray(source.rows))
+        return value;
+    return {
+        ...source,
+        rows: source.rows.map((row) => row !== null && typeof row === 'object' && !Array.isArray(row)
+            ? decodeRow(row)
+            : row),
+    };
+}
 /** Resolve the Tauri primitives from the ambient environment when not injected. */
 async function resolveTauri(injected) {
     if (injected !== undefined)
@@ -150,6 +169,7 @@ export class TauriSyncClient {
                 'beginSecurityPreflight',
                 'activateSecurity',
                 'purgeLocalData',
+                'previousVersionDiscard',
                 'localRevision',
                 'statusSnapshot',
                 'shutdown',
@@ -390,6 +410,15 @@ export class TauriSyncClient {
     async rebootstrapLocalData(input) {
         return decodeLocalDataRebootstrapResult(await this.#command('rebootstrapLocalData', { input }));
     }
+    async previousVersionSnapshot(spec) {
+        return decodePreviousVersionSnapshot(decodeSnapshotRows(await this.#command('previousVersionSnapshot', { spec })));
+    }
+    async previousVersionAudit() {
+        return decodePreviousVersionAuditResult(await this.#command('previousVersionAudit', {}));
+    }
+    async previousVersionDiscard() {
+        return decodePreviousVersionDiscardResult(await this.#command('previousVersionDiscard', {}));
+    }
     /**
      * Replace the native transport's request headers at runtime — the auth
      * rotation path. Pass the FULL header set (it replaces,
@@ -683,6 +712,9 @@ export async function createTauriSyncClient(config) {
                 ...(config.securityPreflight !== undefined
                     ? { securityPreflight: config.securityPreflight }
                     : {}),
+                ...(config.previousVersionContext !== undefined
+                    ? { previousVersionContext: config.previousVersionContext }
+                    : {}),
             },
         },
     });

package/package.json

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

package/src/index.ts

@@ -51,6 +51,9 @@ import type {
   LocalDataRebootstrapResult,
   MutationInput,
   PresencePeer,
+  PreviousVersionAudit,
+  PreviousVersionReadSpec,
+  PreviousVersionSnapshot,
   QueryReadSpec,
   QuerySnapshot,
   RejectionRecord,
@@ -58,6 +61,7 @@ import type {
   SecurityLifecycle,
   SqlRow,
   SqlValue,
+  SyncClientConfig,
   SyncStatusSnapshot,
   WindowBase,
   WindowState,
@@ -67,6 +71,9 @@ import type {
 // runtime so every host surfaces byte-identical policy evidence.
 import {
   decodeLocalDataRebootstrapResult,
+  decodePreviousVersionAuditResult,
+  decodePreviousVersionDiscardResult,
+  decodePreviousVersionSnapshot,
   SECURITY_PREFLIGHT_REQUIRED_CODE,
   withClientDiagnosticsHost,
 } from '@syncular/client';
@@ -116,6 +123,12 @@ export interface TauriSyncClientConfig {
   readonly encryption?: EncryptionKeyringConfig;
   /** Open the native replica behind the fail-closed security gate. */
   readonly securityPreflight?: boolean;
+  /**
+   * RFC 0005 previous-version context, forwarded to the native `create`. The
+   * Rust create handler must read this key to enable capture; while it does
+   * not, the native core treats the feature as off (default-off).
+   */
+  readonly previousVersionContext?: SyncClientConfig['previousVersionContext'];
   /**
    * The Tauri primitives. Omit in a real Tauri webview to auto-resolve from
    * `@tauri-apps/api` (peer dep) or the ambient `window.__TAURI__`; inject in
@@ -225,6 +238,27 @@ function decodeRow(row: Record<string, unknown>): SqlRow {
   return out;
 }
 
+/**
+ * Decode the JSON cell envelopes in an RFC 0005 snapshot reply's rows before
+ * the strict bridge decoder sees them; a malformed reply is passed through
+ * untouched so `decodePreviousVersionSnapshot` rejects it.
+ */
+function decodeSnapshotRows(value: unknown): unknown {
+  if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+    return value;
+  }
+  const source = value as Record<string, unknown>;
+  if (!Array.isArray(source.rows)) return value;
+  return {
+    ...source,
+    rows: source.rows.map((row) =>
+      row !== null && typeof row === 'object' && !Array.isArray(row)
+        ? decodeRow(row as Record<string, unknown>)
+        : row,
+    ),
+  };
+}
+
 /** Resolve the Tauri primitives from the ambient environment when not injected. */
 async function resolveTauri(injected: TauriApi | undefined): Promise<TauriApi> {
   if (injected !== undefined) return injected;
@@ -301,6 +335,7 @@ export class TauriSyncClient implements PromiseMethods<ClientSnapshotMethods> {
         'beginSecurityPreflight',
         'activateSecurity',
         'purgeLocalData',
+        'previousVersionDiscard',
         'localRevision',
         'statusSnapshot',
         'shutdown',
@@ -602,6 +637,31 @@ export class TauriSyncClient implements PromiseMethods<ClientSnapshotMethods> {
     );
   }
 
+  async previousVersionSnapshot(
+    spec: PreviousVersionReadSpec,
+  ): Promise<PreviousVersionSnapshot> {
+    return decodePreviousVersionSnapshot(
+      decodeSnapshotRows(
+        await this.#command('previousVersionSnapshot', { spec }),
+      ),
+    );
+  }
+
+  async previousVersionAudit(): Promise<PreviousVersionAudit | undefined> {
+    return decodePreviousVersionAuditResult(
+      await this.#command('previousVersionAudit', {}),
+    );
+  }
+
+  async previousVersionDiscard(): Promise<{
+    present: boolean;
+    discarded: boolean;
+  }> {
+    return decodePreviousVersionDiscardResult(
+      await this.#command('previousVersionDiscard', {}),
+    );
+  }
+
   /**
    * Replace the native transport's request headers at runtime — the auth
    * rotation path. Pass the FULL header set (it replaces,
@@ -985,6 +1045,9 @@ export async function createTauriSyncClient(
         ...(config.securityPreflight !== undefined
           ? { securityPreflight: config.securityPreflight }
           : {}),
+        ...(config.previousVersionContext !== undefined
+          ? { previousVersionContext: config.previousVersionContext }
+          : {}),
       },
     },
   });