@tanstack/db-sqlite-persistence-core 0.4.8 → 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, CommittedTxAnchor, HydrationPersistenceAdapter, PersistedCollectionCoordinator, PersistedIndexSpec, PersistedMutationEnvelope, PersistedTx, PersistenceAdapter, ProtocolEnvelope, PullSinceResponse, ReconcileCommittedTxResponse } from './persisted.cjs';
+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?: (collectionId: string, fromRowVersion: number) => Promise<{
+    pullSince?: (target: PersistedStorageTarget, fromRowVersion: number, ctx?: {
+        cacheGenerationClaimId?: string;
+    }) => Promise<{
         latestRowVersion: number;
         requiresFullReload: true;
     } | {
@@ -11,12 +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?: (collectionId: string, observedTerm: number) => Promise<{
+    reserveLeadershipTerm?: (target: PersistedStorageTarget, observedTerm: number, ctx?: {
+        cacheGenerationClaimId?: string;
+    }) => Promise<{
         latestTerm: number;
         latestSeq: number;
         latestRowVersion: number;
@@ -35,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;
@@ -61,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;
@@ -70,12 +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>;
     reconcileCommittedTx(collectionId: string, tx: PersistedTx, anchor: CommittedTxAnchor, scopedAdapter?: HydrationPersistenceAdapter): Promise<ReconcileCommittedTxResponse>;
-    pullSince(collectionId: string, fromRowVersion: number, scopedAdapter?: HydrationPersistenceAdapter): Promise<PullSinceResponse>;
+    pullSince(collectionId: string, fromRowVersion: number, scopedAdapter?: HydrationPersistenceAdapter, cacheGenerationClaimId?: string): Promise<PullSinceResponse>;
     dispose(): void;
     private getOrCreateCollectionState;
     private ensureCollectionState;

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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}