@solana/connector 0.0.0 → 0.1.0

package/dist/chunk-ACFSCMUI.mjs

@@ -0,0 +1,359 @@
+import { DEFAULT_MAX_RETRIES, toClusterId, normalizeNetwork, getDefaultRpcUrl } from './chunk-52WUWW5R.mjs';
+import { createLogger, __publicField } from './chunk-5ZUVZZWU.mjs';
+import { Storage, createSolanaMainnet, createSolanaDevnet, createSolanaTestnet, createSolanaLocalnet } from '@wallet-ui/core';
+export { createSolanaDevnet, createSolanaLocalnet, createSolanaMainnet, createSolanaTestnet } from '@wallet-ui/core';
+import { isAddress, getExplorerLink } from 'gill';
+
+var logger = createLogger("EnhancedStorage"), STORAGE_VERSION = "v1", EnhancedStorage = class extends Storage {
+  constructor(key, initial, options) {
+    super(key, initial);
+    this.options = options;
+    __publicField(this, "errorHandlers", /* @__PURE__ */ new Set());
+    __publicField(this, "validators", []);
+    __publicField(this, "memoryFallback");
+    this.memoryFallback = initial, options?.onError && this.errorHandlers.add(options.onError), options?.validator && this.validators.push(options.validator);
+  }
+  /**
+   * Enhanced set with validation and error handling
+   * @returns boolean indicating success
+   */
+  set(value) {
+    try {
+      return this.validate(value) ? (super.set(value), this.memoryFallback = value, true) : (logger.warn("Validation failed", { key: this.key }), false);
+    } catch (error) {
+      return this.handleError(error), this.options?.useMemoryFallback ? (this.memoryFallback = value, true) : false;
+    }
+  }
+  /**
+   * Enhanced get with error handling and fallback
+   */
+  get() {
+    try {
+      return super.get();
+    } catch (error) {
+      return this.handleError(error), this.options?.useMemoryFallback ? this.memoryFallback : this.initial;
+    }
+  }
+  /**
+   * Validate a value against all registered validators
+   */
+  validate(value) {
+    return this.validators.every((validator) => validator(value));
+  }
+  /**
+   * Add a validation rule (chainable)
+   *
+   * @example
+   * ```ts
+   * storage
+   *   .addValidator((addr) => addr?.length === 44)
+   *   .addValidator((addr) => addr?.startsWith('5'))
+   * ```
+   */
+  addValidator(validator) {
+    return this.validators.push(validator), this;
+  }
+  /**
+   * Add error handler (chainable)
+   */
+  onError(handler) {
+    return this.errorHandlers.add(handler), this;
+  }
+  /**
+   * Transform the stored value
+   *
+   * @example
+   * ```ts
+   * const formatted = storage.transform(
+   *   (address) => address ? formatAddress(address) : ''
+   * )
+   * ```
+   */
+  transform(transformer) {
+    return transformer(this.get());
+  }
+  /**
+   * Reset to initial value
+   */
+  reset() {
+    this.set(this.initial);
+  }
+  /**
+   * Clear storage (remove from localStorage)
+   */
+  clear() {
+    try {
+      typeof window < "u" && window.localStorage && window.localStorage.removeItem(this.key), this.reset();
+    } catch (error) {
+      this.handleError(error);
+    }
+  }
+  /**
+   * Check if storage is available (not in private mode, quota not exceeded)
+   */
+  isAvailable() {
+    try {
+      if (typeof window > "u") return false;
+      let testKey = `__storage_test_${this.key}__`;
+      return window.localStorage.setItem(testKey, "test"), window.localStorage.removeItem(testKey), true;
+    } catch {
+      return false;
+    }
+  }
+  /**
+   * Migrate from old key to new key
+   *
+   * @example
+   * ```ts
+   * EnhancedStorage.migrate(
+   *   'old-connector:account',
+   *   createEnhancedStorageAccount()
+   * )
+   * ```
+   */
+  static migrate(oldKey, newStorage) {
+    try {
+      if (typeof window > "u") return false;
+      let oldValue = window.localStorage.getItem(oldKey);
+      if (oldValue) {
+        let parsed = JSON.parse(oldValue);
+        return newStorage.set(parsed), window.localStorage.removeItem(oldKey), true;
+      }
+      return false;
+    } catch {
+      return false;
+    }
+  }
+  handleError(error) {
+    logger.error("Storage error", { key: this.key, error }), this.errorHandlers.forEach((handler) => {
+      try {
+        handler(error);
+      } catch (err) {
+        logger.error("Error in error handler", { error: err });
+      }
+    });
+  }
+};
+function createEnhancedStorageAccount(options) {
+  let key = options?.key ?? `connector-kit:${STORAGE_VERSION}:account`;
+  return new EnhancedStorage(key, options?.initial, {
+    validator: options?.validator,
+    onError: options?.onError,
+    useMemoryFallback: true
+    // Always fallback for SSR
+  });
+}
+function createEnhancedStorageCluster(options) {
+  let key = options?.key ?? `connector-kit:${STORAGE_VERSION}:cluster`, storage = new EnhancedStorage(key, options?.initial ?? "solana:mainnet", {
+    onError: options?.onError,
+    useMemoryFallback: true
+  });
+  return options?.validClusters && storage.addValidator((clusterId) => options.validClusters.includes(clusterId)), storage;
+}
+function createEnhancedStorageWallet(options) {
+  let key = options?.key ?? `connector-kit:${STORAGE_VERSION}:wallet`;
+  return new EnhancedStorage(key, options?.initial, {
+    onError: options?.onError,
+    useMemoryFallback: true
+  });
+}
+var EnhancedStorageAdapter = class {
+  constructor(storage) {
+    this.storage = storage;
+  }
+  get() {
+    return this.storage.get();
+  }
+  set(value) {
+    this.storage.set(value);
+  }
+  subscribe(callback) {
+    return this.storage.value.subscribe(callback);
+  }
+  validate(value) {
+    return this.storage.validate(value);
+  }
+  reset() {
+    this.storage.reset();
+  }
+  clear() {
+    this.storage.clear();
+  }
+  isAvailable() {
+    return this.storage.isAvailable();
+  }
+  transform(transformer) {
+    return this.storage.transform(transformer);
+  }
+  addValidator(validator) {
+    return this.storage.addValidator(validator), this;
+  }
+  onError(handler) {
+    return this.storage.onError(handler), this;
+  }
+};
+var logger2 = createLogger("DefaultConfig");
+function getDefaultConfig(options) {
+  let {
+    appName,
+    appUrl,
+    autoConnect = true,
+    debug,
+    network = "mainnet-beta",
+    enableMobile = true,
+    storage,
+    clusters,
+    customClusters = [],
+    persistClusterSelection = true,
+    clusterStorageKey,
+    enableErrorBoundary = true,
+    maxRetries = DEFAULT_MAX_RETRIES,
+    onError
+  } = options, defaultClusters = clusters ?? [
+    createSolanaMainnet(),
+    createSolanaDevnet(),
+    createSolanaTestnet(),
+    ...network === "localnet" ? [createSolanaLocalnet()] : [],
+    ...customClusters || []
+  ], validClusterIds = defaultClusters.map((c) => c.id), accountStorage = createEnhancedStorageAccount({
+    validator: (address) => address ? isAddress(address) : true,
+    onError: (error) => {
+      debug && logger2.error("Account Storage error", { error }), onError && onError(error, {
+        componentStack: "account-storage"
+      });
+    }
+  }), clusterStorage = createEnhancedStorageCluster({
+    key: clusterStorageKey,
+    initial: getInitialCluster(network),
+    validClusters: persistClusterSelection ? validClusterIds : void 0,
+    onError: (error) => {
+      debug && logger2.error("Cluster Storage error", { error }), onError && onError(error, {
+        componentStack: "cluster-storage"
+      });
+    }
+  }), walletStorage = createEnhancedStorageWallet({
+    onError: (error) => {
+      debug && logger2.error("Wallet Storage error", { error }), onError && onError(error, {
+        componentStack: "wallet-storage"
+      });
+    }
+  });
+  if (typeof window < "u") {
+    let oldAccountKey = "connector-kit:account", oldWalletKey = "connector-kit:wallet", oldClusterKey = clusterStorageKey || "connector-kit:cluster";
+    EnhancedStorage.migrate(oldAccountKey, accountStorage), EnhancedStorage.migrate(oldWalletKey, walletStorage), EnhancedStorage.migrate(oldClusterKey, clusterStorage);
+  }
+  let defaultStorage = storage ?? {
+    account: new EnhancedStorageAdapter(accountStorage),
+    cluster: new EnhancedStorageAdapter(clusterStorage),
+    wallet: new EnhancedStorageAdapter(walletStorage)
+  };
+  return {
+    autoConnect,
+    debug: debug ?? process.env.NODE_ENV === "development",
+    storage: defaultStorage,
+    appName,
+    appUrl,
+    enableMobile,
+    network,
+    cluster: {
+      clusters: defaultClusters,
+      persistSelection: persistClusterSelection,
+      initialCluster: getInitialCluster(network)
+    },
+    errorBoundary: {
+      enabled: enableErrorBoundary,
+      maxRetries,
+      onError
+    }
+  };
+}
+function getInitialCluster(network = "mainnet-beta") {
+  return toClusterId(network);
+}
+function getDefaultMobileConfig(options) {
+  let baseUrl = options.appUrl || (typeof window < "u" ? window.location.origin : "https://localhost:3000");
+  return {
+    appIdentity: {
+      name: options.appName,
+      uri: baseUrl,
+      icon: `${baseUrl}/favicon.ico`
+    },
+    cluster: options.network || "mainnet-beta"
+  };
+}
+
+// src/config/unified-config.ts
+function createConfig(options) {
+  let { network = "mainnet-beta", rpcUrl: customRpcUrl, ...connectorOptions } = options, normalizedNetwork = normalizeNetwork(typeof network == "string" ? network : "mainnet-beta"), rpcUrl = customRpcUrl || getDefaultRpcUrl(normalizedNetwork), rpcNetwork = normalizedNetwork === "mainnet" ? "mainnet-beta" : normalizedNetwork, connectorConfig = getDefaultConfig({
+    ...connectorOptions,
+    network: rpcNetwork
+  }), mobile = options.enableMobile !== false && normalizedNetwork !== "localnet" ? getDefaultMobileConfig({
+    appName: options.appName,
+    appUrl: connectorConfig.appUrl,
+    network: rpcNetwork
+  }) : void 0;
+  return {
+    connectorConfig,
+    mobile,
+    network: normalizedNetwork,
+    rpcUrl,
+    app: {
+      name: options.appName,
+      url: connectorConfig.appUrl || (typeof window < "u" ? window.location.origin : "https://localhost:3000")
+    }
+  };
+}
+function isUnifiedConfig(config) {
+  return !!(config && typeof config == "object" && "connectorConfig" in config && "network" in config && "rpcUrl" in config && "app" in config);
+}
+
+// src/types/wallets.ts
+function isWalletName(value) {
+  return typeof value == "string" && value.length > 0;
+}
+function isAccountAddress(value) {
+  return typeof value == "string" && value.length >= 32 && value.length <= 44;
+}
+function getSolanaExplorerUrl(signature, options = {}) {
+  let { cluster = "mainnet", customUrl } = options, normalizedCluster = cluster === "mainnet-beta" ? "mainnet" : cluster;
+  if (normalizedCluster === "localnet")
+    return `https://explorer.solana.com/tx/${signature}?cluster=custom&customUrl=${encodeURIComponent(customUrl || "http://localhost:8899")}`;
+  let explorerCluster = ["mainnet", "devnet", "testnet"].includes(normalizedCluster) ? normalizedCluster : "devnet";
+  return getExplorerLink({
+    transaction: signature,
+    cluster: explorerCluster
+  });
+}
+function getSolscanUrl(signature, options = {}) {
+  let { cluster = "mainnet" } = options, normalizedCluster = cluster === "mainnet-beta" ? "mainnet" : cluster;
+  return normalizedCluster === "mainnet" ? `https://solscan.io/tx/${signature}` : normalizedCluster === "localnet" ? `https://solscan.io/tx/${signature}?cluster=custom` : `https://solscan.io/tx/${signature}?cluster=${normalizedCluster}`;
+}
+function getXrayUrl(signature) {
+  return `https://xray.helius.xyz/tx/${signature}`;
+}
+function getSolanaFmUrl(signature, options = {}) {
+  let { cluster = "mainnet" } = options, normalizedCluster = cluster === "mainnet-beta" ? "mainnet" : cluster;
+  return normalizedCluster === "mainnet" ? `https://solana.fm/tx/${signature}` : `https://solana.fm/tx/${signature}?cluster=${normalizedCluster}`;
+}
+function getAllExplorerUrls(signature, options = {}) {
+  return {
+    "solana-explorer": getSolanaExplorerUrl(signature, options),
+    solscan: getSolscanUrl(signature, options),
+    xray: getXrayUrl(signature),
+    "solana-fm": getSolanaFmUrl(signature, options)
+  };
+}
+function formatSignature(signature, chars = 8) {
+  return signature.length <= chars * 2 ? signature : `${signature.slice(0, chars)}...${signature.slice(-chars)}`;
+}
+async function copySignature(signature) {
+  try {
+    return await navigator.clipboard.writeText(signature), true;
+  } catch {
+    return false;
+  }
+}
+
+export { EnhancedStorage, EnhancedStorageAdapter, copySignature, createConfig, createEnhancedStorageAccount, createEnhancedStorageCluster, createEnhancedStorageWallet, formatSignature, getAllExplorerUrls, getDefaultConfig, getDefaultMobileConfig, getSolanaExplorerUrl, getSolanaFmUrl, getSolscanUrl, getXrayUrl, isAccountAddress, isUnifiedConfig, isWalletName };
+//# sourceMappingURL=chunk-ACFSCMUI.mjs.map
+//# sourceMappingURL=chunk-ACFSCMUI.mjs.map

package/dist/chunk-ACFSCMUI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/adapters/enhanced-storage.ts","../src/config/default-config.ts","../src/config/unified-config.ts","../src/types/wallets.ts","../src/lib/utils/explorer-urls.ts"],"names":["WalletUiStorage","logger"],"mappings":"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","file":"chunk-ACFSCMUI.mjs","sourcesContent":["/**\n * @solana/connector - Enhanced Storage\n *\n * Extended version of @wallet-ui/core Storage with additional features:\n * - Validation hooks\n * - Error handling and recovery\n * - SSR/memory fallback\n * - Transform utilities\n * - Migration support\n * - Storage availability checks\n */\n\nimport { Storage as WalletUiStorage } from '@wallet-ui/core';\nimport type { SolanaClusterId } from '@wallet-ui/core';\nimport type {\n    StorageOptions,\n    StorageAdapter,\n    EnhancedStorageAccountOptions,\n    EnhancedStorageClusterOptions,\n    EnhancedStorageWalletOptions,\n} from '../../types/storage';\nimport { createLogger } from '../utils/secure-logger';\n\nconst logger = createLogger('EnhancedStorage');\n\n/**\n * Storage version for migration support\n * Increment when making breaking changes to storage format\n */\nexport const STORAGE_VERSION = 'v1';\n\n/**\n * Enhanced version of wallet-ui's Storage class\n * Extends the base Storage with validation, error handling, and SSR support\n */\nexport class EnhancedStorage<T> extends WalletUiStorage<T> {\n    private errorHandlers: Set<(error: Error) => void> = new Set();\n    private validators: ((value: T) => boolean)[] = [];\n    private memoryFallback: T;\n\n    constructor(\n        key: string,\n        initial: T,\n        private options?: StorageOptions<T>,\n    ) {\n        super(key, initial);\n        this.memoryFallback = initial;\n\n        if (options?.onError) {\n            this.errorHandlers.add(options.onError);\n        }\n        if (options?.validator) {\n            this.validators.push(options.validator);\n        }\n    }\n\n    /**\n     * Enhanced set with validation and error handling\n     * @returns boolean indicating success\n     */\n    override set(value: T): boolean {\n        try {\n            if (!this.validate(value)) {\n                logger.warn('Validation failed', { key: this.key });\n                return false;\n            }\n\n            super.set(value);\n\n            this.memoryFallback = value;\n            return true;\n        } catch (error) {\n            this.handleError(error as Error);\n\n            if (this.options?.useMemoryFallback) {\n                this.memoryFallback = value;\n                return true;\n            }\n\n            return false;\n        }\n    }\n\n    /**\n     * Enhanced get with error handling and fallback\n     */\n    override get(): T {\n        try {\n            return super.get();\n        } catch (error) {\n            this.handleError(error as Error);\n\n            if (this.options?.useMemoryFallback) {\n                return this.memoryFallback;\n            }\n\n            return this.initial;\n        }\n    }\n\n    /**\n     * Validate a value against all registered validators\n     */\n    validate(value: T): boolean {\n        return this.validators.every(validator => validator(value));\n    }\n\n    /**\n     * Add a validation rule (chainable)\n     *\n     * @example\n     * ```ts\n     * storage\n     *   .addValidator((addr) => addr?.length === 44)\n     *   .addValidator((addr) => addr?.startsWith('5'))\n     * ```\n     */\n    addValidator(validator: (value: T) => boolean): this {\n        this.validators.push(validator);\n        return this;\n    }\n\n    /**\n     * Add error handler (chainable)\n     */\n    onError(handler: (error: Error) => void): this {\n        this.errorHandlers.add(handler);\n        return this;\n    }\n\n    /**\n     * Transform the stored value\n     *\n     * @example\n     * ```ts\n     * const formatted = storage.transform(\n     *   (address) => address ? formatAddress(address) : ''\n     * )\n     * ```\n     */\n    transform<U>(transformer: (value: T) => U): U {\n        return transformer(this.get());\n    }\n\n    /**\n     * Reset to initial value\n     */\n    reset(): void {\n        this.set(this.initial);\n    }\n\n    /**\n     * Clear storage (remove from localStorage)\n     */\n    clear(): void {\n        try {\n            if (typeof window !== 'undefined' && window.localStorage) {\n                window.localStorage.removeItem(this.key);\n            }\n            this.reset();\n        } catch (error) {\n            this.handleError(error as Error);\n        }\n    }\n\n    /**\n     * Check if storage is available (not in private mode, quota not exceeded)\n     */\n    isAvailable(): boolean {\n        try {\n            if (typeof window === 'undefined') return false;\n            const testKey = `__storage_test_${this.key}__`;\n            window.localStorage.setItem(testKey, 'test');\n            window.localStorage.removeItem(testKey);\n            return true;\n        } catch {\n            return false;\n        }\n    }\n\n    /**\n     * Migrate from old key to new key\n     *\n     * @example\n     * ```ts\n     * EnhancedStorage.migrate(\n     *   'old-connector:account',\n     *   createEnhancedStorageAccount()\n     * )\n     * ```\n     */\n    static migrate<T>(oldKey: string, newStorage: EnhancedStorage<T>): boolean {\n        try {\n            if (typeof window === 'undefined') return false;\n\n            const oldValue = window.localStorage.getItem(oldKey);\n            if (oldValue) {\n                const parsed = JSON.parse(oldValue) as T;\n                newStorage.set(parsed);\n                window.localStorage.removeItem(oldKey);\n                return true;\n            }\n            return false;\n        } catch {\n            return false;\n        }\n    }\n\n    private handleError(error: Error): void {\n        logger.error('Storage error', { key: this.key, error });\n        this.errorHandlers.forEach(handler => {\n            try {\n                handler(error);\n            } catch (err) {\n                logger.error('Error in error handler', { error: err });\n            }\n        });\n    }\n}\n\n// ============================================================================\n// Factory Functions\n// ============================================================================\n\n/**\n * Create a storage instance for wallet account persistence\n *\n * @example\n * ```ts\n * const storage = createEnhancedStorageAccount({\n *   validator: (address) => {\n *     if (!address) return true\n *     return isAddress(address)\n *   }\n * })\n * ```\n */\nexport function createEnhancedStorageAccount(\n    options?: EnhancedStorageAccountOptions,\n): EnhancedStorage<string | undefined> {\n    const key = options?.key ?? `connector-kit:${STORAGE_VERSION}:account`;\n    return new EnhancedStorage(key, options?.initial, {\n        validator: options?.validator,\n        onError: options?.onError,\n        useMemoryFallback: true, // Always fallback for SSR\n    });\n}\n\n/**\n * Create a storage instance for cluster selection persistence\n *\n * @example\n * ```ts\n * const storage = createEnhancedStorageCluster({\n *   initial: 'solana:mainnet',\n *   validClusters: ['solana:mainnet', 'solana:devnet']\n * })\n * ```\n */\nexport function createEnhancedStorageCluster(\n    options?: EnhancedStorageClusterOptions,\n): EnhancedStorage<SolanaClusterId> {\n    const key = options?.key ?? `connector-kit:${STORAGE_VERSION}:cluster`;\n    const storage = new EnhancedStorage(key, options?.initial ?? 'solana:mainnet', {\n        onError: options?.onError,\n        useMemoryFallback: true,\n    });\n\n    if (options?.validClusters) {\n        storage.addValidator(clusterId => options.validClusters!.includes(clusterId));\n    }\n\n    return storage;\n}\n\n/**\n * Create a storage instance for wallet name persistence\n *\n * @example\n * ```ts\n * const storage = createEnhancedStorageWallet({\n *   onError: (error) => console.error('Wallet storage error:', error)\n * })\n * ```\n */\nexport function createEnhancedStorageWallet(\n    options?: EnhancedStorageWalletOptions,\n): EnhancedStorage<string | undefined> {\n    const key = options?.key ?? `connector-kit:${STORAGE_VERSION}:wallet`;\n    return new EnhancedStorage(key, options?.initial, {\n        onError: options?.onError,\n        useMemoryFallback: true,\n    });\n}\n\n// ============================================================================\n// Storage Adapter Interface\n// ============================================================================\n\n/**\n * Adapter to make EnhancedStorage compatible with StorageAdapter interface\n * Exposes both the basic interface and enhanced methods for advanced usage\n */\nexport class EnhancedStorageAdapter<T> implements StorageAdapter<T> {\n    constructor(private storage: EnhancedStorage<T>) {}\n\n    get(): T {\n        return this.storage.get();\n    }\n\n    set(value: T): void {\n        this.storage.set(value);\n    }\n\n    subscribe(callback: (value: T) => void): () => void {\n        return this.storage.value.subscribe(callback);\n    }\n\n    validate(value: T): boolean {\n        return this.storage.validate(value);\n    }\n\n    reset(): void {\n        this.storage.reset();\n    }\n\n    clear(): void {\n        this.storage.clear();\n    }\n\n    isAvailable(): boolean {\n        return this.storage.isAvailable();\n    }\n\n    transform<U>(transformer: (value: T) => U): U {\n        return this.storage.transform(transformer);\n    }\n\n    addValidator(validator: (value: T) => boolean): this {\n        this.storage.addValidator(validator);\n        return this;\n    }\n\n    onError(handler: (error: Error) => void): this {\n        this.storage.onError(handler);\n        return this;\n    }\n}\n","import type { ConnectorConfig } from '../types/connector';\nimport type { SolanaCluster, SolanaClusterId } from '@wallet-ui/core';\nimport { createSolanaMainnet, createSolanaDevnet, createSolanaTestnet, createSolanaLocalnet } from '@wallet-ui/core';\nimport {\n    createEnhancedStorageAccount,\n    createEnhancedStorageCluster,\n    createEnhancedStorageWallet,\n    EnhancedStorageAdapter,\n    EnhancedStorage,\n} from '../lib/adapters/enhanced-storage';\nimport { toClusterId } from '../utils/network';\nimport type React from 'react';\nimport { isAddress } from 'gill';\nimport { DEFAULT_MAX_RETRIES } from '../lib/constants';\nimport { createLogger } from '../lib/utils/secure-logger';\n\nconst logger = createLogger('DefaultConfig');\n\nexport interface DefaultConfigOptions {\n    /** Application name shown in wallet connection prompts */\n    appName: string;\n    /** Application URL for wallet connection metadata */\n    appUrl?: string;\n    /** Enable automatic wallet reconnection on page load */\n    autoConnect?: boolean;\n    /** Enable debug logging */\n    debug?: boolean;\n    /** Solana network to connect to (accepts both 'mainnet' and 'mainnet-beta' conventions) */\n    network?: 'mainnet' | 'mainnet-beta' | 'devnet' | 'testnet' | 'localnet';\n    /** Enable Mobile Wallet Adapter support */\n    enableMobile?: boolean;\n    /** Custom storage implementation */\n    storage?: ConnectorConfig['storage'];\n    /** Custom cluster configuration - overrides network if provided */\n    clusters?: SolanaCluster[];\n    /** Additional custom clusters to add to the default list */\n    customClusters?: SolanaCluster[];\n    /** Persist cluster selection across sessions */\n    persistClusterSelection?: boolean;\n    /** Custom storage key for cluster persistence */\n    clusterStorageKey?: string;\n    /** Enable error boundaries for automatic error handling (default: true) */\n    enableErrorBoundary?: boolean;\n    /** Maximum retry attempts for error recovery (default: 3) */\n    maxRetries?: number;\n    /** Custom error handler */\n    onError?: (error: Error, errorInfo: React.ErrorInfo) => void;\n}\n\n/** Extended ConnectorConfig with app metadata */\nexport interface ExtendedConnectorConfig extends ConnectorConfig {\n    /** Application name for display and metadata */\n    appName?: string;\n    /** Application URL for metadata */\n    appUrl?: string;\n    /** Whether mobile wallet adapter is enabled */\n    enableMobile?: boolean;\n    /** Selected network for convenience (accepts both 'mainnet' and 'mainnet-beta' conventions) */\n    network?: 'mainnet' | 'mainnet-beta' | 'devnet' | 'testnet' | 'localnet';\n    /** Error boundary configuration */\n    errorBoundary?: {\n        /** Enable error boundaries (default: true) */\n        enabled?: boolean;\n        /** Maximum retry attempts (default: 3) */\n        maxRetries?: number;\n        /** Custom error handler */\n        onError?: (error: Error, errorInfo: React.ErrorInfo) => void;\n        /** Custom fallback component */\n        fallback?: (error: Error, retry: () => void) => React.ReactNode;\n    };\n}\n\n/**\n * Creates a default connector configuration with sensible defaults for Solana applications\n */\nexport function getDefaultConfig(options: DefaultConfigOptions): ExtendedConnectorConfig {\n    const {\n        appName,\n        appUrl,\n        autoConnect = true,\n        debug,\n        network = 'mainnet-beta',\n        enableMobile = true,\n        storage,\n        clusters,\n        customClusters = [],\n        persistClusterSelection = true,\n        clusterStorageKey,\n        enableErrorBoundary = true,\n        maxRetries = DEFAULT_MAX_RETRIES,\n        onError,\n    } = options;\n\n    const defaultClusters: SolanaCluster[] = clusters ?? [\n        createSolanaMainnet(),\n        createSolanaDevnet(),\n        createSolanaTestnet(),\n        ...(network === 'localnet' ? [createSolanaLocalnet()] : []),\n        ...(customClusters || []),\n    ];\n\n    const validClusterIds = defaultClusters.map(c => c.id);\n\n    const accountStorage = createEnhancedStorageAccount({\n        validator: address => {\n            if (!address) return true;\n            return isAddress(address);\n        },\n        onError: error => {\n            if (debug) {\n                logger.error('Account Storage error', { error });\n            }\n            if (onError) {\n                onError(error, {\n                    componentStack: 'account-storage',\n                });\n            }\n        },\n    });\n\n    const clusterStorage = createEnhancedStorageCluster({\n        key: clusterStorageKey,\n        initial: getInitialCluster(network),\n        validClusters: persistClusterSelection ? validClusterIds : undefined,\n        onError: error => {\n            if (debug) {\n                logger.error('Cluster Storage error', { error });\n            }\n            if (onError) {\n                onError(error, {\n                    componentStack: 'cluster-storage',\n                });\n            }\n        },\n    });\n\n    const walletStorage = createEnhancedStorageWallet({\n        onError: error => {\n            if (debug) {\n                logger.error('Wallet Storage error', { error });\n            }\n            if (onError) {\n                onError(error, {\n                    componentStack: 'wallet-storage',\n                });\n            }\n        },\n    });\n\n    // Migrate old storage keys to new versioned format (v1)\n    // This allows seamless upgrades from old versions without losing user data\n    if (typeof window !== 'undefined') {\n        // Old keys (pre-v1): 'connector-kit:account', 'connector-kit:wallet', 'connector-kit:cluster'\n        // New keys (v1):     'connector-kit:v1:account', 'connector-kit:v1:wallet', 'connector-kit:v1:cluster'\n        const oldAccountKey = 'connector-kit:account';\n        const oldWalletKey = 'connector-kit:wallet';\n        const oldClusterKey = clusterStorageKey || 'connector-kit:cluster';\n\n        EnhancedStorage.migrate(oldAccountKey, accountStorage);\n        EnhancedStorage.migrate(oldWalletKey, walletStorage);\n        EnhancedStorage.migrate(oldClusterKey, clusterStorage);\n    }\n\n    const defaultStorage: ConnectorConfig['storage'] = storage ?? {\n        account: new EnhancedStorageAdapter(accountStorage),\n        cluster: new EnhancedStorageAdapter(clusterStorage),\n        wallet: new EnhancedStorageAdapter(walletStorage),\n    };\n\n    const config: ExtendedConnectorConfig = {\n        autoConnect,\n        debug: debug ?? process.env.NODE_ENV === 'development',\n        storage: defaultStorage,\n        appName,\n        appUrl,\n        enableMobile,\n        network,\n        cluster: {\n            clusters: defaultClusters,\n            persistSelection: persistClusterSelection,\n            initialCluster: getInitialCluster(network),\n        },\n        errorBoundary: {\n            enabled: enableErrorBoundary,\n            maxRetries,\n            onError,\n        },\n    };\n\n    return config;\n}\n\n/**\n * Helper to convert network string to cluster ID\n * Uses network utility for consistent translation\n */\nfunction getInitialCluster(\n    network: 'mainnet' | 'mainnet-beta' | 'devnet' | 'testnet' | 'localnet' = 'mainnet-beta',\n): SolanaClusterId {\n    return toClusterId(network);\n}\n\n/**\n * Default Mobile Wallet Adapter configuration for Solana applications\n */\nexport function getDefaultMobileConfig(options: {\n    appName: string;\n    appUrl?: string;\n    network?: 'mainnet' | 'mainnet-beta' | 'devnet' | 'testnet';\n}) {\n    const baseUrl =\n        options.appUrl || (typeof window !== 'undefined' ? window.location.origin : 'https://localhost:3000');\n\n    return {\n        appIdentity: {\n            name: options.appName,\n            uri: baseUrl,\n            icon: `${baseUrl}/favicon.ico`,\n        },\n        cluster: options.network || 'mainnet-beta',\n    };\n}\n","/**\n * @solana/connector - Unified configuration\n *\n * Simplified configuration for apps using ConnectorKit\n * Eliminates config duplication and provides a single source of truth\n */\n\nimport type { ExtendedConnectorConfig, DefaultConfigOptions } from './default-config';\nimport type { MobileWalletAdapterConfig } from '../ui/connector-provider';\nimport { getDefaultConfig, getDefaultMobileConfig } from './default-config';\nimport { normalizeNetwork, getDefaultRpcUrl, type SolanaNetwork } from '../utils/network';\n\n/**\n * Options for creating a unified configuration\n * Maintains type safety while providing flexibility\n */\nexport interface UnifiedConfigOptions extends DefaultConfigOptions {\n    /**\n     * Custom RPC URL (optional - overrides default for network)\n     * Note: For production apps, use environment variables to avoid exposing API keys\n     * @see packages/connector/src/utils/cluster.ts for secure RPC URL patterns\n     */\n    rpcUrl?: string;\n}\n\n/**\n * Unified configuration output\n * Contains all configs needed for ConnectorKit and integrations\n *\n * Important: The `rpcUrl` property is intended for:\n * 1. Server-side rendering (SSR) setup\n * 2. Passing to external libraries that need RPC configuration\n * 3. Development/testing environments\n *\n * For production client-side code, use the connector client's `getRpcUrl()` method\n * which supports environment variable patterns and proxy configurations.\n */\nexport interface UnifiedConfig {\n    /** ConnectorKit configuration */\n    connectorConfig: ExtendedConnectorConfig;\n    /** Mobile Wallet Adapter configuration (optional) */\n    mobile?: MobileWalletAdapterConfig;\n    /** Normalized network name ('mainnet', 'devnet', 'testnet', 'localnet') */\n    network: SolanaNetwork;\n    /**\n     * RPC endpoint URL\n     * For external library integration only - client code should use connector client\n     * @deprecated in client components - use `useConnectorClient().getRpcUrl()` instead\n     */\n    rpcUrl: string;\n    /** Application metadata */\n    app: {\n        name: string;\n        url: string;\n    };\n}\n\n/**\n * Create a unified configuration for ConnectorKit\n *\n * This helper eliminates configuration duplication by creating all necessary\n * configs from a single source of truth. It automatically handles network\n * name translation between different conventions.\n *\n * @example Basic usage\n * ```tsx\n * import { createConfig, AppProvider } from '@solana/connector';\n *\n * const config = createConfig({\n *   appName: 'My App',\n *   network: 'mainnet', // Works with 'mainnet' or 'mainnet-beta'\n *   enableMobile: true\n * });\n *\n * <AppProvider config={config}>\n *   {children}\n * </AppProvider>\n * ```\n *\n * @example Integration with external libraries\n * ```tsx\n * import { createConfig, AppProvider } from '@solana/connector';\n * import { ArmaProvider } from '@armadura/sdk';\n *\n * const config = createConfig({\n *   appName: 'My App',\n *   network: 'mainnet',\n * });\n *\n * <AppProvider config={config}>\n *   <ArmaProvider\n *     config={{\n *       network: config.network,\n *       rpcUrl: config.rpcUrl, // Safe - for external library initialization\n *       providers: [...]\n *     }}\n *     useConnector=\"auto\"\n *   >\n *     {children}\n *   </ArmaProvider>\n * </AppProvider>\n * ```\n *\n * @example Production with environment variables\n * ```tsx\n * // Use environment variables to avoid exposing API keys\n * const config = createConfig({\n *   appName: 'My App',\n *   network: 'mainnet',\n *   // RPC URL comes from process.env on server\n *   // Client-side code should use connector client's getRpcUrl()\n * });\n * ```\n *\n * @example Custom clusters\n * ```tsx\n * const config = createConfig({\n *   appName: 'My App',\n *   network: 'mainnet',\n *   customClusters: [\n *     {\n *       id: 'solana:custom',\n *       label: 'Custom RPC',\n *       url: process.env.CUSTOM_RPC_URL || 'https://...'\n *     }\n *   ]\n * });\n * ```\n */\nexport function createConfig(options: UnifiedConfigOptions): UnifiedConfig {\n    // Extract network and rpcUrl, use remaining options for connector config\n    const { network = 'mainnet-beta', rpcUrl: customRpcUrl, ...connectorOptions } = options;\n\n    // Normalize network name for consistency\n    const normalizedNetwork = normalizeNetwork(typeof network === 'string' ? network : 'mainnet-beta');\n\n    // Get RPC URL (custom or default)\n    const rpcUrl = customRpcUrl || getDefaultRpcUrl(normalizedNetwork);\n\n    // Convert normalized network to RPC format (mainnet -> mainnet-beta)\n    const rpcNetwork = normalizedNetwork === 'mainnet' ? 'mainnet-beta' : normalizedNetwork;\n\n    // Create connector configuration\n    const connectorConfig = getDefaultConfig({\n        ...connectorOptions,\n        network: rpcNetwork,\n    });\n\n    // Create mobile configuration (if enabled)\n    const mobile =\n        options.enableMobile !== false && normalizedNetwork !== 'localnet'\n            ? getDefaultMobileConfig({\n                  appName: options.appName,\n                  appUrl: connectorConfig.appUrl,\n                  network: rpcNetwork as 'mainnet-beta' | 'devnet' | 'testnet',\n              })\n            : undefined;\n\n    return {\n        connectorConfig,\n        mobile,\n        network: normalizedNetwork,\n        rpcUrl,\n        app: {\n            name: options.appName,\n            url:\n                connectorConfig.appUrl ||\n                (typeof window !== 'undefined' ? window.location.origin : 'https://localhost:3000'),\n        },\n    };\n}\n\n/**\n * Type guard to check if a config is a unified config\n *\n * @example\n * ```ts\n * if (isUnifiedConfig(someConfig)) {\n *   // TypeScript knows this is UnifiedConfig\n *   console.log(someConfig.network, someConfig.rpcUrl);\n * }\n * ```\n */\nexport function isUnifiedConfig(config: unknown): config is UnifiedConfig {\n    return Boolean(\n        config &&\n            typeof config === 'object' &&\n            'connectorConfig' in config &&\n            'network' in config &&\n            'rpcUrl' in config &&\n            'app' in config,\n    );\n}\n","/**\n * Wallet-related types\n * Re-exports from @wallet-standard/base and custom wallet types\n */\n\nimport type { Wallet, WalletAccount } from '@wallet-standard/base';\n\n// Re-export standard types\nexport type { Wallet, WalletAccount };\n\n/**\n * Wallet name as a branded string for type safety\n * Represents the unique identifier for a wallet (e.g., \"Phantom\", \"Solflare\")\n */\nexport type WalletName = string & { readonly __brand: 'WalletName' };\n\n/**\n * Account address as a branded string for type safety\n * Represents a Solana address (base58-encoded public key)\n *\n * @deprecated Use `Address` from 'gill' instead for consistent address typing\n */\nexport type AccountAddress = string & { readonly __brand: 'AccountAddress' };\n\n/**\n * Type guard to check if a string is a valid wallet name\n */\nexport function isWalletName(value: string): value is WalletName {\n    return typeof value === 'string' && value.length > 0;\n}\n\n/**\n * Type guard to check if a string is a valid account address\n *\n * @deprecated Use `isAddress` from 'gill' instead for proper address validation\n */\nexport function isAccountAddress(value: string): value is AccountAddress {\n    // Basic validation: Solana addresses are typically 32-44 characters\n    return typeof value === 'string' && value.length >= 32 && value.length <= 44;\n}\n\n/**\n * Extended wallet information with capability metadata\n */\nexport interface WalletInfo {\n    /** The Wallet Standard wallet object */\n    wallet: Wallet;\n    /** Whether the wallet extension is installed */\n    installed: boolean;\n    /** Precomputed capability flag for UI convenience */\n    connectable?: boolean;\n}\n","/**\n * @solana/connector - Explorer URL Utilities\n *\n * Generate URLs for various Solana block explorers to view transactions,\n * accounts, and other on-chain data.\n */\n\nimport { getExplorerLink } from 'gill';\n\nexport type ExplorerType = 'solana-explorer' | 'solscan' | 'xray' | 'solana-fm';\n\nexport interface ExplorerOptions {\n    /** Cluster to use for the explorer link */\n    cluster?: string;\n    /** Custom RPC URL for localnet */\n    customUrl?: string;\n}\n\n/**\n * Generate Solana Explorer URL for a transaction signature\n */\nexport function getSolanaExplorerUrl(signature: string, options: ExplorerOptions = {}): string {\n    const { cluster = 'mainnet', customUrl } = options;\n    const normalizedCluster = cluster === 'mainnet-beta' ? 'mainnet' : cluster;\n\n    // Handle localnet with custom URL - gill doesn't support this specific case\n    if (normalizedCluster === 'localnet') {\n        const url = customUrl || 'http://localhost:8899';\n        return `https://explorer.solana.com/tx/${signature}?cluster=custom&customUrl=${encodeURIComponent(url)}`;\n    }\n\n    // Map to valid gill cluster types (custom clusters default to devnet)\n    const validClusters = ['mainnet', 'devnet', 'testnet'] as const;\n    const explorerCluster = validClusters.includes(normalizedCluster as 'mainnet' | 'devnet' | 'testnet')\n        ? (normalizedCluster as 'mainnet' | 'devnet' | 'testnet')\n        : 'devnet';\n\n    // Use gill's getExplorerLink for standard clusters\n    return getExplorerLink({\n        transaction: signature,\n        cluster: explorerCluster,\n    });\n}\n\n/**\n * Generate Solscan URL for a transaction signature\n */\nexport function getSolscanUrl(signature: string, options: ExplorerOptions = {}): string {\n    const { cluster = 'mainnet' } = options;\n    const normalizedCluster = cluster === 'mainnet-beta' ? 'mainnet' : cluster;\n\n    if (normalizedCluster === 'mainnet') {\n        return `https://solscan.io/tx/${signature}`;\n    }\n\n    if (normalizedCluster === 'localnet') {\n        return `https://solscan.io/tx/${signature}?cluster=custom`;\n    }\n\n    return `https://solscan.io/tx/${signature}?cluster=${normalizedCluster}`;\n}\n\n/**\n * Generate XRAY (Helius) URL for a transaction signature\n * Note: XRAY works best with mainnet transactions\n */\nexport function getXrayUrl(signature: string): string {\n    return `https://xray.helius.xyz/tx/${signature}`;\n}\n\n/**\n * Generate SolanaFM URL for a transaction signature\n */\nexport function getSolanaFmUrl(signature: string, options: ExplorerOptions = {}): string {\n    const { cluster = 'mainnet' } = options;\n    const normalizedCluster = cluster === 'mainnet-beta' ? 'mainnet' : cluster;\n\n    if (normalizedCluster === 'mainnet') {\n        return `https://solana.fm/tx/${signature}`;\n    }\n\n    return `https://solana.fm/tx/${signature}?cluster=${normalizedCluster}`;\n}\n\n/**\n * Get all explorer URLs for a transaction\n */\nexport function getAllExplorerUrls(signature: string, options: ExplorerOptions = {}): Record<ExplorerType, string> {\n    return {\n        'solana-explorer': getSolanaExplorerUrl(signature, options),\n        solscan: getSolscanUrl(signature, options),\n        xray: getXrayUrl(signature),\n        'solana-fm': getSolanaFmUrl(signature, options),\n    };\n}\n\n/**\n * Format a transaction signature for display (truncated)\n */\nexport function formatSignature(signature: string, chars = 8): string {\n    if (signature.length <= chars * 2) return signature;\n    return `${signature.slice(0, chars)}...${signature.slice(-chars)}`;\n}\n\n/**\n * Copy signature to clipboard with enhanced error handling\n *\n * @deprecated Use copySignatureToClipboard from utils/clipboard instead\n * This is maintained for backwards compatibility but will be removed in a future version\n */\nexport async function copySignature(signature: string): Promise<boolean> {\n    try {\n        await navigator.clipboard.writeText(signature);\n        return true;\n    } catch {\n        return false;\n    }\n}\n"]}