@tanstack/db-sqlite-persistence-core 0.4.1 → 0.4.4

package/dist/esm/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sources":["../../src/errors.ts"],"sourcesContent":["import { TanStackDBError } from '@tanstack/db'\n\nexport class PersistedCollectionCoreError extends TanStackDBError {\n  constructor(message: string) {\n    super(message)\n    this.name = `PersistedCollectionCoreError`\n  }\n}\n\nexport class InvalidPersistedCollectionConfigError extends PersistedCollectionCoreError {\n  constructor(message: string) {\n    super(message)\n    this.name = `InvalidPersistedCollectionConfigError`\n  }\n}\n\nexport class InvalidSyncConfigError extends InvalidPersistedCollectionConfigError {\n  constructor(details?: string) {\n    super(\n      details\n        ? `Invalid sync config: ${details}`\n        : `Invalid sync config: expected an object with a callable sync function`,\n    )\n    this.name = `InvalidSyncConfigError`\n  }\n}\n\nexport class InvalidPersistedCollectionCoordinatorError extends InvalidPersistedCollectionConfigError {\n  constructor(methodName: string) {\n    super(\n      `Invalid persisted collection coordinator: missing required \"${methodName}\" method`,\n    )\n    this.name = `InvalidPersistedCollectionCoordinatorError`\n  }\n}\n\nexport class InvalidPersistenceAdapterError extends InvalidPersistedCollectionConfigError {\n  constructor(methodName: string) {\n    super(\n      `Invalid persistence adapter: missing required \"${methodName}\" method`,\n    )\n    this.name = `InvalidPersistenceAdapterError`\n  }\n}\n\nexport type PersistedCollectionDurabilityErrorOptions = {\n  cause?: unknown\n  code?: unknown\n  path?: unknown\n}\n\nexport class PersistedCollectionDurabilityError extends PersistedCollectionCoreError {\n  override readonly cause: unknown\n  readonly code: unknown\n  readonly path: unknown\n\n  constructor(\n    message: string,\n    options: PersistedCollectionDurabilityErrorOptions = {},\n  ) {\n    super(message)\n    this.name = `PersistedCollectionDurabilityError`\n    this.cause = options.cause\n    this.code = options.code\n    this.path = options.path\n  }\n}\n\nexport function toPersistedCollectionDurabilityError(\n  collectionId: string,\n  cause: unknown,\n): PersistedCollectionDurabilityError {\n  if (cause instanceof PersistedCollectionDurabilityError) {\n    return cause\n  }\n\n  const details =\n    typeof cause === `object` && cause !== null\n      ? (cause as Record<string, unknown>)\n      : undefined\n  const message = cause instanceof Error ? cause.message : String(cause)\n  return new PersistedCollectionDurabilityError(\n    `Failed to durably persist collection \"${collectionId}\": ${message}`,\n    {\n      cause,\n      code: details?.code,\n      path: details?.path,\n    },\n  )\n}\n\nexport type IndeterminateCommitRequestType =\n  | `rpc:applyLocalMutations:req`\n  | `rpc:applyCommittedTx:req`\n\nexport type IndeterminateCommitErrorOptions = {\n  collectionId: string\n  requestType: IndeterminateCommitRequestType\n  previousLeaderId: string | null\n  previousTerm: number | null\n  currentLeaderId: string | null\n  currentTerm: number | null\n  cause: unknown\n}\n\nexport class IndeterminateCommitError extends PersistedCollectionCoreError {\n  readonly code: `INDETERMINATE_COMMIT` = `INDETERMINATE_COMMIT`\n  readonly collectionId: string\n  readonly requestType: IndeterminateCommitRequestType\n  readonly previousLeaderId: string | null\n  readonly previousTerm: number | null\n  readonly currentLeaderId: string | null\n  readonly currentTerm: number | null\n  override readonly cause: unknown\n\n  constructor(options: IndeterminateCommitErrorOptions) {\n    super(\n      `Commit outcome is indeterminate for collection \"${options.collectionId}\": ${options.requestType} crossed leadership from ${formatLeader(options.previousLeaderId, options.previousTerm)} to ${formatLeader(options.currentLeaderId, options.currentTerm)}`,\n    )\n    this.name = `IndeterminateCommitError`\n    this.collectionId = options.collectionId\n    this.requestType = options.requestType\n    this.previousLeaderId = options.previousLeaderId\n    this.previousTerm = options.previousTerm\n    this.currentLeaderId = options.currentLeaderId\n    this.currentTerm = options.currentTerm\n    this.cause = options.cause\n  }\n}\n\nfunction formatLeader(leaderId: string | null, term: number | null): string {\n  return `${leaderId ?? `unknown leader`} (term ${term ?? `unknown`})`\n}\n\nexport class DuplicateRemoteSubsetOwnerError extends PersistedCollectionCoreError {\n  readonly collectionId: string\n\n  constructor(collectionId: string) {\n    super(\n      `A remote subset owner is already registered for collection \"${collectionId}\"`,\n    )\n    this.name = `DuplicateRemoteSubsetOwnerError`\n    this.collectionId = collectionId\n  }\n}\n\nexport class RetryableRemoteSubsetAcquisitionError extends PersistedCollectionCoreError {\n  override readonly cause: unknown\n\n  constructor(message: string, cause?: unknown) {\n    super(message)\n    this.name = `RetryableRemoteSubsetAcquisitionError`\n    this.cause = cause\n  }\n}\n\nexport class InvalidPersistedStorageKeyError extends InvalidPersistedCollectionConfigError {\n  constructor(key: string | number) {\n    super(\n      `Invalid persisted storage key \"${String(key)}\": numeric keys must be finite`,\n    )\n    this.name = `InvalidPersistedStorageKeyError`\n  }\n}\n\nexport class InvalidPersistedStorageKeyEncodingError extends InvalidPersistedCollectionConfigError {\n  constructor(encoded: string) {\n    super(\n      `Invalid persisted storage key encoding \"${encoded}\": expected prefix \"n:\" or \"s:\"`,\n    )\n    this.name = `InvalidPersistedStorageKeyEncodingError`\n  }\n}\n\nexport class SQLiteBigIntOutOfRangeError extends PersistedCollectionCoreError {\n  constructor(value: bigint, minimum: bigint, maximum: bigint) {\n    super(\n      `SQLite BigInt value ${value} is outside the signed 64-bit range [${minimum}, ${maximum}]`,\n    )\n    this.name = `SQLiteBigIntOutOfRangeError`\n  }\n}\n\nexport class PersistenceUnavailableError extends PersistedCollectionCoreError {\n  constructor(details?: string) {\n    super(\n      details\n        ? `Persistence unavailable: ${details}`\n        : `Persistence unavailable in this runtime`,\n    )\n    this.name = `PersistenceUnavailableError`\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sources":["../../src/errors.ts"],"sourcesContent":["import { TanStackDBError } from '@tanstack/db'\n\nexport class PersistedCollectionCoreError extends TanStackDBError {\n  constructor(message: string) {\n    super(message)\n    this.name = `PersistedCollectionCoreError`\n  }\n}\n\nexport class InvalidPersistedCollectionConfigError extends PersistedCollectionCoreError {\n  constructor(message: string) {\n    super(message)\n    this.name = `InvalidPersistedCollectionConfigError`\n  }\n}\n\nexport class InvalidSyncConfigError extends InvalidPersistedCollectionConfigError {\n  constructor(details?: string) {\n    super(\n      details\n        ? `Invalid sync config: ${details}`\n        : `Invalid sync config: expected an object with a callable sync function`,\n    )\n    this.name = `InvalidSyncConfigError`\n  }\n}\n\nexport class InvalidPersistedCollectionCoordinatorError extends InvalidPersistedCollectionConfigError {\n  constructor(methodName: string) {\n    super(\n      `Invalid persisted collection coordinator: missing required \"${methodName}\" method`,\n    )\n    this.name = `InvalidPersistedCollectionCoordinatorError`\n  }\n}\n\nexport class InvalidPersistenceAdapterError extends InvalidPersistedCollectionConfigError {\n  constructor(methodName: string) {\n    super(\n      `Invalid persistence adapter: missing required \"${methodName}\" method`,\n    )\n    this.name = `InvalidPersistenceAdapterError`\n  }\n}\n\nexport type PersistedCollectionDurabilityErrorOptions = {\n  cause?: unknown\n  code?: unknown\n  path?: unknown\n}\n\nexport class PersistedCollectionDurabilityError extends PersistedCollectionCoreError {\n  override readonly cause: unknown\n  readonly code: unknown\n  readonly path: unknown\n\n  constructor(\n    message: string,\n    options: PersistedCollectionDurabilityErrorOptions = {},\n  ) {\n    super(message)\n    this.name = `PersistedCollectionDurabilityError`\n    this.cause = options.cause\n    this.code = options.code\n    this.path = options.path\n  }\n}\n\nexport function toPersistedCollectionDurabilityError(\n  collectionId: string,\n  cause: unknown,\n): PersistedCollectionDurabilityError {\n  if (cause instanceof PersistedCollectionDurabilityError) {\n    return cause\n  }\n\n  const details =\n    typeof cause === `object` && cause !== null\n      ? (cause as Record<string, unknown>)\n      : undefined\n  const message = cause instanceof Error ? cause.message : String(cause)\n  return new PersistedCollectionDurabilityError(\n    `Failed to durably persist collection \"${collectionId}\": ${message}`,\n    {\n      cause,\n      code: details?.code,\n      path: details?.path,\n    },\n  )\n}\n\nexport type IndeterminateCommitRequestType =\n  `rpc:applyLocalMutations:req` | `rpc:applyCommittedTx:req`\n\nexport type IndeterminateCommitErrorOptions = {\n  collectionId: string\n  requestType: IndeterminateCommitRequestType\n  previousLeaderId: string | null\n  previousTerm: number | null\n  currentLeaderId: string | null\n  currentTerm: number | null\n  cause: unknown\n}\n\nexport class IndeterminateCommitError extends PersistedCollectionCoreError {\n  readonly code: `INDETERMINATE_COMMIT` = `INDETERMINATE_COMMIT`\n  readonly collectionId: string\n  readonly requestType: IndeterminateCommitRequestType\n  readonly previousLeaderId: string | null\n  readonly previousTerm: number | null\n  readonly currentLeaderId: string | null\n  readonly currentTerm: number | null\n  override readonly cause: unknown\n\n  constructor(options: IndeterminateCommitErrorOptions) {\n    super(\n      `Commit outcome is indeterminate for collection \"${options.collectionId}\": ${options.requestType} crossed leadership from ${formatLeader(options.previousLeaderId, options.previousTerm)} to ${formatLeader(options.currentLeaderId, options.currentTerm)}`,\n    )\n    this.name = `IndeterminateCommitError`\n    this.collectionId = options.collectionId\n    this.requestType = options.requestType\n    this.previousLeaderId = options.previousLeaderId\n    this.previousTerm = options.previousTerm\n    this.currentLeaderId = options.currentLeaderId\n    this.currentTerm = options.currentTerm\n    this.cause = options.cause\n  }\n}\n\nfunction formatLeader(leaderId: string | null, term: number | null): string {\n  return `${leaderId ?? `unknown leader`} (term ${term ?? `unknown`})`\n}\n\nexport class DuplicateRemoteSubsetOwnerError extends PersistedCollectionCoreError {\n  readonly collectionId: string\n\n  constructor(collectionId: string) {\n    super(\n      `A remote subset owner is already registered for collection \"${collectionId}\"`,\n    )\n    this.name = `DuplicateRemoteSubsetOwnerError`\n    this.collectionId = collectionId\n  }\n}\n\nexport class RetryableRemoteSubsetAcquisitionError extends PersistedCollectionCoreError {\n  override readonly cause: unknown\n\n  constructor(message: string, cause?: unknown) {\n    super(message)\n    this.name = `RetryableRemoteSubsetAcquisitionError`\n    this.cause = cause\n  }\n}\n\nexport class InvalidPersistedStorageKeyError extends InvalidPersistedCollectionConfigError {\n  constructor(key: string | number) {\n    super(\n      `Invalid persisted storage key \"${String(key)}\": numeric keys must be finite`,\n    )\n    this.name = `InvalidPersistedStorageKeyError`\n  }\n}\n\nexport class InvalidPersistedStorageKeyEncodingError extends InvalidPersistedCollectionConfigError {\n  constructor(encoded: string) {\n    super(\n      `Invalid persisted storage key encoding \"${encoded}\": expected prefix \"n:\" or \"s:\"`,\n    )\n    this.name = `InvalidPersistedStorageKeyEncodingError`\n  }\n}\n\nexport class SQLiteBigIntOutOfRangeError extends PersistedCollectionCoreError {\n  constructor(value: bigint, minimum: bigint, maximum: bigint) {\n    super(\n      `SQLite BigInt value ${value} is outside the signed 64-bit range [${minimum}, ${maximum}]`,\n    )\n    this.name = `SQLiteBigIntOutOfRangeError`\n  }\n}\n\nexport class PersistenceUnavailableError extends PersistedCollectionCoreError {\n  constructor(details?: string) {\n    super(\n      details\n        ? `Persistence unavailable: ${details}`\n        : `Persistence unavailable in this runtime`,\n    )\n    this.name = `PersistenceUnavailableError`\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/persisted.js

@@ -1,5 +1,5 @@
-import { safeRandomUUID, withCollectionConfigFactory, SyncTransactionAbortedError, getLoadSubsetDemandKey, compileSingleRowExpression, toBooleanPredicate, SYNC_PERSISTENCE_VERSION, SYNC_PERSISTENCE_PROTOCOL, PERSISTED_READINESS, NoPendingSyncTransactionCommitError, NoPendingSyncTransactionWriteError } from "@tanstack/db";
-import { InvalidPersistedCollectionConfigError, DuplicateRemoteSubsetOwnerError, toPersistedCollectionDurabilityError, InvalidPersistedCollectionCoordinatorError, InvalidSyncConfigError, InvalidPersistedStorageKeyError, InvalidPersistedStorageKeyEncodingError, PersistedCollectionDurabilityError, InvalidPersistenceAdapterError } from "./errors.js";
+import { safeRandomUUID, withCollectionConfigFactory, whenSyncAccepted, SyncTransactionAbortedError, getLoadSubsetDemandKey, compileSingleRowExpression, toBooleanPredicate, SYNC_PERSISTENCE_VERSION, SYNC_PERSISTENCE_PROTOCOL, PERSISTED_READINESS, NoPendingSyncTransactionCommitError, NoPendingSyncTransactionWriteError, withAcceptedReceipt } from "@tanstack/db";
+import { InvalidPersistedCollectionConfigError, DuplicateRemoteSubsetOwnerError, toPersistedCollectionDurabilityError, InvalidPersistedStorageKeyEncodingError, InvalidPersistedStorageKeyError, InvalidSyncConfigError, InvalidPersistedCollectionCoordinatorError, PersistedCollectionDurabilityError, InvalidPersistenceAdapterError } from "./errors.js";
 import { serializeSQLiteBigInt } from "./sqlite-value.js";
 import { toTransportedLoadSubsetOptions, toProcessLocalLoadSubsetOptions } from "./remote-subset-wire.js";
 import { reportRemoteSubsetOwnerError, unloadRemoteSubsetOwner } from "./remote-subset-owner.js";
@@ -440,7 +440,6 @@ class PersistedCollectionRuntime {
     this.resumeGenerationOwner = /* @__PURE__ */ Symbol(`persisted resume generation owner`);
     this.lifecycleGeneration = 0;
     this.internalApplyDepth = 0;
-    this.sourcePublicationWaitDepth = 0;
     this.appliedReceiptSequence = 0;
     this.syncErrorReported = false;
     this.pendingAppliedReceipts = /* @__PURE__ */ new Map();
@@ -499,11 +498,14 @@ class PersistedCollectionRuntime {
     void receipt.then(removeReceipt, removeReceipt);
     return receipt;
   }
-  async waitForAppliedReceiptsAfter(cursor) {
+  // Startup waits for acceptance: a local mutation's handler can wait for
+  // startup, and the rows publish when that mutation settles. Readiness waits
+  // for them in core. A subset load waits for visibility.
+  async waitForAppliedReceiptsAfter(cursor, until = `visible`) {
     await Promise.all(
       Array.from(
         this.pendingAppliedReceipts,
-        ([sequence, receipt]) => sequence > cursor ? receipt : void 0
+        ([sequence, receipt]) => sequence <= cursor ? void 0 : until === `accepted` ? whenSyncAccepted(receipt) : receipt
       )
     );
   }
@@ -664,7 +666,10 @@ class PersistedCollectionRuntime {
           startup.completedLocalIndexSignatures
         );
         if (startup.appliedCursor !== void 0 && lifecycleGeneration === this.lifecycleGeneration) {
-          await this.waitForAppliedReceiptsAfter(startup.appliedCursor);
+          await this.waitForAppliedReceiptsAfter(
+            startup.appliedCursor,
+            `accepted`
+          );
         }
       }
       if (lifecycleGeneration === this.lifecycleGeneration) {
@@ -699,7 +704,7 @@ class PersistedCollectionRuntime {
         return result;
       });
       if (appliedCursor !== void 0 && lifecycleGeneration === this.lifecycleGeneration) {
-        await this.waitForAppliedReceiptsAfter(appliedCursor);
+        await this.waitForAppliedReceiptsAfter(appliedCursor, `accepted`);
       }
     })().catch((error) => {
       throw this.markTerminalFailure(error, lifecycleGeneration);
@@ -788,7 +793,7 @@ class PersistedCollectionRuntime {
     const applied = this.replaceCollectionMetadataSnapshot(
       snapshot.collectionMetadata
     );
-    if (applied !== true) await applied;
+    await whenSyncAccepted(applied);
   }
   async loadCollectionMetadataSnapshot(adapter) {
     if (!adapter.loadCollectionMetadata) {
@@ -805,7 +810,7 @@ class PersistedCollectionRuntime {
     );
     const currentKeys = this.syncControls.metadata.collection.list().map(({ key }) => key);
     return this.withInternalApply(() => {
-      this.syncControls.begin?.({ immediate: true });
+      this.syncControls.begin?.();
       currentKeys.forEach((key) => {
         if (!nextMetadata.has(key)) {
           this.syncControls.metadata?.collection.delete(key);
@@ -980,13 +985,6 @@ class PersistedCollectionRuntime {
   applyHydrationBufferedTransaction(transaction) {
     const failure = this.getCurrentTerminalFailure();
     if (failure) return Promise.reject(failure.error);
-    if (transaction.beginOptions?.immediate && this.sourcePublicationWaitDepth > 0) {
-      return Promise.reject(
-        new InvalidPersistedCollectionConfigError(
-          `immediate persisted source replay cannot enter while an earlier source publication is waiting`
-        )
-      );
-    }
     return this.applyMutex.run(async () => {
       await this.applyBufferedSyncTransactionUnsafe(transaction);
     });
@@ -1207,7 +1205,7 @@ class PersistedCollectionRuntime {
             hydrationContext.suppliedRowKeys.add(row.key);
           }
           const applied = this.applyRowsToCollection(rows);
-          if (applied !== true) await applied;
+          await whenSyncAccepted(applied);
         }
       } finally {
         if (this.activeHydrationContext === hydrationContext && this.hydratingGeneration === config.lifecycleGeneration) {
@@ -1350,7 +1348,7 @@ class PersistedCollectionRuntime {
       return true;
     }
     return this.withInternalApply(() => {
-      this.syncControls.begin?.({ immediate: true });
+      this.syncControls.begin?.();
       for (const row of rows) {
         if (this.collection?._hasHydratedKey(row.key)) {
           continue;
@@ -1396,7 +1394,7 @@ class PersistedCollectionRuntime {
     );
     const currentKeys = this.syncControls.metadata.collection.list().map(({ key }) => key);
     return this.withInternalApply(() => {
-      this.syncControls.begin?.({ immediate: true });
+      this.syncControls.begin?.();
       this.syncControls.truncate?.();
       for (const row of rows) {
         this.syncControls.write?.({
@@ -1450,14 +1448,9 @@ class PersistedCollectionRuntime {
       const applied = transaction.internal ? this.withInternalApply(transaction.applyToCollection) : transaction.applyToCollection();
       applicationReturned = true;
       abortedDuringApplication = transaction.signal?.aborted === true;
-      if (applied !== true) {
-        this.sourcePublicationWaitDepth++;
-        try {
-          await applied;
-        } finally {
-          this.sourcePublicationWaitDepth--;
-        }
-      }
+      if (transaction.internal) await whenSyncAccepted(applied);
+      else if (applied !== true && !this.collection?._state.hasPersistingTransaction())
+        await applied;
       this.throwIfLifecycleReplaced(transaction.lifecycleGeneration);
       if (!transaction.internal) {
         await this.persistAndBroadcastExternalSyncTransactionUnsafe(
@@ -1627,7 +1620,7 @@ class PersistedCollectionRuntime {
       return;
     }
     const applied = this.withInternalApply(() => {
-      this.syncControls.begin?.({ immediate: true });
+      this.syncControls.begin?.();
       for (const mutation of mutations) {
         if (mutation.type === `delete`) {
           this.syncControls.write?.({
@@ -1643,9 +1636,8 @@ class PersistedCollectionRuntime {
       }
       return this.syncControls.commit?.() ?? true;
     });
-    if (applied !== true) {
-      await applied;
-    }
+    const accepted = whenSyncAccepted(applied);
+    if (accepted !== true) await accepted;
   }
   filterMutationsForCollection(mutations) {
     const collection = this.collection;
@@ -2033,11 +2025,11 @@ class PersistedCollectionRuntime {
     this.resetSequence++;
     if (this.syncControls.begin && this.syncControls.commit) {
       const applied = this.withInternalApply(() => {
-        this.syncControls.begin?.({ immediate: true });
+        this.syncControls.begin?.();
         this.syncControls.truncate?.();
         return this.syncControls.commit?.() ?? true;
       });
-      if (applied !== true) await applied;
+      await whenSyncAccepted(applied);
     }
     if (lifecycleGeneration !== this.lifecycleGeneration) return;
     await this.reloadActiveSubsetsUnsafe(adapter);
@@ -2070,7 +2062,7 @@ class PersistedCollectionRuntime {
       (opt) => opt.where ? compileSingleRowExpression(opt.where) : null
     );
     const applied = this.withInternalApply(() => {
-      this.syncControls.begin?.({ immediate: true });
+      this.syncControls.begin?.();
       for (const {
         key: changedKey,
         value: newValue
@@ -2110,7 +2102,7 @@ class PersistedCollectionRuntime {
       });
       return this.syncControls.commit?.() ?? true;
     });
-    if (applied !== true) await applied;
+    await whenSyncAccepted(applied);
   }
   async reloadActiveSubsetsUnsafe(adapter) {
     const lifecycleGeneration = this.lifecycleGeneration;
@@ -2146,7 +2138,7 @@ class PersistedCollectionRuntime {
         })),
         collectionMetadata
       );
-      if (applied !== true) await applied;
+      await whenSyncAccepted(applied);
     } finally {
       if (this.activeHydrationContext === hydrationContext && this.hydratingGeneration === lifecycleGeneration) {
         this.hydratingGeneration = null;
@@ -2312,6 +2304,14 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
       const settlePendingTransaction = (transaction) => {
         removePendingPublicationTransaction(transaction);
       };
+      const visibleAfterDurable = (transaction, durable) => {
+        const visible = durable.then(async () => {
+          const receipt = transaction.applicationReceipt;
+          if (receipt !== void 0 && receipt !== true) await receipt;
+        });
+        void visible.catch(() => void 0);
+        return withAcceptedReceipt(visible, durable);
+      };
       const settleRuntimeTransaction = (transaction, applied) => {
         void applied.then(
           () => settlePendingTransaction(transaction),
@@ -2419,9 +2419,7 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
             }
           }
           transaction.deferredHydrationMetadataDeleteKeys.clear();
-          params.begin(
-            transaction.queuedBecauseHydrating ? { immediate: true } : transaction.beginOptions
-          );
+          params.begin();
           if (transaction.truncate) params.truncate();
           for (const operation of transaction.operations) {
             if (operation.type === `delete`) {
@@ -2447,14 +2445,8 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
           }
           const applied = params.commit(signal);
           transaction.applicationReceipt = applied;
-          if (applied === true) {
-            removePendingPublicationTransaction(transaction);
-          } else {
-            void applied.then(
-              () => removePendingPublicationTransaction(transaction),
-              () => removePendingPublicationTransaction(transaction)
-            );
-          }
+          removePendingPublicationTransaction(transaction);
+          if (applied !== true) void applied.catch(() => void 0);
           return applied;
         } catch (error) {
           removePendingPublicationTransaction(transaction);
@@ -2475,6 +2467,11 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
       const persistenceCapability = {
         protocol: SYNC_PERSISTENCE_PROTOCOL,
         version: SYNC_PERSISTENCE_VERSION,
+        reserveCommitTurn: () => {
+          const openTransaction = getOpenTransaction();
+          if (openTransaction && !openTransaction.internal)
+            openTransaction.reservesCommitTurn = true;
+        },
         hydrateBaseline: async () => {
           if (startupState.cleanedUp) return;
           try {
@@ -2524,7 +2521,7 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
             params.markReady();
           }).catch(() => void 0);
         },
-        begin: (options) => {
+        begin: () => {
           if (startupState.cleanedUp) return void 0;
           const terminalFailure = getTerminalFailure();
           const internal = runtime.isApplyingInternally();
@@ -2537,7 +2534,6 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
             truncate: false,
             internal,
             lifecycleGeneration: runtime.getLifecycleGeneration(),
-            beginOptions: options,
             operationKeys: /* @__PURE__ */ new Set(),
             hasDependentSuccessor: false,
             queuedBecauseHydrating: terminalFailure === void 0 && !internal && runtime.isHydratingNow(),
@@ -2796,7 +2792,6 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
             truncate: openTransaction.truncate,
             internal: false,
             lifecycleGeneration: openTransaction.lifecycleGeneration,
-            beginOptions: openTransaction.beginOptions,
             expectedResumeGenerationOwner: openTransaction.expectedResumeGenerationOwner,
             signal,
             prependHydrationRows: (rows) => {
@@ -2838,7 +2833,7 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
             });
             settlePublicationAdmissionWaiters(openTransaction);
             settleRuntimeTransaction(openTransaction, applied2);
-            return applied2;
+            return visibleAfterDurable(openTransaction, applied2);
           }
           let applied;
           try {
@@ -2849,7 +2844,7 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
           }
           settlePublicationAdmissionWaiters(openTransaction);
           settleRuntimeTransaction(openTransaction, applied);
-          return applied;
+          return visibleAfterDurable(openTransaction, applied);
         }
       };
       let sourceResult = {};
@@ -2957,7 +2952,7 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
             }
           };
           const openTransaction = getOpenTransaction();
-          const needsPublicationAdmission = openTransaction && !openTransaction.internal && openTransaction.beginOptions?.immediate;
+          const needsPublicationAdmission = openTransaction?.reservesCommitTurn === true;
           const hydrated = sourceResultSettled && !needsPublicationAdmission ? runtime.loadHydratedSubset(
             options,
             (loadOptions) => forwardUpstream(sourceResult, loadOptions)
@@ -2972,7 +2967,7 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
               return;
             }
             const currentTransaction = getOpenTransaction();
-            if (currentTransaction && !currentTransaction.internal && currentTransaction.beginOptions?.immediate) {
+            if (currentTransaction?.reservesCommitTurn) {
               await waitForPublicationAdmission(
                 currentTransaction,
                 options,