@tanstack/db-sqlite-persistence-core 0.4.7 → 0.4.9

package/dist/cjs/broadcast-coordinator.d.cts

@@ -1,8 +1,10 @@
 import { LoadSubsetOptions } from '@tanstack/db';
 import { RemoteSubsetOwner } from './remote-subset-owner.cjs';
-import { ApplyCommittedTxResponse, ApplyLocalMutationsResponse, HydrationPersistenceAdapter, PersistedCollectionCoordinator, PersistedIndexSpec, PersistedMutationEnvelope, PersistedTx, PersistenceAdapter, ProtocolEnvelope, PullSinceResponse } from './persisted.cjs';
-type CoordinatorAdapter = Pick<PersistenceAdapter, `loadSubset` | `applyCommittedTx` | `ensureIndex` | `runInRegularScope`> & {
-    pullSince?: (collectionId: string, fromRowVersion: number) => Promise<{
+import { ApplyCommittedTxResponse, ApplyLocalMutationsResponse, CommittedTxAnchor, HydrationPersistenceAdapter, PersistedCollectionCoordinator, PersistedIndexSpec, PersistedMutationEnvelope, PersistedStorageTarget, PersistedTx, PersistenceAdapter, ProtocolEnvelope, PullSinceResponse, ReconcileCommittedTxResponse } from './persisted.cjs';
+type CoordinatorAdapter = Pick<PersistenceAdapter, `loadSubset` | `applyCommittedTx` | `reconcileCommittedTx` | `ensureIndex` | `runInRegularScope`> & {
+    pullSince?: (target: PersistedStorageTarget, fromRowVersion: number, ctx?: {
+        cacheGenerationClaimId?: string;
+    }) => Promise<{
         latestRowVersion: number;
         requiresFullReload: true;
     } | {
@@ -11,7 +13,16 @@ type CoordinatorAdapter = Pick<PersistenceAdapter, `loadSubset` | `applyCommitte
         changedKeys: Array<string | number>;
         deletedKeys: Array<string | number>;
     }>;
-    getStreamPosition?: (collectionId: string) => Promise<{
+    getStreamPosition?: (target: PersistedStorageTarget, ctx?: {
+        cacheGenerationClaimId?: string;
+    }) => Promise<{
+        latestTerm: number;
+        latestSeq: number;
+        latestRowVersion: number;
+    }>;
+    reserveLeadershipTerm?: (target: PersistedStorageTarget, observedTerm: number, ctx?: {
+        cacheGenerationClaimId?: string;
+    }) => Promise<{
         latestTerm: number;
         latestSeq: number;
         latestRowVersion: number;
@@ -30,6 +41,7 @@ export declare class BroadcastCollectionCoordinator implements PersistedCollecti
     private readonly coordinatorName;
     private defaultAdapter;
     private readonly collectionAdapters;
+    private readonly collectionClaimIds;
     private readonly remoteSubsetOwners;
     private readonly remoteSubsetIds;
     private readonly outboundRemoteSubsetAcquisitions;
@@ -56,7 +68,7 @@ export declare class BroadcastCollectionCoordinator implements PersistedCollecti
      */
     setAdapter(adapter: CoordinatorAdapter): void;
     /** Register the persistence adapter that owns one collection. */
-    setAdapterForCollection(collectionId: string, adapter: CoordinatorAdapter): void;
+    setAdapterForCollection(collectionId: string, adapter: CoordinatorAdapter, cacheGenerationClaimId?: string): void;
     registerRemoteSubsetOwner(collectionId: string, owner: RemoteSubsetOwner): () => void;
     getNodeId(): string;
     subscribe(collectionId: string, onMessage: (message: ProtocolEnvelope<unknown>) => void): () => void;
@@ -65,11 +77,13 @@ export declare class BroadcastCollectionCoordinator implements PersistedCollecti
     ensureLeadership(collectionId: string): Promise<void>;
     requestEnsureRemoteSubset(collectionId: string, options: LoadSubsetOptions): Promise<void>;
     requestReleaseRemoteSubset(collectionId: string, options: LoadSubsetOptions): Promise<void>;
+    private scheduleRemoteSubsetReleaseRetry;
     private acquireRemoteSubset;
-    requestEnsurePersistedIndex(collectionId: string, signature: string, spec: PersistedIndexSpec, scopedAdapter?: HydrationPersistenceAdapter, localEnsureCompleted?: boolean): Promise<void>;
-    requestApplyLocalMutations(collectionId: string, mutations: Array<PersistedMutationEnvelope>): Promise<ApplyLocalMutationsResponse>;
+    requestEnsurePersistedIndex(collectionId: string, signature: string, spec: PersistedIndexSpec, scopedAdapter?: HydrationPersistenceAdapter, localEnsureCompleted?: boolean, cacheGenerationClaimId?: string): Promise<void>;
+    requestApplyLocalMutations(collectionId: string, mutations: Array<PersistedMutationEnvelope>, cacheGenerationClaimId?: string): Promise<ApplyLocalMutationsResponse>;
     requestApplyCommittedTx(collectionId: string, tx: PersistedTx, scopedAdapter?: HydrationPersistenceAdapter): Promise<ApplyCommittedTxResponse>;
-    pullSince(collectionId: string, fromRowVersion: number, scopedAdapter?: HydrationPersistenceAdapter): Promise<PullSinceResponse>;
+    reconcileCommittedTx(collectionId: string, tx: PersistedTx, anchor: CommittedTxAnchor, scopedAdapter?: HydrationPersistenceAdapter): Promise<ReconcileCommittedTxResponse>;
+    pullSince(collectionId: string, fromRowVersion: number, scopedAdapter?: HydrationPersistenceAdapter, cacheGenerationClaimId?: string): Promise<PullSinceResponse>;
     dispose(): void;
     private getOrCreateCollectionState;
     private ensureCollectionState;
@@ -105,6 +119,9 @@ export declare class BroadcastCollectionCoordinator implements PersistedCollecti
     private handleApplyCommittedTx;
     private runDeduplicatedEnvelope;
     private applyCommittedTxOnce;
+    private publishCommittedTx;
+    private handleReconcileCommittedTx;
+    private nextPersistedTxIfLeader;
     private applyDurablyAtNextStreamPosition;
     private handlePullSince;
     private withScheduledWriterLock;

package/dist/cjs/committed-tx-anchor.cjs

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+function isValidCommittedTxAnchor(value) {
+  if (!value || typeof value !== `object`) return false;
+  const anchor = value;
+  return typeof anchor.latestRowVersion === `number` && Number.isSafeInteger(anchor.latestRowVersion) && anchor.latestRowVersion >= 0 && typeof anchor.resetEpoch === `number` && Number.isSafeInteger(anchor.resetEpoch) && anchor.resetEpoch >= 0;
+}
+exports.isValidCommittedTxAnchor = isValidCommittedTxAnchor;
+//# sourceMappingURL=committed-tx-anchor.cjs.map

package/dist/cjs/committed-tx-anchor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"committed-tx-anchor.cjs","sources":["../../src/committed-tx-anchor.ts"],"sourcesContent":["// RPC payloads and direct adapter calls can bypass TypeScript's anchor type.\nexport function isValidCommittedTxAnchor(value: unknown): boolean {\n  if (!value || typeof value !== `object`) return false\n  const anchor = value as Record<string, unknown>\n  return (\n    typeof anchor.latestRowVersion === `number` &&\n    Number.isSafeInteger(anchor.latestRowVersion) &&\n    anchor.latestRowVersion >= 0 &&\n    typeof anchor.resetEpoch === `number` &&\n    Number.isSafeInteger(anchor.resetEpoch) &&\n    anchor.resetEpoch >= 0\n  )\n}\n"],"names":[],"mappings":";;AACO,SAAS,yBAAyB,OAAyB;AAChE,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAChD,QAAM,SAAS;AACf,SACE,OAAO,OAAO,qBAAqB,YACnC,OAAO,cAAc,OAAO,gBAAgB,KAC5C,OAAO,oBAAoB,KAC3B,OAAO,OAAO,eAAe,YAC7B,OAAO,cAAc,OAAO,UAAU,KACtC,OAAO,cAAc;AAEzB;;"}

package/dist/cjs/committed-tx-anchor.d.cts

@@ -0,0 +1 @@
+export declare function isValidCommittedTxAnchor(value: unknown): boolean;

package/dist/cjs/index.cjs

@@ -10,9 +10,12 @@ exports.SQLITE_DRIVER_SHARED_LOGICAL_SCHEDULING_KEY = persisted.SQLITE_DRIVER_SH
 exports.SingleProcessCoordinator = persisted.SingleProcessCoordinator;
 exports.createPersistedTableName = persisted.createPersistedTableName;
 exports.decodePersistedStorageKey = persisted.decodePersistedStorageKey;
+exports.eagerStorageTarget = persisted.eagerStorageTarget;
 exports.encodePersistedStorageKey = persisted.encodePersistedStorageKey;
 exports.forwardSQLiteDriverSharedLogicalScheduling = persisted.forwardSQLiteDriverSharedLogicalScheduling;
+exports.managedStorageTarget = persisted.managedStorageTarget;
 exports.persistedCollectionOptions = persisted.persistedCollectionOptions;
+exports.resolvePersistedStorageTarget = persisted.resolvePersistedStorageTarget;
 exports.validatePersistedCollectionCoordinator = persisted.validatePersistedCollectionCoordinator;
 exports.DuplicateRemoteSubsetOwnerError = errors.DuplicateRemoteSubsetOwnerError;
 exports.IndeterminateCommitError = errors.IndeterminateCommitError;
@@ -30,6 +33,7 @@ exports.SQLiteBigIntOutOfRangeError = errors.SQLiteBigIntOutOfRangeError;
 exports.toPersistedCollectionDurabilityError = errors.toPersistedCollectionDurabilityError;
 exports.DEFAULT_APPLIED_TX_PRUNE_MAX_AGE_SECONDS = sqliteCoreAdapter.DEFAULT_APPLIED_TX_PRUNE_MAX_AGE_SECONDS;
 exports.DEFAULT_APPLIED_TX_PRUNE_MAX_ROWS = sqliteCoreAdapter.DEFAULT_APPLIED_TX_PRUNE_MAX_ROWS;
+exports.DEFAULT_CACHE_GENERATION_CLAIM_TTL_MS = sqliteCoreAdapter.DEFAULT_CACHE_GENERATION_CLAIM_TTL_MS;
 exports.SQLiteCorePersistenceAdapter = sqliteCoreAdapter.SQLiteCorePersistenceAdapter;
 exports.createSQLiteCorePersistenceAdapter = sqliteCoreAdapter.createSQLiteCorePersistenceAdapter;
 exports.PERSISTED_TYPE_TAG = sqliteValue.PERSISTED_TYPE_TAG;

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}