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

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 detailedError = error as Error & { code?: unknown; path?: unknown }\n  const path = detailedError.path\n  return {\n    name: error.name || `Error`,\n    message: error.message || fallbackMessage,\n    stack: error.stack,\n    code:\n      typeof detailedError.code === `string` ||\n      typeof detailedError.code === `number`\n        ? detailedError.code\n        : undefined,\n    path:\n      typeof path === `string` ||\n      (Array.isArray(path) &&\n        path.every(\n          (segment: unknown) =>\n            typeof segment === `string` || typeof segment === `number`,\n        ))\n        ? (path as string | ReadonlyArray<string | number>)\n        : undefined,\n  }\n}\n\nfunction createErrorResponse(\n  request: ElectronPersistenceRequestEnvelope,\n  error: unknown,\n): ElectronPersistenceResponseEnvelope {\n  return {\n    v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n    requestId: request.requestId,\n    method: request.method,\n    ok: false,\n    error: serializeError(error),\n  }\n}\n\nfunction assertValidRequest(request: ElectronPersistenceRequestEnvelope): void {\n  if (request.v !== ELECTRON_PERSISTENCE_PROTOCOL_VERSION) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Unsupported electron persistence protocol version \"${request.v}\"`,\n    )\n  }\n\n  if (\n    typeof request.requestId !== `string` ||\n    request.requestId.trim().length === 0\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence requestId cannot be empty`,\n    )\n  }\n\n  if (\n    typeof request.collectionId !== `string` ||\n    request.collectionId.trim().length === 0\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Electron persistence collectionId cannot be empty`,\n    )\n  }\n}\n\nasync function executeRequestAgainstAdapter(\n  request: ElectronPersistenceRequestEnvelope,\n  adapter: ElectronMainPersistenceAdapter,\n): Promise<ElectronPersistenceResponseEnvelope> {\n  switch (request.method) {\n    case `loadSubset`: {\n      const result = await adapter.loadSubset(\n        request.collectionId,\n        request.payload.options,\n        request.payload.ctx,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `loadResumeSnapshot`: {\n      const result = await adapter.loadResumeSnapshot(\n        request.collectionId,\n        request.payload.ctx,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `loadCollectionMetadata`: {\n      if (!adapter.loadCollectionMetadata) {\n        throw new InvalidPersistedCollectionConfigError(\n          `loadCollectionMetadata is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.loadCollectionMetadata(request.collectionId)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `scanRows`: {\n      if (!adapter.scanRows) {\n        throw new InvalidPersistedCollectionConfigError(\n          `scanRows is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.scanRows(\n        request.collectionId,\n        request.payload.options,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `applyCommittedTx`: {\n      await adapter.applyCommittedTx(request.collectionId, request.payload.tx)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `reconcileCommittedTx`: {\n      const result = adapter.reconcileCommittedTx\n        ? await adapter.reconcileCommittedTx(\n            request.collectionId,\n            request.payload.tx,\n            request.payload.anchor,\n          )\n        : { kind: `unknown` as const }\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `ensureIndex`: {\n      await adapter.ensureIndex(\n        request.collectionId,\n        request.payload.signature,\n        request.payload.spec,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `markIndexRemoved`: {\n      if (!adapter.markIndexRemoved) {\n        throw new InvalidPersistedCollectionConfigError(\n          `markIndexRemoved is not supported by the configured electron persistence adapter`,\n        )\n      }\n      await adapter.markIndexRemoved(\n        request.collectionId,\n        request.payload.signature,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: null,\n      }\n    }\n\n    case `pullSince`: {\n      if (!adapter.pullSince) {\n        throw new InvalidPersistedCollectionConfigError(\n          `pullSince is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const result = await adapter.pullSince(\n        request.collectionId,\n        request.payload.fromRowVersion,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result,\n      }\n    }\n\n    case `reserveLeadershipTerm`: {\n      if (!adapter.reserveLeadershipTerm) {\n        throw new InvalidPersistedCollectionConfigError(\n          `reserveLeadershipTerm is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const position = await adapter.reserveLeadershipTerm(\n        request.collectionId,\n        request.payload.observedTerm,\n      )\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: position,\n      }\n    }\n\n    case `getStreamPosition`: {\n      if (!adapter.getStreamPosition) {\n        throw new InvalidPersistedCollectionConfigError(\n          `getStreamPosition is not supported by the configured electron persistence adapter`,\n        )\n      }\n      const position = await adapter.getStreamPosition(request.collectionId)\n      return {\n        v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,\n        requestId: request.requestId,\n        method: request.method,\n        ok: true,\n        result: position,\n      }\n    }\n  }\n}\n\nfunction resolveModeAwarePersistence(\n  persistence: PersistedCollectionPersistence,\n  request: ElectronPersistenceRequestEnvelope,\n): PersistedCollectionPersistence {\n  const mode = request.resolution?.mode ?? `sync-absent`\n  const schemaVersion = request.resolution?.schemaVersion\n  const collectionAwarePersistence =\n    persistence.resolvePersistenceForCollection?.({\n      collectionId: request.collectionId,\n      mode,\n      schemaVersion,\n    })\n  if (collectionAwarePersistence) {\n    return collectionAwarePersistence\n  }\n\n  const modeAwarePersistence = persistence.resolvePersistenceForMode?.(mode)\n  return modeAwarePersistence ?? persistence\n}\n\nexport type ElectronIpcMainLike = {\n  handle: (\n    channel: string,\n    listener: (\n      event: unknown,\n      request: ElectronPersistenceRequestEnvelope,\n    ) => Promise<ElectronPersistenceResponseEnvelope>,\n  ) => void\n  removeHandler?: (channel: string) => void\n}\n\nexport type ElectronSQLiteMainProcessOptions = {\n  persistence: PersistedCollectionPersistence\n  ipcMain: ElectronIpcMainLike\n  channel?: string\n}\n\nexport function exposeElectronSQLitePersistence(\n  options: ElectronSQLiteMainProcessOptions,\n): () => void {\n  const channel = options.channel ?? DEFAULT_ELECTRON_PERSISTENCE_CHANNEL\n  options.ipcMain.handle(\n    channel,\n    async (\n      _event,\n      request: ElectronPersistenceRequestEnvelope,\n    ): Promise<ElectronPersistenceResponseEnvelope> => {\n      try {\n        assertValidRequest(request)\n        const modeAwarePersistence = resolveModeAwarePersistence(\n          options.persistence,\n          request,\n        )\n        return await executeRequestAgainstAdapter(\n          request,\n          modeAwarePersistence.adapter,\n        )\n      } catch (error) {\n        return createErrorResponse(request, error)\n      }\n    },\n  )\n\n  return () => {\n    options.ipcMain.removeHandler?.(channel)\n  }\n}\n"],"names":[],"mappings":";;AA2CA,SAAS,eAAe,OAAyC;AAC/D,QAAM,kBAAkB;AAExB,MAAI,EAAE,iBAAiB,QAAQ;AAC7B,WAAO;AAAA,MACL,MAAM;AAAA,MACN,SAAS;AAAA,MACT,MAAM;AAAA,IAAA;AAAA,EAEV;AAEA,QAAM,gBAAgB;AACtB,QAAM,OAAO,cAAc;AAC3B,SAAO;AAAA,IACL,MAAM,MAAM,QAAQ;AAAA,IACpB,SAAS,MAAM,WAAW;AAAA,IAC1B,OAAO,MAAM;AAAA,IACb,MACE,OAAO,cAAc,SAAS,YAC9B,OAAO,cAAc,SAAS,WAC1B,cAAc,OACd;AAAA,IACN,MACE,OAAO,SAAS,YACf,MAAM,QAAQ,IAAI,KACjB,KAAK;AAAA,MACH,CAAC,YACC,OAAO,YAAY,YAAY,OAAO,YAAY;AAAA,IAAA,IAEnD,OACD;AAAA,EAAA;AAEV;AAEA,SAAS,oBACP,SACA,OACqC;AACrC,SAAO;AAAA,IACL,GAAG;AAAA,IACH,WAAW,QAAQ;AAAA,IACnB,QAAQ,QAAQ;AAAA,IAChB,IAAI;AAAA,IACJ,OAAO,eAAe,KAAK;AAAA,EAAA;AAE/B;AAEA,SAAS,mBAAmB,SAAmD;AAC7E,MAAI,QAAQ,MAAM,uCAAuC;AACvD,UAAM,IAAI;AAAA,MACR,sDAAsD,QAAQ,CAAC;AAAA,IAAA;AAAA,EAEnE;AAEA,MACE,OAAO,QAAQ,cAAc,YAC7B,QAAQ,UAAU,KAAA,EAAO,WAAW,GACpC;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AAEA,MACE,OAAO,QAAQ,iBAAiB,YAChC,QAAQ,aAAa,KAAA,EAAO,WAAW,GACvC;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IAAA;AAAA,EAEJ;AACF;AAEA,eAAe,6BACb,SACA,SAC8C;AAC9C,UAAQ,QAAQ,QAAA;AAAA,IACd,KAAK,cAAc;AACjB,YAAM,SAAS,MAAM,QAAQ;AAAA,QAC3B,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,QAChB,QAAQ,QAAQ;AAAA,MAAA;AAElB,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,MAAA;AAAA,IAEJ;AAAA,IAEA,KAAK,sBAAsB;AACzB,YAAM,SAAS,MAAM,QAAQ;AAAA,QAC3B,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,MAAA;AAElB,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,MAAA;AAAA,IAEJ;AAAA,IAEA,KAAK,0BAA0B;AAC7B,UAAI,CAAC,QAAQ,wBAAwB;AACnC,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,YAAM,SAAS,MAAM,QAAQ,uBAAuB,QAAQ,YAAY;AACxE,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,MAAA;AAAA,IAEJ;AAAA,IAEA,KAAK,YAAY;AACf,UAAI,CAAC,QAAQ,UAAU;AACrB,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,YAAM,SAAS,MAAM,QAAQ;AAAA,QAC3B,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,MAAA;AAElB,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,MAAA;AAAA,IAEJ;AAAA,IAEA,KAAK,oBAAoB;AACvB,YAAM,QAAQ,iBAAiB,QAAQ,cAAc,QAAQ,QAAQ,EAAE;AACvE,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ,QAAQ;AAAA,MAAA;AAAA,IAEZ;AAAA,IAEA,KAAK,wBAAwB;AAC3B,YAAM,SAAS,QAAQ,uBACnB,MAAM,QAAQ;AAAA,QACZ,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,QAChB,QAAQ,QAAQ;AAAA,MAAA,IAElB,EAAE,MAAM,UAAA;AACZ,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,MAAA;AAAA,IAEJ;AAAA,IAEA,KAAK,eAAe;AAClB,YAAM,QAAQ;AAAA,QACZ,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,QAChB,QAAQ,QAAQ;AAAA,MAAA;AAElB,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ,QAAQ;AAAA,MAAA;AAAA,IAEZ;AAAA,IAEA,KAAK,oBAAoB;AACvB,UAAI,CAAC,QAAQ,kBAAkB;AAC7B,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,YAAM,QAAQ;AAAA,QACZ,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,MAAA;AAElB,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ,QAAQ;AAAA,MAAA;AAAA,IAEZ;AAAA,IAEA,KAAK,aAAa;AAChB,UAAI,CAAC,QAAQ,WAAW;AACtB,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,YAAM,SAAS,MAAM,QAAQ;AAAA,QAC3B,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,MAAA;AAElB,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ;AAAA,MAAA;AAAA,IAEJ;AAAA,IAEA,KAAK,yBAAyB;AAC5B,UAAI,CAAC,QAAQ,uBAAuB;AAClC,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,YAAM,WAAW,MAAM,QAAQ;AAAA,QAC7B,QAAQ;AAAA,QACR,QAAQ,QAAQ;AAAA,MAAA;AAElB,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ,QAAQ;AAAA,MAAA;AAAA,IAEZ;AAAA,IAEA,KAAK,qBAAqB;AACxB,UAAI,CAAC,QAAQ,mBAAmB;AAC9B,cAAM,IAAI;AAAA,UACR;AAAA,QAAA;AAAA,MAEJ;AACA,YAAM,WAAW,MAAM,QAAQ,kBAAkB,QAAQ,YAAY;AACrE,aAAO;AAAA,QACL,GAAG;AAAA,QACH,WAAW,QAAQ;AAAA,QACnB,QAAQ,QAAQ;AAAA,QAChB,IAAI;AAAA,QACJ,QAAQ;AAAA,MAAA;AAAA,IAEZ;AAAA,EAAA;AAEJ;AAEA,SAAS,4BACP,aACA,SACgC;AAChC,QAAM,OAAO,QAAQ,YAAY,QAAQ;AACzC,QAAM,gBAAgB,QAAQ,YAAY;AAC1C,QAAM,6BACJ,YAAY,kCAAkC;AAAA,IAC5C,cAAc,QAAQ;AAAA,IACtB;AAAA,IACA;AAAA,EAAA,CACD;AACH,MAAI,4BAA4B;AAC9B,WAAO;AAAA,EACT;AAEA,QAAM,uBAAuB,YAAY,4BAA4B,IAAI;AACzE,SAAO,wBAAwB;AACjC;AAmBO,SAAS,gCACd,SACY;AACZ,QAAM,UAAU,QAAQ,WAAW;AACnC,UAAQ,QAAQ;AAAA,IACd;AAAA,IACA,OACE,QACA,YACiD;AACjD,UAAI;AACF,2BAAmB,OAAO;AAC1B,cAAM,uBAAuB;AAAA,UAC3B,QAAQ;AAAA,UACR;AAAA,QAAA;AAEF,eAAO,MAAM;AAAA,UACX;AAAA,UACA,qBAAqB;AAAA,QAAA;AAAA,MAEzB,SAAS,OAAO;AACd,eAAO,oBAAoB,SAAS,KAAK;AAAA,MAC3C;AAAA,IACF;AAAA,EAAA;AAGF,SAAO,MAAM;AACX,YAAQ,QAAQ,gBAAgB,OAAO;AAAA,EACzC;AACF;"}
+{"version":3,"file":"main.js","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":[],"mappings":"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"}

package/dist/esm/protocol.d.ts

@@ -1,32 +1,42 @@
 import { LoadSubsetOptions } from '@tanstack/db';
-import { CommittedTxAnchor, PersistedCollectionMode, PersistedIndexSpec, PersistedKeySetEvidence, PersistedTx, ReconciledCommittedTx, SQLitePullSinceResult } from '@tanstack/db-sqlite-persistence-core';
-export declare const ELECTRON_PERSISTENCE_PROTOCOL_VERSION: 4;
+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` | `reconcileCommittedTx` | `ensureIndex` | `markIndexRemoved` | `pullSince` | `getStreamPosition` | `reserveLeadershipTerm`;
+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>;
@@ -38,16 +48,48 @@ export type ElectronPersistencePayloadMap = {
     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;
     };
-    getStreamPosition: {};
     reserveLeadershipTerm: {
         observedTerm: number;
+        ctx?: {
+            cacheGenerationClaimId?: string;
+        };
     };
 };
 export type ElectronPersistenceResultMap = {
@@ -90,6 +132,10 @@ export type ElectronPersistenceResultMap = {
         latestSeq: number;
         latestRowVersion: number;
     };
+    claimCacheGeneration: PersistedCacheGenerationClaim;
+    rotateCacheGeneration: PersistedCacheGenerationClaim;
+    renewCacheGenerationClaim: number | undefined;
+    releaseCacheGenerationClaim: null;
     reserveLeadershipTerm: {
         latestTerm: number;
         latestSeq: number;
@@ -108,6 +154,8 @@ export type ElectronPersistenceRequestByMethod = {
         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];

package/dist/esm/protocol.js

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

@@ -9,5 +9,7 @@ export type ElectronSQLitePersistenceOptions = {
     channel?: string;
     timeoutMs?: number;
     coordinator?: PersistedCollectionCoordinator;
+    /** Set false when a custom main-process adapter does not manage cache generations. */
+    managedCacheGenerations?: boolean;
 };
 export declare function createElectronSQLitePersistence(options: ElectronSQLitePersistenceOptions): PersistedCollectionPersistence;

package/dist/esm/renderer.js

@@ -1,4 +1,4 @@
-import { SingleProcessCoordinator, InvalidPersistedCollectionConfigError } from "@tanstack/db-sqlite-persistence-core";
+import { SingleProcessCoordinator, InvalidPersistedCollectionConfigError, resolvePersistedStorageTarget } from "@tanstack/db-sqlite-persistence-core";
 import { ElectronCollectionCoordinator } from "./electron-coordinator.js";
 import { DEFAULT_ELECTRON_PERSISTENCE_CHANNEL, ELECTRON_PERSISTENCE_PROTOCOL_VERSION } from "./protocol.js";
 const DEFAULT_REQUEST_TIMEOUT_MS = 5e3;
@@ -52,13 +52,24 @@ function createSerializableLoadSubsetOptions(subsetOptions) {
 function createRendererRequestExecutor(options) {
   const channel = options.channel ?? DEFAULT_ELECTRON_PERSISTENCE_CHANNEL;
   const timeoutMs = options.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
-  return async (method, collectionId, payload, resolution) => {
+  return async (method, target, payload, resolution) => {
+    const storageTarget = typeof target === `string` ? void 0 : target;
+    const collectionId = storageTarget ? resolvePersistedStorageTarget(storageTarget).collectionId : target;
+    const isGenerationRequest = method === `claimCacheGeneration` || method === `rotateCacheGeneration` || method === `renewCacheGenerationClaim` || method === `releaseCacheGenerationClaim`;
+    const managedTarget = storageTarget?.kind === `managed`;
+    const logicalCollectionId = resolution?.logicalCollectionId ?? (managedTarget ? options.claimCollections.get(storageTarget.claimId) : isGenerationRequest ? collectionId : void 0);
+    if ((managedTarget || isGenerationRequest) && !logicalCollectionId) {
+      throw new InvalidPersistedCollectionConfigError(
+        `Electron managed cache request requires a known logical Collection ID`
+      );
+    }
     const request = {
       v: ELECTRON_PERSISTENCE_PROTOCOL_VERSION,
       requestId: createRequestId(),
       collectionId,
+      storageTarget,
       method,
-      resolution,
+      resolution: managedTarget || isGenerationRequest ? { ...resolution, mode: `sync-present`, logicalCollectionId } : resolution,
       payload
     };
     const response = await withTimeout(
@@ -85,105 +96,219 @@ function createRendererRequestExecutor(options) {
     return response.result;
   };
 }
-function createResolvedRendererAdapter(executeRequest, resolution) {
-  return {
-    loadSubset: async (collectionId, subsetOptions, ctx) => {
+function createResolvedRendererAdapter(executeRequest, claimCollections, managedCacheGenerations, resolution) {
+  const adapter = {
+    loadSubset: async (target, subsetOptions, ctx) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        ctx?.cacheGenerationClaimId
+      );
       const result = await executeRequest(
         `loadSubset`,
-        collectionId,
+        target,
         {
           options: createSerializableLoadSubsetOptions(subsetOptions),
-          ctx
+          ctx: { ...ctx, cacheGenerationClaimId: access.claimId }
         },
         resolution
       );
       return result;
     },
-    loadResumeSnapshot: async (collectionId, ctx) => {
+    loadResumeSnapshot: async (target, ctx) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        ctx?.cacheGenerationClaimId
+      );
       return executeRequest(
         `loadResumeSnapshot`,
-        collectionId,
-        { ctx },
+        target,
+        { ctx: { ...ctx, cacheGenerationClaimId: access.claimId } },
         resolution
       );
     },
-    applyCommittedTx: async (collectionId, tx) => {
+    applyCommittedTx: async (target, tx) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        tx.cacheGenerationClaimId
+      );
       await executeRequest(
         `applyCommittedTx`,
-        collectionId,
+        target,
         {
-          tx
+          tx: { ...tx, cacheGenerationClaimId: access.claimId }
         },
         resolution
       );
     },
-    reconcileCommittedTx: async (collectionId, tx, anchor) => {
+    reconcileCommittedTx: async (target, tx, anchor) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        tx.cacheGenerationClaimId
+      );
       return executeRequest(
         `reconcileCommittedTx`,
-        collectionId,
-        { tx, anchor },
+        target,
+        { tx: { ...tx, cacheGenerationClaimId: access.claimId }, anchor },
         resolution
       );
     },
-    loadCollectionMetadata: async (collectionId) => {
+    loadCollectionMetadata: async (target, ctx) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        ctx?.cacheGenerationClaimId
+      );
       return executeRequest(
         `loadCollectionMetadata`,
-        collectionId,
-        {},
+        target,
+        { ctx: { ...ctx, cacheGenerationClaimId: access.claimId } },
         resolution
       );
     },
-    scanRows: async (collectionId, options) => {
+    scanRows: async (target, options, ctx) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        ctx?.cacheGenerationClaimId
+      );
       const result = await executeRequest(
         `scanRows`,
-        collectionId,
-        { options },
+        target,
+        { options, ctx: { ...ctx, cacheGenerationClaimId: access.claimId } },
         resolution
       );
       return result;
     },
-    ensureIndex: async (collectionId, signature, spec) => {
+    ensureIndex: async (target, signature, spec, ctx) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        ctx?.cacheGenerationClaimId
+      );
       await executeRequest(
         `ensureIndex`,
-        collectionId,
+        target,
         {
           signature,
-          spec
+          spec,
+          ctx: { ...ctx, cacheGenerationClaimId: access.claimId }
         },
         resolution
       );
     },
-    markIndexRemoved: async (collectionId, signature) => {
+    markIndexRemoved: async (target, signature, ctx) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        ctx?.cacheGenerationClaimId
+      );
       await executeRequest(
         `markIndexRemoved`,
-        collectionId,
+        target,
         {
-          signature
+          signature,
+          ctx: { ...ctx, cacheGenerationClaimId: access.claimId }
         },
         resolution
       );
     },
-    pullSince: async (collectionId, fromRowVersion) => {
+    pullSince: async (target, fromRowVersion, ctx) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        ctx?.cacheGenerationClaimId
+      );
       const result = await executeRequest(
         `pullSince`,
-        collectionId,
+        target,
         {
-          fromRowVersion
+          fromRowVersion,
+          ctx: { ...ctx, cacheGenerationClaimId: access.claimId }
         },
         resolution
       );
       return result;
     },
-    getStreamPosition: async (collectionId) => {
-      return executeRequest(`getStreamPosition`, collectionId, {}, resolution);
+    getStreamPosition: async (target, ctx) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        ctx?.cacheGenerationClaimId
+      );
+      return executeRequest(
+        `getStreamPosition`,
+        target,
+        { ctx: { ...ctx, cacheGenerationClaimId: access.claimId } },
+        resolution
+      );
     },
-    reserveLeadershipTerm: async (collectionId, observedTerm) => executeRequest(
-      `reserveLeadershipTerm`,
-      collectionId,
-      { observedTerm },
-      resolution
-    )
+    claimCacheGeneration: async (collectionId) => {
+      const claim = await executeRequest(
+        `claimCacheGeneration`,
+        collectionId,
+        {},
+        resolution
+      );
+      claimCollections.set(claim.claimId, collectionId);
+      return claim;
+    },
+    rotateCacheGeneration: async (collectionId, claimId, resetMetadata, expectedStorageCollectionId) => {
+      const claim = await executeRequest(
+        `rotateCacheGeneration`,
+        collectionId,
+        { claimId, resetMetadata, expectedStorageCollectionId },
+        resolution
+      );
+      claimCollections.delete(claimId);
+      claimCollections.set(claim.claimId, collectionId);
+      return claim;
+    },
+    renewCacheGenerationClaim: (storageCollectionId, claimId) => {
+      const collectionId = claimCollections.get(claimId);
+      if (!collectionId) {
+        throw new InvalidPersistedCollectionConfigError(
+          `Unknown electron persisted cache claim "${claimId}"`
+        );
+      }
+      return executeRequest(
+        `renewCacheGenerationClaim`,
+        collectionId,
+        { storageCollectionId, claimId },
+        resolution
+      );
+    },
+    releaseCacheGenerationClaim: async (claimId) => {
+      const collectionId = claimCollections.get(claimId);
+      if (!collectionId) {
+        throw new InvalidPersistedCollectionConfigError(
+          `Unknown electron persisted cache claim "${claimId}"`
+        );
+      }
+      await executeRequest(
+        `releaseCacheGenerationClaim`,
+        collectionId,
+        { claimId },
+        resolution
+      );
+      claimCollections.delete(claimId);
+    },
+    reserveLeadershipTerm: async (target, observedTerm, ctx) => {
+      const access = resolvePersistedStorageTarget(
+        target,
+        ctx?.cacheGenerationClaimId
+      );
+      return executeRequest(
+        `reserveLeadershipTerm`,
+        target,
+        {
+          observedTerm,
+          ctx: { ...ctx, cacheGenerationClaimId: access.claimId }
+        },
+        resolution
+      );
+    }
   };
+  if (!managedCacheGenerations) {
+    adapter.claimCacheGeneration = void 0;
+    adapter.rotateCacheGeneration = void 0;
+    adapter.renewCacheGenerationClaim = void 0;
+    adapter.releaseCacheGenerationClaim = void 0;
+  }
+  return adapter;
 }
 function resolveInvoke(options) {
   if (options.invoke) {
@@ -199,28 +324,31 @@ function resolveInvoke(options) {
 function createElectronSQLitePersistence(options) {
   const invoke = resolveInvoke(options);
   const coordinator = options.coordinator ?? new SingleProcessCoordinator();
+  const claimCollections = /* @__PURE__ */ new Map();
   const executeRequest = createRendererRequestExecutor({
     invoke,
     channel: options.channel,
-    timeoutMs: options.timeoutMs
+    timeoutMs: options.timeoutMs,
+    claimCollections
   });
   const adapterCache = /* @__PURE__ */ new Map();
-  const getAdapterForCollection = (mode, schemaVersion) => {
-    const schemaVersionKey = schemaVersion === void 0 ? `schema:default` : `schema:${schemaVersion}`;
-    const cacheKey = `mode:${mode}|${schemaVersionKey}`;
+  const getAdapterForCollection = (collectionId, mode, schemaVersion) => {
+    const cacheKey = JSON.stringify([collectionId, mode, schemaVersion]);
     const cachedAdapter = adapterCache.get(cacheKey);
     if (cachedAdapter) {
       return cachedAdapter;
     }
-    const adapter = createResolvedRendererAdapter(executeRequest, {
-      mode,
-      schemaVersion
-    });
+    const adapter = createResolvedRendererAdapter(
+      executeRequest,
+      claimCollections,
+      options.managedCacheGenerations ?? true,
+      { mode, schemaVersion, logicalCollectionId: collectionId }
+    );
     adapterCache.set(cacheKey, adapter);
     return adapter;
   };
   const createCollectionPersistence = (collectionId, mode, schemaVersion) => {
-    const adapter = getAdapterForCollection(mode, schemaVersion);
+    const adapter = getAdapterForCollection(collectionId, mode, schemaVersion);
     if (coordinator instanceof ElectronCollectionCoordinator) {
       if (collectionId === void 0) {
         coordinator.setAdapter(adapter);