@aura-stack/auth 0.4.0-rc.5 → 0.5.0

package/dist/chunk-U4RK4LKJ.js

@@ -0,0 +1,348 @@
+import {
+  createStructuredData
+} from "./chunk-LX3TJ2TJ.js";
+import {
+  getEnv,
+  getEnvBoolean
+} from "./chunk-WHNDRO3N.js";
+
+// src/logger.ts
+var logMessages = {
+  ROUTER_INTERNAL_ERROR: {
+    facility: 10,
+    severity: "error",
+    msgId: "ROUTER_INTERNAL_ERROR",
+    message: "Unhandled router error while processing the request"
+  },
+  INVALID_REQUEST: {
+    facility: 10,
+    severity: "warning",
+    msgId: "INVALID_REQUEST",
+    message: "Request validation failed against the expected schema"
+  },
+  SERVER_ERROR: {
+    facility: 10,
+    severity: "error",
+    msgId: "SERVER_ERROR",
+    message: "Unexpected internal server error during authentication"
+  },
+  OAUTH_PROTOCOL_ERROR: {
+    facility: 10,
+    severity: "warning",
+    msgId: "OAUTH_PROTOCOL_ERROR",
+    message: "OAuth provider returned an invalid or unexpected protocol response"
+  },
+  OAUTH_AUTHORIZATION_ERROR: {
+    facility: 10,
+    severity: "error",
+    msgId: "OAUTH_AUTHORIZATION_ERROR",
+    message: "OAuth authorization request was rejected or failed"
+  },
+  INVALID_OAUTH_CONFIGURATION: {
+    facility: 10,
+    severity: "error",
+    msgId: "INVALID_OAUTH_CONFIGURATION",
+    message: "The OAuth provider configuration is invalid or incomplete"
+  },
+  OAUTH_ACCESS_TOKEN_REQUEST_INITIATED: {
+    facility: 10,
+    severity: "debug",
+    msgId: "OAUTH_ACCESS_TOKEN_REQUEST_INITIATED",
+    message: "Starting OAuth access token request to the provider"
+  },
+  INVALID_OAUTH_ACCESS_TOKEN_RESPONSE: {
+    facility: 10,
+    severity: "error",
+    msgId: "INVALID_OAUTH_ACCESS_TOKEN_RESPONSE",
+    message: "OAuth access token endpoint returned an invalid or malformed response"
+  },
+  OAUTH_ACCESS_TOKEN_ERROR: {
+    facility: 10,
+    severity: "error",
+    msgId: "OAUTH_ACCESS_TOKEN_ERROR",
+    message: "OAuth access token endpoint returned an error response"
+  },
+  OAUTH_ACCESS_TOKEN_SUCCESS: {
+    facility: 10,
+    severity: "info",
+    msgId: "OAUTH_ACCESS_TOKEN_SUCCESS",
+    message: "Successfully retrieved OAuth access token from the provider"
+  },
+  OAUTH_ACCESS_TOKEN_REQUEST_FAILED: {
+    facility: 10,
+    severity: "error",
+    msgId: "OAUTH_ACCESS_TOKEN_REQUEST_FAILED",
+    message: "Network or server error while requesting OAuth access token"
+  },
+  OAUTH_USERINFO_REQUEST_INITIATED: {
+    facility: 10,
+    severity: "debug",
+    msgId: "OAUTH_USERINFO_REQUEST_INITIATED",
+    message: "Starting OAuth userinfo request to the provider"
+  },
+  OAUTH_USERINFO_INVALID_RESPONSE: {
+    facility: 10,
+    severity: "error",
+    msgId: "OAUTH_USERINFO_INVALID_RESPONSE",
+    message: "OAuth userinfo endpoint returned an invalid or malformed response"
+  },
+  OAUTH_USERINFO_ERROR: {
+    facility: 10,
+    severity: "error",
+    msgId: "OAUTH_USERINFO_ERROR",
+    message: "OAuth userinfo endpoint returned an error response"
+  },
+  OAUTH_USERINFO_SUCCESS: {
+    facility: 10,
+    severity: "info",
+    msgId: "OAUTH_USERINFO_SUCCESS",
+    message: "Successfully retrieved user information from the OAuth provider"
+  },
+  OAUTH_USERINFO_REQUEST_FAILED: {
+    facility: 10,
+    severity: "error",
+    msgId: "OAUTH_USERINFO_REQUEST_FAILED",
+    message: "Network or server error while requesting user information from the OAuth provider"
+  },
+  OAUTH_CALLBACK_SUCCESS: {
+    facility: 4,
+    severity: "info",
+    msgId: "OAUTH_CALLBACK_SUCCESS",
+    message: "OAuth callback completed successfully and session was created"
+  },
+  MISMATCHING_STATE: {
+    facility: 4,
+    severity: "critical",
+    msgId: "MISMATCHING_STATE",
+    message: "OAuth response state parameter does not match the stored state value"
+  },
+  POTENTIAL_OPEN_REDIRECT_ATTACK_DETECTED: {
+    facility: 4,
+    severity: "critical",
+    msgId: "POTENTIAL_OPEN_REDIRECT_ATTACK_DETECTED",
+    message: "Blocked redirect to untrusted or external URL (potential open redirect attack)"
+  },
+  OPEN_REDIRECT_ATTACK: {
+    facility: 4,
+    severity: "warning",
+    msgId: "OPEN_REDIRECT_ATTACK",
+    message: "Detected redirect target that does not match the trusted origin"
+  },
+  SESSION_TOKEN_MISSING: {
+    facility: 4,
+    severity: "warning",
+    msgId: "SESSION_TOKEN_MISSING",
+    message: "Session cookie is missing from the request"
+  },
+  CSRF_TOKEN_MISSING: {
+    facility: 4,
+    severity: "warning",
+    msgId: "CSRF_TOKEN_MISSING",
+    message: "CSRF token cookie is missing from the request"
+  },
+  CSRF_HEADER_MISSING: {
+    facility: 4,
+    severity: "warning",
+    msgId: "CSRF_HEADER_MISSING",
+    message: "CSRF header is missing from the request"
+  },
+  CSRF_TOKEN_INVALID: {
+    facility: 4,
+    severity: "error",
+    msgId: "CSRF_TOKEN_INVALID",
+    message: "CSRF token verification failed or token is invalid"
+  },
+  SIGN_IN_INITIATED: {
+    facility: 4,
+    severity: "info",
+    msgId: "SIGN_IN_INITIATED",
+    message: "Starting OAuth sign-in flow for the selected provider"
+  },
+  SIGN_OUT_ATTEMPT: {
+    facility: 4,
+    severity: "debug",
+    msgId: "SIGN_OUT_ATTEMPT",
+    message: "Received sign-out request from client"
+  },
+  SIGN_OUT_CSRF_VERIFIED: {
+    facility: 4,
+    severity: "info",
+    msgId: "SIGN_OUT_CSRF_VERIFIED",
+    message: "CSRF token was successfully verified during sign-out"
+  },
+  SIGN_OUT_SUCCESS: {
+    facility: 4,
+    severity: "info",
+    msgId: "SIGN_OUT_SUCCESS",
+    message: "User session was cleared and sign-out completed successfully"
+  },
+  SIGN_OUT_REDIRECT: {
+    facility: 4,
+    severity: "debug",
+    msgId: "SIGN_OUT_REDIRECT",
+    message: "Redirecting client after successful sign-out"
+  },
+  AUTH_SESSION_VALID: {
+    facility: 4,
+    severity: "info",
+    msgId: "AUTH_SESSION_VALID",
+    message: "Session token is valid and user session was returned"
+  },
+  AUTH_SESSION_INVALID: {
+    facility: 4,
+    severity: "notice",
+    msgId: "AUTH_SESSION_INVALID",
+    message: "Session token is missing, expired, or invalid"
+  },
+  INVALID_JWT_TOKEN: {
+    facility: 4,
+    severity: "warning",
+    msgId: "INVALID_JWT_TOKEN",
+    message: "JWT session token failed validation during sign-out"
+  },
+  CSRF_TOKEN_REQUESTED: {
+    facility: 4,
+    severity: "debug",
+    msgId: "CSRF_TOKEN_REQUESTED",
+    message: "Client requested a CSRF token"
+  },
+  CSRF_TOKEN_ISSUED: {
+    facility: 4,
+    severity: "debug",
+    msgId: "CSRF_TOKEN_ISSUED",
+    message: "Issued a new CSRF token to the client"
+  },
+  INVALID_URL: {
+    facility: 10,
+    severity: "error",
+    msgId: "INVALID_URL",
+    message: "Derived origin URL is invalid or malformed"
+  },
+  COOKIE_HTTPONLY_DISABLED: {
+    facility: 10,
+    severity: "critical",
+    msgId: "COOKIE_HTTPONLY_DISABLED",
+    message: "Cookie is configured without HttpOnly. This allows JavaScript access via document.cookie and increases XSS exposure."
+  },
+  COOKIE_WILDCARD_DOMAIN: {
+    facility: 10,
+    severity: "critical",
+    msgId: "COOKIE_WILDCARD_DOMAIN",
+    message: "Cookie 'Domain' is set to a wildcard, which is insecure and should be avoided."
+  },
+  COOKIE_SECURE_DISABLED: {
+    facility: 10,
+    severity: "warning",
+    msgId: "COOKIE_SECURE_DISABLED",
+    message: "Cookie is configured with 'Secure' but the request is not HTTPS. The 'Secure' attribute will be ignored by the browser."
+  },
+  COOKIE_SAMESITE_NONE_WITHOUT_SECURE: {
+    facility: 10,
+    severity: "warning",
+    msgId: "COOKIE_SAMESITE_NONE_WITHOUT_SECURE",
+    message: "Cookie uses SameSite=None without Secure. Falling back to SameSite=Lax for safer defaults."
+  },
+  COOKIE_INSECURE_IN_PRODUCTION: {
+    facility: 10,
+    severity: "critical",
+    msgId: "COOKIE_INSECURE_IN_PRODUCTION",
+    message: "Cookies are being served over an insecure connection in production, which is a serious security risk."
+  },
+  COOKIE_HOST_STRATEGY_INSECURE: {
+    facility: 10,
+    severity: "critical",
+    msgId: "COOKIE_HOST_STRATEGY_INSECURE",
+    message: "__Host- cookies require a secure HTTPS context. Falling back to standard cookie settings."
+  },
+  UNTRUSTED_ORIGIN: {
+    facility: 10,
+    severity: "error",
+    msgId: "UNTRUSTED_ORIGIN",
+    message: "The constructed origin URL is not trusted."
+  }
+};
+var createLogEntry = (key, overrides) => {
+  const message = logMessages[key];
+  return {
+    ...message,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    hostname: "aura-auth",
+    procId: typeof process !== "undefined" && process.pid ? process.pid.toString() : "-",
+    ...overrides
+  };
+};
+var logLevelToSeverity = {
+  debug: ["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"],
+  info: ["info", "notice", "warning", "error", "critical", "alert", "emergency"],
+  warn: ["warning", "error", "critical", "alert", "emergency"],
+  error: ["error", "critical", "alert", "emergency"]
+};
+var isValidLogLevel = (value) => {
+  return value === "debug" || value === "info" || value === "warn" || value === "error";
+};
+var getSeverityLevel = (severity) => {
+  const severities = {
+    emergency: 0,
+    alert: 1,
+    critical: 2,
+    error: 3,
+    warning: 4,
+    notice: 5,
+    info: 6,
+    debug: 7
+  };
+  return severities[severity] ?? 6;
+};
+var createSyslogMessage = (options) => {
+  const { timestamp, hostname, appName = "aura-auth", procId = "-", msgId, structuredData, message } = options;
+  const pri = (options.facility ?? 16) * 8 + getSeverityLevel(options.severity);
+  const structuredDataStr = createStructuredData(structuredData ?? {});
+  return `<${pri}>1 ${timestamp} ${hostname} ${appName} ${procId} ${msgId} ${structuredDataStr} ${message}`;
+};
+var createLogger = (logger) => {
+  if (!logger) return void 0;
+  const level = logger.level;
+  const allowedSeverities = logLevelToSeverity[level] ?? [];
+  return {
+    level,
+    log(key, overrides) {
+      const entry = createLogEntry(key, overrides);
+      if (!allowedSeverities.includes(entry.severity)) return entry;
+      logger.log({
+        timestamp: entry.timestamp,
+        appName: entry.appName ?? "aura-auth",
+        hostname: entry.hostname ?? "aura-auth",
+        ...entry
+      });
+      return entry;
+    }
+  };
+};
+var createProxyLogger = (config) => {
+  const level = getEnv("LOG_LEVEL");
+  const debug = getEnvBoolean("DEBUG");
+  if (typeof config?.logger === "object") {
+    return createLogger({
+      log: config.logger?.log || createSyslogMessage,
+      level: isValidLogLevel(config.logger?.level) ? config.logger?.level : isValidLogLevel(level) ? level : "error"
+    });
+  }
+  if (debug || config?.logger === true || level) {
+    return createLogger({
+      level: isValidLogLevel(level) ? level : "debug",
+      log: (options) => {
+        const message = createSyslogMessage(options);
+        console.log(message);
+      }
+    });
+  }
+  return void 0;
+};
+
+export {
+  logMessages,
+  createLogEntry,
+  createSyslogMessage,
+  createLogger,
+  createProxyLogger
+};

package/dist/{chunk-RRLIF4PQ.js → chunk-U5663F2U.js}

@@ -31,6 +31,16 @@ var AuthSecurityError = class extends Error {
     Error.captureStackTrace(this, new.target);
   }
 };
+var AuthClientError = class extends Error {
+  type = "AUTH_CLIENT_ERROR";
+  code;
+  constructor(code, message, options) {
+    super(message, options);
+    this.code = code;
+    this.name = new.target.name;
+    Error.captureStackTrace(this, new.target);
+  }
+};
 var isNativeError = (error) => {
   return error instanceof Error;
 };
@@ -43,13 +53,18 @@ var isAuthInternalError = (error) => {
 var isAuthSecurityError = (error) => {
   return error instanceof AuthSecurityError;
 };
+var isAuthClientError = (error) => {
+  return error instanceof AuthClientError;
+};
 
 export {
   OAuthProtocolError,
   AuthInternalError,
   AuthSecurityError,
+  AuthClientError,
   isNativeError,
   isOAuthProtocolError,
   isAuthInternalError,
-  isAuthSecurityError
+  isAuthSecurityError,
+  isAuthClientError
 };

package/dist/chunk-UN7X6SU5.js

@@ -0,0 +1,53 @@
+import {
+  signIn
+} from "./chunk-JOCGX3RP.js";
+
+// src/actions/signIn/signIn.ts
+import { z } from "zod/v4";
+import { createEndpoint, createEndpointConfig } from "@aura-stack/router";
+var signInConfig = (oauth) => {
+  return createEndpointConfig("/signIn/:oauth", {
+    schemas: {
+      params: z.object({
+        oauth: z.enum(
+          Object.keys(oauth),
+          "The OAuth provider is not supported or invalid."
+        )
+      }),
+      searchParams: z.object({
+        redirect: z.stringbool().optional().default(true),
+        redirectTo: z.string().optional()
+      })
+    }
+  });
+};
+var signInAction = (oauth) => {
+  return createEndpoint(
+    "GET",
+    "/signIn/:oauth",
+    async (ctx) => {
+      const {
+        request,
+        params: { oauth: oauth2 },
+        searchParams: { redirectTo, redirect },
+        context
+      } = ctx;
+      const signInResult = await signIn(oauth2, {
+        ctx: context,
+        headers: request.headers,
+        redirect,
+        redirectTo,
+        request
+      });
+      if (!redirect) {
+        return Response.json(signInResult, { status: 200 });
+      }
+      return signInResult;
+    },
+    signInConfig(oauth)
+  );
+};
+
+export {
+  signInAction
+};

package/dist/chunk-UZQJJD6A.js

@@ -0,0 +1,100 @@
+import {
+  getEnv
+} from "./chunk-WHNDRO3N.js";
+import {
+  AuthInternalError
+} from "./chunk-U5663F2U.js";
+
+// src/jose.ts
+import {
+  createJWT,
+  createJWS,
+  createJWE,
+  createDeriveKey,
+  createSecret
+} from "@aura-stack/jose";
+import { base64url } from "@aura-stack/jose/jose";
+import { encoder, getRandomBytes, getSubtleCrypto } from "@aura-stack/jose/crypto";
+var createJoseInstance = (secret) => {
+  secret ??= getEnv("SECRET");
+  if (!secret) {
+    throw new AuthInternalError(
+      "JOSE_INITIALIZATION_FAILED",
+      "AURA_AUTH_SECRET environment variable is not set and no secret was provided."
+    );
+  }
+  const salt = getEnv("SALT");
+  if (!salt) {
+    throw new AuthInternalError(
+      "JOSE_INITIALIZATION_FAILED",
+      "AURA_AUTH_SALT or AUTH_SALT environment variable is not set. A salt value is required for key derivation."
+    );
+  }
+  try {
+    createSecret(salt);
+  } catch (error) {
+    throw new AuthInternalError(
+      "INVALID_SALT_SECRET_VALUE",
+      "AURA_AUTH_SALT/AUTH_SALT is invalid. It must be at least 32 bytes long and meet entropy requirements.",
+      { cause: error }
+    );
+  }
+  const jose = (async () => {
+    const derivedSigningKey = await createDeriveKey(secret, salt, "signing");
+    const derivedEncryptionKey = await createDeriveKey(secret, salt, "encryption");
+    const derivedCsrfTokenKey = await createDeriveKey(secret, salt, "csrfToken");
+    return {
+      jwt: createJWT({ jws: derivedSigningKey, jwe: derivedEncryptionKey }),
+      jws: createJWS(derivedCsrfTokenKey),
+      jwe: createJWE(derivedEncryptionKey)
+    };
+  })();
+  jose.catch(() => {
+  });
+  return {
+    decodeJWT: async (token, options) => {
+      const { jwt } = await jose;
+      return jwt.decodeJWT(token, options);
+    },
+    encodeJWT: async (payload) => {
+      const { jwt } = await jose;
+      return jwt.encodeJWT(payload);
+    },
+    signJWS: async (...args) => {
+      const { jws } = await jose;
+      return jws.signJWS(...args);
+    },
+    verifyJWS: async (...args) => {
+      const { jws } = await jose;
+      return jws.verifyJWS(...args);
+    },
+    encryptJWE: async (...args) => {
+      const { jwe } = await jose;
+      return jwe.encryptJWE(...args);
+    },
+    decryptJWE: async (...args) => {
+      const { jwe } = await jose;
+      return jwe.decryptJWE(...args);
+    }
+  };
+};
+var jwtVerificationOptions = {
+  algorithms: ["HS256"],
+  typ: "JWT"
+};
+var decodeJWTOptions = {
+  jws: jwtVerificationOptions,
+  jwt: {
+    typ: "JWT"
+  }
+};
+
+export {
+  createJoseInstance,
+  jwtVerificationOptions,
+  decodeJWTOptions,
+  base64url,
+  encoder,
+  getRandomBytes,
+  getSubtleCrypto
+};

package/dist/chunk-V6LLEAR4.js

@@ -0,0 +1,80 @@
+import {
+  base64url,
+  encoder,
+  getRandomBytes,
+  getSubtleCrypto,
+  jwtVerificationOptions
+} from "./chunk-UZQJJD6A.js";
+import {
+  equals,
+  isJWTPayloadWithToken,
+  timingSafeEqual
+} from "./chunk-LX3TJ2TJ.js";
+import {
+  AuthSecurityError
+} from "./chunk-U5663F2U.js";
+
+// src/secure.ts
+var generateSecure = (length = 32) => {
+  return base64url.encode(getRandomBytes(length));
+};
+var createSecretValue = (length = 32) => {
+  return base64url.encode(getRandomBytes(length));
+};
+var createHash = async (data) => {
+  const subtle = getSubtleCrypto();
+  const digest = await subtle.digest("SHA-256", encoder.encode(data));
+  return base64url.encode(new Uint8Array(digest));
+};
+var createPKCE = async (verifier) => {
+  const byteLength = verifier ? void 0 : Math.floor(Math.random() * (96 - 32 + 1) + 32);
+  const codeVerifier = verifier ?? generateSecure(byteLength ?? 64);
+  if (codeVerifier.length < 43 || codeVerifier.length > 128) {
+    throw new AuthSecurityError("PKCE_VERIFIER_INVALID", "The code verifier must be between 43 and 128 characters in length.");
+  }
+  const codeChallenge = await createHash(codeVerifier);
+  return { codeVerifier, codeChallenge, method: "S256" };
+};
+var createCSRF = async (jose, csrfCookie) => {
+  try {
+    const token = generateSecure(32);
+    if (csrfCookie) {
+      await jose.verifyJWS(csrfCookie, jwtVerificationOptions);
+      return csrfCookie;
+    }
+    return jose.signJWS({ token });
+  } catch {
+    const token = generateSecure(32);
+    return jose.signJWS({ token });
+  }
+};
+var verifyCSRF = async (jose, cookie, header) => {
+  try {
+    const cookiePayload = await jose.verifyJWS(cookie, jwtVerificationOptions);
+    const headerPayload = await jose.verifyJWS(header, jwtVerificationOptions);
+    if (!isJWTPayloadWithToken(cookiePayload)) {
+      throw new AuthSecurityError("CSRF_TOKEN_INVALID", "Cookie payload missing token field.");
+    }
+    if (!isJWTPayloadWithToken(headerPayload)) {
+      throw new AuthSecurityError("CSRF_TOKEN_INVALID", "Header payload missing token field.");
+    }
+    if (!equals(cookiePayload.token.length, headerPayload.token.length)) {
+      throw new AuthSecurityError("CSRF_TOKEN_INVALID", "The CSRF tokens do not match.");
+    }
+    if (!timingSafeEqual(cookiePayload.token, headerPayload.token)) {
+      throw new AuthSecurityError("CSRF_TOKEN_INVALID", "The CSRF tokens do not match.");
+    }
+    return true;
+  } catch {
+    throw new AuthSecurityError("CSRF_TOKEN_INVALID", "The CSRF tokens do not match.");
+  }
+};
+
+export {
+  generateSecure,
+  createSecretValue,
+  createHash,
+  createPKCE,
+  createCSRF,
+  verifyCSRF
+};

package/dist/chunk-WHNDRO3N.js

@@ -0,0 +1,50 @@
+// src/env.ts
+var env = new Proxy({}, {
+  get(_, prop) {
+    if (typeof prop !== "string") return void 0;
+    const hasProperty = (process2) => {
+      return process2 && Object.prototype.hasOwnProperty.call(process2, prop);
+    };
+    try {
+      if (typeof process !== "undefined" && hasProperty(process.env)) {
+        return process.env[prop];
+      }
+      if (typeof import.meta !== "undefined" && hasProperty(import.meta.env)) {
+        return import.meta.env[prop];
+      }
+      if (typeof Deno !== "undefined" && Deno.env?.get) {
+        return Deno.env.get(prop);
+      }
+      if (typeof Bun !== "undefined" && hasProperty(Bun.env)) {
+        return Bun.env[prop];
+      }
+      const globalValue = globalThis[prop];
+      return typeof globalValue === "string" ? globalValue : void 0;
+    } catch {
+      return void 0;
+    }
+  }
+});
+var getEnv = (key) => {
+  const keys = [`AURA_AUTH_${key.toUpperCase()}`, `AURA_${key.toUpperCase()}`, `AUTH_${key.toUpperCase()}`, key.toUpperCase()];
+  return env[keys.find((k) => env[k]) ?? ""];
+};
+var getEnvBoolean = (key) => {
+  const value = getEnv(key);
+  if (value === void 0) return false;
+  const normalized = value.trim().toLowerCase();
+  if (["1", "true", "yes", "on", "debug"].includes(normalized)) return true;
+  return false;
+};
+var getEnvArray = (key, defaultValue = []) => {
+  const value = getEnv(key);
+  if (!value) return defaultValue;
+  return value.split(/[,;\n]+/).map((v) => v.trim()).filter(Boolean);
+};
+
+export {
+  env,
+  getEnv,
+  getEnvBoolean,
+  getEnvArray
+};