@kheopskit/react 3.0.1 → 5.0.0

package/README.md

@@ -0,0 +1,103 @@
+# @kheopskit/react
+
+React bindings for [Kheopskit](https://github.com/kheopskit/kheopskit) — list
+wallets and accounts across Polkadot, Ethereum and Solana, with injected wallets
+and WalletConnect (Reown AppKit).
+
+The framework-agnostic core lives in
+[`@kheopskit/core`](https://www.npmjs.com/package/@kheopskit/core).
+Full docs and the interactive playground:
+https://github.com/kheopskit/kheopskit
+
+> **Upgrading from v3?** v4 moves platforms to plugins and makes platform SDKs
+> (and WalletConnect) optional peer dependencies. See
+> [MIGRATING_TO_V4.md](../core/MIGRATING_TO_V4.md).
+
+## Install
+
+`rxjs` is always required; every platform SDK (and WalletConnect) is an optional
+peer dependency — install only what you use:
+
+```bash
+pnpm add @kheopskit/core @kheopskit/react rxjs
+
+pnpm add polkadot-api                                            # Polkadot
+pnpm add viem mipd                                               # Ethereum
+pnpm add @solana/kit @wallet-standard/app @wallet-standard/base  # Solana
+pnpm add @reown/appkit                                           # WalletConnect (optional)
+```
+
+## Usage
+
+Recommended: bind your platform tuple once with `createKheopskit` and get a
+provider plus hooks already typed to those platforms — no generic to repeat.
+
+```ts
+// kheopskit.ts
+import { createKheopskit } from "@kheopskit/react";
+import { polkadot } from "@kheopskit/core/polkadot";
+import { ethereum } from "@kheopskit/core/ethereum";
+import { solana } from "@kheopskit/core/solana";
+
+export const { KheopskitProvider, useWallets, useAccounts } = createKheopskit({
+  platforms: [polkadot(), ethereum(), solana()],
+  autoReconnect: true,
+});
+```
+
+```tsx
+// app.tsx
+import { KheopskitProvider } from "./kheopskit";
+
+export const App = ({ children }: { children: React.ReactNode }) => (
+  <KheopskitProvider>{children}</KheopskitProvider>
+);
+```
+
+```tsx
+// anywhere — accounts/wallets are platform-precise (account.signer / account.client typed)
+import { useWallets, useAccounts } from "./kheopskit";
+
+const { wallets, isHydrating } = useWallets();
+const accounts = useAccounts();
+```
+
+### Without the factory
+
+You can also use the `KheopskitProvider` component directly and recover precise
+types with a type argument (React context can't be generic):
+
+```tsx
+import { KheopskitProvider, useWallets } from "@kheopskit/react";
+
+const platforms = [polkadot(), ethereum(), solana()] as const;
+
+<KheopskitProvider config={{ platforms }}>…</KheopskitProvider>;
+
+const { accounts } = useWallets<typeof platforms>();
+```
+
+## SSR
+
+Pass the request cookie header as `ssrCookies` to hydrate wallet state on the
+server without a UI flash:
+
+```tsx
+// Next.js App Router
+const cookieStore = await cookies();
+const ssrCookies = cookieStore
+  .getAll()
+  .map((c) => `${c.name}=${c.value}`)
+  .join("; ");
+
+<KheopskitProvider ssrCookies={ssrCookies}>{children}</KheopskitProvider>;
+```
+
+> While `state.isHydrating` is `true`, wallets/accounts are cached placeholders
+> carrying only the base fields — SDK fields (`signer`, `client`,
+> provider/extension handles) are absent until hydration completes. Guard access
+> behind `!isHydrating`.
+
+## License
+
+ISC

package/dist/index.d.mts

@@ -1,8 +1,47 @@
 import * as _kheopskit_core from '@kheopskit/core';
-import { KheopskitConfig } from '@kheopskit/core';
+import { KheopskitPlatform, KheopskitConfig, KheopskitState } from '@kheopskit/core';
 import { FC, PropsWithChildren } from 'react';
 
+type CreateKheopskitConfig<P extends readonly KheopskitPlatform[]> = Omit<Partial<KheopskitConfig<P>>, "platforms"> & {
+    /** Platform plugins, e.g. `[polkadot(), solana()]`. Required. */
+    platforms: P;
+};
+/**
+ * Binds a platform tuple once and returns a `KheopskitProvider` plus hooks
+ * (`useWallets`, `useAccounts`) already typed to those platforms — so you don't
+ * repeat `useWallets<typeof platforms>()` in every component.
+ *
+ * @example
+ * ```tsx
+ * // kheopskit.ts
+ * export const { KheopskitProvider, useWallets, useAccounts } = createKheopskit({
+ *   platforms: [polkadot(), ethereum(), solana()],
+ * });
+ *
+ * // anywhere
+ * const { accounts } = useWallets(); // accounts are platform-precise, no generic
+ * ```
+ */
+declare const createKheopskit: <const P extends readonly [KheopskitPlatform, ...KheopskitPlatform[]]>(config: CreateKheopskitConfig<P>) => {
+    KheopskitProvider: FC<PropsWithChildren<{
+        ssrCookies?: string;
+    }>>;
+    /** Current state, typed to the bound platform tuple. */
+    useWallets: () => _kheopskit_core.KheopskitState<P>;
+    /** Current accounts, typed to the bound platform tuple. */
+    useAccounts: () => _kheopskit_core.AccountOf<P[number]>[];
+};
+
 type KheopskitProviderProps = PropsWithChildren & {
+    /**
+     * Kheopskit configuration.
+     *
+     * @remarks
+     * Must be a **referentially stable** value — define it once (module scope, a
+     * `useMemo`, or via {@link createKheopskit}) and pass the same reference. A
+     * new object literal on every render (`config={{ platforms: [...] }}` inline)
+     * recreates the underlying store and re-subscribes each render.
+     */
     config?: Partial<KheopskitConfig>;
     /**
      * Cookie string for SSR hydration.
@@ -25,6 +64,22 @@ type KheopskitProviderProps = PropsWithChildren & {
 };
 declare const KheopskitProvider: FC<KheopskitProviderProps>;
 
-declare const useWallets: () => _kheopskit_core.KheopskitState;
+/**
+ * Convenience hook returning just the accounts from kheopskit state. Pass the
+ * platform tuple as a type argument to recover SDK-precise account types —
+ * `useAccounts<typeof platforms>()` — or use the pre-typed hook from
+ * {@link createKheopskit}.
+ */
+declare const useAccounts: <P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]>() => _kheopskit_core.AccountOf<P[number]>[];
+
+/**
+ * Returns the current kheopskit state (wallets, accounts, config, isHydrating).
+ *
+ * Pass the platform tuple as a type argument to recover SDK-precise account and
+ * wallet types — `useWallets<typeof platforms>()`. React contexts can't be
+ * generic, so without the argument the state is typed with the base
+ * (SDK-free) wallet/account shapes.
+ */
+declare const useWallets: <P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]>() => KheopskitState<P>;
 
-export { KheopskitProvider, type KheopskitProviderProps, useWallets };
+export { type CreateKheopskitConfig, KheopskitProvider, type KheopskitProviderProps, createKheopskit, useAccounts, useWallets };

package/dist/index.d.ts

@@ -1,8 +1,47 @@
 import * as _kheopskit_core from '@kheopskit/core';
-import { KheopskitConfig } from '@kheopskit/core';
+import { KheopskitPlatform, KheopskitConfig, KheopskitState } from '@kheopskit/core';
 import { FC, PropsWithChildren } from 'react';
 
+type CreateKheopskitConfig<P extends readonly KheopskitPlatform[]> = Omit<Partial<KheopskitConfig<P>>, "platforms"> & {
+    /** Platform plugins, e.g. `[polkadot(), solana()]`. Required. */
+    platforms: P;
+};
+/**
+ * Binds a platform tuple once and returns a `KheopskitProvider` plus hooks
+ * (`useWallets`, `useAccounts`) already typed to those platforms — so you don't
+ * repeat `useWallets<typeof platforms>()` in every component.
+ *
+ * @example
+ * ```tsx
+ * // kheopskit.ts
+ * export const { KheopskitProvider, useWallets, useAccounts } = createKheopskit({
+ *   platforms: [polkadot(), ethereum(), solana()],
+ * });
+ *
+ * // anywhere
+ * const { accounts } = useWallets(); // accounts are platform-precise, no generic
+ * ```
+ */
+declare const createKheopskit: <const P extends readonly [KheopskitPlatform, ...KheopskitPlatform[]]>(config: CreateKheopskitConfig<P>) => {
+    KheopskitProvider: FC<PropsWithChildren<{
+        ssrCookies?: string;
+    }>>;
+    /** Current state, typed to the bound platform tuple. */
+    useWallets: () => _kheopskit_core.KheopskitState<P>;
+    /** Current accounts, typed to the bound platform tuple. */
+    useAccounts: () => _kheopskit_core.AccountOf<P[number]>[];
+};
+
 type KheopskitProviderProps = PropsWithChildren & {
+    /**
+     * Kheopskit configuration.
+     *
+     * @remarks
+     * Must be a **referentially stable** value — define it once (module scope, a
+     * `useMemo`, or via {@link createKheopskit}) and pass the same reference. A
+     * new object literal on every render (`config={{ platforms: [...] }}` inline)
+     * recreates the underlying store and re-subscribes each render.
+     */
     config?: Partial<KheopskitConfig>;
     /**
      * Cookie string for SSR hydration.
@@ -25,6 +64,22 @@ type KheopskitProviderProps = PropsWithChildren & {
 };
 declare const KheopskitProvider: FC<KheopskitProviderProps>;
 
-declare const useWallets: () => _kheopskit_core.KheopskitState;
+/**
+ * Convenience hook returning just the accounts from kheopskit state. Pass the
+ * platform tuple as a type argument to recover SDK-precise account types —
+ * `useAccounts<typeof platforms>()` — or use the pre-typed hook from
+ * {@link createKheopskit}.
+ */
+declare const useAccounts: <P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]>() => _kheopskit_core.AccountOf<P[number]>[];
+
+/**
+ * Returns the current kheopskit state (wallets, accounts, config, isHydrating).
+ *
+ * Pass the platform tuple as a type argument to recover SDK-precise account and
+ * wallet types — `useWallets<typeof platforms>()`. React contexts can't be
+ * generic, so without the argument the state is typed with the base
+ * (SDK-free) wallet/account shapes.
+ */
+declare const useWallets: <P extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[]>() => KheopskitState<P>;
 
-export { KheopskitProvider, type KheopskitProviderProps, useWallets };
+export { type CreateKheopskitConfig, KheopskitProvider, type KheopskitProviderProps, createKheopskit, useAccounts, useWallets };

package/dist/index.js

@@ -1,3 +1,4 @@
+"use client";
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -21,12 +22,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   KheopskitProvider: () => KheopskitProvider,
+  createKheopskit: () => createKheopskit,
+  useAccounts: () => useAccounts,
   useWallets: () => useWallets
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/KheopskitProvider.tsx
 var import_core = require("@kheopskit/core");
+var import_internal = require("@kheopskit/core/internal");
 var import_react2 = require("react");
 
 // src/context.ts
@@ -49,13 +53,12 @@ var createStore = (observable$, initialValue, serverValue) => {
       });
     }
   };
-  ensureSubscription();
   const getSnapshot = () => latestValue ?? initialValue;
   const getServerSnapshot = () => serverValue ?? initialValue;
   const subscribe = (callback) => {
     subscriberCount++;
-    listeners.add(callback);
     ensureSubscription();
+    listeners.add(callback);
     callback(getSnapshot());
     return () => {
       subscriberCount--;
@@ -84,6 +87,17 @@ var KheopskitProvider = ({
   ssrCookies
 }) => {
   const resolvedConfig = (0, import_react2.useMemo)(() => (0, import_core.resolveConfig)(config), [config]);
+  const lastConfigRef = (0, import_react2.useRef)(config);
+  const hasMountedRef = (0, import_react2.useRef)(false);
+  (0, import_react2.useEffect)(() => {
+    if (hasMountedRef.current && lastConfigRef.current !== config && (typeof process === "undefined" || process.env?.NODE_ENV !== "production")) {
+      console.warn(
+        "[kheopskit] KheopskitProvider received a new `config` reference; this recreates the store and re-subscribes on every render. Pass a referentially stable config (module scope, useMemo, or createKheopskit())."
+      );
+    }
+    hasMountedRef.current = true;
+    lastConfigRef.current = config;
+  }, [config]);
   const kheopskitStore = (0, import_react2.useMemo)(
     () => (0, import_core.createKheopskitStore)({
       ssrCookies,
@@ -102,32 +116,32 @@ var KheopskitProvider = ({
     }
     const cached = kheopskitStore.getCachedState();
     return {
-      wallets: cached.wallets.map(import_core.hydrateWallet),
-      accounts: cached.accounts.map(import_core.hydrateAccount).filter(
-        (account) => account.platform !== "polkadot" || resolvedConfig.polkadotAccountTypes.includes(account.type)
-      ),
+      wallets: cached.wallets.map(import_internal.hydrateWallet).sort(import_internal.sortWallets),
+      accounts: cached.accounts.filter(
+        (account) => (0, import_internal.acceptsCachedAccount)(account, resolvedConfig.platforms)
+      ).map(import_internal.hydrateAccount).sort(import_internal.sortAccounts),
       config: resolvedConfig,
       isHydrating: true
     };
   }, [ssrCookies, kheopskitStore, resolvedConfig]);
   const initialValue = (0, import_react2.useMemo)(() => {
-    const enrichedWallets = serverValue.wallets.map((w) => {
-      if (!w.icon) {
-        const cachedIcon = (0, import_core.getCachedIcon)(w.id);
-        if (cachedIcon) {
-          return { ...w, icon: cachedIcon };
-        }
-      }
-      return w;
-    });
+    const cached = kheopskitStore.getCachedState();
     return {
-      ...serverValue,
-      wallets: enrichedWallets
+      wallets: cached.wallets.map(import_internal.hydrateWallet).map((wallet) => {
+        if (wallet.icon) return wallet;
+        const cachedIcon = (0, import_internal.getCachedIcon)(wallet.id);
+        return cachedIcon ? { ...wallet, icon: cachedIcon } : wallet;
+      }).sort(import_internal.sortWallets),
+      accounts: cached.accounts.filter(
+        (account) => (0, import_internal.acceptsCachedAccount)(account, resolvedConfig.platforms)
+      ).map(import_internal.hydrateAccount).sort(import_internal.sortAccounts),
+      config: resolvedConfig,
+      isHydrating: true
     };
-  }, [serverValue]);
+  }, [kheopskitStore, resolvedConfig]);
   const store = (0, import_react2.useMemo)(
     () => createStore(
-      (0, import_core.getKheopskit$)(config, ssrCookies, kheopskitStore),
+      (0, import_core.getKheopskit$)(config, { ssrCookies, store: kheopskitStore }),
       initialValue,
       serverValue
     ),
@@ -153,9 +167,31 @@ var useWallets = () => {
     throw new Error("useWallets can't be used without a KheopskitProvider");
   return ctx.state;
 };
+
+// src/createKheopskit.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+var createKheopskit = (config) => {
+  const Provider = ({
+    children,
+    ssrCookies
+  }) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(KheopskitProvider, { config, ssrCookies, children });
+  Provider.displayName = "KheopskitProvider";
+  return {
+    KheopskitProvider: Provider,
+    /** Current state, typed to the bound platform tuple. */
+    useWallets: () => useWallets(),
+    /** Current accounts, typed to the bound platform tuple. */
+    useAccounts: () => useWallets().accounts
+  };
+};
+
+// src/useAccounts.ts
+var useAccounts = () => useWallets().accounts;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   KheopskitProvider,
+  createKheopskit,
+  useAccounts,
   useWallets
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/KheopskitProvider.tsx","../src/context.ts","../src/createStore.ts","../src/useWallets.ts"],"sourcesContent":["export * from \"./KheopskitProvider\";\nexport * from \"./useWallets\";\n","import {\n\tcreateKheopskitStore,\n\tgetCachedIcon,\n\tgetKheopskit$,\n\thydrateAccount,\n\thydrateWallet,\n\ttype KheopskitConfig,\n\ttype KheopskitState,\n\tresolveConfig,\n} from \"@kheopskit/core\";\nimport {\n\ttype FC,\n\ttype PropsWithChildren,\n\tuseEffect,\n\tuseMemo,\n\tuseSyncExternalStore,\n} from \"react\";\nimport { KheopskitContext } from \"./context\";\nimport { createStore } from \"./createStore\";\n\nexport type KheopskitProviderProps = PropsWithChildren & {\n\tconfig?: Partial<KheopskitConfig>;\n\t/**\n\t * Cookie string for SSR hydration.\n\t * Pass the request cookie header (e.g., from Next.js headers or TanStack Start)\n\t * to hydrate wallet state on the server.\n\t *\n\t * @remarks\n\t * This value should be stable per render to avoid unnecessary store recreation.\n\t * Compute it once in your server component or layout and pass it down.\n\t *\n\t * @example\n\t * ```tsx\n\t * // Next.js App Router\n\t * const cookieStore = await cookies();\n\t * const ssrCookies = cookieStore.getAll().map(c => `${c.name}=${c.value}`).join('; ');\n\t * return <Providers ssrCookies={ssrCookies}>{children}</Providers>\n\t * ```\n\t */\n\tssrCookies?: string;\n};\n\nexport const KheopskitProvider: FC<KheopskitProviderProps> = ({\n\tchildren,\n\tconfig,\n\tssrCookies,\n}) => {\n\tconst resolvedConfig = useMemo(() => resolveConfig(config), [config]);\n\n\t// Create a single store for both reading cached state and powering the observable\n\tconst kheopskitStore = useMemo(\n\t\t() =>\n\t\t\tcreateKheopskitStore({\n\t\t\t\tssrCookies,\n\t\t\t\tstorageKey: resolvedConfig.storageKey,\n\t\t\t}),\n\t\t[ssrCookies, resolvedConfig.storageKey],\n\t);\n\n\t// Read cached state from the store for SSR hydration\n\t// This produces wallets WITHOUT localStorage icons (Ethereum wallets have no icon)\n\t// because localStorage isn't available on server\n\tconst serverValue = useMemo<KheopskitState>(() => {\n\t\tif (ssrCookies === undefined) {\n\t\t\treturn {\n\t\t\t\twallets: [],\n\t\t\t\taccounts: [],\n\t\t\t\tconfig: resolvedConfig,\n\t\t\t\tisHydrating: true,\n\t\t\t};\n\t\t}\n\t\tconst cached = kheopskitStore.getCachedState();\n\t\treturn {\n\t\t\twallets: cached.wallets.map(hydrateWallet),\n\t\t\taccounts: cached.accounts\n\t\t\t\t.map(hydrateAccount)\n\t\t\t\t.filter(\n\t\t\t\t\t(account) =>\n\t\t\t\t\t\taccount.platform !== \"polkadot\" ||\n\t\t\t\t\t\tresolvedConfig.polkadotAccountTypes.includes(account.type),\n\t\t\t\t),\n\t\t\tconfig: resolvedConfig,\n\t\t\tisHydrating: true,\n\t\t};\n\t}, [ssrCookies, kheopskitStore, resolvedConfig]);\n\n\t// Initial value for client includes localStorage icons\n\t// This is what we WANT the client to render, not what server rendered\n\tconst initialValue = useMemo<KheopskitState>(() => {\n\t\t// On client, enrich wallets with localStorage icons\n\t\t// getCachedIcon returns empty on server (no localStorage), so this is safe\n\t\tconst enrichedWallets = serverValue.wallets.map((w) => {\n\t\t\tif (!w.icon) {\n\t\t\t\tconst cachedIcon = getCachedIcon(w.id);\n\t\t\t\tif (cachedIcon) {\n\t\t\t\t\treturn { ...w, icon: cachedIcon };\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn w;\n\t\t});\n\t\treturn {\n\t\t\t...serverValue,\n\t\t\twallets: enrichedWallets,\n\t\t};\n\t}, [serverValue]);\n\n\tconst store = useMemo(\n\t\t() =>\n\t\t\tcreateStore(\n\t\t\t\tgetKheopskit$(config, ssrCookies, kheopskitStore),\n\t\t\t\tinitialValue,\n\t\t\t\tserverValue,\n\t\t\t),\n\t\t[config, ssrCookies, kheopskitStore, initialValue, serverValue],\n\t);\n\n\t// Cleanup store subscriptions when store changes or component unmounts\n\tuseEffect(() => {\n\t\treturn () => store.destroy();\n\t}, [store]);\n\n\tconst state = useSyncExternalStore(\n\t\tstore.subscribe,\n\t\tstore.getSnapshot,\n\t\tstore.getServerSnapshot,\n\t);\n\n\tconst value = useMemo(() => ({ state }), [state]);\n\n\treturn (\n\t\t<KheopskitContext.Provider value={value}>\n\t\t\t{children}\n\t\t</KheopskitContext.Provider>\n\t);\n};\n","import type { KheopskitState } from \"@kheopskit/core\";\nimport { createContext } from \"react\";\n\nexport const KheopskitContext = createContext<{\n\tstate: KheopskitState;\n} | null>(null);\n","import type { Observable, Subscription } from \"rxjs\";\n\nexport const createStore = <T>(\n\tobservable$: Observable<T>,\n\tinitialValue: T,\n\tserverValue?: T,\n) => {\n\t// Use null as sentinel to indicate we haven't received first emission yet\n\tlet latestValue: T | null = null;\n\tlet subscription: Subscription | null = null;\n\tlet subscriberCount = 0;\n\tconst listeners = new Set<(value: T) => void>();\n\n\tconst ensureSubscription = () => {\n\t\tif (!subscription || subscription.closed) {\n\t\t\tsubscription = observable$.subscribe((value) => {\n\t\t\t\tlatestValue = value;\n\t\t\t\tfor (const listener of listeners) {\n\t\t\t\t\tlistener(value);\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t};\n\n\t// Start subscription immediately\n\tensureSubscription();\n\n\t// If observable emitted synchronously, use that value\n\t// Otherwise fall back to initialValue\n\tconst getSnapshot = () => latestValue ?? initialValue;\n\n\t/**\n\t * Returns the server-side snapshot for SSR hydration.\n\t * This prevents hydration mismatches by providing a consistent\n\t * value during server rendering. Must return the same value as\n\t * what the server rendered.\n\t */\n\tconst getServerSnapshot = () => serverValue ?? initialValue;\n\n\tconst subscribe = (callback: (value: T) => void) => {\n\t\tsubscriberCount++;\n\t\tlisteners.add(callback);\n\t\t// Ensure observable subscription is active when someone subscribes\n\t\tensureSubscription();\n\n\t\t// Immediately emit current value (BehaviorSubject semantics)\n\t\tcallback(getSnapshot());\n\n\t\treturn () => {\n\t\t\tsubscriberCount--;\n\t\t\tlisteners.delete(callback);\n\t\t\t// Don't close the observable subscription on unsubscribe\n\t\t\t// Let destroy() handle that when the store is truly being disposed\n\t\t};\n\t};\n\n\tconst destroy = () => {\n\t\t// Only unsubscribe if no one is listening\n\t\t// React StrictMode may call destroy and then immediately resubscribe\n\t\tif (subscriberCount === 0 && subscription) {\n\t\t\tsubscription.unsubscribe();\n\t\t\tsubscription = null;\n\t\t}\n\t};\n\n\treturn {\n\t\tgetSnapshot,\n\t\tgetServerSnapshot,\n\t\tsubscribe,\n\t\tdestroy,\n\t};\n};\n","import { useContext } from \"react\";\nimport { KheopskitContext } from \"./context\";\n\nexport const useWallets = () => {\n\tconst ctx = useContext(KheopskitContext);\n\n\t// useEffect(() => {\n\t//   console.debug(\n\t//     \"useWallets wallets:%s accounts:%s\",\n\t//     ctx?.state.wallets.length ?? 0,\n\t//     ctx?.state.accounts.length ?? 0,\n\t//   );\n\t// }, [ctx?.state]);\n\n\tif (!ctx)\n\t\tthrow new Error(\"useWallets can't be used without a KheopskitProvider\");\n\n\treturn ctx.state;\n};\n"],"mappings":"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","names":["import_react","import_react"]}
+{"version":3,"sources":["../src/index.ts","../src/KheopskitProvider.tsx","../src/context.ts","../src/createStore.ts","../src/useWallets.ts","../src/createKheopskit.tsx","../src/useAccounts.ts"],"sourcesContent":["export * from \"./createKheopskit\";\nexport * from \"./KheopskitProvider\";\nexport * from \"./useAccounts\";\nexport * from \"./useWallets\";\n","import {\n\tcreateKheopskitStore,\n\tgetKheopskit$,\n\ttype KheopskitConfig,\n\ttype KheopskitState,\n\tresolveConfig,\n} from \"@kheopskit/core\";\nimport {\n\tacceptsCachedAccount,\n\tgetCachedIcon,\n\thydrateAccount,\n\thydrateWallet,\n\tsortAccounts,\n\tsortWallets,\n} from \"@kheopskit/core/internal\";\nimport {\n\ttype FC,\n\ttype PropsWithChildren,\n\tuseEffect,\n\tuseMemo,\n\tuseRef,\n\tuseSyncExternalStore,\n} from \"react\";\nimport { KheopskitContext } from \"./context\";\nimport { createStore } from \"./createStore\";\n\nexport type KheopskitProviderProps = PropsWithChildren & {\n\t/**\n\t * Kheopskit configuration.\n\t *\n\t * @remarks\n\t * Must be a **referentially stable** value — define it once (module scope, a\n\t * `useMemo`, or via {@link createKheopskit}) and pass the same reference. A\n\t * new object literal on every render (`config={{ platforms: [...] }}` inline)\n\t * recreates the underlying store and re-subscribes each render.\n\t */\n\tconfig?: Partial<KheopskitConfig>;\n\t/**\n\t * Cookie string for SSR hydration.\n\t * Pass the request cookie header (e.g., from Next.js headers or TanStack Start)\n\t * to hydrate wallet state on the server.\n\t *\n\t * @remarks\n\t * This value should be stable per render to avoid unnecessary store recreation.\n\t * Compute it once in your server component or layout and pass it down.\n\t *\n\t * @example\n\t * ```tsx\n\t * // Next.js App Router\n\t * const cookieStore = await cookies();\n\t * const ssrCookies = cookieStore.getAll().map(c => `${c.name}=${c.value}`).join('; ');\n\t * return <Providers ssrCookies={ssrCookies}>{children}</Providers>\n\t * ```\n\t */\n\tssrCookies?: string;\n};\n\nexport const KheopskitProvider: FC<KheopskitProviderProps> = ({\n\tchildren,\n\tconfig,\n\tssrCookies,\n}) => {\n\tconst resolvedConfig = useMemo(() => resolveConfig(config), [config]);\n\n\t// Dev-only: warn if the `config` prop reference changes between renders. A new\n\t// object each render recreates the store and re-subscribes the whole pipeline\n\t// (re-hydrating, dropping live connection state) on every render. `config` must\n\t// be referentially stable — define it at module scope, memoize it, or use\n\t// createKheopskit() (which passes a stable reference for you).\n\tconst lastConfigRef = useRef(config);\n\tconst hasMountedRef = useRef(false);\n\tuseEffect(() => {\n\t\tif (\n\t\t\thasMountedRef.current &&\n\t\t\tlastConfigRef.current !== config &&\n\t\t\t(typeof process === \"undefined\" || process.env?.NODE_ENV !== \"production\")\n\t\t) {\n\t\t\tconsole.warn(\n\t\t\t\t\"[kheopskit] KheopskitProvider received a new `config` reference; this \" +\n\t\t\t\t\t\"recreates the store and re-subscribes on every render. Pass a \" +\n\t\t\t\t\t\"referentially stable config (module scope, useMemo, or createKheopskit()).\",\n\t\t\t);\n\t\t}\n\t\thasMountedRef.current = true;\n\t\tlastConfigRef.current = config;\n\t}, [config]);\n\n\t// Create a single store for both reading cached state and powering the observable\n\tconst kheopskitStore = useMemo(\n\t\t() =>\n\t\t\tcreateKheopskitStore({\n\t\t\t\tssrCookies,\n\t\t\t\tstorageKey: resolvedConfig.storageKey,\n\t\t\t}),\n\t\t[ssrCookies, resolvedConfig.storageKey],\n\t);\n\n\t// Read cached state from the store for SSR hydration\n\t// This produces wallets WITHOUT localStorage icons (Ethereum wallets have no icon)\n\t// because localStorage isn't available on server\n\tconst serverValue = useMemo<KheopskitState>(() => {\n\t\tif (ssrCookies === undefined) {\n\t\t\treturn {\n\t\t\t\twallets: [],\n\t\t\t\taccounts: [],\n\t\t\t\tconfig: resolvedConfig,\n\t\t\t\tisHydrating: true,\n\t\t\t};\n\t\t}\n\t\tconst cached = kheopskitStore.getCachedState();\n\t\treturn {\n\t\t\twallets: cached.wallets.map(hydrateWallet).sort(sortWallets),\n\t\t\taccounts: cached.accounts\n\t\t\t\t.filter((account) =>\n\t\t\t\t\tacceptsCachedAccount(account, resolvedConfig.platforms),\n\t\t\t\t)\n\t\t\t\t.map(hydrateAccount)\n\t\t\t\t.sort(sortAccounts),\n\t\t\tconfig: resolvedConfig,\n\t\t\tisHydrating: true,\n\t\t};\n\t}, [ssrCookies, kheopskitStore, resolvedConfig]);\n\n\t// Client-only initial snapshot, read straight from the client cache so a hard\n\t// reload paints the cached wallet/account list on the very first frame instead\n\t// of flashing empty until the live observable produces its first emission —\n\t// which can be asynchronous (e.g. WalletConnect's AppKit is loaded via dynamic\n\t// import, so the underlying combineLatest can't emit synchronously).\n\t//\n\t// We can't derive this from `serverValue`: without SSR cookies that stays empty\n\t// (to keep the server/client hydration markup identical), so the SPA case would\n\t// otherwise render nothing. This snapshot is only ever read on the client via\n\t// getSnapshot, so reading the cache here is safe — and getCachedIcon returns \"\"\n\t// on the server, making the icon enrichment a no-op there.\n\tconst initialValue = useMemo<KheopskitState>(() => {\n\t\tconst cached = kheopskitStore.getCachedState();\n\t\treturn {\n\t\t\twallets: cached.wallets\n\t\t\t\t.map(hydrateWallet)\n\t\t\t\t.map((wallet) => {\n\t\t\t\t\tif (wallet.icon) return wallet;\n\t\t\t\t\tconst cachedIcon = getCachedIcon(wallet.id);\n\t\t\t\t\treturn cachedIcon ? { ...wallet, icon: cachedIcon } : wallet;\n\t\t\t\t})\n\t\t\t\t.sort(sortWallets),\n\t\t\taccounts: cached.accounts\n\t\t\t\t.filter((account) =>\n\t\t\t\t\tacceptsCachedAccount(account, resolvedConfig.platforms),\n\t\t\t\t)\n\t\t\t\t.map(hydrateAccount)\n\t\t\t\t.sort(sortAccounts),\n\t\t\tconfig: resolvedConfig,\n\t\t\tisHydrating: true,\n\t\t};\n\t}, [kheopskitStore, resolvedConfig]);\n\n\tconst store = useMemo(\n\t\t() =>\n\t\t\tcreateStore(\n\t\t\t\tgetKheopskit$(config, { ssrCookies, store: kheopskitStore }),\n\t\t\t\tinitialValue,\n\t\t\t\tserverValue,\n\t\t\t),\n\t\t[config, ssrCookies, kheopskitStore, initialValue, serverValue],\n\t);\n\n\t// Cleanup store subscriptions when store changes or component unmounts\n\tuseEffect(() => {\n\t\treturn () => store.destroy();\n\t}, [store]);\n\n\tconst state = useSyncExternalStore(\n\t\tstore.subscribe,\n\t\tstore.getSnapshot,\n\t\tstore.getServerSnapshot,\n\t);\n\n\tconst value = useMemo(() => ({ state }), [state]);\n\n\treturn (\n\t\t<KheopskitContext.Provider value={value}>\n\t\t\t{children}\n\t\t</KheopskitContext.Provider>\n\t);\n};\n","import type { KheopskitState } from \"@kheopskit/core\";\nimport { createContext } from \"react\";\n\nexport const KheopskitContext = createContext<{\n\tstate: KheopskitState;\n} | null>(null);\n","import type { Observable, Subscription } from \"rxjs\";\n\nexport const createStore = <T>(\n\tobservable$: Observable<T>,\n\tinitialValue: T,\n\tserverValue?: T,\n) => {\n\t// Use null as sentinel to indicate we haven't received first emission yet\n\tlet latestValue: T | null = null;\n\tlet subscription: Subscription | null = null;\n\tlet subscriberCount = 0;\n\tconst listeners = new Set<(value: T) => void>();\n\n\tconst ensureSubscription = () => {\n\t\tif (!subscription || subscription.closed) {\n\t\t\tsubscription = observable$.subscribe((value) => {\n\t\t\t\tlatestValue = value;\n\t\t\t\tfor (const listener of listeners) {\n\t\t\t\t\tlistener(value);\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t};\n\n\t// The subscription is created lazily by subscribe() (which React calls from a\n\t// committed passive effect), never during render. React may render a tree and\n\t// throw it away without committing — StrictMode double-invokes the initial\n\t// render, and concurrent/Suspense can discard renders — so subscribing eagerly\n\t// here (createStore runs inside the Provider's render-phase useMemo) would leak\n\t// the discarded store's observable subscription. Until the first emission,\n\t// getSnapshot falls back to initialValue.\n\tconst getSnapshot = () => latestValue ?? initialValue;\n\n\t/**\n\t * Returns the server-side snapshot for SSR hydration.\n\t * This prevents hydration mismatches by providing a consistent\n\t * value during server rendering. Must return the same value as\n\t * what the server rendered.\n\t */\n\tconst getServerSnapshot = () => serverValue ?? initialValue;\n\n\tconst subscribe = (callback: (value: T) => void) => {\n\t\tsubscriberCount++;\n\t\t// Subscribe to the observable BEFORE registering this listener, so a\n\t\t// synchronous replay (BehaviorSubject / shareReplay) updates latestValue\n\t\t// without double-invoking this callback — the current value is emitted once,\n\t\t// explicitly, just below.\n\t\tensureSubscription();\n\t\tlisteners.add(callback);\n\n\t\t// Immediately emit current value (BehaviorSubject semantics)\n\t\tcallback(getSnapshot());\n\n\t\treturn () => {\n\t\t\tsubscriberCount--;\n\t\t\tlisteners.delete(callback);\n\t\t\t// Don't close the observable subscription on unsubscribe\n\t\t\t// Let destroy() handle that when the store is truly being disposed\n\t\t};\n\t};\n\n\tconst destroy = () => {\n\t\t// Only unsubscribe if no one is listening\n\t\t// React StrictMode may call destroy and then immediately resubscribe\n\t\tif (subscriberCount === 0 && subscription) {\n\t\t\tsubscription.unsubscribe();\n\t\t\tsubscription = null;\n\t\t}\n\t};\n\n\treturn {\n\t\tgetSnapshot,\n\t\tgetServerSnapshot,\n\t\tsubscribe,\n\t\tdestroy,\n\t};\n};\n","import type { KheopskitPlatform, KheopskitState } from \"@kheopskit/core\";\nimport { useContext } from \"react\";\nimport { KheopskitContext } from \"./context\";\n\n/**\n * Returns the current kheopskit state (wallets, accounts, config, isHydrating).\n *\n * Pass the platform tuple as a type argument to recover SDK-precise account and\n * wallet types — `useWallets<typeof platforms>()`. React contexts can't be\n * generic, so without the argument the state is typed with the base\n * (SDK-free) wallet/account shapes.\n */\nexport const useWallets = <\n\tP extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[],\n>(): KheopskitState<P> => {\n\tconst ctx = useContext(KheopskitContext);\n\n\tif (!ctx)\n\t\tthrow new Error(\"useWallets can't be used without a KheopskitProvider\");\n\n\treturn ctx.state as unknown as KheopskitState<P>;\n};\n","import type { KheopskitConfig, KheopskitPlatform } from \"@kheopskit/core\";\nimport type { FC, PropsWithChildren } from \"react\";\nimport { KheopskitProvider } from \"./KheopskitProvider\";\nimport { useWallets } from \"./useWallets\";\n\nexport type CreateKheopskitConfig<P extends readonly KheopskitPlatform[]> =\n\tOmit<Partial<KheopskitConfig<P>>, \"platforms\"> & {\n\t\t/** Platform plugins, e.g. `[polkadot(), solana()]`. Required. */\n\t\tplatforms: P;\n\t};\n\n/**\n * Binds a platform tuple once and returns a `KheopskitProvider` plus hooks\n * (`useWallets`, `useAccounts`) already typed to those platforms — so you don't\n * repeat `useWallets<typeof platforms>()` in every component.\n *\n * @example\n * ```tsx\n * // kheopskit.ts\n * export const { KheopskitProvider, useWallets, useAccounts } = createKheopskit({\n *   platforms: [polkadot(), ethereum(), solana()],\n * });\n *\n * // anywhere\n * const { accounts } = useWallets(); // accounts are platform-precise, no generic\n * ```\n */\nexport const createKheopskit = <\n\tconst P extends readonly [KheopskitPlatform, ...KheopskitPlatform[]],\n>(\n\tconfig: CreateKheopskitConfig<P>,\n) => {\n\tconst Provider: FC<PropsWithChildren<{ ssrCookies?: string }>> = ({\n\t\tchildren,\n\t\tssrCookies,\n\t}) => (\n\t\t<KheopskitProvider config={config} ssrCookies={ssrCookies}>\n\t\t\t{children}\n\t\t</KheopskitProvider>\n\t);\n\tProvider.displayName = \"KheopskitProvider\";\n\n\treturn {\n\t\tKheopskitProvider: Provider,\n\t\t/** Current state, typed to the bound platform tuple. */\n\t\tuseWallets: () => useWallets<P>(),\n\t\t/** Current accounts, typed to the bound platform tuple. */\n\t\tuseAccounts: () => useWallets<P>().accounts,\n\t};\n};\n","import type { KheopskitPlatform } from \"@kheopskit/core\";\nimport { useWallets } from \"./useWallets\";\n\n/**\n * Convenience hook returning just the accounts from kheopskit state. Pass the\n * platform tuple as a type argument to recover SDK-precise account types —\n * `useAccounts<typeof platforms>()` — or use the pre-typed hook from\n * {@link createKheopskit}.\n */\nexport const useAccounts = <\n\tP extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[],\n>() => useWallets<P>().accounts;\n"],"mappings":"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","names":["import_react","import_react","import_jsx_runtime"]}

package/dist/index.mjs

@@ -1,15 +1,23 @@
+"use client";
+
 // src/KheopskitProvider.tsx
 import {
   createKheopskitStore,
-  getCachedIcon,
   getKheopskit$,
-  hydrateAccount,
-  hydrateWallet,
   resolveConfig
 } from "@kheopskit/core";
+import {
+  acceptsCachedAccount,
+  getCachedIcon,
+  hydrateAccount,
+  hydrateWallet,
+  sortAccounts,
+  sortWallets
+} from "@kheopskit/core/internal";
 import {
   useEffect,
   useMemo,
+  useRef,
   useSyncExternalStore
 } from "react";
 
@@ -33,13 +41,12 @@ var createStore = (observable$, initialValue, serverValue) => {
       });
     }
   };
-  ensureSubscription();
   const getSnapshot = () => latestValue ?? initialValue;
   const getServerSnapshot = () => serverValue ?? initialValue;
   const subscribe = (callback) => {
     subscriberCount++;
-    listeners.add(callback);
     ensureSubscription();
+    listeners.add(callback);
     callback(getSnapshot());
     return () => {
       subscriberCount--;
@@ -68,6 +75,17 @@ var KheopskitProvider = ({
   ssrCookies
 }) => {
   const resolvedConfig = useMemo(() => resolveConfig(config), [config]);
+  const lastConfigRef = useRef(config);
+  const hasMountedRef = useRef(false);
+  useEffect(() => {
+    if (hasMountedRef.current && lastConfigRef.current !== config && (typeof process === "undefined" || process.env?.NODE_ENV !== "production")) {
+      console.warn(
+        "[kheopskit] KheopskitProvider received a new `config` reference; this recreates the store and re-subscribes on every render. Pass a referentially stable config (module scope, useMemo, or createKheopskit())."
+      );
+    }
+    hasMountedRef.current = true;
+    lastConfigRef.current = config;
+  }, [config]);
   const kheopskitStore = useMemo(
     () => createKheopskitStore({
       ssrCookies,
@@ -86,32 +104,32 @@ var KheopskitProvider = ({
     }
     const cached = kheopskitStore.getCachedState();
     return {
-      wallets: cached.wallets.map(hydrateWallet),
-      accounts: cached.accounts.map(hydrateAccount).filter(
-        (account) => account.platform !== "polkadot" || resolvedConfig.polkadotAccountTypes.includes(account.type)
-      ),
+      wallets: cached.wallets.map(hydrateWallet).sort(sortWallets),
+      accounts: cached.accounts.filter(
+        (account) => acceptsCachedAccount(account, resolvedConfig.platforms)
+      ).map(hydrateAccount).sort(sortAccounts),
       config: resolvedConfig,
       isHydrating: true
     };
   }, [ssrCookies, kheopskitStore, resolvedConfig]);
   const initialValue = useMemo(() => {
-    const enrichedWallets = serverValue.wallets.map((w) => {
-      if (!w.icon) {
-        const cachedIcon = getCachedIcon(w.id);
-        if (cachedIcon) {
-          return { ...w, icon: cachedIcon };
-        }
-      }
-      return w;
-    });
+    const cached = kheopskitStore.getCachedState();
     return {
-      ...serverValue,
-      wallets: enrichedWallets
+      wallets: cached.wallets.map(hydrateWallet).map((wallet) => {
+        if (wallet.icon) return wallet;
+        const cachedIcon = getCachedIcon(wallet.id);
+        return cachedIcon ? { ...wallet, icon: cachedIcon } : wallet;
+      }).sort(sortWallets),
+      accounts: cached.accounts.filter(
+        (account) => acceptsCachedAccount(account, resolvedConfig.platforms)
+      ).map(hydrateAccount).sort(sortAccounts),
+      config: resolvedConfig,
+      isHydrating: true
     };
-  }, [serverValue]);
+  }, [kheopskitStore, resolvedConfig]);
   const store = useMemo(
     () => createStore(
-      getKheopskit$(config, ssrCookies, kheopskitStore),
+      getKheopskit$(config, { ssrCookies, store: kheopskitStore }),
       initialValue,
       serverValue
     ),
@@ -137,8 +155,30 @@ var useWallets = () => {
     throw new Error("useWallets can't be used without a KheopskitProvider");
   return ctx.state;
 };
+
+// src/createKheopskit.tsx
+import { jsx as jsx2 } from "react/jsx-runtime";
+var createKheopskit = (config) => {
+  const Provider = ({
+    children,
+    ssrCookies
+  }) => /* @__PURE__ */ jsx2(KheopskitProvider, { config, ssrCookies, children });
+  Provider.displayName = "KheopskitProvider";
+  return {
+    KheopskitProvider: Provider,
+    /** Current state, typed to the bound platform tuple. */
+    useWallets: () => useWallets(),
+    /** Current accounts, typed to the bound platform tuple. */
+    useAccounts: () => useWallets().accounts
+  };
+};
+
+// src/useAccounts.ts
+var useAccounts = () => useWallets().accounts;
 export {
   KheopskitProvider,
+  createKheopskit,
+  useAccounts,
   useWallets
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/KheopskitProvider.tsx","../src/context.ts","../src/createStore.ts","../src/useWallets.ts"],"sourcesContent":["import {\n\tcreateKheopskitStore,\n\tgetCachedIcon,\n\tgetKheopskit$,\n\thydrateAccount,\n\thydrateWallet,\n\ttype KheopskitConfig,\n\ttype KheopskitState,\n\tresolveConfig,\n} from \"@kheopskit/core\";\nimport {\n\ttype FC,\n\ttype PropsWithChildren,\n\tuseEffect,\n\tuseMemo,\n\tuseSyncExternalStore,\n} from \"react\";\nimport { KheopskitContext } from \"./context\";\nimport { createStore } from \"./createStore\";\n\nexport type KheopskitProviderProps = PropsWithChildren & {\n\tconfig?: Partial<KheopskitConfig>;\n\t/**\n\t * Cookie string for SSR hydration.\n\t * Pass the request cookie header (e.g., from Next.js headers or TanStack Start)\n\t * to hydrate wallet state on the server.\n\t *\n\t * @remarks\n\t * This value should be stable per render to avoid unnecessary store recreation.\n\t * Compute it once in your server component or layout and pass it down.\n\t *\n\t * @example\n\t * ```tsx\n\t * // Next.js App Router\n\t * const cookieStore = await cookies();\n\t * const ssrCookies = cookieStore.getAll().map(c => `${c.name}=${c.value}`).join('; ');\n\t * return <Providers ssrCookies={ssrCookies}>{children}</Providers>\n\t * ```\n\t */\n\tssrCookies?: string;\n};\n\nexport const KheopskitProvider: FC<KheopskitProviderProps> = ({\n\tchildren,\n\tconfig,\n\tssrCookies,\n}) => {\n\tconst resolvedConfig = useMemo(() => resolveConfig(config), [config]);\n\n\t// Create a single store for both reading cached state and powering the observable\n\tconst kheopskitStore = useMemo(\n\t\t() =>\n\t\t\tcreateKheopskitStore({\n\t\t\t\tssrCookies,\n\t\t\t\tstorageKey: resolvedConfig.storageKey,\n\t\t\t}),\n\t\t[ssrCookies, resolvedConfig.storageKey],\n\t);\n\n\t// Read cached state from the store for SSR hydration\n\t// This produces wallets WITHOUT localStorage icons (Ethereum wallets have no icon)\n\t// because localStorage isn't available on server\n\tconst serverValue = useMemo<KheopskitState>(() => {\n\t\tif (ssrCookies === undefined) {\n\t\t\treturn {\n\t\t\t\twallets: [],\n\t\t\t\taccounts: [],\n\t\t\t\tconfig: resolvedConfig,\n\t\t\t\tisHydrating: true,\n\t\t\t};\n\t\t}\n\t\tconst cached = kheopskitStore.getCachedState();\n\t\treturn {\n\t\t\twallets: cached.wallets.map(hydrateWallet),\n\t\t\taccounts: cached.accounts\n\t\t\t\t.map(hydrateAccount)\n\t\t\t\t.filter(\n\t\t\t\t\t(account) =>\n\t\t\t\t\t\taccount.platform !== \"polkadot\" ||\n\t\t\t\t\t\tresolvedConfig.polkadotAccountTypes.includes(account.type),\n\t\t\t\t),\n\t\t\tconfig: resolvedConfig,\n\t\t\tisHydrating: true,\n\t\t};\n\t}, [ssrCookies, kheopskitStore, resolvedConfig]);\n\n\t// Initial value for client includes localStorage icons\n\t// This is what we WANT the client to render, not what server rendered\n\tconst initialValue = useMemo<KheopskitState>(() => {\n\t\t// On client, enrich wallets with localStorage icons\n\t\t// getCachedIcon returns empty on server (no localStorage), so this is safe\n\t\tconst enrichedWallets = serverValue.wallets.map((w) => {\n\t\t\tif (!w.icon) {\n\t\t\t\tconst cachedIcon = getCachedIcon(w.id);\n\t\t\t\tif (cachedIcon) {\n\t\t\t\t\treturn { ...w, icon: cachedIcon };\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn w;\n\t\t});\n\t\treturn {\n\t\t\t...serverValue,\n\t\t\twallets: enrichedWallets,\n\t\t};\n\t}, [serverValue]);\n\n\tconst store = useMemo(\n\t\t() =>\n\t\t\tcreateStore(\n\t\t\t\tgetKheopskit$(config, ssrCookies, kheopskitStore),\n\t\t\t\tinitialValue,\n\t\t\t\tserverValue,\n\t\t\t),\n\t\t[config, ssrCookies, kheopskitStore, initialValue, serverValue],\n\t);\n\n\t// Cleanup store subscriptions when store changes or component unmounts\n\tuseEffect(() => {\n\t\treturn () => store.destroy();\n\t}, [store]);\n\n\tconst state = useSyncExternalStore(\n\t\tstore.subscribe,\n\t\tstore.getSnapshot,\n\t\tstore.getServerSnapshot,\n\t);\n\n\tconst value = useMemo(() => ({ state }), [state]);\n\n\treturn (\n\t\t<KheopskitContext.Provider value={value}>\n\t\t\t{children}\n\t\t</KheopskitContext.Provider>\n\t);\n};\n","import type { KheopskitState } from \"@kheopskit/core\";\nimport { createContext } from \"react\";\n\nexport const KheopskitContext = createContext<{\n\tstate: KheopskitState;\n} | null>(null);\n","import type { Observable, Subscription } from \"rxjs\";\n\nexport const createStore = <T>(\n\tobservable$: Observable<T>,\n\tinitialValue: T,\n\tserverValue?: T,\n) => {\n\t// Use null as sentinel to indicate we haven't received first emission yet\n\tlet latestValue: T | null = null;\n\tlet subscription: Subscription | null = null;\n\tlet subscriberCount = 0;\n\tconst listeners = new Set<(value: T) => void>();\n\n\tconst ensureSubscription = () => {\n\t\tif (!subscription || subscription.closed) {\n\t\t\tsubscription = observable$.subscribe((value) => {\n\t\t\t\tlatestValue = value;\n\t\t\t\tfor (const listener of listeners) {\n\t\t\t\t\tlistener(value);\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t};\n\n\t// Start subscription immediately\n\tensureSubscription();\n\n\t// If observable emitted synchronously, use that value\n\t// Otherwise fall back to initialValue\n\tconst getSnapshot = () => latestValue ?? initialValue;\n\n\t/**\n\t * Returns the server-side snapshot for SSR hydration.\n\t * This prevents hydration mismatches by providing a consistent\n\t * value during server rendering. Must return the same value as\n\t * what the server rendered.\n\t */\n\tconst getServerSnapshot = () => serverValue ?? initialValue;\n\n\tconst subscribe = (callback: (value: T) => void) => {\n\t\tsubscriberCount++;\n\t\tlisteners.add(callback);\n\t\t// Ensure observable subscription is active when someone subscribes\n\t\tensureSubscription();\n\n\t\t// Immediately emit current value (BehaviorSubject semantics)\n\t\tcallback(getSnapshot());\n\n\t\treturn () => {\n\t\t\tsubscriberCount--;\n\t\t\tlisteners.delete(callback);\n\t\t\t// Don't close the observable subscription on unsubscribe\n\t\t\t// Let destroy() handle that when the store is truly being disposed\n\t\t};\n\t};\n\n\tconst destroy = () => {\n\t\t// Only unsubscribe if no one is listening\n\t\t// React StrictMode may call destroy and then immediately resubscribe\n\t\tif (subscriberCount === 0 && subscription) {\n\t\t\tsubscription.unsubscribe();\n\t\t\tsubscription = null;\n\t\t}\n\t};\n\n\treturn {\n\t\tgetSnapshot,\n\t\tgetServerSnapshot,\n\t\tsubscribe,\n\t\tdestroy,\n\t};\n};\n","import { useContext } from \"react\";\nimport { KheopskitContext } from \"./context\";\n\nexport const useWallets = () => {\n\tconst ctx = useContext(KheopskitContext);\n\n\t// useEffect(() => {\n\t//   console.debug(\n\t//     \"useWallets wallets:%s accounts:%s\",\n\t//     ctx?.state.wallets.length ?? 0,\n\t//     ctx?.state.accounts.length ?? 0,\n\t//   );\n\t// }, [ctx?.state]);\n\n\tif (!ctx)\n\t\tthrow new Error(\"useWallets can't be used without a KheopskitProvider\");\n\n\treturn ctx.state;\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/KheopskitProvider.tsx","../src/context.ts","../src/createStore.ts","../src/useWallets.ts","../src/createKheopskit.tsx","../src/useAccounts.ts"],"sourcesContent":["import {\n\tcreateKheopskitStore,\n\tgetKheopskit$,\n\ttype KheopskitConfig,\n\ttype KheopskitState,\n\tresolveConfig,\n} from \"@kheopskit/core\";\nimport {\n\tacceptsCachedAccount,\n\tgetCachedIcon,\n\thydrateAccount,\n\thydrateWallet,\n\tsortAccounts,\n\tsortWallets,\n} from \"@kheopskit/core/internal\";\nimport {\n\ttype FC,\n\ttype PropsWithChildren,\n\tuseEffect,\n\tuseMemo,\n\tuseRef,\n\tuseSyncExternalStore,\n} from \"react\";\nimport { KheopskitContext } from \"./context\";\nimport { createStore } from \"./createStore\";\n\nexport type KheopskitProviderProps = PropsWithChildren & {\n\t/**\n\t * Kheopskit configuration.\n\t *\n\t * @remarks\n\t * Must be a **referentially stable** value — define it once (module scope, a\n\t * `useMemo`, or via {@link createKheopskit}) and pass the same reference. A\n\t * new object literal on every render (`config={{ platforms: [...] }}` inline)\n\t * recreates the underlying store and re-subscribes each render.\n\t */\n\tconfig?: Partial<KheopskitConfig>;\n\t/**\n\t * Cookie string for SSR hydration.\n\t * Pass the request cookie header (e.g., from Next.js headers or TanStack Start)\n\t * to hydrate wallet state on the server.\n\t *\n\t * @remarks\n\t * This value should be stable per render to avoid unnecessary store recreation.\n\t * Compute it once in your server component or layout and pass it down.\n\t *\n\t * @example\n\t * ```tsx\n\t * // Next.js App Router\n\t * const cookieStore = await cookies();\n\t * const ssrCookies = cookieStore.getAll().map(c => `${c.name}=${c.value}`).join('; ');\n\t * return <Providers ssrCookies={ssrCookies}>{children}</Providers>\n\t * ```\n\t */\n\tssrCookies?: string;\n};\n\nexport const KheopskitProvider: FC<KheopskitProviderProps> = ({\n\tchildren,\n\tconfig,\n\tssrCookies,\n}) => {\n\tconst resolvedConfig = useMemo(() => resolveConfig(config), [config]);\n\n\t// Dev-only: warn if the `config` prop reference changes between renders. A new\n\t// object each render recreates the store and re-subscribes the whole pipeline\n\t// (re-hydrating, dropping live connection state) on every render. `config` must\n\t// be referentially stable — define it at module scope, memoize it, or use\n\t// createKheopskit() (which passes a stable reference for you).\n\tconst lastConfigRef = useRef(config);\n\tconst hasMountedRef = useRef(false);\n\tuseEffect(() => {\n\t\tif (\n\t\t\thasMountedRef.current &&\n\t\t\tlastConfigRef.current !== config &&\n\t\t\t(typeof process === \"undefined\" || process.env?.NODE_ENV !== \"production\")\n\t\t) {\n\t\t\tconsole.warn(\n\t\t\t\t\"[kheopskit] KheopskitProvider received a new `config` reference; this \" +\n\t\t\t\t\t\"recreates the store and re-subscribes on every render. Pass a \" +\n\t\t\t\t\t\"referentially stable config (module scope, useMemo, or createKheopskit()).\",\n\t\t\t);\n\t\t}\n\t\thasMountedRef.current = true;\n\t\tlastConfigRef.current = config;\n\t}, [config]);\n\n\t// Create a single store for both reading cached state and powering the observable\n\tconst kheopskitStore = useMemo(\n\t\t() =>\n\t\t\tcreateKheopskitStore({\n\t\t\t\tssrCookies,\n\t\t\t\tstorageKey: resolvedConfig.storageKey,\n\t\t\t}),\n\t\t[ssrCookies, resolvedConfig.storageKey],\n\t);\n\n\t// Read cached state from the store for SSR hydration\n\t// This produces wallets WITHOUT localStorage icons (Ethereum wallets have no icon)\n\t// because localStorage isn't available on server\n\tconst serverValue = useMemo<KheopskitState>(() => {\n\t\tif (ssrCookies === undefined) {\n\t\t\treturn {\n\t\t\t\twallets: [],\n\t\t\t\taccounts: [],\n\t\t\t\tconfig: resolvedConfig,\n\t\t\t\tisHydrating: true,\n\t\t\t};\n\t\t}\n\t\tconst cached = kheopskitStore.getCachedState();\n\t\treturn {\n\t\t\twallets: cached.wallets.map(hydrateWallet).sort(sortWallets),\n\t\t\taccounts: cached.accounts\n\t\t\t\t.filter((account) =>\n\t\t\t\t\tacceptsCachedAccount(account, resolvedConfig.platforms),\n\t\t\t\t)\n\t\t\t\t.map(hydrateAccount)\n\t\t\t\t.sort(sortAccounts),\n\t\t\tconfig: resolvedConfig,\n\t\t\tisHydrating: true,\n\t\t};\n\t}, [ssrCookies, kheopskitStore, resolvedConfig]);\n\n\t// Client-only initial snapshot, read straight from the client cache so a hard\n\t// reload paints the cached wallet/account list on the very first frame instead\n\t// of flashing empty until the live observable produces its first emission —\n\t// which can be asynchronous (e.g. WalletConnect's AppKit is loaded via dynamic\n\t// import, so the underlying combineLatest can't emit synchronously).\n\t//\n\t// We can't derive this from `serverValue`: without SSR cookies that stays empty\n\t// (to keep the server/client hydration markup identical), so the SPA case would\n\t// otherwise render nothing. This snapshot is only ever read on the client via\n\t// getSnapshot, so reading the cache here is safe — and getCachedIcon returns \"\"\n\t// on the server, making the icon enrichment a no-op there.\n\tconst initialValue = useMemo<KheopskitState>(() => {\n\t\tconst cached = kheopskitStore.getCachedState();\n\t\treturn {\n\t\t\twallets: cached.wallets\n\t\t\t\t.map(hydrateWallet)\n\t\t\t\t.map((wallet) => {\n\t\t\t\t\tif (wallet.icon) return wallet;\n\t\t\t\t\tconst cachedIcon = getCachedIcon(wallet.id);\n\t\t\t\t\treturn cachedIcon ? { ...wallet, icon: cachedIcon } : wallet;\n\t\t\t\t})\n\t\t\t\t.sort(sortWallets),\n\t\t\taccounts: cached.accounts\n\t\t\t\t.filter((account) =>\n\t\t\t\t\tacceptsCachedAccount(account, resolvedConfig.platforms),\n\t\t\t\t)\n\t\t\t\t.map(hydrateAccount)\n\t\t\t\t.sort(sortAccounts),\n\t\t\tconfig: resolvedConfig,\n\t\t\tisHydrating: true,\n\t\t};\n\t}, [kheopskitStore, resolvedConfig]);\n\n\tconst store = useMemo(\n\t\t() =>\n\t\t\tcreateStore(\n\t\t\t\tgetKheopskit$(config, { ssrCookies, store: kheopskitStore }),\n\t\t\t\tinitialValue,\n\t\t\t\tserverValue,\n\t\t\t),\n\t\t[config, ssrCookies, kheopskitStore, initialValue, serverValue],\n\t);\n\n\t// Cleanup store subscriptions when store changes or component unmounts\n\tuseEffect(() => {\n\t\treturn () => store.destroy();\n\t}, [store]);\n\n\tconst state = useSyncExternalStore(\n\t\tstore.subscribe,\n\t\tstore.getSnapshot,\n\t\tstore.getServerSnapshot,\n\t);\n\n\tconst value = useMemo(() => ({ state }), [state]);\n\n\treturn (\n\t\t<KheopskitContext.Provider value={value}>\n\t\t\t{children}\n\t\t</KheopskitContext.Provider>\n\t);\n};\n","import type { KheopskitState } from \"@kheopskit/core\";\nimport { createContext } from \"react\";\n\nexport const KheopskitContext = createContext<{\n\tstate: KheopskitState;\n} | null>(null);\n","import type { Observable, Subscription } from \"rxjs\";\n\nexport const createStore = <T>(\n\tobservable$: Observable<T>,\n\tinitialValue: T,\n\tserverValue?: T,\n) => {\n\t// Use null as sentinel to indicate we haven't received first emission yet\n\tlet latestValue: T | null = null;\n\tlet subscription: Subscription | null = null;\n\tlet subscriberCount = 0;\n\tconst listeners = new Set<(value: T) => void>();\n\n\tconst ensureSubscription = () => {\n\t\tif (!subscription || subscription.closed) {\n\t\t\tsubscription = observable$.subscribe((value) => {\n\t\t\t\tlatestValue = value;\n\t\t\t\tfor (const listener of listeners) {\n\t\t\t\t\tlistener(value);\n\t\t\t\t}\n\t\t\t});\n\t\t}\n\t};\n\n\t// The subscription is created lazily by subscribe() (which React calls from a\n\t// committed passive effect), never during render. React may render a tree and\n\t// throw it away without committing — StrictMode double-invokes the initial\n\t// render, and concurrent/Suspense can discard renders — so subscribing eagerly\n\t// here (createStore runs inside the Provider's render-phase useMemo) would leak\n\t// the discarded store's observable subscription. Until the first emission,\n\t// getSnapshot falls back to initialValue.\n\tconst getSnapshot = () => latestValue ?? initialValue;\n\n\t/**\n\t * Returns the server-side snapshot for SSR hydration.\n\t * This prevents hydration mismatches by providing a consistent\n\t * value during server rendering. Must return the same value as\n\t * what the server rendered.\n\t */\n\tconst getServerSnapshot = () => serverValue ?? initialValue;\n\n\tconst subscribe = (callback: (value: T) => void) => {\n\t\tsubscriberCount++;\n\t\t// Subscribe to the observable BEFORE registering this listener, so a\n\t\t// synchronous replay (BehaviorSubject / shareReplay) updates latestValue\n\t\t// without double-invoking this callback — the current value is emitted once,\n\t\t// explicitly, just below.\n\t\tensureSubscription();\n\t\tlisteners.add(callback);\n\n\t\t// Immediately emit current value (BehaviorSubject semantics)\n\t\tcallback(getSnapshot());\n\n\t\treturn () => {\n\t\t\tsubscriberCount--;\n\t\t\tlisteners.delete(callback);\n\t\t\t// Don't close the observable subscription on unsubscribe\n\t\t\t// Let destroy() handle that when the store is truly being disposed\n\t\t};\n\t};\n\n\tconst destroy = () => {\n\t\t// Only unsubscribe if no one is listening\n\t\t// React StrictMode may call destroy and then immediately resubscribe\n\t\tif (subscriberCount === 0 && subscription) {\n\t\t\tsubscription.unsubscribe();\n\t\t\tsubscription = null;\n\t\t}\n\t};\n\n\treturn {\n\t\tgetSnapshot,\n\t\tgetServerSnapshot,\n\t\tsubscribe,\n\t\tdestroy,\n\t};\n};\n","import type { KheopskitPlatform, KheopskitState } from \"@kheopskit/core\";\nimport { useContext } from \"react\";\nimport { KheopskitContext } from \"./context\";\n\n/**\n * Returns the current kheopskit state (wallets, accounts, config, isHydrating).\n *\n * Pass the platform tuple as a type argument to recover SDK-precise account and\n * wallet types — `useWallets<typeof platforms>()`. React contexts can't be\n * generic, so without the argument the state is typed with the base\n * (SDK-free) wallet/account shapes.\n */\nexport const useWallets = <\n\tP extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[],\n>(): KheopskitState<P> => {\n\tconst ctx = useContext(KheopskitContext);\n\n\tif (!ctx)\n\t\tthrow new Error(\"useWallets can't be used without a KheopskitProvider\");\n\n\treturn ctx.state as unknown as KheopskitState<P>;\n};\n","import type { KheopskitConfig, KheopskitPlatform } from \"@kheopskit/core\";\nimport type { FC, PropsWithChildren } from \"react\";\nimport { KheopskitProvider } from \"./KheopskitProvider\";\nimport { useWallets } from \"./useWallets\";\n\nexport type CreateKheopskitConfig<P extends readonly KheopskitPlatform[]> =\n\tOmit<Partial<KheopskitConfig<P>>, \"platforms\"> & {\n\t\t/** Platform plugins, e.g. `[polkadot(), solana()]`. Required. */\n\t\tplatforms: P;\n\t};\n\n/**\n * Binds a platform tuple once and returns a `KheopskitProvider` plus hooks\n * (`useWallets`, `useAccounts`) already typed to those platforms — so you don't\n * repeat `useWallets<typeof platforms>()` in every component.\n *\n * @example\n * ```tsx\n * // kheopskit.ts\n * export const { KheopskitProvider, useWallets, useAccounts } = createKheopskit({\n *   platforms: [polkadot(), ethereum(), solana()],\n * });\n *\n * // anywhere\n * const { accounts } = useWallets(); // accounts are platform-precise, no generic\n * ```\n */\nexport const createKheopskit = <\n\tconst P extends readonly [KheopskitPlatform, ...KheopskitPlatform[]],\n>(\n\tconfig: CreateKheopskitConfig<P>,\n) => {\n\tconst Provider: FC<PropsWithChildren<{ ssrCookies?: string }>> = ({\n\t\tchildren,\n\t\tssrCookies,\n\t}) => (\n\t\t<KheopskitProvider config={config} ssrCookies={ssrCookies}>\n\t\t\t{children}\n\t\t</KheopskitProvider>\n\t);\n\tProvider.displayName = \"KheopskitProvider\";\n\n\treturn {\n\t\tKheopskitProvider: Provider,\n\t\t/** Current state, typed to the bound platform tuple. */\n\t\tuseWallets: () => useWallets<P>(),\n\t\t/** Current accounts, typed to the bound platform tuple. */\n\t\tuseAccounts: () => useWallets<P>().accounts,\n\t};\n};\n","import type { KheopskitPlatform } from \"@kheopskit/core\";\nimport { useWallets } from \"./useWallets\";\n\n/**\n * Convenience hook returning just the accounts from kheopskit state. Pass the\n * platform tuple as a type argument to recover SDK-precise account types —\n * `useAccounts<typeof platforms>()` — or use the pre-typed hook from\n * {@link createKheopskit}.\n */\nexport const useAccounts = <\n\tP extends readonly KheopskitPlatform[] = readonly KheopskitPlatform[],\n>() => useWallets<P>().accounts;\n"],"mappings":"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","names":["jsx"]}

package/package.json

@@ -1,20 +1,28 @@
 {
   "name": "@kheopskit/react",
-  "version": "3.0.1",
+  "version": "5.0.0",
   "description": "",
   "private": false,
+  "sideEffects": false,
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.mjs",
-      "require": "./dist/index.js"
-    }
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public"
@@ -27,7 +35,7 @@
   },
   "license": "ISC",
   "peerDependencies": {
-    "@kheopskit/core": "^1.0.1",
+    "@kheopskit/core": "^5.0.0",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
     "rxjs": ">=7.0.0"
@@ -38,7 +46,7 @@
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "rxjs": "^7.8.2",
-    "@kheopskit/core": "1.0.1"
+    "@kheopskit/core": "5.0.0"
   },
   "tsup": {
     "entry": [
@@ -53,10 +61,13 @@
       "esm",
       "cjs"
     ],
-    "target": "es2020"
+    "target": "es2020",
+    "banner": {
+      "js": "\"use client\";"
+    }
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
+    "test": "vitest run --root=../.. packages/react",
     "dev": "tsup --watch",
     "build": "tsup",
     "clean": "rm -rf ./dist && rm -rf ./node_modules",