@tanstack/offline-transactions 0.0.0

package/dist/esm/connectivity/OnlineDetector.js

@@ -0,0 +1,73 @@
+class DefaultOnlineDetector {
+  constructor() {
+    this.listeners = /* @__PURE__ */ new Set();
+    this.isListening = false;
+    this.handleOnline = () => {
+      this.notifyListeners();
+    };
+    this.handleVisibilityChange = () => {
+      if (document.visibilityState === `visible`) {
+        this.notifyListeners();
+      }
+    };
+    this.startListening();
+  }
+  startListening() {
+    if (this.isListening) {
+      return;
+    }
+    this.isListening = true;
+    if (typeof window !== `undefined`) {
+      window.addEventListener(`online`, this.handleOnline);
+      document.addEventListener(`visibilitychange`, this.handleVisibilityChange);
+    }
+  }
+  stopListening() {
+    if (!this.isListening) {
+      return;
+    }
+    this.isListening = false;
+    if (typeof window !== `undefined`) {
+      window.removeEventListener(`online`, this.handleOnline);
+      document.removeEventListener(
+        `visibilitychange`,
+        this.handleVisibilityChange
+      );
+    }
+  }
+  notifyListeners() {
+    for (const listener of this.listeners) {
+      try {
+        listener();
+      } catch (error) {
+        console.warn(`OnlineDetector listener error:`, error);
+      }
+    }
+  }
+  subscribe(callback) {
+    this.listeners.add(callback);
+    return () => {
+      this.listeners.delete(callback);
+      if (this.listeners.size === 0) {
+        this.stopListening();
+      }
+    };
+  }
+  notifyOnline() {
+    this.notifyListeners();
+  }
+  isOnline() {
+    if (typeof navigator !== `undefined`) {
+      return navigator.onLine;
+    }
+    return true;
+  }
+  dispose() {
+    this.stopListening();
+    this.listeners.clear();
+  }
+}
+export {
+  DefaultOnlineDetector
+};
+//# sourceMappingURL=OnlineDetector.js.map

package/dist/esm/connectivity/OnlineDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OnlineDetector.js","sources":["../../../src/connectivity/OnlineDetector.ts"],"sourcesContent":["import type { OnlineDetector } from \"../types\"\n\nexport class DefaultOnlineDetector implements OnlineDetector {\n  private listeners: Set<() => void> = new Set()\n  private isListening = false\n\n  constructor() {\n    this.startListening()\n  }\n\n  private startListening(): void {\n    if (this.isListening) {\n      return\n    }\n\n    this.isListening = true\n\n    if (typeof window !== `undefined`) {\n      window.addEventListener(`online`, this.handleOnline)\n      document.addEventListener(`visibilitychange`, this.handleVisibilityChange)\n    }\n  }\n\n  private stopListening(): void {\n    if (!this.isListening) {\n      return\n    }\n\n    this.isListening = false\n\n    if (typeof window !== `undefined`) {\n      window.removeEventListener(`online`, this.handleOnline)\n      document.removeEventListener(\n        `visibilitychange`,\n        this.handleVisibilityChange\n      )\n    }\n  }\n\n  private handleOnline = (): void => {\n    this.notifyListeners()\n  }\n\n  private handleVisibilityChange = (): void => {\n    if (document.visibilityState === `visible`) {\n      this.notifyListeners()\n    }\n  }\n\n  private notifyListeners(): void {\n    for (const listener of this.listeners) {\n      try {\n        listener()\n      } catch (error) {\n        console.warn(`OnlineDetector listener error:`, error)\n      }\n    }\n  }\n\n  subscribe(callback: () => void): () => void {\n    this.listeners.add(callback)\n\n    return () => {\n      this.listeners.delete(callback)\n\n      if (this.listeners.size === 0) {\n        this.stopListening()\n      }\n    }\n  }\n\n  notifyOnline(): void {\n    this.notifyListeners()\n  }\n\n  isOnline(): boolean {\n    if (typeof navigator !== `undefined`) {\n      return navigator.onLine\n    }\n    return true\n  }\n\n  dispose(): void {\n    this.stopListening()\n    this.listeners.clear()\n  }\n}\n"],"names":[],"mappings":"AAEO,MAAM,sBAAgD;AAAA,EAI3D,cAAc;AAHd,SAAQ,gCAAiC,IAAA;AACzC,SAAQ,cAAc;AAmCtB,SAAQ,eAAe,MAAY;AACjC,WAAK,gBAAA;AAAA,IACP;AAEA,SAAQ,yBAAyB,MAAY;AAC3C,UAAI,SAAS,oBAAoB,WAAW;AAC1C,aAAK,gBAAA;AAAA,MACP;AAAA,IACF;AAxCE,SAAK,eAAA;AAAA,EACP;AAAA,EAEQ,iBAAuB;AAC7B,QAAI,KAAK,aAAa;AACpB;AAAA,IACF;AAEA,SAAK,cAAc;AAEnB,QAAI,OAAO,WAAW,aAAa;AACjC,aAAO,iBAAiB,UAAU,KAAK,YAAY;AACnD,eAAS,iBAAiB,oBAAoB,KAAK,sBAAsB;AAAA,IAC3E;AAAA,EACF;AAAA,EAEQ,gBAAsB;AAC5B,QAAI,CAAC,KAAK,aAAa;AACrB;AAAA,IACF;AAEA,SAAK,cAAc;AAEnB,QAAI,OAAO,WAAW,aAAa;AACjC,aAAO,oBAAoB,UAAU,KAAK,YAAY;AACtD,eAAS;AAAA,QACP;AAAA,QACA,KAAK;AAAA,MAAA;AAAA,IAET;AAAA,EACF;AAAA,EAYQ,kBAAwB;AAC9B,eAAW,YAAY,KAAK,WAAW;AACrC,UAAI;AACF,iBAAA;AAAA,MACF,SAAS,OAAO;AACd,gBAAQ,KAAK,kCAAkC,KAAK;AAAA,MACtD;AAAA,IACF;AAAA,EACF;AAAA,EAEA,UAAU,UAAkC;AAC1C,SAAK,UAAU,IAAI,QAAQ;AAE3B,WAAO,MAAM;AACX,WAAK,UAAU,OAAO,QAAQ;AAE9B,UAAI,KAAK,UAAU,SAAS,GAAG;AAC7B,aAAK,cAAA;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAAA,EAEA,eAAqB;AACnB,SAAK,gBAAA;AAAA,EACP;AAAA,EAEA,WAAoB;AAClB,QAAI,OAAO,cAAc,aAAa;AACpC,aAAO,UAAU;AAAA,IACnB;AACA,WAAO;AAAA,EACT;AAAA,EAEA,UAAgB;AACd,SAAK,cAAA;AACL,SAAK,UAAU,MAAA;AAAA,EACjB;AACF;"}

package/dist/esm/coordination/BroadcastChannelLeader.d.ts

@@ -0,0 +1,26 @@
+import { BaseLeaderElection } from './LeaderElection.js';
+export declare class BroadcastChannelLeader extends BaseLeaderElection {
+    private channelName;
+    private tabId;
+    private channel;
+    private heartbeatInterval;
+    private electionTimeout;
+    private lastLeaderHeartbeat;
+    private readonly heartbeatIntervalMs;
+    private readonly electionTimeoutMs;
+    constructor(channelName?: string);
+    private setupChannel;
+    private handleMessage;
+    requestLeadership(): Promise<boolean>;
+    private startElection;
+    private cancelElection;
+    private claimLeadership;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private sendHeartbeat;
+    private sendMessage;
+    releaseLeadership(): void;
+    private isBroadcastChannelSupported;
+    static isSupported(): boolean;
+    dispose(): void;
+}

package/dist/esm/coordination/BroadcastChannelLeader.js

@@ -0,0 +1,146 @@
+import { BaseLeaderElection } from "./LeaderElection.js";
+class BroadcastChannelLeader extends BaseLeaderElection {
+  constructor(channelName = `offline-executor-leader`) {
+    super();
+    this.channel = null;
+    this.heartbeatInterval = null;
+    this.electionTimeout = null;
+    this.lastLeaderHeartbeat = 0;
+    this.heartbeatIntervalMs = 5e3;
+    this.electionTimeoutMs = 1e4;
+    this.handleMessage = (event) => {
+      const { type, tabId, timestamp } = event.data;
+      if (tabId === this.tabId) {
+        return;
+      }
+      switch (type) {
+        case `heartbeat`:
+          if (this.isLeaderState && tabId < this.tabId) {
+            this.releaseLeadership();
+          } else if (!this.isLeaderState) {
+            this.lastLeaderHeartbeat = timestamp;
+            this.cancelElection();
+          }
+          break;
+        case `election`:
+          if (this.isLeaderState) {
+            this.sendHeartbeat();
+          } else if (tabId > this.tabId) {
+            this.startElection();
+          }
+          break;
+        case `leadership-claim`:
+          if (this.isLeaderState && tabId < this.tabId) {
+            this.releaseLeadership();
+          }
+          break;
+      }
+    };
+    this.channelName = channelName;
+    this.tabId = crypto.randomUUID();
+    this.setupChannel();
+  }
+  setupChannel() {
+    if (!this.isBroadcastChannelSupported()) {
+      return;
+    }
+    this.channel = new BroadcastChannel(this.channelName);
+    this.channel.addEventListener(`message`, this.handleMessage);
+  }
+  async requestLeadership() {
+    if (!this.isBroadcastChannelSupported()) {
+      return false;
+    }
+    if (this.isLeaderState) {
+      return true;
+    }
+    this.startElection();
+    return new Promise((resolve) => {
+      setTimeout(() => {
+        resolve(this.isLeaderState);
+      }, 1e3);
+    });
+  }
+  startElection() {
+    if (this.electionTimeout) {
+      return;
+    }
+    this.sendMessage({
+      type: `election`,
+      tabId: this.tabId,
+      timestamp: Date.now()
+    });
+    this.electionTimeout = window.setTimeout(() => {
+      const timeSinceLastHeartbeat = Date.now() - this.lastLeaderHeartbeat;
+      if (timeSinceLastHeartbeat > this.electionTimeoutMs) {
+        this.claimLeadership();
+      }
+      this.electionTimeout = null;
+    }, this.electionTimeoutMs);
+  }
+  cancelElection() {
+    if (this.electionTimeout) {
+      clearTimeout(this.electionTimeout);
+      this.electionTimeout = null;
+    }
+  }
+  claimLeadership() {
+    this.notifyLeadershipChange(true);
+    this.sendMessage({
+      type: `leadership-claim`,
+      tabId: this.tabId,
+      timestamp: Date.now()
+    });
+    this.startHeartbeat();
+  }
+  startHeartbeat() {
+    if (this.heartbeatInterval) {
+      return;
+    }
+    this.sendHeartbeat();
+    this.heartbeatInterval = window.setInterval(() => {
+      this.sendHeartbeat();
+    }, this.heartbeatIntervalMs);
+  }
+  stopHeartbeat() {
+    if (this.heartbeatInterval) {
+      clearInterval(this.heartbeatInterval);
+      this.heartbeatInterval = null;
+    }
+  }
+  sendHeartbeat() {
+    this.sendMessage({
+      type: `heartbeat`,
+      tabId: this.tabId,
+      timestamp: Date.now()
+    });
+  }
+  sendMessage(message) {
+    if (this.channel) {
+      this.channel.postMessage(message);
+    }
+  }
+  releaseLeadership() {
+    this.stopHeartbeat();
+    this.cancelElection();
+    this.notifyLeadershipChange(false);
+  }
+  isBroadcastChannelSupported() {
+    return typeof BroadcastChannel !== `undefined`;
+  }
+  static isSupported() {
+    return typeof BroadcastChannel !== `undefined`;
+  }
+  dispose() {
+    this.releaseLeadership();
+    if (this.channel) {
+      this.channel.removeEventListener(`message`, this.handleMessage);
+      this.channel.close();
+      this.channel = null;
+    }
+  }
+}
+export {
+  BroadcastChannelLeader
+};
+//# sourceMappingURL=BroadcastChannelLeader.js.map

package/dist/esm/coordination/BroadcastChannelLeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BroadcastChannelLeader.js","sources":["../../../src/coordination/BroadcastChannelLeader.ts"],"sourcesContent":["import { BaseLeaderElection } from \"./LeaderElection\"\n\ninterface LeaderMessage {\n  type: `heartbeat` | `election` | `leadership-claim`\n  tabId: string\n  timestamp: number\n}\n\nexport class BroadcastChannelLeader extends BaseLeaderElection {\n  private channelName: string\n  private tabId: string\n  private channel: BroadcastChannel | null = null\n  private heartbeatInterval: number | null = null\n  private electionTimeout: number | null = null\n  private lastLeaderHeartbeat = 0\n  private readonly heartbeatIntervalMs = 5000\n  private readonly electionTimeoutMs = 10000\n\n  constructor(channelName = `offline-executor-leader`) {\n    super()\n    this.channelName = channelName\n    this.tabId = crypto.randomUUID()\n    this.setupChannel()\n  }\n\n  private setupChannel(): void {\n    if (!this.isBroadcastChannelSupported()) {\n      return\n    }\n\n    this.channel = new BroadcastChannel(this.channelName)\n    this.channel.addEventListener(`message`, this.handleMessage)\n  }\n\n  private handleMessage = (event: MessageEvent<LeaderMessage>): void => {\n    const { type, tabId, timestamp } = event.data\n\n    if (tabId === this.tabId) {\n      return\n    }\n\n    switch (type) {\n      case `heartbeat`:\n        if (this.isLeaderState && tabId < this.tabId) {\n          this.releaseLeadership()\n        } else if (!this.isLeaderState) {\n          this.lastLeaderHeartbeat = timestamp\n          this.cancelElection()\n        }\n        break\n\n      case `election`:\n        if (this.isLeaderState) {\n          this.sendHeartbeat()\n        } else if (tabId > this.tabId) {\n          this.startElection()\n        }\n        break\n\n      case `leadership-claim`:\n        if (this.isLeaderState && tabId < this.tabId) {\n          this.releaseLeadership()\n        }\n        break\n    }\n  }\n\n  async requestLeadership(): Promise<boolean> {\n    if (!this.isBroadcastChannelSupported()) {\n      return false\n    }\n\n    if (this.isLeaderState) {\n      return true\n    }\n\n    this.startElection()\n\n    return new Promise((resolve) => {\n      setTimeout(() => {\n        resolve(this.isLeaderState)\n      }, 1000)\n    })\n  }\n\n  private startElection(): void {\n    if (this.electionTimeout) {\n      return\n    }\n\n    this.sendMessage({\n      type: `election`,\n      tabId: this.tabId,\n      timestamp: Date.now(),\n    })\n\n    this.electionTimeout = window.setTimeout(() => {\n      const timeSinceLastHeartbeat = Date.now() - this.lastLeaderHeartbeat\n\n      if (timeSinceLastHeartbeat > this.electionTimeoutMs) {\n        this.claimLeadership()\n      }\n\n      this.electionTimeout = null\n    }, this.electionTimeoutMs)\n  }\n\n  private cancelElection(): void {\n    if (this.electionTimeout) {\n      clearTimeout(this.electionTimeout)\n      this.electionTimeout = null\n    }\n  }\n\n  private claimLeadership(): void {\n    this.notifyLeadershipChange(true)\n    this.sendMessage({\n      type: `leadership-claim`,\n      tabId: this.tabId,\n      timestamp: Date.now(),\n    })\n    this.startHeartbeat()\n  }\n\n  private startHeartbeat(): void {\n    if (this.heartbeatInterval) {\n      return\n    }\n\n    this.sendHeartbeat()\n\n    this.heartbeatInterval = window.setInterval(() => {\n      this.sendHeartbeat()\n    }, this.heartbeatIntervalMs)\n  }\n\n  private stopHeartbeat(): void {\n    if (this.heartbeatInterval) {\n      clearInterval(this.heartbeatInterval)\n      this.heartbeatInterval = null\n    }\n  }\n\n  private sendHeartbeat(): void {\n    this.sendMessage({\n      type: `heartbeat`,\n      tabId: this.tabId,\n      timestamp: Date.now(),\n    })\n  }\n\n  private sendMessage(message: LeaderMessage): void {\n    if (this.channel) {\n      this.channel.postMessage(message)\n    }\n  }\n\n  releaseLeadership(): void {\n    this.stopHeartbeat()\n    this.cancelElection()\n    this.notifyLeadershipChange(false)\n  }\n\n  private isBroadcastChannelSupported(): boolean {\n    return typeof BroadcastChannel !== `undefined`\n  }\n\n  static isSupported(): boolean {\n    return typeof BroadcastChannel !== `undefined`\n  }\n\n  dispose(): void {\n    this.releaseLeadership()\n\n    if (this.channel) {\n      this.channel.removeEventListener(`message`, this.handleMessage)\n      this.channel.close()\n      this.channel = null\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/coordination/LeaderElection.d.ts

@@ -0,0 +1,10 @@
+import { LeaderElection } from '../types.js';
+export declare abstract class BaseLeaderElection implements LeaderElection {
+    protected isLeaderState: boolean;
+    protected listeners: Set<(isLeader: boolean) => void>;
+    abstract requestLeadership(): Promise<boolean>;
+    abstract releaseLeadership(): void;
+    isLeader(): boolean;
+    onLeadershipChange(callback: (isLeader: boolean) => void): () => void;
+    protected notifyLeadershipChange(isLeader: boolean): void;
+}

package/dist/esm/coordination/LeaderElection.js

@@ -0,0 +1,31 @@
+class BaseLeaderElection {
+  constructor() {
+    this.isLeaderState = false;
+    this.listeners = /* @__PURE__ */ new Set();
+  }
+  isLeader() {
+    return this.isLeaderState;
+  }
+  onLeadershipChange(callback) {
+    this.listeners.add(callback);
+    return () => {
+      this.listeners.delete(callback);
+    };
+  }
+  notifyLeadershipChange(isLeader) {
+    if (this.isLeaderState !== isLeader) {
+      this.isLeaderState = isLeader;
+      for (const listener of this.listeners) {
+        try {
+          listener(isLeader);
+        } catch (error) {
+          console.warn(`Leadership change listener error:`, error);
+        }
+      }
+    }
+  }
+}
+export {
+  BaseLeaderElection
+};
+//# sourceMappingURL=LeaderElection.js.map

package/dist/esm/coordination/LeaderElection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LeaderElection.js","sources":["../../../src/coordination/LeaderElection.ts"],"sourcesContent":["import type { LeaderElection } from \"../types\"\n\nexport abstract class BaseLeaderElection implements LeaderElection {\n  protected isLeaderState = false\n  protected listeners: Set<(isLeader: boolean) => void> = new Set()\n\n  abstract requestLeadership(): Promise<boolean>\n  abstract releaseLeadership(): void\n\n  isLeader(): boolean {\n    return this.isLeaderState\n  }\n\n  onLeadershipChange(callback: (isLeader: boolean) => void): () => void {\n    this.listeners.add(callback)\n\n    return () => {\n      this.listeners.delete(callback)\n    }\n  }\n\n  protected notifyLeadershipChange(isLeader: boolean): void {\n    if (this.isLeaderState !== isLeader) {\n      this.isLeaderState = isLeader\n\n      for (const listener of this.listeners) {\n        try {\n          listener(isLeader)\n        } catch (error) {\n          console.warn(`Leadership change listener error:`, error)\n        }\n      }\n    }\n  }\n}\n"],"names":[],"mappings":"AAEO,MAAe,mBAA6C;AAAA,EAA5D,cAAA;AACL,SAAU,gBAAgB;AAC1B,SAAU,gCAAkD,IAAA;AAAA,EAAI;AAAA,EAKhE,WAAoB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,mBAAmB,UAAmD;AACpE,SAAK,UAAU,IAAI,QAAQ;AAE3B,WAAO,MAAM;AACX,WAAK,UAAU,OAAO,QAAQ;AAAA,IAChC;AAAA,EACF;AAAA,EAEU,uBAAuB,UAAyB;AACxD,QAAI,KAAK,kBAAkB,UAAU;AACnC,WAAK,gBAAgB;AAErB,iBAAW,YAAY,KAAK,WAAW;AACrC,YAAI;AACF,mBAAS,QAAQ;AAAA,QACnB,SAAS,OAAO;AACd,kBAAQ,KAAK,qCAAqC,KAAK;AAAA,QACzD;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;"}

package/dist/esm/coordination/WebLocksLeader.d.ts

@@ -0,0 +1,10 @@
+import { BaseLeaderElection } from './LeaderElection.js';
+export declare class WebLocksLeader extends BaseLeaderElection {
+    private lockName;
+    private releaseLock;
+    constructor(lockName?: string);
+    requestLeadership(): Promise<boolean>;
+    releaseLeadership(): void;
+    private isWebLocksSupported;
+    static isSupported(): boolean;
+}

package/dist/esm/coordination/WebLocksLeader.js

@@ -0,0 +1,71 @@
+import { BaseLeaderElection } from "./LeaderElection.js";
+class WebLocksLeader extends BaseLeaderElection {
+  constructor(lockName = `offline-executor-leader`) {
+    super();
+    this.releaseLock = null;
+    this.lockName = lockName;
+  }
+  async requestLeadership() {
+    if (!this.isWebLocksSupported()) {
+      return false;
+    }
+    if (this.isLeaderState) {
+      return true;
+    }
+    try {
+      const available = await navigator.locks.request(
+        this.lockName,
+        {
+          mode: `exclusive`,
+          ifAvailable: true
+        },
+        (lock) => {
+          return lock !== null;
+        }
+      );
+      if (!available) {
+        return false;
+      }
+      navigator.locks.request(
+        this.lockName,
+        {
+          mode: `exclusive`
+        },
+        async (lock) => {
+          if (lock) {
+            this.notifyLeadershipChange(true);
+            return new Promise((resolve) => {
+              this.releaseLock = () => {
+                this.notifyLeadershipChange(false);
+                resolve();
+              };
+            });
+          }
+        }
+      );
+      return true;
+    } catch (error) {
+      if (error instanceof Error && error.name === `AbortError`) {
+        return false;
+      }
+      console.warn(`Web Locks leadership request failed:`, error);
+      return false;
+    }
+  }
+  releaseLeadership() {
+    if (this.releaseLock) {
+      this.releaseLock();
+      this.releaseLock = null;
+    }
+  }
+  isWebLocksSupported() {
+    return typeof navigator !== `undefined` && `locks` in navigator;
+  }
+  static isSupported() {
+    return typeof navigator !== `undefined` && `locks` in navigator;
+  }
+}
+export {
+  WebLocksLeader
+};
+//# sourceMappingURL=WebLocksLeader.js.map

package/dist/esm/coordination/WebLocksLeader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebLocksLeader.js","sources":["../../../src/coordination/WebLocksLeader.ts"],"sourcesContent":["import { BaseLeaderElection } from \"./LeaderElection\"\n\nexport class WebLocksLeader extends BaseLeaderElection {\n  private lockName: string\n  private releaseLock: (() => void) | null = null\n\n  constructor(lockName = `offline-executor-leader`) {\n    super()\n    this.lockName = lockName\n  }\n\n  async requestLeadership(): Promise<boolean> {\n    if (!this.isWebLocksSupported()) {\n      return false\n    }\n\n    if (this.isLeaderState) {\n      return true\n    }\n\n    try {\n      // First try to acquire the lock with ifAvailable\n      const available = await navigator.locks.request(\n        this.lockName,\n        {\n          mode: `exclusive`,\n          ifAvailable: true,\n        },\n        (lock) => {\n          return lock !== null\n        }\n      )\n\n      if (!available) {\n        return false\n      }\n\n      // Lock is available, now acquire it for real and hold it\n      navigator.locks.request(\n        this.lockName,\n        {\n          mode: `exclusive`,\n        },\n        async (lock) => {\n          if (lock) {\n            this.notifyLeadershipChange(true)\n            // Hold the lock until released\n            return new Promise<void>((resolve) => {\n              this.releaseLock = () => {\n                this.notifyLeadershipChange(false)\n                resolve()\n              }\n            })\n          }\n        }\n      )\n\n      return true\n    } catch (error) {\n      if (error instanceof Error && error.name === `AbortError`) {\n        return false\n      }\n      console.warn(`Web Locks leadership request failed:`, error)\n      return false\n    }\n  }\n\n  releaseLeadership(): void {\n    if (this.releaseLock) {\n      this.releaseLock()\n      this.releaseLock = null\n    }\n  }\n\n  private isWebLocksSupported(): boolean {\n    return typeof navigator !== `undefined` && `locks` in navigator\n  }\n\n  static isSupported(): boolean {\n    return typeof navigator !== `undefined` && `locks` in navigator\n  }\n}\n"],"names":[],"mappings":";AAEO,MAAM,uBAAuB,mBAAmB;AAAA,EAIrD,YAAY,WAAW,2BAA2B;AAChD,UAAA;AAHF,SAAQ,cAAmC;AAIzC,SAAK,WAAW;AAAA,EAClB;AAAA,EAEA,MAAM,oBAAsC;AAC1C,QAAI,CAAC,KAAK,uBAAuB;AAC/B,aAAO;AAAA,IACT;AAEA,QAAI,KAAK,eAAe;AACtB,aAAO;AAAA,IACT;AAEA,QAAI;AAEF,YAAM,YAAY,MAAM,UAAU,MAAM;AAAA,QACtC,KAAK;AAAA,QACL;AAAA,UACE,MAAM;AAAA,UACN,aAAa;AAAA,QAAA;AAAA,QAEf,CAAC,SAAS;AACR,iBAAO,SAAS;AAAA,QAClB;AAAA,MAAA;AAGF,UAAI,CAAC,WAAW;AACd,eAAO;AAAA,MACT;AAGA,gBAAU,MAAM;AAAA,QACd,KAAK;AAAA,QACL;AAAA,UACE,MAAM;AAAA,QAAA;AAAA,QAER,OAAO,SAAS;AACd,cAAI,MAAM;AACR,iBAAK,uBAAuB,IAAI;AAEhC,mBAAO,IAAI,QAAc,CAAC,YAAY;AACpC,mBAAK,cAAc,MAAM;AACvB,qBAAK,uBAAuB,KAAK;AACjC,wBAAA;AAAA,cACF;AAAA,YACF,CAAC;AAAA,UACH;AAAA,QACF;AAAA,MAAA;AAGF,aAAO;AAAA,IACT,SAAS,OAAO;AACd,UAAI,iBAAiB,SAAS,MAAM,SAAS,cAAc;AACzD,eAAO;AAAA,MACT;AACA,cAAQ,KAAK,wCAAwC,KAAK;AAC1D,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,oBAA0B;AACxB,QAAI,KAAK,aAAa;AACpB,WAAK,YAAA;AACL,WAAK,cAAc;AAAA,IACrB;AAAA,EACF;AAAA,EAEQ,sBAA+B;AACrC,WAAO,OAAO,cAAc,eAAe,WAAW;AAAA,EACxD;AAAA,EAEA,OAAO,cAAuB;AAC5B,WAAO,OAAO,cAAc,eAAe,WAAW;AAAA,EACxD;AACF;"}

package/dist/esm/executor/KeyScheduler.d.ts

@@ -0,0 +1,18 @@
+import { OfflineTransaction } from '../types.js';
+export declare class KeyScheduler {
+    private pendingTransactions;
+    private isRunning;
+    schedule(transaction: OfflineTransaction): void;
+    getNextBatch(_maxConcurrency: number): Array<OfflineTransaction>;
+    private isReadyToRun;
+    markStarted(_transaction: OfflineTransaction): void;
+    markCompleted(transaction: OfflineTransaction): void;
+    markFailed(_transaction: OfflineTransaction): void;
+    private removeTransaction;
+    updateTransaction(transaction: OfflineTransaction): void;
+    getPendingCount(): number;
+    getRunningCount(): number;
+    clear(): void;
+    getAllPendingTransactions(): Array<OfflineTransaction>;
+    updateTransactions(updatedTransactions: Array<OfflineTransaction>): void;
+}

package/dist/esm/executor/KeyScheduler.js

@@ -0,0 +1,106 @@
+import { withSyncSpan } from "../telemetry/tracer.js";
+class KeyScheduler {
+  constructor() {
+    this.pendingTransactions = [];
+    this.isRunning = false;
+  }
+  schedule(transaction) {
+    withSyncSpan(
+      `scheduler.schedule`,
+      {
+        "transaction.id": transaction.id,
+        queueLength: this.pendingTransactions.length
+      },
+      () => {
+        this.pendingTransactions.push(transaction);
+        this.pendingTransactions.sort(
+          (a, b) => a.createdAt.getTime() - b.createdAt.getTime()
+        );
+      }
+    );
+  }
+  getNextBatch(_maxConcurrency) {
+    return withSyncSpan(
+      `scheduler.getNextBatch`,
+      { pendingCount: this.pendingTransactions.length },
+      (span) => {
+        if (this.isRunning || this.pendingTransactions.length === 0) {
+          span.setAttribute(`result`, `empty`);
+          return [];
+        }
+        const readyTransaction = this.pendingTransactions.find(
+          (tx) => this.isReadyToRun(tx)
+        );
+        if (readyTransaction) {
+          span.setAttribute(`result`, `found`);
+          span.setAttribute(`transaction.id`, readyTransaction.id);
+        } else {
+          span.setAttribute(`result`, `none_ready`);
+        }
+        return readyTransaction ? [readyTransaction] : [];
+      }
+    );
+  }
+  isReadyToRun(transaction) {
+    return Date.now() >= transaction.nextAttemptAt;
+  }
+  markStarted(_transaction) {
+    this.isRunning = true;
+  }
+  markCompleted(transaction) {
+    this.removeTransaction(transaction);
+    this.isRunning = false;
+  }
+  markFailed(_transaction) {
+    this.isRunning = false;
+  }
+  removeTransaction(transaction) {
+    const index = this.pendingTransactions.findIndex(
+      (tx) => tx.id === transaction.id
+    );
+    if (index >= 0) {
+      this.pendingTransactions.splice(index, 1);
+    }
+  }
+  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()
+      );
+    }
+  }
+  getPendingCount() {
+    return this.pendingTransactions.length;
+  }
+  getRunningCount() {
+    return this.isRunning ? 1 : 0;
+  }
+  clear() {
+    this.pendingTransactions = [];
+    this.isRunning = false;
+  }
+  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;
+      }
+    }
+    this.pendingTransactions.sort(
+      (a, b) => a.createdAt.getTime() - b.createdAt.getTime()
+    );
+  }
+}
+export {
+  KeyScheduler
+};
+//# sourceMappingURL=KeyScheduler.js.map

package/dist/esm/executor/KeyScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyScheduler.js","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  getNextBatch(_maxConcurrency: number): Array<OfflineTransaction> {\n    return withSyncSpan(\n      `scheduler.getNextBatch`,\n      { pendingCount: this.pendingTransactions.length },\n      (span) => {\n        // For sequential processing, we ignore maxConcurrency and only process one transaction at a time\n        if (this.isRunning || this.pendingTransactions.length === 0) {\n          span.setAttribute(`result`, `empty`)\n          return []\n        }\n\n        // Find the first transaction that's ready to run\n        const readyTransaction = this.pendingTransactions.find((tx) =>\n          this.isReadyToRun(tx)\n        )\n\n        if (readyTransaction) {\n          span.setAttribute(`result`, `found`)\n          span.setAttribute(`transaction.id`, readyTransaction.id)\n        } else {\n          span.setAttribute(`result`, `none_ready`)\n        }\n\n        return readyTransaction ? [readyTransaction] : []\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":[],"mappings":";AAGO,MAAM,aAAa;AAAA,EAAnB,cAAA;AACL,SAAQ,sBAAiD,CAAA;AACzD,SAAQ,YAAY;AAAA,EAAA;AAAA,EAEpB,SAAS,aAAuC;AAC9C;AAAA,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,aAAa,iBAAoD;AAC/D,WAAO;AAAA,MACL;AAAA,MACA,EAAE,cAAc,KAAK,oBAAoB,OAAA;AAAA,MACzC,CAAC,SAAS;AAER,YAAI,KAAK,aAAa,KAAK,oBAAoB,WAAW,GAAG;AAC3D,eAAK,aAAa,UAAU,OAAO;AACnC,iBAAO,CAAA;AAAA,QACT;AAGA,cAAM,mBAAmB,KAAK,oBAAoB;AAAA,UAAK,CAAC,OACtD,KAAK,aAAa,EAAE;AAAA,QAAA;AAGtB,YAAI,kBAAkB;AACpB,eAAK,aAAa,UAAU,OAAO;AACnC,eAAK,aAAa,kBAAkB,iBAAiB,EAAE;AAAA,QACzD,OAAO;AACL,eAAK,aAAa,UAAU,YAAY;AAAA,QAC1C;AAEA,eAAO,mBAAmB,CAAC,gBAAgB,IAAI,CAAA;AAAA,MACjD;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;"}

package/dist/esm/executor/TransactionExecutor.d.ts

@@ -0,0 +1,28 @@
+import { KeyScheduler } from './KeyScheduler.js';
+import { OutboxManager } from '../outbox/OutboxManager.js';
+import { OfflineConfig, OfflineTransaction } from '../types.js';
+export declare class TransactionExecutor {
+    private scheduler;
+    private outbox;
+    private config;
+    private retryPolicy;
+    private isExecuting;
+    private executionPromise;
+    private offlineExecutor;
+    private retryTimer;
+    constructor(scheduler: KeyScheduler, outbox: OutboxManager, config: OfflineConfig, offlineExecutor: any);
+    execute(transaction: OfflineTransaction): Promise<void>;
+    executeAll(): Promise<void>;
+    private runExecution;
+    private executeTransaction;
+    private runMutationFn;
+    private handleError;
+    loadPendingTransactions(): Promise<void>;
+    clear(): void;
+    getPendingCount(): number;
+    private scheduleNextRetry;
+    private getEarliestRetryTime;
+    private clearRetryTimer;
+    getRunningCount(): number;
+    resetRetryDelays(): void;
+}