@nodefony/redis 10.0.0-alpha.8 → 10.0.0-alpha.9

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.
@@ -1,4 +1,4 @@
1
- //#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorate.js
1
+ //#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorate.js
2
2
  function __decorate(decorators, target, key, desc) {
3
3
  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
4
  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -1,4 +1,4 @@
1
- //#region \0@oxc-project+runtime@0.150.0/helpers/esm/decorateMetadata.js
1
+ //#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorateMetadata.js
2
2
  function __decorateMetadata(k, v) {
3
3
  if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
4
4
  }
package/dist/index.js CHANGED
@@ -4,8 +4,8 @@ import { defineRedisConfig, redisConfigJsonSchema } from "./nodefony/config/defi
4
4
  import { RedisTokenStore } from "./nodefony/src/RedisTokenStore.js";
5
5
  import { RedisWebAuthnCredentialStore } from "./nodefony/src/RedisWebAuthnCredentialStore.js";
6
6
  import { registerRedisFrameworkStores } from "./nodefony/registerStores.js";
7
- import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
8
- import __decorate from "./_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
7
+ import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
8
+ import __decorate from "./_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
9
9
  import RedisSessionStorage from "./nodefony/src/SessionStorage.js";
10
10
  import { Kernel, Module, services } from "nodefony";
11
11
  import * as redis from "redis";
@@ -12,6 +12,18 @@ const KEY_BASE = "nf:tok";
12
12
  /** Fenêtre par défaut de conservation d'un PAT révoqué sans expiration (30 j). */
13
13
  const DEFAULT_RETENTION_REVOKED_MS = 2592e6;
14
14
  /**
15
+ * Pose un seuil **monotone** en UNE instruction côté serveur : `GET` puis `SET`
16
+ * séparés par un aller-retour laissaient deux révocations simultanées lire le
17
+ * même état et écrire toutes les deux — le seuil le plus ANCIEN pouvait rester,
18
+ * et des jetons révoqués redevenaient valides. Le script garde la clé en chaîne
19
+ * (aucune migration des données existantes, contrairement à un `ZADD GT`).
20
+ */
21
+ const MONOTONIC_SET_SCRIPT = `local c = redis.call('GET', KEYS[1])
22
+ if (not c) or (tonumber(ARGV[1]) > tonumber(c)) then
23
+ redis.call('SET', KEYS[1], ARGV[1])
24
+ end
25
+ return 1`;
26
+ /**
15
27
  * Store de jetons **Redis** (node-redis v6) — implémentation d'{@link ITokenStore}
16
28
  * pour le cluster (source unique cross-pod, denylist hot).
17
29
  *
@@ -167,9 +179,19 @@ var RedisTokenStore = class RedisTokenStore {
167
179
  const client = this.#client();
168
180
  if (!client) return;
169
181
  const recKey = this.#recKey(record.id);
182
+ const hashKey = this.#hashKey(record.secretHash);
183
+ const owner = await client.get(hashKey);
184
+ if (owner !== null && owner !== record.id && await client.exists(this.#recKey(owner)) === 1) throw new Error(`secretHash déjà porté par le jeton ${owner} : un secret ne désigne qu'un jeton`);
185
+ const previous = await client.hGetAll(recKey);
186
+ if (Object.keys(previous).length > 0) {
187
+ const old = this.#decode(previous);
188
+ if (old.secretHash !== record.secretHash) await client.del(this.#hashKey(old.secretHash));
189
+ if (old.subjectId !== record.subjectId) await client.sRem(this.#subjKey(old.subjectId), record.id);
190
+ if (old.family && old.family !== record.family) await client.sRem(this.#famKey(old.family), record.id);
191
+ }
170
192
  await client.del(recKey);
171
193
  await client.hSet(recKey, this.#encode(record));
172
- const ttl = this.#ttlSeconds(record.expiresAt);
194
+ const ttl = record.expiresAt === null && record.revokedAt !== null ? this.#ttlSeconds(record.revokedAt + this.#retentionRevokedMs) : this.#ttlSeconds(record.expiresAt);
173
195
  if (ttl !== void 0) {
174
196
  await client.expire(recKey, ttl);
175
197
  await client.set(this.#hashKey(record.secretHash), record.id, { EX: ttl });
@@ -365,9 +387,10 @@ var RedisTokenStore = class RedisTokenStore {
365
387
  async revokeAllForSubject(subjectId, invalidBefore) {
366
388
  const client = this.#client();
367
389
  if (!client) return;
368
- const key = this.#revsubKey(subjectId);
369
- const current = await client.get(key);
370
- if (current === null || invalidBefore > Number(current)) await client.set(key, String(invalidBefore));
390
+ await client.eval(MONOTONIC_SET_SCRIPT, {
391
+ keys: [this.#revsubKey(subjectId)],
392
+ arguments: [String(invalidBefore)]
393
+ });
371
394
  }
372
395
  async getInvalidBefore(subjectId) {
373
396
  const client = this.#client();
@@ -387,4 +410,4 @@ var RedisTokenStore = class RedisTokenStore {
387
410
  }
388
411
  };
389
412
  //#endregion
390
- export { RedisTokenStore };
413
+ export { MONOTONIC_SET_SCRIPT, RedisTokenStore };
@@ -27,7 +27,19 @@ export interface RedisClientLike {
27
27
  cursor: string;
28
28
  keys: string[];
29
29
  }>;
30
+ eval(script: string, options: {
31
+ keys: string[];
32
+ arguments: string[];
33
+ }): Promise<unknown>;
30
34
  }
35
+ /**
36
+ * Pose un seuil **monotone** en UNE instruction côté serveur : `GET` puis `SET`
37
+ * séparés par un aller-retour laissaient deux révocations simultanées lire le
38
+ * même état et écrire toutes les deux — le seuil le plus ANCIEN pouvait rester,
39
+ * et des jetons révoqués redevenaient valides. Le script garde la clé en chaîne
40
+ * (aucune migration des données existantes, contrairement à un `ZADD GT`).
41
+ */
42
+ export declare const MONOTONIC_SET_SCRIPT = "local c = redis.call('GET', KEYS[1])\nif (not c) or (tonumber(ARGV[1]) > tonumber(c)) then\n redis.call('SET', KEYS[1], ARGV[1])\nend\nreturn 1";
31
43
  /**
32
44
  * Store de jetons **Redis** (node-redis v6) — implémentation d'{@link ITokenStore}
33
45
  * pour le cluster (source unique cross-pod, denylist hot).
@@ -128,7 +128,7 @@ service par la chaîne `"redis"` dans le conteneur, jamais par un `import`. `Red
128
128
  et la sécurité, dans aucun sens — et le graphe de modules reste acyclique.
129
129
 
130
130
  **Charger le module suffit.** `Redis.onKernelRegister()` (`index.ts:54`) valide la configuration puis
131
- appelle `registerRedisFrameworkStores()` (`registerStores.ts:46`), qui inscrit les fabriques `redis`
131
+ appelle `registerRedisFrameworkStores()` (`registerStores.ts:72`), qui inscrit les fabriques `redis`
132
132
  dans les registres de jetons et de passkeys. Le store de session, lui, s'auto-déclare à l'import du
133
133
  fichier (`SessionStorage.ts:323`). Aucune application n'a de câblage à écrire : il ne reste qu'à
134
134
  nommer le store — ou à laisser `auto` choisir.
@@ -278,7 +278,7 @@ Trois détails de ce schéma décident de tout le comportement en panne :
278
278
 
279
279
  1. `RedisService.init()` (`redis.ts:123`) enveloppe **chaque** connexion dans son propre `try/catch` :
280
280
  une connexion qui échoue est journalisée en `ERROR` et les suivantes sont quand même tentées.
281
- 2. `RedisService.createConnection()` (`redis.ts:146`) inscrit la connexion dans `#connections`
281
+ 2. `RedisService.createConnection()` (`redis.ts:175`) inscrit la connexion dans `#connections`
282
282
  **avant** d'attendre son ouverture (`redis.ts:75`).
283
283
  3. `Connection.create()` (`Connection.ts:86`) affecte `this.client` **avant** d'appeler `connect()`.
284
284
 
@@ -335,7 +335,7 @@ vue d'ensemble ; les fiches détaillent les choix qui surprennent.
335
335
 
336
336
  ### `nf:sess:*` — la session, une chaîne et un TTL
337
337
 
338
- Une session est un blob JSON écrit d'un coup. `RedisSessionStorage.write()` (`SessionStorage.ts:123`)
338
+ Une session est un blob JSON écrit d'un coup. `RedisSessionStorage.write()` (`SessionStorage.ts:106`)
339
339
  pose **systématiquement** un `EX` : une clé de session sans TTL serait une session immortelle, donc un
340
340
  défaut de sécurité, pas une commodité.
341
341
 
@@ -351,22 +351,22 @@ survivre dans Redis jusqu'à la fin de son TTL d'inactivité, mais elle est refu
351
351
  ### `nf:tok:*` — les jetons, un HASH et quatre index
352
352
 
353
353
  Pourquoi un HASH plutôt qu'un blob JSON comme la session ? Parce qu'un jeton est **mis à jour en
354
- place** à chaque usage. `RedisTokenStore.markUsed()` (`RedisTokenStore.ts:436`) écrit un à trois
354
+ place** à chaque usage. `RedisTokenStore.markUsed()` (`RedisTokenStore.ts:487`) écrit un à trois
355
355
  champs (`lastUsedAt`, IP, agent) sans relire l'enregistrement, sans le réécrire, et **sans toucher au
356
356
  TTL**. Avec un blob, chaque appel d'API coûterait une lecture, une désérialisation, une réécriture —
357
357
  et remettrait en jeu la date d'expiration.
358
358
 
359
359
  Ce choix impose une précaution : `HSET` sur une clé absente la **recrée**, et une clé recréée n'a pas
360
- de TTL. Le store vérifie donc l'existence d'abord (`RedisTokenStore.ts:254`) et ne fait rien si
360
+ de TTL. Le store vérifie donc l'existence d'abord (`RedisTokenStore.ts:494`) et ne fait rien si
361
361
  l'identifiant est inconnu. Sans ce test, un jeton expiré ressusciterait, immortel, à sa prochaine
362
362
  utilisation.
363
363
 
364
364
  Les quatre index secondaires sont des SET (`subj`, `fam`) et des chaînes (`hash`, `revsub`). Aucun
365
365
  n'a de TTL : ils sont nettoyés **paresseusement**, quand une lecture tombe sur un membre dont
366
- l'enregistrement a expiré — voir `RedisTokenStore.findBySubject()` (`RedisTokenStore.ts:294`) et
367
- `RedisTokenStore.findByHash()` (`RedisTokenStore.ts:276`).
366
+ l'enregistrement a expiré — voir `RedisTokenStore.findBySubject()` (`RedisTokenStore.ts:348`) et
367
+ `RedisTokenStore.findByHash()` (`RedisTokenStore.ts:330`).
368
368
 
369
- La révocation combine les deux régimes. `RedisTokenStore.#applyRevoke()` (`RedisTokenStore.ts:470`)
369
+ La révocation combine les deux régimes. `RedisTokenStore.#applyRevoke()` (`RedisTokenStore.ts:550`)
370
370
  pose la date et la raison, puis — si le jeton n'avait **pas** d'expiration (cas d'un PAT) — lui donne
371
371
  un TTL égal à la durée de rétention. Un jeton révoqué reste donc consultable un temps, puis disparaît
372
372
  tout seul.
@@ -378,7 +378,7 @@ d'ailleurs pas de méthode de maintenance. Deux structures suffisent : un HASH p
378
378
  SET d'identifiants par utilisateur.
379
379
 
380
380
  Un point de conception mérite d'être connu : `countByUser()`
381
- (`RedisWebAuthnCredentialStore.ts:203`) utilise `SCARD`, en O(1), sans lire un seul HASH. Il peut donc
381
+ (`RedisWebAuthnCredentialStore.ts:199`) utilise `SCARD`, en O(1), sans lire un seul HASH. Il peut donc
382
382
  **sur-compter** les membres orphelins qu'une lecture n'a pas encore nettoyés. L'écart est assumé et
383
383
  orienté **fail-closed** : au pire un enrôlement supplémentaire est refusé, jamais un de trop accepté.
384
384
 
@@ -450,7 +450,7 @@ muet ne l'est pas. Voici ce que le code fait réellement, moment par moment.
450
450
  ### Moment 1 — Redis est absent au démarrage
451
451
 
452
452
  Le module est déclaré non critique (`index.ts:36`), et l'initialisation du service est **bornée dans
453
- le temps** : `Kernel.guardInitialize()` (`Kernel.ts:3651`) enveloppe l'appel dans un délai maximal de
453
+ le temps** : `Kernel.guardInitialize()` (`Kernel.ts:3943`) enveloppe l'appel dans un délai maximal de
454
454
  démarrage. Un `init()` qui pend ne gèle donc pas le boot ; l'échec est agrégé au rapport de démarrage,
455
455
  qui fait dire « démarrage DÉGRADÉ » au superviseur au lieu de mentir sur un état sain.
456
456
 
@@ -488,7 +488,7 @@ garde ne se déclenche que dans deux situations exactes :
488
488
  - **après** `RedisService.closeConnections()` (`redis.ts:247`), qui remet la carte à `null`.
489
489
 
490
490
  Il ne se déclenche **pas** après un `connect()` raté. Puisque la connexion est inscrite dans
491
- `#connections` avant d'être ouverte (`redis.ts:114`) et que `Connection.create()` affecte son client
491
+ `#connections` avant d'être ouverte (`redis.ts:76`) et que `Connection.create()` affecte son client
492
492
  avant de le connecter (`Connection.ts:86`), `getClient("main")` rend alors un client **non nul et
493
493
  fermé**. La commande part donc, et la bibliothèque la rejette :
494
494
 
@@ -506,7 +506,7 @@ ClientClosedError: The client is closed
506
506
  ### Moment 4 — l'arrêt
507
507
 
508
508
  Le service s'abonne une fois pour toutes à la fin de vie du kernel dans son constructeur
509
- (`redis.ts:218`). `closeConnections()` (`redis.ts:218`) ferme chaque connexion, avale et journalise les
509
+ (`redis.ts:247`). `closeConnections()` (`redis.ts:247`) ferme chaque connexion, avale et journalise les
510
510
  échecs individuels, puis libère la carte. `Connection.close()` (`Connection.ts:146`) appelle la
511
511
  fermeture gracieuse du client — qui draine les commandes en vol — puis retire **explicitement** les
512
512
  cinq écouteurs via `Connection.#removeListeners()`, dans un bloc `finally` (`Connection.ts:122`).
@@ -528,7 +528,7 @@ L'ordre compte : les écouteurs sont retirés même si la fermeture échoue.
528
528
  | Idempotence : `redis` demandé, module absent | échec franc au démarrage | ✅ fail-loud |
529
529
 
530
530
  Les deux lignes rouges sont un **écart réel au principe** du framework : `RedisSessionStorage.write()`
531
- (`SessionStorage.ts:123`) rend la charge utile sans la persister et sans un mot. Sur la fenêtre
531
+ (`SessionStorage.ts:106`) rend la charge utile sans la persister et sans un mot. Sur la fenêtre
532
532
  étroite qu'il couvre — avant l'ouverture, après la fermeture — l'impact est faible ; le principe, lui,
533
533
  voudrait une trace. À l'inverse, `RedisSessionStorage.destroy()` (`SessionStorage.ts:143`) rend `true`
534
534
  sans connexion **délibérément** : l'appelant est une déconnexion, et lui répondre « échec » laisserait
@@ -594,9 +594,9 @@ erreur.
594
594
  ### Les vidages complets
595
595
 
596
596
  À côté de la pagination, deux méthodes déversent tout. `RedisSessionStorage.listAll()`
597
- (`SessionStorage.ts:198`) est **plafonnée** à un maximum de clés parcourues et journalise un
597
+ (`SessionStorage.ts:181`) est **plafonnée** à un maximum de clés parcourues et journalise un
598
598
  `WARNING` quand elle tronque — listing partiel signalé, jamais silencieux.
599
- `RedisTokenStore.listAll()` (`RedisTokenStore.ts:319`), en revanche, boucle jusqu'à la fin du
599
+ `RedisTokenStore.listAll()` (`RedisTokenStore.ts:378`), en revanche, boucle jusqu'à la fin du
600
600
  keyspace sans plafond : à grande échelle, préférez la pagination ou le système de référence SQL pour
601
601
  la gouvernance.
602
602
 
@@ -635,8 +635,8 @@ c'est la contrepartie assumée de la séparation imposée par le protocole.
635
635
 
636
636
  - **Écran Stores** (`/nodefony/stores`) : pour chaque brique, le store réellement retenu au démarrage
637
637
  **et la raison**. La résolution est enregistrée par `SessionsService.initializeStorage()`
638
- (`sessions-service.ts:231`), qui journalise aussi la décision au format « `auto` → `redis` (infra
639
- cache) ». Le choix automatique lui-même vient de `resolveAutoStore()` (`infra.ts:241`) : Redis n'est
638
+ (`sessions-service.ts:241`), qui journalise aussi la décision au format « `auto` → `redis` (infra
639
+ cache) ». Le choix automatique lui-même vient de `resolveAutoStore()` (`infra.ts:297`) : Redis n'est
640
640
  proposé que pour les natures non durables.
641
641
  - **Écran Sessions** : l'énumération y passe par `listPage` en mode curseur — d'où l'absence de
642
642
  compteur total et la navigation « page suivante » seule. C'est la capacité réduite décrite plus
@@ -657,10 +657,10 @@ surfacé par les écrans transverses ci-dessus.
657
657
  | Le démarrage pend sans Redis | Tentatives illimitées : `connect()` ne rend pas la main | Fixer un maximum fini ; hors production c'est déjà fait (`defineModuleConfig.ts:65`) |
658
658
  | Deux applications se renvoient leurs messages temps réel | Le pub/sub ignore le numéro de base — cloisonnement inexistant | Poser un namespace de canal explicite (`RedisBackplane.ts:31`) |
659
659
  | Les mêmes messages sont diffusés deux fois localement | Anti-echo court-circuité (identifiant d'origine partagé) | Un identifiant d'origine distinct par pod (`RedisBackplane.ts:212`) |
660
- | Un jeton expiré « revient » et n'expire plus | `HSET` recrée une clé absente, sans TTL | Le test d'existence préalable (`RedisTokenStore.ts:254`) — ne pas le retirer |
661
- | `?cursor=…` fait échouer un listing de jetons | Curseur transmis sans validation (`RedisTokenStore.ts:35`) | Ne pas fabriquer de curseur à la main ; rejouer `nextCursor` tel quel |
660
+ | Un jeton expiré « revient » et n'expire plus | `HSET` recrée une clé absente, sans TTL | Le test d'existence préalable (`RedisTokenStore.ts:494`) — ne pas le retirer |
661
+ | `?cursor=…` fait échouer un listing de jetons | Curseur transmis sans validation (`RedisTokenStore.ts:46`) | Ne pas fabriquer de curseur à la main ; rejouer `nextCursor` tel quel |
662
662
  | L'écran d'administration n'affiche aucun total | `countSessions` / `countTokens` rendent `-1` (comptage O(N) refusé) | Afficher « inconnu » ; ne jamais inventer un total |
663
- | Un `offset` envoyé n'a aucun effet | Le mode curseur ne lit que `cursor` (`SessionStorage.ts:258`) | Paginer par curseur, pas par décalage |
663
+ | Un `offset` envoyé n'a aucun effet | Le mode curseur ne lit que `cursor` (`SessionStorage.ts:196`) | Paginer par curseur, pas par décalage |
664
664
  | Des passkeys disparaissent | Politique d'éviction Redis (`allkeys-lru`) sur des clés **sans** TTL | `noeviction` + persistance sur l'instance qui porte les passkeys |
665
665
  | Une session survit à son âge maximal côté Redis | Le TTL glissant n'exprime pas l'absolu (`SessionStorage.ts:168`) | Comportement voulu — l'âge est refusé à la lecture, pas dans le stockage |
666
666
  | Une surcharge de connexion écrase l'hôte global | Un schéma partiel qui réapplique ses défauts clobberait la valeur globale | Ne poser que les champs voulus dans la surcharge — voir [Configuration](./configuration.md) |
@@ -696,7 +696,7 @@ cette prose. Ce qui doit être dit ici, c'est **ce qui est prouvé, et par quoi*
696
696
  > **Une suite verte ne prouve rien sans serveur Redis.** Les bancs d'intégration se **skippent**
697
697
  > quand l'infra manque, et un skip compte comme un succès : on peut lire « tout est vert » sur une
698
698
  > suite qui n'a rien exercé. La gate du module est déclarée une seule fois — `REDIS_GATE` dans
699
- > `vitest.gates.ts:329` — et la fin de run nomme la cible non exercée avec la commande exacte pour la
699
+ > `vitest.gates.ts:339` — et la fin de run nomme la cible non exercée avec la commande exacte pour la
700
700
  > satisfaire. **Les variables et la commande docker se lisent là, pas ici** : les recopier dans cette
701
701
  > page les condamnerait à diverger.
702
702
 
@@ -125,7 +125,7 @@ options ». Il possède **un schéma Zod commenté**, et tout en dérive :
125
125
  pendant d'entrée `IRedisConfigInput` (`IRedisConfig.ts:17`), où tout champ portant un défaut devient
126
126
  optionnel.
127
127
  - **Le texte d'aide** vit dans les `.describe()` du schéma, ce qui permet à
128
- `redisConfigJsonSchema()` (`defineModuleConfig.ts:110`) de publier un JSON Schema **documenté** que
128
+ `redisConfigJsonSchema()` (`defineModuleConfig.ts:121`) de publier un JSON Schema **documenté** que
129
129
  Studio transforme en formulaire.
130
130
  - **Les champs sensibles se déclarent** : `url` et `password` portent un `.meta({ secret: true })`
131
131
  (`config.ts:187`), ce qui les fait masquer là où la configuration est affichée.
@@ -331,7 +331,7 @@ historiques (`nf:sess`, `nf:tok`, `nf:wac`) sont conservés tels quels.
331
331
  | ---------- | --------------- | ------------------------- | --------------------------------------------------------------------------------------------------------- |
332
332
  | `socket` | objet | défauts de `socketSchema` | Les options TCP/TLS communes. |
333
333
  | `username` | chaîne | _absent_ | Utilisateur ACL (Redis 6+). Absent avec un `password` présent = authentification héritée `requirepass`. |
334
- | `password` | chaîne (secret) | _absent_ | Mot de passe. Marqué secret dans `globalOptionsSchema` (`config.ts:187`) → masqué là où il s'afficherait. |
334
+ | `password` | chaîne (secret) | _absent_ | Mot de passe. Marqué secret dans `globalOptionsSchema` (`config.ts:173`) → masqué là où il s'afficherait. |
335
335
 
336
336
  `username` n'a **pas** de variable d'environnement dédiée : sur un serveur à ACL, il se pose dans la
337
337
  configuration de l'application (il n'est pas secret par lui-même), ou dans l'URL.
@@ -460,7 +460,7 @@ jamais où les sessions ont atterri. Le comparatif transverse vit dans
460
460
  ### Quand une URL est posée, ce qui devient sans effet
461
461
 
462
462
  Dès que `url` est renseignée — par l'application ou par l'environnement — `buildClientOptions()`
463
- (`buildClientOptions.ts:68`) **ne pose plus** `socket.host` ni `socket.port` : ils entreraient en
463
+ (`buildClientOptions.ts:45`) **ne pose plus** `socket.host` ni `socket.port` : ils entreraient en
464
464
  conflit avec ceux de l'URL. Trois conséquences à connaître :
465
465
 
466
466
  <!-- prettier-ignore -->
@@ -495,7 +495,7 @@ définitivement.
495
495
  ouverture ne rend jamais la main tant que Redis ne répond pas ; la file d'attente hors ligne du client
496
496
  retient les commandes, et un démarrage sans serveur se transforme en attente infinie plutôt qu'en
497
497
  échec lisible. D'où `applyResilienceDefaults()` (`defineModuleConfig.ts:65`), qui borne les tentatives
498
- à `DEV_DEFAULT_MAX_RETRIES` (`defineModuleConfig.ts:45`) — cinq — quand, et seulement quand,
498
+ à `DEV_DEFAULT_MAX_RETRIES` (`defineModuleConfig.ts:52`) — cinq — quand, et seulement quand,
499
499
  l'application ne s'est pas prononcée.
500
500
 
501
501
  | `NODE_ENV` | L'application fixe `maxRetries` ? | Valeur effective |
@@ -534,7 +534,7 @@ abonné ne peut plus émettre de commandes normales. Une connexion unique rendra
534
534
  stockage mutuellement exclusifs.
535
535
 
536
536
  Ajouter une connexion se fait en nommant une nouvelle clé. La fusion du manifeste est **profonde** —
537
- `loadModulesFromManifest()` (`Kernel.ts:1492`) fusionne la configuration de `use()` sous les défauts
537
+ `loadModulesFromManifest()` (`Kernel.ts:1656`) fusionne la configuration de `use()` sous les défauts
538
538
  déjà matérialisés du module — donc les trois connexions d'usine restent en place :
539
539
 
540
540
  ```ts ignore
@@ -611,7 +611,7 @@ Aucune ligne dans `nodefony.config.ts`. Le mot de passe voyage dans l'URL : trai
611
611
  secret entier, jamais comme une adresse.
612
612
 
613
613
  **La limite de forme à connaître** : le schéma n'expose qu'un **booléen** `tls`
614
- (`socketSchema` (`config.ts:114`)). Autorité de certification privée, certificat client, nom de
614
+ (`socketSchema` (`config.ts:79`)). Autorité de certification privée, certificat client, nom de
615
615
  serveur explicite — rien de tout cela n'est exprimable. Un service managé à certificat public
616
616
  fonctionne ; une authentification mutuelle par certificat n'est pas couverte par la configuration du
617
617
  module.
@@ -697,12 +697,12 @@ faire avant une mise en production.
697
697
  | Symptôme | Cause | Correction |
698
698
  | --- | --- | --- |
699
699
  | Une clé de configuration n'a aucun effet, aucune erreur | Clé inconnue du schéma : la validation Zod **écarte** les clés qu'elle ne connaît pas | Vérifier l'orthographe dans les tables ci-dessus ; contrôler la cible effective (§ Démarrage rapide) |
700
- | L'hôte configuré est ignoré | Une `url` est présente — `buildClientOptions()` (`buildClientOptions.ts:68`) ne pose plus host/port | Retirer `NF_REDIS_URL`/`REDIS_URL`, ou tout mettre dans l'URL |
701
- | `NF_REDIS_PORT` semble sans effet | Valeur non entière ou hors `1..65535` : `applyEnvOverrides()` (`defineModuleConfig.ts:32`) l'ignore | Corriger la valeur — l'ignorance est silencieuse par conception |
700
+ | L'hôte configuré est ignoré | Une `url` est présente — `buildClientOptions()` (`buildClientOptions.ts:45`) ne pose plus host/port | Retirer `NF_REDIS_URL`/`REDIS_URL`, ou tout mettre dans l'URL |
701
+ | `NF_REDIS_PORT` semble sans effet | Valeur non entière ou hors `1..65535` : `applyEnvOverrides()` (`defineModuleConfig.ts:24`) l'ignore | Corriger la valeur — l'ignorance est silencieuse par conception |
702
702
  | Toutes les connexions atterrissent sur la même base | L'URL porte un chemin (`…/2`) qui écrase le `database` de chaque connexion | Déclarer l'URL sans chemin et laisser `database` cloisonner |
703
703
  | Le démarrage pend, sans erreur, sans Redis | Tentatives illimitées : la première ouverture ne rend pas la main | Hors production c'est déjà borné (`applyResilienceDefaults()` (`defineModuleConfig.ts:65`)) ; sinon fixer une valeur finie |
704
704
  | Erreur `NOAUTH` alors que le mot de passe est configuré | L'URL porte des identifiants qui recouvrent `NF_REDIS_PASSWORD` | Ne pas mélanger : l'URL **ou** hôte + mot de passe |
705
- | Les sessions ont changé de magasin sans qu'on touche à la configuration | `NF_REDIS_URL` déclare une infra de cache → `resolveAutoStore()` (`infra.ts:241`) bascule les briques `auto` | Nommer le store explicitement pour un comportement identique partout |
705
+ | Les sessions ont changé de magasin sans qu'on touche à la configuration | `NF_REDIS_URL` déclare une infra de cache → `resolveAutoStore()` (`infra.ts:297`) bascule les briques `auto` | Nommer le store explicitement pour un comportement identique partout |
706
706
  | Une surcharge de connexion ramène le port à `6379` | Un schéma partiel qui réappliquerait ses défauts — d'où `socketOverrideSchema` (`config.ts:133`) sans défaut | Ne poser que les champs voulus ; les autres héritent du socket global |
707
707
  | Le module démarre mais n'ouvre rien | `enabled: false` — module chargé, inerte (`RedisService.init()` (`redis.ts:123`)) | Le réactiver, ou retirer le module du manifeste |
708
708
  | Le formulaire Studio annonce `maxRetries: 0` en développement | Le JSON Schema décrit le schéma, pas la superposition d'exécution | Lire la configuration effective du service |
@@ -749,7 +749,7 @@ rester pur.
749
749
  > **Une suite verte ne prouve rien du reste sans serveur Redis.** Les bancs d'intégration se
750
750
  > **skippent** quand l'infra manque, et un skip compte comme un succès : on peut lire « tout est
751
751
  > vert » sur une suite qui n'a rien exercé. La gate du module est déclarée une seule fois —
752
- > `REDIS_GATE` (`vitest.gates.ts:329`) — et la fin de run nomme la cible non exercée avec la commande
752
+ > `REDIS_GATE` (`vitest.gates.ts:339`) — et la fin de run nomme la cible non exercée avec la commande
753
753
  > exacte pour la satisfaire. **Les variables et la commande docker se lisent là, pas ici** : les
754
754
  > recopier dans cette page les condamnerait à diverger.
755
755
 
package/docs/index.md CHANGED
@@ -273,7 +273,7 @@ chose**.
273
273
  > [!IMPORTANT]
274
274
  > **Une suite verte ne prouve rien sans serveur Redis.** Les bancs d'intégration se **skippent** quand
275
275
  > l'infra manque, et un skip compte comme un succès : on peut lire « tout est vert » sur une suite qui
276
- > n'a rien exercé. Le module déclare donc sa gate — `REDIS_GATE` dans `vitest.gates.ts:329` — et la
276
+ > n'a rien exercé. Le module déclare donc sa gate — `REDIS_GATE` dans `vitest.gates.ts:339` — et la
277
277
  > fin de run nomme la cible non testée avec la commande exacte pour la satisfaire. **Lis ce bloc avant
278
278
  > de conclure.** Les variables et la commande docker viennent de là, pas de cette page : les recopier
279
279
  > ici les condamnerait à diverger.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nodefony/redis",
3
- "version": "10.0.0-alpha.8",
3
+ "version": "10.0.0-alpha.9",
4
4
  "description": "Connecteur Redis de Nodefony : dépôts clé-valeur, cache, sessions partagées et transport de diffusion entre instances",
5
5
  "nodefony": {
6
6
  "storeKind": "cache",
@@ -24,8 +24,8 @@
24
24
  },
25
25
  "scripts": {
26
26
  "start": "node dist/index.js",
27
- "build": "rimraf dist && rolldown -c rolldown.config.ts && tsgo -p tsconfig.declarations.json",
28
- "clean": "rimraf dist",
27
+ "build": "rolldown -c rolldown.config.ts && tsgo -p tsconfig.declarations.json",
28
+ "clean": "node --eval \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
29
29
  "dev": "rolldown -c rolldown.config.ts --watch",
30
30
  "test": "vitest run",
31
31
  "test:watch": "vitest",
@@ -51,20 +51,19 @@
51
51
  "tslib": "2.8.1"
52
52
  },
53
53
  "devDependencies": {
54
- "@nodefony/framework": "^10.0.0-alpha.8",
55
- "@nodefony/http": "^10.0.0-alpha.8",
56
- "@nodefony/security": "^10.0.0-alpha.8",
54
+ "@nodefony/framework": "^10.0.0-alpha.9",
55
+ "@nodefony/http": "^10.0.0-alpha.9",
56
+ "@nodefony/security": "^10.0.0-alpha.9",
57
57
  "@types/node": "26.6.2",
58
58
  "@vitest/coverage-v8": "5.0.1",
59
- "nodefony": "^10.0.0-alpha.8",
60
- "rimraf": "6.1.3",
59
+ "nodefony": "^10.0.0-alpha.9",
61
60
  "vitest": "5.0.1"
62
61
  },
63
62
  "peerDependencies": {
64
- "@nodefony/framework": "^10.0.0-alpha.8",
65
- "@nodefony/http": "^10.0.0-alpha.8",
66
- "@nodefony/security": "^10.0.0-alpha.8",
67
- "nodefony": "^10.0.0-alpha.8",
63
+ "@nodefony/framework": "^10.0.0-alpha.9",
64
+ "@nodefony/http": "^10.0.0-alpha.9",
65
+ "@nodefony/security": "^10.0.0-alpha.9",
66
+ "nodefony": "^10.0.0-alpha.9",
68
67
  "zod": "^4.6.5"
69
68
  },
70
69
  "repository": {