@multiplatform.one/web3 7.25.0 → 7.28.0

package/dist/cjs/core/store.cjs

@@ -0,0 +1,495 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all) __defProp(target, name, {
+    get: all[name],
+    enumerable: true
+  });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from)) if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    });
+  }
+  return to;
+};
+var __toCommonJS = mod => __copyProps(__defProp({}, "__esModule", {
+  value: true
+}), mod);
+var store_exports = {};
+__export(store_exports, {
+  createConnectionStore: () => createConnectionStore,
+  defaultConnectionStorageKey: () => defaultConnectionStorageKey
+});
+module.exports = __toCommonJS(store_exports);
+var import_family = require("./family.cjs");
+const defaultConnectionStorageKey = "mpo.web3.connection";
+const disconnected = Object.freeze({
+  status: "disconnected",
+  family: null,
+  connector: null,
+  address: null,
+  chainId: null,
+  client: null
+});
+const superseded = () => new Error("wallet connect superseded");
+function driverOptions(options) {
+  if (!options || !("silent" in options)) return options;
+  const {
+    silent: _silent,
+    ...rest
+  } = options;
+  return rest;
+}
+function browserStorage() {
+  try {
+    const storage = globalThis.localStorage;
+    return storage && typeof storage.getItem === "function" ? storage : null;
+  } catch {
+    return null;
+  }
+}
+function parseSaved(raw) {
+  if (!raw) return null;
+  try {
+    const value = JSON.parse(raw);
+    return typeof value?.family === "string" && typeof value.connectorId === "string" ? {
+      family: value.family,
+      connectorId: value.connectorId
+    } : null;
+  } catch {
+    return null;
+  }
+}
+const sameConnector = (a, b) => a.id === b.id && a.name === b.name && a.icon === b.icon && a.installed === b.installed;
+const holdersByDriver = /* @__PURE__ */new WeakMap();
+function createConnectionStore(options) {
+  const registry = Array.isArray(options.families) ? (0, import_family.createFamilyRegistry)(options.families) : options.families;
+  const storage = options.storage === void 0 ? browserStorage() : options.storage;
+  const key = options.storageKey ?? defaultConnectionStorageKey;
+  const requestedClose = options.closeTimeout ?? 1e4;
+  const closeTimeout = Number.isNaN(requestedClose) ? 1e4 : Math.max(0, requestedClose);
+  const drivers = /* @__PURE__ */new Map();
+  const holders = /* @__PURE__ */new Map();
+  const listeners = /* @__PURE__ */new Set();
+  const connectorListeners = /* @__PURE__ */new Set();
+  const connectorWatches = /* @__PURE__ */new Map();
+  const closing = /* @__PURE__ */new Map();
+  const inflight = /* @__PURE__ */new Map();
+  let state = disconnected;
+  let active = null;
+  let pending = null;
+  let operation = 0;
+  let clientRequest = 0;
+  let restoring = null;
+  let connectorSnapshot = Object.freeze([]);
+  let destroyed = false;
+  let keptAtDestroy = [];
+  const set = next => {
+    state = next;
+    for (const listener of listeners) listener();
+  };
+  const watchConnectors = driver => {
+    if (connectorListeners.size === 0 || connectorWatches.has(driver) || !driver.watchConnectors) {
+      return;
+    }
+    connectorWatches.set(driver, driver.watchConnectors(() => {
+      for (const listener of connectorListeners) listener();
+    }));
+  };
+  const unwatchConnectors = () => {
+    for (const unwatch of connectorWatches.values()) unwatch();
+    connectorWatches.clear();
+  };
+  const hold = driver => {
+    if (destroyed || holders.has(driver)) return;
+    const held = () => [active, pending].flatMap(entry => entry?.driver === driver ? [entry.connectorId] : []);
+    holders.set(driver, held);
+    let all = holdersByDriver.get(driver);
+    if (!all) {
+      all = /* @__PURE__ */new Set();
+      holdersByDriver.set(driver, all);
+    }
+    all.add(held);
+  };
+  const driverFor = family => {
+    if (family.connectionless || !family.driver) {
+      throw new Error(`wallet family ${family.id} is connectionless; it signs without connecting`);
+    }
+    let driver = drivers.get(family.id);
+    if (!driver) {
+      driver = family.driver();
+      drivers.set(family.id, driver);
+      hold(driver);
+    }
+    watchConnectors(driver);
+    return driver;
+  };
+  const heldElsewhere = driver => [...(holdersByDriver.get(driver) ?? [])].filter(held => held !== holders.get(driver)).flatMap(held => held());
+  const connectorFor = (driver, id) => driver.connectors().find(connector => connector.id === id) ?? {
+    id,
+    name: id
+  };
+  const save = async value => {
+    if (!storage) return;
+    try {
+      if (value) await storage.setItem(key, JSON.stringify(value));else await storage.removeItem(key);
+    } catch {}
+  };
+  const load = async () => {
+    if (!storage) return null;
+    try {
+      return parseSaved(await storage.getItem(key));
+    } catch {
+      return null;
+    }
+  };
+  const closeDriver = (driver, connectorId) => {
+    const previous = closing.get(driver);
+    const run = (async () => {
+      await previous;
+      let timer;
+      const closed = (async () => driver.disconnect(connectorId))().catch(() => {});
+      if (closeTimeout === Number.POSITIVE_INFINITY) await closed;else {
+        await Promise.race([closed, new Promise(resolve => {
+          timer = setTimeout(resolve, Math.min(closeTimeout, 2147483647));
+        })]);
+        clearTimeout(timer);
+      }
+    })();
+    closing.set(driver, run);
+    void run.then(() => {
+      if (closing.get(driver) === run) closing.delete(driver);
+    });
+    return run;
+  };
+  const release = () => {
+    active?.unsubscribe();
+    active = null;
+    clientRequest++;
+  };
+  const closeActive = async () => {
+    const previous = active;
+    release();
+    if (previous) await closeDriver(previous.driver);
+  };
+  const settleStale = async (driver, connectorId, account) => {
+    if (!account) return;
+    const inUse = [...(destroyed ? keptAtDestroy : [active, pending]).filter(entry => entry?.driver === driver).map(entry => entry?.connectorId), ...heldElsewhere(driver)];
+    if (inUse.includes(connectorId)) return;
+    if (inUse.length === 0 && !destroyed) await closeDriver(driver);else await closeDriver(driver, connectorId);
+  };
+  const closeOrphan = async (driver, connectorId) => {
+    const left = driver.getState();
+    if (!left.account) return;
+    if (destroyed) {
+      if (left.connectorId === connectorId) {
+        await settleStale(driver, connectorId, left.account);
+      }
+    } else if (left.connectorId !== null) {
+      await settleStale(driver, left.connectorId, left.account);
+    } else if (![active, pending].some(entry => entry?.driver === driver) && heldElsewhere(driver).length === 0) {
+      await closeDriver(driver);
+    }
+  };
+  const track = (driver, connectorId) => {
+    let counts = inflight.get(driver);
+    if (!counts) {
+      counts = /* @__PURE__ */new Map();
+      inflight.set(driver, counts);
+    }
+    counts.set(connectorId, (counts.get(connectorId) ?? 0) + 1);
+    return () => {
+      const left = (counts.get(connectorId) ?? 1) - 1;
+      if (left > 0) counts.set(connectorId, left);else counts.delete(connectorId);
+    };
+  };
+  const clientFor = (driver, driverState) => {
+    const request = ++clientRequest;
+    let result;
+    try {
+      result = driver.client?.(driverState) ?? null;
+    } catch {
+      return null;
+    }
+    if (result === null || typeof result.then !== "function") {
+      return result;
+    }
+    result.then(client => {
+      if (request === clientRequest && active?.driver === driver && client) {
+        set(Object.freeze({
+          ...state,
+          client
+        }));
+      }
+    }, () => {});
+    return null;
+  };
+  const activate = (family, driver, connector, account) => {
+    release();
+    const onChange = () => {
+      if (active?.driver !== driver) return;
+      const driverState = driver.getState();
+      if (!driverState.account) {
+        if (driverState.status === "connecting" || driverState.status === "reconnecting") return;
+        release();
+        operation++;
+        set(disconnected);
+        return;
+      }
+      const connectorId = driverState.connectorId ?? active.connectorId;
+      if (connectorId !== active.connectorId && inflight.get(driver)?.get(connectorId)) return;
+      const chainId = driverState.account.chainId ?? null;
+      if (connectorId === state.connector?.id && driverState.account.address === state.address && chainId === state.chainId) {
+        return;
+      }
+      const nextConnector = connectorId === state.connector?.id && state.connector ? state.connector : connectorFor(driver, connectorId);
+      if (connectorId !== active.connectorId) {
+        active.connectorId = connectorId;
+        void save({
+          family: family.id,
+          connectorId
+        });
+      }
+      set(Object.freeze({
+        status: "connected",
+        family: family.id,
+        connector: nextConnector,
+        address: driverState.account.address,
+        chainId,
+        client: clientFor(driver, {
+          ...driverState,
+          connectorId
+        })
+      }));
+    };
+    active = {
+      driver,
+      connectorId: connector.id,
+      unsubscribe: driver.subscribe(onChange)
+    };
+    set(Object.freeze({
+      status: "connected",
+      family: family.id,
+      connector,
+      address: account.address,
+      chainId: account.chainId ?? null,
+      client: clientFor(driver, {
+        status: "connected",
+        connectorId: connector.id,
+        account
+      })
+    }));
+  };
+  return {
+    registry,
+    getState: () => state,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    },
+    connectors() {
+      const next = [];
+      for (const family of registry.families) {
+        if (family.connectionless) continue;
+        for (const connector of driverFor(family).connectors()) {
+          next.push({
+            family: family.id,
+            connector
+          });
+        }
+      }
+      const unchanged = next.length === connectorSnapshot.length && next.every((entry, index) => {
+        const previous = connectorSnapshot[index];
+        return previous !== void 0 && entry.family === previous.family && sameConnector(entry.connector, previous.connector);
+      });
+      if (!unchanged) connectorSnapshot = Object.freeze(next.map(entry => Object.freeze(entry)));
+      return connectorSnapshot;
+    },
+    subscribeConnectors(listener) {
+      connectorListeners.add(listener);
+      for (const family of registry.families) if (!family.connectionless) driverFor(family);
+      return () => {
+        connectorListeners.delete(listener);
+        if (connectorListeners.size === 0) unwatchConnectors();
+      };
+    },
+    async connect(familyName, connectorId, connectOptions) {
+      if (destroyed) throw new Error("this connection store was destroyed");
+      const family = registry.require(familyName);
+      const driver = driverFor(family);
+      const connector = connectorFor(driver, connectorId);
+      const current = ++operation;
+      restoring = null;
+      pending = {
+        driver,
+        connectorId
+      };
+      const closingActive = closeActive();
+      set(Object.freeze({
+        ...disconnected,
+        status: "connecting",
+        family: family.id,
+        connector
+      }));
+      await closingActive;
+      if (current === operation) await save(null);
+      await closing.get(driver);
+      const untrack = track(driver, connectorId);
+      let account;
+      let asked = false;
+      try {
+        try {
+          if (current !== operation) throw superseded();
+          asked = true;
+          if (connectOptions?.silent) {
+            const granted = await driver.reconnect(connectorId);
+            if (!granted) {
+              throw new Error(`wallet ${family.id} ${connectorId} is not authorised on this page`);
+            }
+            account = granted;
+          } else {
+            account = await driver.connect(connectorId, driverOptions(connectOptions));
+          }
+        } catch (error) {
+          if (current === operation) {
+            pending = null;
+            set(disconnected);
+          }
+          if (!connectOptions?.silent && (asked || !destroyed)) {
+            await closeOrphan(driver, connectorId);
+          }
+          throw error;
+        }
+        if (current !== operation) {
+          await settleStale(driver, connectorId, account);
+          throw superseded();
+        }
+      } finally {
+        untrack();
+      }
+      pending = null;
+      activate(family, driver, connector, account);
+      await save({
+        family: family.id,
+        connectorId
+      });
+      return state;
+    },
+    async disconnect() {
+      operation++;
+      restoring = null;
+      pending = null;
+      const closingActive = closeActive();
+      set(disconnected);
+      await save(null);
+      await closingActive;
+    },
+    reconnect() {
+      if (restoring) return restoring;
+      if (destroyed || state.status !== "disconnected") return Promise.resolve(state);
+      const current = ++operation;
+      const attempt = (async () => {
+        const saved = await load();
+        if (current !== operation || !saved) return state;
+        const family = registry.get(saved.family);
+        if (!family || family.connectionless || !family.driver) return state;
+        const driver = driverFor(family);
+        const connector = connectorFor(driver, saved.connectorId);
+        pending = {
+          driver,
+          connectorId: saved.connectorId
+        };
+        set(Object.freeze({
+          ...disconnected,
+          status: "reconnecting",
+          family: family.id,
+          connector
+        }));
+        await closing.get(driver);
+        const untrack = track(driver, saved.connectorId);
+        let account;
+        try {
+          try {
+            if (current !== operation) return state;
+            account = await driver.reconnect(saved.connectorId);
+          } catch {
+            if (current === operation) {
+              pending = null;
+              set(disconnected);
+            }
+            await closeOrphan(driver, saved.connectorId);
+            return state;
+          }
+          if (current !== operation) {
+            await settleStale(driver, saved.connectorId, account);
+            return state;
+          }
+        } finally {
+          untrack();
+        }
+        pending = null;
+        if (!account) {
+          set(disconnected);
+          await save(null);
+          await closeOrphan(driver, saved.connectorId);
+          return state;
+        }
+        activate(family, driver, connector, account);
+        return state;
+      })();
+      restoring = attempt;
+      const settled = () => {
+        if (restoring === attempt) restoring = null;
+      };
+      void attempt.then(settled, settled);
+      return attempt;
+    },
+    async client() {
+      if (state.client) return state.client;
+      if (state.status !== "connected" || !active || !state.address) return null;
+      const {
+        driver,
+        connectorId
+      } = active;
+      const asked = state;
+      const request = ++clientRequest;
+      const client = (await driver.client?.({
+        status: "connected",
+        connectorId,
+        account: {
+          address: asked.address,
+          ...(asked.chainId === null ? {} : {
+            chainId: asked.chainId
+          })
+        }
+      })) ?? null;
+      if (client && request === clientRequest && active?.driver === driver && state.status === "connected" && state.address === asked.address && state.chainId === asked.chainId) {
+        set(Object.freeze({
+          ...state,
+          client
+        }));
+      }
+      return client;
+    },
+    destroy() {
+      if (destroyed) return;
+      destroyed = true;
+      keptAtDestroy = [active, pending];
+      for (const [driver, held] of holders) holdersByDriver.get(driver)?.delete(held);
+      operation++;
+      restoring = null;
+      pending = null;
+      release();
+      unwatchConnectors();
+      connectorListeners.clear();
+      listeners.clear();
+    }
+  };
+}