@astratra/security 1.13.0 → 1.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -407,6 +407,20 @@ app.use('/auth', createLoginLimiter({
407
407
  app.use('/auth/login', createAccountLimiter({ onBlocked: ({ identifier }) => { /* ... */ } }));
408
408
  ```
409
409
 
410
+ Un compteur par zone, pour qu'un dépassement sur une page ne bloque pas les autres. Les noms forment une liste fermée, jamais une valeur tirée librement de l'adresse demandée :
411
+
412
+ ```js
413
+ const ZONES = new Set(['notes', 'reunions']);
414
+ app.use(createApiLimiter({
415
+ max: 300,
416
+ area: (req) => {
417
+ const premier = req.path.split('/')[1];
418
+ if (req.path.endsWith('/chapitres')) return { name: 'chapitres', max: 2000 };
419
+ return { name: ZONES.has(premier) ? premier : 'autres' };
420
+ }
421
+ }));
422
+ ```
423
+
410
424
  `createAccountLimiter()` identifie le compte via `req.body.email` par défaut : comme
411
425
  `createWafMiddleware()`, il doit être monté APRÈS `express.json()`/`express.urlencoded()`.
412
426
  Avant, `req.body` vaut `undefined` et toutes les tentatives retombent sur la clé
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@astratra/security",
3
- "version": "1.13.0",
3
+ "version": "1.14.0",
4
4
  "description": "Generic authentication and security middleware for Astratra workspaces.",
5
5
  "engines": {
6
6
  "node": ">=20"
package/src/index.d.ts CHANGED
@@ -304,7 +304,9 @@ export interface AccountLimiterOptions extends RateLimitOptions {
304
304
  onBlocked?: (context: AccountBlockedContext) => Awaitable<void>;
305
305
  }
306
306
 
307
- export function createApiLimiter(options?: RateLimitOptions): RequestHandler;
307
+ /** Un compteur à part pour une zone de l'application ; `max` remplace la limite générale. */
308
+ export interface RateLimitArea { name: string; max?: number }
309
+ export function createApiLimiter(options?: RateLimitOptions & { area?: (req: any) => RateLimitArea | null | undefined }): RequestHandler;
308
310
  export function createLoginLimiter(options?: LoginLimiterOptions): RequestHandler;
309
311
  export function createAccountLimiter(options?: AccountLimiterOptions): RequestHandler;
310
312
  export function skipLocalhost(req: RequestLike): boolean;
@@ -174,15 +174,27 @@ const withOptionalStore = (limiterOptions, store) => {
174
174
 
175
175
  const defaultApiSkip = () => (process.env.NODE_ENV === 'production' ? undefined : skipLocalhost);
176
176
 
177
- const createApiLimiter = (options = {}) => rateLimit(withOptionalStore({
178
- windowMs: options.windowMs || 15 * 60 * 1000,
179
- max: options.max || 300,
180
- skip: options.skip ?? defaultApiSkip(),
181
- standardHeaders: options.standardHeaders ?? true,
182
- legacyHeaders: options.legacyHeaders ?? false,
183
- validate: options.validate || { ip: false },
184
- message: options.message || DEFAULT_API_MESSAGE
185
- }, resolveStore(options)));
177
+ /**
178
+ * `area(req)` sépare les compteurs : chaque zone rendue (`{ name, max }`) a le
179
+ * sien, par adresse. Avec un seul compteur, une boucle ou un gros téléchargement
180
+ * sur une page rendait toutes les autres indisponibles. L'application donne une
181
+ * liste fermée de noms : un nom tiré librement de l'adresse demandée offrirait
182
+ * un compteur neuf à chaque requête, donc plus aucune limite.
183
+ */
184
+ const createApiLimiter = (options = {}) => {
185
+ const fallback = options.max || 300;
186
+ const { area } = options;
187
+ return rateLimit(withOptionalStore({
188
+ windowMs: options.windowMs || 15 * 60 * 1000,
189
+ max: area ? (req) => area(req)?.max || fallback : fallback,
190
+ ...(area ? { keyGenerator: (req) => `${area(req)?.name || 'default'}:${getIp(req)}` } : {}),
191
+ skip: options.skip ?? defaultApiSkip(),
192
+ standardHeaders: options.standardHeaders ?? true,
193
+ legacyHeaders: options.legacyHeaders ?? false,
194
+ validate: options.validate || { ip: false },
195
+ message: options.message || DEFAULT_API_MESSAGE
196
+ }, resolveStore(options)));
197
+ };
186
198
 
187
199
  const createLoginLimiter = (options = {}) => rateLimit(withOptionalStore({
188
200
  windowMs: options.windowMs || 15 * 60 * 1000,