@tanstack/electron-db-sqlite-persistence 0.2.8 → 0.2.9

package/README.md

@@ -108,10 +108,17 @@ publishes nor consumes a coordinator sequence.
 
 If a mutating RPC loses its response, Electron coordination replays it only
 while the requester still knows the same non-null leader id and term. An
-unknown initial route or any leader/term change rejects with
-`IndeterminateCommitError`; the application must reconcile the outcome. The
-coordinator does not retry that mutation against an unknown or replacement
-leader.
+unknown initial route or any leader/term change rejects the direct RPC with
+`IndeterminateCommitError`. For a source-backed persisted Collection, the sync
+wrapper can certify the original transaction ID through the replacement leader
+and the main-process SQLite adapter. Application-issued mutations still need
+caller reconciliation. Main and renderer must use matching persistence protocol
+v4 peers for this IPC operation. A main-process adapter used by an
+`ElectronCollectionCoordinator` must implement `reserveLeadershipTerm` so each
+election reserves a durable term before publishing a route. An adapter without
+that capability can still serve single-renderer persistence through
+`SingleProcessCoordinator`; a coordinated election rejects it before route
+publication.
 
 Remote-subset requests use the same crash-only boundary. The coordinator
 projects a live `LoadSubsetOptions` input to the exported

package/dist/cjs/errors.d.cts

@@ -1,10 +1,10 @@
 import { ElectronPersistenceMethod, ElectronSerializedError } from './protocol.cjs';
 type ElectronPersistenceErrorOptions = {
-    code?: string;
+    code?: string | number;
     cause?: unknown;
 };
 export declare class ElectronPersistenceError extends Error {
-    readonly code: string | undefined;
+    readonly code: string | number | undefined;
     constructor(message: string, options?: ElectronPersistenceErrorOptions);
 }
 export declare class UnknownElectronPersistenceCollectionError extends ElectronPersistenceError {

package/dist/cjs/main.cjs

@@ -11,12 +11,16 @@ function serializeError(error) {
       code: void 0
     };
   }
-  const codedError = error;
+  const detailedError = error;
+  const path = detailedError.path;
   return {
     name: error.name || `Error`,
     message: error.message || fallbackMessage,
     stack: error.stack,
-    code: typeof codedError.code === `string` ? codedError.code : void 0
+    code: typeof detailedError.code === `string` || typeof detailedError.code === `number` ? detailedError.code : void 0,
+    path: typeof path === `string` || Array.isArray(path) && path.every(
+      (segment) => typeof segment === `string` || typeof segment === `number`
+    ) ? path : void 0
   };
 }
 function createErrorResponse(request, error) {
@@ -117,6 +121,20 @@ async function executeRequestAgainstAdapter(request, adapter) {
         result: null
       };
     }
+    case `reconcileCommittedTx`: {
+      const result = adapter.reconcileCommittedTx ? await adapter.reconcileCommittedTx(
+        request.collectionId,
+        request.payload.tx,
+        request.payload.anchor
+      ) : { kind: `unknown` };
+      return {
+        v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
+        requestId: request.requestId,
+        method: request.method,
+        ok: true,
+        result
+      };
+    }
     case `ensureIndex`: {
       await adapter.ensureIndex(
         request.collectionId,
@@ -167,6 +185,24 @@ async function executeRequestAgainstAdapter(request, adapter) {
         result
       };
     }
+    case `reserveLeadershipTerm`: {
+      if (!adapter.reserveLeadershipTerm) {
+        throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+          `reserveLeadershipTerm is not supported by the configured electron persistence adapter`
+        );
+      }
+      const position = await adapter.reserveLeadershipTerm(
+        request.collectionId,
+        request.payload.observedTerm
+      );
+      return {
+        v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
+        requestId: request.requestId,
+        method: request.method,
+        ok: true,
+        result: position
+      };
+    }
     case `getStreamPosition`: {
       if (!adapter.getStreamPosition) {
         throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(

package/dist/cjs/main.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"main.cjs","sources":["../../src/main.ts"],"sourcesContent":["import { InvalidPersistedCollectionConfigError } from '@tanstack/db-sqlite-persistence-core'\nimport {\n  DEFAULT_ELECTRON_PERSISTENCE_CHANNEL,\n  ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n} from './protocol'\nimport type {\n  PersistedCollectionPersistence,\n  PersistenceAdapter,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\nimport type {\n  ElectronPersistedKey,\n  ElectronPersistedRow,\n  ElectronPersistenceRequestEnvelope,\n  ElectronPersistenceResponseEnvelope,\n  ElectronSerializedError,\n} from './protocol'\n\ntype ElectronMainPersistenceAdapter = PersistenceAdapter & {\n  loadCollectionMetadata?: (\n    collectionId: string,\n  ) => Promise<Array<{ key: string; value: unknown }>>\n  scanRows?: (\n    collectionId: string,\n    options?: { metadataOnly?: boolean },\n  ) => Promise<\n    Array<{\n      key: ElectronPersistedKey\n      value: ElectronPersistedRow\n      metadata?: unknown\n    }>\n  >\n  pullSince?: (\n    collectionId: string,\n    fromRowVersion: number,\n  ) => Promise<SQLitePullSinceResult<ElectronPersistedKey>>\n  getStreamPosition?: (collectionId: string) => Promise<{\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n  }>\n}\n\nfunction serializeError(error: unknown): ElectronSerializedError {\n  const fallbackMessage = `Unknown electron persistence error`\n\n  if (!(error instanceof Error)) {\n    return {\n      name: `Error`,\n      message: fallbackMessage,\n      code: undefined,\n    }\n  }\n\n  const codedError = error as Error & { code?: unknown }\n  return {\n    name: error.name || `Error`,\n    message: error.message || fallbackMessage,\n    stack: error.stack,\n    code: typeof codedError.code === `string` ? codedError.code : undefined,\n  }\n}\n\nfunction createErrorResponse(\n  request: ElectronPersistenceRequestEnvelope,\n  error: unknown,\n): ElectronPersistenceResponseEnvelope {\n  return {\n    v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n    requestId: request.requestId,\n    method: request.method,\n    ok: false,\n    error: serializeError(error),\n  }\n}\n\nfunction assertValidRequest(request: ElectronPersistenceRequestEnvelope): void {\n  if (request.v !== ELECTRON_PERSISTENCE_PROTOCOL_VERSION) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Unsupported electron persistence protocol version \"${request.v}\"`,\n    )\n  }\n\n  if (\n    typeof request.requestId !== `string` ||\n    request.requestId.trim().length === 0\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence requestId cannot be empty`,\n    )\n  }\n\n  if (\n    typeof request.collectionId !== `string` ||\n    request.collectionId.trim().length === 0\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence collectionId cannot be empty`,\n    )\n  }\n}\n\nasync function executeRequestAgainstAdapter(\n  request: ElectronPersistenceRequestEnvelope,\n  adapter: ElectronMainPersistenceAdapter,\n): Promise<ElectronPersistenceResponseEnvelope> {\n  switch (request.method) {\n    case `loadSubset`: {\n      const result = await adapter.loadSubset(\n        request.collectionId,\n        request.payload.options,\n        request.payload.ctx,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `loadResumeSnapshot`: {\n      const result = await adapter.loadResumeSnapshot(\n        request.collectionId,\n        request.payload.ctx,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `loadCollectionMetadata`: {\n      if (!adapter.loadCollectionMetadata) {\n        throw new InvalidPersistedCollectionConfigError(\n          `loadCollectionMetadata is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.loadCollectionMetadata(request.collectionId)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `scanRows`: {\n      if (!adapter.scanRows) {\n        throw new InvalidPersistedCollectionConfigError(\n          `scanRows is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.scanRows(\n        request.collectionId,\n        request.payload.options,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `applyCommittedTx`: {\n      await adapter.applyCommittedTx(request.collectionId, request.payload.tx)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `ensureIndex`: {\n      await adapter.ensureIndex(\n        request.collectionId,\n        request.payload.signature,\n        request.payload.spec,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `markIndexRemoved`: {\n      if (!adapter.markIndexRemoved) {\n        throw new InvalidPersistedCollectionConfigError(\n          `markIndexRemoved is not supported by the configured electron persistence adapter`,\n        )\n      }\n      await adapter.markIndexRemoved(\n        request.collectionId,\n        request.payload.signature,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `pullSince`: {\n      if (!adapter.pullSince) {\n        throw new InvalidPersistedCollectionConfigError(\n          `pullSince is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.pullSince(\n        request.collectionId,\n        request.payload.fromRowVersion,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `getStreamPosition`: {\n      if (!adapter.getStreamPosition) {\n        throw new InvalidPersistedCollectionConfigError(\n          `getStreamPosition is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const position = await adapter.getStreamPosition(request.collectionId)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: position,\n      }\n    }\n  }\n}\n\nfunction resolveModeAwarePersistence(\n  persistence: PersistedCollectionPersistence,\n  request: ElectronPersistenceRequestEnvelope,\n): PersistedCollectionPersistence {\n  const mode = request.resolution?.mode ?? `sync-absent`\n  const schemaVersion = request.resolution?.schemaVersion\n  const collectionAwarePersistence =\n    persistence.resolvePersistenceForCollection?.({\n      collectionId: request.collectionId,\n      mode,\n      schemaVersion,\n    })\n  if (collectionAwarePersistence) {\n    return collectionAwarePersistence\n  }\n\n  const modeAwarePersistence = persistence.resolvePersistenceForMode?.(mode)\n  return modeAwarePersistence ?? persistence\n}\n\nexport type ElectronIpcMainLike = {\n  handle: (\n    channel: string,\n    listener: (\n      event: unknown,\n      request: ElectronPersistenceRequestEnvelope,\n    ) => Promise<ElectronPersistenceResponseEnvelope>,\n  ) => void\n  removeHandler?: (channel: string) => void\n}\n\nexport type ElectronSQLiteMainProcessOptions = {\n  persistence: PersistedCollectionPersistence\n  ipcMain: ElectronIpcMainLike\n  channel?: string\n}\n\nexport function exposeElectronSQLitePersistence(\n  options: ElectronSQLiteMainProcessOptions,\n): () => void {\n  const channel = options.channel ?? DEFAULT_ELECTRON_PERSISTENCE_CHANNEL\n  options.ipcMain.handle(\n    channel,\n    async (\n      _event,\n      request: ElectronPersistenceRequestEnvelope,\n    ): Promise<ElectronPersistenceResponseEnvelope> => {\n      try {\n        assertValidRequest(request)\n        const modeAwarePersistence = resolveModeAwarePersistence(\n          options.persistence,\n          request,\n        )\n        return await executeRequestAgainstAdapter(\n          request,\n          modeAwarePersistence.adapter,\n        )\n      } catch (error) {\n        return createErrorResponse(request, error)\n      }\n    },\n  )\n\n  return () => {\n    options.ipcMain.removeHandler?.(channel)\n  }\n}\n"],"names":["ELECTRON_PERSISTENCE_PROTOCOL_VERSION","InvalidPersistedCollectionConfigError","DEFAULT_ELECTRON_PERSISTENCE_CHANNEL"],"mappings":"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"}
+{"version":3,"file":"main.cjs","sources":["../../src/main.ts"],"sourcesContent":["import { InvalidPersistedCollectionConfigError } from '@tanstack/db-sqlite-persistence-core'\nimport {\n  DEFAULT_ELECTRON_PERSISTENCE_CHANNEL,\n  ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n} from './protocol'\nimport type {\n  PersistedCollectionPersistence,\n  PersistenceAdapter,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\nimport type {\n  ElectronPersistedKey,\n  ElectronPersistedRow,\n  ElectronPersistenceRequestEnvelope,\n  ElectronPersistenceResponseEnvelope,\n  ElectronSerializedError,\n} from './protocol'\n\ntype ElectronMainPersistenceAdapter = PersistenceAdapter & {\n  loadCollectionMetadata?: (\n    collectionId: string,\n  ) => Promise<Array<{ key: string; value: unknown }>>\n  scanRows?: (\n    collectionId: string,\n    options?: { metadataOnly?: boolean },\n  ) => Promise<\n    Array<{\n      key: ElectronPersistedKey\n      value: ElectronPersistedRow\n      metadata?: unknown\n    }>\n  >\n  pullSince?: (\n    collectionId: string,\n    fromRowVersion: number,\n  ) => Promise<SQLitePullSinceResult<ElectronPersistedKey>>\n  getStreamPosition?: (collectionId: string) => Promise<{\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n  }>\n}\n\nfunction serializeError(error: unknown): ElectronSerializedError {\n  const fallbackMessage = `Unknown electron persistence error`\n\n  if (!(error instanceof Error)) {\n    return {\n      name: `Error`,\n      message: fallbackMessage,\n      code: undefined,\n    }\n  }\n\n  const detailedError = error as Error & { code?: unknown; path?: unknown }\n  const path = detailedError.path\n  return {\n    name: error.name || `Error`,\n    message: error.message || fallbackMessage,\n    stack: error.stack,\n    code:\n      typeof detailedError.code === `string` ||\n      typeof detailedError.code === `number`\n        ? detailedError.code\n        : undefined,\n    path:\n      typeof path === `string` ||\n      (Array.isArray(path) &&\n        path.every(\n          (segment: unknown) =>\n            typeof segment === `string` || typeof segment === `number`,\n        ))\n        ? (path as string | ReadonlyArray<string | number>)\n        : undefined,\n  }\n}\n\nfunction createErrorResponse(\n  request: ElectronPersistenceRequestEnvelope,\n  error: unknown,\n): ElectronPersistenceResponseEnvelope {\n  return {\n    v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n    requestId: request.requestId,\n    method: request.method,\n    ok: false,\n    error: serializeError(error),\n  }\n}\n\nfunction assertValidRequest(request: ElectronPersistenceRequestEnvelope): void {\n  if (request.v !== ELECTRON_PERSISTENCE_PROTOCOL_VERSION) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Unsupported electron persistence protocol version \"${request.v}\"`,\n    )\n  }\n\n  if (\n    typeof request.requestId !== `string` ||\n    request.requestId.trim().length === 0\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence requestId cannot be empty`,\n    )\n  }\n\n  if (\n    typeof request.collectionId !== `string` ||\n    request.collectionId.trim().length === 0\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence collectionId cannot be empty`,\n    )\n  }\n}\n\nasync function executeRequestAgainstAdapter(\n  request: ElectronPersistenceRequestEnvelope,\n  adapter: ElectronMainPersistenceAdapter,\n): Promise<ElectronPersistenceResponseEnvelope> {\n  switch (request.method) {\n    case `loadSubset`: {\n      const result = await adapter.loadSubset(\n        request.collectionId,\n        request.payload.options,\n        request.payload.ctx,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `loadResumeSnapshot`: {\n      const result = await adapter.loadResumeSnapshot(\n        request.collectionId,\n        request.payload.ctx,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `loadCollectionMetadata`: {\n      if (!adapter.loadCollectionMetadata) {\n        throw new InvalidPersistedCollectionConfigError(\n          `loadCollectionMetadata is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.loadCollectionMetadata(request.collectionId)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `scanRows`: {\n      if (!adapter.scanRows) {\n        throw new InvalidPersistedCollectionConfigError(\n          `scanRows is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.scanRows(\n        request.collectionId,\n        request.payload.options,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `applyCommittedTx`: {\n      await adapter.applyCommittedTx(request.collectionId, request.payload.tx)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `reconcileCommittedTx`: {\n      const result = adapter.reconcileCommittedTx\n        ? await adapter.reconcileCommittedTx(\n            request.collectionId,\n            request.payload.tx,\n            request.payload.anchor,\n          )\n        : { kind: `unknown` as const }\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `ensureIndex`: {\n      await adapter.ensureIndex(\n        request.collectionId,\n        request.payload.signature,\n        request.payload.spec,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `markIndexRemoved`: {\n      if (!adapter.markIndexRemoved) {\n        throw new InvalidPersistedCollectionConfigError(\n          `markIndexRemoved is not supported by the configured electron persistence adapter`,\n        )\n      }\n      await adapter.markIndexRemoved(\n        request.collectionId,\n        request.payload.signature,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `pullSince`: {\n      if (!adapter.pullSince) {\n        throw new InvalidPersistedCollectionConfigError(\n          `pullSince is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.pullSince(\n        request.collectionId,\n        request.payload.fromRowVersion,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `reserveLeadershipTerm`: {\n      if (!adapter.reserveLeadershipTerm) {\n        throw new InvalidPersistedCollectionConfigError(\n          `reserveLeadershipTerm is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const position = await adapter.reserveLeadershipTerm(\n        request.collectionId,\n        request.payload.observedTerm,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: position,\n      }\n    }\n\n    case `getStreamPosition`: {\n      if (!adapter.getStreamPosition) {\n        throw new InvalidPersistedCollectionConfigError(\n          `getStreamPosition is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const position = await adapter.getStreamPosition(request.collectionId)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: position,\n      }\n    }\n  }\n}\n\nfunction resolveModeAwarePersistence(\n  persistence: PersistedCollectionPersistence,\n  request: ElectronPersistenceRequestEnvelope,\n): PersistedCollectionPersistence {\n  const mode = request.resolution?.mode ?? `sync-absent`\n  const schemaVersion = request.resolution?.schemaVersion\n  const collectionAwarePersistence =\n    persistence.resolvePersistenceForCollection?.({\n      collectionId: request.collectionId,\n      mode,\n      schemaVersion,\n    })\n  if (collectionAwarePersistence) {\n    return collectionAwarePersistence\n  }\n\n  const modeAwarePersistence = persistence.resolvePersistenceForMode?.(mode)\n  return modeAwarePersistence ?? persistence\n}\n\nexport type ElectronIpcMainLike = {\n  handle: (\n    channel: string,\n    listener: (\n      event: unknown,\n      request: ElectronPersistenceRequestEnvelope,\n    ) => Promise<ElectronPersistenceResponseEnvelope>,\n  ) => void\n  removeHandler?: (channel: string) => void\n}\n\nexport type ElectronSQLiteMainProcessOptions = {\n  persistence: PersistedCollectionPersistence\n  ipcMain: ElectronIpcMainLike\n  channel?: string\n}\n\nexport function exposeElectronSQLitePersistence(\n  options: ElectronSQLiteMainProcessOptions,\n): () => void {\n  const channel = options.channel ?? DEFAULT_ELECTRON_PERSISTENCE_CHANNEL\n  options.ipcMain.handle(\n    channel,\n    async (\n      _event,\n      request: ElectronPersistenceRequestEnvelope,\n    ): Promise<ElectronPersistenceResponseEnvelope> => {\n      try {\n        assertValidRequest(request)\n        const modeAwarePersistence = resolveModeAwarePersistence(\n          options.persistence,\n          request,\n        )\n        return await executeRequestAgainstAdapter(\n          request,\n          modeAwarePersistence.adapter,\n        )\n      } catch (error) {\n        return createErrorResponse(request, error)\n      }\n    },\n  )\n\n  return () => {\n    options.ipcMain.removeHandler?.(channel)\n  }\n}\n"],"names":["ELECTRON_PERSISTENCE_PROTOCOL_VERSION","InvalidPersistedCollectionConfigError","DEFAULT_ELECTRON_PERSISTENCE_CHANNEL"],"mappings":"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"}

package/dist/cjs/protocol.cjs

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 2;
+const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 4;
 const DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = `tanstack-db:sqlite-persistence`;
 exports.DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = DEFAULT_ELECTRON_PERSISTENCE_CHANNEL;
 exports.ELECTRON_PERSISTENCE_PROTOCOL_VERSION = ELECTRON_PERSISTENCE_PROTOCOL_VERSION;

package/dist/cjs/protocol.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.cjs","sources":["../../src/protocol.ts"],"sourcesContent":["import type { LoadSubsetOptions } from '@tanstack/db'\nimport type {\n  PersistedCollectionMode,\n  PersistedIndexSpec,\n  PersistedKeySetEvidence,\n  PersistedTx,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\n\nexport const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 2 as const\nexport const DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = `tanstack-db:sqlite-persistence`\n\nexport type ElectronPersistedRow = Record<string, unknown>\nexport type ElectronPersistedKey = string | number\n\nexport type ElectronPersistenceResolution = {\n  mode: PersistedCollectionMode\n  schemaVersion?: number\n}\n\nexport type ElectronPersistenceMethod =\n  | `loadSubset`\n  | `loadResumeSnapshot`\n  | `loadCollectionMetadata`\n  | `scanRows`\n  | `applyCommittedTx`\n  | `ensureIndex`\n  | `markIndexRemoved`\n  | `pullSince`\n  | `getStreamPosition`\n\nexport type ElectronPersistencePayloadMap = {\n  loadSubset: {\n    options: LoadSubsetOptions\n    ctx?: { requiredIndexSignatures?: ReadonlyArray<string> }\n  }\n  loadResumeSnapshot: {\n    ctx?: {\n      requiredIndexSignatures?: ReadonlyArray<string>\n      includeRows?: boolean\n    }\n  }\n  loadCollectionMetadata: {}\n  scanRows: {\n    options?: {\n      metadataOnly?: boolean\n    }\n  }\n  applyCommittedTx: {\n    tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>\n  }\n  ensureIndex: {\n    signature: string\n    spec: PersistedIndexSpec\n  }\n  markIndexRemoved: {\n    signature: string\n  }\n  pullSince: {\n    fromRowVersion: number\n  }\n  getStreamPosition: {}\n}\n\nexport type ElectronPersistenceResultMap = {\n  loadSubset: Array<{ key: ElectronPersistedKey; value: ElectronPersistedRow }>\n  loadResumeSnapshot: {\n    rows: Array<{\n      key: ElectronPersistedKey\n      value: ElectronPersistedRow\n      metadata?: unknown\n    }>\n    keySet?: PersistedKeySetEvidence\n    collectionMetadata: Array<{ key: string; value: unknown }>\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n    resetEpoch: number\n  }\n  loadCollectionMetadata: Array<{ key: string; value: unknown }>\n  scanRows: Array<{\n    key: ElectronPersistedKey\n    value: ElectronPersistedRow\n    metadata?: unknown\n  }>\n  applyCommittedTx: null\n  ensureIndex: null\n  markIndexRemoved: null\n  pullSince: SQLitePullSinceResult<ElectronPersistedKey>\n  getStreamPosition: {\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n  }\n}\n\nexport type ElectronSerializedError = {\n  name: string\n  message: string\n  stack?: string\n  code?: string\n}\n\nexport type ElectronPersistenceRequestByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    collectionId: string\n    resolution?: ElectronPersistenceResolution\n    method: Method\n    payload: ElectronPersistencePayloadMap[Method]\n  }\n}\n\nexport type ElectronPersistenceRequest<\n  TMethod extends ElectronPersistenceMethod = ElectronPersistenceMethod,\n> = ElectronPersistenceRequestByMethod[TMethod]\n\nexport type ElectronPersistenceRequestEnvelope =\n  ElectronPersistenceRequestByMethod[ElectronPersistenceMethod]\n\ntype ElectronPersistenceSuccessResponseByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    method: Method\n    ok: true\n    result: ElectronPersistenceResultMap[Method]\n  }\n}\n\ntype ElectronPersistenceErrorResponseByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    method: Method\n    ok: false\n    error: ElectronSerializedError\n  }\n}\n\nexport type ElectronPersistenceResponse<\n  TMethod extends ElectronPersistenceMethod = ElectronPersistenceMethod,\n> =\n  | ElectronPersistenceSuccessResponseByMethod[TMethod]\n  | ElectronPersistenceErrorResponseByMethod[TMethod]\n\nexport type ElectronPersistenceResponseEnvelope =\n  ElectronPersistenceResponse<ElectronPersistenceMethod>\n\nexport type ElectronPersistenceRequestHandler = (\n  request: ElectronPersistenceRequestEnvelope,\n) => Promise<ElectronPersistenceResponseEnvelope>\n\nexport type ElectronPersistenceInvoke = (\n  channel: string,\n  request: ElectronPersistenceRequestEnvelope,\n) => Promise<ElectronPersistenceResponseEnvelope>\n"],"names":[],"mappings":";;AASO,MAAM,wCAAwC;AAC9C,MAAM,uCAAuC;;;"}
+{"version":3,"file":"protocol.cjs","sources":["../../src/protocol.ts"],"sourcesContent":["import type { LoadSubsetOptions } from '@tanstack/db'\nimport type {\n  CommittedTxAnchor,\n  PersistedCollectionMode,\n  PersistedIndexSpec,\n  PersistedKeySetEvidence,\n  PersistedTx,\n  ReconciledCommittedTx,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\n\nexport const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 4 as const\nexport const DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = `tanstack-db:sqlite-persistence`\n\nexport type ElectronPersistedRow = Record<string, unknown>\nexport type ElectronPersistedKey = string | number\n\nexport type ElectronPersistenceResolution = {\n  mode: PersistedCollectionMode\n  schemaVersion?: number\n}\n\nexport type ElectronPersistenceMethod =\n  | `loadSubset`\n  | `loadResumeSnapshot`\n  | `loadCollectionMetadata`\n  | `scanRows`\n  | `applyCommittedTx`\n  | `reconcileCommittedTx`\n  | `ensureIndex`\n  | `markIndexRemoved`\n  | `pullSince`\n  | `getStreamPosition`\n  | `reserveLeadershipTerm`\n\nexport type ElectronPersistencePayloadMap = {\n  loadSubset: {\n    options: LoadSubsetOptions\n    ctx?: { requiredIndexSignatures?: ReadonlyArray<string> }\n  }\n  loadResumeSnapshot: {\n    ctx?: {\n      requiredIndexSignatures?: ReadonlyArray<string>\n      includeRows?: boolean\n    }\n  }\n  loadCollectionMetadata: {}\n  scanRows: {\n    options?: {\n      metadataOnly?: boolean\n    }\n  }\n  applyCommittedTx: {\n    tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>\n  }\n  reconcileCommittedTx: {\n    tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>\n    anchor: CommittedTxAnchor\n  }\n  ensureIndex: {\n    signature: string\n    spec: PersistedIndexSpec\n  }\n  markIndexRemoved: {\n    signature: string\n  }\n  pullSince: {\n    fromRowVersion: number\n  }\n  getStreamPosition: {}\n  reserveLeadershipTerm: { observedTerm: number }\n}\n\nexport type ElectronPersistenceResultMap = {\n  loadSubset: Array<{ key: ElectronPersistedKey; value: ElectronPersistedRow }>\n  loadResumeSnapshot: {\n    rows: Array<{\n      key: ElectronPersistedKey\n      value: ElectronPersistedRow\n      metadata?: unknown\n    }>\n    keySet?: PersistedKeySetEvidence\n    collectionMetadata: Array<{ key: string; value: unknown }>\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n    resetEpoch: number\n  }\n  loadCollectionMetadata: Array<{ key: string; value: unknown }>\n  scanRows: Array<{\n    key: ElectronPersistedKey\n    value: ElectronPersistedRow\n    metadata?: unknown\n  }>\n  applyCommittedTx: null\n  reconcileCommittedTx: ReconciledCommittedTx\n  ensureIndex: null\n  markIndexRemoved: null\n  pullSince: SQLitePullSinceResult<ElectronPersistedKey>\n  getStreamPosition: {\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n  }\n  reserveLeadershipTerm: {\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n  }\n}\n\nexport type ElectronSerializedError = {\n  name: string\n  message: string\n  stack?: string\n  code?: string | number\n  path?: string | ReadonlyArray<string | number>\n}\n\nexport type ElectronPersistenceRequestByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    collectionId: string\n    resolution?: ElectronPersistenceResolution\n    method: Method\n    payload: ElectronPersistencePayloadMap[Method]\n  }\n}\n\nexport type ElectronPersistenceRequest<\n  TMethod extends ElectronPersistenceMethod = ElectronPersistenceMethod,\n> = ElectronPersistenceRequestByMethod[TMethod]\n\nexport type ElectronPersistenceRequestEnvelope =\n  ElectronPersistenceRequestByMethod[ElectronPersistenceMethod]\n\ntype ElectronPersistenceSuccessResponseByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    method: Method\n    ok: true\n    result: ElectronPersistenceResultMap[Method]\n  }\n}\n\ntype ElectronPersistenceErrorResponseByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    method: Method\n    ok: false\n    error: ElectronSerializedError\n  }\n}\n\nexport type ElectronPersistenceResponse<\n  TMethod extends ElectronPersistenceMethod = ElectronPersistenceMethod,\n> =\n  | ElectronPersistenceSuccessResponseByMethod[TMethod]\n  | ElectronPersistenceErrorResponseByMethod[TMethod]\n\nexport type ElectronPersistenceResponseEnvelope =\n  ElectronPersistenceResponse<ElectronPersistenceMethod>\n\nexport type ElectronPersistenceRequestHandler = (\n  request: ElectronPersistenceRequestEnvelope,\n) => Promise<ElectronPersistenceResponseEnvelope>\n\nexport type ElectronPersistenceInvoke = (\n  channel: string,\n  request: ElectronPersistenceRequestEnvelope,\n) => Promise<ElectronPersistenceResponseEnvelope>\n"],"names":[],"mappings":";;AAWO,MAAM,wCAAwC;AAC9C,MAAM,uCAAuC;;;"}

package/dist/cjs/protocol.d.cts

@@ -1,6 +1,6 @@
 import { LoadSubsetOptions } from '@tanstack/db';
-import { PersistedCollectionMode, PersistedIndexSpec, PersistedKeySetEvidence, PersistedTx, SQLitePullSinceResult } from '@tanstack/db-sqlite-persistence-core';
-export declare const ELECTRON_PERSISTENCE_PROTOCOL_VERSION: 2;
+import { CommittedTxAnchor, PersistedCollectionMode, PersistedIndexSpec, PersistedKeySetEvidence, PersistedTx, ReconciledCommittedTx, SQLitePullSinceResult } from '@tanstack/db-sqlite-persistence-core';
+export declare const ELECTRON_PERSISTENCE_PROTOCOL_VERSION: 4;
 export declare const DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = "tanstack-db:sqlite-persistence";
 export type ElectronPersistedRow = Record<string, unknown>;
 export type ElectronPersistedKey = string | number;
@@ -8,7 +8,7 @@ export type ElectronPersistenceResolution = {
     mode: PersistedCollectionMode;
     schemaVersion?: number;
 };
-export type ElectronPersistenceMethod = `loadSubset` | `loadResumeSnapshot` | `loadCollectionMetadata` | `scanRows` | `applyCommittedTx` | `ensureIndex` | `markIndexRemoved` | `pullSince` | `getStreamPosition`;
+export type ElectronPersistenceMethod = `loadSubset` | `loadResumeSnapshot` | `loadCollectionMetadata` | `scanRows` | `applyCommittedTx` | `reconcileCommittedTx` | `ensureIndex` | `markIndexRemoved` | `pullSince` | `getStreamPosition` | `reserveLeadershipTerm`;
 export type ElectronPersistencePayloadMap = {
     loadSubset: {
         options: LoadSubsetOptions;
@@ -31,6 +31,10 @@ export type ElectronPersistencePayloadMap = {
     applyCommittedTx: {
         tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>;
     };
+    reconcileCommittedTx: {
+        tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>;
+        anchor: CommittedTxAnchor;
+    };
     ensureIndex: {
         signature: string;
         spec: PersistedIndexSpec;
@@ -42,6 +46,9 @@ export type ElectronPersistencePayloadMap = {
         fromRowVersion: number;
     };
     getStreamPosition: {};
+    reserveLeadershipTerm: {
+        observedTerm: number;
+    };
 };
 export type ElectronPersistenceResultMap = {
     loadSubset: Array<{
@@ -74,6 +81,7 @@ export type ElectronPersistenceResultMap = {
         metadata?: unknown;
     }>;
     applyCommittedTx: null;
+    reconcileCommittedTx: ReconciledCommittedTx;
     ensureIndex: null;
     markIndexRemoved: null;
     pullSince: SQLitePullSinceResult<ElectronPersistedKey>;
@@ -82,12 +90,18 @@ export type ElectronPersistenceResultMap = {
         latestSeq: number;
         latestRowVersion: number;
     };
+    reserveLeadershipTerm: {
+        latestTerm: number;
+        latestSeq: number;
+        latestRowVersion: number;
+    };
 };
 export type ElectronSerializedError = {
     name: string;
     message: string;
     stack?: string;
-    code?: string;
+    code?: string | number;
+    path?: string | ReadonlyArray<string | number>;
 };
 export type ElectronPersistenceRequestByMethod = {
     [Method in ElectronPersistenceMethod]: {

package/dist/cjs/renderer.cjs

@@ -76,9 +76,12 @@ function createRendererRequestExecutor(options) {
       if (typeof response.error.stack === `string`) {
         remoteError.stack = response.error.stack;
       }
-      if (typeof response.error.code === `string`) {
+      if (typeof response.error.code === `string` || typeof response.error.code === `number`) {
         remoteError.code = response.error.code;
       }
+      if (response.error.path !== void 0) {
+        remoteError.path = response.error.path;
+      }
       throw remoteError;
     }
     return response.result;
@@ -116,6 +119,14 @@ function createResolvedRendererAdapter(executeRequest, resolution) {
         resolution
       );
     },
+    reconcileCommittedTx: async (collectionId, tx, anchor) => {
+      return executeRequest(
+        `reconcileCommittedTx`,
+        collectionId,
+        { tx, anchor },
+        resolution
+      );
+    },
     loadCollectionMetadata: async (collectionId) => {
       return executeRequest(
         `loadCollectionMetadata`,
@@ -167,7 +178,13 @@ function createResolvedRendererAdapter(executeRequest, resolution) {
     },
     getStreamPosition: async (collectionId) => {
       return executeRequest(`getStreamPosition`, collectionId, {}, resolution);
-    }
+    },
+    reserveLeadershipTerm: async (collectionId, observedTerm) => executeRequest(
+      `reserveLeadershipTerm`,
+      collectionId,
+      { observedTerm },
+      resolution
+    )
   };
 }
 function resolveInvoke(options) {

package/dist/cjs/renderer.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.cjs","sources":["../../src/renderer.ts"],"sourcesContent":["import {\n  InvalidPersistedCollectionConfigError,\n  SingleProcessCoordinator,\n} from '@tanstack/db-sqlite-persistence-core'\nimport { ElectronCollectionCoordinator } from './electron-coordinator'\nimport {\n  DEFAULT_ELECTRON_PERSISTENCE_CHANNEL,\n  ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n} from './protocol'\nimport type {\n  PersistedCollectionCoordinator,\n  PersistedCollectionMode,\n  PersistedCollectionPersistence,\n  PersistedIndexSpec,\n  PersistedTx,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\nimport type {\n  ElectronPersistedKey,\n  ElectronPersistedRow,\n  ElectronPersistenceInvoke,\n  ElectronPersistenceMethod,\n  ElectronPersistencePayloadMap,\n  ElectronPersistenceRequest,\n  ElectronPersistenceRequestEnvelope,\n  ElectronPersistenceResolution,\n  ElectronPersistenceResponseEnvelope,\n  ElectronPersistenceResultMap,\n} from './protocol'\nimport type { LoadSubsetOptions } from '@tanstack/db'\n\nconst DEFAULT_REQUEST_TIMEOUT_MS = 5_000\nlet nextRequestId = 1\n\nfunction createRequestId(): string {\n  const requestId = nextRequestId\n  nextRequestId++\n  return `electron-persistence-${requestId}`\n}\n\nfunction withTimeout<T>(\n  promise: Promise<T>,\n  timeoutMs: number,\n  timeoutMessage: string,\n): Promise<T> {\n  if (timeoutMs <= 0) {\n    return promise\n  }\n\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      reject(new InvalidPersistedCollectionConfigError(timeoutMessage))\n    }, timeoutMs)\n\n    promise.then(\n      (value) => {\n        clearTimeout(timer)\n        resolve(value)\n      },\n      (error: unknown) => {\n        clearTimeout(timer)\n        reject(error)\n      },\n    )\n  })\n}\n\nfunction assertValidResponse(\n  response: ElectronPersistenceResponseEnvelope,\n  request: ElectronPersistenceRequestEnvelope,\n): void {\n  if (response.v !== ELECTRON_PERSISTENCE_PROTOCOL_VERSION) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Unexpected electron persistence protocol version \"${response.v}\" in response`,\n    )\n  }\n\n  if (response.requestId !== request.requestId) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Mismatched electron persistence response request id. Expected \"${request.requestId}\", received \"${response.requestId}\"`,\n    )\n  }\n\n  if (response.method !== request.method) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Mismatched electron persistence response method. Expected \"${request.method}\", received \"${response.method}\"`,\n    )\n  }\n}\n\nfunction createSerializableLoadSubsetOptions(\n  subsetOptions: LoadSubsetOptions,\n): LoadSubsetOptions {\n  const { subscription: _subscription, ...serializableOptions } = subsetOptions\n  return serializableOptions\n}\n\ntype RendererRequestExecutor = <TMethod extends ElectronPersistenceMethod>(\n  method: TMethod,\n  collectionId: string,\n  payload: ElectronPersistencePayloadMap[TMethod],\n  resolution?: ElectronPersistenceResolution,\n) => Promise<ElectronPersistenceResultMap[TMethod]>\n\nfunction createRendererRequestExecutor(options: {\n  invoke: ElectronPersistenceInvoke\n  channel?: string\n  timeoutMs?: number\n}): RendererRequestExecutor {\n  const channel = options.channel ?? DEFAULT_ELECTRON_PERSISTENCE_CHANNEL\n  const timeoutMs = options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS\n\n  return async <TMethod extends ElectronPersistenceMethod>(\n    method: TMethod,\n    collectionId: string,\n    payload: ElectronPersistencePayloadMap[TMethod],\n    resolution?: ElectronPersistenceResolution,\n  ) => {\n    const request = {\n      v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n      requestId: createRequestId(),\n      collectionId,\n      method,\n      resolution,\n      payload,\n    } as ElectronPersistenceRequest\n\n    const response = await withTimeout(\n      options.invoke(channel, request),\n      timeoutMs,\n      `Electron persistence request timed out (method=${method}, collection=${collectionId}, timeoutMs=${timeoutMs})`,\n    )\n    assertValidResponse(response, request)\n\n    if (!response.ok) {\n      const remoteError = new InvalidPersistedCollectionConfigError(\n        `${response.error.name}: ${response.error.message}`,\n      )\n      if (typeof response.error.stack === `string`) {\n        remoteError.stack = response.error.stack\n      }\n      if (typeof response.error.code === `string`) {\n        ;(remoteError as Error & { code?: string }).code = response.error.code\n      }\n      throw remoteError\n    }\n\n    return response.result as ElectronPersistenceResultMap[TMethod]\n  }\n}\n\ntype ElectronRendererResolvedAdapter =\n  PersistedCollectionPersistence[`adapter`] & {\n    loadCollectionMetadata: (\n      collectionId: string,\n    ) => Promise<Array<{ key: string; value: unknown }>>\n    scanRows: (\n      collectionId: string,\n      options?: { metadataOnly?: boolean },\n    ) => Promise<\n      Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    >\n    pullSince: (\n      collectionId: string,\n      fromRowVersion: number,\n    ) => Promise<SQLitePullSinceResult<string | number>>\n    getStreamPosition: (collectionId: string) => Promise<{\n      latestTerm: number\n      latestSeq: number\n      latestRowVersion: number\n    }>\n  }\n\nfunction createResolvedRendererAdapter(\n  executeRequest: RendererRequestExecutor,\n  resolution?: ElectronPersistenceResolution,\n): ElectronRendererResolvedAdapter {\n  return {\n    loadSubset: async (\n      collectionId: string,\n      subsetOptions: LoadSubsetOptions,\n      ctx?: { requiredIndexSignatures?: ReadonlyArray<string> },\n    ) => {\n      const result = await executeRequest(\n        `loadSubset`,\n        collectionId,\n        {\n          options: createSerializableLoadSubsetOptions(subsetOptions),\n          ctx,\n        },\n        resolution,\n      )\n\n      return result as Array<{\n        key: string | number\n        value: Record<string, unknown>\n      }>\n    },\n    loadResumeSnapshot: async (\n      collectionId: string,\n      ctx?: {\n        requiredIndexSignatures?: ReadonlyArray<string>\n        includeRows?: boolean\n      },\n    ) => {\n      return executeRequest(\n        `loadResumeSnapshot`,\n        collectionId,\n        { ctx },\n        resolution,\n      )\n    },\n    applyCommittedTx: async (\n      collectionId: string,\n      tx: PersistedTx<Record<string, unknown>, string | number>,\n    ): Promise<void> => {\n      await executeRequest(\n        `applyCommittedTx`,\n        collectionId,\n        {\n          tx: tx as PersistedTx<ElectronPersistedRow, ElectronPersistedKey>,\n        },\n        resolution,\n      )\n    },\n    loadCollectionMetadata: async (\n      collectionId: string,\n    ): Promise<Array<{ key: string; value: unknown }>> => {\n      return executeRequest(\n        `loadCollectionMetadata`,\n        collectionId,\n        {},\n        resolution,\n      )\n    },\n    scanRows: async (\n      collectionId: string,\n      options?: { metadataOnly?: boolean },\n    ): Promise<\n      Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    > => {\n      const result = await executeRequest(\n        `scanRows`,\n        collectionId,\n        { options },\n        resolution,\n      )\n      return result as Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    },\n    ensureIndex: async (\n      collectionId: string,\n      signature: string,\n      spec: PersistedIndexSpec,\n    ): Promise<void> => {\n      await executeRequest(\n        `ensureIndex`,\n        collectionId,\n        {\n          signature,\n          spec,\n        },\n        resolution,\n      )\n    },\n    markIndexRemoved: async (\n      collectionId: string,\n      signature: string,\n    ): Promise<void> => {\n      await executeRequest(\n        `markIndexRemoved`,\n        collectionId,\n        {\n          signature,\n        },\n        resolution,\n      )\n    },\n    pullSince: async (\n      collectionId: string,\n      fromRowVersion: number,\n    ): Promise<SQLitePullSinceResult<string | number>> => {\n      const result = await executeRequest(\n        `pullSince`,\n        collectionId,\n        {\n          fromRowVersion,\n        },\n        resolution,\n      )\n      return result as SQLitePullSinceResult<string | number>\n    },\n    getStreamPosition: async (\n      collectionId: string,\n    ): Promise<{\n      latestTerm: number\n      latestSeq: number\n      latestRowVersion: number\n    }> => {\n      return executeRequest(`getStreamPosition`, collectionId, {}, resolution)\n    },\n  }\n}\n\nexport type ElectronIpcRendererLike = {\n  invoke: (\n    channel: string,\n    request: ElectronPersistenceRequestEnvelope,\n  ) => Promise<ElectronPersistenceResponseEnvelope>\n}\n\nexport type ElectronSQLitePersistenceOptions = {\n  invoke?: ElectronPersistenceInvoke\n  ipcRenderer?: ElectronIpcRendererLike\n  channel?: string\n  timeoutMs?: number\n  coordinator?: PersistedCollectionCoordinator\n}\n\nfunction resolveInvoke(\n  options: ElectronSQLitePersistenceOptions,\n): ElectronPersistenceInvoke {\n  if (options.invoke) {\n    return options.invoke\n  }\n\n  if (options.ipcRenderer) {\n    return (channel, request) => options.ipcRenderer!.invoke(channel, request)\n  }\n\n  throw new InvalidPersistedCollectionConfigError(\n    `Electron renderer persistence requires either invoke or ipcRenderer`,\n  )\n}\n\nexport function createElectronSQLitePersistence(\n  options: ElectronSQLitePersistenceOptions,\n): PersistedCollectionPersistence {\n  const invoke = resolveInvoke(options)\n  const coordinator = options.coordinator ?? new SingleProcessCoordinator()\n  const executeRequest = createRendererRequestExecutor({\n    invoke,\n    channel: options.channel,\n    timeoutMs: options.timeoutMs,\n  })\n  const adapterCache = new Map<string, ElectronRendererResolvedAdapter>()\n\n  const getAdapterForCollection = (\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ) => {\n    const schemaVersionKey =\n      schemaVersion === undefined ? `schema:default` : `schema:${schemaVersion}`\n    const cacheKey = `mode:${mode}|${schemaVersionKey}`\n    const cachedAdapter = adapterCache.get(cacheKey)\n    if (cachedAdapter) {\n      return cachedAdapter\n    }\n\n    const adapter = createResolvedRendererAdapter(executeRequest, {\n      mode,\n      schemaVersion,\n    })\n    adapterCache.set(cacheKey, adapter)\n    return adapter\n  }\n\n  const createCollectionPersistence = (\n    collectionId: string | undefined,\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ): PersistedCollectionPersistence => {\n    const adapter = getAdapterForCollection(mode, schemaVersion)\n    if (coordinator instanceof ElectronCollectionCoordinator) {\n      if (collectionId === undefined) {\n        coordinator.setAdapter(adapter)\n      } else {\n        coordinator.setAdapterForCollection(collectionId, adapter)\n      }\n    }\n    return { adapter, coordinator }\n  }\n\n  const defaultPersistence = createCollectionPersistence(\n    undefined,\n    `sync-absent`,\n    undefined,\n  )\n  if (coordinator instanceof ElectronCollectionCoordinator) {\n    coordinator.setAdapter(defaultPersistence.adapter)\n  }\n\n  return {\n    ...defaultPersistence,\n    resolvePersistenceForCollection: ({ collectionId, mode, schemaVersion }) =>\n      createCollectionPersistence(collectionId, mode, schemaVersion),\n    // Backward compatible fallback for older callers.\n    resolvePersistenceForMode: (mode) =>\n      createCollectionPersistence(undefined, mode, undefined),\n  }\n}\n"],"names":["InvalidPersistedCollectionConfigError","ELECTRON_PERSISTENCE_PROTOCOL_VERSION","DEFAULT_ELECTRON_PERSISTENCE_CHANNEL","SingleProcessCoordinator","ElectronCollectionCoordinator"],"mappings":"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"}
+{"version":3,"file":"renderer.cjs","sources":["../../src/renderer.ts"],"sourcesContent":["import {\n  InvalidPersistedCollectionConfigError,\n  SingleProcessCoordinator,\n} from '@tanstack/db-sqlite-persistence-core'\nimport { ElectronCollectionCoordinator } from './electron-coordinator'\nimport {\n  DEFAULT_ELECTRON_PERSISTENCE_CHANNEL,\n  ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n} from './protocol'\nimport type {\n  CommittedTxAnchor,\n  PersistedCollectionCoordinator,\n  PersistedCollectionMode,\n  PersistedCollectionPersistence,\n  PersistedIndexSpec,\n  PersistedTx,\n  ReconciledCommittedTx,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\nimport type {\n  ElectronPersistedKey,\n  ElectronPersistedRow,\n  ElectronPersistenceInvoke,\n  ElectronPersistenceMethod,\n  ElectronPersistencePayloadMap,\n  ElectronPersistenceRequest,\n  ElectronPersistenceRequestEnvelope,\n  ElectronPersistenceResolution,\n  ElectronPersistenceResponseEnvelope,\n  ElectronPersistenceResultMap,\n} from './protocol'\nimport type { LoadSubsetOptions } from '@tanstack/db'\n\nconst DEFAULT_REQUEST_TIMEOUT_MS = 5_000\nlet nextRequestId = 1\n\nfunction createRequestId(): string {\n  const requestId = nextRequestId\n  nextRequestId++\n  return `electron-persistence-${requestId}`\n}\n\nfunction withTimeout<T>(\n  promise: Promise<T>,\n  timeoutMs: number,\n  timeoutMessage: string,\n): Promise<T> {\n  if (timeoutMs <= 0) {\n    return promise\n  }\n\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      reject(new InvalidPersistedCollectionConfigError(timeoutMessage))\n    }, timeoutMs)\n\n    promise.then(\n      (value) => {\n        clearTimeout(timer)\n        resolve(value)\n      },\n      (error: unknown) => {\n        clearTimeout(timer)\n        reject(error)\n      },\n    )\n  })\n}\n\nfunction assertValidResponse(\n  response: ElectronPersistenceResponseEnvelope,\n  request: ElectronPersistenceRequestEnvelope,\n): void {\n  if (response.v !== ELECTRON_PERSISTENCE_PROTOCOL_VERSION) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Unexpected electron persistence protocol version \"${response.v}\" in response`,\n    )\n  }\n\n  if (response.requestId !== request.requestId) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Mismatched electron persistence response request id. Expected \"${request.requestId}\", received \"${response.requestId}\"`,\n    )\n  }\n\n  if (response.method !== request.method) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Mismatched electron persistence response method. Expected \"${request.method}\", received \"${response.method}\"`,\n    )\n  }\n}\n\nfunction createSerializableLoadSubsetOptions(\n  subsetOptions: LoadSubsetOptions,\n): LoadSubsetOptions {\n  const { subscription: _subscription, ...serializableOptions } = subsetOptions\n  return serializableOptions\n}\n\ntype RendererRequestExecutor = <TMethod extends ElectronPersistenceMethod>(\n  method: TMethod,\n  collectionId: string,\n  payload: ElectronPersistencePayloadMap[TMethod],\n  resolution?: ElectronPersistenceResolution,\n) => Promise<ElectronPersistenceResultMap[TMethod]>\n\nfunction createRendererRequestExecutor(options: {\n  invoke: ElectronPersistenceInvoke\n  channel?: string\n  timeoutMs?: number\n}): RendererRequestExecutor {\n  const channel = options.channel ?? DEFAULT_ELECTRON_PERSISTENCE_CHANNEL\n  const timeoutMs = options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS\n\n  return async <TMethod extends ElectronPersistenceMethod>(\n    method: TMethod,\n    collectionId: string,\n    payload: ElectronPersistencePayloadMap[TMethod],\n    resolution?: ElectronPersistenceResolution,\n  ) => {\n    const request = {\n      v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n      requestId: createRequestId(),\n      collectionId,\n      method,\n      resolution,\n      payload,\n    } as ElectronPersistenceRequest\n\n    const response = await withTimeout(\n      options.invoke(channel, request),\n      timeoutMs,\n      `Electron persistence request timed out (method=${method}, collection=${collectionId}, timeoutMs=${timeoutMs})`,\n    )\n    assertValidResponse(response, request)\n\n    if (!response.ok) {\n      const remoteError = new InvalidPersistedCollectionConfigError(\n        `${response.error.name}: ${response.error.message}`,\n      )\n      if (typeof response.error.stack === `string`) {\n        remoteError.stack = response.error.stack\n      }\n      if (\n        typeof response.error.code === `string` ||\n        typeof response.error.code === `number`\n      ) {\n        ;(remoteError as Error & { code?: string | number }).code =\n          response.error.code\n      }\n      if (response.error.path !== undefined) {\n        ;(\n          remoteError as Error & {\n            path?: string | ReadonlyArray<string | number>\n          }\n        ).path = response.error.path\n      }\n      throw remoteError\n    }\n\n    return response.result as ElectronPersistenceResultMap[TMethod]\n  }\n}\n\ntype ElectronRendererResolvedAdapter =\n  PersistedCollectionPersistence[`adapter`] & {\n    loadCollectionMetadata: (\n      collectionId: string,\n    ) => Promise<Array<{ key: string; value: unknown }>>\n    scanRows: (\n      collectionId: string,\n      options?: { metadataOnly?: boolean },\n    ) => Promise<\n      Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    >\n    pullSince: (\n      collectionId: string,\n      fromRowVersion: number,\n    ) => Promise<SQLitePullSinceResult<string | number>>\n    getStreamPosition: (collectionId: string) => Promise<{\n      latestTerm: number\n      latestSeq: number\n      latestRowVersion: number\n    }>\n    reserveLeadershipTerm: (\n      collectionId: string,\n      observedTerm: number,\n    ) => Promise<{\n      latestTerm: number\n      latestSeq: number\n      latestRowVersion: number\n    }>\n  }\n\nfunction createResolvedRendererAdapter(\n  executeRequest: RendererRequestExecutor,\n  resolution?: ElectronPersistenceResolution,\n): ElectronRendererResolvedAdapter {\n  return {\n    loadSubset: async (\n      collectionId: string,\n      subsetOptions: LoadSubsetOptions,\n      ctx?: { requiredIndexSignatures?: ReadonlyArray<string> },\n    ) => {\n      const result = await executeRequest(\n        `loadSubset`,\n        collectionId,\n        {\n          options: createSerializableLoadSubsetOptions(subsetOptions),\n          ctx,\n        },\n        resolution,\n      )\n\n      return result as Array<{\n        key: string | number\n        value: Record<string, unknown>\n      }>\n    },\n    loadResumeSnapshot: async (\n      collectionId: string,\n      ctx?: {\n        requiredIndexSignatures?: ReadonlyArray<string>\n        includeRows?: boolean\n      },\n    ) => {\n      return executeRequest(\n        `loadResumeSnapshot`,\n        collectionId,\n        { ctx },\n        resolution,\n      )\n    },\n    applyCommittedTx: async (\n      collectionId: string,\n      tx: PersistedTx<Record<string, unknown>, string | number>,\n    ): Promise<void> => {\n      await executeRequest(\n        `applyCommittedTx`,\n        collectionId,\n        {\n          tx: tx as PersistedTx<ElectronPersistedRow, ElectronPersistedKey>,\n        },\n        resolution,\n      )\n    },\n    reconcileCommittedTx: async (\n      collectionId: string,\n      tx: PersistedTx<Record<string, unknown>, string | number>,\n      anchor: CommittedTxAnchor,\n    ): Promise<ReconciledCommittedTx> => {\n      return executeRequest(\n        `reconcileCommittedTx`,\n        collectionId,\n        { tx, anchor },\n        resolution,\n      )\n    },\n    loadCollectionMetadata: async (\n      collectionId: string,\n    ): Promise<Array<{ key: string; value: unknown }>> => {\n      return executeRequest(\n        `loadCollectionMetadata`,\n        collectionId,\n        {},\n        resolution,\n      )\n    },\n    scanRows: async (\n      collectionId: string,\n      options?: { metadataOnly?: boolean },\n    ): Promise<\n      Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    > => {\n      const result = await executeRequest(\n        `scanRows`,\n        collectionId,\n        { options },\n        resolution,\n      )\n      return result as Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    },\n    ensureIndex: async (\n      collectionId: string,\n      signature: string,\n      spec: PersistedIndexSpec,\n    ): Promise<void> => {\n      await executeRequest(\n        `ensureIndex`,\n        collectionId,\n        {\n          signature,\n          spec,\n        },\n        resolution,\n      )\n    },\n    markIndexRemoved: async (\n      collectionId: string,\n      signature: string,\n    ): Promise<void> => {\n      await executeRequest(\n        `markIndexRemoved`,\n        collectionId,\n        {\n          signature,\n        },\n        resolution,\n      )\n    },\n    pullSince: async (\n      collectionId: string,\n      fromRowVersion: number,\n    ): Promise<SQLitePullSinceResult<string | number>> => {\n      const result = await executeRequest(\n        `pullSince`,\n        collectionId,\n        {\n          fromRowVersion,\n        },\n        resolution,\n      )\n      return result as SQLitePullSinceResult<string | number>\n    },\n    getStreamPosition: async (\n      collectionId: string,\n    ): Promise<{\n      latestTerm: number\n      latestSeq: number\n      latestRowVersion: number\n    }> => {\n      return executeRequest(`getStreamPosition`, collectionId, {}, resolution)\n    },\n    reserveLeadershipTerm: async (collectionId, observedTerm) =>\n      executeRequest(\n        `reserveLeadershipTerm`,\n        collectionId,\n        { observedTerm },\n        resolution,\n      ),\n  }\n}\n\nexport type ElectronIpcRendererLike = {\n  invoke: (\n    channel: string,\n    request: ElectronPersistenceRequestEnvelope,\n  ) => Promise<ElectronPersistenceResponseEnvelope>\n}\n\nexport type ElectronSQLitePersistenceOptions = {\n  invoke?: ElectronPersistenceInvoke\n  ipcRenderer?: ElectronIpcRendererLike\n  channel?: string\n  timeoutMs?: number\n  coordinator?: PersistedCollectionCoordinator\n}\n\nfunction resolveInvoke(\n  options: ElectronSQLitePersistenceOptions,\n): ElectronPersistenceInvoke {\n  if (options.invoke) {\n    return options.invoke\n  }\n\n  if (options.ipcRenderer) {\n    return (channel, request) => options.ipcRenderer!.invoke(channel, request)\n  }\n\n  throw new InvalidPersistedCollectionConfigError(\n    `Electron renderer persistence requires either invoke or ipcRenderer`,\n  )\n}\n\nexport function createElectronSQLitePersistence(\n  options: ElectronSQLitePersistenceOptions,\n): PersistedCollectionPersistence {\n  const invoke = resolveInvoke(options)\n  const coordinator = options.coordinator ?? new SingleProcessCoordinator()\n  const executeRequest = createRendererRequestExecutor({\n    invoke,\n    channel: options.channel,\n    timeoutMs: options.timeoutMs,\n  })\n  const adapterCache = new Map<string, ElectronRendererResolvedAdapter>()\n\n  const getAdapterForCollection = (\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ) => {\n    const schemaVersionKey =\n      schemaVersion === undefined ? `schema:default` : `schema:${schemaVersion}`\n    const cacheKey = `mode:${mode}|${schemaVersionKey}`\n    const cachedAdapter = adapterCache.get(cacheKey)\n    if (cachedAdapter) {\n      return cachedAdapter\n    }\n\n    const adapter = createResolvedRendererAdapter(executeRequest, {\n      mode,\n      schemaVersion,\n    })\n    adapterCache.set(cacheKey, adapter)\n    return adapter\n  }\n\n  const createCollectionPersistence = (\n    collectionId: string | undefined,\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ): PersistedCollectionPersistence => {\n    const adapter = getAdapterForCollection(mode, schemaVersion)\n    if (coordinator instanceof ElectronCollectionCoordinator) {\n      if (collectionId === undefined) {\n        coordinator.setAdapter(adapter)\n      } else {\n        coordinator.setAdapterForCollection(collectionId, adapter)\n      }\n    }\n    return { adapter, coordinator }\n  }\n\n  const defaultPersistence = createCollectionPersistence(\n    undefined,\n    `sync-absent`,\n    undefined,\n  )\n  if (coordinator instanceof ElectronCollectionCoordinator) {\n    coordinator.setAdapter(defaultPersistence.adapter)\n  }\n\n  return {\n    ...defaultPersistence,\n    resolvePersistenceForCollection: ({ collectionId, mode, schemaVersion }) =>\n      createCollectionPersistence(collectionId, mode, schemaVersion),\n    // Backward compatible fallback for older callers.\n    resolvePersistenceForMode: (mode) =>\n      createCollectionPersistence(undefined, mode, undefined),\n  }\n}\n"],"names":["InvalidPersistedCollectionConfigError","ELECTRON_PERSISTENCE_PROTOCOL_VERSION","DEFAULT_ELECTRON_PERSISTENCE_CHANNEL","SingleProcessCoordinator","ElectronCollectionCoordinator"],"mappings":"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"}

package/dist/esm/errors.d.ts

@@ -1,10 +1,10 @@
 import { ElectronPersistenceMethod, ElectronSerializedError } from './protocol.js';
 type ElectronPersistenceErrorOptions = {
-    code?: string;
+    code?: string | number;
     cause?: unknown;
 };
 export declare class ElectronPersistenceError extends Error {
-    readonly code: string | undefined;
+    readonly code: string | number | undefined;
     constructor(message: string, options?: ElectronPersistenceErrorOptions);
 }
 export declare class UnknownElectronPersistenceCollectionError extends ElectronPersistenceError {

package/dist/esm/main.js

@@ -9,12 +9,16 @@ function serializeError(error) {
       code: void 0
     };
   }
-  const codedError = error;
+  const detailedError = error;
+  const path = detailedError.path;
   return {
     name: error.name || `Error`,
     message: error.message || fallbackMessage,
     stack: error.stack,
-    code: typeof codedError.code === `string` ? codedError.code : void 0
+    code: typeof detailedError.code === `string` || typeof detailedError.code === `number` ? detailedError.code : void 0,
+    path: typeof path === `string` || Array.isArray(path) && path.every(
+      (segment) => typeof segment === `string` || typeof segment === `number`
+    ) ? path : void 0
   };
 }
 function createErrorResponse(request, error) {
@@ -115,6 +119,20 @@ async function executeRequestAgainstAdapter(request, adapter) {
         result: null
       };
     }
+    case `reconcileCommittedTx`: {
+      const result = adapter.reconcileCommittedTx ? await adapter.reconcileCommittedTx(
+        request.collectionId,
+        request.payload.tx,
+        request.payload.anchor
+      ) : { kind: `unknown` };
+      return {
+        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
+        requestId: request.requestId,
+        method: request.method,
+        ok: true,
+        result
+      };
+    }
     case `ensureIndex`: {
       await adapter.ensureIndex(
         request.collectionId,
@@ -165,6 +183,24 @@ async function executeRequestAgainstAdapter(request, adapter) {
         result
       };
     }
+    case `reserveLeadershipTerm`: {
+      if (!adapter.reserveLeadershipTerm) {
+        throw new InvalidPersistedCollectionConfigError(
+          `reserveLeadershipTerm is not supported by the configured electron persistence adapter`
+        );
+      }
+      const position = await adapter.reserveLeadershipTerm(
+        request.collectionId,
+        request.payload.observedTerm
+      );
+      return {
+        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
+        requestId: request.requestId,
+        method: request.method,
+        ok: true,
+        result: position
+      };
+    }
     case `getStreamPosition`: {
       if (!adapter.getStreamPosition) {
         throw new InvalidPersistedCollectionConfigError(

package/dist/esm/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sources":["../../src/main.ts"],"sourcesContent":["import { InvalidPersistedCollectionConfigError } from '@tanstack/db-sqlite-persistence-core'\nimport {\n  DEFAULT_ELECTRON_PERSISTENCE_CHANNEL,\n  ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n} from './protocol'\nimport type {\n  PersistedCollectionPersistence,\n  PersistenceAdapter,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\nimport type {\n  ElectronPersistedKey,\n  ElectronPersistedRow,\n  ElectronPersistenceRequestEnvelope,\n  ElectronPersistenceResponseEnvelope,\n  ElectronSerializedError,\n} from './protocol'\n\ntype ElectronMainPersistenceAdapter = PersistenceAdapter & {\n  loadCollectionMetadata?: (\n    collectionId: string,\n  ) => Promise<Array<{ key: string; value: unknown }>>\n  scanRows?: (\n    collectionId: string,\n    options?: { metadataOnly?: boolean },\n  ) => Promise<\n    Array<{\n      key: ElectronPersistedKey\n      value: ElectronPersistedRow\n      metadata?: unknown\n    }>\n  >\n  pullSince?: (\n    collectionId: string,\n    fromRowVersion: number,\n  ) => Promise<SQLitePullSinceResult<ElectronPersistedKey>>\n  getStreamPosition?: (collectionId: string) => Promise<{\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n  }>\n}\n\nfunction serializeError(error: unknown): ElectronSerializedError {\n  const fallbackMessage = `Unknown electron persistence error`\n\n  if (!(error instanceof Error)) {\n    return {\n      name: `Error`,\n      message: fallbackMessage,\n      code: undefined,\n    }\n  }\n\n  const codedError = error as Error & { code?: unknown }\n  return {\n    name: error.name || `Error`,\n    message: error.message || fallbackMessage,\n    stack: error.stack,\n    code: typeof codedError.code === `string` ? codedError.code : undefined,\n  }\n}\n\nfunction createErrorResponse(\n  request: ElectronPersistenceRequestEnvelope,\n  error: unknown,\n): ElectronPersistenceResponseEnvelope {\n  return {\n    v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n    requestId: request.requestId,\n    method: request.method,\n    ok: false,\n    error: serializeError(error),\n  }\n}\n\nfunction assertValidRequest(request: ElectronPersistenceRequestEnvelope): void {\n  if (request.v !== ELECTRON_PERSISTENCE_PROTOCOL_VERSION) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Unsupported electron persistence protocol version \"${request.v}\"`,\n    )\n  }\n\n  if (\n    typeof request.requestId !== `string` ||\n    request.requestId.trim().length === 0\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence requestId cannot be empty`,\n    )\n  }\n\n  if (\n    typeof request.collectionId !== `string` ||\n    request.collectionId.trim().length === 0\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence collectionId cannot be empty`,\n    )\n  }\n}\n\nasync function executeRequestAgainstAdapter(\n  request: ElectronPersistenceRequestEnvelope,\n  adapter: ElectronMainPersistenceAdapter,\n): Promise<ElectronPersistenceResponseEnvelope> {\n  switch (request.method) {\n    case `loadSubset`: {\n      const result = await adapter.loadSubset(\n        request.collectionId,\n        request.payload.options,\n        request.payload.ctx,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `loadResumeSnapshot`: {\n      const result = await adapter.loadResumeSnapshot(\n        request.collectionId,\n        request.payload.ctx,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `loadCollectionMetadata`: {\n      if (!adapter.loadCollectionMetadata) {\n        throw new InvalidPersistedCollectionConfigError(\n          `loadCollectionMetadata is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.loadCollectionMetadata(request.collectionId)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `scanRows`: {\n      if (!adapter.scanRows) {\n        throw new InvalidPersistedCollectionConfigError(\n          `scanRows is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.scanRows(\n        request.collectionId,\n        request.payload.options,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `applyCommittedTx`: {\n      await adapter.applyCommittedTx(request.collectionId, request.payload.tx)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `ensureIndex`: {\n      await adapter.ensureIndex(\n        request.collectionId,\n        request.payload.signature,\n        request.payload.spec,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `markIndexRemoved`: {\n      if (!adapter.markIndexRemoved) {\n        throw new InvalidPersistedCollectionConfigError(\n          `markIndexRemoved is not supported by the configured electron persistence adapter`,\n        )\n      }\n      await adapter.markIndexRemoved(\n        request.collectionId,\n        request.payload.signature,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `pullSince`: {\n      if (!adapter.pullSince) {\n        throw new InvalidPersistedCollectionConfigError(\n          `pullSince is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.pullSince(\n        request.collectionId,\n        request.payload.fromRowVersion,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `getStreamPosition`: {\n      if (!adapter.getStreamPosition) {\n        throw new InvalidPersistedCollectionConfigError(\n          `getStreamPosition is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const position = await adapter.getStreamPosition(request.collectionId)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: position,\n      }\n    }\n  }\n}\n\nfunction resolveModeAwarePersistence(\n  persistence: PersistedCollectionPersistence,\n  request: ElectronPersistenceRequestEnvelope,\n): PersistedCollectionPersistence {\n  const mode = request.resolution?.mode ?? `sync-absent`\n  const schemaVersion = request.resolution?.schemaVersion\n  const collectionAwarePersistence =\n    persistence.resolvePersistenceForCollection?.({\n      collectionId: request.collectionId,\n      mode,\n      schemaVersion,\n    })\n  if (collectionAwarePersistence) {\n    return collectionAwarePersistence\n  }\n\n  const modeAwarePersistence = persistence.resolvePersistenceForMode?.(mode)\n  return modeAwarePersistence ?? persistence\n}\n\nexport type ElectronIpcMainLike = {\n  handle: (\n    channel: string,\n    listener: (\n      event: unknown,\n      request: ElectronPersistenceRequestEnvelope,\n    ) => Promise<ElectronPersistenceResponseEnvelope>,\n  ) => void\n  removeHandler?: (channel: string) => void\n}\n\nexport type ElectronSQLiteMainProcessOptions = {\n  persistence: PersistedCollectionPersistence\n  ipcMain: ElectronIpcMainLike\n  channel?: string\n}\n\nexport function exposeElectronSQLitePersistence(\n  options: ElectronSQLiteMainProcessOptions,\n): () => void {\n  const channel = options.channel ?? DEFAULT_ELECTRON_PERSISTENCE_CHANNEL\n  options.ipcMain.handle(\n    channel,\n    async (\n      _event,\n      request: ElectronPersistenceRequestEnvelope,\n    ): Promise<ElectronPersistenceResponseEnvelope> => {\n      try {\n        assertValidRequest(request)\n        const modeAwarePersistence = resolveModeAwarePersistence(\n          options.persistence,\n          request,\n        )\n        return await executeRequestAgainstAdapter(\n          request,\n          modeAwarePersistence.adapter,\n        )\n      } catch (error) {\n        return createErrorResponse(request, error)\n      }\n    },\n  )\n\n  return () => {\n    options.ipcMain.removeHandler?.(channel)\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"main.js","sources":["../../src/main.ts"],"sourcesContent":["import { InvalidPersistedCollectionConfigError } from '@tanstack/db-sqlite-persistence-core'\nimport {\n  DEFAULT_ELECTRON_PERSISTENCE_CHANNEL,\n  ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n} from './protocol'\nimport type {\n  PersistedCollectionPersistence,\n  PersistenceAdapter,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\nimport type {\n  ElectronPersistedKey,\n  ElectronPersistedRow,\n  ElectronPersistenceRequestEnvelope,\n  ElectronPersistenceResponseEnvelope,\n  ElectronSerializedError,\n} from './protocol'\n\ntype ElectronMainPersistenceAdapter = PersistenceAdapter & {\n  loadCollectionMetadata?: (\n    collectionId: string,\n  ) => Promise<Array<{ key: string; value: unknown }>>\n  scanRows?: (\n    collectionId: string,\n    options?: { metadataOnly?: boolean },\n  ) => Promise<\n    Array<{\n      key: ElectronPersistedKey\n      value: ElectronPersistedRow\n      metadata?: unknown\n    }>\n  >\n  pullSince?: (\n    collectionId: string,\n    fromRowVersion: number,\n  ) => Promise<SQLitePullSinceResult<ElectronPersistedKey>>\n  getStreamPosition?: (collectionId: string) => Promise<{\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n  }>\n}\n\nfunction serializeError(error: unknown): ElectronSerializedError {\n  const fallbackMessage = `Unknown electron persistence error`\n\n  if (!(error instanceof Error)) {\n    return {\n      name: `Error`,\n      message: fallbackMessage,\n      code: undefined,\n    }\n  }\n\n  const detailedError = error as Error & { code?: unknown; path?: unknown }\n  const path = detailedError.path\n  return {\n    name: error.name || `Error`,\n    message: error.message || fallbackMessage,\n    stack: error.stack,\n    code:\n      typeof detailedError.code === `string` ||\n      typeof detailedError.code === `number`\n        ? detailedError.code\n        : undefined,\n    path:\n      typeof path === `string` ||\n      (Array.isArray(path) &&\n        path.every(\n          (segment: unknown) =>\n            typeof segment === `string` || typeof segment === `number`,\n        ))\n        ? (path as string | ReadonlyArray<string | number>)\n        : undefined,\n  }\n}\n\nfunction createErrorResponse(\n  request: ElectronPersistenceRequestEnvelope,\n  error: unknown,\n): ElectronPersistenceResponseEnvelope {\n  return {\n    v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n    requestId: request.requestId,\n    method: request.method,\n    ok: false,\n    error: serializeError(error),\n  }\n}\n\nfunction assertValidRequest(request: ElectronPersistenceRequestEnvelope): void {\n  if (request.v !== ELECTRON_PERSISTENCE_PROTOCOL_VERSION) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Unsupported electron persistence protocol version \"${request.v}\"`,\n    )\n  }\n\n  if (\n    typeof request.requestId !== `string` ||\n    request.requestId.trim().length === 0\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence requestId cannot be empty`,\n    )\n  }\n\n  if (\n    typeof request.collectionId !== `string` ||\n    request.collectionId.trim().length === 0\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence collectionId cannot be empty`,\n    )\n  }\n}\n\nasync function executeRequestAgainstAdapter(\n  request: ElectronPersistenceRequestEnvelope,\n  adapter: ElectronMainPersistenceAdapter,\n): Promise<ElectronPersistenceResponseEnvelope> {\n  switch (request.method) {\n    case `loadSubset`: {\n      const result = await adapter.loadSubset(\n        request.collectionId,\n        request.payload.options,\n        request.payload.ctx,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `loadResumeSnapshot`: {\n      const result = await adapter.loadResumeSnapshot(\n        request.collectionId,\n        request.payload.ctx,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `loadCollectionMetadata`: {\n      if (!adapter.loadCollectionMetadata) {\n        throw new InvalidPersistedCollectionConfigError(\n          `loadCollectionMetadata is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.loadCollectionMetadata(request.collectionId)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `scanRows`: {\n      if (!adapter.scanRows) {\n        throw new InvalidPersistedCollectionConfigError(\n          `scanRows is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.scanRows(\n        request.collectionId,\n        request.payload.options,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `applyCommittedTx`: {\n      await adapter.applyCommittedTx(request.collectionId, request.payload.tx)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `reconcileCommittedTx`: {\n      const result = adapter.reconcileCommittedTx\n        ? await adapter.reconcileCommittedTx(\n            request.collectionId,\n            request.payload.tx,\n            request.payload.anchor,\n          )\n        : { kind: `unknown` as const }\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `ensureIndex`: {\n      await adapter.ensureIndex(\n        request.collectionId,\n        request.payload.signature,\n        request.payload.spec,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `markIndexRemoved`: {\n      if (!adapter.markIndexRemoved) {\n        throw new InvalidPersistedCollectionConfigError(\n          `markIndexRemoved is not supported by the configured electron persistence adapter`,\n        )\n      }\n      await adapter.markIndexRemoved(\n        request.collectionId,\n        request.payload.signature,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `pullSince`: {\n      if (!adapter.pullSince) {\n        throw new InvalidPersistedCollectionConfigError(\n          `pullSince is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.pullSince(\n        request.collectionId,\n        request.payload.fromRowVersion,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `reserveLeadershipTerm`: {\n      if (!adapter.reserveLeadershipTerm) {\n        throw new InvalidPersistedCollectionConfigError(\n          `reserveLeadershipTerm is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const position = await adapter.reserveLeadershipTerm(\n        request.collectionId,\n        request.payload.observedTerm,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: position,\n      }\n    }\n\n    case `getStreamPosition`: {\n      if (!adapter.getStreamPosition) {\n        throw new InvalidPersistedCollectionConfigError(\n          `getStreamPosition is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const position = await adapter.getStreamPosition(request.collectionId)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: position,\n      }\n    }\n  }\n}\n\nfunction resolveModeAwarePersistence(\n  persistence: PersistedCollectionPersistence,\n  request: ElectronPersistenceRequestEnvelope,\n): PersistedCollectionPersistence {\n  const mode = request.resolution?.mode ?? `sync-absent`\n  const schemaVersion = request.resolution?.schemaVersion\n  const collectionAwarePersistence =\n    persistence.resolvePersistenceForCollection?.({\n      collectionId: request.collectionId,\n      mode,\n      schemaVersion,\n    })\n  if (collectionAwarePersistence) {\n    return collectionAwarePersistence\n  }\n\n  const modeAwarePersistence = persistence.resolvePersistenceForMode?.(mode)\n  return modeAwarePersistence ?? persistence\n}\n\nexport type ElectronIpcMainLike = {\n  handle: (\n    channel: string,\n    listener: (\n      event: unknown,\n      request: ElectronPersistenceRequestEnvelope,\n    ) => Promise<ElectronPersistenceResponseEnvelope>,\n  ) => void\n  removeHandler?: (channel: string) => void\n}\n\nexport type ElectronSQLiteMainProcessOptions = {\n  persistence: PersistedCollectionPersistence\n  ipcMain: ElectronIpcMainLike\n  channel?: string\n}\n\nexport function exposeElectronSQLitePersistence(\n  options: ElectronSQLiteMainProcessOptions,\n): () => void {\n  const channel = options.channel ?? DEFAULT_ELECTRON_PERSISTENCE_CHANNEL\n  options.ipcMain.handle(\n    channel,\n    async (\n      _event,\n      request: ElectronPersistenceRequestEnvelope,\n    ): Promise<ElectronPersistenceResponseEnvelope> => {\n      try {\n        assertValidRequest(request)\n        const modeAwarePersistence = resolveModeAwarePersistence(\n          options.persistence,\n          request,\n        )\n        return await executeRequestAgainstAdapter(\n          request,\n          modeAwarePersistence.adapter,\n        )\n      } catch (error) {\n        return createErrorResponse(request, error)\n      }\n    },\n  )\n\n  return () => {\n    options.ipcMain.removeHandler?.(channel)\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/protocol.d.ts

@@ -1,6 +1,6 @@
 import { LoadSubsetOptions } from '@tanstack/db';
-import { PersistedCollectionMode, PersistedIndexSpec, PersistedKeySetEvidence, PersistedTx, SQLitePullSinceResult } from '@tanstack/db-sqlite-persistence-core';
-export declare const ELECTRON_PERSISTENCE_PROTOCOL_VERSION: 2;
+import { CommittedTxAnchor, PersistedCollectionMode, PersistedIndexSpec, PersistedKeySetEvidence, PersistedTx, ReconciledCommittedTx, SQLitePullSinceResult } from '@tanstack/db-sqlite-persistence-core';
+export declare const ELECTRON_PERSISTENCE_PROTOCOL_VERSION: 4;
 export declare const DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = "tanstack-db:sqlite-persistence";
 export type ElectronPersistedRow = Record<string, unknown>;
 export type ElectronPersistedKey = string | number;
@@ -8,7 +8,7 @@ export type ElectronPersistenceResolution = {
     mode: PersistedCollectionMode;
     schemaVersion?: number;
 };
-export type ElectronPersistenceMethod = `loadSubset` | `loadResumeSnapshot` | `loadCollectionMetadata` | `scanRows` | `applyCommittedTx` | `ensureIndex` | `markIndexRemoved` | `pullSince` | `getStreamPosition`;
+export type ElectronPersistenceMethod = `loadSubset` | `loadResumeSnapshot` | `loadCollectionMetadata` | `scanRows` | `applyCommittedTx` | `reconcileCommittedTx` | `ensureIndex` | `markIndexRemoved` | `pullSince` | `getStreamPosition` | `reserveLeadershipTerm`;
 export type ElectronPersistencePayloadMap = {
     loadSubset: {
         options: LoadSubsetOptions;
@@ -31,6 +31,10 @@ export type ElectronPersistencePayloadMap = {
     applyCommittedTx: {
         tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>;
     };
+    reconcileCommittedTx: {
+        tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>;
+        anchor: CommittedTxAnchor;
+    };
     ensureIndex: {
         signature: string;
         spec: PersistedIndexSpec;
@@ -42,6 +46,9 @@ export type ElectronPersistencePayloadMap = {
         fromRowVersion: number;
     };
     getStreamPosition: {};
+    reserveLeadershipTerm: {
+        observedTerm: number;
+    };
 };
 export type ElectronPersistenceResultMap = {
     loadSubset: Array<{
@@ -74,6 +81,7 @@ export type ElectronPersistenceResultMap = {
         metadata?: unknown;
     }>;
     applyCommittedTx: null;
+    reconcileCommittedTx: ReconciledCommittedTx;
     ensureIndex: null;
     markIndexRemoved: null;
     pullSince: SQLitePullSinceResult<ElectronPersistedKey>;
@@ -82,12 +90,18 @@ export type ElectronPersistenceResultMap = {
         latestSeq: number;
         latestRowVersion: number;
     };
+    reserveLeadershipTerm: {
+        latestTerm: number;
+        latestSeq: number;
+        latestRowVersion: number;
+    };
 };
 export type ElectronSerializedError = {
     name: string;
     message: string;
     stack?: string;
-    code?: string;
+    code?: string | number;
+    path?: string | ReadonlyArray<string | number>;
 };
 export type ElectronPersistenceRequestByMethod = {
     [Method in ElectronPersistenceMethod]: {

package/dist/esm/protocol.js

@@ -1,4 +1,4 @@
-const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 2;
+const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 4;
 const DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = `tanstack-db:sqlite-persistence`;
 export {
   DEFAULT_ELECTRON_PERSISTENCE_CHANNEL,

package/dist/esm/protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"protocol.js","sources":["../../src/protocol.ts"],"sourcesContent":["import type { LoadSubsetOptions } from '@tanstack/db'\nimport type {\n  PersistedCollectionMode,\n  PersistedIndexSpec,\n  PersistedKeySetEvidence,\n  PersistedTx,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\n\nexport const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 2 as const\nexport const DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = `tanstack-db:sqlite-persistence`\n\nexport type ElectronPersistedRow = Record<string, unknown>\nexport type ElectronPersistedKey = string | number\n\nexport type ElectronPersistenceResolution = {\n  mode: PersistedCollectionMode\n  schemaVersion?: number\n}\n\nexport type ElectronPersistenceMethod =\n  | `loadSubset`\n  | `loadResumeSnapshot`\n  | `loadCollectionMetadata`\n  | `scanRows`\n  | `applyCommittedTx`\n  | `ensureIndex`\n  | `markIndexRemoved`\n  | `pullSince`\n  | `getStreamPosition`\n\nexport type ElectronPersistencePayloadMap = {\n  loadSubset: {\n    options: LoadSubsetOptions\n    ctx?: { requiredIndexSignatures?: ReadonlyArray<string> }\n  }\n  loadResumeSnapshot: {\n    ctx?: {\n      requiredIndexSignatures?: ReadonlyArray<string>\n      includeRows?: boolean\n    }\n  }\n  loadCollectionMetadata: {}\n  scanRows: {\n    options?: {\n      metadataOnly?: boolean\n    }\n  }\n  applyCommittedTx: {\n    tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>\n  }\n  ensureIndex: {\n    signature: string\n    spec: PersistedIndexSpec\n  }\n  markIndexRemoved: {\n    signature: string\n  }\n  pullSince: {\n    fromRowVersion: number\n  }\n  getStreamPosition: {}\n}\n\nexport type ElectronPersistenceResultMap = {\n  loadSubset: Array<{ key: ElectronPersistedKey; value: ElectronPersistedRow }>\n  loadResumeSnapshot: {\n    rows: Array<{\n      key: ElectronPersistedKey\n      value: ElectronPersistedRow\n      metadata?: unknown\n    }>\n    keySet?: PersistedKeySetEvidence\n    collectionMetadata: Array<{ key: string; value: unknown }>\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n    resetEpoch: number\n  }\n  loadCollectionMetadata: Array<{ key: string; value: unknown }>\n  scanRows: Array<{\n    key: ElectronPersistedKey\n    value: ElectronPersistedRow\n    metadata?: unknown\n  }>\n  applyCommittedTx: null\n  ensureIndex: null\n  markIndexRemoved: null\n  pullSince: SQLitePullSinceResult<ElectronPersistedKey>\n  getStreamPosition: {\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n  }\n}\n\nexport type ElectronSerializedError = {\n  name: string\n  message: string\n  stack?: string\n  code?: string\n}\n\nexport type ElectronPersistenceRequestByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    collectionId: string\n    resolution?: ElectronPersistenceResolution\n    method: Method\n    payload: ElectronPersistencePayloadMap[Method]\n  }\n}\n\nexport type ElectronPersistenceRequest<\n  TMethod extends ElectronPersistenceMethod = ElectronPersistenceMethod,\n> = ElectronPersistenceRequestByMethod[TMethod]\n\nexport type ElectronPersistenceRequestEnvelope =\n  ElectronPersistenceRequestByMethod[ElectronPersistenceMethod]\n\ntype ElectronPersistenceSuccessResponseByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    method: Method\n    ok: true\n    result: ElectronPersistenceResultMap[Method]\n  }\n}\n\ntype ElectronPersistenceErrorResponseByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    method: Method\n    ok: false\n    error: ElectronSerializedError\n  }\n}\n\nexport type ElectronPersistenceResponse<\n  TMethod extends ElectronPersistenceMethod = ElectronPersistenceMethod,\n> =\n  | ElectronPersistenceSuccessResponseByMethod[TMethod]\n  | ElectronPersistenceErrorResponseByMethod[TMethod]\n\nexport type ElectronPersistenceResponseEnvelope =\n  ElectronPersistenceResponse<ElectronPersistenceMethod>\n\nexport type ElectronPersistenceRequestHandler = (\n  request: ElectronPersistenceRequestEnvelope,\n) => Promise<ElectronPersistenceResponseEnvelope>\n\nexport type ElectronPersistenceInvoke = (\n  channel: string,\n  request: ElectronPersistenceRequestEnvelope,\n) => Promise<ElectronPersistenceResponseEnvelope>\n"],"names":[],"mappings":"AASO,MAAM,wCAAwC;AAC9C,MAAM,uCAAuC;"}
+{"version":3,"file":"protocol.js","sources":["../../src/protocol.ts"],"sourcesContent":["import type { LoadSubsetOptions } from '@tanstack/db'\nimport type {\n  CommittedTxAnchor,\n  PersistedCollectionMode,\n  PersistedIndexSpec,\n  PersistedKeySetEvidence,\n  PersistedTx,\n  ReconciledCommittedTx,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\n\nexport const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 4 as const\nexport const DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = `tanstack-db:sqlite-persistence`\n\nexport type ElectronPersistedRow = Record<string, unknown>\nexport type ElectronPersistedKey = string | number\n\nexport type ElectronPersistenceResolution = {\n  mode: PersistedCollectionMode\n  schemaVersion?: number\n}\n\nexport type ElectronPersistenceMethod =\n  | `loadSubset`\n  | `loadResumeSnapshot`\n  | `loadCollectionMetadata`\n  | `scanRows`\n  | `applyCommittedTx`\n  | `reconcileCommittedTx`\n  | `ensureIndex`\n  | `markIndexRemoved`\n  | `pullSince`\n  | `getStreamPosition`\n  | `reserveLeadershipTerm`\n\nexport type ElectronPersistencePayloadMap = {\n  loadSubset: {\n    options: LoadSubsetOptions\n    ctx?: { requiredIndexSignatures?: ReadonlyArray<string> }\n  }\n  loadResumeSnapshot: {\n    ctx?: {\n      requiredIndexSignatures?: ReadonlyArray<string>\n      includeRows?: boolean\n    }\n  }\n  loadCollectionMetadata: {}\n  scanRows: {\n    options?: {\n      metadataOnly?: boolean\n    }\n  }\n  applyCommittedTx: {\n    tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>\n  }\n  reconcileCommittedTx: {\n    tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>\n    anchor: CommittedTxAnchor\n  }\n  ensureIndex: {\n    signature: string\n    spec: PersistedIndexSpec\n  }\n  markIndexRemoved: {\n    signature: string\n  }\n  pullSince: {\n    fromRowVersion: number\n  }\n  getStreamPosition: {}\n  reserveLeadershipTerm: { observedTerm: number }\n}\n\nexport type ElectronPersistenceResultMap = {\n  loadSubset: Array<{ key: ElectronPersistedKey; value: ElectronPersistedRow }>\n  loadResumeSnapshot: {\n    rows: Array<{\n      key: ElectronPersistedKey\n      value: ElectronPersistedRow\n      metadata?: unknown\n    }>\n    keySet?: PersistedKeySetEvidence\n    collectionMetadata: Array<{ key: string; value: unknown }>\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n    resetEpoch: number\n  }\n  loadCollectionMetadata: Array<{ key: string; value: unknown }>\n  scanRows: Array<{\n    key: ElectronPersistedKey\n    value: ElectronPersistedRow\n    metadata?: unknown\n  }>\n  applyCommittedTx: null\n  reconcileCommittedTx: ReconciledCommittedTx\n  ensureIndex: null\n  markIndexRemoved: null\n  pullSince: SQLitePullSinceResult<ElectronPersistedKey>\n  getStreamPosition: {\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n  }\n  reserveLeadershipTerm: {\n    latestTerm: number\n    latestSeq: number\n    latestRowVersion: number\n  }\n}\n\nexport type ElectronSerializedError = {\n  name: string\n  message: string\n  stack?: string\n  code?: string | number\n  path?: string | ReadonlyArray<string | number>\n}\n\nexport type ElectronPersistenceRequestByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    collectionId: string\n    resolution?: ElectronPersistenceResolution\n    method: Method\n    payload: ElectronPersistencePayloadMap[Method]\n  }\n}\n\nexport type ElectronPersistenceRequest<\n  TMethod extends ElectronPersistenceMethod = ElectronPersistenceMethod,\n> = ElectronPersistenceRequestByMethod[TMethod]\n\nexport type ElectronPersistenceRequestEnvelope =\n  ElectronPersistenceRequestByMethod[ElectronPersistenceMethod]\n\ntype ElectronPersistenceSuccessResponseByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    method: Method\n    ok: true\n    result: ElectronPersistenceResultMap[Method]\n  }\n}\n\ntype ElectronPersistenceErrorResponseByMethod = {\n  [Method in ElectronPersistenceMethod]: {\n    v: number\n    requestId: string\n    method: Method\n    ok: false\n    error: ElectronSerializedError\n  }\n}\n\nexport type ElectronPersistenceResponse<\n  TMethod extends ElectronPersistenceMethod = ElectronPersistenceMethod,\n> =\n  | ElectronPersistenceSuccessResponseByMethod[TMethod]\n  | ElectronPersistenceErrorResponseByMethod[TMethod]\n\nexport type ElectronPersistenceResponseEnvelope =\n  ElectronPersistenceResponse<ElectronPersistenceMethod>\n\nexport type ElectronPersistenceRequestHandler = (\n  request: ElectronPersistenceRequestEnvelope,\n) => Promise<ElectronPersistenceResponseEnvelope>\n\nexport type ElectronPersistenceInvoke = (\n  channel: string,\n  request: ElectronPersistenceRequestEnvelope,\n) => Promise<ElectronPersistenceResponseEnvelope>\n"],"names":[],"mappings":"AAWO,MAAM,wCAAwC;AAC9C,MAAM,uCAAuC;"}

package/dist/esm/renderer.js

@@ -74,9 +74,12 @@ function createRendererRequestExecutor(options) {
       if (typeof response.error.stack === `string`) {
         remoteError.stack = response.error.stack;
       }
-      if (typeof response.error.code === `string`) {
+      if (typeof response.error.code === `string` || typeof response.error.code === `number`) {
         remoteError.code = response.error.code;
       }
+      if (response.error.path !== void 0) {
+        remoteError.path = response.error.path;
+      }
       throw remoteError;
     }
     return response.result;
@@ -114,6 +117,14 @@ function createResolvedRendererAdapter(executeRequest, resolution) {
         resolution
       );
     },
+    reconcileCommittedTx: async (collectionId, tx, anchor) => {
+      return executeRequest(
+        `reconcileCommittedTx`,
+        collectionId,
+        { tx, anchor },
+        resolution
+      );
+    },
     loadCollectionMetadata: async (collectionId) => {
       return executeRequest(
         `loadCollectionMetadata`,
@@ -165,7 +176,13 @@ function createResolvedRendererAdapter(executeRequest, resolution) {
     },
     getStreamPosition: async (collectionId) => {
       return executeRequest(`getStreamPosition`, collectionId, {}, resolution);
-    }
+    },
+    reserveLeadershipTerm: async (collectionId, observedTerm) => executeRequest(
+      `reserveLeadershipTerm`,
+      collectionId,
+      { observedTerm },
+      resolution
+    )
   };
 }
 function resolveInvoke(options) {

package/dist/esm/renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.js","sources":["../../src/renderer.ts"],"sourcesContent":["import {\n  InvalidPersistedCollectionConfigError,\n  SingleProcessCoordinator,\n} from '@tanstack/db-sqlite-persistence-core'\nimport { ElectronCollectionCoordinator } from './electron-coordinator'\nimport {\n  DEFAULT_ELECTRON_PERSISTENCE_CHANNEL,\n  ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n} from './protocol'\nimport type {\n  PersistedCollectionCoordinator,\n  PersistedCollectionMode,\n  PersistedCollectionPersistence,\n  PersistedIndexSpec,\n  PersistedTx,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\nimport type {\n  ElectronPersistedKey,\n  ElectronPersistedRow,\n  ElectronPersistenceInvoke,\n  ElectronPersistenceMethod,\n  ElectronPersistencePayloadMap,\n  ElectronPersistenceRequest,\n  ElectronPersistenceRequestEnvelope,\n  ElectronPersistenceResolution,\n  ElectronPersistenceResponseEnvelope,\n  ElectronPersistenceResultMap,\n} from './protocol'\nimport type { LoadSubsetOptions } from '@tanstack/db'\n\nconst DEFAULT_REQUEST_TIMEOUT_MS = 5_000\nlet nextRequestId = 1\n\nfunction createRequestId(): string {\n  const requestId = nextRequestId\n  nextRequestId++\n  return `electron-persistence-${requestId}`\n}\n\nfunction withTimeout<T>(\n  promise: Promise<T>,\n  timeoutMs: number,\n  timeoutMessage: string,\n): Promise<T> {\n  if (timeoutMs <= 0) {\n    return promise\n  }\n\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      reject(new InvalidPersistedCollectionConfigError(timeoutMessage))\n    }, timeoutMs)\n\n    promise.then(\n      (value) => {\n        clearTimeout(timer)\n        resolve(value)\n      },\n      (error: unknown) => {\n        clearTimeout(timer)\n        reject(error)\n      },\n    )\n  })\n}\n\nfunction assertValidResponse(\n  response: ElectronPersistenceResponseEnvelope,\n  request: ElectronPersistenceRequestEnvelope,\n): void {\n  if (response.v !== ELECTRON_PERSISTENCE_PROTOCOL_VERSION) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Unexpected electron persistence protocol version \"${response.v}\" in response`,\n    )\n  }\n\n  if (response.requestId !== request.requestId) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Mismatched electron persistence response request id. Expected \"${request.requestId}\", received \"${response.requestId}\"`,\n    )\n  }\n\n  if (response.method !== request.method) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Mismatched electron persistence response method. Expected \"${request.method}\", received \"${response.method}\"`,\n    )\n  }\n}\n\nfunction createSerializableLoadSubsetOptions(\n  subsetOptions: LoadSubsetOptions,\n): LoadSubsetOptions {\n  const { subscription: _subscription, ...serializableOptions } = subsetOptions\n  return serializableOptions\n}\n\ntype RendererRequestExecutor = <TMethod extends ElectronPersistenceMethod>(\n  method: TMethod,\n  collectionId: string,\n  payload: ElectronPersistencePayloadMap[TMethod],\n  resolution?: ElectronPersistenceResolution,\n) => Promise<ElectronPersistenceResultMap[TMethod]>\n\nfunction createRendererRequestExecutor(options: {\n  invoke: ElectronPersistenceInvoke\n  channel?: string\n  timeoutMs?: number\n}): RendererRequestExecutor {\n  const channel = options.channel ?? DEFAULT_ELECTRON_PERSISTENCE_CHANNEL\n  const timeoutMs = options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS\n\n  return async <TMethod extends ElectronPersistenceMethod>(\n    method: TMethod,\n    collectionId: string,\n    payload: ElectronPersistencePayloadMap[TMethod],\n    resolution?: ElectronPersistenceResolution,\n  ) => {\n    const request = {\n      v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n      requestId: createRequestId(),\n      collectionId,\n      method,\n      resolution,\n      payload,\n    } as ElectronPersistenceRequest\n\n    const response = await withTimeout(\n      options.invoke(channel, request),\n      timeoutMs,\n      `Electron persistence request timed out (method=${method}, collection=${collectionId}, timeoutMs=${timeoutMs})`,\n    )\n    assertValidResponse(response, request)\n\n    if (!response.ok) {\n      const remoteError = new InvalidPersistedCollectionConfigError(\n        `${response.error.name}: ${response.error.message}`,\n      )\n      if (typeof response.error.stack === `string`) {\n        remoteError.stack = response.error.stack\n      }\n      if (typeof response.error.code === `string`) {\n        ;(remoteError as Error & { code?: string }).code = response.error.code\n      }\n      throw remoteError\n    }\n\n    return response.result as ElectronPersistenceResultMap[TMethod]\n  }\n}\n\ntype ElectronRendererResolvedAdapter =\n  PersistedCollectionPersistence[`adapter`] & {\n    loadCollectionMetadata: (\n      collectionId: string,\n    ) => Promise<Array<{ key: string; value: unknown }>>\n    scanRows: (\n      collectionId: string,\n      options?: { metadataOnly?: boolean },\n    ) => Promise<\n      Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    >\n    pullSince: (\n      collectionId: string,\n      fromRowVersion: number,\n    ) => Promise<SQLitePullSinceResult<string | number>>\n    getStreamPosition: (collectionId: string) => Promise<{\n      latestTerm: number\n      latestSeq: number\n      latestRowVersion: number\n    }>\n  }\n\nfunction createResolvedRendererAdapter(\n  executeRequest: RendererRequestExecutor,\n  resolution?: ElectronPersistenceResolution,\n): ElectronRendererResolvedAdapter {\n  return {\n    loadSubset: async (\n      collectionId: string,\n      subsetOptions: LoadSubsetOptions,\n      ctx?: { requiredIndexSignatures?: ReadonlyArray<string> },\n    ) => {\n      const result = await executeRequest(\n        `loadSubset`,\n        collectionId,\n        {\n          options: createSerializableLoadSubsetOptions(subsetOptions),\n          ctx,\n        },\n        resolution,\n      )\n\n      return result as Array<{\n        key: string | number\n        value: Record<string, unknown>\n      }>\n    },\n    loadResumeSnapshot: async (\n      collectionId: string,\n      ctx?: {\n        requiredIndexSignatures?: ReadonlyArray<string>\n        includeRows?: boolean\n      },\n    ) => {\n      return executeRequest(\n        `loadResumeSnapshot`,\n        collectionId,\n        { ctx },\n        resolution,\n      )\n    },\n    applyCommittedTx: async (\n      collectionId: string,\n      tx: PersistedTx<Record<string, unknown>, string | number>,\n    ): Promise<void> => {\n      await executeRequest(\n        `applyCommittedTx`,\n        collectionId,\n        {\n          tx: tx as PersistedTx<ElectronPersistedRow, ElectronPersistedKey>,\n        },\n        resolution,\n      )\n    },\n    loadCollectionMetadata: async (\n      collectionId: string,\n    ): Promise<Array<{ key: string; value: unknown }>> => {\n      return executeRequest(\n        `loadCollectionMetadata`,\n        collectionId,\n        {},\n        resolution,\n      )\n    },\n    scanRows: async (\n      collectionId: string,\n      options?: { metadataOnly?: boolean },\n    ): Promise<\n      Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    > => {\n      const result = await executeRequest(\n        `scanRows`,\n        collectionId,\n        { options },\n        resolution,\n      )\n      return result as Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    },\n    ensureIndex: async (\n      collectionId: string,\n      signature: string,\n      spec: PersistedIndexSpec,\n    ): Promise<void> => {\n      await executeRequest(\n        `ensureIndex`,\n        collectionId,\n        {\n          signature,\n          spec,\n        },\n        resolution,\n      )\n    },\n    markIndexRemoved: async (\n      collectionId: string,\n      signature: string,\n    ): Promise<void> => {\n      await executeRequest(\n        `markIndexRemoved`,\n        collectionId,\n        {\n          signature,\n        },\n        resolution,\n      )\n    },\n    pullSince: async (\n      collectionId: string,\n      fromRowVersion: number,\n    ): Promise<SQLitePullSinceResult<string | number>> => {\n      const result = await executeRequest(\n        `pullSince`,\n        collectionId,\n        {\n          fromRowVersion,\n        },\n        resolution,\n      )\n      return result as SQLitePullSinceResult<string | number>\n    },\n    getStreamPosition: async (\n      collectionId: string,\n    ): Promise<{\n      latestTerm: number\n      latestSeq: number\n      latestRowVersion: number\n    }> => {\n      return executeRequest(`getStreamPosition`, collectionId, {}, resolution)\n    },\n  }\n}\n\nexport type ElectronIpcRendererLike = {\n  invoke: (\n    channel: string,\n    request: ElectronPersistenceRequestEnvelope,\n  ) => Promise<ElectronPersistenceResponseEnvelope>\n}\n\nexport type ElectronSQLitePersistenceOptions = {\n  invoke?: ElectronPersistenceInvoke\n  ipcRenderer?: ElectronIpcRendererLike\n  channel?: string\n  timeoutMs?: number\n  coordinator?: PersistedCollectionCoordinator\n}\n\nfunction resolveInvoke(\n  options: ElectronSQLitePersistenceOptions,\n): ElectronPersistenceInvoke {\n  if (options.invoke) {\n    return options.invoke\n  }\n\n  if (options.ipcRenderer) {\n    return (channel, request) => options.ipcRenderer!.invoke(channel, request)\n  }\n\n  throw new InvalidPersistedCollectionConfigError(\n    `Electron renderer persistence requires either invoke or ipcRenderer`,\n  )\n}\n\nexport function createElectronSQLitePersistence(\n  options: ElectronSQLitePersistenceOptions,\n): PersistedCollectionPersistence {\n  const invoke = resolveInvoke(options)\n  const coordinator = options.coordinator ?? new SingleProcessCoordinator()\n  const executeRequest = createRendererRequestExecutor({\n    invoke,\n    channel: options.channel,\n    timeoutMs: options.timeoutMs,\n  })\n  const adapterCache = new Map<string, ElectronRendererResolvedAdapter>()\n\n  const getAdapterForCollection = (\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ) => {\n    const schemaVersionKey =\n      schemaVersion === undefined ? `schema:default` : `schema:${schemaVersion}`\n    const cacheKey = `mode:${mode}|${schemaVersionKey}`\n    const cachedAdapter = adapterCache.get(cacheKey)\n    if (cachedAdapter) {\n      return cachedAdapter\n    }\n\n    const adapter = createResolvedRendererAdapter(executeRequest, {\n      mode,\n      schemaVersion,\n    })\n    adapterCache.set(cacheKey, adapter)\n    return adapter\n  }\n\n  const createCollectionPersistence = (\n    collectionId: string | undefined,\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ): PersistedCollectionPersistence => {\n    const adapter = getAdapterForCollection(mode, schemaVersion)\n    if (coordinator instanceof ElectronCollectionCoordinator) {\n      if (collectionId === undefined) {\n        coordinator.setAdapter(adapter)\n      } else {\n        coordinator.setAdapterForCollection(collectionId, adapter)\n      }\n    }\n    return { adapter, coordinator }\n  }\n\n  const defaultPersistence = createCollectionPersistence(\n    undefined,\n    `sync-absent`,\n    undefined,\n  )\n  if (coordinator instanceof ElectronCollectionCoordinator) {\n    coordinator.setAdapter(defaultPersistence.adapter)\n  }\n\n  return {\n    ...defaultPersistence,\n    resolvePersistenceForCollection: ({ collectionId, mode, schemaVersion }) =>\n      createCollectionPersistence(collectionId, mode, schemaVersion),\n    // Backward compatible fallback for older callers.\n    resolvePersistenceForMode: (mode) =>\n      createCollectionPersistence(undefined, mode, undefined),\n  }\n}\n"],"names":[],"mappings":";;;AA+BA,MAAM,6BAA6B;AACnC,IAAI,gBAAgB;AAEpB,SAAS,kBAA0B;AACjC,QAAM,YAAY;AAClB;AACA,SAAO,wBAAwB,SAAS;AAC1C;AAEA,SAAS,YACP,SACA,WACA,gBACY;AACZ,MAAI,aAAa,GAAG;AAClB,WAAO;AAAA,EACT;AAEA,SAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACzC,UAAM,QAAQ,WAAW,MAAM;AAC7B,aAAO,IAAI,sCAAsC,cAAc,CAAC;AAAA,IAClE,GAAG,SAAS;AAEZ,YAAQ;AAAA,MACN,CAAC,UAAU;AACT,qBAAa,KAAK;AAClB,gBAAQ,KAAK;AAAA,MACf;AAAA,MACA,CAAC,UAAmB;AAClB,qBAAa,KAAK;AAClB,eAAO,KAAK;AAAA,MACd;AAAA,IAAA;AAAA,EAEJ,CAAC;AACH;AAEA,SAAS,oBACP,UACA,SACM;AACN,MAAI,SAAS,MAAM,uCAAuC;AACxD,UAAM,IAAI;AAAA,MACR,qDAAqD,SAAS,CAAC;AAAA,IAAA;AAAA,EAEnE;AAEA,MAAI,SAAS,cAAc,QAAQ,WAAW;AAC5C,UAAM,IAAI;AAAA,MACR,kEAAkE,QAAQ,SAAS,gBAAgB,SAAS,SAAS;AAAA,IAAA;AAAA,EAEzH;AAEA,MAAI,SAAS,WAAW,QAAQ,QAAQ;AACtC,UAAM,IAAI;AAAA,MACR,8DAA8D,QAAQ,MAAM,gBAAgB,SAAS,MAAM;AAAA,IAAA;AAAA,EAE/G;AACF;AAEA,SAAS,oCACP,eACmB;AACnB,QAAM,EAAE,cAAc,eAAe,GAAG,wBAAwB;AAChE,SAAO;AACT;AASA,SAAS,8BAA8B,SAIX;AAC1B,QAAM,UAAU,QAAQ,WAAW;AACnC,QAAM,YAAY,QAAQ,aAAa;AAEvC,SAAO,OACL,QACA,cACA,SACA,eACG;AACH,UAAM,UAAU;AAAA,MACd,GAAG;AAAA,MACH,WAAW,gBAAA;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAGF,UAAM,WAAW,MAAM;AAAA,MACrB,QAAQ,OAAO,SAAS,OAAO;AAAA,MAC/B;AAAA,MACA,kDAAkD,MAAM,gBAAgB,YAAY,eAAe,SAAS;AAAA,IAAA;AAE9G,wBAAoB,UAAU,OAAO;AAErC,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,cAAc,IAAI;AAAA,QACtB,GAAG,SAAS,MAAM,IAAI,KAAK,SAAS,MAAM,OAAO;AAAA,MAAA;AAEnD,UAAI,OAAO,SAAS,MAAM,UAAU,UAAU;AAC5C,oBAAY,QAAQ,SAAS,MAAM;AAAA,MACrC;AACA,UAAI,OAAO,SAAS,MAAM,SAAS,UAAU;AACzC,oBAA0C,OAAO,SAAS,MAAM;AAAA,MACpE;AACA,YAAM;AAAA,IACR;AAEA,WAAO,SAAS;AAAA,EAClB;AACF;AA4BA,SAAS,8BACP,gBACA,YACiC;AACjC,SAAO;AAAA,IACL,YAAY,OACV,cACA,eACA,QACG;AACH,YAAM,SAAS,MAAM;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,UACE,SAAS,oCAAoC,aAAa;AAAA,UAC1D;AAAA,QAAA;AAAA,QAEF;AAAA,MAAA;AAGF,aAAO;AAAA,IAIT;AAAA,IACA,oBAAoB,OAClB,cACA,QAIG;AACH,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,EAAE,IAAA;AAAA,QACF;AAAA,MAAA;AAAA,IAEJ;AAAA,IACA,kBAAkB,OAChB,cACA,OACkB;AAClB,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,UACE;AAAA,QAAA;AAAA,QAEF;AAAA,MAAA;AAAA,IAEJ;AAAA,IACA,wBAAwB,OACtB,iBACoD;AACpD,aAAO;AAAA,QACL;AAAA,QACA;AAAA,QACA,CAAA;AAAA,QACA;AAAA,MAAA;AAAA,IAEJ;AAAA,IACA,UAAU,OACR,cACA,YAOG;AACH,YAAM,SAAS,MAAM;AAAA,QACnB;AAAA,QACA;AAAA,QACA,EAAE,QAAA;AAAA,QACF;AAAA,MAAA;AAEF,aAAO;AAAA,IAKT;AAAA,IACA,aAAa,OACX,cACA,WACA,SACkB;AAClB,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,UACE;AAAA,UACA;AAAA,QAAA;AAAA,QAEF;AAAA,MAAA;AAAA,IAEJ;AAAA,IACA,kBAAkB,OAChB,cACA,cACkB;AAClB,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,UACE;AAAA,QAAA;AAAA,QAEF;AAAA,MAAA;AAAA,IAEJ;AAAA,IACA,WAAW,OACT,cACA,mBACoD;AACpD,YAAM,SAAS,MAAM;AAAA,QACnB;AAAA,QACA;AAAA,QACA;AAAA,UACE;AAAA,QAAA;AAAA,QAEF;AAAA,MAAA;AAEF,aAAO;AAAA,IACT;AAAA,IACA,mBAAmB,OACjB,iBAKI;AACJ,aAAO,eAAe,qBAAqB,cAAc,CAAA,GAAI,UAAU;AAAA,IACzE;AAAA,EAAA;AAEJ;AAiBA,SAAS,cACP,SAC2B;AAC3B,MAAI,QAAQ,QAAQ;AAClB,WAAO,QAAQ;AAAA,EACjB;AAEA,MAAI,QAAQ,aAAa;AACvB,WAAO,CAAC,SAAS,YAAY,QAAQ,YAAa,OAAO,SAAS,OAAO;AAAA,EAC3E;AAEA,QAAM,IAAI;AAAA,IACR;AAAA,EAAA;AAEJ;AAEO,SAAS,gCACd,SACgC;AAChC,QAAM,SAAS,cAAc,OAAO;AACpC,QAAM,cAAc,QAAQ,eAAe,IAAI,yBAAA;AAC/C,QAAM,iBAAiB,8BAA8B;AAAA,IACnD;AAAA,IACA,SAAS,QAAQ;AAAA,IACjB,WAAW,QAAQ;AAAA,EAAA,CACpB;AACD,QAAM,mCAAmB,IAAA;AAEzB,QAAM,0BAA0B,CAC9B,MACA,kBACG;AACH,UAAM,mBACJ,kBAAkB,SAAY,mBAAmB,UAAU,aAAa;AAC1E,UAAM,WAAW,QAAQ,IAAI,IAAI,gBAAgB;AACjD,UAAM,gBAAgB,aAAa,IAAI,QAAQ;AAC/C,QAAI,eAAe;AACjB,aAAO;AAAA,IACT;AAEA,UAAM,UAAU,8BAA8B,gBAAgB;AAAA,MAC5D;AAAA,MACA;AAAA,IAAA,CACD;AACD,iBAAa,IAAI,UAAU,OAAO;AAClC,WAAO;AAAA,EACT;AAEA,QAAM,8BAA8B,CAClC,cACA,MACA,kBACmC;AACnC,UAAM,UAAU,wBAAwB,MAAM,aAAa;AAC3D,QAAI,uBAAuB,+BAA+B;AACxD,UAAI,iBAAiB,QAAW;AAC9B,oBAAY,WAAW,OAAO;AAAA,MAChC,OAAO;AACL,oBAAY,wBAAwB,cAAc,OAAO;AAAA,MAC3D;AAAA,IACF;AACA,WAAO,EAAE,SAAS,YAAA;AAAA,EACpB;AAEA,QAAM,qBAAqB;AAAA,IACzB;AAAA,IACA;AAAA,IACA;AAAA,EAAA;AAEF,MAAI,uBAAuB,+BAA+B;AACxD,gBAAY,WAAW,mBAAmB,OAAO;AAAA,EACnD;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,iCAAiC,CAAC,EAAE,cAAc,MAAM,oBACtD,4BAA4B,cAAc,MAAM,aAAa;AAAA;AAAA,IAE/D,2BAA2B,CAAC,SAC1B,4BAA4B,QAAW,MAAM,MAAS;AAAA,EAAA;AAE5D;"}
+{"version":3,"file":"renderer.js","sources":["../../src/renderer.ts"],"sourcesContent":["import {\n  InvalidPersistedCollectionConfigError,\n  SingleProcessCoordinator,\n} from '@tanstack/db-sqlite-persistence-core'\nimport { ElectronCollectionCoordinator } from './electron-coordinator'\nimport {\n  DEFAULT_ELECTRON_PERSISTENCE_CHANNEL,\n  ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n} from './protocol'\nimport type {\n  CommittedTxAnchor,\n  PersistedCollectionCoordinator,\n  PersistedCollectionMode,\n  PersistedCollectionPersistence,\n  PersistedIndexSpec,\n  PersistedTx,\n  ReconciledCommittedTx,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\nimport type {\n  ElectronPersistedKey,\n  ElectronPersistedRow,\n  ElectronPersistenceInvoke,\n  ElectronPersistenceMethod,\n  ElectronPersistencePayloadMap,\n  ElectronPersistenceRequest,\n  ElectronPersistenceRequestEnvelope,\n  ElectronPersistenceResolution,\n  ElectronPersistenceResponseEnvelope,\n  ElectronPersistenceResultMap,\n} from './protocol'\nimport type { LoadSubsetOptions } from '@tanstack/db'\n\nconst DEFAULT_REQUEST_TIMEOUT_MS = 5_000\nlet nextRequestId = 1\n\nfunction createRequestId(): string {\n  const requestId = nextRequestId\n  nextRequestId++\n  return `electron-persistence-${requestId}`\n}\n\nfunction withTimeout<T>(\n  promise: Promise<T>,\n  timeoutMs: number,\n  timeoutMessage: string,\n): Promise<T> {\n  if (timeoutMs <= 0) {\n    return promise\n  }\n\n  return new Promise<T>((resolve, reject) => {\n    const timer = setTimeout(() => {\n      reject(new InvalidPersistedCollectionConfigError(timeoutMessage))\n    }, timeoutMs)\n\n    promise.then(\n      (value) => {\n        clearTimeout(timer)\n        resolve(value)\n      },\n      (error: unknown) => {\n        clearTimeout(timer)\n        reject(error)\n      },\n    )\n  })\n}\n\nfunction assertValidResponse(\n  response: ElectronPersistenceResponseEnvelope,\n  request: ElectronPersistenceRequestEnvelope,\n): void {\n  if (response.v !== ELECTRON_PERSISTENCE_PROTOCOL_VERSION) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Unexpected electron persistence protocol version \"${response.v}\" in response`,\n    )\n  }\n\n  if (response.requestId !== request.requestId) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Mismatched electron persistence response request id. Expected \"${request.requestId}\", received \"${response.requestId}\"`,\n    )\n  }\n\n  if (response.method !== request.method) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Mismatched electron persistence response method. Expected \"${request.method}\", received \"${response.method}\"`,\n    )\n  }\n}\n\nfunction createSerializableLoadSubsetOptions(\n  subsetOptions: LoadSubsetOptions,\n): LoadSubsetOptions {\n  const { subscription: _subscription, ...serializableOptions } = subsetOptions\n  return serializableOptions\n}\n\ntype RendererRequestExecutor = <TMethod extends ElectronPersistenceMethod>(\n  method: TMethod,\n  collectionId: string,\n  payload: ElectronPersistencePayloadMap[TMethod],\n  resolution?: ElectronPersistenceResolution,\n) => Promise<ElectronPersistenceResultMap[TMethod]>\n\nfunction createRendererRequestExecutor(options: {\n  invoke: ElectronPersistenceInvoke\n  channel?: string\n  timeoutMs?: number\n}): RendererRequestExecutor {\n  const channel = options.channel ?? DEFAULT_ELECTRON_PERSISTENCE_CHANNEL\n  const timeoutMs = options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS\n\n  return async <TMethod extends ElectronPersistenceMethod>(\n    method: TMethod,\n    collectionId: string,\n    payload: ElectronPersistencePayloadMap[TMethod],\n    resolution?: ElectronPersistenceResolution,\n  ) => {\n    const request = {\n      v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n      requestId: createRequestId(),\n      collectionId,\n      method,\n      resolution,\n      payload,\n    } as ElectronPersistenceRequest\n\n    const response = await withTimeout(\n      options.invoke(channel, request),\n      timeoutMs,\n      `Electron persistence request timed out (method=${method}, collection=${collectionId}, timeoutMs=${timeoutMs})`,\n    )\n    assertValidResponse(response, request)\n\n    if (!response.ok) {\n      const remoteError = new InvalidPersistedCollectionConfigError(\n        `${response.error.name}: ${response.error.message}`,\n      )\n      if (typeof response.error.stack === `string`) {\n        remoteError.stack = response.error.stack\n      }\n      if (\n        typeof response.error.code === `string` ||\n        typeof response.error.code === `number`\n      ) {\n        ;(remoteError as Error & { code?: string | number }).code =\n          response.error.code\n      }\n      if (response.error.path !== undefined) {\n        ;(\n          remoteError as Error & {\n            path?: string | ReadonlyArray<string | number>\n          }\n        ).path = response.error.path\n      }\n      throw remoteError\n    }\n\n    return response.result as ElectronPersistenceResultMap[TMethod]\n  }\n}\n\ntype ElectronRendererResolvedAdapter =\n  PersistedCollectionPersistence[`adapter`] & {\n    loadCollectionMetadata: (\n      collectionId: string,\n    ) => Promise<Array<{ key: string; value: unknown }>>\n    scanRows: (\n      collectionId: string,\n      options?: { metadataOnly?: boolean },\n    ) => Promise<\n      Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    >\n    pullSince: (\n      collectionId: string,\n      fromRowVersion: number,\n    ) => Promise<SQLitePullSinceResult<string | number>>\n    getStreamPosition: (collectionId: string) => Promise<{\n      latestTerm: number\n      latestSeq: number\n      latestRowVersion: number\n    }>\n    reserveLeadershipTerm: (\n      collectionId: string,\n      observedTerm: number,\n    ) => Promise<{\n      latestTerm: number\n      latestSeq: number\n      latestRowVersion: number\n    }>\n  }\n\nfunction createResolvedRendererAdapter(\n  executeRequest: RendererRequestExecutor,\n  resolution?: ElectronPersistenceResolution,\n): ElectronRendererResolvedAdapter {\n  return {\n    loadSubset: async (\n      collectionId: string,\n      subsetOptions: LoadSubsetOptions,\n      ctx?: { requiredIndexSignatures?: ReadonlyArray<string> },\n    ) => {\n      const result = await executeRequest(\n        `loadSubset`,\n        collectionId,\n        {\n          options: createSerializableLoadSubsetOptions(subsetOptions),\n          ctx,\n        },\n        resolution,\n      )\n\n      return result as Array<{\n        key: string | number\n        value: Record<string, unknown>\n      }>\n    },\n    loadResumeSnapshot: async (\n      collectionId: string,\n      ctx?: {\n        requiredIndexSignatures?: ReadonlyArray<string>\n        includeRows?: boolean\n      },\n    ) => {\n      return executeRequest(\n        `loadResumeSnapshot`,\n        collectionId,\n        { ctx },\n        resolution,\n      )\n    },\n    applyCommittedTx: async (\n      collectionId: string,\n      tx: PersistedTx<Record<string, unknown>, string | number>,\n    ): Promise<void> => {\n      await executeRequest(\n        `applyCommittedTx`,\n        collectionId,\n        {\n          tx: tx as PersistedTx<ElectronPersistedRow, ElectronPersistedKey>,\n        },\n        resolution,\n      )\n    },\n    reconcileCommittedTx: async (\n      collectionId: string,\n      tx: PersistedTx<Record<string, unknown>, string | number>,\n      anchor: CommittedTxAnchor,\n    ): Promise<ReconciledCommittedTx> => {\n      return executeRequest(\n        `reconcileCommittedTx`,\n        collectionId,\n        { tx, anchor },\n        resolution,\n      )\n    },\n    loadCollectionMetadata: async (\n      collectionId: string,\n    ): Promise<Array<{ key: string; value: unknown }>> => {\n      return executeRequest(\n        `loadCollectionMetadata`,\n        collectionId,\n        {},\n        resolution,\n      )\n    },\n    scanRows: async (\n      collectionId: string,\n      options?: { metadataOnly?: boolean },\n    ): Promise<\n      Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    > => {\n      const result = await executeRequest(\n        `scanRows`,\n        collectionId,\n        { options },\n        resolution,\n      )\n      return result as Array<{\n        key: string | number\n        value: Record<string, unknown>\n        metadata?: unknown\n      }>\n    },\n    ensureIndex: async (\n      collectionId: string,\n      signature: string,\n      spec: PersistedIndexSpec,\n    ): Promise<void> => {\n      await executeRequest(\n        `ensureIndex`,\n        collectionId,\n        {\n          signature,\n          spec,\n        },\n        resolution,\n      )\n    },\n    markIndexRemoved: async (\n      collectionId: string,\n      signature: string,\n    ): Promise<void> => {\n      await executeRequest(\n        `markIndexRemoved`,\n        collectionId,\n        {\n          signature,\n        },\n        resolution,\n      )\n    },\n    pullSince: async (\n      collectionId: string,\n      fromRowVersion: number,\n    ): Promise<SQLitePullSinceResult<string | number>> => {\n      const result = await executeRequest(\n        `pullSince`,\n        collectionId,\n        {\n          fromRowVersion,\n        },\n        resolution,\n      )\n      return result as SQLitePullSinceResult<string | number>\n    },\n    getStreamPosition: async (\n      collectionId: string,\n    ): Promise<{\n      latestTerm: number\n      latestSeq: number\n      latestRowVersion: number\n    }> => {\n      return executeRequest(`getStreamPosition`, collectionId, {}, resolution)\n    },\n    reserveLeadershipTerm: async (collectionId, observedTerm) =>\n      executeRequest(\n        `reserveLeadershipTerm`,\n        collectionId,\n        { observedTerm },\n        resolution,\n      ),\n  }\n}\n\nexport type ElectronIpcRendererLike = {\n  invoke: (\n    channel: string,\n    request: ElectronPersistenceRequestEnvelope,\n  ) => Promise<ElectronPersistenceResponseEnvelope>\n}\n\nexport type ElectronSQLitePersistenceOptions = {\n  invoke?: ElectronPersistenceInvoke\n  ipcRenderer?: ElectronIpcRendererLike\n  channel?: string\n  timeoutMs?: number\n  coordinator?: PersistedCollectionCoordinator\n}\n\nfunction resolveInvoke(\n  options: ElectronSQLitePersistenceOptions,\n): ElectronPersistenceInvoke {\n  if (options.invoke) {\n    return options.invoke\n  }\n\n  if (options.ipcRenderer) {\n    return (channel, request) => options.ipcRenderer!.invoke(channel, request)\n  }\n\n  throw new InvalidPersistedCollectionConfigError(\n    `Electron renderer persistence requires either invoke or ipcRenderer`,\n  )\n}\n\nexport function createElectronSQLitePersistence(\n  options: ElectronSQLitePersistenceOptions,\n): PersistedCollectionPersistence {\n  const invoke = resolveInvoke(options)\n  const coordinator = options.coordinator ?? new SingleProcessCoordinator()\n  const executeRequest = createRendererRequestExecutor({\n    invoke,\n    channel: options.channel,\n    timeoutMs: options.timeoutMs,\n  })\n  const adapterCache = new Map<string, ElectronRendererResolvedAdapter>()\n\n  const getAdapterForCollection = (\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ) => {\n    const schemaVersionKey =\n      schemaVersion === undefined ? `schema:default` : `schema:${schemaVersion}`\n    const cacheKey = `mode:${mode}|${schemaVersionKey}`\n    const cachedAdapter = adapterCache.get(cacheKey)\n    if (cachedAdapter) {\n      return cachedAdapter\n    }\n\n    const adapter = createResolvedRendererAdapter(executeRequest, {\n      mode,\n      schemaVersion,\n    })\n    adapterCache.set(cacheKey, adapter)\n    return adapter\n  }\n\n  const createCollectionPersistence = (\n    collectionId: string | undefined,\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ): PersistedCollectionPersistence => {\n    const adapter = getAdapterForCollection(mode, schemaVersion)\n    if (coordinator instanceof ElectronCollectionCoordinator) {\n      if (collectionId === undefined) {\n        coordinator.setAdapter(adapter)\n      } else {\n        coordinator.setAdapterForCollection(collectionId, adapter)\n      }\n    }\n    return { adapter, coordinator }\n  }\n\n  const defaultPersistence = createCollectionPersistence(\n    undefined,\n    `sync-absent`,\n    undefined,\n  )\n  if (coordinator instanceof ElectronCollectionCoordinator) {\n    coordinator.setAdapter(defaultPersistence.adapter)\n  }\n\n  return {\n    ...defaultPersistence,\n    resolvePersistenceForCollection: ({ collectionId, mode, schemaVersion }) =>\n      createCollectionPersistence(collectionId, mode, schemaVersion),\n    // Backward compatible fallback for older callers.\n    resolvePersistenceForMode: (mode) =>\n      createCollectionPersistence(undefined, mode, undefined),\n  }\n}\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/electron-db-sqlite-persistence",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "Electron SQLite persisted collection bridge for TanStack DB",
   "author": "TanStack Team",
   "license": "MIT",
@@ -60,7 +60,7 @@
     "src"
   ],
   "dependencies": {
-    "@tanstack/db-sqlite-persistence-core": "0.4.7"
+    "@tanstack/db-sqlite-persistence-core": "0.4.8"
   },
   "peerDependencies": {
     "typescript": ">=4.7"

package/src/errors.ts

@@ -4,12 +4,12 @@ import type {
 } from './protocol'
 
 type ElectronPersistenceErrorOptions = {
-  code?: string
+  code?: string | number
   cause?: unknown
 }
 
 export class ElectronPersistenceError extends Error {
-  readonly code: string | undefined
+  readonly code: string | number | undefined
 
   constructor(message: string, options?: ElectronPersistenceErrorOptions) {
     super(message, { cause: options?.cause })

package/src/main.ts

@@ -52,12 +52,26 @@ function serializeError(error: unknown): ElectronSerializedError {
     }
   }
 
-  const codedError = error as Error & { code?: unknown }
+  const detailedError = error as Error & { code?: unknown; path?: unknown }
+  const path = detailedError.path
   return {
     name: error.name || `Error`,
     message: error.message || fallbackMessage,
     stack: error.stack,
-    code: typeof codedError.code === `string` ? codedError.code : undefined,
+    code:
+      typeof detailedError.code === `string` ||
+      typeof detailedError.code === `number`
+        ? detailedError.code
+        : undefined,
+    path:
+      typeof path === `string` ||
+      (Array.isArray(path) &&
+        path.every(
+          (segment: unknown) =>
+            typeof segment === `string` || typeof segment === `number`,
+        ))
+        ? (path as string | ReadonlyArray<string | number>)
+        : undefined,
   }
 }
 
@@ -180,6 +194,23 @@ async function executeRequestAgainstAdapter(
       }
     }
 
+    case `reconcileCommittedTx`: {
+      const result = adapter.reconcileCommittedTx
+        ? await adapter.reconcileCommittedTx(
+            request.collectionId,
+            request.payload.tx,
+            request.payload.anchor,
+          )
+        : { kind: `unknown` as const }
+      return {
+        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
+        requestId: request.requestId,
+        method: request.method,
+        ok: true,
+        result,
+      }
+    }
+
     case `ensureIndex`: {
       await adapter.ensureIndex(
         request.collectionId,
@@ -233,6 +264,25 @@ async function executeRequestAgainstAdapter(
       }
     }
 
+    case `reserveLeadershipTerm`: {
+      if (!adapter.reserveLeadershipTerm) {
+        throw new InvalidPersistedCollectionConfigError(
+          `reserveLeadershipTerm is not supported by the configured electron persistence adapter`,
+        )
+      }
+      const position = await adapter.reserveLeadershipTerm(
+        request.collectionId,
+        request.payload.observedTerm,
+      )
+      return {
+        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
+        requestId: request.requestId,
+        method: request.method,
+        ok: true,
+        result: position,
+      }
+    }
+
     case `getStreamPosition`: {
       if (!adapter.getStreamPosition) {
         throw new InvalidPersistedCollectionConfigError(

package/src/protocol.ts

@@ -1,13 +1,15 @@
 import type { LoadSubsetOptions } from '@tanstack/db'
 import type {
+  CommittedTxAnchor,
   PersistedCollectionMode,
   PersistedIndexSpec,
   PersistedKeySetEvidence,
   PersistedTx,
+  ReconciledCommittedTx,
   SQLitePullSinceResult,
 } from '@tanstack/db-sqlite-persistence-core'
 
-export const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 2 as const
+export const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 4 as const
 export const DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = `tanstack-db:sqlite-persistence`
 
 export type ElectronPersistedRow = Record<string, unknown>
@@ -24,10 +26,12 @@ export type ElectronPersistenceMethod =
   | `loadCollectionMetadata`
   | `scanRows`
   | `applyCommittedTx`
+  | `reconcileCommittedTx`
   | `ensureIndex`
   | `markIndexRemoved`
   | `pullSince`
   | `getStreamPosition`
+  | `reserveLeadershipTerm`
 
 export type ElectronPersistencePayloadMap = {
   loadSubset: {
@@ -49,6 +53,10 @@ export type ElectronPersistencePayloadMap = {
   applyCommittedTx: {
     tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>
   }
+  reconcileCommittedTx: {
+    tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>
+    anchor: CommittedTxAnchor
+  }
   ensureIndex: {
     signature: string
     spec: PersistedIndexSpec
@@ -60,6 +68,7 @@ export type ElectronPersistencePayloadMap = {
     fromRowVersion: number
   }
   getStreamPosition: {}
+  reserveLeadershipTerm: { observedTerm: number }
 }
 
 export type ElectronPersistenceResultMap = {
@@ -84,6 +93,7 @@ export type ElectronPersistenceResultMap = {
     metadata?: unknown
   }>
   applyCommittedTx: null
+  reconcileCommittedTx: ReconciledCommittedTx
   ensureIndex: null
   markIndexRemoved: null
   pullSince: SQLitePullSinceResult<ElectronPersistedKey>
@@ -92,13 +102,19 @@ export type ElectronPersistenceResultMap = {
     latestSeq: number
     latestRowVersion: number
   }
+  reserveLeadershipTerm: {
+    latestTerm: number
+    latestSeq: number
+    latestRowVersion: number
+  }
 }
 
 export type ElectronSerializedError = {
   name: string
   message: string
   stack?: string
-  code?: string
+  code?: string | number
+  path?: string | ReadonlyArray<string | number>
 }
 
 export type ElectronPersistenceRequestByMethod = {

package/src/renderer.ts

@@ -8,11 +8,13 @@ import {
   ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
 } from './protocol'
 import type {
+  CommittedTxAnchor,
   PersistedCollectionCoordinator,
   PersistedCollectionMode,
   PersistedCollectionPersistence,
   PersistedIndexSpec,
   PersistedTx,
+  ReconciledCommittedTx,
   SQLitePullSinceResult,
 } from '@tanstack/db-sqlite-persistence-core'
 import type {
@@ -139,8 +141,19 @@ function createRendererRequestExecutor(options: {
       if (typeof response.error.stack === `string`) {
         remoteError.stack = response.error.stack
       }
-      if (typeof response.error.code === `string`) {
-        ;(remoteError as Error & { code?: string }).code = response.error.code
+      if (
+        typeof response.error.code === `string` ||
+        typeof response.error.code === `number`
+      ) {
+        ;(remoteError as Error & { code?: string | number }).code =
+          response.error.code
+      }
+      if (response.error.path !== undefined) {
+        ;(
+          remoteError as Error & {
+            path?: string | ReadonlyArray<string | number>
+          }
+        ).path = response.error.path
       }
       throw remoteError
     }
@@ -173,6 +186,14 @@ type ElectronRendererResolvedAdapter =
       latestSeq: number
       latestRowVersion: number
     }>
+    reserveLeadershipTerm: (
+      collectionId: string,
+      observedTerm: number,
+    ) => Promise<{
+      latestTerm: number
+      latestSeq: number
+      latestRowVersion: number
+    }>
   }
 
 function createResolvedRendererAdapter(
@@ -227,6 +248,18 @@ function createResolvedRendererAdapter(
         resolution,
       )
     },
+    reconcileCommittedTx: async (
+      collectionId: string,
+      tx: PersistedTx<Record<string, unknown>, string | number>,
+      anchor: CommittedTxAnchor,
+    ): Promise<ReconciledCommittedTx> => {
+      return executeRequest(
+        `reconcileCommittedTx`,
+        collectionId,
+        { tx, anchor },
+        resolution,
+      )
+    },
     loadCollectionMetadata: async (
       collectionId: string,
     ): Promise<Array<{ key: string; value: unknown }>> => {
@@ -310,6 +343,13 @@ function createResolvedRendererAdapter(
     }> => {
       return executeRequest(`getStreamPosition`, collectionId, {}, resolution)
     },
+    reserveLeadershipTerm: async (collectionId, observedTerm) =>
+      executeRequest(
+        `reserveLeadershipTerm`,
+        collectionId,
+        { observedTerm },
+        resolution,
+      ),
   }
 }