@kheopskit/core 5.2.1 → 6.0.0-rc.0

package/dist/{iconCache-DUtkJlaX.js → iconCache-FR4iy6go.js}

@@ -1,4 +1,4 @@
-const require_types = require("./types-DKU-SNio.js");
+const require_types = require("./types-BWHvNFlN.js");
 const require_polkadotExtensions = require("./polkadotExtensions-y4J9UzYl.js");
 //#region src/utils/hydrateState.ts
 /**
@@ -14,35 +14,22 @@ 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);
+	const connect = async () => {
+		throw require_types.walletPendingError(cached.id);
 	};
+	const disconnect = async () => {};
 	if (cached.type === "walletconnect") return {
 		id: cached.id,
 		type: "walletconnect",
 		platforms: [],
 		name: cached.name,
 		icon: "",
-		isConnected: cached.isConnected,
-		connect: throwPending,
-		disconnect: throwPending
+		status: cached.isConnected ? "connecting" : "disconnected",
+		isPlaceholder: true,
+		isConnected: false,
+		connect,
+		disconnect
 	};
 	const { platform, identifier } = require_types.parseWalletId(cached.id);
 	return {
@@ -51,30 +38,24 @@ const hydrateWallet = (cached) => {
 		type: cached.type,
 		name: cached.name,
 		icon: lookupWalletIcon(platform, identifier),
-		isConnected: cached.isConnected,
-		connect: throwPending,
-		disconnect: throwPending
+		status: cached.isConnected ? "connecting" : "disconnected",
+		isPlaceholder: true,
+		isConnected: false,
+		connect,
+		disconnect
 	};
 };
-/**
-* 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`/`txCreator`) are absent until the real account
-* replaces this placeholder; signing stays gated on `isHydrating` until then.
-*/
 const hydrateAccount = (cached) => ({
 	id: cached.id,
+	isPlaceholder: true,
 	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 }
+	...cached.platform === "polkadot" && { type: cached.polkadotAccountType },
+	...cached.platform === "solana" && { chains: [] }
 });
 /**
 * Converts a wallet to a CachedWallet for storage.
@@ -158,14 +139,14 @@ const getSafeLocalStorage = () => {
 };
 /**
 * @deprecated Use getSafeLocalStorage() instead. This is kept for backward compatibility.
-* Returns a proxy that lazily initializes on first method call.
+* Returns a proxy that lazily initializes on first use.
 */
 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) ?? (() => {});
+	get subscribe() {
+		return getSafeLocalStorage().subscribe;
 	}
 };
 /**
@@ -393,4 +374,4 @@ Object.defineProperty(exports, "setCachedIcons", {
 	}
 });
 
-//# sourceMappingURL=iconCache-DUtkJlaX.js.map
+//# sourceMappingURL=iconCache-FR4iy6go.js.map

package/dist/iconCache-FR4iy6go.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iconCache-FR4iy6go.js","names":["POLKADOT_EXTENSIONS","walletPendingError","parseWalletId","isWalletConnectWallet"],"sources":["../src/utils/hydrateState.ts","../src/utils/storage.ts","../src/utils/iconCache.ts"],"sourcesContent":["import { walletPendingError } from \"../api/errors\";\nimport {\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\ntype PlaceholderOf<W> = W & { isPlaceholder: true; isConnected: false };\n\nexport const hydrateWallet = (\n\tcached: CachedWallet,\n): PlaceholderOf<BaseWallet | WalletConnectWallet> => {\n\tconst connect = async () => {\n\t\tthrow walletPendingError(cached.id);\n\t};\n\tconst disconnect = async () => {};\n\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\tstatus: cached.isConnected ? \"connecting\" : \"disconnected\",\n\t\t\tisPlaceholder: true,\n\t\t\tisConnected: false,\n\t\t\tconnect,\n\t\t\tdisconnect,\n\t\t};\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\tstatus: cached.isConnected ? \"connecting\" : \"disconnected\",\n\t\tisPlaceholder: true,\n\t\tisConnected: false,\n\t\tconnect,\n\t\tdisconnect,\n\t};\n};\n\nexport const hydrateAccount = (\n\tcached: CachedAccount,\n): BaseWalletAccount & { isPlaceholder: true } => ({\n\tid: cached.id as WalletAccountId,\n\tisPlaceholder: true,\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\t...(cached.platform === \"solana\" && { chains: [] }),\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 use.\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\tget subscribe() {\n\t\treturn getSafeLocalStorage().subscribe;\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,10 @@
-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 SyncableStorage } from "./storage-D3AwNgqc.mjs";
+import { A as getWalletId, C as WalletStatus, D as KheopskitError, E as isWalletConnectWallet, F as parseWalletAccountId, M as parseWalletId, N as WalletAccountId, O as KheopskitErrorCode, P as getWalletAccountId, S as WalletPlatform, T as isInjectedWallet, _ as WalletConnectMetadata, a as CachedAccount, b as WalletConnectWallet, c as KheopskitConfig, d as KheopskitStore, f as KheopskitStoreData, g as PolkadotAccountType, h as PlatformContext, i as BaseWalletAccount, j as isValidWalletId, k as WalletId, l as KheopskitPlatform, m as PlaceholderWallet, n as AppKitInstance, o as CachedWallet, p as Placeholder, r as BaseWallet, s as ConnectOptions, t as AccountOf, u as KheopskitState, v as WalletConnectPlugin, w as WalletType, x as WalletOf, y as WalletConnectProvider } from "./types-Dkyt9bf4.mjs";
 import { t as clearAllCachedObservables } from "./getCachedObservable-LUq9IfEx.mjs";
 import { Observable } from "rxjs";
 //#region src/utils/isValidAddress.d.ts
 export 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.
- */
-export declare const resetAppKitCache: () => void;
-//#endregion
 //#region src/api/config.d.ts
 /**
  * Default storage key for persisting wallet connection state.
@@ -21,53 +14,13 @@ export declare const resetAppKitCache: () => void;
 export declare const DEFAULT_STORAGE_KEY = "kheopskit";
 export 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 =
-/** `connect()` called on a wallet that is already connected. */
-"WALLET_ALREADY_CONNECTED" |
-/** `disconnect()` called on a wallet that is not connected. */
-"WALLET_NOT_CONNECTED" |
-/** The wallet does not advertise a capability kheopskit needs to proceed. */
-"FEATURE_NOT_SUPPORTED" |
-/** No active WalletConnect session for the requested operation. */
-"NO_SESSION" |
-/** No provider available for the requested namespace. */
-"NO_PROVIDER" |
-/** The installed polkadot-api version exposes neither `getTxCreatorFromPjs` (v3) nor `getPolkadotSignerFromPjs` (v2). */
-"UNSUPPORTED_VERSION" |
-/** The requested chain cannot be used for this operation (e.g. a Solana cluster with no CAIP-2 id over WalletConnect). */
-"UNSUPPORTED_CHAIN";
-/**
- * Error thrown by kheopskit wallet/account operations. Carries a stable
- * {@link KheopskitErrorCode} and, when relevant, the offending wallet id.
- *
- * @example
- * ```ts
- * try {
- *   await wallet.connect();
- * } catch (error) {
- *   if (error instanceof KheopskitError && error.code === "WALLET_ALREADY_CONNECTED") {
- *     // ignore
- *   } else throw error;
- * }
- * ```
- */
-export 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;
-  });
-}
-//#endregion
 //#region src/api/store.d.ts
 type CreateKheopskitStoreOptions = {
+  /**
+   * Storage backend to persist into. When provided, it takes precedence over
+   * `ssrCookies` and localStorage.
+   */
+  storage?: SyncableStorage;
   /**
    * Cookie string for SSR hydration.
    * When provided, uses cookieStorage instead of localStorage.
@@ -81,8 +34,8 @@ type CreateKheopskitStoreOptions = {
 };
 /**
  * Creates a kheopskit store with the appropriate storage backend.
- * Uses cookieStorage when ssrCookies is provided (for SSR hydration),
- * otherwise falls back to safeLocalStorage.
+ * Uses the given `storage` when provided, else cookieStorage when ssrCookies is
+ * provided (for SSR hydration), otherwise safeLocalStorage.
  *
  * @param options - Configuration options for the store
  */
@@ -113,16 +66,18 @@ type GetHydratedSnapshotOptions = {
 };
 /**
  * Builds the cached-state snapshot every consumer must agree on: read the
- * store's cached state, hydrate wallets/accounts into placeholders, filter
- * accounts through each platform plugin's `acceptsCachedAccount` hook, and sort
- * with the same comparators the live pipeline uses.
+ * store's cached state, hydrate wallets/accounts into placeholders, apply the
+ * `autoReconnect` rule (a cached connected wallet it rejects becomes
+ * `disconnected` and loses its cached accounts), filter accounts through each
+ * platform plugin's `acceptsCachedAccount` hook, and sort with the same
+ * comparators the live pipeline uses.
  *
  * This is the single implementation behind the observable's initial seed and
  * both React snapshot sources (`serverValue`/`initialValue`). They must produce
  * the same shape in the same order or the UI flickers/reorders on reload — by
  * sharing this helper, that agreement holds by construction.
  */
-export declare const getHydratedSnapshot: (store: KheopskitStore, platforms: readonly KheopskitPlatform[], options?: GetHydratedSnapshotOptions) => HydratedSnapshot;
+export declare const getHydratedSnapshot: (store: KheopskitStore, config: Pick<KheopskitConfig, "platforms" | "autoReconnect">, options?: GetHydratedSnapshotOptions) => HydratedSnapshot;
 //#endregion
 //#region src/api/kheopskit.d.ts
 /** Options for {@link getKheopskit$}. */
@@ -134,12 +89,11 @@ export type GetKheopskitOptions = {
    */
   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.)
+   * An existing store to reuse instead of creating one.
    */
   store?: ReturnType<typeof createKheopskitStore>;
 };
 export declare const getKheopskit$: <const P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]>(config?: Partial<KheopskitConfig<P>>, options?: GetKheopskitOptions) => Observable<KheopskitState<P>>;
 //#endregion
-export { AccountOf, AppKitInstance, BaseWallet, BaseWalletAccount, CachedAccount, CachedWallet, type GetHydratedSnapshotOptions, type HydratedSnapshot, KheopskitConfig, type KheopskitErrorCode, KheopskitPlatform, KheopskitState, KheopskitStore, KheopskitStoreData, PlatformContext, PolkadotAccountType, type WalletAccountId, WalletConnectConfig, WalletConnectMetadata, WalletConnectProvider, WalletConnectWallet, type WalletId, WalletOf, WalletPlatform, WalletType, clearAllCachedObservables, getWalletAccountId, getWalletId, isInjectedWallet, isValidWalletId, isWalletConnectWallet, parseWalletAccountId, parseWalletId };
+export { AccountOf, AppKitInstance, BaseWallet, BaseWalletAccount, CachedAccount, CachedWallet, ConnectOptions, type GetHydratedSnapshotOptions, type HydratedSnapshot, KheopskitConfig, KheopskitError, type KheopskitErrorCode, KheopskitPlatform, KheopskitState, KheopskitStore, KheopskitStoreData, Placeholder, PlaceholderWallet, PlatformContext, PolkadotAccountType, type SyncableStorage, type WalletAccountId, WalletConnectMetadata, WalletConnectPlugin, WalletConnectProvider, WalletConnectWallet, type WalletId, WalletOf, WalletPlatform, WalletStatus, WalletType, clearAllCachedObservables, getWalletAccountId, getWalletId, isInjectedWallet, isValidWalletId, isWalletConnectWallet, parseWalletAccountId, parseWalletId };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.ts

@@ -1,17 +1,10 @@
-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.js";
+import { t as SyncableStorage } from "./storage-D3AwNgqc.js";
+import { A as getWalletId, C as WalletStatus, D as KheopskitError, E as isWalletConnectWallet, F as parseWalletAccountId, M as parseWalletId, N as WalletAccountId, O as KheopskitErrorCode, P as getWalletAccountId, S as WalletPlatform, T as isInjectedWallet, _ as WalletConnectMetadata, a as CachedAccount, b as WalletConnectWallet, c as KheopskitConfig, d as KheopskitStore, f as KheopskitStoreData, g as PolkadotAccountType, h as PlatformContext, i as BaseWalletAccount, j as isValidWalletId, k as WalletId, l as KheopskitPlatform, m as PlaceholderWallet, n as AppKitInstance, o as CachedWallet, p as Placeholder, r as BaseWallet, s as ConnectOptions, t as AccountOf, u as KheopskitState, v as WalletConnectPlugin, w as WalletType, x as WalletOf, y as WalletConnectProvider } from "./types-Dkyt9bf4.js";
 import { t as clearAllCachedObservables } from "./getCachedObservable-LUq9IfEx.js";
 import { Observable } from "rxjs";
 //#region src/utils/isValidAddress.d.ts
 export 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.
- */
-export declare const resetAppKitCache: () => void;
-//#endregion
 //#region src/api/config.d.ts
 /**
  * Default storage key for persisting wallet connection state.
@@ -21,53 +14,13 @@ export declare const resetAppKitCache: () => void;
 export declare const DEFAULT_STORAGE_KEY = "kheopskit";
 export 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 =
-/** `connect()` called on a wallet that is already connected. */
-"WALLET_ALREADY_CONNECTED" |
-/** `disconnect()` called on a wallet that is not connected. */
-"WALLET_NOT_CONNECTED" |
-/** The wallet does not advertise a capability kheopskit needs to proceed. */
-"FEATURE_NOT_SUPPORTED" |
-/** No active WalletConnect session for the requested operation. */
-"NO_SESSION" |
-/** No provider available for the requested namespace. */
-"NO_PROVIDER" |
-/** The installed polkadot-api version exposes neither `getTxCreatorFromPjs` (v3) nor `getPolkadotSignerFromPjs` (v2). */
-"UNSUPPORTED_VERSION" |
-/** The requested chain cannot be used for this operation (e.g. a Solana cluster with no CAIP-2 id over WalletConnect). */
-"UNSUPPORTED_CHAIN";
-/**
- * Error thrown by kheopskit wallet/account operations. Carries a stable
- * {@link KheopskitErrorCode} and, when relevant, the offending wallet id.
- *
- * @example
- * ```ts
- * try {
- *   await wallet.connect();
- * } catch (error) {
- *   if (error instanceof KheopskitError && error.code === "WALLET_ALREADY_CONNECTED") {
- *     // ignore
- *   } else throw error;
- * }
- * ```
- */
-export 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;
-  });
-}
-//#endregion
 //#region src/api/store.d.ts
 type CreateKheopskitStoreOptions = {
+  /**
+   * Storage backend to persist into. When provided, it takes precedence over
+   * `ssrCookies` and localStorage.
+   */
+  storage?: SyncableStorage;
   /**
    * Cookie string for SSR hydration.
    * When provided, uses cookieStorage instead of localStorage.
@@ -81,8 +34,8 @@ type CreateKheopskitStoreOptions = {
 };
 /**
  * Creates a kheopskit store with the appropriate storage backend.
- * Uses cookieStorage when ssrCookies is provided (for SSR hydration),
- * otherwise falls back to safeLocalStorage.
+ * Uses the given `storage` when provided, else cookieStorage when ssrCookies is
+ * provided (for SSR hydration), otherwise safeLocalStorage.
  *
  * @param options - Configuration options for the store
  */
@@ -113,16 +66,18 @@ type GetHydratedSnapshotOptions = {
 };
 /**
  * Builds the cached-state snapshot every consumer must agree on: read the
- * store's cached state, hydrate wallets/accounts into placeholders, filter
- * accounts through each platform plugin's `acceptsCachedAccount` hook, and sort
- * with the same comparators the live pipeline uses.
+ * store's cached state, hydrate wallets/accounts into placeholders, apply the
+ * `autoReconnect` rule (a cached connected wallet it rejects becomes
+ * `disconnected` and loses its cached accounts), filter accounts through each
+ * platform plugin's `acceptsCachedAccount` hook, and sort with the same
+ * comparators the live pipeline uses.
  *
  * This is the single implementation behind the observable's initial seed and
  * both React snapshot sources (`serverValue`/`initialValue`). They must produce
  * the same shape in the same order or the UI flickers/reorders on reload — by
  * sharing this helper, that agreement holds by construction.
  */
-export declare const getHydratedSnapshot: (store: KheopskitStore, platforms: readonly KheopskitPlatform[], options?: GetHydratedSnapshotOptions) => HydratedSnapshot;
+export declare const getHydratedSnapshot: (store: KheopskitStore, config: Pick<KheopskitConfig, "platforms" | "autoReconnect">, options?: GetHydratedSnapshotOptions) => HydratedSnapshot;
 //#endregion
 //#region src/api/kheopskit.d.ts
 /** Options for {@link getKheopskit$}. */
@@ -134,12 +89,11 @@ export type GetKheopskitOptions = {
    */
   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.)
+   * An existing store to reuse instead of creating one.
    */
   store?: ReturnType<typeof createKheopskitStore>;
 };
 export declare const getKheopskit$: <const P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]>(config?: Partial<KheopskitConfig<P>>, options?: GetKheopskitOptions) => Observable<KheopskitState<P>>;
 //#endregion
-export { AccountOf, AppKitInstance, BaseWallet, BaseWalletAccount, CachedAccount, CachedWallet, type GetHydratedSnapshotOptions, type HydratedSnapshot, KheopskitConfig, type KheopskitErrorCode, KheopskitPlatform, KheopskitState, KheopskitStore, KheopskitStoreData, PlatformContext, PolkadotAccountType, type WalletAccountId, WalletConnectConfig, WalletConnectMetadata, WalletConnectProvider, WalletConnectWallet, type WalletId, WalletOf, WalletPlatform, WalletType, clearAllCachedObservables, getWalletAccountId, getWalletId, isInjectedWallet, isValidWalletId, isWalletConnectWallet, parseWalletAccountId, parseWalletId };
+export { AccountOf, AppKitInstance, BaseWallet, BaseWalletAccount, CachedAccount, CachedWallet, ConnectOptions, type GetHydratedSnapshotOptions, type HydratedSnapshot, KheopskitConfig, KheopskitError, type KheopskitErrorCode, KheopskitPlatform, KheopskitState, KheopskitStore, KheopskitStoreData, Placeholder, PlaceholderWallet, PlatformContext, PolkadotAccountType, type SyncableStorage, type WalletAccountId, WalletConnectMetadata, WalletConnectPlugin, WalletConnectProvider, WalletConnectWallet, type WalletId, WalletOf, WalletPlatform, WalletStatus, WalletType, clearAllCachedObservables, getWalletAccountId, getWalletId, isInjectedWallet, isValidWalletId, isWalletConnectWallet, parseWalletAccountId, parseWalletId };
 //# sourceMappingURL=index.d.ts.map