@kheopskit/core 1.0.0 → 4.0.0

package/dist/chunk-NU46D4MZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/kheopskit/kheopskit/packages/core/dist/chunk-NU46D4MZ.js","../src/utils/isEthereumAddress.ts","../src/utils/isSs58Address.ts","../src/utils/isSolanaAddress.ts","../src/utils/isValidAddress.ts","../src/utils/WalletAccountId.ts","../src/api/appKit.ts","../src/api/errors.ts","../src/api/config.ts","../src/api/store.ts","../src/utils/createStore.ts"],"names":["base58","store"],"mappings":"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","file":"/home/runner/work/kheopskit/kheopskit/packages/core/dist/chunk-NU46D4MZ.js","sourcesContent":[null,"import { keccak_256 } from \"@noble/hashes/sha3\";\n\nconst HEX_ADDRESS = /^0x[0-9a-fA-F]{40}$/;\nconst encoder = new TextEncoder();\n\n/**\n * Verifies the EIP-55 mixed-case checksum of an Ethereum address.\n * Dependency-free (keccak via @noble/hashes) so core stays decoupled from viem.\n */\nconst isChecksumValid = (address: string): boolean => {\n\tconst hex = address.slice(2);\n\tconst hash = keccak_256(encoder.encode(hex.toLowerCase()));\n\tfor (let i = 0; i < 40; i++) {\n\t\tconst char = hex.charAt(i);\n\t\tconst isLetter =\n\t\t\t(char >= \"a\" && char <= \"f\") || (char >= \"A\" && char <= \"F\");\n\t\tif (!isLetter) continue;\n\t\tconst byte = hash[i >> 1] ?? 0;\n\t\tconst nibble = i % 2 === 0 ? byte >> 4 : byte & 0x0f;\n\t\tconst isUpper = char <= \"F\";\n\t\tif (isUpper !== nibble >= 8) return false;\n\t}\n\treturn true;\n};\n\n/**\n * Returns true if `address` is a valid Ethereum address.\n *\n * Mirrors viem's `isAddress` (strict): the shape must be `0x` + 40 hex, and a\n * mixed-case address must pass the EIP-55 checksum. All-lowercase addresses are\n * accepted as non-checksummed.\n */\nexport const isEthereumAddress = (address: string): boolean => {\n\tif (!HEX_ADDRESS.test(address)) return false;\n\tif (address === address.toLowerCase()) return true;\n\treturn isChecksumValid(address);\n};\n","import { blake2b } from \"@noble/hashes/blake2b\";\nimport { base58 } from \"@scure/base\";\n\n// The \"SS58PRE\" prefix used in the SS58 checksum preimage.\nconst SS58PRE = new Uint8Array([0x53, 0x53, 0x35, 0x38, 0x50, 0x52, 0x45]);\n\n/**\n * Returns true if `address` is a valid SS58-encoded 32-byte account id (the\n * only form Substrate wallets inject), verifying the blake2b-512 checksum.\n *\n * Dependency-free (base58 via @scure/base, blake2b via @noble/hashes) so core\n * stays decoupled from polkadot-api.\n */\nexport const isSs58Address = (address: string): boolean => {\n\tif (!address) return false;\n\n\tlet decoded: Uint8Array;\n\ttry {\n\t\tdecoded = base58.decode(address);\n\t} catch {\n\t\treturn false;\n\t}\n\n\t// First byte encodes the network prefix; the high bit is reserved/invalid.\n\tconst firstByte = decoded[0];\n\tif (firstByte === undefined || firstByte & 0b1000_0000) return false;\n\t// The 0b0100_0000 bit marks a 2-byte prefix.\n\tconst prefixLength = firstByte & 0b0100_0000 ? 2 : 1;\n\n\t// AccountId32 layout: prefix + 32-byte pubkey + 2-byte checksum.\n\tif (decoded.length !== prefixLength + 32 + 2) return false;\n\n\tconst body = decoded.subarray(0, decoded.length - 2);\n\tconst preimage = new Uint8Array(SS58PRE.length + body.length);\n\tpreimage.set(SS58PRE);\n\tpreimage.set(body, SS58PRE.length);\n\tconst hash = blake2b(preimage, { dkLen: 64 });\n\n\treturn (\n\t\tdecoded[decoded.length - 2] === hash[0] &&\n\t\tdecoded[decoded.length - 1] === hash[1]\n\t);\n};\n","import { base58 } from \"@scure/base\";\n\n/**\n * Returns true if the value is a valid Solana address: a base58-encoded\n * 32-byte ed25519 public key.\n *\n * Solana addresses carry no checksum, so this is a pure base58 + length check.\n * Dependency-free (base58 via @scure/base) so core stays decoupled from\n * @solana/kit.\n */\nexport const isSolanaAddress = (address: string): boolean => {\n\tif (!address) return false;\n\ttry {\n\t\treturn base58.decode(address).length === 32;\n\t} catch {\n\t\treturn false;\n\t}\n};\n","import { isEthereumAddress } from \"./isEthereumAddress\";\nimport { isSolanaAddress } from \"./isSolanaAddress\";\nimport { isSs58Address } from \"./isSs58Address\";\n\nexport const isValidAddress = (address: string): boolean => {\n\tif (address.startsWith(\"0x\")) return isEthereumAddress(address);\n\t// SS58 (checksummed) and Solana (base58, no checksum) are disjoint: a\n\t// 32-byte Solana pubkey fails SS58 decoding, and an SS58 address decodes to\n\t// more than 32 bytes so it fails the Solana length check.\n\treturn isSs58Address(address) || isSolanaAddress(address);\n};\n","import { isValidAddress } from \"./isValidAddress\";\n\nexport type WalletAccountId = string;\n\nexport const getWalletAccountId = (\n\twalletId: string,\n\taddress: string,\n): WalletAccountId => {\n\tif (!walletId) throw new Error(\"Missing walletId\");\n\tif (!isValidAddress(address)) throw new Error(\"Invalid address\");\n\treturn `${walletId}::${address}`;\n};\n\nexport const parseWalletAccountId = (accountId: string) => {\n\tif (!accountId) throw new Error(\"Invalid walletAccountId\");\n\tconst [walletId, address] = accountId.split(\"::\");\n\tif (!walletId) throw new Error(\"Missing walletId\");\n\tif (!address || !isValidAddress(address)) throw new Error(\"Invalid address\");\n\treturn { walletId, address };\n};\n","import {\n\tBehaviorSubject,\n\tcombineLatest,\n\tdistinctUntilChanged,\n\tfrom,\n\tmap,\n\tObservable,\n\tof,\n\tshareReplay,\n\tswitchMap,\n\ttap,\n} from \"rxjs\";\nimport { clearCachedObservablesByPrefix } from \"../utils/getCachedObservable\";\nimport { getWalletId } from \"../utils/WalletId\";\nimport type {\n\tAppKitInstance,\n\tEthereumAppKitWallet,\n\tKheopskitConfig,\n\tPolkadotAppKitWallet,\n\tSolanaAppKitWallet,\n} from \"./types\";\n\n/**\n * Dynamically import @reown/appkit/core to avoid loading browser-only code\n * during SSR or in edge runtimes like Cloudflare Workers.\n * The AppKit library uses Lit for web components which requires document.\n */\nconst loadAppKit = async () => {\n\ttry {\n\t\tconst { createAppKit } = await import(\"@reown/appkit/core\");\n\t\treturn createAppKit;\n\t} catch (cause) {\n\t\tconsole.error(\n\t\t\t\"[kheopskit] WalletConnect is configured but @reown/appkit could not be loaded. \" +\n\t\t\t\t\"Install it with `pnpm add @reown/appkit` (or remove config.walletConnect). \" +\n\t\t\t\t\"WalletConnect wallets are disabled; injected wallets still work.\",\n\t\t\tcause,\n\t\t);\n\t\treturn null;\n\t}\n};\n\nconst WALLET_CONNECT_ICON =\n\t\"data:image/svg+xml;base64,PHN2ZyBmaWxsPSJub25lIiBoZWlnaHQ9IjQwMCIgdmlld0JveD0iMCAwIDQwMCA0MDAiIHdpZHRoPSI0MDAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiPjxjbGlwUGF0aCBpZD0iYSI+PHBhdGggZD0ibTAgMGg0MDB2NDAwaC00MDB6Ii8+PC9jbGlwUGF0aD48ZyBjbGlwLXBhdGg9InVybCgjYSkiPjxjaXJjbGUgY3g9IjIwMCIgY3k9IjIwMCIgZmlsbD0iIzMzOTZmZiIgcj0iMTk5LjUiIHN0cm9rZT0iIzY2YjFmZiIvPjxwYXRoIGQ9Im0xMjIuNTE5IDE0OC45NjVjNDIuNzkxLTQxLjcyOSAxMTIuMTcxLTQxLjcyOSAxNTQuOTYyIDBsNS4xNSA1LjAyMmMyLjE0IDIuMDg2IDIuMTQgNS40NjkgMCA3LjU1NWwtMTcuNjE3IDE3LjE4Yy0xLjA3IDEuMDQzLTIuODA0IDEuMDQzLTMuODc0IDBsLTcuMDg3LTYuOTExYy0yOS44NTMtMjkuMTExLTc4LjI1My0yOS4xMTEtMTA4LjEwNiAwbC03LjU5IDcuNDAxYy0xLjA3IDEuMDQzLTIuODA0IDEuMDQzLTMuODc0IDBsLTE3LjYxNy0xNy4xOGMtMi4xNC0yLjA4Ni0yLjE0LTUuNDY5IDAtNy41NTV6bTE5MS4zOTcgMzUuNTI5IDE1LjY3OSAxNS4yOWMyLjE0IDIuMDg2IDIuMTQgNS40NjkgMCA3LjU1NWwtNzAuNyA2OC45NDRjLTIuMTM5IDIuMDg3LTUuNjA4IDIuMDg3LTcuNzQ4IDBsLTUwLjE3OC00OC45MzFjLS41MzUtLjUyMi0xLjQwMi0uNTIyLTEuOTM3IDBsLTUwLjE3OCA0OC45MzFjLTIuMTM5IDIuMDg3LTUuNjA4IDIuMDg3LTcuNzQ4IDBsLTcwLjcwMTUtNjguOTQ1Yy0yLjEzOTYtMi4wODYtMi4xMzk2LTUuNDY5IDAtNy41NTVsMTUuNjc5NS0xNS4yOWMyLjEzOTYtMi4wODYgNS42MDg1LTIuMDg2IDcuNzQ4MSAwbDUwLjE3ODkgNDguOTMyYy41MzUuNTIyIDEuNDAyLjUyMiAxLjkzNyAwbDUwLjE3Ny00OC45MzJjMi4xMzktMi4wODcgNS42MDgtMi4wODcgNy43NDggMGw1MC4xNzkgNDguOTMyYy41MzUuNTIyIDEuNDAyLjUyMiAxLjkzNyAwbDUwLjE3OS00OC45MzFjMi4xMzktMi4wODcgNS42MDgtMi4wODcgNy43NDggMHoiIGZpbGw9IiNmZmYiLz48L2c+PC9zdmc+\";\n\ntype AppKitWallets = {\n\tpolkadot?: PolkadotAppKitWallet;\n\tethereum?: EthereumAppKitWallet;\n\tsolana?: SolanaAppKitWallet;\n};\n\n// Once it exists, the appKit object should never be recreated. Anchored on\n// globalThis so it stays a single instance even if this module is duplicated\n// across bundle chunks (e.g. CJS subpath entries).\nconst APPKIT_SYMBOL = Symbol.for(\"kheopskit.cachedAppKit\");\ntype AppKitGlobal = Record<symbol, Observable<AppKitWallets> | undefined>;\nconst getCachedAppKit = (): Observable<AppKitWallets> | undefined =>\n\t(globalThis as unknown as AppKitGlobal)[APPKIT_SYMBOL];\nconst setCachedAppKit = (\n\tvalue: Observable<AppKitWallets> | undefined,\n): void => {\n\t(globalThis as unknown as AppKitGlobal)[APPKIT_SYMBOL] = value;\n};\n\n/**\n * Clears the cached AppKit observable.\n * Use when configuration changes or for testing purposes.\n * Note: This does NOT destroy the appKit instance created by Reown.\n */\nexport const resetAppKitCache = (): void => {\n\tsetCachedAppKit(undefined);\n};\n\n/**\n * Tap callback that drops a WalletConnect wallet's cached account observables\n * whenever it transitions to disconnected. Covers external disconnects (from\n * the wallet app), which flip `isConnected` via `subscribeProviders` without\n * ever calling `disconnect()`, so a later reconnect rebuilds the account\n * observables against the fresh session instead of a stale closure.\n *\n * Keys are `accounts:<walletId>:...`; the trailing colon scopes the prefix to\n * this wallet and avoids matching a sibling whose id is a string prefix.\n */\nconst clearAccountsCacheOnDisconnect =\n\t(platform: \"polkadot\" | \"ethereum\" | \"solana\") =>\n\t(isConnected: boolean): void => {\n\t\tif (!isConnected)\n\t\t\tclearCachedObservablesByPrefix(\n\t\t\t\t`accounts:${getWalletId(platform, \"walletconnect\")}:`,\n\t\t\t);\n\t};\n\n/**\n * Observable of AppKit (WalletConnect) wallets for the given config.\n *\n * @remarks\n * The AppKit instance is a process-wide singleton (Reown AppKit itself cannot\n * be instantiated twice). The **first** call with a `walletConnect` config wins;\n * later calls with a *different* `walletConnect` config reuse that first\n * instance. Call {@link resetAppKitCache} before re-initialising if the\n * WalletConnect config must change.\n */\nexport const getAppKitWallets$ = (\n\tconfig: KheopskitConfig,\n): Observable<AppKitWallets> => {\n\tif (!config.walletConnect) return of({});\n\n\t// SSR guard - don't try to load AppKit on the server\n\tif (typeof window === \"undefined\") return of({});\n\n\tconst walletConnect = config.walletConnect;\n\n\tlet cachedAppKit = getCachedAppKit();\n\tif (!cachedAppKit) {\n\t\t// Use dynamic import to avoid loading @reown/appkit at module evaluation time\n\t\t// This is critical for SSR and edge runtimes like Cloudflare Workers\n\t\tcachedAppKit = from(loadAppKit()).pipe(\n\t\t\tswitchMap((createAppKit) => {\n\t\t\t\t// @reown/appkit missing (optional peer dep) — degrade gracefully.\n\t\t\t\tif (!createAppKit) return of<AppKitWallets>({});\n\t\t\t\treturn new Observable<AppKitWallets>((subscriber) => {\n\t\t\t\t\tconst appKit = createAppKit({\n\t\t\t\t\t\tprojectId: walletConnect.projectId,\n\t\t\t\t\t\tmetadata: walletConnect.metadata,\n\t\t\t\t\t\t// Loosely typed in WalletConnectConfig to keep @reown/appkit's\n\t\t\t\t\t\t// types out of core; forwarded to AppKit verbatim.\n\t\t\t\t\t\tnetworks: walletConnect.networks as never,\n\t\t\t\t\t\tthemeMode: walletConnect.themeMode,\n\t\t\t\t\t\tthemeVariables: walletConnect.themeVariables as never,\n\t\t\t\t\t\tuniversalProviderConfigOverride: {\n\t\t\t\t\t\t\tmethods: {\n\t\t\t\t\t\t\t\tpolkadot: [\"polkadot_signTransaction\", \"polkadot_signMessage\"],\n\t\t\t\t\t\t\t\tsolana: [\n\t\t\t\t\t\t\t\t\t\"solana_signTransaction\",\n\t\t\t\t\t\t\t\t\t\"solana_signMessage\",\n\t\t\t\t\t\t\t\t\t\"solana_signAndSendTransaction\",\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t},\n\t\t\t\t\t\tallWallets: \"HIDE\",\n\t\t\t\t\t\tdebug: config.debug,\n\t\t\t\t\t\tallowUnsupportedChain: true,\n\t\t\t\t\t});\n\n\t\t\t\t\t// Exposed on wallets as the (decoupled) AppKitInstance escape hatch.\n\t\t\t\t\tconst appKitInstance = appKit as unknown as AppKitInstance;\n\n\t\t\t\t\tconst status$ = new BehaviorSubject({\n\t\t\t\t\t\tisPolkadotConnected: false,\n\t\t\t\t\t\tisEthereumConnected: false,\n\t\t\t\t\t\tisSolanaConnected: false,\n\t\t\t\t\t});\n\n\t\t\t\t\tconst unsubProviders = appKit.subscribeProviders((providers) => {\n\t\t\t\t\t\tstatus$.next({\n\t\t\t\t\t\t\tisPolkadotConnected: !!providers.polkadot,\n\t\t\t\t\t\t\tisEthereumConnected: !!providers.eip155,\n\t\t\t\t\t\t\tisSolanaConnected: !!providers.solana,\n\t\t\t\t\t\t});\n\t\t\t\t\t});\n\n\t\t\t\t\tconst polkadotWallet$ = appKit.chainNamespaces.includes(\"polkadot\")\n\t\t\t\t\t\t? status$.pipe(\n\t\t\t\t\t\t\t\tmap((s) => s.isPolkadotConnected),\n\t\t\t\t\t\t\t\tdistinctUntilChanged(),\n\t\t\t\t\t\t\t\ttap(clearAccountsCacheOnDisconnect(\"polkadot\")),\n\t\t\t\t\t\t\t\tmap((isConnected): PolkadotAppKitWallet => {\n\t\t\t\t\t\t\t\t\tconst walletInfo = appKit.getWalletInfo();\n\t\t\t\t\t\t\t\t\tconst walletId = getWalletId(\"polkadot\", \"walletconnect\");\n\n\t\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\t\tid: walletId,\n\t\t\t\t\t\t\t\t\t\tplatform: \"polkadot\",\n\t\t\t\t\t\t\t\t\t\ttype: \"appKit\",\n\t\t\t\t\t\t\t\t\t\tappKit: appKitInstance,\n\t\t\t\t\t\t\t\t\t\tname: walletInfo?.name ?? \"WalletConnect\",\n\t\t\t\t\t\t\t\t\t\ticon: walletInfo?.icon ?? WALLET_CONNECT_ICON,\n\t\t\t\t\t\t\t\t\t\tconnect: async () => {\n\t\t\t\t\t\t\t\t\t\t\tif (!isConnected) await appKit.open();\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\tdisconnect: async () => {\n\t\t\t\t\t\t\t\t\t\t\tif (isConnected) await appKit.disconnect();\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\tisConnected,\n\t\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t: of(undefined);\n\n\t\t\t\t\tconst ethereumWallet$ = appKit.chainNamespaces.includes(\"eip155\")\n\t\t\t\t\t\t? status$.pipe(\n\t\t\t\t\t\t\t\tmap((s) => s.isEthereumConnected),\n\t\t\t\t\t\t\t\tdistinctUntilChanged(),\n\t\t\t\t\t\t\t\ttap(clearAccountsCacheOnDisconnect(\"ethereum\")),\n\t\t\t\t\t\t\t\tmap((isConnected): EthereumAppKitWallet => {\n\t\t\t\t\t\t\t\t\tconst walletInfo = appKit.getWalletInfo();\n\t\t\t\t\t\t\t\t\tconst walletId = getWalletId(\"ethereum\", \"walletconnect\");\n\n\t\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\t\tid: walletId,\n\t\t\t\t\t\t\t\t\t\tplatform: \"ethereum\",\n\t\t\t\t\t\t\t\t\t\ttype: \"appKit\",\n\t\t\t\t\t\t\t\t\t\tappKit: appKitInstance,\n\t\t\t\t\t\t\t\t\t\tname: walletInfo?.name ?? \"WalletConnect\",\n\t\t\t\t\t\t\t\t\t\ticon: walletInfo?.icon ?? WALLET_CONNECT_ICON,\n\t\t\t\t\t\t\t\t\t\tconnect: () => appKit.open(),\n\t\t\t\t\t\t\t\t\t\tdisconnect: async () => {\n\t\t\t\t\t\t\t\t\t\t\tawait appKit.disconnect();\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\tisConnected,\n\t\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t: of(undefined);\n\n\t\t\t\t\tconst solanaWallet$ = appKit.chainNamespaces.includes(\"solana\")\n\t\t\t\t\t\t? status$.pipe(\n\t\t\t\t\t\t\t\tmap((s) => s.isSolanaConnected),\n\t\t\t\t\t\t\t\tdistinctUntilChanged(),\n\t\t\t\t\t\t\t\ttap(clearAccountsCacheOnDisconnect(\"solana\")),\n\t\t\t\t\t\t\t\tmap((isConnected): SolanaAppKitWallet => {\n\t\t\t\t\t\t\t\t\tconst walletInfo = appKit.getWalletInfo();\n\t\t\t\t\t\t\t\t\tconst walletId = getWalletId(\"solana\", \"walletconnect\");\n\n\t\t\t\t\t\t\t\t\treturn {\n\t\t\t\t\t\t\t\t\t\tid: walletId,\n\t\t\t\t\t\t\t\t\t\tplatform: \"solana\",\n\t\t\t\t\t\t\t\t\t\ttype: \"appKit\",\n\t\t\t\t\t\t\t\t\t\tappKit: appKitInstance,\n\t\t\t\t\t\t\t\t\t\tname: walletInfo?.name ?? \"WalletConnect\",\n\t\t\t\t\t\t\t\t\t\ticon: walletInfo?.icon ?? WALLET_CONNECT_ICON,\n\t\t\t\t\t\t\t\t\t\tconnect: () => appKit.open(),\n\t\t\t\t\t\t\t\t\t\tdisconnect: async () => {\n\t\t\t\t\t\t\t\t\t\t\tawait appKit.disconnect();\n\t\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t\t\tisConnected,\n\t\t\t\t\t\t\t\t\t};\n\t\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t: of(undefined);\n\n\t\t\t\t\tconst sub = combineLatest({\n\t\t\t\t\t\tpolkadot: polkadotWallet$,\n\t\t\t\t\t\tethereum: ethereumWallet$,\n\t\t\t\t\t\tsolana: solanaWallet$,\n\t\t\t\t\t}).subscribe(subscriber);\n\n\t\t\t\t\treturn () => {\n\t\t\t\t\t\tsub.unsubscribe();\n\t\t\t\t\t\tunsubProviders();\n\t\t\t\t\t};\n\t\t\t\t});\n\t\t\t}),\n\t\t\tshareReplay({ refCount: true, bufferSize: 1 }),\n\t\t);\n\t\tsetCachedAppKit(cachedAppKit);\n\t}\n\n\treturn cachedAppKit;\n};\n","/**\n * Stable error codes thrown by kheopskit. Catch a {@link KheopskitError} and\n * branch on `error.code` instead of matching message strings.\n */\nexport type KheopskitErrorCode =\n\t/** `connect()` called on a wallet that is already connected. */\n\t| \"WALLET_ALREADY_CONNECTED\"\n\t/** `disconnect()` called on a wallet that is not connected. */\n\t| \"WALLET_NOT_CONNECTED\"\n\t/** The wallet does not advertise a capability kheopskit needs to proceed. */\n\t| \"FEATURE_NOT_SUPPORTED\"\n\t/** No active WalletConnect session for the requested operation. */\n\t| \"NO_SESSION\"\n\t/** No provider available for the requested namespace. */\n\t| \"NO_PROVIDER\"\n\t/** The requested chain cannot be used for this operation (e.g. a Solana cluster with no CAIP-2 id over WalletConnect). */\n\t| \"UNSUPPORTED_CHAIN\";\n\n/**\n * Error thrown by kheopskit wallet/account operations. Carries a stable\n * {@link KheopskitErrorCode} and, when relevant, the offending wallet id.\n *\n * @example\n * ```ts\n * try {\n *   await wallet.connect();\n * } catch (error) {\n *   if (error instanceof KheopskitError && error.code === \"WALLET_ALREADY_CONNECTED\") {\n *     // ignore\n *   } else throw error;\n * }\n * ```\n */\nexport class KheopskitError extends Error {\n\treadonly code: KheopskitErrorCode;\n\t/** The wallet id this error relates to, when applicable. */\n\treadonly walletId?: string;\n\n\tconstructor(\n\t\tcode: KheopskitErrorCode,\n\t\tmessage: string,\n\t\toptions?: { walletId?: string; cause?: unknown },\n\t) {\n\t\tsuper(`[kheopskit] ${message}`, { cause: options?.cause });\n\t\tthis.name = \"KheopskitError\";\n\t\tthis.code = code;\n\t\tthis.walletId = options?.walletId;\n\t}\n}\n","import type { KheopskitConfig, KheopskitPlatform } from \"./types\";\n\n/**\n * Default storage key for persisting wallet connection state.\n * Can be overridden via config.storageKey to avoid conflicts\n * when running multiple dapps on the same domain.\n */\nexport const DEFAULT_STORAGE_KEY = \"kheopskit\";\n\nconst DEFAULTS = {\n\tautoReconnect: true,\n\tdebug: false,\n\tstorageKey: DEFAULT_STORAGE_KEY,\n\thydrationGracePeriod: 500,\n} satisfies Omit<KheopskitConfig, \"platforms\" | \"walletConnect\">;\n\nexport const resolveConfig = <\n\tconst P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[],\n>(\n\tconfig?: Partial<KheopskitConfig<P>>,\n): KheopskitConfig<P> => {\n\tconst platforms = (config?.platforms ?? []) as P;\n\n\t// Guard the v4 breaking change: platforms are plugin instances, not strings.\n\t// Catches JS callers (no tsc) and gives agents a fix that names the doc.\n\tconst invalidPlatforms = (platforms as readonly unknown[]).filter(\n\t\t(p) =>\n\t\t\ttypeof p !== \"object\" ||\n\t\t\tp === null ||\n\t\t\ttypeof (p as { getWallets$?: unknown }).getWallets$ !== \"function\",\n\t);\n\tif (invalidPlatforms.length > 0) {\n\t\tthrow new Error(\n\t\t\t\"[kheopskit] config.platforms must contain plugin instances created by the \" +\n\t\t\t\t\"per-platform factories (e.g. platforms: [polkadot(), ethereum(), solana()] \" +\n\t\t\t\t'imported from \"@kheopskit/core/<platform>\"). ' +\n\t\t\t\t`Invalid entries: ${JSON.stringify(invalidPlatforms)}. ` +\n\t\t\t\t'String platform names like \"polkadot\" were removed in v4 — see MIGRATING_TO_V4.md.',\n\t\t);\n\t}\n\n\tif (platforms.length === 0) {\n\t\tconsole.warn(\n\t\t\t\"[kheopskit] No platforms configured; wallets and accounts will be empty. \" +\n\t\t\t\t'Pass e.g. platforms: [polkadot()] from \"@kheopskit/core/polkadot\".',\n\t\t);\n\t}\n\n\treturn Object.assign({}, DEFAULTS, config, { platforms });\n};\n","import { uniq } from \"lodash-es\";\nimport { createStore } from \"../utils/createStore\";\nimport { isWalletPlatform } from \"../utils/isWalletPlatform\";\nimport { cookieStorage, safeLocalStorage } from \"../utils/storage\";\nimport { getWalletAccountId } from \"../utils/WalletAccountId\";\nimport {\n\tisValidWalletId,\n\tparseWalletId,\n\ttype WalletId,\n} from \"../utils/WalletId\";\nimport { DEFAULT_STORAGE_KEY } from \"./config\";\nimport type { CachedAccount, CachedWallet } from \"./types\";\n\ntype KheopskitStoreData = {\n\tautoReconnect?: WalletId[];\n\t/** Cached wallet state for SSR hydration to prevent UI flash */\n\tcachedWallets?: CachedWallet[];\n\t/** Cached account state for SSR hydration to prevent UI flash */\n\tcachedAccounts?: CachedAccount[];\n};\n\ntype CompactWalletEntry = [WalletId, string, 0 | 1, 0 | 1];\ntype CompactPolkadotAccountType = 0 | 1 | 2 | 3;\ntype CompactAccountEntry = [\n\tWalletId,\n\tstring,\n\tstring | null,\n\tnumber | null,\n\t(CompactPolkadotAccountType | null)?,\n];\n\ntype CompactStoreV1 = {\n\tv: 1;\n\t// autoReconnect\n\tr?: WalletId[];\n\t// wallets: [id, name, isConnected(0|1), type(0=injected,1=appKit)?]\n\tw?: CompactWalletEntry[];\n\t// accounts: [walletId, address, name?]\n\ta?: CompactAccountEntry[];\n};\n\nconst DEFAULT_SETTINGS: KheopskitStoreData = {};\n\n/**\n * Validates a cached wallet read from persisted storage. Cached state may have\n * been written by an older (or corrupted) version with a different shape, so we\n * drop anything that wouldn't survive hydration/sort rather than letting it\n * throw at render time. Only the fields downstream code relies on are checked.\n */\nconst isValidCachedWallet = (value: unknown): value is CachedWallet => {\n\tif (!value || typeof value !== \"object\") return false;\n\tconst w = value as Record<string, unknown>;\n\treturn (\n\t\tisValidWalletId(w.id) &&\n\t\tisWalletPlatform(w.platform) &&\n\t\ttypeof w.name === \"string\" &&\n\t\t(w.type === \"injected\" || w.type === \"appKit\") &&\n\t\ttypeof w.isConnected === \"boolean\"\n\t);\n};\n\n/** Validates a cached account read from persisted storage. See {@link isValidCachedWallet}. */\nconst isValidCachedAccount = (value: unknown): value is CachedAccount => {\n\tif (!value || typeof value !== \"object\") return false;\n\tconst a = value as Record<string, unknown>;\n\treturn (\n\t\ttypeof a.id === \"string\" &&\n\t\t!!a.id &&\n\t\tisWalletPlatform(a.platform) &&\n\t\ttypeof a.address === \"string\" &&\n\t\t!!a.address &&\n\t\tisValidWalletId(a.walletId) &&\n\t\ttypeof a.walletName === \"string\"\n\t);\n};\n\nconst toCompactPolkadotAccountType = (\n\ttype: CachedAccount[\"polkadotAccountType\"],\n): CompactPolkadotAccountType | null => {\n\tswitch (type) {\n\t\tcase \"sr25519\":\n\t\t\treturn 0;\n\t\tcase \"ed25519\":\n\t\t\treturn 1;\n\t\tcase \"ecdsa\":\n\t\t\treturn 2;\n\t\tcase \"ethereum\":\n\t\t\treturn 3;\n\t\tdefault:\n\t\t\treturn null;\n\t}\n};\n\nconst fromCompactPolkadotAccountType = (\n\ttype: CompactPolkadotAccountType | null | undefined,\n): CachedAccount[\"polkadotAccountType\"] => {\n\tswitch (type) {\n\t\tcase 0:\n\t\t\treturn \"sr25519\";\n\t\tcase 1:\n\t\t\treturn \"ed25519\";\n\t\tcase 2:\n\t\t\treturn \"ecdsa\";\n\t\tcase 3:\n\t\t\treturn \"ethereum\";\n\t\tdefault:\n\t\t\treturn undefined;\n\t}\n};\n\ntype CreateKheopskitStoreOptions = {\n\t/**\n\t * Cookie string for SSR hydration.\n\t * When provided, uses cookieStorage instead of localStorage.\n\t */\n\tssrCookies?: string;\n\t/**\n\t * Custom storage key to namespace the stored data.\n\t * @default \"kheopskit\"\n\t */\n\tstorageKey?: string;\n};\n\n/**\n * Creates a kheopskit store with the appropriate storage backend.\n * Uses cookieStorage when ssrCookies is provided (for SSR hydration),\n * otherwise falls back to safeLocalStorage.\n *\n * @param options - Configuration options for the store\n */\nexport const createKheopskitStore = (\n\toptions: CreateKheopskitStoreOptions = {},\n) => {\n\tconst { ssrCookies, storageKey = DEFAULT_STORAGE_KEY } = options;\n\tconst storage =\n\t\tssrCookies !== undefined\n\t\t\t? createCompactCookieStorage(ssrCookies)\n\t\t\t: safeLocalStorage;\n\tconst store = createStore(storageKey, DEFAULT_SETTINGS, storage);\n\n\tconst addEnabledWalletId = (walletId: WalletId) => {\n\t\tparseWalletId(walletId); // validate walletId\n\t\tstore.mutate((prev) => ({\n\t\t\t...prev,\n\t\t\tautoReconnect: uniq((prev.autoReconnect ?? []).concat(walletId)),\n\t\t}));\n\t};\n\n\tconst removeEnabledWalletId = (walletId: WalletId) => {\n\t\tstore.mutate((prev) => ({\n\t\t\t...prev,\n\t\t\tautoReconnect: uniq(\n\t\t\t\t(prev.autoReconnect ?? []).filter((id) => id !== walletId),\n\t\t\t),\n\t\t}));\n\t};\n\n\tconst getCachedState = () => {\n\t\t// `store.get()` returns whatever JSON was persisted — it may be from an\n\t\t// older version, a different shape, or outright corrupt. Read defensively:\n\t\t// coerce non-objects/arrays to empty and drop any entry that fails\n\t\t// validation, so stale cache degrades to \"start fresh\" instead of throwing\n\t\t// during hydration (which renders eagerly, so a throw blanks the dapp).\n\t\tconst data = store.get() as Partial<KheopskitStoreData> | null | undefined;\n\t\tconst cachedWallets = Array.isArray(data?.cachedWallets)\n\t\t\t? data.cachedWallets\n\t\t\t: [];\n\t\tconst cachedAccounts = Array.isArray(data?.cachedAccounts)\n\t\t\t? data.cachedAccounts\n\t\t\t: [];\n\t\treturn {\n\t\t\twallets: cachedWallets.filter(isValidCachedWallet),\n\t\t\taccounts: cachedAccounts.filter(isValidCachedAccount),\n\t\t};\n\t};\n\n\tconst setCachedState = (\n\t\twallets: CachedWallet[],\n\t\taccounts: CachedAccount[],\n\t) => {\n\t\tstore.mutate((prev) => ({\n\t\t\t...prev,\n\t\t\tcachedWallets: wallets,\n\t\t\tcachedAccounts: accounts,\n\t\t}));\n\t};\n\n\treturn {\n\t\tobservable: store.observable,\n\t\taddEnabledWalletId,\n\t\tremoveEnabledWalletId,\n\t\tgetCachedState,\n\t\tsetCachedState,\n\t};\n};\n\nexport type KheopskitStore = ReturnType<typeof createKheopskitStore>;\n\n/**\n * Cached default store instance, anchored on globalThis so it stays a single\n * instance even if this module is duplicated across bundle chunks (e.g. CJS\n * subpath entries). Lazily initialized on first access to be SSR-safe.\n */\nconst DEFAULT_STORE_SYMBOL = Symbol.for(\"kheopskit.defaultStore\");\n\n/**\n * Gets the default store, creating it on first access.\n * Uses localStorage on client, noop on server.\n * Lazily initialized to avoid SSR issues with module-level code.\n */\nexport const getDefaultStore = (): KheopskitStore => {\n\tconst g = globalThis as unknown as Record<symbol, KheopskitStore | undefined>;\n\tif (!g[DEFAULT_STORE_SYMBOL]) {\n\t\tg[DEFAULT_STORE_SYMBOL] = createKheopskitStore();\n\t}\n\treturn g[DEFAULT_STORE_SYMBOL];\n};\n\n/**\n * @deprecated Use createKheopskitStore() or getDefaultStore() instead.\n * This export is kept for backward compatibility but may cause SSR issues\n * if imported at module level in server environments.\n */\nexport const store = {\n\tget observable() {\n\t\treturn getDefaultStore().observable;\n\t},\n\taddEnabledWalletId: (walletId: WalletId) =>\n\t\tgetDefaultStore().addEnabledWalletId(walletId),\n\tremoveEnabledWalletId: (walletId: WalletId) =>\n\t\tgetDefaultStore().removeEnabledWalletId(walletId),\n\tgetCachedState: () => getDefaultStore().getCachedState(),\n\tsetCachedState: (wallets: CachedWallet[], accounts: CachedAccount[]) =>\n\t\tgetDefaultStore().setCachedState(wallets, accounts),\n};\n\nconst isCompactStore = (value: unknown): value is CompactStoreV1 => {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return false;\n\tif (\"cachedWallets\" in value || \"cachedAccounts\" in value) return false;\n\treturn \"v\" in value || \"w\" in value || \"a\" in value || \"r\" in value;\n};\n\nconst toCompactStore = (data: KheopskitStoreData): CompactStoreV1 => {\n\tconst wallets = data.cachedWallets?.map(\n\t\t(wallet): CompactWalletEntry => [\n\t\t\twallet.id,\n\t\t\twallet.name,\n\t\t\twallet.isConnected ? 1 : 0,\n\t\t\twallet.type === \"appKit\" ? 1 : 0,\n\t\t],\n\t);\n\n\tconst accounts = data.cachedAccounts?.map(\n\t\t(account): CompactAccountEntry => [\n\t\t\taccount.walletId,\n\t\t\taccount.address,\n\t\t\taccount.name ?? null,\n\t\t\taccount.chainId ?? null,\n\t\t\ttoCompactPolkadotAccountType(account.polkadotAccountType),\n\t\t],\n\t);\n\n\treturn {\n\t\tv: 1,\n\t\tr: data.autoReconnect,\n\t\tw: wallets?.length ? wallets : undefined,\n\t\ta: accounts?.length ? accounts : undefined,\n\t};\n};\n\nconst fromCompactStore = (data: CompactStoreV1): KheopskitStoreData => {\n\tconst walletNameMap = new Map<WalletId, string>();\n\n\t// Decode defensively: a compact payload may be malformed (older/corrupt\n\t// cookie, hand-edited). Skip entries with an unparseable wallet id rather\n\t// than throwing, which would crash store initialisation.\n\tconst wallets: CachedWallet[] = [];\n\tfor (const item of Array.isArray(data.w) ? data.w : []) {\n\t\tif (!Array.isArray(item)) continue;\n\t\tconst [id, name, isConnected, type] = item;\n\t\tif (!isValidWalletId(id)) continue;\n\t\tconst { platform } = parseWalletId(id);\n\t\twalletNameMap.set(id, name);\n\t\twallets.push({\n\t\t\tid,\n\t\t\tplatform,\n\t\t\ttype: type === 1 ? \"appKit\" : \"injected\",\n\t\t\tname,\n\t\t\tisConnected: isConnected === 1,\n\t\t});\n\t}\n\n\tconst accounts: CachedAccount[] = [];\n\tfor (const item of Array.isArray(data.a) ? data.a : []) {\n\t\tif (!Array.isArray(item)) continue;\n\t\tconst [walletId, address, name, chainId, polkadotAccountType] = item;\n\t\tif (!isValidWalletId(walletId) || typeof address !== \"string\" || !address)\n\t\t\tcontinue;\n\t\tconst { platform } = parseWalletId(walletId);\n\t\taccounts.push({\n\t\t\tid: getWalletAccountId(walletId, address),\n\t\t\tplatform,\n\t\t\taddress,\n\t\t\tname: name ?? undefined,\n\t\t\tchainId: chainId ?? undefined,\n\t\t\tpolkadotAccountType:\n\t\t\t\tplatform === \"polkadot\"\n\t\t\t\t\t? fromCompactPolkadotAccountType(polkadotAccountType)\n\t\t\t\t\t: undefined,\n\t\t\twalletId,\n\t\t\twalletName: walletNameMap.get(walletId) ?? walletId,\n\t\t});\n\t}\n\n\treturn {\n\t\tautoReconnect: data.r,\n\t\tcachedWallets: wallets,\n\t\tcachedAccounts: accounts,\n\t};\n};\n\nconst decodeStore = (raw: string, fallback: KheopskitStoreData) => {\n\ttry {\n\t\tconst parsed = JSON.parse(raw) as unknown;\n\t\tif (isCompactStore(parsed)) return fromCompactStore(parsed);\n\t\treturn parsed as KheopskitStoreData;\n\t} catch {\n\t\treturn fallback;\n\t}\n};\n\nconst encodeStore = (data: KheopskitStoreData): string =>\n\tJSON.stringify(toCompactStore(data));\n\nconst createCompactCookieStorage = (initialCookies?: string) => {\n\tconst base = cookieStorage(initialCookies);\n\n\treturn {\n\t\tgetItem: (key: string) => {\n\t\t\tconst raw = base.getItem(key);\n\t\t\tif (!raw) return null;\n\t\t\tconst expanded = decodeStore(raw, DEFAULT_SETTINGS);\n\t\t\tif (typeof document !== \"undefined\") {\n\t\t\t\ttry {\n\t\t\t\t\tconst parsed = JSON.parse(raw) as unknown;\n\t\t\t\t\tif (!isCompactStore(parsed)) {\n\t\t\t\t\t\tbase.setItem(key, encodeStore(expanded));\n\t\t\t\t\t}\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore malformed cookie during migration\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn JSON.stringify(expanded);\n\t\t},\n\t\tsetItem: (key: string, value: string) => {\n\t\t\tconst expanded = decodeStore(value, DEFAULT_SETTINGS);\n\t\t\tbase.setItem(key, encodeStore(expanded));\n\t\t},\n\t\tremoveItem: base.removeItem,\n\t\tsubscribe: (key: string, callback: (value: string | null) => void) => {\n\t\t\tconst unsubscribe = base.subscribe?.(key, (value) => {\n\t\t\t\tif (!value) {\n\t\t\t\t\tcallback(null);\n\t\t\t\t\treturn;\n\t\t\t\t}\n\t\t\t\tconst expanded = decodeStore(value, DEFAULT_SETTINGS);\n\t\t\t\tcallback(JSON.stringify(expanded));\n\t\t\t});\n\t\t\treturn () => {\n\t\t\t\tunsubscribe?.();\n\t\t\t};\n\t\t},\n\t};\n};\n","import { BehaviorSubject } from \"rxjs\";\nimport { type SyncableStorage, safeLocalStorage } from \"./storage\";\n\nexport const createStore = <T>(\n\tkey: string,\n\tdefaultValue: T,\n\tstorage: SyncableStorage = safeLocalStorage,\n) => {\n\tconst subject = new BehaviorSubject<T>(\n\t\tgetStoredData(key, defaultValue, storage),\n\t);\n\n\t// Cross-tab sync via storage.subscribe (uses storage event for localStorage, BroadcastChannel for cookies)\n\t// Only subscribe if window is available (client-side) and storage supports it\n\tlet unsubscribeStorage: (() => void) | undefined;\n\tif (typeof window !== \"undefined\" && storage.subscribe) {\n\t\tunsubscribeStorage = storage.subscribe(key, (newValue) => {\n\t\t\tsubject.next(parseData(newValue, defaultValue));\n\t\t});\n\t}\n\n\tconst update = (val: T) => {\n\t\tsetStoredData(key, val, storage);\n\t\tsubject.next(val);\n\t};\n\n\treturn {\n\t\tobservable: subject.asObservable(),\n\t\tset: (val: T) => update(val),\n\t\tmutate: (transform: (prev: T) => T) =>\n\t\t\tupdate(transform(subject.getValue())),\n\t\tget: () => structuredClone(subject.getValue()),\n\t\t/**\n\t\t * Cleanup subscriptions. Call this when the store is no longer needed.\n\t\t */\n\t\tdestroy: () => {\n\t\t\tunsubscribeStorage?.();\n\t\t\tsubject.complete();\n\t\t},\n\t};\n};\n\nconst parseData = <T>(str: string | null, defaultValue: T): T => {\n\ttry {\n\t\tif (str) return JSON.parse(str);\n\t} catch {\n\t\t// invalid data\n\t}\n\treturn defaultValue;\n};\n\nconst getStoredData = <T>(\n\tkey: string,\n\tdefaultValue: T,\n\tstorage: SyncableStorage,\n): T => {\n\tconst str = storage.getItem(key);\n\treturn parseData(str, defaultValue);\n};\n\nconst setStoredData = <T>(key: string, val: T, storage: SyncableStorage) => {\n\tconst str = JSON.stringify(val);\n\tstorage.setItem(key, str);\n};\n"]}

package/dist/chunk-PNPPI5CH.mjs

@@ -0,0 +1,201 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/utils/storage.ts
+var noopStorage = {
+  getItem: () => null,
+  setItem: () => {
+  },
+  removeItem: () => {
+  }
+};
+var _safeLocalStorage = null;
+var createSafeLocalStorage = () => {
+  if (typeof window === "undefined") return noopStorage;
+  try {
+    const testKey = "__kheopskit_test__";
+    window.localStorage.setItem(testKey, testKey);
+    window.localStorage.removeItem(testKey);
+    return {
+      getItem: (key) => window.localStorage.getItem(key),
+      setItem: (key, value) => window.localStorage.setItem(key, value),
+      removeItem: (key) => window.localStorage.removeItem(key),
+      subscribe: (key, callback) => {
+        const handler = (event) => {
+          if (event.key === key) {
+            callback(event.newValue);
+          }
+        };
+        window.addEventListener("storage", handler);
+        return () => window.removeEventListener("storage", handler);
+      }
+    };
+  } catch {
+    return noopStorage;
+  }
+};
+var getSafeLocalStorage = () => {
+  if (_safeLocalStorage === null) {
+    _safeLocalStorage = createSafeLocalStorage();
+  }
+  return _safeLocalStorage;
+};
+var safeLocalStorage = {
+  getItem: (key) => getSafeLocalStorage().getItem(key),
+  setItem: (key, value) => getSafeLocalStorage().setItem(key, value),
+  removeItem: (key) => getSafeLocalStorage().removeItem(key),
+  subscribe: (key, callback) => {
+    const storage = getSafeLocalStorage();
+    return storage.subscribe?.(key, callback) ?? (() => {
+    });
+  }
+};
+var parseCookie = (cookieString, key) => {
+  if (!cookieString) return null;
+  for (const cookie of cookieString.split(";")) {
+    const [k, ...v] = cookie.split("=");
+    const cookieKey = k?.trim();
+    if (cookieKey === key) {
+      try {
+        return decodeURIComponent(v.join("=").trim());
+      } catch {
+        return null;
+      }
+    }
+  }
+  return null;
+};
+var COOKIE_MAX_SIZE = 3 * 1024;
+var BROADCAST_CHANNEL_NAME = "kheopskit-storage-sync";
+var sharedBroadcastChannel = null;
+var getBroadcastChannel = () => {
+  if (sharedBroadcastChannel) return sharedBroadcastChannel;
+  if (typeof BroadcastChannel === "undefined") return null;
+  try {
+    sharedBroadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);
+  } catch {
+  }
+  return sharedBroadcastChannel;
+};
+var isSecureConnection = () => typeof window !== "undefined" && window.location.protocol === "https:";
+var cookieStorage = (initialCookies) => {
+  return {
+    getItem: (key) => {
+      const cookieString = typeof document !== "undefined" ? document.cookie : initialCookies;
+      return parseCookie(cookieString, key);
+    },
+    setItem: (key, value) => {
+      if (typeof document === "undefined") return;
+      const encodedValue = encodeURIComponent(value);
+      if (encodedValue.length > COOKIE_MAX_SIZE) {
+        console.warn(
+          `[kheopskit] Cookie value for "${key}" exceeds recommended size limit (${encodedValue.length} > ${COOKIE_MAX_SIZE} bytes). This may cause issues with cookie storage. Consider reducing the number of connected wallets.`
+        );
+      }
+      const expires = /* @__PURE__ */ new Date();
+      expires.setFullYear(expires.getFullYear() + 1);
+      let cookieStr = `${key}=${encodedValue};expires=${expires.toUTCString()};path=/;SameSite=Lax`;
+      if (isSecureConnection()) {
+        cookieStr += ";Secure";
+      }
+      document.cookie = cookieStr;
+      getBroadcastChannel()?.postMessage({ type: "set", key, value });
+    },
+    removeItem: (key) => {
+      if (typeof document === "undefined") return;
+      let cookieStr = `${key}=;expires=Thu, 01 Jan 1970 00:00:01 GMT;path=/;SameSite=Lax`;
+      if (isSecureConnection()) {
+        cookieStr += ";Secure";
+      }
+      document.cookie = cookieStr;
+      getBroadcastChannel()?.postMessage({ type: "remove", key });
+    },
+    subscribe: (key, callback) => {
+      const channel = getBroadcastChannel();
+      if (!channel) return () => {
+      };
+      const handler = (event) => {
+        const data = event.data;
+        if (data.key === key) {
+          if (data.type === "set") {
+            callback(data.value ?? null);
+          } else if (data.type === "remove") {
+            callback(null);
+          }
+        }
+      };
+      channel.addEventListener("message", handler);
+      return () => {
+        channel.removeEventListener("message", handler);
+      };
+    }
+  };
+};
+
+// src/utils/isWalletPlatform.ts
+var isWalletPlatform = (platform) => typeof platform === "string" && ["polkadot", "ethereum", "solana"].includes(platform);
+
+// src/utils/WalletId.ts
+var getWalletId = (platform, identifier) => {
+  if (!isWalletPlatform(platform)) throw new Error("Invalid platform");
+  if (!identifier) throw new Error("Invalid name");
+  return `${platform}:${identifier}`;
+};
+var parseWalletId = (walletId) => {
+  if (!walletId) throw new Error("Invalid walletId");
+  const [platform, identifier] = walletId.split(":");
+  if (!isWalletPlatform(platform)) throw new Error("Invalid platform");
+  if (!identifier) throw new Error("Invalid address");
+  return { platform, identifier };
+};
+var isValidWalletId = (walletId) => {
+  if (typeof walletId !== "string" || !walletId) return false;
+  const [platform, identifier] = walletId.split(":");
+  return isWalletPlatform(platform) && !!identifier;
+};
+
+// src/utils/getCachedObservable.ts
+var CACHE_SYMBOL = /* @__PURE__ */ Symbol.for("kheopskit.observableCache");
+var getCache = () => {
+  const g = globalThis;
+  let cache = g[CACHE_SYMBOL];
+  if (!cache) {
+    cache = /* @__PURE__ */ new Map();
+    g[CACHE_SYMBOL] = cache;
+  }
+  return cache;
+};
+var getCachedObservable$ = (key, create) => {
+  const cache = getCache();
+  if (!cache.has(key)) cache.set(key, create());
+  return cache.get(key);
+};
+var clearCachedObservable = (key) => {
+  getCache().delete(key);
+};
+var clearCachedObservablesByPrefix = (prefix) => {
+  const cache = getCache();
+  for (const key of cache.keys()) {
+    if (key.startsWith(prefix)) cache.delete(key);
+  }
+};
+var clearAllCachedObservables = () => {
+  getCache().clear();
+};
+
+export {
+  __publicField,
+  getSafeLocalStorage,
+  safeLocalStorage,
+  cookieStorage,
+  isWalletPlatform,
+  getWalletId,
+  parseWalletId,
+  isValidWalletId,
+  getCachedObservable$,
+  clearCachedObservable,
+  clearCachedObservablesByPrefix,
+  clearAllCachedObservables
+};
+//# sourceMappingURL=chunk-PNPPI5CH.mjs.map

package/dist/chunk-PNPPI5CH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/storage.ts","../src/utils/isWalletPlatform.ts","../src/utils/WalletId.ts","../src/utils/getCachedObservable.ts"],"sourcesContent":["export type Storage = {\n\tgetItem: (key: string) => string | null;\n\tsetItem: (key: string, value: string) => void;\n\tremoveItem: (key: string) => void;\n};\n\n/**\n * Extended storage interface with cross-tab sync support.\n */\nexport type SyncableStorage = Storage & {\n\t/**\n\t * Subscribe to storage changes from other tabs.\n\t * Returns an unsubscribe function.\n\t */\n\tsubscribe?: (\n\t\tkey: string,\n\t\tcallback: (value: string | null) => void,\n\t) => () => void;\n};\n\n/**\n * A no-op storage implementation that does nothing.\n * Useful for testing or SSR environments where no storage is needed.\n */\nexport const noopStorage: SyncableStorage = {\n\tgetItem: () => null,\n\tsetItem: () => {},\n\tremoveItem: () => {},\n};\n\n/**\n * Cached localStorage wrapper instance.\n * Lazily initialized on first access to avoid SSR issues.\n */\nlet _safeLocalStorage: SyncableStorage | null = null;\n\n/**\n * Creates the localStorage wrapper, testing for availability.\n * Returns noopStorage if localStorage is unavailable (SSR, private browsing, etc.)\n */\nconst createSafeLocalStorage = (): SyncableStorage => {\n\tif (typeof window === \"undefined\") return noopStorage;\n\n\ttry {\n\t\t// Test that localStorage is accessible (may throw in private browsing)\n\t\tconst testKey = \"__kheopskit_test__\";\n\t\twindow.localStorage.setItem(testKey, testKey);\n\t\twindow.localStorage.removeItem(testKey);\n\n\t\treturn {\n\t\t\tgetItem: (key: string) => window.localStorage.getItem(key),\n\t\t\tsetItem: (key: string, value: string) =>\n\t\t\t\twindow.localStorage.setItem(key, value),\n\t\t\tremoveItem: (key: string) => window.localStorage.removeItem(key),\n\t\t\tsubscribe: (key: string, callback: (value: string | null) => void) => {\n\t\t\t\tconst handler = (event: StorageEvent) => {\n\t\t\t\t\tif (event.key === key) {\n\t\t\t\t\t\tcallback(event.newValue);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t\twindow.addEventListener(\"storage\", handler);\n\t\t\t\treturn () => window.removeEventListener(\"storage\", handler);\n\t\t\t},\n\t\t};\n\t} catch {\n\t\treturn noopStorage;\n\t}\n};\n\n/**\n * A safe localStorage wrapper that falls back to noopStorage\n * when localStorage is not available (e.g., during SSR).\n * Includes cross-tab sync via the native 'storage' event.\n *\n * Lazily initialized on first access to be SSR-safe.\n */\nexport const getSafeLocalStorage = (): SyncableStorage => {\n\tif (_safeLocalStorage === null) {\n\t\t_safeLocalStorage = createSafeLocalStorage();\n\t}\n\treturn _safeLocalStorage;\n};\n\n/**\n * @deprecated Use getSafeLocalStorage() instead. This is kept for backward compatibility.\n * Returns a proxy that lazily initializes on first method call.\n */\nexport const safeLocalStorage: SyncableStorage = {\n\tgetItem: (key: string) => getSafeLocalStorage().getItem(key),\n\tsetItem: (key: string, value: string) =>\n\t\tgetSafeLocalStorage().setItem(key, value),\n\tremoveItem: (key: string) => getSafeLocalStorage().removeItem(key),\n\tsubscribe: (key: string, callback: (value: string | null) => void) => {\n\t\tconst storage = getSafeLocalStorage();\n\t\treturn storage.subscribe?.(key, callback) ?? (() => {});\n\t},\n};\n\n/**\n * Parse a cookie string to extract the value for a specific key.\n * @param cookieString - The full cookie header string (e.g., document.cookie or req.headers.cookie)\n * @param key - The cookie key to find\n * @returns The cookie value or null if not found\n */\nexport const parseCookie = (\n\tcookieString: string | undefined,\n\tkey: string,\n): string | null => {\n\tif (!cookieString) return null;\n\n\tfor (const cookie of cookieString.split(\";\")) {\n\t\tconst [k, ...v] = cookie.split(\"=\");\n\t\tconst cookieKey = k?.trim();\n\t\tif (cookieKey === key) {\n\t\t\ttry {\n\t\t\t\treturn decodeURIComponent(v.join(\"=\").trim());\n\t\t\t} catch {\n\t\t\t\treturn null; // Malformed cookie value\n\t\t\t}\n\t\t}\n\t}\n\n\treturn null;\n};\n\n/**\n * Maximum recommended size for cookie storage (3KB to stay well under 4KB limit).\n *\n * @remarks\n * Cookie storage is subject to browser limits (typically 4KB per cookie).\n * When users connect many wallets, the auto-reconnect list may exceed this limit.\n * If this happens:\n * - A console warning will be logged\n * - Some browsers may silently reject the cookie\n * - Consider using fewer simultaneous wallet connections\n *\n * The stored data includes wallet IDs in format `platform:identifier`\n * (e.g., `polkadot:talisman`, `ethereum:io.metamask`).\n */\nexport const COOKIE_MAX_SIZE = 3 * 1024;\n\n/**\n * BroadcastChannel name for cross-tab cookie sync.\n */\nconst BROADCAST_CHANNEL_NAME = \"kheopskit-storage-sync\";\n\n/**\n * Singleton BroadcastChannel for cross-tab cookie sync.\n * Created once and shared across all cookieStorage instances.\n */\nlet sharedBroadcastChannel: BroadcastChannel | null = null;\n\nconst getBroadcastChannel = (): BroadcastChannel | null => {\n\tif (sharedBroadcastChannel) return sharedBroadcastChannel;\n\tif (typeof BroadcastChannel === \"undefined\") return null;\n\n\ttry {\n\t\tsharedBroadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);\n\t} catch {\n\t\t// BroadcastChannel not supported or failed\n\t}\n\treturn sharedBroadcastChannel;\n};\n\n/**\n * Check if the current connection is secure (HTTPS).\n * Must be called at runtime (inside methods) to work correctly after SSR hydration.\n */\nconst isSecureConnection = (): boolean =>\n\ttypeof window !== \"undefined\" && window.location.protocol === \"https:\";\n\n/**\n * A cookie-based storage implementation for SSR environments.\n * Reads cookies from an optional initial cookie string (for SSR hydration),\n * writes to document.cookie on the client.\n *\n * Features:\n * - Secure flag automatically added for HTTPS connections\n * - Cross-tab synchronization via BroadcastChannel API\n * - Size limit warning when data exceeds recommended limits\n *\n * @param initialCookies - Optional cookie string for server-side hydration\n */\nexport const cookieStorage = (initialCookies?: string): SyncableStorage => {\n\treturn {\n\t\tgetItem: (key: string) => {\n\t\t\t// On server, use initialCookies. On client, read from document.cookie\n\t\t\tconst cookieString =\n\t\t\t\ttypeof document !== \"undefined\" ? document.cookie : initialCookies;\n\t\t\treturn parseCookie(cookieString, key);\n\t\t},\n\t\tsetItem: (key: string, value: string) => {\n\t\t\tif (typeof document === \"undefined\") return;\n\n\t\t\t// Warn if value exceeds recommended size\n\t\t\tconst encodedValue = encodeURIComponent(value);\n\t\t\tif (encodedValue.length > COOKIE_MAX_SIZE) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[kheopskit] Cookie value for \"${key}\" exceeds recommended size limit (${encodedValue.length} > ${COOKIE_MAX_SIZE} bytes). ` +\n\t\t\t\t\t\t\"This may cause issues with cookie storage. Consider reducing the number of connected wallets.\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Set cookie with 1 year expiry\n\t\t\tconst expires = new Date();\n\t\t\texpires.setFullYear(expires.getFullYear() + 1);\n\n\t\t\t// Build cookie string with security attributes\n\t\t\tlet cookieStr = `${key}=${encodedValue};expires=${expires.toUTCString()};path=/;SameSite=Lax`;\n\t\t\tif (isSecureConnection()) {\n\t\t\t\tcookieStr += \";Secure\";\n\t\t\t}\n\n\t\t\t// biome-ignore lint: necessary for cookie storage - direct cookie assignment is the standard API\n\t\t\tdocument.cookie = cookieStr;\n\n\t\t\t// Broadcast change to other tabs\n\t\t\tgetBroadcastChannel()?.postMessage({ type: \"set\", key, value });\n\t\t},\n\t\tremoveItem: (key: string) => {\n\t\t\tif (typeof document === \"undefined\") return;\n\n\t\t\t// Build delete cookie string\n\t\t\tlet cookieStr = `${key}=;expires=Thu, 01 Jan 1970 00:00:01 GMT;path=/;SameSite=Lax`;\n\t\t\tif (isSecureConnection()) {\n\t\t\t\tcookieStr += \";Secure\";\n\t\t\t}\n\n\t\t\t// biome-ignore lint: necessary for cookie storage - direct cookie assignment is the standard API\n\t\t\tdocument.cookie = cookieStr;\n\n\t\t\t// Broadcast change to other tabs\n\t\t\tgetBroadcastChannel()?.postMessage({ type: \"remove\", key });\n\t\t},\n\t\tsubscribe: (key: string, callback: (value: string | null) => void) => {\n\t\t\tconst channel = getBroadcastChannel();\n\t\t\tif (!channel) return () => {};\n\n\t\t\tconst handler = (event: MessageEvent) => {\n\t\t\t\tconst data = event.data as {\n\t\t\t\t\ttype: string;\n\t\t\t\t\tkey: string;\n\t\t\t\t\tvalue?: string;\n\t\t\t\t};\n\t\t\t\tif (data.key === key) {\n\t\t\t\t\tif (data.type === \"set\") {\n\t\t\t\t\t\tcallback(data.value ?? null);\n\t\t\t\t\t} else if (data.type === \"remove\") {\n\t\t\t\t\t\tcallback(null);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t};\n\n\t\t\tchannel.addEventListener(\"message\", handler);\n\t\t\treturn () => {\n\t\t\t\tchannel.removeEventListener(\"message\", handler);\n\t\t\t};\n\t\t},\n\t};\n};\n\n/**\n * Cleanup the shared BroadcastChannel used for cross-tab cookie sync.\n * Call this when you're done using cookie storage (e.g., in tests or when unmounting).\n *\n * @remarks\n * In normal browser usage, you typically don't need to call this -\n * the channel will be cleaned up when the page is closed.\n * This is primarily useful for testing environments where multiple\n * test runs may accumulate channels.\n */\nexport const cleanupBroadcastChannel = (): void => {\n\tif (sharedBroadcastChannel) {\n\t\tsharedBroadcastChannel.close();\n\t\tsharedBroadcastChannel = null;\n\t}\n};\n","import type { WalletPlatform } from \"../api/types\";\n\nexport const isWalletPlatform = (\n\tplatform: unknown,\n): platform is WalletPlatform =>\n\ttypeof platform === \"string\" &&\n\t[\"polkadot\", \"ethereum\", \"solana\"].includes(platform as WalletPlatform);\n","import type { WalletPlatform } from \"../api/types\";\nimport { isWalletPlatform } from \"./isWalletPlatform\";\n\nexport type WalletId = string;\n\nexport const getWalletId = (\n\tplatform: WalletPlatform,\n\tidentifier: string,\n): WalletId => {\n\tif (!isWalletPlatform(platform)) throw new Error(\"Invalid platform\");\n\tif (!identifier) throw new Error(\"Invalid name\");\n\treturn `${platform}:${identifier}`;\n};\n\nexport const parseWalletId = (walletId: string) => {\n\tif (!walletId) throw new Error(\"Invalid walletId\");\n\tconst [platform, identifier] = walletId.split(\":\");\n\tif (!isWalletPlatform(platform)) throw new Error(\"Invalid platform\");\n\tif (!identifier) throw new Error(\"Invalid address\");\n\treturn { platform, identifier };\n};\n\n/**\n * Non-throwing variant of {@link parseWalletId}. Use when validating untrusted\n * input (e.g. cached state persisted by an older version) before parsing.\n */\nexport const isValidWalletId = (walletId: unknown): walletId is WalletId => {\n\tif (typeof walletId !== \"string\" || !walletId) return false;\n\tconst [platform, identifier] = walletId.split(\":\");\n\treturn isWalletPlatform(platform) && !!identifier;\n};\n","import type { Observable } from \"rxjs\";\n\n// Anchored on globalThis so the cache stays a single instance even if the\n// module is duplicated across bundle chunks (e.g. CJS subpath entries).\nconst CACHE_SYMBOL = Symbol.for(\"kheopskit.observableCache\");\n\nconst getCache = (): Map<string, Observable<unknown>> => {\n\tconst g = globalThis as unknown as Record<\n\t\tsymbol,\n\t\tMap<string, Observable<unknown>> | undefined\n\t>;\n\tlet cache = g[CACHE_SYMBOL];\n\tif (!cache) {\n\t\tcache = new Map();\n\t\tg[CACHE_SYMBOL] = cache;\n\t}\n\treturn cache;\n};\n\nexport const getCachedObservable$ = <T, Obs = Observable<T>>(\n\tkey: string,\n\tcreate: () => Obs,\n): Obs => {\n\tconst cache = getCache();\n\tif (!cache.has(key)) cache.set(key, create() as Observable<unknown>);\n\n\treturn cache.get(key) as Obs;\n};\n\n/**\n * Clears an observable from the cache.\n * Use when a wallet disconnects or configuration changes.\n */\nexport const clearCachedObservable = (key: string): void => {\n\tgetCache().delete(key);\n};\n\n/**\n * Clears all cached observables whose key starts with `prefix`.\n *\n * Used to drop a wallet's account observables when it disconnects, so a later\n * reconnect rebuilds them against the current wallet handle instead of a stale\n * closure — and to keep the cache from growing unbounded across connect cycles.\n */\nexport const clearCachedObservablesByPrefix = (prefix: string): void => {\n\tconst cache = getCache();\n\tfor (const key of cache.keys()) {\n\t\tif (key.startsWith(prefix)) cache.delete(key);\n\t}\n};\n\n/**\n * Clears all cached observables.\n * Use when resetting the entire kheopskit state.\n */\nexport const clearAllCachedObservables = (): void => {\n\tgetCache().clear();\n};\n"],"mappings":"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","names":[]}

package/dist/chunk-SIUWQBT4.js

@@ -0,0 +1,201 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/utils/storage.ts
+var noopStorage = {
+  getItem: () => null,
+  setItem: () => {
+  },
+  removeItem: () => {
+  }
+};
+var _safeLocalStorage = null;
+var createSafeLocalStorage = () => {
+  if (typeof window === "undefined") return noopStorage;
+  try {
+    const testKey = "__kheopskit_test__";
+    window.localStorage.setItem(testKey, testKey);
+    window.localStorage.removeItem(testKey);
+    return {
+      getItem: (key) => window.localStorage.getItem(key),
+      setItem: (key, value) => window.localStorage.setItem(key, value),
+      removeItem: (key) => window.localStorage.removeItem(key),
+      subscribe: (key, callback) => {
+        const handler = (event) => {
+          if (event.key === key) {
+            callback(event.newValue);
+          }
+        };
+        window.addEventListener("storage", handler);
+        return () => window.removeEventListener("storage", handler);
+      }
+    };
+  } catch (e) {
+    return noopStorage;
+  }
+};
+var getSafeLocalStorage = () => {
+  if (_safeLocalStorage === null) {
+    _safeLocalStorage = createSafeLocalStorage();
+  }
+  return _safeLocalStorage;
+};
+var safeLocalStorage = {
+  getItem: (key) => getSafeLocalStorage().getItem(key),
+  setItem: (key, value) => getSafeLocalStorage().setItem(key, value),
+  removeItem: (key) => getSafeLocalStorage().removeItem(key),
+  subscribe: (key, callback) => {
+    const storage = getSafeLocalStorage();
+    return _nullishCoalesce(_optionalChain([storage, 'access', _ => _.subscribe, 'optionalCall', _2 => _2(key, callback)]), () => ( (() => {
+    })));
+  }
+};
+var parseCookie = (cookieString, key) => {
+  if (!cookieString) return null;
+  for (const cookie of cookieString.split(";")) {
+    const [k, ...v] = cookie.split("=");
+    const cookieKey = _optionalChain([k, 'optionalAccess', _3 => _3.trim, 'call', _4 => _4()]);
+    if (cookieKey === key) {
+      try {
+        return decodeURIComponent(v.join("=").trim());
+      } catch (e2) {
+        return null;
+      }
+    }
+  }
+  return null;
+};
+var COOKIE_MAX_SIZE = 3 * 1024;
+var BROADCAST_CHANNEL_NAME = "kheopskit-storage-sync";
+var sharedBroadcastChannel = null;
+var getBroadcastChannel = () => {
+  if (sharedBroadcastChannel) return sharedBroadcastChannel;
+  if (typeof BroadcastChannel === "undefined") return null;
+  try {
+    sharedBroadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);
+  } catch (e3) {
+  }
+  return sharedBroadcastChannel;
+};
+var isSecureConnection = () => typeof window !== "undefined" && window.location.protocol === "https:";
+var cookieStorage = (initialCookies) => {
+  return {
+    getItem: (key) => {
+      const cookieString = typeof document !== "undefined" ? document.cookie : initialCookies;
+      return parseCookie(cookieString, key);
+    },
+    setItem: (key, value) => {
+      if (typeof document === "undefined") return;
+      const encodedValue = encodeURIComponent(value);
+      if (encodedValue.length > COOKIE_MAX_SIZE) {
+        console.warn(
+          `[kheopskit] Cookie value for "${key}" exceeds recommended size limit (${encodedValue.length} > ${COOKIE_MAX_SIZE} bytes). This may cause issues with cookie storage. Consider reducing the number of connected wallets.`
+        );
+      }
+      const expires = /* @__PURE__ */ new Date();
+      expires.setFullYear(expires.getFullYear() + 1);
+      let cookieStr = `${key}=${encodedValue};expires=${expires.toUTCString()};path=/;SameSite=Lax`;
+      if (isSecureConnection()) {
+        cookieStr += ";Secure";
+      }
+      document.cookie = cookieStr;
+      _optionalChain([getBroadcastChannel, 'call', _5 => _5(), 'optionalAccess', _6 => _6.postMessage, 'call', _7 => _7({ type: "set", key, value })]);
+    },
+    removeItem: (key) => {
+      if (typeof document === "undefined") return;
+      let cookieStr = `${key}=;expires=Thu, 01 Jan 1970 00:00:01 GMT;path=/;SameSite=Lax`;
+      if (isSecureConnection()) {
+        cookieStr += ";Secure";
+      }
+      document.cookie = cookieStr;
+      _optionalChain([getBroadcastChannel, 'call', _8 => _8(), 'optionalAccess', _9 => _9.postMessage, 'call', _10 => _10({ type: "remove", key })]);
+    },
+    subscribe: (key, callback) => {
+      const channel = getBroadcastChannel();
+      if (!channel) return () => {
+      };
+      const handler = (event) => {
+        const data = event.data;
+        if (data.key === key) {
+          if (data.type === "set") {
+            callback(_nullishCoalesce(data.value, () => ( null)));
+          } else if (data.type === "remove") {
+            callback(null);
+          }
+        }
+      };
+      channel.addEventListener("message", handler);
+      return () => {
+        channel.removeEventListener("message", handler);
+      };
+    }
+  };
+};
+
+// src/utils/isWalletPlatform.ts
+var isWalletPlatform = (platform) => typeof platform === "string" && ["polkadot", "ethereum", "solana"].includes(platform);
+
+// src/utils/WalletId.ts
+var getWalletId = (platform, identifier) => {
+  if (!isWalletPlatform(platform)) throw new Error("Invalid platform");
+  if (!identifier) throw new Error("Invalid name");
+  return `${platform}:${identifier}`;
+};
+var parseWalletId = (walletId) => {
+  if (!walletId) throw new Error("Invalid walletId");
+  const [platform, identifier] = walletId.split(":");
+  if (!isWalletPlatform(platform)) throw new Error("Invalid platform");
+  if (!identifier) throw new Error("Invalid address");
+  return { platform, identifier };
+};
+var isValidWalletId = (walletId) => {
+  if (typeof walletId !== "string" || !walletId) return false;
+  const [platform, identifier] = walletId.split(":");
+  return isWalletPlatform(platform) && !!identifier;
+};
+
+// src/utils/getCachedObservable.ts
+var CACHE_SYMBOL = /* @__PURE__ */ Symbol.for("kheopskit.observableCache");
+var getCache = () => {
+  const g = globalThis;
+  let cache = g[CACHE_SYMBOL];
+  if (!cache) {
+    cache = /* @__PURE__ */ new Map();
+    g[CACHE_SYMBOL] = cache;
+  }
+  return cache;
+};
+var getCachedObservable$ = (key, create) => {
+  const cache = getCache();
+  if (!cache.has(key)) cache.set(key, create());
+  return cache.get(key);
+};
+var clearCachedObservable = (key) => {
+  getCache().delete(key);
+};
+var clearCachedObservablesByPrefix = (prefix) => {
+  const cache = getCache();
+  for (const key of cache.keys()) {
+    if (key.startsWith(prefix)) cache.delete(key);
+  }
+};
+var clearAllCachedObservables = () => {
+  getCache().clear();
+};
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+exports.__publicField = __publicField; exports.getSafeLocalStorage = getSafeLocalStorage; exports.safeLocalStorage = safeLocalStorage; exports.cookieStorage = cookieStorage; exports.isWalletPlatform = isWalletPlatform; exports.getWalletId = getWalletId; exports.parseWalletId = parseWalletId; exports.isValidWalletId = isValidWalletId; exports.getCachedObservable$ = getCachedObservable$; exports.clearCachedObservable = clearCachedObservable; exports.clearCachedObservablesByPrefix = clearCachedObservablesByPrefix; exports.clearAllCachedObservables = clearAllCachedObservables;
+//# sourceMappingURL=chunk-SIUWQBT4.js.map

package/dist/chunk-SIUWQBT4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/home/runner/work/kheopskit/kheopskit/packages/core/dist/chunk-SIUWQBT4.js","../src/utils/storage.ts","../src/utils/isWalletPlatform.ts","../src/utils/WalletId.ts","../src/utils/getCachedObservable.ts"],"names":[],"mappings":"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","file":"/home/runner/work/kheopskit/kheopskit/packages/core/dist/chunk-SIUWQBT4.js","sourcesContent":[null,"export type Storage = {\n\tgetItem: (key: string) => string | null;\n\tsetItem: (key: string, value: string) => void;\n\tremoveItem: (key: string) => void;\n};\n\n/**\n * Extended storage interface with cross-tab sync support.\n */\nexport type SyncableStorage = Storage & {\n\t/**\n\t * Subscribe to storage changes from other tabs.\n\t * Returns an unsubscribe function.\n\t */\n\tsubscribe?: (\n\t\tkey: string,\n\t\tcallback: (value: string | null) => void,\n\t) => () => void;\n};\n\n/**\n * A no-op storage implementation that does nothing.\n * Useful for testing or SSR environments where no storage is needed.\n */\nexport const noopStorage: SyncableStorage = {\n\tgetItem: () => null,\n\tsetItem: () => {},\n\tremoveItem: () => {},\n};\n\n/**\n * Cached localStorage wrapper instance.\n * Lazily initialized on first access to avoid SSR issues.\n */\nlet _safeLocalStorage: SyncableStorage | null = null;\n\n/**\n * Creates the localStorage wrapper, testing for availability.\n * Returns noopStorage if localStorage is unavailable (SSR, private browsing, etc.)\n */\nconst createSafeLocalStorage = (): SyncableStorage => {\n\tif (typeof window === \"undefined\") return noopStorage;\n\n\ttry {\n\t\t// Test that localStorage is accessible (may throw in private browsing)\n\t\tconst testKey = \"__kheopskit_test__\";\n\t\twindow.localStorage.setItem(testKey, testKey);\n\t\twindow.localStorage.removeItem(testKey);\n\n\t\treturn {\n\t\t\tgetItem: (key: string) => window.localStorage.getItem(key),\n\t\t\tsetItem: (key: string, value: string) =>\n\t\t\t\twindow.localStorage.setItem(key, value),\n\t\t\tremoveItem: (key: string) => window.localStorage.removeItem(key),\n\t\t\tsubscribe: (key: string, callback: (value: string | null) => void) => {\n\t\t\t\tconst handler = (event: StorageEvent) => {\n\t\t\t\t\tif (event.key === key) {\n\t\t\t\t\t\tcallback(event.newValue);\n\t\t\t\t\t}\n\t\t\t\t};\n\t\t\t\twindow.addEventListener(\"storage\", handler);\n\t\t\t\treturn () => window.removeEventListener(\"storage\", handler);\n\t\t\t},\n\t\t};\n\t} catch {\n\t\treturn noopStorage;\n\t}\n};\n\n/**\n * A safe localStorage wrapper that falls back to noopStorage\n * when localStorage is not available (e.g., during SSR).\n * Includes cross-tab sync via the native 'storage' event.\n *\n * Lazily initialized on first access to be SSR-safe.\n */\nexport const getSafeLocalStorage = (): SyncableStorage => {\n\tif (_safeLocalStorage === null) {\n\t\t_safeLocalStorage = createSafeLocalStorage();\n\t}\n\treturn _safeLocalStorage;\n};\n\n/**\n * @deprecated Use getSafeLocalStorage() instead. This is kept for backward compatibility.\n * Returns a proxy that lazily initializes on first method call.\n */\nexport const safeLocalStorage: SyncableStorage = {\n\tgetItem: (key: string) => getSafeLocalStorage().getItem(key),\n\tsetItem: (key: string, value: string) =>\n\t\tgetSafeLocalStorage().setItem(key, value),\n\tremoveItem: (key: string) => getSafeLocalStorage().removeItem(key),\n\tsubscribe: (key: string, callback: (value: string | null) => void) => {\n\t\tconst storage = getSafeLocalStorage();\n\t\treturn storage.subscribe?.(key, callback) ?? (() => {});\n\t},\n};\n\n/**\n * Parse a cookie string to extract the value for a specific key.\n * @param cookieString - The full cookie header string (e.g., document.cookie or req.headers.cookie)\n * @param key - The cookie key to find\n * @returns The cookie value or null if not found\n */\nexport const parseCookie = (\n\tcookieString: string | undefined,\n\tkey: string,\n): string | null => {\n\tif (!cookieString) return null;\n\n\tfor (const cookie of cookieString.split(\";\")) {\n\t\tconst [k, ...v] = cookie.split(\"=\");\n\t\tconst cookieKey = k?.trim();\n\t\tif (cookieKey === key) {\n\t\t\ttry {\n\t\t\t\treturn decodeURIComponent(v.join(\"=\").trim());\n\t\t\t} catch {\n\t\t\t\treturn null; // Malformed cookie value\n\t\t\t}\n\t\t}\n\t}\n\n\treturn null;\n};\n\n/**\n * Maximum recommended size for cookie storage (3KB to stay well under 4KB limit).\n *\n * @remarks\n * Cookie storage is subject to browser limits (typically 4KB per cookie).\n * When users connect many wallets, the auto-reconnect list may exceed this limit.\n * If this happens:\n * - A console warning will be logged\n * - Some browsers may silently reject the cookie\n * - Consider using fewer simultaneous wallet connections\n *\n * The stored data includes wallet IDs in format `platform:identifier`\n * (e.g., `polkadot:talisman`, `ethereum:io.metamask`).\n */\nexport const COOKIE_MAX_SIZE = 3 * 1024;\n\n/**\n * BroadcastChannel name for cross-tab cookie sync.\n */\nconst BROADCAST_CHANNEL_NAME = \"kheopskit-storage-sync\";\n\n/**\n * Singleton BroadcastChannel for cross-tab cookie sync.\n * Created once and shared across all cookieStorage instances.\n */\nlet sharedBroadcastChannel: BroadcastChannel | null = null;\n\nconst getBroadcastChannel = (): BroadcastChannel | null => {\n\tif (sharedBroadcastChannel) return sharedBroadcastChannel;\n\tif (typeof BroadcastChannel === \"undefined\") return null;\n\n\ttry {\n\t\tsharedBroadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);\n\t} catch {\n\t\t// BroadcastChannel not supported or failed\n\t}\n\treturn sharedBroadcastChannel;\n};\n\n/**\n * Check if the current connection is secure (HTTPS).\n * Must be called at runtime (inside methods) to work correctly after SSR hydration.\n */\nconst isSecureConnection = (): boolean =>\n\ttypeof window !== \"undefined\" && window.location.protocol === \"https:\";\n\n/**\n * A cookie-based storage implementation for SSR environments.\n * Reads cookies from an optional initial cookie string (for SSR hydration),\n * writes to document.cookie on the client.\n *\n * Features:\n * - Secure flag automatically added for HTTPS connections\n * - Cross-tab synchronization via BroadcastChannel API\n * - Size limit warning when data exceeds recommended limits\n *\n * @param initialCookies - Optional cookie string for server-side hydration\n */\nexport const cookieStorage = (initialCookies?: string): SyncableStorage => {\n\treturn {\n\t\tgetItem: (key: string) => {\n\t\t\t// On server, use initialCookies. On client, read from document.cookie\n\t\t\tconst cookieString =\n\t\t\t\ttypeof document !== \"undefined\" ? document.cookie : initialCookies;\n\t\t\treturn parseCookie(cookieString, key);\n\t\t},\n\t\tsetItem: (key: string, value: string) => {\n\t\t\tif (typeof document === \"undefined\") return;\n\n\t\t\t// Warn if value exceeds recommended size\n\t\t\tconst encodedValue = encodeURIComponent(value);\n\t\t\tif (encodedValue.length > COOKIE_MAX_SIZE) {\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`[kheopskit] Cookie value for \"${key}\" exceeds recommended size limit (${encodedValue.length} > ${COOKIE_MAX_SIZE} bytes). ` +\n\t\t\t\t\t\t\"This may cause issues with cookie storage. Consider reducing the number of connected wallets.\",\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t// Set cookie with 1 year expiry\n\t\t\tconst expires = new Date();\n\t\t\texpires.setFullYear(expires.getFullYear() + 1);\n\n\t\t\t// Build cookie string with security attributes\n\t\t\tlet cookieStr = `${key}=${encodedValue};expires=${expires.toUTCString()};path=/;SameSite=Lax`;\n\t\t\tif (isSecureConnection()) {\n\t\t\t\tcookieStr += \";Secure\";\n\t\t\t}\n\n\t\t\t// biome-ignore lint: necessary for cookie storage - direct cookie assignment is the standard API\n\t\t\tdocument.cookie = cookieStr;\n\n\t\t\t// Broadcast change to other tabs\n\t\t\tgetBroadcastChannel()?.postMessage({ type: \"set\", key, value });\n\t\t},\n\t\tremoveItem: (key: string) => {\n\t\t\tif (typeof document === \"undefined\") return;\n\n\t\t\t// Build delete cookie string\n\t\t\tlet cookieStr = `${key}=;expires=Thu, 01 Jan 1970 00:00:01 GMT;path=/;SameSite=Lax`;\n\t\t\tif (isSecureConnection()) {\n\t\t\t\tcookieStr += \";Secure\";\n\t\t\t}\n\n\t\t\t// biome-ignore lint: necessary for cookie storage - direct cookie assignment is the standard API\n\t\t\tdocument.cookie = cookieStr;\n\n\t\t\t// Broadcast change to other tabs\n\t\t\tgetBroadcastChannel()?.postMessage({ type: \"remove\", key });\n\t\t},\n\t\tsubscribe: (key: string, callback: (value: string | null) => void) => {\n\t\t\tconst channel = getBroadcastChannel();\n\t\t\tif (!channel) return () => {};\n\n\t\t\tconst handler = (event: MessageEvent) => {\n\t\t\t\tconst data = event.data as {\n\t\t\t\t\ttype: string;\n\t\t\t\t\tkey: string;\n\t\t\t\t\tvalue?: string;\n\t\t\t\t};\n\t\t\t\tif (data.key === key) {\n\t\t\t\t\tif (data.type === \"set\") {\n\t\t\t\t\t\tcallback(data.value ?? null);\n\t\t\t\t\t} else if (data.type === \"remove\") {\n\t\t\t\t\t\tcallback(null);\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t};\n\n\t\t\tchannel.addEventListener(\"message\", handler);\n\t\t\treturn () => {\n\t\t\t\tchannel.removeEventListener(\"message\", handler);\n\t\t\t};\n\t\t},\n\t};\n};\n\n/**\n * Cleanup the shared BroadcastChannel used for cross-tab cookie sync.\n * Call this when you're done using cookie storage (e.g., in tests or when unmounting).\n *\n * @remarks\n * In normal browser usage, you typically don't need to call this -\n * the channel will be cleaned up when the page is closed.\n * This is primarily useful for testing environments where multiple\n * test runs may accumulate channels.\n */\nexport const cleanupBroadcastChannel = (): void => {\n\tif (sharedBroadcastChannel) {\n\t\tsharedBroadcastChannel.close();\n\t\tsharedBroadcastChannel = null;\n\t}\n};\n","import type { WalletPlatform } from \"../api/types\";\n\nexport const isWalletPlatform = (\n\tplatform: unknown,\n): platform is WalletPlatform =>\n\ttypeof platform === \"string\" &&\n\t[\"polkadot\", \"ethereum\", \"solana\"].includes(platform as WalletPlatform);\n","import type { WalletPlatform } from \"../api/types\";\nimport { isWalletPlatform } from \"./isWalletPlatform\";\n\nexport type WalletId = string;\n\nexport const getWalletId = (\n\tplatform: WalletPlatform,\n\tidentifier: string,\n): WalletId => {\n\tif (!isWalletPlatform(platform)) throw new Error(\"Invalid platform\");\n\tif (!identifier) throw new Error(\"Invalid name\");\n\treturn `${platform}:${identifier}`;\n};\n\nexport const parseWalletId = (walletId: string) => {\n\tif (!walletId) throw new Error(\"Invalid walletId\");\n\tconst [platform, identifier] = walletId.split(\":\");\n\tif (!isWalletPlatform(platform)) throw new Error(\"Invalid platform\");\n\tif (!identifier) throw new Error(\"Invalid address\");\n\treturn { platform, identifier };\n};\n\n/**\n * Non-throwing variant of {@link parseWalletId}. Use when validating untrusted\n * input (e.g. cached state persisted by an older version) before parsing.\n */\nexport const isValidWalletId = (walletId: unknown): walletId is WalletId => {\n\tif (typeof walletId !== \"string\" || !walletId) return false;\n\tconst [platform, identifier] = walletId.split(\":\");\n\treturn isWalletPlatform(platform) && !!identifier;\n};\n","import type { Observable } from \"rxjs\";\n\n// Anchored on globalThis so the cache stays a single instance even if the\n// module is duplicated across bundle chunks (e.g. CJS subpath entries).\nconst CACHE_SYMBOL = Symbol.for(\"kheopskit.observableCache\");\n\nconst getCache = (): Map<string, Observable<unknown>> => {\n\tconst g = globalThis as unknown as Record<\n\t\tsymbol,\n\t\tMap<string, Observable<unknown>> | undefined\n\t>;\n\tlet cache = g[CACHE_SYMBOL];\n\tif (!cache) {\n\t\tcache = new Map();\n\t\tg[CACHE_SYMBOL] = cache;\n\t}\n\treturn cache;\n};\n\nexport const getCachedObservable$ = <T, Obs = Observable<T>>(\n\tkey: string,\n\tcreate: () => Obs,\n): Obs => {\n\tconst cache = getCache();\n\tif (!cache.has(key)) cache.set(key, create() as Observable<unknown>);\n\n\treturn cache.get(key) as Obs;\n};\n\n/**\n * Clears an observable from the cache.\n * Use when a wallet disconnects or configuration changes.\n */\nexport const clearCachedObservable = (key: string): void => {\n\tgetCache().delete(key);\n};\n\n/**\n * Clears all cached observables whose key starts with `prefix`.\n *\n * Used to drop a wallet's account observables when it disconnects, so a later\n * reconnect rebuilds them against the current wallet handle instead of a stale\n * closure — and to keep the cache from growing unbounded across connect cycles.\n */\nexport const clearCachedObservablesByPrefix = (prefix: string): void => {\n\tconst cache = getCache();\n\tfor (const key of cache.keys()) {\n\t\tif (key.startsWith(prefix)) cache.delete(key);\n\t}\n};\n\n/**\n * Clears all cached observables.\n * Use when resetting the entire kheopskit state.\n */\nexport const clearAllCachedObservables = (): void => {\n\tgetCache().clear();\n};\n"]}