@classic-homes/auth 1.23.0 → 1.28.0

package/README.md

@@ -148,6 +148,27 @@ function handleSSOLogin(redirectUrl: string) {
 }
 ```
 
+`initiateSSOLogin` also sends a random `client_state`, kept in this tab's
+sessionStorage (single-use, 10-minute TTL). The API echoes it in the callback
+hash (`client_state`, in both the token and the MFA-challenge variants); check
+it **before** storing any tokens from the hash, so a crafted callback URL can't
+sign the user into someone else's account (login CSRF):
+
+```typescript
+import { verifySsoClientState } from '@classic-homes/auth/core';
+
+const params = new URLSearchParams(window.location.hash.slice(1));
+const { accepted, result } = verifySsoClientState(params); // 'ok' | 'mismatch' | 'missing'
+if (!accepted) {
+  window.history.replaceState({}, '', window.location.pathname);
+  throw new Error('This sign-in link was not started from this browser tab. Please sign in again.');
+}
+```
+
+Set `sso.requireClientState: true` once the API echoing `client_state` is
+deployed to that environment. Until then (the default) every result is
+accepted, so log `result` to watch the rollout.
+
 ### 5. MFA Challenge Verification
 
 ```typescript
@@ -395,6 +416,8 @@ interface AuthConfig {
     enabled: boolean;
     provider: string;
     authorizeUrl?: string;
+    /** Reject SSO callbacks whose client_state is missing or wrong (default false) */
+    requireClientState?: boolean;
   };
 
   /** Callback when auth errors occur */

package/dist/auth.svelte-JLSRQJAC.js

@@ -0,0 +1,3 @@
+export { authActions, authStore, currentUser, isAuthenticated } from './chunk-S3DNV7VV.js';
+import './chunk-GBYHYVXX.js';
+import './chunk-K6TV3ZVS.js';

package/dist/{chunk-ETKDIPD2.js → chunk-GBYHYVXX.js}

@@ -1,4 +1,101 @@
-import { getConfig, getStorage, isTokenExpired, getFetch, isValidRedirectUrl } from './chunk-2CYGQUUY.js';
+import { isInitialized, getConfig, getUserRoles, getStorage, isTokenExpired, getFetch, isValidRedirectUrl } from './chunk-K6TV3ZVS.js';
+
+// src/core/sso-state.ts
+var SSO_CLIENT_STATE_PARAM = "client_state";
+var SSO_CLIENT_STATE_TTL_MS = 10 * 60 * 1e3;
+function storageKey() {
+  const prefix = isInitialized() ? getConfig().storageKey ?? "classic_auth" : "classic_auth";
+  return `${prefix}_sso_client_state`;
+}
+function sessionStore() {
+  try {
+    return typeof globalThis.sessionStorage === "undefined" ? null : globalThis.sessionStorage;
+  } catch {
+    return null;
+  }
+}
+function randomUrlSafe(byteLength) {
+  const bytes = new Uint8Array(byteLength);
+  globalThis.crypto.getRandomValues(bytes);
+  let binary = "";
+  for (const byte of bytes) binary += String.fromCharCode(byte);
+  return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function createSsoClientState() {
+  const store = sessionStore();
+  if (!store) return null;
+  const value = randomUrlSafe(32);
+  const entry = { value, createdAt: Date.now() };
+  try {
+    store.setItem(storageKey(), JSON.stringify(entry));
+  } catch {
+    return null;
+  }
+  return value;
+}
+function takeStored() {
+  const store = sessionStore();
+  if (!store) return null;
+  const key = storageKey();
+  try {
+    const raw = store.getItem(key);
+    store.removeItem(key);
+    if (!raw) return null;
+    const parsed = JSON.parse(raw);
+    if (typeof parsed?.value !== "string" || typeof parsed.createdAt !== "number") return null;
+    return { value: parsed.value, createdAt: parsed.createdAt };
+  } catch {
+    return null;
+  }
+}
+function timingSafeEqual(a, b) {
+  if (a.length !== b.length) return false;
+  let diff = 0;
+  for (let i = 0; i < a.length; i++) diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
+  return diff === 0;
+}
+function consumeSsoClientState(received) {
+  const stored = takeStored();
+  if (!received) return "missing";
+  if (!stored) return "mismatch";
+  if (Date.now() - stored.createdAt > SSO_CLIENT_STATE_TTL_MS) return "mismatch";
+  return timingSafeEqual(stored.value, received) ? "ok" : "mismatch";
+}
+function verifySsoClientState(input) {
+  const received = input instanceof URLSearchParams ? input.get(SSO_CLIENT_STATE_PARAM) : input;
+  const result = consumeSsoClientState(received);
+  const required = isInitialized() && getConfig().sso?.requireClientState === true;
+  return { result, accepted: result === "ok" || !required };
+}
+
+// src/core/errors.ts
+var RoleDeniedError = class _RoleDeniedError extends Error {
+  constructor(user, requiredRoles, redirectTo) {
+    const userRoles = getUserRoles(user).join(", ") || "none";
+    super(
+      `User "${user.username}" does not have required role(s). Has: [${userRoles}], Required: [${requiredRoles.join(", ")}]`
+    );
+    this.name = "RoleDeniedError";
+    this.user = user;
+    this.requiredRoles = requiredRoles;
+    this.redirectTo = redirectTo;
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _RoleDeniedError);
+    }
+  }
+};
+function isRoleDeniedError(error) {
+  return error instanceof RoleDeniedError || error?.name === "RoleDeniedError";
+}
+var InvalidAuthResponseError = class _InvalidAuthResponseError extends Error {
+  constructor(message = "Unexpected authentication response: no access token or user") {
+    super(message);
+    this.name = "InvalidAuthResponseError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _InvalidAuthResponseError);
+    }
+  }
+};
 
 // src/core/client.ts
 var DEFAULT_REFRESH_RETRY_DELAYS = [1e3, 3e3];
@@ -30,8 +127,8 @@ function getRefreshToken() {
 }
 function getSessionTokenKey() {
   const config = getConfig();
-  const storageKey = config.storageKey ?? "classic_auth";
-  return `${storageKey}_session`;
+  const storageKey2 = config.storageKey ?? "classic_auth";
+  return `${storageKey2}_session`;
 }
 function getSessionToken() {
   const storage = getStorage();
@@ -43,22 +140,22 @@ function updateStoredTokens(accessToken, refreshToken) {
 function writeStoredTokens(accessToken, refreshToken) {
   const config = getConfig();
   const storage = getStorage();
-  const storageKey = config.storageKey ?? "classic_auth";
+  const storageKey2 = config.storageKey ?? "classic_auth";
   let parsed = {};
   try {
-    const authData = storage.getItem(storageKey);
+    const authData = storage.getItem(storageKey2);
     if (authData) parsed = JSON.parse(authData);
   } catch {
   }
   parsed.accessToken = accessToken;
   parsed.refreshToken = refreshToken;
-  storage.setItem(storageKey, JSON.stringify(parsed));
+  storage.setItem(storageKey2, JSON.stringify(parsed));
   config.onTokenRefresh?.({ accessToken, refreshToken });
   return syncSvelteStore((authStore) => authStore.updateTokens(accessToken, refreshToken));
 }
 async function syncSvelteStore(apply) {
   try {
-    const { authStore } = await import('./auth.svelte-T4LKTTDZ.js');
+    const { authStore } = await import('./auth.svelte-JLSRQJAC.js');
     apply(authStore);
   } catch {
   }
@@ -121,8 +218,8 @@ async function refreshOnce(refreshToken) {
 function withRefreshLock(fn) {
   const locks = typeof navigator !== "undefined" ? navigator.locks : void 0;
   if (!locks) return fn();
-  const storageKey = getConfig().storageKey ?? "classic_auth";
-  return locks.request(`${storageKey}:refresh`, fn);
+  const storageKey2 = getConfig().storageKey ?? "classic_auth";
+  return locks.request(`${storageKey2}:refresh`, fn);
 }
 function refreshSession(options = {}) {
   if (options.onlyIfExpired) {
@@ -197,14 +294,41 @@ function extractData(response) {
   }
   return response;
 }
+function isApiOrigin(url, baseUrl) {
+  try {
+    const page = typeof location !== "undefined" ? location.href : void 0;
+    return new URL(url).origin === new URL(baseUrl, page).origin;
+  } catch {
+    return false;
+  }
+}
 function apiRequest(endpoint, options = {}) {
   return apiRequestInternal(endpoint, options, false);
 }
 async function apiRequestInternal(endpoint, options, isRetry) {
-  const { authenticated = false, customFetch, body, timeout, signal, ...fetchOptions } = options;
+  const {
+    authenticated: wantsAuth = false,
+    customFetch,
+    body,
+    timeout,
+    signal,
+    noAuthRetry = false,
+    ...fetchOptions
+  } = options;
   const config = getConfig();
   const fetchFn = customFetch ?? getFetch();
-  const url = endpoint.startsWith("http") ? endpoint : `${config.baseUrl}${endpoint}`;
+  const isAbsolute = /^https?:\/\//i.test(endpoint);
+  const url = isAbsolute ? endpoint : `${config.baseUrl}${endpoint}`;
+  const authenticated = wantsAuth && (!isAbsolute || isApiOrigin(url, config.baseUrl));
+  if (authenticated && noAuthRetry && !isRetry && typeof window !== "undefined") {
+    const accessToken = getAccessToken();
+    if (accessToken && isTokenExpired(accessToken)) {
+      const outcome = await refreshSession({ onlyIfExpired: true });
+      if (outcome === "rejected") {
+        throw new Error("Authentication failed. Please sign in again.");
+      }
+    }
+  }
   const timeoutMs = timeout ?? config.requestTimeout ?? 3e4;
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
@@ -238,7 +362,7 @@ async function apiRequestInternal(endpoint, options, isRetry) {
       signal: controller.signal
     });
     clearTimeout(timeoutId);
-    if (response.status === 401 && authenticated && typeof window !== "undefined") {
+    if (response.status === 401 && authenticated && !noAuthRetry && typeof window !== "undefined") {
       if (isRetry) {
         await expireSession();
         throw new Error("Authentication failed. Please sign in again.");
@@ -312,9 +436,9 @@ function initCrossTabSync() {
   if (typeof window === "undefined") return () => {
   };
   const config = getConfig();
-  const storageKey = config.storageKey ?? "classic_auth";
+  const storageKey2 = config.storageKey ?? "classic_auth";
   function handleStorage(event) {
-    if (event.key !== storageKey) return;
+    if (event.key !== storageKey2) return;
     void syncSvelteStore((authStore) => authStore.rehydrate());
   }
   window.addEventListener("storage", handleStorage);
@@ -425,6 +549,8 @@ var authApi = {
    * Initiate SSO login by redirecting to the SSO provider.
    * @param options.callbackUrl - The URL where the SSO provider should redirect after auth
    * @param options.redirectUrl - The final URL to redirect to after processing the callback
+   * Also sends a fresh `client_state` (kept in this tab's sessionStorage) that
+   * the callback page must check with `verifySsoClientState()`.
    * @throws Error if redirectUrl or callbackUrl fail validation
    */
   initiateSSOLogin(options) {
@@ -444,6 +570,10 @@ var authApi = {
     if (options?.redirectUrl) {
       params.set("redirect", options.redirectUrl);
     }
+    const clientState = createSsoClientState();
+    if (clientState) {
+      params.set(SSO_CLIENT_STATE_PARAM, clientState);
+    }
     const url = params.toString() ? `${authorizeUrl}?${params}` : authorizeUrl;
     window.location.href = url;
   },
@@ -468,7 +598,12 @@ var authApi = {
    * Change the current user's password.
    */
   async changePassword(data) {
-    await api.put("/auth/change-password", data, true);
+    await apiRequest("/auth/change-password", {
+      method: "PUT",
+      body: data,
+      authenticated: true,
+      noAuthRetry: true
+    });
   },
   // ============================================================================
   // Email Verification
@@ -570,16 +705,20 @@ var authApi = {
    * Disable MFA.
    */
   async disableMFA(password) {
-    await api.delete("/auth/mfa", true, void 0, { password });
+    await apiRequest("/auth/mfa", {
+      method: "DELETE",
+      body: { password },
+      authenticated: true,
+      noAuthRetry: true
+    });
   },
   /**
    * Regenerate MFA backup codes.
    */
   async regenerateBackupCodes(password) {
-    const response = await api.post(
+    const response = await apiRequest(
       "/auth/mfa/regenerate-backup-codes",
-      { password },
-      true
+      { method: "POST", body: { password }, authenticated: true, noAuthRetry: true }
     );
     return extractData(response);
   },
@@ -707,7 +846,12 @@ var authApi = {
    * Unlink an SSO account.
    */
   async unlinkSSOAccount(provider, password) {
-    await api.delete("/auth/sso/unlink", true, void 0, { provider, password });
+    await apiRequest("/auth/sso/unlink", {
+      method: "DELETE",
+      body: { provider, password },
+      authenticated: true,
+      noAuthRetry: true
+    });
   },
   /**
    * Link an SSO account.
@@ -834,4 +978,4 @@ var authApi = {
   }
 };
 
-export { api, apiRequest, authApi, clearStoredAuth, extractData, getAccessToken, getRefreshToken, getSessionToken, initCrossTabSync, refreshSession, updateStoredTokens };
+export { InvalidAuthResponseError, RoleDeniedError, SSO_CLIENT_STATE_PARAM, SSO_CLIENT_STATE_TTL_MS, api, apiRequest, authApi, clearStoredAuth, consumeSsoClientState, createSsoClientState, extractData, getAccessToken, getRefreshToken, getSessionToken, initCrossTabSync, isRoleDeniedError, refreshSession, updateStoredTokens, verifySsoClientState };

package/dist/{chunk-2CYGQUUY.js → chunk-K6TV3ZVS.js}

@@ -97,13 +97,48 @@ function isValidRedirectUrl(url) {
     }
   } catch {
     if (url.includes("://") || url.startsWith("//")) return false;
+    return isSameOriginRelative(url);
+  }
+}
+function isSameOriginRelative(url) {
+  const sentinel = "https://relative.invalid";
+  let current = url;
+  for (let round = 0; round < 4; round++) {
+    try {
+      if (new URL(current, sentinel).origin !== sentinel) return false;
+    } catch {
+      return false;
+    }
+    let decoded;
     try {
-      const sentinel = "https://relative.invalid";
-      return new URL(url, sentinel).origin === sentinel;
+      decoded = decodeURIComponent(current);
     } catch {
       return false;
     }
+    if (decoded === current) return true;
+    current = decoded;
   }
+  return false;
+}
+function isValidSSOLogoutUrl(url) {
+  if (isValidRedirectUrl(url)) return true;
+  const cfg = getConfig();
+  let parsed;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return false;
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") return false;
+  const origins = [...cfg.sso?.logoutOrigins ?? []];
+  if (cfg.sso?.authorizeUrl) origins.push(cfg.sso.authorizeUrl);
+  return origins.some((origin) => {
+    try {
+      return new URL(origin).origin === parsed.origin;
+    } catch {
+      return false;
+    }
+  });
 }
 
 // src/core/jwt.ts
@@ -251,4 +286,4 @@ function hasAllRoles(user, roles) {
   return roles.every((role) => held.includes(role));
 }
 
-export { ROLE_HIERARCHY, ROLE_NAMES, computePrimaryRole, createMemoryStorage, createSessionStorage, decodeJWT, extractClaims, getConfig, getDefaultStorage, getEffectiveLevel, getFetch, getStorage, getTokenExpiration, getTokenRemainingTime, getUserRoles, hasAllRoles, hasAnyRole, hasRole, initAuth, isInitialized, isTokenExpired, isValidRedirectUrl, resetConfig };
+export { ROLE_HIERARCHY, ROLE_NAMES, computePrimaryRole, createMemoryStorage, createSessionStorage, decodeJWT, extractClaims, getConfig, getDefaultStorage, getEffectiveLevel, getFetch, getStorage, getTokenExpiration, getTokenRemainingTime, getUserRoles, hasAllRoles, hasAnyRole, hasRole, initAuth, isInitialized, isTokenExpired, isValidRedirectUrl, isValidSSOLogoutUrl, resetConfig };

package/dist/{chunk-KSOYQYUZ.js → chunk-S3DNV7VV.js}

@@ -1,5 +1,5 @@
-import { authApi } from './chunk-ETKDIPD2.js';
-import { isInitialized, getConfig, hasRole, hasAnyRole, hasAllRoles, decodeJWT, getStorage, getDefaultStorage } from './chunk-2CYGQUUY.js';
+import { InvalidAuthResponseError, authApi } from './chunk-GBYHYVXX.js';
+import { isInitialized, getConfig, isValidSSOLogoutUrl, hasRole, hasAnyRole, hasAllRoles, decodeJWT, getStorage, getDefaultStorage } from './chunk-K6TV3ZVS.js';
 
 // src/svelte/stores/auth.svelte.ts
 var STORAGE_VERSION = 2;
@@ -107,6 +107,9 @@ var AuthStore = class {
    * Set auth data after successful login.
    */
   setAuth(accessToken, refreshToken, user, sessionToken) {
+    if (typeof accessToken !== "string" || accessToken === "" || !user) {
+      throw new InvalidAuthResponseError("setAuth requires an access token and a user");
+    }
     const userWithPermissions = normalizeUser(user, accessToken);
     this.state = {
       accessToken,
@@ -198,7 +201,12 @@ var AuthStore = class {
       const response = await authApi.logout();
       this.logout();
       if (response?.ssoLogout && response?.logoutUrl) {
-        return { ssoLogoutUrl: response.logoutUrl };
+        if (isValidSSOLogoutUrl(response.logoutUrl)) {
+          return { ssoLogoutUrl: response.logoutUrl };
+        }
+        getConfig().onAuthError?.(
+          new Error("Ignored SSO logout URL: origin is not allowed (see sso.logoutOrigins)")
+        );
       }
     } catch {
       this.logout();

package/dist/{chunk-DFCBWKCU.js → chunk-TUWTOMZZ.js}

@@ -1,12 +1,12 @@
-import { authApi } from './chunk-ETKDIPD2.js';
-import { getUserRoles, hasAnyRole } from './chunk-2CYGQUUY.js';
+import { authApi, InvalidAuthResponseError, RoleDeniedError } from './chunk-GBYHYVXX.js';
+import { hasAnyRole, getUserRoles } from './chunk-K6TV3ZVS.js';
 
 // src/core/guards.ts
 function isMfaChallengeResponse(response) {
   return "requiresMFA" in response && response.requiresMFA === true || "mfaRequired" in response && response.mfaRequired === true;
 }
 function isLoginSuccessResponse(response) {
-  return "accessToken" in response && "user" in response && !isMfaChallengeResponse(response);
+  return typeof response?.accessToken === "string" && response.accessToken !== "" && typeof response.user === "object" && response.user !== null && !isMfaChallengeResponse(response);
 }
 function getMfaToken(response) {
   return response.mfaToken ?? response.mfaChallengeToken;
@@ -15,27 +15,16 @@ function getAvailableMethods(response) {
   return response.availableMethods ?? ["totp"];
 }
 
-// src/core/errors.ts
-var RoleDeniedError = class _RoleDeniedError extends Error {
-  constructor(user, requiredRoles, redirectTo) {
-    const userRoles = getUserRoles(user).join(", ") || "none";
-    super(
-      `User "${user.username}" does not have required role(s). Has: [${userRoles}], Required: [${requiredRoles.join(", ")}]`
-    );
-    this.name = "RoleDeniedError";
-    this.user = user;
-    this.requiredRoles = requiredRoles;
-    this.redirectTo = redirectTo;
-    if (Error.captureStackTrace) {
-      Error.captureStackTrace(this, _RoleDeniedError);
-    }
-  }
-};
-function isRoleDeniedError(error) {
-  return error instanceof RoleDeniedError || error?.name === "RoleDeniedError";
-}
-
 // src/core/service.ts
+async function setStoreAuth(response) {
+  let store;
+  try {
+    store = (await import('./auth.svelte-JLSRQJAC.js')).authStore;
+  } catch {
+    return;
+  }
+  store.setAuth(response.accessToken, response.refreshToken, response.user, response.sessionToken);
+}
 var AuthService = class {
   // ============================================================================
   // Authentication
@@ -48,7 +37,13 @@ var AuthService = class {
    */
   async login(credentials, options) {
     const response = await authApi.login(credentials);
-    if (options?.allowedRoles?.length && !isMfaChallengeResponse(response)) {
+    if (isMfaChallengeResponse(response)) {
+      return response;
+    }
+    if (!isLoginSuccessResponse(response)) {
+      throw new InvalidAuthResponseError();
+    }
+    if (options?.allowedRoles?.length) {
       if (!hasAnyRole(response.user, options.allowedRoles)) {
         throw new RoleDeniedError(
           response.user,
@@ -57,17 +52,8 @@ var AuthService = class {
         );
       }
     }
-    if (options?.autoSetAuth !== false && !isMfaChallengeResponse(response)) {
-      try {
-        const { authStore } = await import('./auth.svelte-T4LKTTDZ.js');
-        authStore.setAuth(
-          response.accessToken,
-          response.refreshToken,
-          response.user,
-          response.sessionToken
-        );
-      } catch {
-      }
+    if (options?.autoSetAuth !== false) {
+      await setStoreAuth(response);
     }
     return response;
   }
@@ -234,6 +220,9 @@ var AuthService = class {
    */
   async verifyMFAChallenge(data, options) {
     const response = await authApi.verifyMFAChallenge(data);
+    if (!isLoginSuccessResponse(response)) {
+      throw new InvalidAuthResponseError();
+    }
     if (options?.allowedRoles?.length) {
       if (!hasAnyRole(response.user, options.allowedRoles)) {
         throw new RoleDeniedError(
@@ -244,16 +233,7 @@ var AuthService = class {
       }
     }
     if (options?.autoSetAuth !== false) {
-      try {
-        const { authStore } = await import('./auth.svelte-T4LKTTDZ.js');
-        authStore.setAuth(
-          response.accessToken,
-          response.refreshToken,
-          response.user,
-          response.sessionToken
-        );
-      } catch {
-      }
+      await setStoreAuth(response);
     }
     return response;
   }
@@ -407,4 +387,4 @@ function formatUserRoles(user, options = {}) {
   return formatted.join(separator);
 }
 
-export { AuthService, RoleDeniedError, authService, formatUserRoles, getAvailableMethods, getAvatarFallback, getDisplayName, getGreeting, getMfaToken, getUserEmail, getUserInitials, isLoginSuccessResponse, isMfaChallengeResponse, isRoleDeniedError };
+export { AuthService, authService, formatUserRoles, getAvailableMethods, getAvatarFallback, getDisplayName, getGreeting, getMfaToken, getUserEmail, getUserInitials, isLoginSuccessResponse, isMfaChallengeResponse };

package/dist/{chunk-NLG6NSE4.js → chunk-XUOSWSDO.js}

@@ -1,6 +1,6 @@
-import { authService } from './chunk-DFCBWKCU.js';
-import { authStore, currentUser, isAuthenticated, authActions } from './chunk-KSOYQYUZ.js';
-import { isInitialized, initAuth, getUserRoles } from './chunk-2CYGQUUY.js';
+import { authService } from './chunk-TUWTOMZZ.js';
+import { authStore, currentUser, isAuthenticated, authActions } from './chunk-S3DNV7VV.js';
+import { isInitialized, initAuth, getUserRoles } from './chunk-K6TV3ZVS.js';
 
 // src/svelte/guards/auth-guard.ts
 function checkAuth(options = {}) {
@@ -175,7 +175,12 @@ function createAuthHook(options = {}) {
     event,
     resolve
   }) => {
-    const { pathname } = event.url;
+    let pathname;
+    try {
+      pathname = decodePathname(event.url.pathname);
+    } catch {
+      return new Response("Malformed URI", { status: 400 });
+    }
     const isLoginPage = pathname.replace(/(.)\/+$/, "$1") === loginPathname;
     const isPublic = isLoginPage || publicRoutes.some((r) => r.test(pathname));
     if (isPublic) {
@@ -198,7 +203,7 @@ function createAuthHook(options = {}) {
         return onUnauthenticated(event);
       }
       const loginUrl = new URL(loginPath, event.url.origin);
-      loginUrl.searchParams.set(redirectParam, pathname + event.url.search);
+      loginUrl.searchParams.set(redirectParam, event.url.pathname + event.url.search);
       return new Response(null, {
         status: 302,
         headers: { Location: loginUrl.pathname + loginUrl.search }
@@ -207,6 +212,9 @@ function createAuthHook(options = {}) {
     return resolve(event);
   };
 }
+function decodePathname(pathname) {
+  return pathname.split("%25").map(decodeURI).join("%25");
+}
 function matchesRoute(pathname, patterns) {
   return patterns.some((pattern) => pattern.test(pathname));
 }

package/dist/core/index.d.ts

@@ -1,6 +1,69 @@
-import { e as LoginCredentials, f as LoginResponse, g as LogoutResponse, R as RegisterData, k as RegisterResponse, p as User, j as ProfileUpdateData, C as ChangePasswordData, n as Session, A as ApiKey, c as CreateApiKeyRequest, d as CreateApiKeyResponse, U as UpdateApiKeyRequest, i as MFAStatus, h as MFASetupResponse, M as MFAChallengeData, D as Device, q as UserPreferences, L as LinkedAccount, m as SecurityEvent, P as Pagination, r as UserRolesResponse } from '../types-Bqh2gkvu.js';
-export { a as AuthConfig, b as AuthState, l as ResetPasswordData, S as SSOConfig, o as StorageAdapter, s as createMemoryStorage, t as createSessionStorage, u as getConfig, v as getDefaultStorage, w as getFetch, x as getStorage, y as initAuth, z as isInitialized, B as resetConfig } from '../types-Bqh2gkvu.js';
-export { A as AuthService, L as LoginOptions, M as MFAVerifyOptions, R as RoleDeniedError, a as authService, f as formatUserRoles, g as getAvatarFallback, b as getDisplayName, c as getGreeting, d as getUserEmail, e as getUserInitials, i as isRoleDeniedError } from '../user-utils-92PeSjcw.js';
+import { e as LoginCredentials, f as LoginResponse, g as LogoutResponse, R as RegisterData, k as RegisterResponse, p as User, j as ProfileUpdateData, C as ChangePasswordData, n as Session, A as ApiKey, c as CreateApiKeyRequest, d as CreateApiKeyResponse, U as UpdateApiKeyRequest, i as MFAStatus, h as MFASetupResponse, M as MFAChallengeData, D as Device, q as UserPreferences, L as LinkedAccount, m as SecurityEvent, P as Pagination, r as UserRolesResponse } from '../types-B70Kgcc_.js';
+export { a as AuthConfig, b as AuthState, l as ResetPasswordData, S as SSOConfig, o as StorageAdapter, s as createMemoryStorage, t as createSessionStorage, u as getConfig, v as getDefaultStorage, w as getFetch, x as getStorage, y as initAuth, z as isInitialized, B as resetConfig } from '../types-B70Kgcc_.js';
+export { A as AuthService, I as InvalidAuthResponseError, L as LoginOptions, M as MFAVerifyOptions, R as RoleDeniedError, a as authService, f as formatUserRoles, g as getAvatarFallback, b as getDisplayName, c as getGreeting, d as getUserEmail, e as getUserInitials, i as isRoleDeniedError } from '../user-utils-DWEU-Ovm.js';
+
+/**
+ * SSO client state
+ *
+ * Binds an SSO callback to the browser tab that started the login. Before
+ * redirecting to `/auth/sso/authorize`, the tab generates a random
+ * `client_state`, keeps it in sessionStorage (per-tab, single-use, 10-minute
+ * TTL) and sends it along; the server echoes it back in the callback hash
+ * fragment (token and MFA-challenge variants alike). The callback page then
+ * calls `verifySsoClientState()` before trusting anything in the hash.
+ *
+ * Without this, an attacker could complete SSO for their own account and send
+ * the victim the resulting callback URL, silently signing the victim in as the
+ * attacker (login CSRF / session fixation).
+ */
+/** Hash-fragment (and authorize query) parameter carrying the client state. */
+declare const SSO_CLIENT_STATE_PARAM = "client_state";
+/** How long a stored client state stays valid. */
+declare const SSO_CLIENT_STATE_TTL_MS: number;
+/**
+ * Result of checking a callback's `client_state` against the one this tab stored:
+ * - `ok`: present and matches an unexpired stored value
+ * - `mismatch`: present but this tab stored none, it expired, or it differs
+ * - `missing`: the callback carried no `client_state`
+ */
+type SsoClientStateResult = 'ok' | 'mismatch' | 'missing';
+interface SsoClientStateVerification {
+    result: SsoClientStateResult;
+    /**
+     * Whether the callback may proceed: always for `ok`; for `missing` and
+     * `mismatch` only while `sso.requireClientState` is off (rollout mode).
+     */
+    accepted: boolean;
+}
+/**
+ * Generate a fresh client state and store it for this tab, replacing any
+ * earlier one. Returns `null` when sessionStorage is unavailable — sending a
+ * value the callback can't check would only produce a mismatch.
+ */
+declare function createSsoClientState(): string | null;
+/**
+ * Compare the `client_state` an SSO callback received with the one this tab
+ * stored, and consume the stored value (single-use) whatever the outcome.
+ * This is the raw check; `verifySsoClientState()` applies the
+ * `sso.requireClientState` policy on top.
+ */
+declare function consumeSsoClientState(received: string | null | undefined): SsoClientStateResult;
+/**
+ * Verify an SSO callback's `client_state` and decide whether to proceed.
+ * Accepts the received value, or the callback's parsed hash params.
+ *
+ * With `sso.requireClientState: true`, anything but `ok` is rejected. While it
+ * is off (the default, so apps can ship before the API echoes the value),
+ * every result is accepted — log `result` to watch the rollout.
+ *
+ * @example
+ * ```typescript
+ * const params = new URLSearchParams(window.location.hash.slice(1));
+ * const { accepted, result } = verifySsoClientState(params);
+ * if (!accepted) throw new Error(`SSO sign-in could not be verified (${result})`);
+ * ```
+ */
+declare function verifySsoClientState(input: string | URLSearchParams | null | undefined): SsoClientStateVerification;
 
 /**
  * HTTP Client
@@ -19,6 +82,14 @@ interface ApiRequestOptions extends Omit<RequestInit, 'body' | 'signal'> {
     timeout?: number;
     /** AbortSignal for manual cancellation */
     signal?: AbortSignal;
+    /**
+     * Treat a 401 as an ordinary request error: no token refresh, no retry
+     * and no session expiry. For endpoints where a 401 means a wrong password
+     * rather than a dead token (change password, disable MFA, ...), so a typo
+     * does not sign the user out. An already-expired access token is still
+     * refreshed before the request is sent.
+     */
+    noAuthRetry?: boolean;
 }
 /**
  * The CHAPI envelope shape, for endpoints that wrap their payload in `data`.
@@ -186,6 +257,8 @@ declare const authApi: {
      * Initiate SSO login by redirecting to the SSO provider.
      * @param options.callbackUrl - The URL where the SSO provider should redirect after auth
      * @param options.redirectUrl - The final URL to redirect to after processing the callback
+     * Also sends a fresh `client_state` (kept in this tab's sessionStorage) that
+     * the callback page must check with `verifySsoClientState()`.
      * @throws Error if redirectUrl or callbackUrl fail validation
      */
     initiateSSOLogin(options?: {
@@ -389,7 +462,9 @@ declare const authApi: {
 declare function isMfaChallengeResponse(response: LoginResponse): boolean;
 /**
  * Check if a login response is a successful login (with tokens and user).
- * Returns true if the response contains valid authentication data.
+ * Returns true only for a non-empty access token plus a user object, so an
+ * MFA challenge in a shape isMfaChallengeResponse doesn't recognise is never
+ * mistaken for a login.
  */
 declare function isLoginSuccessResponse(response: LoginResponse): boolean;
 /**
@@ -621,4 +696,4 @@ declare function hasAnyRole(user: Pick<User, 'roles'> | null | undefined, roles:
  */
 declare function hasAllRoles(user: Pick<User, 'roles'> | null | undefined, roles: readonly string[]): boolean;
 
-export { ApiKey, type ApiRequestOptions, type ApiResponse, ChangePasswordData, CreateApiKeyRequest, CreateApiKeyResponse, Device, type JWTPayload, LinkedAccount, LoginCredentials, LoginResponse, LogoutResponse, MFAChallengeData, MFASetupResponse, MFAStatus, Pagination, ProfileUpdateData, ROLE_HIERARCHY, ROLE_NAMES, type RefreshOutcome, type RefreshSessionOptions, RegisterData, RegisterResponse, type RoleName, SecurityEvent, Session, UpdateApiKeyRequest, User, UserPreferences, UserRolesResponse, api, apiRequest, authApi, clearStoredAuth, computePrimaryRole, decodeJWT, extractClaims, extractData, getAccessToken, getAvailableMethods, getEffectiveLevel, getMfaToken, getRefreshToken, getSessionToken, getTokenExpiration, getTokenRemainingTime, getUserRoles, hasAllRoles, hasAnyRole, hasRole, initCrossTabSync, isLoginSuccessResponse, isMfaChallengeResponse, isTokenExpired, refreshSession, updateStoredTokens };
+export { ApiKey, type ApiRequestOptions, type ApiResponse, ChangePasswordData, CreateApiKeyRequest, CreateApiKeyResponse, Device, type JWTPayload, LinkedAccount, LoginCredentials, LoginResponse, LogoutResponse, MFAChallengeData, MFASetupResponse, MFAStatus, Pagination, ProfileUpdateData, ROLE_HIERARCHY, ROLE_NAMES, type RefreshOutcome, type RefreshSessionOptions, RegisterData, RegisterResponse, type RoleName, SSO_CLIENT_STATE_PARAM, SSO_CLIENT_STATE_TTL_MS, SecurityEvent, Session, type SsoClientStateResult, type SsoClientStateVerification, UpdateApiKeyRequest, User, UserPreferences, UserRolesResponse, api, apiRequest, authApi, clearStoredAuth, computePrimaryRole, consumeSsoClientState, createSsoClientState, decodeJWT, extractClaims, extractData, getAccessToken, getAvailableMethods, getEffectiveLevel, getMfaToken, getRefreshToken, getSessionToken, getTokenExpiration, getTokenRemainingTime, getUserRoles, hasAllRoles, hasAnyRole, hasRole, initCrossTabSync, isLoginSuccessResponse, isMfaChallengeResponse, isTokenExpired, refreshSession, updateStoredTokens, verifySsoClientState };

package/dist/core/index.js

@@ -1,3 +1,3 @@
-export { AuthService, RoleDeniedError, authService, formatUserRoles, getAvailableMethods, getAvatarFallback, getDisplayName, getGreeting, getMfaToken, getUserEmail, getUserInitials, isLoginSuccessResponse, isMfaChallengeResponse, isRoleDeniedError } from '../chunk-DFCBWKCU.js';
-export { api, apiRequest, authApi, clearStoredAuth, extractData, getAccessToken, getRefreshToken, getSessionToken, initCrossTabSync, refreshSession, updateStoredTokens } from '../chunk-ETKDIPD2.js';
-export { ROLE_HIERARCHY, ROLE_NAMES, computePrimaryRole, createMemoryStorage, createSessionStorage, decodeJWT, extractClaims, getConfig, getDefaultStorage, getEffectiveLevel, getFetch, getStorage, getTokenExpiration, getTokenRemainingTime, getUserRoles, hasAllRoles, hasAnyRole, hasRole, initAuth, isInitialized, isTokenExpired, resetConfig } from '../chunk-2CYGQUUY.js';
+export { AuthService, authService, formatUserRoles, getAvailableMethods, getAvatarFallback, getDisplayName, getGreeting, getMfaToken, getUserEmail, getUserInitials, isLoginSuccessResponse, isMfaChallengeResponse } from '../chunk-TUWTOMZZ.js';
+export { InvalidAuthResponseError, RoleDeniedError, SSO_CLIENT_STATE_PARAM, SSO_CLIENT_STATE_TTL_MS, api, apiRequest, authApi, clearStoredAuth, consumeSsoClientState, createSsoClientState, extractData, getAccessToken, getRefreshToken, getSessionToken, initCrossTabSync, isRoleDeniedError, refreshSession, updateStoredTokens, verifySsoClientState } from '../chunk-GBYHYVXX.js';
+export { ROLE_HIERARCHY, ROLE_NAMES, computePrimaryRole, createMemoryStorage, createSessionStorage, decodeJWT, extractClaims, getConfig, getDefaultStorage, getEffectiveLevel, getFetch, getStorage, getTokenExpiration, getTokenRemainingTime, getUserRoles, hasAllRoles, hasAnyRole, hasRole, initAuth, isInitialized, isTokenExpired, resetConfig } from '../chunk-K6TV3ZVS.js';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { A as ApiKey, a as AuthConfig, b as AuthState, C as ChangePasswordData, c as CreateApiKeyRequest, d as CreateApiKeyResponse, D as Device, L as LinkedAccount, e as LoginCredentials, f as LoginResponse, g as LogoutResponse, M as MFAChallengeData, h as MFASetupResponse, i as MFAStatus, P as Pagination, j as ProfileUpdateData, R as RegisterData, k as RegisterResponse, l as ResetPasswordData, S as SSOConfig, m as SecurityEvent, n as Session, o as StorageAdapter, U as UpdateApiKeyRequest, p as User, q as UserPreferences, r as UserRolesResponse, s as createMemoryStorage, t as createSessionStorage, u as getConfig, v as getDefaultStorage, w as getFetch, x as getStorage, y as initAuth, z as isInitialized, B as resetConfig } from './types-Bqh2gkvu.js';
-export { ApiRequestOptions, ApiResponse, JWTPayload, ROLE_HIERARCHY, ROLE_NAMES, RefreshOutcome, RefreshSessionOptions, RoleName, api, apiRequest, authApi, clearStoredAuth, computePrimaryRole, decodeJWT, extractClaims, extractData, getAccessToken, getAvailableMethods, getEffectiveLevel, getMfaToken, getRefreshToken, getSessionToken, getTokenExpiration, getTokenRemainingTime, getUserRoles, hasAllRoles, hasAnyRole, hasRole, initCrossTabSync, isLoginSuccessResponse, isMfaChallengeResponse, isTokenExpired, refreshSession, updateStoredTokens } from './core/index.js';
-export { A as AuthService, L as LoginOptions, M as MFAVerifyOptions, R as RoleDeniedError, a as authService, f as formatUserRoles, g as getAvatarFallback, b as getDisplayName, c as getGreeting, d as getUserEmail, e as getUserInitials, i as isRoleDeniedError } from './user-utils-92PeSjcw.js';
+export { A as ApiKey, a as AuthConfig, b as AuthState, C as ChangePasswordData, c as CreateApiKeyRequest, d as CreateApiKeyResponse, D as Device, L as LinkedAccount, e as LoginCredentials, f as LoginResponse, g as LogoutResponse, M as MFAChallengeData, h as MFASetupResponse, i as MFAStatus, P as Pagination, j as ProfileUpdateData, R as RegisterData, k as RegisterResponse, l as ResetPasswordData, S as SSOConfig, m as SecurityEvent, n as Session, o as StorageAdapter, U as UpdateApiKeyRequest, p as User, q as UserPreferences, r as UserRolesResponse, s as createMemoryStorage, t as createSessionStorage, u as getConfig, v as getDefaultStorage, w as getFetch, x as getStorage, y as initAuth, z as isInitialized, B as resetConfig } from './types-B70Kgcc_.js';
+export { ApiRequestOptions, ApiResponse, JWTPayload, ROLE_HIERARCHY, ROLE_NAMES, RefreshOutcome, RefreshSessionOptions, RoleName, SSO_CLIENT_STATE_PARAM, SSO_CLIENT_STATE_TTL_MS, SsoClientStateResult, SsoClientStateVerification, api, apiRequest, authApi, clearStoredAuth, computePrimaryRole, consumeSsoClientState, createSsoClientState, decodeJWT, extractClaims, extractData, getAccessToken, getAvailableMethods, getEffectiveLevel, getMfaToken, getRefreshToken, getSessionToken, getTokenExpiration, getTokenRemainingTime, getUserRoles, hasAllRoles, hasAnyRole, hasRole, initCrossTabSync, isLoginSuccessResponse, isMfaChallengeResponse, isTokenExpired, refreshSession, updateStoredTokens, verifySsoClientState } from './core/index.js';
+export { A as AuthService, I as InvalidAuthResponseError, L as LoginOptions, M as MFAVerifyOptions, R as RoleDeniedError, a as authService, f as formatUserRoles, g as getAvatarFallback, b as getDisplayName, c as getGreeting, d as getUserEmail, e as getUserInitials, i as isRoleDeniedError } from './user-utils-DWEU-Ovm.js';
 export { AuthClient, AuthGuardOptions, AuthGuardResult, AuthHookOptions, CreateAuthClientOptions, NavFilterOptions, RoleRestrictedItem, authActions, authStore, canAccess, checkAuth, createAuthClient, createAuthGuard, createAuthHook, createNavFilter, currentUser, filterByAccess, filterNavSections, isAuthenticated, matchesRoute, protectedLoad, requireAuth, requirePermission, requireRole, routePatterns } from './svelte/index.js';

package/dist/index.js

@@ -1,5 +1,5 @@
-export { canAccess, checkAuth, createAuthClient, createAuthGuard, createAuthHook, createNavFilter, filterByAccess, filterNavSections, matchesRoute, protectedLoad, requireAuth, requirePermission, requireRole, routePatterns } from './chunk-NLG6NSE4.js';
-export { AuthService, RoleDeniedError, authService, formatUserRoles, getAvailableMethods, getAvatarFallback, getDisplayName, getGreeting, getMfaToken, getUserEmail, getUserInitials, isLoginSuccessResponse, isMfaChallengeResponse, isRoleDeniedError } from './chunk-DFCBWKCU.js';
-export { authActions, authStore, currentUser, isAuthenticated } from './chunk-KSOYQYUZ.js';
-export { api, apiRequest, authApi, clearStoredAuth, extractData, getAccessToken, getRefreshToken, getSessionToken, initCrossTabSync, refreshSession, updateStoredTokens } from './chunk-ETKDIPD2.js';
-export { ROLE_HIERARCHY, ROLE_NAMES, computePrimaryRole, createMemoryStorage, createSessionStorage, decodeJWT, extractClaims, getConfig, getDefaultStorage, getEffectiveLevel, getFetch, getStorage, getTokenExpiration, getTokenRemainingTime, getUserRoles, hasAllRoles, hasAnyRole, hasRole, initAuth, isInitialized, isTokenExpired, resetConfig } from './chunk-2CYGQUUY.js';
+export { canAccess, checkAuth, createAuthClient, createAuthGuard, createAuthHook, createNavFilter, filterByAccess, filterNavSections, matchesRoute, protectedLoad, requireAuth, requirePermission, requireRole, routePatterns } from './chunk-XUOSWSDO.js';
+export { AuthService, authService, formatUserRoles, getAvailableMethods, getAvatarFallback, getDisplayName, getGreeting, getMfaToken, getUserEmail, getUserInitials, isLoginSuccessResponse, isMfaChallengeResponse } from './chunk-TUWTOMZZ.js';
+export { authActions, authStore, currentUser, isAuthenticated } from './chunk-S3DNV7VV.js';
+export { InvalidAuthResponseError, RoleDeniedError, SSO_CLIENT_STATE_PARAM, SSO_CLIENT_STATE_TTL_MS, api, apiRequest, authApi, clearStoredAuth, consumeSsoClientState, createSsoClientState, extractData, getAccessToken, getRefreshToken, getSessionToken, initCrossTabSync, isRoleDeniedError, refreshSession, updateStoredTokens, verifySsoClientState } from './chunk-GBYHYVXX.js';
+export { ROLE_HIERARCHY, ROLE_NAMES, computePrimaryRole, createMemoryStorage, createSessionStorage, decodeJWT, extractClaims, getConfig, getDefaultStorage, getEffectiveLevel, getFetch, getStorage, getTokenExpiration, getTokenRemainingTime, getUserRoles, hasAllRoles, hasAnyRole, hasRole, initAuth, isInitialized, isTokenExpired, resetConfig } from './chunk-K6TV3ZVS.js';

package/dist/svelte/index.d.ts

@@ -1,7 +1,7 @@
-import { b as AuthState, p as User, a as AuthConfig } from '../types-Bqh2gkvu.js';
-export { y as initAuth, z as isInitialized } from '../types-Bqh2gkvu.js';
-import { a as authService } from '../user-utils-92PeSjcw.js';
-export { R as RoleDeniedError, f as formatUserRoles, g as getAvatarFallback, b as getDisplayName, c as getGreeting, d as getUserEmail, e as getUserInitials, i as isRoleDeniedError } from '../user-utils-92PeSjcw.js';
+import { b as AuthState, p as User, a as AuthConfig } from '../types-B70Kgcc_.js';
+export { y as initAuth, z as isInitialized } from '../types-B70Kgcc_.js';
+import { a as authService } from '../user-utils-DWEU-Ovm.js';
+export { I as InvalidAuthResponseError, R as RoleDeniedError, f as formatUserRoles, g as getAvatarFallback, b as getDisplayName, c as getGreeting, d as getUserEmail, e as getUserInitials, i as isRoleDeniedError } from '../user-utils-DWEU-Ovm.js';
 
 /**
  * Auth Store

package/dist/svelte/index.js

@@ -1,5 +1,5 @@
-export { canAccess, checkAuth, createAuthClient, createAuthGuard, createAuthHook, createNavFilter, filterByAccess, filterNavSections, matchesRoute, protectedLoad, requireAuth, requirePermission, requireRole, routePatterns } from '../chunk-NLG6NSE4.js';
-export { RoleDeniedError, formatUserRoles, getAvatarFallback, getDisplayName, getGreeting, getUserEmail, getUserInitials, isRoleDeniedError } from '../chunk-DFCBWKCU.js';
-export { authActions, authStore, currentUser, isAuthenticated } from '../chunk-KSOYQYUZ.js';
-import '../chunk-ETKDIPD2.js';
-export { initAuth, isInitialized } from '../chunk-2CYGQUUY.js';
+export { canAccess, checkAuth, createAuthClient, createAuthGuard, createAuthHook, createNavFilter, filterByAccess, filterNavSections, matchesRoute, protectedLoad, requireAuth, requirePermission, requireRole, routePatterns } from '../chunk-XUOSWSDO.js';
+export { formatUserRoles, getAvatarFallback, getDisplayName, getGreeting, getUserEmail, getUserInitials } from '../chunk-TUWTOMZZ.js';
+export { authActions, authStore, currentUser, isAuthenticated } from '../chunk-S3DNV7VV.js';
+export { InvalidAuthResponseError, RoleDeniedError, isRoleDeniedError } from '../chunk-GBYHYVXX.js';
+export { initAuth, isInitialized } from '../chunk-K6TV3ZVS.js';

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { p as User, D as Device, f as LoginResponse, m as SecurityEvent, n as Session, A as ApiKey, L as LinkedAccount, g as LogoutResponse, h as MFASetupResponse, i as MFAStatus, k as RegisterResponse, q as UserPreferences, o as StorageAdapter, b as AuthState, a as AuthConfig } from '../types-Bqh2gkvu.js';
+import { p as User, D as Device, f as LoginResponse, m as SecurityEvent, n as Session, A as ApiKey, L as LinkedAccount, g as LogoutResponse, h as MFASetupResponse, i as MFAStatus, k as RegisterResponse, q as UserPreferences, o as StorageAdapter, b as AuthState, a as AuthConfig } from '../types-B70Kgcc_.js';
 
 /**
  * User Fixtures

package/dist/testing/index.js

@@ -1,4 +1,4 @@
-import { hasRole, hasAnyRole, hasAllRoles, initAuth, resetConfig, getUserRoles, isTokenExpired, decodeJWT } from '../chunk-2CYGQUUY.js';
+import { hasRole, hasAnyRole, hasAllRoles, initAuth, resetConfig, getUserRoles, isTokenExpired, decodeJWT } from '../chunk-K6TV3ZVS.js';
 
 // src/testing/fixtures/users.ts
 var mockUser = {

package/dist/{types-Bqh2gkvu.d.ts → types-B70Kgcc_.d.ts}

@@ -11,6 +11,21 @@ interface SSOConfig {
     provider: string;
     /** Override the default authorize URL (defaults to /auth/sso/authorize) */
     authorizeUrl?: string;
+    /**
+     * Origins the server's SSO logout URL may point to (the identity
+     * provider's, e.g. 'https://sso.example.com'). The authorizeUrl origin and
+     * the redirect origins accepted by isValidRedirectUrl are always allowed;
+     * a logout URL anywhere else is dropped.
+     */
+    logoutOrigins?: string[];
+    /**
+     * Reject SSO callbacks whose `client_state` is missing or doesn't match the
+     * one this tab sent to the authorize endpoint (see `verifySsoClientState`).
+     * Default `false` for one release so apps can roll out before the API
+     * echoes `client_state`; turn it on once the API is deployed to that
+     * environment. It becomes the default in the next major.
+     */
+    requireClientState?: boolean;
 }
 interface StorageAdapter {
     getItem(key: string): string | null;

package/dist/{user-utils-92PeSjcw.d.ts → user-utils-DWEU-Ovm.d.ts}

@@ -1,4 +1,4 @@
-import { e as LoginCredentials, f as LoginResponse, g as LogoutResponse, R as RegisterData, k as RegisterResponse, p as User, j as ProfileUpdateData, n as Session, A as ApiKey, c as CreateApiKeyRequest, d as CreateApiKeyResponse, U as UpdateApiKeyRequest, i as MFAStatus, h as MFASetupResponse, M as MFAChallengeData, D as Device, q as UserPreferences, L as LinkedAccount, m as SecurityEvent, P as Pagination } from './types-Bqh2gkvu.js';
+import { e as LoginCredentials, f as LoginResponse, g as LogoutResponse, R as RegisterData, k as RegisterResponse, p as User, j as ProfileUpdateData, n as Session, A as ApiKey, c as CreateApiKeyRequest, d as CreateApiKeyResponse, U as UpdateApiKeyRequest, i as MFAStatus, h as MFASetupResponse, M as MFAChallengeData, D as Device, q as UserPreferences, L as LinkedAccount, m as SecurityEvent, P as Pagination } from './types-B70Kgcc_.js';
 
 /**
  * Auth Service
@@ -309,6 +309,16 @@ declare class RoleDeniedError extends Error {
  * Type guard to check if an error is a RoleDeniedError.
  */
 declare function isRoleDeniedError(error: unknown): error is RoleDeniedError;
+/**
+ * Error thrown when a login or MFA verification response is neither a
+ * recognised MFA challenge nor a success (an access token and a user).
+ * The auth state is left untouched, so an unexpected server shape fails
+ * closed instead of signing the user in without a token.
+ */
+declare class InvalidAuthResponseError extends Error {
+    readonly name = "InvalidAuthResponseError";
+    constructor(message?: string);
+}
 
 /**
  * User Display Utilities
@@ -413,4 +423,4 @@ declare function formatUserRoles(user: User | null | undefined, options?: {
     capitalize?: boolean;
 }): string;
 
-export { AuthService as A, type LoginOptions as L, type MFAVerifyOptions as M, RoleDeniedError as R, authService as a, getDisplayName as b, getGreeting as c, getUserEmail as d, getUserInitials as e, formatUserRoles as f, getAvatarFallback as g, isRoleDeniedError as i };
+export { AuthService as A, InvalidAuthResponseError as I, type LoginOptions as L, type MFAVerifyOptions as M, RoleDeniedError as R, authService as a, getDisplayName as b, getGreeting as c, getUserEmail as d, getUserInitials as e, formatUserRoles as f, getAvatarFallback as g, isRoleDeniedError as i };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/auth",
-  "version": "1.23.0",
+  "version": "1.28.0",
   "description": "Authentication services and Svelte bindings for Classic Theme apps",
   "type": "module",
   "main": "dist/index.js",

package/dist/auth.svelte-T4LKTTDZ.js

@@ -1,3 +0,0 @@
-export { authActions, authStore, currentUser, isAuthenticated } from './chunk-KSOYQYUZ.js';
-import './chunk-ETKDIPD2.js';
-import './chunk-2CYGQUUY.js';