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

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
+v5 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
@@ -136,6 +143,14 @@ idempotent.
 ## Notes
 
 - The renderer API mirrors other runtimes: one shared `create...Persistence`.
+- IPC protocol v6 forwards explicit eager or managed storage targets,
+  on-demand cache claims, rotation, renewal, release, claim checks on SQLite
+  reads and writes, exact transaction-ID
+  reconciliation, and claim-scoped leadership-term reservation. Upgrade main
+  and renderer together.
+  If a custom main-process adapter does not implement these operations, pass
+  `managedCacheGenerations: false` to `createElectronSQLitePersistence` to keep
+  the full-shape recovery fallback.
 - Collection mode (`sync-present` vs `sync-absent`) and `schemaVersion` are
   resolved per collection and forwarded across IPC automatically.
 - Without an `ElectronCollectionCoordinator`, single-renderer mode uses

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) {
@@ -45,11 +49,25 @@ function assertValidRequest(request) {
     );
   }
 }
+function requireStorageTarget(request) {
+  const target = request.storageTarget;
+  if (!target) {
+    throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+      `Electron persistence data request requires an explicit storage target`
+    );
+  }
+  if (dbSqlitePersistenceCore.resolvePersistedStorageTarget(target).collectionId !== request.collectionId) {
+    throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+      `Electron persistence storage target does not match its collectionId`
+    );
+  }
+  return target;
+}
 async function executeRequestAgainstAdapter(request, adapter) {
   switch (request.method) {
     case `loadSubset`: {
       const result = await adapter.loadSubset(
-        request.collectionId,
+        requireStorageTarget(request),
         request.payload.options,
         request.payload.ctx
       );
@@ -63,7 +81,7 @@ async function executeRequestAgainstAdapter(request, adapter) {
     }
     case `loadResumeSnapshot`: {
       const result = await adapter.loadResumeSnapshot(
-        request.collectionId,
+        requireStorageTarget(request),
         request.payload.ctx
       );
       return {
@@ -80,7 +98,10 @@ async function executeRequestAgainstAdapter(request, adapter) {
           `loadCollectionMetadata is not supported by the configured electron persistence adapter`
         );
       }
-      const result = await adapter.loadCollectionMetadata(request.collectionId);
+      const result = await adapter.loadCollectionMetadata(
+        requireStorageTarget(request),
+        request.payload.ctx
+      );
       return {
         v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
         requestId: request.requestId,
@@ -96,8 +117,9 @@ async function executeRequestAgainstAdapter(request, adapter) {
         );
       }
       const result = await adapter.scanRows(
-        request.collectionId,
-        request.payload.options
+        requireStorageTarget(request),
+        request.payload.options,
+        request.payload.ctx
       );
       return {
         v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
@@ -108,7 +130,10 @@ async function executeRequestAgainstAdapter(request, adapter) {
       };
     }
     case `applyCommittedTx`: {
-      await adapter.applyCommittedTx(request.collectionId, request.payload.tx);
+      await adapter.applyCommittedTx(
+        requireStorageTarget(request),
+        request.payload.tx
+      );
       return {
         v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
         requestId: request.requestId,
@@ -117,11 +142,26 @@ async function executeRequestAgainstAdapter(request, adapter) {
         result: null
       };
     }
+    case `reconcileCommittedTx`: {
+      const result = adapter.reconcileCommittedTx ? await adapter.reconcileCommittedTx(
+        requireStorageTarget(request),
+        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,
+        requireStorageTarget(request),
         request.payload.signature,
-        request.payload.spec
+        request.payload.spec,
+        request.payload.ctx
       );
       return {
         v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
@@ -138,8 +178,9 @@ async function executeRequestAgainstAdapter(request, adapter) {
         );
       }
       await adapter.markIndexRemoved(
-        request.collectionId,
-        request.payload.signature
+        requireStorageTarget(request),
+        request.payload.signature,
+        request.payload.ctx
       );
       return {
         v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
@@ -156,8 +197,9 @@ async function executeRequestAgainstAdapter(request, adapter) {
         );
       }
       const result = await adapter.pullSince(
-        request.collectionId,
-        request.payload.fromRowVersion
+        requireStorageTarget(request),
+        request.payload.fromRowVersion,
+        request.payload.ctx
       );
       return {
         v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
@@ -167,13 +209,35 @@ 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(
+        requireStorageTarget(request),
+        request.payload.observedTerm,
+        request.payload.ctx
+      );
+      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(
           `getStreamPosition is not supported by the configured electron persistence adapter`
         );
       }
-      const position = await adapter.getStreamPosition(request.collectionId);
+      const position = await adapter.getStreamPosition(
+        requireStorageTarget(request),
+        request.payload.ctx
+      );
       return {
         v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
         requestId: request.requestId,
@@ -182,13 +246,86 @@ async function executeRequestAgainstAdapter(request, adapter) {
         result: position
       };
     }
+    case `claimCacheGeneration`: {
+      if (!adapter.claimCacheGeneration) {
+        throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+          `claimCacheGeneration is not supported by the configured electron persistence adapter`
+        );
+      }
+      const result = await adapter.claimCacheGeneration(request.collectionId);
+      return {
+        v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
+        requestId: request.requestId,
+        method: request.method,
+        ok: true,
+        result
+      };
+    }
+    case `rotateCacheGeneration`: {
+      if (!adapter.rotateCacheGeneration) {
+        throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+          `rotateCacheGeneration is not supported by the configured electron persistence adapter`
+        );
+      }
+      const result = await adapter.rotateCacheGeneration(
+        request.collectionId,
+        request.payload.claimId,
+        request.payload.resetMetadata,
+        request.payload.expectedStorageCollectionId
+      );
+      return {
+        v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
+        requestId: request.requestId,
+        method: request.method,
+        ok: true,
+        result
+      };
+    }
+    case `renewCacheGenerationClaim`: {
+      if (!adapter.renewCacheGenerationClaim) {
+        throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+          `renewCacheGenerationClaim is not supported by the configured electron persistence adapter`
+        );
+      }
+      const result = await adapter.renewCacheGenerationClaim(
+        request.payload.storageCollectionId,
+        request.payload.claimId
+      );
+      return {
+        v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
+        requestId: request.requestId,
+        method: request.method,
+        ok: true,
+        result
+      };
+    }
+    case `releaseCacheGenerationClaim`: {
+      if (!adapter.releaseCacheGenerationClaim) {
+        throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+          `releaseCacheGenerationClaim is not supported by the configured electron persistence adapter`
+        );
+      }
+      await adapter.releaseCacheGenerationClaim(request.payload.claimId);
+      return {
+        v: protocol.ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
+        requestId: request.requestId,
+        method: request.method,
+        ok: true,
+        result: null
+      };
+    }
   }
 }
 function resolveModeAwarePersistence(persistence, request) {
+  if (request.storageTarget?.kind === `managed` && !request.resolution?.logicalCollectionId) {
+    throw new dbSqlitePersistenceCore.InvalidPersistedCollectionConfigError(
+      `Electron managed cache request requires a logical Collection ID`
+    );
+  }
   const mode = request.resolution?.mode ?? `sync-absent`;
   const schemaVersion = request.resolution?.schemaVersion;
   const collectionAwarePersistence = persistence.resolvePersistenceForCollection?.({
-    collectionId: request.collectionId,
+    collectionId: request.resolution?.logicalCollectionId ?? request.collectionId,
     mode,
     schemaVersion
   });

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 {\n  InvalidPersistedCollectionConfigError,\n  resolvePersistedStorageTarget,\n} 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  PersistedStorageTarget,\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    target: PersistedStorageTarget,\n    ctx?: { cacheGenerationClaimId?: string },\n  ) => Promise<Array<{ key: string; value: unknown }>>\n  scanRows?: (\n    target: PersistedStorageTarget,\n    options?: { metadataOnly?: boolean },\n    ctx?: { cacheGenerationClaimId?: string },\n  ) => Promise<\n    Array<{\n      key: ElectronPersistedKey\n      value: ElectronPersistedRow\n      metadata?: unknown\n    }>\n  >\n  pullSince?: (\n    target: PersistedStorageTarget,\n    fromRowVersion: number,\n    ctx?: { cacheGenerationClaimId?: string },\n  ) => Promise<SQLitePullSinceResult<ElectronPersistedKey>>\n  getStreamPosition?: (\n    target: PersistedStorageTarget,\n    ctx?: { cacheGenerationClaimId?: string },\n  ) => 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\nfunction requireStorageTarget(\n  request: ElectronPersistenceRequestEnvelope,\n): PersistedStorageTarget {\n  const target = request.storageTarget\n  if (!target) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence data request requires an explicit storage target`,\n    )\n  }\n  if (\n    resolvePersistedStorageTarget(target).collectionId !== request.collectionId\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence storage target does not match its collectionId`,\n    )\n  }\n  return target\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        requireStorageTarget(request),\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        requireStorageTarget(request),\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(\n        requireStorageTarget(request),\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 `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        requireStorageTarget(request),\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 `applyCommittedTx`: {\n      await adapter.applyCommittedTx(\n        requireStorageTarget(request),\n        request.payload.tx,\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 `reconcileCommittedTx`: {\n      const result = adapter.reconcileCommittedTx\n        ? await adapter.reconcileCommittedTx(\n            requireStorageTarget(request),\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        requireStorageTarget(request),\n        request.payload.signature,\n        request.payload.spec,\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: 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        requireStorageTarget(request),\n        request.payload.signature,\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: 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        requireStorageTarget(request),\n        request.payload.fromRowVersion,\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 `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        requireStorageTarget(request),\n        request.payload.observedTerm,\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: 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(\n        requireStorageTarget(request),\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: position,\n      }\n    }\n\n    case `claimCacheGeneration`: {\n      if (!adapter.claimCacheGeneration) {\n        throw new InvalidPersistedCollectionConfigError(\n          `claimCacheGeneration is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.claimCacheGeneration(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 `rotateCacheGeneration`: {\n      if (!adapter.rotateCacheGeneration) {\n        throw new InvalidPersistedCollectionConfigError(\n          `rotateCacheGeneration is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.rotateCacheGeneration(\n        request.collectionId,\n        request.payload.claimId,\n        request.payload.resetMetadata,\n        request.payload.expectedStorageCollectionId,\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 `renewCacheGenerationClaim`: {\n      if (!adapter.renewCacheGenerationClaim) {\n        throw new InvalidPersistedCollectionConfigError(\n          `renewCacheGenerationClaim is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.renewCacheGenerationClaim(\n        request.payload.storageCollectionId,\n        request.payload.claimId,\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 `releaseCacheGenerationClaim`: {\n      if (!adapter.releaseCacheGenerationClaim) {\n        throw new InvalidPersistedCollectionConfigError(\n          `releaseCacheGenerationClaim is not supported by the configured electron persistence adapter`,\n        )\n      }\n      await adapter.releaseCacheGenerationClaim(request.payload.claimId)\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}\n\nfunction resolveModeAwarePersistence(\n  persistence: PersistedCollectionPersistence,\n  request: ElectronPersistenceRequestEnvelope,\n): PersistedCollectionPersistence {\n  if (\n    request.storageTarget?.kind === `managed` &&\n    !request.resolution?.logicalCollectionId\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron managed cache request requires a logical Collection ID`,\n    )\n  }\n  const mode = request.resolution?.mode ?? `sync-absent`\n  const schemaVersion = request.resolution?.schemaVersion\n  const collectionAwarePersistence =\n    persistence.resolvePersistenceForCollection?.({\n      collectionId:\n        request.resolution?.logicalCollectionId ?? 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","resolvePersistedStorageTarget","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 = 6;
 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  PersistedCacheGenerationClaim,\n  PersistedCollectionMode,\n  PersistedIndexSpec,\n  PersistedKeySetEvidence,\n  PersistedStorageTarget,\n  PersistedTx,\n  ReconciledCommittedTx,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\n\nexport const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 6 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  logicalCollectionId?: string\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  | `claimCacheGeneration`\n  | `rotateCacheGeneration`\n  | `renewCacheGenerationClaim`\n  | `releaseCacheGenerationClaim`\n  | `reserveLeadershipTerm`\n\nexport type ElectronPersistencePayloadMap = {\n  loadSubset: {\n    options: LoadSubsetOptions\n    ctx?: {\n      requiredIndexSignatures?: ReadonlyArray<string>\n      cacheGenerationClaimId?: string\n    }\n  }\n  loadResumeSnapshot: {\n    ctx?: {\n      requiredIndexSignatures?: ReadonlyArray<string>\n      includeRows?: boolean\n      cacheGenerationClaimId?: string\n    }\n  }\n  loadCollectionMetadata: { ctx?: { cacheGenerationClaimId?: string } }\n  scanRows: {\n    options?: {\n      metadataOnly?: boolean\n    }\n    ctx?: { cacheGenerationClaimId?: string }\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    ctx?: { cacheGenerationClaimId?: string }\n  }\n  markIndexRemoved: {\n    signature: string\n    ctx?: { cacheGenerationClaimId?: string }\n  }\n  pullSince: {\n    fromRowVersion: number\n    ctx?: { cacheGenerationClaimId?: string }\n  }\n  getStreamPosition: { ctx?: { cacheGenerationClaimId?: string } }\n  claimCacheGeneration: {}\n  rotateCacheGeneration: {\n    claimId: string\n    resetMetadata?: { key: string; value: unknown }\n    expectedStorageCollectionId?: string\n  }\n  renewCacheGenerationClaim: {\n    storageCollectionId: string\n    claimId: string\n  }\n  releaseCacheGenerationClaim: { claimId: string }\n  reserveLeadershipTerm: {\n    observedTerm: number\n    ctx?: { cacheGenerationClaimId?: string }\n  }\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  claimCacheGeneration: PersistedCacheGenerationClaim\n  rotateCacheGeneration: PersistedCacheGenerationClaim\n  renewCacheGenerationClaim: number | undefined\n  releaseCacheGenerationClaim: null\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    /** Required for data operations; preserves eager or managed identity across IPC. */\n    storageTarget?: PersistedStorageTarget\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":";;AAaO,MAAM,wCAAwC;AAC9C,MAAM,uCAAuC;;;"}

package/dist/cjs/protocol.d.cts

@@ -1,47 +1,96 @@
 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, PersistedCacheGenerationClaim, PersistedCollectionMode, PersistedIndexSpec, PersistedKeySetEvidence, PersistedStorageTarget, PersistedTx, ReconciledCommittedTx, SQLitePullSinceResult } from '@tanstack/db-sqlite-persistence-core';
+export declare const ELECTRON_PERSISTENCE_PROTOCOL_VERSION: 6;
 export declare const DEFAULT_ELECTRON_PERSISTENCE_CHANNEL = "tanstack-db:sqlite-persistence";
 export type ElectronPersistedRow = Record<string, unknown>;
 export type ElectronPersistedKey = string | number;
 export type ElectronPersistenceResolution = {
     mode: PersistedCollectionMode;
     schemaVersion?: number;
+    logicalCollectionId?: string;
 };
-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` | `claimCacheGeneration` | `rotateCacheGeneration` | `renewCacheGenerationClaim` | `releaseCacheGenerationClaim` | `reserveLeadershipTerm`;
 export type ElectronPersistencePayloadMap = {
     loadSubset: {
         options: LoadSubsetOptions;
         ctx?: {
             requiredIndexSignatures?: ReadonlyArray<string>;
+            cacheGenerationClaimId?: string;
         };
     };
     loadResumeSnapshot: {
         ctx?: {
             requiredIndexSignatures?: ReadonlyArray<string>;
             includeRows?: boolean;
+            cacheGenerationClaimId?: string;
+        };
+    };
+    loadCollectionMetadata: {
+        ctx?: {
+            cacheGenerationClaimId?: string;
         };
     };
-    loadCollectionMetadata: {};
     scanRows: {
         options?: {
             metadataOnly?: boolean;
         };
+        ctx?: {
+            cacheGenerationClaimId?: string;
+        };
     };
     applyCommittedTx: {
         tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>;
     };
+    reconcileCommittedTx: {
+        tx: PersistedTx<ElectronPersistedRow, ElectronPersistedKey>;
+        anchor: CommittedTxAnchor;
+    };
     ensureIndex: {
         signature: string;
         spec: PersistedIndexSpec;
+        ctx?: {
+            cacheGenerationClaimId?: string;
+        };
     };
     markIndexRemoved: {
         signature: string;
+        ctx?: {
+            cacheGenerationClaimId?: string;
+        };
     };
     pullSince: {
         fromRowVersion: number;
+        ctx?: {
+            cacheGenerationClaimId?: string;
+        };
+    };
+    getStreamPosition: {
+        ctx?: {
+            cacheGenerationClaimId?: string;
+        };
+    };
+    claimCacheGeneration: {};
+    rotateCacheGeneration: {
+        claimId: string;
+        resetMetadata?: {
+            key: string;
+            value: unknown;
+        };
+        expectedStorageCollectionId?: string;
+    };
+    renewCacheGenerationClaim: {
+        storageCollectionId: string;
+        claimId: string;
+    };
+    releaseCacheGenerationClaim: {
+        claimId: string;
+    };
+    reserveLeadershipTerm: {
+        observedTerm: number;
+        ctx?: {
+            cacheGenerationClaimId?: string;
+        };
     };
-    getStreamPosition: {};
 };
 export type ElectronPersistenceResultMap = {
     loadSubset: Array<{
@@ -74,6 +123,7 @@ export type ElectronPersistenceResultMap = {
         metadata?: unknown;
     }>;
     applyCommittedTx: null;
+    reconcileCommittedTx: ReconciledCommittedTx;
     ensureIndex: null;
     markIndexRemoved: null;
     pullSince: SQLitePullSinceResult<ElectronPersistedKey>;
@@ -82,18 +132,30 @@ export type ElectronPersistenceResultMap = {
         latestSeq: number;
         latestRowVersion: number;
     };
+    claimCacheGeneration: PersistedCacheGenerationClaim;
+    rotateCacheGeneration: PersistedCacheGenerationClaim;
+    renewCacheGenerationClaim: number | undefined;
+    releaseCacheGenerationClaim: null;
+    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]: {
         v: number;
         requestId: string;
         collectionId: string;
+        /** Required for data operations; preserves eager or managed identity across IPC. */
+        storageTarget?: PersistedStorageTarget;
         resolution?: ElectronPersistenceResolution;
         method: Method;
         payload: ElectronPersistencePayloadMap[Method];