@liberfi.io/wallet-connector 0.1.18 → 0.1.20

package/README.md

@@ -0,0 +1,334 @@
+# @liberfi.io/wallet-connector
+
+Base wallet connector abstraction for the Liberfi React SDK. This package defines the **interfaces**, **React context/providers**, and **hooks** for wallet connection and authentication — without binding to any specific wallet provider or identity service. Concrete implementations (e.g. Privy) live in separate packages like `@liberfi.io/wallet-connector-privy`.
+
+## Design Philosophy
+
+- **Provider-agnostic abstraction** — Defines a `WalletAdapter` interface and React contexts; the package never imports a concrete wallet SDK. Implementation packages inject behavior via `WalletConnectorProvider` and `AuthProvider`.
+- **Inversion of control** — `connect`, `disconnect`, `signIn`, `signOut`, and `refreshAccessToken` are supplied by the consumer, not hardcoded. This allows swapping wallet providers without changing downstream code.
+- **Layered architecture** — Three clean layers: `types/` (interfaces and domain types) → `providers/` (React context and passthrough providers) → `hooks/` (consumer-facing hooks). No circular dependencies.
+- **Minimal surface area** — Only exports what consumers need: 2 providers, 5 hooks, and a handful of types. No UI, no side effects, no heavy dependencies.
+
+## Installation
+
+```bash
+pnpm add @liberfi.io/wallet-connector
+```
+
+### Peer Dependencies
+
+| Package     | Version |
+| ----------- | ------- |
+| `react`     | >=18    |
+| `react-dom` | >=18    |
+
+## API Reference
+
+### Types
+
+#### `WalletAdapter`
+
+The core wallet abstraction. All wallet implementations must conform to this interface.
+
+```typescript
+interface WalletAdapter {
+  get chainNamespace(): ChainNamespace;
+  get chain(): Chain | undefined;
+  get address(): string;
+  get isConnected(): boolean;
+  get isCustodial(): boolean;
+  get connector(): string;
+
+  signMessage(message: string): Promise<string>;
+  signTransaction(serializedTx: Uint8Array): Promise<Uint8Array>;
+  sendTransaction(serializedTx: Uint8Array): Promise<string>;
+}
+```
+
+#### `EvmWalletAdapter`
+
+Extends `WalletAdapter` with EVM-specific capabilities.
+
+```typescript
+interface EvmWalletAdapter extends WalletAdapter {
+  getEip1193Provider(): Promise<Eip1193Provider | undefined>;
+  switchChain(chain: Chain): Promise<void>;
+}
+```
+
+#### `Eip1193Provider`
+
+Standard [EIP-1193](https://eips.ethereum.org/EIPS/eip-1193) provider interface.
+
+```typescript
+interface Eip1193Provider {
+  request(request: {
+    method: string;
+    params?: Array<unknown> | Record<string, unknown>;
+  }): Promise<unknown>;
+}
+```
+
+#### `AuthenticatedUser`
+
+Represents the currently authenticated user.
+
+```typescript
+interface AuthenticatedUser {
+  id: string;
+  wallets: Array<WalletAdapter>;
+  accessToken: string;
+}
+```
+
+#### `WalletConnectorContextValue`
+
+Shape of the wallet connector context.
+
+```typescript
+interface WalletConnectorContextValue {
+  status:
+    | "detecting"
+    | "connecting"
+    | "connected"
+    | "disconnecting"
+    | "disconnected";
+  wallets: Array<WalletAdapter>;
+  connect: () => Promise<void>;
+  disconnect: () => Promise<void>;
+}
+```
+
+#### `AuthContextValue`
+
+Shape of the auth context.
+
+```typescript
+interface AuthContextValue {
+  user: AuthenticatedUser | null;
+  status: "unauthenticated" | "authenticating" | "authenticated";
+  signIn: () => void | Promise<void>;
+  signOut: () => void | Promise<void>;
+  refreshAccessToken: () => void | Promise<void>;
+}
+```
+
+### Components
+
+#### `WalletConnectorProvider`
+
+Provides wallet connection state to the component tree. Typically wrapped by an implementation provider (e.g. `PrivyWalletConnectorProvider`).
+
+| Prop         | Type                                    | Description                |
+| ------------ | --------------------------------------- | -------------------------- |
+| `status`     | `WalletConnectorContextValue["status"]` | Current connection status  |
+| `wallets`    | `Array<WalletAdapter>`                  | Connected wallet adapters  |
+| `connect`    | `() => Promise<void>`                   | Triggers wallet connection |
+| `disconnect` | `() => Promise<void>`                   | Disconnects all wallets    |
+| `children`   | `ReactNode`                             | Child components           |
+
+#### `AuthProvider`
+
+Provides authentication state to the component tree. Typically wrapped by an implementation provider (e.g. `PrivyAuthProvider`).
+
+| Prop                 | Type                          | Description                |
+| -------------------- | ----------------------------- | -------------------------- |
+| `user`               | `AuthenticatedUser \| null`   | Current authenticated user |
+| `status`             | `AuthContextValue["status"]`  | Current auth status        |
+| `signIn`             | `() => void \| Promise<void>` | Triggers sign-in flow      |
+| `signOut`            | `() => void \| Promise<void>` | Triggers sign-out flow     |
+| `refreshAccessToken` | `() => void \| Promise<void>` | Refreshes the access token |
+| `children`           | `ReactNode`                   | Child components           |
+
+### Hooks
+
+#### `useWalletConnector()`
+
+Returns the full `WalletConnectorContextValue`. Throws if used outside `WalletConnectorProvider`.
+
+```typescript
+function useWalletConnector(): WalletConnectorContextValue;
+```
+
+#### `useWallets()`
+
+Convenience hook that returns only the `wallets` array from the wallet connector context.
+
+```typescript
+function useWallets(): Array<WalletAdapter>;
+```
+
+#### `useAuth()`
+
+Returns the full `AuthContextValue`. Throws if used outside `AuthProvider`.
+
+```typescript
+function useAuth(): AuthContextValue;
+```
+
+#### `useAuthCallback<T>(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.
+
+```typescript
+type AuthGuardedCallback<T extends (...args: any[]) => any> = (
+  ...args: Parameters<T>
+) => Promise<Awaited<ReturnType<T>> | undefined>;
+
+function useAuthCallback<T extends (...args: any[]) => any>(
+  callback: T,
+  deps?: DependencyList,
+): AuthGuardedCallback<T>;
+```
+
+The return type `AuthGuardedCallback<T>` makes it explicit that the wrapped function may resolve to `undefined` when the user is not authenticated.
+
+#### `useSwitchChain()`
+
+Returns a function that switches all connected EVM wallets to a given chain. Solana chains are automatically skipped.
+
+```typescript
+function useSwitchChain(): (chain: Chain) => Promise<void>;
+```
+
+### Constants
+
+#### `version`
+
+The current package version string.
+
+```typescript
+const version: string; // e.g. "0.1.18"
+```
+
+## Usage Examples
+
+### Basic Setup with an Implementation Provider
+
+This package is designed to be used with an implementation provider. Here's an example using `@liberfi.io/wallet-connector-privy`:
+
+```tsx
+import {
+  PrivyWalletConnectorProvider,
+  PrivyAuthProvider,
+} from "@liberfi.io/wallet-connector-privy";
+
+function App() {
+  return (
+    <PrivyWalletConnectorProvider privyAppId="your-app-id">
+      <PrivyAuthProvider>
+        <MyApp />
+      </PrivyAuthProvider>
+    </PrivyWalletConnectorProvider>
+  );
+}
+```
+
+### Consuming Wallet State
+
+```tsx
+import { useWalletConnector, useWallets } from "@liberfi.io/wallet-connector";
+
+function WalletStatus() {
+  const { status, connect, disconnect } = useWalletConnector();
+  const wallets = useWallets();
+
+  if (status === "disconnected") {
+    return <button onClick={connect}>Connect Wallet</button>;
+  }
+
+  return (
+    <div>
+      <p>Status: {status}</p>
+      <ul>
+        {wallets.map((w) => (
+          <li key={w.address}>
+            {w.connector}: {w.address}
+          </li>
+        ))}
+      </ul>
+      <button onClick={disconnect}>Disconnect</button>
+    </div>
+  );
+}
+```
+
+### Auth-Gated Actions
+
+```tsx
+import { useAuthCallback } from "@liberfi.io/wallet-connector";
+
+function TradeButton() {
+  const handleTrade = useAuthCallback(async () => {
+    // This only runs when the user is authenticated.
+    // If not authenticated, signIn() is triggered automatically.
+    await executeTrade();
+  }, []);
+
+  return <button onClick={handleTrade}>Trade</button>;
+}
+```
+
+### Switching Chains
+
+```tsx
+import { Chain } from "@liberfi.io/types";
+import { useSwitchChain } from "@liberfi.io/wallet-connector";
+
+function ChainSwitcher() {
+  const switchChain = useSwitchChain();
+
+  return (
+    <button onClick={() => switchChain(Chain.ETHEREUM)}>
+      Switch to Ethereum
+    </button>
+  );
+}
+```
+
+### Building a Custom Implementation
+
+To create a new wallet connector implementation, implement `WalletAdapter` (and optionally `EvmWalletAdapter`) and wrap the providers:
+
+```tsx
+import {
+  WalletConnectorProvider,
+  AuthProvider,
+  WalletAdapter,
+} from "@liberfi.io/wallet-connector";
+
+class MyWalletAdapter implements WalletAdapter {
+  // Implement all WalletAdapter properties and methods...
+}
+
+function MyWalletConnectorProvider({ children }: PropsWithChildren) {
+  const [wallets, setWallets] = useState<WalletAdapter[]>([]);
+  const [status, setStatus] = useState<"disconnected" | "connected">(
+    "disconnected",
+  );
+
+  const connect = async () => {
+    /* your connect logic */
+  };
+  const disconnect = async () => {
+    /* your disconnect logic */
+  };
+
+  return (
+    <WalletConnectorProvider
+      status={status}
+      wallets={wallets}
+      connect={connect}
+      disconnect={disconnect}
+    >
+      {children}
+    </WalletConnectorProvider>
+  );
+}
+```
+
+## Future Improvements
+
+- **Context default safety** — Switch context defaults from `{} as ContextValue` to `null` with `ContextValue | null` type for type-safe "no provider" detection.
+- **Expand test coverage** — Add tests for status transitions (unauthenticated → authenticated) and error propagation when `switchChain` rejects.
+- **Typed EIP-1193 overloads** — Provide method-specific typed overloads for common EIP-1193 methods (e.g. `eth_sendTransaction`, `personal_sign`).

package/dist/index.d.mts

@@ -34,6 +34,13 @@ interface WalletAdapter {
     sendTransaction(serializedTx: Uint8Array): Promise<string>;
 }
 
+/**
+ * Represents the currently authenticated user.
+ *
+ * Implementation providers (e.g. `wallet-connector-privy`) construct this
+ * by spreading their own user object, so runtime instances may carry
+ * additional provider-specific fields beyond what is declared here.
+ */
 interface AuthenticatedUser {
     /** user id */
     id: string;
@@ -41,19 +48,20 @@ interface AuthenticatedUser {
     wallets: Array<WalletAdapter>;
     /** user access token */
     accessToken: string;
-    /** user profiles */
-    [key: string]: any;
 }
 
 /**
  * The interface to an [EIP-1193](https://eips.ethereum.org/EIPS/eip-1193) provider,
- * which is a standard used by most injected providers
+ * which is a standard used by most injected providers.
+ *
+ * Uses `unknown` for params and return value — callers must narrow
+ * the result to the expected type based on the method being called.
  */
 interface Eip1193Provider {
     request(request: {
         method: string;
-        params?: Array<any> | Record<string, any>;
-    }): Promise<any>;
+        params?: Array<unknown> | Record<string, unknown>;
+    }): Promise<unknown>;
 }
 /**
  * Evm wallet adapter interface
@@ -83,13 +91,46 @@ interface AuthContextValue {
     refreshAccessToken: () => void | Promise<void>;
 }
 
+/**
+ * Returns the auth context value.
+ *
+ * Must be used within an {@link AuthProvider}.
+ * Throws if no provider is found in the component tree.
+ *
+ * @returns The current {@link AuthContextValue} (user, status, signIn, signOut, refreshAccessToken).
+ */
 declare function useAuth(): AuthContextValue;
 
-declare function useAuthCallback<T extends (...args: any[]) => any>(callback: T, deps?: DependencyList): T;
+/**
+ * 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.
+ */
+type AuthGuardedCallback<T extends (...args: any[]) => any> = (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>> | undefined>;
+/**
+ * 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).
+ *
+ * @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.
+ */
+declare function useAuthCallback<T extends (...args: any[]) => any>(callback: T, deps?: DependencyList): AuthGuardedCallback<T>;
 
 /**
  * Returns a function that switches all connected EVM wallets to the given chain.
- * Solana chains are skipped.
+ *
+ * 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.
+ *
+ * @returns An async function `(chain: Chain) => Promise<void>`.
  */
 declare function useSwitchChain(): (chain: Chain) => Promise<void>;
 
@@ -108,21 +149,46 @@ interface WalletConnectorContextValue {
 }
 
 /**
- * use wallet connector hook
- * @returns wallet connector
+ * Returns the wallet connector context value.
+ *
+ * Must be used within a {@link WalletConnectorProvider}.
+ * Throws if no provider is found in the component tree.
+ *
+ * @returns The current {@link WalletConnectorContextValue} (status, wallets, connect, disconnect).
  */
 declare function useWalletConnector(): WalletConnectorContextValue;
 
 /**
- * use wallets hook
- * @returns all wallets that can be used to take onchain actions
+ * Convenience hook that returns the `wallets` array from the wallet connector context.
+ *
+ * Shorthand for `useWalletConnector().wallets`.
+ *
+ * @returns All wallets that can be used to take on-chain actions when connected.
  */
 declare function useWallets(): WalletAdapter[];
 
+/** Props for {@link AuthProvider}. */
 type AuthProviderProps = PropsWithChildren<AuthContextValue>;
+/**
+ * Provides authentication state to the component tree.
+ *
+ * This is a passthrough provider — it accepts the full context value as props
+ * and forwards it to React context. Implementation providers (e.g.
+ * `PrivyAuthProvider`) typically wrap this component and supply the concrete
+ * `user`, `status`, `signIn`, `signOut`, and `refreshAccessToken` values.
+ */
 declare function AuthProvider({ children, ...value }: AuthProviderProps): react_jsx_runtime.JSX.Element;
 
+/** Props for {@link WalletConnectorProvider}. */
 type WalletConnectorProviderProps = PropsWithChildren<WalletConnectorContextValue>;
+/**
+ * Provides wallet connection state to the component tree.
+ *
+ * This is a passthrough provider — it accepts the full context value as props
+ * and forwards it to React context. Implementation providers (e.g.
+ * `PrivyWalletConnectorProvider`) typically wrap this component and supply
+ * the concrete `status`, `wallets`, `connect`, and `disconnect` values.
+ */
 declare function WalletConnectorProvider({ children, ...value }: WalletConnectorProviderProps): react_jsx_runtime.JSX.Element;
 
 declare global {
@@ -132,6 +198,6 @@ declare global {
         };
     }
 }
-declare const _default: "0.1.18";
+declare const _default: "0.1.20";
 
-export { AuthProvider, type AuthProviderProps, type AuthenticatedUser, type Eip1193Provider, type EvmWalletAdapter, type WalletAdapter, WalletConnectorProvider, type WalletConnectorProviderProps, useAuth, useAuthCallback, useSwitchChain, useWalletConnector, useWallets, _default as version };
+export { type AuthGuardedCallback, AuthProvider, type AuthProviderProps, type AuthenticatedUser, type Eip1193Provider, type EvmWalletAdapter, type WalletAdapter, WalletConnectorProvider, type WalletConnectorProviderProps, useAuth, useAuthCallback, useSwitchChain, useWalletConnector, useWallets, _default as version };

package/dist/index.d.ts

@@ -34,6 +34,13 @@ interface WalletAdapter {
     sendTransaction(serializedTx: Uint8Array): Promise<string>;
 }
 
+/**
+ * Represents the currently authenticated user.
+ *
+ * Implementation providers (e.g. `wallet-connector-privy`) construct this
+ * by spreading their own user object, so runtime instances may carry
+ * additional provider-specific fields beyond what is declared here.
+ */
 interface AuthenticatedUser {
     /** user id */
     id: string;
@@ -41,19 +48,20 @@ interface AuthenticatedUser {
     wallets: Array<WalletAdapter>;
     /** user access token */
     accessToken: string;
-    /** user profiles */
-    [key: string]: any;
 }
 
 /**
  * The interface to an [EIP-1193](https://eips.ethereum.org/EIPS/eip-1193) provider,
- * which is a standard used by most injected providers
+ * which is a standard used by most injected providers.
+ *
+ * Uses `unknown` for params and return value — callers must narrow
+ * the result to the expected type based on the method being called.
  */
 interface Eip1193Provider {
     request(request: {
         method: string;
-        params?: Array<any> | Record<string, any>;
-    }): Promise<any>;
+        params?: Array<unknown> | Record<string, unknown>;
+    }): Promise<unknown>;
 }
 /**
  * Evm wallet adapter interface
@@ -83,13 +91,46 @@ interface AuthContextValue {
     refreshAccessToken: () => void | Promise<void>;
 }
 
+/**
+ * Returns the auth context value.
+ *
+ * Must be used within an {@link AuthProvider}.
+ * Throws if no provider is found in the component tree.
+ *
+ * @returns The current {@link AuthContextValue} (user, status, signIn, signOut, refreshAccessToken).
+ */
 declare function useAuth(): AuthContextValue;
 
-declare function useAuthCallback<T extends (...args: any[]) => any>(callback: T, deps?: DependencyList): T;
+/**
+ * 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.
+ */
+type AuthGuardedCallback<T extends (...args: any[]) => any> = (...args: Parameters<T>) => Promise<Awaited<ReturnType<T>> | undefined>;
+/**
+ * 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).
+ *
+ * @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.
+ */
+declare function useAuthCallback<T extends (...args: any[]) => any>(callback: T, deps?: DependencyList): AuthGuardedCallback<T>;
 
 /**
  * Returns a function that switches all connected EVM wallets to the given chain.
- * Solana chains are skipped.
+ *
+ * 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.
+ *
+ * @returns An async function `(chain: Chain) => Promise<void>`.
  */
 declare function useSwitchChain(): (chain: Chain) => Promise<void>;
 
@@ -108,21 +149,46 @@ interface WalletConnectorContextValue {
 }
 
 /**
- * use wallet connector hook
- * @returns wallet connector
+ * Returns the wallet connector context value.
+ *
+ * Must be used within a {@link WalletConnectorProvider}.
+ * Throws if no provider is found in the component tree.
+ *
+ * @returns The current {@link WalletConnectorContextValue} (status, wallets, connect, disconnect).
  */
 declare function useWalletConnector(): WalletConnectorContextValue;
 
 /**
- * use wallets hook
- * @returns all wallets that can be used to take onchain actions
+ * Convenience hook that returns the `wallets` array from the wallet connector context.
+ *
+ * Shorthand for `useWalletConnector().wallets`.
+ *
+ * @returns All wallets that can be used to take on-chain actions when connected.
  */
 declare function useWallets(): WalletAdapter[];
 
+/** Props for {@link AuthProvider}. */
 type AuthProviderProps = PropsWithChildren<AuthContextValue>;
+/**
+ * Provides authentication state to the component tree.
+ *
+ * This is a passthrough provider — it accepts the full context value as props
+ * and forwards it to React context. Implementation providers (e.g.
+ * `PrivyAuthProvider`) typically wrap this component and supply the concrete
+ * `user`, `status`, `signIn`, `signOut`, and `refreshAccessToken` values.
+ */
 declare function AuthProvider({ children, ...value }: AuthProviderProps): react_jsx_runtime.JSX.Element;
 
+/** Props for {@link WalletConnectorProvider}. */
 type WalletConnectorProviderProps = PropsWithChildren<WalletConnectorContextValue>;
+/**
+ * Provides wallet connection state to the component tree.
+ *
+ * This is a passthrough provider — it accepts the full context value as props
+ * and forwards it to React context. Implementation providers (e.g.
+ * `PrivyWalletConnectorProvider`) typically wrap this component and supply
+ * the concrete `status`, `wallets`, `connect`, and `disconnect` values.
+ */
 declare function WalletConnectorProvider({ children, ...value }: WalletConnectorProviderProps): react_jsx_runtime.JSX.Element;
 
 declare global {
@@ -132,6 +198,6 @@ declare global {
         };
     }
 }
-declare const _default: "0.1.18";
+declare const _default: "0.1.20";
 
-export { AuthProvider, type AuthProviderProps, type AuthenticatedUser, type Eip1193Provider, type EvmWalletAdapter, type WalletAdapter, WalletConnectorProvider, type WalletConnectorProviderProps, useAuth, useAuthCallback, useSwitchChain, useWalletConnector, useWallets, _default as version };
+export { type AuthGuardedCallback, AuthProvider, type AuthProviderProps, type AuthenticatedUser, type Eip1193Provider, type EvmWalletAdapter, type WalletAdapter, WalletConnectorProvider, type WalletConnectorProviderProps, useAuth, useAuthCallback, useSwitchChain, useWalletConnector, useWallets, _default as version };

package/dist/index.js

@@ -1,2 +1,2 @@
-'use strict';var react=require('react'),types=require('@liberfi.io/types'),utils=require('@liberfi.io/utils'),jsxRuntime=require('react/jsx-runtime');var n=react.createContext({});function s(){let t=react.useContext(n);if(!t)throw new Error("useAuth must be used within a AuthProvider");return t}function L(t,e){let{status:r,signIn:o}=s(),a=react.useRef(r);return a.current=r,react.useCallback(async(...c)=>{if(a.current!=="authenticated"){a.current==="unauthenticated"&&o();return}return t(...c)},[...e||[],o,t])}var i=react.createContext({});function u(){let t=react.useContext(i);if(!t)throw new Error("useWalletConnector must be used within a WalletConnectorProvider");return t}function l(){let{wallets:t}=u();return t}function K(){let t=l();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 ot({children:t,...e}){return jsxRuntime.jsx(n.Provider,{value:e,children:t})}function st({children:t,...e}){return jsxRuntime.jsx(i.Provider,{value:e,children:t})}typeof window<"u"&&(window.__LIBERFI_VERSION__=window.__LIBERFI_VERSION__||{},window.__LIBERFI_VERSION__["@liberfi.io/wallet-connector"]="0.1.18");var w="0.1.18";exports.AuthProvider=ot;exports.WalletConnectorProvider=st;exports.useAuth=s;exports.useAuthCallback=L;exports.useSwitchChain=K;exports.useWalletConnector=u;exports.useWallets=l;exports.version=w;//# sourceMappingURL=index.js.map
+'use strict';var react=require('react'),types=require('@liberfi.io/types'),utils=require('@liberfi.io/utils'),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 b(t,e){let{status:r,signIn:o}=u(),a=react.useRef(r);return a.current=r,react.useCallback(async(...c)=>{if(a.current!=="authenticated"){a.current==="unauthenticated"&&o();return}return t(...c)},[...e||[],o,t])}var i=react.createContext({});function s(){let t=react.useContext(i);if(!t)throw new Error("useWalletConnector must be used within a WalletConnectorProvider");return t}function l(){let{wallets:t}=s();return t}function J(){let t=l();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 et({children:t,...e}){return jsxRuntime.jsx(n.Provider,{value:e,children:t})}function at({children:t,...e}){return jsxRuntime.jsx(i.Provider,{value:e,children:t})}typeof window<"u"&&(window.__LIBERFI_VERSION__=window.__LIBERFI_VERSION__||{},window.__LIBERFI_VERSION__["@liberfi.io/wallet-connector"]="0.1.20");var w="0.1.20";exports.AuthProvider=et;exports.WalletConnectorProvider=at;exports.useAuth=u;exports.useAuthCallback=b;exports.useSwitchChain=J;exports.useWalletConnector=s;exports.useWallets=l;exports.version=w;//# 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/useSwitchChain.ts","../src/providers/AuthProvider.tsx","../src/providers/WalletConnectorProvider.tsx","../src/version.ts"],"names":["AuthContext","createContext","useAuth","context","useContext","useAuthCallback","callback","deps","status","signIn","statusRef","useRef","useCallback","args","WalletConnectorContext","useWalletConnector","useWallets","wallets","useSwitchChain","chain","chainToNamespace","ChainNamespace","evmWallets","w","AuthProvider","children","value","jsx","WalletConnectorProvider","version_default"],"mappings":"sJAgBO,IAAMA,CAAAA,CAAcC,mBAAAA,CACzB,EACF,CAAA,CCfO,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,CCLO,SAASE,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACG,CACH,GAAM,CAAE,MAAA,CAAAC,CAAAA,CAAQ,MAAA,CAAAC,CAAO,CAAA,CAAIP,CAAAA,EAAQ,CAI7BQ,CAAAA,CAAYC,YAAAA,CAAeH,CAAM,CAAA,CACvC,OAAAE,CAAAA,CAAU,OAAA,CAAUF,CAAAA,CAETI,kBACT,MAAA,GAAUC,CAAAA,GAA4D,CACpE,GAAIH,CAAAA,CAAU,OAAA,GAAY,eAAA,CAAiB,CAIrCA,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,CAGF,CCPO,IAAMQ,CAAAA,CACXb,mBAAAA,CAA2C,EAAiC,CAAA,CCnBvE,SAASc,CAAAA,EAAqB,CACnC,IAAMZ,CAAAA,CAAUC,gBAAAA,CAAWU,CAAsB,CAAA,CACjD,GAAI,CAACX,CAAAA,CACH,MAAM,IAAI,KAAA,CACR,kEACF,CAAA,CAEF,OAAOA,CACT,CCTO,SAASa,CAAAA,EAAa,CAC3B,GAAM,CAAE,OAAA,CAAAC,CAAQ,CAAA,CAAIF,CAAAA,EAAmB,CACvC,OAAOE,CACT,CCCO,SAASC,CAAAA,EAAiB,CAC/B,IAAMD,CAAAA,CAAUD,CAAAA,EAAW,CAE3B,OAAOJ,iBAAAA,CACL,MAAOO,CAAAA,EAAiB,CACtB,GAAIC,sBAAAA,CAAiBD,CAAK,CAAA,GAAME,oBAAAA,CAAe,MAAA,CAAQ,OAEvD,IAAMC,CAAAA,CAAaL,CAAAA,CAAQ,MAAA,CACxBM,CAAAA,EAA6B,aAAA,GAAiBA,CAAAA,EAAKA,CAAAA,CAAE,WACxD,CAAA,CACA,MAAM,OAAA,CAAQ,GAAA,CAAID,CAAAA,CAAW,GAAA,CAAKC,CAAAA,EAAMA,CAAAA,CAAE,WAAA,CAAYJ,CAAK,CAAC,CAAC,EAC/D,EACA,CAACF,CAAO,CACV,CACF,CCnBO,SAASO,EAAAA,CAAa,CAAE,QAAA,CAAAC,CAAAA,CAAU,GAAGC,CAAM,CAAA,CAAsB,CACtE,OAAOC,cAAAA,CAAC3B,CAAAA,CAAY,QAAA,CAAZ,CAAqB,KAAA,CAAO0B,CAAAA,CAAQ,QAAA,CAAAD,CAAAA,CAAS,CACvD,CCEO,SAASG,GAAwB,CACtC,QAAA,CAAAH,CAAAA,CACA,GAAGC,CACL,CAAA,CAAiC,CAC/B,OACEC,cAAAA,CAACb,CAAAA,CAAuB,QAAA,CAAvB,CAAgC,KAAA,CAAOY,CAAAA,CACrC,QAAA,CAAAD,CAAAA,CACH,CAEJ,CCXI,OAAO,MAAA,CAAW,GAAA,GACpB,MAAA,CAAO,mBAAA,CAAsB,MAAA,CAAO,mBAAA,EAAuB,EAAC,CAC5D,MAAA,CAAO,mBAAA,CAAoB,8BAA8B,CAAA,CAAI,QAAA,CAAA,KAGxDI,CAAAA,CAAQ","file":"index.js","sourcesContent":["import { createContext } from \"react\";\nimport { AuthenticatedUser } from \"../types\";\n\nexport interface AuthContextValue {\n  /** authenticated user profile */\n  user: AuthenticatedUser | null;\n  /** authentication status */\n  status: \"unauthenticated\" | \"authenticating\" | \"authenticated\";\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\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\nexport function useAuthCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  deps?: DependencyList,\n): T {\n  const { status, signIn } = useAuth();\n\n  // statusRef will be updated to the latest on each render\n  // avoid callback rebuild on status changes\n  const statusRef = useRef<string>(status);\n  statusRef.current = status;\n\n  const cb = useCallback(\n    async (...args: Parameters<T>): Promise<ReturnType<T> | undefined> => {\n      if (statusRef.current !== \"authenticated\") {\n        // Only trigger sign-in when truly unauthenticated.\n        // When \"authenticating\" (wallet detecting/connecting), just wait —\n        // calling signIn() again may conflict with the in-progress auth flow.\n        if (statusRef.current === \"unauthenticated\") {\n          signIn();\n        }\n        return;\n      }\n      return callback(...args);\n    },\n    [...(deps || []), signIn, callback],\n  );\n\n  return cb as T;\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 * use wallet connector hook\n * @returns wallet connector\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 * use wallets hook\n * @returns all wallets that can be used to take onchain actions\n */\nexport function useWallets() {\n  const { wallets } = useWalletConnector();\n  return wallets;\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 * Solana chains are skipped.\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 { AuthContext, AuthContextValue } from \"./AuthContext\";\n\nexport type AuthProviderProps = PropsWithChildren<AuthContextValue>;\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\nexport type WalletConnectorProviderProps =\n  PropsWithChildren<WalletConnectorContextValue>;\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","declare global {\n  interface Window {\n    __LIBERFI_VERSION__?: {\n      [key: string]: string;\n    };\n  }\n}\nif (typeof window !== \"undefined\") {\n  window.__LIBERFI_VERSION__ = window.__LIBERFI_VERSION__ || {};\n  window.__LIBERFI_VERSION__[\"@liberfi.io/wallet-connector\"] = \"0.1.18\";\n}\n\nexport default \"0.1.18\";\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/useSwitchChain.ts","../src/providers/AuthProvider.tsx","../src/providers/WalletConnectorProvider.tsx","../src/version.ts"],"names":["AuthContext","createContext","useAuth","context","useContext","useAuthCallback","callback","deps","status","signIn","statusRef","useRef","useCallback","args","WalletConnectorContext","useWalletConnector","useWallets","wallets","useSwitchChain","chain","chainToNamespace","ChainNamespace","evmWallets","w","AuthProvider","children","value","jsx","WalletConnectorProvider","version_default"],"mappings":"sJAgBO,IAAMA,CAAAA,CAAcC,mBAAAA,CACzB,EACF,CAAA,CCPO,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,MAAA,CAAAC,CAAO,CAAA,CAAIP,CAAAA,EAAQ,CAE7BQ,CAAAA,CAAYC,YAAAA,CAAeH,CAAM,CAAA,CACvC,OAAAE,CAAAA,CAAU,OAAA,CAAUF,CAAAA,CAEbI,kBACL,MAAA,GACKC,CAAAA,GAC6C,CAChD,GAAIH,CAAAA,CAAU,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,CAAAA,CACXb,mBAAAA,CAA2C,EAAiC,CAAA,CCfvE,SAASc,CAAAA,EAAqB,CACnC,IAAMZ,CAAAA,CAAUC,gBAAAA,CAAWU,CAAsB,CAAA,CACjD,GAAI,CAACX,CAAAA,CACH,MAAM,IAAI,KAAA,CACR,kEACF,CAAA,CAEF,OAAOA,CACT,CCVO,SAASa,CAAAA,EAAa,CAC3B,GAAM,CAAE,OAAA,CAAAC,CAAQ,CAAA,CAAIF,CAAAA,EAAmB,CACvC,OAAOE,CACT,CCGO,SAASC,CAAAA,EAAiB,CAC/B,IAAMD,CAAAA,CAAUD,CAAAA,EAAW,CAE3B,OAAOJ,iBAAAA,CACL,MAAOO,CAAAA,EAAiB,CACtB,GAAIC,sBAAAA,CAAiBD,CAAK,CAAA,GAAME,oBAAAA,CAAe,MAAA,CAAQ,OAEvD,IAAMC,CAAAA,CAAaL,CAAAA,CAAQ,MAAA,CACxBM,CAAAA,EAA6B,aAAA,GAAiBA,CAAAA,EAAKA,CAAAA,CAAE,WACxD,CAAA,CACA,MAAM,OAAA,CAAQ,GAAA,CAAID,CAAAA,CAAW,GAAA,CAAKC,CAAAA,EAAMA,CAAAA,CAAE,WAAA,CAAYJ,CAAK,CAAC,CAAC,EAC/D,EACA,CAACF,CAAO,CACV,CACF,CCfO,SAASO,EAAAA,CAAa,CAAE,QAAA,CAAAC,CAAAA,CAAU,GAAGC,CAAM,CAAA,CAAsB,CACtE,OAAOC,cAAAA,CAAC3B,CAAAA,CAAY,QAAA,CAAZ,CAAqB,KAAA,CAAO0B,CAAAA,CAAQ,QAAA,CAAAD,CAAAA,CAAS,CACvD,CCEO,SAASG,GAAwB,CACtC,QAAA,CAAAH,CAAAA,CACA,GAAGC,CACL,CAAA,CAAiC,CAC/B,OACEC,cAAAA,CAACb,CAAAA,CAAuB,QAAA,CAAvB,CAAgC,KAAA,CAAOY,CAAAA,CACrC,QAAA,CAAAD,CAAAA,CACH,CAEJ,CCpBI,OAAO,MAAA,CAAW,GAAA,GACpB,MAAA,CAAO,mBAAA,CAAsB,MAAA,CAAO,mBAAA,EAAuB,EAAC,CAC5D,MAAA,CAAO,mBAAA,CAAoB,8BAA8B,CAAA,CAAI,QAAA,CAAA,KAGxDI,CAAAA,CAAQ","file":"index.js","sourcesContent":["import { createContext } from \"react\";\nimport { AuthenticatedUser } from \"../types\";\n\nexport interface AuthContextValue {\n  /** authenticated user profile */\n  user: AuthenticatedUser | null;\n  /** authentication status */\n  status: \"unauthenticated\" | \"authenticating\" | \"authenticated\";\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 { 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 { AuthContext, AuthContextValue } from \"./AuthContext\";\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","declare global {\n  interface Window {\n    __LIBERFI_VERSION__?: {\n      [key: string]: string;\n    };\n  }\n}\nif (typeof window !== \"undefined\") {\n  window.__LIBERFI_VERSION__ = window.__LIBERFI_VERSION__ || {};\n  window.__LIBERFI_VERSION__[\"@liberfi.io/wallet-connector\"] = \"0.1.20\";\n}\n\nexport default \"0.1.20\";\n"]}

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import {createContext,useContext,useRef,useCallback}from'react';import {ChainNamespace}from'@liberfi.io/types';import {chainToNamespace}from'@liberfi.io/utils';import {jsx}from'react/jsx-runtime';var n=createContext({});function s(){let t=useContext(n);if(!t)throw new Error("useAuth must be used within a AuthProvider");return t}function L(t,e){let{status:r,signIn:o}=s(),a=useRef(r);return a.current=r,useCallback(async(...c)=>{if(a.current!=="authenticated"){a.current==="unauthenticated"&&o();return}return t(...c)},[...e||[],o,t])}var i=createContext({});function u(){let t=useContext(i);if(!t)throw new Error("useWalletConnector must be used within a WalletConnectorProvider");return t}function l(){let{wallets:t}=u();return t}function K(){let t=l();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 ot({children:t,...e}){return jsx(n.Provider,{value:e,children:t})}function st({children:t,...e}){return jsx(i.Provider,{value:e,children:t})}typeof window<"u"&&(window.__LIBERFI_VERSION__=window.__LIBERFI_VERSION__||{},window.__LIBERFI_VERSION__["@liberfi.io/wallet-connector"]="0.1.18");var w="0.1.18";export{ot as AuthProvider,st as WalletConnectorProvider,s as useAuth,L as useAuthCallback,K as useSwitchChain,u as useWalletConnector,l as useWallets,w as version};//# sourceMappingURL=index.mjs.map
+import {createContext,useContext,useRef,useCallback}from'react';import {ChainNamespace}from'@liberfi.io/types';import {chainToNamespace}from'@liberfi.io/utils';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 b(t,e){let{status:r,signIn:o}=u(),a=useRef(r);return a.current=r,useCallback(async(...c)=>{if(a.current!=="authenticated"){a.current==="unauthenticated"&&o();return}return t(...c)},[...e||[],o,t])}var i=createContext({});function s(){let t=useContext(i);if(!t)throw new Error("useWalletConnector must be used within a WalletConnectorProvider");return t}function l(){let{wallets:t}=s();return t}function J(){let t=l();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 et({children:t,...e}){return jsx(n.Provider,{value:e,children:t})}function at({children:t,...e}){return jsx(i.Provider,{value:e,children:t})}typeof window<"u"&&(window.__LIBERFI_VERSION__=window.__LIBERFI_VERSION__||{},window.__LIBERFI_VERSION__["@liberfi.io/wallet-connector"]="0.1.20");var w="0.1.20";export{et as AuthProvider,at as WalletConnectorProvider,u as useAuth,b as useAuthCallback,J as useSwitchChain,s as useWalletConnector,l as useWallets,w as version};//# 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/useSwitchChain.ts","../src/providers/AuthProvider.tsx","../src/providers/WalletConnectorProvider.tsx","../src/version.ts"],"names":["AuthContext","createContext","useAuth","context","useContext","useAuthCallback","callback","deps","status","signIn","statusRef","useRef","useCallback","args","WalletConnectorContext","useWalletConnector","useWallets","wallets","useSwitchChain","chain","chainToNamespace","ChainNamespace","evmWallets","w","AuthProvider","children","value","jsx","WalletConnectorProvider","version_default"],"mappings":"oMAgBO,IAAMA,CAAAA,CAAcC,aAAAA,CACzB,EACF,CAAA,CCfO,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,CCLO,SAASE,CAAAA,CACdC,CAAAA,CACAC,CAAAA,CACG,CACH,GAAM,CAAE,MAAA,CAAAC,CAAAA,CAAQ,MAAA,CAAAC,CAAO,CAAA,CAAIP,CAAAA,EAAQ,CAI7BQ,CAAAA,CAAYC,MAAAA,CAAeH,CAAM,CAAA,CACvC,OAAAE,CAAAA,CAAU,OAAA,CAAUF,CAAAA,CAETI,YACT,MAAA,GAAUC,CAAAA,GAA4D,CACpE,GAAIH,CAAAA,CAAU,OAAA,GAAY,eAAA,CAAiB,CAIrCA,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,CAGF,CCPO,IAAMQ,CAAAA,CACXb,aAAAA,CAA2C,EAAiC,CAAA,CCnBvE,SAASc,CAAAA,EAAqB,CACnC,IAAMZ,CAAAA,CAAUC,UAAAA,CAAWU,CAAsB,CAAA,CACjD,GAAI,CAACX,CAAAA,CACH,MAAM,IAAI,KAAA,CACR,kEACF,CAAA,CAEF,OAAOA,CACT,CCTO,SAASa,CAAAA,EAAa,CAC3B,GAAM,CAAE,OAAA,CAAAC,CAAQ,CAAA,CAAIF,CAAAA,EAAmB,CACvC,OAAOE,CACT,CCCO,SAASC,CAAAA,EAAiB,CAC/B,IAAMD,CAAAA,CAAUD,CAAAA,EAAW,CAE3B,OAAOJ,WAAAA,CACL,MAAOO,CAAAA,EAAiB,CACtB,GAAIC,gBAAAA,CAAiBD,CAAK,CAAA,GAAME,cAAAA,CAAe,MAAA,CAAQ,OAEvD,IAAMC,CAAAA,CAAaL,CAAAA,CAAQ,MAAA,CACxBM,CAAAA,EAA6B,aAAA,GAAiBA,CAAAA,EAAKA,CAAAA,CAAE,WACxD,CAAA,CACA,MAAM,OAAA,CAAQ,GAAA,CAAID,CAAAA,CAAW,GAAA,CAAKC,CAAAA,EAAMA,CAAAA,CAAE,WAAA,CAAYJ,CAAK,CAAC,CAAC,EAC/D,EACA,CAACF,CAAO,CACV,CACF,CCnBO,SAASO,EAAAA,CAAa,CAAE,QAAA,CAAAC,CAAAA,CAAU,GAAGC,CAAM,CAAA,CAAsB,CACtE,OAAOC,GAAAA,CAAC3B,CAAAA,CAAY,QAAA,CAAZ,CAAqB,KAAA,CAAO0B,CAAAA,CAAQ,QAAA,CAAAD,CAAAA,CAAS,CACvD,CCEO,SAASG,GAAwB,CACtC,QAAA,CAAAH,CAAAA,CACA,GAAGC,CACL,CAAA,CAAiC,CAC/B,OACEC,GAAAA,CAACb,CAAAA,CAAuB,QAAA,CAAvB,CAAgC,KAAA,CAAOY,CAAAA,CACrC,QAAA,CAAAD,CAAAA,CACH,CAEJ,CCXI,OAAO,MAAA,CAAW,GAAA,GACpB,MAAA,CAAO,mBAAA,CAAsB,MAAA,CAAO,mBAAA,EAAuB,EAAC,CAC5D,MAAA,CAAO,mBAAA,CAAoB,8BAA8B,CAAA,CAAI,QAAA,CAAA,KAGxDI,CAAAA,CAAQ","file":"index.mjs","sourcesContent":["import { createContext } from \"react\";\nimport { AuthenticatedUser } from \"../types\";\n\nexport interface AuthContextValue {\n  /** authenticated user profile */\n  user: AuthenticatedUser | null;\n  /** authentication status */\n  status: \"unauthenticated\" | \"authenticating\" | \"authenticated\";\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\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\nexport function useAuthCallback<T extends (...args: any[]) => any>(\n  callback: T,\n  deps?: DependencyList,\n): T {\n  const { status, signIn } = useAuth();\n\n  // statusRef will be updated to the latest on each render\n  // avoid callback rebuild on status changes\n  const statusRef = useRef<string>(status);\n  statusRef.current = status;\n\n  const cb = useCallback(\n    async (...args: Parameters<T>): Promise<ReturnType<T> | undefined> => {\n      if (statusRef.current !== \"authenticated\") {\n        // Only trigger sign-in when truly unauthenticated.\n        // When \"authenticating\" (wallet detecting/connecting), just wait —\n        // calling signIn() again may conflict with the in-progress auth flow.\n        if (statusRef.current === \"unauthenticated\") {\n          signIn();\n        }\n        return;\n      }\n      return callback(...args);\n    },\n    [...(deps || []), signIn, callback],\n  );\n\n  return cb as T;\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 * use wallet connector hook\n * @returns wallet connector\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 * use wallets hook\n * @returns all wallets that can be used to take onchain actions\n */\nexport function useWallets() {\n  const { wallets } = useWalletConnector();\n  return wallets;\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 * Solana chains are skipped.\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 { AuthContext, AuthContextValue } from \"./AuthContext\";\n\nexport type AuthProviderProps = PropsWithChildren<AuthContextValue>;\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\nexport type WalletConnectorProviderProps =\n  PropsWithChildren<WalletConnectorContextValue>;\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","declare global {\n  interface Window {\n    __LIBERFI_VERSION__?: {\n      [key: string]: string;\n    };\n  }\n}\nif (typeof window !== \"undefined\") {\n  window.__LIBERFI_VERSION__ = window.__LIBERFI_VERSION__ || {};\n  window.__LIBERFI_VERSION__[\"@liberfi.io/wallet-connector\"] = \"0.1.18\";\n}\n\nexport default \"0.1.18\";\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/useSwitchChain.ts","../src/providers/AuthProvider.tsx","../src/providers/WalletConnectorProvider.tsx","../src/version.ts"],"names":["AuthContext","createContext","useAuth","context","useContext","useAuthCallback","callback","deps","status","signIn","statusRef","useRef","useCallback","args","WalletConnectorContext","useWalletConnector","useWallets","wallets","useSwitchChain","chain","chainToNamespace","ChainNamespace","evmWallets","w","AuthProvider","children","value","jsx","WalletConnectorProvider","version_default"],"mappings":"oMAgBO,IAAMA,CAAAA,CAAcC,aAAAA,CACzB,EACF,CAAA,CCPO,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,MAAA,CAAAC,CAAO,CAAA,CAAIP,CAAAA,EAAQ,CAE7BQ,CAAAA,CAAYC,MAAAA,CAAeH,CAAM,CAAA,CACvC,OAAAE,CAAAA,CAAU,OAAA,CAAUF,CAAAA,CAEbI,YACL,MAAA,GACKC,CAAAA,GAC6C,CAChD,GAAIH,CAAAA,CAAU,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,CAAAA,CACXb,aAAAA,CAA2C,EAAiC,CAAA,CCfvE,SAASc,CAAAA,EAAqB,CACnC,IAAMZ,CAAAA,CAAUC,UAAAA,CAAWU,CAAsB,CAAA,CACjD,GAAI,CAACX,CAAAA,CACH,MAAM,IAAI,KAAA,CACR,kEACF,CAAA,CAEF,OAAOA,CACT,CCVO,SAASa,CAAAA,EAAa,CAC3B,GAAM,CAAE,OAAA,CAAAC,CAAQ,CAAA,CAAIF,CAAAA,EAAmB,CACvC,OAAOE,CACT,CCGO,SAASC,CAAAA,EAAiB,CAC/B,IAAMD,CAAAA,CAAUD,CAAAA,EAAW,CAE3B,OAAOJ,WAAAA,CACL,MAAOO,CAAAA,EAAiB,CACtB,GAAIC,gBAAAA,CAAiBD,CAAK,CAAA,GAAME,cAAAA,CAAe,MAAA,CAAQ,OAEvD,IAAMC,CAAAA,CAAaL,CAAAA,CAAQ,MAAA,CACxBM,CAAAA,EAA6B,aAAA,GAAiBA,CAAAA,EAAKA,CAAAA,CAAE,WACxD,CAAA,CACA,MAAM,OAAA,CAAQ,GAAA,CAAID,CAAAA,CAAW,GAAA,CAAKC,CAAAA,EAAMA,CAAAA,CAAE,WAAA,CAAYJ,CAAK,CAAC,CAAC,EAC/D,EACA,CAACF,CAAO,CACV,CACF,CCfO,SAASO,EAAAA,CAAa,CAAE,QAAA,CAAAC,CAAAA,CAAU,GAAGC,CAAM,CAAA,CAAsB,CACtE,OAAOC,GAAAA,CAAC3B,CAAAA,CAAY,QAAA,CAAZ,CAAqB,KAAA,CAAO0B,CAAAA,CAAQ,QAAA,CAAAD,CAAAA,CAAS,CACvD,CCEO,SAASG,GAAwB,CACtC,QAAA,CAAAH,CAAAA,CACA,GAAGC,CACL,CAAA,CAAiC,CAC/B,OACEC,GAAAA,CAACb,CAAAA,CAAuB,QAAA,CAAvB,CAAgC,KAAA,CAAOY,CAAAA,CACrC,QAAA,CAAAD,CAAAA,CACH,CAEJ,CCpBI,OAAO,MAAA,CAAW,GAAA,GACpB,MAAA,CAAO,mBAAA,CAAsB,MAAA,CAAO,mBAAA,EAAuB,EAAC,CAC5D,MAAA,CAAO,mBAAA,CAAoB,8BAA8B,CAAA,CAAI,QAAA,CAAA,KAGxDI,CAAAA,CAAQ","file":"index.mjs","sourcesContent":["import { createContext } from \"react\";\nimport { AuthenticatedUser } from \"../types\";\n\nexport interface AuthContextValue {\n  /** authenticated user profile */\n  user: AuthenticatedUser | null;\n  /** authentication status */\n  status: \"unauthenticated\" | \"authenticating\" | \"authenticated\";\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 { 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 { AuthContext, AuthContextValue } from \"./AuthContext\";\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","declare global {\n  interface Window {\n    __LIBERFI_VERSION__?: {\n      [key: string]: string;\n    };\n  }\n}\nif (typeof window !== \"undefined\") {\n  window.__LIBERFI_VERSION__ = window.__LIBERFI_VERSION__ || {};\n  window.__LIBERFI_VERSION__[\"@liberfi.io/wallet-connector\"] = \"0.1.20\";\n}\n\nexport default \"0.1.20\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liberfi.io/wallet-connector",
-  "version": "0.1.18",
+  "version": "0.1.20",
   "description": "Base Wallet Connector for Liberfi React SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -14,18 +14,24 @@
     "access": "public"
   },
   "dependencies": {
-    "@liberfi.io/types": "0.1.27",
-    "@liberfi.io/utils": "0.1.24"
+    "@liberfi.io/types": "0.1.29",
+    "@liberfi.io/utils": "0.1.26"
   },
   "devDependencies": {
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/jest": "^29.5.3",
     "@types/react": "^19.1.13",
     "@types/react-dom": "^19.1.9",
+    "jest": "^29.6.1",
+    "jest-environment-jsdom": "^29.7.0",
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
     "rimraf": "^5.0.5",
+    "ts-jest": "^29.4.6",
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
-    "tsconfig": "0.1.15"
+    "tsconfig": "0.1.17"
   },
   "peerDependencies": {
     "react": ">=18",
@@ -33,6 +39,6 @@
   },
   "scripts": {
     "build": "rimraf -rf dist && tsup",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "jest"
   }
 }