decane-connect-kit 2.0.3 → 2.1.0

package/dist/index.js

@@ -1868,7 +1868,12 @@ function startBitcoinDiscovery(registry) {
 }
 
 // src/factory.ts
-function createDecane(config = {}) {
+function createDecane(config) {
+  if (!config?.appId) {
+    throw new Error(
+      "decane-connect-kit: appId is required. Pass your dashboard project ID as config.appId."
+    );
+  }
   const emitter = createEmitter();
   const registry = createRegistry(emitter);
   const session = createSessionManager();
@@ -1914,9 +1919,10 @@ var ERROR_MAP = {
   ORIGIN_NOT_ALLOWED: OriginNotAllowedError
 };
 var ApiClient = class {
-  constructor(baseUrl, apiKey) {
+  constructor(baseUrl, apiKey, appId) {
     this.baseUrl = baseUrl;
     this.apiKey = apiKey;
+    this.appId = appId;
   }
   async _request(path, init) {
     let res;
@@ -1926,6 +1932,7 @@ var ApiClient = class {
         headers: {
           "Content-Type": "application/json",
           "X-API-Key": this.apiKey,
+          "X-App-Id": this.appId,
           ...init?.headers
         }
       });
@@ -1992,6 +1999,35 @@ var ApiClient = class {
       body: JSON.stringify({ response, origin })
     });
   }
+  /**
+   * Exchange a token from the developer's own auth system for a Decane
+   * session. `providerId` is only needed when the project has more than one
+   * provider configured.
+   */
+  async authExternal(token, providerId) {
+    return this._request("/auth/external", {
+      method: "POST",
+      body: JSON.stringify(providerId ? { token, providerId } : { token })
+    });
+  }
+  /**
+   * Returns null when this user has no server-registered passkey, which is the
+   * expected answer for wallets created before passkey sign-in existed or for
+   * PIN-only users — the caller falls back to the normal sign-in flow.
+   */
+  async getWebAuthnLoginOptions(userId, rpId) {
+    return this._request("/webauthn/login-options", {
+      method: "POST",
+      body: JSON.stringify({ userId, rpId }),
+      allow404: true
+    });
+  }
+  async postWebAuthnLogin(userId, response, origin) {
+    return this._request("/webauthn/login", {
+      method: "POST",
+      body: JSON.stringify({ userId, response, origin })
+    });
+  }
   async revoke(jwt) {
     await this._request("/auth/revoke", {
       method: "POST",
@@ -2450,7 +2486,13 @@ function validatePin(pin) {
 
 // src/social/crypto/passkey.ts
 init_errors();
-import { startRegistration } from "@simplewebauthn/browser";
+import { startRegistration, startAuthentication as startAuthentication2 } from "@simplewebauthn/browser";
+function b64u(u) {
+  return btoa(String.fromCharCode(...u)).replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+}
+function fromB64u(s) {
+  return Uint8Array.from(atob(s.replace(/-/g, "+").replace(/_/g, "/")), (c) => c.charCodeAt(0));
+}
 function buf3(u) {
   return u.buffer.slice(u.byteOffset, u.byteOffset + u.byteLength);
 }
@@ -2477,6 +2519,29 @@ async function registerPasskey(opts) {
   );
   return { credentialId, prfOutput, response };
 }
+async function authenticateWithPasskey(opts) {
+  const optionsJSON = {
+    ...opts.optionsJSON,
+    extensions: {
+      ...opts.optionsJSON.extensions,
+      prf: { eval: { first: b64u(opts.prfSalt) } }
+    }
+  };
+  let response;
+  try {
+    response = await startAuthentication2({ optionsJSON });
+  } catch (e) {
+    if (e.name === "NotAllowedError") throw new UserCancelledError();
+    throw e;
+  }
+  const ext = response.clientExtensionResults;
+  const prfResults = ext?.["prf"]?.results;
+  let prfOutput;
+  if (prfResults?.first) {
+    prfOutput = typeof prfResults.first === "string" ? fromB64u(prfResults.first) : new Uint8Array(prfResults.first);
+  }
+  return { response, prfOutput };
+}
 async function getPrfOutput(opts) {
   const challenge = crypto.getRandomValues(new Uint8Array(32));
   let cred;
@@ -2819,6 +2884,7 @@ function clearPersisted(key) {
   }
 }
 async function createDecaneConnect(config) {
+  if (!config.appId) throw new Error("decane-connect-kit: appId is required");
   if (!config.apiKey) throw new Error("decane-connect-kit: apiKey is required");
   if (!config.chains?.length)
     throw new Error("decane-connect-kit: at least one chain is required");
@@ -2829,7 +2895,7 @@ async function createDecaneConnect(config) {
   const PERSIST_KEY = makePersistKey(config.apiKey);
   const teeUrl = config.teeUrl ?? DEFAULT_TEE_URL;
   const events = new EventEmitter();
-  const api = new ApiClient(baseUrl, config.apiKey);
+  const api = new ApiClient(baseUrl, config.apiKey, config.appId);
   const storage = new Storage();
   const session = new SessionManager(events, durationMs, teeUrl);
   let auth = null;
@@ -3079,6 +3145,45 @@ async function createDecaneConnect(config) {
     }
     return addresses;
   }
+  async function passkeyLoginCandidate() {
+    if (!persisted?.userId || !isPasskeySupported()) return null;
+    const stored = await storage.getShare(persisted.userId);
+    if (!stored || stored.unlockMethod !== "passkey") return null;
+    if (!stored.credentialId || !stored.prfSalt) return null;
+    return stored;
+  }
+  async function passkeyLogin(stored) {
+    const userId = stored.userId;
+    const options = await api.getWebAuthnLoginOptions(userId, rpId);
+    if (!options) {
+      throw new NewDeviceError();
+    }
+    const { response, prfOutput } = await authenticateWithPasskey({
+      optionsJSON: options,
+      prfSalt: stored.prfSalt
+    });
+    if (!prfOutput) throw new ShareCorruptedError();
+    const result = await api.postWebAuthnLogin(userId, response, window.location.origin);
+    let deviceShare;
+    try {
+      deviceShare = await aesGcmDecrypt(
+        await importAesKey(prfOutput),
+        stored.wrappedDeviceShare,
+        stored.iv
+      );
+    } catch {
+      throw new ShareCorruptedError();
+    }
+    const rawAddresses = await api.getAddresses(result.jwt);
+    const recordedAddresses = rawAddresses.evm && rawAddresses.solana ? { evm: rawAddresses.evm, solana: rawAddresses.solana } : null;
+    const addresses = await session.start(deviceShare, result.jwt, recordedAddresses);
+    zeroize(deviceShare);
+    auth = { jwt: result.jwt, userId, addresses };
+    persisted = { userId, addresses };
+    savePersisted(PERSIST_KEY, persisted);
+    events.emit("connected");
+    return { addresses, isNewUser: false };
+  }
   async function handleAuthResult(result) {
     let addresses;
     if (!result.hasShare) {
@@ -3097,6 +3202,15 @@ async function createDecaneConnect(config) {
       if (auth && session.isActive()) {
         return { addresses: auth.addresses, isNewUser: false };
       }
+      const candidate = await passkeyLoginCandidate();
+      if (candidate) {
+        try {
+          return await passkeyLogin(candidate);
+        } catch (e) {
+          if (e instanceof UserCancelledError) throw e;
+          console.warn("decane-connect-kit: passkey sign-in unavailable, falling back to standard sign-in.", e);
+        }
+      }
       const method = config.authMethods[0];
       if (!method) throw new CallSequenceError("No authMethods configured");
       if (method === "google") return client.connectWithGoogle();
@@ -3129,6 +3243,11 @@ async function createDecaneConnect(config) {
       return new Promise(() => {
       });
     },
+    async connectWithToken(token, opts) {
+      if (!token) throw new CallSequenceError("connectWithToken requires a token");
+      const result = await api.authExternal(token, opts?.providerId);
+      return handleAuthResult(result);
+    },
     async connectWithEmail(email) {
       await startEmailAuth(api, email);
       return { codeRequired: true };
@@ -3137,7 +3256,22 @@ async function createDecaneConnect(config) {
       const result = await verifyEmailCode(api, email, code);
       return handleAuthResult(result);
     },
+    async canSignInWithPasskey() {
+      return await passkeyLoginCandidate() !== null;
+    },
+    async signInWithPasskey() {
+      const candidate = await passkeyLoginCandidate();
+      if (!candidate) throw new NewDeviceError();
+      return passkeyLogin(candidate);
+    },
     async unlock() {
+      if (!auth) {
+        const candidate = await passkeyLoginCandidate();
+        if (candidate) {
+          await passkeyLogin(candidate);
+          return;
+        }
+      }
       if (!auth) {
         throw persisted ? new ReconnectRequiredError() : new CallSequenceError("Not connected \u2014 call connect() first");
       }
@@ -3340,8 +3474,8 @@ async function createDecaneConnect(config) {
 function bufferToB64u(buf6) {
   return btoa(String.fromCharCode(...buf6)).replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
 }
-function b64uToBuffer(b64u) {
-  const b644 = b64u.replace(/-/g, "+").replace(/_/g, "/");
+function b64uToBuffer(b64u2) {
+  const b644 = b64u2.replace(/-/g, "+").replace(/_/g, "/");
   return Uint8Array.from(atob(b644), (c) => c.charCodeAt(0));
 }
 function toHex(bytes) {
@@ -3728,11 +3862,16 @@ function WalletSelector({
   socialAuthMethods = ["google", "email"],
   onGoogleSignIn,
   onEmailStart,
-  onEmailVerify
+  onEmailVerify,
+  customAuthLabel,
+  onCustomAuthSignIn,
+  canUsePasskey = false,
+  passkeyAddress = null,
+  onPasskeySignIn
 }) {
   const showSocial = hasSocialMode(mode);
   const showWallets = mode !== "social";
-  const [view, setView] = useState(showWallets ? "wallets" : "social");
+  const [view, setView] = useState(showSocial ? "social" : "wallets");
   const [search, setSearch] = useState("");
   const [filter, setFilter] = useState("all");
   const [pendingWallet, setPendingWallet] = useState(null);
@@ -3741,6 +3880,8 @@ function WalletSelector({
   const [codeVal, setCodeVal] = useState("");
   const [socialLoad, setSocialLoad] = useState(false);
   const [socialErr, setSocialErr] = useState("");
+  const [showOtherMethods, setShowOtherMethods] = useState(false);
+  const passkeyFirst = canUsePasskey && !!onPasskeySignIn && !showOtherMethods;
   useEffect(() => {
     if (!open) return;
     injectFont();
@@ -3756,17 +3897,36 @@ function WalletSelector({
       setSearch("");
       setFilter("all");
       setPendingWallet(null);
-      setView(showWallets ? "wallets" : "social");
+      setView(showSocial ? "social" : "wallets");
       setEmailStep("input");
       setEmailVal("");
       setCodeVal("");
       setSocialErr("");
+      setShowOtherMethods(false);
       return;
     }
     return () => {
       document.getElementById("decane-tokens")?.remove();
     };
   }, [open, showWallets]);
+  async function handlePasskeySignIn() {
+    if (!onPasskeySignIn) return;
+    setSocialLoad(true);
+    setSocialErr("");
+    try {
+      await onPasskeySignIn();
+    } catch (e) {
+      const err = e;
+      if (err?.name !== "UserCancelledError") {
+        setSocialErr(err?.message ?? "Passkey sign-in failed");
+        setShowOtherMethods(true);
+      }
+      setSocialLoad(false);
+    }
+  }
+  async function handlePasskeyClick() {
+    void handlePasskeySignIn();
+  }
   async function handleGoogleClick() {
     if (!onGoogleSignIn) return;
     setSocialLoad(true);
@@ -3778,6 +3938,17 @@ function WalletSelector({
       setSocialLoad(false);
     }
   }
+  async function handleCustomAuthClick() {
+    if (!onCustomAuthSignIn) return;
+    setSocialLoad(true);
+    setSocialErr("");
+    try {
+      await onCustomAuthSignIn();
+    } catch (e) {
+      setSocialErr(e.message);
+      setSocialLoad(false);
+    }
+  }
   async function handleEmailStart(e) {
     e.preventDefault();
     if (!onEmailStart) return;
@@ -4052,7 +4223,7 @@ function WalletSelector({
             }
           },
           /* @__PURE__ */ React2.createElement("svg", { width: "12", height: "12", viewBox: "0 0 12 12", fill: "none" }, /* @__PURE__ */ React2.createElement("path", { d: "M1.5 1.5L10.5 10.5M10.5 1.5L1.5 10.5", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round" }))
-        )), showWallets && showSocial && /* @__PURE__ */ React2.createElement("div", { style: { display: "flex", gap: 4, marginBottom: 14, background: "var(--dc-surface)", borderRadius: 10, padding: 3 } }, ["wallets", "social"].map((v) => /* @__PURE__ */ React2.createElement(
+        )), showWallets && showSocial && /* @__PURE__ */ React2.createElement("div", { style: { display: "flex", gap: 4, marginBottom: 14, background: "var(--dc-surface)", borderRadius: 10, padding: 3 } }, ["social", "wallets"].map((v) => /* @__PURE__ */ React2.createElement(
           "button",
           {
             key: v,
@@ -4111,7 +4282,53 @@ function WalletSelector({
               e.currentTarget.style.borderColor = "var(--dc-border)";
             }
           }
-        ))), view === "social" && /* @__PURE__ */ React2.createElement("div", { style: { padding: "4px 20px 24px", display: "flex", flexDirection: "column", gap: 10 } }, socialErr && /* @__PURE__ */ React2.createElement("div", { style: { background: "rgba(204,51,0,0.1)", border: "1px solid var(--dc-danger)", borderRadius: 8, padding: "9px 12px", fontSize: 12, color: "var(--dc-danger)" } }, socialErr), socialAuthMethods.includes("google") && /* @__PURE__ */ React2.createElement(
+        ))), view === "social" && /* @__PURE__ */ React2.createElement("div", { style: { padding: "4px 20px 24px", display: "flex", flexDirection: "column", gap: 10 } }, socialErr && /* @__PURE__ */ React2.createElement("div", { style: { background: "rgba(204,51,0,0.1)", border: "1px solid var(--dc-danger)", borderRadius: 8, padding: "9px 12px", fontSize: 12, color: "var(--dc-danger)" } }, socialErr), passkeyFirst && /* @__PURE__ */ React2.createElement(React2.Fragment, null, /* @__PURE__ */ React2.createElement(
+          "button",
+          {
+            onClick: handlePasskeyClick,
+            disabled: socialLoad,
+            style: {
+              display: "flex",
+              alignItems: "center",
+              justifyContent: "center",
+              gap: 10,
+              width: "100%",
+              padding: "13px 16px",
+              background: "var(--dc-accent)",
+              border: "none",
+              borderRadius: 10,
+              cursor: socialLoad ? "not-allowed" : "pointer",
+              color: "var(--dc-accent-text)",
+              fontSize: 14,
+              fontWeight: 700,
+              fontFamily: "inherit",
+              opacity: socialLoad ? 0.6 : 1
+            }
+          },
+          /* @__PURE__ */ React2.createElement("svg", { width: "17", height: "17", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round" }, /* @__PURE__ */ React2.createElement("circle", { cx: "12", cy: "8", r: "4" }), /* @__PURE__ */ React2.createElement("path", { d: "M6 21v-1a4 4 0 0 1 4-4h1" }), /* @__PURE__ */ React2.createElement("path", { d: "M17 15v6M14.5 18h5" })),
+          socialLoad ? "Verifying\u2026" : "Continue with passkey"
+        ), passkeyAddress && /* @__PURE__ */ React2.createElement("div", { style: { textAlign: "center", fontSize: 12, color: "var(--dc-text-muted)" } }, "Resuming ", passkeyAddress.slice(0, 6), "\u2026", passkeyAddress.slice(-4)), /* @__PURE__ */ React2.createElement(
+          "button",
+          {
+            onClick: () => {
+              setShowOtherMethods(true);
+              setSocialErr("");
+            },
+            disabled: socialLoad,
+            style: {
+              background: "none",
+              border: "none",
+              padding: "6px 0",
+              color: "var(--dc-text-muted)",
+              fontSize: 12.5,
+              cursor: socialLoad ? "not-allowed" : "pointer",
+              fontFamily: "inherit",
+              textDecoration: "underline",
+              textUnderlineOffset: 3
+            }
+          },
+          "Use a different account"
+        )), !passkeyFirst && socialAuthMethods.includes("google") && /* @__PURE__ */ React2.createElement(
           "button",
           {
             onClick: handleGoogleClick,
@@ -4143,7 +4360,7 @@ function WalletSelector({
           },
           /* @__PURE__ */ React2.createElement("svg", { width: "18", height: "18", viewBox: "0 0 18 18", fill: "none" }, /* @__PURE__ */ React2.createElement("path", { d: "M17.64 9.2c0-.637-.057-1.251-.164-1.84H9v3.481h4.844c-.209 1.125-.843 2.078-1.796 2.717v2.258h2.908c1.702-1.567 2.684-3.875 2.684-6.615z", fill: "#4285F4" }), /* @__PURE__ */ React2.createElement("path", { d: "M9 18c2.43 0 4.467-.806 5.956-2.18l-2.908-2.259c-.806.54-1.837.86-3.048.86-2.344 0-4.328-1.584-5.036-3.711H.957v2.332A8.997 8.997 0 0 0 9 18z", fill: "#34A853" }), /* @__PURE__ */ React2.createElement("path", { d: "M3.964 10.71A5.41 5.41 0 0 1 3.682 9c0-.593.102-1.17.282-1.71V4.958H.957A8.996 8.996 0 0 0 0 9c0 1.452.348 2.827.957 4.042l3.007-2.332z", fill: "#FBBC05" }), /* @__PURE__ */ React2.createElement("path", { d: "M9 3.58c1.321 0 2.508.454 3.44 1.345l2.582-2.58C13.463.891 11.426 0 9 0A8.997 8.997 0 0 0 .957 4.958L3.964 6.29C4.672 4.163 6.656 3.58 9 3.58z", fill: "#EA4335" })),
           socialLoad ? "Redirecting\u2026" : "Continue with Google"
-        ), socialAuthMethods.includes("google") && socialAuthMethods.includes("email") && /* @__PURE__ */ React2.createElement("div", { style: { display: "flex", alignItems: "center", gap: 10 } }, /* @__PURE__ */ React2.createElement("div", { style: { flex: 1, height: 1, background: "var(--dc-border)" } }), /* @__PURE__ */ React2.createElement("span", { style: { fontSize: 11, color: "var(--dc-text-muted)", whiteSpace: "nowrap" } }, "or continue with email"), /* @__PURE__ */ React2.createElement("div", { style: { flex: 1, height: 1, background: "var(--dc-border)" } })), socialAuthMethods.includes("email") && (emailStep === "input" ? /* @__PURE__ */ React2.createElement("form", { onSubmit: handleEmailStart, style: { display: "flex", flexDirection: "column", gap: 8 } }, /* @__PURE__ */ React2.createElement(
+        ), !passkeyFirst && socialAuthMethods.includes("google") && socialAuthMethods.includes("email") && /* @__PURE__ */ React2.createElement("div", { style: { display: "flex", alignItems: "center", gap: 10 } }, /* @__PURE__ */ React2.createElement("div", { style: { flex: 1, height: 1, background: "var(--dc-border)" } }), /* @__PURE__ */ React2.createElement("span", { style: { fontSize: 11, color: "var(--dc-text-muted)", whiteSpace: "nowrap" } }, "or continue with email"), /* @__PURE__ */ React2.createElement("div", { style: { flex: 1, height: 1, background: "var(--dc-border)" } })), !passkeyFirst && socialAuthMethods.includes("email") && (emailStep === "input" ? /* @__PURE__ */ React2.createElement("form", { onSubmit: handleEmailStart, style: { display: "flex", flexDirection: "column", gap: 8 } }, /* @__PURE__ */ React2.createElement(
           "input",
           {
             type: "email",
@@ -4262,7 +4479,38 @@ function WalletSelector({
             }
           },
           socialLoad ? "Verifying\u2026" : "Verify"
-        ))))), view === "wallets" && /* @__PURE__ */ React2.createElement("div", { style: { overflowY: "auto", flex: 1, padding: "0 12px 20px" } }, filtered.length > 0 ? /* @__PURE__ */ React2.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 2 } }, filtered.map((w) => /* @__PURE__ */ React2.createElement(WalletRow, { key: w.id, wallet: w, onClick: () => handleWalletClick(w) }))) : /* @__PURE__ */ React2.createElement("div", { style: { textAlign: "center", padding: "32px 16px", color: "var(--dc-text-muted)", fontSize: 13 } }, q ? `No wallets matching "${q}"` : "No wallets detected")), view === "wallets" && /* @__PURE__ */ React2.createElement("div", { style: { padding: "10px 20px 14px", borderTop: "1px solid var(--dc-border)", textAlign: "center", fontSize: 11, color: "var(--dc-text-muted)" } }, "Don't see your wallet? Make sure it's installed and unlocked"))
+        )))), !passkeyFirst && customAuthLabel && onCustomAuthSignIn && /* @__PURE__ */ React2.createElement(React2.Fragment, null, (socialAuthMethods.includes("google") || socialAuthMethods.includes("email")) && /* @__PURE__ */ React2.createElement("div", { style: { display: "flex", alignItems: "center", gap: 10 } }, /* @__PURE__ */ React2.createElement("div", { style: { flex: 1, height: 1, background: "var(--dc-border)" } }), /* @__PURE__ */ React2.createElement("span", { style: { fontSize: 11, color: "var(--dc-text-muted)", whiteSpace: "nowrap" } }, "or"), /* @__PURE__ */ React2.createElement("div", { style: { flex: 1, height: 1, background: "var(--dc-border)" } })), /* @__PURE__ */ React2.createElement(
+          "button",
+          {
+            onClick: handleCustomAuthClick,
+            disabled: socialLoad,
+            style: {
+              display: "flex",
+              alignItems: "center",
+              justifyContent: "center",
+              gap: 10,
+              width: "100%",
+              padding: "11px 16px",
+              background: "var(--dc-surface)",
+              border: "1px solid var(--dc-border)",
+              borderRadius: 10,
+              cursor: socialLoad ? "not-allowed" : "pointer",
+              fontSize: 14,
+              fontWeight: 600,
+              color: "var(--dc-text)",
+              fontFamily: "inherit",
+              transition: "border-color 0.12s, background 0.12s",
+              opacity: socialLoad ? 0.6 : 1
+            },
+            onMouseEnter: (e) => {
+              if (!socialLoad) e.currentTarget.style.borderColor = "var(--dc-border-accent)";
+            },
+            onMouseLeave: (e) => {
+              e.currentTarget.style.borderColor = "var(--dc-border)";
+            }
+          },
+          socialLoad ? "Connecting\u2026" : customAuthLabel
+        ))), view === "wallets" && /* @__PURE__ */ React2.createElement("div", { style: { overflowY: "auto", flex: 1, padding: "0 12px 20px" } }, filtered.length > 0 ? /* @__PURE__ */ React2.createElement("div", { style: { display: "flex", flexDirection: "column", gap: 2 } }, filtered.map((w) => /* @__PURE__ */ React2.createElement(WalletRow, { key: w.id, wallet: w, onClick: () => handleWalletClick(w) }))) : /* @__PURE__ */ React2.createElement("div", { style: { textAlign: "center", padding: "32px 16px", color: "var(--dc-text-muted)", fontSize: 13 } }, q ? `No wallets matching "${q}"` : "No wallets detected")), view === "wallets" && /* @__PURE__ */ React2.createElement("div", { style: { padding: "10px 20px 14px", borderTop: "1px solid var(--dc-border)", textAlign: "center", fontSize: 11, color: "var(--dc-text-muted)" } }, "Don't see your wallet? Make sure it's installed and unlocked"))
       )
     )
   );
@@ -4384,13 +4632,16 @@ function SignInView({
   onEmailStart,
   onEmailVerify,
   authMethods,
-  resumeHint
+  resumeHint,
+  customAuthLabel,
+  onCustomAuthSignIn
 }) {
   const [googleLoading, setGoogleLoading] = useState2(false);
   const [email, setEmail] = useState2("");
   const [code, setCode] = useState2("");
   const [emailSent, setEmailSent] = useState2(false);
   const [emailLoading, setEmailLoading] = useState2(false);
+  const [customLoading, setCustomLoading] = useState2(false);
   const [error, setError] = useState2("");
   async function handleGoogle() {
     setError("");
@@ -4427,6 +4678,18 @@ function SignInView({
       setEmailLoading(false);
     }
   }
+  async function handleCustomAuth() {
+    if (!onCustomAuthSignIn) return;
+    setError("");
+    setCustomLoading(true);
+    try {
+      await onCustomAuthSignIn();
+    } catch (e) {
+      setError(e.message);
+    } finally {
+      setCustomLoading(false);
+    }
+  }
   const inputStyle = {
     width: "100%",
     background: "var(--dc-surface)",
@@ -4499,7 +4762,27 @@ function SignInView({
     fontWeight: 700,
     cursor: "pointer",
     fontFamily: "inherit"
-  } }, emailLoading ? "\u2026" : "Verify"))), error && /* @__PURE__ */ React3.createElement("div", { style: { marginTop: 10, fontSize: 12, color: "var(--dc-danger, #ff5533)" } }, error));
+  } }, emailLoading ? "\u2026" : "Verify"))), customAuthLabel && onCustomAuthSignIn && /* @__PURE__ */ React3.createElement(React3.Fragment, null, (authMethods.includes("google") || authMethods.includes("email")) && /* @__PURE__ */ React3.createElement("div", { style: { textAlign: "center", color: "var(--dc-text-muted)", fontSize: 12, margin: "10px 0" } }, "\u2014 or \u2014"), /* @__PURE__ */ React3.createElement(
+    "button",
+    {
+      onClick: handleCustomAuth,
+      disabled: customLoading,
+      style: {
+        width: "100%",
+        padding: "10px 0",
+        background: "var(--dc-surface)",
+        color: "var(--dc-text)",
+        border: "1px solid var(--dc-border)",
+        borderRadius: 10,
+        fontSize: 13,
+        fontWeight: 600,
+        cursor: customLoading ? "not-allowed" : "pointer",
+        opacity: customLoading ? 0.7 : 1,
+        fontFamily: "inherit"
+      }
+    },
+    customLoading ? "Connecting\u2026" : customAuthLabel
+  )), error && /* @__PURE__ */ React3.createElement("div", { style: { marginTop: 10, fontSize: 12, color: "var(--dc-danger, #ff5533)" } }, error));
 }
 function RecoverySection({
   addresses,
@@ -4616,6 +4899,8 @@ function SocialWalletModal({
   onEmailStart,
   onEmailVerify,
   authMethods = ["google", "email"],
+  customAuthLabel,
+  onCustomAuthSignIn,
   onRotateShares,
   onExportPortableBackup,
   rpcUrls,
@@ -4771,7 +5056,9 @@ function SocialWalletModal({
         onEmailStart,
         onEmailVerify,
         authMethods,
-        resumeHint: socialAuth.needsReconnect ? "your wallet" : void 0
+        resumeHint: socialAuth.needsReconnect ? "your wallet" : void 0,
+        customAuthLabel,
+        onCustomAuthSignIn
       }
     ) : /* @__PURE__ */ React3.createElement(React3.Fragment, null, /* @__PURE__ */ React3.createElement("div", { style: {
       margin: "0 16px 14px",
@@ -4864,7 +5151,8 @@ var DEFAULT_SOCIAL = {
   isNewUser: false,
   isUnlocked: false,
   sessionExpiresAt: null,
-  needsReconnect: false
+  needsReconnect: false,
+  canUsePasskey: false
 };
 var DecaneContext = createContext(null);
 function hasSocial(mode) {
@@ -4879,6 +5167,16 @@ function deriveNetworks(mode, explicit) {
 }
 function DecaneKit({ config, children }) {
   const mode = config?.mode ?? "wallets";
+  if (!config?.appId) {
+    throw new Error(
+      "DecaneKit: config.appId is required. Pass your dashboard project ID."
+    );
+  }
+  if (hasSocial(mode) && !config.social?.apiKey) {
+    throw new Error(
+      `DecaneKit: config.social.apiKey is required for social sign-in (mode "${mode}"). Create an API key for this project in the dashboard.`
+    );
+  }
   const walletRef = useRef(null);
   if (!walletRef.current) walletRef.current = createDecane(config);
   const socialRef = useRef(null);
@@ -4909,6 +5207,7 @@ function DecaneKit({ config, children }) {
     socialInitialized.current = true;
     const { apiKey, authMethods, promptPin, apiBaseUrl, chains, rpcUrls } = config.social;
     createDecaneConnect({
+      appId: config.appId,
       apiKey,
       apiBaseUrl,
       authMethods: authMethods ?? ["google", "email"],
@@ -4926,6 +5225,8 @@ function DecaneKit({ config, children }) {
       if (saved) {
         setSocialAuth((p) => ({ ...p, addresses: saved, isUnlocked: false, needsReconnect: true }));
       }
+      sdk.canSignInWithPasskey().then((can) => setSocialAuth((p) => ({ ...p, canUsePasskey: can }))).catch(() => {
+      });
       const params = new URLSearchParams(window.location.search);
       if (params.has("decane_jwt") || params.has("decane_error")) {
         sdk.connectWithGoogle().then(applyResult).catch(console.error);
@@ -4939,9 +5240,20 @@ function DecaneKit({ config, children }) {
       isNewUser: result.isNewUser,
       isUnlocked: sdk?.isUnlocked() ?? false,
       sessionExpiresAt: sdk?.sessionExpiresAt() ?? null,
-      needsReconnect: false
+      needsReconnect: false,
+      canUsePasskey: false
+    });
+    sdk?.canSignInWithPasskey().then((can) => setSocialAuth((p) => ({ ...p, canUsePasskey: can }))).catch(() => {
     });
   }
+  const signInWithPasskey = useCallback3(async () => {
+    const sdk = socialRef.current;
+    if (!sdk) throw new Error("Social sign-in not configured");
+    const result = await sdk.signInWithPasskey();
+    applyResult(result);
+    setSelectorOpen(false);
+    return result;
+  }, []);
   const connectWithGoogle = useCallback3(async () => {
     const sdk = socialRef.current;
     if (!sdk) throw new Error("Social sign-in not configured");
@@ -4959,6 +5271,19 @@ function DecaneKit({ config, children }) {
     applyResult(result);
     setSelectorOpen(false);
   }, []);
+  const connectWithToken = useCallback3(async (token, opts) => {
+    const sdk = socialRef.current;
+    if (!sdk) throw new Error("Social sign-in not configured");
+    const result = await sdk.connectWithToken(token, opts);
+    applyResult(result);
+    setSelectorOpen(false);
+  }, []);
+  const customAuthConfig = config?.social?.customAuth;
+  const connectWithCustomAuth = useCallback3(async () => {
+    if (!customAuthConfig) throw new Error("Custom auth not configured");
+    const token = await customAuthConfig.getToken();
+    await connectWithToken(token, customAuthConfig.providerId ? { providerId: customAuthConfig.providerId } : void 0);
+  }, [customAuthConfig, connectWithToken]);
   const socialUnlock = useCallback3(async () => {
     const sdk = socialRef.current;
     if (!sdk) return;
@@ -5035,9 +5360,13 @@ function DecaneKit({ config, children }) {
         setTheme,
         mode,
         socialAuth,
+        signInWithPasskey,
         connectWithGoogle,
         connectWithEmail,
         verifyEmailCode: verifyEmailCode2,
+        connectWithToken,
+        customAuthLabel: customAuthConfig?.label,
+        connectWithCustomAuth: customAuthConfig ? connectWithCustomAuth : void 0,
         socialUnlock,
         socialDisconnect,
         socialSignMessage,
@@ -5067,7 +5396,12 @@ function DecaneKit({ config, children }) {
         socialAuthMethods: config?.social?.authMethods ?? ["google", "email"],
         onGoogleSignIn: connectWithGoogle,
         onEmailStart: connectWithEmail,
-        onEmailVerify: verifyEmailCode2
+        onEmailVerify: verifyEmailCode2,
+        canUsePasskey: socialAuth.canUsePasskey,
+        passkeyAddress: socialAuth.addresses?.evm ?? socialAuth.addresses?.solana ?? null,
+        onPasskeySignIn: signInWithPasskey,
+        customAuthLabel: customAuthConfig?.label,
+        onCustomAuthSignIn: customAuthConfig ? connectWithCustomAuth : void 0
       }
     ),
     /* @__PURE__ */ React4.createElement(
@@ -5079,6 +5413,8 @@ function DecaneKit({ config, children }) {
         socialAuth,
         onUnlock: socialUnlock,
         onDisconnect: socialDisconnect,
+        customAuthLabel: customAuthConfig?.label,
+        onCustomAuthSignIn: customAuthConfig ? connectWithCustomAuth : void 0,
         onGoogleSignIn: connectWithGoogle,
         onEmailStart: connectWithEmail,
         onEmailVerify: verifyEmailCode2,
@@ -5109,11 +5445,16 @@ function useSocialAuth() {
     connectWithGoogle,
     connectWithEmail,
     verifyEmailCode: verifyEmailCode2,
+    connectWithToken,
+    customAuthLabel,
+    connectWithCustomAuth,
     socialUnlock,
     socialDisconnect
   } = useDecaneContext();
   const [googleLoading, setGoogleLoading] = useState4(false);
   const [emailLoading, setEmailLoading] = useState4(false);
+  const [tokenLoading, setTokenLoading] = useState4(false);
+  const [customLoading, setCustomLoading] = useState4(false);
   const [error, setError] = useState4(null);
   const signInWithGoogle = useCallback4(async () => {
     setGoogleLoading(true);
@@ -5150,6 +5491,31 @@ function useSocialAuth() {
       setEmailLoading(false);
     }
   }, [verifyEmailCode2]);
+  const signInWithToken = useCallback4(async (token, opts) => {
+    setTokenLoading(true);
+    setError(null);
+    try {
+      await connectWithToken(token, opts);
+    } catch (e) {
+      setError(e.message);
+      throw e;
+    } finally {
+      setTokenLoading(false);
+    }
+  }, [connectWithToken]);
+  const signInWithCustomAuth = useCallback4(async () => {
+    if (!connectWithCustomAuth) throw new Error("Custom auth not configured");
+    setCustomLoading(true);
+    setError(null);
+    try {
+      await connectWithCustomAuth();
+    } catch (e) {
+      setError(e.message);
+      throw e;
+    } finally {
+      setCustomLoading(false);
+    }
+  }, [connectWithCustomAuth]);
   const unlock = useCallback4(async () => {
     setError(null);
     try {
@@ -5181,11 +5547,16 @@ function useSocialAuth() {
     needsReconnect: socialAuth.needsReconnect,
     googleLoading,
     emailLoading,
+    tokenLoading,
+    customLoading,
+    customAuthLabel,
     error,
     clearError: () => setError(null),
     signInWithGoogle,
     sendEmailCode,
     confirmEmailCode,
+    signInWithToken,
+    signInWithCustomAuth: connectWithCustomAuth ? signInWithCustomAuth : void 0,
     unlock,
     disconnect
   };