@solana/connector 0.1.0 → 0.1.1

package/dist/{chunk-52WUWW5R.mjs → chunk-TAAXHAV2.mjs}

@@ -51,23 +51,11 @@ function getWalletsRegistry() {
 var ConnectorError = class extends Error {
   constructor(message, context, originalError) {
     super(message);
-    /**
-     * Additional context about the error
-     */
     __publicField(this, "context");
-    /**
-     * The underlying error that caused this error
-     */
     __publicField(this, "originalError");
-    /**
-     * Timestamp when error occurred
-     */
     __publicField(this, "timestamp");
     this.name = this.constructor.name, this.context = context, this.originalError = originalError, this.timestamp = (/* @__PURE__ */ new Date()).toISOString(), Error.captureStackTrace && Error.captureStackTrace(this, this.constructor);
   }
-  /**
-   * Get a JSON representation of the error
-   */
   toJSON() {
     return {
       name: this.name,
@@ -134,21 +122,13 @@ function isTransactionError(error) {
   return error instanceof TransactionError;
 }
 var Errors = {
-  // Connection errors
   walletNotConnected: (context) => new ConnectionError("WALLET_NOT_CONNECTED", "No wallet connected", context),
-  walletNotFound: (walletName) => new ConnectionError("WALLET_NOT_FOUND", `Wallet not found${walletName ? `: ${walletName}` : ""}`, {
-    walletName
-  }),
+  walletNotFound: (walletName) => new ConnectionError("WALLET_NOT_FOUND", `Wallet not found${walletName ? `: ${walletName}` : ""}`, { walletName }),
   connectionFailed: (originalError) => new ConnectionError("CONNECTION_FAILED", "Failed to connect to wallet", void 0, originalError),
   accountNotAvailable: (address) => new ConnectionError("ACCOUNT_NOT_AVAILABLE", "Requested account not available", { address }),
-  // Validation errors
   invalidTransaction: (reason, context) => new ValidationError("INVALID_TRANSACTION", `Invalid transaction: ${reason}`, context),
-  invalidFormat: (expectedFormat, actualFormat) => new ValidationError("INVALID_FORMAT", `Invalid format: expected ${expectedFormat}`, {
-    expectedFormat,
-    actualFormat
-  }),
+  invalidFormat: (expectedFormat, actualFormat) => new ValidationError("INVALID_FORMAT", `Invalid format: expected ${expectedFormat}`, { expectedFormat, actualFormat }),
   unsupportedFormat: (format) => new ValidationError("UNSUPPORTED_FORMAT", `Unsupported format: ${format}`, { format }),
-  // Configuration errors
   missingProvider: (hookName) => new ConfigurationError(
     "MISSING_PROVIDER",
     `${hookName} must be used within ConnectorProvider. Wrap your app with <ConnectorProvider> or <UnifiedProvider>.`,
@@ -159,10 +139,8 @@ var Errors = {
     `Cluster ${clusterId} not found. Available clusters: ${availableClusters.join(", ")}`,
     { clusterId, availableClusters }
   ),
-  // Network errors
   rpcError: (message, originalError) => new NetworkError("RPC_ERROR", message, void 0, originalError),
   networkTimeout: () => new NetworkError("NETWORK_TIMEOUT", "Network request timed out"),
-  // Transaction errors
   signingFailed: (originalError) => new TransactionError("SIGNING_FAILED", "Failed to sign transaction", void 0, originalError),
   featureNotSupported: (feature) => new TransactionError("FEATURE_NOT_SUPPORTED", `Wallet does not support ${feature}`, { feature }),
   userRejected: (operation) => new TransactionError("USER_REJECTED", `User rejected ${operation}`, { operation })
@@ -240,27 +218,28 @@ function getNetworkDisplayName(network) {
   return normalized.charAt(0).toUpperCase() + normalized.slice(1);
 }
 function getClusterRpcUrl(cluster) {
-  if (!cluster)
-    throw new Error("Invalid cluster configuration: unable to determine RPC URL for cluster unknown");
-  let url;
-  if (typeof cluster == "string" ? url = cluster : typeof cluster == "object" && cluster !== null ? "url" in cluster && typeof cluster.url == "string" ? url = cluster.url : "rpcUrl" in cluster && typeof cluster.rpcUrl == "string" ? url = cluster.rpcUrl : url = "" : url = "", url?.startsWith("http://") || url?.startsWith("https://"))
+  if (typeof cluster == "string") {
+    let presets2 = {
+      ...PUBLIC_RPC_ENDPOINTS,
+      "mainnet-beta": PUBLIC_RPC_ENDPOINTS.mainnet
+    };
+    if (presets2[cluster])
+      return presets2[cluster];
+    throw new Error(`Unknown cluster: ${cluster}`);
+  }
+  let url = cluster.url || cluster.rpcUrl;
+  if (!url)
+    throw new Error("Cluster URL is required");
+  if (url.startsWith("http://") || url.startsWith("https://"))
     return url;
   let presets = {
     ...PUBLIC_RPC_ENDPOINTS,
     "mainnet-beta": PUBLIC_RPC_ENDPOINTS.mainnet
   };
-  if (url && presets[url])
-    return presets[url];
-  if (!url || url === "[object Object]")
-    throw new Error(
-      `Invalid cluster configuration: unable to determine RPC URL for cluster ${cluster?.id ?? "unknown"}`
-    );
-  return url;
+  return presets[url] ? presets[url] : url;
 }
 function getClusterExplorerUrl(cluster, path) {
-  if (!cluster || !cluster.id)
-    return path ? `https://explorer.solana.com/${path}?cluster=devnet` : "https://explorer.solana.com?cluster=devnet";
-  let parts = cluster.id.split(":"), clusterSegment = parts.length >= 2 && parts[1] ? parts[1] : "devnet", isMainnet2 = cluster.id === "solana:mainnet" || cluster.id === "solana:mainnet-beta" || clusterSegment === "mainnet" || clusterSegment === "mainnet-beta", base = isMainnet2 ? "https://explorer.solana.com" : `https://explorer.solana.com?cluster=${clusterSegment}`;
+  let clusterSegment = cluster.id.split(":")[1] || "devnet", isMainnet2 = cluster.id === "solana:mainnet" || cluster.id === "solana:mainnet-beta", base = isMainnet2 ? "https://explorer.solana.com" : `https://explorer.solana.com?cluster=${clusterSegment}`;
   return path ? isMainnet2 ? `https://explorer.solana.com/${path}` : `https://explorer.solana.com/${path}?cluster=${clusterSegment}` : base;
 }
 function getTransactionUrl(signature, cluster) {
@@ -293,19 +272,40 @@ function isTestnetCluster(cluster) {
   return cluster.id === "solana:testnet";
 }
 function isLocalCluster(cluster) {
-  let url = "";
-  return "url" in cluster && typeof cluster.url == "string" ? url = cluster.url : "rpcUrl" in cluster && typeof cluster.rpcUrl == "string" && (url = cluster.rpcUrl), cluster.id === "solana:localnet" || url.includes("localhost") || url.includes("127.0.0.1");
+  let url = cluster.url || cluster.rpcUrl;
+  return url ? cluster.id === "solana:localnet" || url.includes("localhost") || url.includes("127.0.0.1") : cluster.id === "solana:localnet";
 }
 function getClusterName(cluster) {
   if (cluster.label) return cluster.label;
-  if ("name" in cluster && typeof cluster.name == "string")
-    return cluster.name;
+  if (cluster.name) return cluster.name;
   let parts = cluster.id.split(":");
-  return parts.length >= 2 && parts[1] ? parts.slice(1).join(":") : "Unknown";
+  if (parts.length >= 2 && parts[1]) {
+    let name = parts.slice(1).join(":");
+    return name.charAt(0).toUpperCase() + name.slice(1).replace(/-/g, " ");
+  }
+  return "Unknown";
 }
 function getClusterType(cluster) {
   return isMainnetCluster(cluster) ? "mainnet" : isDevnetCluster(cluster) ? "devnet" : isTestnetCluster(cluster) ? "testnet" : isLocalCluster(cluster) ? "localnet" : "custom";
 }
+function getClusterChainId(cluster) {
+  let clusterType = getClusterType(cluster);
+  if (clusterType === "localnet" || clusterType === "custom")
+    return null;
+  switch (clusterType) {
+    case "mainnet":
+      return "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+    case "devnet":
+      return "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1";
+    case "testnet":
+      return "solana:4uhcVJyU9pJkvQyS88uRDiswHXSCkY3z";
+    default:
+      return null;
+  }
+}
+function getChainIdForWalletStandard(cluster) {
+  return getClusterChainId(cluster);
+}
 
 // src/lib/constants.ts
 var POLL_INTERVALS_MS = [1e3, 2e3, 3e3, 5e3, 5e3], DEFAULT_MAX_RETRIES = 3, DEFAULT_MAX_TRACKED_TRANSACTIONS = 20;
@@ -842,7 +842,8 @@ var WalletDetector = class extends BaseCollaborator {
     for (let unsubscribe of this.unsubscribers)
       try {
         unsubscribe();
-      } catch {
+      } catch (error) {
+        logger3.warn("Error during unsubscribe cleanup", { error });
       }
     this.unsubscribers = [];
   }
@@ -898,11 +899,14 @@ var ConnectionManager = class extends BaseCollaborator {
         selectedWallet: wallet.name,
         selectedAccount: selected,
         accountsCount: accounts.length
-      }), this.eventEmitter.emit({
+      }), selected ? this.eventEmitter.emit({
         type: "wallet:connected",
         wallet: name,
-        account: selected || "",
+        account: selected,
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      }) : this.log("\u26A0\uFE0F Connection succeeded but no account available", {
+        wallet: wallet.name,
+        accountsCount: accounts.length
       }), this.walletStorage && (!("isAvailable" in this.walletStorage) || typeof this.walletStorage.isAvailable != "function" || this.walletStorage.isAvailable() ? this.walletStorage.set(name) : this.log("Storage not available (private browsing?), skipping wallet persistence")), this.subscribeToWalletEvents();
     } catch (e) {
       let errorMessage = e instanceof Error ? e.message : String(e);
@@ -932,22 +936,11 @@ var ConnectionManager = class extends BaseCollaborator {
    * Disconnect from wallet
    */
   async disconnect() {
-    if (this.walletChangeUnsub) {
-      try {
-        this.walletChangeUnsub();
-      } catch {
-      }
-      this.walletChangeUnsub = null;
-    }
-    this.stopPollingWalletAccounts();
+    this.walletChangeUnsub && (this.walletChangeUnsub(), this.walletChangeUnsub = null), this.stopPollingWalletAccounts();
     let wallet = this.getState().selectedWallet;
     if (wallet) {
       let disconnect = getDisconnectFeature(wallet);
-      if (disconnect)
-        try {
-          await disconnect();
-        } catch {
-        }
+      disconnect && await disconnect();
     }
     this.stateManager.updateState(
       {
@@ -1002,14 +995,7 @@ var ConnectionManager = class extends BaseCollaborator {
    * Subscribe to wallet change events
    */
   subscribeToWalletEvents() {
-    if (this.walletChangeUnsub) {
-      try {
-        this.walletChangeUnsub();
-      } catch {
-      }
-      this.walletChangeUnsub = null;
-    }
-    this.stopPollingWalletAccounts();
+    this.walletChangeUnsub && (this.walletChangeUnsub(), this.walletChangeUnsub = null), this.stopPollingWalletAccounts();
     let wallet = this.getState().selectedWallet;
     if (!wallet) return;
     let eventsOn = getEventsFeature(wallet);
@@ -1083,16 +1069,9 @@ var logger4 = createLogger("AutoConnector"), MIN_ADDRESS_LENGTH = 30, AutoConnec
     __publicField(this, "debug");
     this.walletDetector = walletDetector, this.connectionManager = connectionManager, this.stateManager = stateManager, this.walletStorage = walletStorage, this.debug = debug;
   }
-  /**
-   * Attempt auto-connection using both instant and fallback strategies
-   */
   async attemptAutoConnect() {
     return await this.attemptInstantConnect() ? true : (await this.attemptStandardConnect(), this.stateManager.getSnapshot().connected);
   }
-  /**
-   * Attempt instant auto-connection using direct wallet detection
-   * Bypasses wallet standard initialization for maximum speed
-   */
   async attemptInstantConnect() {
     let storedWalletName = this.walletStorage?.get();
     if (!storedWalletName) return false;
@@ -1203,9 +1182,6 @@ var logger4 = createLogger("AutoConnector"), MIN_ADDRESS_LENGTH = 30, AutoConnec
       }), false;
     }
   }
-  /**
-   * Attempt auto-connection via standard wallet detection (fallback)
-   */
   async attemptStandardConnect() {
     try {
       if (this.stateManager.getSnapshot().connected) {
@@ -1286,10 +1262,10 @@ var TransactionTracker = class extends BaseCollaborator {
    * Track a transaction for debugging and monitoring
    */
   trackTransaction(activity) {
-    let state = this.getState(), fullActivity = {
+    let clusterId = this.getState().cluster?.id || "solana:devnet", fullActivity = {
       ...activity,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      cluster: state.cluster?.id || "solana:devnet"
+      cluster: clusterId
     };
     this.transactions.unshift(fullActivity), this.transactions.length > this.maxTransactions && this.transactions.pop(), this.totalTransactions++, this.eventEmitter.emit({
       type: "transaction:tracked",
@@ -1441,9 +1417,6 @@ var logger5 = createLogger("ConnectorClient"), ConnectorClient = class {
       () => this.initialized
     ), this.initialize();
   }
-  /**
-   * Initialize the connector
-   */
   initialize() {
     if (!(typeof window > "u") && !this.initialized)
       try {
@@ -1456,51 +1429,26 @@ var logger5 = createLogger("ConnectorClient"), ConnectorClient = class {
         this.config.debug && logger5.error("Connector initialization failed", { error: e });
       }
   }
-  // ============================================================================
-  // Public API - Delegates to collaborators
-  // ============================================================================
-  /**
-   * Connect to a wallet by name
-   */
   async select(walletName) {
     let wallet = this.stateManager.getSnapshot().wallets.find((w) => w.wallet.name === walletName)?.wallet;
     if (!wallet) throw new Error(`Wallet ${walletName} not found`);
     await this.connectionManager.connect(wallet, walletName);
   }
-  /**
-   * Disconnect from the current wallet
-   */
   async disconnect() {
     await this.connectionManager.disconnect();
   }
-  /**
-   * Select a different account
-   */
   async selectAccount(address) {
     await this.connectionManager.selectAccount(address);
   }
-  /**
-   * Set the active cluster (network)
-   */
   async setCluster(clusterId) {
     await this.clusterManager.setCluster(clusterId);
   }
-  /**
-   * Get the currently active cluster
-   */
   getCluster() {
     return this.clusterManager.getCluster();
   }
-  /**
-   * Get all available clusters
-   */
   getClusters() {
     return this.clusterManager.getClusters();
   }
-  /**
-   * Get the RPC URL for the current cluster
-   * @returns RPC URL or null if no cluster is selected
-   */
   getRpcUrl() {
     let cluster = this.clusterManager.getCluster();
     if (!cluster) return null;
@@ -1510,36 +1458,12 @@ var logger5 = createLogger("ConnectorClient"), ConnectorClient = class {
       return this.config.debug && logger5.error("Failed to get RPC URL", { error }), null;
     }
   }
-  /**
-   * Subscribe to state changes
-   */
   subscribe(listener) {
     return this.stateManager.subscribe(listener);
   }
-  /**
-   * Get current state snapshot
-   */
   getSnapshot() {
     return this.stateManager.getSnapshot();
   }
-  /**
-   * Reset all storage to initial values
-   * Useful for "logout", "forget this device", or clearing user data
-   *
-   * This will:
-   * - Clear saved wallet name
-   * - Clear saved account address
-   * - Reset cluster to initial value (does not clear)
-   *
-   * Note: This does NOT disconnect the wallet. Call disconnect() separately if needed.
-   *
-   * @example
-   * ```ts
-   * // Complete logout flow
-   * await client.disconnect();
-   * client.resetStorage();
-   * ```
-   */
   resetStorage() {
     this.config.debug && logger5.info("Resetting all storage to initial values");
     let storageKeys = ["account", "wallet", "cluster"];
@@ -1557,66 +1481,34 @@ var logger5 = createLogger("ConnectorClient"), ConnectorClient = class {
       timestamp: (/* @__PURE__ */ new Date()).toISOString()
     });
   }
-  /**
-   * Subscribe to connector events
-   */
   on(listener) {
     return this.eventEmitter.on(listener);
   }
-  /**
-   * Remove a specific event listener
-   */
   off(listener) {
     this.eventEmitter.off(listener);
   }
-  /**
-   * Remove all event listeners
-   */
   offAll() {
     this.eventEmitter.offAll();
   }
-  /**
-   * Emit a connector event
-   * Internal method used by transaction signer and other components
-   * @internal
-   */
   emitEvent(event) {
     this.eventEmitter.emit(event);
   }
-  /**
-   * Track a transaction for debugging and monitoring
-   */
   trackTransaction(activity) {
     this.transactionTracker.trackTransaction(activity);
   }
-  /**
-   * Update transaction status
-   */
   updateTransactionStatus(signature, status, error) {
     this.transactionTracker.updateStatus(signature, status, error);
   }
-  /**
-   * Clear transaction history
-   */
   clearTransactionHistory() {
     this.transactionTracker.clearHistory();
   }
-  /**
-   * Get connector health and diagnostics
-   */
   getHealth() {
     return this.healthMonitor.getHealth();
   }
-  /**
-   * Get performance and debug metrics
-   */
   getDebugMetrics() {
     this.stateManager.getSnapshot();
     return this.debugMetrics.updateListenerCounts(this.eventEmitter.getListenerCount(), 0), this.debugMetrics.getMetrics();
   }
-  /**
-   * Get debug state including transactions
-   */
   getDebugState() {
     return {
       ...this.getDebugMetrics(),
@@ -1624,15 +1516,9 @@ var logger5 = createLogger("ConnectorClient"), ConnectorClient = class {
       totalTransactions: this.transactionTracker.getTotalCount()
     };
   }
-  /**
-   * Reset debug metrics
-   */
   resetDebugMetrics() {
     this.debugMetrics.resetMetrics();
   }
-  /**
-   * Cleanup resources
-   */
   destroy() {
     this.connectionManager.disconnect().catch(() => {
     }), this.walletDetector.destroy(), this.eventEmitter.offAll(), this.stateManager.clear();
@@ -2528,6 +2414,6 @@ function createGillTransactionSigner(connectorSigner) {
   };
 }
 
-export { ClipboardErrorType, ConfigurationError, ConnectionError, ConnectorClient, ConnectorError, ConnectorErrorBoundary, DEFAULT_MAX_RETRIES, Errors, NetworkError, PUBLIC_RPC_ENDPOINTS, TransactionError, TransactionSignerError, ValidationError, WalletErrorType, copyAddressToClipboard, copySignatureToClipboard, copyToClipboard, createGillTransactionSigner, createTransactionSigner, formatAddress, formatNumber, formatSOL, formatTokenAmount, getAddressUrl, getBlockUrl, getClusterExplorerUrl, getClusterName, getClusterRpcUrl, getClusterType, getDefaultRpcUrl, getNetworkDisplayName, getPolyfillStatus, getTokenUrl, getTransactionUrl, getUserFriendlyMessage, getWalletsRegistry, installPolyfills, isClipboardAvailable, isConfigurationError, isConnectionError, isConnectorError, isCryptoAvailable, isDevnet, isDevnetCluster, isLocalCluster, isLocalnet, isMainnet, isMainnetCluster, isNetworkError, isPolyfillInstalled, isTestnet, isTestnetCluster, isTransactionError, isTransactionSignerError, isValidationError, normalizeNetwork, toClusterId, toConnectorError, truncate, withErrorBoundary };
-//# sourceMappingURL=chunk-52WUWW5R.mjs.map
-//# sourceMappingURL=chunk-52WUWW5R.mjs.map
+export { ClipboardErrorType, ConfigurationError, ConnectionError, ConnectorClient, ConnectorError, ConnectorErrorBoundary, DEFAULT_MAX_RETRIES, Errors, NetworkError, PUBLIC_RPC_ENDPOINTS, TransactionError, TransactionSignerError, ValidationError, WalletErrorType, copyAddressToClipboard, copySignatureToClipboard, copyToClipboard, createGillTransactionSigner, createTransactionSigner, formatAddress, formatNumber, formatSOL, formatTokenAmount, getAddressUrl, getBlockUrl, getChainIdForWalletStandard, getClusterChainId, getClusterExplorerUrl, getClusterName, getClusterRpcUrl, getClusterType, getDefaultRpcUrl, getNetworkDisplayName, getPolyfillStatus, getTokenUrl, getTransactionUrl, getUserFriendlyMessage, getWalletsRegistry, installPolyfills, isClipboardAvailable, isConfigurationError, isConnectionError, isConnectorError, isCryptoAvailable, isDevnet, isDevnetCluster, isLocalCluster, isLocalnet, isMainnet, isMainnetCluster, isNetworkError, isPolyfillInstalled, isTestnet, isTestnetCluster, isTransactionError, isTransactionSignerError, isValidationError, normalizeNetwork, toClusterId, toConnectorError, truncate, withErrorBoundary };
+//# sourceMappingURL=chunk-TAAXHAV2.mjs.map
+//# sourceMappingURL=chunk-TAAXHAV2.mjs.map