@tanstack/offline-transactions 1.0.54 → 1.0.58

package/dist/cjs/executor/KeyScheduler.cjs

@@ -4,20 +4,25 @@ const tracer = require("../telemetry/tracer.cjs");
 class KeyScheduler {
   constructor() {
     this.pendingTransactions = [];
-    this.isRunning = false;
   }
   schedule(transaction) {
-    tracer.withSyncSpan(
+    return tracer.withSyncSpan(
       `scheduler.schedule`,
       {
         "transaction.id": transaction.id,
         queueLength: this.pendingTransactions.length
       },
       () => {
+        if (this.pendingTransactions.some(
+          (pending) => pending.id === transaction.id
+        )) {
+          return false;
+        }
         this.pendingTransactions.push(transaction);
         this.pendingTransactions.sort(
           (a, b) => a.createdAt.getTime() - b.createdAt.getTime()
         );
+        return true;
       }
     );
   }
@@ -26,7 +31,7 @@ class KeyScheduler {
       `scheduler.getNext`,
       { pendingCount: this.pendingTransactions.length },
       (span) => {
-        if (this.isRunning || this.pendingTransactions.length === 0) {
+        if (this.activeTransactionId !== void 0 || this.pendingTransactions.length === 0) {
           span.setAttribute(`result`, `empty`);
           return void 0;
         }
@@ -45,15 +50,15 @@ class KeyScheduler {
   isReadyToRun(transaction) {
     return Date.now() >= transaction.nextAttemptAt;
   }
-  markStarted(_transaction) {
-    this.isRunning = true;
+  markStarted(transaction) {
+    this.activeTransactionId = transaction.id;
   }
   markCompleted(transaction) {
     this.removeTransaction(transaction);
-    this.isRunning = false;
+    this.activeTransactionId = void 0;
   }
   markFailed(_transaction) {
-    this.isRunning = false;
+    this.activeTransactionId = void 0;
   }
   removeTransaction(transaction) {
     const index = this.pendingTransactions.findIndex(
@@ -64,38 +69,38 @@ class KeyScheduler {
     }
   }
   updateTransaction(transaction) {
-    const index = this.pendingTransactions.findIndex(
-      (tx) => tx.id === transaction.id
-    );
-    if (index >= 0) {
-      this.pendingTransactions[index] = transaction;
-      this.pendingTransactions.sort(
-        (a, b) => a.createdAt.getTime() - b.createdAt.getTime()
-      );
-    }
+    this.updateTransactions([transaction]);
   }
   getPendingCount() {
     return this.pendingTransactions.length;
   }
   getRunningCount() {
-    return this.isRunning ? 1 : 0;
+    return this.activeTransactionId === void 0 ? 0 : 1;
   }
   clear() {
     this.pendingTransactions = [];
-    this.isRunning = false;
+    this.activeTransactionId = void 0;
+  }
+  /** @internal Reconcile one replay snapshot without canceling issued work. */
+  removePendingTransactions(transactionIds) {
+    const ids = new Set(transactionIds);
+    if (this.activeTransactionId !== void 0)
+      ids.delete(this.activeTransactionId);
+    this.pendingTransactions = this.pendingTransactions.filter(
+      ({ id }) => !ids.has(id)
+    );
+    return [...ids];
   }
   getAllPendingTransactions() {
     return [...this.pendingTransactions];
   }
   updateTransactions(updatedTransactions) {
-    for (const updatedTx of updatedTransactions) {
-      const index = this.pendingTransactions.findIndex(
-        (tx) => tx.id === updatedTx.id
-      );
-      if (index >= 0) {
-        this.pendingTransactions[index] = updatedTx;
-      }
-    }
+    const updatedById = new Map(
+      updatedTransactions.map((transaction) => [transaction.id, transaction])
+    );
+    this.pendingTransactions = this.pendingTransactions.map(
+      (transaction) => updatedById.get(transaction.id) ?? transaction
+    );
     this.pendingTransactions.sort(
       (a, b) => a.createdAt.getTime() - b.createdAt.getTime()
     );

package/dist/cjs/executor/KeyScheduler.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"KeyScheduler.cjs","sources":["../../../src/executor/KeyScheduler.ts"],"sourcesContent":["import { withSyncSpan } from '../telemetry/tracer'\nimport type { OfflineTransaction } from '../types'\n\nexport class KeyScheduler {\n  private pendingTransactions: Array<OfflineTransaction> = []\n  private isRunning = false\n\n  schedule(transaction: OfflineTransaction): void {\n    withSyncSpan(\n      `scheduler.schedule`,\n      {\n        'transaction.id': transaction.id,\n        queueLength: this.pendingTransactions.length,\n      },\n      () => {\n        this.pendingTransactions.push(transaction)\n        // Sort by creation time to maintain FIFO order\n        this.pendingTransactions.sort(\n          (a, b) => a.createdAt.getTime() - b.createdAt.getTime(),\n        )\n      },\n    )\n  }\n\n  getNext(): OfflineTransaction | undefined {\n    return withSyncSpan(\n      `scheduler.getNext`,\n      { pendingCount: this.pendingTransactions.length },\n      (span) => {\n        if (this.isRunning || this.pendingTransactions.length === 0) {\n          span.setAttribute(`result`, `empty`)\n          return undefined\n        }\n\n        const firstTransaction = this.pendingTransactions[0]!\n\n        if (!this.isReadyToRun(firstTransaction)) {\n          span.setAttribute(`result`, `waiting_for_first`)\n          span.setAttribute(`transaction.id`, firstTransaction.id)\n          return undefined\n        }\n\n        span.setAttribute(`result`, `found`)\n        span.setAttribute(`transaction.id`, firstTransaction.id)\n        return firstTransaction\n      },\n    )\n  }\n\n  private isReadyToRun(transaction: OfflineTransaction): boolean {\n    return Date.now() >= transaction.nextAttemptAt\n  }\n\n  markStarted(_transaction: OfflineTransaction): void {\n    this.isRunning = true\n  }\n\n  markCompleted(transaction: OfflineTransaction): void {\n    this.removeTransaction(transaction)\n    this.isRunning = false\n  }\n\n  markFailed(_transaction: OfflineTransaction): void {\n    this.isRunning = false\n  }\n\n  private removeTransaction(transaction: OfflineTransaction): void {\n    const index = this.pendingTransactions.findIndex(\n      (tx) => tx.id === transaction.id,\n    )\n    if (index >= 0) {\n      this.pendingTransactions.splice(index, 1)\n    }\n  }\n\n  updateTransaction(transaction: OfflineTransaction): void {\n    const index = this.pendingTransactions.findIndex(\n      (tx) => tx.id === transaction.id,\n    )\n    if (index >= 0) {\n      this.pendingTransactions[index] = transaction\n      // Re-sort to maintain FIFO order after update\n      this.pendingTransactions.sort(\n        (a, b) => a.createdAt.getTime() - b.createdAt.getTime(),\n      )\n    }\n  }\n\n  getPendingCount(): number {\n    return this.pendingTransactions.length\n  }\n\n  getRunningCount(): number {\n    return this.isRunning ? 1 : 0\n  }\n\n  clear(): void {\n    this.pendingTransactions = []\n    this.isRunning = false\n  }\n\n  getAllPendingTransactions(): Array<OfflineTransaction> {\n    return [...this.pendingTransactions]\n  }\n\n  updateTransactions(updatedTransactions: Array<OfflineTransaction>): void {\n    for (const updatedTx of updatedTransactions) {\n      const index = this.pendingTransactions.findIndex(\n        (tx) => tx.id === updatedTx.id,\n      )\n      if (index >= 0) {\n        this.pendingTransactions[index] = updatedTx\n      }\n    }\n    // Re-sort to maintain FIFO order after updates\n    this.pendingTransactions.sort(\n      (a, b) => a.createdAt.getTime() - b.createdAt.getTime(),\n    )\n  }\n}\n"],"names":["withSyncSpan"],"mappings":";;;AAGO,MAAM,aAAa;AAAA,EAAnB,cAAA;AACL,SAAQ,sBAAiD,CAAA;AACzD,SAAQ,YAAY;AAAA,EAAA;AAAA,EAEpB,SAAS,aAAuC;AAC9CA,WAAAA;AAAAA,MACE;AAAA,MACA;AAAA,QACE,kBAAkB,YAAY;AAAA,QAC9B,aAAa,KAAK,oBAAoB;AAAA,MAAA;AAAA,MAExC,MAAM;AACJ,aAAK,oBAAoB,KAAK,WAAW;AAEzC,aAAK,oBAAoB;AAAA,UACvB,CAAC,GAAG,MAAM,EAAE,UAAU,YAAY,EAAE,UAAU,QAAA;AAAA,QAAQ;AAAA,MAE1D;AAAA,IAAA;AAAA,EAEJ;AAAA,EAEA,UAA0C;AACxC,WAAOA,OAAAA;AAAAA,MACL;AAAA,MACA,EAAE,cAAc,KAAK,oBAAoB,OAAA;AAAA,MACzC,CAAC,SAAS;AACR,YAAI,KAAK,aAAa,KAAK,oBAAoB,WAAW,GAAG;AAC3D,eAAK,aAAa,UAAU,OAAO;AACnC,iBAAO;AAAA,QACT;AAEA,cAAM,mBAAmB,KAAK,oBAAoB,CAAC;AAEnD,YAAI,CAAC,KAAK,aAAa,gBAAgB,GAAG;AACxC,eAAK,aAAa,UAAU,mBAAmB;AAC/C,eAAK,aAAa,kBAAkB,iBAAiB,EAAE;AACvD,iBAAO;AAAA,QACT;AAEA,aAAK,aAAa,UAAU,OAAO;AACnC,aAAK,aAAa,kBAAkB,iBAAiB,EAAE;AACvD,eAAO;AAAA,MACT;AAAA,IAAA;AAAA,EAEJ;AAAA,EAEQ,aAAa,aAA0C;AAC7D,WAAO,KAAK,SAAS,YAAY;AAAA,EACnC;AAAA,EAEA,YAAY,cAAwC;AAClD,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,cAAc,aAAuC;AACnD,SAAK,kBAAkB,WAAW;AAClC,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,WAAW,cAAwC;AACjD,SAAK,YAAY;AAAA,EACnB;AAAA,EAEQ,kBAAkB,aAAuC;AAC/D,UAAM,QAAQ,KAAK,oBAAoB;AAAA,MACrC,CAAC,OAAO,GAAG,OAAO,YAAY;AAAA,IAAA;AAEhC,QAAI,SAAS,GAAG;AACd,WAAK,oBAAoB,OAAO,OAAO,CAAC;AAAA,IAC1C;AAAA,EACF;AAAA,EAEA,kBAAkB,aAAuC;AACvD,UAAM,QAAQ,KAAK,oBAAoB;AAAA,MACrC,CAAC,OAAO,GAAG,OAAO,YAAY;AAAA,IAAA;AAEhC,QAAI,SAAS,GAAG;AACd,WAAK,oBAAoB,KAAK,IAAI;AAElC,WAAK,oBAAoB;AAAA,QACvB,CAAC,GAAG,MAAM,EAAE,UAAU,YAAY,EAAE,UAAU,QAAA;AAAA,MAAQ;AAAA,IAE1D;AAAA,EACF;AAAA,EAEA,kBAA0B;AACxB,WAAO,KAAK,oBAAoB;AAAA,EAClC;AAAA,EAEA,kBAA0B;AACxB,WAAO,KAAK,YAAY,IAAI;AAAA,EAC9B;AAAA,EAEA,QAAc;AACZ,SAAK,sBAAsB,CAAA;AAC3B,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,4BAAuD;AACrD,WAAO,CAAC,GAAG,KAAK,mBAAmB;AAAA,EACrC;AAAA,EAEA,mBAAmB,qBAAsD;AACvE,eAAW,aAAa,qBAAqB;AAC3C,YAAM,QAAQ,KAAK,oBAAoB;AAAA,QACrC,CAAC,OAAO,GAAG,OAAO,UAAU;AAAA,MAAA;AAE9B,UAAI,SAAS,GAAG;AACd,aAAK,oBAAoB,KAAK,IAAI;AAAA,MACpC;AAAA,IACF;AAEA,SAAK,oBAAoB;AAAA,MACvB,CAAC,GAAG,MAAM,EAAE,UAAU,YAAY,EAAE,UAAU,QAAA;AAAA,IAAQ;AAAA,EAE1D;AACF;;"}
+{"version":3,"file":"KeyScheduler.cjs","sources":["../../../src/executor/KeyScheduler.ts"],"sourcesContent":["import { withSyncSpan } from '../telemetry/tracer'\nimport type { OfflineTransaction } from '../types'\n\nexport class KeyScheduler {\n  private pendingTransactions: Array<OfflineTransaction> = []\n  private activeTransactionId: string | undefined\n\n  schedule(transaction: OfflineTransaction): boolean {\n    return withSyncSpan(\n      `scheduler.schedule`,\n      {\n        'transaction.id': transaction.id,\n        queueLength: this.pendingTransactions.length,\n      },\n      () => {\n        if (\n          this.pendingTransactions.some(\n            (pending) => pending.id === transaction.id,\n          )\n        ) {\n          return false\n        }\n        this.pendingTransactions.push(transaction)\n        // Sort by creation time to maintain FIFO order\n        this.pendingTransactions.sort(\n          (a, b) => a.createdAt.getTime() - b.createdAt.getTime(),\n        )\n        return true\n      },\n    )\n  }\n\n  getNext(): OfflineTransaction | undefined {\n    return withSyncSpan(\n      `scheduler.getNext`,\n      { pendingCount: this.pendingTransactions.length },\n      (span) => {\n        if (\n          this.activeTransactionId !== undefined ||\n          this.pendingTransactions.length === 0\n        ) {\n          span.setAttribute(`result`, `empty`)\n          return undefined\n        }\n\n        const firstTransaction = this.pendingTransactions[0]!\n\n        if (!this.isReadyToRun(firstTransaction)) {\n          span.setAttribute(`result`, `waiting_for_first`)\n          span.setAttribute(`transaction.id`, firstTransaction.id)\n          return undefined\n        }\n\n        span.setAttribute(`result`, `found`)\n        span.setAttribute(`transaction.id`, firstTransaction.id)\n        return firstTransaction\n      },\n    )\n  }\n\n  private isReadyToRun(transaction: OfflineTransaction): boolean {\n    return Date.now() >= transaction.nextAttemptAt\n  }\n\n  markStarted(transaction: OfflineTransaction): void {\n    this.activeTransactionId = transaction.id\n  }\n\n  markCompleted(transaction: OfflineTransaction): void {\n    this.removeTransaction(transaction)\n    this.activeTransactionId = undefined\n  }\n\n  markFailed(_transaction: OfflineTransaction): void {\n    this.activeTransactionId = undefined\n  }\n\n  private removeTransaction(transaction: OfflineTransaction): void {\n    const index = this.pendingTransactions.findIndex(\n      (tx) => tx.id === transaction.id,\n    )\n    if (index >= 0) {\n      this.pendingTransactions.splice(index, 1)\n    }\n  }\n\n  updateTransaction(transaction: OfflineTransaction): void {\n    this.updateTransactions([transaction])\n  }\n\n  getPendingCount(): number {\n    return this.pendingTransactions.length\n  }\n\n  getRunningCount(): number {\n    return this.activeTransactionId === undefined ? 0 : 1\n  }\n\n  clear(): void {\n    this.pendingTransactions = []\n    this.activeTransactionId = undefined\n  }\n\n  /** @internal Reconcile one replay snapshot without canceling issued work. */\n  removePendingTransactions(transactionIds: Iterable<string>): Array<string> {\n    const ids = new Set(transactionIds)\n    if (this.activeTransactionId !== undefined)\n      ids.delete(this.activeTransactionId)\n    this.pendingTransactions = this.pendingTransactions.filter(\n      ({ id }) => !ids.has(id),\n    )\n    return [...ids]\n  }\n\n  getAllPendingTransactions(): Array<OfflineTransaction> {\n    return [...this.pendingTransactions]\n  }\n\n  updateTransactions(updatedTransactions: Array<OfflineTransaction>): void {\n    const updatedById = new Map(\n      updatedTransactions.map((transaction) => [transaction.id, transaction]),\n    )\n    this.pendingTransactions = this.pendingTransactions.map(\n      (transaction) => updatedById.get(transaction.id) ?? transaction,\n    )\n    // Re-sort to maintain FIFO order after updates\n    this.pendingTransactions.sort(\n      (a, b) => a.createdAt.getTime() - b.createdAt.getTime(),\n    )\n  }\n}\n"],"names":["withSyncSpan"],"mappings":"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"}

package/dist/cjs/executor/KeyScheduler.d.cts

@@ -1,11 +1,11 @@
 import { OfflineTransaction } from '../types.cjs';
 export declare class KeyScheduler {
     private pendingTransactions;
-    private isRunning;
-    schedule(transaction: OfflineTransaction): void;
+    private activeTransactionId;
+    schedule(transaction: OfflineTransaction): boolean;
     getNext(): OfflineTransaction | undefined;
     private isReadyToRun;
-    markStarted(_transaction: OfflineTransaction): void;
+    markStarted(transaction: OfflineTransaction): void;
     markCompleted(transaction: OfflineTransaction): void;
     markFailed(_transaction: OfflineTransaction): void;
     private removeTransaction;
@@ -13,6 +13,8 @@ export declare class KeyScheduler {
     getPendingCount(): number;
     getRunningCount(): number;
     clear(): void;
+    /** @internal Reconcile one replay snapshot without canceling issued work. */
+    removePendingTransactions(transactionIds: Iterable<string>): Array<string>;
     getAllPendingTransactions(): Array<OfflineTransaction>;
     updateTransactions(updatedTransactions: Array<OfflineTransaction>): void;
 }

package/dist/cjs/executor/TransactionExecutor.cjs

@@ -34,11 +34,12 @@ class TransactionExecutor {
     } finally {
       this.isExecuting = false;
       this.executionPromise = null;
+      this.scheduleNextRetry();
     }
   }
   async runExecution() {
     while (this.scheduler.getPendingCount() > 0) {
-      if (!this.isOnline()) {
+      if (!this.canExecute()) {
         break;
       }
       const transaction = this.scheduler.getNext();
@@ -47,7 +48,6 @@ class TransactionExecutor {
       }
       await this.executeTransaction(transaction);
     }
-    this.scheduleNextRetry();
   }
   async executeTransaction(transaction) {
     try {
@@ -64,12 +64,9 @@ class TransactionExecutor {
           if (transaction.retryCount > 0) {
             span.setAttribute(`retry.attempt`, transaction.retryCount);
           }
+          let result;
           try {
-            const result = await this.runMutationFn(transaction);
-            this.scheduler.markCompleted(transaction);
-            await this.outbox.remove(transaction.id);
-            span.setAttribute(`result`, `success`);
-            this.offlineExecutor.resolveTransaction(transaction.id, result);
+            result = await this.runMutationFn(transaction);
           } catch (error) {
             const err = error instanceof Error ? error : new Error(String(error));
             span.setAttribute(`result`, `error`);
@@ -77,6 +74,17 @@ class TransactionExecutor {
             err[HANDLED_EXECUTION_ERROR] = true;
             throw err;
           }
+          let removalError;
+          try {
+            await this.outbox.remove(transaction.id);
+          } catch (error) {
+            removalError = error;
+          } finally {
+            this.scheduler.markCompleted(transaction);
+          }
+          span.setAttribute(`result`, `success`);
+          this.offlineExecutor.resolveTransaction(transaction.id, result);
+          if (removalError !== void 0) throw removalError;
         }
       );
     } catch (error) {
@@ -120,14 +128,21 @@ class TransactionExecutor {
         );
         span.setAttribute(`shouldRetry`, shouldRetry);
         if (!shouldRetry) {
-          this.scheduler.markCompleted(transaction);
-          await this.outbox.remove(transaction.id);
+          let removalError;
+          try {
+            await this.outbox.remove(transaction.id);
+          } catch (cleanupError) {
+            removalError = cleanupError;
+          } finally {
+            this.scheduler.markCompleted(transaction);
+          }
           console.warn(
             `Transaction ${transaction.id} failed permanently:`,
             error
           );
           span.setAttribute(`result`, `permanent_failure`);
           this.offlineExecutor.rejectTransaction(transaction.id, error);
+          if (removalError !== void 0) throw removalError;
           return;
         }
         const delay = Math.max(
@@ -146,7 +161,6 @@ class TransactionExecutor {
         };
         span.setAttribute(`retryDelay`, delay);
         span.setAttribute(`nextRetryCount`, updatedTransaction.retryCount);
-        this.scheduler.markFailed(transaction);
         this.scheduler.updateTransaction(updatedTransaction);
         try {
           await this.outbox.update(transaction.id, updatedTransaction);
@@ -155,28 +169,48 @@ class TransactionExecutor {
           span.recordException(persistError);
           span.setAttribute(`result`, `persist_failed`);
           throw persistError;
+        } finally {
+          this.scheduler.markFailed(transaction);
         }
-        this.scheduleNextRetry();
       }
     );
   }
   async loadPendingTransactions() {
-    const transactions = await this.outbox.getAll();
-    let filteredTransactions = transactions;
-    if (this.config.beforeRetry) {
-      filteredTransactions = this.config.beforeRetry(transactions);
-    }
-    for (const transaction of filteredTransactions) {
-      this.scheduler.schedule(transaction);
-    }
-    this.restoreOptimisticState(filteredTransactions);
-    this.resetRetryDelays();
-    this.scheduleNextRetry();
-    const removedTransactions = transactions.filter(
-      (tx) => !filteredTransactions.some((filtered) => filtered.id === tx.id)
-    );
-    if (removedTransactions.length > 0) {
-      await this.outbox.removeMany(removedTransactions.map((tx) => tx.id));
+    let removedIds = [];
+    await this.outbox.withAll((transactions) => {
+      const { isOfflineEnabled } = this.offlineExecutor;
+      if (!isOfflineEnabled) return;
+      let filteredTransactions = transactions;
+      if (this.config.beforeRetry) {
+        filteredTransactions = this.config.beforeRetry(transactions);
+      }
+      if (!this.offlineExecutor.isOfflineEnabled) return;
+      const newlyLoaded = filteredTransactions.filter(
+        (transaction) => this.scheduler.schedule(transaction)
+      );
+      const retainedIds = new Set(filteredTransactions.map(({ id }) => id));
+      removedIds = transactions.filter(({ id }) => !retainedIds.has(id)).map(({ id }) => id);
+      removedIds = this.scheduler.removePendingTransactions(removedIds);
+      this.restoreOptimisticState(newlyLoaded);
+      this.resetRetryDelays();
+      this.scheduleNextRetry();
+    });
+    if (removedIds.length > 0) {
+      const error = new types.NonRetriableError(`Transaction excluded by beforeRetry`);
+      await Promise.all(
+        removedIds.map(async (id) => {
+          try {
+            await this.outbox.remove(id);
+            this.offlineExecutor.rejectTransaction(id, error);
+          } catch (cleanupError) {
+            console.warn(
+              `Failed to remove transaction excluded by beforeRetry:`,
+              id,
+              cleanupError
+            );
+          }
+        })
+      );
     }
   }
   /**
@@ -231,31 +265,34 @@ class TransactionExecutor {
     this.scheduler.clear();
     this.clearRetryTimer();
   }
+  pause() {
+    this.clearRetryTimer();
+  }
   getPendingCount() {
     return this.scheduler.getPendingCount();
   }
   scheduleNextRetry() {
     this.clearRetryTimer();
-    if (!this.isOnline()) {
+    if (!this.canExecute()) {
       return;
     }
-    const earliestRetryTime = this.getEarliestRetryTime();
-    if (earliestRetryTime === null) {
+    const nextRetryTime = this.getNextRetryTime();
+    if (nextRetryTime === null) {
       return;
     }
-    const delay = Math.max(0, earliestRetryTime - Date.now());
+    const delay = Math.max(0, nextRetryTime - Date.now());
     this.retryTimer = setTimeout(() => {
       this.executeAll().catch((error) => {
         console.warn(`Failed to execute retry batch:`, error);
       });
     }, delay);
   }
-  getEarliestRetryTime() {
+  getNextRetryTime() {
     const allTransactions = this.scheduler.getAllPendingTransactions();
     if (allTransactions.length === 0) {
       return null;
     }
-    return Math.min(...allTransactions.map((tx) => tx.nextAttemptAt));
+    return allTransactions[0].nextAttemptAt;
   }
   clearRetryTimer() {
     if (this.retryTimer) {
@@ -263,8 +300,8 @@ class TransactionExecutor {
       this.retryTimer = null;
     }
   }
-  isOnline() {
-    return this.offlineExecutor.isOnline();
+  canExecute() {
+    return this.offlineExecutor.isOfflineEnabled && this.offlineExecutor.isOnline();
   }
   getRunningCount() {
     return this.scheduler.getRunningCount();

package/dist/cjs/executor/TransactionExecutor.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"TransactionExecutor.cjs","sources":["../../../src/executor/TransactionExecutor.ts"],"sourcesContent":["import { createTransaction } from '@tanstack/db'\nimport { DefaultRetryPolicy } from '../retry/RetryPolicy'\nimport { NonRetriableError } from '../types'\nimport { withNestedSpan } from '../telemetry/tracer'\nimport type { KeyScheduler } from './KeyScheduler'\nimport type { OutboxManager } from '../outbox/OutboxManager'\nimport type {\n  OfflineConfig,\n  OfflineTransaction,\n  TransactionSignaler,\n} from '../types'\n\nconst HANDLED_EXECUTION_ERROR = Symbol(`HandledExecutionError`)\n\nexport class TransactionExecutor {\n  private scheduler: KeyScheduler\n  private outbox: OutboxManager\n  private config: OfflineConfig\n  private retryPolicy: DefaultRetryPolicy\n  private isExecuting = false\n  private executionPromise: Promise<void> | null = null\n  private offlineExecutor: TransactionSignaler\n  private retryTimer: ReturnType<typeof setTimeout> | null = null\n\n  constructor(\n    scheduler: KeyScheduler,\n    outbox: OutboxManager,\n    config: OfflineConfig,\n    offlineExecutor: TransactionSignaler,\n  ) {\n    this.scheduler = scheduler\n    this.outbox = outbox\n    this.config = config\n    this.retryPolicy = new DefaultRetryPolicy(\n      Number.POSITIVE_INFINITY,\n      config.jitter ?? true,\n    )\n    this.offlineExecutor = offlineExecutor\n  }\n\n  async execute(transaction: OfflineTransaction): Promise<void> {\n    this.scheduler.schedule(transaction)\n    await this.executeAll()\n  }\n\n  async executeAll(): Promise<void> {\n    if (this.isExecuting) {\n      return this.executionPromise!\n    }\n\n    this.isExecuting = true\n    this.executionPromise = this.runExecution()\n\n    try {\n      await this.executionPromise\n    } finally {\n      this.isExecuting = false\n      this.executionPromise = null\n    }\n  }\n\n  private async runExecution(): Promise<void> {\n    while (this.scheduler.getPendingCount() > 0) {\n      if (!this.isOnline()) {\n        break\n      }\n\n      const transaction = this.scheduler.getNext()\n\n      if (!transaction) {\n        break\n      }\n\n      await this.executeTransaction(transaction)\n    }\n\n    // Schedule next retry after execution completes\n    this.scheduleNextRetry()\n  }\n\n  private async executeTransaction(\n    transaction: OfflineTransaction,\n  ): Promise<void> {\n    try {\n      await withNestedSpan(\n        `transaction.execute`,\n        {\n          'transaction.id': transaction.id,\n          'transaction.mutationFnName': transaction.mutationFnName,\n          'transaction.retryCount': transaction.retryCount,\n          'transaction.keyCount': transaction.keys.length,\n        },\n        async (span) => {\n          this.scheduler.markStarted(transaction)\n\n          if (transaction.retryCount > 0) {\n            span.setAttribute(`retry.attempt`, transaction.retryCount)\n          }\n\n          try {\n            const result = await this.runMutationFn(transaction)\n\n            this.scheduler.markCompleted(transaction)\n            await this.outbox.remove(transaction.id)\n\n            span.setAttribute(`result`, `success`)\n            this.offlineExecutor.resolveTransaction(transaction.id, result)\n          } catch (error) {\n            const err =\n              error instanceof Error ? error : new Error(String(error))\n\n            span.setAttribute(`result`, `error`)\n\n            await this.handleError(transaction, err)\n            ;(err as any)[HANDLED_EXECUTION_ERROR] = true\n            throw err\n          }\n        },\n      )\n    } catch (error) {\n      if (\n        error instanceof Error &&\n        (error as any)[HANDLED_EXECUTION_ERROR] === true\n      ) {\n        return\n      }\n\n      throw error\n    }\n  }\n\n  private async runMutationFn(transaction: OfflineTransaction): Promise<void> {\n    const mutationFn = this.config.mutationFns[transaction.mutationFnName]\n\n    if (!mutationFn) {\n      const errorMessage = `Unknown mutation function: ${transaction.mutationFnName}`\n\n      if (this.config.onUnknownMutationFn) {\n        this.config.onUnknownMutationFn(transaction.mutationFnName, transaction)\n      }\n\n      throw new NonRetriableError(errorMessage)\n    }\n\n    // Mutations are already PendingMutation objects with collections attached\n    // from the deserializer, so we can use them directly\n    const transactionWithMutations = {\n      id: transaction.id,\n      mutations: transaction.mutations,\n      metadata: transaction.metadata ?? {},\n    }\n\n    await mutationFn({\n      transaction: transactionWithMutations as any,\n      idempotencyKey: transaction.idempotencyKey,\n    })\n  }\n\n  private async handleError(\n    transaction: OfflineTransaction,\n    error: Error,\n  ): Promise<void> {\n    return withNestedSpan(\n      `transaction.handleError`,\n      {\n        'transaction.id': transaction.id,\n        'error.name': error.name,\n        'error.message': error.message,\n      },\n      async (span) => {\n        const shouldRetry = this.retryPolicy.shouldRetry(\n          error,\n          transaction.retryCount,\n        )\n\n        span.setAttribute(`shouldRetry`, shouldRetry)\n\n        if (!shouldRetry) {\n          this.scheduler.markCompleted(transaction)\n          await this.outbox.remove(transaction.id)\n          console.warn(\n            `Transaction ${transaction.id} failed permanently:`,\n            error,\n          )\n\n          span.setAttribute(`result`, `permanent_failure`)\n          // Signal permanent failure to the waiting transaction\n          this.offlineExecutor.rejectTransaction(transaction.id, error)\n          return\n        }\n\n        const delay = Math.max(\n          0,\n          this.retryPolicy.calculateDelay(transaction.retryCount),\n        )\n        const updatedTransaction: OfflineTransaction = {\n          ...transaction,\n          retryCount: transaction.retryCount + 1,\n          nextAttemptAt: Date.now() + delay,\n          lastError: {\n            name: error.name,\n            message: error.message,\n            stack: error.stack,\n          },\n        }\n\n        span.setAttribute(`retryDelay`, delay)\n        span.setAttribute(`nextRetryCount`, updatedTransaction.retryCount)\n\n        this.scheduler.markFailed(transaction)\n        this.scheduler.updateTransaction(updatedTransaction)\n\n        try {\n          await this.outbox.update(transaction.id, updatedTransaction)\n          span.setAttribute(`result`, `scheduled_retry`)\n        } catch (persistError) {\n          span.recordException(persistError as Error)\n          span.setAttribute(`result`, `persist_failed`)\n          throw persistError\n        }\n\n        // Schedule retry timer\n        this.scheduleNextRetry()\n      },\n    )\n  }\n\n  async loadPendingTransactions(): Promise<void> {\n    const transactions = await this.outbox.getAll()\n    let filteredTransactions = transactions\n\n    if (this.config.beforeRetry) {\n      filteredTransactions = this.config.beforeRetry(transactions)\n    }\n\n    for (const transaction of filteredTransactions) {\n      this.scheduler.schedule(transaction)\n    }\n\n    // Restore optimistic state for loaded transactions\n    // This ensures the UI shows the optimistic data while transactions are pending\n    this.restoreOptimisticState(filteredTransactions)\n\n    // Reset retry delays for all loaded transactions so they can run immediately\n    this.resetRetryDelays()\n\n    // Schedule retry timer for loaded transactions\n    this.scheduleNextRetry()\n\n    const removedTransactions = transactions.filter(\n      (tx) => !filteredTransactions.some((filtered) => filtered.id === tx.id),\n    )\n\n    if (removedTransactions.length > 0) {\n      await this.outbox.removeMany(removedTransactions.map((tx) => tx.id))\n    }\n  }\n\n  /**\n   * Restore optimistic state from loaded transactions.\n   * Creates internal transactions to hold the mutations so the collection's\n   * state manager can show optimistic data while waiting for sync.\n   */\n  private restoreOptimisticState(\n    transactions: Array<OfflineTransaction>,\n  ): void {\n    for (const offlineTx of transactions) {\n      if (offlineTx.mutations.length === 0) {\n        continue\n      }\n\n      try {\n        // Create a restoration transaction that holds mutations for optimistic state display.\n        // It will never commit - the real mutation is handled by the offline executor.\n        const restorationTx = createTransaction({\n          id: offlineTx.id,\n          autoCommit: false,\n          mutationFn: async () => {},\n        })\n\n        // Prevent unhandled promise rejection when cleanup calls rollback()\n        // We don't care about this promise - it's just for holding mutations\n        restorationTx.isPersisted.promise.catch(() => {\n          // Intentionally ignored - restoration transactions are cleaned up\n          // via cleanupRestorationTransaction, not through normal commit flow\n        })\n\n        restorationTx.applyMutations(offlineTx.mutations)\n\n        // Register with each affected collection's state manager\n        const touchedCollections = new Set<string>()\n        for (const mutation of offlineTx.mutations) {\n          // Defensive check for corrupted deserialized data\n          // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n          if (!mutation.collection) {\n            continue\n          }\n          const collectionId = mutation.collection.id\n          if (touchedCollections.has(collectionId)) {\n            continue\n          }\n          touchedCollections.add(collectionId)\n\n          mutation.collection._state.transactions.set(\n            restorationTx.id,\n            restorationTx,\n          )\n          mutation.collection._state.recomputeOptimisticState(true)\n        }\n\n        this.offlineExecutor.registerRestorationTransaction(\n          offlineTx.id,\n          restorationTx,\n        )\n      } catch (error) {\n        console.warn(\n          `Failed to restore optimistic state for transaction ${offlineTx.id}:`,\n          error,\n        )\n      }\n    }\n  }\n\n  clear(): void {\n    this.scheduler.clear()\n    this.clearRetryTimer()\n  }\n\n  getPendingCount(): number {\n    return this.scheduler.getPendingCount()\n  }\n\n  private scheduleNextRetry(): void {\n    // Clear existing timer\n    this.clearRetryTimer()\n\n    if (!this.isOnline()) {\n      return\n    }\n\n    // Find the earliest retry time among pending transactions\n    const earliestRetryTime = this.getEarliestRetryTime()\n\n    if (earliestRetryTime === null) {\n      return // No transactions pending retry\n    }\n\n    const delay = Math.max(0, earliestRetryTime - Date.now())\n\n    this.retryTimer = setTimeout(() => {\n      this.executeAll().catch((error) => {\n        console.warn(`Failed to execute retry batch:`, error)\n      })\n    }, delay)\n  }\n\n  private getEarliestRetryTime(): number | null {\n    const allTransactions = this.scheduler.getAllPendingTransactions()\n\n    if (allTransactions.length === 0) {\n      return null\n    }\n\n    return Math.min(...allTransactions.map((tx) => tx.nextAttemptAt))\n  }\n\n  private clearRetryTimer(): void {\n    if (this.retryTimer) {\n      clearTimeout(this.retryTimer)\n      this.retryTimer = null\n    }\n  }\n\n  private isOnline(): boolean {\n    return this.offlineExecutor.isOnline()\n  }\n\n  getRunningCount(): number {\n    return this.scheduler.getRunningCount()\n  }\n\n  resetRetryDelays(): void {\n    const allTransactions = this.scheduler.getAllPendingTransactions()\n    const updatedTransactions = allTransactions.map((transaction) => ({\n      ...transaction,\n      nextAttemptAt: Date.now(),\n    }))\n\n    this.scheduler.updateTransactions(updatedTransactions)\n  }\n}\n"],"names":["DefaultRetryPolicy","withNestedSpan","NonRetriableError","createTransaction"],"mappings":"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"}
+{"version":3,"file":"TransactionExecutor.cjs","sources":["../../../src/executor/TransactionExecutor.ts"],"sourcesContent":["import { createTransaction } from '@tanstack/db'\nimport { DefaultRetryPolicy } from '../retry/RetryPolicy'\nimport { NonRetriableError } from '../types'\nimport { withNestedSpan } from '../telemetry/tracer'\nimport type { KeyScheduler } from './KeyScheduler'\nimport type { OutboxManager } from '../outbox/OutboxManager'\nimport type {\n  OfflineConfig,\n  OfflineTransaction,\n  TransactionSignaler,\n} from '../types'\n\nconst HANDLED_EXECUTION_ERROR = Symbol(`HandledExecutionError`)\n\nexport class TransactionExecutor {\n  private scheduler: KeyScheduler\n  private outbox: OutboxManager\n  private config: OfflineConfig\n  private retryPolicy: DefaultRetryPolicy\n  private isExecuting = false\n  private executionPromise: Promise<void> | null = null\n  private offlineExecutor: TransactionSignaler\n  private retryTimer: ReturnType<typeof setTimeout> | null = null\n\n  constructor(\n    scheduler: KeyScheduler,\n    outbox: OutboxManager,\n    config: OfflineConfig,\n    offlineExecutor: TransactionSignaler,\n  ) {\n    this.scheduler = scheduler\n    this.outbox = outbox\n    this.config = config\n    this.retryPolicy = new DefaultRetryPolicy(\n      Number.POSITIVE_INFINITY,\n      config.jitter ?? true,\n    )\n    this.offlineExecutor = offlineExecutor\n  }\n\n  async execute(transaction: OfflineTransaction): Promise<void> {\n    this.scheduler.schedule(transaction)\n    await this.executeAll()\n  }\n\n  async executeAll(): Promise<void> {\n    if (this.isExecuting) {\n      return this.executionPromise!\n    }\n\n    this.isExecuting = true\n    this.executionPromise = this.runExecution()\n\n    try {\n      await this.executionPromise\n    } finally {\n      this.isExecuting = false\n      this.executionPromise = null\n      this.scheduleNextRetry()\n    }\n  }\n\n  private async runExecution(): Promise<void> {\n    while (this.scheduler.getPendingCount() > 0) {\n      if (!this.canExecute()) {\n        break\n      }\n\n      const transaction = this.scheduler.getNext()\n\n      if (!transaction) {\n        break\n      }\n\n      await this.executeTransaction(transaction)\n    }\n  }\n\n  private async executeTransaction(\n    transaction: OfflineTransaction,\n  ): Promise<void> {\n    try {\n      await withNestedSpan(\n        `transaction.execute`,\n        {\n          'transaction.id': transaction.id,\n          'transaction.mutationFnName': transaction.mutationFnName,\n          'transaction.retryCount': transaction.retryCount,\n          'transaction.keyCount': transaction.keys.length,\n        },\n        async (span) => {\n          this.scheduler.markStarted(transaction)\n\n          if (transaction.retryCount > 0) {\n            span.setAttribute(`retry.attempt`, transaction.retryCount)\n          }\n\n          let result: void\n          try {\n            result = await this.runMutationFn(transaction)\n          } catch (error) {\n            const err =\n              error instanceof Error ? error : new Error(String(error))\n\n            span.setAttribute(`result`, `error`)\n\n            await this.handleError(transaction, err)\n            ;(err as any)[HANDLED_EXECUTION_ERROR] = true\n            throw err\n          }\n\n          let removalError: unknown\n          try {\n            // Replay can still see this ID until durable deletion settles.\n            await this.outbox.remove(transaction.id)\n          } catch (error) {\n            removalError = error\n          } finally {\n            this.scheduler.markCompleted(transaction)\n          }\n\n          span.setAttribute(`result`, `success`)\n          this.offlineExecutor.resolveTransaction(transaction.id, result)\n          if (removalError !== undefined) throw removalError\n        },\n      )\n    } catch (error) {\n      if (\n        error instanceof Error &&\n        (error as any)[HANDLED_EXECUTION_ERROR] === true\n      ) {\n        return\n      }\n\n      throw error\n    }\n  }\n\n  private async runMutationFn(transaction: OfflineTransaction): Promise<void> {\n    const mutationFn = this.config.mutationFns[transaction.mutationFnName]\n\n    if (!mutationFn) {\n      const errorMessage = `Unknown mutation function: ${transaction.mutationFnName}`\n\n      if (this.config.onUnknownMutationFn) {\n        this.config.onUnknownMutationFn(transaction.mutationFnName, transaction)\n      }\n\n      throw new NonRetriableError(errorMessage)\n    }\n\n    // Mutations are already PendingMutation objects with collections attached\n    // from the deserializer, so we can use them directly\n    const transactionWithMutations = {\n      id: transaction.id,\n      mutations: transaction.mutations,\n      metadata: transaction.metadata ?? {},\n    }\n\n    await mutationFn({\n      transaction: transactionWithMutations as any,\n      idempotencyKey: transaction.idempotencyKey,\n    })\n  }\n\n  private async handleError(\n    transaction: OfflineTransaction,\n    error: Error,\n  ): Promise<void> {\n    return withNestedSpan(\n      `transaction.handleError`,\n      {\n        'transaction.id': transaction.id,\n        'error.name': error.name,\n        'error.message': error.message,\n      },\n      async (span) => {\n        const shouldRetry = this.retryPolicy.shouldRetry(\n          error,\n          transaction.retryCount,\n        )\n\n        span.setAttribute(`shouldRetry`, shouldRetry)\n\n        if (!shouldRetry) {\n          let removalError: unknown\n          try {\n            await this.outbox.remove(transaction.id)\n          } catch (cleanupError) {\n            removalError = cleanupError\n          } finally {\n            this.scheduler.markCompleted(transaction)\n          }\n          console.warn(\n            `Transaction ${transaction.id} failed permanently:`,\n            error,\n          )\n\n          span.setAttribute(`result`, `permanent_failure`)\n          // Signal permanent failure to the waiting transaction\n          this.offlineExecutor.rejectTransaction(transaction.id, error)\n          if (removalError !== undefined) throw removalError\n          return\n        }\n\n        const delay = Math.max(\n          0,\n          this.retryPolicy.calculateDelay(transaction.retryCount),\n        )\n        const updatedTransaction: OfflineTransaction = {\n          ...transaction,\n          retryCount: transaction.retryCount + 1,\n          nextAttemptAt: Date.now() + delay,\n          lastError: {\n            name: error.name,\n            message: error.message,\n            stack: error.stack,\n          },\n        }\n\n        span.setAttribute(`retryDelay`, delay)\n        span.setAttribute(`nextRetryCount`, updatedTransaction.retryCount)\n\n        this.scheduler.updateTransaction(updatedTransaction)\n\n        try {\n          await this.outbox.update(transaction.id, updatedTransaction)\n          span.setAttribute(`result`, `scheduled_retry`)\n        } catch (persistError) {\n          span.recordException(persistError as Error)\n          span.setAttribute(`result`, `persist_failed`)\n          throw persistError\n        } finally {\n          this.scheduler.markFailed(transaction)\n        }\n      },\n    )\n  }\n\n  async loadPendingTransactions(): Promise<void> {\n    let removedIds: Array<string> = []\n    await this.outbox.withAll((transactions) => {\n      const { isOfflineEnabled } = this.offlineExecutor\n      if (!isOfflineEnabled) return\n      let filteredTransactions = transactions\n\n      if (this.config.beforeRetry) {\n        filteredTransactions = this.config.beforeRetry(transactions)\n      }\n\n      // The retry hook is user code and may synchronously revoke replay rights.\n      if (!this.offlineExecutor.isOfflineEnabled) return\n\n      const newlyLoaded = filteredTransactions.filter((transaction) =>\n        this.scheduler.schedule(transaction),\n      )\n\n      const retainedIds = new Set(filteredTransactions.map(({ id }) => id))\n      removedIds = transactions\n        .filter(({ id }) => !retainedIds.has(id))\n        .map(({ id }) => id)\n      removedIds = this.scheduler.removePendingTransactions(removedIds)\n\n      // Restore optimistic state for loaded transactions\n      // This ensures the UI shows the optimistic data while transactions are pending\n      this.restoreOptimisticState(newlyLoaded)\n\n      // Reset retry delays for all loaded transactions so they can run immediately\n      this.resetRetryDelays()\n\n      // Schedule retry timer for loaded transactions\n      this.scheduleNextRetry()\n    })\n\n    if (removedIds.length > 0) {\n      const error = new NonRetriableError(`Transaction excluded by beforeRetry`)\n      await Promise.all(\n        removedIds.map(async (id) => {\n          try {\n            await this.outbox.remove(id)\n            this.offlineExecutor.rejectTransaction(id, error)\n          } catch (cleanupError) {\n            console.warn(\n              `Failed to remove transaction excluded by beforeRetry:`,\n              id,\n              cleanupError,\n            )\n          }\n        }),\n      )\n    }\n  }\n\n  /**\n   * Restore optimistic state from loaded transactions.\n   * Creates internal transactions to hold the mutations so the collection's\n   * state manager can show optimistic data while waiting for sync.\n   */\n  private restoreOptimisticState(\n    transactions: Array<OfflineTransaction>,\n  ): void {\n    for (const offlineTx of transactions) {\n      if (offlineTx.mutations.length === 0) {\n        continue\n      }\n\n      try {\n        // Create a restoration transaction that holds mutations for optimistic state display.\n        // It will never commit - the real mutation is handled by the offline executor.\n        const restorationTx = createTransaction({\n          id: offlineTx.id,\n          autoCommit: false,\n          mutationFn: async () => {},\n        })\n\n        // Prevent unhandled promise rejection when cleanup calls rollback()\n        // We don't care about this promise - it's just for holding mutations\n        restorationTx.isPersisted.promise.catch(() => {\n          // Intentionally ignored - restoration transactions are cleaned up\n          // via cleanupRestorationTransaction, not through normal commit flow\n        })\n\n        restorationTx.applyMutations(offlineTx.mutations)\n\n        // Register with each affected collection's state manager\n        const touchedCollections = new Set<string>()\n        for (const mutation of offlineTx.mutations) {\n          // Defensive check for corrupted deserialized data\n          // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n          if (!mutation.collection) {\n            continue\n          }\n          const collectionId = mutation.collection.id\n          if (touchedCollections.has(collectionId)) {\n            continue\n          }\n          touchedCollections.add(collectionId)\n\n          mutation.collection._state.transactions.set(\n            restorationTx.id,\n            restorationTx,\n          )\n          mutation.collection._state.recomputeOptimisticState(true)\n        }\n\n        this.offlineExecutor.registerRestorationTransaction(\n          offlineTx.id,\n          restorationTx,\n        )\n      } catch (error) {\n        console.warn(\n          `Failed to restore optimistic state for transaction ${offlineTx.id}:`,\n          error,\n        )\n      }\n    }\n  }\n\n  clear(): void {\n    this.scheduler.clear()\n    this.clearRetryTimer()\n  }\n\n  pause(): void {\n    // Retain queued work and let the issued call finish its acknowledgment.\n    this.clearRetryTimer()\n  }\n\n  getPendingCount(): number {\n    return this.scheduler.getPendingCount()\n  }\n\n  private scheduleNextRetry(): void {\n    // Clear existing timer\n    this.clearRetryTimer()\n\n    if (!this.canExecute()) {\n      return\n    }\n\n    const nextRetryTime = this.getNextRetryTime()\n\n    if (nextRetryTime === null) {\n      return // No transactions pending retry\n    }\n\n    const delay = Math.max(0, nextRetryTime - Date.now())\n\n    this.retryTimer = setTimeout(() => {\n      this.executeAll().catch((error) => {\n        console.warn(`Failed to execute retry batch:`, error)\n      })\n    }, delay)\n  }\n\n  private getNextRetryTime(): number | null {\n    const allTransactions = this.scheduler.getAllPendingTransactions()\n\n    if (allTransactions.length === 0) {\n      return null\n    }\n\n    // Later transactions cannot overtake the FIFO head, even if they are ready.\n    return allTransactions[0]!.nextAttemptAt\n  }\n\n  private clearRetryTimer(): void {\n    if (this.retryTimer) {\n      clearTimeout(this.retryTimer)\n      this.retryTimer = null\n    }\n  }\n\n  private canExecute(): boolean {\n    return (\n      this.offlineExecutor.isOfflineEnabled && this.offlineExecutor.isOnline()\n    )\n  }\n\n  getRunningCount(): number {\n    return this.scheduler.getRunningCount()\n  }\n\n  resetRetryDelays(): void {\n    const allTransactions = this.scheduler.getAllPendingTransactions()\n    const updatedTransactions = allTransactions.map((transaction) => ({\n      ...transaction,\n      nextAttemptAt: Date.now(),\n    }))\n\n    this.scheduler.updateTransactions(updatedTransactions)\n  }\n}\n"],"names":["DefaultRetryPolicy","withNestedSpan","NonRetriableError","createTransaction"],"mappings":"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"}

package/dist/cjs/executor/TransactionExecutor.d.cts

@@ -25,11 +25,12 @@ export declare class TransactionExecutor {
      */
     private restoreOptimisticState;
     clear(): void;
+    pause(): void;
     getPendingCount(): number;
     private scheduleNextRetry;
-    private getEarliestRetryTime;
+    private getNextRetryTime;
     private clearRetryTimer;
-    private isOnline;
+    private canExecute;
     getRunningCount(): number;
     resetRetryDelays(): void;
 }

package/dist/cjs/outbox/OutboxManager.cjs

@@ -5,12 +5,32 @@ const TransactionSerializer = require("./TransactionSerializer.cjs");
 class OutboxManager {
   constructor(storage, collections) {
     this.keyPrefix = `tx:`;
+    this.removalRevision = 0;
+    this.activeReads = /* @__PURE__ */ new Set();
+    this.removedAtRevision = /* @__PURE__ */ new Map();
     this.storage = storage;
     this.serializer = new TransactionSerializer.TransactionSerializer(collections);
   }
   getStorageKey(id) {
     return `${this.keyPrefix}${id}`;
   }
+  recordRemovals(ids) {
+    this.removalRevision++;
+    if (this.activeReads.size === 0) return;
+    for (const id of ids) this.removedAtRevision.set(id, this.removalRevision);
+    this.pruneRemovalHistory();
+  }
+  pruneRemovalHistory() {
+    if (this.activeReads.size === 0) {
+      this.removedAtRevision.clear();
+      return;
+    }
+    let oldestRead = Number.POSITIVE_INFINITY;
+    for (const read of this.activeReads)
+      oldestRead = Math.min(oldestRead, read.revision);
+    for (const [id, revision] of this.removedAtRevision)
+      if (revision <= oldestRead) this.removedAtRevision.delete(id);
+  }
   async add(transaction) {
     return tracer.withSpan(
       `outbox.add`,
@@ -39,6 +59,10 @@ class OutboxManager {
         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;
@@ -46,31 +70,46 @@ class OutboxManager {
     });
   }
   async getAll() {
-    return 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) {
-            console.warn(
-              `Failed to deserialize transaction from key ${key}:`,
-              error
-            );
+    return this.withAll((transactions) => transactions);
+  }
+  async withAll(consume) {
+    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
+              );
+            }
           }
         }
-      }
-      return transactions.sort(
-        (a, b) => a.createdAt.getTime() - b.createdAt.getTime()
-      );
-    });
+        const currentTransactions = transactions.filter(
+          ({ id }) => (this.removedAtRevision.get(id) ?? 0) <= read.revision
+        ).sort((a, b) => a.createdAt.getTime() - b.createdAt.getTime());
+        return consume(currentTransactions);
+      });
+    } finally {
+      this.activeReads.delete(read);
+      this.pruneRemovalHistory();
+    }
   }
   async getByKeys(keys) {
     const allTransactions = await this.getAll();
@@ -93,6 +132,7 @@ class OutboxManager {
     return tracer.withSpan(`outbox.remove`, {}, async () => {
       const key = this.getStorageKey(id);
       await this.storage.delete(key);
+      this.recordRemovals([id]);
     });
   }
   async removeMany(ids) {
@@ -103,7 +143,9 @@ class OutboxManager {
   async clear() {
     const keys = await this.storage.keys();
     const transactionKeys = keys.filter((key) => key.startsWith(this.keyPrefix));
-    await Promise.all(transactionKeys.map((key) => this.storage.delete(key)));
+    await this.removeMany(
+      transactionKeys.map((key) => key.slice(this.keyPrefix.length))
+    );
   }
   async count() {
     const keys = await this.storage.keys();