@shware/security 2.5.3 → 2.6.0

package/dist/auth/index.cjs

@@ -1,565 +1,524 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/auth/index.ts
-var auth_exports = {};
-__export(auth_exports, {
-  Auth: () => Auth,
-  PATH: () => PATH
-});
-module.exports = __toCommonJS(auth_exports);
-var import_node_crypto = require("crypto");
-var import_utils = require("@shware/utils");
-var import_core = require("../core/index.cjs");
-var import_schema = require("../email/schema.cjs");
-var import_client = require("../oauth2/client.cjs");
-var import_provider = require("../oauth2/provider/index.cjs");
-var import_common = require("../session/common.cjs");
-var import_http = require("../utils/http.cjs");
-var import_timing = require("../utils/timing.cjs");
-var import_valid = require("../utils/valid.cjs");
-var PKCE_FORMAT = /^[A-Za-z0-9_-]{43,128}$/;
-var PATH = {
-  CSRF: "/csrf",
-  LOGOUT: "/logout",
-  LOGGED: "/logged",
-  OAUTH2_STATE: "/oauth2/state/:registrationId",
-  OAUTH2_NONCE: "/oauth2/nonce/:registrationId",
-  OAUTH2_AUTHORIZATION: "/oauth2/authorization/:registrationId",
-  LOGIN_OAUTH2_CODE: "/login/oauth2/code/:registrationId",
-  LOGIN_OAUTH2_NATIVE: "/login/oauth2/native/:registrationId",
-  LOGIN_OAUTH2_ONETAP: "/login/oauth2/onetap/google",
-  LOGIN_EMAIL: "/login/email",
-  LOGIN_PHONE: "/login/phone",
-  SEND_EMAIL_VERIFICATION_CODE: "/auth/sendEmailVerificationCode",
-  SEND_PHONE_VERIFICATION_CODE: "/auth/sendPhoneVerificationCode",
-  // Desktop / native app sign-in via web loopback (RFC 8252 + OAuth 2.1 Auth Code Flow):
-  //   1. user already authenticated with cookie session → POST DESKTOP_AUTHORIZE → { code }
-  //   2. web redirects to desktop's loopback callback with the code
-  //   3. desktop renderer POSTs DESKTOP_EXCHANGE with the code → server returns
-  //      Set-Cookie carrying a fresh session, single-use code is invalidated
-  // The two-step flow keeps the actual session id off the redirect URL — only a
-  // 5-minute single-use code transits via the loopback.
-  DESKTOP_AUTHORIZE: "/auth/desktop/authorize",
-  DESKTOP_EXCHANGE: "/auth/desktop/exchange",
-  CLEANUP_EXPIRED_SESSIONS: "/sessions/expired/cleanup"
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../core/index.cjs");
+const require_email_schema = require("../email/schema.cjs");
+const require_oauth2_client = require("../oauth2/client.cjs");
+const require_oauth2_provider_google = require("../oauth2/provider/google.cjs");
+require("../oauth2/provider/index.cjs");
+const require_session_common = require("../session/common.cjs");
+const require_utils_http = require("../utils/http.cjs");
+const require_utils_timing = require("../utils/timing.cjs");
+const require_utils_valid = require("../utils/valid.cjs");
+let node_crypto = require("node:crypto");
+let _shware_utils = require("@shware/utils");
+//#region src/auth/index.ts
+const PKCE_FORMAT = /^[A-Za-z0-9_-]{43,128}$/;
+const PATH = {
+	CSRF: "/csrf",
+	LOGOUT: "/logout",
+	LOGGED: "/logged",
+	OAUTH2_STATE: "/oauth2/state/:registrationId",
+	OAUTH2_NONCE: "/oauth2/nonce/:registrationId",
+	OAUTH2_AUTHORIZATION: "/oauth2/authorization/:registrationId",
+	LOGIN_OAUTH2_CODE: "/login/oauth2/code/:registrationId",
+	LOGIN_OAUTH2_NATIVE: "/login/oauth2/native/:registrationId",
+	LOGIN_OAUTH2_ONETAP: "/login/oauth2/onetap/google",
+	LOGIN_EMAIL: "/login/email",
+	LOGIN_PHONE: "/login/phone",
+	SEND_EMAIL_VERIFICATION_CODE: "/auth/sendEmailVerificationCode",
+	SEND_PHONE_VERIFICATION_CODE: "/auth/sendPhoneVerificationCode",
+	DESKTOP_AUTHORIZE: "/auth/desktop/authorize",
+	DESKTOP_EXCHANGE: "/auth/desktop/exchange",
+	CLEANUP_EXPIRED_SESSIONS: "/sessions/expired/cleanup"
 };
 var Auth = class {
-  timing;
-  cookieName;
-  cookieOptions;
-  kv;
-  repository;
-  turnstileSecretKey;
-  oauth2Client;
-  ATTR_OAUTH2_AUTHORIZATION_REQUEST = "oauth2AuthorizationRequest";
-  constructor({
-    sessionRepository,
-    kvRepository,
-    turnstileSecretKey,
-    oauth2,
-    cookie,
-    timing: timing2
-  }) {
-    this.timing = timing2 ?? false;
-    this.kv = kvRepository;
-    this.repository = sessionRepository;
-    this.turnstileSecretKey = turnstileSecretKey;
-    const { name, ...cookieOptions } = cookie ?? {};
-    this.cookieName = name ?? "SESSION";
-    this.cookieOptions = {
-      path: "/",
-      sameSite: "none",
-      secure: true,
-      httpOnly: true,
-      ...cookieOptions
-    };
-    this.oauth2Client = oauth2?.client ? new import_client.OAuth2Client(oauth2.client) : null;
-  }
-  getSessionId(request) {
-    let sessionId;
-    const header = request.headers.get("Authorization");
-    if (header?.startsWith("Bearer ")) {
-      sessionId = header.replace("Bearer ", "");
-    }
-    if (!sessionId) {
-      sessionId = (0, import_http.getCookie)(request, this.cookieName);
-    }
-    return sessionId;
-  }
-  csrf = async (_request) => {
-    const token = (0, import_node_crypto.randomUUID)();
-    const response = Response.json({
-      token,
-      parameterName: "_csrf",
-      headerName: "X-XSRF-TOKEN"
-    });
-    (0, import_http.setCookie)(response, "XSRF-TOKEN", token, {
-      path: "/",
-      secure: true,
-      httpOnly: false,
-      sameSite: "none",
-      domain: this.cookieOptions.domain
-    });
-    return response;
-  };
-  logout = async (request) => {
-    const sessionId = this.getSessionId(request);
-    if (sessionId) await this.repository.deleteById(sessionId);
-    const response = Response.json({});
-    (0, import_http.deleteCookie)(response, this.cookieName);
-    return response;
-  };
-  logged = async (request, onLogged) => {
-    const sessionId = this.getSessionId(request);
-    if (!sessionId) return Response.json({ data: false });
-    const session = await this.repository.findById(sessionId);
-    if (!session) return Response.json({ data: false });
-    const name = session.getAttribute(import_common.PRINCIPAL_NAME_INDEX_NAME);
-    session.setLastAccessedTime(Date.now());
-    await this.repository.save(session);
-    if (name !== null) await onLogged?.({ name: String(name) });
-    const response = Response.json({ data: name !== null });
-    const maxAge = session.getMaxInactiveInterval();
-    (0, import_http.setCookie)(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });
-    return response;
-  };
-  createPkceParameters() {
-    const code_verifier = (0, import_node_crypto.randomUUID)();
-    const code_challenge = (0, import_node_crypto.createHash)("sha256").update(code_verifier).digest().toString("base64url");
-    return { code_verifier, code_challenge, code_challenge_method: "S256" };
-  }
-  getOauth2StateKey(state) {
-    return `oauth2:state:${state}`;
-  }
-  getOauth2NonceKey(nonce) {
-    return `oauth2:nonce:${nonce}`;
-  }
-  getEmailVerificationCodeKey(email) {
-    return `email:verification:${email}`;
-  }
-  getPhoneVerificationCodeKey(phone) {
-    return `phone:verification:${phone}`;
-  }
-  getDesktopCodeKey(code) {
-    return `desktop:code:${code}`;
-  }
-  oauth2State = async (request) => {
-    const { registrationId } = (0, import_http.param)(request, PATH.OAUTH2_STATE);
-    const state = (0, import_node_crypto.randomUUID)();
-    await this.kv.setItem(this.getOauth2StateKey(state), registrationId, 10 * 60);
-    return Response.json({ state });
-  };
-  oauth2Nonce = async (request) => {
-    const { registrationId } = (0, import_http.param)(request, PATH.OAUTH2_NONCE);
-    const nonce = (0, import_node_crypto.randomUUID)();
-    await this.kv.setItem(this.getOauth2NonceKey(nonce), registrationId, 10 * 60);
-    return Response.json({ nonce });
-  };
-  oauth2Authorization = async (request) => {
-    (0, import_utils.invariant)(this.oauth2Client, "oauth2Client is not initialized");
-    const { mark, setTiming } = (0, import_timing.timing)({ enabled: this.timing });
-    const { registrationId } = (0, import_http.param)(request, PATH.OAUTH2_AUTHORIZATION);
-    const state = (0, import_node_crypto.randomUUID)();
-    const pkce = this.createPkceParameters();
-    const uri = await this.oauth2Client.createAuthorizationUri({ registrationId, state, pkce });
-    const sessionId = this.getSessionId(request);
-    const session = sessionId ? await this.repository.findById(sessionId) ?? this.repository.createSession() : this.repository.createSession();
-    mark("fetch_session");
-    const authorizationRequest = {
-      state,
-      registrationId,
-      authorizationRequestUri: uri.href,
-      additionalParameters: pkce
-    };
-    const value = JSON.stringify(authorizationRequest);
-    session.setAttribute(this.ATTR_OAUTH2_AUTHORIZATION_REQUEST, value);
-    await this.repository.save(session);
-    mark("save_session");
-    const response = new Response(null, { status: 302, headers: { location: uri.href } });
-    const maxAge = session.getMaxInactiveInterval();
-    (0, import_http.setCookie)(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });
-    setTiming(response);
-    return response;
-  };
-  redirect = (error, description) => {
-    (0, import_utils.invariant)(this.oauth2Client, "oauth2Client is not initialized");
-    const uri = new URL(this.oauth2Client.errorUri);
-    uri.searchParams.set("error", error);
-    if (description) uri.searchParams.set("error_description", description);
-    return Response.redirect(uri.href, 302);
-  };
-  loginOAuth2Code = async (request, handler) => {
-    (0, import_utils.invariant)(this.oauth2Client, "oauth2Client is not initialized");
-    const { mark, setTiming } = (0, import_timing.timing)({ enabled: this.timing });
-    const sessionId = this.getSessionId(request);
-    const session = sessionId ? await this.repository.findById(sessionId) : null;
-    if (!session) {
-      return this.redirect("invalid_request", "session not found");
-    }
-    mark("load_session");
-    const json = session.getAttribute(this.ATTR_OAUTH2_AUTHORIZATION_REQUEST);
-    if (!json) {
-      return this.redirect("invalid_request", "authorization request not found");
-    }
-    const cached = JSON.parse(json);
-    const { registrationId } = (0, import_http.param)(request, PATH.LOGIN_OAUTH2_CODE);
-    let data;
-    if (request.method === "POST" && request.headers.get("content-type")?.toLowerCase() === "application/x-www-form-urlencoded") {
-      const params = new URLSearchParams(await request.text());
-      data = Object.fromEntries(params.entries());
-    } else {
-      data = (0, import_http.query)(request);
-    }
-    const parsed = import_client.oauth2RedirectQuerySchema.safeParse(data);
-    if (!parsed.success) {
-      return this.redirect("invalid_request", "invalid redirect query");
-    }
-    if (!parsed.data.code || !parsed.data.state) {
-      return this.redirect("invalid_request", "invalid redirect query");
-    }
-    if (parsed.data.state !== cached.state) {
-      return this.redirect("invalid_request", "redirect state mismatch");
-    }
-    if (registrationId !== cached.registrationId) {
-      return this.redirect("invalid_request", "redirect registration mismatch");
-    }
-    mark("validate_session");
-    const { code } = parsed.data;
-    const token = await this.oauth2Client.exchangeAuthorizationCode({
-      registrationId,
-      code,
-      pkce: cached.additionalParameters
-    });
-    const userInfo = await this.oauth2Client.getUserInfo({ registrationId, token });
-    mark("exchange_code");
-    const principal = await handler(request, registrationId, userInfo, token);
-    mark("save_principal");
-    session.setLastAccessedTime(Date.now());
-    session.removeAttribute(this.ATTR_OAUTH2_AUTHORIZATION_REQUEST);
-    session.setAttribute(import_common.PRINCIPAL_NAME_INDEX_NAME, principal.name);
-    await this.repository.save(session);
-    mark("update_session");
-    const uri = new URL(this.oauth2Client.successUri);
-    uri.searchParams.set("status", "success");
-    uri.searchParams.set("registrationId", registrationId);
-    const response = new Response(null, { status: 302, headers: { location: uri.href } });
-    const maxAge = session.getMaxInactiveInterval();
-    (0, import_http.setCookie)(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });
-    setTiming(response);
-    return response;
-  };
-  loginOAuth2Native = async (request, handler) => {
-    (0, import_utils.invariant)(this.oauth2Client, "oauth2Client is not initialized");
-    const { mark, setTiming } = (0, import_timing.timing)({ enabled: this.timing });
-    const { registrationId } = (0, import_http.param)(request, PATH.LOGIN_OAUTH2_NATIVE);
-    const credentials = await request.json();
-    const { userInfo, token } = await this.oauth2Client.loginOAuth2Native({
-      registrationId,
-      credentials
-    });
-    mark("login_oauth2_native");
-    const { nonce } = userInfo.data;
-    if (nonce) {
-      const value = await this.kv.getItem(this.getOauth2NonceKey(nonce));
-      if (value !== registrationId) {
-        const json = { error: "invalid_request", error_description: "nonce mismatch" };
-        return Response.json(json, { status: 400 });
-      }
-      await this.kv.removeItem(this.getOauth2NonceKey(nonce));
-      mark("check_nonce");
-    }
-    const principal = await handler(request, registrationId, userInfo, token);
-    mark("save_principal");
-    const session = this.repository.createSession();
-    session.setAttribute(import_common.PRINCIPAL_NAME_INDEX_NAME, principal.name);
-    await this.repository.save(session);
-    const response = new Response(JSON.stringify(principal), {
-      status: 200,
-      headers: { "Content-Type": "application/json" }
-    });
-    const maxAge = session.getMaxInactiveInterval();
-    (0, import_http.setCookie)(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });
-    setTiming(response);
-    return response;
-  };
-  loginOAuth2Onetap = async (request, handler, registrationId = "google") => {
-    (0, import_utils.invariant)(this.oauth2Client, "oauth2Client is not initialized");
-    const { mark, setTiming } = (0, import_timing.timing)({ enabled: this.timing });
-    let body;
-    if (request.headers.get("Content-Type")?.includes("application/x-www-form-urlencoded")) {
-      const text = await request.text();
-      body = Object.fromEntries(new URLSearchParams(text));
-    } else if (request.headers.get("Content-Type")?.includes("application/json")) {
-      body = await request.json();
-    } else {
-      const json = { error: "invalid_request", error_description: "invalid content type" };
-      return Response.json(json, { status: 400 });
-    }
-    const parsed = import_client.googleOneTapSchema.parse(body);
-    let principal;
-    if (parsed.credential) {
-      const { token, userInfo } = await import_provider.google.getTokenInfo(parsed.credential);
-      principal = await handler(request, registrationId, userInfo, token);
-    } else if (parsed.code) {
-      const token = await this.oauth2Client.exchangeAuthorizationCode({
-        registrationId,
-        code: parsed.code
-      });
-      const userInfo = await this.oauth2Client.getUserInfo({ registrationId, token });
-      principal = await handler(request, registrationId, userInfo, token);
-    } else {
-      throw new Error("invalid request");
-    }
-    mark("save_principal");
-    const session = this.repository.createSession();
-    session.setAttribute(import_common.PRINCIPAL_NAME_INDEX_NAME, principal.name);
-    await this.repository.save(session);
-    const response = new Response(JSON.stringify(principal), {
-      status: 200,
-      headers: { "Content-Type": "application/json" }
-    });
-    const maxAge = session.getMaxInactiveInterval();
-    (0, import_http.setCookie)(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });
-    setTiming(response);
-    return response;
-  };
-  sendEmailVerificationCode = async (request, sender) => {
-    (0, import_utils.invariant)(this.turnstileSecretKey, "turnstileSecretKey is not configured");
-    const { data, error } = (0, import_valid.valid)(import_schema.sendEmailVerificationCodeSchema, await request.json());
-    if (error) return Response.json(error, { status: error.error.code });
-    const { email, turnstileToken } = data;
-    const result = await (0, import_valid.verifyTurnstileToken)(this.turnstileSecretKey, turnstileToken);
-    if (result.error) return Response.json(result.error, { status: result.error.error.code });
-    try {
-      const verificationCode = (0, import_node_crypto.randomInt)(1e6).toString().padStart(6, "0");
-      await sender({ email, verificationCode });
-      await this.kv.setItem(this.getEmailVerificationCodeKey(email), verificationCode, 10 * 60);
-      return Response.json({});
-    } catch (e) {
-      console.error("Failed to send email verification code", e);
-      return Response.json((0, import_valid.invalidArgument)("EMAIL_DELIVERY_FAILED"), { status: 400 });
-    }
-  };
-  loginEmail = async (request, handler) => {
-    const { data, error } = (0, import_valid.valid)(import_schema.loginEmailSchema, await request.json());
-    if (error) return Response.json(error, { status: error.error.code });
-    const { email, verificationCode } = data;
-    const key = this.getEmailVerificationCodeKey(email);
-    const stored = await this.kv.getItem(key);
-    if (typeof stored !== "string" || stored.length !== verificationCode.length || !(0, import_node_crypto.timingSafeEqual)(Buffer.from(stored), Buffer.from(verificationCode))) {
-      return Response.json((0, import_valid.invalidArgument)("INVALID_VERIFICATION_CODE"), { status: 400 });
-    }
-    await this.kv.removeItem(key);
-    const claims = { sub: email, email, email_verified: true };
-    const principal = await handler(request, import_core.Provider.EMAIL, { claims, data: {} });
-    const session = this.repository.createSession();
-    session.setAttribute(import_common.PRINCIPAL_NAME_INDEX_NAME, principal.name);
-    await this.repository.save(session);
-    const response = new Response(JSON.stringify(principal), {
-      status: 200,
-      headers: { "Content-Type": "application/json" }
-    });
-    const maxAge = session.getMaxInactiveInterval();
-    (0, import_http.setCookie)(response, this.cookieName, session.getId(), { ...this.cookieOptions, maxAge });
-    return 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.
-   *
-   * 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.
-   *
-   * 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.
-   */
-  desktopAuthorize = async (request) => {
-    const principal = await this.getPrincipal(request);
-    if (!principal) {
-      const body2 = {
-        error: {
-          code: 401,
-          status: "UNAUTHENTICATED",
-          message: "sign in first",
-          details: []
-        }
-      };
-      return Response.json(body2, { status: 401 });
-    }
-    let body;
-    try {
-      body = await request.json();
-    } catch {
-      return Response.json((0, import_valid.invalidArgument)("INVALID_ARGUMENT"), { status: 400 });
-    }
-    const codeChallenge = typeof body.code_challenge === "string" ? body.code_challenge : null;
-    if (!codeChallenge || body.code_challenge_method !== "S256" || !PKCE_FORMAT.test(codeChallenge)) {
-      return Response.json((0, import_valid.invalidArgument)("INVALID_ARGUMENT"), { status: 400 });
-    }
-    const code = (0, import_node_crypto.randomUUID)();
-    const record = { name: principal.name, cc: codeChallenge };
-    await this.kv.setItem(this.getDesktopCodeKey(code), JSON.stringify(record), 5 * 60);
-    return Response.json({ code });
-  };
-  /**
-   * 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.
-   *
-   * 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.
-   *
-   * No CSRF check needed — the request carries no cookie, the auth code
-   * itself is the credential, and KV's single-use removal blocks replay.
-   */
-  desktopExchange = async (request) => {
-    let body;
-    try {
-      body = await request.json();
-    } catch {
-      return Response.json((0, import_valid.invalidArgument)("INVALID_ARGUMENT"), { status: 400 });
-    }
-    const code = typeof body.code === "string" ? body.code : null;
-    const verifier = typeof body.code_verifier === "string" ? body.code_verifier : null;
-    if (!code || !verifier || !PKCE_FORMAT.test(verifier)) {
-      return Response.json((0, import_valid.invalidArgument)("INVALID_ARGUMENT"), { status: 400 });
-    }
-    const key = this.getDesktopCodeKey(code);
-    const raw = await this.kv.getItem(key);
-    if (typeof raw !== "string") {
-      return Response.json((0, import_valid.invalidArgument)("INVALID_DESKTOP_CODE"), { status: 400 });
-    }
-    let record;
-    try {
-      record = JSON.parse(raw);
-    } catch {
-      await this.kv.removeItem(key);
-      return Response.json((0, import_valid.invalidArgument)("INVALID_DESKTOP_CODE"), { status: 400 });
-    }
-    const computed = (0, import_node_crypto.createHash)("sha256").update(verifier).digest();
-    const stored = Buffer.from(record.cc, "base64url");
-    if (stored.length !== computed.length || !(0, import_node_crypto.timingSafeEqual)(computed, stored)) {
-      return Response.json((0, import_valid.invalidArgument)("INVALID_DESKTOP_CODE"), { status: 400 });
-    }
-    await this.kv.removeItem(key);
-    const session = this.repository.createSession();
-    session.setAttribute(import_common.PRINCIPAL_NAME_INDEX_NAME, record.name);
-    session.setAttribute("client_type", "desktop");
-    await this.repository.save(session);
-    const response = Response.json({ ok: true });
-    const maxAge = session.getMaxInactiveInterval();
-    (0, import_http.setCookie)(response, this.cookieName, session.getId(), {
-      ...this.cookieOptions,
-      // Override sameSite/secure for desktop: the renderer's origin
-      // (file:// / app://) is cross-site to the API, so SameSite=Lax/Strict
-      // would block the cookie on subsequent fetches.
-      sameSite: "none",
-      secure: true,
-      maxAge
-    });
-    return response;
-  };
-  sendPhoneVerificationCode = async (_request, _sender) => {
-    return Response.json({ error: "not_implemented" }, { status: 501 });
-  };
-  loginPhone = async (_request, _handler) => {
-    return Response.json({ error: "not_implemented" }, { status: 501 });
-  };
-  kick = async (principal) => {
-    const sessions = await this.repository.findByPrincipalName(principal.name);
-    for (const sessionId of sessions.keys()) {
-      await this.repository.deleteById(sessionId);
-    }
-  };
-  isAuthenticated = async (request) => {
-    const sessionId = this.getSessionId(request);
-    if (!sessionId) return false;
-    const session = await this.repository.findById(sessionId);
-    if (!session) return false;
-    const principalName = session.getAttribute(import_common.PRINCIPAL_NAME_INDEX_NAME);
-    if (!principalName) return false;
-    return true;
-  };
-  getSession = async (request, create) => {
-    const sessionId = this.getSessionId(request);
-    if (!sessionId) {
-      if (create) {
-        const session2 = this.repository.createSession();
-        await this.repository.save(session2);
-        return session2;
-      } else {
-        return null;
-      }
-    }
-    const session = await this.repository.findById(sessionId);
-    if (!session) {
-      if (create) {
-        const session2 = this.repository.createSession();
-        await this.repository.save(session2);
-        return session2;
-      } else {
-        return null;
-      }
-    }
-    return session;
-  };
-  deleteSession = async (sessionId) => {
-    await this.repository.deleteById(sessionId);
-  };
-  getPrincipal = async (request) => {
-    const sessionId = this.getSessionId(request);
-    if (!sessionId) return null;
-    const session = await this.repository.findById(sessionId);
-    if (!session) return null;
-    const name = session.getAttribute(import_common.PRINCIPAL_NAME_INDEX_NAME);
-    if (!name) return null;
-    return { name: String(name) };
-  };
-  listSessions = async (principal) => {
-    const sessions = await this.repository.findByPrincipalName(principal.name);
-    return Array.from(sessions.values());
-  };
-  cleanupExpiredSessions = async (cleanupCount) => {
-    await this.repository.cleanupExpiredSessions(cleanupCount);
-    return Response.json({});
-  };
+	timing;
+	cookieName;
+	cookieOptions;
+	kv;
+	repository;
+	turnstileSecretKey;
+	oauth2Client;
+	ATTR_OAUTH2_AUTHORIZATION_REQUEST = "oauth2AuthorizationRequest";
+	constructor({ sessionRepository, kvRepository, turnstileSecretKey, oauth2, cookie, timing }) {
+		this.timing = timing ?? false;
+		this.kv = kvRepository;
+		this.repository = sessionRepository;
+		this.turnstileSecretKey = turnstileSecretKey;
+		const { name, ...cookieOptions } = cookie ?? {};
+		this.cookieName = name ?? "SESSION";
+		this.cookieOptions = {
+			path: "/",
+			sameSite: "none",
+			secure: true,
+			httpOnly: true,
+			...cookieOptions
+		};
+		this.oauth2Client = oauth2?.client ? new require_oauth2_client.OAuth2Client(oauth2.client) : null;
+	}
+	getSessionId(request) {
+		let sessionId;
+		const header = request.headers.get("Authorization");
+		if (header?.startsWith("Bearer ")) sessionId = header.replace("Bearer ", "");
+		if (!sessionId) sessionId = require_utils_http.getCookie(request, this.cookieName);
+		return sessionId;
+	}
+	csrf = async (_request) => {
+		const token = (0, node_crypto.randomUUID)();
+		const response = Response.json({
+			token,
+			parameterName: "_csrf",
+			headerName: "X-XSRF-TOKEN"
+		});
+		require_utils_http.setCookie(response, "XSRF-TOKEN", token, {
+			path: "/",
+			secure: true,
+			httpOnly: false,
+			sameSite: "none",
+			domain: this.cookieOptions.domain
+		});
+		return response;
+	};
+	logout = async (request) => {
+		const sessionId = this.getSessionId(request);
+		if (sessionId) await this.repository.deleteById(sessionId);
+		const response = Response.json({});
+		require_utils_http.deleteCookie(response, this.cookieName);
+		return response;
+	};
+	logged = async (request, onLogged) => {
+		const sessionId = this.getSessionId(request);
+		if (!sessionId) return Response.json({ data: false });
+		const session = await this.repository.findById(sessionId);
+		if (!session) return Response.json({ data: false });
+		const name = session.getAttribute(require_session_common.PRINCIPAL_NAME_INDEX_NAME);
+		session.setLastAccessedTime(Date.now());
+		await this.repository.save(session);
+		if (name !== null) await onLogged?.({ name: String(name) });
+		const response = Response.json({ data: name !== null });
+		const maxAge = session.getMaxInactiveInterval();
+		require_utils_http.setCookie(response, this.cookieName, session.getId(), {
+			...this.cookieOptions,
+			maxAge
+		});
+		return response;
+	};
+	createPkceParameters() {
+		const code_verifier = (0, node_crypto.randomUUID)();
+		return {
+			code_verifier,
+			code_challenge: (0, node_crypto.createHash)("sha256").update(code_verifier).digest().toString("base64url"),
+			code_challenge_method: "S256"
+		};
+	}
+	getOauth2StateKey(state) {
+		return `oauth2:state:${state}`;
+	}
+	getOauth2NonceKey(nonce) {
+		return `oauth2:nonce:${nonce}`;
+	}
+	getEmailVerificationCodeKey(email) {
+		return `email:verification:${email}`;
+	}
+	getPhoneVerificationCodeKey(phone) {
+		return `phone:verification:${phone}`;
+	}
+	getDesktopCodeKey(code) {
+		return `desktop:code:${code}`;
+	}
+	oauth2State = async (request) => {
+		const { registrationId } = require_utils_http.param(request, PATH.OAUTH2_STATE);
+		const state = (0, node_crypto.randomUUID)();
+		await this.kv.setItem(this.getOauth2StateKey(state), registrationId, 600);
+		return Response.json({ state });
+	};
+	oauth2Nonce = async (request) => {
+		const { registrationId } = require_utils_http.param(request, PATH.OAUTH2_NONCE);
+		const nonce = (0, node_crypto.randomUUID)();
+		await this.kv.setItem(this.getOauth2NonceKey(nonce), registrationId, 600);
+		return Response.json({ nonce });
+	};
+	oauth2Authorization = async (request) => {
+		(0, _shware_utils.invariant)(this.oauth2Client, "oauth2Client is not initialized");
+		const { mark, setTiming } = require_utils_timing.timing({ enabled: this.timing });
+		const { registrationId } = require_utils_http.param(request, PATH.OAUTH2_AUTHORIZATION);
+		const state = (0, node_crypto.randomUUID)();
+		const pkce = this.createPkceParameters();
+		const uri = await this.oauth2Client.createAuthorizationUri({
+			registrationId,
+			state,
+			pkce
+		});
+		const sessionId = this.getSessionId(request);
+		const session = sessionId ? await this.repository.findById(sessionId) ?? this.repository.createSession() : this.repository.createSession();
+		mark("fetch_session");
+		const authorizationRequest = {
+			state,
+			registrationId,
+			authorizationRequestUri: uri.href,
+			additionalParameters: pkce
+		};
+		const value = JSON.stringify(authorizationRequest);
+		session.setAttribute(this.ATTR_OAUTH2_AUTHORIZATION_REQUEST, value);
+		await this.repository.save(session);
+		mark("save_session");
+		const response = new Response(null, {
+			status: 302,
+			headers: { location: uri.href }
+		});
+		const maxAge = session.getMaxInactiveInterval();
+		require_utils_http.setCookie(response, this.cookieName, session.getId(), {
+			...this.cookieOptions,
+			maxAge
+		});
+		setTiming(response);
+		return response;
+	};
+	redirect = (error, description) => {
+		(0, _shware_utils.invariant)(this.oauth2Client, "oauth2Client is not initialized");
+		const uri = new URL(this.oauth2Client.errorUri);
+		uri.searchParams.set("error", error);
+		if (description) uri.searchParams.set("error_description", description);
+		return Response.redirect(uri.href, 302);
+	};
+	loginOAuth2Code = async (request, handler) => {
+		(0, _shware_utils.invariant)(this.oauth2Client, "oauth2Client is not initialized");
+		const { mark, setTiming } = require_utils_timing.timing({ enabled: this.timing });
+		const sessionId = this.getSessionId(request);
+		const session = sessionId ? await this.repository.findById(sessionId) : null;
+		if (!session) return this.redirect("invalid_request", "session not found");
+		mark("load_session");
+		const json = session.getAttribute(this.ATTR_OAUTH2_AUTHORIZATION_REQUEST);
+		if (!json) return this.redirect("invalid_request", "authorization request not found");
+		const cached = JSON.parse(json);
+		const { registrationId } = require_utils_http.param(request, PATH.LOGIN_OAUTH2_CODE);
+		let data;
+		if (request.method === "POST" && request.headers.get("content-type")?.toLowerCase() === "application/x-www-form-urlencoded") {
+			const params = new URLSearchParams(await request.text());
+			data = Object.fromEntries(params.entries());
+		} else data = require_utils_http.query(request);
+		const parsed = require_oauth2_client.oauth2RedirectQuerySchema.safeParse(data);
+		if (!parsed.success) return this.redirect("invalid_request", "invalid redirect query");
+		if (!parsed.data.code || !parsed.data.state) return this.redirect("invalid_request", "invalid redirect query");
+		if (parsed.data.state !== cached.state) return this.redirect("invalid_request", "redirect state mismatch");
+		if (registrationId !== cached.registrationId) return this.redirect("invalid_request", "redirect registration mismatch");
+		mark("validate_session");
+		const { code } = parsed.data;
+		const token = await this.oauth2Client.exchangeAuthorizationCode({
+			registrationId,
+			code,
+			pkce: cached.additionalParameters
+		});
+		const userInfo = await this.oauth2Client.getUserInfo({
+			registrationId,
+			token
+		});
+		mark("exchange_code");
+		const principal = await handler(request, registrationId, userInfo, token);
+		mark("save_principal");
+		session.setLastAccessedTime(Date.now());
+		session.removeAttribute(this.ATTR_OAUTH2_AUTHORIZATION_REQUEST);
+		session.setAttribute(require_session_common.PRINCIPAL_NAME_INDEX_NAME, principal.name);
+		await this.repository.save(session);
+		mark("update_session");
+		const uri = new URL(this.oauth2Client.successUri);
+		uri.searchParams.set("status", "success");
+		uri.searchParams.set("registrationId", registrationId);
+		const response = new Response(null, {
+			status: 302,
+			headers: { location: uri.href }
+		});
+		const maxAge = session.getMaxInactiveInterval();
+		require_utils_http.setCookie(response, this.cookieName, session.getId(), {
+			...this.cookieOptions,
+			maxAge
+		});
+		setTiming(response);
+		return response;
+	};
+	loginOAuth2Native = async (request, handler) => {
+		(0, _shware_utils.invariant)(this.oauth2Client, "oauth2Client is not initialized");
+		const { mark, setTiming } = require_utils_timing.timing({ enabled: this.timing });
+		const { registrationId } = require_utils_http.param(request, PATH.LOGIN_OAUTH2_NATIVE);
+		const credentials = await request.json();
+		const { userInfo, token } = await this.oauth2Client.loginOAuth2Native({
+			registrationId,
+			credentials
+		});
+		mark("login_oauth2_native");
+		const { nonce } = userInfo.data;
+		if (nonce) {
+			if (await this.kv.getItem(this.getOauth2NonceKey(nonce)) !== registrationId) return Response.json({
+				error: "invalid_request",
+				error_description: "nonce mismatch"
+			}, { status: 400 });
+			await this.kv.removeItem(this.getOauth2NonceKey(nonce));
+			mark("check_nonce");
+		}
+		const principal = await handler(request, registrationId, userInfo, token);
+		mark("save_principal");
+		const session = this.repository.createSession();
+		session.setAttribute(require_session_common.PRINCIPAL_NAME_INDEX_NAME, principal.name);
+		await this.repository.save(session);
+		const response = new Response(JSON.stringify(principal), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+		const maxAge = session.getMaxInactiveInterval();
+		require_utils_http.setCookie(response, this.cookieName, session.getId(), {
+			...this.cookieOptions,
+			maxAge
+		});
+		setTiming(response);
+		return response;
+	};
+	loginOAuth2Onetap = async (request, handler, registrationId = "google") => {
+		(0, _shware_utils.invariant)(this.oauth2Client, "oauth2Client is not initialized");
+		const { mark, setTiming } = require_utils_timing.timing({ enabled: this.timing });
+		let body;
+		if (request.headers.get("Content-Type")?.includes("application/x-www-form-urlencoded")) {
+			const text = await request.text();
+			body = Object.fromEntries(new URLSearchParams(text));
+		} else if (request.headers.get("Content-Type")?.includes("application/json")) body = await request.json();
+		else return Response.json({
+			error: "invalid_request",
+			error_description: "invalid content type"
+		}, { status: 400 });
+		const parsed = require_oauth2_client.googleOneTapSchema.parse(body);
+		let principal;
+		if (parsed.credential) {
+			const { token, userInfo } = await require_oauth2_provider_google.google.getTokenInfo(parsed.credential);
+			principal = await handler(request, registrationId, userInfo, token);
+		} else if (parsed.code) {
+			const token = await this.oauth2Client.exchangeAuthorizationCode({
+				registrationId,
+				code: parsed.code
+			});
+			principal = await handler(request, registrationId, await this.oauth2Client.getUserInfo({
+				registrationId,
+				token
+			}), token);
+		} else throw new Error("invalid request");
+		mark("save_principal");
+		const session = this.repository.createSession();
+		session.setAttribute(require_session_common.PRINCIPAL_NAME_INDEX_NAME, principal.name);
+		await this.repository.save(session);
+		const response = new Response(JSON.stringify(principal), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+		const maxAge = session.getMaxInactiveInterval();
+		require_utils_http.setCookie(response, this.cookieName, session.getId(), {
+			...this.cookieOptions,
+			maxAge
+		});
+		setTiming(response);
+		return response;
+	};
+	sendEmailVerificationCode = async (request, sender) => {
+		(0, _shware_utils.invariant)(this.turnstileSecretKey, "turnstileSecretKey is not configured");
+		const { data, error } = require_utils_valid.valid(require_email_schema.sendEmailVerificationCodeSchema, await request.json());
+		if (error) return Response.json(error, { status: error.error.code });
+		const { email, turnstileToken } = data;
+		const result = await require_utils_valid.verifyTurnstileToken(this.turnstileSecretKey, turnstileToken);
+		if (result.error) return Response.json(result.error, { status: result.error.error.code });
+		try {
+			const verificationCode = (0, node_crypto.randomInt)(1e6).toString().padStart(6, "0");
+			await sender({
+				email,
+				verificationCode
+			});
+			await this.kv.setItem(this.getEmailVerificationCodeKey(email), verificationCode, 600);
+			return Response.json({});
+		} catch (e) {
+			console.error("Failed to send email verification code", e);
+			return Response.json(require_utils_valid.invalidArgument("EMAIL_DELIVERY_FAILED"), { status: 400 });
+		}
+	};
+	loginEmail = async (request, handler) => {
+		const { data, error } = require_utils_valid.valid(require_email_schema.loginEmailSchema, await request.json());
+		if (error) return Response.json(error, { status: error.error.code });
+		const { email, verificationCode } = data;
+		const key = this.getEmailVerificationCodeKey(email);
+		const stored = await this.kv.getItem(key);
+		if (typeof stored !== "string" || stored.length !== verificationCode.length || !(0, node_crypto.timingSafeEqual)(Buffer.from(stored), Buffer.from(verificationCode))) return Response.json(require_utils_valid.invalidArgument("INVALID_VERIFICATION_CODE"), { status: 400 });
+		await this.kv.removeItem(key);
+		const principal = await handler(request, "EMAIL", {
+			claims: {
+				sub: email,
+				email,
+				email_verified: true
+			},
+			data: {}
+		});
+		const session = this.repository.createSession();
+		session.setAttribute(require_session_common.PRINCIPAL_NAME_INDEX_NAME, principal.name);
+		await this.repository.save(session);
+		const response = new Response(JSON.stringify(principal), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+		const maxAge = session.getMaxInactiveInterval();
+		require_utils_http.setCookie(response, this.cookieName, session.getId(), {
+			...this.cookieOptions,
+			maxAge
+		});
+		return 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.
+	*
+	* 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.
+	*
+	* 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.
+	*/
+	desktopAuthorize = async (request) => {
+		const principal = await this.getPrincipal(request);
+		if (!principal) return Response.json({ error: {
+			code: 401,
+			status: "UNAUTHENTICATED",
+			message: "sign in first",
+			details: []
+		} }, { status: 401 });
+		let body;
+		try {
+			body = await request.json();
+		} catch {
+			return Response.json(require_utils_valid.invalidArgument("INVALID_ARGUMENT"), { status: 400 });
+		}
+		const codeChallenge = typeof body.code_challenge === "string" ? body.code_challenge : null;
+		if (!codeChallenge || body.code_challenge_method !== "S256" || !PKCE_FORMAT.test(codeChallenge)) return Response.json(require_utils_valid.invalidArgument("INVALID_ARGUMENT"), { status: 400 });
+		const code = (0, node_crypto.randomUUID)();
+		const record = {
+			name: principal.name,
+			cc: codeChallenge
+		};
+		await this.kv.setItem(this.getDesktopCodeKey(code), JSON.stringify(record), 300);
+		return Response.json({ code });
+	};
+	/**
+	* 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.
+	*
+	* 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.
+	*
+	* No CSRF check needed — the request carries no cookie, the auth code
+	* itself is the credential, and KV's single-use removal blocks replay.
+	*/
+	desktopExchange = async (request) => {
+		let body;
+		try {
+			body = await request.json();
+		} catch {
+			return Response.json(require_utils_valid.invalidArgument("INVALID_ARGUMENT"), { status: 400 });
+		}
+		const code = typeof body.code === "string" ? body.code : null;
+		const verifier = typeof body.code_verifier === "string" ? body.code_verifier : null;
+		if (!code || !verifier || !PKCE_FORMAT.test(verifier)) return Response.json(require_utils_valid.invalidArgument("INVALID_ARGUMENT"), { status: 400 });
+		const key = this.getDesktopCodeKey(code);
+		const raw = await this.kv.getItem(key);
+		if (typeof raw !== "string") return Response.json(require_utils_valid.invalidArgument("INVALID_DESKTOP_CODE"), { status: 400 });
+		let record;
+		try {
+			record = JSON.parse(raw);
+		} catch {
+			await this.kv.removeItem(key);
+			return Response.json(require_utils_valid.invalidArgument("INVALID_DESKTOP_CODE"), { status: 400 });
+		}
+		const computed = (0, node_crypto.createHash)("sha256").update(verifier).digest();
+		const stored = Buffer.from(record.cc, "base64url");
+		if (stored.length !== computed.length || !(0, node_crypto.timingSafeEqual)(computed, stored)) return Response.json(require_utils_valid.invalidArgument("INVALID_DESKTOP_CODE"), { status: 400 });
+		await this.kv.removeItem(key);
+		const session = this.repository.createSession();
+		session.setAttribute(require_session_common.PRINCIPAL_NAME_INDEX_NAME, record.name);
+		session.setAttribute("client_type", "desktop");
+		await this.repository.save(session);
+		const response = Response.json({ ok: true });
+		const maxAge = session.getMaxInactiveInterval();
+		require_utils_http.setCookie(response, this.cookieName, session.getId(), {
+			...this.cookieOptions,
+			sameSite: "none",
+			secure: true,
+			maxAge
+		});
+		return response;
+	};
+	sendPhoneVerificationCode = async (_request, _sender) => {
+		return Response.json({ error: "not_implemented" }, { status: 501 });
+	};
+	loginPhone = async (_request, _handler) => {
+		return Response.json({ error: "not_implemented" }, { status: 501 });
+	};
+	kick = async (principal) => {
+		const sessions = await this.repository.findByPrincipalName(principal.name);
+		for (const sessionId of sessions.keys()) await this.repository.deleteById(sessionId);
+	};
+	isAuthenticated = async (request) => {
+		const sessionId = this.getSessionId(request);
+		if (!sessionId) return false;
+		const session = await this.repository.findById(sessionId);
+		if (!session) return false;
+		if (!session.getAttribute(require_session_common.PRINCIPAL_NAME_INDEX_NAME)) return false;
+		return true;
+	};
+	getSession = async (request, create) => {
+		const sessionId = this.getSessionId(request);
+		if (!sessionId) if (create) {
+			const session = this.repository.createSession();
+			await this.repository.save(session);
+			return session;
+		} else return null;
+		const session = await this.repository.findById(sessionId);
+		if (!session) if (create) {
+			const session = this.repository.createSession();
+			await this.repository.save(session);
+			return session;
+		} else return null;
+		return session;
+	};
+	deleteSession = async (sessionId) => {
+		await this.repository.deleteById(sessionId);
+	};
+	getPrincipal = async (request) => {
+		const sessionId = this.getSessionId(request);
+		if (!sessionId) return null;
+		const session = await this.repository.findById(sessionId);
+		if (!session) return null;
+		const name = session.getAttribute(require_session_common.PRINCIPAL_NAME_INDEX_NAME);
+		if (!name) return null;
+		return { name: String(name) };
+	};
+	listSessions = async (principal) => {
+		const sessions = await this.repository.findByPrincipalName(principal.name);
+		return Array.from(sessions.values());
+	};
+	cleanupExpiredSessions = async (cleanupCount) => {
+		await this.repository.cleanupExpiredSessions(cleanupCount);
+		return Response.json({});
+	};
 };
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  Auth,
-  PATH
-});
+//#endregion
+exports.Auth = Auth;
+exports.PATH = PATH;
+
 //# sourceMappingURL=index.cjs.map