@liberfi.io/wallet-connector 0.1.186 → 0.2.1

package/README.md

@@ -166,29 +166,37 @@ Returns the full `AuthContextValue`. Throws if used outside `AuthProvider`.
 function useAuth(): AuthContextValue;
 ```
 
-#### `useAuthCallback<T>(callback, deps?)`
+#### `useAuthCallback<A>(callback, deps?)`
 
-Wraps a callback so it only executes when the user is authenticated. If unauthenticated, it triggers `signIn()` and returns `undefined`. If currently authenticating, it silently returns `undefined` without re-triggering sign-in.
+Wraps a callback so it only executes when the user is authenticated. The contract is **fire-and-forget**: the input callback's return value is always discarded — to consume a callback's result, capture it inside the callback itself (e.g. `setState`, toast, analytics).
+
+Behavior by auth status:
+
+- `authenticated` — executes the callback. The callback's return value is discarded; rejections **do** propagate to the returned Promise so callers may `await` and `try/catch` to handle the callback's own failures.
+- `unauthenticated` — triggers `signIn()` fire-and-forget and resolves immediately. Errors from `signIn()` are silenced here — observe them via the auth provider's own error channel (e.g. `PrivyAuthProvider`'s `onError`).
+- `authenticating` / `deauthenticating` — no-op; resolves immediately without re-triggering sign-in.
 
 ```typescript
-type AuthGuardedCallback<T extends (...args: any[]) => any> = (
-  ...args: Parameters<T>
-) => Promise<Awaited<ReturnType<T>> | undefined>;
+type AuthGuardedCallback<A extends readonly unknown[]> = (
+  ...args: A
+) => Promise<void>;
 
-function useAuthCallback<T extends (...args: any[]) => any>(
-  callback: T,
+function useAuthCallback<A extends unknown[]>(
+  callback: (...args: A) => void | Promise<void>,
   deps?: DependencyList,
-): AuthGuardedCallback<T>;
+): AuthGuardedCallback<A>;
 ```
 
-The return type `AuthGuardedCallback<T>` makes it explicit that the wrapped function may resolve to `undefined` when the user is not authenticated.
+The input callback's return type is constrained to `void | Promise<void>` so the API surface is unambiguously fire-and-forget. A callback returning `Promise<value>` will be rejected at compile time, forcing the consumer to drop the value or refactor.
+
+#### `useSwitchEvmWalletsToChain()`
 
-#### `useSwitchChain()`
+Returns a function that switches **all connected EVM wallets** to a given chain. Non-EVM chains (e.g. Solana) are a no-op since Solana has no chain-switching concept within its namespace. Fail-fast on the first wallet's rejection (`Promise.all`); previously-switched wallets are NOT rolled back.
 
-Returns a function that switches all connected EVM wallets to a given chain. Solana chains are automatically skipped.
+> **Per-wallet usage**: do NOT use this hook to switch a single wallet. Call `wallet.switchChain(chain)` directly on the [`EvmWalletAdapter`](#evmwalletadapter). This hook is the "sync the whole wallet set to a UI-selected chain" primitive.
 
 ```typescript
-function useSwitchChain(): (chain: Chain) => Promise<void>;
+function useSwitchEvmWalletsToChain(): (chain: Chain) => Promise<void>;
 ```
 
 ### Constants
@@ -269,14 +277,14 @@ function TradeButton() {
 }
 ```
 
-### Switching Chains
+### Switching Chains (UI selector — sync all EVM wallets)
 
 ```tsx
 import { Chain } from "@liberfi.io/types";
-import { useSwitchChain } from "@liberfi.io/wallet-connector";
+import { useSwitchEvmWalletsToChain } from "@liberfi.io/wallet-connector";
 
 function ChainSwitcher() {
-  const switchChain = useSwitchChain();
+  const switchChain = useSwitchEvmWalletsToChain();
 
   return (
     <button onClick={() => switchChain(Chain.ETHEREUM)}>
@@ -286,6 +294,21 @@ function ChainSwitcher() {
 }
 ```
 
+For switching a **single** wallet (e.g. temporarily for a transaction), call `wallet.switchChain(chain)` directly:
+
+```tsx
+import { Chain } from "@liberfi.io/types";
+import {
+  useConnectedWallet,
+  type EvmWalletAdapter,
+} from "@liberfi.io/wallet-connector";
+
+async function trade(evmWallet: EvmWalletAdapter) {
+  await evmWallet.switchChain(Chain.POLYGON);
+  // ... do the trade ...
+}
+```
+
 ### Building a Custom Implementation
 
 To create a new wallet connector implementation, implement `WalletAdapter` (and optionally `EvmWalletAdapter`) and wrap the providers:

package/dist/index.d.mts

@@ -105,24 +105,40 @@ declare function useAuth(): AuthContextValue;
 /**
  * The return type of {@link useAuthCallback}.
  *
- * Accepts the same parameters as `T` but always returns a `Promise` that
- * resolves to `Awaited<ReturnType<T>>` when authenticated, or `undefined`
- * when the user is not yet authenticated.
+ * Always resolves to `void` — the wrapper is fire-and-forget by design.
+ * Any value returned by the input callback is discarded. To consume a
+ * callback's result, capture it inside the callback itself (e.g. setState,
+ * toast). For sign-in errors, observe via the auth provider's own channel
+ * (e.g. `PrivyAuthProvider`'s `onError`).
+ *
+ * Rejections from the input callback DO propagate to the returned Promise,
+ * so callers may `await` and `try/catch` to handle the callback's own
+ * failures. Rejections from `signIn()` are silenced — they are observable
+ * elsewhere.
  */
-type AuthGuardedCallback<T extends (...args: any[]) => any> = (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>> | undefined>;
+type AuthGuardedCallback<A extends readonly unknown[]> = (...args: A) => Promise<void>;
 /**
  * Wraps a callback so it only executes when the user is authenticated.
  *
- * - **authenticated**: executes the callback and returns its result.
- * - **unauthenticated**: triggers `signIn()` and returns `undefined`.
- * - **authenticating**: returns `undefined` without re-triggering sign-in
- *   (avoids conflicting with an in-progress auth flow).
+ * Behavior by auth status:
+ * - `authenticated`: executes the callback; the callback's return value is
+ *   discarded, but any rejection propagates to the returned Promise.
+ * - `unauthenticated`: triggers `signIn()` fire-and-forget and resolves
+ *   immediately. Errors from `signIn()` are silenced here — observe them
+ *   via the auth provider's own error channel.
+ * - `authenticating` / `deauthenticating`: no-op; resolves immediately
+ *   without re-triggering sign-in.
+ *
+ * The input callback's return type is constrained to `void | Promise<void>`
+ * so the API surface is unambiguously fire-and-forget. To consume a
+ * callback's result, capture it inside the callback itself rather than
+ * via the wrapper's return value.
  *
  * @param callback - The function to guard behind authentication.
  * @param deps - Optional dependency list (same semantics as `useCallback`).
- * @returns A wrapped callback that may resolve to `undefined` when not authenticated.
+ * @returns A wrapped callback returning `Promise<void>`.
  */
-declare function useAuthCallback<T extends (...args: any[]) => any>(callback: T, deps?: DependencyList): AuthGuardedCallback<T>;
+declare function useAuthCallback<A extends unknown[]>(callback: (...args: A) => void | Promise<void>, deps?: DependencyList): AuthGuardedCallback<A>;
 
 /**
  * Returns the first connected wallet matching the given chain's namespace,
@@ -137,15 +153,25 @@ declare function useAuthCallback<T extends (...args: any[]) => any>(callback: T,
 declare function useConnectedWallet(chain: Chain): WalletAdapter | undefined;
 
 /**
- * Returns a function that switches all connected EVM wallets to the given chain.
+ * Returns a function that switches **all connected EVM wallets** to the given chain.
+ *
+ * Semantics:
+ *
+ * - If `chain` is in the EVM namespace, every connected wallet whose
+ *   `chainNamespace === ChainNamespace.EVM` is switched concurrently.
+ * - If `chain` is NOT in the EVM namespace (e.g. Solana), the call is a no-op
+ *   (Solana has no chain-switching concept within its namespace).
+ * - Fail-fast on first wallet rejection (`Promise.all`); previously-switched
+ *   wallets are NOT rolled back. Subscribe to per-wallet status separately
+ *   if rollback is needed.
  *
- * Solana chains are automatically skipped (no-op). For EVM chains, the returned
- * function calls `switchChain` on every connected wallet that implements
- * {@link EvmWalletAdapter} in parallel.
+ * **Do NOT use this hook to switch a single wallet** — call
+ * `wallet.switchChain(chain)` directly on the {@link EvmWalletAdapter}. This
+ * hook is the "sync the whole wallet set to a UI-selected chain" primitive.
  *
  * @returns An async function `(chain: Chain) => Promise<void>`.
  */
-declare function useSwitchChain(): (chain: Chain) => Promise<void>;
+declare function useSwitchEvmWalletsToChain(): (chain: Chain) => Promise<void>;
 
 interface WalletConnectorContextValue {
     /**
@@ -204,4 +230,4 @@ type WalletConnectorProviderProps = PropsWithChildren<WalletConnectorContextValu
  */
 declare function WalletConnectorProvider({ children, ...value }: WalletConnectorProviderProps): react_jsx_runtime.JSX.Element;
 
-export { type AuthGuardedCallback, AuthProvider, type AuthProviderProps, type AuthStatus, type AuthenticatedUser, type Eip1193Provider, type EvmWalletAdapter, type WalletAdapter, WalletConnectorProvider, type WalletConnectorProviderProps, useAuth, useAuthCallback, useConnectedWallet, useSwitchChain, useWalletConnector, useWallets };
+export { type AuthGuardedCallback, AuthProvider, type AuthProviderProps, type AuthStatus, type AuthenticatedUser, type Eip1193Provider, type EvmWalletAdapter, type WalletAdapter, WalletConnectorProvider, type WalletConnectorProviderProps, useAuth, useAuthCallback, useConnectedWallet, useSwitchEvmWalletsToChain, useWalletConnector, useWallets };

package/dist/index.d.ts

@@ -105,24 +105,40 @@ declare function useAuth(): AuthContextValue;
 /**
  * The return type of {@link useAuthCallback}.
  *
- * Accepts the same parameters as `T` but always returns a `Promise` that
- * resolves to `Awaited<ReturnType<T>>` when authenticated, or `undefined`
- * when the user is not yet authenticated.
+ * Always resolves to `void` — the wrapper is fire-and-forget by design.
+ * Any value returned by the input callback is discarded. To consume a
+ * callback's result, capture it inside the callback itself (e.g. setState,
+ * toast). For sign-in errors, observe via the auth provider's own channel
+ * (e.g. `PrivyAuthProvider`'s `onError`).
+ *
+ * Rejections from the input callback DO propagate to the returned Promise,
+ * so callers may `await` and `try/catch` to handle the callback's own
+ * failures. Rejections from `signIn()` are silenced — they are observable
+ * elsewhere.
  */
-type AuthGuardedCallback<T extends (...args: any[]) => any> = (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>> | undefined>;
+type AuthGuardedCallback<A extends readonly unknown[]> = (...args: A) => Promise<void>;
 /**
  * Wraps a callback so it only executes when the user is authenticated.
  *
- * - **authenticated**: executes the callback and returns its result.
- * - **unauthenticated**: triggers `signIn()` and returns `undefined`.
- * - **authenticating**: returns `undefined` without re-triggering sign-in
- *   (avoids conflicting with an in-progress auth flow).
+ * Behavior by auth status:
+ * - `authenticated`: executes the callback; the callback's return value is
+ *   discarded, but any rejection propagates to the returned Promise.
+ * - `unauthenticated`: triggers `signIn()` fire-and-forget and resolves
+ *   immediately. Errors from `signIn()` are silenced here — observe them
+ *   via the auth provider's own error channel.
+ * - `authenticating` / `deauthenticating`: no-op; resolves immediately
+ *   without re-triggering sign-in.
+ *
+ * The input callback's return type is constrained to `void | Promise<void>`
+ * so the API surface is unambiguously fire-and-forget. To consume a
+ * callback's result, capture it inside the callback itself rather than
+ * via the wrapper's return value.
  *
  * @param callback - The function to guard behind authentication.
  * @param deps - Optional dependency list (same semantics as `useCallback`).
- * @returns A wrapped callback that may resolve to `undefined` when not authenticated.
+ * @returns A wrapped callback returning `Promise<void>`.
  */
-declare function useAuthCallback<T extends (...args: any[]) => any>(callback: T, deps?: DependencyList): AuthGuardedCallback<T>;
+declare function useAuthCallback<A extends unknown[]>(callback: (...args: A) => void | Promise<void>, deps?: DependencyList): AuthGuardedCallback<A>;
 
 /**
  * Returns the first connected wallet matching the given chain's namespace,
@@ -137,15 +153,25 @@ declare function useAuthCallback<T extends (...args: any[]) => any>(callback: T,
 declare function useConnectedWallet(chain: Chain): WalletAdapter | undefined;
 
 /**
- * Returns a function that switches all connected EVM wallets to the given chain.
+ * Returns a function that switches **all connected EVM wallets** to the given chain.
+ *
+ * Semantics:
+ *
+ * - If `chain` is in the EVM namespace, every connected wallet whose
+ *   `chainNamespace === ChainNamespace.EVM` is switched concurrently.
+ * - If `chain` is NOT in the EVM namespace (e.g. Solana), the call is a no-op
+ *   (Solana has no chain-switching concept within its namespace).
+ * - Fail-fast on first wallet rejection (`Promise.all`); previously-switched
+ *   wallets are NOT rolled back. Subscribe to per-wallet status separately
+ *   if rollback is needed.
  *
- * Solana chains are automatically skipped (no-op). For EVM chains, the returned
- * function calls `switchChain` on every connected wallet that implements
- * {@link EvmWalletAdapter} in parallel.
+ * **Do NOT use this hook to switch a single wallet** — call
+ * `wallet.switchChain(chain)` directly on the {@link EvmWalletAdapter}. This
+ * hook is the "sync the whole wallet set to a UI-selected chain" primitive.
  *
  * @returns An async function `(chain: Chain) => Promise<void>`.
  */
-declare function useSwitchChain(): (chain: Chain) => Promise<void>;
+declare function useSwitchEvmWalletsToChain(): (chain: Chain) => Promise<void>;
 
 interface WalletConnectorContextValue {
     /**
@@ -204,4 +230,4 @@ type WalletConnectorProviderProps = PropsWithChildren<WalletConnectorContextValu
  */
 declare function WalletConnectorProvider({ children, ...value }: WalletConnectorProviderProps): react_jsx_runtime.JSX.Element;
 
-export { type AuthGuardedCallback, AuthProvider, type AuthProviderProps, type AuthStatus, type AuthenticatedUser, type Eip1193Provider, type EvmWalletAdapter, type WalletAdapter, WalletConnectorProvider, type WalletConnectorProviderProps, useAuth, useAuthCallback, useConnectedWallet, useSwitchChain, useWalletConnector, useWallets };
+export { type AuthGuardedCallback, AuthProvider, type AuthProviderProps, type AuthStatus, type AuthenticatedUser, type Eip1193Provider, type EvmWalletAdapter, type WalletAdapter, WalletConnectorProvider, type WalletConnectorProviderProps, useAuth, useAuthCallback, useConnectedWallet, useSwitchEvmWalletsToChain, useWalletConnector, useWallets };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var react=require('react'),utils=require('@liberfi.io/utils'),types=require('@liberfi.io/types'),jsxRuntime=require('react/jsx-runtime');var n=react.createContext({});function u(){let t=react.useContext(n);if(!t)throw new Error("useAuth must be used within a AuthProvider");return t}function R(t,e){let{status:r,signIn:o}=u(),s=react.useRef(r);return s.current=r,react.useCallback(async(...p)=>{if(s.current!=="authenticated"){s.current==="unauthenticated"&&o();return}return t(...p)},[...e||[],o,t])}var i=react.createContext({});function l(){let t=react.useContext(i);if(!t)throw new Error("useWalletConnector must be used within a WalletConnectorProvider");return t}function a(){let{wallets:t}=l();return t}function H(t){let e=a(),r=utils.chainToNamespace(t);return react.useMemo(()=>e.find(o=>o.chainNamespace===r&&o.isConnected),[e,r])}function _(){let t=a();return react.useCallback(async e=>{if(utils.chainToNamespace(e)===types.ChainNamespace.SOLANA)return;let r=t.filter(o=>"switchChain"in o&&o.isConnected);await Promise.all(r.map(o=>o.switchChain(e)));},[t])}function st({children:t,...e}){return jsxRuntime.jsx(n.Provider,{value:e,children:t})}function mt({children:t,...e}){return jsxRuntime.jsx(i.Provider,{value:e,children:t})}exports.AuthProvider=st;exports.WalletConnectorProvider=mt;exports.useAuth=u;exports.useAuthCallback=R;exports.useConnectedWallet=H;exports.useSwitchChain=_;exports.useWalletConnector=l;exports.useWallets=a;//# sourceMappingURL=index.js.map
+'use strict';var react=require('react'),utils=require('@liberfi.io/utils'),types=require('@liberfi.io/types'),jsxRuntime=require('react/jsx-runtime');var n=react.createContext(null);function u(){let t=react.useContext(n);if(t===null)throw new Error("useAuth must be used within an AuthProvider");return t}function M(t,e){let{status:r,signIn:o}=u(),l=react.useRef(r);return l.current=r,react.useCallback(async(...c)=>{if(l.current!=="authenticated"){l.current==="unauthenticated"&&Promise.resolve().then(()=>o()).catch(()=>{});return}await t(...c);},[...e||[],o,t])}var i=react.createContext(null);function s(){let t=react.useContext(i);if(t===null)throw new Error("useWalletConnector must be used within a WalletConnectorProvider");return t}function a(){let{wallets:t}=s();return t}function H(t){let e=a(),r=utils.chainToNamespace(t);return react.useMemo(()=>e.find(o=>o.chainNamespace===r&&o.isConnected),[e,r])}function _(){let t=a();return react.useCallback(async e=>{if(utils.chainToNamespace(e)!==types.ChainNamespace.EVM)return;let r=t.filter(o=>o.chainNamespace===types.ChainNamespace.EVM&&o.isConnected);await Promise.all(r.map(o=>o.switchChain(e)));},[t])}function lt({children:t,...e}){return jsxRuntime.jsx(n.Provider,{value:e,children:t})}function mt({children:t,...e}){return jsxRuntime.jsx(i.Provider,{value:e,children:t})}exports.AuthProvider=lt;exports.WalletConnectorProvider=mt;exports.useAuth=u;exports.useAuthCallback=M;exports.useConnectedWallet=H;exports.useSwitchEvmWalletsToChain=_;exports.useWalletConnector=s;exports.useWallets=a;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/providers/AuthContext.ts","../src/hooks/useAuth.ts","../src/hooks/useAuthCallback.ts","../src/providers/WalletConnectorContext.ts","../src/hooks/useWalletConnector.ts","../src/hooks/useWallets.ts","../src/hooks/useConnectedWallet.ts","../src/hooks/useSwitchChain.ts","../src/providers/AuthProvider.tsx","../src/providers/WalletConnectorProvider.tsx"],"names":["AuthContext","createContext","useAuth","context","useContext","useAuthCallback","callback","deps","status","signIn","statusRef","useRef","useCallback","args","WalletConnectorContext","useWalletConnector","useWallets","wallets","useConnectedWallet","chain","ns","chainToNamespace","useMemo","w","useSwitchChain","ChainNamespace","evmWallets","AuthProvider","children","value","jsx","WalletConnectorProvider"],"mappings":"sJAsBO,IAAMA,CAAAA,CAAcC,mBAAAA,CACzB,EACF,ECbO,SAASC,CAAAA,EAAU,CACxB,IAAMC,CAAAA,CAAUC,gBAAAA,CAAWJ,CAAW,CAAA,CACtC,GAAI,CAACG,CAAAA,CACH,MAAM,IAAI,KAAA,CAAM,4CAA4C,CAAA,CAE9D,OAAOA,CACT,CCUO,SAASE,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACwB,CACxB,GAAM,CAAE,MAAA,CAAAC,CAAAA,CAAQ,OAAAC,CAAO,CAAA,CAAIP,CAAAA,EAAQ,CAE7BQ,CAAAA,CAAYC,YAAAA,CAAeH,CAAM,CAAA,CACvC,OAAAE,CAAAA,CAAU,OAAA,CAAUF,CAAAA,CAEbI,iBAAAA,CACL,MAAA,GACKC,CAAAA,GAC6C,CAChD,GAAIH,EAAU,OAAA,GAAY,eAAA,CAAiB,CACrCA,CAAAA,CAAU,OAAA,GAAY,iBAAA,EACxBD,CAAAA,EAAO,CAET,MACF,CACA,OAAOH,CAAAA,CAAS,GAAGO,CAAI,CACzB,CAAA,CACA,CAAC,GAAIN,CAAAA,EAAQ,EAAC,CAAIE,CAAAA,CAAQH,CAAQ,CACpC,CACF,CCzBO,IAAMQ,EACXb,mBAAAA,CAA2C,EAAiC,CAAA,CCfvE,SAASc,CAAAA,EAAqB,CACnC,IAAMZ,EAAUC,gBAAAA,CAAWU,CAAsB,CAAA,CACjD,GAAI,CAACX,CAAAA,CACH,MAAM,IAAI,MACR,kEACF,CAAA,CAEF,OAAOA,CACT,CCVO,SAASa,CAAAA,EAAa,CAC3B,GAAM,CAAE,OAAA,CAAAC,CAAQ,CAAA,CAAIF,CAAAA,EAAmB,CACvC,OAAOE,CACT,CCIO,SAASC,CAAAA,CAAmBC,CAAAA,CAAyC,CAC1E,IAAMF,CAAAA,CAAUD,CAAAA,GACVI,CAAAA,CAAKC,sBAAAA,CAAiBF,CAAK,CAAA,CACjC,OAAOG,aAAAA,CACL,IAAML,CAAAA,CAAQ,KAAMM,CAAAA,EAAMA,CAAAA,CAAE,cAAA,GAAmBH,CAAAA,EAAMG,CAAAA,CAAE,WAAW,CAAA,CAClE,CAACN,EAASG,CAAE,CACd,CACF,CCRO,SAASI,GAAiB,CAC/B,IAAMP,CAAAA,CAAUD,CAAAA,EAAW,CAE3B,OAAOJ,iBAAAA,CACL,MAAOO,GAAiB,CACtB,GAAIE,sBAAAA,CAAiBF,CAAK,CAAA,GAAMM,oBAAAA,CAAe,MAAA,CAAQ,OAEvD,IAAMC,CAAAA,CAAaT,CAAAA,CAAQ,MAAA,CACxBM,CAAAA,EAA6B,aAAA,GAAiBA,CAAAA,EAAKA,CAAAA,CAAE,WACxD,CAAA,CACA,MAAM,OAAA,CAAQ,GAAA,CAAIG,CAAAA,CAAW,GAAA,CAAKH,CAAAA,EAAMA,CAAAA,CAAE,YAAYJ,CAAK,CAAC,CAAC,EAC/D,CAAA,CACA,CAACF,CAAO,CACV,CACF,CCTO,SAASU,EAAAA,CAAa,CAAE,QAAA,CAAAC,EAAU,GAAGC,CAAM,CAAA,CAAsB,CACtE,OAAOC,cAAAA,CAAC9B,CAAAA,CAAY,QAAA,CAAZ,CAAqB,KAAA,CAAO6B,CAAAA,CAAQ,QAAA,CAAAD,CAAAA,CAAS,CACvD,CCJO,SAASG,EAAAA,CAAwB,CACtC,QAAA,CAAAH,CAAAA,CACA,GAAGC,CACL,CAAA,CAAiC,CAC/B,OACEC,cAAAA,CAAChB,CAAAA,CAAuB,QAAA,CAAvB,CAAgC,KAAA,CAAOe,CAAAA,CACrC,QAAA,CAAAD,EACH,CAEJ","file":"index.js","sourcesContent":["import { createContext } from \"react\";\nimport { AuthenticatedUser } from \"../types\";\n\nexport type AuthStatus =\n  | \"unauthenticated\"\n  | \"authenticating\"\n  | \"authenticated\"\n  | \"deauthenticating\";\n\nexport interface AuthContextValue {\n  /** authenticated user profile */\n  user: AuthenticatedUser | null;\n  /** authentication status */\n  status: AuthStatus;\n  /** sign in to the IdP */\n  signIn: () => void | Promise<void>;\n  /** sign out from the IdP */\n  signOut: () => void | Promise<void>;\n  /** refresh the access token */\n  refreshAccessToken: () => void | Promise<void>;\n}\n\nexport const AuthContext = createContext<AuthContextValue>(\n  {} as AuthContextValue,\n);\n","import { useContext } from \"react\";\nimport { AuthContext } from \"../providers/AuthContext\";\n\n/**\n * Returns the auth context value.\n *\n * Must be used within an {@link AuthProvider}.\n * Throws if no provider is found in the component tree.\n *\n * @returns The current {@link AuthContextValue} (user, status, signIn, signOut, refreshAccessToken).\n */\nexport function useAuth() {\n  const context = useContext(AuthContext);\n  if (!context) {\n    throw new Error(\"useAuth must be used within a AuthProvider\");\n  }\n  return context;\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { DependencyList, useCallback, useRef } from \"react\";\nimport { useAuth } from \"./useAuth\";\n\n/**\n * The return type of {@link useAuthCallback}.\n *\n * Accepts the same parameters as `T` but always returns a `Promise` that\n * resolves to `Awaited<ReturnType<T>>` when authenticated, or `undefined`\n * when the user is not yet authenticated.\n */\nexport type AuthGuardedCallback<T extends (...args: any[]) => any> = (\n  ...args: Parameters<T>\n) => Promise<Awaited<ReturnType<T>> | undefined>;\n\n/**\n * Wraps a callback so it only executes when the user is authenticated.\n *\n * - **authenticated**: executes the callback and returns its result.\n * - **unauthenticated**: triggers `signIn()` and returns `undefined`.\n * - **authenticating**: returns `undefined` without re-triggering sign-in\n *   (avoids conflicting with an in-progress auth flow).\n *\n * @param callback - The function to guard behind authentication.\n * @param deps - Optional dependency list (same semantics as `useCallback`).\n * @returns A wrapped callback that may resolve to `undefined` when not authenticated.\n */\nexport function useAuthCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  deps?: DependencyList,\n): AuthGuardedCallback<T> {\n  const { status, signIn } = useAuth();\n\n  const statusRef = useRef<string>(status);\n  statusRef.current = status;\n\n  return useCallback(\n    async (\n      ...args: Parameters<T>\n    ): Promise<Awaited<ReturnType<T>> | undefined> => {\n      if (statusRef.current !== \"authenticated\") {\n        if (statusRef.current === \"unauthenticated\") {\n          signIn();\n        }\n        return;\n      }\n      return callback(...args);\n    },\n    [...(deps || []), signIn, callback],\n  );\n}\n","import { createContext } from \"react\";\nimport { WalletAdapter } from \"../types\";\n\nexport interface WalletConnectorContextValue {\n  /**\n   * detecting: is detecting connected wallets\n   * connecting: is connecting to the first wallet\n   * connected: is connected to at least one wallet\n   * disconnecting: is disconnecting from the last connected wallet\n   * disconnected: is disconnected from all wallets\n   */\n  status:\n    | \"detecting\"\n    | \"connecting\"\n    | \"connected\"\n    | \"disconnecting\"\n    | \"disconnected\";\n  // all wallets that can be used to take onchain actions when connected\n  wallets: Array<WalletAdapter>;\n  // if no wallets are connected, connect one or multiple wallets\n  connect: () => Promise<void>;\n  // disconnect all wallets\n  disconnect: () => Promise<void>;\n}\n\nexport const WalletConnectorContext =\n  createContext<WalletConnectorContextValue>({} as WalletConnectorContextValue);\n","import { useContext } from \"react\";\nimport { WalletConnectorContext } from \"../providers/WalletConnectorContext\";\n\n/**\n * Returns the wallet connector context value.\n *\n * Must be used within a {@link WalletConnectorProvider}.\n * Throws if no provider is found in the component tree.\n *\n * @returns The current {@link WalletConnectorContextValue} (status, wallets, connect, disconnect).\n */\nexport function useWalletConnector() {\n  const context = useContext(WalletConnectorContext);\n  if (!context) {\n    throw new Error(\n      \"useWalletConnector must be used within a WalletConnectorProvider\",\n    );\n  }\n  return context;\n}\n","import { useWalletConnector } from \"./useWalletConnector\";\n\n/**\n * Convenience hook that returns the `wallets` array from the wallet connector context.\n *\n * Shorthand for `useWalletConnector().wallets`.\n *\n * @returns All wallets that can be used to take on-chain actions when connected.\n */\nexport function useWallets() {\n  const { wallets } = useWalletConnector();\n  return wallets;\n}\n","import { useMemo } from \"react\";\nimport type { Chain } from \"@liberfi.io/types\";\nimport { chainToNamespace } from \"@liberfi.io/utils\";\nimport type { WalletAdapter } from \"../types/WalletAdapter\";\nimport { useWallets } from \"./useWallets\";\n\n/**\n * Returns the first connected wallet matching the given chain's namespace,\n * or `undefined` if none is connected.\n *\n * Shorthand for the common pattern:\n * ```ts\n * const wallets = useWallets();\n * const wallet = wallets.find(w => w.chainNamespace === ns && w.isConnected);\n * ```\n */\nexport function useConnectedWallet(chain: Chain): WalletAdapter | undefined {\n  const wallets = useWallets();\n  const ns = chainToNamespace(chain);\n  return useMemo(\n    () => wallets.find((w) => w.chainNamespace === ns && w.isConnected),\n    [wallets, ns],\n  );\n}\n","import { useCallback } from \"react\";\nimport { Chain, ChainNamespace } from \"@liberfi.io/types\";\nimport { chainToNamespace } from \"@liberfi.io/utils\";\nimport { EvmWalletAdapter } from \"../types\";\nimport { useWallets } from \"./useWallets\";\n\n/**\n * Returns a function that switches all connected EVM wallets to the given chain.\n *\n * Solana chains are automatically skipped (no-op). For EVM chains, the returned\n * function calls `switchChain` on every connected wallet that implements\n * {@link EvmWalletAdapter} in parallel.\n *\n * @returns An async function `(chain: Chain) => Promise<void>`.\n */\nexport function useSwitchChain() {\n  const wallets = useWallets();\n\n  return useCallback(\n    async (chain: Chain) => {\n      if (chainToNamespace(chain) === ChainNamespace.SOLANA) return;\n\n      const evmWallets = wallets.filter(\n        (w): w is EvmWalletAdapter => \"switchChain\" in w && w.isConnected,\n      );\n      await Promise.all(evmWallets.map((w) => w.switchChain(chain)));\n    },\n    [wallets],\n  );\n}\n","import { PropsWithChildren } from \"react\";\nimport {\n  AuthContext,\n  type AuthContextValue,\n  type AuthStatus,\n} from \"./AuthContext\";\n\nexport type { AuthStatus };\n\n/** Props for {@link AuthProvider}. */\nexport type AuthProviderProps = PropsWithChildren<AuthContextValue>;\n\n/**\n * Provides authentication state to the component tree.\n *\n * This is a passthrough provider — it accepts the full context value as props\n * and forwards it to React context. Implementation providers (e.g.\n * `PrivyAuthProvider`) typically wrap this component and supply the concrete\n * `user`, `status`, `signIn`, `signOut`, and `refreshAccessToken` values.\n */\nexport function AuthProvider({ children, ...value }: AuthProviderProps) {\n  return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;\n}\n","import { PropsWithChildren } from \"react\";\nimport {\n  WalletConnectorContext,\n  WalletConnectorContextValue,\n} from \"./WalletConnectorContext\";\n\n/** Props for {@link WalletConnectorProvider}. */\nexport type WalletConnectorProviderProps =\n  PropsWithChildren<WalletConnectorContextValue>;\n\n/**\n * Provides wallet connection state to the component tree.\n *\n * This is a passthrough provider — it accepts the full context value as props\n * and forwards it to React context. Implementation providers (e.g.\n * `PrivyWalletConnectorProvider`) typically wrap this component and supply\n * the concrete `status`, `wallets`, `connect`, and `disconnect` values.\n */\nexport function WalletConnectorProvider({\n  children,\n  ...value\n}: WalletConnectorProviderProps) {\n  return (\n    <WalletConnectorContext.Provider value={value}>\n      {children}\n    </WalletConnectorContext.Provider>\n  );\n}\n"]}
+{"version":3,"sources":["../src/providers/AuthContext.ts","../src/hooks/useAuth.ts","../src/hooks/useAuthCallback.ts","../src/providers/WalletConnectorContext.ts","../src/hooks/useWalletConnector.ts","../src/hooks/useWallets.ts","../src/hooks/useConnectedWallet.ts","../src/hooks/useSwitchEvmWalletsToChain.ts","../src/providers/AuthProvider.tsx","../src/providers/WalletConnectorProvider.tsx"],"names":["AuthContext","createContext","useAuth","context","useContext","useAuthCallback","callback","deps","status","signIn","statusRef","useRef","useCallback","args","WalletConnectorContext","useWalletConnector","useWallets","wallets","useConnectedWallet","chain","ns","chainToNamespace","useMemo","w","useSwitchEvmWalletsToChain","ChainNamespace","evmWallets","AuthProvider","children","value","jsx","WalletConnectorProvider"],"mappings":"sJAsBO,IAAMA,CAAAA,CAAcC,mBAAAA,CAAuC,IAAI,CAAA,CCX/D,SAASC,GAAU,CACxB,IAAMC,CAAAA,CAAUC,gBAAAA,CAAWJ,CAAW,CAAA,CACtC,GAAIG,CAAAA,GAAY,KACd,MAAM,IAAI,KAAA,CAAM,6CAA6C,CAAA,CAE/D,OAAOA,CACT,CCyBO,SAASE,CAAAA,CACdC,CAAAA,CACAC,EACwB,CACxB,GAAM,CAAE,MAAA,CAAAC,CAAAA,CAAQ,MAAA,CAAAC,CAAO,CAAA,CAAIP,GAAQ,CAE7BQ,CAAAA,CAAYC,YAAAA,CAAeH,CAAM,CAAA,CACvC,OAAAE,CAAAA,CAAU,OAAA,CAAUF,EAEbI,iBAAAA,CACL,MAAA,GAAUC,CAAAA,GAA2B,CACnC,GAAIH,CAAAA,CAAU,OAAA,GAAY,eAAA,CAAiB,CACrCA,EAAU,OAAA,GAAY,iBAAA,EAIxB,OAAA,CAAQ,OAAA,EAAQ,CACb,IAAA,CAAK,IAAMD,CAAAA,EAAQ,CAAA,CACnB,KAAA,CAAM,IAAM,CAGb,CAAC,CAAA,CAEL,MACF,CACA,MAAMH,CAAAA,CAAS,GAAGO,CAAI,EACxB,CAAA,CACA,CAAC,GAAIN,CAAAA,EAAQ,EAAC,CAAIE,CAAAA,CAAQH,CAAQ,CACpC,CACF,CC9CO,IAAMQ,CAAAA,CACXb,mBAAAA,CAAkD,IAAI,CAAA,CCfjD,SAASc,CAAAA,EAAqB,CACnC,IAAMZ,CAAAA,CAAUC,gBAAAA,CAAWU,CAAsB,CAAA,CACjD,GAAIX,IAAY,IAAA,CACd,MAAM,IAAI,KAAA,CACR,kEACF,CAAA,CAEF,OAAOA,CACT,CCVO,SAASa,CAAAA,EAAa,CAC3B,GAAM,CAAE,OAAA,CAAAC,CAAQ,CAAA,CAAIF,CAAAA,GACpB,OAAOE,CACT,CCIO,SAASC,CAAAA,CAAmBC,CAAAA,CAAyC,CAC1E,IAAMF,EAAUD,CAAAA,EAAW,CACrBI,CAAAA,CAAKC,sBAAAA,CAAiBF,CAAK,CAAA,CACjC,OAAOG,aAAAA,CACL,IAAML,CAAAA,CAAQ,IAAA,CAAMM,CAAAA,EAAMA,CAAAA,CAAE,cAAA,GAAmBH,CAAAA,EAAMG,CAAAA,CAAE,WAAW,EAClE,CAACN,CAAAA,CAASG,CAAE,CACd,CACF,CCEO,SAASI,CAAAA,EAA6B,CAC3C,IAAMP,CAAAA,CAAUD,CAAAA,EAAW,CAE3B,OAAOJ,kBACL,MAAOO,CAAAA,EAAiB,CACtB,GAAIE,uBAAiBF,CAAK,CAAA,GAAMM,oBAAAA,CAAe,GAAA,CAAK,OAEpD,IAAMC,CAAAA,CAAaT,CAAAA,CAAQ,MAAA,CACxBM,CAAAA,EACCA,CAAAA,CAAE,cAAA,GAAmBE,oBAAAA,CAAe,KAAOF,CAAAA,CAAE,WACjD,CAAA,CACA,MAAM,OAAA,CAAQ,GAAA,CAAIG,CAAAA,CAAW,GAAA,CAAKH,GAAMA,CAAAA,CAAE,WAAA,CAAYJ,CAAK,CAAC,CAAC,EAC/D,CAAA,CACA,CAACF,CAAO,CACV,CACF,CCpBO,SAASU,EAAAA,CAAa,CAAE,SAAAC,CAAAA,CAAU,GAAGC,CAAM,CAAA,CAAsB,CACtE,OAAOC,cAAAA,CAAC9B,CAAAA,CAAY,SAAZ,CAAqB,KAAA,CAAO6B,CAAAA,CAAQ,QAAA,CAAAD,CAAAA,CAAS,CACvD,CCJO,SAASG,EAAAA,CAAwB,CACtC,QAAA,CAAAH,CAAAA,CACA,GAAGC,CACL,EAAiC,CAC/B,OACEC,cAAAA,CAAChB,CAAAA,CAAuB,SAAvB,CAAgC,KAAA,CAAOe,CAAAA,CACrC,QAAA,CAAAD,EACH,CAEJ","file":"index.js","sourcesContent":["import { createContext } from \"react\";\nimport { AuthenticatedUser } from \"../types\";\n\nexport type AuthStatus =\n  | \"unauthenticated\"\n  | \"authenticating\"\n  | \"authenticated\"\n  | \"deauthenticating\";\n\nexport interface AuthContextValue {\n  /** authenticated user profile */\n  user: AuthenticatedUser | null;\n  /** authentication status */\n  status: AuthStatus;\n  /** sign in to the IdP */\n  signIn: () => void | Promise<void>;\n  /** sign out from the IdP */\n  signOut: () => void | Promise<void>;\n  /** refresh the access token */\n  refreshAccessToken: () => void | Promise<void>;\n}\n\nexport const AuthContext = createContext<AuthContextValue | null>(null);\n","import { useContext } from \"react\";\nimport { AuthContext } from \"../providers/AuthContext\";\n\n/**\n * Returns the auth context value.\n *\n * Must be used within an {@link AuthProvider}.\n * Throws if no provider is found in the component tree.\n *\n * @returns The current {@link AuthContextValue} (user, status, signIn, signOut, refreshAccessToken).\n */\nexport function useAuth() {\n  const context = useContext(AuthContext);\n  if (context === null) {\n    throw new Error(\"useAuth must be used within an AuthProvider\");\n  }\n  return context;\n}\n","import { DependencyList, useCallback, useRef } from \"react\";\nimport { useAuth } from \"./useAuth\";\n\n/**\n * The return type of {@link useAuthCallback}.\n *\n * Always resolves to `void` — the wrapper is fire-and-forget by design.\n * Any value returned by the input callback is discarded. To consume a\n * callback's result, capture it inside the callback itself (e.g. setState,\n * toast). For sign-in errors, observe via the auth provider's own channel\n * (e.g. `PrivyAuthProvider`'s `onError`).\n *\n * Rejections from the input callback DO propagate to the returned Promise,\n * so callers may `await` and `try/catch` to handle the callback's own\n * failures. Rejections from `signIn()` are silenced — they are observable\n * elsewhere.\n */\nexport type AuthGuardedCallback<A extends readonly unknown[]> = (\n  ...args: A\n) => Promise<void>;\n\n/**\n * Wraps a callback so it only executes when the user is authenticated.\n *\n * Behavior by auth status:\n * - `authenticated`: executes the callback; the callback's return value is\n *   discarded, but any rejection propagates to the returned Promise.\n * - `unauthenticated`: triggers `signIn()` fire-and-forget and resolves\n *   immediately. Errors from `signIn()` are silenced here — observe them\n *   via the auth provider's own error channel.\n * - `authenticating` / `deauthenticating`: no-op; resolves immediately\n *   without re-triggering sign-in.\n *\n * The input callback's return type is constrained to `void | Promise<void>`\n * so the API surface is unambiguously fire-and-forget. To consume a\n * callback's result, capture it inside the callback itself rather than\n * via the wrapper's return value.\n *\n * @param callback - The function to guard behind authentication.\n * @param deps - Optional dependency list (same semantics as `useCallback`).\n * @returns A wrapped callback returning `Promise<void>`.\n */\nexport function useAuthCallback<A extends unknown[]>(\n  callback: (...args: A) => void | Promise<void>,\n  deps?: DependencyList,\n): AuthGuardedCallback<A> {\n  const { status, signIn } = useAuth();\n\n  const statusRef = useRef<string>(status);\n  statusRef.current = status;\n\n  return useCallback(\n    async (...args: A): Promise<void> => {\n      if (statusRef.current !== \"authenticated\") {\n        if (statusRef.current === \"unauthenticated\") {\n          // signIn may return void or Promise<void>. Use Promise.resolve().then(...)\n          // (instead of Promise.resolve(signIn())) so a synchronous throw is also\n          // captured by .catch. Keep fire-and-forget: do NOT await.\n          Promise.resolve()\n            .then(() => signIn())\n            .catch(() => {\n              // Silently swallow; signIn errors are observed via the auth\n              // provider's own error channel (e.g. PrivyAuthProvider's onError).\n            });\n        }\n        return;\n      }\n      await callback(...args);\n    },\n    [...(deps || []), signIn, callback],\n  );\n}\n","import { createContext } from \"react\";\nimport { WalletAdapter } from \"../types\";\n\nexport interface WalletConnectorContextValue {\n  /**\n   * detecting: is detecting connected wallets\n   * connecting: is connecting to the first wallet\n   * connected: is connected to at least one wallet\n   * disconnecting: is disconnecting from the last connected wallet\n   * disconnected: is disconnected from all wallets\n   */\n  status:\n    | \"detecting\"\n    | \"connecting\"\n    | \"connected\"\n    | \"disconnecting\"\n    | \"disconnected\";\n  // all wallets that can be used to take onchain actions when connected\n  wallets: Array<WalletAdapter>;\n  // if no wallets are connected, connect one or multiple wallets\n  connect: () => Promise<void>;\n  // disconnect all wallets\n  disconnect: () => Promise<void>;\n}\n\nexport const WalletConnectorContext =\n  createContext<WalletConnectorContextValue | null>(null);\n","import { useContext } from \"react\";\nimport { WalletConnectorContext } from \"../providers/WalletConnectorContext\";\n\n/**\n * Returns the wallet connector context value.\n *\n * Must be used within a {@link WalletConnectorProvider}.\n * Throws if no provider is found in the component tree.\n *\n * @returns The current {@link WalletConnectorContextValue} (status, wallets, connect, disconnect).\n */\nexport function useWalletConnector() {\n  const context = useContext(WalletConnectorContext);\n  if (context === null) {\n    throw new Error(\n      \"useWalletConnector must be used within a WalletConnectorProvider\",\n    );\n  }\n  return context;\n}\n","import { useWalletConnector } from \"./useWalletConnector\";\n\n/**\n * Convenience hook that returns the `wallets` array from the wallet connector context.\n *\n * Shorthand for `useWalletConnector().wallets`.\n *\n * @returns All wallets that can be used to take on-chain actions when connected.\n */\nexport function useWallets() {\n  const { wallets } = useWalletConnector();\n  return wallets;\n}\n","import { useMemo } from \"react\";\nimport type { Chain } from \"@liberfi.io/types\";\nimport { chainToNamespace } from \"@liberfi.io/utils\";\nimport type { WalletAdapter } from \"../types/WalletAdapter\";\nimport { useWallets } from \"./useWallets\";\n\n/**\n * Returns the first connected wallet matching the given chain's namespace,\n * or `undefined` if none is connected.\n *\n * Shorthand for the common pattern:\n * ```ts\n * const wallets = useWallets();\n * const wallet = wallets.find(w => w.chainNamespace === ns && w.isConnected);\n * ```\n */\nexport function useConnectedWallet(chain: Chain): WalletAdapter | undefined {\n  const wallets = useWallets();\n  const ns = chainToNamespace(chain);\n  return useMemo(\n    () => wallets.find((w) => w.chainNamespace === ns && w.isConnected),\n    [wallets, ns],\n  );\n}\n","import { useCallback } from \"react\";\nimport { Chain, ChainNamespace } from \"@liberfi.io/types\";\nimport { chainToNamespace } from \"@liberfi.io/utils\";\nimport { EvmWalletAdapter } from \"../types\";\nimport { useWallets } from \"./useWallets\";\n\n/**\n * Returns a function that switches **all connected EVM wallets** to the given chain.\n *\n * Semantics:\n *\n * - If `chain` is in the EVM namespace, every connected wallet whose\n *   `chainNamespace === ChainNamespace.EVM` is switched concurrently.\n * - If `chain` is NOT in the EVM namespace (e.g. Solana), the call is a no-op\n *   (Solana has no chain-switching concept within its namespace).\n * - Fail-fast on first wallet rejection (`Promise.all`); previously-switched\n *   wallets are NOT rolled back. Subscribe to per-wallet status separately\n *   if rollback is needed.\n *\n * **Do NOT use this hook to switch a single wallet** — call\n * `wallet.switchChain(chain)` directly on the {@link EvmWalletAdapter}. This\n * hook is the \"sync the whole wallet set to a UI-selected chain\" primitive.\n *\n * @returns An async function `(chain: Chain) => Promise<void>`.\n */\nexport function useSwitchEvmWalletsToChain() {\n  const wallets = useWallets();\n\n  return useCallback(\n    async (chain: Chain) => {\n      if (chainToNamespace(chain) !== ChainNamespace.EVM) return;\n\n      const evmWallets = wallets.filter(\n        (w): w is EvmWalletAdapter =>\n          w.chainNamespace === ChainNamespace.EVM && w.isConnected,\n      );\n      await Promise.all(evmWallets.map((w) => w.switchChain(chain)));\n    },\n    [wallets],\n  );\n}\n","import { PropsWithChildren } from \"react\";\nimport {\n  AuthContext,\n  type AuthContextValue,\n  type AuthStatus,\n} from \"./AuthContext\";\n\nexport type { AuthStatus };\n\n/** Props for {@link AuthProvider}. */\nexport type AuthProviderProps = PropsWithChildren<AuthContextValue>;\n\n/**\n * Provides authentication state to the component tree.\n *\n * This is a passthrough provider — it accepts the full context value as props\n * and forwards it to React context. Implementation providers (e.g.\n * `PrivyAuthProvider`) typically wrap this component and supply the concrete\n * `user`, `status`, `signIn`, `signOut`, and `refreshAccessToken` values.\n */\nexport function AuthProvider({ children, ...value }: AuthProviderProps) {\n  return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;\n}\n","import { PropsWithChildren } from \"react\";\nimport {\n  WalletConnectorContext,\n  WalletConnectorContextValue,\n} from \"./WalletConnectorContext\";\n\n/** Props for {@link WalletConnectorProvider}. */\nexport type WalletConnectorProviderProps =\n  PropsWithChildren<WalletConnectorContextValue>;\n\n/**\n * Provides wallet connection state to the component tree.\n *\n * This is a passthrough provider — it accepts the full context value as props\n * and forwards it to React context. Implementation providers (e.g.\n * `PrivyWalletConnectorProvider`) typically wrap this component and supply\n * the concrete `status`, `wallets`, `connect`, and `disconnect` values.\n */\nexport function WalletConnectorProvider({\n  children,\n  ...value\n}: WalletConnectorProviderProps) {\n  return (\n    <WalletConnectorContext.Provider value={value}>\n      {children}\n    </WalletConnectorContext.Provider>\n  );\n}\n"]}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import {createContext,useContext,useRef,useCallback,useMemo}from'react';import {chainToNamespace}from'@liberfi.io/utils';import {ChainNamespace}from'@liberfi.io/types';import {jsx}from'react/jsx-runtime';var n=createContext({});function u(){let t=useContext(n);if(!t)throw new Error("useAuth must be used within a AuthProvider");return t}function R(t,e){let{status:r,signIn:o}=u(),s=useRef(r);return s.current=r,useCallback(async(...p)=>{if(s.current!=="authenticated"){s.current==="unauthenticated"&&o();return}return t(...p)},[...e||[],o,t])}var i=createContext({});function l(){let t=useContext(i);if(!t)throw new Error("useWalletConnector must be used within a WalletConnectorProvider");return t}function a(){let{wallets:t}=l();return t}function H(t){let e=a(),r=chainToNamespace(t);return useMemo(()=>e.find(o=>o.chainNamespace===r&&o.isConnected),[e,r])}function _(){let t=a();return useCallback(async e=>{if(chainToNamespace(e)===ChainNamespace.SOLANA)return;let r=t.filter(o=>"switchChain"in o&&o.isConnected);await Promise.all(r.map(o=>o.switchChain(e)));},[t])}function st({children:t,...e}){return jsx(n.Provider,{value:e,children:t})}function mt({children:t,...e}){return jsx(i.Provider,{value:e,children:t})}export{st as AuthProvider,mt as WalletConnectorProvider,u as useAuth,R as useAuthCallback,H as useConnectedWallet,_ as useSwitchChain,l as useWalletConnector,a as useWallets};//# sourceMappingURL=index.mjs.map
+import {createContext,useContext,useRef,useCallback,useMemo}from'react';import {chainToNamespace}from'@liberfi.io/utils';import {ChainNamespace}from'@liberfi.io/types';import {jsx}from'react/jsx-runtime';var n=createContext(null);function u(){let t=useContext(n);if(t===null)throw new Error("useAuth must be used within an AuthProvider");return t}function M(t,e){let{status:r,signIn:o}=u(),l=useRef(r);return l.current=r,useCallback(async(...c)=>{if(l.current!=="authenticated"){l.current==="unauthenticated"&&Promise.resolve().then(()=>o()).catch(()=>{});return}await t(...c);},[...e||[],o,t])}var i=createContext(null);function s(){let t=useContext(i);if(t===null)throw new Error("useWalletConnector must be used within a WalletConnectorProvider");return t}function a(){let{wallets:t}=s();return t}function H(t){let e=a(),r=chainToNamespace(t);return useMemo(()=>e.find(o=>o.chainNamespace===r&&o.isConnected),[e,r])}function _(){let t=a();return useCallback(async e=>{if(chainToNamespace(e)!==ChainNamespace.EVM)return;let r=t.filter(o=>o.chainNamespace===ChainNamespace.EVM&&o.isConnected);await Promise.all(r.map(o=>o.switchChain(e)));},[t])}function lt({children:t,...e}){return jsx(n.Provider,{value:e,children:t})}function mt({children:t,...e}){return jsx(i.Provider,{value:e,children:t})}export{lt as AuthProvider,mt as WalletConnectorProvider,u as useAuth,M as useAuthCallback,H as useConnectedWallet,_ as useSwitchEvmWalletsToChain,s as useWalletConnector,a as useWallets};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/providers/AuthContext.ts","../src/hooks/useAuth.ts","../src/hooks/useAuthCallback.ts","../src/providers/WalletConnectorContext.ts","../src/hooks/useWalletConnector.ts","../src/hooks/useWallets.ts","../src/hooks/useConnectedWallet.ts","../src/hooks/useSwitchChain.ts","../src/providers/AuthProvider.tsx","../src/providers/WalletConnectorProvider.tsx"],"names":["AuthContext","createContext","useAuth","context","useContext","useAuthCallback","callback","deps","status","signIn","statusRef","useRef","useCallback","args","WalletConnectorContext","useWalletConnector","useWallets","wallets","useConnectedWallet","chain","ns","chainToNamespace","useMemo","w","useSwitchChain","ChainNamespace","evmWallets","AuthProvider","children","value","jsx","WalletConnectorProvider"],"mappings":"4MAsBO,IAAMA,CAAAA,CAAcC,aAAAA,CACzB,EACF,ECbO,SAASC,CAAAA,EAAU,CACxB,IAAMC,CAAAA,CAAUC,UAAAA,CAAWJ,CAAW,CAAA,CACtC,GAAI,CAACG,CAAAA,CACH,MAAM,IAAI,KAAA,CAAM,4CAA4C,CAAA,CAE9D,OAAOA,CACT,CCUO,SAASE,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACwB,CACxB,GAAM,CAAE,MAAA,CAAAC,CAAAA,CAAQ,OAAAC,CAAO,CAAA,CAAIP,CAAAA,EAAQ,CAE7BQ,CAAAA,CAAYC,MAAAA,CAAeH,CAAM,CAAA,CACvC,OAAAE,CAAAA,CAAU,OAAA,CAAUF,CAAAA,CAEbI,WAAAA,CACL,MAAA,GACKC,CAAAA,GAC6C,CAChD,GAAIH,EAAU,OAAA,GAAY,eAAA,CAAiB,CACrCA,CAAAA,CAAU,OAAA,GAAY,iBAAA,EACxBD,CAAAA,EAAO,CAET,MACF,CACA,OAAOH,CAAAA,CAAS,GAAGO,CAAI,CACzB,CAAA,CACA,CAAC,GAAIN,CAAAA,EAAQ,EAAC,CAAIE,CAAAA,CAAQH,CAAQ,CACpC,CACF,CCzBO,IAAMQ,EACXb,aAAAA,CAA2C,EAAiC,CAAA,CCfvE,SAASc,CAAAA,EAAqB,CACnC,IAAMZ,EAAUC,UAAAA,CAAWU,CAAsB,CAAA,CACjD,GAAI,CAACX,CAAAA,CACH,MAAM,IAAI,MACR,kEACF,CAAA,CAEF,OAAOA,CACT,CCVO,SAASa,CAAAA,EAAa,CAC3B,GAAM,CAAE,OAAA,CAAAC,CAAQ,CAAA,CAAIF,CAAAA,EAAmB,CACvC,OAAOE,CACT,CCIO,SAASC,CAAAA,CAAmBC,CAAAA,CAAyC,CAC1E,IAAMF,CAAAA,CAAUD,CAAAA,GACVI,CAAAA,CAAKC,gBAAAA,CAAiBF,CAAK,CAAA,CACjC,OAAOG,OAAAA,CACL,IAAML,CAAAA,CAAQ,KAAMM,CAAAA,EAAMA,CAAAA,CAAE,cAAA,GAAmBH,CAAAA,EAAMG,CAAAA,CAAE,WAAW,CAAA,CAClE,CAACN,EAASG,CAAE,CACd,CACF,CCRO,SAASI,GAAiB,CAC/B,IAAMP,CAAAA,CAAUD,CAAAA,EAAW,CAE3B,OAAOJ,WAAAA,CACL,MAAOO,GAAiB,CACtB,GAAIE,gBAAAA,CAAiBF,CAAK,CAAA,GAAMM,cAAAA,CAAe,MAAA,CAAQ,OAEvD,IAAMC,CAAAA,CAAaT,CAAAA,CAAQ,MAAA,CACxBM,CAAAA,EAA6B,aAAA,GAAiBA,CAAAA,EAAKA,CAAAA,CAAE,WACxD,CAAA,CACA,MAAM,OAAA,CAAQ,GAAA,CAAIG,CAAAA,CAAW,GAAA,CAAKH,CAAAA,EAAMA,CAAAA,CAAE,YAAYJ,CAAK,CAAC,CAAC,EAC/D,CAAA,CACA,CAACF,CAAO,CACV,CACF,CCTO,SAASU,EAAAA,CAAa,CAAE,QAAA,CAAAC,EAAU,GAAGC,CAAM,CAAA,CAAsB,CACtE,OAAOC,GAAAA,CAAC9B,CAAAA,CAAY,QAAA,CAAZ,CAAqB,KAAA,CAAO6B,CAAAA,CAAQ,QAAA,CAAAD,CAAAA,CAAS,CACvD,CCJO,SAASG,EAAAA,CAAwB,CACtC,QAAA,CAAAH,CAAAA,CACA,GAAGC,CACL,CAAA,CAAiC,CAC/B,OACEC,GAAAA,CAAChB,CAAAA,CAAuB,QAAA,CAAvB,CAAgC,KAAA,CAAOe,CAAAA,CACrC,QAAA,CAAAD,EACH,CAEJ","file":"index.mjs","sourcesContent":["import { createContext } from \"react\";\nimport { AuthenticatedUser } from \"../types\";\n\nexport type AuthStatus =\n  | \"unauthenticated\"\n  | \"authenticating\"\n  | \"authenticated\"\n  | \"deauthenticating\";\n\nexport interface AuthContextValue {\n  /** authenticated user profile */\n  user: AuthenticatedUser | null;\n  /** authentication status */\n  status: AuthStatus;\n  /** sign in to the IdP */\n  signIn: () => void | Promise<void>;\n  /** sign out from the IdP */\n  signOut: () => void | Promise<void>;\n  /** refresh the access token */\n  refreshAccessToken: () => void | Promise<void>;\n}\n\nexport const AuthContext = createContext<AuthContextValue>(\n  {} as AuthContextValue,\n);\n","import { useContext } from \"react\";\nimport { AuthContext } from \"../providers/AuthContext\";\n\n/**\n * Returns the auth context value.\n *\n * Must be used within an {@link AuthProvider}.\n * Throws if no provider is found in the component tree.\n *\n * @returns The current {@link AuthContextValue} (user, status, signIn, signOut, refreshAccessToken).\n */\nexport function useAuth() {\n  const context = useContext(AuthContext);\n  if (!context) {\n    throw new Error(\"useAuth must be used within a AuthProvider\");\n  }\n  return context;\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { DependencyList, useCallback, useRef } from \"react\";\nimport { useAuth } from \"./useAuth\";\n\n/**\n * The return type of {@link useAuthCallback}.\n *\n * Accepts the same parameters as `T` but always returns a `Promise` that\n * resolves to `Awaited<ReturnType<T>>` when authenticated, or `undefined`\n * when the user is not yet authenticated.\n */\nexport type AuthGuardedCallback<T extends (...args: any[]) => any> = (\n  ...args: Parameters<T>\n) => Promise<Awaited<ReturnType<T>> | undefined>;\n\n/**\n * Wraps a callback so it only executes when the user is authenticated.\n *\n * - **authenticated**: executes the callback and returns its result.\n * - **unauthenticated**: triggers `signIn()` and returns `undefined`.\n * - **authenticating**: returns `undefined` without re-triggering sign-in\n *   (avoids conflicting with an in-progress auth flow).\n *\n * @param callback - The function to guard behind authentication.\n * @param deps - Optional dependency list (same semantics as `useCallback`).\n * @returns A wrapped callback that may resolve to `undefined` when not authenticated.\n */\nexport function useAuthCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  deps?: DependencyList,\n): AuthGuardedCallback<T> {\n  const { status, signIn } = useAuth();\n\n  const statusRef = useRef<string>(status);\n  statusRef.current = status;\n\n  return useCallback(\n    async (\n      ...args: Parameters<T>\n    ): Promise<Awaited<ReturnType<T>> | undefined> => {\n      if (statusRef.current !== \"authenticated\") {\n        if (statusRef.current === \"unauthenticated\") {\n          signIn();\n        }\n        return;\n      }\n      return callback(...args);\n    },\n    [...(deps || []), signIn, callback],\n  );\n}\n","import { createContext } from \"react\";\nimport { WalletAdapter } from \"../types\";\n\nexport interface WalletConnectorContextValue {\n  /**\n   * detecting: is detecting connected wallets\n   * connecting: is connecting to the first wallet\n   * connected: is connected to at least one wallet\n   * disconnecting: is disconnecting from the last connected wallet\n   * disconnected: is disconnected from all wallets\n   */\n  status:\n    | \"detecting\"\n    | \"connecting\"\n    | \"connected\"\n    | \"disconnecting\"\n    | \"disconnected\";\n  // all wallets that can be used to take onchain actions when connected\n  wallets: Array<WalletAdapter>;\n  // if no wallets are connected, connect one or multiple wallets\n  connect: () => Promise<void>;\n  // disconnect all wallets\n  disconnect: () => Promise<void>;\n}\n\nexport const WalletConnectorContext =\n  createContext<WalletConnectorContextValue>({} as WalletConnectorContextValue);\n","import { useContext } from \"react\";\nimport { WalletConnectorContext } from \"../providers/WalletConnectorContext\";\n\n/**\n * Returns the wallet connector context value.\n *\n * Must be used within a {@link WalletConnectorProvider}.\n * Throws if no provider is found in the component tree.\n *\n * @returns The current {@link WalletConnectorContextValue} (status, wallets, connect, disconnect).\n */\nexport function useWalletConnector() {\n  const context = useContext(WalletConnectorContext);\n  if (!context) {\n    throw new Error(\n      \"useWalletConnector must be used within a WalletConnectorProvider\",\n    );\n  }\n  return context;\n}\n","import { useWalletConnector } from \"./useWalletConnector\";\n\n/**\n * Convenience hook that returns the `wallets` array from the wallet connector context.\n *\n * Shorthand for `useWalletConnector().wallets`.\n *\n * @returns All wallets that can be used to take on-chain actions when connected.\n */\nexport function useWallets() {\n  const { wallets } = useWalletConnector();\n  return wallets;\n}\n","import { useMemo } from \"react\";\nimport type { Chain } from \"@liberfi.io/types\";\nimport { chainToNamespace } from \"@liberfi.io/utils\";\nimport type { WalletAdapter } from \"../types/WalletAdapter\";\nimport { useWallets } from \"./useWallets\";\n\n/**\n * Returns the first connected wallet matching the given chain's namespace,\n * or `undefined` if none is connected.\n *\n * Shorthand for the common pattern:\n * ```ts\n * const wallets = useWallets();\n * const wallet = wallets.find(w => w.chainNamespace === ns && w.isConnected);\n * ```\n */\nexport function useConnectedWallet(chain: Chain): WalletAdapter | undefined {\n  const wallets = useWallets();\n  const ns = chainToNamespace(chain);\n  return useMemo(\n    () => wallets.find((w) => w.chainNamespace === ns && w.isConnected),\n    [wallets, ns],\n  );\n}\n","import { useCallback } from \"react\";\nimport { Chain, ChainNamespace } from \"@liberfi.io/types\";\nimport { chainToNamespace } from \"@liberfi.io/utils\";\nimport { EvmWalletAdapter } from \"../types\";\nimport { useWallets } from \"./useWallets\";\n\n/**\n * Returns a function that switches all connected EVM wallets to the given chain.\n *\n * Solana chains are automatically skipped (no-op). For EVM chains, the returned\n * function calls `switchChain` on every connected wallet that implements\n * {@link EvmWalletAdapter} in parallel.\n *\n * @returns An async function `(chain: Chain) => Promise<void>`.\n */\nexport function useSwitchChain() {\n  const wallets = useWallets();\n\n  return useCallback(\n    async (chain: Chain) => {\n      if (chainToNamespace(chain) === ChainNamespace.SOLANA) return;\n\n      const evmWallets = wallets.filter(\n        (w): w is EvmWalletAdapter => \"switchChain\" in w && w.isConnected,\n      );\n      await Promise.all(evmWallets.map((w) => w.switchChain(chain)));\n    },\n    [wallets],\n  );\n}\n","import { PropsWithChildren } from \"react\";\nimport {\n  AuthContext,\n  type AuthContextValue,\n  type AuthStatus,\n} from \"./AuthContext\";\n\nexport type { AuthStatus };\n\n/** Props for {@link AuthProvider}. */\nexport type AuthProviderProps = PropsWithChildren<AuthContextValue>;\n\n/**\n * Provides authentication state to the component tree.\n *\n * This is a passthrough provider — it accepts the full context value as props\n * and forwards it to React context. Implementation providers (e.g.\n * `PrivyAuthProvider`) typically wrap this component and supply the concrete\n * `user`, `status`, `signIn`, `signOut`, and `refreshAccessToken` values.\n */\nexport function AuthProvider({ children, ...value }: AuthProviderProps) {\n  return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;\n}\n","import { PropsWithChildren } from \"react\";\nimport {\n  WalletConnectorContext,\n  WalletConnectorContextValue,\n} from \"./WalletConnectorContext\";\n\n/** Props for {@link WalletConnectorProvider}. */\nexport type WalletConnectorProviderProps =\n  PropsWithChildren<WalletConnectorContextValue>;\n\n/**\n * Provides wallet connection state to the component tree.\n *\n * This is a passthrough provider — it accepts the full context value as props\n * and forwards it to React context. Implementation providers (e.g.\n * `PrivyWalletConnectorProvider`) typically wrap this component and supply\n * the concrete `status`, `wallets`, `connect`, and `disconnect` values.\n */\nexport function WalletConnectorProvider({\n  children,\n  ...value\n}: WalletConnectorProviderProps) {\n  return (\n    <WalletConnectorContext.Provider value={value}>\n      {children}\n    </WalletConnectorContext.Provider>\n  );\n}\n"]}
+{"version":3,"sources":["../src/providers/AuthContext.ts","../src/hooks/useAuth.ts","../src/hooks/useAuthCallback.ts","../src/providers/WalletConnectorContext.ts","../src/hooks/useWalletConnector.ts","../src/hooks/useWallets.ts","../src/hooks/useConnectedWallet.ts","../src/hooks/useSwitchEvmWalletsToChain.ts","../src/providers/AuthProvider.tsx","../src/providers/WalletConnectorProvider.tsx"],"names":["AuthContext","createContext","useAuth","context","useContext","useAuthCallback","callback","deps","status","signIn","statusRef","useRef","useCallback","args","WalletConnectorContext","useWalletConnector","useWallets","wallets","useConnectedWallet","chain","ns","chainToNamespace","useMemo","w","useSwitchEvmWalletsToChain","ChainNamespace","evmWallets","AuthProvider","children","value","jsx","WalletConnectorProvider"],"mappings":"4MAsBO,IAAMA,CAAAA,CAAcC,aAAAA,CAAuC,IAAI,CAAA,CCX/D,SAASC,GAAU,CACxB,IAAMC,CAAAA,CAAUC,UAAAA,CAAWJ,CAAW,CAAA,CACtC,GAAIG,CAAAA,GAAY,KACd,MAAM,IAAI,KAAA,CAAM,6CAA6C,CAAA,CAE/D,OAAOA,CACT,CCyBO,SAASE,CAAAA,CACdC,CAAAA,CACAC,EACwB,CACxB,GAAM,CAAE,MAAA,CAAAC,CAAAA,CAAQ,MAAA,CAAAC,CAAO,CAAA,CAAIP,GAAQ,CAE7BQ,CAAAA,CAAYC,MAAAA,CAAeH,CAAM,CAAA,CACvC,OAAAE,CAAAA,CAAU,OAAA,CAAUF,EAEbI,WAAAA,CACL,MAAA,GAAUC,CAAAA,GAA2B,CACnC,GAAIH,CAAAA,CAAU,OAAA,GAAY,eAAA,CAAiB,CACrCA,EAAU,OAAA,GAAY,iBAAA,EAIxB,OAAA,CAAQ,OAAA,EAAQ,CACb,IAAA,CAAK,IAAMD,CAAAA,EAAQ,CAAA,CACnB,KAAA,CAAM,IAAM,CAGb,CAAC,CAAA,CAEL,MACF,CACA,MAAMH,CAAAA,CAAS,GAAGO,CAAI,EACxB,CAAA,CACA,CAAC,GAAIN,CAAAA,EAAQ,EAAC,CAAIE,CAAAA,CAAQH,CAAQ,CACpC,CACF,CC9CO,IAAMQ,CAAAA,CACXb,aAAAA,CAAkD,IAAI,CAAA,CCfjD,SAASc,CAAAA,EAAqB,CACnC,IAAMZ,CAAAA,CAAUC,UAAAA,CAAWU,CAAsB,CAAA,CACjD,GAAIX,IAAY,IAAA,CACd,MAAM,IAAI,KAAA,CACR,kEACF,CAAA,CAEF,OAAOA,CACT,CCVO,SAASa,CAAAA,EAAa,CAC3B,GAAM,CAAE,OAAA,CAAAC,CAAQ,CAAA,CAAIF,CAAAA,GACpB,OAAOE,CACT,CCIO,SAASC,CAAAA,CAAmBC,CAAAA,CAAyC,CAC1E,IAAMF,EAAUD,CAAAA,EAAW,CACrBI,CAAAA,CAAKC,gBAAAA,CAAiBF,CAAK,CAAA,CACjC,OAAOG,OAAAA,CACL,IAAML,CAAAA,CAAQ,IAAA,CAAMM,CAAAA,EAAMA,CAAAA,CAAE,cAAA,GAAmBH,CAAAA,EAAMG,CAAAA,CAAE,WAAW,EAClE,CAACN,CAAAA,CAASG,CAAE,CACd,CACF,CCEO,SAASI,CAAAA,EAA6B,CAC3C,IAAMP,CAAAA,CAAUD,CAAAA,EAAW,CAE3B,OAAOJ,YACL,MAAOO,CAAAA,EAAiB,CACtB,GAAIE,iBAAiBF,CAAK,CAAA,GAAMM,cAAAA,CAAe,GAAA,CAAK,OAEpD,IAAMC,CAAAA,CAAaT,CAAAA,CAAQ,MAAA,CACxBM,CAAAA,EACCA,CAAAA,CAAE,cAAA,GAAmBE,cAAAA,CAAe,KAAOF,CAAAA,CAAE,WACjD,CAAA,CACA,MAAM,OAAA,CAAQ,GAAA,CAAIG,CAAAA,CAAW,GAAA,CAAKH,GAAMA,CAAAA,CAAE,WAAA,CAAYJ,CAAK,CAAC,CAAC,EAC/D,CAAA,CACA,CAACF,CAAO,CACV,CACF,CCpBO,SAASU,EAAAA,CAAa,CAAE,SAAAC,CAAAA,CAAU,GAAGC,CAAM,CAAA,CAAsB,CACtE,OAAOC,GAAAA,CAAC9B,CAAAA,CAAY,SAAZ,CAAqB,KAAA,CAAO6B,CAAAA,CAAQ,QAAA,CAAAD,CAAAA,CAAS,CACvD,CCJO,SAASG,EAAAA,CAAwB,CACtC,QAAA,CAAAH,CAAAA,CACA,GAAGC,CACL,EAAiC,CAC/B,OACEC,GAAAA,CAAChB,CAAAA,CAAuB,SAAvB,CAAgC,KAAA,CAAOe,CAAAA,CACrC,QAAA,CAAAD,EACH,CAEJ","file":"index.mjs","sourcesContent":["import { createContext } from \"react\";\nimport { AuthenticatedUser } from \"../types\";\n\nexport type AuthStatus =\n  | \"unauthenticated\"\n  | \"authenticating\"\n  | \"authenticated\"\n  | \"deauthenticating\";\n\nexport interface AuthContextValue {\n  /** authenticated user profile */\n  user: AuthenticatedUser | null;\n  /** authentication status */\n  status: AuthStatus;\n  /** sign in to the IdP */\n  signIn: () => void | Promise<void>;\n  /** sign out from the IdP */\n  signOut: () => void | Promise<void>;\n  /** refresh the access token */\n  refreshAccessToken: () => void | Promise<void>;\n}\n\nexport const AuthContext = createContext<AuthContextValue | null>(null);\n","import { useContext } from \"react\";\nimport { AuthContext } from \"../providers/AuthContext\";\n\n/**\n * Returns the auth context value.\n *\n * Must be used within an {@link AuthProvider}.\n * Throws if no provider is found in the component tree.\n *\n * @returns The current {@link AuthContextValue} (user, status, signIn, signOut, refreshAccessToken).\n */\nexport function useAuth() {\n  const context = useContext(AuthContext);\n  if (context === null) {\n    throw new Error(\"useAuth must be used within an AuthProvider\");\n  }\n  return context;\n}\n","import { DependencyList, useCallback, useRef } from \"react\";\nimport { useAuth } from \"./useAuth\";\n\n/**\n * The return type of {@link useAuthCallback}.\n *\n * Always resolves to `void` — the wrapper is fire-and-forget by design.\n * Any value returned by the input callback is discarded. To consume a\n * callback's result, capture it inside the callback itself (e.g. setState,\n * toast). For sign-in errors, observe via the auth provider's own channel\n * (e.g. `PrivyAuthProvider`'s `onError`).\n *\n * Rejections from the input callback DO propagate to the returned Promise,\n * so callers may `await` and `try/catch` to handle the callback's own\n * failures. Rejections from `signIn()` are silenced — they are observable\n * elsewhere.\n */\nexport type AuthGuardedCallback<A extends readonly unknown[]> = (\n  ...args: A\n) => Promise<void>;\n\n/**\n * Wraps a callback so it only executes when the user is authenticated.\n *\n * Behavior by auth status:\n * - `authenticated`: executes the callback; the callback's return value is\n *   discarded, but any rejection propagates to the returned Promise.\n * - `unauthenticated`: triggers `signIn()` fire-and-forget and resolves\n *   immediately. Errors from `signIn()` are silenced here — observe them\n *   via the auth provider's own error channel.\n * - `authenticating` / `deauthenticating`: no-op; resolves immediately\n *   without re-triggering sign-in.\n *\n * The input callback's return type is constrained to `void | Promise<void>`\n * so the API surface is unambiguously fire-and-forget. To consume a\n * callback's result, capture it inside the callback itself rather than\n * via the wrapper's return value.\n *\n * @param callback - The function to guard behind authentication.\n * @param deps - Optional dependency list (same semantics as `useCallback`).\n * @returns A wrapped callback returning `Promise<void>`.\n */\nexport function useAuthCallback<A extends unknown[]>(\n  callback: (...args: A) => void | Promise<void>,\n  deps?: DependencyList,\n): AuthGuardedCallback<A> {\n  const { status, signIn } = useAuth();\n\n  const statusRef = useRef<string>(status);\n  statusRef.current = status;\n\n  return useCallback(\n    async (...args: A): Promise<void> => {\n      if (statusRef.current !== \"authenticated\") {\n        if (statusRef.current === \"unauthenticated\") {\n          // signIn may return void or Promise<void>. Use Promise.resolve().then(...)\n          // (instead of Promise.resolve(signIn())) so a synchronous throw is also\n          // captured by .catch. Keep fire-and-forget: do NOT await.\n          Promise.resolve()\n            .then(() => signIn())\n            .catch(() => {\n              // Silently swallow; signIn errors are observed via the auth\n              // provider's own error channel (e.g. PrivyAuthProvider's onError).\n            });\n        }\n        return;\n      }\n      await callback(...args);\n    },\n    [...(deps || []), signIn, callback],\n  );\n}\n","import { createContext } from \"react\";\nimport { WalletAdapter } from \"../types\";\n\nexport interface WalletConnectorContextValue {\n  /**\n   * detecting: is detecting connected wallets\n   * connecting: is connecting to the first wallet\n   * connected: is connected to at least one wallet\n   * disconnecting: is disconnecting from the last connected wallet\n   * disconnected: is disconnected from all wallets\n   */\n  status:\n    | \"detecting\"\n    | \"connecting\"\n    | \"connected\"\n    | \"disconnecting\"\n    | \"disconnected\";\n  // all wallets that can be used to take onchain actions when connected\n  wallets: Array<WalletAdapter>;\n  // if no wallets are connected, connect one or multiple wallets\n  connect: () => Promise<void>;\n  // disconnect all wallets\n  disconnect: () => Promise<void>;\n}\n\nexport const WalletConnectorContext =\n  createContext<WalletConnectorContextValue | null>(null);\n","import { useContext } from \"react\";\nimport { WalletConnectorContext } from \"../providers/WalletConnectorContext\";\n\n/**\n * Returns the wallet connector context value.\n *\n * Must be used within a {@link WalletConnectorProvider}.\n * Throws if no provider is found in the component tree.\n *\n * @returns The current {@link WalletConnectorContextValue} (status, wallets, connect, disconnect).\n */\nexport function useWalletConnector() {\n  const context = useContext(WalletConnectorContext);\n  if (context === null) {\n    throw new Error(\n      \"useWalletConnector must be used within a WalletConnectorProvider\",\n    );\n  }\n  return context;\n}\n","import { useWalletConnector } from \"./useWalletConnector\";\n\n/**\n * Convenience hook that returns the `wallets` array from the wallet connector context.\n *\n * Shorthand for `useWalletConnector().wallets`.\n *\n * @returns All wallets that can be used to take on-chain actions when connected.\n */\nexport function useWallets() {\n  const { wallets } = useWalletConnector();\n  return wallets;\n}\n","import { useMemo } from \"react\";\nimport type { Chain } from \"@liberfi.io/types\";\nimport { chainToNamespace } from \"@liberfi.io/utils\";\nimport type { WalletAdapter } from \"../types/WalletAdapter\";\nimport { useWallets } from \"./useWallets\";\n\n/**\n * Returns the first connected wallet matching the given chain's namespace,\n * or `undefined` if none is connected.\n *\n * Shorthand for the common pattern:\n * ```ts\n * const wallets = useWallets();\n * const wallet = wallets.find(w => w.chainNamespace === ns && w.isConnected);\n * ```\n */\nexport function useConnectedWallet(chain: Chain): WalletAdapter | undefined {\n  const wallets = useWallets();\n  const ns = chainToNamespace(chain);\n  return useMemo(\n    () => wallets.find((w) => w.chainNamespace === ns && w.isConnected),\n    [wallets, ns],\n  );\n}\n","import { useCallback } from \"react\";\nimport { Chain, ChainNamespace } from \"@liberfi.io/types\";\nimport { chainToNamespace } from \"@liberfi.io/utils\";\nimport { EvmWalletAdapter } from \"../types\";\nimport { useWallets } from \"./useWallets\";\n\n/**\n * Returns a function that switches **all connected EVM wallets** to the given chain.\n *\n * Semantics:\n *\n * - If `chain` is in the EVM namespace, every connected wallet whose\n *   `chainNamespace === ChainNamespace.EVM` is switched concurrently.\n * - If `chain` is NOT in the EVM namespace (e.g. Solana), the call is a no-op\n *   (Solana has no chain-switching concept within its namespace).\n * - Fail-fast on first wallet rejection (`Promise.all`); previously-switched\n *   wallets are NOT rolled back. Subscribe to per-wallet status separately\n *   if rollback is needed.\n *\n * **Do NOT use this hook to switch a single wallet** — call\n * `wallet.switchChain(chain)` directly on the {@link EvmWalletAdapter}. This\n * hook is the \"sync the whole wallet set to a UI-selected chain\" primitive.\n *\n * @returns An async function `(chain: Chain) => Promise<void>`.\n */\nexport function useSwitchEvmWalletsToChain() {\n  const wallets = useWallets();\n\n  return useCallback(\n    async (chain: Chain) => {\n      if (chainToNamespace(chain) !== ChainNamespace.EVM) return;\n\n      const evmWallets = wallets.filter(\n        (w): w is EvmWalletAdapter =>\n          w.chainNamespace === ChainNamespace.EVM && w.isConnected,\n      );\n      await Promise.all(evmWallets.map((w) => w.switchChain(chain)));\n    },\n    [wallets],\n  );\n}\n","import { PropsWithChildren } from \"react\";\nimport {\n  AuthContext,\n  type AuthContextValue,\n  type AuthStatus,\n} from \"./AuthContext\";\n\nexport type { AuthStatus };\n\n/** Props for {@link AuthProvider}. */\nexport type AuthProviderProps = PropsWithChildren<AuthContextValue>;\n\n/**\n * Provides authentication state to the component tree.\n *\n * This is a passthrough provider — it accepts the full context value as props\n * and forwards it to React context. Implementation providers (e.g.\n * `PrivyAuthProvider`) typically wrap this component and supply the concrete\n * `user`, `status`, `signIn`, `signOut`, and `refreshAccessToken` values.\n */\nexport function AuthProvider({ children, ...value }: AuthProviderProps) {\n  return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;\n}\n","import { PropsWithChildren } from \"react\";\nimport {\n  WalletConnectorContext,\n  WalletConnectorContextValue,\n} from \"./WalletConnectorContext\";\n\n/** Props for {@link WalletConnectorProvider}. */\nexport type WalletConnectorProviderProps =\n  PropsWithChildren<WalletConnectorContextValue>;\n\n/**\n * Provides wallet connection state to the component tree.\n *\n * This is a passthrough provider — it accepts the full context value as props\n * and forwards it to React context. Implementation providers (e.g.\n * `PrivyWalletConnectorProvider`) typically wrap this component and supply\n * the concrete `status`, `wallets`, `connect`, and `disconnect` values.\n */\nexport function WalletConnectorProvider({\n  children,\n  ...value\n}: WalletConnectorProviderProps) {\n  return (\n    <WalletConnectorContext.Provider value={value}>\n      {children}\n    </WalletConnectorContext.Provider>\n  );\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liberfi.io/wallet-connector",
-  "version": "0.1.186",
+  "version": "0.2.1",
   "description": "Base Wallet Connector for Liberfi React SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -14,8 +14,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@liberfi.io/types": "0.4.0",
-    "@liberfi.io/utils": "0.1.192"
+    "@liberfi.io/types": "0.4.2",
+    "@liberfi.io/utils": "0.2.1"
   },
   "devDependencies": {
     "@testing-library/dom": "^10.4.1",
@@ -31,7 +31,7 @@
     "ts-jest": "^29.4.6",
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
-    "tsconfig": "0.1.183"
+    "tsconfig": "0.1.185"
   },
   "peerDependencies": {
     "react": ">=18",