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

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

@@ -0,0 +1,280 @@
+/**
+ * Session Bootstrap Service
+ *
+ * Handles session key generation, storage, and signing function creation.
+ * Extracted from useNordUserInitialization to enable:
+ * - Testable pure functions
+ * - Clear separation from React lifecycle
+ * - Reusable session logic
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { logger } from '../../utils/logger';
+// ============================================
+// CONSTANTS
+// ============================================
+var SESSION_KEYS_PREFIX = 'n1_session_keys_';
+var SESSION_ID_PREFIX = 'n1_sessionId_';
+// ============================================
+// STORAGE HELPERS
+// ============================================
+/**
+ * Generate storage key for session keys.
+ */
+function getSessionKeysStorageKey(address) {
+    return "".concat(SESSION_KEYS_PREFIX).concat(address);
+}
+/**
+ * Generate storage key for session ID.
+ */
+function getSessionIdStorageKey(address) {
+    return "".concat(SESSION_ID_PREFIX).concat(address);
+}
+// ============================================
+// SESSION KEY MANAGEMENT
+// ============================================
+/**
+ * Check if session keys exist for an address.
+ */
+export function hasStoredSessionKeys(address) {
+    if (typeof localStorage === 'undefined')
+        return false;
+    try {
+        var key = getSessionKeysStorageKey(address);
+        var stored = localStorage.getItem(key);
+        if (!stored)
+            return false;
+        var parsed = JSON.parse(stored);
+        return !!((parsed === null || parsed === void 0 ? void 0 : parsed.ed25519PublicKey) && (parsed === null || parsed === void 0 ? void 0 : parsed.ed25519PrivateKey));
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Read stored session keys for an address.
+ */
+export function readSessionKeys(address) {
+    if (typeof localStorage === 'undefined')
+        return null;
+    try {
+        var key = getSessionKeysStorageKey(address);
+        var stored = localStorage.getItem(key);
+        if (!stored)
+            return null;
+        var parsed = JSON.parse(stored);
+        if (!(parsed === null || parsed === void 0 ? void 0 : parsed.ed25519PublicKey) || !(parsed === null || parsed === void 0 ? void 0 : parsed.ed25519PrivateKey)) {
+            return null;
+        }
+        // Convert arrays back to Uint8Array
+        return {
+            ed25519PrivateKey: new Uint8Array(Object.values(parsed.ed25519PrivateKey)),
+            ed25519PublicKey: new Uint8Array(Object.values(parsed.ed25519PublicKey)),
+            walletPublicKey: parsed.walletPublicKey,
+            chainName: parsed.chainName,
+        };
+    }
+    catch (error) {
+        logger.warn('[SessionBootstrapService] Failed to read session keys', { error: error });
+        return null;
+    }
+}
+/**
+ * Store session keys for an address.
+ */
+export function storeSessionKeys(params) {
+    var _a;
+    if (typeof localStorage === 'undefined')
+        return;
+    try {
+        var key = getSessionKeysStorageKey(params.address);
+        var data = {
+            ed25519PrivateKey: Array.from(params.privateKey),
+            ed25519PublicKey: Array.from(params.publicKey),
+            walletPublicKey: params.address,
+            chainName: (_a = params.chainName) !== null && _a !== void 0 ? _a : 'SOL',
+        };
+        localStorage.setItem(key, JSON.stringify(data));
+        logger.debug('[SessionBootstrapService] Session keys stored');
+    }
+    catch (error) {
+        logger.warn('[SessionBootstrapService] Failed to store session keys', { error: error });
+    }
+}
+/**
+ * Clear session keys for an address.
+ */
+export function clearSessionKeys(address) {
+    if (typeof localStorage === 'undefined')
+        return;
+    try {
+        var key = getSessionKeysStorageKey(address);
+        localStorage.removeItem(key);
+        logger.debug('[SessionBootstrapService] Session keys cleared');
+    }
+    catch (_a) {
+        // Ignore
+    }
+}
+// ============================================
+// SESSION ID MANAGEMENT
+// ============================================
+/**
+ * Read stored session ID for an address.
+ */
+export function readSessionId(address) {
+    if (typeof localStorage === 'undefined')
+        return null;
+    try {
+        var key = getSessionIdStorageKey(address);
+        var stored = localStorage.getItem(key);
+        if (!stored)
+            return null;
+        return BigInt(stored);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+/**
+ * Store session ID for an address.
+ */
+export function storeSessionId(address, sessionId) {
+    if (typeof localStorage === 'undefined')
+        return;
+    try {
+        var key = getSessionIdStorageKey(address);
+        localStorage.setItem(key, sessionId.toString());
+    }
+    catch (_a) {
+        // Ignore
+    }
+}
+/**
+ * Clear session ID for an address.
+ */
+export function clearSessionId(address) {
+    if (typeof localStorage === 'undefined')
+        return;
+    try {
+        var key = getSessionIdStorageKey(address);
+        localStorage.removeItem(key);
+    }
+    catch (_a) {
+        // Ignore
+    }
+}
+// ============================================
+// SESSION INITIALIZATION
+// ============================================
+/**
+ * Get or create session key pair for an address.
+ *
+ * This function:
+ * 1. Checks for existing stored keys
+ * 2. If found, returns them
+ * 3. If not found, generates new keys (caller must provide generator)
+ */
+export function getOrCreateSessionKeyPair(address, generateKeyPair) {
+    return __awaiter(this, void 0, void 0, function () {
+        var stored, keyPair;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    stored = readSessionKeys(address);
+                    if (stored) {
+                        logger.debug('[SessionBootstrapService] Using stored session keys');
+                        return [2 /*return*/, {
+                                privateKey: stored.ed25519PrivateKey,
+                                publicKey: stored.ed25519PublicKey,
+                            }];
+                    }
+                    // Generate new keys
+                    logger.debug('[SessionBootstrapService] Generating new session keys');
+                    return [4 /*yield*/, generateKeyPair()];
+                case 1:
+                    keyPair = _a.sent();
+                    // Store for future use
+                    storeSessionKeys({
+                        address: address,
+                        privateKey: keyPair.privateKey,
+                        publicKey: keyPair.publicKey,
+                    });
+                    return [2 /*return*/, keyPair];
+            }
+        });
+    });
+}
+// ============================================
+// SESSION STATE HELPERS
+// ============================================
+/**
+ * Check if a session is fully initialized.
+ */
+export function isSessionReady(params) {
+    return !!(params.sessionPubKey &&
+        params.signMessageWithSessionKey &&
+        params.signMessageWithWalletKey &&
+        params.signTransactionWithWalletKey);
+}
+/**
+ * Clear all session data for an address.
+ */
+export function clearAllSessionData(address) {
+    clearSessionKeys(address);
+    clearSessionId(address);
+    logger.debug('[SessionBootstrapService] All session data cleared');
+}
+// ============================================
+// VALIDATION
+// ============================================
+/**
+ * Validate session keys are usable.
+ */
+export function validateSessionKeys(keys) {
+    // Check key lengths
+    if (keys.ed25519PrivateKey.length !== 64) {
+        logger.warn('[SessionBootstrapService] Invalid private key length');
+        return false;
+    }
+    if (keys.ed25519PublicKey.length !== 32) {
+        logger.warn('[SessionBootstrapService] Invalid public key length');
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=SessionBootstrapService.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionBootstrapService.js","sourceRoot":"","sources":["../../../../src/services/bootstrap/SessionBootstrapService.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Session Bootstrap Service\n *\n * Handles session key generation, storage, and signing function creation.\n * Extracted from useNordUserInitialization to enable:\n * - Testable pure functions\n * - Clear separation from React lifecycle\n * - Reusable session logic\n */\n\nimport { logger } from '../../utils/logger';\n\n// ============================================\n// CONSTANTS\n// ============================================\n\nconst SESSION_KEYS_PREFIX = 'n1_session_keys_';\nconst SESSION_ID_PREFIX = 'n1_sessionId_';\n\n// ============================================\n// STORAGE HELPERS\n// ============================================\n\n/**\n * Generate storage key for session keys.\n */\nfunction getSessionKeysStorageKey(address: string): string {\n  return `${SESSION_KEYS_PREFIX}${address}`;\n}\n\n/**\n * Generate storage key for session ID.\n */\nfunction getSessionIdStorageKey(address: string): string {\n  return `${SESSION_ID_PREFIX}${address}`;\n}\n\n// ============================================\n// SESSION KEY TYPES\n// ============================================\n\nexport interface StoredSessionKeys {\n  ed25519PrivateKey: Uint8Array;\n  ed25519PublicKey: Uint8Array;\n  walletPublicKey: string;\n  chainName: string;\n}\n\nexport interface SessionKeyPair {\n  privateKey: Uint8Array;\n  publicKey: Uint8Array;\n}\n\n// ============================================\n// SESSION KEY MANAGEMENT\n// ============================================\n\n/**\n * Check if session keys exist for an address.\n */\nexport function hasStoredSessionKeys(address: string): boolean {\n  if (typeof localStorage === 'undefined') return false;\n\n  try {\n    const key = getSessionKeysStorageKey(address);\n    const stored = localStorage.getItem(key);\n    if (!stored) return false;\n\n    const parsed = JSON.parse(stored);\n    return !!(parsed?.ed25519PublicKey && parsed?.ed25519PrivateKey);\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Read stored session keys for an address.\n */\nexport function readSessionKeys(address: string): StoredSessionKeys | null {\n  if (typeof localStorage === 'undefined') return null;\n\n  try {\n    const key = getSessionKeysStorageKey(address);\n    const stored = localStorage.getItem(key);\n    if (!stored) return null;\n\n    const parsed = JSON.parse(stored);\n    if (!parsed?.ed25519PublicKey || !parsed?.ed25519PrivateKey) {\n      return null;\n    }\n\n    // Convert arrays back to Uint8Array\n    return {\n      ed25519PrivateKey: new Uint8Array(Object.values(parsed.ed25519PrivateKey)),\n      ed25519PublicKey: new Uint8Array(Object.values(parsed.ed25519PublicKey)),\n      walletPublicKey: parsed.walletPublicKey,\n      chainName: parsed.chainName,\n    };\n  } catch (error) {\n    logger.warn('[SessionBootstrapService] Failed to read session keys', { error });\n    return null;\n  }\n}\n\n/**\n * Store session keys for an address.\n */\nexport function storeSessionKeys(params: {\n  address: string;\n  privateKey: Uint8Array;\n  publicKey: Uint8Array;\n  chainName?: string;\n}): void {\n  if (typeof localStorage === 'undefined') return;\n\n  try {\n    const key = getSessionKeysStorageKey(params.address);\n    const data = {\n      ed25519PrivateKey: Array.from(params.privateKey),\n      ed25519PublicKey: Array.from(params.publicKey),\n      walletPublicKey: params.address,\n      chainName: params.chainName ?? 'SOL',\n    };\n    localStorage.setItem(key, JSON.stringify(data));\n    logger.debug('[SessionBootstrapService] Session keys stored');\n  } catch (error) {\n    logger.warn('[SessionBootstrapService] Failed to store session keys', { error });\n  }\n}\n\n/**\n * Clear session keys for an address.\n */\nexport function clearSessionKeys(address: string): void {\n  if (typeof localStorage === 'undefined') return;\n\n  try {\n    const key = getSessionKeysStorageKey(address);\n    localStorage.removeItem(key);\n    logger.debug('[SessionBootstrapService] Session keys cleared');\n  } catch {\n    // Ignore\n  }\n}\n\n// ============================================\n// SESSION ID MANAGEMENT\n// ============================================\n\n/**\n * Read stored session ID for an address.\n */\nexport function readSessionId(address: string): bigint | null {\n  if (typeof localStorage === 'undefined') return null;\n\n  try {\n    const key = getSessionIdStorageKey(address);\n    const stored = localStorage.getItem(key);\n    if (!stored) return null;\n\n    return BigInt(stored);\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Store session ID for an address.\n */\nexport function storeSessionId(address: string, sessionId: bigint): void {\n  if (typeof localStorage === 'undefined') return;\n\n  try {\n    const key = getSessionIdStorageKey(address);\n    localStorage.setItem(key, sessionId.toString());\n  } catch {\n    // Ignore\n  }\n}\n\n/**\n * Clear session ID for an address.\n */\nexport function clearSessionId(address: string): void {\n  if (typeof localStorage === 'undefined') return;\n\n  try {\n    const key = getSessionIdStorageKey(address);\n    localStorage.removeItem(key);\n  } catch {\n    // Ignore\n  }\n}\n\n// ============================================\n// SESSION INITIALIZATION\n// ============================================\n\n/**\n * Get or create session key pair for an address.\n *\n * This function:\n * 1. Checks for existing stored keys\n * 2. If found, returns them\n * 3. If not found, generates new keys (caller must provide generator)\n */\nexport async function getOrCreateSessionKeyPair(\n  address: string,\n  generateKeyPair: () => Promise<SessionKeyPair>\n): Promise<SessionKeyPair> {\n  // Check for existing keys\n  const stored = readSessionKeys(address);\n  if (stored) {\n    logger.debug('[SessionBootstrapService] Using stored session keys');\n    return {\n      privateKey: stored.ed25519PrivateKey,\n      publicKey: stored.ed25519PublicKey,\n    };\n  }\n\n  // Generate new keys\n  logger.debug('[SessionBootstrapService] Generating new session keys');\n  const keyPair = await generateKeyPair();\n\n  // Store for future use\n  storeSessionKeys({\n    address,\n    privateKey: keyPair.privateKey,\n    publicKey: keyPair.publicKey,\n  });\n\n  return keyPair;\n}\n\n// ============================================\n// SESSION STATE HELPERS\n// ============================================\n\n/**\n * Check if a session is fully initialized.\n */\nexport function isSessionReady(params: {\n  sessionPubKey: Uint8Array | null;\n  signMessageWithSessionKey: unknown;\n  signMessageWithWalletKey: unknown;\n  signTransactionWithWalletKey: unknown;\n}): boolean {\n  return !!(\n    params.sessionPubKey &&\n    params.signMessageWithSessionKey &&\n    params.signMessageWithWalletKey &&\n    params.signTransactionWithWalletKey\n  );\n}\n\n/**\n * Clear all session data for an address.\n */\nexport function clearAllSessionData(address: string): void {\n  clearSessionKeys(address);\n  clearSessionId(address);\n  logger.debug('[SessionBootstrapService] All session data cleared');\n}\n\n// ============================================\n// VALIDATION\n// ============================================\n\n/**\n * Validate session keys are usable.\n */\nexport function validateSessionKeys(keys: StoredSessionKeys): boolean {\n  // Check key lengths\n  if (keys.ed25519PrivateKey.length !== 64) {\n    logger.warn('[SessionBootstrapService] Invalid private key length');\n    return false;\n  }\n\n  if (keys.ed25519PublicKey.length !== 32) {\n    logger.warn('[SessionBootstrapService] Invalid public key length');\n    return false;\n  }\n\n  return true;\n}\n"]}

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

@@ -0,0 +1,92 @@
+/**
+ * Turnkey Bootstrap Service
+ *
+ * Handles Turnkey authentication and wallet provisioning.
+ * Extracted from TurnkeyProvider to enable:
+ * - Testable pure functions
+ * - Clear separation from React lifecycle
+ * - Reusable bootstrap logic
+ */
+import type { TurnkeySessionData } from './types';
+export declare const TURNKEY_WALLET_NAME = "Nord Turnkey Wallet";
+export declare const SOLANA_ADDRESS_FORMAT = "ADDRESS_FORMAT_SOLANA";
+/**
+ * Normalize EVM address to lowercase for consistent comparison.
+ */
+export declare function normalizeAddress(address?: string | null): string | null;
+/**
+ * Check if error indicates user rejected the action.
+ */
+export declare function isUserRejectedError(error: unknown): boolean;
+/**
+ * Check if the stored session belongs to a different user.
+ * Returns true if we need to clear the session for the new user.
+ */
+export declare function isSessionForDifferentUser(targetAddress: string): boolean;
+/**
+ * Check if we have a valid stored session for the target address.
+ */
+export declare function hasStoredSession(targetAddress: string): boolean;
+/**
+ * Get stored session data for the target address.
+ */
+export declare function getStoredSession(targetAddress: string): TurnkeySessionData | null;
+/**
+ * Store session data after successful login.
+ */
+export declare function storeSession(targetAddress: string, sessionKey: string, options?: {
+    evmAddress?: string | null;
+    solanaAccount?: TurnkeySessionData['solanaAccount'];
+    session?: unknown;
+}): void;
+/**
+ * Update the Solana account for an existing session.
+ */
+export declare function updateSessionSolanaAccount(targetAddress: string, solanaAccount: NonNullable<TurnkeySessionData['solanaAccount']>): void;
+/**
+ * Clear session for logout or user switch.
+ */
+export declare function clearSession(targetAddress?: string | null): void;
+/**
+ * Find an existing Solana wallet in the list of Turnkey wallets.
+ */
+export declare function findExistingSolanaWallet(wallets: any[]): any | null;
+/**
+ * Extract Solana account from a wallet.
+ */
+export declare function extractSolanaAccount(wallet: any): any | null;
+/**
+ * Check if stored session has Solana account cached.
+ */
+export declare function hasCachedSolanaAccount(targetAddress: string): boolean;
+/**
+ * Get cached Solana account from stored session.
+ */
+export declare function getCachedSolanaAccount(targetAddress: string): TurnkeySessionData['solanaAccount'] | null;
+/**
+ * Determine next action for Turnkey bootstrap.
+ *
+ * This is a pure function that determines what should happen next
+ * without actually performing the action.
+ */
+export declare function determineBootstrapAction(params: {
+    targetAddress: string | null;
+    walletNetwork: 'solana' | 'evm' | null;
+    hasEvmWallet: boolean;
+    hasTurnkeyConfig: boolean;
+}): 'skip' | 'reset' | 'hydrate' | 'login';
+/**
+ * Determine next action for Solana wallet provisioning.
+ */
+export declare function determineSolanaProvisionAction(params: {
+    targetAddress: string;
+    existingWallets: any[];
+}): 'use_cached' | 'use_existing' | 'create';
+/**
+ * Categorize a Turnkey error for appropriate handling.
+ */
+export declare function categorizeTurnkeyError(error: unknown): {
+    type: 'user_rejected' | 'network' | 'session_expired' | 'unknown';
+    message: string;
+    recoverable: boolean;
+};

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

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