@tanstack/electron-db-sqlite-persistence 0.1.35 → 0.2.2

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 `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 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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"}

package/dist/esm/protocol.d.ts

@@ -1,6 +1,6 @@
 import { LoadSubsetOptions } from '@tanstack/db';
-import { PersistedCollectionMode, PersistedIndexSpec, PersistedTx, SQLitePullSinceResult } from '@tanstack/db-sqlite-persistence-core';
-export declare const ELECTRON_PERSISTENCE_PROTOCOL_VERSION: 1;
+import { PersistedCollectionMode, PersistedIndexSpec, PersistedKeySetEvidence, PersistedTx, SQLitePullSinceResult } from '@tanstack/db-sqlite-persistence-core';
+export declare const ELECTRON_PERSISTENCE_PROTOCOL_VERSION: 2;
 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` | `loadCollectionMetadata` | `scanRows` | `applyCommittedTx` | `ensureIndex` | `markIndexRemoved` | `pullSince` | `getStreamPosition`;
+export type ElectronPersistenceMethod = `loadSubset` | `loadResumeSnapshot` | `loadCollectionMetadata` | `scanRows` | `applyCommittedTx` | `ensureIndex` | `markIndexRemoved` | `pullSince` | `getStreamPosition`;
 export type ElectronPersistencePayloadMap = {
     loadSubset: {
         options: LoadSubsetOptions;
@@ -16,6 +16,12 @@ export type ElectronPersistencePayloadMap = {
             requiredIndexSignatures?: ReadonlyArray<string>;
         };
     };
+    loadResumeSnapshot: {
+        ctx?: {
+            requiredIndexSignatures?: ReadonlyArray<string>;
+            includeRows?: boolean;
+        };
+    };
     loadCollectionMetadata: {};
     scanRows: {
         options?: {
@@ -42,6 +48,22 @@ export type ElectronPersistenceResultMap = {
         key: ElectronPersistedKey;
         value: ElectronPersistedRow;
     }>;
+    loadResumeSnapshot: {
+        rows: Array<{
+            key: ElectronPersistedKey;
+            value: ElectronPersistedRow;
+            metadata?: unknown;
+        }>;
+        keySet?: PersistedKeySetEvidence;
+        collectionMetadata: Array<{
+            key: string;
+            value: unknown;
+        }>;
+        latestTerm: number;
+        latestSeq: number;
+        latestRowVersion: number;
+        resetEpoch: number;
+    };
     loadCollectionMetadata: Array<{
         key: string;
         value: unknown;

package/dist/esm/protocol.js

@@ -1,4 +1,4 @@
-const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 1;
+const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 2;
 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  PersistedTx,\n  SQLitePullSinceResult,\n} from '@tanstack/db-sqlite-persistence-core'\n\nexport const ELECTRON_PERSISTENCE_PROTOCOL_VERSION = 1 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  | `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  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  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":"AAQO,MAAM,wCAAwC;AAC9C,MAAM,uCAAuC;"}
+{"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;"}

package/dist/esm/renderer.js

@@ -96,6 +96,14 @@ function createResolvedRendererAdapter(executeRequest, resolution) {
       );
       return result;
     },
+    loadResumeSnapshot: async (collectionId, ctx) => {
+      return executeRequest(
+        `loadResumeSnapshot`,
+        collectionId,
+        { ctx },
+        resolution
+      );
+    },
     applyCommittedTx: async (collectionId, tx) => {
       await executeRequest(
         `applyCommittedTx`,
@@ -192,24 +200,32 @@ function createElectronSQLitePersistence(options) {
       schemaVersion
     });
     adapterCache.set(cacheKey, adapter);
+    return adapter;
+  };
+  const createCollectionPersistence = (collectionId, mode, schemaVersion) => {
+    const adapter = getAdapterForCollection(mode, schemaVersion);
     if (coordinator instanceof ElectronCollectionCoordinator) {
-      coordinator.setAdapter(adapter);
+      if (collectionId === void 0) {
+        coordinator.setAdapter(adapter);
+      } else {
+        coordinator.setAdapterForCollection(collectionId, adapter);
+      }
     }
-    return adapter;
+    return { adapter, coordinator };
   };
-  const createCollectionPersistence = (mode, schemaVersion) => ({
-    adapter: getAdapterForCollection(mode, schemaVersion),
-    coordinator
-  });
   const defaultPersistence = createCollectionPersistence(
+    void 0,
     `sync-absent`,
     void 0
   );
+  if (coordinator instanceof ElectronCollectionCoordinator) {
+    coordinator.setAdapter(defaultPersistence.adapter);
+  }
   return {
     ...defaultPersistence,
-    resolvePersistenceForCollection: ({ mode, schemaVersion }) => createCollectionPersistence(mode, schemaVersion),
+    resolvePersistenceForCollection: ({ collectionId, mode, schemaVersion }) => createCollectionPersistence(collectionId, mode, schemaVersion),
     // Backward compatible fallback for older callers.
-    resolvePersistenceForMode: (mode) => createCollectionPersistence(mode, void 0)
+    resolvePersistenceForMode: (mode) => createCollectionPersistence(void 0, mode, void 0)
   };
 }
 export {

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    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\n    // Wire the adapter into the coordinator so it can handle\n    // leader-side RPCs (applyCommittedTx, pullSince, getStreamPosition, etc.)\n    if (coordinator instanceof ElectronCollectionCoordinator) {\n      coordinator.setAdapter(adapter)\n    }\n\n    return adapter\n  }\n\n  const createCollectionPersistence = (\n    mode: PersistedCollectionMode,\n    schemaVersion: number | undefined,\n  ): PersistedCollectionPersistence => ({\n    adapter: getAdapterForCollection(mode, schemaVersion),\n    coordinator,\n  })\n\n  const defaultPersistence = createCollectionPersistence(\n    `sync-absent`,\n    undefined,\n  )\n\n  return {\n    ...defaultPersistence,\n    resolvePersistenceForCollection: ({ mode, schemaVersion }) =>\n      createCollectionPersistence(mode, schemaVersion),\n    // Backward compatible fallback for older callers.\n    resolvePersistenceForMode: (mode) =>\n      createCollectionPersistence(mode, undefined),\n  }\n}\n"],"names":[],"mappings":"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"}
+{"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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/electron-db-sqlite-persistence",
-  "version": "0.1.35",
+  "version": "0.2.2",
   "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.2.23"
+    "@tanstack/db-sqlite-persistence-core": "0.4.1"
   },
   "peerDependencies": {
     "typescript": ">=4.7"