@tanstack/db-sqlite-persistence-core 0.4.3 → 0.4.5

package/dist/cjs/sqlite-value.cjs

@@ -22,10 +22,61 @@ function serializeSQLiteBigInt(value) {
     [PERSISTED_VALUE_TAG]: value.toString()
   };
 }
+function sqliteTemporalKind(value) {
+  if (value === null || typeof value !== `object`) return;
+  const tag = value[Symbol.toStringTag];
+  if (tag === `Temporal.Instant` || tag === `Temporal.PlainDate`) return tag;
+  return void 0;
+}
+function requireSQLiteTemporalConstructor(kind) {
+  const name = kind.slice(`Temporal.`.length);
+  const constructor = globalThis.Temporal?.[name];
+  if (typeof constructor?.from !== `function` || typeof constructor.prototype.toString !== `function`) {
+    throw new errors.InvalidPersistedCollectionConfigError(
+      `Missing global ${kind} constructor for SQLite persistence`
+    );
+  }
+  return constructor;
+}
+function reviveSQLiteTemporal(kind, value) {
+  return requireSQLiteTemporalConstructor(kind).from(value);
+}
+function serializeSQLiteTemporal(value) {
+  if (value === null || typeof value !== `object`) return;
+  const prototype = Object.getPrototypeOf(value);
+  if (prototype === null || prototype === Object.prototype) return;
+  const tag = value[Symbol.toStringTag];
+  if (typeof tag !== `string` || !tag.startsWith(`Temporal.`)) return;
+  const kind = sqliteTemporalKind(value);
+  if (!kind)
+    throw new errors.InvalidPersistedCollectionConfigError(
+      `Unsupported ${tag} value for SQLite persistence`
+    );
+  const constructor = requireSQLiteTemporalConstructor(kind);
+  let text;
+  try {
+    text = constructor.prototype.toString.call(value);
+  } catch {
+    throw new errors.InvalidPersistedCollectionConfigError(
+      `Invalid ${kind} value for the registered global constructor`
+    );
+  }
+  const native = constructor.from(text);
+  const iso = kind === `Temporal.PlainDate` ? native.withCalendar(`iso8601`) : void 0;
+  const order = iso ? `${String(iso.year + 1e6).padStart(7, `0`)}${String(iso.month).padStart(2, `0`)}${String(iso.day).padStart(2, `0`)}` : (native.epochNanoseconds + 10000000000000000000000n).toString().padStart(23, `0`);
+  return { [PERSISTED_TYPE_TAG]: kind, [PERSISTED_VALUE_TAG]: text, order };
+}
+function sqliteTemporalIdentity(value) {
+  return `${value[PERSISTED_TYPE_TAG]}:${value[PERSISTED_VALUE_TAG]}`;
+}
 exports.PERSISTED_TYPE_TAG = PERSISTED_TYPE_TAG;
 exports.PERSISTED_VALUE_TAG = PERSISTED_VALUE_TAG;
 exports.SQLITE_BIGINT_MAX = SQLITE_BIGINT_MAX;
 exports.SQLITE_BIGINT_MIN = SQLITE_BIGINT_MIN;
 exports.assertSQLiteBigIntInRange = assertSQLiteBigIntInRange;
+exports.reviveSQLiteTemporal = reviveSQLiteTemporal;
 exports.serializeSQLiteBigInt = serializeSQLiteBigInt;
+exports.serializeSQLiteTemporal = serializeSQLiteTemporal;
+exports.sqliteTemporalIdentity = sqliteTemporalIdentity;
+exports.sqliteTemporalKind = sqliteTemporalKind;
 //# sourceMappingURL=sqlite-value.cjs.map

package/dist/cjs/sqlite-value.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sqlite-value.cjs","sources":["../../src/sqlite-value.ts"],"sourcesContent":["import { SQLiteBigIntOutOfRangeError } from './errors'\n\nexport const SQLITE_BIGINT_MIN = -9_223_372_036_854_775_808n\nexport const SQLITE_BIGINT_MAX = 9_223_372_036_854_775_807n\nexport const PERSISTED_TYPE_TAG = `__tanstack_db_persisted_type__`\nexport const PERSISTED_VALUE_TAG = `value`\n\nexport type SerializedSQLiteBigInt = {\n  [PERSISTED_TYPE_TAG]: `bigint`\n  [PERSISTED_VALUE_TAG]: string\n}\n\nexport function assertSQLiteBigIntInRange(value: bigint): bigint {\n  if (value < SQLITE_BIGINT_MIN || value > SQLITE_BIGINT_MAX) {\n    throw new SQLiteBigIntOutOfRangeError(\n      value,\n      SQLITE_BIGINT_MIN,\n      SQLITE_BIGINT_MAX,\n    )\n  }\n  return value\n}\n\nexport function serializeSQLiteBigInt(value: bigint): SerializedSQLiteBigInt {\n  assertSQLiteBigIntInRange(value)\n  return {\n    [PERSISTED_TYPE_TAG]: `bigint`,\n    [PERSISTED_VALUE_TAG]: value.toString(),\n  }\n}\n"],"names":["SQLiteBigIntOutOfRangeError"],"mappings":";;;AAEO,MAAM,oBAAoB,CAAC;AAC3B,MAAM,oBAAoB;AAC1B,MAAM,qBAAqB;AAC3B,MAAM,sBAAsB;AAO5B,SAAS,0BAA0B,OAAuB;AAC/D,MAAI,QAAQ,qBAAqB,QAAQ,mBAAmB;AAC1D,UAAM,IAAIA,OAAAA;AAAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AACA,SAAO;AACT;AAEO,SAAS,sBAAsB,OAAuC;AAC3E,4BAA0B,KAAK;AAC/B,SAAO;AAAA,IACL,CAAC,kBAAkB,GAAG;AAAA,IACtB,CAAC,mBAAmB,GAAG,MAAM,SAAA;AAAA,EAAS;AAE1C;;;;;;;"}
+{"version":3,"file":"sqlite-value.cjs","sources":["../../src/sqlite-value.ts"],"sourcesContent":["import {\n  InvalidPersistedCollectionConfigError,\n  SQLiteBigIntOutOfRangeError,\n} from './errors'\n\nexport const SQLITE_BIGINT_MIN = -9_223_372_036_854_775_808n\nexport const SQLITE_BIGINT_MAX = 9_223_372_036_854_775_807n\nexport const PERSISTED_TYPE_TAG = `__tanstack_db_persisted_type__`\nexport const PERSISTED_VALUE_TAG = `value`\n\nexport type SerializedSQLiteBigInt = {\n  [PERSISTED_TYPE_TAG]: `bigint`\n  [PERSISTED_VALUE_TAG]: string\n}\n\nexport function assertSQLiteBigIntInRange(value: bigint): bigint {\n  if (value < SQLITE_BIGINT_MIN || value > SQLITE_BIGINT_MAX) {\n    throw new SQLiteBigIntOutOfRangeError(\n      value,\n      SQLITE_BIGINT_MIN,\n      SQLITE_BIGINT_MAX,\n    )\n  }\n  return value\n}\n\nexport function serializeSQLiteBigInt(value: bigint): SerializedSQLiteBigInt {\n  assertSQLiteBigIntInRange(value)\n  return {\n    [PERSISTED_TYPE_TAG]: `bigint`,\n    [PERSISTED_VALUE_TAG]: value.toString(),\n  }\n}\n\ntype SQLiteTemporalKind = `Temporal.Instant` | `Temporal.PlainDate`\ntype SQLiteTemporal = {\n  epochNanoseconds: bigint\n  year: number\n  month: number\n  day: number\n  withCalendar: (calendar: string) => SQLiteTemporal\n}\ntype TemporalConstructor = {\n  from: (value: string) => SQLiteTemporal\n  prototype: { toString: () => string }\n}\n\nexport type SerializedSQLiteTemporal = {\n  [PERSISTED_TYPE_TAG]: SQLiteTemporalKind\n  [PERSISTED_VALUE_TAG]: string\n  order: string\n}\n\nexport function sqliteTemporalKind(\n  value: unknown,\n): SQLiteTemporalKind | undefined {\n  if (value === null || typeof value !== `object`) return\n  const tag = (value as { [Symbol.toStringTag]?: unknown })[Symbol.toStringTag]\n  if (tag === `Temporal.Instant` || tag === `Temporal.PlainDate`) return tag\n  return undefined\n}\n\nfunction requireSQLiteTemporalConstructor(\n  kind: SQLiteTemporalKind,\n): TemporalConstructor {\n  const name = kind.slice(`Temporal.`.length)\n  const constructor = (\n    globalThis as { Temporal?: Record<string, TemporalConstructor> }\n  ).Temporal?.[name]\n  if (\n    typeof constructor?.from !== `function` ||\n    typeof constructor.prototype.toString !== `function`\n  ) {\n    throw new InvalidPersistedCollectionConfigError(\n      `Missing global ${kind} constructor for SQLite persistence`,\n    )\n  }\n  return constructor\n}\n\nexport function reviveSQLiteTemporal(\n  kind: SQLiteTemporalKind,\n  value: string,\n): unknown {\n  return requireSQLiteTemporalConstructor(kind).from(value)\n}\n\n/** Registered prototype methods validate the brand; user toString is ignored. */\nexport function serializeSQLiteTemporal(\n  value: unknown,\n): SerializedSQLiteTemporal | undefined {\n  if (value === null || typeof value !== `object`) return\n  const prototype = Object.getPrototypeOf(value)\n  if (prototype === null || prototype === Object.prototype) return\n  const tag = (value as { [Symbol.toStringTag]?: unknown })[Symbol.toStringTag]\n  if (typeof tag !== `string` || !tag.startsWith(`Temporal.`)) return\n  const kind = sqliteTemporalKind(value)\n  if (!kind)\n    throw new InvalidPersistedCollectionConfigError(\n      `Unsupported ${tag} value for SQLite persistence`,\n    )\n  const constructor = requireSQLiteTemporalConstructor(kind)\n  let text: string\n  try {\n    text = constructor.prototype.toString.call(value)\n  } catch {\n    throw new InvalidPersistedCollectionConfigError(\n      `Invalid ${kind} value for the registered global constructor`,\n    )\n  }\n  const native = constructor.from(text)\n  const iso =\n    kind === `Temporal.PlainDate` ? native.withCalendar(`iso8601`) : undefined\n  // Text keys avoid both floating-point precision loss and SQLite's int64 cap.\n  const order = iso\n    ? `${String(iso.year + 1_000_000).padStart(7, `0`)}${String(iso.month).padStart(2, `0`)}${String(iso.day).padStart(2, `0`)}`\n    : (native.epochNanoseconds + 10_000_000_000_000_000_000_000n)\n        .toString()\n        .padStart(23, `0`)\n  return { [PERSISTED_TYPE_TAG]: kind, [PERSISTED_VALUE_TAG]: text, order }\n}\n\nexport function sqliteTemporalIdentity(\n  value: SerializedSQLiteTemporal,\n): string {\n  return `${value[PERSISTED_TYPE_TAG]}:${value[PERSISTED_VALUE_TAG]}`\n}\n"],"names":["SQLiteBigIntOutOfRangeError","InvalidPersistedCollectionConfigError"],"mappings":";;;AAKO,MAAM,oBAAoB,CAAC;AAC3B,MAAM,oBAAoB;AAC1B,MAAM,qBAAqB;AAC3B,MAAM,sBAAsB;AAO5B,SAAS,0BAA0B,OAAuB;AAC/D,MAAI,QAAQ,qBAAqB,QAAQ,mBAAmB;AAC1D,UAAM,IAAIA,OAAAA;AAAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAAA,EAEJ;AACA,SAAO;AACT;AAEO,SAAS,sBAAsB,OAAuC;AAC3E,4BAA0B,KAAK;AAC/B,SAAO;AAAA,IACL,CAAC,kBAAkB,GAAG;AAAA,IACtB,CAAC,mBAAmB,GAAG,MAAM,SAAA;AAAA,EAAS;AAE1C;AAqBO,SAAS,mBACd,OACgC;AAChC,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU;AACjD,QAAM,MAAO,MAA6C,OAAO,WAAW;AAC5E,MAAI,QAAQ,sBAAsB,QAAQ,qBAAsB,QAAO;AACvE,SAAO;AACT;AAEA,SAAS,iCACP,MACqB;AACrB,QAAM,OAAO,KAAK,MAAM,YAAY,MAAM;AAC1C,QAAM,cACJ,WACA,WAAW,IAAI;AACjB,MACE,OAAO,aAAa,SAAS,cAC7B,OAAO,YAAY,UAAU,aAAa,YAC1C;AACA,UAAM,IAAIC,OAAAA;AAAAA,MACR,kBAAkB,IAAI;AAAA,IAAA;AAAA,EAE1B;AACA,SAAO;AACT;AAEO,SAAS,qBACd,MACA,OACS;AACT,SAAO,iCAAiC,IAAI,EAAE,KAAK,KAAK;AAC1D;AAGO,SAAS,wBACd,OACsC;AACtC,MAAI,UAAU,QAAQ,OAAO,UAAU,SAAU;AACjD,QAAM,YAAY,OAAO,eAAe,KAAK;AAC7C,MAAI,cAAc,QAAQ,cAAc,OAAO,UAAW;AAC1D,QAAM,MAAO,MAA6C,OAAO,WAAW;AAC5E,MAAI,OAAO,QAAQ,YAAY,CAAC,IAAI,WAAW,WAAW,EAAG;AAC7D,QAAM,OAAO,mBAAmB,KAAK;AACrC,MAAI,CAAC;AACH,UAAM,IAAIA,OAAAA;AAAAA,MACR,eAAe,GAAG;AAAA,IAAA;AAEtB,QAAM,cAAc,iCAAiC,IAAI;AACzD,MAAI;AACJ,MAAI;AACF,WAAO,YAAY,UAAU,SAAS,KAAK,KAAK;AAAA,EAClD,QAAQ;AACN,UAAM,IAAIA,OAAAA;AAAAA,MACR,WAAW,IAAI;AAAA,IAAA;AAAA,EAEnB;AACA,QAAM,SAAS,YAAY,KAAK,IAAI;AACpC,QAAM,MACJ,SAAS,uBAAuB,OAAO,aAAa,SAAS,IAAI;AAEnE,QAAM,QAAQ,MACV,GAAG,OAAO,IAAI,OAAO,GAAS,EAAE,SAAS,GAAG,GAAG,CAAC,GAAG,OAAO,IAAI,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,GAAG,OAAO,IAAI,GAAG,EAAE,SAAS,GAAG,GAAG,CAAC,MACvH,OAAO,mBAAmB,0BACxB,WACA,SAAS,IAAI,GAAG;AACvB,SAAO,EAAE,CAAC,kBAAkB,GAAG,MAAM,CAAC,mBAAmB,GAAG,MAAM,MAAA;AACpE;AAEO,SAAS,uBACd,OACQ;AACR,SAAO,GAAG,MAAM,kBAAkB,CAAC,IAAI,MAAM,mBAAmB,CAAC;AACnE;;;;;;;;;;;"}

package/dist/cjs/sqlite-value.d.cts

@@ -8,3 +8,15 @@ export type SerializedSQLiteBigInt = {
 };
 export declare function assertSQLiteBigIntInRange(value: bigint): bigint;
 export declare function serializeSQLiteBigInt(value: bigint): SerializedSQLiteBigInt;
+type SQLiteTemporalKind = `Temporal.Instant` | `Temporal.PlainDate`;
+export type SerializedSQLiteTemporal = {
+    [PERSISTED_TYPE_TAG]: SQLiteTemporalKind;
+    [PERSISTED_VALUE_TAG]: string;
+    order: string;
+};
+export declare function sqliteTemporalKind(value: unknown): SQLiteTemporalKind | undefined;
+export declare function reviveSQLiteTemporal(kind: SQLiteTemporalKind, value: string): unknown;
+/** Registered prototype methods validate the brand; user toString is ignored. */
+export declare function serializeSQLiteTemporal(value: unknown): SerializedSQLiteTemporal | undefined;
+export declare function sqliteTemporalIdentity(value: SerializedSQLiteTemporal): string;
+export {};

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/index.js

@@ -1,8 +1,8 @@
 import { SQLITE_DRIVER_SHARED_LOGICAL_SCHEDULING_KEY, SingleProcessCoordinator, createPersistedTableName, decodePersistedStorageKey, encodePersistedStorageKey, forwardSQLiteDriverSharedLogicalScheduling, persistedCollectionOptions, validatePersistedCollectionCoordinator } from "./persisted.js";
 import { DuplicateRemoteSubsetOwnerError, IndeterminateCommitError, InvalidPersistedCollectionConfigError, InvalidPersistedCollectionCoordinatorError, InvalidPersistedStorageKeyEncodingError, InvalidPersistedStorageKeyError, InvalidPersistenceAdapterError, InvalidSyncConfigError, PersistedCollectionCoreError, PersistedCollectionDurabilityError, PersistenceUnavailableError, RetryableRemoteSubsetAcquisitionError, SQLiteBigIntOutOfRangeError, toPersistedCollectionDurabilityError } from "./errors.js";
 import { DEFAULT_APPLIED_TX_PRUNE_MAX_AGE_SECONDS, DEFAULT_APPLIED_TX_PRUNE_MAX_ROWS, SQLiteCorePersistenceAdapter, createSQLiteCorePersistenceAdapter } from "./sqlite-core-adapter.js";
-import { PERSISTED_TYPE_TAG, PERSISTED_VALUE_TAG, SQLITE_BIGINT_MAX, SQLITE_BIGINT_MIN, assertSQLiteBigIntInRange, serializeSQLiteBigInt } from "./sqlite-value.js";
-import { RemoteSubsetWireValueError, toProcessLocalLoadSubsetOptions, toTransportedLoadSubsetOptions } from "./remote-subset-wire.js";
+import { PERSISTED_TYPE_TAG, PERSISTED_VALUE_TAG, SQLITE_BIGINT_MAX, SQLITE_BIGINT_MIN, assertSQLiteBigIntInRange, reviveSQLiteTemporal, serializeSQLiteBigInt, serializeSQLiteTemporal, sqliteTemporalIdentity, sqliteTemporalKind } from "./sqlite-value.js";
+import { RemoteSubsetWireValueError, toProcessLocalLoadSubsetOptions, toTransportedLoadSubsetOptions, validateRemoteSubsetOptions } from "./remote-subset-wire.js";
 import { safeRandomUUID } from "@tanstack/db";
 export {
   DEFAULT_APPLIED_TX_PRUNE_MAX_AGE_SECONDS,
@@ -35,11 +35,16 @@ export {
   encodePersistedStorageKey,
   forwardSQLiteDriverSharedLogicalScheduling,
   persistedCollectionOptions,
+  reviveSQLiteTemporal,
   safeRandomUUID,
   serializeSQLiteBigInt,
+  serializeSQLiteTemporal,
+  sqliteTemporalIdentity,
+  sqliteTemporalKind,
   toPersistedCollectionDurabilityError,
   toProcessLocalLoadSubsetOptions,
   toTransportedLoadSubsetOptions,
-  validatePersistedCollectionCoordinator
+  validatePersistedCollectionCoordinator,
+  validateRemoteSubsetOptions
 };
 //# sourceMappingURL=index.js.map

package/dist/esm/persisted.d.ts

@@ -358,6 +358,12 @@ export interface PersistedCollectionCoordinator {
      */
     requestEnsurePersistedIndex: (collectionId: string, signature: string, spec: PersistedIndexSpec, scopedAdapter?: HydrationPersistenceAdapter, localEnsureCompleted?: boolean) => Promise<void>;
     requestApplyLocalMutations?: (collectionId: string, mutations: Array<PersistedMutationEnvelope>) => Promise<ApplyLocalMutationsResponse>;
+    /**
+     * Applies a committed transaction through the supplied adapter when present.
+     * Wrappers must forward this leader-local loan: scheduling it again can wait
+     * on the hydration that is awaiting this call. Never serialize or retain the
+     * loan after the call; ordinary work uses the registered collection adapter.
+     */
     requestApplyCommittedTx: (collectionId: string, tx: PersistedTx, scopedAdapter?: HydrationPersistenceAdapter) => Promise<ApplyCommittedTxResponse>;
     /** The scoped adapter is leader-local and is never serialized to a follower. */
     pullSince?: (collectionId: string, fromRowVersion: number, scopedAdapter?: HydrationPersistenceAdapter) => Promise<PullSinceResponse>;
@@ -433,7 +439,7 @@ export declare class SingleProcessCoordinator implements PersistedCollectionCoor
     registerRemoteSubsetOwner(collectionId: string, owner: RemoteSubsetOwner): () => void;
     requestEnsurePersistedIndex(): Promise<void>;
     setAdapterForCollection(collectionId: string, adapter: PersistenceAdapter): void;
-    requestApplyCommittedTx(collectionId: string, tx: PersistedTx): Promise<ApplyCommittedTxResponse>;
+    requestApplyCommittedTx(collectionId: string, tx: PersistedTx, scopedAdapter?: HydrationPersistenceAdapter): Promise<ApplyCommittedTxResponse>;
     pullSince(): Promise<PullSinceResponse>;
 }
 export declare function validatePersistedCollectionCoordinator(coordinator: PersistedCollectionCoordinator): void;

package/dist/esm/persisted.js

@@ -1,7 +1,7 @@
-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 { serializeSQLiteBigInt } from "./sqlite-value.js";
-import { toTransportedLoadSubsetOptions, toProcessLocalLoadSubsetOptions } from "./remote-subset-wire.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, serializeSQLiteTemporal } from "./sqlite-value.js";
+import { toTransportedLoadSubsetOptions, toProcessLocalLoadSubsetOptions, validateRemoteSubsetOptions } from "./remote-subset-wire.js";
 import { reportRemoteSubsetOwnerError, unloadRemoteSubsetOwner } from "./remote-subset-owner.js";
 const SQLITE_DRIVER_SHARED_LOGICAL_SCHEDULING_KEY = /* @__PURE__ */ Symbol.for(
   `tanstack-db.sqlite-driver-supports-shared-logical-scheduling`
@@ -176,8 +176,8 @@ class SingleProcessCoordinator {
   setAdapterForCollection(collectionId, adapter) {
     this.collectionAdapters.set(collectionId, adapter);
   }
-  async requestApplyCommittedTx(collectionId, tx) {
-    const adapter = this.collectionAdapters.get(collectionId);
+  async requestApplyCommittedTx(collectionId, tx, scopedAdapter) {
+    const adapter = scopedAdapter ?? this.collectionAdapters.get(collectionId);
     if (!adapter) {
       throw new InvalidPersistedCollectionConfigError(
         `SingleProcessCoordinator has no persistence adapter configured for collection "${collectionId}"`
@@ -333,6 +333,8 @@ function toStableSerializable(value) {
     case `undefined`:
       return void 0;
   }
+  const temporal = serializeSQLiteTemporal(value);
+  if (temporal) return temporal;
   if (value instanceof Date) {
     return value.toISOString();
   }
@@ -440,7 +442,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 +500,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 +668,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 +706,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);
@@ -740,7 +747,6 @@ class PersistedCollectionRuntime {
     await this.hydrateSubsetUnsafe(
       baseline,
       {
-        requestRemoteEnsure: false,
         lifecycleGeneration,
         bindKeySetEvidence: true
       },
@@ -788,7 +794,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 +811,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);
@@ -823,6 +829,7 @@ class PersistedCollectionRuntime {
     const subsetKey = this.getSubsetKey(options);
     const truncateGeneration = this.sourceTruncateGeneration;
     const routeRemoteDemandDuringHydration = this.canRouteRemoteDemandThroughCoordinator();
+    if (routeRemoteDemandDuringHydration) validateRemoteSubsetOptions(options);
     this.activeSubsets.set(subsetKey, options);
     const appliedCursor = this.appliedReceiptSequence;
     try {
@@ -832,7 +839,6 @@ class PersistedCollectionRuntime {
             (adapter) => this.hydrateSubsetUnsafe(
               options,
               {
-                requestRemoteEnsure: this.mode === `sync-present` && !routeRemoteDemandDuringHydration,
                 lifecycleGeneration,
                 requestLocalLoadFailure: true,
                 rejectBufferedReplayFailure: true
@@ -848,6 +854,9 @@ class PersistedCollectionRuntime {
       });
       if (lifecycleGeneration !== this.lifecycleGeneration) return;
       await this.waitForAppliedReceiptsAfter(appliedCursor);
+      if (!routeRemoteDemandDuringHydration && this.canRouteRemoteDemandThroughCoordinator()) {
+        validateRemoteSubsetOptions(options);
+      }
     } catch (error) {
       if (this.activeSubsets.get(subsetKey) === options) {
         this.activeSubsets.delete(subsetKey);
@@ -957,7 +966,6 @@ class PersistedCollectionRuntime {
         (adapter) => this.hydrateSubsetUnsafe(
           options,
           {
-            requestRemoteEnsure: false,
             lifecycleGeneration,
             rejectBufferedReplayFailure: true
           },
@@ -980,13 +988,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 +1208,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) {
@@ -1217,9 +1218,6 @@ class PersistedCollectionRuntime {
       if (config.lifecycleGeneration !== this.lifecycleGeneration) return;
       replayFailure = await this.flushQueuedHydrationTransactionsUnsafe(adapter);
       if (config.lifecycleGeneration !== this.lifecycleGeneration) return;
-      if (config.requestRemoteEnsure && !replayFailure) {
-        this.queueRemoteSubsetEnsure(options);
-      }
     } catch (error) {
       if (config.requestLocalLoadFailure && !rowsLoaded) {
         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;
@@ -1818,6 +1810,7 @@ class PersistedCollectionRuntime {
     }
     const subsetKey = this.getSubsetKey(options);
     if (this.activeSubsets.get(subsetKey) !== options) return;
+    validateRemoteSubsetOptions(options);
     this.pendingRemoteSubsetEnsures.set(subsetKey, options);
     void this.flushPendingRemoteSubsetEnsures();
   }
@@ -2033,11 +2026,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 +2063,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 +2103,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 +2139,7 @@ class PersistedCollectionRuntime {
         })),
         collectionMetadata
       );
-      if (applied !== true) await applied;
+      await whenSyncAccepted(applied);
     } finally {
       if (this.activeHydrationContext === hydrationContext && this.hydratingGeneration === lifecycleGeneration) {
         this.hydratingGeneration = null;
@@ -2220,8 +2213,8 @@ class PersistedCollectionRuntime {
     await this.requestCoordinatorPersistedIndex(indexMetadata, completedLocally);
   }
   async ensureLocalPersistedIndex(indexMetadata, adapter) {
-    const spec = this.buildPersistedIndexSpec(indexMetadata);
     try {
+      const spec = this.buildPersistedIndexSpec(indexMetadata);
       await adapter.ensureIndex(
         this.collectionId,
         indexMetadata.signature,
@@ -2234,8 +2227,8 @@ class PersistedCollectionRuntime {
     }
   }
   async requestCoordinatorPersistedIndex(indexMetadata, completedLocally) {
-    const spec = this.buildPersistedIndexSpec(indexMetadata);
     try {
+      const spec = this.buildPersistedIndexSpec(indexMetadata);
       await this.persistence.coordinator.requestEnsurePersistedIndex(
         this.collectionId,
         indexMetadata.signature,
@@ -2312,6 +2305,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 +2420,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 +2446,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 +2468,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 +2522,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 +2535,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 +2793,6 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
             truncate: openTransaction.truncate,
             internal: false,
             lifecycleGeneration: openTransaction.lifecycleGeneration,
-            beginOptions: openTransaction.beginOptions,
             expectedResumeGenerationOwner: openTransaction.expectedResumeGenerationOwner,
             signal,
             prependHydrationRows: (rows) => {
@@ -2838,8 +2834,9 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
             });
             settlePublicationAdmissionWaiters(openTransaction);
             settleRuntimeTransaction(openTransaction, applied2);
-            return applied2;
+            return visibleAfterDurable(openTransaction, applied2);
           }
+          openTransaction.hydrationSequence = void 0;
           let applied;
           try {
             applied = runtime.applyHydrationBufferedTransaction(transaction);
@@ -2849,7 +2846,7 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
           }
           settlePublicationAdmissionWaiters(openTransaction);
           settleRuntimeTransaction(openTransaction, applied);
-          return applied;
+          return visibleAfterDurable(openTransaction, applied);
         }
       };
       let sourceResult = {};
@@ -2957,7 +2954,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 +2969,7 @@ function createWrappedSyncConfig(sourceSyncConfig, runtime, persistedReadiness)
               return;
             }
             const currentTransaction = getOpenTransaction();
-            if (currentTransaction && !currentTransaction.internal && currentTransaction.beginOptions?.immediate) {
+            if (currentTransaction?.reservesCommitTurn) {
               await waitForPublicationAdmission(
                 currentTransaction,
                 options,