@0xkey-io/react-wallet-kit 0.1.0

package/dist/utils/oauth/url.mjs

@@ -0,0 +1,230 @@
+import { createForOfIteratorHelper as _createForOfIteratorHelper, slicedToArray as _slicedToArray } from '../../_virtual/_rollupPluginBabelHelpers.mjs';
+import { OAuthProviders } from '@0xkey-io/sdk-types';
+import { OAUTH_PROVIDER_CONFIGS, popupWidth, popupHeight } from './config.mjs';
+
+/**
+ * Builds the OAuth state parameter string
+ */
+function buildOAuthState(params) {
+  var provider = params.provider,
+    flow = params.flow,
+    publicKey = params.publicKey,
+    nonce = params.nonce,
+    additionalState = params.additionalState;
+  var state = "provider=".concat(provider, "&flow=").concat(flow, "&publicKey=").concat(encodeURIComponent(publicKey));
+  if (nonce) {
+    state += "&nonce=".concat(nonce);
+  }
+  if (additionalState) {
+    var extra = Object.entries(additionalState).map(function (_ref) {
+      var _ref2 = _slicedToArray(_ref, 2),
+        k = _ref2[0],
+        v = _ref2[1];
+      return "".concat(encodeURIComponent(k), "=").concat(encodeURIComponent(v));
+    }).join("&");
+    if (extra) {
+      state += "&".concat(extra);
+    }
+  }
+  return state;
+}
+/**
+ * Opens a centered OAuth popup window
+ */
+function openOAuthPopup() {
+  var width = popupWidth;
+  var height = popupHeight;
+  var left = window.screenX + (window.innerWidth - width) / 2;
+  var top = window.screenY + (window.innerHeight - height) / 2;
+  return window.open("about:blank", "_blank", "width=".concat(width, ",height=").concat(height, ",top=").concat(top, ",left=").concat(left, ",scrollbars=yes,resizable=yes"));
+}
+/**
+ * Redirects to OAuth provider URL
+ */
+function redirectToOAuthProvider(url) {
+  window.location.href = url;
+  var timeLimit = 5 * 60 * 1000; // 5 minutes
+  return new Promise(function (_, reject) {
+    var timeout = setTimeout(function () {
+      reject(new Error("Authentication timed out."));
+    }, timeLimit);
+    window.addEventListener("beforeunload", function () {
+      return clearTimeout(timeout);
+    });
+  });
+}
+/**
+ * Cleans up OAuth parameters from URL (removes hash and search)
+ */
+function cleanupOAuthUrl() {
+  window.history.replaceState(null, document.title, window.location.pathname);
+}
+/**
+ * Cleans up OAuth hash from URL but preserves search parameters
+ */
+function cleanupOAuthUrlPreserveSearch() {
+  window.history.replaceState(null, document.title, window.location.pathname + window.location.search);
+}
+/**
+ * Parses the OAuth state parameter string into an object
+ */
+function parseStateParam(stateParam) {
+  if (!stateParam) return {};
+  var result = {};
+  var pairs = stateParam.split("&");
+  var _iterator = _createForOfIteratorHelper(pairs),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var pair = _step.value;
+      var _pair$split = pair.split("="),
+        _pair$split2 = _slicedToArray(_pair$split, 2),
+        key = _pair$split2[0],
+        value = _pair$split2[1];
+      if (key && value !== undefined) {
+        result[key] = decodeURIComponent(value);
+      }
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return result;
+}
+/**
+ * Unified OAuth response parser for both popup and redirect flows.
+ * Handles both:
+ * - PKCE flows (Facebook, Discord, X): code in search parameters
+ * - Non-PKCE flows (Google, Apple): id_token in hash parameters
+ * - Apple's non-standard hash format where state parameters are directly embedded
+ *
+ * @param url - The full URL to parse (from popup or redirect)
+ * @param expectedProvider - Optional provider if already known (for popup flows)
+ * @returns Parsed OAuth response data including tokens, codes, and state parameters, or null if invalid
+ */
+function parseOAuthResponse(url, expectedProvider) {
+  var idToken = null;
+  var authCode = null;
+  var stateString = null;
+  var parsedUrl = new URL(url);
+  var search = parsedUrl.search.substring(1); // Remove leading '?'
+  var hash = parsedUrl.hash.substring(1); // Remove leading '#'
+  // Handle PKCE flows (code in search parameters)
+  if (search && search.includes("code=")) {
+    var searchParams = new URLSearchParams(search);
+    authCode = searchParams.get("code");
+    stateString = searchParams.get("state");
+  }
+  // Handle non-PKCE flows (id_token in hash)
+  else if (hash) {
+    // Handle Apple's non-standard format: state=provider=apple&flow=redirect&...&code=...&id_token=...
+    if (hash.startsWith("state=provider=apple")) {
+      // Extract id_token from the end
+      var idTokenMatch = hash.match(/id_token=([^&]+)$/);
+      idToken = idTokenMatch ? idTokenMatch[1] : null;
+      // Extract state content between "state=" and "&code="
+      var stateEndIndex = hash.indexOf("&code=");
+      if (stateEndIndex !== -1) {
+        stateString = hash.substring(6, stateEndIndex); // Remove "state=" prefix
+      }
+    } else {
+      // Standard OAuth format - parse as URLSearchParams
+      var hashParams = new URLSearchParams(hash);
+      idToken = hashParams.get("id_token");
+      stateString = hashParams.get("state");
+    }
+  }
+  // Parse state parameters
+  var _parseStateParam = parseStateParam(stateString),
+    provider = _parseStateParam.provider,
+    flow = _parseStateParam.flow,
+    publicKey = _parseStateParam.publicKey,
+    openModal = _parseStateParam.openModal,
+    sessionKey = _parseStateParam.sessionKey,
+    oauthIntent = _parseStateParam.oauthIntent,
+    nonce = _parseStateParam.nonce,
+    redirectUri = _parseStateParam.redirectUri;
+  // If we have an expected provider (popup flow), validate it matches
+  if (expectedProvider) {
+    var config = OAUTH_PROVIDER_CONFIGS[expectedProvider];
+    if (config.usesPKCE) {
+      // PKCE providers must have authCode and matching provider in state
+      if (!authCode || !stateString || provider !== expectedProvider) {
+        return null;
+      }
+    } else {
+      // Non-PKCE providers must have idToken
+      if (!idToken) {
+        return null;
+      }
+    }
+  }
+  return {
+    idToken: idToken,
+    authCode: authCode,
+    provider: provider !== null && provider !== void 0 ? provider : null,
+    flow: flow !== null && flow !== void 0 ? flow : null,
+    publicKey: publicKey !== null && publicKey !== void 0 ? publicKey : null,
+    openModal: openModal !== null && openModal !== void 0 ? openModal : null,
+    sessionKey: sessionKey !== null && sessionKey !== void 0 ? sessionKey : undefined,
+    oauthIntent: oauthIntent !== null && oauthIntent !== void 0 ? oauthIntent : null,
+    nonce: nonce !== null && nonce !== void 0 ? nonce : null,
+    redirectUri: redirectUri !== null && redirectUri !== void 0 ? redirectUri : null
+  };
+}
+/**
+ * Builds the complete OAuth authorization URL for a provider
+ */
+function buildOAuthUrl(params) {
+  var provider = params.provider,
+    clientId = params.clientId,
+    redirectUri = params.redirectUri,
+    publicKey = params.publicKey,
+    nonce = params.nonce,
+    flow = params.flow,
+    codeChallenge = params.codeChallenge,
+    additionalState = params.additionalState;
+  var config = OAUTH_PROVIDER_CONFIGS[provider];
+  var authUrl = new URL(config.authUrl);
+  authUrl.searchParams.set("client_id", clientId);
+  authUrl.searchParams.set("redirect_uri", redirectUri);
+  authUrl.searchParams.set("response_type", config.responseType);
+  if (config.scopes) {
+    authUrl.searchParams.set("scope", config.scopes);
+  }
+  if (config.responseMode) {
+    authUrl.searchParams.set("response_mode", config.responseMode);
+  }
+  // PKCE parameters
+  if (config.usesPKCE && codeChallenge) {
+    authUrl.searchParams.set("code_challenge", codeChallenge);
+    authUrl.searchParams.set("code_challenge_method", "S256");
+  }
+  // Nonce handling - some providers want it in URL params, others in state
+  if (config.nonceInParams) {
+    authUrl.searchParams.set("nonce", nonce);
+  }
+  // Google-specific: prompt for account selection
+  if (provider === OAuthProviders.GOOGLE) {
+    authUrl.searchParams.set("prompt", "select_account");
+  }
+  // Build state parameter
+  var stateParams = {
+    provider: provider,
+    flow: flow,
+    publicKey: publicKey
+  };
+  // Include nonce in state for providers that need it there (not in URL params)
+  if (!config.nonceInParams) {
+    stateParams.nonce = nonce;
+  }
+  if (additionalState) {
+    stateParams.additionalState = additionalState;
+  }
+  authUrl.searchParams.set("state", buildOAuthState(stateParams));
+  return authUrl.toString();
+}
+
+export { buildOAuthState, buildOAuthUrl, cleanupOAuthUrl, cleanupOAuthUrlPreserveSearch, openOAuthPopup, parseOAuthResponse, parseStateParam, redirectToOAuthProvider };
+//# sourceMappingURL=url.mjs.map

package/dist/utils/oauth/url.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.mjs","sources":["../../../src/utils/oauth/url.ts"],"sourcesContent":[null],"names":["buildOAuthState","params","provider","flow","publicKey","nonce","additionalState","state","concat","encodeURIComponent","extra","Object","entries","map","_ref","_ref2","_slicedToArray","k","v","join","openOAuthPopup","width","popupWidth","height","popupHeight","left","window","screenX","innerWidth","top","screenY","innerHeight","open","redirectToOAuthProvider","url","location","href","timeLimit","Promise","_","reject","timeout","setTimeout","Error","addEventListener","clearTimeout","cleanupOAuthUrl","history","replaceState","document","title","pathname","cleanupOAuthUrlPreserveSearch","search","parseStateParam","stateParam","result","pairs","split","_iterator","_createForOfIteratorHelper","_step","s","n","done","pair","value","_pair$split","_pair$split2","key","undefined","decodeURIComponent","err","e","f","parseOAuthResponse","expectedProvider","idToken","authCode","stateString","parsedUrl","URL","substring","hash","includes","searchParams","URLSearchParams","get","startsWith","idTokenMatch","match","stateEndIndex","indexOf","hashParams","_parseStateParam","openModal","sessionKey","oauthIntent","redirectUri","config","OAUTH_PROVIDER_CONFIGS","usesPKCE","buildOAuthUrl","clientId","codeChallenge","authUrl","set","responseType","scopes","responseMode","nonceInParams","OAuthProviders","GOOGLE","stateParams","toString"],"mappings":"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"}

package/dist/utils/timers.d.ts

@@ -0,0 +1,73 @@
+export type TimerController = {
+    clear: () => void;
+};
+export type TimerMap = Record<string, TimerController>;
+export declare const MAX_DELAY_MS = 2147483647;
+/**
+ * @internal A drop-in replacement for `setTimeout` that supports arbitrarily long delays.
+ *
+ * ### Why?
+ * Browsers clamp `setTimeout` delays to a 32-bit signed integer,
+ * i.e. a maximum of ~24.8 days (`2_147_483_647ms`). Any larger value
+ * will fire almost immediately. This helper safely schedules timeouts
+ * that can be months or years into the future.
+ *
+ * ### How it works
+ * - On call, we record a fixed **target timestamp** (`now + delayMs`).
+ * - We schedule a single "leg" of at most ~24.8 days into the future,
+ *   with an internal `tick` function as the callback.
+ * - When a leg expires, `tick` checks how much time is left:
+ *   - If `remaining > 0`, it schedules the next leg (`min(MAX_DELAY_MS, remaining)`).
+ *   - If `remaining <= 0`, the full delay has passed and we finally call your `cb()`.
+ * - At any time, only **one** leg is active. Calling `.clear()` cancels
+ *   the current leg and prevents further hops.
+ *
+ * ### Benefits
+ * - Works seamlessly for both short and very long delays.
+ * - Survives tab sleep / system suspend: when the tab wakes,
+ *   `tick` re-checks the target timestamp and fires immediately if overdue.
+ * - No drift accumulation: each hop recalculates based on the fixed target,
+ *   so you always land as close as possible to the intended deadline.
+ *
+ * ### Example
+ * ```ts
+ * const controller = setCappedTimeout(() => {
+ *   console.log("A whole year later!");
+ * }, 1000 * 60 * 60 * 24 * 365);
+ *
+ * // Cancel if needed
+ * controller.clear();
+ * ```
+ *
+ * @param cb - Function to run once the full delay has elapsed.
+ * @param delayMs - Delay in milliseconds (can exceed 2_147_483_647).
+ * @returns A controller with a `.clear()` method to cancel the timeout.
+ */
+export declare function setCappedTimeout(cb: () => void, delayMs: number): TimerController;
+/** @internal Simple one-shot timeout that still returns a controller for uniformity. */
+export declare function setTimeoutController(cb: () => void, delayMs: number): TimerController;
+/** @internal Replace any existing timer for `key` with `controller`. */
+export declare function putTimer(map: TimerMap, key: string, controller: TimerController): void;
+/** @internal Clear a specific key (noop if missing). */
+export declare function clearKey(map: TimerMap, key: string): void;
+/** @internal Clear several keys at once (noop on missing). */
+export declare function clearKeys(map: TimerMap, keys: string[]): void;
+/** @internal Clear all timers in the map. */
+export declare function clearAll(map: TimerMap): void;
+/**
+ * @internal Convenience: set a capped timeout directly into the map for `key`.
+ * @param map The map to store the timer in (pass in the ref to the timer map)
+ * @param key The key to associate with the timer
+ * @param cb The callback to invoke when the timer expires
+ * @param delayMs The delay in milliseconds before the timer expires
+ * */
+export declare function setCappedTimeoutInMap(map: TimerMap, key: string, cb: () => void, delayMs: number): void;
+/**
+ * @internal Convenience: set a regular (short) timeout into the map for `key`.
+ * @param map The map to store the timer in (pass in the ref to the timer map)
+ * @param key The key to associate with the timer
+ * @param cb The callback to invoke when the timer expires
+ * @param delayMs The delay in milliseconds before the timer expires
+ */
+export declare function setTimeoutInMap(map: TimerMap, key: string, cb: () => void, delayMs: number): void;
+//# sourceMappingURL=timers.d.ts.map

package/dist/utils/timers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../src/utils/timers.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AACpD,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEvD,eAAO,MAAM,YAAY,aAAgB,CAAC;AAO1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,MAAM,IAAI,EACd,OAAO,EAAE,MAAM,GACd,eAAe,CAuBjB;AAED,wFAAwF;AACxF,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,MAAM,IAAI,EACd,OAAO,EAAE,MAAM,GACd,eAAe,CAIjB;AAED,wEAAwE;AACxE,wBAAgB,QAAQ,CACtB,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,eAAe,QAI5B;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,QAGlD;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAEtD;AAED,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,QAKrC;AAED;;;;;;KAMK;AACL,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,IAAI,EACd,OAAO,EAAE,MAAM,QAGhB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,MAAM,EACX,EAAE,EAAE,MAAM,IAAI,EACd,OAAO,EAAE,MAAM,QAGhB"}

package/dist/utils/timers.js

@@ -0,0 +1,133 @@
+'use strict';
+
+// This file contains utility functions for managing timers and timeouts for session management.
+// Unfortunately, the delay param in Node Timeouts is a 32-bit signed integer, meaning it can only represent delays up to ~24.8 days.
+// This file provides functions to handle long delays by breaking them into smaller chunks.
+// These functions are separate from the normal utils function to reduce clutter and improve visibility.
+// Use `setTimeoutInMap` for short, frequent nudges (10s), and `setCappedTimeoutInMap` for anything that could exceed ~24.8 days.
+const MAX_DELAY_MS = 2_147_483_647; // ~24.8 days
+/** @internal */
+function toIntMs(x) {
+  return Math.max(0, Math.floor(Number.isFinite(x) ? x : 0));
+}
+/**
+ * @internal A drop-in replacement for `setTimeout` that supports arbitrarily long delays.
+ *
+ * ### Why?
+ * Browsers clamp `setTimeout` delays to a 32-bit signed integer,
+ * i.e. a maximum of ~24.8 days (`2_147_483_647ms`). Any larger value
+ * will fire almost immediately. This helper safely schedules timeouts
+ * that can be months or years into the future.
+ *
+ * ### How it works
+ * - On call, we record a fixed **target timestamp** (`now + delayMs`).
+ * - We schedule a single "leg" of at most ~24.8 days into the future,
+ *   with an internal `tick` function as the callback.
+ * - When a leg expires, `tick` checks how much time is left:
+ *   - If `remaining > 0`, it schedules the next leg (`min(MAX_DELAY_MS, remaining)`).
+ *   - If `remaining <= 0`, the full delay has passed and we finally call your `cb()`.
+ * - At any time, only **one** leg is active. Calling `.clear()` cancels
+ *   the current leg and prevents further hops.
+ *
+ * ### Benefits
+ * - Works seamlessly for both short and very long delays.
+ * - Survives tab sleep / system suspend: when the tab wakes,
+ *   `tick` re-checks the target timestamp and fires immediately if overdue.
+ * - No drift accumulation: each hop recalculates based on the fixed target,
+ *   so you always land as close as possible to the intended deadline.
+ *
+ * ### Example
+ * ```ts
+ * const controller = setCappedTimeout(() => {
+ *   console.log("A whole year later!");
+ * }, 1000 * 60 * 60 * 24 * 365);
+ *
+ * // Cancel if needed
+ * controller.clear();
+ * ```
+ *
+ * @param cb - Function to run once the full delay has elapsed.
+ * @param delayMs - Delay in milliseconds (can exceed 2_147_483_647).
+ * @returns A controller with a `.clear()` method to cancel the timeout.
+ */
+function setCappedTimeout(cb, delayMs) {
+  const target = Date.now() + toIntMs(delayMs);
+  let handle;
+  const tick = () => {
+    const remaining = target - Date.now();
+    if (remaining <= 0) {
+      cb();
+      return;
+    }
+    handle = window.setTimeout(tick, Math.min(MAX_DELAY_MS, remaining));
+  };
+  tick();
+  return {
+    clear() {
+      if (handle !== undefined) {
+        window.clearTimeout(handle);
+        handle = undefined;
+      }
+    }
+  };
+}
+/** @internal Simple one-shot timeout that still returns a controller for uniformity. */
+function setTimeoutController(cb, delayMs) {
+  const ms = toIntMs(delayMs);
+  let id = window.setTimeout(cb, ms);
+  return {
+    clear: () => window.clearTimeout(id)
+  };
+}
+/** @internal Replace any existing timer for `key` with `controller`. */
+function putTimer(map, key, controller) {
+  map[key]?.clear?.();
+  map[key] = controller;
+}
+/** @internal Clear a specific key (noop if missing). */
+function clearKey(map, key) {
+  map[key]?.clear?.();
+  delete map[key];
+}
+/** @internal Clear several keys at once (noop on missing). */
+function clearKeys(map, keys) {
+  for (const k of keys) clearKey(map, k);
+}
+/** @internal Clear all timers in the map. */
+function clearAll(map) {
+  for (const k of Object.keys(map)) {
+    map[k]?.clear?.();
+    delete map[k];
+  }
+}
+/**
+ * @internal Convenience: set a capped timeout directly into the map for `key`.
+ * @param map The map to store the timer in (pass in the ref to the timer map)
+ * @param key The key to associate with the timer
+ * @param cb The callback to invoke when the timer expires
+ * @param delayMs The delay in milliseconds before the timer expires
+ * */
+function setCappedTimeoutInMap(map, key, cb, delayMs) {
+  putTimer(map, key, setCappedTimeout(cb, delayMs));
+}
+/**
+ * @internal Convenience: set a regular (short) timeout into the map for `key`.
+ * @param map The map to store the timer in (pass in the ref to the timer map)
+ * @param key The key to associate with the timer
+ * @param cb The callback to invoke when the timer expires
+ * @param delayMs The delay in milliseconds before the timer expires
+ */
+function setTimeoutInMap(map, key, cb, delayMs) {
+  putTimer(map, key, setTimeoutController(cb, delayMs));
+}
+
+exports.MAX_DELAY_MS = MAX_DELAY_MS;
+exports.clearAll = clearAll;
+exports.clearKey = clearKey;
+exports.clearKeys = clearKeys;
+exports.putTimer = putTimer;
+exports.setCappedTimeout = setCappedTimeout;
+exports.setCappedTimeoutInMap = setCappedTimeoutInMap;
+exports.setTimeoutController = setTimeoutController;
+exports.setTimeoutInMap = setTimeoutInMap;
+//# sourceMappingURL=timers.js.map

package/dist/utils/timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.js","sources":["../../src/utils/timers.ts"],"sourcesContent":[null],"names":["MAX_DELAY_MS","toIntMs","x","Math","max","floor","Number","isFinite","setCappedTimeout","cb","delayMs","target","Date","now","handle","tick","remaining","window","setTimeout","min","clear","undefined","clearTimeout","setTimeoutController","ms","id","putTimer","map","key","controller","clearKey","clearKeys","keys","k","clearAll","Object","setCappedTimeoutInMap","setTimeoutInMap"],"mappings":"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"}

package/dist/utils/timers.mjs

@@ -0,0 +1,142 @@
+import { createForOfIteratorHelper as _createForOfIteratorHelper } from '../_virtual/_rollupPluginBabelHelpers.mjs';
+
+// This file contains utility functions for managing timers and timeouts for session management.
+// Unfortunately, the delay param in Node Timeouts is a 32-bit signed integer, meaning it can only represent delays up to ~24.8 days.
+// This file provides functions to handle long delays by breaking them into smaller chunks.
+// These functions are separate from the normal utils function to reduce clutter and improve visibility.
+// Use `setTimeoutInMap` for short, frequent nudges (10s), and `setCappedTimeoutInMap` for anything that could exceed ~24.8 days.
+var MAX_DELAY_MS = 2147483647; // ~24.8 days
+/** @internal */
+function toIntMs(x) {
+  return Math.max(0, Math.floor(Number.isFinite(x) ? x : 0));
+}
+/**
+ * @internal A drop-in replacement for `setTimeout` that supports arbitrarily long delays.
+ *
+ * ### Why?
+ * Browsers clamp `setTimeout` delays to a 32-bit signed integer,
+ * i.e. a maximum of ~24.8 days (`2_147_483_647ms`). Any larger value
+ * will fire almost immediately. This helper safely schedules timeouts
+ * that can be months or years into the future.
+ *
+ * ### How it works
+ * - On call, we record a fixed **target timestamp** (`now + delayMs`).
+ * - We schedule a single "leg" of at most ~24.8 days into the future,
+ *   with an internal `tick` function as the callback.
+ * - When a leg expires, `tick` checks how much time is left:
+ *   - If `remaining > 0`, it schedules the next leg (`min(MAX_DELAY_MS, remaining)`).
+ *   - If `remaining <= 0`, the full delay has passed and we finally call your `cb()`.
+ * - At any time, only **one** leg is active. Calling `.clear()` cancels
+ *   the current leg and prevents further hops.
+ *
+ * ### Benefits
+ * - Works seamlessly for both short and very long delays.
+ * - Survives tab sleep / system suspend: when the tab wakes,
+ *   `tick` re-checks the target timestamp and fires immediately if overdue.
+ * - No drift accumulation: each hop recalculates based on the fixed target,
+ *   so you always land as close as possible to the intended deadline.
+ *
+ * ### Example
+ * ```ts
+ * const controller = setCappedTimeout(() => {
+ *   console.log("A whole year later!");
+ * }, 1000 * 60 * 60 * 24 * 365);
+ *
+ * // Cancel if needed
+ * controller.clear();
+ * ```
+ *
+ * @param cb - Function to run once the full delay has elapsed.
+ * @param delayMs - Delay in milliseconds (can exceed 2_147_483_647).
+ * @returns A controller with a `.clear()` method to cancel the timeout.
+ */
+function setCappedTimeout(cb, delayMs) {
+  var target = Date.now() + toIntMs(delayMs);
+  var handle;
+  var _tick = function tick() {
+    var remaining = target - Date.now();
+    if (remaining <= 0) {
+      cb();
+      return;
+    }
+    handle = window.setTimeout(_tick, Math.min(MAX_DELAY_MS, remaining));
+  };
+  _tick();
+  return {
+    clear: function clear() {
+      if (handle !== undefined) {
+        window.clearTimeout(handle);
+        handle = undefined;
+      }
+    }
+  };
+}
+/** @internal Simple one-shot timeout that still returns a controller for uniformity. */
+function setTimeoutController(cb, delayMs) {
+  var ms = toIntMs(delayMs);
+  var id = window.setTimeout(cb, ms);
+  return {
+    clear: function clear() {
+      return window.clearTimeout(id);
+    }
+  };
+}
+/** @internal Replace any existing timer for `key` with `controller`. */
+function putTimer(map, key, controller) {
+  var _map$key, _map$key$clear;
+  (_map$key = map[key]) === null || _map$key === void 0 ? void 0 : (_map$key$clear = _map$key.clear) === null || _map$key$clear === void 0 ? void 0 : _map$key$clear.call(_map$key);
+  map[key] = controller;
+}
+/** @internal Clear a specific key (noop if missing). */
+function clearKey(map, key) {
+  var _map$key2, _map$key2$clear;
+  (_map$key2 = map[key]) === null || _map$key2 === void 0 ? void 0 : (_map$key2$clear = _map$key2.clear) === null || _map$key2$clear === void 0 ? void 0 : _map$key2$clear.call(_map$key2);
+  delete map[key];
+}
+/** @internal Clear several keys at once (noop on missing). */
+function clearKeys(map, keys) {
+  var _iterator = _createForOfIteratorHelper(keys),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var k = _step.value;
+      clearKey(map, k);
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+}
+/** @internal Clear all timers in the map. */
+function clearAll(map) {
+  for (var _i = 0, _Object$keys = Object.keys(map); _i < _Object$keys.length; _i++) {
+    var _map$k, _map$k$clear;
+    var k = _Object$keys[_i];
+    (_map$k = map[k]) === null || _map$k === void 0 ? void 0 : (_map$k$clear = _map$k.clear) === null || _map$k$clear === void 0 ? void 0 : _map$k$clear.call(_map$k);
+    delete map[k];
+  }
+}
+/**
+ * @internal Convenience: set a capped timeout directly into the map for `key`.
+ * @param map The map to store the timer in (pass in the ref to the timer map)
+ * @param key The key to associate with the timer
+ * @param cb The callback to invoke when the timer expires
+ * @param delayMs The delay in milliseconds before the timer expires
+ * */
+function setCappedTimeoutInMap(map, key, cb, delayMs) {
+  putTimer(map, key, setCappedTimeout(cb, delayMs));
+}
+/**
+ * @internal Convenience: set a regular (short) timeout into the map for `key`.
+ * @param map The map to store the timer in (pass in the ref to the timer map)
+ * @param key The key to associate with the timer
+ * @param cb The callback to invoke when the timer expires
+ * @param delayMs The delay in milliseconds before the timer expires
+ */
+function setTimeoutInMap(map, key, cb, delayMs) {
+  putTimer(map, key, setTimeoutController(cb, delayMs));
+}
+
+export { MAX_DELAY_MS, clearAll, clearKey, clearKeys, putTimer, setCappedTimeout, setCappedTimeoutInMap, setTimeoutController, setTimeoutInMap };
+//# sourceMappingURL=timers.mjs.map

package/dist/utils/timers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.mjs","sources":["../../src/utils/timers.ts"],"sourcesContent":[null],"names":["MAX_DELAY_MS","toIntMs","x","Math","max","floor","Number","isFinite","setCappedTimeout","cb","delayMs","target","Date","now","handle","tick","remaining","window","setTimeout","min","clear","undefined","clearTimeout","setTimeoutController","ms","id","putTimer","map","key","controller","_map$key","_map$key$clear","call","clearKey","_map$key2","_map$key2$clear","clearKeys","keys","_iterator","_createForOfIteratorHelper","_step","s","n","done","k","value","err","e","f","clearAll","_i","_Object$keys","Object","length","_map$k","_map$k$clear","setCappedTimeoutInMap","setTimeoutInMap"],"mappings":"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"}

package/dist/utils/utils.d.ts

@@ -0,0 +1,40 @@
+import { Session, ZeroXKeyError, ZeroXKeyErrorCodes } from "@0xkey-io/sdk-types";
+import { type Wallet, WalletProvider } from "@0xkey-io/core";
+export declare const SESSION_WARNING_THRESHOLD_MS: number;
+export declare const authErrors: {
+    passkey: {
+        createFailed: string;
+        loginFailed: string;
+        timeoutOrNotAllowed: string;
+    };
+    otp: {
+        sendFailed: string;
+        invalidEmail: string;
+        invalidPhone: string;
+    };
+    oauth: {
+        loginFailed: string;
+    };
+    wallet: {
+        loginFailed: string;
+        noPublicKey: string;
+    };
+    suborg: {
+        fetchFailed: string;
+        createFailed: string;
+    };
+};
+export declare const useDebouncedCallback: <T extends (...args: any[]) => void>(fn: T, wait?: number) => T;
+export declare const isValidSession: (session?: Session | undefined) => boolean;
+export declare function withZeroXKeyErrorHandling<T>(fn: () => Promise<T>, sessionExpireFn?: () => Promise<void>, callbacks?: {
+    onError?: (error: ZeroXKeyError) => void;
+}, fallbackMessage?: string, fallbackCode?: ZeroXKeyErrorCodes): Promise<T>;
+export declare function useScreenSize(): {
+    width: number;
+    height: number;
+    isMobile: boolean;
+};
+export declare function isWalletConnect(wallet: WalletProvider): boolean;
+export declare function useWalletProviderState(initialState?: WalletProvider[]): readonly [WalletProvider[], (newProviders: WalletProvider[]) => void];
+export declare function mergeWalletsWithoutDuplicates(existingWallets: Wallet[], newWallets: Wallet[]): Wallet[];
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,aAAa,EACb,kBAAkB,EACnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,KAAK,MAAM,EACX,cAAc,EAEf,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,4BAA4B,QAAY,CAAC;AAEtD,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;CAgCtB,CAAC;AAEF,eAAO,MAAM,oBAAoB,uBAAwB,GAAG,EAAE,KAAK,IAAI,MACjE,CAAC,oBAEJ,CAgBF,CAAC;AAEF,eAAO,MAAM,cAAc,aAAc,OAAO,GAAG,SAAS,KAAG,OAE9D,CAAC;AAEF,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACrC,SAAS,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAA;CAAE,EACxD,eAAe,SAA8B,EAC7C,YAAY,qBAA6B,GACxC,OAAO,CAAC,CAAC,CAAC,CAqCZ;AAGD,wBAAgB,aAAa;;;;EAyB5B;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAE/D;AAED,wBAAgB,sBAAsB,CAAC,YAAY,GAAE,cAAc,EAAO,8CA2BvD,cAAc,EAAE,WAWlC;AAED,wBAAgB,6BAA6B,CAC3C,eAAe,EAAE,MAAM,EAAE,EACzB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,EAAE,CAMV"}