@tanstack/offline-transactions 1.1.0 → 1.1.1

package/dist/cjs/outbox/OutboxManager.cjs

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const tracer = require("../telemetry/tracer.cjs");
 const TransactionSerializer = require("./TransactionSerializer.cjs");
 class OutboxTransactionNotFoundError extends Error {
 }
@@ -34,42 +33,24 @@ class OutboxManager {
       if (revision <= oldestRead) this.removedAtRevision.delete(id);
   }
   async add(transaction) {
-    return tracer.withSpan(
-      `outbox.add`,
-      {
-        "transaction.id": transaction.id,
-        "transaction.mutationFnName": transaction.mutationFnName,
-        "transaction.keyCount": transaction.keys.length
-      },
-      async () => {
-        const key = this.getStorageKey(transaction.id);
-        const serialized = this.serializer.serialize(transaction);
-        await this.storage.set(key, serialized);
-      }
-    );
+    const key = this.getStorageKey(transaction.id);
+    const serialized = this.serializer.serialize(transaction);
+    await this.storage.set(key, serialized);
   }
   async get(id) {
-    return tracer.withSpan(`outbox.get`, {}, async (span) => {
-      const key = this.getStorageKey(id);
-      const data = await this.storage.get(key);
-      if (!data) {
-        span.setAttribute(`result`, `not_found`);
-        return null;
-      }
-      try {
-        const transaction = this.serializer.deserialize(data);
-        span.setAttribute(`result`, `found`);
-        return transaction;
-      } catch (error) {
-        if (error instanceof TransactionSerializer.MissingTemporalConstructorError) {
-          error.message = `transaction ${id}: ${error.message}`;
-          throw error;
-        }
-        console.warn(`Failed to deserialize transaction ${id}:`, error);
-        span.setAttribute(`result`, `deserialize_error`);
-        return null;
+    const key = this.getStorageKey(id);
+    const data = await this.storage.get(key);
+    if (!data) return null;
+    try {
+      return this.serializer.deserialize(data);
+    } catch (error) {
+      if (error instanceof TransactionSerializer.MissingTemporalConstructorError) {
+        error.message = `transaction ${id}: ${error.message}`;
+        throw error;
       }
-    });
+      console.warn(`Failed to deserialize transaction ${id}:`, error);
+      return null;
+    }
   }
   async getAll() {
     return this.withAll((transactions) => transactions);
@@ -78,36 +59,33 @@ class OutboxManager {
     const read = { revision: this.removalRevision };
     this.activeReads.add(read);
     try {
-      return await tracer.withSpan(`outbox.getAll`, {}, async (span) => {
-        const keys = await this.storage.keys();
-        const transactionKeys = keys.filter(
-          (key) => key.startsWith(this.keyPrefix)
-        );
-        span.setAttribute(`transactionCount`, transactionKeys.length);
-        const transactions = [];
-        for (const key of transactionKeys) {
-          const data = await this.storage.get(key);
-          if (data) {
-            try {
-              const transaction = this.serializer.deserialize(data);
-              transactions.push(transaction);
-            } catch (error) {
-              if (error instanceof TransactionSerializer.MissingTemporalConstructorError) {
-                error.message = `transaction ${key.slice(this.keyPrefix.length)}: ${error.message}`;
-                throw error;
-              }
-              console.warn(
-                `Failed to deserialize transaction from key ${key}:`,
-                error
-              );
+      const keys = await this.storage.keys();
+      const transactionKeys = keys.filter(
+        (key) => key.startsWith(this.keyPrefix)
+      );
+      const transactions = [];
+      for (const key of transactionKeys) {
+        const data = await this.storage.get(key);
+        if (data) {
+          try {
+            const transaction = this.serializer.deserialize(data);
+            transactions.push(transaction);
+          } catch (error) {
+            if (error instanceof TransactionSerializer.MissingTemporalConstructorError) {
+              error.message = `transaction ${key.slice(this.keyPrefix.length)}: ${error.message}`;
+              throw error;
             }
+            console.warn(
+              `Failed to deserialize transaction from key ${key}:`,
+              error
+            );
           }
         }
-        const currentTransactions = transactions.filter(
-          ({ id }) => (this.removedAtRevision.get(id) ?? 0) <= read.revision
-        ).sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
-        return consume(currentTransactions);
-      });
+      }
+      const currentTransactions = transactions.filter(
+        ({ id }) => (this.removedAtRevision.get(id) ?? 0) <= read.revision
+      ).sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+      return await consume(currentTransactions);
     } finally {
       this.activeReads.delete(read);
       this.pruneRemovalHistory();
@@ -121,26 +99,19 @@ class OutboxManager {
     );
   }
   async update(id, updates) {
-    return tracer.withSpan(`outbox.update`, {}, async () => {
-      const existing = await this.get(id);
-      if (!existing) {
-        throw new OutboxTransactionNotFoundError(`Transaction ${id} not found`);
-      }
-      const updated = { ...existing, ...updates };
-      await this.add(updated);
-    });
+    const existing = await this.get(id);
+    if (!existing) {
+      throw new OutboxTransactionNotFoundError(`Transaction ${id} not found`);
+    }
+    await this.add({ ...existing, ...updates });
   }
   async remove(id) {
-    return tracer.withSpan(`outbox.remove`, {}, async () => {
-      const key = this.getStorageKey(id);
-      await this.storage.delete(key);
-      this.recordRemovals([id]);
-    });
+    const key = this.getStorageKey(id);
+    await this.storage.delete(key);
+    this.recordRemovals([id]);
   }
   async removeMany(ids) {
-    return tracer.withSpan(`outbox.removeMany`, { count: ids.length }, async () => {
-      await Promise.all(ids.map((id) => this.remove(id)));
-    });
+    await Promise.all(ids.map((id) => this.remove(id)));
   }
   async clear() {
     const keys = await this.storage.keys();

package/dist/cjs/outbox/OutboxManager.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"OutboxManager.cjs","sources":["../../../src/outbox/OutboxManager.ts"],"sourcesContent":["import { withSpan } from '../telemetry/tracer'\nimport {\n  MissingTemporalConstructorError,\n  TransactionSerializer,\n} from './TransactionSerializer'\nimport type { OfflineTransaction, StorageAdapter } from '../types'\nimport type { Collection } from '@tanstack/db'\n\nexport class OutboxTransactionNotFoundError extends Error {}\n\nexport class OutboxManager {\n  private storage: StorageAdapter\n  private serializer: TransactionSerializer\n  private keyPrefix = `tx:`\n  private removalRevision = 0\n  private activeReads = new Set<{ revision: number }>()\n  private removedAtRevision = new Map<string, number>()\n\n  constructor(\n    storage: StorageAdapter,\n\n    collections: Record<string, Collection<any, any, any, any, any>>,\n  ) {\n    this.storage = storage\n    this.serializer = new TransactionSerializer(collections)\n  }\n\n  private getStorageKey(id: string): string {\n    return `${this.keyPrefix}${id}`\n  }\n\n  private recordRemovals(ids: Iterable<string>): void {\n    this.removalRevision++\n    if (this.activeReads.size === 0) return\n    for (const id of ids) this.removedAtRevision.set(id, this.removalRevision)\n    this.pruneRemovalHistory()\n  }\n\n  private pruneRemovalHistory(): void {\n    if (this.activeReads.size === 0) {\n      this.removedAtRevision.clear()\n      return\n    }\n    let oldestRead = Number.POSITIVE_INFINITY\n    for (const read of this.activeReads)\n      oldestRead = Math.min(oldestRead, read.revision)\n    for (const [id, revision] of this.removedAtRevision)\n      if (revision <= oldestRead) this.removedAtRevision.delete(id)\n  }\n\n  async add(transaction: OfflineTransaction): Promise<void> {\n    return withSpan(\n      `outbox.add`,\n      {\n        'transaction.id': transaction.id,\n        'transaction.mutationFnName': transaction.mutationFnName,\n        'transaction.keyCount': transaction.keys.length,\n      },\n      async () => {\n        const key = this.getStorageKey(transaction.id)\n        const serialized = this.serializer.serialize(transaction)\n        await this.storage.set(key, serialized)\n      },\n    )\n  }\n\n  async get(id: string): Promise<OfflineTransaction | null> {\n    return withSpan(`outbox.get`, { 'transaction.id': id }, async (span) => {\n      const key = this.getStorageKey(id)\n      const data = await this.storage.get(key)\n\n      if (!data) {\n        span.setAttribute(`result`, `not_found`)\n        return null\n      }\n\n      try {\n        const transaction = this.serializer.deserialize(data)\n        span.setAttribute(`result`, `found`)\n        return transaction\n      } catch (error) {\n        if (error instanceof MissingTemporalConstructorError) {\n          error.message = `transaction ${id}: ${error.message}`\n          throw error\n        }\n        console.warn(`Failed to deserialize transaction ${id}:`, error)\n        span.setAttribute(`result`, `deserialize_error`)\n        return null\n      }\n    })\n  }\n\n  async getAll(): Promise<Array<OfflineTransaction>> {\n    return this.withAll((transactions) => transactions)\n  }\n\n  async withAll<T>(\n    consume: (transactions: Array<OfflineTransaction>) => T,\n  ): Promise<T> {\n    const read = { revision: this.removalRevision }\n    this.activeReads.add(read)\n    try {\n      return await withSpan(`outbox.getAll`, {}, async (span) => {\n        const keys = await this.storage.keys()\n        const transactionKeys = keys.filter((key) =>\n          key.startsWith(this.keyPrefix),\n        )\n\n        span.setAttribute(`transactionCount`, transactionKeys.length)\n\n        const transactions: Array<OfflineTransaction> = []\n\n        for (const key of transactionKeys) {\n          const data = await this.storage.get(key)\n          if (data) {\n            try {\n              const transaction = this.serializer.deserialize(data)\n              transactions.push(transaction)\n            } catch (error) {\n              if (error instanceof MissingTemporalConstructorError) {\n                error.message = `transaction ${key.slice(this.keyPrefix.length)}: ${error.message}`\n                throw error\n              }\n              console.warn(\n                `Failed to deserialize transaction from key ${key}:`,\n                error,\n              )\n            }\n          }\n        }\n\n        const currentTransactions = transactions\n          .filter(\n            ({ id }) => (this.removedAtRevision.get(id) ?? 0) <= read.revision,\n          )\n          .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime())\n        // Keep the read registered until replay admission completes. A durable\n        // removal cannot land between filtering and this synchronous consumer.\n        return consume(currentTransactions)\n      })\n    } finally {\n      this.activeReads.delete(read)\n      this.pruneRemovalHistory()\n    }\n  }\n\n  async getByKeys(keys: Array<string>): Promise<Array<OfflineTransaction>> {\n    const allTransactions = await this.getAll()\n    const keySet = new Set(keys)\n\n    return allTransactions.filter((transaction) =>\n      transaction.keys.some((key) => keySet.has(key)),\n    )\n  }\n\n  async update(\n    id: string,\n    updates: Partial<OfflineTransaction>,\n  ): Promise<void> {\n    return withSpan(`outbox.update`, { 'transaction.id': id }, async () => {\n      const existing = await this.get(id)\n      if (!existing) {\n        throw new OutboxTransactionNotFoundError(`Transaction ${id} not found`)\n      }\n\n      const updated = { ...existing, ...updates }\n      await this.add(updated)\n    })\n  }\n\n  async remove(id: string): Promise<void> {\n    return withSpan(`outbox.remove`, { 'transaction.id': id }, async () => {\n      const key = this.getStorageKey(id)\n      await this.storage.delete(key)\n      this.recordRemovals([id])\n    })\n  }\n\n  async removeMany(ids: Array<string>): Promise<void> {\n    return withSpan(`outbox.removeMany`, { count: ids.length }, async () => {\n      await Promise.all(ids.map((id) => this.remove(id)))\n    })\n  }\n\n  async clear(): Promise<void> {\n    const keys = await this.storage.keys()\n    const transactionKeys = keys.filter((key) => key.startsWith(this.keyPrefix))\n\n    await this.removeMany(\n      transactionKeys.map((key) => key.slice(this.keyPrefix.length)),\n    )\n  }\n\n  async count(): Promise<number> {\n    const keys = await this.storage.keys()\n    return keys.filter((key) => key.startsWith(this.keyPrefix)).length\n  }\n}\n"],"names":["TransactionSerializer","withSpan","MissingTemporalConstructorError"],"mappings":"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"}
+{"version":3,"file":"OutboxManager.cjs","sources":["../../../src/outbox/OutboxManager.ts"],"sourcesContent":["import {\n  MissingTemporalConstructorError,\n  TransactionSerializer,\n} from './TransactionSerializer'\nimport type { OfflineTransaction, StorageAdapter } from '../types'\nimport type { Collection } from '@tanstack/db'\n\nexport class OutboxTransactionNotFoundError extends Error {}\n\nexport class OutboxManager {\n  private storage: StorageAdapter\n  private serializer: TransactionSerializer\n  private keyPrefix = `tx:`\n  private removalRevision = 0\n  private activeReads = new Set<{ revision: number }>()\n  private removedAtRevision = new Map<string, number>()\n\n  constructor(\n    storage: StorageAdapter,\n\n    collections: Record<string, Collection<any, any, any, any, any>>,\n  ) {\n    this.storage = storage\n    this.serializer = new TransactionSerializer(collections)\n  }\n\n  private getStorageKey(id: string): string {\n    return `${this.keyPrefix}${id}`\n  }\n\n  private recordRemovals(ids: Iterable<string>): void {\n    this.removalRevision++\n    if (this.activeReads.size === 0) return\n    for (const id of ids) this.removedAtRevision.set(id, this.removalRevision)\n    this.pruneRemovalHistory()\n  }\n\n  private pruneRemovalHistory(): void {\n    if (this.activeReads.size === 0) {\n      this.removedAtRevision.clear()\n      return\n    }\n    let oldestRead = Number.POSITIVE_INFINITY\n    for (const read of this.activeReads)\n      oldestRead = Math.min(oldestRead, read.revision)\n    for (const [id, revision] of this.removedAtRevision)\n      if (revision <= oldestRead) this.removedAtRevision.delete(id)\n  }\n\n  async add(transaction: OfflineTransaction): Promise<void> {\n    const key = this.getStorageKey(transaction.id)\n    const serialized = this.serializer.serialize(transaction)\n    await this.storage.set(key, serialized)\n  }\n\n  async get(id: string): Promise<OfflineTransaction | null> {\n    const key = this.getStorageKey(id)\n    const data = await this.storage.get(key)\n    if (!data) return null\n\n    try {\n      return this.serializer.deserialize(data)\n    } catch (error) {\n      if (error instanceof MissingTemporalConstructorError) {\n        error.message = `transaction ${id}: ${error.message}`\n        throw error\n      }\n      console.warn(`Failed to deserialize transaction ${id}:`, error)\n      return null\n    }\n  }\n\n  async getAll(): Promise<Array<OfflineTransaction>> {\n    return this.withAll((transactions) => transactions)\n  }\n\n  async withAll<T>(\n    consume: (transactions: Array<OfflineTransaction>) => T,\n  ): Promise<T> {\n    const read = { revision: this.removalRevision }\n    this.activeReads.add(read)\n    try {\n      const keys = await this.storage.keys()\n      const transactionKeys = keys.filter((key) =>\n        key.startsWith(this.keyPrefix),\n      )\n\n      const transactions: Array<OfflineTransaction> = []\n\n      for (const key of transactionKeys) {\n        const data = await this.storage.get(key)\n        if (data) {\n          try {\n            const transaction = this.serializer.deserialize(data)\n            transactions.push(transaction)\n          } catch (error) {\n            if (error instanceof MissingTemporalConstructorError) {\n              error.message = `transaction ${key.slice(this.keyPrefix.length)}: ${error.message}`\n              throw error\n            }\n            console.warn(\n              `Failed to deserialize transaction from key ${key}:`,\n              error,\n            )\n          }\n        }\n      }\n\n      const currentTransactions = transactions\n        .filter(\n          ({ id }) => (this.removedAtRevision.get(id) ?? 0) <= read.revision,\n        )\n        .sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime())\n      // Keep the read registered until replay admission completes. A durable\n      // removal cannot land between filtering and this synchronous consumer.\n      return await consume(currentTransactions)\n    } finally {\n      this.activeReads.delete(read)\n      this.pruneRemovalHistory()\n    }\n  }\n\n  async getByKeys(keys: Array<string>): Promise<Array<OfflineTransaction>> {\n    const allTransactions = await this.getAll()\n    const keySet = new Set(keys)\n\n    return allTransactions.filter((transaction) =>\n      transaction.keys.some((key) => keySet.has(key)),\n    )\n  }\n\n  async update(\n    id: string,\n    updates: Partial<OfflineTransaction>,\n  ): Promise<void> {\n    const existing = await this.get(id)\n    if (!existing) {\n      throw new OutboxTransactionNotFoundError(`Transaction ${id} not found`)\n    }\n    await this.add({ ...existing, ...updates })\n  }\n\n  async remove(id: string): Promise<void> {\n    const key = this.getStorageKey(id)\n    await this.storage.delete(key)\n    this.recordRemovals([id])\n  }\n\n  async removeMany(ids: Array<string>): Promise<void> {\n    await Promise.all(ids.map((id) => this.remove(id)))\n  }\n\n  async clear(): Promise<void> {\n    const keys = await this.storage.keys()\n    const transactionKeys = keys.filter((key) => key.startsWith(this.keyPrefix))\n\n    await this.removeMany(\n      transactionKeys.map((key) => key.slice(this.keyPrefix.length)),\n    )\n  }\n\n  async count(): Promise<number> {\n    const keys = await this.storage.keys()\n    return keys.filter((key) => key.startsWith(this.keyPrefix)).length\n  }\n}\n"],"names":["TransactionSerializer","MissingTemporalConstructorError"],"mappings":"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"}

package/dist/esm/OfflineExecutor.d.ts

@@ -19,6 +19,11 @@ export declare class OfflineExecutor {
     private initResolve;
     private initReject;
     private pendingTransactionPromises;
+    /**
+     * Ids this executor settled, oldest first. A waiter for one of them has
+     * nothing left to wait for. An unknown id can still arrive from another tab.
+     */
+    private readonly settledTransactions;
     private restorationTransactions;
     constructor(config: OfflineConfig);
     /**
@@ -39,6 +44,7 @@ export declare class OfflineExecutor {
     createOfflineTransaction(options: CreateOfflineTransactionOptions): Transaction | OfflineTransactionAPI;
     createOfflineAction<T>(options: CreateOfflineActionOptions<T>): (variables: T) => Transaction<Record<string, unknown>>;
     private persistTransaction;
+    private rememberSettled;
     waitForTransactionCompletion(transactionId: string): Promise<any>;
     resolveTransaction(transactionId: string, result: any): void;
     rejectTransaction(transactionId: string, error: Error): void;

package/dist/esm/OfflineExecutor.js

@@ -9,8 +9,8 @@ import { BroadcastChannelLeader } from "./coordination/BroadcastChannelLeader.js
 import { WebOnlineDetector } from "./connectivity/OnlineDetector.js";
 import { OfflineTransaction } from "./api/OfflineTransaction.js";
 import { createOfflineAction } from "./api/OfflineAction.js";
-import { withSpan, withNestedSpan } from "./telemetry/tracer.js";
 import { NonRetriableError } from "./types.js";
+const SETTLED_TRANSACTIONS_REMEMBERED = 1e3;
 let OfflineExecutor$1 = class OfflineExecutor {
   constructor(config) {
     this.isLeaderState = false;
@@ -18,6 +18,7 @@ let OfflineExecutor$1 = class OfflineExecutor {
     this.unsubscribeOnline = null;
     this.unsubscribeLeadership = null;
     this.pendingTransactionPromises = /* @__PURE__ */ new Map();
+    this.settledTransactions = /* @__PURE__ */ new Set();
     this.restorationTransactions = /* @__PURE__ */ new Map();
     this.config = config;
     this.scheduler = new KeyScheduler();
@@ -171,60 +172,50 @@ let OfflineExecutor$1 = class OfflineExecutor {
     });
   }
   async initialize() {
-    return withSpan(`executor.initialize`, {}, async (span) => {
-      try {
-        const { storage, diagnostic } = await this.createStorage();
-        if (this.disposed) {
-          this.initResolve();
-          return;
-        }
-        ;
-        this.storage = storage;
-        this.storageDiagnostic = diagnostic;
-        this.mode = diagnostic.mode;
-        span.setAttribute(`storage.mode`, diagnostic.mode);
-        span.setAttribute(`storage.code`, diagnostic.code);
-        if (!storage) {
-          if (this.config.onStorageFailure) {
-            this.config.onStorageFailure(diagnostic);
-          }
-          span.setAttribute(`result`, `online-only`);
-          this.initResolve();
-          return;
-        }
-        this.outbox = new OutboxManager(storage, this.config.collections);
-        this.executor = new TransactionExecutor(
-          this.scheduler,
-          this.outbox,
-          this.config,
-          this
-        );
-        this.leaderElection = this.createLeaderElection();
-        const isLeader = await this.leaderElection.requestLeadership();
-        if (this.disposed) {
-          this.leaderElection.releaseLeadership();
-          this.initResolve();
-          return;
-        }
-        this.isLeaderState = isLeader;
-        span.setAttribute(`isLeader`, isLeader);
-        this.setupEventListeners();
-        if (this.config.onLeadershipChange) {
-          this.config.onLeadershipChange(isLeader);
-        }
-        if (isLeader) {
-          await this.loadAndReplayTransactions();
+    try {
+      const { storage, diagnostic } = await this.createStorage();
+      if (this.disposed) {
+        this.initResolve();
+        return;
+      }
+      ;
+      this.storage = storage;
+      this.storageDiagnostic = diagnostic;
+      this.mode = diagnostic.mode;
+      if (!storage) {
+        if (this.config.onStorageFailure) {
+          this.config.onStorageFailure(diagnostic);
         }
-        span.setAttribute(`result`, `offline-enabled`);
         this.initResolve();
-      } catch (error) {
-        console.warn(`Failed to initialize offline executor:`, error);
-        span.setAttribute(`result`, `failed`);
-        this.initReject(
-          error instanceof Error ? error : new Error(String(error))
-        );
+        return;
       }
-    });
+      this.outbox = new OutboxManager(storage, this.config.collections);
+      this.executor = new TransactionExecutor(
+        this.scheduler,
+        this.outbox,
+        this.config,
+        this
+      );
+      this.leaderElection = this.createLeaderElection();
+      const isLeader = await this.leaderElection.requestLeadership();
+      if (this.disposed) {
+        this.leaderElection.releaseLeadership();
+        this.initResolve();
+        return;
+      }
+      this.isLeaderState = isLeader;
+      this.setupEventListeners();
+      if (this.config.onLeadershipChange) {
+        this.config.onLeadershipChange(isLeader);
+      }
+      if (isLeader) {
+        await this.loadAndReplayTransactions();
+      }
+      this.initResolve();
+    } catch (error) {
+      console.warn(`Failed to initialize offline executor:`, error);
+      this.initReject(error instanceof Error ? error : new Error(String(error)));
+    }
   }
   async loadAndReplayTransactions() {
     if (!this.executor) {
@@ -295,34 +286,29 @@ let OfflineExecutor$1 = class OfflineExecutor {
   }
   async persistTransaction(transaction) {
     await this.initPromise;
-    return withNestedSpan(
-      `executor.persistTransaction`,
-      {
-        "transaction.id": transaction.id,
-        "transaction.mutationFnName": transaction.mutationFnName
-      },
-      async (span) => {
-        if (!this.isOfflineEnabled || !this.outbox || !this.executor) {
-          span.setAttribute(`result`, `rejected_not_admitted`);
-          throw new NonRetriableError(`Offline transaction was not admitted`);
-        }
-        try {
-          this.executor.assertHealthy();
-          await this.outbox.add(transaction);
-          this.executor.execute(transaction).catch((error) => {
-            console.warn(`Failed to execute transactions:`, error);
-          });
-          span.setAttribute(`result`, `persisted`);
-        } catch (error) {
-          console.error(
-            `Failed to persist offline transaction ${transaction.id}:`,
-            error
-          );
-          span.setAttribute(`result`, `failed`);
-          throw error;
-        }
-      }
-    );
+    if (!this.isOfflineEnabled || !this.outbox || !this.executor) {
+      throw new NonRetriableError(`Offline transaction was not admitted`);
+    }
+    try {
+      this.executor.assertHealthy();
+      await this.outbox.add(transaction);
+      this.executor.execute(transaction).catch((error) => {
+        console.warn(`Failed to execute transactions:`, error);
+      });
+    } catch (error) {
+      console.error(
+        `Failed to persist offline transaction ${transaction.id}:`,
+        error
+      );
+      throw error;
+    }
+  }
+  rememberSettled(transactionId) {
+    this.settledTransactions.add(transactionId);
+    if (this.settledTransactions.size > SETTLED_TRANSACTIONS_REMEMBERED)
+      this.settledTransactions.delete(
+        this.settledTransactions.values().next().value
+      );
   }
   // Method for OfflineTransaction to wait for completion
   async waitForTransactionCompletion(transactionId) {
@@ -330,6 +316,10 @@ let OfflineExecutor$1 = class OfflineExecutor {
     if (existing) {
       return existing.promise;
     }
+    if (this.settledTransactions.has(transactionId))
+      throw new Error(
+        `Offline transaction ${transactionId} already settled; wait for it before it settles`
+      );
     const deferred = {};
     deferred.promise = new Promise((resolve, reject) => {
       deferred.resolve = resolve;
@@ -340,6 +330,7 @@ let OfflineExecutor$1 = class OfflineExecutor {
   }
   // Method for TransactionExecutor to signal completion
   resolveTransaction(transactionId, result) {
+    this.rememberSettled(transactionId);
     const deferred = this.pendingTransactionPromises.get(transactionId);
     if (deferred) {
       deferred.resolve(result);
@@ -349,6 +340,7 @@ let OfflineExecutor$1 = class OfflineExecutor {
   }
   // Method for TransactionExecutor to signal failure
   rejectTransaction(transactionId, error) {
+    this.rememberSettled(transactionId);
     const deferred = this.pendingTransactionPromises.get(transactionId);
     if (deferred) {
       deferred.reject(error);

package/dist/esm/OfflineExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"OfflineExecutor.js","sources":["../../src/OfflineExecutor.ts"],"sourcesContent":["// Storage adapters\nimport {\n  createOptimisticAction,\n  createTransaction,\n  safeRandomUUID,\n} from '@tanstack/db'\nimport { IndexedDBAdapter } from './storage/IndexedDBAdapter'\nimport { LocalStorageAdapter } from './storage/LocalStorageAdapter'\n\n// Core components\nimport { OutboxManager } from './outbox/OutboxManager'\nimport { KeyScheduler } from './executor/KeyScheduler'\nimport { TransactionExecutor } from './executor/TransactionExecutor'\n\n// Coordination\nimport { WebLocksLeader } from './coordination/WebLocksLeader'\nimport { BroadcastChannelLeader } from './coordination/BroadcastChannelLeader'\n\n// Connectivity\nimport { WebOnlineDetector } from './connectivity/OnlineDetector'\n\n// API\nimport { OfflineTransaction as OfflineTransactionAPI } from './api/OfflineTransaction'\nimport { createOfflineAction } from './api/OfflineAction'\n\n// TanStack DB primitives\n\n// Replay\nimport { withNestedSpan, withSpan } from './telemetry/tracer'\nimport { NonRetriableError } from './types'\nimport type {\n  CreateOfflineActionOptions,\n  CreateOfflineTransactionOptions,\n  LeaderElection,\n  OfflineConfig,\n  OfflineMode,\n  OfflineTransaction,\n  OnlineDetector,\n  StorageAdapter,\n  StorageDiagnostic,\n} from './types'\nimport type { Transaction } from '@tanstack/db'\n\nexport class OfflineExecutor {\n  private config: OfflineConfig\n\n  // @ts-expect-error - Set during async initialization in initialize()\n  private storage: StorageAdapter | null\n  private outbox: OutboxManager | null\n  private scheduler: KeyScheduler\n  private executor: TransactionExecutor | null\n  private leaderElection: LeaderElection | null\n  private onlineDetector: OnlineDetector\n  private isLeaderState = false\n  private disposed = false\n  private unsubscribeOnline: (() => void) | null = null\n  private unsubscribeLeadership: (() => void) | null = null\n\n  // Public diagnostic properties\n  public readonly mode: OfflineMode\n  public readonly storageDiagnostic: StorageDiagnostic\n\n  // Track initialization completion\n  private initPromise: Promise<void>\n  private initResolve!: () => void\n  private initReject!: (error: Error) => void\n\n  // Coordination mechanism for blocking transactions\n  private pendingTransactionPromises: Map<\n    string,\n    {\n      promise: Promise<any>\n      resolve: (result: any) => void\n      reject: (error: Error) => void\n    }\n  > = new Map()\n\n  // Track restoration transactions for cleanup when offline transactions complete\n  private restorationTransactions: Map<string, Transaction> = new Map()\n\n  constructor(config: OfflineConfig) {\n    this.config = config\n    this.scheduler = new KeyScheduler()\n    this.onlineDetector = config.onlineDetector ?? new WebOnlineDetector()\n\n    // Initialize as pending - will be set by async initialization\n    this.storage = null\n    this.outbox = null\n    this.executor = null\n    this.leaderElection = null\n\n    // Temporary diagnostic - will be updated by async initialization\n    this.mode = `offline`\n    this.storageDiagnostic = {\n      code: `STORAGE_AVAILABLE`,\n      mode: `offline`,\n      message: `Initializing storage...`,\n    }\n\n    // Create initialization promise\n    this.initPromise = new Promise((resolve, reject) => {\n      this.initResolve = resolve\n      this.initReject = reject\n    })\n    // Handle constructor-started rejection; waitForInit still observes it.\n    void this.initPromise.catch(() => {})\n    this.initialize()\n  }\n\n  /**\n   * Probe storage availability and create appropriate adapter.\n   * Returns null if no storage is available (online-only mode).\n   */\n  private async createStorage(): Promise<{\n    storage: StorageAdapter | null\n    diagnostic: StorageDiagnostic\n  }> {\n    // If user provided custom storage, use it without probing\n    if (this.config.storage) {\n      return {\n        storage: this.config.storage,\n        diagnostic: {\n          code: `STORAGE_AVAILABLE`,\n          mode: `offline`,\n          message: `Using custom storage adapter`,\n        },\n      }\n    }\n\n    // Probe IndexedDB first\n    const idbProbe = await IndexedDBAdapter.probe()\n    if (idbProbe.available) {\n      return {\n        storage: new IndexedDBAdapter(),\n        diagnostic: {\n          code: `STORAGE_AVAILABLE`,\n          mode: `offline`,\n          message: `Using IndexedDB for offline storage`,\n        },\n      }\n    }\n\n    // IndexedDB failed, try localStorage\n    const lsProbe = LocalStorageAdapter.probe()\n    if (lsProbe.available) {\n      return {\n        storage: new LocalStorageAdapter(),\n        diagnostic: {\n          code: `INDEXEDDB_UNAVAILABLE`,\n          mode: `offline`,\n          message: `IndexedDB unavailable, using localStorage fallback`,\n          error: idbProbe.error,\n        },\n      }\n    }\n\n    // Both failed - determine the diagnostic code\n    const isSecurityError =\n      idbProbe.error?.name === `SecurityError` ||\n      lsProbe.error?.name === `SecurityError`\n    const isQuotaError =\n      idbProbe.error?.name === `QuotaExceededError` ||\n      lsProbe.error?.name === `QuotaExceededError`\n\n    let code: StorageDiagnostic[`code`]\n    let message: string\n\n    if (isSecurityError) {\n      code = `STORAGE_BLOCKED`\n      message = `Storage blocked (private mode or security restrictions). Running in online-only mode.`\n    } else if (isQuotaError) {\n      code = `QUOTA_EXCEEDED`\n      message = `Storage quota exceeded. Running in online-only mode.`\n    } else {\n      code = `UNKNOWN_ERROR`\n      message = `Storage unavailable due to unknown error. Running in online-only mode.`\n    }\n\n    return {\n      storage: null,\n      diagnostic: {\n        code,\n        mode: `online-only`,\n        message,\n        error: idbProbe.error || lsProbe.error,\n      },\n    }\n  }\n\n  private createLeaderElection(): LeaderElection {\n    if (this.config.leaderElection) {\n      return this.config.leaderElection\n    }\n\n    if (WebLocksLeader.isSupported()) {\n      return new WebLocksLeader()\n    } else if (BroadcastChannelLeader.isSupported()) {\n      return new BroadcastChannelLeader()\n    } else {\n      // Fallback: always be leader in environments without multi-tab support\n      return {\n        requestLeadership: () => Promise.resolve(true),\n        releaseLeadership: () => {},\n        isLeader: () => true,\n        onLeadershipChange: () => () => {},\n      }\n    }\n  }\n\n  private setupEventListeners(): void {\n    // Only set up leader election listeners if we have storage\n    if (this.leaderElection) {\n      this.unsubscribeLeadership = this.leaderElection.onLeadershipChange(\n        (isLeader) => {\n          // A custom elector may repeat the initial result while replay is active.\n          if (this.disposed || isLeader === this.isLeaderState) return\n          this.isLeaderState = isLeader\n          if (!isLeader) this.executor?.pause()\n\n          if (this.config.onLeadershipChange) {\n            this.config.onLeadershipChange(isLeader)\n          }\n\n          if (isLeader) {\n            this.loadAndReplayTransactions().catch((error) => {\n              console.warn(`Failed to load and replay transactions:`, error)\n            })\n          }\n        },\n      )\n    }\n\n    this.unsubscribeOnline = this.onlineDetector.subscribe(() => {\n      if (this.isOfflineEnabled && this.executor) {\n        this.executor.resetRetryDelays()\n\n        if (this.scheduler.getPendingCount() > 0) {\n          const barrierPromise = this.executor.executeAll()\n\n          for (const collection of Object.values(this.config.collections)) {\n            collection.deferDataRefresh = barrierPromise\n          }\n\n          barrierPromise\n            .catch((error) => {\n              console.warn(\n                `Failed to execute transactions on connectivity change:`,\n                error,\n              )\n            })\n            .finally(() => {\n              for (const collection of Object.values(this.config.collections)) {\n                if (collection.deferDataRefresh === barrierPromise) {\n                  collection.deferDataRefresh = null\n                }\n              }\n            })\n        } else {\n          this.executor.executeAll().catch((error) => {\n            console.warn(\n              `Failed to execute transactions on connectivity change:`,\n              error,\n            )\n          })\n        }\n      }\n    })\n  }\n\n  private async initialize(): Promise<void> {\n    return withSpan(`executor.initialize`, {}, async (span) => {\n      try {\n        // Probe storage and create adapter\n        const { storage, diagnostic } = await this.createStorage()\n        if (this.disposed) {\n          this.initResolve()\n          return\n        }\n\n        // Cast to writable to set readonly properties\n        ;(this as any).storage = storage\n        ;(this as any).storageDiagnostic = diagnostic\n        ;(this as any).mode = diagnostic.mode\n\n        span.setAttribute(`storage.mode`, diagnostic.mode)\n        span.setAttribute(`storage.code`, diagnostic.code)\n\n        if (!storage) {\n          // Online-only mode - notify callback and skip offline setup\n          if (this.config.onStorageFailure) {\n            this.config.onStorageFailure(diagnostic)\n          }\n          span.setAttribute(`result`, `online-only`)\n          this.initResolve()\n          return\n        }\n\n        // Storage available - set up offline components\n        this.outbox = new OutboxManager(storage, this.config.collections)\n        this.executor = new TransactionExecutor(\n          this.scheduler,\n          this.outbox,\n          this.config,\n          this,\n        )\n        this.leaderElection = this.createLeaderElection()\n\n        // Request leadership first\n        const isLeader = await this.leaderElection.requestLeadership()\n        // Disposal may have run while leadership was pending.\n        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n        if (this.disposed) {\n          this.leaderElection.releaseLeadership()\n          this.initResolve()\n          return\n        }\n        this.isLeaderState = isLeader\n        span.setAttribute(`isLeader`, isLeader)\n\n        // Set up event listeners after leadership is established\n        // This prevents the callback from being called multiple times\n        this.setupEventListeners()\n\n        // Notify initial leadership state\n        if (this.config.onLeadershipChange) {\n          this.config.onLeadershipChange(isLeader)\n        }\n\n        if (isLeader) {\n          await this.loadAndReplayTransactions()\n        }\n        span.setAttribute(`result`, `offline-enabled`)\n        this.initResolve()\n      } catch (error) {\n        console.warn(`Failed to initialize offline executor:`, error)\n        span.setAttribute(`result`, `failed`)\n        this.initReject(\n          error instanceof Error ? error : new Error(String(error)),\n        )\n      }\n    })\n  }\n\n  private async loadAndReplayTransactions(): Promise<void> {\n    if (!this.executor) {\n      return\n    }\n\n    // Startup must observe a failed read instead of reporting an empty outbox.\n    await this.executor.loadPendingTransactions()\n\n    // Replay completion is separate from initialization and durable admission.\n    this.executor.executeAll().catch((error) => {\n      console.warn(`Failed to execute transactions:`, error)\n    })\n  }\n\n  get isOfflineEnabled(): boolean {\n    return !this.disposed && this.mode === `offline` && this.isLeaderState\n  }\n\n  /**\n   * Wait for the executor to fully initialize.\n   * This ensures that pending transactions are loaded and optimistic state is restored.\n   */\n  async waitForInit(): Promise<void> {\n    return this.initPromise\n  }\n\n  createOfflineTransaction(\n    options: CreateOfflineTransactionOptions,\n  ): Transaction | OfflineTransactionAPI {\n    const mutationFn = this.config.mutationFns[options.mutationFnName]\n\n    if (!mutationFn) {\n      throw new Error(`Unknown mutation function: ${options.mutationFnName}`)\n    }\n\n    // Check leadership immediately and use the appropriate primitive\n    if (!this.isOfflineEnabled) {\n      // Non-leader: use createTransaction directly with the resolved mutation function\n      // We need to wrap it to add the idempotency key\n      return createTransaction({\n        autoCommit: options.autoCommit ?? true,\n        mutationFn: (params) =>\n          mutationFn({\n            ...params,\n            idempotencyKey: options.idempotencyKey || safeRandomUUID(),\n          }),\n        metadata: options.metadata,\n      })\n    }\n\n    // Leader: use OfflineTransaction wrapper for offline persistence\n    return new OfflineTransactionAPI(\n      options,\n      mutationFn,\n      this.persistTransaction.bind(this),\n      this,\n    )\n  }\n\n  createOfflineAction<T>(options: CreateOfflineActionOptions<T>) {\n    const mutationFn = this.config.mutationFns[options.mutationFnName]\n\n    if (!mutationFn) {\n      throw new Error(`Unknown mutation function: ${options.mutationFnName}`)\n    }\n\n    // Return a wrapper that checks leadership status at call time\n    return (variables: T) => {\n      // Check leadership when action is called, not when it's created\n      if (!this.isOfflineEnabled) {\n        // Non-leader: use createOptimisticAction directly\n        const action = createOptimisticAction({\n          mutationFn: (vars, params) =>\n            mutationFn({\n              ...vars,\n              ...params,\n              idempotencyKey: safeRandomUUID(),\n            }),\n          onMutate: options.onMutate,\n        })\n        return action(variables)\n      }\n\n      // Leader: use the offline action wrapper\n      const action = createOfflineAction(\n        options,\n        mutationFn,\n        this.persistTransaction.bind(this),\n        this,\n      )\n      return action(variables)\n    }\n  }\n\n  private async persistTransaction(\n    transaction: OfflineTransaction,\n  ): Promise<void> {\n    // Wait for initialization to complete\n    await this.initPromise\n\n    return withNestedSpan(\n      `executor.persistTransaction`,\n      {\n        'transaction.id': transaction.id,\n        'transaction.mutationFnName': transaction.mutationFnName,\n      },\n      async (span) => {\n        if (!this.isOfflineEnabled || !this.outbox || !this.executor) {\n          span.setAttribute(`result`, `rejected_not_admitted`)\n          throw new NonRetriableError(`Offline transaction was not admitted`)\n        }\n\n        try {\n          this.executor.assertHealthy()\n          await this.outbox.add(transaction)\n          // A shared queue error belongs to its execution, not every caller\n          // that durably admitted a transaction. Per-ID signals settle callers.\n          this.executor.execute(transaction).catch((error) => {\n            console.warn(`Failed to execute transactions:`, error)\n          })\n          span.setAttribute(`result`, `persisted`)\n        } catch (error) {\n          console.error(\n            `Failed to persist offline transaction ${transaction.id}:`,\n            error,\n          )\n          span.setAttribute(`result`, `failed`)\n          throw error\n        }\n      },\n    )\n  }\n\n  // Method for OfflineTransaction to wait for completion\n  async waitForTransactionCompletion(transactionId: string): Promise<any> {\n    const existing = this.pendingTransactionPromises.get(transactionId)\n    if (existing) {\n      return existing.promise\n    }\n\n    const deferred: {\n      promise: Promise<any>\n      resolve: (result: any) => void\n      reject: (error: Error) => void\n    } = {} as any\n\n    deferred.promise = new Promise((resolve, reject) => {\n      deferred.resolve = resolve\n      deferred.reject = reject\n    })\n\n    this.pendingTransactionPromises.set(transactionId, deferred)\n    return deferred.promise\n  }\n\n  // Method for TransactionExecutor to signal completion\n  resolveTransaction(transactionId: string, result: any): void {\n    const deferred = this.pendingTransactionPromises.get(transactionId)\n    if (deferred) {\n      deferred.resolve(result)\n      this.pendingTransactionPromises.delete(transactionId)\n    }\n\n    // Clean up the restoration transaction - the sync will provide authoritative data\n    this.cleanupRestorationTransaction(transactionId)\n  }\n\n  // Method for TransactionExecutor to signal failure\n  rejectTransaction(transactionId: string, error: Error): void {\n    const deferred = this.pendingTransactionPromises.get(transactionId)\n    if (deferred) {\n      deferred.reject(error)\n      this.pendingTransactionPromises.delete(transactionId)\n    }\n\n    // Clean up the restoration transaction and rollback optimistic state\n    this.cleanupRestorationTransaction(transactionId, true)\n  }\n\n  // Method for TransactionExecutor to register restoration transactions\n  registerRestorationTransaction(\n    offlineTransactionId: string,\n    restorationTransaction: Transaction,\n  ): void {\n    this.restorationTransactions.set(\n      offlineTransactionId,\n      restorationTransaction,\n    )\n  }\n\n  private cleanupRestorationTransaction(\n    transactionId: string,\n    shouldRollback = false,\n  ): void {\n    const restorationTx = this.restorationTransactions.get(transactionId)\n    if (!restorationTx) {\n      return\n    }\n\n    this.restorationTransactions.delete(transactionId)\n\n    if (shouldRollback) {\n      restorationTx.rollback()\n      return\n    }\n\n    // Mark as completed: every Collection that tracked it recomputes and\n    // releases it. The actual data will come from the sync.\n    restorationTx.setState(`completed`)\n    restorationTx.isPersisted.resolve(restorationTx)\n    restorationTx.touchCollection()\n  }\n\n  async removeFromOutbox(id: string): Promise<void> {\n    if (!this.outbox) {\n      return\n    }\n    await this.outbox.remove(id)\n  }\n\n  async peekOutbox(): Promise<Array<OfflineTransaction>> {\n    if (!this.outbox) {\n      return []\n    }\n    return this.outbox.getAll()\n  }\n\n  async clearOutbox(): Promise<void> {\n    if (!this.outbox || !this.executor) {\n      return\n    }\n    await this.outbox.clear()\n    this.executor.clear()\n  }\n\n  getPendingCount(): number {\n    if (!this.executor) {\n      return 0\n    }\n    return this.executor.getPendingCount()\n  }\n\n  getRunningCount(): number {\n    if (!this.executor) {\n      return 0\n    }\n    return this.executor.getRunningCount()\n  }\n\n  getOnlineDetector(): OnlineDetector {\n    return this.onlineDetector\n  }\n\n  isOnline(): boolean {\n    return this.onlineDetector.isOnline()\n  }\n\n  dispose(): void {\n    this.disposed = true\n    this.executor?.pause()\n    for (const collection of Object.values(this.config.collections)) {\n      collection.deferDataRefresh = null\n    }\n\n    if (this.unsubscribeOnline) {\n      this.unsubscribeOnline()\n      this.unsubscribeOnline = null\n    }\n\n    if (this.unsubscribeLeadership) {\n      this.unsubscribeLeadership()\n      this.unsubscribeLeadership = null\n    }\n\n    if (this.leaderElection) {\n      this.leaderElection.releaseLeadership()\n\n      if (`dispose` in this.leaderElection) {\n        ;(this.leaderElection as any).dispose()\n      }\n    }\n\n    this.onlineDetector.dispose()\n  }\n}\n\nexport function startOfflineExecutor(config: OfflineConfig): OfflineExecutor {\n  return new OfflineExecutor(config)\n}\n"],"names":["OfflineTransactionAPI","action","OfflineExecutor"],"mappings":"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"}
+{"version":3,"file":"OfflineExecutor.js","sources":["../../src/OfflineExecutor.ts"],"sourcesContent":["// Storage adapters\nimport {\n  createOptimisticAction,\n  createTransaction,\n  safeRandomUUID,\n} from '@tanstack/db'\nimport { IndexedDBAdapter } from './storage/IndexedDBAdapter'\nimport { LocalStorageAdapter } from './storage/LocalStorageAdapter'\n\n// Core components\nimport { OutboxManager } from './outbox/OutboxManager'\nimport { KeyScheduler } from './executor/KeyScheduler'\nimport { TransactionExecutor } from './executor/TransactionExecutor'\n\n// Coordination\nimport { WebLocksLeader } from './coordination/WebLocksLeader'\nimport { BroadcastChannelLeader } from './coordination/BroadcastChannelLeader'\n\n// Connectivity\nimport { WebOnlineDetector } from './connectivity/OnlineDetector'\n\n// API\nimport { OfflineTransaction as OfflineTransactionAPI } from './api/OfflineTransaction'\nimport { createOfflineAction } from './api/OfflineAction'\n\n// TanStack DB primitives\n\n// Replay\nimport { NonRetriableError } from './types'\nimport type {\n  CreateOfflineActionOptions,\n  CreateOfflineTransactionOptions,\n  LeaderElection,\n  OfflineConfig,\n  OfflineMode,\n  OfflineTransaction,\n  OnlineDetector,\n  StorageAdapter,\n  StorageDiagnostic,\n} from './types'\nimport type { Transaction } from '@tanstack/db'\n\n/** How many settled ids an executor remembers to reject late waiters. */\nconst SETTLED_TRANSACTIONS_REMEMBERED = 1000\n\nexport class OfflineExecutor {\n  private config: OfflineConfig\n\n  // @ts-expect-error - Set during async initialization in initialize()\n  private storage: StorageAdapter | null\n  private outbox: OutboxManager | null\n  private scheduler: KeyScheduler\n  private executor: TransactionExecutor | null\n  private leaderElection: LeaderElection | null\n  private onlineDetector: OnlineDetector\n  private isLeaderState = false\n  private disposed = false\n  private unsubscribeOnline: (() => void) | null = null\n  private unsubscribeLeadership: (() => void) | null = null\n\n  // Public diagnostic properties\n  public readonly mode: OfflineMode\n  public readonly storageDiagnostic: StorageDiagnostic\n\n  // Track initialization completion\n  private initPromise: Promise<void>\n  private initResolve!: () => void\n  private initReject!: (error: Error) => void\n\n  // Coordination mechanism for blocking transactions\n  private pendingTransactionPromises: Map<\n    string,\n    {\n      promise: Promise<any>\n      resolve: (result: any) => void\n      reject: (error: Error) => void\n    }\n  > = new Map()\n\n  /**\n   * Ids this executor settled, oldest first. A waiter for one of them has\n   * nothing left to wait for. An unknown id can still arrive from another tab.\n   */\n  private readonly settledTransactions = new Set<string>()\n\n  // Track restoration transactions for cleanup when offline transactions complete\n  private restorationTransactions: Map<string, Transaction> = new Map()\n\n  constructor(config: OfflineConfig) {\n    this.config = config\n    this.scheduler = new KeyScheduler()\n    this.onlineDetector = config.onlineDetector ?? new WebOnlineDetector()\n\n    // Initialize as pending - will be set by async initialization\n    this.storage = null\n    this.outbox = null\n    this.executor = null\n    this.leaderElection = null\n\n    // Temporary diagnostic - will be updated by async initialization\n    this.mode = `offline`\n    this.storageDiagnostic = {\n      code: `STORAGE_AVAILABLE`,\n      mode: `offline`,\n      message: `Initializing storage...`,\n    }\n\n    // Create initialization promise\n    this.initPromise = new Promise((resolve, reject) => {\n      this.initResolve = resolve\n      this.initReject = reject\n    })\n    // Handle constructor-started rejection; waitForInit still observes it.\n    void this.initPromise.catch(() => {})\n    this.initialize()\n  }\n\n  /**\n   * Probe storage availability and create appropriate adapter.\n   * Returns null if no storage is available (online-only mode).\n   */\n  private async createStorage(): Promise<{\n    storage: StorageAdapter | null\n    diagnostic: StorageDiagnostic\n  }> {\n    // If user provided custom storage, use it without probing\n    if (this.config.storage) {\n      return {\n        storage: this.config.storage,\n        diagnostic: {\n          code: `STORAGE_AVAILABLE`,\n          mode: `offline`,\n          message: `Using custom storage adapter`,\n        },\n      }\n    }\n\n    // Probe IndexedDB first\n    const idbProbe = await IndexedDBAdapter.probe()\n    if (idbProbe.available) {\n      return {\n        storage: new IndexedDBAdapter(),\n        diagnostic: {\n          code: `STORAGE_AVAILABLE`,\n          mode: `offline`,\n          message: `Using IndexedDB for offline storage`,\n        },\n      }\n    }\n\n    // IndexedDB failed, try localStorage\n    const lsProbe = LocalStorageAdapter.probe()\n    if (lsProbe.available) {\n      return {\n        storage: new LocalStorageAdapter(),\n        diagnostic: {\n          code: `INDEXEDDB_UNAVAILABLE`,\n          mode: `offline`,\n          message: `IndexedDB unavailable, using localStorage fallback`,\n          error: idbProbe.error,\n        },\n      }\n    }\n\n    // Both failed - determine the diagnostic code\n    const isSecurityError =\n      idbProbe.error?.name === `SecurityError` ||\n      lsProbe.error?.name === `SecurityError`\n    const isQuotaError =\n      idbProbe.error?.name === `QuotaExceededError` ||\n      lsProbe.error?.name === `QuotaExceededError`\n\n    let code: StorageDiagnostic[`code`]\n    let message: string\n\n    if (isSecurityError) {\n      code = `STORAGE_BLOCKED`\n      message = `Storage blocked (private mode or security restrictions). Running in online-only mode.`\n    } else if (isQuotaError) {\n      code = `QUOTA_EXCEEDED`\n      message = `Storage quota exceeded. Running in online-only mode.`\n    } else {\n      code = `UNKNOWN_ERROR`\n      message = `Storage unavailable due to unknown error. Running in online-only mode.`\n    }\n\n    return {\n      storage: null,\n      diagnostic: {\n        code,\n        mode: `online-only`,\n        message,\n        error: idbProbe.error || lsProbe.error,\n      },\n    }\n  }\n\n  private createLeaderElection(): LeaderElection {\n    if (this.config.leaderElection) {\n      return this.config.leaderElection\n    }\n\n    if (WebLocksLeader.isSupported()) {\n      return new WebLocksLeader()\n    } else if (BroadcastChannelLeader.isSupported()) {\n      return new BroadcastChannelLeader()\n    } else {\n      // Fallback: always be leader in environments without multi-tab support\n      return {\n        requestLeadership: () => Promise.resolve(true),\n        releaseLeadership: () => {},\n        isLeader: () => true,\n        onLeadershipChange: () => () => {},\n      }\n    }\n  }\n\n  private setupEventListeners(): void {\n    // Only set up leader election listeners if we have storage\n    if (this.leaderElection) {\n      this.unsubscribeLeadership = this.leaderElection.onLeadershipChange(\n        (isLeader) => {\n          // A custom elector may repeat the initial result while replay is active.\n          if (this.disposed || isLeader === this.isLeaderState) return\n          this.isLeaderState = isLeader\n          if (!isLeader) this.executor?.pause()\n\n          if (this.config.onLeadershipChange) {\n            this.config.onLeadershipChange(isLeader)\n          }\n\n          if (isLeader) {\n            this.loadAndReplayTransactions().catch((error) => {\n              console.warn(`Failed to load and replay transactions:`, error)\n            })\n          }\n        },\n      )\n    }\n\n    this.unsubscribeOnline = this.onlineDetector.subscribe(() => {\n      if (this.isOfflineEnabled && this.executor) {\n        this.executor.resetRetryDelays()\n\n        if (this.scheduler.getPendingCount() > 0) {\n          const barrierPromise = this.executor.executeAll()\n\n          for (const collection of Object.values(this.config.collections)) {\n            collection.deferDataRefresh = barrierPromise\n          }\n\n          barrierPromise\n            .catch((error) => {\n              console.warn(\n                `Failed to execute transactions on connectivity change:`,\n                error,\n              )\n            })\n            .finally(() => {\n              for (const collection of Object.values(this.config.collections)) {\n                if (collection.deferDataRefresh === barrierPromise) {\n                  collection.deferDataRefresh = null\n                }\n              }\n            })\n        } else {\n          this.executor.executeAll().catch((error) => {\n            console.warn(\n              `Failed to execute transactions on connectivity change:`,\n              error,\n            )\n          })\n        }\n      }\n    })\n  }\n\n  private async initialize(): Promise<void> {\n    try {\n      // Probe storage and create adapter\n      const { storage, diagnostic } = await this.createStorage()\n      if (this.disposed) {\n        this.initResolve()\n        return\n      }\n\n      // Cast to writable to set readonly properties\n      ;(this as any).storage = storage\n      ;(this as any).storageDiagnostic = diagnostic\n      ;(this as any).mode = diagnostic.mode\n\n      if (!storage) {\n        // Online-only mode - notify callback and skip offline setup\n        if (this.config.onStorageFailure) {\n          this.config.onStorageFailure(diagnostic)\n        }\n        this.initResolve()\n        return\n      }\n\n      // Storage available - set up offline components\n      this.outbox = new OutboxManager(storage, this.config.collections)\n      this.executor = new TransactionExecutor(\n        this.scheduler,\n        this.outbox,\n        this.config,\n        this,\n      )\n      this.leaderElection = this.createLeaderElection()\n\n      // Request leadership first\n      const isLeader = await this.leaderElection.requestLeadership()\n      // Disposal may have run while leadership was pending.\n      // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n      if (this.disposed) {\n        this.leaderElection.releaseLeadership()\n        this.initResolve()\n        return\n      }\n      this.isLeaderState = isLeader\n\n      // Set up event listeners after leadership is established\n      // This prevents the callback from being called multiple times\n      this.setupEventListeners()\n\n      // Notify initial leadership state\n      if (this.config.onLeadershipChange) {\n        this.config.onLeadershipChange(isLeader)\n      }\n\n      if (isLeader) {\n        await this.loadAndReplayTransactions()\n      }\n      this.initResolve()\n    } catch (error) {\n      console.warn(`Failed to initialize offline executor:`, error)\n      this.initReject(error instanceof Error ? error : new Error(String(error)))\n    }\n  }\n\n  private async loadAndReplayTransactions(): Promise<void> {\n    if (!this.executor) {\n      return\n    }\n\n    // Startup must observe a failed read instead of reporting an empty outbox.\n    await this.executor.loadPendingTransactions()\n\n    // Replay completion is separate from initialization and durable admission.\n    this.executor.executeAll().catch((error) => {\n      console.warn(`Failed to execute transactions:`, error)\n    })\n  }\n\n  get isOfflineEnabled(): boolean {\n    return !this.disposed && this.mode === `offline` && this.isLeaderState\n  }\n\n  /**\n   * Wait for the executor to fully initialize.\n   * This ensures that pending transactions are loaded and optimistic state is restored.\n   */\n  async waitForInit(): Promise<void> {\n    return this.initPromise\n  }\n\n  createOfflineTransaction(\n    options: CreateOfflineTransactionOptions,\n  ): Transaction | OfflineTransactionAPI {\n    const mutationFn = this.config.mutationFns[options.mutationFnName]\n\n    if (!mutationFn) {\n      throw new Error(`Unknown mutation function: ${options.mutationFnName}`)\n    }\n\n    // Check leadership immediately and use the appropriate primitive\n    if (!this.isOfflineEnabled) {\n      // Non-leader: use createTransaction directly with the resolved mutation function\n      // We need to wrap it to add the idempotency key\n      return createTransaction({\n        autoCommit: options.autoCommit ?? true,\n        mutationFn: (params) =>\n          mutationFn({\n            ...params,\n            idempotencyKey: options.idempotencyKey || safeRandomUUID(),\n          }),\n        metadata: options.metadata,\n      })\n    }\n\n    // Leader: use OfflineTransaction wrapper for offline persistence\n    return new OfflineTransactionAPI(\n      options,\n      mutationFn,\n      this.persistTransaction.bind(this),\n      this,\n    )\n  }\n\n  createOfflineAction<T>(options: CreateOfflineActionOptions<T>) {\n    const mutationFn = this.config.mutationFns[options.mutationFnName]\n\n    if (!mutationFn) {\n      throw new Error(`Unknown mutation function: ${options.mutationFnName}`)\n    }\n\n    // Return a wrapper that checks leadership status at call time\n    return (variables: T) => {\n      // Check leadership when action is called, not when it's created\n      if (!this.isOfflineEnabled) {\n        // Non-leader: use createOptimisticAction directly\n        const action = createOptimisticAction({\n          mutationFn: (vars, params) =>\n            mutationFn({\n              ...vars,\n              ...params,\n              idempotencyKey: safeRandomUUID(),\n            }),\n          onMutate: options.onMutate,\n        })\n        return action(variables)\n      }\n\n      // Leader: use the offline action wrapper\n      const action = createOfflineAction(\n        options,\n        mutationFn,\n        this.persistTransaction.bind(this),\n        this,\n      )\n      return action(variables)\n    }\n  }\n\n  private async persistTransaction(\n    transaction: OfflineTransaction,\n  ): Promise<void> {\n    // Wait for initialization to complete\n    await this.initPromise\n\n    if (!this.isOfflineEnabled || !this.outbox || !this.executor) {\n      throw new NonRetriableError(`Offline transaction was not admitted`)\n    }\n\n    try {\n      this.executor.assertHealthy()\n      await this.outbox.add(transaction)\n      // A shared queue error belongs to its execution, not every caller\n      // that durably admitted a transaction. Per-ID signals settle callers.\n      this.executor.execute(transaction).catch((error) => {\n        console.warn(`Failed to execute transactions:`, error)\n      })\n    } catch (error) {\n      console.error(\n        `Failed to persist offline transaction ${transaction.id}:`,\n        error,\n      )\n      throw error\n    }\n  }\n\n  private rememberSettled(transactionId: string): void {\n    this.settledTransactions.add(transactionId)\n    if (this.settledTransactions.size > SETTLED_TRANSACTIONS_REMEMBERED)\n      this.settledTransactions.delete(\n        this.settledTransactions.values().next().value!,\n      )\n  }\n\n  // Method for OfflineTransaction to wait for completion\n  async waitForTransactionCompletion(transactionId: string): Promise<any> {\n    const existing = this.pendingTransactionPromises.get(transactionId)\n    if (existing) {\n      return existing.promise\n    }\n    if (this.settledTransactions.has(transactionId))\n      throw new Error(\n        `Offline transaction ${transactionId} already settled; wait for it before it settles`,\n      )\n\n    const deferred: {\n      promise: Promise<any>\n      resolve: (result: any) => void\n      reject: (error: Error) => void\n    } = {} as any\n\n    deferred.promise = new Promise((resolve, reject) => {\n      deferred.resolve = resolve\n      deferred.reject = reject\n    })\n\n    this.pendingTransactionPromises.set(transactionId, deferred)\n    return deferred.promise\n  }\n\n  // Method for TransactionExecutor to signal completion\n  resolveTransaction(transactionId: string, result: any): void {\n    this.rememberSettled(transactionId)\n    const deferred = this.pendingTransactionPromises.get(transactionId)\n    if (deferred) {\n      deferred.resolve(result)\n      this.pendingTransactionPromises.delete(transactionId)\n    }\n\n    // Clean up the restoration transaction - the sync will provide authoritative data\n    this.cleanupRestorationTransaction(transactionId)\n  }\n\n  // Method for TransactionExecutor to signal failure\n  rejectTransaction(transactionId: string, error: Error): void {\n    this.rememberSettled(transactionId)\n    const deferred = this.pendingTransactionPromises.get(transactionId)\n    if (deferred) {\n      deferred.reject(error)\n      this.pendingTransactionPromises.delete(transactionId)\n    }\n\n    // Clean up the restoration transaction and rollback optimistic state\n    this.cleanupRestorationTransaction(transactionId, true)\n  }\n\n  // Method for TransactionExecutor to register restoration transactions\n  registerRestorationTransaction(\n    offlineTransactionId: string,\n    restorationTransaction: Transaction,\n  ): void {\n    this.restorationTransactions.set(\n      offlineTransactionId,\n      restorationTransaction,\n    )\n  }\n\n  private cleanupRestorationTransaction(\n    transactionId: string,\n    shouldRollback = false,\n  ): void {\n    const restorationTx = this.restorationTransactions.get(transactionId)\n    if (!restorationTx) {\n      return\n    }\n\n    this.restorationTransactions.delete(transactionId)\n\n    if (shouldRollback) {\n      restorationTx.rollback()\n      return\n    }\n\n    // Mark as completed: every Collection that tracked it recomputes and\n    // releases it. The actual data will come from the sync.\n    restorationTx.setState(`completed`)\n    restorationTx.isPersisted.resolve(restorationTx)\n    restorationTx.touchCollection()\n  }\n\n  async removeFromOutbox(id: string): Promise<void> {\n    if (!this.outbox) {\n      return\n    }\n    await this.outbox.remove(id)\n  }\n\n  async peekOutbox(): Promise<Array<OfflineTransaction>> {\n    if (!this.outbox) {\n      return []\n    }\n    return this.outbox.getAll()\n  }\n\n  async clearOutbox(): Promise<void> {\n    if (!this.outbox || !this.executor) {\n      return\n    }\n    await this.outbox.clear()\n    this.executor.clear()\n  }\n\n  getPendingCount(): number {\n    if (!this.executor) {\n      return 0\n    }\n    return this.executor.getPendingCount()\n  }\n\n  getRunningCount(): number {\n    if (!this.executor) {\n      return 0\n    }\n    return this.executor.getRunningCount()\n  }\n\n  getOnlineDetector(): OnlineDetector {\n    return this.onlineDetector\n  }\n\n  isOnline(): boolean {\n    return this.onlineDetector.isOnline()\n  }\n\n  dispose(): void {\n    this.disposed = true\n    this.executor?.pause()\n    for (const collection of Object.values(this.config.collections)) {\n      collection.deferDataRefresh = null\n    }\n\n    if (this.unsubscribeOnline) {\n      this.unsubscribeOnline()\n      this.unsubscribeOnline = null\n    }\n\n    if (this.unsubscribeLeadership) {\n      this.unsubscribeLeadership()\n      this.unsubscribeLeadership = null\n    }\n\n    if (this.leaderElection) {\n      this.leaderElection.releaseLeadership()\n\n      if (`dispose` in this.leaderElection) {\n        ;(this.leaderElection as any).dispose()\n      }\n    }\n\n    this.onlineDetector.dispose()\n  }\n}\n\nexport function startOfflineExecutor(config: OfflineConfig): OfflineExecutor {\n  return new OfflineExecutor(config)\n}\n"],"names":["OfflineTransactionAPI","action","OfflineExecutor"],"mappings":"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"}

package/dist/esm/api/OfflineAction.js

@@ -5,35 +5,24 @@ function isPromiseLike(value) {
 }
 function createOfflineAction(options, mutationFn, persistTransaction, executor) {
   const { mutationFnName, onMutate } = options;
-  console.log(`createOfflineAction 2`, options);
   return (variables) => {
     const offlineTransaction = new OfflineTransaction(
       {
         mutationFnName,
-        autoCommit: false
+        // The transaction commits after onMutate and reports a failure
+        // through `when('settled')`.
+        autoCommit: true
       },
       mutationFn,
       persistTransaction,
       executor
     );
-    const transaction = offlineTransaction.mutate(() => {
-      console.log(`mutate`);
+    return offlineTransaction.mutate(() => {
       const maybePromise = onMutate(variables);
       if (isPromiseLike(maybePromise)) {
         throw new OnMutateMustBeSynchronousError();
       }
     });
-    const commitPromise = (async () => {
-      try {
-        await transaction.commit();
-        console.log(`offlineAction committed - success`);
-      } catch {
-        console.log(`offlineAction commit failed - error`);
-      }
-    })();
-    commitPromise.catch(() => {
-    });
-    return transaction;
   };
 }
 export {

package/dist/esm/api/OfflineAction.js.map

@@ -1 +1 @@
-{"version":3,"file":"OfflineAction.js","sources":["../../../src/api/OfflineAction.ts"],"sourcesContent":["import { OnMutateMustBeSynchronousError } from '@tanstack/db'\nimport { OfflineTransaction } from './OfflineTransaction'\nimport type { Transaction } from '@tanstack/db'\nimport type {\n  CreateOfflineActionOptions,\n  OfflineMutationFn,\n  OfflineTransaction as OfflineTransactionType,\n} from '../types'\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return (\n    !!value &&\n    (typeof value === `object` || typeof value === `function`) &&\n    typeof (value as { then?: unknown }).then === `function`\n  )\n}\n\nexport function createOfflineAction<T>(\n  options: CreateOfflineActionOptions<T>,\n  mutationFn: OfflineMutationFn,\n  persistTransaction: (tx: OfflineTransactionType) => Promise<void>,\n  executor: any,\n): (variables: T) => Transaction {\n  const { mutationFnName, onMutate } = options\n  console.log(`createOfflineAction 2`, options)\n\n  return (variables: T): Transaction => {\n    const offlineTransaction = new OfflineTransaction(\n      {\n        mutationFnName,\n        autoCommit: false,\n      },\n      mutationFn,\n      persistTransaction,\n      executor,\n    )\n\n    const transaction = offlineTransaction.mutate(() => {\n      console.log(`mutate`)\n      const maybePromise = onMutate(variables) as unknown\n\n      if (isPromiseLike(maybePromise)) {\n        throw new OnMutateMustBeSynchronousError()\n      }\n    })\n\n    // Immediately commit\n    const commitPromise = (async () => {\n      try {\n        await transaction.commit()\n        console.log(`offlineAction committed - success`)\n      } catch {\n        console.log(`offlineAction commit failed - error`)\n      }\n    })()\n\n    // Don't await - this is fire-and-forget for optimistic actions\n    // But catch to prevent unhandled rejection\n    commitPromise.catch(() => {\n      // Already handled in try/catch above\n    })\n\n    return transaction\n  }\n}\n"],"names":[],"mappings":";;AASA,SAAS,cAAc,OAA+C;AACpE,SACE,CAAC,CAAC,UACD,OAAO,UAAU,YAAY,OAAO,UAAU,eAC/C,OAAQ,MAA6B,SAAS;AAElD;AAEO,SAAS,oBACd,SACA,YACA,oBACA,UAC+B;AAC/B,QAAM,EAAE,gBAAgB,SAAA,IAAa;AACrC,UAAQ,IAAI,yBAAyB,OAAO;AAE5C,SAAO,CAAC,cAA8B;AACpC,UAAM,qBAAqB,IAAI;AAAA,MAC7B;AAAA,QACE;AAAA,QACA,YAAY;AAAA,MAAA;AAAA,MAEd;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAGF,UAAM,cAAc,mBAAmB,OAAO,MAAM;AAClD,cAAQ,IAAI,QAAQ;AACpB,YAAM,eAAe,SAAS,SAAS;AAEvC,UAAI,cAAc,YAAY,GAAG;AAC/B,cAAM,IAAI,+BAAA;AAAA,MACZ;AAAA,IACF,CAAC;AAGD,UAAM,iBAAiB,YAAY;AACjC,UAAI;AACF,cAAM,YAAY,OAAA;AAClB,gBAAQ,IAAI,mCAAmC;AAAA,MACjD,QAAQ;AACN,gBAAQ,IAAI,qCAAqC;AAAA,MACnD;AAAA,IACF,GAAA;AAIA,kBAAc,MAAM,MAAM;AAAA,IAE1B,CAAC;AAED,WAAO;AAAA,EACT;AACF;"}
+{"version":3,"file":"OfflineAction.js","sources":["../../../src/api/OfflineAction.ts"],"sourcesContent":["import { OnMutateMustBeSynchronousError } from '@tanstack/db'\nimport { OfflineTransaction } from './OfflineTransaction'\nimport type { Transaction } from '@tanstack/db'\nimport type {\n  CreateOfflineActionOptions,\n  OfflineMutationFn,\n  OfflineTransaction as OfflineTransactionType,\n} from '../types'\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<unknown> {\n  return (\n    !!value &&\n    (typeof value === `object` || typeof value === `function`) &&\n    typeof (value as { then?: unknown }).then === `function`\n  )\n}\n\nexport function createOfflineAction<T>(\n  options: CreateOfflineActionOptions<T>,\n  mutationFn: OfflineMutationFn,\n  persistTransaction: (tx: OfflineTransactionType) => Promise<void>,\n  executor: any,\n): (variables: T) => Transaction {\n  const { mutationFnName, onMutate } = options\n\n  return (variables: T): Transaction => {\n    const offlineTransaction = new OfflineTransaction(\n      {\n        mutationFnName,\n        // The transaction commits after onMutate and reports a failure\n        // through `when('settled')`.\n        autoCommit: true,\n      },\n      mutationFn,\n      persistTransaction,\n      executor,\n    )\n\n    return offlineTransaction.mutate(() => {\n      const maybePromise = onMutate(variables) as unknown\n\n      if (isPromiseLike(maybePromise)) {\n        throw new OnMutateMustBeSynchronousError()\n      }\n    })\n  }\n}\n"],"names":[],"mappings":";;AASA,SAAS,cAAc,OAA+C;AACpE,SACE,CAAC,CAAC,UACD,OAAO,UAAU,YAAY,OAAO,UAAU,eAC/C,OAAQ,MAA6B,SAAS;AAElD;AAEO,SAAS,oBACd,SACA,YACA,oBACA,UAC+B;AAC/B,QAAM,EAAE,gBAAgB,SAAA,IAAa;AAErC,SAAO,CAAC,cAA8B;AACpC,UAAM,qBAAqB,IAAI;AAAA,MAC7B;AAAA,QACE;AAAA;AAAA;AAAA,QAGA,YAAY;AAAA,MAAA;AAAA,MAEd;AAAA,MACA;AAAA,MACA;AAAA,IAAA;AAGF,WAAO,mBAAmB,OAAO,MAAM;AACrC,YAAM,eAAe,SAAS,SAAS;AAEvC,UAAI,cAAc,YAAY,GAAG;AAC/B,cAAM,IAAI,+BAAA;AAAA,MACZ;AAAA,IACF,CAAC;AAAA,EACH;AACF;"}

package/dist/esm/api/OfflineTransaction.d.ts

@@ -7,6 +7,8 @@ export declare class OfflineTransaction {
     private idempotencyKey;
     private metadata;
     private transaction;
+    /** The mutation function ran, so the executor settles the waiter. */
+    private persisting;
     private persistTransaction;
     private executor;
     constructor(options: CreateOfflineTransactionOptions, mutationFn: OfflineMutationFn, persistTransaction: (tx: OfflineTransactionType) => Promise<void>, executor: any);