@dexterai/connect 0.8.0 → 0.10.0

package/dist/{chunk-LYIBVWRG.js → chunk-ZHJ557FI.js}

@@ -63,10 +63,13 @@ function derInteger(component) {
 // src/relay.ts
 var DEFAULT_API_BASE = "https://api.dexter.cash";
 var ANON_SIGN_BASE = "/api/passkey-anon/sign";
-async function passkeyLogin(config = {}) {
+async function passkeyLogin(config = {}, onPhase) {
   const apiBase = (config.apiBase ?? DEFAULT_API_BASE).replace(/\/$/, "");
+  onPhase?.("challenge");
   const options = await fetchLoginChallenge(apiBase);
+  onPhase?.("passkey");
   const credential = await getAssertion(options);
+  onPhase?.("verifying");
   return submitLogin(apiBase, credential);
 }
 async function fetchLoginChallenge(apiBase) {
@@ -344,6 +347,17 @@ function onStorageEvent(e) {
 }
 var ACTIVE_WALLET_STORAGE_KEY = ACTIVE_HANDLE_KEY;
 
+// src/phase.ts
+var PHASE_LABEL = {
+  challenge: "Preparing\u2026",
+  passkey: "Waiting for your passkey\u2026",
+  verifying: "Verifying\u2026",
+  finalizing: "Finishing\u2026"
+};
+function ceremonyPhaseLabel(phase) {
+  return PHASE_LABEL[phase];
+}
+
 // src/signals.ts
 function pkc() {
   if (typeof window === "undefined") return null;
@@ -420,6 +434,7 @@ export {
   forgetWallet,
   subscribe,
   ACTIVE_WALLET_STORAGE_KEY,
+  ceremonyPhaseLabel,
   passkeySignalSupport,
   renamePasskey,
   prunePasskey,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { D as DexterConnectConfig, S as SignInResult, C as ConnectVault } from './signals-CkBFwCNw.js';
-export { A as ACTIVE_WALLET_STORAGE_KEY, a as ConnectError, P as PasskeyLoginTokens, b as PasskeySignalSupport, c as StoredWallet, e as ejectActiveWallet, f as forgetWallet, g as getActiveHandle, d as getCredentialId, l as listWallets, p as passkeySignalSupport, h as prunePasskey, r as renamePasskey, s as setActiveHandle, i as subscribeWallet, j as switchWallet, k as syncAcceptedPasskeys } from './signals-CkBFwCNw.js';
+import { D as DexterConnectConfig, C as CeremonyPhase, S as SignInResult, a as ConnectVault } from './signals-CXkNJfIo.js';
+export { A as ACTIVE_WALLET_STORAGE_KEY, b as ConnectError, P as PasskeyLoginTokens, c as PasskeySignalSupport, d as StoredWallet, e as ejectActiveWallet, f as forgetWallet, g as getActiveHandle, h as getCredentialId, l as listWallets, p as passkeySignalSupport, i as prunePasskey, r as renamePasskey, s as setActiveHandle, j as subscribeWallet, k as switchWallet, m as syncAcceptedPasskeys } from './signals-CXkNJfIo.js';
 import { DexterApiBrowserPasskeySigner } from '@dexterai/vault/signers/browser';
 
 /**
@@ -15,7 +15,7 @@ import { DexterApiBrowserPasskeySigner } from '@dexterai/vault/signers/browser';
  * Relays to dexter-api's ANON router — a first-time third-party user has no
  * Supabase session, so the Supabase-gated router would 401.
  */
-declare function passkeyLogin(config?: DexterConnectConfig): Promise<SignInResult>;
+declare function passkeyLogin(config?: DexterConnectConfig, onPhase?: (phase: CeremonyPhase) => void): Promise<SignInResult>;
 
 /** What `issueChallenge` returns to the SDK signer. */
 interface AnonChallengeResult {
@@ -82,6 +82,9 @@ interface CreateWalletConfig extends DexterConnectConfig {
     name?: string;
     /** RP id for the new credential. Default "dexter.cash". */
     rpId?: string;
+    /** Called as the ceremony progresses, for live "connecting steps" UI:
+     *  challenge → passkey → verifying → finalizing. */
+    onPhase?: (phase: CeremonyPhase) => void;
 }
 interface CreateWalletResult {
     /** Server-minted 16-byte user handle, base64url — the vault identity. */
@@ -99,4 +102,12 @@ interface CreateWalletResult {
  */
 declare function createWallet(config?: CreateWalletConfig): Promise<CreateWalletResult>;
 
-export { type AnonChallengeResult, type AnonServerPolicy, ConnectVault, type CreateWalletConfig, type CreateWalletResult, DexterConnectConfig, SignInResult, createAnonServerPolicy, createPasskeySigner, createWallet, passkeyLogin };
+/**
+ * Human-readable label for a ceremony phase — the live "connecting step" copy.
+ * ONE source of truth so sign-in (SignInWithDexter) and create (consumer setup
+ * flows) show identical wording. Consumers surfacing createWallet's `onPhase`
+ * should use this instead of hand-rolling their own strings (Rule #7).
+ */
+declare function ceremonyPhaseLabel(phase: CeremonyPhase): string;
+
+export { type AnonChallengeResult, type AnonServerPolicy, CeremonyPhase, ConnectVault, type CreateWalletConfig, type CreateWalletResult, DexterConnectConfig, SignInResult, ceremonyPhaseLabel, createAnonServerPolicy, createPasskeySigner, createWallet, passkeyLogin };

package/dist/index.js

@@ -3,6 +3,7 @@ import {
   ConnectError,
   base64urlToBytes,
   bytesToBase64url,
+  ceremonyPhaseLabel,
   createAnonServerPolicy,
   createPasskeySigner,
   ejectActiveWallet,
@@ -18,7 +19,7 @@ import {
   subscribe,
   switchWallet,
   syncAcceptedPasskeys
-} from "./chunk-LYIBVWRG.js";
+} from "./chunk-ZHJ557FI.js";
 
 // src/enroll.ts
 var DEFAULT_API_BASE = "https://api.dexter.cash";
@@ -31,9 +32,13 @@ async function createWallet(config = {}) {
   const apiBase = (config.apiBase ?? DEFAULT_API_BASE).replace(/\/$/, "");
   const rpId = config.rpId ?? DEFAULT_RP_ID;
   const name = config.name && config.name.trim() || DEFAULT_WALLET_NAME;
+  config.onPhase?.("challenge");
   const options = await fetchEnrollChallenge(apiBase);
+  config.onPhase?.("passkey");
   const credential = await createCredential(options, name, rpId);
+  config.onPhase?.("verifying");
   const enrolled = await submitEnrollComplete(apiBase, credential);
+  config.onPhase?.("finalizing");
   const init = await initializeVault(apiBase, enrolled.userHandle, enrolled.credentialId);
   setActiveHandle(enrolled.userHandle, name, enrolled.credentialId);
   return {
@@ -148,6 +153,7 @@ async function readErrorCode(res) {
 export {
   ACTIVE_WALLET_STORAGE_KEY,
   ConnectError,
+  ceremonyPhaseLabel,
   createAnonServerPolicy,
   createPasskeySigner,
   createWallet,

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, c as StoredWallet, b as PasskeySignalSupport } from './signals-CkBFwCNw.js';
+import { C as CeremonyPhase, S as SignInResult, P as PasskeyLoginTokens, a as ConnectVault, b as ConnectError, d as StoredWallet, c as PasskeySignalSupport } from './signals-CXkNJfIo.js';
 import { ReactElement, ReactNode } from 'react';
 
 type ConnectStatus = 'idle' | 'pending' | 'done' | 'error';
@@ -11,6 +11,9 @@ interface UseSignInWithDexterConfig {
 }
 interface UseSignInWithDexter {
     status: ConnectStatus;
+    /** Live ceremony phase while status==='pending' (challenge → passkey →
+     *  verifying); null otherwise. Drives the button's "connecting steps". */
+    phase: CeremonyPhase | null;
     isVaultConnected: boolean;
     /** Run the ceremony. Resolves with the result; throws ConnectError on failure
      *  (error is also captured in `error` + `status==='error'` for declarative UI). */

package/dist/react.js

@@ -1,5 +1,6 @@
 import {
   ConnectError,
+  ceremonyPhaseLabel,
   createPasskeySigner,
   ejectActiveWallet,
   getActiveHandle,
@@ -12,7 +13,7 @@ import {
   setActiveHandle,
   subscribe,
   switchWallet
-} from "./chunk-LYIBVWRG.js";
+} from "./chunk-ZHJ557FI.js";
 
 // src/useSignInWithDexter.ts
 import { useCallback, useEffect, useMemo, useState } from "react";
@@ -59,6 +60,7 @@ var DEFAULT_RPC = "https://api.dexter.cash/proxy/helius/rpc";
 function useSignInWithDexter(config = {}) {
   const { apiBase, rpcUrl = DEFAULT_RPC } = config;
   const [status, setStatus] = useState("idle");
+  const [phase, setPhase] = useState(null);
   const [session, setSession] = useState(null);
   const [vault, setVault] = useState(null);
   const [usdcBalance, setUsdcBalance] = useState(null);
@@ -70,17 +72,20 @@ function useSignInWithDexter(config = {}) {
   }, [vault, rpcUrl]);
   const signIn = useCallback(async () => {
     setError(null);
+    setPhase(null);
     setStatus("pending");
     try {
-      const result = await passkeyLogin(apiBase ? { apiBase } : {});
+      const result = await passkeyLogin(apiBase ? { apiBase } : {}, setPhase);
       setSession(result.session);
       setVault(result.vault ?? null);
       setStatus("done");
+      setPhase(null);
       return result;
     } catch (err) {
       const e = err instanceof ConnectError ? err : new ConnectError("sign_in_failed", String(err));
       setError(e);
       setStatus("error");
+      setPhase(null);
       throw e;
     }
   }, [apiBase]);
@@ -100,6 +105,7 @@ function useSignInWithDexter(config = {}) {
   }, [refreshBalance]);
   return {
     status,
+    phase,
     isVaultConnected: status === "done" && vault !== null,
     signIn,
     disconnect,
@@ -263,6 +269,7 @@ function SignInWithDexter(props) {
     DexterButton,
     {
       loading: c.status === "pending",
+      loadingLabel: c.phase ? ceremonyPhaseLabel(c.phase) : "Connecting\u2026",
       variant,
       block,
       className,

package/dist/{signals-CkBFwCNw.d.ts → signals-CXkNJfIo.d.ts}

@@ -32,6 +32,12 @@ interface SignInResult {
     /** Present once vault-review ships the vault-in-login change. */
     vault?: ConnectVault;
 }
+/**
+ * Coarse ceremony phase, emitted as a sign-in/create ceremony progresses so the
+ * UI can show live "connecting steps" instead of one flat spinner:
+ *   challenge → passkey (the OS prompt) → verifying → finalizing (create only).
+ */
+type CeremonyPhase = 'challenge' | 'passkey' | 'verifying' | 'finalizing';
 interface DexterConnectConfig {
     /** dexter-api base. Default https://api.dexter.cash. */
     apiBase?: string;
@@ -139,4 +145,4 @@ declare function syncAcceptedPasskeys(args: {
     rpId?: string;
 }): Promise<boolean>;
 
-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 PasskeySignalSupport as b, type StoredWallet as c, getCredentialId as d, ejectActiveWallet as e, forgetWallet as f, getActiveHandle as g, prunePasskey as h, subscribe as i, switchWallet as j, syncAcceptedPasskeys as k, listWallets as l, passkeySignalSupport as p, renamePasskey as r, setActiveHandle as s };
+export { ACTIVE_WALLET_STORAGE_KEY as A, type CeremonyPhase as C, type DexterConnectConfig as D, type PasskeyLoginTokens as P, type SignInResult as S, type ConnectVault as a, ConnectError as b, type PasskeySignalSupport as c, type StoredWallet as d, ejectActiveWallet as e, forgetWallet as f, getActiveHandle as g, getCredentialId as h, prunePasskey as i, subscribe as j, switchWallet as k, listWallets as l, syncAcceptedPasskeys as m, passkeySignalSupport as p, renamePasskey as r, setActiveHandle as s };

package/package.json

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