@iqauth/sdk 2.6.4 → 2.7.0

package/dist/browser.d.mts

@@ -1,8 +1,8 @@
-import { S as SessionManager } from './signIn-CiIBTJIh.mjs';
-export { n as AccountRecord, A as AccountRegistry, C as CallbackResult, k as LinkProviderInput, L as LinkedIdentity, M as MagicLinkRequestInput, m as MultiAccountTokenStore, j as PasskeyAuthInput, P as PasswordlessOptions, z as REFRESH_COOKIE, R as RefreshTokenStore, a as SessionManagerOptions, b as SessionSnapshot, c as SessionStatus, x as SignInOptions, y as SignOutOptions, U as UnlinkProviderInput, d as beginPasskeyAuthentication, e as beginPasskeyRegistration, o as buildSignInUrl, B as clearCookie, h as enrollPasskey, f as finishPasskeyAuthentication, g as finishPasskeyRegistration, D as getCookie, p as handleAuthCallback, i as linkProvider, l as listLinkedIdentities, q as redirectToSignIn, r as requestMagicLink, E as setCookie, t as signIn, s as signInWithPasskey, w as signOut, u as unlinkProvider, v as verifyMagicLink } from './signIn-CiIBTJIh.mjs';
-export { K as KeyMode, c as ParsedPublishableKey, P as PublishableKeyPayload, e as encodePublishableKey, i as isPublishableKey, b as isSecretKey, p as parsePublishableKey } from './publishableKey-BaR0HoAH.mjs';
-export { a as ErrorCode, E as ErrorCodes, I as IQAuthError } from './errors-CDdl24MP.mjs';
-import './types-DZAflmmq.mjs';
+import { S as SessionManager } from './signIn-T-CZ6t6r.mjs';
+export { p as AccountRecord, A as AccountRegistry, C as CallbackResult, d as LinkProviderInput, L as LinkedIdentity, M as MagicLinkRequestInput, o as MultiAccountTokenStore, n as PasskeyAuthInput, P as PasswordlessOptions, z as REFRESH_COOKIE, R as RefreshTokenStore, e as SessionManagerOptions, a as SessionSnapshot, f as SessionStatus, b as SignInOptions, c as SignOutOptions, U as UnlinkProviderInput, g as beginPasskeyAuthentication, i as beginPasskeyRegistration, q as buildSignInUrl, B as clearCookie, k as enrollPasskey, h as finishPasskeyAuthentication, j as finishPasskeyRegistration, D as getCookie, t as handleAuthCallback, m as linkProvider, l as listLinkedIdentities, w as redirectToSignIn, r as requestMagicLink, E as setCookie, x as signIn, s as signInWithPasskey, y as signOut, u as unlinkProvider, v as verifyMagicLink } from './signIn-T-CZ6t6r.mjs';
+export { K as KeyMode, c as ParsedPublishableKey, P as PublishableKeyPayload, e as encodePublishableKey, i as isPublishableKey, b as isSecretKey, p as parsePublishableKey } from './publishableKey-f2kq-rKw.mjs';
+export { b as ErrorCode, E as ErrorCodes, I as IQAuthError } from './errors-Jl1Jtm-6.mjs';
+import './types-XOV9XPVi.mjs';
 
 /**
  * Browser-safe PKCE + state/nonce generation using WebCrypto.

package/dist/browser.d.ts

@@ -1,8 +1,8 @@
-import { S as SessionManager } from './signIn-OCr88Zf8.js';
-export { n as AccountRecord, A as AccountRegistry, C as CallbackResult, k as LinkProviderInput, L as LinkedIdentity, M as MagicLinkRequestInput, m as MultiAccountTokenStore, j as PasskeyAuthInput, P as PasswordlessOptions, z as REFRESH_COOKIE, R as RefreshTokenStore, a as SessionManagerOptions, b as SessionSnapshot, c as SessionStatus, x as SignInOptions, y as SignOutOptions, U as UnlinkProviderInput, d as beginPasskeyAuthentication, e as beginPasskeyRegistration, o as buildSignInUrl, B as clearCookie, h as enrollPasskey, f as finishPasskeyAuthentication, g as finishPasskeyRegistration, D as getCookie, p as handleAuthCallback, i as linkProvider, l as listLinkedIdentities, q as redirectToSignIn, r as requestMagicLink, E as setCookie, t as signIn, s as signInWithPasskey, w as signOut, u as unlinkProvider, v as verifyMagicLink } from './signIn-OCr88Zf8.js';
-export { K as KeyMode, c as ParsedPublishableKey, P as PublishableKeyPayload, e as encodePublishableKey, i as isPublishableKey, b as isSecretKey, p as parsePublishableKey } from './publishableKey-BaR0HoAH.js';
-export { a as ErrorCode, E as ErrorCodes, I as IQAuthError } from './errors-CDdl24MP.js';
-import './types-DZAflmmq.js';
+import { S as SessionManager } from './signIn-BLFnz8SV.js';
+export { p as AccountRecord, A as AccountRegistry, C as CallbackResult, d as LinkProviderInput, L as LinkedIdentity, M as MagicLinkRequestInput, o as MultiAccountTokenStore, n as PasskeyAuthInput, P as PasswordlessOptions, z as REFRESH_COOKIE, R as RefreshTokenStore, e as SessionManagerOptions, a as SessionSnapshot, f as SessionStatus, b as SignInOptions, c as SignOutOptions, U as UnlinkProviderInput, g as beginPasskeyAuthentication, i as beginPasskeyRegistration, q as buildSignInUrl, B as clearCookie, k as enrollPasskey, h as finishPasskeyAuthentication, j as finishPasskeyRegistration, D as getCookie, t as handleAuthCallback, m as linkProvider, l as listLinkedIdentities, w as redirectToSignIn, r as requestMagicLink, E as setCookie, x as signIn, s as signInWithPasskey, y as signOut, u as unlinkProvider, v as verifyMagicLink } from './signIn-BLFnz8SV.js';
+export { K as KeyMode, c as ParsedPublishableKey, P as PublishableKeyPayload, e as encodePublishableKey, i as isPublishableKey, b as isSecretKey, p as parsePublishableKey } from './publishableKey-f2kq-rKw.js';
+export { b as ErrorCode, E as ErrorCodes, I as IQAuthError } from './errors-Jl1Jtm-6.js';
+import './types-XOV9XPVi.js';
 
 /**
  * Browser-safe PKCE + state/nonce generation using WebCrypto.

package/dist/browser.js

@@ -444,13 +444,30 @@ __export(browser_exports, {
 module.exports = __toCommonJS(browser_exports);
 
 // src/errors.ts
-var IQAuthError = class extends Error {
-  constructor(code, message, status, raw) {
+var IQAuthError = class _IQAuthError extends Error {
+  constructor(code, message, status, cause) {
     super(message);
     this.name = "IQAuthError";
     this.code = code;
     this.status = status;
-    this.raw = raw;
+    this.cause = cause;
+    this.raw = cause;
+  }
+  /**
+   * Type guard: true when `value` is an `IQAuthError`. Useful for adapters
+   * that round-trip errors through `unknown` (e.g. fastify's `setErrorHandler`).
+   */
+  static isIQAuthError(value) {
+    return value instanceof _IQAuthError || typeof value === "object" && value !== null && value.name === "IQAuthError" && typeof value.code === "string";
+  }
+  /**
+   * Type-narrowed code check. Lets callers write
+   * `if (err.is("token_expired")) …` with full IntelliSense for the typed
+   * taxonomy without losing the ability to handle server codes via
+   * `err.code === "TOKEN_REVOKED"`.
+   */
+  is(code) {
+    return this.code === code;
   }
 };
 var ErrorCodes = {
@@ -549,14 +566,14 @@ function assertPublishableKey(raw, opts) {
   const ctx = opts?.context ? `${opts.context}: ` : "";
   if (typeof raw !== "string" || raw.length === 0) {
     throw new IQAuthError(
-      "CONFIG_INVALID",
+      "config_invalid",
       `${ctx}IQAuth publishable key is missing. Set IQAUTH_PUBLISHABLE_KEY (or pass publishableKey) to a pk_test_\u2026 or pk_live_\u2026 value from the IQAuth admin console.`
     );
   }
   const shapeMatch = raw.match(/^pk_(test|live)_([A-Za-z0-9_-]+)$/);
   if (!shapeMatch) {
     throw new IQAuthError(
-      "CONFIG_INVALID",
+      "config_invalid",
       `${ctx}IQAuth publishable key is malformed (got ${raw.slice(0, 12)}\u2026). Expected pk_test_\u2026 or pk_live_\u2026; regenerate the key from the IQAuth admin console.`
     );
   }
@@ -565,19 +582,19 @@ function assertPublishableKey(raw, opts) {
     decoded = JSON.parse(b64urlDecode(shapeMatch[2]));
   } catch {
     throw new IQAuthError(
-      "CONFIG_INVALID",
+      "config_invalid",
       `${ctx}IQAuth publishable key payload is not valid base64url JSON. Regenerate the key from the IQAuth admin console.`
     );
   }
   if (!isPublishableKeyPayload(decoded)) {
     throw new IQAuthError(
-      "CONFIG_INVALID",
+      "config_invalid",
       `${ctx}IQAuth publishable key payload is missing required fields {iss, appId, tenantId, kid}. Regenerate the key from the IQAuth admin console.`
     );
   }
   if (!isValidIssuerUrl(decoded.iss)) {
     throw new IQAuthError(
-      "CONFIG_INVALID",
+      "config_invalid",
       `${ctx}IQAuth publishable key encodes an invalid issuer (iss=${JSON.stringify(decoded.iss)}). Expected a fully-qualified URL like "https://auth.example.com" (scheme required). Regenerate the key from the IQAuth admin console \u2014 the new key will encode a valid issuer URL.`
     );
   }
@@ -656,6 +673,7 @@ function clearPkce(state) {
 }
 
 // src/browser/sessionManager.ts
+var PROBE_WAIT_MS = 80;
 var DEFAULT_REFRESH_PATH = "/api/v1/auth/refresh";
 var DEFAULT_USERINFO_PATH = "/api/v1/auth/me";
 async function readAuthErrorCode(res) {
@@ -693,7 +711,13 @@ function claimsToSessionUser(claims) {
     tenantId: claims.tenantId,
     vendorId: claims.vendorId,
     roles: claims.roles ?? [],
-    entitlements: claims.entitlements ?? []
+    entitlements: claims.entitlements ?? [],
+    // SDK 2.7.0 (Task #124) — pass through identity claims when issued.
+    ...claims.picture !== void 0 ? { picture: claims.picture } : {},
+    ...claims.email_verified !== void 0 ? { emailVerified: claims.email_verified } : {},
+    ...claims.given_name !== void 0 ? { givenName: claims.given_name } : {},
+    ...claims.family_name !== void 0 ? { familyName: claims.family_name } : {},
+    ...claims.locale !== void 0 ? { locale: claims.locale } : {}
   };
 }
 var EMPTY = {
@@ -717,11 +741,50 @@ var NO_OP_STORE = {
   write: () => void 0,
   clear: () => void 0
 };
+var IDEMPOTENCY_HEADER = "X-IQAuth-Idempotency";
+function randomIdempotencyToken() {
+  if (typeof crypto !== "undefined" && typeof crypto.getRandomValues === "function") {
+    const bytes = new Uint8Array(16);
+    crypto.getRandomValues(bytes);
+    let out = "";
+    for (const b of bytes) out += b.toString(16).padStart(2, "0");
+    return out;
+  }
+  return Math.random().toString(36).slice(2) + Math.random().toString(36).slice(2);
+}
 var SessionManager = class {
   constructor(options) {
     this.snapshot = { ...EMPTY };
     this.listeners = /* @__PURE__ */ new Set();
     this.refreshPromise = null;
+    /**
+     * Cancellation handle for the in-flight refresh, if any. `signOut()` (or a
+     * `session:signout` broadcast from another tab) calls `abort()` so the
+     * refresh response is dropped before it can write a fresh access cookie
+     * on top of the just-cleared session — the second root cause of "ghost
+     * signed-in" sessions after Sign Out.
+     */
+    this.refreshAbort = null;
+    /**
+     * Set to `true` by `signOut()` / `signOutLocal()` for the lifetime of the
+     * call. Used as a safety belt: even if a refresh response arrives while
+     * `refreshAbort` was unable to interrupt the network call (e.g. the body
+     * was already streaming back), `runRefresh` checks this flag before
+     * mutating session state and bails out.
+     */
+    this.signoutInProgress = false;
+    /**
+     * Per-session opaque idempotency token. Sent as `X-IQAuth-Idempotency` on
+     * every /refresh and /signout request the SDK makes through a framework
+     * adapter (Express/Fastify/Hono/Next), so the adapter's `SignoutRegistry`
+     * can collapse a refresh that lands moments after a signout — even when
+     * the two requests are routed to different server instances (multi-replica
+     * deployments).
+     *
+     * Generated lazily on first use, rotated on signout so the next session
+     * starts with a fresh token. Opaque random — never the raw refresh token.
+     */
+    this.idempotencyToken = null;
     this.channel = null;
     this.proactiveTimer = null;
     this.bootstrapped = false;
@@ -729,6 +792,8 @@ var SessionManager = class {
     this.remoteRefreshWaiters = [];
     /** Active claims by other tabs (keyed by source tabId). */
     this.foreignClaim = null;
+    /** Resolver for an in-flight cross-tab `session:probe`, set during bootstrap. */
+    this.probeResolver = null;
     const parsed = assertPublishableKey(options.publishableKey, { context: "@iqauth/sdk/browser SessionManager" });
     this.key = parsed;
     const inferred = options.issuer ?? (parsed.iss.startsWith("http") ? parsed.iss : `https://${parsed.iss}`);
@@ -741,6 +806,8 @@ var SessionManager = class {
     this.refreshCookieName = options.cookieNames?.refresh ?? REFRESH_COOKIE;
     this.tokenStore = options.tokenStore ?? (this.serverManagedSession ? NO_OP_STORE : this.useCookies ? defaultCookieStore(this.refreshCookieName) : NO_OP_STORE);
     this.crossTabLockTimeoutMs = options.crossTabLockTimeoutMs ?? 4e3;
+    this.debug = options.debug ?? false;
+    this.onTimingEvent = options.onTimingEvent ?? null;
     this.fetchImpl = options.fetchImpl ?? (typeof fetch !== "undefined" ? fetch.bind(globalThis) : (() => {
       throw new Error("global fetch is not available; pass fetchImpl");
     }));
@@ -767,10 +834,35 @@ var SessionManager = class {
   get issuerUrl() {
     return this.issuer;
   }
+  /**
+   * SDK 2.7.0 (Task #124) — The hosted IQAuth host derived from the
+   * publishable key's `iss` claim, normalized to URL form. This is what
+   * `<SignIn/>` and `buildSignInUrl` use to talk to the hosted UI; it
+   * deliberately ignores the `issuer` constructor override so a misrouted
+   * `issuer` (e.g. pointed at the consumer app's own domain) cannot break
+   * the hosted flow. Use {@link issuerUrl} for token / discovery endpoints.
+   */
+  get hostedIssuerUrl() {
+    const iss = this.key.iss;
+    return (iss.startsWith("http") ? iss : `https://${iss}`).replace(/\/+$/, "");
+  }
   /** Cookie name the SDK uses for the refresh token (overridable via `cookieNames.refresh`). */
   get refreshCookie() {
     return this.refreshCookieName;
   }
+  /**
+   * Returns the current per-session idempotency token, generating one
+   * lazily on first use. Sent as the `X-IQAuth-Idempotency` header on
+   * /refresh and /signout requests so the framework adapter's
+   * `SignoutRegistry` can collapse a refresh-vs-signout race even across
+   * server instances.
+   */
+  getIdempotencyToken() {
+    if (!this.idempotencyToken) {
+      this.idempotencyToken = randomIdempotencyToken();
+    }
+    return this.idempotencyToken;
+  }
   getSnapshot() {
     return this.snapshot;
   }
@@ -784,9 +876,44 @@ var SessionManager = class {
    * One-time bootstrap: warm the session from the refresh cookie if present.
    * Safe to call multiple times.
    */
+  /**
+   * Task #126: Public timing-event emitter. Used by the browser sign-in
+   * helpers (redirectToSignIn / handleAuthCallback) to surface signIn-phase
+   * timings through the same `debug` + `onTimingEvent` channel as
+   * bootstrap/refresh. Safe to call from anywhere — internal callers
+   * pre-compute durationMs.
+   */
+  recordTiming(phase, durationMs, ok, code) {
+    this.emitTiming(phase, durationMs, ok, code);
+  }
+  /** Task #126: emit a session timing event to debug log + onTimingEvent hook. */
+  emitTiming(phase, durationMs, ok, code) {
+    if (this.debug) {
+      try {
+        console.debug("[iqauth_session]", { phase, durationMs, ok, code });
+      } catch {
+      }
+    }
+    if (this.onTimingEvent) {
+      try {
+        this.onTimingEvent({ phase, durationMs, ok, code });
+      } catch {
+      }
+    }
+  }
   async bootstrap() {
     if (this.bootstrapped) return;
     this.bootstrapped = true;
+    const t0 = Date.now();
+    try {
+      await this.bootstrapInner();
+      this.emitTiming("bootstrap", Date.now() - t0, this.snapshot.status === "authenticated");
+    } catch (err) {
+      this.emitTiming("bootstrap", Date.now() - t0, false, err instanceof Error ? err.message : "ERROR");
+      throw err;
+    }
+  }
+  async bootstrapInner() {
     if (this.serverManagedSession) {
       try {
         const res = await this.fetchImpl(`${this.issuer}${this.userinfoPath}`, {
@@ -821,6 +948,15 @@ var SessionManager = class {
         return;
       }
     }
+    const peerSnapshot = await this.probePeers();
+    if (peerSnapshot && peerSnapshot.status === "authenticated") {
+      this.update({
+        ...peerSnapshot,
+        version: Math.max(this.snapshot.version, peerSnapshot.version) + 1
+      });
+      this.scheduleProactiveRefresh();
+      return;
+    }
     const stored = await Promise.resolve(this.tokenStore.read());
     if (!stored) {
       this.setStatus("unauthenticated");
@@ -829,6 +965,22 @@ var SessionManager = class {
     const ok = await this.refresh();
     if (!ok) this.setStatus("unauthenticated");
   }
+  probePeers() {
+    if (!this.channel) return Promise.resolve(null);
+    return new Promise((resolve) => {
+      let settled = false;
+      const finish = (snap) => {
+        if (settled) return;
+        settled = true;
+        this.probeResolver = null;
+        clearTimeout(timer);
+        resolve(snap);
+      };
+      this.probeResolver = (snap) => finish(snap);
+      const timer = setTimeout(() => finish(null), PROBE_WAIT_MS);
+      this.broadcastEnvelope({ type: "session:probe", source: this.tabId, ts: Date.now() });
+    });
+  }
   /**
    * Single-flight token refresh, coordinated across tabs via BroadcastChannel.
    *
@@ -842,30 +994,48 @@ var SessionManager = class {
    */
   refresh() {
     if (this.refreshPromise) return this.refreshPromise;
-    this.refreshPromise = this.runRefresh().finally(() => {
+    const t0 = Date.now();
+    this.refreshPromise = this.runRefresh().then((ok) => {
+      this.emitTiming("refresh", Date.now() - t0, ok, ok ? void 0 : this.snapshot.error?.code ?? "REFRESH_FAILED");
+      return ok;
+    }).finally(() => {
       this.refreshPromise = null;
     });
     return this.refreshPromise;
   }
   async runRefresh() {
-    const myClaim = { source: this.tabId, ts: Date.now() };
-    if (this.channel) {
-      this.broadcastEnvelope({ type: "refresh:claim", source: myClaim.source, ts: myClaim.ts });
-      await new Promise((r) => setTimeout(r, 25));
-      const foreign = this.foreignClaim;
-      if (foreign && this.claimWins(foreign, myClaim)) {
-        return this.waitForForeignRefresh();
-      }
-    }
+    const abort = new AbortController();
+    this.refreshAbort = abort;
     try {
+      const myClaim = { source: this.tabId, ts: Date.now() };
+      if (this.channel) {
+        this.broadcastEnvelope({ type: "refresh:claim", source: myClaim.source, ts: myClaim.ts });
+        await new Promise((r) => setTimeout(r, 25));
+        if (abort.signal.aborted || this.signoutInProgress) {
+          this.broadcastEnvelope({ type: "refresh:done", source: this.tabId, ts: Date.now(), ok: false });
+          return false;
+        }
+        const foreign = this.foreignClaim;
+        if (foreign && this.claimWins(foreign, myClaim)) {
+          return this.waitForForeignRefresh();
+        }
+      }
       const refreshToken = await Promise.resolve(this.tokenStore.read());
       const res = await this.fetchImpl(`${this.issuer}${this.refreshPath}`, {
         method: "POST",
         credentials: "include",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(refreshToken ? { refreshToken } : {})
+        headers: {
+          "Content-Type": "application/json",
+          [IDEMPOTENCY_HEADER]: this.getIdempotencyToken()
+        },
+        body: JSON.stringify(refreshToken ? { refreshToken } : {}),
+        signal: abort.signal
       });
       const body = await res.json().catch(() => ({}));
+      if (this.signoutInProgress || abort.signal.aborted) {
+        this.broadcastEnvelope({ type: "refresh:done", source: this.tabId, ts: Date.now(), ok: false });
+        return false;
+      }
       const data = body.data;
       if (!res.ok || !body.success || !data?.accessToken) {
         const err = body.error;
@@ -884,14 +1054,18 @@ var SessionManager = class {
       this.broadcastEnvelope({ type: "refresh:done", source: this.tabId, ts: Date.now(), ok: true });
       return true;
     } catch (err) {
-      this.setError({
-        code: "NETWORK_ERROR",
-        message: err instanceof Error ? err.message : "Refresh request failed"
-      });
+      const aborted = err?.name === "AbortError" || abort.signal.aborted || this.signoutInProgress;
+      if (!aborted) {
+        this.setError({
+          code: "NETWORK_ERROR",
+          message: err instanceof Error ? err.message : "Refresh request failed"
+        });
+      }
       this.broadcastEnvelope({ type: "refresh:done", source: this.tabId, ts: Date.now(), ok: false });
       return false;
     } finally {
       this.foreignClaim = null;
+      if (this.refreshAbort === abort) this.refreshAbort = null;
     }
   }
   claimWins(foreign, mine) {
@@ -999,6 +1173,14 @@ var SessionManager = class {
    * the server-side logout request.
    */
   signOutLocal(status = "unauthenticated") {
+    this.signoutInProgress = true;
+    if (this.refreshAbort) {
+      try {
+        this.refreshAbort.abort();
+      } catch {
+      }
+      this.refreshAbort = null;
+    }
     void Promise.resolve(this.tokenStore.clear());
     if (this.proactiveTimer) {
       clearTimeout(this.proactiveTimer);
@@ -1013,7 +1195,12 @@ var SessionManager = class {
       error: null,
       version: this.snapshot.version + 1
     });
+    this.broadcastEnvelope({ type: "refresh:abort", source: this.tabId, ts: Date.now() });
     this.broadcast("session:signout");
+    this.idempotencyToken = null;
+    setTimeout(() => {
+      this.signoutInProgress = false;
+    }, 0);
   }
   /**
    * Replace the refresh-token store at runtime. Used by the F22
@@ -1077,6 +1264,12 @@ var SessionManager = class {
   }
   onBroadcast(env) {
     if (!env || env.source === this.tabId) return;
+    if (env.type === "session:probe") {
+      if (this.snapshot.status === "authenticated") {
+        this.broadcast("session:update");
+      }
+      return;
+    }
     if (env.type === "refresh:claim") {
       this.foreignClaim = { source: env.source, ts: env.ts };
       return;
@@ -1089,6 +1282,24 @@ var SessionManager = class {
       this.foreignClaim = null;
       return;
     }
+    if (env.type === "refresh:abort") {
+      this.signoutInProgress = true;
+      if (this.refreshAbort) {
+        try {
+          this.refreshAbort.abort();
+        } catch {
+        }
+        this.refreshAbort = null;
+      }
+      const waiters = this.remoteRefreshWaiters;
+      this.remoteRefreshWaiters = [];
+      for (const w of waiters) w(false);
+      this.foreignClaim = null;
+      setTimeout(() => {
+        this.signoutInProgress = false;
+      }, 0);
+      return;
+    }
     if (env.type === "session:signout") {
       this.update({
         status: "unauthenticated",
@@ -1102,6 +1313,12 @@ var SessionManager = class {
       return;
     }
     if ((env.type === "session:update" || env.type === "session:refresh") && env.payload) {
+      if (this.probeResolver && env.payload.status === "authenticated") {
+        const r = this.probeResolver;
+        this.probeResolver = null;
+        r(env.payload);
+        return;
+      }
       this.update({
         ...env.payload,
         version: Math.max(this.snapshot.version, env.payload.version) + 1
@@ -1386,7 +1603,7 @@ async function buildSignInUrl(manager, opts = {}) {
     returnTo,
     createdAt: Date.now()
   });
-  const url2 = new URL(opts.signInPath ?? DEFAULT_SIGN_IN_PATH, manager.issuerUrl);
+  const url2 = new URL(opts.signInPath ?? DEFAULT_SIGN_IN_PATH, manager.hostedIssuerUrl);
   url2.searchParams.set("response_type", "code");
   url2.searchParams.set("app", manager.appKey);
   url2.searchParams.set("publishable_key", manager.publishableKey.raw);
@@ -1401,33 +1618,50 @@ async function buildSignInUrl(manager, opts = {}) {
   return url2.toString();
 }
 async function redirectToSignIn(manager, opts = {}) {
-  const url2 = await buildSignInUrl(manager, opts);
-  if (typeof window === "undefined") {
-    throw new Error("redirectToSignIn requires a browser environment");
+  const t0 = Date.now();
+  let ok = false;
+  let code;
+  try {
+    const url2 = await buildSignInUrl(manager, opts);
+    if (typeof window === "undefined") {
+      code = "NO_WINDOW";
+      throw new Error("redirectToSignIn requires a browser environment");
+    }
+    ok = true;
+    manager.recordTiming("signIn", Date.now() - t0, true);
+    window.location.assign(url2);
+  } catch (err) {
+    if (!ok) manager.recordTiming("signIn", Date.now() - t0, false, code ?? (err instanceof Error ? err.message : "ERROR"));
+    throw err;
   }
-  window.location.assign(url2);
 }
 async function signIn(manager, opts = {}) {
   return redirectToSignIn(manager, opts);
 }
 async function handleAuthCallback(manager, options = {}) {
+  const t0 = Date.now();
+  const emit = (ok, code2) => manager.recordTiming("signIn", Date.now() - t0, ok, code2);
   const url2 = new URL(options.url ?? (typeof window !== "undefined" ? window.location.href : ""));
   const code = url2.searchParams.get("code");
   const state = url2.searchParams.get("state");
   const errorParam = url2.searchParams.get("error");
   if (errorParam) {
+    emit(false, errorParam);
     return { ok: false, returnTo: "/", error: errorParam };
   }
   if (!code || !state) {
+    emit(false, "missing_code_or_state");
     return { ok: false, returnTo: "/", error: "missing_code_or_state" };
   }
   const record = loadPkce(state);
   if (!record) {
+    emit(false, "unknown_state");
     return { ok: false, returnTo: "/", error: "unknown_state" };
   }
   clearPkce(state);
   const fetchImpl = options.fetchImpl ?? (typeof fetch !== "undefined" ? fetch.bind(globalThis) : null);
   if (!fetchImpl) {
+    emit(false, "no_fetch");
     return { ok: false, returnTo: record.returnTo, error: "no_fetch" };
   }
   const tokenUrl = `${manager.issuerUrl}${options.tokenPath ?? DEFAULT_TOKEN_PATH}`;
@@ -1446,10 +1680,12 @@ async function handleAuthCallback(manager, options = {}) {
   const body = await res.json().catch(() => ({}));
   if (!res.ok) {
     const desc = body.error_description ?? body.error ?? "token_exchange_failed";
+    emit(false, desc);
     return { ok: false, returnTo: record.returnTo, error: desc };
   }
   const tokens = body;
   if (!tokens.access_token) {
+    emit(false, "missing_access_token");
     return { ok: false, returnTo: record.returnTo, error: "missing_access_token" };
   }
   if (tokens.refresh_token) {
@@ -1457,21 +1693,24 @@ async function handleAuthCallback(manager, options = {}) {
     setCookie(cookieName, tokens.refresh_token, { maxAgeSeconds: 60 * 60 * 24 * 30 });
   }
   manager.applyAccessToken(tokens.access_token, tokens.refresh_token);
+  emit(true);
   return { ok: true, returnTo: record.returnTo };
 }
 async function signOut(manager, opts = {}) {
   if (!opts.localOnly) {
     const issuer = manager.issuerUrl.replace(/\/$/, "");
+    const idempotency = manager.getIdempotencyToken();
     try {
       const url2 = `${issuer}${opts.logoutPath ?? DEFAULT_LOGOUT_PATH}`;
-      await manager.fetch(url2, { method: "POST" }).catch(() => void 0);
+      await manager.fetch(url2, { method: "POST", headers: { "X-IQAuth-Idempotency": idempotency } }).catch(() => void 0);
     } catch {
     }
     if (opts.endSsoSession !== false) {
       try {
         await fetch(`${issuer}${DEFAULT_SSO_LOGOUT_PATH}`, {
           method: "POST",
-          credentials: "include"
+          credentials: "include",
+          headers: { "X-IQAuth-Idempotency": idempotency }
         }).catch(() => void 0);
       } catch {
       }

package/dist/browser.mjs

@@ -4,7 +4,7 @@ import {
   exitImpersonation,
   reverify,
   withReverification
-} from "./chunk-LIZYFXH7.mjs";
+} from "./chunk-DFWHSDYQ.mjs";
 import {
   AccountRegistry,
   MultiAccountTokenStore,
@@ -20,7 +20,7 @@ import {
   signInWithPasskey,
   unlinkProvider,
   verifyMagicLink
-} from "./chunk-XAWYUPMO.mjs";
+} from "./chunk-RTJAIBXY.mjs";
 import {
   REFRESH_COOKIE,
   buildSignInUrl,
@@ -31,7 +31,7 @@ import {
   setCookie,
   signIn,
   signOut
-} from "./chunk-DJIBN2N7.mjs";
+} from "./chunk-GN37E64I.mjs";
 import {
   createPkcePair,
   randomUrlSafe,
@@ -42,11 +42,11 @@ import {
   isPublishableKey,
   isSecretKey,
   parsePublishableKey
-} from "./chunk-WQWBJSSS.mjs";
+} from "./chunk-HVHNYPDC.mjs";
 import {
   ErrorCodes,
   IQAuthError
-} from "./chunk-6I6RM4MN.mjs";
+} from "./chunk-6PJRLRB4.mjs";
 import "./chunk-Y6FXYEAI.mjs";
 export {
   AccountRegistry,

package/dist/{chunk-6I6RM4MN.mjs → chunk-6PJRLRB4.mjs}

@@ -1,11 +1,40 @@
 // src/errors.ts
-var IQAuthError = class extends Error {
-  constructor(code, message, status, raw) {
+var IQ_AUTH_ERROR_CODES = [
+  "token_expired",
+  "token_invalid",
+  "jwks_unavailable",
+  "jwks_fetch_failed",
+  "rate_limited",
+  "network",
+  "config_invalid",
+  "app_not_found",
+  "permission_denied",
+  "unknown"
+];
+var IQAuthError = class _IQAuthError extends Error {
+  constructor(code, message, status, cause) {
     super(message);
     this.name = "IQAuthError";
     this.code = code;
     this.status = status;
-    this.raw = raw;
+    this.cause = cause;
+    this.raw = cause;
+  }
+  /**
+   * Type guard: true when `value` is an `IQAuthError`. Useful for adapters
+   * that round-trip errors through `unknown` (e.g. fastify's `setErrorHandler`).
+   */
+  static isIQAuthError(value) {
+    return value instanceof _IQAuthError || typeof value === "object" && value !== null && value.name === "IQAuthError" && typeof value.code === "string";
+  }
+  /**
+   * Type-narrowed code check. Lets callers write
+   * `if (err.is("token_expired")) …` with full IntelliSense for the typed
+   * taxonomy without losing the ability to handle server codes via
+   * `err.code === "TOKEN_REVOKED"`.
+   */
+  is(code) {
+    return this.code === code;
   }
 };
 var ErrorCodes = {
@@ -46,6 +75,7 @@ var ErrorCodes = {
 };
 
 export {
+  IQ_AUTH_ERROR_CODES,
   IQAuthError,
   ErrorCodes
 };

package/dist/{chunk-LIZYFXH7.mjs → chunk-DFWHSDYQ.mjs}

@@ -1,6 +1,6 @@
 import {
   IQAuthError
-} from "./chunk-6I6RM4MN.mjs";
+} from "./chunk-6PJRLRB4.mjs";
 
 // src/browser/reverify.ts
 var PRIOR_SESSION_STORAGE_KEY = "iqauth_prior_admin_session";