@rakomi/react-native 0.1.0 → 0.3.0

package/dist/index.cjs

@@ -12,6 +12,24 @@ var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require
   throw Error('Dynamic require of "' + x + '" is not supported');
 });
 
+// src/internal/ceremony-lock.ts
+function createCeremonyLock() {
+  let held = false;
+  return {
+    tryAcquire() {
+      if (held) return false;
+      held = true;
+      return true;
+    },
+    release() {
+      held = false;
+    },
+    get held() {
+      return held;
+    }
+  };
+}
+
 // src/internal/canonical-url.ts
 var CanonicalizeUrlError = class extends Error {
   constructor(code, message) {
@@ -117,6 +135,37 @@ function createDpopSession(options) {
   return new DpopSession(options);
 }
 
+// src/internal/compose-signals.ts
+function composeSignals(caller, internal) {
+  if (caller === void 0) {
+    return { signal: internal, dispose: () => void 0 };
+  }
+  const controller = new AbortController();
+  const abort = (reason) => {
+    if (!controller.signal.aborted) controller.abort(reason);
+  };
+  const onCaller = () => abort(caller.reason);
+  const onInternal = () => abort(internal.reason);
+  if (caller.aborted) {
+    abort(caller.reason);
+  } else if (internal.aborted) {
+    abort(internal.reason);
+  } else {
+    caller.addEventListener("abort", onCaller, { once: true });
+    internal.addEventListener("abort", onInternal, { once: true });
+  }
+  let disposed = false;
+  return {
+    signal: controller.signal,
+    dispose: () => {
+      if (disposed) return;
+      disposed = true;
+      caller.removeEventListener("abort", onCaller);
+      internal.removeEventListener("abort", onInternal);
+    }
+  };
+}
+
 // src/internal/http-client.ts
 function createRnHttpClient(options = {}) {
   const baseUrl = options.baseUrl?.replace(/\/$/, "") ?? "";
@@ -125,18 +174,41 @@ function createRnHttpClient(options = {}) {
     fetch: async (url, init = {}) => {
       const fullUrl = url.startsWith("http://") || url.startsWith("https://") ? url : `${baseUrl}${url.startsWith("/") ? "" : "/"}${url}`;
       const controller = new AbortController();
-      const timer = setTimeout(() => controller.abort(), timeout);
+      const timedOut = Object.assign(new Error("request timed out"), { name: "TimeoutError" });
+      const timer = setTimeout(() => controller.abort(timedOut), timeout);
+      const composed = composeSignals(init.signal, controller.signal);
+      let response;
       try {
-        return await fetch(fullUrl, {
+        response = await fetch(fullUrl, {
           method: init.method ?? "GET",
           headers: init.headers,
           body: init.body,
           redirect: "error",
-          signal: init.signal ?? controller.signal
+          signal: composed.signal
         });
-      } finally {
+      } catch (err2) {
         clearTimeout(timer);
+        composed.dispose();
+        throw err2;
+      }
+      clearTimeout(timer);
+      const body = response.body;
+      const streaming = body !== null && body !== void 0 && typeof body.pipeThrough === "function" && typeof TransformStream !== "undefined";
+      if (!streaming) {
+        composed.dispose();
+        return response;
       }
+      const release = new TransformStream({
+        flush: () => composed.dispose()
+      });
+      const piped = body.pipeThrough(release);
+      const wrapped = new Response(piped, {
+        status: response.status,
+        statusText: response.statusText,
+        headers: response.headers
+      });
+      composed.signal.addEventListener("abort", () => composed.dispose(), { once: true });
+      return wrapped;
     }
   };
 }
@@ -225,8 +297,8 @@ function deriveDefaultJwksUri(tokenEndpoint) {
     return tokenEndpoint.replace(/\/[^/]*$/, "") + "/.well-known/jwks.json";
   }
 }
-var RAKOMI_PLATFORM_ISSUER_DEFAULT = "https://rakomi.com";
-var RAKOMI_PLATFORM_AUDIENCE_DEFAULT = "https://rakomi.com";
+var RAKOMI_PLATFORM_ISSUER_DEFAULT = "https://api.rakomi.com";
+var RAKOMI_PLATFORM_AUDIENCE_DEFAULT = "https://api.rakomi.com";
 function deriveDefaultIssuer(_tokenEndpoint) {
   return RAKOMI_PLATFORM_ISSUER_DEFAULT;
 }
@@ -941,8 +1013,24 @@ function RakomiProvider(props) {
     return Object.freeze(built);
   }, [props.nativeAdapter, props.tokenCache]);
   const http = react.useMemo(() => createRnHttpClient({ baseUrl: props.baseUrl }), [props.baseUrl]);
+  const authorizationEndpointCache = react.useMemo(
+    () => sdkCore.createAuthorizationEndpointCache({
+      fetchDiscoveryDocument: async () => {
+        const response = await http.fetch("/.well-known/openid-configuration", {
+          method: "GET",
+          headers: { Accept: "application/json" }
+        });
+        if (!response.ok) {
+          throw new Error(`discovery fetch failed: HTTP ${response.status}`);
+        }
+        return response.json();
+      }
+    }),
+    [http]
+  );
   const events = react.useMemo(() => new sdkCore.EventLog(props.onEvent), [props.onEvent]);
   const [snapshot, dispatch] = react.useReducer(sdkCore.reduce, sdkCore.INITIAL_SNAPSHOT);
+  const passkeyCeremonyLock = react.useRef(createCeremonyLock()).current;
   const translate = react.useMemo(
     () => sdkCore.createTranslator(props.locale ?? "en", props.translations),
     [props.locale, props.translations]
@@ -1075,6 +1163,7 @@ function RakomiProvider(props) {
       redirectUri: props.redirectUri,
       adapter,
       http,
+      authorizationEndpointCache,
       snapshot,
       state: snapshot.state,
       isSignedIn: sdkCore.isSignedIn(snapshot),
@@ -1086,10 +1175,11 @@ function RakomiProvider(props) {
       signOut,
       getToken,
       submitOAuthTokens,
+      passkeyCeremonyLock,
       beginAuthFlow,
       dpopSession
     }),
-    [adapter, http, snapshot, events, props.publishableKey, props.baseUrl, props.redirectUri, props.locale, translate, signOut, getToken, submitOAuthTokens, beginAuthFlow, dpopSession]
+    [adapter, http, authorizationEndpointCache, snapshot, events, props.publishableKey, props.baseUrl, props.redirectUri, props.locale, translate, signOut, getToken, submitOAuthTokens, beginAuthFlow, dpopSession, passkeyCeremonyLock]
   );
   return /* @__PURE__ */ jsxRuntime.jsx(RakomiContext.Provider, { value, children: props.children });
 }
@@ -1203,19 +1293,20 @@ function useFlag(flag, options) {
 }
 function useOrganization() {
   const { user } = useRakomiContext();
-  const orgId = user?.rawClaims["org_id"];
-  const orgRole = user?.rawClaims["org_role"];
-  const orgMemberships = user?.rawClaims["org_memberships"] ?? [];
+  const { org_id: orgId, org_role: orgRole, org_memberships: orgMemberships } = sdkCore.extractOrgClaims(
+    user?.rawClaims ?? {}
+  );
   return {
     isLoaded: !!user,
-    organization: orgId && orgRole ? { orgId, orgRole, orgMemberships } : null
+    organization: orgId && orgRole ? { orgId, orgRole, orgMemberships: orgMemberships ?? [] } : null
   };
 }
 function useOrganizationList() {
   const { user } = useRakomiContext();
+  const { org_memberships: organizations } = sdkCore.extractOrgClaims(user?.rawClaims ?? {});
   return {
     isLoaded: !!user,
-    organizations: user?.rawClaims["org_memberships"] ?? []
+    organizations: organizations ?? []
   };
 }
 function useLinkedAccounts() {
@@ -1249,7 +1340,8 @@ function useAuthConfig() {
             headers: { Accept: "application/json", "X-API-Key": publishableKey }
           });
           if (!response.ok) return null;
-          return await response.json();
+          const raw = await response.json();
+          return sdkCore.parseAuthConfigResponse(raw, baseUrl);
         } catch {
           return null;
         }
@@ -1545,13 +1637,23 @@ function SignIn(props) {
   const [code, setCode] = react.useState("");
   const [busy, setBusy] = react.useState(false);
   const tokenEndpoint = props.tokenEndpoint ?? "/v1/auth/oauth/callback";
-  const authorizationEndpoint = props.authorizationEndpoint ?? "/oauth/authorize";
   const totpVerifyEndpoint = props.totpVerifyEndpoint ?? "/v1/auth/mfa/totp/verify";
   const providers = props.providers ?? ["google"];
   async function onProviderPress(provider) {
     if (busy) return;
     setBusy(true);
     ctx.events.push({ type: "sign_in_attempted", severity: "info", metadata: { provider } });
+    let authorizationEndpoint = props.authorizationEndpoint;
+    if (!authorizationEndpoint) {
+      const resolved = await ctx.authorizationEndpointCache.resolve(ctx.baseUrl);
+      if (!resolved.ok) {
+        ctx.events.push({ type: "sign_in_failed", severity: "warning", error: resolved.error });
+        setStep({ kind: "error", error: resolved.error });
+        setBusy(false);
+        return;
+      }
+      authorizationEndpoint = resolved.authorizationEndpoint;
+    }
     const outcome = await startSocialSignIn({
       adapter: ctx.adapter,
       http: ctx.http,
@@ -1757,7 +1859,7 @@ function UserButton(props) {
 function UserProfile(props) {
   react.useEffect(() => {
     if (typeof __DEV__ !== "undefined" && __DEV__) {
-      console.warn("[@rakomi/react-native] <UserProfile /> is in preview until 0.2.0 \u2014 feedback welcome.");
+      console.warn("[@rakomi/react-native] <UserProfile /> is in preview \u2014 feedback welcome.");
     }
   }, []);
   const ctx = useRakomiContext();
@@ -1805,6 +1907,264 @@ function createNativeDpopProver(options) {
   };
 }
 
+// src/native/passkey-envelope.ts
+var BASE64URL = /^[A-Za-z0-9_-]+$/;
+var RULES = {
+  registration: {
+    required: ["id", "rawId", "response.clientDataJSON", "response.attestationObject"],
+    base64url: ["id", "rawId", "response.clientDataJSON", "response.attestationObject"],
+    requiredStringArray: ["response.transports"],
+    requiredObject: ["clientExtensionResults"],
+    keep: ["id", "rawId", "type", "authenticatorAttachment", "clientExtensionResults"],
+    keepInResponse: [
+      "clientDataJSON",
+      "attestationObject",
+      "authenticatorData",
+      "publicKey",
+      "publicKeyAlgorithm"
+    ],
+    keepStringArrayInResponse: ["transports"]
+  },
+  assertion: {
+    required: [
+      "id",
+      "rawId",
+      "response.clientDataJSON",
+      "response.authenticatorData",
+      "response.signature"
+    ],
+    base64url: [
+      "id",
+      "rawId",
+      "response.clientDataJSON",
+      "response.authenticatorData",
+      "response.signature",
+      "response.userHandle"
+    ],
+    requiredStringArray: [],
+    requiredObject: ["clientExtensionResults"],
+    keep: ["id", "rawId", "type", "authenticatorAttachment", "clientExtensionResults"],
+    keepInResponse: ["clientDataJSON", "authenticatorData", "signature", "userHandle"],
+    keepStringArrayInResponse: []
+  }
+};
+var CredentialEnvelopeError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "CredentialEnvelopeError";
+  }
+};
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function readPath(envelope, path) {
+  const dot = path.indexOf(".");
+  if (dot === -1) return envelope[path];
+  const parent = envelope[path.slice(0, dot)];
+  return isRecord(parent) ? parent[path.slice(dot + 1)] : void 0;
+}
+function assertW3cCredentialEnvelope(kind, parsed) {
+  if (!isRecord(parsed)) {
+    throw new CredentialEnvelopeError(
+      `the native module returned a ${parsed === null ? "null" : typeof parsed}; the contract is a JSON object`
+    );
+  }
+  if (parsed["type"] !== "public-key") {
+    throw new CredentialEnvelopeError(`'type' must be the string "public-key" (W3C WebAuthn L3)`);
+  }
+  if (!isRecord(parsed["response"])) {
+    throw new CredentialEnvelopeError(`'response' is missing or is not an object`);
+  }
+  const rule = RULES[kind];
+  for (const path of rule.required) {
+    const value = readPath(parsed, path);
+    if (typeof value !== "string" || value.length === 0) {
+      throw new CredentialEnvelopeError(
+        `'${path}' is required on a ${kind} response and must be a non-empty string (W3C WebAuthn L3 JSON serialization)`
+      );
+    }
+  }
+  for (const path of rule.requiredStringArray) {
+    const value = readPath(parsed, path);
+    if (!Array.isArray(value) || value.some((entry) => typeof entry !== "string")) {
+      throw new CredentialEnvelopeError(
+        `'${path}' is required on a ${kind} response and must be an array of strings (W3C WebAuthn L3). The server stores it and replays it into allowCredentials \u2014 omitting it silently breaks cross-device sign-in later, on another device.`
+      );
+    }
+  }
+  for (const path of rule.requiredObject) {
+    const value = readPath(parsed, path);
+    if (!isRecord(value)) {
+      throw new CredentialEnvelopeError(
+        `'${path}' is required on a ${kind} response and must be an object (an empty object is fine)`
+      );
+    }
+  }
+  for (const path of rule.base64url) {
+    const value = readPath(parsed, path);
+    if (value === void 0 || value === null) continue;
+    if (typeof value !== "string" || !BASE64URL.test(value)) {
+      throw new CredentialEnvelopeError(
+        `'${path}' is not unpadded base64url (RFC 4648 \xA75). On iOS, Data.base64EncodedString() emits standard base64 (RFC 4648 \xA74, with '+', '/' and '=' padding) \u2014 use the URL-safe, unpadded variant.`
+      );
+    }
+  }
+}
+function sanitizeCredentialEnvelope(kind, parsed) {
+  assertW3cCredentialEnvelope(kind, parsed);
+  const envelope = parsed;
+  const source = envelope["response"];
+  const rule = RULES[kind];
+  const response = /* @__PURE__ */ Object.create(null);
+  for (const key of rule.keepInResponse) {
+    const value = source[key];
+    if (typeof value === "string" || typeof value === "number") response[key] = value;
+  }
+  for (const key of rule.keepStringArrayInResponse) {
+    const value = source[key];
+    if (Array.isArray(value)) response[key] = value.filter((entry) => typeof entry === "string");
+  }
+  const projected = /* @__PURE__ */ Object.create(null);
+  for (const key of rule.keep) {
+    const value = envelope[key];
+    if (value !== void 0) projected[key] = value;
+  }
+  projected["response"] = response;
+  return projected;
+}
+
+// src/native/passkey-adapter.ts
+var NATIVE_CODE_TO_KIND = Object.assign(/* @__PURE__ */ Object.create(null), {
+  PASSKEY_CANCELLED: "cancelled",
+  PASSKEY_UNSUPPORTED: "unsupported",
+  PASSKEY_NO_CREDENTIAL: "cancelled"
+});
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeNativeRejection(err2) {
+  const code = isRecord2(err2) ? err2["code"] : void 0;
+  if (typeof code === "string") {
+    const kind = NATIVE_CODE_TO_KIND[code];
+    if (kind !== void 0) {
+      throw new sdkCore.PasskeyCeremonyError(kind);
+    }
+  }
+  throw err2;
+}
+function assertNever(value) {
+  throw new sdkCore.PasskeyCeremonyError("failed", `unhandled ceremony-error kind: ${String(value)}`);
+}
+function describeKind(kind) {
+  switch (kind) {
+    case "cancelled":
+      return "the user dismissed the passkey sheet";
+    case "unsupported":
+      return "this platform cannot run a passkey ceremony";
+    case "failed":
+      return "the passkey ceremony failed";
+    default:
+      return assertNever(kind);
+  }
+}
+function createNativePasskeyAdapter(options) {
+  const mod = options.module;
+  let inFlight = null;
+  const candidate = mod;
+  const missing = ["isPasskeySupported", "createPasskey", "getPasskey"].filter(
+    (method) => typeof candidate?.[method] !== "function"
+  );
+  if (missing.length > 0) {
+    throw new Error(
+      `native passkey module is missing: ${missing.join(", ")} \u2014 it does not satisfy NativePasskeyModuleSpec`
+    );
+  }
+  async function runCeremony(kind, requestJson, ceremonyOptions) {
+    const signal = ceremonyOptions?.signal;
+    if (signal?.aborted === true) {
+      throw new sdkCore.PasskeyCeremonyError("cancelled", describeKind("cancelled"));
+    }
+    const ticket = /* @__PURE__ */ Symbol("passkey-ceremony");
+    inFlight = ticket;
+    const onAbort = () => {
+      if (inFlight !== ticket) return;
+      try {
+        void Promise.resolve(mod.cancelPasskeyRequest?.()).catch(() => void 0);
+      } catch {
+      }
+    };
+    signal?.addEventListener("abort", onAbort, { once: true });
+    let raw;
+    try {
+      raw = await (kind === "registration" ? mod.createPasskey(requestJson) : mod.getPasskey(requestJson));
+    } catch (err2) {
+      normalizeNativeRejection(err2);
+    } finally {
+      signal?.removeEventListener("abort", onAbort);
+      if (inFlight === ticket) inFlight = null;
+    }
+    if (typeof raw !== "string") {
+      throw new CredentialEnvelopeError(
+        `the native module returned ${raw === null ? "null" : `a ${typeof raw}`}; the contract is a JSON string \u2014 wrap a module with an object API so it stringifies its argument and its result`
+      );
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      throw new CredentialEnvelopeError(
+        "the native module returned a string that is not valid JSON (a double-encoded response does this)"
+      );
+    }
+    return sanitizeCredentialEnvelope(kind, parsed);
+  }
+  async function ceremonyOrMalformed(kind, requestJson, ceremonyOptions) {
+    try {
+      return await runCeremony(kind, requestJson, ceremonyOptions);
+    } catch (err2) {
+      if (err2 instanceof CredentialEnvelopeError) {
+        return { rakomiEnvelopeViolation: err2.message };
+      }
+      throw err2;
+    }
+  }
+  return {
+    async isSupported() {
+      try {
+        return await mod.isPasskeySupported() === true;
+      } catch {
+        return false;
+      }
+    },
+    hasPlatformAuthenticator() {
+      return probePlatformAuthenticator(mod);
+    },
+    createCredential(creationOptions, ceremonyOptions) {
+      return ceremonyOrMalformed(
+        "registration",
+        JSON.stringify(creationOptions),
+        ceremonyOptions
+      );
+    },
+    getCredential(requestOptions, ceremonyOptions) {
+      return ceremonyOrMalformed(
+        "assertion",
+        JSON.stringify(requestOptions),
+        ceremonyOptions
+      );
+    }
+  };
+}
+async function probePlatformAuthenticator(mod) {
+  if (typeof mod.isPlatformAuthenticatorAvailable !== "function") return null;
+  try {
+    const available = await mod.isPlatformAuthenticatorAvailable();
+    return typeof available === "boolean" ? available : null;
+  } catch {
+    return null;
+  }
+}
+
 // src/internal/webhook-verify.ts
 var RKSEC_PREFIX = "rksec_";
 var EXPECTED_KEY_LENGTH = 32;
@@ -1920,6 +2280,349 @@ async function verifyPublisherWebhook(body, headers, secret, tolerance = DEFAULT
   const clamped = Math.min(Math.max(0, tolerance), MAX_WEBHOOK_TOLERANCE);
   return verifyWebhook(body, headers, secret, clamped);
 }
+var CEREMONY_ACTIONS = /* @__PURE__ */ new Set(["signIn", "register", "stepUp"]);
+function platformProbe(adapter) {
+  const candidate = adapter.hasPlatformAuthenticator;
+  return typeof candidate === "function" ? candidate.bind(adapter) : void 0;
+}
+function sessionIdentity(token) {
+  const payload = sdkCore.decodeJwtPayload(token);
+  if (payload === null) return null;
+  const subject = payload["sub"];
+  const session = payload["sid"];
+  if (typeof subject !== "string" || !subject) return null;
+  if (typeof session !== "string" || !session) return null;
+  return { subject, session };
+}
+var notSupported = () => sdkCore.passkeyError(
+  "PASSKEY_NOT_SUPPORTED",
+  "no passkey ceremony adapter is wired: pass one on `nativeAdapter.passkeys` (see createNativePasskeyAdapter)"
+);
+function usePasskeys(options = {}) {
+  const ctx = useRakomiContext();
+  const {
+    adapter: nativeAdapter,
+    http,
+    baseUrl,
+    publishableKey,
+    getToken,
+    beginAuthFlow,
+    submitOAuthTokens,
+    passkeyCeremonyLock
+  } = ctx;
+  const [isSupported, setIsSupported] = react.useState(null);
+  const [hasPlatformAuthenticator, setHasPlatformAuthenticator] = react.useState(null);
+  const [passkeys, setPasskeys] = react.useState(void 0);
+  const [error, setError] = react.useState(null);
+  const [isSigningIn, setIsSigningIn] = react.useState(false);
+  const [isRegistering, setIsRegistering] = react.useState(false);
+  const [isSteppingUp, setIsSteppingUp] = react.useState(false);
+  const [isLoading, setIsLoading] = react.useState(false);
+  const [isMutating, setIsMutating] = react.useState(false);
+  const adapter = options.adapter ?? nativeAdapter.passkeys;
+  const mountedRef = react.useRef(true);
+  const busyRef = react.useRef({
+    signIn: false,
+    register: false,
+    stepUp: false,
+    list: false,
+    mutate: false
+  });
+  const inFlightRef = react.useRef(/* @__PURE__ */ new Set());
+  react.useEffect(() => {
+    mountedRef.current = true;
+    const inFlight = inFlightRef.current;
+    return () => {
+      mountedRef.current = false;
+      for (const controller of inFlight) controller.abort();
+      inFlight.clear();
+    };
+  }, []);
+  react.useEffect(() => {
+    if (adapter === void 0) {
+      setIsSupported(false);
+      setHasPlatformAuthenticator(null);
+      return;
+    }
+    let cancelled = false;
+    void (async () => {
+      const [supported, platform] = await Promise.all([
+        Promise.resolve(adapter.isSupported()).catch(() => false),
+        Promise.resolve(platformProbe(adapter)?.() ?? null).catch(() => null)
+      ]);
+      if (cancelled || !mountedRef.current) return;
+      setIsSupported(supported === true);
+      setHasPlatformAuthenticator(typeof platform === "boolean" ? platform : null);
+    })();
+    return () => {
+      cancelled = true;
+    };
+  }, [adapter]);
+  const setBusy = react.useCallback((key, value) => {
+    busyRef.current[key] = value;
+    if (key === "signIn") setIsSigningIn(value);
+    else if (key === "register") setIsRegistering(value);
+    else if (key === "stepUp") setIsSteppingUp(value);
+    else if (key === "list") setIsLoading(value);
+    else setIsMutating(value);
+  }, []);
+  const requireSession = react.useCallback(async () => {
+    const expired = () => sdkCore.passkeyError("PASSKEY_SESSION_EXPIRED", "you must be signed in to manage passkeys");
+    const token = await getToken();
+    if (!token.ok) {
+      const err2 = token.error;
+      if (err2.code === "NETWORK_ERROR" || err2.code === "REFRESH_FAILED" && err2.reason === "network") {
+        return sdkCore.passkeyError("PASSKEY_NETWORK_ERROR", err2.message);
+      }
+      return expired();
+    }
+    const user = sdkCore.decodeUser(token.token);
+    if (user === null) return expired();
+    return { accessToken: token.token, userId: user.id };
+  }, [getToken]);
+  const runAction = react.useCallback(
+    async (key, guarded, run, onSuccess) => {
+      const refuse = (result) => {
+        if (!result.ok && mountedRef.current) setError(result.error);
+        return result;
+      };
+      if (busyRef.current[key]) return refuse(guarded);
+      const isCeremony = CEREMONY_ACTIONS.has(key);
+      if (isCeremony && !passkeyCeremonyLock.tryAcquire()) return refuse(guarded);
+      setBusy(key, true);
+      setError(null);
+      const controller = new AbortController();
+      inFlightRef.current.add(controller);
+      try {
+        const result = await run(controller.signal);
+        if (!result.ok && mountedRef.current) setError(result.error);
+        if (result.ok && mountedRef.current) onSuccess?.(result);
+        return result;
+      } finally {
+        inFlightRef.current.delete(controller);
+        busyRef.current[key] = false;
+        if (isCeremony) passkeyCeremonyLock.release();
+        if (mountedRef.current) setBusy(key, false);
+      }
+    },
+    [passkeyCeremonyLock, setBusy]
+  );
+  const busyResult = react.useCallback(
+    (action) => ({
+      ok: false,
+      error: sdkCore.passkeyError("PASSKEY_INVALID_INPUT", `a passkey ${action} is already in progress`)
+    }),
+    []
+  );
+  const unsupported = react.useCallback(() => {
+    const result = { ok: false, error: notSupported() };
+    if (mountedRef.current) setError(result.error);
+    return Promise.resolve(result);
+  }, []);
+  const sessionFailure = (session) => !("accessToken" in session);
+  const signInWithPasskey = react.useCallback(
+    (input = {}) => {
+      if (adapter === void 0) return unsupported();
+      return runAction("signIn", busyResult("sign-in"), async (signal) => {
+        const result = await sdkCore.assertPasskey({
+          http,
+          baseUrl,
+          clientId: publishableKey,
+          adapter,
+          ...input.userHandle === void 0 ? {} : { userHandle: input.userHandle },
+          signal
+        });
+        if (!result.ok) return result;
+        const failed = (message) => ({
+          ok: false,
+          error: sdkCore.passkeyError("PASSKEY_REQUEST_FAILED", message)
+        });
+        let nonce;
+        try {
+          nonce = await beginAuthFlow();
+        } catch (err2) {
+          return failed(
+            `the passkey was accepted but the session could not be started: ${err2 instanceof Error ? err2.message : "unknown error"}`
+          );
+        }
+        const tokens = result.tokens;
+        if (nativeAdapter.dpopProver !== void 0 && tokens.token_type !== "DPoP") {
+          return failed(
+            "the passkey was accepted but the session was refused: this app is configured for sender-constrained (DPoP) sessions, and the passkey sign-in returned an unbound bearer session. Storing it would silently downgrade the app\u2019s security posture."
+          );
+        }
+        try {
+          await submitOAuthTokens(tokens, nonce);
+        } catch (err2) {
+          return failed(
+            `the passkey was accepted but the session could not be stored: ${err2 instanceof Error ? err2.message : "unknown error"}`
+          );
+        }
+        const confirmed = await getToken();
+        if (!confirmed.ok) {
+          return failed(
+            "the passkey was accepted but the session was not established (the token submission was rejected)"
+          );
+        }
+        const submitted = sessionIdentity(tokens.access_token);
+        const live = sessionIdentity(confirmed.token);
+        if (submitted === null || live === null) {
+          if (confirmed.token !== tokens.access_token) {
+            return failed("the passkey was accepted but the resulting session token could not be read");
+          }
+          return result;
+        }
+        if (live.subject !== submitted.subject || live.session !== submitted.session) {
+          return failed(
+            "the passkey was accepted but the session was not established (the token submission was rejected)"
+          );
+        }
+        return result;
+      });
+    },
+    [
+      adapter,
+      baseUrl,
+      beginAuthFlow,
+      busyResult,
+      getToken,
+      http,
+      publishableKey,
+      runAction,
+      submitOAuthTokens,
+      unsupported
+    ]
+  );
+  const stepUpWithPasskey = react.useCallback(() => {
+    if (adapter === void 0) return unsupported();
+    return runAction("stepUp", busyResult("step-up"), async (signal) => {
+      const session = await requireSession();
+      if (sessionFailure(session)) return { ok: false, error: session };
+      return sdkCore.stepUpWithPasskey({
+        http,
+        baseUrl,
+        clientId: publishableKey,
+        accessToken: session.accessToken,
+        adapter,
+        signal
+      });
+    });
+  }, [adapter, baseUrl, busyResult, http, publishableKey, requireSession, runAction, unsupported]);
+  const registerPasskey = react.useCallback(
+    (input) => {
+      if (adapter === void 0) return unsupported();
+      return runAction("register", busyResult("registration"), async (signal) => {
+        const session = await requireSession();
+        if (sessionFailure(session)) return { ok: false, error: session };
+        return sdkCore.registerPasskey({
+          http,
+          baseUrl,
+          clientId: publishableKey,
+          accessToken: session.accessToken,
+          stepUpToken: input.stepUpToken,
+          adapter,
+          ...input.nickname === void 0 ? {} : { nickname: input.nickname },
+          signal
+        });
+      });
+    },
+    [adapter, baseUrl, busyResult, http, publishableKey, requireSession, runAction, unsupported]
+  );
+  const listPasskeys = react.useCallback(
+    (input) => runAction(
+      "list",
+      busyResult("list"),
+      async (signal) => {
+        const session = await requireSession();
+        if (sessionFailure(session)) return { ok: false, error: session };
+        return sdkCore.listPasskeys({
+          http,
+          baseUrl,
+          clientId: publishableKey,
+          accessToken: session.accessToken,
+          stepUpToken: input.stepUpToken,
+          userId: session.userId,
+          signal
+        });
+      },
+      (result) => {
+        if (result.ok) setPasskeys(result.data);
+      }
+    ),
+    [baseUrl, busyResult, http, publishableKey, requireSession, runAction]
+  );
+  const renamePasskey = react.useCallback(
+    (input) => runAction(
+      "mutate",
+      busyResult("mutation"),
+      async (signal) => {
+        const session = await requireSession();
+        if (sessionFailure(session)) return { ok: false, error: session };
+        return sdkCore.renamePasskey({
+          http,
+          baseUrl,
+          clientId: publishableKey,
+          accessToken: session.accessToken,
+          stepUpToken: input.stepUpToken,
+          userId: session.userId,
+          passkeyId: input.passkeyId,
+          nickname: input.nickname,
+          signal
+        });
+      },
+      (result) => {
+        if (!result.ok) return;
+        setPasskeys(
+          (current) => current?.map((passkey) => passkey.id === result.passkey.id ? result.passkey : passkey)
+        );
+      }
+    ),
+    [baseUrl, busyResult, http, publishableKey, requireSession, runAction]
+  );
+  const deletePasskey = react.useCallback(
+    (input) => runAction(
+      "mutate",
+      busyResult("mutation"),
+      async (signal) => {
+        const session = await requireSession();
+        if (sessionFailure(session)) return { ok: false, error: session };
+        return sdkCore.deletePasskey({
+          http,
+          baseUrl,
+          clientId: publishableKey,
+          accessToken: session.accessToken,
+          stepUpToken: input.stepUpToken,
+          userId: session.userId,
+          passkeyId: input.passkeyId,
+          signal
+        });
+      },
+      (result) => {
+        if (result.ok) {
+          setPasskeys((current) => current?.filter((passkey) => passkey.id !== input.passkeyId));
+        }
+      }
+    ),
+    [baseUrl, busyResult, http, publishableKey, requireSession, runAction]
+  );
+  return {
+    isSupported,
+    hasPlatformAuthenticator,
+    passkeys,
+    error,
+    isSigningIn,
+    isRegistering,
+    isSteppingUp,
+    isLoading,
+    isMutating,
+    signInWithPasskey,
+    stepUpWithPasskey,
+    registerPasskey,
+    listPasskeys,
+    renamePasskey,
+    deletePasskey
+  };
+}
 
 // src/hooks/use-submit-oauth-tokens.ts
 function useSubmitOAuthTokens() {
@@ -2014,6 +2717,10 @@ Object.defineProperty(exports, "base64url", {
   enumerable: true,
   get: function () { return sdkCore.base64url; }
 });
+Object.defineProperty(exports, "createAuthorizationEndpointCache", {
+  enumerable: true,
+  get: function () { return sdkCore.createAuthorizationEndpointCache; }
+});
 Object.defineProperty(exports, "createTranslator", {
   enumerable: true,
   get: function () { return sdkCore.createTranslator; }
@@ -2030,6 +2737,10 @@ Object.defineProperty(exports, "decodeUser", {
   enumerable: true,
   get: function () { return sdkCore.decodeUser; }
 });
+Object.defineProperty(exports, "deriveAuthorizationEndpointFallback", {
+  enumerable: true,
+  get: function () { return sdkCore.deriveAuthorizationEndpointFallback; }
+});
 Object.defineProperty(exports, "generatePkce", {
   enumerable: true,
   get: function () { return sdkCore.generatePkce; }
@@ -2085,6 +2796,7 @@ exports.UserProfile = UserProfile;
 exports.createDefaultExpoAdapter = createDefaultExpoAdapter;
 exports.createDpopSession = createDpopSession;
 exports.createNativeDpopProver = createNativeDpopProver;
+exports.createNativePasskeyAdapter = createNativePasskeyAdapter;
 exports.createRnHttpClient = createRnHttpClient;
 exports.startSocialSignIn = startSocialSignIn;
 exports.useAnonymousSignin = useAnonymousSignin;
@@ -2100,6 +2812,7 @@ exports.useMagicLink = useMagicLink;
 exports.useMfa = useMfa;
 exports.useOrganization = useOrganization;
 exports.useOrganizationList = useOrganizationList;
+exports.usePasskeys = usePasskeys;
 exports.useRegister = useRegister;
 exports.useSession = useSession;
 exports.useSubmitOAuthTokens = useSubmitOAuthTokens;