@kheopskit/core 5.1.0 → 5.1.2

package/dist/iconCache-DS4zNiP1.js

@@ -0,0 +1,396 @@
+const require_types = require("./types-DKU-SNio.js");
+const require_polkadotExtensions = require("./polkadotExtensions-y4J9UzYl.js");
+//#region src/utils/hydrateState.ts
+/**
+* Looks up the icon for a wallet from known Polkadot extensions only.
+* Ethereum icons will be populated from the localStorage icon cache via the merge function.
+*
+* Note: We DON'T use localStorage icon cache here because hydrateWallet is called
+* during SSR (server) and client hydration. localStorage isn't available on server,
+* so using it would cause a hydration mismatch. Icons for Ethereum wallets will be
+* populated when the hydration buffer merges cached wallets with live wallets.
+*/
+const lookupWalletIcon = (platform, identifier) => {
+	if (platform === "polkadot") return require_polkadotExtensions.POLKADOT_EXTENSIONS[identifier]?.icon ?? "";
+	return "";
+};
+/**
+* Error thrown when trying to use a placeholder wallet that hasn't fully loaded yet.
+*/
+var PendingWalletError = class extends Error {
+	constructor(walletId) {
+		super(`Wallet ${walletId} is still loading. Wait for isHydrating to be false before calling connect/disconnect.`);
+		this.name = "PendingWalletError";
+	}
+};
+/**
+* Converts a CachedWallet to a placeholder wallet for SSR hydration display.
+*
+* The placeholder carries only the SDK-free {@link BaseWallet} fields; the real
+* wallet (with its injected provider/extension/standard-wallet handle) replaces
+* it once it loads. connect/disconnect throw until then.
+*/
+const hydrateWallet = (cached) => {
+	const throwPending = () => {
+		throw new PendingWalletError(cached.id);
+	};
+	if (cached.type === "walletconnect") return {
+		id: cached.id,
+		type: "walletconnect",
+		platforms: [],
+		name: cached.name,
+		icon: "",
+		isConnected: cached.isConnected,
+		connect: throwPending,
+		disconnect: throwPending
+	};
+	const { platform, identifier } = require_types.parseWalletId(cached.id);
+	return {
+		id: cached.id,
+		platform: cached.platform,
+		type: cached.type,
+		name: cached.name,
+		icon: lookupWalletIcon(platform, identifier),
+		isConnected: cached.isConnected,
+		connect: throwPending,
+		disconnect: throwPending
+	};
+};
+/**
+* Converts a CachedAccount to a placeholder account for SSR hydration display.
+*
+* The placeholder carries the SDK-free {@link BaseWalletAccount} fields plus the
+* plain, serializable platform data that lives in the cache — Ethereum `chainId`
+* and the Polkadot key `type`. Those render immediately on reload (no blank →
+* value flicker) and match what the live account will report. Only the SDK
+* handles (`client`/`signer`/`polkadotSigner`) are absent until the real account
+* replaces this placeholder; signing stays gated on `isHydrating` until then.
+*/
+const hydrateAccount = (cached) => ({
+	id: cached.id,
+	platform: cached.platform,
+	address: cached.address,
+	name: cached.name,
+	walletId: cached.walletId,
+	walletName: cached.walletName,
+	...cached.platform === "ethereum" && { chainId: cached.chainId },
+	...cached.platform === "polkadot" && { type: cached.polkadotAccountType }
+});
+/**
+* Converts a wallet to a CachedWallet for storage.
+* Only extracts the serializable properties needed for hydration.
+*/
+const serializeWallet = (wallet) => ({
+	id: wallet.id,
+	platform: require_types.isWalletConnectWallet(wallet) ? void 0 : wallet.platform,
+	type: wallet.type,
+	name: wallet.name,
+	isConnected: wallet.isConnected
+});
+/**
+* Converts an account to a CachedAccount for storage.
+* Only extracts the serializable properties needed for hydration. Platform-only
+* fields (Ethereum chainId, Polkadot key type) are read defensively so this
+* stays SDK-free.
+*/
+const serializeAccount = (account) => ({
+	id: account.id,
+	platform: account.platform,
+	address: account.address,
+	name: account.name,
+	chainId: account.platform === "ethereum" ? account.chainId : void 0,
+	polkadotAccountType: account.platform === "polkadot" ? account.type : void 0,
+	walletId: account.walletId,
+	walletName: account.walletName
+});
+//#endregion
+//#region src/utils/storage.ts
+/**
+* A no-op storage implementation that does nothing.
+* Useful for testing or SSR environments where no storage is needed.
+*/
+const noopStorage = {
+	getItem: () => null,
+	setItem: () => {},
+	removeItem: () => {}
+};
+/**
+* Cached localStorage wrapper instance.
+* Lazily initialized on first access to avoid SSR issues.
+*/
+let _safeLocalStorage = null;
+/**
+* Creates the localStorage wrapper, testing for availability.
+* Returns noopStorage if localStorage is unavailable (SSR, private browsing, etc.)
+*/
+const 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;
+	}
+};
+/**
+* A safe localStorage wrapper that falls back to noopStorage
+* when localStorage is not available (e.g., during SSR).
+* Includes cross-tab sync via the native 'storage' event.
+*
+* Lazily initialized on first access to be SSR-safe.
+*/
+const getSafeLocalStorage = () => {
+	if (_safeLocalStorage === null) _safeLocalStorage = createSafeLocalStorage();
+	return _safeLocalStorage;
+};
+/**
+* @deprecated Use getSafeLocalStorage() instead. This is kept for backward compatibility.
+* Returns a proxy that lazily initializes on first method call.
+*/
+const safeLocalStorage = {
+	getItem: (key) => getSafeLocalStorage().getItem(key),
+	setItem: (key, value) => getSafeLocalStorage().setItem(key, value),
+	removeItem: (key) => getSafeLocalStorage().removeItem(key),
+	subscribe: (key, callback) => {
+		return getSafeLocalStorage().subscribe?.(key, callback) ?? (() => {});
+	}
+};
+/**
+* Parse a cookie string to extract the value for a specific key.
+* @param cookieString - The full cookie header string (e.g., document.cookie or req.headers.cookie)
+* @param key - The cookie key to find
+* @returns The cookie value or null if not found
+*/
+const parseCookie = (cookieString, key) => {
+	if (!cookieString) return null;
+	for (const cookie of cookieString.split(";")) {
+		const [k, ...v] = cookie.split("=");
+		if (k?.trim() === key) try {
+			return decodeURIComponent(v.join("=").trim());
+		} catch {
+			return null;
+		}
+	}
+	return null;
+};
+/**
+* Maximum recommended size for cookie storage (3KB to stay well under 4KB limit).
+*
+* @remarks
+* Cookie storage is subject to browser limits (typically 4KB per cookie).
+* When users connect many wallets, the auto-reconnect list may exceed this limit.
+* If this happens:
+* - A console warning will be logged
+* - Some browsers may silently reject the cookie
+* - Consider using fewer simultaneous wallet connections
+*
+* The stored data includes wallet IDs in format `platform:identifier`
+* (e.g., `polkadot:talisman`, `ethereum:io.metamask`).
+*/
+const COOKIE_MAX_SIZE = 3 * 1024;
+/**
+* BroadcastChannel name for cross-tab cookie sync.
+*/
+const BROADCAST_CHANNEL_NAME = "kheopskit-storage-sync";
+/**
+* Singleton BroadcastChannel for cross-tab cookie sync.
+* Created once and shared across all cookieStorage instances.
+*/
+let sharedBroadcastChannel = null;
+const getBroadcastChannel = () => {
+	if (sharedBroadcastChannel) return sharedBroadcastChannel;
+	if (typeof BroadcastChannel === "undefined") return null;
+	try {
+		sharedBroadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);
+	} catch {}
+	return sharedBroadcastChannel;
+};
+/**
+* Check if the current connection is secure (HTTPS).
+* Must be called at runtime (inside methods) to work correctly after SSR hydration.
+*/
+const isSecureConnection = () => typeof window !== "undefined" && window.location.protocol === "https:";
+/**
+* A cookie-based storage implementation for SSR environments.
+* Reads cookies from an optional initial cookie string (for SSR hydration),
+* writes to document.cookie on the client.
+*
+* Features:
+* - Secure flag automatically added for HTTPS connections
+* - Cross-tab synchronization via BroadcastChannel API
+* - Size limit warning when data exceeds recommended limits
+*
+* @param initialCookies - Optional cookie string for server-side hydration
+*/
+const 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 > 3072) 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);
+			};
+		}
+	};
+};
+//#endregion
+//#region src/utils/iconCache.ts
+/**
+* Storage key for the icon cache in localStorage.
+*/
+const ICON_CACHE_KEY = "kheopskit-icons";
+/**
+* In-memory cache to avoid repeated localStorage reads.
+*/
+let memoryCache = null;
+/**
+* Loads the icon cache from localStorage.
+*/
+const loadCache = () => {
+	if (memoryCache !== null) return memoryCache;
+	try {
+		const stored = safeLocalStorage.getItem(ICON_CACHE_KEY);
+		memoryCache = stored ? JSON.parse(stored) : {};
+	} catch {
+		memoryCache = {};
+	}
+	return memoryCache;
+};
+/**
+* Saves the icon cache to localStorage.
+*/
+const saveCache = (cache) => {
+	try {
+		safeLocalStorage.setItem(ICON_CACHE_KEY, JSON.stringify(cache));
+		memoryCache = cache;
+	} catch {}
+};
+/**
+* Gets a cached icon for a wallet.
+* @param walletId - The wallet ID (e.g., "ethereum:io.talisman")
+* @returns The cached icon data URI, or undefined if not cached
+*/
+const getCachedIcon = (walletId) => {
+	return loadCache()[walletId] || void 0;
+};
+/**
+* Sets multiple cached icons at once.
+* More efficient than calling setCachedIcon multiple times.
+* @param icons - Map of wallet ID to icon
+*/
+const setCachedIcons = (icons) => {
+	const cache = loadCache();
+	let changed = false;
+	for (const [walletId, icon] of Object.entries(icons)) if (icon && cache[walletId] !== icon) {
+		cache[walletId] = icon;
+		changed = true;
+	}
+	if (changed) saveCache(cache);
+};
+//#endregion
+Object.defineProperty(exports, "cookieStorage", {
+	enumerable: true,
+	get: function() {
+		return cookieStorage;
+	}
+});
+Object.defineProperty(exports, "getCachedIcon", {
+	enumerable: true,
+	get: function() {
+		return getCachedIcon;
+	}
+});
+Object.defineProperty(exports, "getSafeLocalStorage", {
+	enumerable: true,
+	get: function() {
+		return getSafeLocalStorage;
+	}
+});
+Object.defineProperty(exports, "hydrateAccount", {
+	enumerable: true,
+	get: function() {
+		return hydrateAccount;
+	}
+});
+Object.defineProperty(exports, "hydrateWallet", {
+	enumerable: true,
+	get: function() {
+		return hydrateWallet;
+	}
+});
+Object.defineProperty(exports, "safeLocalStorage", {
+	enumerable: true,
+	get: function() {
+		return safeLocalStorage;
+	}
+});
+Object.defineProperty(exports, "serializeAccount", {
+	enumerable: true,
+	get: function() {
+		return serializeAccount;
+	}
+});
+Object.defineProperty(exports, "serializeWallet", {
+	enumerable: true,
+	get: function() {
+		return serializeWallet;
+	}
+});
+Object.defineProperty(exports, "setCachedIcons", {
+	enumerable: true,
+	get: function() {
+		return setCachedIcons;
+	}
+});
+
+//# sourceMappingURL=iconCache-DS4zNiP1.js.map

package/dist/iconCache-DS4zNiP1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconCache-DS4zNiP1.js","names":["POLKADOT_EXTENSIONS","parseWalletId","isWalletConnectWallet"],"sources":["../src/utils/hydrateState.ts","../src/utils/storage.ts","../src/utils/iconCache.ts"],"sourcesContent":["import {\n\ttype BaseWallet,\n\ttype BaseWalletAccount,\n\ttype CachedAccount,\n\ttype CachedWallet,\n\tisWalletConnectWallet,\n\ttype PolkadotAccountType,\n\ttype WalletConnectWallet,\n} from \"../api/types\";\nimport { POLKADOT_EXTENSIONS } from \"./polkadotExtensions\";\nimport type { WalletAccountId } from \"./WalletAccountId\";\nimport { parseWalletId, type WalletId } from \"./WalletId\";\n\n/**\n * Looks up the icon for a wallet from known Polkadot extensions only.\n * Ethereum icons will be populated from the localStorage icon cache via the merge function.\n *\n * Note: We DON'T use localStorage icon cache here because hydrateWallet is called\n * during SSR (server) and client hydration. localStorage isn't available on server,\n * so using it would cause a hydration mismatch. Icons for Ethereum wallets will be\n * populated when the hydration buffer merges cached wallets with live wallets.\n */\nconst lookupWalletIcon = (platform: string, identifier: string): string => {\n\t// Only Polkadot extensions have hardcoded icons that are safe for SSR\n\tif (platform === \"polkadot\") {\n\t\treturn POLKADOT_EXTENSIONS[identifier]?.icon ?? \"\";\n\t}\n\t// Ethereum icons come from localStorage or live wallets - not here\n\treturn \"\";\n};\n\n/**\n * Error thrown when trying to use a placeholder wallet that hasn't fully loaded yet.\n */\nclass PendingWalletError extends Error {\n\tconstructor(walletId: string) {\n\t\tsuper(\n\t\t\t`Wallet ${walletId} is still loading. Wait for isHydrating to be false before calling connect/disconnect.`,\n\t\t);\n\t\tthis.name = \"PendingWalletError\";\n\t}\n}\n\n/**\n * Converts a CachedWallet to a placeholder wallet for SSR hydration display.\n *\n * The placeholder carries only the SDK-free {@link BaseWallet} fields; the real\n * wallet (with its injected provider/extension/standard-wallet handle) replaces\n * it once it loads. connect/disconnect throw until then.\n */\nexport const hydrateWallet = (\n\tcached: CachedWallet,\n): BaseWallet | WalletConnectWallet => {\n\tconst throwPending = () => {\n\t\tthrow new PendingWalletError(cached.id);\n\t};\n\n\t// The platform-less WalletConnect connector. `appKit`/`platforms` are SDK\n\t// state absent until the live connector loads (cast like other placeholder\n\t// SDK handles); icon is filled from the localStorage cache by the caller.\n\tif (cached.type === \"walletconnect\") {\n\t\treturn {\n\t\t\tid: cached.id,\n\t\t\ttype: \"walletconnect\",\n\t\t\tplatforms: [],\n\t\t\tname: cached.name,\n\t\t\ticon: \"\",\n\t\t\tisConnected: cached.isConnected,\n\t\t\tconnect: throwPending,\n\t\t\tdisconnect: throwPending,\n\t\t} as unknown as WalletConnectWallet;\n\t}\n\n\tconst { platform, identifier } = parseWalletId(cached.id);\n\n\treturn {\n\t\tid: cached.id,\n\t\tplatform: cached.platform as BaseWallet[\"platform\"],\n\t\ttype: cached.type,\n\t\tname: cached.name,\n\t\ticon: lookupWalletIcon(platform, identifier),\n\t\tisConnected: cached.isConnected,\n\t\tconnect: throwPending,\n\t\tdisconnect: throwPending,\n\t};\n};\n\n/**\n * Converts a CachedAccount to a placeholder account for SSR hydration display.\n *\n * The placeholder carries the SDK-free {@link BaseWalletAccount} fields plus the\n * plain, serializable platform data that lives in the cache — Ethereum `chainId`\n * and the Polkadot key `type`. Those render immediately on reload (no blank →\n * value flicker) and match what the live account will report. Only the SDK\n * handles (`client`/`signer`/`polkadotSigner`) are absent until the real account\n * replaces this placeholder; signing stays gated on `isHydrating` until then.\n */\nexport const hydrateAccount = (cached: CachedAccount): BaseWalletAccount => ({\n\tid: cached.id as WalletAccountId,\n\tplatform: cached.platform,\n\taddress: cached.address,\n\tname: cached.name,\n\twalletId: cached.walletId,\n\twalletName: cached.walletName,\n\t// Spread (not direct keys) so the extra platform fields don't trip the\n\t// excess-property check against BaseWalletAccount; they're read back via the\n\t// platform-specific account types once narrowed by `platform`.\n\t...(cached.platform === \"ethereum\" && { chainId: cached.chainId }),\n\t...(cached.platform === \"polkadot\" && {\n\t\ttype: cached.polkadotAccountType,\n\t}),\n});\n\n/**\n * Converts a wallet to a CachedWallet for storage.\n * Only extracts the serializable properties needed for hydration.\n */\nexport const serializeWallet = (\n\twallet: BaseWallet | WalletConnectWallet,\n): CachedWallet => ({\n\tid: wallet.id,\n\t// The WalletConnect connector has no platform.\n\tplatform: isWalletConnectWallet(wallet) ? undefined : wallet.platform,\n\ttype: wallet.type,\n\tname: wallet.name,\n\t// Note: icon is NOT stored to save cookie space\n\tisConnected: wallet.isConnected,\n});\n\n/**\n * Converts an account to a CachedAccount for storage.\n * Only extracts the serializable properties needed for hydration. Platform-only\n * fields (Ethereum chainId, Polkadot key type) are read defensively so this\n * stays SDK-free.\n */\nexport const serializeAccount = (\n\taccount: BaseWalletAccount,\n): CachedAccount => ({\n\tid: account.id,\n\tplatform: account.platform,\n\taddress: account.address,\n\tname: account.name,\n\tchainId:\n\t\taccount.platform === \"ethereum\"\n\t\t\t? (account as { chainId?: number }).chainId\n\t\t\t: undefined,\n\tpolkadotAccountType:\n\t\taccount.platform === \"polkadot\"\n\t\t\t? (account as { type?: PolkadotAccountType }).type\n\t\t\t: undefined,\n\twalletId: account.walletId as WalletId,\n\twalletName: account.walletName,\n});\n","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 { safeLocalStorage } from \"./storage\";\n\n/**\n * Storage key for the icon cache in localStorage.\n */\nconst ICON_CACHE_KEY = \"kheopskit-icons\";\n\n/**\n * Icon cache type: a map of wallet ID to icon data URI or URL.\n */\ntype IconCache = Record<string, string>;\n\n/**\n * In-memory cache to avoid repeated localStorage reads.\n */\nlet memoryCache: IconCache | null = null;\n\n/**\n * Loads the icon cache from localStorage.\n */\nconst loadCache = (): IconCache => {\n\tif (memoryCache !== null) return memoryCache;\n\n\ttry {\n\t\tconst stored = safeLocalStorage.getItem(ICON_CACHE_KEY);\n\t\tmemoryCache = stored ? (JSON.parse(stored) as IconCache) : {};\n\t} catch {\n\t\tmemoryCache = {};\n\t}\n\treturn memoryCache;\n};\n\n/**\n * Saves the icon cache to localStorage.\n */\nconst saveCache = (cache: IconCache): void => {\n\ttry {\n\t\tsafeLocalStorage.setItem(ICON_CACHE_KEY, JSON.stringify(cache));\n\t\tmemoryCache = cache;\n\t} catch {\n\t\t// localStorage may be full or unavailable\n\t}\n};\n\n/**\n * Gets a cached icon for a wallet.\n * @param walletId - The wallet ID (e.g., \"ethereum:io.talisman\")\n * @returns The cached icon data URI, or undefined if not cached\n */\nexport const getCachedIcon = (walletId: string): string | undefined => {\n\tconst cache = loadCache();\n\treturn cache[walletId] || undefined;\n};\n\n/**\n * Sets multiple cached icons at once.\n * More efficient than calling setCachedIcon multiple times.\n * @param icons - Map of wallet ID to icon\n */\nexport const setCachedIcons = (icons: Record<string, string>): void => {\n\tconst cache = loadCache();\n\tlet changed = false;\n\n\tfor (const [walletId, icon] of Object.entries(icons)) {\n\t\tif (icon && cache[walletId] !== icon) {\n\t\t\tcache[walletId] = icon;\n\t\t\tchanged = true;\n\t\t}\n\t}\n\n\tif (changed) {\n\t\tsaveCache(cache);\n\t}\n};\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,17 +1,18 @@
-export { c as clearAllCachedObservables } from './getCachedObservable-C4E8dfMp.mjs';
-import { K as KheopskitPlatform, d as KheopskitConfig, a as WalletId, e as KheopskitStore, B as BaseWallet, b as WalletConnectWallet, f as BaseWalletAccount, g as KheopskitState } from './types-0iDBydsK.mjs';
-export { A as AccountOf, h as AppKitInstance, C as CachedAccount, j as CachedWallet, k as KheopskitStoreData, P as PlatformContext, l as PolkadotAccountType, W as WalletAccountId, m as WalletConnectConfig, n as WalletConnectMetadata, o as WalletConnectProvider, p as WalletOf, q as WalletPlatform, r as WalletType, s as getWalletAccountId, t as getWalletId, i as isInjectedWallet, u as isValidWalletId, c as isWalletConnectWallet, v as parseWalletAccountId, w as parseWalletId } from './types-0iDBydsK.mjs';
-import { Observable } from 'rxjs';
-
+import { C as WalletId, D as WalletAccountId, E as parseWalletId, O as getWalletAccountId, S as isWalletConnectWallet, T as isValidWalletId, _ as WalletConnectWallet, a as CachedAccount, b as WalletType, c as KheopskitPlatform, d as KheopskitStoreData, f as PlatformContext, g as WalletConnectProvider, h as WalletConnectMetadata, i as BaseWalletAccount, k as parseWalletAccountId, l as KheopskitState, m as WalletConnectConfig, n as AppKitInstance, o as CachedWallet, p as PolkadotAccountType, r as BaseWallet, s as KheopskitConfig, t as AccountOf, u as KheopskitStore, v as WalletOf, w as getWalletId, x as isInjectedWallet, y as WalletPlatform } from "./types-Cb-vuEru.mjs";
+import { t as clearAllCachedObservables } from "./getCachedObservable-LUq9IfEx.mjs";
+import { Observable } from "rxjs";
+//#region src/utils/isValidAddress.d.ts
 declare const isValidAddress: (address: string) => boolean;
-
+//#endregion
+//#region src/api/appKit.d.ts
 /**
  * Clears the cached AppKit observable.
  * Use when configuration changes or for testing purposes.
  * Note: This does NOT destroy the appKit instance created by Reown.
  */
 declare const resetAppKitCache: () => void;
-
+//#endregion
+//#region src/api/config.d.ts
 /**
  * Default storage key for persisting wallet connection state.
  * Can be overridden via config.storageKey to avoid conflicts
@@ -19,24 +20,25 @@ declare const resetAppKitCache: () => void;
  */
 declare const DEFAULT_STORAGE_KEY = "kheopskit";
 declare const resolveConfig: <const P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]>(config?: Partial<KheopskitConfig<P>>) => KheopskitConfig<P>;
-
+//#endregion
+//#region src/api/errors.d.ts
 /**
  * Stable error codes thrown by kheopskit. Catch a {@link KheopskitError} and
  * branch on `error.code` instead of matching message strings.
  */
-type KheopskitErrorCode = 
+type KheopskitErrorCode =
 /** `connect()` called on a wallet that is already connected. */
-"WALLET_ALREADY_CONNECTED"
+"WALLET_ALREADY_CONNECTED" |
 /** `disconnect()` called on a wallet that is not connected. */
- | "WALLET_NOT_CONNECTED"
+"WALLET_NOT_CONNECTED" |
 /** The wallet does not advertise a capability kheopskit needs to proceed. */
- | "FEATURE_NOT_SUPPORTED"
+"FEATURE_NOT_SUPPORTED" |
 /** No active WalletConnect session for the requested operation. */
- | "NO_SESSION"
+"NO_SESSION" |
 /** No provider available for the requested namespace. */
- | "NO_PROVIDER"
+"NO_PROVIDER" |
 /** The requested chain cannot be used for this operation (e.g. a Solana cluster with no CAIP-2 id over WalletConnect). */
- | "UNSUPPORTED_CHAIN";
+"UNSUPPORTED_CHAIN";
 /**
  * Error thrown by kheopskit wallet/account operations. Carries a stable
  * {@link KheopskitErrorCode} and, when relevant, the offending wallet id.
@@ -53,26 +55,27 @@ type KheopskitErrorCode =
  * ```
  */
 declare class KheopskitError extends Error {
-    readonly code: KheopskitErrorCode;
-    /** The wallet id this error relates to, when applicable. */
-    readonly walletId?: WalletId;
-    constructor(code: KheopskitErrorCode, message: string, options?: {
-        walletId?: WalletId;
-        cause?: unknown;
-    });
+  readonly code: KheopskitErrorCode;
+  /** The wallet id this error relates to, when applicable. */
+  readonly walletId?: WalletId;
+  constructor(code: KheopskitErrorCode, message: string, options?: {
+    walletId?: WalletId;
+    cause?: unknown;
+  });
 }
-
+//#endregion
+//#region src/api/store.d.ts
 type CreateKheopskitStoreOptions = {
-    /**
-     * Cookie string for SSR hydration.
-     * When provided, uses cookieStorage instead of localStorage.
-     */
-    ssrCookies?: string;
-    /**
-     * Custom storage key to namespace the stored data.
-     * @default "kheopskit"
-     */
-    storageKey?: string;
+  /**
+   * Cookie string for SSR hydration.
+   * When provided, uses cookieStorage instead of localStorage.
+   */
+  ssrCookies?: string;
+  /**
+   * Custom storage key to namespace the stored data.
+   * @default "kheopskit"
+   */
+  storageKey?: string;
 };
 /**
  * Creates a kheopskit store with the appropriate storage backend.
@@ -88,22 +91,23 @@ declare const createKheopskitStore: (options?: CreateKheopskitStoreOptions) => K
  * Lazily initialized to avoid SSR issues with module-level code.
  */
 declare const getDefaultStore: () => KheopskitStore;
-
+//#endregion
+//#region src/api/hydration.d.ts
 /** Result of {@link getHydratedSnapshot}: placeholder wallets and accounts built from the cache. */
 type HydratedSnapshot = {
-    wallets: (BaseWallet | WalletConnectWallet)[];
-    accounts: BaseWalletAccount[];
+  wallets: (BaseWallet | WalletConnectWallet)[];
+  accounts: BaseWalletAccount[];
 };
 type GetHydratedSnapshotOptions = {
-    /**
-     * Enrich wallets that have no icon from the localStorage icon cache.
-     *
-     * Must stay `false` for any snapshot that has to match server-rendered markup
-     * (React's `getServerSnapshot` runs on the client during hydration, where the
-     * icon cache is populated — enriching there would diverge from the server,
-     * which always sees an empty cache).
-     */
-    icons?: boolean;
+  /**
+   * Enrich wallets that have no icon from the localStorage icon cache.
+   *
+   * Must stay `false` for any snapshot that has to match server-rendered markup
+   * (React's `getServerSnapshot` runs on the client during hydration, where the
+   * icon cache is populated — enriching there would diverge from the server,
+   * which always sees an empty cache).
+   */
+  icons?: boolean;
 };
 /**
  * Builds the cached-state snapshot every consumer must agree on: read the
@@ -117,21 +121,23 @@ type GetHydratedSnapshotOptions = {
  * sharing this helper, that agreement holds by construction.
  */
 declare const getHydratedSnapshot: (store: KheopskitStore, platforms: readonly KheopskitPlatform[], options?: GetHydratedSnapshotOptions) => HydratedSnapshot;
-
+//#endregion
+//#region src/api/kheopskit.d.ts
 /** Options for {@link getKheopskit$}. */
 type GetKheopskitOptions = {
-    /**
-     * Cookie string for SSR hydration. When provided, state is read from cookies
-     * instead of localStorage so the server can hydrate without a flash. Pass the
-     * request's `cookie` header.
-     */
-    ssrCookies?: string;
-    /**
-     * An existing store to reuse instead of creating one. Advanced escape hatch —
-     * most callers omit it. (`@kheopskit/react` passes its provider-scoped store.)
-     */
-    store?: ReturnType<typeof createKheopskitStore>;
+  /**
+   * Cookie string for SSR hydration. When provided, state is read from cookies
+   * instead of localStorage so the server can hydrate without a flash. Pass the
+   * request's `cookie` header.
+   */
+  ssrCookies?: string;
+  /**
+   * An existing store to reuse instead of creating one. Advanced escape hatch —
+   * most callers omit it. (`@kheopskit/react` passes its provider-scoped store.)
+   */
+  store?: ReturnType<typeof createKheopskitStore>;
 };
 declare const getKheopskit$: <const P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]>(config?: Partial<KheopskitConfig<P>>, options?: GetKheopskitOptions) => Observable<KheopskitState<P>>;
-
-export { BaseWallet, BaseWalletAccount, DEFAULT_STORAGE_KEY, type GetHydratedSnapshotOptions, type GetKheopskitOptions, type HydratedSnapshot, KheopskitConfig, KheopskitError, type KheopskitErrorCode, KheopskitPlatform, KheopskitState, KheopskitStore, WalletConnectWallet, WalletId, createKheopskitStore, getDefaultStore, getHydratedSnapshot, getKheopskit$, isValidAddress, resetAppKitCache, resolveConfig };
+//#endregion
+export { AccountOf, AppKitInstance, BaseWallet, BaseWalletAccount, CachedAccount, CachedWallet, DEFAULT_STORAGE_KEY, type GetHydratedSnapshotOptions, GetKheopskitOptions, type HydratedSnapshot, KheopskitConfig, KheopskitError, type KheopskitErrorCode, KheopskitPlatform, KheopskitState, KheopskitStore, KheopskitStoreData, PlatformContext, PolkadotAccountType, type WalletAccountId, WalletConnectConfig, WalletConnectMetadata, WalletConnectProvider, WalletConnectWallet, type WalletId, WalletOf, WalletPlatform, WalletType, clearAllCachedObservables, createKheopskitStore, getDefaultStore, getHydratedSnapshot, getKheopskit$, getWalletAccountId, getWalletId, isInjectedWallet, isValidAddress, isValidWalletId, isWalletConnectWallet, parseWalletAccountId, parseWalletId, resetAppKitCache, resolveConfig };
+//# sourceMappingURL=index.d.mts.map