@kheopskit/core 5.1.0 → 5.1.2

package/dist/iconCache-BSa42Sui.mjs

@@ -0,0 +1,343 @@
+import { n as isWalletConnectWallet, o as parseWalletId } from "./types-jnifAAA0.mjs";
+import { t as POLKADOT_EXTENSIONS } from "./polkadotExtensions-BoVKhNU_.mjs";
+//#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 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 } = 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: 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
+export { safeLocalStorage as a, serializeAccount as c, getSafeLocalStorage as i, serializeWallet as l, setCachedIcons as n, hydrateAccount as o, cookieStorage as r, hydrateWallet as s, getCachedIcon as t };
+
+//# sourceMappingURL=iconCache-BSa42Sui.mjs.map

package/dist/iconCache-BSa42Sui.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconCache-BSa42Sui.mjs","names":[],"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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"}