@shware/security 7.1.0 → 8.0.0

package/dist/auth/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["isKnownOAuth2ErrorType","attributesSize","MAX_ATTRIBUTES_BYTES","OAuth2Client","getCookie","randomUUID","PRINCIPAL_NAME_INDEX_NAME","createHash","param","timing","query","oauth2RedirectQuerySchema","OAuth2Error","bodyAttributes","googleOneTapSchema","valid","sendEmailVerificationCodeSchema","verifyTurnstileToken","resourceExhausted","randomInt","invalidArgument","loginEmailSchema","timingSafeEqual"],"sources":["../../src/auth/index.ts"],"sourcesContent":["import { createHash, randomInt, randomUUID, timingSafeEqual } from 'node:crypto';\nimport { invariant } from '@shware/utils';\nimport type { Principal } from '../core/index';\nimport { loginEmailSchema, sendEmailVerificationCodeSchema } from '../email/schema';\nimport { OAuth2Client, googleOneTapSchema, oauth2RedirectQuerySchema } from '../oauth2/client';\nimport { OAuth2Error, type OAuth2ErrorType, isKnownOAuth2ErrorType } from '../oauth2/error';\nimport type {\n  NativeCredential,\n  OAuth2AuthorizationRequest,\n  PkceParameters,\n  StandardClaims,\n} from '../oauth2/types';\nimport { PRINCIPAL_NAME_INDEX_NAME } from '../session/common';\nimport type { KVRepository, Session, SessionRepository } from '../session/types';\nimport {\n  type CookieOptions,\n  deleteCookie,\n  getCookie,\n  param,\n  query,\n  setCookie,\n} from '../utils/http';\nimport { timing } from '../utils/timing';\nimport { invalidArgument, resourceExhausted, valid, verifyTurnstileToken } from '../utils/valid';\nimport { MAX_ATTRIBUTES_BYTES, attributesSize, bodyAttributes } from './attributes';\nimport type {\n  AuthConfig,\n  AuthService,\n  AuthorizedHandler,\n  LoggedHandler,\n  OAuth2AuthorizationOptions,\n} from './types';\n\n// PKCE per RFC 7636: code_verifier / code_challenge are 43-128 chars from\n// the unreserved set. We restrict to base64url (drops \".\" and \"~\") since\n// that's what S256 produces and what callers should be sending; rejecting\n// the rest shrinks the accepted input shape without losing legit clients.\n// A 32-byte random verifier base64url-encodes to exactly 43 chars.\nconst PKCE_FORMAT = /^[A-Za-z0-9_-]{43,128}$/;\n\n// A native app's `code_verifier` goes on to the provider, which checks it against the challenge\n// the app sent: accept the whole RFC 7636 unreserved set here, as the provider does.\nconst CODE_VERIFIER_FORMAT = /^[A-Za-z0-9._~-]{43,128}$/;\n\nconst INVALID_CODE_VERIFIER = {\n  error: 'invalid_request',\n  error_description: 'code_verifier must be 43-128 characters from [A-Za-z0-9-._~]',\n};\n\n// error_description forwarded to errorUri comes from the provider or an error message: cap it so\n// the redirect URL stays short and an attacker-crafted callback cannot stuff the page with text.\nconst MAX_ERROR_DESCRIPTION_LENGTH = 256;\n\n/** An error code safe to put on errorUri: a registered one as is, anything else as `fallback`. */\nfunction safeErrorType(error: string, fallback: OAuth2ErrorType): OAuth2ErrorType {\n  return isKnownOAuth2ErrorType(error) ? error : fallback;\n}\n\n/**\n * The codes a failure past validation keeps on errorUri, each one the user can act on: the code\n * expired or was used (start again), they declined, or the provider is briefly down. Every other\n * failure there (a rejected client, a user info request that failed) is the app's or the\n * provider's problem, which the user sees as `server_error`.\n */\nconst CALLBACK_ERROR_TYPES: ReadonlySet<OAuth2ErrorType> = new Set([\n  'invalid_grant',\n  'access_denied',\n  'temporarily_unavailable',\n]);\n\nfunction authorizationAttributes(\n  attributes: OAuth2AuthorizationOptions['attributes']\n): Record<string, string> | undefined {\n  if (!attributes) return undefined;\n  const defined: Record<string, string> = {};\n  for (const [key, value] of Object.entries(attributes)) {\n    if (value !== undefined) defined[key] = value;\n  }\n  if (Object.keys(defined).length === 0) return undefined;\n  // The host's own values, written with the session: oversized is a bug in the host, not a 400.\n  const size = attributesSize(defined);\n  invariant(\n    size <= MAX_ATTRIBUTES_BYTES,\n    `oauth2 authorization attributes are ${size} bytes, at most ${MAX_ATTRIBUTES_BYTES} allowed`\n  );\n  return defined;\n}\n\n/** Sign in with Apple answers with `response_mode=form_post`; a charset parameter may follow. */\nconst INVALID_ATTRIBUTES = {\n  error: 'invalid_request',\n  error_description: `attributes must map strings to strings, at most ${MAX_ATTRIBUTES_BYTES} bytes`,\n};\n\nfunction isFormPost(request: Request) {\n  const contentType = request.headers.get('content-type')?.toLowerCase();\n  return (\n    request.method === 'POST' && !!contentType?.startsWith('application/x-www-form-urlencoded')\n  );\n}\n\ninterface DesktopCodeRecord {\n  /** principal.name from the upstream cookie session */\n  name: string;\n  /** code_challenge (S256, base64url) — verifier must hash to this */\n  cc: string;\n}\n\nexport const PATH = {\n  CSRF: '/csrf',\n  LOGOUT: '/logout',\n  LOGGED: '/logged',\n\n  OAUTH2_STATE: '/oauth2/state/:provider',\n  OAUTH2_NONCE: '/oauth2/nonce/:provider',\n  OAUTH2_AUTHORIZATION: '/oauth2/authorization/:provider',\n  LOGIN_OAUTH2_CODE: '/login/oauth2/code/:provider',\n  LOGIN_OAUTH2_NATIVE: '/login/oauth2/native/:provider',\n  LOGIN_OAUTH2_ONETAP: '/login/oauth2/onetap/google',\n\n  LOGIN_EMAIL: '/login/email',\n  LOGIN_PHONE: '/login/phone',\n  SEND_EMAIL_VERIFICATION_CODE: '/auth/sendEmailVerificationCode',\n  SEND_PHONE_VERIFICATION_CODE: '/auth/sendPhoneVerificationCode',\n\n  // Desktop / native app sign-in via web loopback (RFC 8252 + OAuth 2.1 Auth Code Flow):\n  //   1. user already authenticated with cookie session → POST DESKTOP_AUTHORIZE → { code }\n  //   2. web redirects to desktop's loopback callback with the code\n  //   3. desktop renderer POSTs DESKTOP_EXCHANGE with the code → server returns\n  //      Set-Cookie carrying a fresh session, single-use code is invalidated\n  // The two-step flow keeps the actual session id off the redirect URL — only a\n  // 5-minute single-use code transits via the loopback.\n  DESKTOP_AUTHORIZE: '/auth/desktop/authorize',\n  DESKTOP_EXCHANGE: '/auth/desktop/exchange',\n\n  CLEANUP_EXPIRED_SESSIONS: '/sessions/expired/cleanup',\n} as const;\n\n/** Seconds an email verification code, and its attempt counter, stay valid. */\nconst EMAIL_VERIFICATION_CODE_TTL = 10 * 60;\n\nexport class Auth implements AuthService {\n  private readonly timing: boolean;\n  private readonly cookieName;\n  private readonly cookieOptions: CookieOptions;\n  private readonly kv: KVRepository;\n  private readonly repository: SessionRepository;\n  private readonly turnstileSecretKey?: string;\n  private readonly maxVerificationAttempts: number;\n  private readonly verificationResendCooldown: number;\n  private readonly oauth2Client: OAuth2Client | null;\n  private readonly onetapRequireNonce: boolean;\n  private readonly touchInterval: number;\n  private readonly ATTR_OAUTH2_AUTHORIZATION_REQUEST = 'oauth2AuthorizationRequest';\n\n  constructor({\n    sessionRepository,\n    kvRepository,\n    turnstileSecretKey,\n    verificationCode,\n    oauth2,\n    cookie,\n    session,\n    timing,\n  }: AuthConfig) {\n    this.timing = timing ?? false;\n    this.kv = kvRepository;\n    this.repository = sessionRepository;\n    this.turnstileSecretKey = turnstileSecretKey;\n    this.maxVerificationAttempts = verificationCode?.maxAttempts ?? 5;\n    this.verificationResendCooldown = verificationCode?.resendCooldown ?? 60;\n    invariant(this.maxVerificationAttempts >= 1, 'verificationCode.maxAttempts must be at least 1');\n    invariant(\n      this.verificationResendCooldown >= 1,\n      'verificationCode.resendCooldown must be at least 1 second'\n    );\n    const { name, ...cookieOptions } = cookie ?? {};\n    this.cookieName = name ?? 'SESSION';\n    this.cookieOptions = {\n      path: '/',\n      sameSite: 'none',\n      secure: true,\n      httpOnly: true,\n      ...cookieOptions,\n    };\n    this.oauth2Client = oauth2?.client ? new OAuth2Client(oauth2.client) : null;\n    this.onetapRequireNonce = oauth2?.onetap?.requireNonce ?? true;\n    this.touchInterval = (session?.touchInterval ?? 3600) * 1000;\n    invariant(this.touchInterval >= 0, 'session.touchInterval must not be negative');\n  }\n\n  private getSessionId(request: Request): string | undefined {\n    let sessionId: string | undefined;\n    const header = request.headers.get('Authorization');\n    if (header?.startsWith('Bearer ')) {\n      sessionId = header.replace('Bearer ', '');\n    }\n    if (!sessionId) {\n      sessionId = getCookie(request, this.cookieName);\n    }\n    return sessionId;\n  }\n\n  csrf = async (_request: Request): Promise<Response> => {\n    const token = randomUUID();\n    const response = Response.json({\n      token,\n      parameterName: '_csrf',\n      headerName: 'X-XSRF-TOKEN',\n    });\n\n    // Double Submit Cookie Protection\n    setCookie(response, 'XSRF-TOKEN', token, {\n      path: '/',\n      secure: true,\n      httpOnly: false,\n      sameSite: 'none',\n      domain: this.cookieOptions.domain,\n    });\n    return response;\n  };\n\n  logout = async (request: Request): Promise<Response> => {\n    const sessionId = this.getSessionId(request);\n    if (sessionId) await this.repository.deleteById(sessionId);\n    const response = Response.json({});\n    // A Set-Cookie only replaces the stored cookie when Domain and Path match (RFC 6265),\n    // so clear it with the same attributes it was set with.\n    deleteCookie(response, this.cookieName, this.cookieOptions);\n    return response;\n  };\n\n  logged = async (request: Request, onLogged?: LoggedHandler): Promise<Response> => {\n    // 1. get session from header or cookie\n    const sessionId = this.getSessionId(request);\n    if (!sessionId) return Response.json({ data: false });\n    const session = await this.repository.findById(sessionId);\n    if (!session) return Response.json({ data: false });\n\n    // 2. get principal name from session\n    const name = session.getAttribute(PRINCIPAL_NAME_INDEX_NAME);\n    session.setLastAccessedTime(Date.now());\n    await this.repository.save(session);\n\n    // 3. call onLogged\n    if (name !== null) await onLogged?.({ name: String(name) });\n\n    // 4. renew cookie\n    const response = Response.json({ data: name !== null });\n    const maxAge = session.getMaxInactiveInterval();\n    setCookie(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });\n    return response;\n  };\n\n  private createPkceParameters(): PkceParameters {\n    const code_verifier = randomUUID();\n    const code_challenge = createHash('sha256')\n      .update(code_verifier)\n      .digest()\n      .toString('base64url');\n\n    return { code_verifier, code_challenge, code_challenge_method: 'S256' };\n  }\n\n  private getOauth2StateKey(state: string) {\n    return `oauth2:state:${state}`;\n  }\n\n  private getOauth2NonceKey(nonce: string) {\n    return `oauth2:nonce:${nonce}`;\n  }\n\n  private getEmailVerificationCodeKey(email: string) {\n    return `email:verification:${email}`;\n  }\n\n  private getEmailVerificationAttemptsKey(email: string) {\n    return `email:verification-attempts:${email}`;\n  }\n\n  private getEmailVerificationCooldownKey(email: string) {\n    return `email:verification-cooldown:${email}`;\n  }\n\n  private getPhoneVerificationCodeKey(phone: string) {\n    return `phone:verification:${phone}`;\n  }\n\n  private getDesktopCodeKey(code: string) {\n    return `desktop:code:${code}`;\n  }\n\n  oauth2State = async (request: Request): Promise<Response> => {\n    const { provider } = param(request, PATH.OAUTH2_STATE);\n    const state = randomUUID();\n    await this.kv.setItem(this.getOauth2StateKey(state), provider, 10 * 60);\n    return Response.json({ state });\n  };\n\n  oauth2Nonce = async (request: Request): Promise<Response> => {\n    const { provider } = param(request, PATH.OAUTH2_NONCE);\n    const nonce = randomUUID();\n    await this.kv.setItem(this.getOauth2NonceKey(nonce), provider, 10 * 60);\n    return Response.json({ nonce });\n  };\n\n  oauth2Authorization = async (\n    request: Request,\n    options?: OAuth2AuthorizationOptions\n  ): Promise<Response> => {\n    invariant(this.oauth2Client, 'oauth2Client is not initialized');\n    const attributes = authorizationAttributes(options?.attributes);\n    const { mark, setTiming } = timing({ enabled: this.timing });\n    const { provider } = param(request, PATH.OAUTH2_AUTHORIZATION);\n    const state = randomUUID();\n    const pkce = this.createPkceParameters();\n    const uri = await this.oauth2Client.createAuthorizationUri({ provider, state, pkce });\n    const sessionId = this.getSessionId(request);\n    const session = sessionId\n      ? ((await this.repository.findById(sessionId)) ?? this.repository.createSession())\n      : this.repository.createSession();\n    mark('fetch_session');\n\n    const authorizationRequest: OAuth2AuthorizationRequest = {\n      state,\n      provider,\n      authorizationRequestUri: uri.href,\n      additionalParameters: pkce,\n      ...(attributes ? { attributes } : {}),\n    };\n\n    const value = JSON.stringify(authorizationRequest);\n    session.setAttribute(this.ATTR_OAUTH2_AUTHORIZATION_REQUEST, value);\n    await this.repository.save(session);\n    mark('save_session');\n\n    const response = new Response(null, { status: 302, headers: { location: uri.href } });\n    const maxAge = session.getMaxInactiveInterval();\n    setCookie(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });\n    setTiming(response);\n\n    return response;\n  };\n\n  private readonly redirect = (error: OAuth2ErrorType, description?: string): Response => {\n    invariant(this.oauth2Client, 'oauth2Client is not initialized');\n    const uri = new URL(this.oauth2Client.errorUri);\n    uri.searchParams.set('error', error);\n    if (description) {\n      uri.searchParams.set('error_description', description.slice(0, MAX_ERROR_DESCRIPTION_LENGTH));\n    }\n    return Response.redirect(uri.href, 302);\n  };\n\n  loginOAuth2Code = async (request: Request, handler: AuthorizedHandler): Promise<Response> => {\n    invariant(this.oauth2Client, 'oauth2Client is not initialized');\n    const { mark, setTiming } = timing({ enabled: this.timing });\n\n    // 1. get session from header or cookie\n    const sessionId = this.getSessionId(request);\n    const session = sessionId ? await this.repository.findById(sessionId) : null;\n    if (!session) {\n      return this.redirect('invalid_request', 'session not found');\n    }\n    mark('load_session');\n\n    // 2. get cached authorization request from session\n    const json = session.getAttribute(this.ATTR_OAUTH2_AUTHORIZATION_REQUEST) as string | null;\n    if (!json) {\n      return this.redirect('invalid_request', 'authorization request not found');\n    }\n    const cached: OAuth2AuthorizationRequest = JSON.parse(json);\n\n    // 3. validate redirect query/formdata\n    const { provider } = param(request, PATH.LOGIN_OAUTH2_CODE);\n    let data: Record<string, string>;\n    // apple redirect: response_mode=form_post\n    if (isFormPost(request)) {\n      const params = new URLSearchParams(await request.text());\n      data = Object.fromEntries(params.entries());\n    } else {\n      data = query(request);\n    }\n\n    const parsed = oauth2RedirectQuerySchema.safeParse(data);\n    if (!parsed.success) {\n      return this.redirect('invalid_request', 'invalid redirect query');\n    }\n    // The provider answered with an error instead of a code (the user pressed Cancel →\n    // access_denied, invalid_scope, server_error, ...). Forward it rather than reporting a\n    // malformed query. This runs before the state check on purpose: providers echo state on\n    // error responses, but not all reliably do, and a forged error callback can only make the\n    // victim's popup show an error — nothing is exchanged or signed in. A present state that does\n    // not match still wins, since that is the more accurate (and more alarming) diagnosis.\n    if (parsed.data.error) {\n      if (parsed.data.state && parsed.data.state !== cached.state) {\n        return this.redirect('invalid_request', 'redirect state mismatch');\n      }\n      return this.redirect(\n        safeErrorType(parsed.data.error, 'server_error'),\n        parsed.data.error_description\n      );\n    }\n    if (!parsed.data.code || !parsed.data.state) {\n      return this.redirect('invalid_request', 'invalid redirect query');\n    }\n    if (parsed.data.state !== cached.state) {\n      return this.redirect('invalid_request', 'redirect state mismatch');\n    }\n    if (provider !== cached.provider) {\n      return this.redirect('invalid_request', 'redirect provider mismatch');\n    }\n    mark('validate_session');\n\n    // 4. exchange authorization code for token and get user info\n    const { code, user } = parsed.data;\n\n    // Everything past validation can fail (an expired or reused code, a network error, the host's\n    // handler or session store). The callback runs in a popup the user is looking at, so every\n    // failure must land on errorUri instead of surfacing as a raw JSON error response.\n    let signedIn: Session;\n    try {\n      const { clientId, token } = await this.oauth2Client.exchangeAuthorizationCode({\n        provider,\n        code,\n        pkce: cached.additionalParameters,\n      });\n      // Apple posts the user's name alongside the code, once: hand it to the provider with the token.\n      const userInfo = await this.oauth2Client.getUserInfo({\n        provider,\n        clientId,\n        token,\n        response: user ? { user } : undefined,\n      });\n      mark('exchange_code');\n\n      // 5. create or update principal, with what the host attached when the flow started\n      const principal = await handler(request, {\n        provider,\n        clientId,\n        userInfo,\n        token,\n        attributes: cached.attributes ?? {},\n      });\n      mark('save_principal');\n\n      // 6. sign in on a new session: the id the browser brought may have been planted by an\n      // attacker who started the flow (session fixation), so it must not become authenticated.\n      signedIn = this.signedInSession(session, principal.name);\n      await this.repository.save(signedIn);\n      await this.repository.deleteById(session.getId());\n      mark('update_session');\n    } catch (error) {\n      // The details stay in the logs: an OAuth2Error message can carry a client id or a\n      // provider's response, which has no place in a URL the browser keeps in its history.\n      if (error instanceof OAuth2Error) {\n        console.warn('OAuth2 callback failed', error);\n        const type = CALLBACK_ERROR_TYPES.has(error.error) ? error.error : 'server_error';\n        return this.redirect(type);\n      }\n      console.error('OAuth2 callback failed', error);\n      return this.redirect('server_error');\n    }\n\n    const uri = new URL(this.oauth2Client.successUri);\n    uri.searchParams.set('status', 'success');\n    uri.searchParams.set('provider', provider);\n\n    const response = new Response(null, { status: 302, headers: { location: uri.href } });\n    const maxAge = signedIn.getMaxInactiveInterval();\n    setCookie(response, this.cookieName, signedIn.getId(), { ...this.cookieOptions, maxAge });\n    setTiming(response);\n\n    return response;\n  };\n\n  /**\n   * A fresh session for `name`, carrying over what the host kept in the pre-login one. The\n   * authorization request (state, PKCE verifier, flow attributes) is single-use and was consumed\n   * by this callback, and a principal left there from an earlier sign-in is replaced.\n   */\n  private signedInSession(previous: Session, name: string): Session {\n    const session = this.repository.createSession();\n    for (const attribute of previous.getAttributeNames()) {\n      if (attribute === this.ATTR_OAUTH2_AUTHORIZATION_REQUEST) continue;\n      if (attribute === PRINCIPAL_NAME_INDEX_NAME) continue;\n      const value = previous.getAttribute(attribute);\n      if (value !== null) session.setAttribute(attribute, value);\n    }\n    session.setAttribute(PRINCIPAL_NAME_INDEX_NAME, name);\n    return session;\n  }\n\n  loginOAuth2Native = async (request: Request, handler: AuthorizedHandler): Promise<Response> => {\n    invariant(this.oauth2Client, 'oauth2Client is not initialized');\n    const { mark, setTiming } = timing({ enabled: this.timing });\n    const { provider } = param(request, PATH.LOGIN_OAUTH2_NATIVE);\n    const body: unknown = await request.json();\n    // Whatever the app sends besides its credentials for `onAuthorized` (a referral code, ...).\n    const attributes = bodyAttributes(body);\n    if (!attributes) return Response.json(INVALID_ATTRIBUTES, { status: 400 });\n    // Only the credentials go on to the provider client.\n    const { attributes: _, ...credentials } = body as NativeCredential & { attributes?: unknown };\n    const { code_verifier } = credentials as { code_verifier?: unknown };\n    if (\n      code_verifier !== undefined &&\n      (typeof code_verifier !== 'string' || !CODE_VERIFIER_FORMAT.test(code_verifier))\n    ) {\n      return Response.json(INVALID_CODE_VERIFIER, { status: 400 });\n    }\n    const { clientId, userInfo, token } = await this.oauth2Client.loginOAuth2Native({\n      provider,\n      credentials,\n    });\n    mark('login_oauth2_native');\n\n    const { nonce } = userInfo.data as { nonce?: string };\n    if (nonce) {\n      const value = await this.kv.getItem(this.getOauth2NonceKey(nonce));\n      if (value !== provider) {\n        const json = { error: 'invalid_request', error_description: 'nonce mismatch' };\n        return Response.json(json, { status: 400 });\n      }\n      await this.kv.removeItem(this.getOauth2NonceKey(nonce));\n      mark('check_nonce');\n    }\n\n    const principal = await handler(request, { provider, clientId, userInfo, token, attributes });\n    mark('save_principal');\n\n    const session = this.repository.createSession();\n    session.setAttribute(PRINCIPAL_NAME_INDEX_NAME, principal.name);\n    await this.repository.save(session);\n    const response = new Response(JSON.stringify(principal), {\n      status: 200,\n      headers: { 'Content-Type': 'application/json' },\n    });\n    const maxAge = session.getMaxInactiveInterval();\n    setCookie(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });\n    setTiming(response);\n\n    return response;\n  };\n\n  loginOAuth2Onetap = async (\n    request: Request,\n    handler: AuthorizedHandler,\n    provider = 'google'\n  ): Promise<Response> => {\n    invariant(this.oauth2Client, 'oauth2Client is not initialized');\n    const { mark, setTiming } = timing({ enabled: this.timing });\n\n    // should support application/x-www-form-urlencoded and application/json\n    // Google's own form post carries no attributes; an app posting JSON may add them.\n    let body: Record<string, string>;\n    let attributes: Record<string, string> | null = {};\n    if (request.headers.get('Content-Type')?.includes('application/x-www-form-urlencoded')) {\n      const text = await request.text();\n      body = Object.fromEntries(new URLSearchParams(text));\n    } else if (request.headers.get('Content-Type')?.includes('application/json')) {\n      const json: unknown = await request.json();\n      attributes = bodyAttributes(json);\n      body = json as Record<string, string>;\n    } else {\n      const json = { error: 'invalid_request', error_description: 'invalid content type' };\n      return Response.json(json, { status: 400 });\n    }\n\n    if (!attributes) return Response.json(INVALID_ATTRIBUTES, { status: 400 });\n    const parsed = googleOneTapSchema.parse(body);\n\n    // Both the credential and the code are issued to the provider's web client.\n    let principal: Principal;\n    if (parsed.credential) {\n      const { clientId, token, userInfo } = await this.oauth2Client.getTokenInfo({\n        provider,\n        credential: parsed.credential,\n      });\n      mark('verify_credential');\n\n      // A credential is replayable until it expires, so it must carry a single-use nonce from\n      // `oauth2Nonce`, which the front end passed to `prompt`. This replaces Google's\n      // `g_csrf_token` double-submit cookie, which FedCM mode no longer sets.\n      const { nonce } = userInfo.data as { nonce?: unknown };\n      if (typeof nonce === 'string' && nonce) {\n        const value = await this.kv.getItem(this.getOauth2NonceKey(nonce));\n        if (value !== provider) {\n          const json = { error: 'invalid_request', error_description: 'nonce mismatch' };\n          return Response.json(json, { status: 401 });\n        }\n        await this.kv.removeItem(this.getOauth2NonceKey(nonce));\n        mark('check_nonce');\n      } else if (this.onetapRequireNonce) {\n        const json = { error: 'invalid_request', error_description: 'nonce missing' };\n        return Response.json(json, { status: 401 });\n      }\n\n      principal = await handler(request, { provider, clientId, userInfo, token, attributes });\n    } else if (parsed.code) {\n      const { clientId, token } = await this.oauth2Client.exchangeAuthorizationCode({\n        provider,\n        code: parsed.code,\n      });\n      const userInfo = await this.oauth2Client.getUserInfo({ provider, clientId, token });\n      principal = await handler(request, { provider, clientId, userInfo, token, attributes });\n    } else {\n      throw new Error('invalid request');\n    }\n\n    mark('save_principal');\n\n    const session = this.repository.createSession();\n    session.setAttribute(PRINCIPAL_NAME_INDEX_NAME, principal.name);\n    await this.repository.save(session);\n    const response = new Response(JSON.stringify(principal), {\n      status: 200,\n      headers: { 'Content-Type': 'application/json' },\n    });\n    const maxAge = session.getMaxInactiveInterval();\n    setCookie(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });\n    setTiming(response);\n\n    return response;\n  };\n\n  sendEmailVerificationCode = async (\n    request: Request,\n    sender: (data: { email: string; verificationCode: string }) => Promise<void>\n  ): Promise<Response> => {\n    invariant(this.turnstileSecretKey, 'turnstileSecretKey is not configured');\n\n    const { data, error } = valid(sendEmailVerificationCodeSchema, await request.json());\n    if (error) return Response.json(error, { status: error.error.code });\n    const { email, turnstileToken } = data;\n\n    const result = await verifyTurnstileToken(this.turnstileSecretKey, turnstileToken);\n    if (result.error) return Response.json(result.error, { status: result.error.error.code });\n\n    // The cooldown is claimed before sending, so of concurrent requests exactly one sends. A failed\n    // delivery releases it again: no code was stored, so an immediate retry gains an attacker\n    // nothing, while keeping it would lock the user out of signing in for the whole cooldown.\n    const cooldownKey = this.getEmailVerificationCooldownKey(email);\n    if ((await this.kv.increment(cooldownKey, this.verificationResendCooldown)) > 1) {\n      const error = resourceExhausted(\n        'VERIFICATION_CODE_RESEND_TOO_SOON',\n        'Verification code was sent recently'\n      );\n      return Response.json(error, { status: error.error.code });\n    }\n\n    try {\n      // Sent before it is stored, so a failed delivery leaves the previous code usable.\n      const verificationCode = randomInt(1_000_000).toString().padStart(6, '0');\n      await sender({ email, verificationCode });\n      // The new code gets the full attempt budget; the cooldown bounds how often that happens.\n      // Reset before storing, so every comparison against the new code is counted.\n      await this.kv.removeItem(this.getEmailVerificationAttemptsKey(email));\n      await this.kv.setItem(\n        this.getEmailVerificationCodeKey(email),\n        verificationCode,\n        EMAIL_VERIFICATION_CODE_TTL\n      );\n      return Response.json({});\n    } catch (e) {\n      console.error('Failed to send email verification code', e);\n      await this.kv.removeItem(cooldownKey);\n      return Response.json(invalidArgument('EMAIL_DELIVERY_FAILED'), { status: 400 });\n    }\n  };\n\n  loginEmail = async (request: Request, handler: AuthorizedHandler): Promise<Response> => {\n    const { data, error } = valid(loginEmailSchema, await request.json());\n    if (error) return Response.json(error, { status: error.error.code });\n    const { email, verificationCode, attributes } = data;\n\n    const key = this.getEmailVerificationCodeKey(email);\n    const attemptsKey = this.getEmailVerificationAttemptsKey(email);\n    const stored = await this.kv.getItem(key);\n    if (typeof stored !== 'string') {\n      return Response.json(invalidArgument('INVALID_VERIFICATION_CODE'), { status: 400 });\n    }\n\n    // Count the attempt before comparing: the atomic increment hands every request, parallel ones\n    // included, a distinct count, so at most maxAttempts comparisons are ever made against a code.\n    const attempts = await this.kv.increment(attemptsKey, EMAIL_VERIFICATION_CODE_TTL);\n    if (attempts > this.maxVerificationAttempts) {\n      // Only the code is discarded. The counter stays until it expires (or a new code is sent):\n      // removing it would hand requests that already read the code a fresh budget.\n      await this.kv.removeItem(key);\n      const error = invalidArgument('VERIFICATION_CODE_ATTEMPTS_EXCEEDED');\n      return Response.json(error, { status: error.error.code });\n    }\n    if (\n      stored.length !== verificationCode.length ||\n      !timingSafeEqual(Buffer.from(stored), Buffer.from(verificationCode))\n    ) {\n      return Response.json(invalidArgument('INVALID_VERIFICATION_CODE'), { status: 400 });\n    }\n    await this.kv.removeItem(key);\n    await this.kv.removeItem(attemptsKey);\n    const claims: StandardClaims = { sub: email, email, email_verified: true };\n    const principal = await handler(request, {\n      provider: 'EMAIL',\n      userInfo: { claims, data: {} },\n      attributes: attributes ?? {},\n    });\n\n    // save session\n    const session = this.repository.createSession();\n    session.setAttribute(PRINCIPAL_NAME_INDEX_NAME, principal.name);\n    await this.repository.save(session);\n    const response = new Response(JSON.stringify(principal), {\n      status: 200,\n      headers: { 'Content-Type': 'application/json' },\n    });\n    const maxAge = session.getMaxInactiveInterval();\n    setCookie(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });\n\n    return response;\n  };\n\n  /**\n   * Step 1 of the desktop / native app sign-in handshake. The caller already\n   * completed normal sign-in on the web (so a cookie session exists); this\n   * issues a 5-minute single-use code that the web page hands off to the\n   * desktop client via a loopback redirect.\n   *\n   * PKCE (RFC 7636, S256 only): the desktop generates a random `code_verifier`\n   * before opening the browser, derives `code_challenge = base64url(sha256(verifier))`,\n   * and threads the challenge through the URL → web page → here. We pin\n   * the challenge to the code in KV; `desktopExchange` enforces that the\n   * caller knows the matching verifier. This blocks an attacker who only\n   * intercepts the auth code (browser history, malicious extension, packet\n   * capture on loopback) from exchanging it.\n   *\n   * Requires an authenticated cookie session — anonymous callers get 401.\n   * Throttling / abuse protection on this endpoint is the API layer's job\n   * (rate-limit per principal); the SDK doesn't gate it because the\n   * upstream sign-in flow already passed CAPTCHA / OAuth / verification.\n   */\n  desktopAuthorize = async (request: Request): Promise<Response> => {\n    const principal = await this.getPrincipal(request);\n    if (!principal) {\n      const body = {\n        error: {\n          code: 401,\n          status: 'UNAUTHENTICATED',\n          message: 'sign in first',\n          details: [],\n        },\n      };\n      return Response.json(body, { status: 401 });\n    }\n\n    let body: { code_challenge?: unknown; code_challenge_method?: unknown };\n    try {\n      body = (await request.json()) as {\n        code_challenge?: unknown;\n        code_challenge_method?: unknown;\n      };\n    } catch {\n      return Response.json(invalidArgument('INVALID_ARGUMENT'), { status: 400 });\n    }\n\n    const codeChallenge = typeof body.code_challenge === 'string' ? body.code_challenge : null;\n    if (\n      !codeChallenge ||\n      body.code_challenge_method !== 'S256' ||\n      !PKCE_FORMAT.test(codeChallenge)\n    ) {\n      return Response.json(invalidArgument('INVALID_ARGUMENT'), { status: 400 });\n    }\n\n    const code = randomUUID();\n    const record: DesktopCodeRecord = { name: principal.name, cc: codeChallenge };\n    await this.kv.setItem(this.getDesktopCodeKey(code), JSON.stringify(record), 5 * 60);\n\n    return Response.json({ code });\n  };\n\n  /**\n   * Step 2 of the desktop / native app sign-in handshake. The desktop\n   * client hands back the auth code it received via the loopback callback,\n   * and we mint a fresh session for it — independent of the web cookie\n   * session that originally `authorize`'d the code, so logging out on\n   * either side doesn't cascade to the other.\n   *\n   * Cookie attributes: defaults to `SameSite=None; Secure` so the cookie\n   * survives cross-site fetches from the desktop renderer's `file://` /\n   * `app://` origin. The configured base `cookieOptions` provide\n   * everything else (`domain`, `path`, `httpOnly`, `maxAge`); the override\n   * is targeted at the SameSite/Secure pair only. In a non-HTTPS dev\n   * backend this combination is rejected by Chromium — see the desktop\n   * sign-in PRD for workarounds.\n   *\n   * No CSRF check needed — the request carries no cookie, the auth code\n   * itself is the credential, and KV's single-use removal blocks replay.\n   */\n  desktopExchange = async (request: Request): Promise<Response> => {\n    let body: { code?: unknown; code_verifier?: unknown };\n    try {\n      body = (await request.json()) as { code?: unknown; code_verifier?: unknown };\n    } catch {\n      return Response.json(invalidArgument('INVALID_ARGUMENT'), { status: 400 });\n    }\n\n    const code = typeof body.code === 'string' ? body.code : null;\n    const verifier = typeof body.code_verifier === 'string' ? body.code_verifier : null;\n    if (!code || !verifier || !PKCE_FORMAT.test(verifier)) {\n      return Response.json(invalidArgument('INVALID_ARGUMENT'), { status: 400 });\n    }\n\n    const key = this.getDesktopCodeKey(code);\n    const raw = await this.kv.getItem(key);\n    if (typeof raw !== 'string') {\n      return Response.json(invalidArgument('INVALID_DESKTOP_CODE'), { status: 400 });\n    }\n    let record: DesktopCodeRecord;\n    try {\n      record = JSON.parse(raw) as DesktopCodeRecord;\n    } catch {\n      // Malformed KV record (shouldn't happen with our own writes) — drop it\n      // and surface as an invalid code; the caller can retry the whole flow.\n      await this.kv.removeItem(key);\n      return Response.json(invalidArgument('INVALID_DESKTOP_CODE'), { status: 400 });\n    }\n\n    // Verify PKCE: base64url(sha256(verifier)) === stored challenge.\n    // Don't burn the code on a verifier mismatch — that would let an\n    // attacker who races a network retry brick a legit exchange. The code\n    // is single-use on success and 5-min TTL bounded; brute-forcing the\n    // 256-bit verifier in that window is infeasible.\n    const computed = createHash('sha256').update(verifier).digest();\n    const stored = Buffer.from(record.cc, 'base64url');\n    if (stored.length !== computed.length || !timingSafeEqual(computed, stored)) {\n      return Response.json(invalidArgument('INVALID_DESKTOP_CODE'), { status: 400 });\n    }\n\n    // One-time use: remove BEFORE creating the session so a concurrent\n    // duplicate exchange (e.g. retry after timeout) sees the code as\n    // consumed even if our session save races it.\n    await this.kv.removeItem(key);\n\n    const session = this.repository.createSession();\n    session.setAttribute(PRINCIPAL_NAME_INDEX_NAME, record.name);\n    session.setAttribute('client_type', 'desktop');\n    await this.repository.save(session);\n\n    const response = Response.json({ ok: true });\n    const maxAge = session.getMaxInactiveInterval();\n    setCookie(response, this.cookieName, session.getId(), {\n      ...this.cookieOptions,\n      // Override sameSite/secure for desktop: the renderer's origin\n      // (file:// / app://) is cross-site to the API, so SameSite=Lax/Strict\n      // would block the cookie on subsequent fetches.\n      sameSite: 'none',\n      secure: true,\n      maxAge,\n    });\n    return response;\n  };\n\n  sendPhoneVerificationCode = async (\n    _request: Request,\n    _sender: (data: { phone: string; verificationCode: string }) => Promise<void>\n  ): Promise<Response> => {\n    return Response.json({ error: 'not_implemented' }, { status: 501 });\n  };\n\n  loginPhone = async (_request: Request, _handler: AuthorizedHandler): Promise<Response> => {\n    return Response.json({ error: 'not_implemented' }, { status: 501 });\n  };\n\n  kick = async (principal: Principal): Promise<void> => {\n    const sessions = await this.repository.findByPrincipalName(principal.name);\n    for (const sessionId of sessions.keys()) {\n      await this.repository.deleteById(sessionId);\n    }\n  };\n\n  /**\n   * Sliding expiration: an authenticated request renews the session, as `logged` does, so a user\n   * who keeps using the app is never signed out after `maxInactiveInterval` of not calling one\n   * particular endpoint. No extra read: the session was just loaded to authenticate, and its\n   * `lastAccessedTime` is compared in memory; writes are spaced by `session.touchInterval` (see\n   * `AuthConfig`), so a session accessed again within the interval is not rewritten.\n   */\n  private async touch(session: Session) {\n    const now = Date.now();\n    if (now - session.getLastAccessedTime() < this.touchInterval) return;\n    session.setLastAccessedTime(now);\n    await this.repository.save(session);\n  }\n\n  isAuthenticated = async (request: Request): Promise<boolean> => {\n    const sessionId = this.getSessionId(request);\n    if (!sessionId) return false;\n    const session = await this.repository.findById(sessionId);\n    if (!session) return false;\n    const principalName = session.getAttribute(PRINCIPAL_NAME_INDEX_NAME);\n    if (!principalName) return false;\n    await this.touch(session);\n    return true;\n  };\n\n  getSession = async <T extends boolean>(\n    request: Request,\n    create: T\n  ): Promise<T extends true ? Session : Session | null> => {\n    const sessionId = this.getSessionId(request);\n    if (!sessionId) {\n      if (create) {\n        const session = this.repository.createSession();\n        await this.repository.save(session);\n        return session;\n      } else {\n        return null as T extends true ? Session : Session | null;\n      }\n    }\n    const session = await this.repository.findById(sessionId);\n    if (!session) {\n      if (create) {\n        const session = this.repository.createSession();\n        await this.repository.save(session);\n        return session;\n      } else {\n        return null as T extends true ? Session : Session | null;\n      }\n    }\n    return session;\n  };\n\n  deleteSession = async (sessionId: string): Promise<void> => {\n    await this.repository.deleteById(sessionId);\n  };\n\n  getPrincipal = async (request: Request): Promise<Principal | null> => {\n    const sessionId = this.getSessionId(request);\n    if (!sessionId) return null;\n    const session = await this.repository.findById(sessionId);\n    if (!session) return null;\n    const name = session.getAttribute(PRINCIPAL_NAME_INDEX_NAME);\n    if (!name) return null;\n    await this.touch(session);\n    return { name: String(name) };\n  };\n\n  listSessions = async (principal: Principal): Promise<Session[]> => {\n    const sessions = await this.repository.findByPrincipalName(principal.name);\n    return Array.from(sessions.values());\n  };\n\n  cleanupExpiredSessions = async (cleanupCount?: number): Promise<Response> => {\n    await this.repository.cleanupExpiredSessions(cleanupCount);\n    return Response.json({});\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["isKnownOAuth2ErrorType","attributesSize","MAX_ATTRIBUTES_BYTES","extend","googleOneTapSchema","attributesSchema","object","string","regex","literal","EmailVerificationCodes","DesktopCodes","OAuth2Client","getCookie","PRINCIPAL_NAME_INDEX_NAME","errorResponse","randomUUID","createHash","AuthenticationError","param","timing","query","oauth2RedirectQuerySchema","OAuth2Error","readJson","bodyAttributes","invalidArgument","readForm","parse","sendEmailVerificationCodeSchema","verifyTurnstileToken","loginEmailSchema","unauthenticated"],"sources":["../../src/auth/index.ts"],"sourcesContent":["import { createHash, randomUUID } from 'node:crypto';\nimport { invariant } from '@shware/utils';\nimport { extend, literal, object, regex, string } from 'zod/mini';\nimport type { Principal } from '../core/index';\nimport { loginEmailSchema, sendEmailVerificationCodeSchema } from '../email/schema';\nimport { OAuth2Client, googleOneTapSchema, oauth2RedirectQuerySchema } from '../oauth2/client';\nimport { OAuth2Error, type OAuth2ErrorType, isKnownOAuth2ErrorType } from '../oauth2/error';\nimport type {\n  NativeCredential,\n  OAuth2AuthorizationRequest,\n  PkceParameters,\n  StandardClaims,\n} from '../oauth2/types';\nimport { PRINCIPAL_NAME_INDEX_NAME } from '../session/common';\nimport type { KVRepository, Session, SessionRepository } from '../session/types';\nimport {\n  type CookieOptions,\n  deleteCookie,\n  getCookie,\n  param,\n  query,\n  setCookie,\n} from '../utils/http';\nimport { timing } from '../utils/timing';\nimport { parse, readForm, readJson, verifyTurnstileToken } from '../utils/valid';\nimport {\n  MAX_ATTRIBUTES_BYTES,\n  attributesSchema,\n  attributesSize,\n  bodyAttributes,\n} from './attributes';\nimport { DesktopCodes } from './desktop-codes';\nimport { type EmailSender, EmailVerificationCodes } from './email-codes';\nimport { AuthenticationError } from './error';\nimport { errorResponse, invalidArgument, unauthenticated } from './respond';\nimport type {\n  AuthConfig,\n  AuthService,\n  Authorization,\n  AuthorizedHandler,\n  LoggedHandler,\n  OAuth2AuthorizationOptions,\n} from './types';\n\n// PKCE per RFC 7636: code_verifier / code_challenge are 43-128 chars from\n// the unreserved set. We restrict to base64url (drops \".\" and \"~\") since\n// that's what S256 produces and what callers should be sending; rejecting\n// the rest shrinks the accepted input shape without losing legit clients.\n// A 32-byte random verifier base64url-encodes to exactly 43 chars.\nconst PKCE_FORMAT = /^[A-Za-z0-9_-]{43,128}$/;\n\n// A native app's `code_verifier` goes on to the provider, which checks it against the challenge\n// the app sent: accept the whole RFC 7636 unreserved set here, as the provider does.\nconst CODE_VERIFIER_FORMAT = /^[A-Za-z0-9._~-]{43,128}$/;\n\n/** The header a session id travels in besides the cookie, with `session.header` on. */\nconst SESSION_HEADER = 'X-Auth-Token';\n\n/** Seconds an OAuth2 state or nonce may be used within. */\nconst OAUTH2_PARAMETER_TTL = 10 * 60;\n\n// error_description forwarded to errorUri comes from the provider or an error message: cap it so\n// the redirect URL stays short and an attacker-crafted callback cannot stuff the page with text.\nconst MAX_ERROR_DESCRIPTION_LENGTH = 256;\n\n/** An error code safe to put on errorUri: a registered one as is, anything else as `fallback`. */\nfunction safeErrorType(error: string, fallback: OAuth2ErrorType): OAuth2ErrorType {\n  return isKnownOAuth2ErrorType(error) ? error : fallback;\n}\n\n/**\n * The codes a failure past validation keeps on errorUri, each one the user can act on: the code\n * expired or was used (start again), they declined, or the provider is briefly down. Every other\n * failure there (a rejected client, a user info request that failed) is the app's or the\n * provider's problem, which the user sees as `server_error`.\n */\nconst CALLBACK_ERROR_TYPES: ReadonlySet<OAuth2ErrorType> = new Set([\n  'invalid_grant',\n  'access_denied',\n  'temporarily_unavailable',\n]);\n\nfunction authorizationAttributes(\n  attributes: OAuth2AuthorizationOptions['attributes']\n): Record<string, string> | undefined {\n  if (!attributes) return undefined;\n  const defined: Record<string, string> = {};\n  for (const [key, value] of Object.entries(attributes)) {\n    if (value !== undefined) defined[key] = value;\n  }\n  if (Object.keys(defined).length === 0) return undefined;\n  // The host's own values, written with the session: oversized is a bug in the host, not a 400.\n  const size = attributesSize(defined);\n  invariant(\n    size <= MAX_ATTRIBUTES_BYTES,\n    `oauth2 authorization attributes are ${size} bytes, at most ${MAX_ATTRIBUTES_BYTES} allowed`\n  );\n  return defined;\n}\n\n/** Sign in with Apple answers with `response_mode=form_post`; a charset parameter may follow. */\nfunction isFormPost(request: Request) {\n  const contentType = request.headers.get('content-type')?.toLowerCase();\n  return (\n    request.method === 'POST' && !!contentType?.startsWith('application/x-www-form-urlencoded')\n  );\n}\n\n/** Google's own form post carries no attributes; an app posting JSON may add them. */\nconst oneTapBodySchema = extend(googleOneTapSchema, { attributes: attributesSchema });\n\nconst desktopAuthorizeSchema = object({\n  code_challenge: string().check(regex(PKCE_FORMAT)),\n  code_challenge_method: literal('S256'),\n});\n\nconst desktopExchangeSchema = object({\n  code: string(),\n  code_verifier: string().check(regex(PKCE_FORMAT)),\n});\n\nexport const PATH = {\n  CSRF: '/csrf',\n  LOGOUT: '/logout',\n  LOGGED: '/logged',\n\n  OAUTH2_STATE: '/oauth2/state/:provider',\n  OAUTH2_NONCE: '/oauth2/nonce/:provider',\n  OAUTH2_AUTHORIZATION: '/oauth2/authorization/:provider',\n  LOGIN_OAUTH2_CODE: '/login/oauth2/code/:provider',\n  LOGIN_OAUTH2_NATIVE: '/login/oauth2/native/:provider',\n  LOGIN_OAUTH2_ONETAP: '/login/oauth2/onetap/google',\n\n  LOGIN_EMAIL: '/login/email',\n  SEND_EMAIL_VERIFICATION_CODE: '/auth/sendEmailVerificationCode',\n\n  // Desktop / native app sign-in via web loopback (RFC 8252 + OAuth 2.1 Auth Code Flow):\n  //   1. user already authenticated with cookie session → POST DESKTOP_AUTHORIZE → { code }\n  //   2. web redirects to desktop's loopback callback with the code\n  //   3. desktop renderer POSTs DESKTOP_EXCHANGE with the code → server returns\n  //      Set-Cookie carrying a fresh session, single-use code is invalidated\n  // The two-step flow keeps the actual session id off the redirect URL — only a\n  // 5-minute single-use code transits via the loopback.\n  DESKTOP_AUTHORIZE: '/auth/desktop/authorize',\n  DESKTOP_EXCHANGE: '/auth/desktop/exchange',\n\n  CLEANUP_EXPIRED_SESSIONS: '/sessions/expired/cleanup',\n} as const;\n\n/**\n * The login routes and session helpers. Every route is one straight line: read and validate the\n * request, check the credential, call the host's `onAuthorized`, sign in. Failures are thrown and\n * answered in one place per kind of route: a JSON route runs under `guard`, which maps a\n * `RequestError`, an `AuthenticationError` or an `OAuth2Error` to its google.rpc body (see\n * `respond.ts`); the redirect callback maps the same errors to `errorUri` parameters (`redirect`).\n */\nexport class Auth implements AuthService {\n  private readonly timing: boolean;\n  private readonly cookieName;\n  private readonly cookieOptions: CookieOptions;\n  private readonly kv: KVRepository;\n  private readonly repository: SessionRepository;\n  private readonly turnstileSecretKey?: string;\n  private readonly emailCodes: EmailVerificationCodes;\n  private readonly desktopCodes: DesktopCodes;\n  private readonly oauth2Client: OAuth2Client | null;\n  private readonly onetapRequireNonce: boolean;\n  private readonly touchInterval: number;\n  private readonly sessionHeader: boolean;\n  private readonly ATTR_OAUTH2_AUTHORIZATION_REQUEST = 'oauth2AuthorizationRequest';\n\n  constructor({\n    sessionRepository,\n    kvRepository,\n    turnstileSecretKey,\n    verificationCode,\n    oauth2,\n    cookie,\n    session,\n    timing,\n  }: AuthConfig) {\n    this.timing = timing ?? false;\n    this.kv = kvRepository;\n    this.repository = sessionRepository;\n    this.turnstileSecretKey = turnstileSecretKey;\n    const maxAttempts = verificationCode?.maxAttempts ?? 5;\n    const resendCooldown = verificationCode?.resendCooldown ?? 60;\n    invariant(maxAttempts >= 1, 'verificationCode.maxAttempts must be at least 1');\n    invariant(resendCooldown >= 1, 'verificationCode.resendCooldown must be at least 1 second');\n    this.emailCodes = new EmailVerificationCodes(kvRepository, { maxAttempts, resendCooldown });\n    this.desktopCodes = new DesktopCodes(kvRepository);\n    const { name, ...cookieOptions } = cookie ?? {};\n    this.cookieName = name ?? 'SESSION';\n    this.cookieOptions = {\n      path: '/',\n      sameSite: 'none',\n      secure: true,\n      httpOnly: true,\n      ...cookieOptions,\n    };\n    this.oauth2Client = oauth2?.client ? new OAuth2Client(oauth2.client) : null;\n    this.onetapRequireNonce = oauth2?.onetap?.requireNonce ?? true;\n    this.touchInterval = (session?.touchInterval ?? 3600) * 1000;\n    this.sessionHeader = session?.header ?? false;\n    invariant(this.touchInterval >= 0, 'session.touchInterval must not be negative');\n  }\n\n  // ---- sessions and responses ------------------------------------------------------------------\n\n  private getSessionId(request: Request): string | undefined {\n    const fromCookie = getCookie(request, this.cookieName);\n    if (fromCookie) return fromCookie;\n    return (this.sessionHeader && request.headers.get(SESSION_HEADER)) || undefined;\n  }\n\n  /** The session the request carries, if it exists. */\n  private async loadSession(request: Request): Promise<Session | null> {\n    const sessionId = this.getSessionId(request);\n    return sessionId ? this.repository.findById(sessionId) : null;\n  }\n\n  /** The signed-in principal of a session, if any. */\n  private principalOf(session: Session): Principal | null {\n    const name = session.getAttribute(PRINCIPAL_NAME_INDEX_NAME);\n    return name ? { name: String(name) } : null;\n  }\n\n  /**\n   * A new session signed in as `principal`. With `carryOver`, what the host kept in the pre-login\n   * session moves to the new one; the authorization request (state, PKCE verifier, flow\n   * attributes) is single-use and was consumed, and a principal left there from an earlier\n   * sign-in is replaced. The new id is never the one the browser brought, which may have been\n   * planted by an attacker who started the flow (session fixation).\n   */\n  private async signIn(principal: Principal, carryOver?: Session): Promise<Session> {\n    const session = this.repository.createSession();\n    for (const attribute of carryOver?.getAttributeNames() ?? []) {\n      if (attribute === this.ATTR_OAUTH2_AUTHORIZATION_REQUEST) continue;\n      if (attribute === PRINCIPAL_NAME_INDEX_NAME) continue;\n      const value = carryOver?.getAttribute(attribute);\n      if (value !== null && value !== undefined) session.setAttribute(attribute, value);\n    }\n    session.setAttribute(PRINCIPAL_NAME_INDEX_NAME, principal.name);\n    await this.repository.save(session);\n    return session;\n  }\n\n  /**\n   * `response` carrying `session`: its cookie, renewed for the whole inactive interval, and with\n   * `session.header` on, the `X-Auth-Token` header a client without a cookie jar reads.\n   */\n  private withSession(response: Response, session: Session, cookie?: CookieOptions): Response {\n    const maxAge = session.getMaxInactiveInterval();\n    setCookie(response, this.cookieName, session.getId(), {\n      ...this.cookieOptions,\n      ...cookie,\n      maxAge,\n    });\n    if (this.sessionHeader) response.headers.set(SESSION_HEADER, session.getId());\n    return response;\n  }\n\n  /** Runs a JSON route: a failure it knows is its response, anything else is the host's. */\n  private async guard(run: () => Promise<Response>): Promise<Response> {\n    try {\n      return await run();\n    } catch (error) {\n      const response = errorResponse(error);\n      if (response) return response;\n      throw error;\n    }\n  }\n\n  /** The error redirect of the callback flow; `refusal`'s reason and metadata ride along. */\n  private redirect(\n    error: OAuth2ErrorType,\n    description?: string,\n    refusal?: AuthenticationError\n  ): Response {\n    invariant(this.oauth2Client, 'oauth2Client is not initialized');\n    const uri = new URL(this.oauth2Client.errorUri);\n    // Metadata never replaces a parameter: not one errorUri carries itself, nor one set below.\n    for (const [key, value] of Object.entries(refusal?.metadata ?? {})) {\n      if (!uri.searchParams.has(key)) uri.searchParams.set(key, value);\n    }\n    uri.searchParams.set('error', error);\n    if (description) {\n      uri.searchParams.set('error_description', description.slice(0, MAX_ERROR_DESCRIPTION_LENGTH));\n    }\n    if (refusal) uri.searchParams.set('reason', refusal.reason);\n    return Response.redirect(uri.href, 302);\n  }\n\n  // ---- basic -----------------------------------------------------------------------------------\n\n  csrf = async (_request: Request): Promise<Response> => {\n    const token = randomUUID();\n    const response = Response.json({\n      token,\n      parameterName: '_csrf',\n      headerName: 'X-XSRF-TOKEN',\n    });\n\n    // Double Submit Cookie Protection\n    setCookie(response, 'XSRF-TOKEN', token, {\n      path: '/',\n      secure: true,\n      httpOnly: false,\n      sameSite: 'none',\n      domain: this.cookieOptions.domain,\n    });\n    return response;\n  };\n\n  logout = async (request: Request): Promise<Response> => {\n    const sessionId = this.getSessionId(request);\n    if (sessionId) await this.repository.deleteById(sessionId);\n    const response = Response.json({});\n    // A Set-Cookie only replaces the stored cookie when Domain and Path match (RFC 6265),\n    // so clear it with the same attributes it was set with.\n    deleteCookie(response, this.cookieName, this.cookieOptions);\n    return response;\n  };\n\n  logged = async (request: Request, onLogged?: LoggedHandler): Promise<Response> => {\n    const session = await this.loadSession(request);\n    if (!session) return Response.json({ data: false });\n\n    session.setLastAccessedTime(Date.now());\n    await this.repository.save(session);\n\n    const principal = this.principalOf(session);\n    if (principal) await onLogged?.(principal);\n    return this.withSession(Response.json({ data: principal !== null }), session);\n  };\n\n  // ---- oauth2 ----------------------------------------------------------------------------------\n\n  private createPkceParameters(): PkceParameters {\n    const code_verifier = randomUUID();\n    const code_challenge = createHash('sha256')\n      .update(code_verifier)\n      .digest()\n      .toString('base64url');\n\n    return { code_verifier, code_challenge, code_challenge_method: 'S256' };\n  }\n\n  private getOauth2StateKey(state: string) {\n    return `oauth2:state:${state}`;\n  }\n\n  private getOauth2NonceKey(nonce: string) {\n    return `oauth2:nonce:${nonce}`;\n  }\n\n  /**\n   * Spends a nonce `oauth2Nonce` issued for `provider`: `NONCE_MISMATCH` for one that was not,\n   * or was used already. An id token is replayable until it expires; the nonce it carries makes\n   * it sign in once.\n   */\n  private async consumeNonce(nonce: string, provider: string): Promise<void> {\n    const key = this.getOauth2NonceKey(nonce);\n    if ((await this.kv.getItem(key)) !== provider) throw new AuthenticationError('NONCE_MISMATCH');\n    await this.kv.removeItem(key);\n  }\n\n  oauth2State = async (request: Request): Promise<Response> => {\n    const { provider } = param(request, PATH.OAUTH2_STATE);\n    const state = randomUUID();\n    await this.kv.setItem(this.getOauth2StateKey(state), provider, OAUTH2_PARAMETER_TTL);\n    return Response.json({ state });\n  };\n\n  oauth2Nonce = async (request: Request): Promise<Response> => {\n    const { provider } = param(request, PATH.OAUTH2_NONCE);\n    const nonce = randomUUID();\n    await this.kv.setItem(this.getOauth2NonceKey(nonce), provider, OAUTH2_PARAMETER_TTL);\n    return Response.json({ nonce });\n  };\n\n  oauth2Authorization = (\n    request: Request,\n    options?: OAuth2AuthorizationOptions\n  ): Promise<Response> =>\n    this.guard(async () => {\n      invariant(this.oauth2Client, 'oauth2Client is not initialized');\n      const attributes = authorizationAttributes(options?.attributes);\n      const { mark, setTiming } = timing({ enabled: this.timing });\n      const { provider } = param(request, PATH.OAUTH2_AUTHORIZATION);\n      const state = randomUUID();\n      const pkce = this.createPkceParameters();\n      const uri = await this.oauth2Client.createAuthorizationUri({ provider, state, pkce });\n      const session = (await this.loadSession(request)) ?? this.repository.createSession();\n      mark('fetch_session');\n\n      const authorizationRequest: OAuth2AuthorizationRequest = {\n        state,\n        provider,\n        authorizationRequestUri: uri.href,\n        additionalParameters: pkce,\n        ...(attributes ? { attributes } : {}),\n      };\n      session.setAttribute(\n        this.ATTR_OAUTH2_AUTHORIZATION_REQUEST,\n        JSON.stringify(authorizationRequest)\n      );\n      await this.repository.save(session);\n      mark('save_session');\n\n      const response = new Response(null, { status: 302, headers: { location: uri.href } });\n      setTiming(response);\n      return this.withSession(response, session);\n    });\n\n  loginOAuth2Code = async (request: Request, handler: AuthorizedHandler): Promise<Response> => {\n    invariant(this.oauth2Client, 'oauth2Client is not initialized');\n    const { mark, setTiming } = timing({ enabled: this.timing });\n\n    // 1. the session the flow started on, and the authorization request it stored\n    const session = await this.loadSession(request);\n    if (!session) return this.redirect('invalid_request', 'session not found');\n    mark('load_session');\n    const json = session.getAttribute(this.ATTR_OAUTH2_AUTHORIZATION_REQUEST) as string | null;\n    if (!json) return this.redirect('invalid_request', 'authorization request not found');\n    const cached: OAuth2AuthorizationRequest = JSON.parse(json);\n\n    // 2. the provider's answer: query, or a form for Apple's response_mode=form_post\n    const { provider } = param(request, PATH.LOGIN_OAUTH2_CODE);\n    const data = isFormPost(request)\n      ? Object.fromEntries(new URLSearchParams(await request.text()))\n      : query(request);\n    const parsed = oauth2RedirectQuerySchema.safeParse(data);\n    if (!parsed.success) return this.redirect('invalid_request', 'invalid redirect query');\n    // The provider answered with an error instead of a code (the user pressed Cancel →\n    // access_denied, invalid_scope, server_error, ...). Forward it rather than reporting a\n    // malformed query. This runs before the state check on purpose: providers echo state on\n    // error responses, but not all reliably do, and a forged error callback can only make the\n    // victim's popup show an error — nothing is exchanged or signed in. A present state that does\n    // not match still wins, since that is the more accurate (and more alarming) diagnosis.\n    if (parsed.data.error) {\n      if (parsed.data.state && parsed.data.state !== cached.state) {\n        return this.redirect('invalid_request', 'redirect state mismatch');\n      }\n      return this.redirect(\n        safeErrorType(parsed.data.error, 'server_error'),\n        parsed.data.error_description\n      );\n    }\n    const { code, state, user } = parsed.data;\n    if (!code || !state) return this.redirect('invalid_request', 'invalid redirect query');\n    if (state !== cached.state) return this.redirect('invalid_request', 'redirect state mismatch');\n    if (provider !== cached.provider) {\n      return this.redirect('invalid_request', 'redirect provider mismatch');\n    }\n    mark('validate_session');\n\n    // 3. exchange the code, load the user, sign in. Everything here can fail (an expired or reused\n    // code, a network error, the host's handler or session store). The callback runs in a popup\n    // the user is looking at, so every failure must land on errorUri, never as a JSON error.\n    let signedIn: Session;\n    try {\n      const { clientId, token } = await this.oauth2Client.exchangeAuthorizationCode({\n        provider,\n        code,\n        pkce: cached.additionalParameters,\n      });\n      // Apple posts the user's name alongside the code, once: hand it to the provider with the token.\n      const userInfo = await this.oauth2Client.getUserInfo({\n        provider,\n        clientId,\n        token,\n        response: user ? { user } : undefined,\n      });\n      mark('exchange_code');\n\n      const principal = await handler(request, {\n        provider,\n        clientId,\n        userInfo,\n        token,\n        attributes: cached.attributes ?? {},\n      });\n      mark('save_principal');\n\n      signedIn = await this.signIn(principal, session);\n      await this.repository.deleteById(session.getId());\n      mark('update_session');\n    } catch (error) {\n      // The details stay in the logs: an OAuth2Error message can carry a client id or a\n      // provider's response, which has no place in a URL the browser keeps in its history.\n      if (error instanceof OAuth2Error) {\n        console.warn('OAuth2 callback failed', error);\n        const type = CALLBACK_ERROR_TYPES.has(error.error) ? error.error : 'server_error';\n        return this.redirect(type);\n      }\n      // A refusal is something the user can act on, so its reason and metadata reach the page,\n      // as they reach a JSON client through the ErrorInfo.\n      if (error instanceof AuthenticationError) {\n        console.warn('OAuth2 sign-in refused', error.reason, error.metadata);\n        return this.redirect('access_denied', undefined, error);\n      }\n      console.error('OAuth2 callback failed', error);\n      return this.redirect('server_error');\n    }\n\n    const uri = new URL(this.oauth2Client.successUri);\n    uri.searchParams.set('status', 'success');\n    uri.searchParams.set('provider', provider);\n    const response = new Response(null, { status: 302, headers: { location: uri.href } });\n    setTiming(response);\n    return this.withSession(response, signedIn);\n  };\n\n  /** The shared tail of the JSON login routes: the host's handler, then a signed-in session. */\n  private async authorize(\n    request: Request,\n    handler: AuthorizedHandler,\n    authorization: Authorization,\n    setTiming: (response: Response) => void\n  ): Promise<Response> {\n    const principal = await handler(request, authorization);\n    const session = await this.signIn(principal);\n    const response = Response.json(principal);\n    setTiming(response);\n    return this.withSession(response, session);\n  }\n\n  loginOAuth2Native = (request: Request, handler: AuthorizedHandler): Promise<Response> =>\n    this.guard(async () => {\n      invariant(this.oauth2Client, 'oauth2Client is not initialized');\n      const { mark, setTiming } = timing({ enabled: this.timing });\n      const { provider } = param(request, PATH.LOGIN_OAUTH2_NATIVE);\n      const body = await readJson(request);\n      // Whatever the app sends besides its credentials for `onAuthorized` (a referral code, ...).\n      const attributes = bodyAttributes(body);\n      // Only the credentials go on to the provider client.\n      const { attributes: _, ...credentials } = body as NativeCredential & { attributes?: unknown };\n      const { code_verifier } = credentials as { code_verifier?: unknown };\n      if (\n        code_verifier !== undefined &&\n        (typeof code_verifier !== 'string' || !CODE_VERIFIER_FORMAT.test(code_verifier))\n      ) {\n        throw invalidArgument(\n          'INVALID_CODE_VERIFIER',\n          'code_verifier must be 43-128 characters from [A-Za-z0-9-._~]'\n        );\n      }\n      const { clientId, userInfo, token } = await this.oauth2Client.loginOAuth2Native({\n        provider,\n        credentials,\n      });\n      mark('login_oauth2_native');\n\n      const { nonce } = userInfo.data as { nonce?: unknown };\n      if (typeof nonce === 'string' && nonce) {\n        await this.consumeNonce(nonce, provider);\n        mark('check_nonce');\n      }\n\n      return this.authorize(\n        request,\n        handler,\n        { provider, clientId, userInfo, token, attributes },\n        setTiming\n      );\n    });\n\n  loginOAuth2Onetap = (\n    request: Request,\n    handler: AuthorizedHandler,\n    provider = 'google'\n  ): Promise<Response> =>\n    this.guard(async () => {\n      invariant(this.oauth2Client, 'oauth2Client is not initialized');\n      const { mark, setTiming } = timing({ enabled: this.timing });\n\n      // Google's own form post, or an app's JSON.\n      const contentType = request.headers.get('content-type') ?? '';\n      const body = contentType.includes('application/json')\n        ? await readJson(request)\n        : await readForm(request);\n      const { attributes = {}, ...parsed } = parse(oneTapBodySchema, body);\n\n      // Both the credential and the code are issued to the provider's web client.\n      let clientId: string;\n      let token: Authorization['token'];\n      let userInfo: Authorization['userInfo'];\n      if (parsed.credential) {\n        ({ clientId, token, userInfo } = await this.oauth2Client.getTokenInfo({\n          provider,\n          credential: parsed.credential,\n        }));\n        mark('verify_credential');\n\n        // A credential is replayable until it expires, so it must carry a single-use nonce from\n        // `oauth2Nonce`, which the front end passed to `prompt`. This replaces Google's\n        // `g_csrf_token` double-submit cookie, which FedCM mode no longer sets.\n        const { nonce } = userInfo.data as { nonce?: unknown };\n        if (typeof nonce === 'string' && nonce) {\n          await this.consumeNonce(nonce, provider);\n          mark('check_nonce');\n        } else if (this.onetapRequireNonce) {\n          throw new AuthenticationError('NONCE_MISSING');\n        }\n      } else if (parsed.code) {\n        ({ clientId, token } = await this.oauth2Client.exchangeAuthorizationCode({\n          provider,\n          code: parsed.code,\n        }));\n        userInfo = await this.oauth2Client.getUserInfo({ provider, clientId, token });\n      } else {\n        throw invalidArgument('INVALID_ARGUMENT', 'credential or code is required');\n      }\n\n      return this.authorize(\n        request,\n        handler,\n        { provider, clientId, userInfo, token, attributes },\n        setTiming\n      );\n    });\n\n  // ---- email -----------------------------------------------------------------------------------\n\n  sendEmailVerificationCode = (request: Request, sender: EmailSender): Promise<Response> =>\n    this.guard(async () => {\n      invariant(this.turnstileSecretKey, 'turnstileSecretKey is not configured');\n      const { email, turnstileToken } = parse(\n        sendEmailVerificationCodeSchema,\n        await readJson(request)\n      );\n      await verifyTurnstileToken(this.turnstileSecretKey, turnstileToken);\n      await this.emailCodes.send(email, sender);\n      return Response.json({});\n    });\n\n  verifyEmailCode = (email: string, verificationCode: string): Promise<void> =>\n    this.emailCodes.verify(email, verificationCode);\n\n  loginEmail = (request: Request, handler: AuthorizedHandler): Promise<Response> =>\n    this.guard(async () => {\n      const { setTiming } = timing({ enabled: this.timing });\n      const {\n        email,\n        verificationCode,\n        attributes = {},\n      } = parse(loginEmailSchema, await readJson(request));\n      await this.emailCodes.verify(email, verificationCode);\n      const claims: StandardClaims = { sub: email, email, email_verified: true };\n      return this.authorize(\n        request,\n        handler,\n        { provider: 'EMAIL', userInfo: { claims, data: {} }, attributes },\n        setTiming\n      );\n    });\n\n  // ---- desktop ---------------------------------------------------------------------------------\n\n  /**\n   * Step 1 of the desktop / native app sign-in handshake. The caller already completed normal\n   * sign-in on the web (so a cookie session exists); this issues a 5-minute single-use code that\n   * the web page hands off to the desktop client via a loopback redirect.\n   *\n   * PKCE (RFC 7636, S256 only): the desktop generates a random `code_verifier` before opening the\n   * browser, derives `code_challenge = base64url(sha256(verifier))`, and threads the challenge\n   * through the URL → web page → here. The challenge is pinned to the code; `desktopExchange`\n   * enforces that the caller knows the matching verifier. This blocks an attacker who only\n   * intercepts the auth code (browser history, malicious extension, packet capture on loopback)\n   * from exchanging it.\n   *\n   * Requires an authenticated cookie session: anonymous callers get 401. Throttling / abuse\n   * protection on this endpoint is the API layer's job (rate-limit per principal); the SDK does\n   * not gate it because the upstream sign-in flow already passed CAPTCHA / OAuth / verification.\n   */\n  desktopAuthorize = (request: Request): Promise<Response> =>\n    this.guard(async () => {\n      const principal = await this.getPrincipal(request);\n      if (!principal) throw unauthenticated('Sign in first');\n      const { code_challenge } = parse(desktopAuthorizeSchema, await readJson(request));\n      const code = await this.desktopCodes.issue(principal, code_challenge);\n      return Response.json({ code });\n    });\n\n  /**\n   * Step 2 of the desktop / native app sign-in handshake. The desktop client hands back the auth\n   * code it received via the loopback callback, and we mint a fresh session for it, independent\n   * of the web cookie session that originally authorized the code, so logging out on either side\n   * does not cascade to the other.\n   *\n   * Cookie attributes: `SameSite=None; Secure` so the cookie survives cross-site fetches from the\n   * desktop renderer's `file://` / `app://` origin. The configured `cookieOptions` provide\n   * everything else (`domain`, `path`, `httpOnly`); the override is targeted at the\n   * SameSite/Secure pair only. In a non-HTTPS dev backend this combination is rejected by\n   * Chromium, see the desktop sign-in PRD for workarounds.\n   *\n   * No CSRF check needed: the request carries no cookie, the auth code itself is the credential,\n   * and the code's single-use removal blocks replay.\n   */\n  desktopExchange = (request: Request): Promise<Response> =>\n    this.guard(async () => {\n      const { code, code_verifier } = parse(desktopExchangeSchema, await readJson(request));\n      const principal = await this.desktopCodes.redeem(code, code_verifier);\n      const session = await this.signIn(principal);\n      session.setAttribute('client_type', 'desktop');\n      await this.repository.save(session);\n      return this.withSession(Response.json({ ok: true }), session, {\n        sameSite: 'none',\n        secure: true,\n      });\n    });\n\n  // ---- session management ----------------------------------------------------------------------\n\n  kick = async (principal: Principal): Promise<void> => {\n    const sessions = await this.repository.findByPrincipalName(principal.name);\n    for (const sessionId of sessions.keys()) {\n      await this.repository.deleteById(sessionId);\n    }\n  };\n\n  /**\n   * Sliding expiration: an authenticated request renews the session, as `logged` does, so a user\n   * who keeps using the app is never signed out after `maxInactiveInterval` of not calling one\n   * particular endpoint. No extra read: the session was just loaded to authenticate, and its\n   * `lastAccessedTime` is compared in memory; writes are spaced by `session.touchInterval` (see\n   * `AuthConfig`), so a session accessed again within the interval is not rewritten.\n   */\n  private async touch(session: Session) {\n    const now = Date.now();\n    if (now - session.getLastAccessedTime() < this.touchInterval) return;\n    session.setLastAccessedTime(now);\n    await this.repository.save(session);\n  }\n\n  getPrincipal = async (request: Request): Promise<Principal | null> => {\n    const session = await this.loadSession(request);\n    const principal = session && this.principalOf(session);\n    if (!principal) return null;\n    await this.touch(session);\n    return principal;\n  };\n\n  isAuthenticated = async (request: Request): Promise<boolean> => {\n    return (await this.getPrincipal(request)) !== null;\n  };\n\n  getSession = async <T extends boolean>(\n    request: Request,\n    create: T\n  ): Promise<T extends true ? Session : Session | null> => {\n    type Result = T extends true ? Session : Session | null;\n    const session = await this.loadSession(request);\n    if (session || !create) return session as Result;\n    const created = this.repository.createSession();\n    await this.repository.save(created);\n    return created;\n  };\n\n  deleteSession = async (sessionId: string): Promise<void> => {\n    await this.repository.deleteById(sessionId);\n  };\n\n  listSessions = async (principal: Principal): Promise<Session[]> => {\n    const sessions = await this.repository.findByPrincipalName(principal.name);\n    return Array.from(sessions.values());\n  };\n\n  cleanupExpiredSessions = async (cleanupCount?: number): Promise<Response> => {\n    await this.repository.cleanupExpiredSessions(cleanupCount);\n    return Response.json({});\n  };\n}\n"],"mappings":"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"}

package/dist/auth/index.d.cts

@@ -1,7 +1,7 @@
 import { Principal } from "../core/index.cjs";
 import { Session } from "../session/types.cjs";
+import { EmailSender } from "./email-codes.cjs";
 import { AuthConfig, AuthService, AuthorizedHandler, LoggedHandler, OAuth2AuthorizationOptions } from "./types.cjs";
-//#region src/auth/index.d.ts
 export declare const PATH: {
   readonly CSRF: '/csrf';
   readonly LOGOUT: '/logout';
@@ -13,13 +13,18 @@ export declare const PATH: {
   readonly LOGIN_OAUTH2_NATIVE: '/login/oauth2/native/:provider';
   readonly LOGIN_OAUTH2_ONETAP: '/login/oauth2/onetap/google';
   readonly LOGIN_EMAIL: '/login/email';
-  readonly LOGIN_PHONE: '/login/phone';
   readonly SEND_EMAIL_VERIFICATION_CODE: '/auth/sendEmailVerificationCode';
-  readonly SEND_PHONE_VERIFICATION_CODE: '/auth/sendPhoneVerificationCode';
   readonly DESKTOP_AUTHORIZE: '/auth/desktop/authorize';
   readonly DESKTOP_EXCHANGE: '/auth/desktop/exchange';
   readonly CLEANUP_EXPIRED_SESSIONS: '/sessions/expired/cleanup';
 };
+/**
+ * The login routes and session helpers. Every route is one straight line: read and validate the
+ * request, check the credential, call the host's `onAuthorized`, sign in. Failures are thrown and
+ * answered in one place per kind of route: a JSON route runs under `guard`, which maps a
+ * `RequestError`, an `AuthenticationError` or an `OAuth2Error` to its google.rpc body (see
+ * `respond.ts`); the redirect callback maps the same errors to `errorUri` parameters (`redirect`).
+ */
 export declare class Auth implements AuthService {
   private readonly timing;
   private readonly cookieName;
@@ -27,87 +32,92 @@ export declare class Auth implements AuthService {
   private readonly kv;
   private readonly repository;
   private readonly turnstileSecretKey?;
-  private readonly maxVerificationAttempts;
-  private readonly verificationResendCooldown;
+  private readonly emailCodes;
+  private readonly desktopCodes;
   private readonly oauth2Client;
   private readonly onetapRequireNonce;
   private readonly touchInterval;
+  private readonly sessionHeader;
   private readonly ATTR_OAUTH2_AUTHORIZATION_REQUEST;
   constructor({ sessionRepository, kvRepository, turnstileSecretKey, verificationCode, oauth2, cookie, session, timing }: AuthConfig);
   private getSessionId;
+  /** The session the request carries, if it exists. */
+  private loadSession;
+  /** The signed-in principal of a session, if any. */
+  private principalOf;
+  /**
+   * A new session signed in as `principal`. With `carryOver`, what the host kept in the pre-login
+   * session moves to the new one; the authorization request (state, PKCE verifier, flow
+   * attributes) is single-use and was consumed, and a principal left there from an earlier
+   * sign-in is replaced. The new id is never the one the browser brought, which may have been
+   * planted by an attacker who started the flow (session fixation).
+   */
+  private signIn;
+  /**
+   * `response` carrying `session`: its cookie, renewed for the whole inactive interval, and with
+   * `session.header` on, the `X-Auth-Token` header a client without a cookie jar reads.
+   */
+  private withSession;
+  /** Runs a JSON route: a failure it knows is its response, anything else is the host's. */
+  private guard;
+  /** The error redirect of the callback flow; `refusal`'s reason and metadata ride along. */
+  private redirect;
   csrf: (_request: Request) => Promise<Response>;
   logout: (request: Request) => Promise<Response>;
   logged: (request: Request, onLogged?: LoggedHandler) => Promise<Response>;
   private createPkceParameters;
   private getOauth2StateKey;
   private getOauth2NonceKey;
-  private getEmailVerificationCodeKey;
-  private getEmailVerificationAttemptsKey;
-  private getEmailVerificationCooldownKey;
-  private getPhoneVerificationCodeKey;
-  private getDesktopCodeKey;
+  /**
+   * Spends a nonce `oauth2Nonce` issued for `provider`: `NONCE_MISMATCH` for one that was not,
+   * or was used already. An id token is replayable until it expires; the nonce it carries makes
+   * it sign in once.
+   */
+  private consumeNonce;
   oauth2State: (request: Request) => Promise<Response>;
   oauth2Nonce: (request: Request) => Promise<Response>;
   oauth2Authorization: (request: Request, options?: OAuth2AuthorizationOptions) => Promise<Response>;
-  private readonly redirect;
   loginOAuth2Code: (request: Request, handler: AuthorizedHandler) => Promise<Response>;
-  /**
-   * A fresh session for `name`, carrying over what the host kept in the pre-login one. The
-   * authorization request (state, PKCE verifier, flow attributes) is single-use and was consumed
-   * by this callback, and a principal left there from an earlier sign-in is replaced.
-   */
-  private signedInSession;
+  /** The shared tail of the JSON login routes: the host's handler, then a signed-in session. */
+  private authorize;
   loginOAuth2Native: (request: Request, handler: AuthorizedHandler) => Promise<Response>;
   loginOAuth2Onetap: (request: Request, handler: AuthorizedHandler, provider?: string) => Promise<Response>;
-  sendEmailVerificationCode: (request: Request, sender: (data: {
-    email: string;
-    verificationCode: string;
-  }) => Promise<void>) => Promise<Response>;
+  sendEmailVerificationCode: (request: Request, sender: EmailSender) => Promise<Response>;
+  verifyEmailCode: (email: string, verificationCode: string) => Promise<void>;
   loginEmail: (request: Request, handler: AuthorizedHandler) => Promise<Response>;
   /**
-   * Step 1 of the desktop / native app sign-in handshake. The caller already
-   * completed normal sign-in on the web (so a cookie session exists); this
-   * issues a 5-minute single-use code that the web page hands off to the
-   * desktop client via a loopback redirect.
+   * Step 1 of the desktop / native app sign-in handshake. The caller already completed normal
+   * sign-in on the web (so a cookie session exists); this issues a 5-minute single-use code that
+   * the web page hands off to the desktop client via a loopback redirect.
    *
-   * PKCE (RFC 7636, S256 only): the desktop generates a random `code_verifier`
-   * before opening the browser, derives `code_challenge = base64url(sha256(verifier))`,
-   * and threads the challenge through the URL → web page → here. We pin
-   * the challenge to the code in KV; `desktopExchange` enforces that the
-   * caller knows the matching verifier. This blocks an attacker who only
-   * intercepts the auth code (browser history, malicious extension, packet
-   * capture on loopback) from exchanging it.
+   * PKCE (RFC 7636, S256 only): the desktop generates a random `code_verifier` before opening the
+   * browser, derives `code_challenge = base64url(sha256(verifier))`, and threads the challenge
+   * through the URL → web page → here. The challenge is pinned to the code; `desktopExchange`
+   * enforces that the caller knows the matching verifier. This blocks an attacker who only
+   * intercepts the auth code (browser history, malicious extension, packet capture on loopback)
+   * from exchanging it.
    *
-   * Requires an authenticated cookie session — anonymous callers get 401.
-   * Throttling / abuse protection on this endpoint is the API layer's job
-   * (rate-limit per principal); the SDK doesn't gate it because the
-   * upstream sign-in flow already passed CAPTCHA / OAuth / verification.
+   * Requires an authenticated cookie session: anonymous callers get 401. Throttling / abuse
+   * protection on this endpoint is the API layer's job (rate-limit per principal); the SDK does
+   * not gate it because the upstream sign-in flow already passed CAPTCHA / OAuth / verification.
    */
   desktopAuthorize: (request: Request) => Promise<Response>;
   /**
-   * Step 2 of the desktop / native app sign-in handshake. The desktop
-   * client hands back the auth code it received via the loopback callback,
-   * and we mint a fresh session for it — independent of the web cookie
-   * session that originally `authorize`'d the code, so logging out on
-   * either side doesn't cascade to the other.
+   * Step 2 of the desktop / native app sign-in handshake. The desktop client hands back the auth
+   * code it received via the loopback callback, and we mint a fresh session for it, independent
+   * of the web cookie session that originally authorized the code, so logging out on either side
+   * does not cascade to the other.
    *
-   * Cookie attributes: defaults to `SameSite=None; Secure` so the cookie
-   * survives cross-site fetches from the desktop renderer's `file://` /
-   * `app://` origin. The configured base `cookieOptions` provide
-   * everything else (`domain`, `path`, `httpOnly`, `maxAge`); the override
-   * is targeted at the SameSite/Secure pair only. In a non-HTTPS dev
-   * backend this combination is rejected by Chromium — see the desktop
-   * sign-in PRD for workarounds.
+   * Cookie attributes: `SameSite=None; Secure` so the cookie survives cross-site fetches from the
+   * desktop renderer's `file://` / `app://` origin. The configured `cookieOptions` provide
+   * everything else (`domain`, `path`, `httpOnly`); the override is targeted at the
+   * SameSite/Secure pair only. In a non-HTTPS dev backend this combination is rejected by
+   * Chromium, see the desktop sign-in PRD for workarounds.
    *
-   * No CSRF check needed — the request carries no cookie, the auth code
-   * itself is the credential, and KV's single-use removal blocks replay.
+   * No CSRF check needed: the request carries no cookie, the auth code itself is the credential,
+   * and the code's single-use removal blocks replay.
    */
   desktopExchange: (request: Request) => Promise<Response>;
-  sendPhoneVerificationCode: (_request: Request, _sender: (data: {
-    phone: string;
-    verificationCode: string;
-  }) => Promise<void>) => Promise<Response>;
-  loginPhone: (_request: Request, _handler: AuthorizedHandler) => Promise<Response>;
   kick: (principal: Principal) => Promise<void>;
   /**
    * Sliding expiration: an authenticated request renews the session, as `logged` does, so a user
@@ -117,12 +127,11 @@ export declare class Auth implements AuthService {
    * `AuthConfig`), so a session accessed again within the interval is not rewritten.
    */
   private touch;
+  getPrincipal: (request: Request) => Promise<Principal | null>;
   isAuthenticated: (request: Request) => Promise<boolean>;
   getSession: <T extends boolean>(request: Request, create: T) => Promise<T extends true ? Session : Session | null>;
   deleteSession: (sessionId: string) => Promise<void>;
-  getPrincipal: (request: Request) => Promise<Principal | null>;
   listSessions: (principal: Principal) => Promise<Session[]>;
   cleanupExpiredSessions: (cleanupCount?: number) => Promise<Response>;
 }
-//#endregion
 //# sourceMappingURL=index.d.cts.map

package/dist/auth/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/auth/index.ts"],"mappings":";;;;qBA4Ga;WACX;WACA;WACA;WAEA;WACA;WACA;WACA;WACA;WACA;WAEA;WACA;WACA;WACA;WASA;WACA;WAEA;;qBAMW,gBAAgB;mBACV;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;EAEjB,cACE,mBACA,cACA,oBACA,kBACA,QACA,QACA,SACA,UACC;UA2BK;EAYR,OAAI,UAAoB,YAAU,QAAQ;EAmB1C,SAAM,SAAmB,YAAU,QAAQ;EAU3C,SAAM,SAAmB,SAAO,WAAa,kBAAgB,QAAQ;UAsB7D;UAUA;UAIA;UAIA;UAIA;UAIA;UAIA;UAIA;EAIR,cAAW,SAAmB,YAAU,QAAQ;EAOhD,cAAW,SAAmB,YAAU,QAAQ;EAOhD,sBAAmB,SACR,SAAO,UACN,+BACT,QAAQ;mBAmCM;EAUjB,kBAAe,SAAmB,SAAO,SAAW,sBAAoB,QAAQ;;;;;;UA+HxE;EAYR,oBAAiB,SAAmB,SAAO,SAAW,sBAAoB,QAAQ;EAmDlF,oBAAiB,SACN,SAAO,SACP,mBAAiB,sBAEzB,QAAQ;EA6EX,4BAAyB,SACd,SAAO,SACP;IAAQ;IAAe;QAA+B,kBAC9D,QAAQ;EA0CX,aAAU,SAAmB,SAAO,SAAW,sBAAoB,QAAQ;;;;;;;;;;;;;;;;;;;;EAsE3E,mBAAgB,SAAmB,YAAU,QAAQ;;;;;;;;;;;;;;;;;;;EA0DrD,kBAAe,SAAmB,YAAU,QAAQ;EAgEpD,4BAAyB,UACb,SAAO,UACP;IAAQ;IAAe;QAA+B,kBAC/D,QAAQ;EAIX,aAAU,UAAoB,SAAO,UAAY,sBAAoB,QAAQ;EAI7E,OAAI,WAAqB,cAAY;;;;;;;;UAcvB;EAOd,kBAAe,SAAmB,YAAU;EAW5C,aAAoB,mBAAiB,SAC1B,SAAO,QACR,MACP,QAAQ,iBAAiB,UAAU;EAwBtC,gBAAa,sBAA8B;EAI3C,eAAY,SAAmB,YAAU,QAAQ;EAWjD,eAAY,WAAqB,cAAY,QAAQ;EAKrD,yBAAsB,0BAAkC,QAAQ"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/auth/index.ts"],"mappings":";;;;qBAyHa;WACX;WACA;WACA;WAEA;WACA;WACA;WACA;WACA;WACA;WAEA;WACA;WASA;WACA;WAEA;;;;;;;;;qBAUW,gBAAgB;mBACV;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;mBACA;EAEjB,cACE,mBACA,cACA,oBACA,kBACA,QACA,QACA,SACA,UACC;UA6BK;;UAOM;;UAMN;;;;;;;;UAYM;;;;;UAiBN;;UAYM;;UAWN;EAqBR,OAAI,UAAoB,YAAU,QAAQ;EAmB1C,SAAM,SAAmB,YAAU,QAAQ;EAU3C,SAAM,SAAmB,SAAO,WAAa,kBAAgB,QAAQ;UAc7D;UAUA;UAIA;;;;;;UASM;EAMd,cAAW,SAAmB,YAAU,QAAQ;EAOhD,cAAW,SAAmB,YAAU,QAAQ;EAOhD,sBAAmB,SACR,SAAO,UACN,+BACT,QAAQ;EA+BX,kBAAe,SAAmB,SAAO,SAAW,sBAAoB,QAAQ;;UAoGlE;EAad,oBAAiB,SAAa,SAAO,SAAW,sBAAoB,QAAQ;EAwC5E,oBAAiB,SACN,SAAO,SACP,mBAAiB,sBAEzB,QAAQ;EAqDX,4BAAyB,SAAa,SAAO,QAAU,gBAAc,QAAQ;EAY7E,kBAAe,eAAiB,6BAA6B;EAG7D,aAAU,SAAa,SAAO,SAAW,sBAAoB,QAAQ;;;;;;;;;;;;;;;;;EAoCrE,mBAAgB,SAAa,YAAU,QAAQ;;;;;;;;;;;;;;;;EAwB/C,kBAAe,SAAa,YAAU,QAAQ;EAe9C,OAAI,WAAqB,cAAY;;;;;;;;UAcvB;EAOd,eAAY,SAAmB,YAAU,QAAQ;EAQjD,kBAAe,SAAmB,YAAU;EAI5C,aAAoB,mBAAiB,SAC1B,SAAO,QACR,MACP,QAAQ,iBAAiB,UAAU;EAStC,gBAAa,sBAA8B;EAI3C,eAAY,WAAqB,cAAY,QAAQ;EAKrD,yBAAsB,0BAAkC,QAAQ"}