@bwalletx/connect 0.3.0 → 0.4.1

package/dist/react.d.ts

@@ -1,7 +1,18 @@
-import * as react from 'react';
-import { CSSProperties } from 'react';
+import { ReactNode, ReactElement, CSSProperties } from 'react';
+import { WalletInterface } from '@bsv/sdk';
+import { C as ConnectedWallet, W as WalletOption, P as PayRequest, a as PayResult, B as BuyTokenRequest, b as PayOptions } from './wallets-VOKIKBbO.js';
+export { H as HandCashAdapterOptions, c as PaymentError, d as brc100Option, e as discoverWallets, h as handcashAdapter, p as pairingOption } from './wallets-VOKIKBbO.js';
 import { SigninSize, SigninTheme, SigninLabel, SigninBrand } from './element.js';
 
+/**
+ * React wrapper for <bwalletx-signin>. React is an optional peer dependency; the button itself is
+ * the web component, so markup and behaviour are identical everywhere.
+ *
+ *   import { BwalletxSignin } from '@bwalletx/connect/react';
+ *   <BwalletxSignin challengeUrl="/auth/bwalletx/challenge" verifyUrl="/auth/bwalletx/verify"
+ *     onSignedIn={(d) => router.refresh()} />
+ */
+
 interface SignedInDetail {
     identityKey: string;
     method: string;
@@ -41,30 +52,65 @@ interface BwalletxSigninProps {
     onNotFound?: () => void;
     onError?: (error: unknown) => void;
 }
-declare function BwalletxSignin(props: BwalletxSigninProps): react.ReactElement<{
-    ref: react.RefObject<HTMLElement | null>;
-    id: string | undefined;
-    class: string | undefined;
-    style: CSSProperties | undefined;
-    size: SigninSize | undefined;
-    theme: SigninTheme | undefined;
-    label: SigninLabel | undefined;
-    brand: SigninBrand | undefined;
-    subtitle: string | undefined;
-    'full-width': string | undefined;
-    loading: string | undefined;
-    disabled: string | undefined;
-    'challenge-url': string | undefined;
-    'verify-url': string | undefined;
-    'get-url': string | undefined;
-    'web-url': string | undefined;
-    href: string | undefined;
-    'authorize-url': string | undefined;
-    'client-id': string | undefined;
-    'redirect-uri': string | undefined;
-    scope: string | undefined;
-    'discover-ms': number | undefined;
-    'aria-label': string | undefined;
-}, string | react.JSXElementConstructor<any>>;
+declare function BwalletxSignin(props: BwalletxSigninProps): ReactElement;
+
+type BwalletXStatus = 'idle' | 'restoring' | 'connecting' | 'connected' | 'error';
+interface BwalletXState {
+    status: BwalletXStatus;
+    identityKey: string | null;
+    handle: string | null;
+    paymail: string | null;
+    /** The BRC-100 wallet. null until connect() (a session restored from the cookie has no wallet yet). */
+    wallet: WalletInterface | null;
+    /** Which option connected (e.g. 'com.bwalletx.extension', 'bwalletx-pairing', 'handcash'). */
+    walletId: string | null;
+    /** True while the transitional HandCash adapter is in use. */
+    transitional: boolean;
+    /** The server session (verifyUrl/sessionUrl) is in place. */
+    signedIn: boolean;
+    error: Error | null;
+}
+interface BwalletXContextValue extends BwalletXState {
+    /** Find wallets, show the picker if there is a choice, connect, and sign in if verifyUrl is set. */
+    connect(opts?: {
+        walletId?: string;
+    }): Promise<ConnectedWallet | null>;
+    disconnect(): Promise<void>;
+    /** The wallets found on the last connect() (or listWallets()). */
+    wallets: WalletOption[];
+    listWallets(): Promise<WalletOption[]>;
+    pay(req: PayRequest): Promise<PayResult>;
+    tip(req: PayRequest): Promise<PayResult>;
+    buyToken(req: BuyTokenRequest): Promise<PayResult>;
+}
+interface BwalletXProviderProps {
+    children?: ReactNode;
+    /** POST { identityKey } → challenge. With verifyUrl, connect() also signs in. */
+    challengeUrl?: string;
+    /** POST { identityKey, nonce, signature } → { identityKey, handle?, paymail? } and sets the cookie. */
+    verifyUrl?: string;
+    /** POST to clear the cookie on disconnect(). */
+    logoutUrl?: string;
+    /** GET → { identityKey, handle?, paymail? } to restore a session on load. */
+    sessionUrl?: string;
+    /** Offer phone pairing with the built-in QR modal. Default true. */
+    pairing?: boolean;
+    /** Show the built-in picker when more than one wallet is available. Default true. */
+    picker?: boolean;
+    /** Extra options, e.g. [handcashAdapter({ login })]. */
+    extraWallets?: WalletOption[];
+    /** Probe desktop wallets on localhost. Default false. */
+    probeLocal?: boolean;
+    discoverMs?: number;
+    payOptions?: PayOptions;
+    onError?: (e: Error) => void;
+}
+/** Holds the connected wallet and session for the tree. Renders nothing itself; SSR-safe. */
+declare function BwalletXProvider(p: BwalletXProviderProps): ReactElement;
+/** The wallet + session state. Must be inside <BwalletXProvider>. */
+declare function useBwalletX(): BwalletXContextValue;
+
+/** Alias with the casing used by <BwalletxSignin>. */
+declare const BwalletxProvider: typeof BwalletXProvider;
 
-export { BwalletxSignin, type BwalletxSigninProps, type SignedInDetail, BwalletxSignin as default };
+export { BuyTokenRequest, type BwalletXContextValue, BwalletXProvider, type BwalletXProviderProps, type BwalletXState, type BwalletXStatus, BwalletxProvider, BwalletxSignin, type BwalletxSigninProps, ConnectedWallet, PayOptions, PayRequest, PayResult, type SignedInDetail, WalletOption, BwalletxSignin as default, useBwalletX };

package/dist/react.js

@@ -1,9 +1,32 @@
 import {
-  defineBwalletxSignin
+  PaymentError,
+  brc100Option,
+  buyToken,
+  discoverWallets,
+  handcashAdapter,
+  pairingModal,
+  pairingOption,
+  pay,
+  pickWallet,
+  tip
+} from "./chunk-FUQ46RJV.js";
+import {
+  clearPairing,
+  defineBwalletxSignin,
+  signInWithBwalletX
 } from "./chunk-NNMUSWPG.js";
 
 // src/react.ts
-import { createElement, useEffect, useRef } from "react";
+import {
+  createContext,
+  createElement,
+  useCallback,
+  useContext,
+  useEffect,
+  useMemo,
+  useRef,
+  useState
+} from "react";
 function BwalletxSignin(props) {
   const ref = useRef(null);
   const cb = useRef(props);
@@ -52,8 +75,157 @@ function BwalletxSignin(props) {
   });
 }
 var react_default = BwalletxSignin;
+var empty = {
+  status: "idle",
+  identityKey: null,
+  handle: null,
+  paymail: null,
+  wallet: null,
+  walletId: null,
+  transitional: false,
+  signedIn: false,
+  error: null
+};
+var Ctx = createContext(null);
+async function postJson(url, body) {
+  const r = await fetch(url, { method: "POST", credentials: "same-origin", headers: { "content-type": "application/json" }, body: JSON.stringify(body) });
+  const j = await r.json().catch(() => ({}));
+  if (!r.ok) throw Object.assign(new Error(String(j.error ?? `${url} answered ${r.status}`)), { status: r.status, code: j.code });
+  return j;
+}
+function BwalletXProvider(p) {
+  const [state, setState] = useState(empty);
+  const [wallets, setWallets] = useState([]);
+  const props = useRef(p);
+  props.current = p;
+  const payer = useRef(null);
+  const fail = useCallback((e) => {
+    const err = e instanceof Error ? e : new Error(String(e));
+    setState((s) => ({ ...s, status: "error", error: err }));
+    props.current.onError?.(err);
+    return err;
+  }, []);
+  useEffect(() => {
+    const url = p.sessionUrl;
+    if (!url) return;
+    let live = true;
+    setState((s) => ({ ...s, status: "restoring" }));
+    fetch(url, { credentials: "same-origin" }).then((r) => r.json()).then((j) => {
+      if (!live) return;
+      setState(
+        (s) => j.identityKey ? { ...s, status: "connected", identityKey: j.identityKey, handle: j.handle ?? null, paymail: j.paymail ?? null, signedIn: true } : { ...s, status: s.status === "restoring" ? "idle" : s.status }
+      );
+    }).catch(() => live && setState((s) => ({ ...s, status: s.status === "restoring" ? "idle" : s.status })));
+    return () => {
+      live = false;
+    };
+  }, [p.sessionUrl]);
+  const listWallets = useCallback(async () => {
+    const c = props.current;
+    const list = await discoverWallets({
+      ms: c.discoverMs,
+      probeLocal: c.probeLocal,
+      extra: c.extraWallets,
+      pairing: c.pairing === false ? void 0 : () => pairingModal()
+    });
+    setWallets(list);
+    return list;
+  }, []);
+  const connect = useCallback(
+    async (opts = {}) => {
+      const c = props.current;
+      setState((s) => ({ ...s, status: "connecting", error: null }));
+      try {
+        const list = await listWallets();
+        let choice = opts.walletId ? list.find((w) => w.id === opts.walletId) : void 0;
+        if (!choice) {
+          const direct = list.filter((w) => w.kind !== "pairing");
+          choice = c.picker !== false && list.length > 1 ? await pickWallet(list) : direct[0] ?? list[0] ?? null;
+        }
+        if (!choice) {
+          if (!list.length) throw Object.assign(new Error("No wallet found. Get bWalletX at bwalletx.com."), { code: "NOT_FOUND" });
+          setState((s) => ({ ...s, status: s.identityKey ? "connected" : "idle" }));
+          return null;
+        }
+        const cw = await choice.connect();
+        let { handle = null, paymail = null } = cw;
+        let signedIn = false;
+        if (cw.wallet && c.challengeUrl && c.verifyUrl) {
+          const r = await signInWithBwalletX({
+            wallet: cw.wallet,
+            challenge: (identityKey) => postJson(c.challengeUrl, { identityKey })
+          });
+          const v = await postJson(c.verifyUrl, { identityKey: r.identityKey, nonce: r.nonce, signature: r.signature });
+          handle = v.handle ?? handle;
+          paymail = v.paymail ?? paymail;
+          signedIn = true;
+        }
+        payer.current = cw.payer;
+        setState({
+          status: "connected",
+          identityKey: cw.identityKey,
+          handle,
+          paymail,
+          wallet: cw.wallet,
+          walletId: cw.optionId,
+          transitional: !!cw.transitional,
+          signedIn,
+          error: null
+        });
+        return cw;
+      } catch (e) {
+        if (e?.message === "cancelled") {
+          setState((s) => ({ ...s, status: s.identityKey ? "connected" : "idle" }));
+          return null;
+        }
+        throw fail(e);
+      }
+    },
+    [fail, listWallets]
+  );
+  const disconnect = useCallback(async () => {
+    const c = props.current;
+    if (c.logoutUrl) await postJson(c.logoutUrl, {}).catch(() => {
+    });
+    if (state.walletId === "bwalletx-pairing") await clearPairing();
+    payer.current = null;
+    setState(empty);
+  }, [state.walletId]);
+  const need = () => {
+    if (!payer.current) throw new PaymentError("NOT_SUPPORTED", "Connect a wallet first (connect()).");
+    return payer.current;
+  };
+  const value = useMemo(
+    () => ({
+      ...state,
+      wallets,
+      connect,
+      disconnect,
+      listWallets,
+      pay: (req) => pay(need(), req, props.current.payOptions),
+      tip: (req) => tip(need(), req, props.current.payOptions),
+      buyToken: (req) => buyToken(need(), req)
+    }),
+    [state, wallets, connect, disconnect, listWallets]
+  );
+  return createElement(Ctx.Provider, { value }, p.children);
+}
+function useBwalletX() {
+  const v = useContext(Ctx);
+  if (!v) throw new Error("useBwalletX() must be used inside <BwalletXProvider>");
+  return v;
+}
+var BwalletxProvider = BwalletXProvider;
 export {
+  BwalletXProvider,
+  BwalletxProvider,
   BwalletxSignin,
-  react_default as default
+  PaymentError,
+  brc100Option,
+  react_default as default,
+  discoverWallets,
+  handcashAdapter,
+  pairingOption,
+  useBwalletX
 };
 //# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React wrapper for <bwalletx-signin>. React is an optional peer dependency; the button itself is\n * the web component, so markup and behaviour are identical everywhere.\n *\n *   import { BwalletxSignin } from '@bwalletx/connect/react';\n *   <BwalletxSignin challengeUrl=\"/auth/bwalletx/challenge\" verifyUrl=\"/auth/bwalletx/verify\"\n *     onSignedIn={(d) => router.refresh()} />\n */\nimport { createElement, useEffect, useRef, type CSSProperties } from 'react';\nimport { defineBwalletxSignin, type SigninBrand, type SigninLabel, type SigninSize, type SigninTheme } from './element.js';\n\nexport interface SignedInDetail {\n  identityKey: string;\n  method: string;\n  nonce: string;\n  signature: number[];\n  response: unknown;\n}\n\nexport interface BwalletxSigninProps {\n  size?: SigninSize;\n  theme?: SigninTheme;\n  label?: SigninLabel;\n  brand?: SigninBrand;\n  /** true/undefined = default, false = hidden, string = custom text. */\n  subtitle?: boolean | string;\n  fullWidth?: boolean;\n  loading?: boolean;\n  disabled?: boolean;\n  challengeUrl?: string;\n  verifyUrl?: string;\n  getUrl?: string;\n  webUrl?: string;\n  href?: string;\n  authorizeUrl?: string;\n  clientId?: string;\n  redirectUri?: string;\n  scope?: string;\n  discoverMs?: number;\n  'aria-label'?: string;\n  className?: string;\n  style?: CSSProperties;\n  id?: string;\n  /** Every click. Call e.preventDefault() to skip the built-in flow. */\n  onClick?: (e: CustomEvent<{ element: HTMLElement }>) => void;\n  onSignedIn?: (d: SignedInDetail) => void;\n  onNotFound?: () => void;\n  onError?: (error: unknown) => void;\n}\n\nexport function BwalletxSignin(props: BwalletxSigninProps) {\n  const ref = useRef<HTMLElement>(null);\n  const cb = useRef(props);\n  cb.current = props;\n\n  useEffect(() => {\n    defineBwalletxSignin();\n    const el = ref.current;\n    if (!el) return;\n    const on: [string, EventListener][] = [\n      ['bwalletx-signin', (e) => cb.current.onClick?.(e as CustomEvent<{ element: HTMLElement }>)],\n      ['bwalletx-signed-in', (e) => cb.current.onSignedIn?.((e as CustomEvent<SignedInDetail>).detail)],\n      ['bwalletx-not-found', () => cb.current.onNotFound?.()],\n      ['bwalletx-error', (e) => cb.current.onError?.((e as CustomEvent<{ error: unknown }>).detail.error)],\n    ];\n    for (const [t, f] of on) el.addEventListener(t, f);\n    return () => { for (const [t, f] of on) el.removeEventListener(t, f); };\n  }, []);\n\n  const p = props;\n  const flag = (v: boolean | undefined) => (v ? '' : undefined);\n  return createElement('bwalletx-signin', {\n    ref,\n    id: p.id,\n    class: p.className,\n    style: p.style,\n    size: p.size,\n    theme: p.theme,\n    label: p.label,\n    brand: p.brand,\n    subtitle: p.subtitle === false ? 'off' : typeof p.subtitle === 'string' ? p.subtitle : undefined,\n    'full-width': flag(p.fullWidth),\n    loading: flag(p.loading),\n    disabled: flag(p.disabled),\n    'challenge-url': p.challengeUrl,\n    'verify-url': p.verifyUrl,\n    'get-url': p.getUrl,\n    'web-url': p.webUrl,\n    href: p.href,\n    'authorize-url': p.authorizeUrl,\n    'client-id': p.clientId,\n    'redirect-uri': p.redirectUri,\n    scope: p.scope,\n    'discover-ms': p.discoverMs,\n    'aria-label': p['aria-label'],\n  });\n}\n\nexport default BwalletxSignin;\n"],"mappings":";;;;;AAQA,SAAS,eAAe,WAAW,cAAkC;AA0C9D,SAAS,eAAe,OAA4B;AACzD,QAAM,MAAM,OAAoB,IAAI;AACpC,QAAM,KAAK,OAAO,KAAK;AACvB,KAAG,UAAU;AAEb,YAAU,MAAM;AACd,yBAAqB;AACrB,UAAM,KAAK,IAAI;AACf,QAAI,CAAC,GAAI;AACT,UAAM,KAAgC;AAAA,MACpC,CAAC,mBAAmB,CAAC,MAAM,GAAG,QAAQ,UAAU,CAA0C,CAAC;AAAA,MAC3F,CAAC,sBAAsB,CAAC,MAAM,GAAG,QAAQ,aAAc,EAAkC,MAAM,CAAC;AAAA,MAChG,CAAC,sBAAsB,MAAM,GAAG,QAAQ,aAAa,CAAC;AAAA,MACtD,CAAC,kBAAkB,CAAC,MAAM,GAAG,QAAQ,UAAW,EAAsC,OAAO,KAAK,CAAC;AAAA,IACrG;AACA,eAAW,CAAC,GAAG,CAAC,KAAK,GAAI,IAAG,iBAAiB,GAAG,CAAC;AACjD,WAAO,MAAM;AAAE,iBAAW,CAAC,GAAG,CAAC,KAAK,GAAI,IAAG,oBAAoB,GAAG,CAAC;AAAA,IAAG;AAAA,EACxE,GAAG,CAAC,CAAC;AAEL,QAAM,IAAI;AACV,QAAM,OAAO,CAAC,MAA4B,IAAI,KAAK;AACnD,SAAO,cAAc,mBAAmB;AAAA,IACtC;AAAA,IACA,IAAI,EAAE;AAAA,IACN,OAAO,EAAE;AAAA,IACT,OAAO,EAAE;AAAA,IACT,MAAM,EAAE;AAAA,IACR,OAAO,EAAE;AAAA,IACT,OAAO,EAAE;AAAA,IACT,OAAO,EAAE;AAAA,IACT,UAAU,EAAE,aAAa,QAAQ,QAAQ,OAAO,EAAE,aAAa,WAAW,EAAE,WAAW;AAAA,IACvF,cAAc,KAAK,EAAE,SAAS;AAAA,IAC9B,SAAS,KAAK,EAAE,OAAO;AAAA,IACvB,UAAU,KAAK,EAAE,QAAQ;AAAA,IACzB,iBAAiB,EAAE;AAAA,IACnB,cAAc,EAAE;AAAA,IAChB,WAAW,EAAE;AAAA,IACb,WAAW,EAAE;AAAA,IACb,MAAM,EAAE;AAAA,IACR,iBAAiB,EAAE;AAAA,IACnB,aAAa,EAAE;AAAA,IACf,gBAAgB,EAAE;AAAA,IAClB,OAAO,EAAE;AAAA,IACT,eAAe,EAAE;AAAA,IACjB,cAAc,EAAE,YAAY;AAAA,EAC9B,CAAC;AACH;AAEA,IAAO,gBAAQ;","names":[]}
+{"version":3,"sources":["../src/react.ts"],"sourcesContent":["/**\n * React wrapper for <bwalletx-signin>. React is an optional peer dependency; the button itself is\n * the web component, so markup and behaviour are identical everywhere.\n *\n *   import { BwalletxSignin } from '@bwalletx/connect/react';\n *   <BwalletxSignin challengeUrl=\"/auth/bwalletx/challenge\" verifyUrl=\"/auth/bwalletx/verify\"\n *     onSignedIn={(d) => router.refresh()} />\n */\nimport {\n  createContext,\n  createElement,\n  useCallback,\n  useContext,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type CSSProperties,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\nimport type { WalletInterface } from '@bsv/sdk';\nimport { clearPairing } from './pair.js';\nimport { signInWithBwalletX, type Challenge } from './signin.js';\nimport { pairingModal } from './modal.js';\nimport { pickWallet } from './modal.js';\nimport { discoverWallets, type ConnectedWallet, type WalletOption } from './wallets.js';\nimport { PaymentError, buyToken, pay, tip, type BuyTokenRequest, type PayOptions, type PayRequest, type PayResult } from './pay.js';\nimport { defineBwalletxSignin, type SigninBrand, type SigninLabel, type SigninSize, type SigninTheme } from './element.js';\n\nexport interface SignedInDetail {\n  identityKey: string;\n  method: string;\n  nonce: string;\n  signature: number[];\n  response: unknown;\n}\n\nexport interface BwalletxSigninProps {\n  size?: SigninSize;\n  theme?: SigninTheme;\n  label?: SigninLabel;\n  brand?: SigninBrand;\n  /** true/undefined = default, false = hidden, string = custom text. */\n  subtitle?: boolean | string;\n  fullWidth?: boolean;\n  loading?: boolean;\n  disabled?: boolean;\n  challengeUrl?: string;\n  verifyUrl?: string;\n  getUrl?: string;\n  webUrl?: string;\n  href?: string;\n  authorizeUrl?: string;\n  clientId?: string;\n  redirectUri?: string;\n  scope?: string;\n  discoverMs?: number;\n  'aria-label'?: string;\n  className?: string;\n  style?: CSSProperties;\n  id?: string;\n  /** Every click. Call e.preventDefault() to skip the built-in flow. */\n  onClick?: (e: CustomEvent<{ element: HTMLElement }>) => void;\n  onSignedIn?: (d: SignedInDetail) => void;\n  onNotFound?: () => void;\n  onError?: (error: unknown) => void;\n}\n\nexport function BwalletxSignin(props: BwalletxSigninProps): ReactElement {\n  const ref = useRef<HTMLElement>(null);\n  const cb = useRef(props);\n  cb.current = props;\n\n  useEffect(() => {\n    defineBwalletxSignin();\n    const el = ref.current;\n    if (!el) return;\n    const on: [string, EventListener][] = [\n      ['bwalletx-signin', (e) => cb.current.onClick?.(e as CustomEvent<{ element: HTMLElement }>)],\n      ['bwalletx-signed-in', (e) => cb.current.onSignedIn?.((e as CustomEvent<SignedInDetail>).detail)],\n      ['bwalletx-not-found', () => cb.current.onNotFound?.()],\n      ['bwalletx-error', (e) => cb.current.onError?.((e as CustomEvent<{ error: unknown }>).detail.error)],\n    ];\n    for (const [t, f] of on) el.addEventListener(t, f);\n    return () => { for (const [t, f] of on) el.removeEventListener(t, f); };\n  }, []);\n\n  const p = props;\n  const flag = (v: boolean | undefined) => (v ? '' : undefined);\n  return createElement('bwalletx-signin', {\n    ref,\n    id: p.id,\n    class: p.className,\n    style: p.style,\n    size: p.size,\n    theme: p.theme,\n    label: p.label,\n    brand: p.brand,\n    subtitle: p.subtitle === false ? 'off' : typeof p.subtitle === 'string' ? p.subtitle : undefined,\n    'full-width': flag(p.fullWidth),\n    loading: flag(p.loading),\n    disabled: flag(p.disabled),\n    'challenge-url': p.challengeUrl,\n    'verify-url': p.verifyUrl,\n    'get-url': p.getUrl,\n    'web-url': p.webUrl,\n    href: p.href,\n    'authorize-url': p.authorizeUrl,\n    'client-id': p.clientId,\n    'redirect-uri': p.redirectUri,\n    scope: p.scope,\n    'discover-ms': p.discoverMs,\n    'aria-label': p['aria-label'],\n  });\n}\n\nexport default BwalletxSignin;\n\nexport type BwalletXStatus = 'idle' | 'restoring' | 'connecting' | 'connected' | 'error';\n\nexport interface BwalletXState {\n  status: BwalletXStatus;\n  identityKey: string | null;\n  handle: string | null;\n  paymail: string | null;\n  /** The BRC-100 wallet. null until connect() (a session restored from the cookie has no wallet yet). */\n  wallet: WalletInterface | null;\n  /** Which option connected (e.g. 'com.bwalletx.extension', 'bwalletx-pairing', 'handcash'). */\n  walletId: string | null;\n  /** True while the transitional HandCash adapter is in use. */\n  transitional: boolean;\n  /** The server session (verifyUrl/sessionUrl) is in place. */\n  signedIn: boolean;\n  error: Error | null;\n}\n\nexport interface BwalletXContextValue extends BwalletXState {\n  /** Find wallets, show the picker if there is a choice, connect, and sign in if verifyUrl is set. */\n  connect(opts?: { walletId?: string }): Promise<ConnectedWallet | null>;\n  disconnect(): Promise<void>;\n  /** The wallets found on the last connect() (or listWallets()). */\n  wallets: WalletOption[];\n  listWallets(): Promise<WalletOption[]>;\n  pay(req: PayRequest): Promise<PayResult>;\n  tip(req: PayRequest): Promise<PayResult>;\n  buyToken(req: BuyTokenRequest): Promise<PayResult>;\n}\n\nexport interface BwalletXProviderProps {\n  children?: ReactNode;\n  /** POST { identityKey } → challenge. With verifyUrl, connect() also signs in. */\n  challengeUrl?: string;\n  /** POST { identityKey, nonce, signature } → { identityKey, handle?, paymail? } and sets the cookie. */\n  verifyUrl?: string;\n  /** POST to clear the cookie on disconnect(). */\n  logoutUrl?: string;\n  /** GET → { identityKey, handle?, paymail? } to restore a session on load. */\n  sessionUrl?: string;\n  /** Offer phone pairing with the built-in QR modal. Default true. */\n  pairing?: boolean;\n  /** Show the built-in picker when more than one wallet is available. Default true. */\n  picker?: boolean;\n  /** Extra options, e.g. [handcashAdapter({ login })]. */\n  extraWallets?: WalletOption[];\n  /** Probe desktop wallets on localhost. Default false. */\n  probeLocal?: boolean;\n  discoverMs?: number;\n  payOptions?: PayOptions;\n  onError?: (e: Error) => void;\n}\n\nconst empty: BwalletXState = {\n  status: 'idle', identityKey: null, handle: null, paymail: null, wallet: null, walletId: null, transitional: false, signedIn: false, error: null,\n};\n\nconst Ctx = createContext<BwalletXContextValue | null>(null);\n\nasync function postJson(url: string, body: unknown): Promise<Record<string, unknown>> {\n  const r = await fetch(url, { method: 'POST', credentials: 'same-origin', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body) });\n  const j = (await r.json().catch(() => ({}))) as Record<string, unknown>;\n  if (!r.ok) throw Object.assign(new Error(String(j.error ?? `${url} answered ${r.status}`)), { status: r.status, code: j.code });\n  return j;\n}\n\n/** Holds the connected wallet and session for the tree. Renders nothing itself; SSR-safe. */\nexport function BwalletXProvider(p: BwalletXProviderProps): ReactElement {\n  const [state, setState] = useState<BwalletXState>(empty);\n  const [wallets, setWallets] = useState<WalletOption[]>([]);\n  const props = useRef(p);\n  props.current = p;\n  const payer = useRef<ConnectedWallet['payer']>(null);\n\n  const fail = useCallback((e: unknown) => {\n    const err = e instanceof Error ? e : new Error(String(e));\n    setState((s) => ({ ...s, status: 'error', error: err }));\n    props.current.onError?.(err);\n    return err;\n  }, []);\n\n  useEffect(() => {\n    const url = p.sessionUrl;\n    if (!url) return;\n    let live = true;\n    setState((s) => ({ ...s, status: 'restoring' }));\n    fetch(url, { credentials: 'same-origin' })\n      .then((r) => r.json())\n      .then((j: { identityKey?: string | null; handle?: string; paymail?: string }) => {\n        if (!live) return;\n        setState((s) =>\n          j.identityKey\n            ? { ...s, status: 'connected', identityKey: j.identityKey, handle: j.handle ?? null, paymail: j.paymail ?? null, signedIn: true }\n            : { ...s, status: s.status === 'restoring' ? 'idle' : s.status },\n        );\n      })\n      .catch(() => live && setState((s) => ({ ...s, status: s.status === 'restoring' ? 'idle' : s.status })));\n    return () => {\n      live = false;\n    };\n  }, [p.sessionUrl]);\n\n  const listWallets = useCallback(async () => {\n    const c = props.current;\n    const list = await discoverWallets({\n      ms: c.discoverMs,\n      probeLocal: c.probeLocal,\n      extra: c.extraWallets,\n      pairing: c.pairing === false ? undefined : () => pairingModal(),\n    });\n    setWallets(list);\n    return list;\n  }, []);\n\n  const connect = useCallback(\n    async (opts: { walletId?: string } = {}) => {\n      const c = props.current;\n      setState((s) => ({ ...s, status: 'connecting', error: null }));\n      try {\n        const list = await listWallets();\n        let choice: WalletOption | null | undefined = opts.walletId ? list.find((w) => w.id === opts.walletId) : undefined;\n        if (!choice) {\n          const direct = list.filter((w) => w.kind !== 'pairing');\n          choice = c.picker !== false && list.length > 1 ? await pickWallet(list) : (direct[0] ?? list[0] ?? null);\n        }\n        if (!choice) {\n          if (!list.length) throw Object.assign(new Error('No wallet found. Get bWalletX at bwalletx.com.'), { code: 'NOT_FOUND' });\n          setState((s) => ({ ...s, status: s.identityKey ? 'connected' : 'idle' }));\n          return null;\n        }\n        const cw = await choice.connect();\n        let { handle = null, paymail = null } = cw as { handle?: string | null; paymail?: string | null };\n        let signedIn = false;\n        if (cw.wallet && c.challengeUrl && c.verifyUrl) {\n          const r = await signInWithBwalletX({\n            wallet: cw.wallet,\n            challenge: (identityKey) => postJson(c.challengeUrl!, { identityKey }) as unknown as Promise<Challenge>,\n          });\n          const v = await postJson(c.verifyUrl, { identityKey: r.identityKey, nonce: r.nonce, signature: r.signature });\n          handle = (v.handle as string | undefined) ?? handle;\n          paymail = (v.paymail as string | undefined) ?? paymail;\n          signedIn = true;\n        }\n        payer.current = cw.payer;\n        setState({\n          status: 'connected',\n          identityKey: cw.identityKey,\n          handle,\n          paymail,\n          wallet: cw.wallet,\n          walletId: cw.optionId,\n          transitional: !!cw.transitional,\n          signedIn,\n          error: null,\n        });\n        return cw;\n      } catch (e) {\n        if ((e as Error)?.message === 'cancelled') {\n          setState((s) => ({ ...s, status: s.identityKey ? 'connected' : 'idle' }));\n          return null;\n        }\n        throw fail(e);\n      }\n    },\n    [fail, listWallets],\n  );\n\n  const disconnect = useCallback(async () => {\n    const c = props.current;\n    if (c.logoutUrl) await postJson(c.logoutUrl, {}).catch(() => {});\n    if (state.walletId === 'bwalletx-pairing') await clearPairing();\n    payer.current = null;\n    setState(empty);\n  }, [state.walletId]);\n\n  const need = () => {\n    if (!payer.current) throw new PaymentError('NOT_SUPPORTED', 'Connect a wallet first (connect()).');\n    return payer.current;\n  };\n\n  const value = useMemo<BwalletXContextValue>(\n    () => ({\n      ...state,\n      wallets,\n      connect,\n      disconnect,\n      listWallets,\n      pay: (req) => pay(need(), req, props.current.payOptions),\n      tip: (req) => tip(need(), req, props.current.payOptions),\n      buyToken: (req) => buyToken(need(), req),\n    }),\n    [state, wallets, connect, disconnect, listWallets],\n  );\n\n  return createElement(Ctx.Provider, { value }, p.children);\n}\n\n/** The wallet + session state. Must be inside <BwalletXProvider>. */\nexport function useBwalletX(): BwalletXContextValue {\n  const v = useContext(Ctx);\n  if (!v) throw new Error('useBwalletX() must be used inside <BwalletXProvider>');\n  return v;\n}\n\nexport { handcashAdapter, brc100Option, pairingOption, discoverWallets } from './wallets.js';\nexport type { WalletOption, ConnectedWallet, HandCashAdapterOptions } from './wallets.js';\nexport { PaymentError } from './pay.js';\nexport type { PayRequest, PayResult, BuyTokenRequest, PayOptions } from './pay.js';\n/** Alias with the casing used by <BwalletxSignin>. */\nexport const BwalletxProvider = BwalletXProvider;\n"],"mappings":"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","names":[]}