npm - @tuwaio/orbit-core - Versions diffs - 1.0.0-fix-packages-alpha.1.bb47310 → 1.0.0-fix-packages-alpha.3.dc7f910 - Mend

@tuwaio/orbit-core 1.0.0-fix-packages-alpha.1.bb47310 → 1.0.0-fix-packages-alpha.3.dc7f910

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/README.md CHANGED Viewed

@@ -18,17 +18,17 @@ Its primary goal is to establish a **unified interface** for interacting with di
 ## ✨ Key Features
--   **Multi-Chain Foundation:** Defines the core `OrbitAdapter` enum (supporting EVM, Solana, Starknet) and types for building consistent multi-chain support.
--   **Framework Agnostic & Headless:** Contains only logic, no UI components, ensuring compatibility with any frontend setup.
--   **Type-Safe Development:** Fully written in TypeScript 5.9+ for a robust developer experience.
--   **Flexible Adapter System:** Provides utilities like `selectAdapterByKey` to easily manage and switch between different blockchain adapter implementations.
--   **Essential Utilities:** Includes common helpers for tasks such as:
-    * Formatting wallet names and chain IDs (`formatWalletName`, `formatWalletChainId`).
-    * Identifying chain types (`isSolanaChain`, `getAdapterFromWalletType`).
-    * Managing wallet connection state in localStorage (`lastConnectedWalletHelpers`, `recentConnectedWalletHelpers`).
-    * Handling impersonation for development/testing (`impersonatedHelpers`).
-    * Basic async operations (`delay`, `waitFor`).
--   **SSR Safe:** Utilities are designed to work safely in both browser and Server-Side Rendering environments.
+- **Multi-Chain Foundation:** Defines the core `OrbitAdapter` enum (supporting EVM, Solana, Starknet) and types for building consistent multi-chain support.
+- **Framework Agnostic & Headless:** Contains only logic, no UI components, ensuring compatibility with any frontend setup.
+- **Type-Safe Development:** Fully written in TypeScript 5.9+ for a robust developer experience.
+- **Flexible Adapter System:** Provides utilities like `selectAdapterByKey` to easily manage and switch between different blockchain adapter implementations.
+- **Essential Utilities:** Includes common helpers for tasks such as:
+  - Formatting connector names and chain IDs (`formatConnectorName`, `formatConnectorChainId`).
+  - Identifying chain types (`isSolanaChain`, `getAdapterFromConnectorType`).
+  - Managing connector connection state in localStorage (`lastConnectedConnectorHelpers`, `recentConnectedConnectorHelpers`).
+  - Handling impersonation for development/testing (`impersonatedHelpers`).
+  - Basic async operations (`delay`, `waitFor`).
+- **SSR Safe:** Utilities are designed to work safely in both browser and Server-Side Rendering environments.
 ---
@@ -117,33 +117,33 @@ if (selectedSolanaAdapter && selectedSolanaAdapter.key === OrbitAdapter.SOLANA)
 ```typescript
 import {
   OrbitAdapter,
-  formatWalletName,
-  getAdapterFromWalletType,
-  getWalletTypeFromConnectorName,
+  formatConnectorName,
+  getAdapterFromConnectorType,
+  getConnectorTypeFromName,
   isSolanaChain,
-  lastConnectedWalletHelpers
+  lastConnectedConnectorHelpers
 } from '@tuwaio/orbit-core';
 // Formatting
-const formattedName = formatWalletName('MetaMask'); // "metamask"
+const formattedName = formatConnectorName('MetaMask'); // "metamask"
 console.log(formattedName);
-const walletType = getWalletTypeFromConnectorName(OrbitAdapter.EVM, 'Brave Wallet'); // "evm:bravewallet"
-console.log(walletType);
+const connectorType = getConnectorTypeFromName(OrbitAdapter.EVM, 'Brave Wallet'); // "evm:bravewallet"
+console.log(connectorType);
 // Identification
-const adapterType = getAdapterFromWalletType(walletType); // OrbitAdapter.EVM
+const adapterType = getAdapterFromConnectorType(connectorType); // OrbitAdapter.EVM
 console.log(adapterType);
 console.log(isSolanaChain('devnet')); // true
 console.log(isSolanaChain(1)); // false
-// Local Storage Management for Last Connected Wallet
-lastConnectedWalletHelpers.setLastConnectedWallet({
-  walletType: 'evm:metamask',
+// Local Storage Management for Last Connected Connector
+lastConnectedConnectorHelpers.setLastConnectedConnector({
+  connectorType: 'evm:metamask',
   chainId: 1,
   address: '0x123...'
 });
-const lastWallet = lastConnectedWalletHelpers.getLastConnectedWallet();
-console.log(lastWallet); // { walletType: 'evm:metamask', chainId: 1, address: '0x123...' }
+const lastWallet = lastConnectedConnectorHelpers.getLastConnectedConnector();
+console.log(lastWallet); // { connectorType: 'evm:metamask', chainId: 1, address: '0x123...' }
 // lastConnectedWalletHelpers.removeLastConnectedWallet();
 ```
@@ -154,17 +154,17 @@ console.log(lastWallet); // { walletType: 'evm:metamask', chainId: 1, address: '
 Orbit Core is designed around modularity and abstraction:
-1.  **Core Types (`types.ts`):** Defines fundamental structures like `OrbitAdapter` (enum for EVM, Solana, Starknet), `BaseAdapter` (common interface), and `WalletType`.
-2.  **Adapter System:** Enables handling multiple blockchain types via a common interface. The `selectAdapterByKey` utility allows runtime selection of the correct adapter implementation based on the `OrbitAdapter` key. Chain-specific logic resides in separate packages (e.g., `@tuwaio/orbit-evm`).
-3.  **Utilities (`utils/`):** A collection of framework-agnostic helper functions covering formatting, chain identification, localStorage management (for connection state persistence), async operations, and other common tasks needed when building multi-chain UIs.
+1. **Core Types (`types.ts`):** Defines fundamental structures like `OrbitAdapter` (enum for EVM, Solana, Starknet), `BaseAdapter` (common interface), and `ConnectorType`.
+2. **Adapter System:** Enables handling multiple blockchain types via a common interface. The `selectAdapterByKey` utility allows runtime selection of the correct adapter implementation based on the `OrbitAdapter` key. Chain-specific logic resides in separate packages (e.g., `@tuwaio/orbit-evm`).
+3. **Utilities (`utils/`):** A collection of framework-agnostic helper functions covering formatting, chain identification, localStorage management (for connection state persistence), async operations, and other common tasks needed when building multi-chain UIs.
 ### Key Exports (`index.ts`)
-- **Types:** `OrbitAdapter`, `BaseAdapter`, `WalletType`, `OrbitGenericAdapter`, `RecentConnectedWallet`.
-- **Adapter Utilities:** `selectAdapterByKey`, `getAdapterFromWalletType`.
-- **Formatting Utilities:** `formatWalletChainId`, `formatWalletName`, `getWalletTypeFromConnectorName`.
+- **Types:** `OrbitAdapter`, `BaseAdapter`, `ConnectorType`, `OrbitGenericAdapter`, `RecentConnectedConnector`.
+- **Adapter Utilities:** `selectAdapterByKey`, `getAdapterFromConnectorType`.
+- **Formatting Utilities:** `formatConnectorChainId`, `formatConnectorName`, `getConnectorTypeFromName`.
 - **Chain Helpers:** `isSolanaChain`, `setChainId`.
-- **Storage Helpers:** `lastConnectedWalletHelpers`, `recentConnectedWalletHelpers`, `impersonatedHelpers`, `getParsedStorageItem`.
+- **Storage Helpers:** `lastConnectedConnectorHelpers`, `recentConnectedConnectorHelpers`, `impersonatedHelpers`, `getParsedStorageItem`.
 - **General Utilities:** `delay`, `filterUniqueByKey`, `waitFor`, `isSafeApp`.
 -----

package/dist/index.d.mts CHANGED Viewed

@@ -102,10 +102,10 @@ type BaseAdapter = {
     getAvatar?: (name: string) => Promise<string | null>;
 };
 /**
- * Type representing a wallet identifier in format "OrbitAdapter:wallet"
+ * Type representing a connector identifier in format "OrbitAdapter:connector"
  * @example "evm:metamask" | "solana:phantom"
  */
-type WalletType = `${OrbitAdapter}:${string}`;
+type ConnectorType = `${OrbitAdapter}:${string}`;
 /**
  * @name delay
@@ -152,69 +152,70 @@ declare const delay: <T>(value: T, ms: number) => Promise<T>;
  */
 declare function filterUniqueByKey<T>(array: T[], key: keyof T): T[];
-declare function formatWalletChainId(chainId: string | number, connectedAdapter: OrbitAdapter): string | number;
+declare function formatConnectorChainId(chainId: string | number, connectedAdapter: OrbitAdapter): string | number;
-declare const formatWalletName: (walletName: string) => string;
+declare const formatConnectorName: (connectorName: string) => string;
 /**
- * Extracts the adapter type from a wallet type string
+ * Extracts the adapter type from a connector type string
  *
  * @example
  * ```typescript
  * // Returns OrbitAdapter.EVM
- * getAdapterFromWalletType('evm:metamask');
+ * getAdapterFromConnectorType('evm:metamask');
  *
  * // Returns OrbitAdapter.SOLANA
- * getAdapterFromWalletType('solana:phantom');
+ * getAdapterFromConnectorType('solana:phantom');
  *
  * // Returns OrbitAdapter.EVM (default)
- * getAdapterFromWalletType('unknown');
+ * getAdapterFromConnectorType('unknown');
  * ```
  *
- * @param walletType - Wallet type in format "chain:wallet" (e.g. "evm:metamask", "solana:phantom")
+ * @param connectorType - Connector type in format "orbit-adapter:connector" (e.g. "evm:metamask", "solana:phantom")
  * @returns The corresponding {@link OrbitAdapter} type or EVM as default
  *
  * @remarks
- * The function splits the wallet type string by ":" and takes the first part as the adapter type.
+ * The function splits the connector type string by ":" and takes the first part as the adapter type.
  * If the split fails or the first part is empty, it defaults to EVM adapter.
  */
-declare function getAdapterFromWalletType(walletType: WalletType): OrbitAdapter;
+declare function getAdapterFromConnectorType(connectorType: ConnectorType): OrbitAdapter;
 /**
- * Internal function for safely retrieving and parsing data from localStorage.
- *
- * @param key - The key for localStorage
- * @returns The parsed LastConnectedWallet object or undefined if data is not found/invalid
- */
-declare function getParsedStorageItem<ReturnType>(key: string): ReturnType | undefined;
-/**
- * Generates a standardized wallet type identifier from adapter type and connector name
+ * Generates a standardized connector type identifier from adapter type and connector name
  *
  * @example
  * ```typescript
  * // Returns "evm:metamask"
- * getWalletTypeFromConnectorName(OrbitAdapter.EVM, "MetaMask");
+ * getConnectorTypeFromName(OrbitAdapter.EVM, "MetaMask");
  *
  * // Returns "solana:phantom"
- * getWalletTypeFromConnectorName(OrbitAdapter.SOLANA, "Phantom");
+ * getConnectorTypeFromName(OrbitAdapter.SOLANA, "Phantom");
  *
  * // Returns "evm:coinbasewallet" (removes spaces)
- * getWalletTypeFromConnectorName(OrbitAdapter.EVM, "Coinbase Wallet");
+ * getConnectorTypeFromName(OrbitAdapter.EVM, "Coinbase Wallet");
  * ```
  *
  * @param adapter - The blockchain adapter type (e.g. EVM, SOLANA)
- * @param name - The wallet connector name (e.g. "MetaMask", "Phantom")
- * @returns A formatted wallet type string in format "chain:wallet"
+ * @param name - The connector name (e.g. "MetaMask", "Phantom")
+ * @returns A formatted connector type string in format "orbit-adapter:connector"
  *
  * @remarks
  * The function:
  * 1. Combines adapter type with connector name using ":" as separator
  * 2. Removes all whitespace from connector name
  * 3. Converts connector name to lowercase
- * This ensures consistent wallet type identifiers across the application
+ * This ensures consistent connector type identifiers across the application
+ * and normalizes connector names for better UX/consistency.
  */
-declare function getWalletTypeFromConnectorName(adapter: OrbitAdapter, name: string): string;
+declare function getConnectorTypeFromName(adapter: OrbitAdapter, name: string): string;
+/**
+ * Internal function for safely retrieving and parsing data from localStorage.
+ *
+ * @param key - The key for localStorage
+ * @returns The parsed LastConnectedConnector object or undefined if data is not found/invalid
+ */
+declare function getParsedStorageItem<ReturnType>(key: string): ReturnType | undefined;
 /**
  * Helper utilities for managing impersonated wallet addresses
@@ -263,8 +264,8 @@ declare const impersonatedHelpers: {
 declare const isSafeApp: boolean;
-type LastConnectedWallet = {
-    walletType: WalletType;
+type LastConnectedConnector = {
+    connectorType: ConnectorType;
     chainId: number | string;
     address?: string;
 };
@@ -272,71 +273,71 @@ type LastConnectedWallet = {
  * Helper utilities for managing the last connected wallet state
  *
  * @remarks
- * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.
+ * All data is stored in localStorage with the 'orbit-core:lastConnectedConnector' key.
  * Functions are safe to use in both browser and SSR environments.
  */
-declare const lastConnectedWalletHelpers: {
+declare const lastConnectedConnectorHelpers: {
     STORAGE_KEY: string;
     /**
      * The value of the last connected wallet, initialized when the module loads.
      * Returns undefined if not set, invalid, or in an SSR context.
      */
-    lastConnectedWallet: LastConnectedWallet | undefined;
+    lastConnectedConnector: LastConnectedConnector | undefined;
     /**
      * Stores the last connected wallet data in localStorage.
      *
      * @param data - Object containing the wallet type and chain ID.
      * @returns undefined in SSR context, void in browser
      */
-    setLastConnectedWallet: ({ walletType, chainId, address }: LastConnectedWallet) => void;
+    setLastConnectedConnector: ({ connectorType, chainId, address }: LastConnectedConnector) => void;
     /**
      * Retrieves the current last connected wallet data from localStorage.
      *
-     * @returns The LastConnectedWallet object or undefined if not set or in SSR context
+     * @returns The LastConnectedConnector object or undefined if not set or in SSR context
      */
-    getLastConnectedWallet: () => LastConnectedWallet | undefined;
+    getLastConnectedConnector: () => LastConnectedConnector | undefined;
     /**
      * Removes the last connected wallet data from localStorage.
      *
      * @returns undefined in SSR context, void in browser
      */
-    removeLastConnectedWallet: () => void;
+    removeLastConnectedConnector: () => void;
 };
-type RecentConnectedWallet = Record<OrbitAdapter, Record<string, boolean>>;
+type RecentConnectedConnector = Record<OrbitAdapter, Record<string, boolean>>;
 /**
- * Helper utilities for managing the last connected wallet state
+ * Helper utilities for managing the last connected connector state
  *
  * @remarks
- * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.
+ * All data is stored in localStorage with the 'orbit-core:lastConnectedConnector' key.
  * Functions are safe to use in both browser and SSR environments.
  */
-declare const recentConnectedWalletHelpers: {
+declare const recentConnectedConnectorHelpers: {
     STORAGE_KEY: string;
     /**
-     * The value of the last connected wallet, initialized when the module loads.
+     * The value of the last connected connector, initialized when the module loads.
      * Returns undefined if not set, invalid, or in an SSR context.
      */
-    recentConnectedWallet: RecentConnectedWallet | undefined;
+    recentConnectedConnector: RecentConnectedConnector | undefined;
     /**
-     * Stores the last connected wallet data in localStorage.
+     * Stores the last connected connector data in localStorage.
      *
-     * @param wallets - RecentConnectedWallet
+     * @param connectors - RecentConnectedConnector
      * @returns undefined in SSR context, void in browser
      */
-    setRecentConnectedWallet: (wallets: RecentConnectedWallet) => void;
+    setRecentConnectedConnector: (connectors: RecentConnectedConnector) => void;
     /**
-     * Retrieves the current last connected wallet data from localStorage.
+     * Retrieves the current last connected connector data from localStorage.
      *
-     * @returns The LastConnectedWallet object or undefined if not set or in SSR context
+     * @returns The LastConnectedConnector object or undefined if not set or in SSR context
      */
-    getRecentConnectedWallet: () => RecentConnectedWallet | undefined;
+    getRecentConnectedConnector: () => RecentConnectedConnector | undefined;
     /**
-     * Removes the last connected wallet data from localStorage.
+     * Removes the last connected connector data from localStorage.
      *
      * @returns undefined in SSR context, void in browser
      */
-    removeRecentConnectedWallet: () => void;
+    removeRecentConnectedConnector: () => void;
 };
 /**
@@ -406,4 +407,4 @@ declare function isSolanaChain(chainId: number | string): boolean;
  */
 declare function setChainId(chainId: number | string): string | number;
-export { type BaseAdapter, OrbitAdapter, type OrbitGenericAdapter, type RecentConnectedWallet, type WalletType, delay, filterUniqueByKey, formatWalletChainId, formatWalletName, getAdapterFromWalletType, getParsedStorageItem, getWalletTypeFromConnectorName, impersonatedHelpers, isSafeApp, isSolanaChain, lastConnectedWalletHelpers, recentConnectedWalletHelpers, selectAdapterByKey, setChainId, waitFor };
+export { type BaseAdapter, type ConnectorType, OrbitAdapter, type OrbitGenericAdapter, type RecentConnectedConnector, delay, filterUniqueByKey, formatConnectorChainId, formatConnectorName, getAdapterFromConnectorType, getConnectorTypeFromName, getParsedStorageItem, impersonatedHelpers, isSafeApp, isSolanaChain, lastConnectedConnectorHelpers, recentConnectedConnectorHelpers, selectAdapterByKey, setChainId, waitFor };

package/dist/index.d.ts CHANGED Viewed

@@ -102,10 +102,10 @@ type BaseAdapter = {
     getAvatar?: (name: string) => Promise<string | null>;
 };
 /**
- * Type representing a wallet identifier in format "OrbitAdapter:wallet"
+ * Type representing a connector identifier in format "OrbitAdapter:connector"
  * @example "evm:metamask" | "solana:phantom"
  */
-type WalletType = `${OrbitAdapter}:${string}`;
+type ConnectorType = `${OrbitAdapter}:${string}`;
 /**
  * @name delay
@@ -152,69 +152,70 @@ declare const delay: <T>(value: T, ms: number) => Promise<T>;
  */
 declare function filterUniqueByKey<T>(array: T[], key: keyof T): T[];
-declare function formatWalletChainId(chainId: string | number, connectedAdapter: OrbitAdapter): string | number;
+declare function formatConnectorChainId(chainId: string | number, connectedAdapter: OrbitAdapter): string | number;
-declare const formatWalletName: (walletName: string) => string;
+declare const formatConnectorName: (connectorName: string) => string;
 /**
- * Extracts the adapter type from a wallet type string
+ * Extracts the adapter type from a connector type string
  *
  * @example
  * ```typescript
  * // Returns OrbitAdapter.EVM
- * getAdapterFromWalletType('evm:metamask');
+ * getAdapterFromConnectorType('evm:metamask');
  *
  * // Returns OrbitAdapter.SOLANA
- * getAdapterFromWalletType('solana:phantom');
+ * getAdapterFromConnectorType('solana:phantom');
  *
  * // Returns OrbitAdapter.EVM (default)
- * getAdapterFromWalletType('unknown');
+ * getAdapterFromConnectorType('unknown');
  * ```
  *
- * @param walletType - Wallet type in format "chain:wallet" (e.g. "evm:metamask", "solana:phantom")
+ * @param connectorType - Connector type in format "orbit-adapter:connector" (e.g. "evm:metamask", "solana:phantom")
  * @returns The corresponding {@link OrbitAdapter} type or EVM as default
  *
  * @remarks
- * The function splits the wallet type string by ":" and takes the first part as the adapter type.
+ * The function splits the connector type string by ":" and takes the first part as the adapter type.
  * If the split fails or the first part is empty, it defaults to EVM adapter.
  */
-declare function getAdapterFromWalletType(walletType: WalletType): OrbitAdapter;
+declare function getAdapterFromConnectorType(connectorType: ConnectorType): OrbitAdapter;
 /**
- * Internal function for safely retrieving and parsing data from localStorage.
- *
- * @param key - The key for localStorage
- * @returns The parsed LastConnectedWallet object or undefined if data is not found/invalid
- */
-declare function getParsedStorageItem<ReturnType>(key: string): ReturnType | undefined;
-/**
- * Generates a standardized wallet type identifier from adapter type and connector name
+ * Generates a standardized connector type identifier from adapter type and connector name
  *
  * @example
  * ```typescript
  * // Returns "evm:metamask"
- * getWalletTypeFromConnectorName(OrbitAdapter.EVM, "MetaMask");
+ * getConnectorTypeFromName(OrbitAdapter.EVM, "MetaMask");
  *
  * // Returns "solana:phantom"
- * getWalletTypeFromConnectorName(OrbitAdapter.SOLANA, "Phantom");
+ * getConnectorTypeFromName(OrbitAdapter.SOLANA, "Phantom");
  *
  * // Returns "evm:coinbasewallet" (removes spaces)
- * getWalletTypeFromConnectorName(OrbitAdapter.EVM, "Coinbase Wallet");
+ * getConnectorTypeFromName(OrbitAdapter.EVM, "Coinbase Wallet");
  * ```
  *
  * @param adapter - The blockchain adapter type (e.g. EVM, SOLANA)
- * @param name - The wallet connector name (e.g. "MetaMask", "Phantom")
- * @returns A formatted wallet type string in format "chain:wallet"
+ * @param name - The connector name (e.g. "MetaMask", "Phantom")
+ * @returns A formatted connector type string in format "orbit-adapter:connector"
  *
  * @remarks
  * The function:
  * 1. Combines adapter type with connector name using ":" as separator
  * 2. Removes all whitespace from connector name
  * 3. Converts connector name to lowercase
- * This ensures consistent wallet type identifiers across the application
+ * This ensures consistent connector type identifiers across the application
+ * and normalizes connector names for better UX/consistency.
  */
-declare function getWalletTypeFromConnectorName(adapter: OrbitAdapter, name: string): string;
+declare function getConnectorTypeFromName(adapter: OrbitAdapter, name: string): string;
+/**
+ * Internal function for safely retrieving and parsing data from localStorage.
+ *
+ * @param key - The key for localStorage
+ * @returns The parsed LastConnectedConnector object or undefined if data is not found/invalid
+ */
+declare function getParsedStorageItem<ReturnType>(key: string): ReturnType | undefined;
 /**
  * Helper utilities for managing impersonated wallet addresses
@@ -263,8 +264,8 @@ declare const impersonatedHelpers: {
 declare const isSafeApp: boolean;
-type LastConnectedWallet = {
-    walletType: WalletType;
+type LastConnectedConnector = {
+    connectorType: ConnectorType;
     chainId: number | string;
     address?: string;
 };
@@ -272,71 +273,71 @@ type LastConnectedWallet = {
  * Helper utilities for managing the last connected wallet state
  *
  * @remarks
- * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.
+ * All data is stored in localStorage with the 'orbit-core:lastConnectedConnector' key.
  * Functions are safe to use in both browser and SSR environments.
  */
-declare const lastConnectedWalletHelpers: {
+declare const lastConnectedConnectorHelpers: {
     STORAGE_KEY: string;
     /**
      * The value of the last connected wallet, initialized when the module loads.
      * Returns undefined if not set, invalid, or in an SSR context.
      */
-    lastConnectedWallet: LastConnectedWallet | undefined;
+    lastConnectedConnector: LastConnectedConnector | undefined;
     /**
      * Stores the last connected wallet data in localStorage.
      *
      * @param data - Object containing the wallet type and chain ID.
      * @returns undefined in SSR context, void in browser
      */
-    setLastConnectedWallet: ({ walletType, chainId, address }: LastConnectedWallet) => void;
+    setLastConnectedConnector: ({ connectorType, chainId, address }: LastConnectedConnector) => void;
     /**
      * Retrieves the current last connected wallet data from localStorage.
      *
-     * @returns The LastConnectedWallet object or undefined if not set or in SSR context
+     * @returns The LastConnectedConnector object or undefined if not set or in SSR context
      */
-    getLastConnectedWallet: () => LastConnectedWallet | undefined;
+    getLastConnectedConnector: () => LastConnectedConnector | undefined;
     /**
      * Removes the last connected wallet data from localStorage.
      *
      * @returns undefined in SSR context, void in browser
      */
-    removeLastConnectedWallet: () => void;
+    removeLastConnectedConnector: () => void;
 };
-type RecentConnectedWallet = Record<OrbitAdapter, Record<string, boolean>>;
+type RecentConnectedConnector = Record<OrbitAdapter, Record<string, boolean>>;
 /**
- * Helper utilities for managing the last connected wallet state
+ * Helper utilities for managing the last connected connector state
  *
  * @remarks
- * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.
+ * All data is stored in localStorage with the 'orbit-core:lastConnectedConnector' key.
  * Functions are safe to use in both browser and SSR environments.
  */
-declare const recentConnectedWalletHelpers: {
+declare const recentConnectedConnectorHelpers: {
     STORAGE_KEY: string;
     /**
-     * The value of the last connected wallet, initialized when the module loads.
+     * The value of the last connected connector, initialized when the module loads.
      * Returns undefined if not set, invalid, or in an SSR context.
      */
-    recentConnectedWallet: RecentConnectedWallet | undefined;
+    recentConnectedConnector: RecentConnectedConnector | undefined;
     /**
-     * Stores the last connected wallet data in localStorage.
+     * Stores the last connected connector data in localStorage.
      *
-     * @param wallets - RecentConnectedWallet
+     * @param connectors - RecentConnectedConnector
      * @returns undefined in SSR context, void in browser
      */
-    setRecentConnectedWallet: (wallets: RecentConnectedWallet) => void;
+    setRecentConnectedConnector: (connectors: RecentConnectedConnector) => void;
     /**
-     * Retrieves the current last connected wallet data from localStorage.
+     * Retrieves the current last connected connector data from localStorage.
      *
-     * @returns The LastConnectedWallet object or undefined if not set or in SSR context
+     * @returns The LastConnectedConnector object or undefined if not set or in SSR context
      */
-    getRecentConnectedWallet: () => RecentConnectedWallet | undefined;
+    getRecentConnectedConnector: () => RecentConnectedConnector | undefined;
     /**
-     * Removes the last connected wallet data from localStorage.
+     * Removes the last connected connector data from localStorage.
      *
      * @returns undefined in SSR context, void in browser
      */
-    removeRecentConnectedWallet: () => void;
+    removeRecentConnectedConnector: () => void;
 };
 /**
@@ -406,4 +407,4 @@ declare function isSolanaChain(chainId: number | string): boolean;
  */
 declare function setChainId(chainId: number | string): string | number;
-export { type BaseAdapter, OrbitAdapter, type OrbitGenericAdapter, type RecentConnectedWallet, type WalletType, delay, filterUniqueByKey, formatWalletChainId, formatWalletName, getAdapterFromWalletType, getParsedStorageItem, getWalletTypeFromConnectorName, impersonatedHelpers, isSafeApp, isSolanaChain, lastConnectedWalletHelpers, recentConnectedWalletHelpers, selectAdapterByKey, setChainId, waitFor };
+export { type BaseAdapter, type ConnectorType, OrbitAdapter, type OrbitGenericAdapter, type RecentConnectedConnector, delay, filterUniqueByKey, formatConnectorChainId, formatConnectorName, getAdapterFromConnectorType, getConnectorTypeFromName, getParsedStorageItem, impersonatedHelpers, isSafeApp, isSolanaChain, lastConnectedConnectorHelpers, recentConnectedConnectorHelpers, selectAdapterByKey, setChainId, waitFor };

package/dist/index.js CHANGED Viewed

@@ -1,2 +1,2 @@
-'use strict';var d=(n=>(n.EVM="evm",n.SOLANA="solana",n.Starknet="starknet",n))(d||{});var c=(e,t)=>new Promise(r=>{let n=()=>{setTimeout(()=>r(e),t);};typeof window<"u"?n():setTimeout(n,0);});function u(e,t){let r=new Set;return e.filter(n=>{let a=n[t];return r.has(a)?false:(r.add(a),true)})}function g(e,t){return typeof e=="string"?`${t}:${e}`:e}var s=new Map([["Impersonated Connector","impersonatedwallet"],["Safe","safewallet"],["Trust","trustwallet"],["Trust Wallet","trustwallet"],["Brave \u041A\u043E\u0448\u0435\u043B\u0435\u043A","bravewallet"],["Brave Wallet","bravewallet"],["Base Account","coinbasewallet"]]),A=e=>s.get(e)??e.replace(/\s+/g,"").toLowerCase();function W(e){return e?.split(":")[0]??"evm"}function o(e){if(typeof window>"u")return;let t=window.localStorage.getItem(e);if(t)try{return JSON.parse(t)}catch(r){console.error(`Error parsing ${e} from localStorage:`,r);return}}function O(e,t){return `${e}:${t.replace(/\s+/g,"").toLowerCase()}`}var R={impersonatedAddress:typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress")??"":"",setImpersonated:e=>typeof window<"u"?window.localStorage.setItem("satellite-connect:impersonatedAddress",e):void 0,getImpersonated:()=>typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress"):void 0,removeImpersonated:()=>typeof window<"u"?window.localStorage.removeItem("satellite-connect:impersonatedAddress"):void 0};var v=typeof window<"u"&&window!==window.parent;var i={STORAGE_KEY:"orbit-core:lastConnectedWallet",lastConnectedWallet:o("orbit-core:lastConnectedWallet"),setLastConnectedWallet:({walletType:e,chainId:t,address:r})=>typeof window<"u"?window.localStorage.setItem(i.STORAGE_KEY,JSON.stringify({walletType:e,chainId:t,address:r})):void 0,getLastConnectedWallet:()=>o(i.STORAGE_KEY),removeLastConnectedWallet:()=>typeof window<"u"?window.localStorage.removeItem(i.STORAGE_KEY):void 0};var l={STORAGE_KEY:"orbit-core:recentConnectedWallet",recentConnectedWallet:o("orbit-core:recentConnectedWallets"),setRecentConnectedWallet:e=>typeof window<"u"?window.localStorage.setItem(l.STORAGE_KEY,JSON.stringify(e)):void 0,getRecentConnectedWallet:()=>o(l.STORAGE_KEY),removeRecentConnectedWallet:()=>typeof window<"u"?window.localStorage.removeItem(l.STORAGE_KEY):void 0};var $=({adapterKey:e,adapter:t})=>{if(Array.isArray(t)){if(t.length===0){console.error("Adapter selection failed: The provided adapters array is empty.");return}let r=t.find(n=>n.key===e);return r||(console.warn(`No adapter found for key: "${e}". Falling back to the first available adapter: "${t[0].key}".`),t[0])}return t};async function N(e,t=50,r=200){for(let n=0;n<t;n++){if(e())return;await new Promise(a=>setTimeout(a,r));}throw new Error("Predicate not fulfilled in time")}function p(e){return typeof e=="string"?["devnet","testnet","mainnet-beta","mainnet"].includes(e):false}function h(e){return p(e)?`solana:${e}`:e}exports.OrbitAdapter=d;exports.delay=c;exports.filterUniqueByKey=u;exports.formatWalletChainId=g;exports.formatWalletName=A;exports.getAdapterFromWalletType=W;exports.getParsedStorageItem=o;exports.getWalletTypeFromConnectorName=O;exports.impersonatedHelpers=R;exports.isSafeApp=v;exports.isSolanaChain=p;exports.lastConnectedWalletHelpers=i;exports.recentConnectedWalletHelpers=l;exports.selectAdapterByKey=$;exports.setChainId=h;exports.waitFor=N;//# sourceMappingURL=index.js.map
+'use strict';var a=(r=>(r.EVM="evm",r.SOLANA="solana",r.Starknet="starknet",r))(a||{});var l=(e,t)=>new Promise(n=>{let r=()=>{setTimeout(()=>n(e),t);};typeof window<"u"?r():setTimeout(r,0);});function u(e,t){let n=new Set;return e.filter(r=>{let i=r[t];return n.has(i)?false:(n.add(i),true)})}function C(e,t){return typeof e=="string"?`${t}:${e}`:e}var c=new Map([["Impersonated Connector","impersonatedwallet"],["Safe","safewallet"],["Trust","trustwallet"],["Trust Wallet","trustwallet"],["Brave \u041A\u043E\u0448\u0435\u043B\u0435\u043A","bravewallet"],["Brave Wallet","bravewallet"],["Base Account","coinbasewallet"]]),y=e=>c.get(e)??e.replace(/\s+/g,"").toLowerCase();function T(e){return e?.split(":")[0]??"evm"}function O(e,t){return `${e}:${t.replace(/\s+/g,"").toLowerCase()}`}function o(e){if(typeof window>"u")return;let t=window.localStorage.getItem(e);if(t)try{return JSON.parse(t)}catch(n){console.error(`Error parsing ${e} from localStorage:`,n);return}}var I={impersonatedAddress:typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress")??"":"",setImpersonated:e=>typeof window<"u"?window.localStorage.setItem("satellite-connect:impersonatedAddress",e):void 0,getImpersonated:()=>typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress"):void 0,removeImpersonated:()=>typeof window<"u"?window.localStorage.removeItem("satellite-connect:impersonatedAddress"):void 0};var G=typeof window<"u"&&window!==window.parent;var d={STORAGE_KEY:"orbit-core:lastConnectedConnector",lastConnectedConnector:o("orbit-core:lastConnectedConnector"),setLastConnectedConnector:({connectorType:e,chainId:t,address:n})=>typeof window<"u"?window.localStorage.setItem(d.STORAGE_KEY,JSON.stringify({connectorType:e,chainId:t,address:n})):void 0,getLastConnectedConnector:()=>o(d.STORAGE_KEY),removeLastConnectedConnector:()=>typeof window<"u"?window.localStorage.removeItem(d.STORAGE_KEY):void 0};var s={STORAGE_KEY:"orbit-core:recentConnectedConnector",recentConnectedConnector:o("orbit-core:recentConnectedConnectors"),setRecentConnectedConnector:e=>typeof window<"u"?window.localStorage.setItem(s.STORAGE_KEY,JSON.stringify(e)):void 0,getRecentConnectedConnector:()=>o(s.STORAGE_KEY),removeRecentConnectedConnector:()=>typeof window<"u"?window.localStorage.removeItem(s.STORAGE_KEY):void 0};var $=({adapterKey:e,adapter:t})=>{if(Array.isArray(t)){if(t.length===0){console.error("Adapter selection failed: The provided adapters array is empty.");return}let n=t.find(r=>r.key===e);return n||(console.warn(`No adapter found for key: "${e}". Falling back to the first available adapter: "${t[0].key}".`),t[0])}return t};async function Y(e,t=50,n=200){for(let r=0;r<t;r++){if(e())return;await new Promise(i=>setTimeout(i,n));}throw new Error("Predicate not fulfilled in time")}function p(e){return typeof e=="string"?["devnet","testnet","mainnet-beta","mainnet"].includes(e):false}function B(e){return p(e)?`solana:${e}`:e}exports.OrbitAdapter=a;exports.delay=l;exports.filterUniqueByKey=u;exports.formatConnectorChainId=C;exports.formatConnectorName=y;exports.getAdapterFromConnectorType=T;exports.getConnectorTypeFromName=O;exports.getParsedStorageItem=o;exports.impersonatedHelpers=I;exports.isSafeApp=G;exports.isSolanaChain=p;exports.lastConnectedConnectorHelpers=d;exports.recentConnectedConnectorHelpers=s;exports.selectAdapterByKey=$;exports.setChainId=B;exports.waitFor=Y;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/types.ts","../src/utils/delay.ts","../src/utils/filterUniqueByKey.ts","../src/utils/formatWalletChainId.ts","../src/utils/formatWalletName.ts","../src/utils/getAdapterFromWalletType.ts","../src/utils/getParsedStorageItem.ts","../src/utils/getWalletTypeFromConnectorName.ts","../src/utils/impersonatedHelpers.ts","../src/utils/isSafeApp.ts","../src/utils/lastConnectedWalletHelpers.ts","../src/utils/recentConnectedWalletHelpers.ts","../src/utils/selectAdapterByKey.ts","../src/utils/waitFor.ts","../src/utils/%D1%81hainHelpers.ts"],"names":["OrbitAdapter","delay","value","ms","resolve","runTimeout","filterUniqueByKey","array","key","seenValues","item","keyValue","formatWalletChainId","chainId","connectedAdapter","WALLET_MAPPINGS","formatWalletName","walletName","getAdapterFromWalletType","walletType","getParsedStorageItem","error","getWalletTypeFromConnectorName","adapter","name","impersonatedHelpers","address","isSafeApp","lastConnectedWalletHelpers","recentConnectedWalletHelpers","wallets","selectAdapterByKey","adapterKey","foundAdapter","a","waitFor","predicate","maxChecks","checkIntervalMs","i","isSolanaChain","setChainId"],"mappings":"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","file":"index.js","sourcesContent":["/*\n @file\n * Core type definitions for the Orbit blockchain adapter system.\n * This file contains fundamental enums and types that define the supported blockchain architectures\n * and their adapter interfaces.\n /\n\n// =================================================================================================\n// 1. ENUMS AND CORE TRANSACTION TYPES\n// =================================================================================================\n\n/\n Defines the supported blockchain adapters in the Orbit system.\n * Each adapter corresponds to a specific blockchain architecture and implements\n * the necessary interfaces for that chain's functionality.\n \n @enum {string}\n \n @example\n * ```typescript\n * // Using adapter types in configuration\n * const config = {\n * chainType: OrbitAdapter.EVM,\n * // other configuration...\n * };\n \n // Checking adapter compatibility\n * if (chainType === OrbitAdapter.SOLANA) {\n * // Solana-specific logic\n * }\n * ```\n /\nexport enum OrbitAdapter {\n /\n For Ethereum Virtual Machine (EVM) compatible chains.\n * Supports networks like:\n * - Ethereum Mainnet\n * - Polygon\n * - Binance Smart Chain\n * - Avalanche\n * - Other EVM-compatible L1/L2 chains\n /\n EVM = 'evm',\n\n /\n For the Solana blockchain.\n * Supports:\n * - Solana Mainnet\n * - Devnet\n * - Testnet\n /\n SOLANA = 'solana',\n\n /\n For the Starknet L2 network.\n * Supports:\n * - Starknet Mainnet\n * - Testnet (Goerli)\n * - Other Starknet deployments\n /\n Starknet = 'starknet',\n}\n\n/\n Generic type for creating blockchain adapters with type safety.\n * This type ensures that all adapters implement the required interface\n * and are properly keyed by their blockchain type.\n \n @typeParam A - Type that extends the base adapter interface with a key property\n \n @property {A \| A[]} adapter - Single adapter instance or array of adapters\n \n @example\n * ```typescript\n * // Single adapter implementation\n * interface EVMAdapter extends BaseAdapter {\n * key: OrbitAdapter.EVM;\n * // EVM-specific methods...\n * }\n * const evmConfig: OrbitGenericAdapter<EVMAdapter> = {\n * adapter: {\n * key: OrbitAdapter.EVM,\n * // implementation...\n * }\n * };\n \n // Multiple adapters\n * const multiChainConfig: OrbitGenericAdapter<EVMAdapter> = {\n * adapter: [\n * { key: OrbitAdapter.EVM, ... },\n * { key: OrbitAdapter.SOLANA, ... }\n * ]\n * };\n * ```\n /\nexport type OrbitGenericAdapter<A extends { key: OrbitAdapter }> = {\n adapter: A \| A[];\n};\n\nexport type BaseAdapter = {\n /\n Generates blockchain explorer URL\n * @returns Explorer URL or undefined if not available\n /\n getExplorerUrl: (url?: string, chainId?: string \| number) => string \| undefined;\n\n /* Optional method to resolve ENS-like names /\n getName?: (address: string) => Promise<string \| null>;\n\n /* Optional method to get avatar for resolved names /\n getAvatar?: (name: string) => Promise<string \| null>;\n};\n\n/\n Type representing a wallet identifier in format \"OrbitAdapter:wallet\"\n * @example \"evm:metamask\" \| \"solana:phantom\"\n /\nexport type WalletType = `${OrbitAdapter}:${string}`;\n","/\n @name delay\n \n Ensures the global 'window' object is available (if running in a browser-like environment),\n * then pauses execution for a specified duration, and finally resolves the Promise with the given value.\n \n This utility function is designed to be safe for use in Server-Side Rendering (SSR) environments.\n * It asynchronously waits for the 'window' object to be defined before starting the actual timer,\n * helping to prevent errors during the initial server render while still providing a time delay on the client.\n \n @template T - The type of the value being resolved.\n \n @param {T} value - The value to resolve the Promise with after the delay.\n * @param {number} ms - The number of milliseconds (delay) to wait before resolving the Promise after 'window' is available.\n \n @returns {Promise<T>} A Promise that resolves with the provided `value` after both the 'window' check and the delay (`ms`) are complete.\n \n @example\n * ```typescript\n * // Use this in an environment where 'window' might not be immediately available (e.g., Next.js component).\n * async function waitForWindowAndDelay() {\n * console.log(\"Start wait...\");\n * // This will wait for window, and then wait 100ms.\n * const data = await delay(\"Ready to connect\", 100);\n * console.log(data);\n * }\n * waitForWindowAndDelay();\n * ```\n /\nexport const delay = <T>(value: T, ms: number): Promise<T> => {\n return new Promise((resolve) => {\n const runTimeout = () => {\n setTimeout(() => resolve(value), ms);\n };\n\n if (typeof window !== 'undefined') {\n runTimeout();\n } else {\n setTimeout(runTimeout, 0);\n }\n });\n};\n","/\n Filters an array of objects to keep only the first occurrence of an object\n * based on a unique value of a specified key.\n \n This function is generic and type-safe. It iterates through the array and uses a\n * Set to track already encountered key values, effectively removing duplicates.\n \n @template T The type of the objects in the array.\n * @param {T[]} array - The array of objects to be filtered.\n * @param {keyof T} key - The object key (property name) whose values must be unique.\n * @returns {T[]} The filtered array containing only objects with unique key values.\n /\nexport function filterUniqueByKey<T>(array: T[], key: keyof T): T[] {\n // 1. Create a Set to store the unique values of the key encountered so far.\n // Set is a collection of unique values, which is perfect for fast duplicate checks.\n const seenValues = new Set<T[keyof T]>();\n\n // 2. Use the native Array.prototype.filter() method to create a new, filtered array.\n return array.filter((item) => {\n // Access the value of the specified key from the current object.\n const keyValue = item[key];\n\n // 3. Check if this key value has been seen before.\n if (seenValues.has(keyValue)) {\n // If the value is already in the Set, return false.\n // This object is a duplicate and will be excluded from the result.\n return false;\n } else {\n // If the value is encountered for the first time, add it to the Set.\n seenValues.add(keyValue);\n // Return true to include the object in the resulting unique array.\n return true;\n }\n });\n}\n","import { OrbitAdapter } from '../types';\n\nexport function formatWalletChainId(chainId: string \| number, connectedAdapter: OrbitAdapter) {\n if (typeof chainId === 'string') {\n return `${connectedAdapter}:${chainId}`;\n } else {\n return chainId;\n }\n}\n","const WALLET_MAPPINGS = new Map([\n ['Impersonated Connector', 'impersonatedwallet'],\n ['Safe', 'safewallet'],\n ['Trust', 'trustwallet'],\n ['Trust Wallet', 'trustwallet'],\n ['Brave Кошелек', 'bravewallet'],\n ['Brave Wallet', 'bravewallet'],\n ['Base Account', 'coinbasewallet'], // TODO: need fix\n]);\n\nexport const formatWalletName = (walletName: string): string => {\n return WALLET_MAPPINGS.get(walletName) ?? walletName.replace(/\\s+/g, '').toLowerCase();\n};\n","import { OrbitAdapter, WalletType } from '../types';\n\n/\n Extracts the adapter type from a wallet type string\n \n @example\n * ```typescript\n * // Returns OrbitAdapter.EVM\n * getAdapterFromWalletType('evm:metamask');\n \n // Returns OrbitAdapter.SOLANA\n * getAdapterFromWalletType('solana:phantom');\n \n // Returns OrbitAdapter.EVM (default)\n * getAdapterFromWalletType('unknown');\n * ```\n \n @param walletType - Wallet type in format \"chain:wallet\" (e.g. \"evm:metamask\", \"solana:phantom\")\n * @returns The corresponding {@link OrbitAdapter} type or EVM as default\n \n @remarks\n * The function splits the wallet type string by \":\" and takes the first part as the adapter type.\n * If the split fails or the first part is empty, it defaults to EVM adapter.\n /\nexport function getAdapterFromWalletType(walletType: WalletType): OrbitAdapter {\n return (walletType?.split(':')[0] as OrbitAdapter.EVM) ?? OrbitAdapter.EVM;\n}\n","/\n Internal function for safely retrieving and parsing data from localStorage.\n \n @param key - The key for localStorage\n * @returns The parsed LastConnectedWallet object or undefined if data is not found/invalid\n /\nexport function getParsedStorageItem<ReturnType>(key: string): ReturnType \| undefined {\n if (typeof window === 'undefined') {\n return undefined;\n }\n\n const item = window.localStorage.getItem(key);\n\n // If the item is null (not set) or an empty string, return undefined\n if (!item) {\n return undefined;\n }\n\n try {\n // Safe JSON parsing\n return JSON.parse(item) as ReturnType;\n } catch (error) {\n // In case of a parsing error (e.g., invalid JSON), log the error and return undefined\n console.error(`Error parsing ${key} from localStorage:`, error);\n return undefined;\n }\n}\n","import { OrbitAdapter } from '../types';\n\n/\n Generates a standardized wallet type identifier from adapter type and connector name\n \n @example\n * ```typescript\n * // Returns \"evm:metamask\"\n * getWalletTypeFromConnectorName(OrbitAdapter.EVM, \"MetaMask\");\n \n // Returns \"solana:phantom\"\n * getWalletTypeFromConnectorName(OrbitAdapter.SOLANA, \"Phantom\");\n \n // Returns \"evm:coinbasewallet\" (removes spaces)\n * getWalletTypeFromConnectorName(OrbitAdapter.EVM, \"Coinbase Wallet\");\n * ```\n \n @param adapter - The blockchain adapter type (e.g. EVM, SOLANA)\n * @param name - The wallet connector name (e.g. \"MetaMask\", \"Phantom\")\n * @returns A formatted wallet type string in format \"chain:wallet\"\n \n @remarks\n * The function:\n * 1. Combines adapter type with connector name using \":\" as separator\n * 2. Removes all whitespace from connector name\n * 3. Converts connector name to lowercase\n * This ensures consistent wallet type identifiers across the application\n /\nexport function getWalletTypeFromConnectorName(adapter: OrbitAdapter, name: string): string {\n return `${adapter}:${name.replace(/\\s+/g, '').toLowerCase()}`;\n}\n","/\n Helper utilities for managing impersonated wallet addresses\n \n @remarks\n * These utilities are primarily used for development and testing purposes.\n * They provide a way to simulate different wallet addresses without actually connecting a wallet.\n * All data is stored in localStorage with the 'satellite-connect:impersonatedAddress' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const impersonatedHelpers = {\n /\n Currently impersonated address from localStorage\n * Returns empty string if not set or in SSR context\n /\n impersonatedAddress:\n typeof window !== 'undefined' ? (window.localStorage.getItem('satellite-connect:impersonatedAddress') ?? '') : '',\n\n /\n Stores an impersonated address in localStorage\n \n @example\n * ```typescript\n * // Set impersonated address\n * impersonatedHelpers.setImpersonated('0x1234...5678');\n * ```\n \n @param address - Ethereum or Solana address to impersonate\n * @returns undefined in SSR context, void in browser\n /\n setImpersonated: (address: string) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem('satellite-connect:impersonatedAddress', address)\n : undefined,\n\n /\n Retrieves the current impersonated address from localStorage\n \n @example\n * ```typescript\n * // Get current impersonated address\n * const address = impersonatedHelpers.getImpersonated();\n * if (address) {\n * console.log('Currently impersonating:', address);\n * }\n * ```\n * @returns The impersonated address or undefined if not set or in SSR context\n /\n getImpersonated: () =>\n typeof window !== 'undefined' ? window.localStorage.getItem('satellite-connect:impersonatedAddress') : undefined,\n\n removeImpersonated: () =>\n typeof window !== 'undefined' ? window.localStorage.removeItem('satellite-connect:impersonatedAddress') : undefined,\n};\n","export const isSafeApp = typeof window !== 'undefined' && window !== window.parent;\n","import { WalletType } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\ntype LastConnectedWallet = { walletType: WalletType; chainId: number \| string; address?: string };\n\n/\n Helper utilities for managing the last connected wallet state\n \n @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const lastConnectedWalletHelpers = {\n // Key used for localStorage\n STORAGE_KEY: 'orbit-core:lastConnectedWallet',\n\n /\n The value of the last connected wallet, initialized when the module loads.\n * Returns undefined if not set, invalid, or in an SSR context.\n /\n lastConnectedWallet: getParsedStorageItem<LastConnectedWallet>('orbit-core:lastConnectedWallet'),\n\n /\n Stores the last connected wallet data in localStorage.\n \n @param data - Object containing the wallet type and chain ID.\n * @returns undefined in SSR context, void in browser\n /\n setLastConnectedWallet: ({ walletType, chainId, address }: LastConnectedWallet) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem(\n lastConnectedWalletHelpers.STORAGE_KEY,\n JSON.stringify({ walletType, chainId, address }),\n )\n : undefined,\n\n /\n Retrieves the current last connected wallet data from localStorage.\n \n @returns The LastConnectedWallet object or undefined if not set or in SSR context\n /\n getLastConnectedWallet: () => getParsedStorageItem<LastConnectedWallet>(lastConnectedWalletHelpers.STORAGE_KEY),\n\n /\n Removes the last connected wallet data from localStorage.\n \n @returns undefined in SSR context, void in browser\n /\n removeLastConnectedWallet: () =>\n typeof window !== 'undefined' ? window.localStorage.removeItem(lastConnectedWalletHelpers.STORAGE_KEY) : undefined,\n};\n","import { OrbitAdapter } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\nexport type RecentConnectedWallet = Record<OrbitAdapter, Record<string, boolean>>;\n\n/\n Helper utilities for managing the last connected wallet state\n \n @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const recentConnectedWalletHelpers = {\n // Key used for localStorage\n STORAGE_KEY: 'orbit-core:recentConnectedWallet',\n\n /\n The value of the last connected wallet, initialized when the module loads.\n * Returns undefined if not set, invalid, or in an SSR context.\n /\n recentConnectedWallet: getParsedStorageItem<RecentConnectedWallet>('orbit-core:recentConnectedWallets'),\n\n /\n Stores the last connected wallet data in localStorage.\n \n @param wallets - RecentConnectedWallet\n * @returns undefined in SSR context, void in browser\n /\n setRecentConnectedWallet: (wallets: RecentConnectedWallet) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem(recentConnectedWalletHelpers.STORAGE_KEY, JSON.stringify(wallets))\n : undefined,\n\n /\n Retrieves the current last connected wallet data from localStorage.\n \n @returns The LastConnectedWallet object or undefined if not set or in SSR context\n /\n getRecentConnectedWallet: () => getParsedStorageItem<RecentConnectedWallet>(recentConnectedWalletHelpers.STORAGE_KEY),\n\n /\n Removes the last connected wallet data from localStorage.\n \n @returns undefined in SSR context, void in browser\n /\n removeRecentConnectedWallet: () =>\n typeof window !== 'undefined'\n ? window.localStorage.removeItem(recentConnectedWalletHelpers.STORAGE_KEY)\n : undefined,\n};\n","/\n @file\n * This module provides adapter selection functionality for the Orbit system.\n * Part of the core infrastructure for managing blockchain adapters.\n /\n\nimport { OrbitAdapter, OrbitGenericAdapter } from '../types';\n\n/\n Selects an appropriate adapter based on the provided key from either a single adapter\n * or an array of adapters.\n \n @typeParam A - Type extending basic adapter interface with a key property\n \n @param options - Selection configuration object\n * @param options.adapterKey - Target adapter key to search for\n * @param options.adapter - Single adapter or array of adapters to search within\n \n @returns Selected adapter or undefined if no suitable adapter found\n \n @remarks\n * If an array is provided but no matching adapter is found, falls back to the first adapter\n * in the array with a warning message.\n \n @example\n * ```typescript\n * // Single adapter usage\n * const singleResult = selectAdapterByKey({\n * adapterKey: OrbitAdapter.SOLANA,\n * adapter: { key: OrbitAdapter.SOLANA, connect: async () => {...} }\n * });\n \n // Multiple adapters usage\n * const multiResult = selectAdapterByKey({\n * adapterKey: OrbitAdapter.EVM,\n * adapter: [\n * { key: OrbitAdapter.SOLANA, connect: async () => {...} },\n * { key: OrbitAdapter.EVM, connect: async () => {...} }\n * ]\n * });\n * ```\n \n @throws {Error} Logs error if adapter array is empty\n * @throws {Warning} Logs warning if requested adapter key not found in array\n /\nexport const selectAdapterByKey = <A extends { key: OrbitAdapter }>({\n adapterKey,\n adapter,\n}: { adapterKey: OrbitAdapter } & OrbitGenericAdapter<A>): A \| undefined => {\n if (Array.isArray(adapter)) {\n if (adapter.length === 0) {\n console.error('Adapter selection failed: The provided adapters array is empty.');\n return undefined;\n }\n\n const foundAdapter = adapter.find((a) => a.key === adapterKey);\n\n if (foundAdapter) {\n return foundAdapter;\n } else {\n console.warn(\n `No adapter found for key: \"${adapterKey}\". Falling back to the first available adapter: \"${adapter[0].key}\".`,\n );\n return adapter[0];\n }\n }\n return adapter;\n};\n","export async function waitFor(\n predicate: () => boolean \| undefined,\n maxChecks: number = 50,\n checkIntervalMs: number = 200,\n) {\n for (let i = 0; i < maxChecks; i++) {\n if (predicate()) {\n return;\n }\n await new Promise((resolve) => setTimeout(resolve, checkIntervalMs));\n }\n throw new Error('Predicate not fulfilled in time');\n}\n","/\n Checks whether the given chain ID belongs to a Solana network.\n * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.\n \n @param {number \| string} chainId - The chain ID or chain name.\n * @returns {boolean} - True if the chain ID corresponds to a Solana network, false otherwise.\n /\nexport function isSolanaChain(chainId: number \| string): boolean {\n if (typeof chainId === 'string') {\n return ['devnet', 'testnet', 'mainnet-beta', 'mainnet'].includes(chainId);\n }\n return false;\n}\n\n/\n Sets the chain ID to a Solana-specific format if the chain is a Solana network.\n \n @param {number \| string} chainId - The original chain ID or name.\n * @returns {string \| number} - The formatted chain ID prefixed with 'solana:' if Solana, otherwise the original.\n */\nexport function setChainId(chainId: number \| string): string \| number {\n if (isSolanaChain(chainId)) {\n return `solana:${chainId}`;\n } else {\n return chainId;\n }\n}\n"]}
1	+ {"version":3,"sources":["../src/types.ts","../src/utils/delay.ts","../src/utils/filterUniqueByKey.ts","../src/utils/formatConnectorChainId.ts","../src/utils/formatConnectorName.ts","../src/utils/getAdapterFromConnectorType.ts","../src/utils/getConnectorTypeFromName.ts","../src/utils/getParsedStorageItem.ts","../src/utils/impersonatedHelpers.ts","../src/utils/isSafeApp.ts","../src/utils/lastConnectedConnectorHelpers.ts","../src/utils/recentConnectedConnectorHelpers.ts","../src/utils/selectAdapterByKey.ts","../src/utils/waitFor.ts","../src/utils/%D1%81hainHelpers.ts"],"names":["OrbitAdapter","delay","value","ms","resolve","runTimeout","filterUniqueByKey","array","key","seenValues","item","keyValue","formatConnectorChainId","chainId","connectedAdapter","CONNECTOR_MAPPINGS","formatConnectorName","connectorName","getAdapterFromConnectorType","connectorType","getConnectorTypeFromName","adapter","name","getParsedStorageItem","error","impersonatedHelpers","address","isSafeApp","lastConnectedConnectorHelpers","recentConnectedConnectorHelpers","connectors","selectAdapterByKey","adapterKey","foundAdapter","a","waitFor","predicate","maxChecks","checkIntervalMs","i","isSolanaChain","setChainId"],"mappings":"aAgCO,IAAKA,CAAAA,CAAAA,CAAAA,CAAAA,GAUVA,CAAAA,CAAA,GAAA,CAAM,KAAA,CASNA,CAAAA,CAAA,MAAA,CAAS,QAAA,CASTA,CAAAA,CAAA,QAAA,CAAW,UAAA,CA5BDA,CAAAA,CAAAA,EAAAA,CAAAA,EAAA,EAAA,ECHL,IAAMC,EAAQ,CAAIC,CAAAA,CAAUC,CAAAA,GAC1B,IAAI,OAAA,CAASC,CAAAA,EAAY,CAC9B,IAAMC,CAAAA,CAAa,IAAM,CACvB,UAAA,CAAW,IAAMD,CAAAA,CAAQF,CAAK,CAAA,CAAGC,CAAE,EACrC,CAAA,CAEI,OAAO,MAAA,CAAW,GAAA,CACpBE,CAAAA,EAAW,CAEX,UAAA,CAAWA,CAAAA,CAAY,CAAC,EAE5B,CAAC,EC5BI,SAASC,CAAAA,CAAqBC,CAAAA,CAAYC,CAAAA,CAAmB,CAGlE,IAAMC,CAAAA,CAAa,IAAI,GAAA,CAGvB,OAAOF,CAAAA,CAAM,MAAA,CAAQG,CAAAA,EAAS,CAE5B,IAAMC,EAAWD,CAAAA,CAAKF,CAAG,CAAA,CAGzB,OAAIC,CAAAA,CAAW,GAAA,CAAIE,CAAQ,CAAA,CAGlB,KAAA,EAGPF,CAAAA,CAAW,GAAA,CAAIE,CAAQ,CAAA,CAEhB,IAAA,CAEX,CAAC,CACH,CChCO,SAASC,CAAAA,CAAuBC,CAAAA,CAA0BC,CAAAA,CAAgC,CAC/F,OAAI,OAAOD,CAAAA,EAAY,QAAA,CACd,CAAA,EAAGC,CAAgB,CAAA,CAAA,EAAID,CAAO,GAE9BA,CAEX,CCRA,IAAME,CAAAA,CAAqB,IAAI,GAAA,CAAI,CACjC,CAAC,wBAAA,CAA0B,oBAAoB,CAAA,CAC/C,CAAC,MAAA,CAAQ,YAAY,CAAA,CACrB,CAAC,OAAA,CAAS,aAAa,CAAA,CACvB,CAAC,cAAA,CAAgB,aAAa,CAAA,CAC9B,CAAC,kDAAA,CAAiB,aAAa,CAAA,CAC/B,CAAC,cAAA,CAAgB,aAAa,EAC9B,CAAC,cAAA,CAAgB,gBAAgB,CACnC,CAAC,CAAA,CAEYC,CAAAA,CAAuBC,CAAAA,EAC3BF,CAAAA,CAAmB,GAAA,CAAIE,CAAa,CAAA,EAAKA,CAAAA,CAAc,OAAA,CAAQ,MAAA,CAAQ,EAAE,CAAA,CAAE,WAAA,GCa7E,SAASC,CAAAA,CAA4BC,CAAAA,CAA4C,CACtF,OAAQA,CAAAA,EAAe,KAAA,CAAM,GAAG,CAAA,CAAE,CAAC,CAAA,EAA0B,KAC/D,CCGO,SAASC,CAAAA,CAAyBC,CAAAA,CAAuBC,CAAAA,CAAsB,CACpF,OAAO,CAAA,EAAGD,CAAO,CAAA,CAAA,EAAIC,CAAAA,CAAK,OAAA,CAAQ,MAAA,CAAQ,EAAE,CAAA,CAAE,WAAA,EAAa,CAAA,CAC7D,CCzBO,SAASC,CAAAA,CAAiCf,CAAAA,CAAqC,CACpF,GAAI,OAAO,MAAA,CAAW,GAAA,CACpB,OAGF,IAAME,CAAAA,CAAO,OAAO,YAAA,CAAa,OAAA,CAAQF,CAAG,CAAA,CAG5C,GAAKE,CAAAA,CAIL,GAAI,CAEF,OAAO,IAAA,CAAK,KAAA,CAAMA,CAAI,CACxB,CAAA,MAASc,CAAAA,CAAO,CAEd,OAAA,CAAQ,KAAA,CAAM,CAAA,cAAA,EAAiBhB,CAAG,CAAA,mBAAA,CAAA,CAAuBgB,CAAK,CAAA,CAC9D,MACF,CACF,CCjBO,IAAMC,CAAAA,CAAsB,CAKjC,mBAAA,CACE,OAAO,MAAA,CAAW,GAAA,CAAe,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,uCAAuC,CAAA,EAAK,EAAA,CAAM,EAAA,CAcjH,eAAA,CAAkBC,CAAAA,EAChB,OAAO,MAAA,CAAW,GAAA,CACd,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,uCAAA,CAAyCA,CAAO,CAAA,CAC5E,MAAA,CAeN,eAAA,CAAiB,IACf,OAAO,MAAA,CAAW,GAAA,CAAc,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQ,uCAAuC,EAAI,MAAA,CAEzG,kBAAA,CAAoB,IAClB,OAAO,MAAA,CAAW,GAAA,CAAc,MAAA,CAAO,YAAA,CAAa,UAAA,CAAW,uCAAuC,CAAA,CAAI,MAC9G,ECpDO,IAAMC,CAAAA,CAAY,OAAO,MAAA,CAAW,GAAA,EAAe,MAAA,GAAW,MAAA,CAAO,OCYrE,IAAMC,CAAAA,CAAgC,CAE3C,WAAA,CAAa,mCAAA,CAMb,sBAAA,CAAwBL,CAAAA,CAA6C,mCAAmC,CAAA,CAQxG,0BAA2B,CAAC,CAAE,aAAA,CAAAJ,CAAAA,CAAe,OAAA,CAAAN,CAAAA,CAAS,OAAA,CAAAa,CAAQ,CAAA,GAC5D,OAAO,MAAA,CAAW,GAAA,CACd,MAAA,CAAO,YAAA,CAAa,OAAA,CAClBE,CAAAA,CAA8B,WAAA,CAC9B,IAAA,CAAK,SAAA,CAAU,CAAE,aAAA,CAAAT,CAAAA,CAAe,OAAA,CAAAN,CAAAA,CAAS,OAAA,CAAAa,CAAQ,CAAC,CACpD,CAAA,CACA,MAAA,CAON,0BAA2B,IACzBH,CAAAA,CAA6CK,CAAAA,CAA8B,WAAW,CAAA,CAOxF,4BAAA,CAA8B,IAC5B,OAAO,MAAA,CAAW,GAAA,CACd,MAAA,CAAO,YAAA,CAAa,UAAA,CAAWA,CAAAA,CAA8B,WAAW,CAAA,CACxE,MACR,ECzCO,IAAMC,CAAAA,CAAkC,CAE7C,WAAA,CAAa,qCAAA,CAMb,wBAAA,CAA0BN,CAAAA,CAA+C,sCAAsC,CAAA,CAQ/G,2BAAA,CAA8BO,CAAAA,EAC5B,OAAO,OAAW,GAAA,CACd,MAAA,CAAO,YAAA,CAAa,OAAA,CAAQD,CAAAA,CAAgC,WAAA,CAAa,IAAA,CAAK,SAAA,CAAUC,CAAU,CAAC,CAAA,CACnG,MAAA,CAON,2BAAA,CAA6B,IAC3BP,CAAAA,CAA+CM,CAAAA,CAAgC,WAAW,CAAA,CAO5F,8BAAA,CAAgC,IAC9B,OAAO,MAAA,CAAW,GAAA,CACd,MAAA,CAAO,YAAA,CAAa,UAAA,CAAWA,CAAAA,CAAgC,WAAW,CAAA,CAC1E,MACR,ECLO,IAAME,CAAAA,CAAqB,CAAkC,CAClE,UAAA,CAAAC,CAAAA,CACA,OAAA,CAAAX,CACF,CAAA,GAA4E,CAC1E,GAAI,KAAA,CAAM,OAAA,CAAQA,CAAO,CAAA,CAAG,CAC1B,GAAIA,CAAAA,CAAQ,MAAA,GAAW,CAAA,CAAG,CACxB,OAAA,CAAQ,KAAA,CAAM,iEAAiE,CAAA,CAC/E,MACF,CAEA,IAAMY,CAAAA,CAAeZ,CAAAA,CAAQ,KAAMa,CAAAA,EAAMA,CAAAA,CAAE,GAAA,GAAQF,CAAU,CAAA,CAE7D,OAAIC,CAAAA,GAGF,OAAA,CAAQ,IAAA,CACN,CAAA,2BAAA,EAA8BD,CAAU,CAAA,iDAAA,EAAoDX,CAAAA,CAAQ,CAAC,CAAA,CAAE,GAAG,CAAA,EAAA,CAC5G,CAAA,CACOA,CAAAA,CAAQ,CAAC,CAAA,CAEpB,CACA,OAAOA,CACT,ECnEA,eAAsBc,CAAAA,CACpBC,CAAAA,CACAC,CAAAA,CAAoB,EAAA,CACpBC,EAA0B,GAAA,CAC1B,CACA,IAAA,IAASC,CAAAA,CAAI,CAAA,CAAGA,CAAAA,CAAIF,CAAAA,CAAWE,CAAAA,EAAAA,CAAK,CAClC,GAAIH,CAAAA,EAAU,CACZ,OAEF,MAAM,IAAI,OAAA,CAAShC,CAAAA,EAAY,UAAA,CAAWA,CAAAA,CAASkC,CAAe,CAAC,EACrE,CACA,MAAM,IAAI,KAAA,CAAM,iCAAiC,CACnD,CCLO,SAASE,EAAc3B,CAAAA,CAAmC,CAC/D,OAAI,OAAOA,CAAAA,EAAY,QAAA,CACd,CAAC,QAAA,CAAU,SAAA,CAAW,cAAA,CAAgB,SAAS,CAAA,CAAE,QAAA,CAASA,CAAO,CAAA,CAEnE,KACT,CAQO,SAAS4B,CAAAA,CAAW5B,CAAAA,CAA2C,CACpE,OAAI2B,CAAAA,CAAc3B,CAAO,CAAA,CAChB,CAAA,OAAA,EAAUA,CAAO,CAAA,CAAA,CAEjBA,CAEX","file":"index.js","sourcesContent":["/*\n @file\n * Core type definitions for the Orbit blockchain adapter system.\n * This file contains fundamental enums and types that define the supported blockchain architectures\n * and their adapter interfaces.\n /\n\n// =================================================================================================\n// 1. ENUMS AND CORE TRANSACTION TYPES\n// =================================================================================================\n\n/\n Defines the supported blockchain adapters in the Orbit system.\n * Each adapter corresponds to a specific blockchain architecture and implements\n * the necessary interfaces for that chain's functionality.\n \n @enum {string}\n \n @example\n * ```typescript\n * // Using adapter types in configuration\n * const config = {\n * chainType: OrbitAdapter.EVM,\n * // other configuration...\n * };\n \n // Checking adapter compatibility\n * if (chainType === OrbitAdapter.SOLANA) {\n * // Solana-specific logic\n * }\n * ```\n /\nexport enum OrbitAdapter {\n /\n For Ethereum Virtual Machine (EVM) compatible chains.\n * Supports networks like:\n * - Ethereum Mainnet\n * - Polygon\n * - Binance Smart Chain\n * - Avalanche\n * - Other EVM-compatible L1/L2 chains\n /\n EVM = 'evm',\n\n /\n For the Solana blockchain.\n * Supports:\n * - Solana Mainnet\n * - Devnet\n * - Testnet\n /\n SOLANA = 'solana',\n\n /\n For the Starknet L2 network.\n * Supports:\n * - Starknet Mainnet\n * - Testnet (Goerli)\n * - Other Starknet deployments\n /\n Starknet = 'starknet',\n}\n\n/\n Generic type for creating blockchain adapters with type safety.\n * This type ensures that all adapters implement the required interface\n * and are properly keyed by their blockchain type.\n \n @typeParam A - Type that extends the base adapter interface with a key property\n \n @property {A \| A[]} adapter - Single adapter instance or array of adapters\n \n @example\n * ```typescript\n * // Single adapter implementation\n * interface EVMAdapter extends BaseAdapter {\n * key: OrbitAdapter.EVM;\n * // EVM-specific methods...\n * }\n * const evmConfig: OrbitGenericAdapter<EVMAdapter> = {\n * adapter: {\n * key: OrbitAdapter.EVM,\n * // implementation...\n * }\n * };\n \n // Multiple adapters\n * const multiChainConfig: OrbitGenericAdapter<EVMAdapter> = {\n * adapter: [\n * { key: OrbitAdapter.EVM, ... },\n * { key: OrbitAdapter.SOLANA, ... }\n * ]\n * };\n * ```\n /\nexport type OrbitGenericAdapter<A extends { key: OrbitAdapter }> = {\n adapter: A \| A[];\n};\n\nexport type BaseAdapter = {\n /\n Generates blockchain explorer URL\n * @returns Explorer URL or undefined if not available\n /\n getExplorerUrl: (url?: string, chainId?: string \| number) => string \| undefined;\n\n /* Optional method to resolve ENS-like names /\n getName?: (address: string) => Promise<string \| null>;\n\n /* Optional method to get avatar for resolved names /\n getAvatar?: (name: string) => Promise<string \| null>;\n};\n\n/\n Type representing a connector identifier in format \"OrbitAdapter:connector\"\n * @example \"evm:metamask\" \| \"solana:phantom\"\n /\nexport type ConnectorType = `${OrbitAdapter}:${string}`;\n","/\n @name delay\n \n Ensures the global 'window' object is available (if running in a browser-like environment),\n * then pauses execution for a specified duration, and finally resolves the Promise with the given value.\n \n This utility function is designed to be safe for use in Server-Side Rendering (SSR) environments.\n * It asynchronously waits for the 'window' object to be defined before starting the actual timer,\n * helping to prevent errors during the initial server render while still providing a time delay on the client.\n \n @template T - The type of the value being resolved.\n \n @param {T} value - The value to resolve the Promise with after the delay.\n * @param {number} ms - The number of milliseconds (delay) to wait before resolving the Promise after 'window' is available.\n \n @returns {Promise<T>} A Promise that resolves with the provided `value` after both the 'window' check and the delay (`ms`) are complete.\n \n @example\n * ```typescript\n * // Use this in an environment where 'window' might not be immediately available (e.g., Next.js component).\n * async function waitForWindowAndDelay() {\n * console.log(\"Start wait...\");\n * // This will wait for window, and then wait 100ms.\n * const data = await delay(\"Ready to connect\", 100);\n * console.log(data);\n * }\n * waitForWindowAndDelay();\n * ```\n /\nexport const delay = <T>(value: T, ms: number): Promise<T> => {\n return new Promise((resolve) => {\n const runTimeout = () => {\n setTimeout(() => resolve(value), ms);\n };\n\n if (typeof window !== 'undefined') {\n runTimeout();\n } else {\n setTimeout(runTimeout, 0);\n }\n });\n};\n","/\n Filters an array of objects to keep only the first occurrence of an object\n * based on a unique value of a specified key.\n \n This function is generic and type-safe. It iterates through the array and uses a\n * Set to track already encountered key values, effectively removing duplicates.\n \n @template T The type of the objects in the array.\n * @param {T[]} array - The array of objects to be filtered.\n * @param {keyof T} key - The object key (property name) whose values must be unique.\n * @returns {T[]} The filtered array containing only objects with unique key values.\n /\nexport function filterUniqueByKey<T>(array: T[], key: keyof T): T[] {\n // 1. Create a Set to store the unique values of the key encountered so far.\n // Set is a collection of unique values, which is perfect for fast duplicate checks.\n const seenValues = new Set<T[keyof T]>();\n\n // 2. Use the native Array.prototype.filter() method to create a new, filtered array.\n return array.filter((item) => {\n // Access the value of the specified key from the current object.\n const keyValue = item[key];\n\n // 3. Check if this key value has been seen before.\n if (seenValues.has(keyValue)) {\n // If the value is already in the Set, return false.\n // This object is a duplicate and will be excluded from the result.\n return false;\n } else {\n // If the value is encountered for the first time, add it to the Set.\n seenValues.add(keyValue);\n // Return true to include the object in the resulting unique array.\n return true;\n }\n });\n}\n","import { OrbitAdapter } from '../types';\n\nexport function formatConnectorChainId(chainId: string \| number, connectedAdapter: OrbitAdapter) {\n if (typeof chainId === 'string') {\n return `${connectedAdapter}:${chainId}`;\n } else {\n return chainId;\n }\n}\n","const CONNECTOR_MAPPINGS = new Map([\n ['Impersonated Connector', 'impersonatedwallet'],\n ['Safe', 'safewallet'],\n ['Trust', 'trustwallet'],\n ['Trust Wallet', 'trustwallet'],\n ['Brave Кошелек', 'bravewallet'],\n ['Brave Wallet', 'bravewallet'],\n ['Base Account', 'coinbasewallet'], // TODO: need fix\n]);\n\nexport const formatConnectorName = (connectorName: string): string => {\n return CONNECTOR_MAPPINGS.get(connectorName) ?? connectorName.replace(/\\s+/g, '').toLowerCase();\n};\n","import { ConnectorType, OrbitAdapter } from '../types';\n\n/\n Extracts the adapter type from a connector type string\n \n @example\n * ```typescript\n * // Returns OrbitAdapter.EVM\n * getAdapterFromConnectorType('evm:metamask');\n \n // Returns OrbitAdapter.SOLANA\n * getAdapterFromConnectorType('solana:phantom');\n \n // Returns OrbitAdapter.EVM (default)\n * getAdapterFromConnectorType('unknown');\n * ```\n \n @param connectorType - Connector type in format \"orbit-adapter:connector\" (e.g. \"evm:metamask\", \"solana:phantom\")\n * @returns The corresponding {@link OrbitAdapter} type or EVM as default\n \n @remarks\n * The function splits the connector type string by \":\" and takes the first part as the adapter type.\n * If the split fails or the first part is empty, it defaults to EVM adapter.\n /\nexport function getAdapterFromConnectorType(connectorType: ConnectorType): OrbitAdapter {\n return (connectorType?.split(':')[0] as OrbitAdapter.EVM) ?? OrbitAdapter.EVM;\n}\n","import { OrbitAdapter } from '../types';\n\n/\n Generates a standardized connector type identifier from adapter type and connector name\n \n @example\n * ```typescript\n * // Returns \"evm:metamask\"\n * getConnectorTypeFromName(OrbitAdapter.EVM, \"MetaMask\");\n \n // Returns \"solana:phantom\"\n * getConnectorTypeFromName(OrbitAdapter.SOLANA, \"Phantom\");\n \n // Returns \"evm:coinbasewallet\" (removes spaces)\n * getConnectorTypeFromName(OrbitAdapter.EVM, \"Coinbase Wallet\");\n * ```\n \n @param adapter - The blockchain adapter type (e.g. EVM, SOLANA)\n * @param name - The connector name (e.g. \"MetaMask\", \"Phantom\")\n * @returns A formatted connector type string in format \"orbit-adapter:connector\"\n \n @remarks\n * The function:\n * 1. Combines adapter type with connector name using \":\" as separator\n * 2. Removes all whitespace from connector name\n * 3. Converts connector name to lowercase\n * This ensures consistent connector type identifiers across the application\n * and normalizes connector names for better UX/consistency.\n /\nexport function getConnectorTypeFromName(adapter: OrbitAdapter, name: string): string {\n return `${adapter}:${name.replace(/\\s+/g, '').toLowerCase()}`;\n}\n","/\n Internal function for safely retrieving and parsing data from localStorage.\n \n @param key - The key for localStorage\n * @returns The parsed LastConnectedConnector object or undefined if data is not found/invalid\n /\nexport function getParsedStorageItem<ReturnType>(key: string): ReturnType \| undefined {\n if (typeof window === 'undefined') {\n return undefined;\n }\n\n const item = window.localStorage.getItem(key);\n\n // If the item is null (not set) or an empty string, return undefined\n if (!item) {\n return undefined;\n }\n\n try {\n // Safe JSON parsing\n return JSON.parse(item) as ReturnType;\n } catch (error) {\n // In case of a parsing error (e.g., invalid JSON), log the error and return undefined\n console.error(`Error parsing ${key} from localStorage:`, error);\n return undefined;\n }\n}\n","/\n Helper utilities for managing impersonated wallet addresses\n \n @remarks\n * These utilities are primarily used for development and testing purposes.\n * They provide a way to simulate different wallet addresses without actually connecting a wallet.\n * All data is stored in localStorage with the 'satellite-connect:impersonatedAddress' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const impersonatedHelpers = {\n /\n Currently impersonated address from localStorage\n * Returns empty string if not set or in SSR context\n /\n impersonatedAddress:\n typeof window !== 'undefined' ? (window.localStorage.getItem('satellite-connect:impersonatedAddress') ?? '') : '',\n\n /\n Stores an impersonated address in localStorage\n \n @example\n * ```typescript\n * // Set impersonated address\n * impersonatedHelpers.setImpersonated('0x1234...5678');\n * ```\n \n @param address - Ethereum or Solana address to impersonate\n * @returns undefined in SSR context, void in browser\n /\n setImpersonated: (address: string) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem('satellite-connect:impersonatedAddress', address)\n : undefined,\n\n /\n Retrieves the current impersonated address from localStorage\n \n @example\n * ```typescript\n * // Get current impersonated address\n * const address = impersonatedHelpers.getImpersonated();\n * if (address) {\n * console.log('Currently impersonating:', address);\n * }\n * ```\n * @returns The impersonated address or undefined if not set or in SSR context\n /\n getImpersonated: () =>\n typeof window !== 'undefined' ? window.localStorage.getItem('satellite-connect:impersonatedAddress') : undefined,\n\n removeImpersonated: () =>\n typeof window !== 'undefined' ? window.localStorage.removeItem('satellite-connect:impersonatedAddress') : undefined,\n};\n","export const isSafeApp = typeof window !== 'undefined' && window !== window.parent;\n","import { ConnectorType } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\ntype LastConnectedConnector = { connectorType: ConnectorType; chainId: number \| string; address?: string };\n\n/\n Helper utilities for managing the last connected wallet state\n \n @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedConnector' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const lastConnectedConnectorHelpers = {\n // Key used for localStorage\n STORAGE_KEY: 'orbit-core:lastConnectedConnector',\n\n /\n The value of the last connected wallet, initialized when the module loads.\n * Returns undefined if not set, invalid, or in an SSR context.\n /\n lastConnectedConnector: getParsedStorageItem<LastConnectedConnector>('orbit-core:lastConnectedConnector'),\n\n /\n Stores the last connected wallet data in localStorage.\n \n @param data - Object containing the wallet type and chain ID.\n * @returns undefined in SSR context, void in browser\n /\n setLastConnectedConnector: ({ connectorType, chainId, address }: LastConnectedConnector) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem(\n lastConnectedConnectorHelpers.STORAGE_KEY,\n JSON.stringify({ connectorType, chainId, address }),\n )\n : undefined,\n\n /\n Retrieves the current last connected wallet data from localStorage.\n \n @returns The LastConnectedConnector object or undefined if not set or in SSR context\n /\n getLastConnectedConnector: () =>\n getParsedStorageItem<LastConnectedConnector>(lastConnectedConnectorHelpers.STORAGE_KEY),\n\n /\n Removes the last connected wallet data from localStorage.\n \n @returns undefined in SSR context, void in browser\n /\n removeLastConnectedConnector: () =>\n typeof window !== 'undefined'\n ? window.localStorage.removeItem(lastConnectedConnectorHelpers.STORAGE_KEY)\n : undefined,\n};\n","import { OrbitAdapter } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\nexport type RecentConnectedConnector = Record<OrbitAdapter, Record<string, boolean>>;\n\n/\n Helper utilities for managing the last connected connector state\n \n @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedConnector' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const recentConnectedConnectorHelpers = {\n // Key used for localStorage\n STORAGE_KEY: 'orbit-core:recentConnectedConnector',\n\n /\n The value of the last connected connector, initialized when the module loads.\n * Returns undefined if not set, invalid, or in an SSR context.\n /\n recentConnectedConnector: getParsedStorageItem<RecentConnectedConnector>('orbit-core:recentConnectedConnectors'),\n\n /\n Stores the last connected connector data in localStorage.\n \n @param connectors - RecentConnectedConnector\n * @returns undefined in SSR context, void in browser\n /\n setRecentConnectedConnector: (connectors: RecentConnectedConnector) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem(recentConnectedConnectorHelpers.STORAGE_KEY, JSON.stringify(connectors))\n : undefined,\n\n /\n Retrieves the current last connected connector data from localStorage.\n \n @returns The LastConnectedConnector object or undefined if not set or in SSR context\n /\n getRecentConnectedConnector: () =>\n getParsedStorageItem<RecentConnectedConnector>(recentConnectedConnectorHelpers.STORAGE_KEY),\n\n /\n Removes the last connected connector data from localStorage.\n \n @returns undefined in SSR context, void in browser\n /\n removeRecentConnectedConnector: () =>\n typeof window !== 'undefined'\n ? window.localStorage.removeItem(recentConnectedConnectorHelpers.STORAGE_KEY)\n : undefined,\n};\n","/\n @file\n * This module provides adapter selection functionality for the Orbit system.\n * Part of the core infrastructure for managing blockchain adapters.\n /\n\nimport { OrbitAdapter, OrbitGenericAdapter } from '../types';\n\n/\n Selects an appropriate adapter based on the provided key from either a single adapter\n * or an array of adapters.\n \n @typeParam A - Type extending basic adapter interface with a key property\n \n @param options - Selection configuration object\n * @param options.adapterKey - Target adapter key to search for\n * @param options.adapter - Single adapter or array of adapters to search within\n \n @returns Selected adapter or undefined if no suitable adapter found\n \n @remarks\n * If an array is provided but no matching adapter is found, falls back to the first adapter\n * in the array with a warning message.\n \n @example\n * ```typescript\n * // Single adapter usage\n * const singleResult = selectAdapterByKey({\n * adapterKey: OrbitAdapter.SOLANA,\n * adapter: { key: OrbitAdapter.SOLANA, connect: async () => {...} }\n * });\n \n // Multiple adapters usage\n * const multiResult = selectAdapterByKey({\n * adapterKey: OrbitAdapter.EVM,\n * adapter: [\n * { key: OrbitAdapter.SOLANA, connect: async () => {...} },\n * { key: OrbitAdapter.EVM, connect: async () => {...} }\n * ]\n * });\n * ```\n \n @throws {Error} Logs error if adapter array is empty\n * @throws {Warning} Logs warning if requested adapter key not found in array\n /\nexport const selectAdapterByKey = <A extends { key: OrbitAdapter }>({\n adapterKey,\n adapter,\n}: { adapterKey: OrbitAdapter } & OrbitGenericAdapter<A>): A \| undefined => {\n if (Array.isArray(adapter)) {\n if (adapter.length === 0) {\n console.error('Adapter selection failed: The provided adapters array is empty.');\n return undefined;\n }\n\n const foundAdapter = adapter.find((a) => a.key === adapterKey);\n\n if (foundAdapter) {\n return foundAdapter;\n } else {\n console.warn(\n `No adapter found for key: \"${adapterKey}\". Falling back to the first available adapter: \"${adapter[0].key}\".`,\n );\n return adapter[0];\n }\n }\n return adapter;\n};\n","export async function waitFor(\n predicate: () => boolean \| undefined,\n maxChecks: number = 50,\n checkIntervalMs: number = 200,\n) {\n for (let i = 0; i < maxChecks; i++) {\n if (predicate()) {\n return;\n }\n await new Promise((resolve) => setTimeout(resolve, checkIntervalMs));\n }\n throw new Error('Predicate not fulfilled in time');\n}\n","/\n Checks whether the given chain ID belongs to a Solana network.\n * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.\n \n @param {number \| string} chainId - The chain ID or chain name.\n * @returns {boolean} - True if the chain ID corresponds to a Solana network, false otherwise.\n /\nexport function isSolanaChain(chainId: number \| string): boolean {\n if (typeof chainId === 'string') {\n return ['devnet', 'testnet', 'mainnet-beta', 'mainnet'].includes(chainId);\n }\n return false;\n}\n\n/\n Sets the chain ID to a Solana-specific format if the chain is a Solana network.\n \n @param {number \| string} chainId - The original chain ID or name.\n * @returns {string \| number} - The formatted chain ID prefixed with 'solana:' if Solana, otherwise the original.\n */\nexport function setChainId(chainId: number \| string): string \| number {\n if (isSolanaChain(chainId)) {\n return `solana:${chainId}`;\n } else {\n return chainId;\n }\n}\n"]}

package/dist/index.mjs CHANGED Viewed

@@ -1,2 +1,2 @@
-var d=(n=>(n.EVM="evm",n.SOLANA="solana",n.Starknet="starknet",n))(d||{});var c=(e,t)=>new Promise(r=>{let n=()=>{setTimeout(()=>r(e),t);};typeof window<"u"?n():setTimeout(n,0);});function u(e,t){let r=new Set;return e.filter(n=>{let a=n[t];return r.has(a)?false:(r.add(a),true)})}function g(e,t){return typeof e=="string"?`${t}:${e}`:e}var s=new Map([["Impersonated Connector","impersonatedwallet"],["Safe","safewallet"],["Trust","trustwallet"],["Trust Wallet","trustwallet"],["Brave \u041A\u043E\u0448\u0435\u043B\u0435\u043A","bravewallet"],["Brave Wallet","bravewallet"],["Base Account","coinbasewallet"]]),A=e=>s.get(e)??e.replace(/\s+/g,"").toLowerCase();function W(e){return e?.split(":")[0]??"evm"}function o(e){if(typeof window>"u")return;let t=window.localStorage.getItem(e);if(t)try{return JSON.parse(t)}catch(r){console.error(`Error parsing ${e} from localStorage:`,r);return}}function O(e,t){return `${e}:${t.replace(/\s+/g,"").toLowerCase()}`}var R={impersonatedAddress:typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress")??"":"",setImpersonated:e=>typeof window<"u"?window.localStorage.setItem("satellite-connect:impersonatedAddress",e):void 0,getImpersonated:()=>typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress"):void 0,removeImpersonated:()=>typeof window<"u"?window.localStorage.removeItem("satellite-connect:impersonatedAddress"):void 0};var v=typeof window<"u"&&window!==window.parent;var i={STORAGE_KEY:"orbit-core:lastConnectedWallet",lastConnectedWallet:o("orbit-core:lastConnectedWallet"),setLastConnectedWallet:({walletType:e,chainId:t,address:r})=>typeof window<"u"?window.localStorage.setItem(i.STORAGE_KEY,JSON.stringify({walletType:e,chainId:t,address:r})):void 0,getLastConnectedWallet:()=>o(i.STORAGE_KEY),removeLastConnectedWallet:()=>typeof window<"u"?window.localStorage.removeItem(i.STORAGE_KEY):void 0};var l={STORAGE_KEY:"orbit-core:recentConnectedWallet",recentConnectedWallet:o("orbit-core:recentConnectedWallets"),setRecentConnectedWallet:e=>typeof window<"u"?window.localStorage.setItem(l.STORAGE_KEY,JSON.stringify(e)):void 0,getRecentConnectedWallet:()=>o(l.STORAGE_KEY),removeRecentConnectedWallet:()=>typeof window<"u"?window.localStorage.removeItem(l.STORAGE_KEY):void 0};var $=({adapterKey:e,adapter:t})=>{if(Array.isArray(t)){if(t.length===0){console.error("Adapter selection failed: The provided adapters array is empty.");return}let r=t.find(n=>n.key===e);return r||(console.warn(`No adapter found for key: "${e}". Falling back to the first available adapter: "${t[0].key}".`),t[0])}return t};async function N(e,t=50,r=200){for(let n=0;n<t;n++){if(e())return;await new Promise(a=>setTimeout(a,r));}throw new Error("Predicate not fulfilled in time")}function p(e){return typeof e=="string"?["devnet","testnet","mainnet-beta","mainnet"].includes(e):false}function h(e){return p(e)?`solana:${e}`:e}export{d as OrbitAdapter,c as delay,u as filterUniqueByKey,g as formatWalletChainId,A as formatWalletName,W as getAdapterFromWalletType,o as getParsedStorageItem,O as getWalletTypeFromConnectorName,R as impersonatedHelpers,v as isSafeApp,p as isSolanaChain,i as lastConnectedWalletHelpers,l as recentConnectedWalletHelpers,$ as selectAdapterByKey,h as setChainId,N as waitFor};//# sourceMappingURL=index.mjs.map
+var a=(r=>(r.EVM="evm",r.SOLANA="solana",r.Starknet="starknet",r))(a||{});var l=(e,t)=>new Promise(n=>{let r=()=>{setTimeout(()=>n(e),t);};typeof window<"u"?r():setTimeout(r,0);});function u(e,t){let n=new Set;return e.filter(r=>{let i=r[t];return n.has(i)?false:(n.add(i),true)})}function C(e,t){return typeof e=="string"?`${t}:${e}`:e}var c=new Map([["Impersonated Connector","impersonatedwallet"],["Safe","safewallet"],["Trust","trustwallet"],["Trust Wallet","trustwallet"],["Brave \u041A\u043E\u0448\u0435\u043B\u0435\u043A","bravewallet"],["Brave Wallet","bravewallet"],["Base Account","coinbasewallet"]]),y=e=>c.get(e)??e.replace(/\s+/g,"").toLowerCase();function T(e){return e?.split(":")[0]??"evm"}function O(e,t){return `${e}:${t.replace(/\s+/g,"").toLowerCase()}`}function o(e){if(typeof window>"u")return;let t=window.localStorage.getItem(e);if(t)try{return JSON.parse(t)}catch(n){console.error(`Error parsing ${e} from localStorage:`,n);return}}var I={impersonatedAddress:typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress")??"":"",setImpersonated:e=>typeof window<"u"?window.localStorage.setItem("satellite-connect:impersonatedAddress",e):void 0,getImpersonated:()=>typeof window<"u"?window.localStorage.getItem("satellite-connect:impersonatedAddress"):void 0,removeImpersonated:()=>typeof window<"u"?window.localStorage.removeItem("satellite-connect:impersonatedAddress"):void 0};var G=typeof window<"u"&&window!==window.parent;var d={STORAGE_KEY:"orbit-core:lastConnectedConnector",lastConnectedConnector:o("orbit-core:lastConnectedConnector"),setLastConnectedConnector:({connectorType:e,chainId:t,address:n})=>typeof window<"u"?window.localStorage.setItem(d.STORAGE_KEY,JSON.stringify({connectorType:e,chainId:t,address:n})):void 0,getLastConnectedConnector:()=>o(d.STORAGE_KEY),removeLastConnectedConnector:()=>typeof window<"u"?window.localStorage.removeItem(d.STORAGE_KEY):void 0};var s={STORAGE_KEY:"orbit-core:recentConnectedConnector",recentConnectedConnector:o("orbit-core:recentConnectedConnectors"),setRecentConnectedConnector:e=>typeof window<"u"?window.localStorage.setItem(s.STORAGE_KEY,JSON.stringify(e)):void 0,getRecentConnectedConnector:()=>o(s.STORAGE_KEY),removeRecentConnectedConnector:()=>typeof window<"u"?window.localStorage.removeItem(s.STORAGE_KEY):void 0};var $=({adapterKey:e,adapter:t})=>{if(Array.isArray(t)){if(t.length===0){console.error("Adapter selection failed: The provided adapters array is empty.");return}let n=t.find(r=>r.key===e);return n||(console.warn(`No adapter found for key: "${e}". Falling back to the first available adapter: "${t[0].key}".`),t[0])}return t};async function Y(e,t=50,n=200){for(let r=0;r<t;r++){if(e())return;await new Promise(i=>setTimeout(i,n));}throw new Error("Predicate not fulfilled in time")}function p(e){return typeof e=="string"?["devnet","testnet","mainnet-beta","mainnet"].includes(e):false}function B(e){return p(e)?`solana:${e}`:e}export{a as OrbitAdapter,l as delay,u as filterUniqueByKey,C as formatConnectorChainId,y as formatConnectorName,T as getAdapterFromConnectorType,O as getConnectorTypeFromName,o as getParsedStorageItem,I as impersonatedHelpers,G as isSafeApp,p as isSolanaChain,d as lastConnectedConnectorHelpers,s as recentConnectedConnectorHelpers,$ as selectAdapterByKey,B as setChainId,Y as waitFor};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/types.ts","../src/utils/delay.ts","../src/utils/filterUniqueByKey.ts","../src/utils/formatWalletChainId.ts","../src/utils/formatWalletName.ts","../src/utils/getAdapterFromWalletType.ts","../src/utils/getParsedStorageItem.ts","../src/utils/getWalletTypeFromConnectorName.ts","../src/utils/impersonatedHelpers.ts","../src/utils/isSafeApp.ts","../src/utils/lastConnectedWalletHelpers.ts","../src/utils/recentConnectedWalletHelpers.ts","../src/utils/selectAdapterByKey.ts","../src/utils/waitFor.ts","../src/utils/%D1%81hainHelpers.ts"],"names":["OrbitAdapter","delay","value","ms","resolve","runTimeout","filterUniqueByKey","array","key","seenValues","item","keyValue","formatWalletChainId","chainId","connectedAdapter","WALLET_MAPPINGS","formatWalletName","walletName","getAdapterFromWalletType","walletType","getParsedStorageItem","error","getWalletTypeFromConnectorName","adapter","name","impersonatedHelpers","address","isSafeApp","lastConnectedWalletHelpers","recentConnectedWalletHelpers","wallets","selectAdapterByKey","adapterKey","foundAdapter","a","waitFor","predicate","maxChecks","checkIntervalMs","i","isSolanaChain","setChainId"],"mappings":"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","file":"index.mjs","sourcesContent":["/*\n @file\n * Core type definitions for the Orbit blockchain adapter system.\n * This file contains fundamental enums and types that define the supported blockchain architectures\n * and their adapter interfaces.\n /\n\n// =================================================================================================\n// 1. ENUMS AND CORE TRANSACTION TYPES\n// =================================================================================================\n\n/\n Defines the supported blockchain adapters in the Orbit system.\n * Each adapter corresponds to a specific blockchain architecture and implements\n * the necessary interfaces for that chain's functionality.\n \n @enum {string}\n \n @example\n * ```typescript\n * // Using adapter types in configuration\n * const config = {\n * chainType: OrbitAdapter.EVM,\n * // other configuration...\n * };\n \n // Checking adapter compatibility\n * if (chainType === OrbitAdapter.SOLANA) {\n * // Solana-specific logic\n * }\n * ```\n /\nexport enum OrbitAdapter {\n /\n For Ethereum Virtual Machine (EVM) compatible chains.\n * Supports networks like:\n * - Ethereum Mainnet\n * - Polygon\n * - Binance Smart Chain\n * - Avalanche\n * - Other EVM-compatible L1/L2 chains\n /\n EVM = 'evm',\n\n /\n For the Solana blockchain.\n * Supports:\n * - Solana Mainnet\n * - Devnet\n * - Testnet\n /\n SOLANA = 'solana',\n\n /\n For the Starknet L2 network.\n * Supports:\n * - Starknet Mainnet\n * - Testnet (Goerli)\n * - Other Starknet deployments\n /\n Starknet = 'starknet',\n}\n\n/\n Generic type for creating blockchain adapters with type safety.\n * This type ensures that all adapters implement the required interface\n * and are properly keyed by their blockchain type.\n \n @typeParam A - Type that extends the base adapter interface with a key property\n \n @property {A \| A[]} adapter - Single adapter instance or array of adapters\n \n @example\n * ```typescript\n * // Single adapter implementation\n * interface EVMAdapter extends BaseAdapter {\n * key: OrbitAdapter.EVM;\n * // EVM-specific methods...\n * }\n * const evmConfig: OrbitGenericAdapter<EVMAdapter> = {\n * adapter: {\n * key: OrbitAdapter.EVM,\n * // implementation...\n * }\n * };\n \n // Multiple adapters\n * const multiChainConfig: OrbitGenericAdapter<EVMAdapter> = {\n * adapter: [\n * { key: OrbitAdapter.EVM, ... },\n * { key: OrbitAdapter.SOLANA, ... }\n * ]\n * };\n * ```\n /\nexport type OrbitGenericAdapter<A extends { key: OrbitAdapter }> = {\n adapter: A \| A[];\n};\n\nexport type BaseAdapter = {\n /\n Generates blockchain explorer URL\n * @returns Explorer URL or undefined if not available\n /\n getExplorerUrl: (url?: string, chainId?: string \| number) => string \| undefined;\n\n /* Optional method to resolve ENS-like names /\n getName?: (address: string) => Promise<string \| null>;\n\n /* Optional method to get avatar for resolved names /\n getAvatar?: (name: string) => Promise<string \| null>;\n};\n\n/\n Type representing a wallet identifier in format \"OrbitAdapter:wallet\"\n * @example \"evm:metamask\" \| \"solana:phantom\"\n /\nexport type WalletType = `${OrbitAdapter}:${string}`;\n","/\n @name delay\n \n Ensures the global 'window' object is available (if running in a browser-like environment),\n * then pauses execution for a specified duration, and finally resolves the Promise with the given value.\n \n This utility function is designed to be safe for use in Server-Side Rendering (SSR) environments.\n * It asynchronously waits for the 'window' object to be defined before starting the actual timer,\n * helping to prevent errors during the initial server render while still providing a time delay on the client.\n \n @template T - The type of the value being resolved.\n \n @param {T} value - The value to resolve the Promise with after the delay.\n * @param {number} ms - The number of milliseconds (delay) to wait before resolving the Promise after 'window' is available.\n \n @returns {Promise<T>} A Promise that resolves with the provided `value` after both the 'window' check and the delay (`ms`) are complete.\n \n @example\n * ```typescript\n * // Use this in an environment where 'window' might not be immediately available (e.g., Next.js component).\n * async function waitForWindowAndDelay() {\n * console.log(\"Start wait...\");\n * // This will wait for window, and then wait 100ms.\n * const data = await delay(\"Ready to connect\", 100);\n * console.log(data);\n * }\n * waitForWindowAndDelay();\n * ```\n /\nexport const delay = <T>(value: T, ms: number): Promise<T> => {\n return new Promise((resolve) => {\n const runTimeout = () => {\n setTimeout(() => resolve(value), ms);\n };\n\n if (typeof window !== 'undefined') {\n runTimeout();\n } else {\n setTimeout(runTimeout, 0);\n }\n });\n};\n","/\n Filters an array of objects to keep only the first occurrence of an object\n * based on a unique value of a specified key.\n \n This function is generic and type-safe. It iterates through the array and uses a\n * Set to track already encountered key values, effectively removing duplicates.\n \n @template T The type of the objects in the array.\n * @param {T[]} array - The array of objects to be filtered.\n * @param {keyof T} key - The object key (property name) whose values must be unique.\n * @returns {T[]} The filtered array containing only objects with unique key values.\n /\nexport function filterUniqueByKey<T>(array: T[], key: keyof T): T[] {\n // 1. Create a Set to store the unique values of the key encountered so far.\n // Set is a collection of unique values, which is perfect for fast duplicate checks.\n const seenValues = new Set<T[keyof T]>();\n\n // 2. Use the native Array.prototype.filter() method to create a new, filtered array.\n return array.filter((item) => {\n // Access the value of the specified key from the current object.\n const keyValue = item[key];\n\n // 3. Check if this key value has been seen before.\n if (seenValues.has(keyValue)) {\n // If the value is already in the Set, return false.\n // This object is a duplicate and will be excluded from the result.\n return false;\n } else {\n // If the value is encountered for the first time, add it to the Set.\n seenValues.add(keyValue);\n // Return true to include the object in the resulting unique array.\n return true;\n }\n });\n}\n","import { OrbitAdapter } from '../types';\n\nexport function formatWalletChainId(chainId: string \| number, connectedAdapter: OrbitAdapter) {\n if (typeof chainId === 'string') {\n return `${connectedAdapter}:${chainId}`;\n } else {\n return chainId;\n }\n}\n","const WALLET_MAPPINGS = new Map([\n ['Impersonated Connector', 'impersonatedwallet'],\n ['Safe', 'safewallet'],\n ['Trust', 'trustwallet'],\n ['Trust Wallet', 'trustwallet'],\n ['Brave Кошелек', 'bravewallet'],\n ['Brave Wallet', 'bravewallet'],\n ['Base Account', 'coinbasewallet'], // TODO: need fix\n]);\n\nexport const formatWalletName = (walletName: string): string => {\n return WALLET_MAPPINGS.get(walletName) ?? walletName.replace(/\\s+/g, '').toLowerCase();\n};\n","import { OrbitAdapter, WalletType } from '../types';\n\n/\n Extracts the adapter type from a wallet type string\n \n @example\n * ```typescript\n * // Returns OrbitAdapter.EVM\n * getAdapterFromWalletType('evm:metamask');\n \n // Returns OrbitAdapter.SOLANA\n * getAdapterFromWalletType('solana:phantom');\n \n // Returns OrbitAdapter.EVM (default)\n * getAdapterFromWalletType('unknown');\n * ```\n \n @param walletType - Wallet type in format \"chain:wallet\" (e.g. \"evm:metamask\", \"solana:phantom\")\n * @returns The corresponding {@link OrbitAdapter} type or EVM as default\n \n @remarks\n * The function splits the wallet type string by \":\" and takes the first part as the adapter type.\n * If the split fails or the first part is empty, it defaults to EVM adapter.\n /\nexport function getAdapterFromWalletType(walletType: WalletType): OrbitAdapter {\n return (walletType?.split(':')[0] as OrbitAdapter.EVM) ?? OrbitAdapter.EVM;\n}\n","/\n Internal function for safely retrieving and parsing data from localStorage.\n \n @param key - The key for localStorage\n * @returns The parsed LastConnectedWallet object or undefined if data is not found/invalid\n /\nexport function getParsedStorageItem<ReturnType>(key: string): ReturnType \| undefined {\n if (typeof window === 'undefined') {\n return undefined;\n }\n\n const item = window.localStorage.getItem(key);\n\n // If the item is null (not set) or an empty string, return undefined\n if (!item) {\n return undefined;\n }\n\n try {\n // Safe JSON parsing\n return JSON.parse(item) as ReturnType;\n } catch (error) {\n // In case of a parsing error (e.g., invalid JSON), log the error and return undefined\n console.error(`Error parsing ${key} from localStorage:`, error);\n return undefined;\n }\n}\n","import { OrbitAdapter } from '../types';\n\n/\n Generates a standardized wallet type identifier from adapter type and connector name\n \n @example\n * ```typescript\n * // Returns \"evm:metamask\"\n * getWalletTypeFromConnectorName(OrbitAdapter.EVM, \"MetaMask\");\n \n // Returns \"solana:phantom\"\n * getWalletTypeFromConnectorName(OrbitAdapter.SOLANA, \"Phantom\");\n \n // Returns \"evm:coinbasewallet\" (removes spaces)\n * getWalletTypeFromConnectorName(OrbitAdapter.EVM, \"Coinbase Wallet\");\n * ```\n \n @param adapter - The blockchain adapter type (e.g. EVM, SOLANA)\n * @param name - The wallet connector name (e.g. \"MetaMask\", \"Phantom\")\n * @returns A formatted wallet type string in format \"chain:wallet\"\n \n @remarks\n * The function:\n * 1. Combines adapter type with connector name using \":\" as separator\n * 2. Removes all whitespace from connector name\n * 3. Converts connector name to lowercase\n * This ensures consistent wallet type identifiers across the application\n /\nexport function getWalletTypeFromConnectorName(adapter: OrbitAdapter, name: string): string {\n return `${adapter}:${name.replace(/\\s+/g, '').toLowerCase()}`;\n}\n","/\n Helper utilities for managing impersonated wallet addresses\n \n @remarks\n * These utilities are primarily used for development and testing purposes.\n * They provide a way to simulate different wallet addresses without actually connecting a wallet.\n * All data is stored in localStorage with the 'satellite-connect:impersonatedAddress' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const impersonatedHelpers = {\n /\n Currently impersonated address from localStorage\n * Returns empty string if not set or in SSR context\n /\n impersonatedAddress:\n typeof window !== 'undefined' ? (window.localStorage.getItem('satellite-connect:impersonatedAddress') ?? '') : '',\n\n /\n Stores an impersonated address in localStorage\n \n @example\n * ```typescript\n * // Set impersonated address\n * impersonatedHelpers.setImpersonated('0x1234...5678');\n * ```\n \n @param address - Ethereum or Solana address to impersonate\n * @returns undefined in SSR context, void in browser\n /\n setImpersonated: (address: string) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem('satellite-connect:impersonatedAddress', address)\n : undefined,\n\n /\n Retrieves the current impersonated address from localStorage\n \n @example\n * ```typescript\n * // Get current impersonated address\n * const address = impersonatedHelpers.getImpersonated();\n * if (address) {\n * console.log('Currently impersonating:', address);\n * }\n * ```\n * @returns The impersonated address or undefined if not set or in SSR context\n /\n getImpersonated: () =>\n typeof window !== 'undefined' ? window.localStorage.getItem('satellite-connect:impersonatedAddress') : undefined,\n\n removeImpersonated: () =>\n typeof window !== 'undefined' ? window.localStorage.removeItem('satellite-connect:impersonatedAddress') : undefined,\n};\n","export const isSafeApp = typeof window !== 'undefined' && window !== window.parent;\n","import { WalletType } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\ntype LastConnectedWallet = { walletType: WalletType; chainId: number \| string; address?: string };\n\n/\n Helper utilities for managing the last connected wallet state\n \n @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const lastConnectedWalletHelpers = {\n // Key used for localStorage\n STORAGE_KEY: 'orbit-core:lastConnectedWallet',\n\n /\n The value of the last connected wallet, initialized when the module loads.\n * Returns undefined if not set, invalid, or in an SSR context.\n /\n lastConnectedWallet: getParsedStorageItem<LastConnectedWallet>('orbit-core:lastConnectedWallet'),\n\n /\n Stores the last connected wallet data in localStorage.\n \n @param data - Object containing the wallet type and chain ID.\n * @returns undefined in SSR context, void in browser\n /\n setLastConnectedWallet: ({ walletType, chainId, address }: LastConnectedWallet) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem(\n lastConnectedWalletHelpers.STORAGE_KEY,\n JSON.stringify({ walletType, chainId, address }),\n )\n : undefined,\n\n /\n Retrieves the current last connected wallet data from localStorage.\n \n @returns The LastConnectedWallet object or undefined if not set or in SSR context\n /\n getLastConnectedWallet: () => getParsedStorageItem<LastConnectedWallet>(lastConnectedWalletHelpers.STORAGE_KEY),\n\n /\n Removes the last connected wallet data from localStorage.\n \n @returns undefined in SSR context, void in browser\n /\n removeLastConnectedWallet: () =>\n typeof window !== 'undefined' ? window.localStorage.removeItem(lastConnectedWalletHelpers.STORAGE_KEY) : undefined,\n};\n","import { OrbitAdapter } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\nexport type RecentConnectedWallet = Record<OrbitAdapter, Record<string, boolean>>;\n\n/\n Helper utilities for managing the last connected wallet state\n \n @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedWallet' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const recentConnectedWalletHelpers = {\n // Key used for localStorage\n STORAGE_KEY: 'orbit-core:recentConnectedWallet',\n\n /\n The value of the last connected wallet, initialized when the module loads.\n * Returns undefined if not set, invalid, or in an SSR context.\n /\n recentConnectedWallet: getParsedStorageItem<RecentConnectedWallet>('orbit-core:recentConnectedWallets'),\n\n /\n Stores the last connected wallet data in localStorage.\n \n @param wallets - RecentConnectedWallet\n * @returns undefined in SSR context, void in browser\n /\n setRecentConnectedWallet: (wallets: RecentConnectedWallet) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem(recentConnectedWalletHelpers.STORAGE_KEY, JSON.stringify(wallets))\n : undefined,\n\n /\n Retrieves the current last connected wallet data from localStorage.\n \n @returns The LastConnectedWallet object or undefined if not set or in SSR context\n /\n getRecentConnectedWallet: () => getParsedStorageItem<RecentConnectedWallet>(recentConnectedWalletHelpers.STORAGE_KEY),\n\n /\n Removes the last connected wallet data from localStorage.\n \n @returns undefined in SSR context, void in browser\n /\n removeRecentConnectedWallet: () =>\n typeof window !== 'undefined'\n ? window.localStorage.removeItem(recentConnectedWalletHelpers.STORAGE_KEY)\n : undefined,\n};\n","/\n @file\n * This module provides adapter selection functionality for the Orbit system.\n * Part of the core infrastructure for managing blockchain adapters.\n /\n\nimport { OrbitAdapter, OrbitGenericAdapter } from '../types';\n\n/\n Selects an appropriate adapter based on the provided key from either a single adapter\n * or an array of adapters.\n \n @typeParam A - Type extending basic adapter interface with a key property\n \n @param options - Selection configuration object\n * @param options.adapterKey - Target adapter key to search for\n * @param options.adapter - Single adapter or array of adapters to search within\n \n @returns Selected adapter or undefined if no suitable adapter found\n \n @remarks\n * If an array is provided but no matching adapter is found, falls back to the first adapter\n * in the array with a warning message.\n \n @example\n * ```typescript\n * // Single adapter usage\n * const singleResult = selectAdapterByKey({\n * adapterKey: OrbitAdapter.SOLANA,\n * adapter: { key: OrbitAdapter.SOLANA, connect: async () => {...} }\n * });\n \n // Multiple adapters usage\n * const multiResult = selectAdapterByKey({\n * adapterKey: OrbitAdapter.EVM,\n * adapter: [\n * { key: OrbitAdapter.SOLANA, connect: async () => {...} },\n * { key: OrbitAdapter.EVM, connect: async () => {...} }\n * ]\n * });\n * ```\n \n @throws {Error} Logs error if adapter array is empty\n * @throws {Warning} Logs warning if requested adapter key not found in array\n /\nexport const selectAdapterByKey = <A extends { key: OrbitAdapter }>({\n adapterKey,\n adapter,\n}: { adapterKey: OrbitAdapter } & OrbitGenericAdapter<A>): A \| undefined => {\n if (Array.isArray(adapter)) {\n if (adapter.length === 0) {\n console.error('Adapter selection failed: The provided adapters array is empty.');\n return undefined;\n }\n\n const foundAdapter = adapter.find((a) => a.key === adapterKey);\n\n if (foundAdapter) {\n return foundAdapter;\n } else {\n console.warn(\n `No adapter found for key: \"${adapterKey}\". Falling back to the first available adapter: \"${adapter[0].key}\".`,\n );\n return adapter[0];\n }\n }\n return adapter;\n};\n","export async function waitFor(\n predicate: () => boolean \| undefined,\n maxChecks: number = 50,\n checkIntervalMs: number = 200,\n) {\n for (let i = 0; i < maxChecks; i++) {\n if (predicate()) {\n return;\n }\n await new Promise((resolve) => setTimeout(resolve, checkIntervalMs));\n }\n throw new Error('Predicate not fulfilled in time');\n}\n","/\n Checks whether the given chain ID belongs to a Solana network.\n * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.\n \n @param {number \| string} chainId - The chain ID or chain name.\n * @returns {boolean} - True if the chain ID corresponds to a Solana network, false otherwise.\n /\nexport function isSolanaChain(chainId: number \| string): boolean {\n if (typeof chainId === 'string') {\n return ['devnet', 'testnet', 'mainnet-beta', 'mainnet'].includes(chainId);\n }\n return false;\n}\n\n/\n Sets the chain ID to a Solana-specific format if the chain is a Solana network.\n \n @param {number \| string} chainId - The original chain ID or name.\n * @returns {string \| number} - The formatted chain ID prefixed with 'solana:' if Solana, otherwise the original.\n */\nexport function setChainId(chainId: number \| string): string \| number {\n if (isSolanaChain(chainId)) {\n return `solana:${chainId}`;\n } else {\n return chainId;\n }\n}\n"]}
1	+ {"version":3,"sources":["../src/types.ts","../src/utils/delay.ts","../src/utils/filterUniqueByKey.ts","../src/utils/formatConnectorChainId.ts","../src/utils/formatConnectorName.ts","../src/utils/getAdapterFromConnectorType.ts","../src/utils/getConnectorTypeFromName.ts","../src/utils/getParsedStorageItem.ts","../src/utils/impersonatedHelpers.ts","../src/utils/isSafeApp.ts","../src/utils/lastConnectedConnectorHelpers.ts","../src/utils/recentConnectedConnectorHelpers.ts","../src/utils/selectAdapterByKey.ts","../src/utils/waitFor.ts","../src/utils/%D1%81hainHelpers.ts"],"names":["OrbitAdapter","delay","value","ms","resolve","runTimeout","filterUniqueByKey","array","key","seenValues","item","keyValue","formatConnectorChainId","chainId","connectedAdapter","CONNECTOR_MAPPINGS","formatConnectorName","connectorName","getAdapterFromConnectorType","connectorType","getConnectorTypeFromName","adapter","name","getParsedStorageItem","error","impersonatedHelpers","address","isSafeApp","lastConnectedConnectorHelpers","recentConnectedConnectorHelpers","connectors","selectAdapterByKey","adapterKey","foundAdapter","a","waitFor","predicate","maxChecks","checkIntervalMs","i","isSolanaChain","setChainId"],"mappings":"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","file":"index.mjs","sourcesContent":["/*\n @file\n * Core type definitions for the Orbit blockchain adapter system.\n * This file contains fundamental enums and types that define the supported blockchain architectures\n * and their adapter interfaces.\n /\n\n// =================================================================================================\n// 1. ENUMS AND CORE TRANSACTION TYPES\n// =================================================================================================\n\n/\n Defines the supported blockchain adapters in the Orbit system.\n * Each adapter corresponds to a specific blockchain architecture and implements\n * the necessary interfaces for that chain's functionality.\n \n @enum {string}\n \n @example\n * ```typescript\n * // Using adapter types in configuration\n * const config = {\n * chainType: OrbitAdapter.EVM,\n * // other configuration...\n * };\n \n // Checking adapter compatibility\n * if (chainType === OrbitAdapter.SOLANA) {\n * // Solana-specific logic\n * }\n * ```\n /\nexport enum OrbitAdapter {\n /\n For Ethereum Virtual Machine (EVM) compatible chains.\n * Supports networks like:\n * - Ethereum Mainnet\n * - Polygon\n * - Binance Smart Chain\n * - Avalanche\n * - Other EVM-compatible L1/L2 chains\n /\n EVM = 'evm',\n\n /\n For the Solana blockchain.\n * Supports:\n * - Solana Mainnet\n * - Devnet\n * - Testnet\n /\n SOLANA = 'solana',\n\n /\n For the Starknet L2 network.\n * Supports:\n * - Starknet Mainnet\n * - Testnet (Goerli)\n * - Other Starknet deployments\n /\n Starknet = 'starknet',\n}\n\n/\n Generic type for creating blockchain adapters with type safety.\n * This type ensures that all adapters implement the required interface\n * and are properly keyed by their blockchain type.\n \n @typeParam A - Type that extends the base adapter interface with a key property\n \n @property {A \| A[]} adapter - Single adapter instance or array of adapters\n \n @example\n * ```typescript\n * // Single adapter implementation\n * interface EVMAdapter extends BaseAdapter {\n * key: OrbitAdapter.EVM;\n * // EVM-specific methods...\n * }\n * const evmConfig: OrbitGenericAdapter<EVMAdapter> = {\n * adapter: {\n * key: OrbitAdapter.EVM,\n * // implementation...\n * }\n * };\n \n // Multiple adapters\n * const multiChainConfig: OrbitGenericAdapter<EVMAdapter> = {\n * adapter: [\n * { key: OrbitAdapter.EVM, ... },\n * { key: OrbitAdapter.SOLANA, ... }\n * ]\n * };\n * ```\n /\nexport type OrbitGenericAdapter<A extends { key: OrbitAdapter }> = {\n adapter: A \| A[];\n};\n\nexport type BaseAdapter = {\n /\n Generates blockchain explorer URL\n * @returns Explorer URL or undefined if not available\n /\n getExplorerUrl: (url?: string, chainId?: string \| number) => string \| undefined;\n\n /* Optional method to resolve ENS-like names /\n getName?: (address: string) => Promise<string \| null>;\n\n /* Optional method to get avatar for resolved names /\n getAvatar?: (name: string) => Promise<string \| null>;\n};\n\n/\n Type representing a connector identifier in format \"OrbitAdapter:connector\"\n * @example \"evm:metamask\" \| \"solana:phantom\"\n /\nexport type ConnectorType = `${OrbitAdapter}:${string}`;\n","/\n @name delay\n \n Ensures the global 'window' object is available (if running in a browser-like environment),\n * then pauses execution for a specified duration, and finally resolves the Promise with the given value.\n \n This utility function is designed to be safe for use in Server-Side Rendering (SSR) environments.\n * It asynchronously waits for the 'window' object to be defined before starting the actual timer,\n * helping to prevent errors during the initial server render while still providing a time delay on the client.\n \n @template T - The type of the value being resolved.\n \n @param {T} value - The value to resolve the Promise with after the delay.\n * @param {number} ms - The number of milliseconds (delay) to wait before resolving the Promise after 'window' is available.\n \n @returns {Promise<T>} A Promise that resolves with the provided `value` after both the 'window' check and the delay (`ms`) are complete.\n \n @example\n * ```typescript\n * // Use this in an environment where 'window' might not be immediately available (e.g., Next.js component).\n * async function waitForWindowAndDelay() {\n * console.log(\"Start wait...\");\n * // This will wait for window, and then wait 100ms.\n * const data = await delay(\"Ready to connect\", 100);\n * console.log(data);\n * }\n * waitForWindowAndDelay();\n * ```\n /\nexport const delay = <T>(value: T, ms: number): Promise<T> => {\n return new Promise((resolve) => {\n const runTimeout = () => {\n setTimeout(() => resolve(value), ms);\n };\n\n if (typeof window !== 'undefined') {\n runTimeout();\n } else {\n setTimeout(runTimeout, 0);\n }\n });\n};\n","/\n Filters an array of objects to keep only the first occurrence of an object\n * based on a unique value of a specified key.\n \n This function is generic and type-safe. It iterates through the array and uses a\n * Set to track already encountered key values, effectively removing duplicates.\n \n @template T The type of the objects in the array.\n * @param {T[]} array - The array of objects to be filtered.\n * @param {keyof T} key - The object key (property name) whose values must be unique.\n * @returns {T[]} The filtered array containing only objects with unique key values.\n /\nexport function filterUniqueByKey<T>(array: T[], key: keyof T): T[] {\n // 1. Create a Set to store the unique values of the key encountered so far.\n // Set is a collection of unique values, which is perfect for fast duplicate checks.\n const seenValues = new Set<T[keyof T]>();\n\n // 2. Use the native Array.prototype.filter() method to create a new, filtered array.\n return array.filter((item) => {\n // Access the value of the specified key from the current object.\n const keyValue = item[key];\n\n // 3. Check if this key value has been seen before.\n if (seenValues.has(keyValue)) {\n // If the value is already in the Set, return false.\n // This object is a duplicate and will be excluded from the result.\n return false;\n } else {\n // If the value is encountered for the first time, add it to the Set.\n seenValues.add(keyValue);\n // Return true to include the object in the resulting unique array.\n return true;\n }\n });\n}\n","import { OrbitAdapter } from '../types';\n\nexport function formatConnectorChainId(chainId: string \| number, connectedAdapter: OrbitAdapter) {\n if (typeof chainId === 'string') {\n return `${connectedAdapter}:${chainId}`;\n } else {\n return chainId;\n }\n}\n","const CONNECTOR_MAPPINGS = new Map([\n ['Impersonated Connector', 'impersonatedwallet'],\n ['Safe', 'safewallet'],\n ['Trust', 'trustwallet'],\n ['Trust Wallet', 'trustwallet'],\n ['Brave Кошелек', 'bravewallet'],\n ['Brave Wallet', 'bravewallet'],\n ['Base Account', 'coinbasewallet'], // TODO: need fix\n]);\n\nexport const formatConnectorName = (connectorName: string): string => {\n return CONNECTOR_MAPPINGS.get(connectorName) ?? connectorName.replace(/\\s+/g, '').toLowerCase();\n};\n","import { ConnectorType, OrbitAdapter } from '../types';\n\n/\n Extracts the adapter type from a connector type string\n \n @example\n * ```typescript\n * // Returns OrbitAdapter.EVM\n * getAdapterFromConnectorType('evm:metamask');\n \n // Returns OrbitAdapter.SOLANA\n * getAdapterFromConnectorType('solana:phantom');\n \n // Returns OrbitAdapter.EVM (default)\n * getAdapterFromConnectorType('unknown');\n * ```\n \n @param connectorType - Connector type in format \"orbit-adapter:connector\" (e.g. \"evm:metamask\", \"solana:phantom\")\n * @returns The corresponding {@link OrbitAdapter} type or EVM as default\n \n @remarks\n * The function splits the connector type string by \":\" and takes the first part as the adapter type.\n * If the split fails or the first part is empty, it defaults to EVM adapter.\n /\nexport function getAdapterFromConnectorType(connectorType: ConnectorType): OrbitAdapter {\n return (connectorType?.split(':')[0] as OrbitAdapter.EVM) ?? OrbitAdapter.EVM;\n}\n","import { OrbitAdapter } from '../types';\n\n/\n Generates a standardized connector type identifier from adapter type and connector name\n \n @example\n * ```typescript\n * // Returns \"evm:metamask\"\n * getConnectorTypeFromName(OrbitAdapter.EVM, \"MetaMask\");\n \n // Returns \"solana:phantom\"\n * getConnectorTypeFromName(OrbitAdapter.SOLANA, \"Phantom\");\n \n // Returns \"evm:coinbasewallet\" (removes spaces)\n * getConnectorTypeFromName(OrbitAdapter.EVM, \"Coinbase Wallet\");\n * ```\n \n @param adapter - The blockchain adapter type (e.g. EVM, SOLANA)\n * @param name - The connector name (e.g. \"MetaMask\", \"Phantom\")\n * @returns A formatted connector type string in format \"orbit-adapter:connector\"\n \n @remarks\n * The function:\n * 1. Combines adapter type with connector name using \":\" as separator\n * 2. Removes all whitespace from connector name\n * 3. Converts connector name to lowercase\n * This ensures consistent connector type identifiers across the application\n * and normalizes connector names for better UX/consistency.\n /\nexport function getConnectorTypeFromName(adapter: OrbitAdapter, name: string): string {\n return `${adapter}:${name.replace(/\\s+/g, '').toLowerCase()}`;\n}\n","/\n Internal function for safely retrieving and parsing data from localStorage.\n \n @param key - The key for localStorage\n * @returns The parsed LastConnectedConnector object or undefined if data is not found/invalid\n /\nexport function getParsedStorageItem<ReturnType>(key: string): ReturnType \| undefined {\n if (typeof window === 'undefined') {\n return undefined;\n }\n\n const item = window.localStorage.getItem(key);\n\n // If the item is null (not set) or an empty string, return undefined\n if (!item) {\n return undefined;\n }\n\n try {\n // Safe JSON parsing\n return JSON.parse(item) as ReturnType;\n } catch (error) {\n // In case of a parsing error (e.g., invalid JSON), log the error and return undefined\n console.error(`Error parsing ${key} from localStorage:`, error);\n return undefined;\n }\n}\n","/\n Helper utilities for managing impersonated wallet addresses\n \n @remarks\n * These utilities are primarily used for development and testing purposes.\n * They provide a way to simulate different wallet addresses without actually connecting a wallet.\n * All data is stored in localStorage with the 'satellite-connect:impersonatedAddress' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const impersonatedHelpers = {\n /\n Currently impersonated address from localStorage\n * Returns empty string if not set or in SSR context\n /\n impersonatedAddress:\n typeof window !== 'undefined' ? (window.localStorage.getItem('satellite-connect:impersonatedAddress') ?? '') : '',\n\n /\n Stores an impersonated address in localStorage\n \n @example\n * ```typescript\n * // Set impersonated address\n * impersonatedHelpers.setImpersonated('0x1234...5678');\n * ```\n \n @param address - Ethereum or Solana address to impersonate\n * @returns undefined in SSR context, void in browser\n /\n setImpersonated: (address: string) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem('satellite-connect:impersonatedAddress', address)\n : undefined,\n\n /\n Retrieves the current impersonated address from localStorage\n \n @example\n * ```typescript\n * // Get current impersonated address\n * const address = impersonatedHelpers.getImpersonated();\n * if (address) {\n * console.log('Currently impersonating:', address);\n * }\n * ```\n * @returns The impersonated address or undefined if not set or in SSR context\n /\n getImpersonated: () =>\n typeof window !== 'undefined' ? window.localStorage.getItem('satellite-connect:impersonatedAddress') : undefined,\n\n removeImpersonated: () =>\n typeof window !== 'undefined' ? window.localStorage.removeItem('satellite-connect:impersonatedAddress') : undefined,\n};\n","export const isSafeApp = typeof window !== 'undefined' && window !== window.parent;\n","import { ConnectorType } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\ntype LastConnectedConnector = { connectorType: ConnectorType; chainId: number \| string; address?: string };\n\n/\n Helper utilities for managing the last connected wallet state\n \n @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedConnector' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const lastConnectedConnectorHelpers = {\n // Key used for localStorage\n STORAGE_KEY: 'orbit-core:lastConnectedConnector',\n\n /\n The value of the last connected wallet, initialized when the module loads.\n * Returns undefined if not set, invalid, or in an SSR context.\n /\n lastConnectedConnector: getParsedStorageItem<LastConnectedConnector>('orbit-core:lastConnectedConnector'),\n\n /\n Stores the last connected wallet data in localStorage.\n \n @param data - Object containing the wallet type and chain ID.\n * @returns undefined in SSR context, void in browser\n /\n setLastConnectedConnector: ({ connectorType, chainId, address }: LastConnectedConnector) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem(\n lastConnectedConnectorHelpers.STORAGE_KEY,\n JSON.stringify({ connectorType, chainId, address }),\n )\n : undefined,\n\n /\n Retrieves the current last connected wallet data from localStorage.\n \n @returns The LastConnectedConnector object or undefined if not set or in SSR context\n /\n getLastConnectedConnector: () =>\n getParsedStorageItem<LastConnectedConnector>(lastConnectedConnectorHelpers.STORAGE_KEY),\n\n /\n Removes the last connected wallet data from localStorage.\n \n @returns undefined in SSR context, void in browser\n /\n removeLastConnectedConnector: () =>\n typeof window !== 'undefined'\n ? window.localStorage.removeItem(lastConnectedConnectorHelpers.STORAGE_KEY)\n : undefined,\n};\n","import { OrbitAdapter } from '../types';\nimport { getParsedStorageItem } from './getParsedStorageItem';\n\nexport type RecentConnectedConnector = Record<OrbitAdapter, Record<string, boolean>>;\n\n/\n Helper utilities for managing the last connected connector state\n \n @remarks\n * All data is stored in localStorage with the 'orbit-core:lastConnectedConnector' key.\n * Functions are safe to use in both browser and SSR environments.\n /\nexport const recentConnectedConnectorHelpers = {\n // Key used for localStorage\n STORAGE_KEY: 'orbit-core:recentConnectedConnector',\n\n /\n The value of the last connected connector, initialized when the module loads.\n * Returns undefined if not set, invalid, or in an SSR context.\n /\n recentConnectedConnector: getParsedStorageItem<RecentConnectedConnector>('orbit-core:recentConnectedConnectors'),\n\n /\n Stores the last connected connector data in localStorage.\n \n @param connectors - RecentConnectedConnector\n * @returns undefined in SSR context, void in browser\n /\n setRecentConnectedConnector: (connectors: RecentConnectedConnector) =>\n typeof window !== 'undefined'\n ? window.localStorage.setItem(recentConnectedConnectorHelpers.STORAGE_KEY, JSON.stringify(connectors))\n : undefined,\n\n /\n Retrieves the current last connected connector data from localStorage.\n \n @returns The LastConnectedConnector object or undefined if not set or in SSR context\n /\n getRecentConnectedConnector: () =>\n getParsedStorageItem<RecentConnectedConnector>(recentConnectedConnectorHelpers.STORAGE_KEY),\n\n /\n Removes the last connected connector data from localStorage.\n \n @returns undefined in SSR context, void in browser\n /\n removeRecentConnectedConnector: () =>\n typeof window !== 'undefined'\n ? window.localStorage.removeItem(recentConnectedConnectorHelpers.STORAGE_KEY)\n : undefined,\n};\n","/\n @file\n * This module provides adapter selection functionality for the Orbit system.\n * Part of the core infrastructure for managing blockchain adapters.\n /\n\nimport { OrbitAdapter, OrbitGenericAdapter } from '../types';\n\n/\n Selects an appropriate adapter based on the provided key from either a single adapter\n * or an array of adapters.\n \n @typeParam A - Type extending basic adapter interface with a key property\n \n @param options - Selection configuration object\n * @param options.adapterKey - Target adapter key to search for\n * @param options.adapter - Single adapter or array of adapters to search within\n \n @returns Selected adapter or undefined if no suitable adapter found\n \n @remarks\n * If an array is provided but no matching adapter is found, falls back to the first adapter\n * in the array with a warning message.\n \n @example\n * ```typescript\n * // Single adapter usage\n * const singleResult = selectAdapterByKey({\n * adapterKey: OrbitAdapter.SOLANA,\n * adapter: { key: OrbitAdapter.SOLANA, connect: async () => {...} }\n * });\n \n // Multiple adapters usage\n * const multiResult = selectAdapterByKey({\n * adapterKey: OrbitAdapter.EVM,\n * adapter: [\n * { key: OrbitAdapter.SOLANA, connect: async () => {...} },\n * { key: OrbitAdapter.EVM, connect: async () => {...} }\n * ]\n * });\n * ```\n \n @throws {Error} Logs error if adapter array is empty\n * @throws {Warning} Logs warning if requested adapter key not found in array\n /\nexport const selectAdapterByKey = <A extends { key: OrbitAdapter }>({\n adapterKey,\n adapter,\n}: { adapterKey: OrbitAdapter } & OrbitGenericAdapter<A>): A \| undefined => {\n if (Array.isArray(adapter)) {\n if (adapter.length === 0) {\n console.error('Adapter selection failed: The provided adapters array is empty.');\n return undefined;\n }\n\n const foundAdapter = adapter.find((a) => a.key === adapterKey);\n\n if (foundAdapter) {\n return foundAdapter;\n } else {\n console.warn(\n `No adapter found for key: \"${adapterKey}\". Falling back to the first available adapter: \"${adapter[0].key}\".`,\n );\n return adapter[0];\n }\n }\n return adapter;\n};\n","export async function waitFor(\n predicate: () => boolean \| undefined,\n maxChecks: number = 50,\n checkIntervalMs: number = 200,\n) {\n for (let i = 0; i < maxChecks; i++) {\n if (predicate()) {\n return;\n }\n await new Promise((resolve) => setTimeout(resolve, checkIntervalMs));\n }\n throw new Error('Predicate not fulfilled in time');\n}\n","/\n Checks whether the given chain ID belongs to a Solana network.\n * Supports common Solana network names: 'devnet', 'testnet', 'mainnet-beta', 'mainnet'.\n \n @param {number \| string} chainId - The chain ID or chain name.\n * @returns {boolean} - True if the chain ID corresponds to a Solana network, false otherwise.\n /\nexport function isSolanaChain(chainId: number \| string): boolean {\n if (typeof chainId === 'string') {\n return ['devnet', 'testnet', 'mainnet-beta', 'mainnet'].includes(chainId);\n }\n return false;\n}\n\n/\n Sets the chain ID to a Solana-specific format if the chain is a Solana network.\n \n @param {number \| string} chainId - The original chain ID or name.\n * @returns {string \| number} - The formatted chain ID prefixed with 'solana:' if Solana, otherwise the original.\n */\nexport function setChainId(chainId: number \| string): string \| number {\n if (isSolanaChain(chainId)) {\n return `solana:${chainId}`;\n } else {\n return chainId;\n }\n}\n"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@tuwaio/orbit-core",
-  "version": "1.0.0-fix-packages-alpha.1.bb47310",
+  "version": "1.0.0-fix-packages-alpha.3.dc7f910",
   "private": false,
   "author": "Oleksandr Tkach",
   "license": "Apache-2.0",