tab-bridge 0.1.1 → 0.3.0

package/dist/{chunk-BQCNBNBT.cjs → chunk-TGEXRVAL.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-// src/types.ts
+// src/types/messages.ts
 var PROTOCOL_VERSION = 1;
 
 // src/utils/id.ts
@@ -15,18 +15,56 @@ function generateTabId() {
   });
 }
 
-// src/utils/env.ts
-var isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
-var hasDocument = typeof document !== "undefined";
-var hasLocalStorage = (() => {
-  try {
-    return typeof localStorage !== "undefined" && localStorage !== null;
-  } catch {
-    return false;
+// src/utils/errors.ts
+var ErrorCode = {
+  CHANNEL_CLOSED: "CHANNEL_CLOSED",
+  CHANNEL_SEND_FAILED: "CHANNEL_SEND_FAILED",
+  RPC_TIMEOUT: "RPC_TIMEOUT",
+  RPC_NO_HANDLER: "RPC_NO_HANDLER",
+  RPC_NO_LEADER: "RPC_NO_LEADER",
+  RPC_HANDLER_ERROR: "RPC_HANDLER_ERROR",
+  RPC_DESTROYED: "RPC_DESTROYED",
+  STORAGE_QUOTA_EXCEEDED: "STORAGE_QUOTA_EXCEEDED",
+  MIDDLEWARE_REJECTED: "MIDDLEWARE_REJECTED",
+  ALREADY_DESTROYED: "ALREADY_DESTROYED"
+};
+var TabSyncError = class _TabSyncError extends Error {
+  constructor(message, code, cause) {
+    super(message);
+    this.code = code;
+    this.name = "TabSyncError";
+    this.cause = cause;
   }
-})();
-var hasBroadcastChannel = typeof BroadcastChannel !== "undefined";
-var hasCrypto = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function";
+  static timeout(method, ms) {
+    return new _TabSyncError(
+      `RPC "${method}" timed out after ${ms}ms`,
+      ErrorCode.RPC_TIMEOUT
+    );
+  }
+  static noLeader() {
+    return new _TabSyncError("No leader available", ErrorCode.RPC_NO_LEADER);
+  }
+  static noHandler(method) {
+    return new _TabSyncError(
+      `No handler registered for "${method}"`,
+      ErrorCode.RPC_NO_HANDLER
+    );
+  }
+  static destroyed() {
+    return new _TabSyncError("Instance has been destroyed", ErrorCode.ALREADY_DESTROYED);
+  }
+};
+
+// src/utils/logger.ts
+function createLogger(enabled, tabId) {
+  if (!enabled) return { log: (() => {
+  }) };
+  const prefix = `%c[tab-sync:${tabId.slice(0, 8)}]`;
+  const style = "color:#818cf8;font-weight:600";
+  return {
+    log: (label, ...args) => console.log(prefix, style, label, ...args)
+  };
+}
 
 // src/channels/broadcast.ts
 var BroadcastChannelTransport = class {
@@ -52,21 +90,36 @@ var BroadcastChannelTransport = class {
   }
 };
 
+// src/utils/env.ts
+var isBrowser = typeof window !== "undefined" && typeof window.document !== "undefined";
+var hasDocument = typeof document !== "undefined";
+var hasLocalStorage = (() => {
+  try {
+    return typeof localStorage !== "undefined" && localStorage !== null;
+  } catch {
+    return false;
+  }
+})();
+var hasBroadcastChannel = typeof BroadcastChannel !== "undefined";
+var hasCrypto = typeof crypto !== "undefined" && typeof crypto.randomUUID === "function";
+
 // src/channels/storage.ts
 var KEY_PREFIX = "__tab_sync__";
 var StorageChannel = class {
-  constructor(channelName) {
+  constructor(channelName, onError) {
     this.listeners = /* @__PURE__ */ new Set();
     this.closed = false;
     this.seq = 0;
     this.key = `${KEY_PREFIX}${channelName}`;
+    this.onError = onError;
   }
   postMessage(message) {
     if (this.closed || !hasLocalStorage) return;
     try {
       const wrapped = JSON.stringify({ m: message, s: this.seq++ });
       localStorage.setItem(this.key, wrapped);
-    } catch {
+    } catch (e) {
+      this.onError?.(e instanceof Error ? e : new Error(String(e)));
     }
   }
   onMessage(callback) {
@@ -106,9 +159,9 @@ var StorageChannel = class {
 };
 
 // src/channels/channel.ts
-function createChannel(channelName, transport) {
+function createChannel(channelName, transport, onError) {
   if (transport === "local-storage") {
-    return new StorageChannel(channelName);
+    return new StorageChannel(channelName, onError);
   }
   if (transport === "broadcast-channel") {
     return new BroadcastChannelTransport(channelName);
@@ -116,7 +169,7 @@ function createChannel(channelName, transport) {
   if (typeof BroadcastChannel !== "undefined") {
     return new BroadcastChannelTransport(channelName);
   }
-  return new StorageChannel(channelName);
+  return new StorageChannel(channelName, onError);
 }
 
 // src/utils/timestamp.ts
@@ -358,7 +411,21 @@ var StateManager = class {
     for (const [key, remote] of Object.entries(state)) {
       const local = this.state.get(key);
       if (!local || remote.timestamp > local.timestamp) {
-        this.state.set(key, { value: remote.value, timestamp: remote.timestamp });
+        let finalValue = remote.value;
+        if (this.mergeFn && local) {
+          finalValue = this.mergeFn(local.value, remote.value, key);
+        }
+        if (this.interceptRemote) {
+          const result = this.interceptRemote(
+            key,
+            finalValue,
+            local?.value,
+            meta
+          );
+          if (result === false) continue;
+          if (result && "value" in result) finalValue = result.value;
+        }
+        this.state.set(key, { value: finalValue, timestamp: remote.timestamp });
         changedKeys.push(key);
       }
     }
@@ -374,15 +441,15 @@ var StateManager = class {
   }
   notifyKey(key, value, meta) {
     const listeners = this.keyListeners.get(key);
-    if (!listeners) return;
-    for (const cb of listeners) {
+    if (!listeners || listeners.size === 0) return;
+    for (const cb of [...listeners]) {
       cb(value, meta);
     }
   }
   notifyChange(changedKeys, meta) {
     if (this.changeListeners.size === 0) return;
     const snapshot = this.getAll();
-    for (const cb of this.changeListeners) {
+    for (const cb of [...this.changeListeners]) {
       cb(snapshot, changedKeys, meta);
     }
   }
@@ -589,6 +656,8 @@ var LeaderElection = class {
     this.leaderWatchTimer = null;
     this.lastLeaderHeartbeat = 0;
     this.electing = false;
+    this.generation = 0;
+    this.currentClaimId = null;
     this.leaderCallbacks = /* @__PURE__ */ new Set();
     this.leaderCleanups = /* @__PURE__ */ new Map();
     this.send = options.send;
@@ -633,7 +702,7 @@ var LeaderElection = class {
         this.handleClaim(message.payload, message.senderId);
         break;
       case "LEADER_ACK":
-        this.handleAck(message.senderId);
+        this.handleAck(message.payload, message.senderId);
         break;
       case "LEADER_HEARTBEAT":
         this.handleHeartbeat(message.senderId);
@@ -663,11 +732,17 @@ var LeaderElection = class {
   startElection() {
     if (this.electing) return;
     this.electing = true;
+    this.generation++;
+    this.currentClaimId = generateTabId();
     this.send({
       type: "LEADER_CLAIM",
       senderId: this.tabId,
       timestamp: monotonic(),
-      payload: { createdAt: this.tabCreatedAt }
+      payload: {
+        createdAt: this.tabCreatedAt,
+        claimId: this.currentClaimId,
+        generation: this.generation
+      }
     });
     this.electionTimer = setTimeout(() => {
       this.electionTimer = null;
@@ -683,9 +758,11 @@ var LeaderElection = class {
       this.electing = false;
     }
   }
-  handleAck(senderId) {
+  handleAck(payload, senderId) {
+    if (payload.generation < this.generation) return;
     this.clearElectionTimer();
     this.electing = false;
+    this.generation = Math.max(this.generation, payload.generation);
     this.setLeader(senderId);
   }
   handleHeartbeat(senderId) {
@@ -707,7 +784,10 @@ var LeaderElection = class {
       type: "LEADER_ACK",
       senderId: this.tabId,
       timestamp: monotonic(),
-      payload: null
+      payload: {
+        claimId: this.currentClaimId,
+        generation: this.generation
+      }
     });
     this.startHeartbeat();
   }
@@ -717,7 +797,7 @@ var LeaderElection = class {
     this.lastLeaderHeartbeat = Date.now();
     if (this.isLeader() && !wasLeader) {
       this.startHeartbeat();
-      for (const cb of this.leaderCallbacks) {
+      for (const cb of [...this.leaderCallbacks]) {
         const cleanup = cb();
         if (typeof cleanup === "function") {
           this.leaderCleanups.set(cb, cleanup);
@@ -788,46 +868,6 @@ var LeaderElection = class {
   }
 };
 
-// src/utils/errors.ts
-var ErrorCode = {
-  CHANNEL_CLOSED: "CHANNEL_CLOSED",
-  CHANNEL_SEND_FAILED: "CHANNEL_SEND_FAILED",
-  RPC_TIMEOUT: "RPC_TIMEOUT",
-  RPC_NO_HANDLER: "RPC_NO_HANDLER",
-  RPC_NO_LEADER: "RPC_NO_LEADER",
-  RPC_HANDLER_ERROR: "RPC_HANDLER_ERROR",
-  RPC_DESTROYED: "RPC_DESTROYED",
-  STORAGE_QUOTA_EXCEEDED: "STORAGE_QUOTA_EXCEEDED",
-  MIDDLEWARE_REJECTED: "MIDDLEWARE_REJECTED",
-  ALREADY_DESTROYED: "ALREADY_DESTROYED"
-};
-var TabSyncError = class _TabSyncError extends Error {
-  constructor(message, code, cause) {
-    super(message);
-    this.code = code;
-    this.name = "TabSyncError";
-    this.cause = cause;
-  }
-  static timeout(method, ms) {
-    return new _TabSyncError(
-      `RPC "${method}" timed out after ${ms}ms`,
-      ErrorCode.RPC_TIMEOUT
-    );
-  }
-  static noLeader() {
-    return new _TabSyncError("No leader available", ErrorCode.RPC_NO_LEADER);
-  }
-  static noHandler(method) {
-    return new _TabSyncError(
-      `No handler registered for "${method}"`,
-      ErrorCode.RPC_NO_HANDLER
-    );
-  }
-  static destroyed() {
-    return new _TabSyncError("Instance has been destroyed", ErrorCode.ALREADY_DESTROYED);
-  }
-};
-
 // src/core/rpc.ts
 var DEFAULT_TIMEOUT = 5e3;
 var RPCHandler = class {
@@ -837,6 +877,7 @@ var RPCHandler = class {
     this.send = options.send;
     this.tabId = options.tabId;
     this.resolveLeaderId = options.resolveLeaderId ?? (() => null);
+    this.resolveTabIds = options.resolveTabIds ?? (() => []);
     this.onError = options.onError ?? (() => {
     });
   }
@@ -865,6 +906,15 @@ var RPCHandler = class {
       });
     });
   }
+  callAll(method, args, timeout = DEFAULT_TIMEOUT) {
+    const tabIds = this.resolveTabIds().filter((id) => id !== this.tabId);
+    if (tabIds.length === 0) return Promise.resolve([]);
+    return Promise.all(
+      tabIds.map(
+        (targetId) => this.call(targetId, method, args, timeout).then((result) => ({ tabId: targetId, result })).catch((err) => ({ tabId: targetId, error: err.message }))
+      )
+    );
+  }
   handle(method, handler) {
     this.handlers.set(
       method,
@@ -933,13 +983,32 @@ var RPCHandler = class {
     }
   }
   sendResponse(targetId, callId, result, error) {
-    this.send({
-      type: "RPC_RESPONSE",
-      senderId: this.tabId,
-      targetId,
-      timestamp: monotonic(),
-      payload: { callId, result, error }
-    });
+    try {
+      this.send({
+        type: "RPC_RESPONSE",
+        senderId: this.tabId,
+        targetId,
+        timestamp: monotonic(),
+        payload: { callId, result, error }
+      });
+    } catch (e) {
+      const serErr = new TabSyncError(
+        `Failed to serialize RPC response for "${callId}": ${e instanceof Error ? e.message : String(e)}`,
+        ErrorCode.CHANNEL_SEND_FAILED,
+        e
+      );
+      this.onError(serErr);
+      try {
+        this.send({
+          type: "RPC_RESPONSE",
+          senderId: this.tabId,
+          targetId,
+          timestamp: monotonic(),
+          payload: { callId, result: void 0, error: serErr.message }
+        });
+      } catch {
+      }
+    }
   }
 };
 
@@ -970,7 +1039,8 @@ function destroyMiddleware(middlewares) {
   }
 }
 
-// src/core/tab-sync.ts
+// src/core/persist.ts
+var DEFAULT_KEY = "tab-sync:state";
 function resolvePersistOptions(opt) {
   if (!opt) return null;
   if (opt === true) return {};
@@ -979,12 +1049,23 @@ function resolvePersistOptions(opt) {
 function loadPersistedState(opts) {
   const storage = opts.storage ?? (hasLocalStorage ? localStorage : null);
   if (!storage) return {};
-  const key = opts.key ?? "tab-sync:state";
+  const key = opts.key ?? DEFAULT_KEY;
+  const versionKey = `${key}:version`;
   const deserialize = opts.deserialize ?? JSON.parse;
   try {
     const raw = storage.getItem(key);
     if (!raw) return {};
-    const parsed = deserialize(raw);
+    let parsed = deserialize(raw);
+    if (opts.version !== void 0 && opts.migrate) {
+      const rawVersion = storage.getItem(versionKey);
+      const oldVersion = rawVersion ? Number(rawVersion) : 0;
+      if (oldVersion !== opts.version) {
+        parsed = opts.migrate(parsed, oldVersion);
+        const serialize = opts.serialize ?? JSON.stringify;
+        storage.setItem(key, serialize(parsed));
+        storage.setItem(versionKey, String(opts.version));
+      }
+    }
     return filterPersistKeys(parsed, opts);
   } catch {
     return {};
@@ -1008,9 +1089,10 @@ function createPersistSaver(opts, onError) {
   }, flush() {
   }, destroy() {
   } };
-  const key = opts.key ?? "tab-sync:state";
+  const key = opts.key ?? DEFAULT_KEY;
   const serialize = opts.serialize ?? JSON.stringify;
   const debounce = opts.debounce ?? 100;
+  const versionKey = `${key}:version`;
   let timer = null;
   let latestState = null;
   function doSave() {
@@ -1018,6 +1100,9 @@ function createPersistSaver(opts, onError) {
     try {
       const filtered = filterPersistKeys({ ...latestState }, opts);
       storage.setItem(key, serialize(filtered));
+      if (opts.version !== void 0) {
+        storage.setItem(versionKey, String(opts.version));
+      }
     } catch (e) {
       onError(e instanceof Error ? e : new Error(String(e)));
     }
@@ -1049,15 +1134,8 @@ function createPersistSaver(opts, onError) {
     }
   };
 }
-function createLogger(enabled, tabId) {
-  if (!enabled) return { log: (() => {
-  }) };
-  const prefix = `%c[tab-sync:${tabId.slice(0, 8)}]`;
-  const style = "color:#818cf8;font-weight:600";
-  return {
-    log: (label, ...args) => console.log(prefix, style, label, ...args)
-  };
-}
+
+// src/core/tab-sync.ts
 function createTabSync(options) {
   const opts = options ?? {};
   const tabId = generateTabId();
@@ -1084,7 +1162,7 @@ function createTabSync(options) {
       initialState = { ...initialState, ...restored };
     }
   }
-  const channel = createChannel(channelName, opts.transport);
+  const channel = createChannel(channelName, opts.transport, onError);
   const { log } = createLogger(debug, tabId);
   const send = (message) => {
     log("\u2192", message.type, message.payload);
@@ -1121,6 +1199,7 @@ function createTabSync(options) {
     send,
     tabId,
     resolveLeaderId: () => election?.getLeaderId() ?? null,
+    resolveTabIds: () => registry.getTabs().map((t) => t.id),
     onError
   });
   const unsubChannel = channel.onMessage((message) => {
@@ -1161,7 +1240,11 @@ function createTabSync(options) {
   election?.start();
   let ready = true;
   let destroyed = false;
+  function assertAlive() {
+    if (destroyed) throw TabSyncError.destroyed();
+  }
   function middlewareSet(key, value) {
+    assertAlive();
     if (middlewares.length === 0) {
       stateManager.set(key, value);
       if (persister) persister.save(stateManager.getAll());
@@ -1183,6 +1266,7 @@ function createTabSync(options) {
     if (persister) persister.save(stateManager.getAll());
   }
   function middlewarePatch(partial) {
+    assertAlive();
     if (middlewares.length === 0) {
       stateManager.patch(partial);
       if (persister) persister.save(stateManager.getAll());
@@ -1218,6 +1302,13 @@ function createTabSync(options) {
     getAll: () => stateManager.getAll(),
     set: middlewareSet,
     patch: middlewarePatch,
+    transaction: (fn) => {
+      assertAlive();
+      const current = stateManager.getAll();
+      const result = fn(current);
+      if (result === null) return;
+      middlewarePatch(result);
+    },
     // Subscriptions
     on: (key, callback) => stateManager.on(key, callback),
     once: (key, callback) => {
@@ -1228,15 +1319,30 @@ function createTabSync(options) {
       return unsub;
     },
     onChange: (callback) => stateManager.onChange(callback),
-    select: (selector, callback, isEqual = Object.is) => {
+    select: (selector, callback, options2) => {
+      const isEqual = options2?.isEqual ?? Object.is;
+      const debounceMs = options2?.debounce;
       let prev = selector(stateManager.getAll());
-      return stateManager.onChange((state, _keys, meta) => {
+      let debounceTimer = null;
+      const unsub = stateManager.onChange((state, _keys, meta) => {
         const next = selector(state);
         if (!isEqual(prev, next)) {
           prev = next;
-          callback(next, meta);
+          if (debounceMs !== void 0 && debounceMs > 0) {
+            if (debounceTimer) clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(() => {
+              debounceTimer = null;
+              callback(prev, meta);
+            }, debounceMs);
+          } else {
+            callback(next, meta);
+          }
         }
       });
+      return () => {
+        if (debounceTimer) clearTimeout(debounceTimer);
+        unsub();
+      };
     },
     // Leader
     isLeader: () => election?.isLeader() ?? true,
@@ -1255,6 +1361,13 @@ function createTabSync(options) {
       return registry.getTab(leaderId) ?? null;
     },
     waitForLeader: () => {
+      if (!leaderEnabled) {
+        const selfInfo = registry.getTab(tabId);
+        if (selfInfo) return Promise.resolve(selfInfo);
+        return Promise.reject(
+          new TabSyncError("Leader election is disabled", ErrorCode.RPC_NO_LEADER)
+        );
+      }
       const leader = instance.getLeader();
       if (leader) return Promise.resolve(leader);
       return new Promise((resolve) => {
@@ -1282,8 +1395,18 @@ function createTabSync(options) {
     getTabCount: () => registry.getTabCount(),
     onTabChange: (callback) => registry.onTabChange(callback),
     // RPC
-    call: ((target, method, args, timeout) => rpc.call(target, method, args, timeout)),
-    handle: ((method, handler) => rpc.handle(method, handler)),
+    call: ((target, method, args, timeout) => {
+      assertAlive();
+      return rpc.call(target, method, args, timeout);
+    }),
+    handle: ((method, handler) => {
+      assertAlive();
+      return rpc.handle(method, handler);
+    }),
+    callAll: ((method, args, timeout) => {
+      assertAlive();
+      return rpc.callAll(method, args, timeout);
+    }),
     // Lifecycle
     destroy: () => {
       if (destroyed) return;
@@ -1319,6 +1442,8 @@ exports.TabRegistry = TabRegistry;
 exports.TabSyncError = TabSyncError;
 exports.createBatcher = createBatcher;
 exports.createChannel = createChannel;
+exports.createLogger = createLogger;
+exports.createPersistSaver = createPersistSaver;
 exports.createTabSync = createTabSync;
 exports.destroyMiddleware = destroyMiddleware;
 exports.generateTabId = generateTabId;
@@ -1327,6 +1452,8 @@ exports.hasCrypto = hasCrypto;
 exports.hasDocument = hasDocument;
 exports.hasLocalStorage = hasLocalStorage;
 exports.isBrowser = isBrowser;
+exports.loadPersistedState = loadPersistedState;
 exports.monotonic = monotonic;
 exports.notifyMiddleware = notifyMiddleware;
+exports.resolvePersistOptions = resolvePersistOptions;
 exports.runMiddleware = runMiddleware;