@fonderie/auth 1.1.0 → 1.2.0

package/dist/index.cjs

@@ -57,6 +57,8 @@ __export(index_exports, {
   AUTH_CONFIG_KEYS: () => AUTH_CONFIG_KEYS,
   AuthModule: () => AuthModule,
   MESSAGE_KEYS: () => MESSAGE_KEYS,
+  buildAuthAccountLimiter: () => buildAuthAccountLimiter,
+  buildAuthIpLimiter: () => buildAuthIpLimiter,
   normalizeEmail: () => normalizeEmail,
   normalizeEmailSafe: () => normalizeEmailSafe,
   requireAuth: () => import_middlewares3.requireAuth,
@@ -86,6 +88,55 @@ var requireEmailLogin = async (ctx, next) => {
 // src/middlewares/validate.ts
 var import_middlewares = require("@fonderie/core/middlewares");
 
+// src/services/rate-limit.ts
+var import_rate_limit = require("@fonderie/rate-limit");
+var min = (n) => n * 60;
+var DEFAULTS = {
+  // login: 10/15min per IP AND 5/15min per account (credential stuffing
+  // rotates IPs, so the per-account bucket is the one that bites).
+  login: {
+    ip: { capacity: 10, refillPerSec: 10 / min(15) },
+    account: { capacity: 5, refillPerSec: 5 / min(15) },
+    accountField: "email"
+  },
+  // register: 5/hour per IP — signup abuse is IP-shaped.
+  register: { ip: { capacity: 5, refillPerSec: 5 / min(60) } },
+  // forgot: 5/hour per IP AND 3/hour per account (email-bombing protection).
+  forgot: {
+    ip: { capacity: 5, refillPerSec: 5 / min(60) },
+    account: { capacity: 3, refillPerSec: 3 / min(60) },
+    accountField: "email"
+  },
+  // mfaVerify: 10/15min per IP — TOTP brute-force.
+  mfaVerify: { ip: { capacity: 10, refillPerSec: 10 / min(15) } }
+};
+function resolve(route, store, config) {
+  if (config === false) return null;
+  const override = config?.rules?.[route];
+  if (override === false) return null;
+  const backing = config?.store ?? new import_rate_limit.StoreAdapterStore(store);
+  const def = DEFAULTS[route];
+  return {
+    store: backing,
+    ipRule: override ?? def.ip,
+    ...def.account && def.accountField ? { account: { rule: def.account, field: def.accountField } } : {}
+  };
+}
+function buildAuthIpLimiter(route, store, config) {
+  const r = resolve(route, store, config);
+  if (!r) return null;
+  return (0, import_rate_limit.rateLimit)({ store: r.store, rule: r.ipRule, key: (0, import_rate_limit.byIp)(`auth:${route}`) });
+}
+function buildAuthAccountLimiter(route, store, config) {
+  const r = resolve(route, store, config);
+  if (!r || !r.account) return null;
+  return (0, import_rate_limit.rateLimit)({
+    store: r.store,
+    rule: r.account.rule,
+    key: (0, import_rate_limit.byBodyField)(`auth:${route}`, r.account.field)
+  });
+}
+
 // src/schemas.ts
 var schemas_exports = {};
 __export(schemas_exports, {
@@ -151,6 +202,26 @@ var changePasswordSchema = import_zod.z.object({
 });
 var mfaTokenSchema = import_zod.z.object({ token: import_zod.z.string().trim().min(6).max(64) });
 
+// src/services/cookies.ts
+function secureAttr(config) {
+  const secure = config.secureCookies ?? process.env["NODE_ENV"] === "production";
+  return secure ? "; Secure" : "";
+}
+function tokenPairCookies(accessToken, refreshToken, config) {
+  const secure = secureAttr(config);
+  return [
+    `access_token=${accessToken}; HttpOnly; SameSite=Strict; Path=/${secure}`,
+    `refresh_token=${refreshToken}; HttpOnly; SameSite=Strict; Path=/auth/refresh${secure}`
+  ].join(", ");
+}
+function clearedTokenCookies(config) {
+  const secure = secureAttr(config);
+  return [
+    `access_token=; HttpOnly; SameSite=Strict; Path=/; Max-Age=0${secure}`,
+    `refresh_token=; HttpOnly; SameSite=Strict; Path=/auth/refresh; Max-Age=0${secure}`
+  ].join(", ");
+}
+
 // src/controllers/mfa.controller.ts
 var import_qrcode = __toESM(require("qrcode"), 1);
 var import_core3 = require("@fonderie/core");
@@ -735,10 +806,7 @@ function mfaController(store, config, issuer, bus) {
         {
           status: 200,
           headers: {
-            "Set-Cookie": [
-              `access_token=${accessToken}; HttpOnly; SameSite=Strict; Path=/`,
-              `refresh_token=${refreshToken}; HttpOnly; SameSite=Strict; Path=/auth/refresh`
-            ].join(", ")
+            "Set-Cookie": tokenPairCookies(accessToken, refreshToken, config)
           }
         }
       );
@@ -1072,10 +1140,7 @@ function authController(store, config, bus) {
           {
             status: 201,
             headers: {
-              "Set-Cookie": [
-                `access_token=${accessToken}; HttpOnly; SameSite=Strict; Path=/`,
-                `refresh_token=${refreshToken}; HttpOnly; SameSite=Strict; Path=/auth/refresh`
-              ].join(", ")
+              "Set-Cookie": tokenPairCookies(accessToken, refreshToken, config)
             }
           }
         );
@@ -1137,10 +1202,7 @@ function authController(store, config, bus) {
           {
             status: 202,
             headers: {
-              "Set-Cookie": [
-                `access_token=${accessToken}; HttpOnly; SameSite=Strict; Path=/`,
-                `refresh_token=${refreshToken}; HttpOnly; SameSite=Strict; Path=/auth/refresh`
-              ].join(", ")
+              "Set-Cookie": tokenPairCookies(accessToken, refreshToken, config)
             }
           }
         );
@@ -1199,10 +1261,7 @@ function authController(store, config, bus) {
           {
             status: 200,
             headers: {
-              "Set-Cookie": [
-                `access_token=${accessToken}; HttpOnly; SameSite=Strict; Path=/`,
-                `refresh_token=${refreshToken}; HttpOnly; SameSite=Strict; Path=/auth/refresh`
-              ].join(", ")
+              "Set-Cookie": tokenPairCookies(accessToken, refreshToken, config)
             }
           }
         );
@@ -1245,10 +1304,7 @@ function authController(store, config, bus) {
           {
             status: 202,
             headers: {
-              "Set-Cookie": [
-                `access_token=${accessToken}; HttpOnly; SameSite=Strict; Path=/`,
-                `refresh_token=${refreshToken}; HttpOnly; SameSite=Strict; Path=/auth/refresh`
-              ].join(", ")
+              "Set-Cookie": tokenPairCookies(accessToken, refreshToken, config)
             }
           }
         );
@@ -1269,10 +1325,7 @@ function authController(store, config, bus) {
         {
           status: 200,
           headers: {
-            "Set-Cookie": [
-              "access_token=; HttpOnly; SameSite=Strict; Path=/; Max-Age=0",
-              "refresh_token=; HttpOnly; SameSite=Strict; Path=/auth/refresh; Max-Age=0"
-            ].join(", ")
+            "Set-Cookie": clearedTokenCookies(config)
           }
         }
       );
@@ -1313,10 +1366,7 @@ function authController(store, config, bus) {
         {
           status: 200,
           headers: {
-            "Set-Cookie": [
-              `access_token=${accessToken}; HttpOnly; SameSite=Strict; Path=/`,
-              `refresh_token=${refreshToken}; HttpOnly; SameSite=Strict; Path=/auth/refresh`
-            ].join(", ")
+            "Set-Cookie": tokenPairCookies(accessToken, refreshToken, config)
           }
         }
       );
@@ -1344,12 +1394,9 @@ function authController(store, config, bus) {
       const remaining = checkCooldown(await passwordReset.findLastSentAt(user.id), cooldown);
       if (remaining > 0) {
         return (0, import_core4.setApiResponse)(
-          import_core4.HTTP.TOO_MANY_REQUESTS,
-          "VERIFICATION_COOLDOWN",
-          "Please wait before requesting a new password reset code.",
-          {
-            retryAfter: Math.ceil(remaining / 1e3)
-          }
+          import_core4.HTTP.OK,
+          "PASSWORD_RESET_EMAIL_SENT",
+          "Password reset email sent (if account exists)."
         );
       }
       const pin = (0, import_node_crypto2.randomInt)(1e5, 1e6).toString();
@@ -1468,10 +1515,7 @@ function authController(store, config, bus) {
           {
             status: 200,
             headers: {
-              "Set-Cookie": [
-                `access_token=${accessToken}; HttpOnly; SameSite=Strict; Path=/`,
-                `refresh_token=${refreshToken}; HttpOnly; SameSite=Strict; Path=/auth/refresh`
-              ].join(", ")
+              "Set-Cookie": tokenPairCookies(accessToken, refreshToken, config)
             }
           }
         );
@@ -1588,7 +1632,7 @@ function normalizePhone2(phone2) {
 function isValidPhone2(phone2) {
   return typeof phone2 === "string" && /^\+?[1-9]\d{6,14}$/.test(normalizePhone2(phone2));
 }
-function userController(store, bus) {
+function userController(store, config, bus) {
   const users = new UserModel(store);
   const emailVerif = new EmailVerificationModel(store);
   const phoneVerif = new PhoneVerificationModel(store);
@@ -1777,10 +1821,7 @@ function userController(store, bus) {
         {
           status: 200,
           headers: {
-            "Set-Cookie": [
-              "access_token=; HttpOnly; SameSite=Strict; Path=/; Max-Age=0",
-              "refresh_token=; HttpOnly; SameSite=Strict; Path=/auth/refresh; Max-Age=0"
-            ].join(", ")
+            "Set-Cookie": clearedTokenCookies(config)
           }
         }
       );
@@ -1884,10 +1925,7 @@ function oauthController(store, config) {
         {
           status: 200,
           headers: {
-            "Set-Cookie": [
-              `access_token=${accessToken}; HttpOnly; SameSite=Strict; Path=/`,
-              `refresh_token=${refreshToken}; HttpOnly; SameSite=Strict; Path=/auth/refresh`
-            ].join(", ")
+            "Set-Cookie": tokenPairCookies(accessToken, refreshToken, config)
           }
         }
       );
@@ -1897,19 +1935,22 @@ function oauthController(store, config) {
 
 // src/routes.ts
 function buildAuthRoutes(store, config, bus) {
-  const user = userController(store, bus);
+  const user = userController(store, config, bus);
   const auth = authController(store, config, bus);
   const oauth = oauthController(store, config);
   const mfa = mfaController(store, config, config.appName ?? "Fonderie", bus);
   const verifyGate = config.requireVerification ? import_middlewares2.requireVerified : (_ctx, next) => next();
+  const passthrough = (_ctx, next) => next();
+  const ipLimit = (route) => buildAuthIpLimiter(route, store, config.rateLimit) ?? passthrough;
+  const acctLimit = (route) => buildAuthAccountLimiter(route, store, config.rateLimit) ?? passthrough;
   const routes = [
     // Registration & Login (Public)
-    ["POST", "/auth/register", (0, import_middlewares.validate)(registerSchema), auth.register],
-    ["POST", "/auth/login", (0, import_middlewares.validate)(loginSchema), auth.login],
+    ["POST", "/auth/register", ipLimit("register"), (0, import_middlewares.validate)(registerSchema), auth.register],
+    ["POST", "/auth/login", ipLimit("login"), (0, import_middlewares.validate)(loginSchema), acctLimit("login"), auth.login],
     // Token Management (Public)
     ["POST", "/auth/refresh", (0, import_middlewares.validate)(refreshSchema), auth.refresh],
     // Email — Password Recovery (Public)
-    ["POST", "/auth/email/forgot", (0, import_middlewares.validate)(forgotPasswordSchema), auth.forgotPassword],
+    ["POST", "/auth/email/forgot", ipLimit("forgot"), (0, import_middlewares.validate)(forgotPasswordSchema), acctLimit("forgot"), auth.forgotPassword],
     ["POST", "/auth/email/reset", (0, import_middlewares.validate)(resetPasswordSchema), auth.resetPassword],
     // Verification (Protected — email or phone, determined by loginMethod)
     ["POST", "/auth/verify", import_middlewares2.requireAuth, (0, import_middlewares.validate)(verifySchema), auth.verify],
@@ -1929,7 +1970,7 @@ function buildAuthRoutes(store, config, bus) {
     ["POST", "/auth/mfa/setup", import_middlewares2.requireAuth, requireEmailLogin, import_middlewares2.requireVerified, mfa.setup],
     // /auth/mfa/verify accepts both mfaPending tokens (TOTP/backup-code login)
     // and full tokens (setup confirmation), so requireAnyAuth is used here.
-    ["POST", "/auth/mfa/verify", import_middlewares2.requireAnyAuth, requireEmailLogin, import_middlewares2.requireVerified, (0, import_middlewares.validate)(mfaTokenSchema), mfa.verify],
+    ["POST", "/auth/mfa/verify", ipLimit("mfaVerify"), import_middlewares2.requireAnyAuth, requireEmailLogin, import_middlewares2.requireVerified, (0, import_middlewares.validate)(mfaTokenSchema), mfa.verify],
     ["POST", "/auth/mfa/disable", import_middlewares2.requireAuth, requireEmailLogin, import_middlewares2.requireVerified, (0, import_middlewares.validate)(mfaTokenSchema), mfa.disable],
     [
       "POST",
@@ -2014,6 +2055,8 @@ var import_middlewares3 = require("@fonderie/core/middlewares");
   AUTH_CONFIG_KEYS,
   AuthModule,
   MESSAGE_KEYS,
+  buildAuthAccountLimiter,
+  buildAuthIpLimiter,
   normalizeEmail,
   normalizeEmailSafe,
   requireAuth,