@dexterai/connect 0.2.0 → 0.3.0

package/dist/{chunk-46P7XAAI.js → chunk-HFG2GUFX.js}

@@ -228,9 +228,129 @@ function createPasskeySigner(vault, apiBase, opts = {}) {
   });
 }
 
+// src/walletStore.ts
+var ACTIVE_HANDLE_KEY = "dexter:passkey:userHandle";
+var ROSTER_KEY = "dexter:passkey:wallets";
+var listeners = /* @__PURE__ */ new Set();
+function hasStorage() {
+  try {
+    return typeof window !== "undefined" && !!window.localStorage;
+  } catch {
+    return false;
+  }
+}
+function readRoster() {
+  if (!hasStorage()) return [];
+  try {
+    const raw = window.localStorage.getItem(ROSTER_KEY);
+    if (!raw) return [];
+    const parsed = JSON.parse(raw);
+    if (!Array.isArray(parsed)) return [];
+    return parsed.filter(
+      (w) => !!w && typeof w === "object" && typeof w.handle === "string"
+    );
+  } catch {
+    return [];
+  }
+}
+function writeRoster(wallets) {
+  if (!hasStorage()) return;
+  try {
+    window.localStorage.setItem(ROSTER_KEY, JSON.stringify(wallets));
+  } catch {
+  }
+}
+function emit() {
+  for (const l of listeners) {
+    try {
+      l();
+    } catch {
+    }
+  }
+}
+function getActiveHandle() {
+  if (!hasStorage()) return null;
+  try {
+    return window.localStorage.getItem(ACTIVE_HANDLE_KEY);
+  } catch {
+    return null;
+  }
+}
+function setActiveHandle(handle, label) {
+  if (!hasStorage() || !handle) return;
+  try {
+    window.localStorage.setItem(ACTIVE_HANDLE_KEY, handle);
+  } catch {
+    return;
+  }
+  const roster = readRoster();
+  const existing = roster.find((w) => w.handle === handle);
+  const now = Date.now();
+  if (existing) {
+    existing.lastUsedAt = now;
+    if (label !== void 0) existing.label = label;
+  } else {
+    roster.push({ handle, label, lastUsedAt: now });
+  }
+  writeRoster(roster);
+  emit();
+}
+function ejectActiveWallet(opts) {
+  if (!hasStorage()) return;
+  const current = getActiveHandle();
+  try {
+    window.localStorage.removeItem(ACTIVE_HANDLE_KEY);
+  } catch {
+  }
+  if (opts?.forget && current) {
+    writeRoster(readRoster().filter((w) => w.handle !== current));
+  }
+  emit();
+}
+function listWallets() {
+  return readRoster().sort((a, b) => (b.lastUsedAt ?? 0) - (a.lastUsedAt ?? 0));
+}
+function switchWallet(handle) {
+  if (!readRoster().some((w) => w.handle === handle)) return false;
+  setActiveHandle(handle);
+  return true;
+}
+function forgetWallet(handle) {
+  if (getActiveHandle() === handle) {
+    ejectActiveWallet({ forget: true });
+    return;
+  }
+  writeRoster(readRoster().filter((w) => w.handle !== handle));
+  emit();
+}
+function subscribe(listener) {
+  listeners.add(listener);
+  if (hasStorage() && listeners.size === 1) {
+    window.addEventListener("storage", onStorageEvent);
+  }
+  return () => {
+    listeners.delete(listener);
+    if (hasStorage() && listeners.size === 0) {
+      window.removeEventListener("storage", onStorageEvent);
+    }
+  };
+}
+function onStorageEvent(e) {
+  if (e.key === ACTIVE_HANDLE_KEY || e.key === ROSTER_KEY || e.key === null) emit();
+}
+var ACTIVE_WALLET_STORAGE_KEY = ACTIVE_HANDLE_KEY;
+
 export {
   ConnectError,
   passkeyLogin,
   createAnonServerPolicy,
-  createPasskeySigner
+  createPasskeySigner,
+  getActiveHandle,
+  setActiveHandle,
+  ejectActiveWallet,
+  listWallets,
+  switchWallet,
+  forgetWallet,
+  subscribe,
+  ACTIVE_WALLET_STORAGE_KEY
 };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DexterConnectConfig, S as SignInResult, C as ConnectVault } from './types---RcNI2Y.js';
-export { a as ConnectError, P as PasskeyLoginTokens } from './types---RcNI2Y.js';
+import { D as DexterConnectConfig, S as SignInResult, C as ConnectVault } from './walletStore-CWXhXuzK.js';
+export { A as ACTIVE_WALLET_STORAGE_KEY, a as ConnectError, P as PasskeyLoginTokens, b as StoredWallet, e as ejectActiveWallet, f as forgetWallet, g as getActiveHandle, l as listWallets, s as setActiveHandle, c as subscribeWallet, d as switchWallet } from './walletStore-CWXhXuzK.js';
 import { DexterApiBrowserPasskeySigner } from '@dexterai/vault/signers/browser';
 
 /**

package/dist/index.js

@@ -1,12 +1,28 @@
 import {
+  ACTIVE_WALLET_STORAGE_KEY,
   ConnectError,
   createAnonServerPolicy,
   createPasskeySigner,
-  passkeyLogin
-} from "./chunk-46P7XAAI.js";
+  ejectActiveWallet,
+  forgetWallet,
+  getActiveHandle,
+  listWallets,
+  passkeyLogin,
+  setActiveHandle,
+  subscribe,
+  switchWallet
+} from "./chunk-HFG2GUFX.js";
 export {
+  ACTIVE_WALLET_STORAGE_KEY,
   ConnectError,
   createAnonServerPolicy,
   createPasskeySigner,
-  passkeyLogin
+  ejectActiveWallet,
+  forgetWallet,
+  getActiveHandle,
+  listWallets,
+  passkeyLogin,
+  setActiveHandle,
+  subscribe as subscribeWallet,
+  switchWallet
 };

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { DexterApiBrowserPasskeySigner } from '@dexterai/vault/signers/browser';
-import { S as SignInResult, P as PasskeyLoginTokens, C as ConnectVault, a as ConnectError } from './types---RcNI2Y.js';
+import { S as SignInResult, P as PasskeyLoginTokens, C as ConnectVault, a as ConnectError, b as StoredWallet } from './walletStore-CWXhXuzK.js';
 import { ReactElement } from 'react';
 
 type ConnectStatus = 'idle' | 'pending' | 'done' | 'error';
@@ -64,4 +64,25 @@ interface SignInWithDexterProps extends UseSignInWithDexterConfig {
  */
 declare function SignInWithDexter(props: SignInWithDexterProps): ReactElement | null;
 
-export { type ConnectStatus, SignInWithDexter, type SignInWithDexterProps, type UseSignInWithDexter, type UseSignInWithDexterConfig, useSignInWithDexter };
+interface UseDexterWallet {
+    /** Active wallet handle, or null if this browser has no active wallet. */
+    activeHandle: string | null;
+    /** Known wallets on this browser, most-recently-used first. */
+    wallets: StoredWallet[];
+    /**
+     * Eject the active wallet — "switch / start fresh / sign out of this wallet".
+     * The browser is no longer bound to it; the next enroll/recover starts clean.
+     * Pass `{ forget: true }` to also drop it from the roster.
+     */
+    eject: (opts?: {
+        forget?: boolean;
+    }) => void;
+    /** Switch the active wallet to a known handle. No-op if unknown. */
+    switchTo: (handle: string) => boolean;
+    /** Record/activate a handle (after enroll or recover). Prefer this over
+     *  hand-writing localStorage so the roster + subscribers stay correct. */
+    setActive: (handle: string, label?: string) => void;
+}
+declare function useDexterWallet(): UseDexterWallet;
+
+export { type ConnectStatus, SignInWithDexter, type SignInWithDexterProps, type UseDexterWallet, type UseSignInWithDexter, type UseSignInWithDexterConfig, useDexterWallet, useSignInWithDexter };

package/dist/react.js

@@ -1,8 +1,14 @@
 import {
   ConnectError,
   createPasskeySigner,
-  passkeyLogin
-} from "./chunk-46P7XAAI.js";
+  ejectActiveWallet,
+  getActiveHandle,
+  listWallets,
+  passkeyLogin,
+  setActiveHandle,
+  subscribe,
+  switchWallet
+} from "./chunk-HFG2GUFX.js";
 
 // src/useSignInWithDexter.ts
 import { useCallback, useEffect, useMemo, useState } from "react";
@@ -198,7 +204,30 @@ var DISCONNECT = {
   lineHeight: 1,
   opacity: 0.6
 };
+
+// src/useDexterWallet.ts
+import { useCallback as useCallback2, useEffect as useEffect2, useState as useState2 } from "react";
+function useDexterWallet() {
+  const [activeHandle, setHandle] = useState2(() => getActiveHandle());
+  const [wallets, setWallets] = useState2(() => listWallets());
+  useEffect2(() => {
+    const sync = () => {
+      setHandle(getActiveHandle());
+      setWallets(listWallets());
+    };
+    sync();
+    return subscribe(sync);
+  }, []);
+  return {
+    activeHandle,
+    wallets,
+    eject: useCallback2((opts) => ejectActiveWallet(opts), []),
+    switchTo: useCallback2((handle) => switchWallet(handle), []),
+    setActive: useCallback2((handle, label) => setActiveHandle(handle, label), [])
+  };
+}
 export {
   SignInWithDexter,
+  useDexterWallet,
   useSignInWithDexter
 };

package/dist/walletStore-CWXhXuzK.d.ts

@@ -0,0 +1,92 @@
+/** Supabase session tokens returned by dexter-api's passkey-login (camelCase). */
+interface PasskeyLoginTokens {
+    accessToken: string;
+    refreshToken: string;
+    expiresAt: number;
+    expiresIn: number;
+    tokenType: string;
+}
+/**
+ * Vault identity, returned ALONGSIDE the session by passkey-login once
+ * vault-review ships the dexter-api change (ASK 1). Optional until then —
+ * the connector degrades to session-only. Consumers that open x402 tabs
+ * (dexter-agents) need `vaultPda` + `publicKey` to build a passkey signer.
+ */
+interface ConnectVault {
+    vaultPda: string;
+    /** Swig state address, base58 — the user-facing Dexter Wallet address. */
+    swigAddress: string;
+    /** v2 swig wallet PDA (deposit address); null until the swig is deployed. */
+    receiveAddress: string | null;
+    /** Swig wallet's USDC ATA, base58 (for the connected-chip balance read);
+     *  null until the swig is deployed. Server-resolved (off-curve-safe). */
+    usdcAta: string | null;
+    /** base64 33-byte SEC1 compressed P-256 authority pubkey (for the signer). */
+    publicKey: string;
+    userHandle: string;
+    credentialId: string;
+}
+/** Result of a completed "Sign in with Dexter" ceremony. */
+interface SignInResult {
+    session: PasskeyLoginTokens;
+    /** Present once vault-review ships the vault-in-login change. */
+    vault?: ConnectVault;
+}
+interface DexterConnectConfig {
+    /** dexter-api base. Default https://api.dexter.cash. */
+    apiBase?: string;
+}
+/** Typed error whose `code` is the server's snake_case error string. */
+declare class ConnectError extends Error {
+    readonly code: string;
+    constructor(code: string, message?: string);
+}
+
+/** A wallet this browser knows about. `handle` is the identity; the rest is UX. */
+interface StoredWallet {
+    /** base64url 16-byte user handle — the vault identity. */
+    handle: string;
+    /** Human label for switch UIs (e.g. an email, or "Dexter Wallet"). */
+    label?: string;
+    /** Epoch ms of last activation — for ordering the switcher. */
+    lastUsedAt?: number;
+}
+type Listener = () => void;
+/** The active wallet handle, or null if this browser has no active wallet. */
+declare function getActiveHandle(): string | null;
+/**
+ * Set the active wallet handle (e.g. after enroll or recover), upserting it into
+ * the roster with a fresh `lastUsedAt`. Idempotent. Fires subscribers.
+ */
+declare function setActiveHandle(handle: string, label?: string): void;
+/**
+ * EJECT — clear the active wallet so the browser is no longer bound to it. This
+ * is "switch / start fresh / sign out of this wallet". The wallet stays in the
+ * roster (so the user can switch back) unless `forget` is true. After eject,
+ * `getActiveHandle()` is null and the next enroll/recover starts clean. Fires
+ * subscribers. This is the function whose absence WAS the welded-wallet bug.
+ */
+declare function ejectActiveWallet(opts?: {
+    forget?: boolean;
+}): void;
+/** Every wallet this browser knows about, most-recently-used first. */
+declare function listWallets(): StoredWallet[];
+/**
+ * Switch the active wallet to a handle ALREADY in the roster. Returns false (and
+ * does nothing) if the handle is unknown — switching is only ever to a wallet
+ * this browser has seen, never to an arbitrary string.
+ */
+declare function switchWallet(handle: string): boolean;
+/** Remove a wallet from the roster entirely; clears active if it was active. */
+declare function forgetWallet(handle: string): void;
+/**
+ * Subscribe to active-wallet/roster changes. Returns an unsubscribe fn. Also
+ * wires the cross-tab `storage` event once, so ejecting in one tab updates the
+ * others. The React hook (`useDexterWallet`) is a thin wrapper over this.
+ */
+declare function subscribe(listener: Listener): () => void;
+/** Exposed for consumers that must reference the canonical key (migrations,
+ *  tests). Prefer the accessors above — do NOT read localStorage by hand. */
+declare const ACTIVE_WALLET_STORAGE_KEY = "dexter:passkey:userHandle";
+
+export { ACTIVE_WALLET_STORAGE_KEY as A, type ConnectVault as C, type DexterConnectConfig as D, type PasskeyLoginTokens as P, type SignInResult as S, ConnectError as a, type StoredWallet as b, subscribe as c, switchWallet as d, ejectActiveWallet as e, forgetWallet as f, getActiveHandle as g, listWallets as l, setActiveHandle as s };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dexterai/connect",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Sign in with Dexter — passkey connector. Composes @dexterai/vault.",
   "type": "module",
   "exports": {

package/dist/types---RcNI2Y.d.ts

@@ -1,45 +0,0 @@
-/** Supabase session tokens returned by dexter-api's passkey-login (camelCase). */
-interface PasskeyLoginTokens {
-    accessToken: string;
-    refreshToken: string;
-    expiresAt: number;
-    expiresIn: number;
-    tokenType: string;
-}
-/**
- * Vault identity, returned ALONGSIDE the session by passkey-login once
- * vault-review ships the dexter-api change (ASK 1). Optional until then —
- * the connector degrades to session-only. Consumers that open x402 tabs
- * (dexter-agents) need `vaultPda` + `publicKey` to build a passkey signer.
- */
-interface ConnectVault {
-    vaultPda: string;
-    /** Swig state address, base58 — the user-facing Dexter Wallet address. */
-    swigAddress: string;
-    /** v2 swig wallet PDA (deposit address); null until the swig is deployed. */
-    receiveAddress: string | null;
-    /** Swig wallet's USDC ATA, base58 (for the connected-chip balance read);
-     *  null until the swig is deployed. Server-resolved (off-curve-safe). */
-    usdcAta: string | null;
-    /** base64 33-byte SEC1 compressed P-256 authority pubkey (for the signer). */
-    publicKey: string;
-    userHandle: string;
-    credentialId: string;
-}
-/** Result of a completed "Sign in with Dexter" ceremony. */
-interface SignInResult {
-    session: PasskeyLoginTokens;
-    /** Present once vault-review ships the vault-in-login change. */
-    vault?: ConnectVault;
-}
-interface DexterConnectConfig {
-    /** dexter-api base. Default https://api.dexter.cash. */
-    apiBase?: string;
-}
-/** Typed error whose `code` is the server's snake_case error string. */
-declare class ConnectError extends Error {
-    readonly code: string;
-    constructor(code: string, message?: string);
-}
-
-export { type ConnectVault as C, type DexterConnectConfig as D, type PasskeyLoginTokens as P, type SignInResult as S, ConnectError as a };