@n1xyz/wallet-widget 0.0.34 → 0.0.35-alpha.1

package/dist/src/services/bootstrap/TurnkeyBootstrapService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurnkeyBootstrapService.js","sourceRoot":"","sources":["../../../../src/services/bootstrap/TurnkeyBootstrapService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Turnkey Bootstrap Service\n *\n * Handles Turnkey authentication and wallet provisioning.\n * Extracted from TurnkeyProvider to enable:\n * - Testable pure functions\n * - Clear separation from React lifecycle\n * - Reusable bootstrap logic\n */\n\nimport { logger } from '../../utils/logger';\nimport { StorageService } from '../storage';\nimport type { TurnkeyBootstrapConfig, TurnkeySessionData } from './types';\n\n// ============================================\n// CONSTANTS\n// ============================================\n\nexport const TURNKEY_WALLET_NAME = 'Nord Turnkey Wallet';\nexport const SOLANA_ADDRESS_FORMAT = 'ADDRESS_FORMAT_SOLANA';\n\n// ============================================\n// ADDRESS UTILITIES\n// ============================================\n\n/**\n * Normalize EVM address to lowercase for consistent comparison.\n */\nexport function normalizeAddress(address?: string | null): string | null {\n  if (!address) return null;\n  return address.toLowerCase();\n}\n\n/**\n * Check if error indicates user rejected the action.\n */\nexport function isUserRejectedError(error: unknown): boolean {\n  const errorObj = error as { code?: string | number; message?: string; name?: string };\n  const code = errorObj?.code;\n  const message = errorObj?.message?.toLowerCase?.() ?? '';\n  const name = errorObj?.name?.toLowerCase?.() ?? '';\n\n  // Check for explicit user rejection codes first (most reliable)\n  if (\n    code === 'USER_REJECTED' ||\n    code === 4001 ||\n    code === 'USER_CANCELED' ||\n    code === 'USER_CANCELLED'\n  ) {\n    return true;\n  }\n\n  // Check for explicit user rejection in error name\n  if (\n    name.includes('user_rejected') ||\n    name.includes('user_canceled') ||\n    name.includes('user_cancelled')\n  ) {\n    return true;\n  }\n\n  // Check message for explicit \"user rejected\" patterns\n  if (message.includes('user rejected') || message.includes('user rejected the request')) {\n    return true;\n  }\n\n  // \"wallet auth was cancelled\" needs BOTH message AND code to be safe\n  const cancelledMessage =\n    message.includes('wallet auth was cancelled') ||\n    message.includes('wallet authorization was cancelled');\n  if (cancelledMessage) {\n    if (\n      code === 4001 ||\n      code === 'USER_REJECTED' ||\n      code === 'USER_CANCELED' ||\n      code === 'USER_CANCELLED'\n    ) {\n      return true;\n    }\n    return false;\n  }\n\n  return false;\n}\n\n// ============================================\n// SESSION MANAGEMENT\n// ============================================\n\n/**\n * Check if the stored session belongs to a different user.\n * Returns true if we need to clear the session for the new user.\n */\nexport function isSessionForDifferentUser(targetAddress: string): boolean {\n  const storedClientAddress = StorageService.readTurnkeyClientAddress();\n  if (!storedClientAddress) return false;\n\n  return storedClientAddress.toLowerCase() !== targetAddress.toLowerCase();\n}\n\n/**\n * Check if we have a valid stored session for the target address.\n */\nexport function hasStoredSession(targetAddress: string): boolean {\n  const session = StorageService.readTurnkeySession(targetAddress);\n  return session !== null && !!session.sessionKey;\n}\n\n/**\n * Get stored session data for the target address.\n */\nexport function getStoredSession(targetAddress: string): TurnkeySessionData | null {\n  const storedSession = StorageService.readTurnkeySession(targetAddress);\n  if (!storedSession?.sessionKey) return null;\n\n  return {\n    sessionKey: storedSession.sessionKey,\n    evmAddress: storedSession.evmAddress,\n    solanaAccount: storedSession.solanaAccount,\n    session: storedSession.session,\n  };\n}\n\n/**\n * Store session data after successful login.\n */\nexport function storeSession(\n  targetAddress: string,\n  sessionKey: string,\n  options?: {\n    evmAddress?: string | null;\n    solanaAccount?: TurnkeySessionData['solanaAccount'];\n    session?: unknown;\n  }\n): void {\n  StorageService.writeTurnkeySession({\n    sessionKey,\n    evmAddress: options?.evmAddress ?? targetAddress,\n    solanaAccount: options?.solanaAccount ?? null,\n    session: options?.session,\n  });\n  StorageService.writeTurnkeyClientAddress(targetAddress);\n}\n\n/**\n * Update the Solana account for an existing session.\n */\nexport function updateSessionSolanaAccount(\n  targetAddress: string,\n  solanaAccount: NonNullable<TurnkeySessionData['solanaAccount']>\n): void {\n  StorageService.updateTurnkeySolanaAccount(targetAddress, solanaAccount);\n}\n\n/**\n * Clear session for logout or user switch.\n */\nexport function clearSession(targetAddress?: string | null): void {\n  StorageService.clearTurnkeySession(targetAddress);\n  logger.debug('[TurnkeyBootstrapService] Session cleared');\n}\n\n// ============================================\n// WALLET HELPERS\n// ============================================\n\n/**\n * Find an existing Solana wallet in the list of Turnkey wallets.\n */\nexport function findExistingSolanaWallet(wallets: any[]): any | null {\n  return (\n    wallets.find(\n      (w) =>\n        w.walletName === TURNKEY_WALLET_NAME &&\n        w.accounts?.some((a: any) => a.addressFormat === SOLANA_ADDRESS_FORMAT)\n    ) ?? null\n  );\n}\n\n/**\n * Extract Solana account from a wallet.\n */\nexport function extractSolanaAccount(wallet: any): any | null {\n  if (!wallet?.accounts) return null;\n  return wallet.accounts.find((a: any) => a.addressFormat === SOLANA_ADDRESS_FORMAT) ?? null;\n}\n\n/**\n * Check if stored session has Solana account cached.\n */\nexport function hasCachedSolanaAccount(targetAddress: string): boolean {\n  const session = StorageService.readTurnkeySession(targetAddress);\n  return !!session?.solanaAccount?.account?.address;\n}\n\n/**\n * Get cached Solana account from stored session.\n */\nexport function getCachedSolanaAccount(\n  targetAddress: string\n): TurnkeySessionData['solanaAccount'] | null {\n  const session = StorageService.readTurnkeySession(targetAddress);\n  return session?.solanaAccount ?? null;\n}\n\n// ============================================\n// BOOTSTRAP ORCHESTRATION\n// ============================================\n\n/**\n * Determine next action for Turnkey bootstrap.\n *\n * This is a pure function that determines what should happen next\n * without actually performing the action.\n */\nexport function determineBootstrapAction(params: {\n  targetAddress: string | null;\n  walletNetwork: 'solana' | 'evm' | null;\n  hasEvmWallet: boolean;\n  hasTurnkeyConfig: boolean;\n}): 'skip' | 'reset' | 'hydrate' | 'login' {\n  const { targetAddress, walletNetwork, hasEvmWallet, hasTurnkeyConfig } = params;\n\n  // Pre-flight checks\n  if (!hasTurnkeyConfig || walletNetwork !== 'evm' || !hasEvmWallet || !targetAddress) {\n    return 'skip';\n  }\n\n  // Check if user switched accounts\n  if (isSessionForDifferentUser(targetAddress)) {\n    return 'reset';\n  }\n\n  // Check if we have a stored session\n  if (hasStoredSession(targetAddress)) {\n    return 'hydrate';\n  }\n\n  // Need fresh login\n  return 'login';\n}\n\n/**\n * Determine next action for Solana wallet provisioning.\n */\nexport function determineSolanaProvisionAction(params: {\n  targetAddress: string;\n  existingWallets: any[];\n}): 'use_cached' | 'use_existing' | 'create' {\n  const { targetAddress, existingWallets } = params;\n\n  // Check cache first\n  if (hasCachedSolanaAccount(targetAddress)) {\n    return 'use_cached';\n  }\n\n  // Check existing wallets\n  const existing = findExistingSolanaWallet(existingWallets);\n  if (existing && extractSolanaAccount(existing)) {\n    return 'use_existing';\n  }\n\n  // Need to create\n  return 'create';\n}\n\n// ============================================\n// ERROR HANDLING\n// ============================================\n\n/**\n * Categorize a Turnkey error for appropriate handling.\n */\nexport function categorizeTurnkeyError(error: unknown): {\n  type: 'user_rejected' | 'network' | 'session_expired' | 'unknown';\n  message: string;\n  recoverable: boolean;\n} {\n  if (isUserRejectedError(error)) {\n    return {\n      type: 'user_rejected',\n      message: 'User rejected the request',\n      recoverable: true,\n    };\n  }\n\n  const errorObj = error as { message?: string; code?: string | number };\n  const message = errorObj?.message ?? String(error);\n\n  // Session expired\n  if (\n    message.includes('session expired') ||\n    message.includes('invalid session') ||\n    message.includes('no active session')\n  ) {\n    return {\n      type: 'session_expired',\n      message: 'Session expired, please reconnect',\n      recoverable: true,\n    };\n  }\n\n  // Network errors\n  if (\n    message.includes('network') ||\n    message.includes('fetch') ||\n    message.includes('timeout')\n  ) {\n    return {\n      type: 'network',\n      message: 'Network error, please try again',\n      recoverable: true,\n    };\n  }\n\n  return {\n    type: 'unknown',\n    message: message || 'An unknown error occurred',\n    recoverable: false,\n  };\n}\n"]}

package/dist/src/services/bootstrap/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Bootstrap Services
+ *
+ * Services for handling widget initialization and bootstrap logic.
+ * These are pure functions extracted from React providers to enable
+ * testability and clear separation of concerns.
+ */
+export { isLocalhost, patchFetchForProxy, loadDynamicSdk, isSdkLoaded, getCachedSdk, buildSdkSettings, buildSolanaNetworks, buildWalletConnectors, isSolanaWallet, hasWalletAddressChanged, storeWalletAddress, } from './DynamicSdkService';
+export { TURNKEY_WALLET_NAME, SOLANA_ADDRESS_FORMAT, normalizeAddress, isUserRejectedError, isSessionForDifferentUser, hasStoredSession, getStoredSession, storeSession, updateSessionSolanaAccount, clearSession, findExistingSolanaWallet, extractSolanaAccount, hasCachedSolanaAccount, getCachedSolanaAccount, determineBootstrapAction, determineSolanaProvisionAction, categorizeTurnkeyError, } from './TurnkeyBootstrapService';
+export { hasStoredSessionKeys, readSessionKeys, storeSessionKeys, clearSessionKeys, readSessionId, storeSessionId, clearSessionId, getOrCreateSessionKeyPair, isSessionReady, clearAllSessionData, validateSessionKeys, } from './SessionBootstrapService';
+export type { StoredSessionKeys, SessionKeyPair } from './SessionBootstrapService';
+export { checkForRecoverableDeposit, isDepositForWallet, getPendingDeposit, mapStageToPhase, determineRecoveryAction, clearPendingDeposit, clearLastDeposit, clearAllDepositData, validateDepositForRecovery, prepareDepositRecovery, migrateLegacyDeposits, } from './DepositRecoveryService';
+export type { DynamicSdkConfig, DynamicSdkLoadResult, ProxyConfig, TurnkeyBootstrapConfig, TurnkeySessionData, TurnkeyBootstrapResult, SessionInitParams, SessionInitResult, RecoverableDeposit, DepositRecoveryResult, BootstrapState, BootstrapError, } from './types';

package/dist/src/services/bootstrap/index.js

@@ -0,0 +1,16 @@
+/**
+ * Bootstrap Services
+ *
+ * Services for handling widget initialization and bootstrap logic.
+ * These are pure functions extracted from React providers to enable
+ * testability and clear separation of concerns.
+ */
+// Dynamic SDK Service
+export { isLocalhost, patchFetchForProxy, loadDynamicSdk, isSdkLoaded, getCachedSdk, buildSdkSettings, buildSolanaNetworks, buildWalletConnectors, isSolanaWallet, hasWalletAddressChanged, storeWalletAddress, } from './DynamicSdkService';
+// Turnkey Bootstrap Service
+export { TURNKEY_WALLET_NAME, SOLANA_ADDRESS_FORMAT, normalizeAddress, isUserRejectedError, isSessionForDifferentUser, hasStoredSession, getStoredSession, storeSession, updateSessionSolanaAccount, clearSession, findExistingSolanaWallet, extractSolanaAccount, hasCachedSolanaAccount, getCachedSolanaAccount, determineBootstrapAction, determineSolanaProvisionAction, categorizeTurnkeyError, } from './TurnkeyBootstrapService';
+// Session Bootstrap Service
+export { hasStoredSessionKeys, readSessionKeys, storeSessionKeys, clearSessionKeys, readSessionId, storeSessionId, clearSessionId, getOrCreateSessionKeyPair, isSessionReady, clearAllSessionData, validateSessionKeys, } from './SessionBootstrapService';
+// Deposit Recovery Service
+export { checkForRecoverableDeposit, isDepositForWallet, getPendingDeposit, mapStageToPhase, determineRecoveryAction, clearPendingDeposit, clearLastDeposit, clearAllDepositData, validateDepositForRecovery, prepareDepositRecovery, migrateLegacyDeposits, } from './DepositRecoveryService';
+//# sourceMappingURL=index.js.map

package/dist/src/services/bootstrap/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/bootstrap/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sBAAsB;AACtB,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,4BAA4B;AAC5B,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,0BAA0B,EAC1B,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,8BAA8B,EAC9B,sBAAsB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,4BAA4B;AAC5B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,cAAc,EACd,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAGnC,2BAA2B;AAC3B,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,0BAA0B,EAC1B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC","sourcesContent":["/**\n * Bootstrap Services\n *\n * Services for handling widget initialization and bootstrap logic.\n * These are pure functions extracted from React providers to enable\n * testability and clear separation of concerns.\n */\n\n// Dynamic SDK Service\nexport {\n  isLocalhost,\n  patchFetchForProxy,\n  loadDynamicSdk,\n  isSdkLoaded,\n  getCachedSdk,\n  buildSdkSettings,\n  buildSolanaNetworks,\n  buildWalletConnectors,\n  isSolanaWallet,\n  hasWalletAddressChanged,\n  storeWalletAddress,\n} from './DynamicSdkService';\n\n// Turnkey Bootstrap Service\nexport {\n  TURNKEY_WALLET_NAME,\n  SOLANA_ADDRESS_FORMAT,\n  normalizeAddress,\n  isUserRejectedError,\n  isSessionForDifferentUser,\n  hasStoredSession,\n  getStoredSession,\n  storeSession,\n  updateSessionSolanaAccount,\n  clearSession,\n  findExistingSolanaWallet,\n  extractSolanaAccount,\n  hasCachedSolanaAccount,\n  getCachedSolanaAccount,\n  determineBootstrapAction,\n  determineSolanaProvisionAction,\n  categorizeTurnkeyError,\n} from './TurnkeyBootstrapService';\n\n// Session Bootstrap Service\nexport {\n  hasStoredSessionKeys,\n  readSessionKeys,\n  storeSessionKeys,\n  clearSessionKeys,\n  readSessionId,\n  storeSessionId,\n  clearSessionId,\n  getOrCreateSessionKeyPair,\n  isSessionReady,\n  clearAllSessionData,\n  validateSessionKeys,\n} from './SessionBootstrapService';\nexport type { StoredSessionKeys, SessionKeyPair } from './SessionBootstrapService';\n\n// Deposit Recovery Service\nexport {\n  checkForRecoverableDeposit,\n  isDepositForWallet,\n  getPendingDeposit,\n  mapStageToPhase,\n  determineRecoveryAction,\n  clearPendingDeposit,\n  clearLastDeposit,\n  clearAllDepositData,\n  validateDepositForRecovery,\n  prepareDepositRecovery,\n  migrateLegacyDeposits,\n} from './DepositRecoveryService';\n\n// Types\nexport type {\n  DynamicSdkConfig,\n  DynamicSdkLoadResult,\n  ProxyConfig,\n  TurnkeyBootstrapConfig,\n  TurnkeySessionData,\n  TurnkeyBootstrapResult,\n  SessionInitParams,\n  SessionInitResult,\n  RecoverableDeposit,\n  DepositRecoveryResult,\n  BootstrapState,\n  BootstrapError,\n} from './types';\n"]}

package/dist/src/services/bootstrap/types.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Bootstrap Service Types
+ *
+ * Types used by bootstrap services for initialization logic.
+ */
+/** Configuration for Dynamic SDK loading */
+export interface DynamicSdkConfig {
+    environmentId: string;
+    preferredNetwork?: 'solana' | 'evm' | null;
+    solanaRpcUrl?: string;
+}
+/** Result of Dynamic SDK loading */
+export interface DynamicSdkLoadResult {
+    provider: any;
+    widget: any;
+    solanaConnector: any;
+    evmConnector: any;
+}
+/** Proxy configuration for localhost development */
+export interface ProxyConfig {
+    proxyBase: string;
+    targetDomains: string[];
+}
+/** Configuration for Turnkey bootstrap */
+export interface TurnkeyBootstrapConfig {
+    organizationId: string;
+    authProxyConfigId: string;
+    authProxyUrl: string;
+    apiBaseUrl: string;
+    sessionExpirationSeconds?: number;
+}
+/** Turnkey session data */
+export interface TurnkeySessionData {
+    sessionKey: string;
+    evmAddress?: string | null;
+    solanaAccount?: {
+        walletId: string;
+        account: {
+            address: string;
+            addressFormat?: string;
+        };
+    } | null;
+    /** Full Turnkey session payload (userId, organizationId, expiry, etc.) */
+    session?: unknown;
+}
+/** Result of Turnkey bootstrap */
+export interface TurnkeyBootstrapResult {
+    session: TurnkeySessionData;
+    solanaAddress: string;
+    walletId: string;
+}
+/** Session initialization parameters */
+export interface SessionInitParams {
+    evmAddress: string;
+    solanaAddress: string;
+    sessionMode: 'Nord' | 'NTS';
+}
+/** Session initialization result */
+export interface SessionInitResult {
+    sessionPubKey: Uint8Array;
+    walletPubKey: Uint8Array;
+    nordUser: any;
+}
+/** Pending deposit to recover */
+export interface RecoverableDeposit {
+    depositId: string;
+    wallet: string;
+    chain: string;
+    amount: string;
+    stage: string;
+    tx?: string | null;
+    attestationId?: string | null;
+}
+/** Result of deposit recovery check */
+export interface DepositRecoveryResult {
+    hasRecoverable: boolean;
+    deposit: RecoverableDeposit | null;
+}
+/** Overall bootstrap state */
+export interface BootstrapState {
+    dynamicSdk: 'idle' | 'loading' | 'ready' | 'error';
+    turnkey: 'idle' | 'authenticating' | 'creating' | 'ready' | 'error';
+    session: 'idle' | 'hydrating' | 'ready' | 'error';
+    depositRecovery: 'idle' | 'checking' | 'recovering' | 'ready';
+}
+/** Bootstrap error info */
+export interface BootstrapError {
+    phase: keyof BootstrapState;
+    message: string;
+    code?: string | number;
+    recoverable: boolean;
+}

package/dist/src/services/bootstrap/types.js

@@ -0,0 +1,7 @@
+/**
+ * Bootstrap Service Types
+ *
+ * Types used by bootstrap services for initialization logic.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/services/bootstrap/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/services/bootstrap/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG","sourcesContent":["/**\n * Bootstrap Service Types\n *\n * Types used by bootstrap services for initialization logic.\n */\n\n// ============================================\n// DYNAMIC SDK TYPES\n// ============================================\n\n/** Configuration for Dynamic SDK loading */\nexport interface DynamicSdkConfig {\n  environmentId: string;\n  preferredNetwork?: 'solana' | 'evm' | null;\n  solanaRpcUrl?: string;\n}\n\n/** Result of Dynamic SDK loading */\nexport interface DynamicSdkLoadResult {\n  provider: any;\n  widget: any;\n  solanaConnector: any;\n  evmConnector: any;\n}\n\n/** Proxy configuration for localhost development */\nexport interface ProxyConfig {\n  proxyBase: string;\n  targetDomains: string[];\n}\n\n// ============================================\n// TURNKEY TYPES\n// ============================================\n\n/** Configuration for Turnkey bootstrap */\nexport interface TurnkeyBootstrapConfig {\n  organizationId: string;\n  authProxyConfigId: string;\n  authProxyUrl: string;\n  apiBaseUrl: string;\n  sessionExpirationSeconds?: number;\n}\n\n/** Turnkey session data */\nexport interface TurnkeySessionData {\n  sessionKey: string;\n  evmAddress?: string | null;\n  solanaAccount?: {\n    walletId: string;\n    account: {\n      address: string;\n      addressFormat?: string;\n    };\n  } | null;\n  /** Full Turnkey session payload (userId, organizationId, expiry, etc.) */\n  session?: unknown;\n}\n\n/** Result of Turnkey bootstrap */\nexport interface TurnkeyBootstrapResult {\n  session: TurnkeySessionData;\n  solanaAddress: string;\n  walletId: string;\n}\n\n// ============================================\n// SESSION TYPES\n// ============================================\n\n/** Session initialization parameters */\nexport interface SessionInitParams {\n  evmAddress: string;\n  solanaAddress: string;\n  sessionMode: 'Nord' | 'NTS';\n}\n\n/** Session initialization result */\nexport interface SessionInitResult {\n  sessionPubKey: Uint8Array;\n  walletPubKey: Uint8Array;\n  nordUser: any;\n}\n\n// ============================================\n// DEPOSIT RECOVERY TYPES\n// ============================================\n\n/** Pending deposit to recover */\nexport interface RecoverableDeposit {\n  depositId: string;\n  wallet: string;\n  chain: string;\n  amount: string;\n  stage: string;\n  tx?: string | null;\n  attestationId?: string | null;\n}\n\n/** Result of deposit recovery check */\nexport interface DepositRecoveryResult {\n  hasRecoverable: boolean;\n  deposit: RecoverableDeposit | null;\n}\n\n// ============================================\n// BOOTSTRAP ORCHESTRATION\n// ============================================\n\n/** Overall bootstrap state */\nexport interface BootstrapState {\n  dynamicSdk: 'idle' | 'loading' | 'ready' | 'error';\n  turnkey: 'idle' | 'authenticating' | 'creating' | 'ready' | 'error';\n  session: 'idle' | 'hydrating' | 'ready' | 'error';\n  depositRecovery: 'idle' | 'checking' | 'recovering' | 'ready';\n}\n\n/** Bootstrap error info */\nexport interface BootstrapError {\n  phase: keyof BootstrapState;\n  message: string;\n  code?: string | number;\n  recoverable: boolean;\n}\n"]}

package/dist/src/services/storage/StorageService.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Storage Service
+ *
+ * Unified abstraction for localStorage operations.
+ * Handles browser/server environments, provides typed getters/setters,
+ * and centralizes all storage logic.
+ */
+import type { PendingDepositState, StoredDepositRecord, StoredTurnkeySession, LegacyPendingDeposit, PendingDepositStage } from './types';
+export declare const StorageService: {
+    /**
+     * Read the active pending deposit from storage.
+     * Returns null if expired or invalid.
+     */
+    readPendingDeposit(now?: number): PendingDepositState | null;
+    /**
+     * Write a pending deposit to storage.
+     */
+    writePendingDeposit(state: PendingDepositState, now?: number): PendingDepositState;
+    /**
+     * Clear the active pending deposit.
+     */
+    clearPendingDeposit(): void;
+    /**
+     * Save a completed deposit record for a wallet address.
+     */
+    saveLastDeposit(address: string | null | undefined, record: StoredDepositRecord): void;
+    /**
+     * Read the last completed deposit for a wallet address.
+     */
+    readLastDeposit(address: string | null | undefined): StoredDepositRecord | null;
+    /**
+     * Clear the last deposit record for a wallet address.
+     */
+    clearLastDeposit(address: string | null | undefined): void;
+    /**
+     * Read the stored Turnkey session.
+     */
+    readTurnkeySession(address?: string | null): StoredTurnkeySession | null;
+    /**
+     * Write a Turnkey session to storage.
+     */
+    writeTurnkeySession(session: StoredTurnkeySession): void;
+    /**
+     * Clear the stored Turnkey session and client address.
+     * If address is provided, only clears if it matches the stored session.
+     * If no address is provided, unconditionally clears both.
+     */
+    clearTurnkeySession(address?: string | null): void;
+    /**
+     * Read the stored Turnkey client wallet address.
+     */
+    readTurnkeyClientAddress(): string | null;
+    /**
+     * Write the Turnkey client wallet address.
+     * Pass null to clear the stored address.
+     */
+    writeTurnkeyClientAddress(address: string | null): void;
+    /**
+     * Update the Solana account for an existing Turnkey session.
+     */
+    updateTurnkeySolanaAccount(address: string, solanaAccount: {
+        walletId: string;
+        account: {
+            address: string;
+            addressFormat?: string;
+        };
+    }): void;
+    /**
+     * Read legacy pending deposits array.
+     */
+    readLegacyPendingDeposits(): LegacyPendingDeposit[];
+    /**
+     * Clear legacy pending deposits array.
+     */
+    clearLegacyPendingDeposits(): void;
+    /**
+     * Reconcile local and remote deposit stages.
+     * Returns the more advanced stage (unless remote is 'failed').
+     */
+    reconcileStages(localStage: PendingDepositStage, remoteStage: PendingDepositStage | null | undefined): PendingDepositStage;
+    /**
+     * Advance a pending deposit to a new stage.
+     * Prevents stage regression (except to 'failed').
+     */
+    advancePendingDeposit(previous: PendingDepositState, updates: Partial<Omit<PendingDepositState, "depositId" | "wallet" | "chain">> & {
+        stage: PendingDepositStage;
+    }, now?: number): PendingDepositState;
+    /**
+     * Create a new pending deposit draft.
+     */
+    createPendingDepositDraft(params: {
+        depositId: string;
+        wallet: string;
+        chain: string;
+        amount: string;
+        now?: number;
+    }): PendingDepositState;
+};

package/dist/src/services/storage/StorageService.js

@@ -0,0 +1,360 @@
+/**
+ * Storage Service
+ *
+ * Unified abstraction for localStorage operations.
+ * Handles browser/server environments, provides typed getters/setters,
+ * and centralizes all storage logic.
+ */
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+import { logger } from '../../utils/logger';
+import { ACTIVE_PENDING_DEPOSIT_KEY, TURNKEY_SESSION_KEY, TURNKEY_CLIENT_WALLET_KEY, PENDING_DEPOSITS_META_KEY, getLastDepositKey, } from './keys';
+import { DEPOSIT_STAGE_ORDER, getStageRank } from './types';
+/** In-memory fallback for Node/test environments */
+var memoryStorage = (function () {
+    var map = new Map();
+    return {
+        getItem: function (k) { return (map.has(k) ? map.get(k) : null); },
+        setItem: function (k, v) {
+            map.set(k, v);
+        },
+        removeItem: function (k) {
+            map.delete(k);
+        },
+    };
+})();
+/** Get the appropriate storage backend */
+var getStorage = function () {
+    if (typeof globalThis !== 'undefined' && typeof globalThis.localStorage !== 'undefined') {
+        var ls = globalThis.localStorage;
+        if (ls && typeof ls.getItem === 'function') {
+            return ls;
+        }
+    }
+    return memoryStorage;
+};
+// ============================================
+// DEPOSIT TTL CONSTANTS
+// ============================================
+var MAX_DEPOSIT_TTL_MS = 48 * 60 * 60 * 1000; // 48 hours
+var FAILED_DEPOSIT_TTL_MS = 30 * 60 * 1000; // 30 minutes
+// ============================================
+// STORAGE SERVICE
+// ============================================
+export var StorageService = {
+    // ============================================
+    // PENDING DEPOSIT OPERATIONS
+    // ============================================
+    /**
+     * Read the active pending deposit from storage.
+     * Returns null if expired or invalid.
+     */
+    readPendingDeposit: function (now) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        if (now === void 0) { now = Date.now(); }
+        var storage = getStorage();
+        var raw = storage.getItem(ACTIVE_PENDING_DEPOSIT_KEY);
+        if (!raw)
+            return null;
+        try {
+            var parsed = JSON.parse(raw);
+            if (!parsed || typeof parsed !== 'object')
+                return null;
+            if (!parsed.depositId || !parsed.wallet)
+                return null;
+            var stage = parsed.stage && DEPOSIT_STAGE_ORDER.includes(parsed.stage) ? parsed.stage : 'initiated';
+            var updatedAt = (_a = parsed.updatedAt) !== null && _a !== void 0 ? _a : now;
+            var ttl = stage === 'failed' ? FAILED_DEPOSIT_TTL_MS : MAX_DEPOSIT_TTL_MS;
+            if (now - updatedAt > ttl) {
+                this.clearPendingDeposit();
+                return null;
+            }
+            return {
+                depositId: parsed.depositId,
+                wallet: parsed.wallet,
+                chain: parsed.chain || '',
+                amount: (_b = parsed.amount) !== null && _b !== void 0 ? _b : '',
+                stage: stage,
+                tx: (_c = parsed.tx) !== null && _c !== void 0 ? _c : null,
+                mintTx: (_d = parsed.mintTx) !== null && _d !== void 0 ? _d : null,
+                attestationId: (_e = parsed.attestationId) !== null && _e !== void 0 ? _e : null,
+                explorerUrl: (_f = parsed.explorerUrl) !== null && _f !== void 0 ? _f : null,
+                reason: (_g = parsed.reason) !== null && _g !== void 0 ? _g : null,
+                updatedAt: updatedAt,
+            };
+        }
+        catch (_h) {
+            this.clearPendingDeposit();
+            return null;
+        }
+    },
+    /**
+     * Write a pending deposit to storage.
+     */
+    writePendingDeposit: function (state, now) {
+        var _a, _b, _c, _d, _e;
+        if (now === void 0) { now = Date.now(); }
+        var storage = getStorage();
+        var stored = {
+            depositId: state.depositId,
+            wallet: state.wallet,
+            chain: state.chain,
+            amount: state.amount,
+            stage: state.stage,
+            tx: (_a = state.tx) !== null && _a !== void 0 ? _a : null,
+            mintTx: (_b = state.mintTx) !== null && _b !== void 0 ? _b : null,
+            attestationId: (_c = state.attestationId) !== null && _c !== void 0 ? _c : null,
+            explorerUrl: (_d = state.explorerUrl) !== null && _d !== void 0 ? _d : null,
+            reason: (_e = state.reason) !== null && _e !== void 0 ? _e : null,
+            updatedAt: now,
+        };
+        try {
+            storage.setItem(ACTIVE_PENDING_DEPOSIT_KEY, JSON.stringify(stored));
+        }
+        catch (e) {
+            logger.warn('[StorageService] Failed to write pending deposit', { error: e });
+        }
+        return __assign(__assign({}, state), { updatedAt: now });
+    },
+    /**
+     * Clear the active pending deposit.
+     */
+    clearPendingDeposit: function () {
+        var storage = getStorage();
+        storage.removeItem(ACTIVE_PENDING_DEPOSIT_KEY);
+    },
+    // ============================================
+    // COMPLETED DEPOSIT OPERATIONS
+    // ============================================
+    /**
+     * Save a completed deposit record for a wallet address.
+     */
+    saveLastDeposit: function (address, record) {
+        if (!address || !record || !record.transactionId)
+            return;
+        var storage = getStorage();
+        try {
+            storage.setItem(getLastDepositKey(address), JSON.stringify(record));
+        }
+        catch (e) {
+            logger.warn('[StorageService] Failed to save last deposit', { error: e });
+        }
+    },
+    /**
+     * Read the last completed deposit for a wallet address.
+     */
+    readLastDeposit: function (address) {
+        if (!address)
+            return null;
+        var storage = getStorage();
+        try {
+            var raw = storage.getItem(getLastDepositKey(address));
+            if (!raw)
+                return null;
+            return JSON.parse(raw);
+        }
+        catch (_a) {
+            storage.removeItem(getLastDepositKey(address));
+            return null;
+        }
+    },
+    /**
+     * Clear the last deposit record for a wallet address.
+     */
+    clearLastDeposit: function (address) {
+        if (!address)
+            return;
+        var storage = getStorage();
+        storage.removeItem(getLastDepositKey(address));
+    },
+    // ============================================
+    // TURNKEY SESSION OPERATIONS
+    // ============================================
+    /**
+     * Read the stored Turnkey session.
+     */
+    readTurnkeySession: function (address) {
+        var _a;
+        var storage = getStorage();
+        try {
+            var raw = storage.getItem(TURNKEY_SESSION_KEY);
+            if (!raw)
+                return null;
+            var parsed = JSON.parse(raw);
+            if (!parsed || typeof parsed !== 'object' || !parsed.sessionKey) {
+                return null;
+            }
+            // If address provided, validate it matches
+            if (address) {
+                var normalized = address.toLowerCase();
+                var sessionAddress = (_a = parsed.evmAddress) === null || _a === void 0 ? void 0 : _a.toLowerCase();
+                if (sessionAddress && sessionAddress !== normalized) {
+                    return null;
+                }
+            }
+            return parsed;
+        }
+        catch (e) {
+            logger.warn('[StorageService] Failed to read Turnkey session', { error: e });
+            return null;
+        }
+    },
+    /**
+     * Write a Turnkey session to storage.
+     */
+    writeTurnkeySession: function (session) {
+        var storage = getStorage();
+        try {
+            storage.setItem(TURNKEY_SESSION_KEY, JSON.stringify(session));
+        }
+        catch (e) {
+            logger.warn('[StorageService] Failed to write Turnkey session', { error: e });
+        }
+    },
+    /**
+     * Clear the stored Turnkey session and client address.
+     * If address is provided, only clears if it matches the stored session.
+     * If no address is provided, unconditionally clears both.
+     */
+    clearTurnkeySession: function (address) {
+        var _a;
+        var storage = getStorage();
+        // If address provided, only clear if it matches
+        if (address) {
+            var session = this.readTurnkeySession();
+            if (session && ((_a = session.evmAddress) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== address.toLowerCase()) {
+                return;
+            }
+        }
+        storage.removeItem(TURNKEY_SESSION_KEY);
+        storage.removeItem(TURNKEY_CLIENT_WALLET_KEY);
+    },
+    /**
+     * Read the stored Turnkey client wallet address.
+     */
+    readTurnkeyClientAddress: function () {
+        var storage = getStorage();
+        try {
+            var raw = storage.getItem(TURNKEY_CLIENT_WALLET_KEY);
+            return raw ? raw.toLowerCase() : null;
+        }
+        catch (_a) {
+            return null;
+        }
+    },
+    /**
+     * Write the Turnkey client wallet address.
+     * Pass null to clear the stored address.
+     */
+    writeTurnkeyClientAddress: function (address) {
+        var storage = getStorage();
+        try {
+            if (address) {
+                storage.setItem(TURNKEY_CLIENT_WALLET_KEY, address.toLowerCase());
+            }
+            else {
+                storage.removeItem(TURNKEY_CLIENT_WALLET_KEY);
+            }
+        }
+        catch (_a) {
+            // ignore
+        }
+    },
+    /**
+     * Update the Solana account for an existing Turnkey session.
+     */
+    updateTurnkeySolanaAccount: function (address, solanaAccount) {
+        var session = this.readTurnkeySession(address);
+        if (!session)
+            return;
+        session.solanaAccount = solanaAccount;
+        this.writeTurnkeySession(session);
+    },
+    // ============================================
+    // LEGACY PENDING DEPOSITS (for migration)
+    // ============================================
+    /**
+     * Read legacy pending deposits array.
+     */
+    readLegacyPendingDeposits: function () {
+        var storage = getStorage();
+        try {
+            var raw = storage.getItem(PENDING_DEPOSITS_META_KEY);
+            if (!raw)
+                return [];
+            var parsed = JSON.parse(raw);
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch (_a) {
+            return [];
+        }
+    },
+    /**
+     * Clear legacy pending deposits array.
+     */
+    clearLegacyPendingDeposits: function () {
+        var storage = getStorage();
+        storage.removeItem(PENDING_DEPOSITS_META_KEY);
+    },
+    // ============================================
+    // UTILITIES
+    // ============================================
+    /**
+     * Reconcile local and remote deposit stages.
+     * Returns the more advanced stage (unless remote is 'failed').
+     */
+    reconcileStages: function (localStage, remoteStage) {
+        if (!remoteStage)
+            return localStage;
+        if (remoteStage === 'failed')
+            return 'failed';
+        var localRank = getStageRank(localStage);
+        var remoteRank = getStageRank(remoteStage);
+        return remoteRank > localRank ? remoteStage : localStage;
+    },
+    /**
+     * Advance a pending deposit to a new stage.
+     * Prevents stage regression (except to 'failed').
+     */
+    advancePendingDeposit: function (previous, updates, now) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+        if (now === void 0) { now = Date.now(); }
+        var prevRank = getStageRank(previous.stage);
+        var nextRank = getStageRank(updates.stage);
+        if (updates.stage !== 'failed' && nextRank < prevRank) {
+            throw new Error("Cannot regress pending deposit stage from ".concat(previous.stage, " to ").concat(updates.stage));
+        }
+        var merged = __assign(__assign(__assign({}, previous), updates), { tx: (_b = (_a = updates.tx) !== null && _a !== void 0 ? _a : previous.tx) !== null && _b !== void 0 ? _b : null, mintTx: (_d = (_c = updates.mintTx) !== null && _c !== void 0 ? _c : previous.mintTx) !== null && _d !== void 0 ? _d : null, attestationId: (_f = (_e = updates.attestationId) !== null && _e !== void 0 ? _e : previous.attestationId) !== null && _f !== void 0 ? _f : null, explorerUrl: (_h = (_g = updates.explorerUrl) !== null && _g !== void 0 ? _g : previous.explorerUrl) !== null && _h !== void 0 ? _h : null, reason: (_k = (_j = updates.reason) !== null && _j !== void 0 ? _j : previous.reason) !== null && _k !== void 0 ? _k : null, stage: updates.stage, updatedAt: now });
+        return this.writePendingDeposit(merged, now);
+    },
+    /**
+     * Create a new pending deposit draft.
+     */
+    createPendingDepositDraft: function (params) {
+        var _a;
+        var now = (_a = params.now) !== null && _a !== void 0 ? _a : Date.now();
+        return this.writePendingDeposit({
+            depositId: params.depositId,
+            wallet: params.wallet,
+            chain: params.chain,
+            amount: params.amount,
+            stage: 'initiated',
+            tx: null,
+            mintTx: null,
+            attestationId: null,
+            explorerUrl: null,
+            reason: null,
+            updatedAt: now,
+        }, now);
+    },
+};
+//# sourceMappingURL=StorageService.js.map