@nodefony/redis 10.0.0-beta.1 → 10.0.0-beta.2

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
@@ -10,7 +10,7 @@ sessions, files d'attente, compteurs, verrous, pub/sub — c'est vous qui décid
10
10
 
11
11
  ## Installation
12
12
 
13
- Module workspace du monorepo Nodefony. Déclaré dans `@modules()` racine.
13
+ Module workspace du monorepo Nodefony. Déclaré dans le manifeste `modules` de `nodefony.config.ts`.
14
14
 
15
15
  ```bash
16
16
  docker compose -f docker/docker-compose.yml up -d # Redis 7, password "nodefony-dev"
@@ -53,13 +53,14 @@ export default {
53
53
 
54
54
  ### Variables d'environnement
55
55
 
56
- | Variable | Effet |
57
- | ------------------- | -------------------------------------------------------- |
58
- | `NF_REDIS_URL` | URL complète `redis[s]://…` — **la forme qui l'emporte** |
59
- | `REDIS_URL` | même effet, alias posé par les hébergeurs — lu en SECOND |
60
- | `NF_REDIS_HOST` | hôte du serveur |
61
- | `NF_REDIS_PORT` | port (validé) |
62
- | `NF_REDIS_PASSWORD` | mot de passe (jamais committé) |
56
+ | Variable | Effet |
57
+ | ------------------------ | -------------------------------------------------------- |
58
+ | `NF_REDIS_URL` | URL complète `redis[s]://…` — **la forme qui l'emporte** |
59
+ | `REDIS_URL` | même effet, alias posé par les hébergeurs — lu en SECOND |
60
+ | `NF_REDIS_HOST` | hôte du serveur |
61
+ | `NF_REDIS_PORT` | port (validé) |
62
+ | `NF_REDIS_PASSWORD` | mot de passe (jamais committé) |
63
+ | `NF_REDIS_KEY_NAMESPACE` | cloison des clés de cette application (prioritaire) |
63
64
 
64
65
  Si les deux URL sont posées, **`NF_REDIS_URL` gagne** : c'est votre réglage, il passe
65
66
  devant celui que la plateforme d'hébergement a injecté.
@@ -1,4 +1,4 @@
1
- //#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorate.js
1
+ //#region \0@oxc-project+runtime@0.152.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.151.0/helpers/esm/decorateMetadata.js
1
+ //#region \0@oxc-project+runtime@0.152.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.151.0/helpers/esm/decorateMetadata.js";
8
- import __decorate from "./_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
7
+ import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.152.0/helpers/esm/decorateMetadata.js";
8
+ import __decorate from "./_virtual/_@oxc-project_runtime@0.152.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";
@@ -191,7 +191,8 @@ class RedisDiagnosticController extends Controller {
191
191
  const main = redis?.getConnection("main");
192
192
  const client = redis?.getClient("main");
193
193
 
194
- const cle = `nf:sess:${session.id}`;
194
+ // Le préfixe porte la cloison de l'application : `nf:<app>:sess` (`keyPrefix()`).
195
+ const cle = `${redis?.keyPrefix("nf:sess")}:${session.id}`;
195
196
  // -2 = clé absente, -1 = clé sans TTL (anomalie ici), n > 0 = secondes restantes.
196
197
  const ttl = client && main?.connected ? await client.ttl(cle) : -2;
197
198
 
@@ -223,11 +224,11 @@ Puis, côté requête :
223
224
  ```bash
224
225
  curl -s -c cookies.txt http://127.0.0.1:5151/diagnostic/redis/session
225
226
  # {"connexions":["main","publish","subscribe"],"mainConnectee":true,
226
- # "cle":"nf:sess:9f2c…","ttlSecondes":1800}
227
+ # "cle":"nf:mon-app:sess:9f2c…","ttlSecondes":1800}
227
228
 
228
229
  # La même clé, vue du serveur — le TTL est bien porté par Redis lui-même.
229
- redis-cli TTL nf:sess:9f2c… # (integer) 1800
230
- redis-cli TYPE nf:sess:9f2c… # string
230
+ redis-cli TTL nf:mon-app:sess:9f2c… # (integer) 1800
231
+ redis-cli TYPE nf:mon-app:sess:9f2c… # string
231
232
  ```
232
233
 
233
234
  Rejoue la requête après quelques secondes : le TTL est **remonté à 1800**. C'est le timeout glissant,
@@ -319,6 +320,11 @@ exclusifs. Le module tranche par la topologie : `main` pour les commandes, `publ
319
320
  Le module n'écrit rien. Ce qui suit appartient aux quatre stores et au backplane. Le tableau donne la
320
321
  vue d'ensemble ; les fiches détaillent les choix qui surprennent.
321
322
 
323
+ > [!NOTE]
324
+ > Les préfixes sont donnés **sans la cloison** de l'application, pour la lisibilité. Une application
325
+ > nommée les reçoit cloisonnés : `nf:sess` devient `nf:<application>:sess` (`RedisService.keyPrefix()`,
326
+ > `redis.ts:105`), la cloison venant de `keyNamespace` ou, à défaut, du nom du projet.
327
+
322
328
  | Clé | Structure | Durée de vie | Écrit par |
323
329
  | --------------------------- | -------------- | --------------------------------------------- | ----------------------------------------------- |
324
330
  | `nf:sess:<id>` | STRING (JSON) | TTL = idle, reposé à chaque écriture/touch | `RedisSessionStorage` |
@@ -479,29 +485,18 @@ partent ; si la stratégie abandonne, elles sont rejetées.
479
485
  `Connection.connected` repasse à `false` — mais **`Connection.client` reste affecté**. C'est le point
480
486
  suivant.
481
487
 
482
- ### Moment 3 — le garde `if (!client)` et ce qu'il ne couvre pas
483
-
484
- Tous les stores commencent par le même geste : demander le client, et se replier s'il vaut `null`. Ce
485
- garde ne se déclenche que dans deux situations exactes :
486
-
487
- - **avant** l'initialisation du service — la carte des connexions vaut encore `null` ;
488
- - **après** `RedisService.closeConnections()` (`redis.ts:243`), qui remet la carte à `null`.
488
+ ### Moment 3 — le garde `if (!client)`, et ce qu'il couvre
489
489
 
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:76`) et que `Connection.create()` affecte son client
492
- avant de le connecter (`Connection.ts:86`), `getClient("main")` rend alors un client **non nul et
493
- fermé**. La commande part donc, et la bibliothèque la rejette :
494
-
495
- ```
496
- ClientClosedError: The client is closed
497
- ```
490
+ Tous les stores commencent par le même geste : demander le client, et se replier s'il vaut `null`.
491
+ `RedisService.getClient()` (`redis.ts:218`) rend `null` dès que le socket **n'est pas ouvert** :
492
+ avant l'initialisation, après `RedisService.closeConnections()`, mais aussi après un `connect()` raté
493
+ — la connexion reste inscrite dans la carte avec un client jamais ouvert, et c'est l'ouverture
494
+ (`isOpen`), pas la présence, qui est testée. Pendant une reconnexion, en revanche, le socket est
495
+ ouvert : les commandes attendent dans la file hors ligne de la bibliothèque.
498
496
 
499
- > [!CAUTION]
500
- > Le repli documenté par les stores (« la connexion n'est pas ou plus ouverte → no-op ») décrit le
501
- > comportement du démarrage et de l'arrêt, **pas celui d'un incident**. Un Redis injoignable au
502
- > démarrage laisse une connexion fermée dans la carte : les stores ne se replient pas, ils propagent
503
- > l'erreur du client. Tester votre application « Redis éteint » consiste donc à l'éteindre **après**
504
- > le démarrage _et_ à la démarrer sans lui — les deux chemins ne sont pas les mêmes.
497
+ L'indisponibilité est **journalisée à la transition** : un `WARNING` « connexion indisponible » à la
498
+ première bascule (pas un par appel), puis un `INFO` « rétablie » quand la connexion revient.
499
+ `client-availability.test.ts` verrouille les trois comportements.
505
500
 
506
501
  ### Moment 4 — l'arrêt
507
502
 
@@ -521,9 +516,9 @@ L'ordre compte : les écouteurs sont retirés même si la fermeture échoue.
521
516
  | Démarrage du module en échec | non critique → agrégé au rapport, « démarrage DÉGRADÉ » | ✅ superviseur |
522
517
  | Perte de connexion en cours de vie | `ERROR` / `WARNING` / `INFO` + événements réémis | ✅ journal + événements |
523
518
  | Commande pendant la reconnexion | file d'attente hors ligne, puis envoi ou rejet | ✅ l'appelant reçoit le rejet |
524
- | Commande sur une connexion jamais ouverte | `ClientClosedError` propagé jusqu'à l'appelant | ✅ bruyant (mais pas le repli annoncé) |
525
- | Écriture de session, client `null` | **no-op muet** — la session n'est pas persistée, rien n'est journalisé | ❌ **silencieux** |
526
- | Écriture de jeton / passkey, client `null` | **no-op muet** | ❌ **silencieux** |
519
+ | Commande sur une connexion jamais ouverte | `getClient` → `null`, repli du store | ✅ `WARNING` à la transition |
520
+ | Écriture de session, client `null` | no-op — la session n'est pas persistée | ✅ annoncé au journal (transition) |
521
+ | Écriture de jeton / passkey, client `null` | no-op | ✅ annoncé au journal (transition) |
527
522
  | Backplane : module ou connexions absents | `WARNING` nommant la cause, hub laissé en local | ✅ modèle du genre |
528
523
  | Idempotence : `redis` demandé, module absent | échec franc au démarrage | ✅ fail-loud |
529
524
 
@@ -567,7 +562,7 @@ Redis rend **toutes** les clés d'un coup, quel que soit le `COUNT` demandé. Un
567
562
  alors la `limit` et violerait le contrat.
568
563
 
569
564
  D'où un curseur de la forme `"<déjà consommé>:<curseur Redis>"`, encodé par `encodeCursor()`
570
- (`SessionStorage.ts:33`). Quand un lot contient plus d'éléments que la page, le store n'en rend que
565
+ (`scanCursor.ts`). Quand un lot contient plus d'éléments que la page, le store n'en rend que
571
566
  `limit`, mémorise combien de clés du lot ont été consommées, et la page suivante **rejoue le même
572
567
  `SCAN`** pour reprendre à la bonne position. Le coût est un re-parcours du lot courant, payé
573
568
  uniquement sur un chemin d'administration. Les trois stores partagent ce mécanisme, à l'identique.
@@ -579,26 +574,23 @@ uniquement sur un chemin d'administration. Les trois stores partagent ce mécani
579
574
  > serveur qui a révélé le débordement. Sans `NF_REDIS_TEST_URL`, les bancs de pagination passent au vert
580
575
  > **sans avoir testé la seule chose que ce code résout**.
581
576
 
582
- ### Une asymétrie sur les curseurs hostiles
577
+ ### Les curseurs hostiles
583
578
 
584
579
  Le curseur arrive de l'extérieur (chaîne de requête d'un écran d'administration, client qui rejoue une
585
580
  page) : il n'est pas digne de confiance. Un curseur `SCAN` valide est toujours une suite de chiffres.
586
581
 
587
- Le store de session s'en protège : `scanOrZero()` (`scanCursor.ts:68`) impose le format et retombe
588
- sur `"0"` sinon — repartir du début est faux au pire d'une page, transmettre une valeur arbitraire
589
- échoue à coup sûr. Les stores de jetons (`RedisTokenStore.ts:35`) et de passkeys
590
- (`RedisWebAuthnCredentialStore.ts:31`) ne font **pas** cette validation : ils transmettent le curseur
591
- tel quel, et Redis rejette la commande. Un paramètre malformé y transforme une simple consultation en
592
- erreur.
582
+ Les trois stores s'en protègent par la même règle : `decodeCursor()` puis `scanOrZero()`
583
+ (`scanCursor.ts:68`) imposent le format et retombent sur `"0"` sinon — repartir du début est faux au
584
+ pire d'une page, transmettre une valeur arbitraire échouerait à coup sûr.
593
585
 
594
586
  ### Les vidages complets
595
587
 
596
588
  À côté de la pagination, deux méthodes déversent tout. `RedisSessionStorage.listAll()`
597
589
  (`SessionStorage.ts:181`) est **plafonnée** à un maximum de clés parcourues et journalise un
598
590
  `WARNING` quand elle tronque — listing partiel signalé, jamais silencieux.
599
- `RedisTokenStore.listAll()` (`RedisTokenStore.ts:378`), en revanche, boucle jusqu'à la fin du
600
- keyspace sans plafond : à grande échelle, préférez la pagination ou le système de référence SQL pour
601
- la gouvernance.
591
+ `RedisTokenStore.listAll()` (`RedisTokenStore.ts:378`) l'est aussi, à `MAX_SCAN` clés, avec le même
592
+ `WARNING` de listing partiel : à grande échelle, préférez la pagination ou le système de référence
593
+ SQL pour la gouvernance.
602
594
 
603
595
  Redaction : la page de sessions vide explicitement les sacs de données métier avant de sortir
604
596
  (`SessionStorage.ts:296`) — un enregistrement d'administration ne transporte jamais le contenu
@@ -651,19 +643,17 @@ surfacé par les écrans transverses ci-dessus.
651
643
 
652
644
  ## ⚠️ Pièges (symptôme → cause → correction)
653
645
 
654
- | Symptôme | Cause (dans le code) | Correction |
655
- | ------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
656
- | `ClientClosedError` alors que le store « dégrade en douceur » | Connexion posée dans `#connections` avant ouverture (`redis.ts:75`) → client non nul mais fermé | Traiter Redis comme faillible côté appelant ; surveiller le journal de démarrage |
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
- | 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
- | 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: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
- | 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:196`) | Paginer par curseur, pas par décalage |
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
- | 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
- | 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) |
646
+ | Symptôme | Cause (dans le code) | Correction |
647
+ | -------------------------------------------------------- | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
648
+ | 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`) |
649
+ | 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`) |
650
+ | 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`) |
651
+ | 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 |
652
+ | L'écran d'administration n'affiche aucun total | `countSessions` / `countTokens` rendent `-1` (comptage O(N) refusé) | Afficher « inconnu » ; ne jamais inventer un total |
653
+ | Un `offset` envoyé n'a aucun effet | Le mode curseur ne lit que `cursor` (`SessionStorage.ts:196`) | Paginer par curseur, pas par décalage |
654
+ | Des passkeys disparaissent | Politique d'éviction Redis (`allkeys-lru`) sur des clés **sans** TTL | `noeviction` + persistance sur l'instance qui porte les passkeys |
655
+ | 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 |
656
+ | 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) |
667
657
 
668
658
  ## 🧪 Tests & couverture
669
659
 
@@ -680,9 +670,9 @@ cette prose. Ce qui doit être dit ici, c'est **ce qui est prouvé, et par quoi*
680
670
 
681
671
  **Ce qui manque, et qu'il faut savoir :**
682
672
 
683
- - **Aucun test n'exerce la perte de connexion en cours de vie.** Le banc de robustesse simule un
684
- client `null` — un état que le service n'atteint qu'avant l'initialisation ou après la fermeture. Le
685
- chemin réellement emprunté lors d'un incident (client fermé, non nul) n'est couvert nulle part.
673
+ - **La perte de connexion en cours de vie n'est exercée que par son effet sur `getClient`**
674
+ (`client-availability.test.ts`) : une coupure réelle d'un serveur Redis pendant le trafic n'a pas
675
+ de banc dédié.
686
676
  - **La branche de reprise du curseur composite n'est atteinte qu'avec un serveur réel** (voir plus
687
677
  haut) : le double ne déborde jamais.
688
678
  - **Pas de banc de charge ni de test de mémoire dédiés** dans ce module — voir le skill
@@ -28,7 +28,7 @@ coverageModule: redis
28
28
  # Configuration de @nodefony/redis
29
29
 
30
30
  > Une seule question à trancher : **quelle machine Redis, et comment y entrer**. Tout le reste a un
31
- > défaut sûr. Cette page donne la liste complète des clés avec leur valeur d'usine réelle, les quatre
31
+ > défaut sûr. Cette page donne la liste complète des clés avec leur valeur d'usine réelle, les cinq
32
32
  > variables d'environnement et l'ordre exact dans lequel elles gagnent, puis six situations de
33
33
  > déploiement — du poste de développement au service managé chiffré. Ce que le module fait _dedans_
34
34
  > avec ces valeurs (cycle des connexions, reconnexion, dégradation) est décrit par la page voisine,
@@ -391,7 +391,7 @@ connections: {
391
391
 
392
392
  ## Variables d'environnement et ordre de précédence
393
393
 
394
- ### Les quatre variables lues
394
+ ### Les cinq variables lues
395
395
 
396
396
  Toutes sont appliquées **après** la validation, par `applyEnvOverrides()`
397
397
  (`defineModuleConfig.ts:23`).
@@ -402,6 +402,7 @@ Toutes sont appliquées **après** la validation, par `applyEnvOverrides()`
402
402
  | `NF_REDIS_HOST` | `globalOptions.socket.host` | Posée telle quelle, sans validation supplémentaire. |
403
403
  | `NF_REDIS_PORT` | `globalOptions.socket.port` | **Ignorée en silence** si ce n'est pas un entier de `1` à `65535`. |
404
404
  | `NF_REDIS_PASSWORD` | `globalOptions.password` | Le seul chemin recommandé pour le secret : jamais dans un fichier versionné. |
405
+ | `NF_REDIS_KEY_NAMESPACE` | `keyNamespace` | Prioritaire sur la config ; cloison de déploiement. |
405
406
 
406
407
  `REDIS_URL` est accepté comme **alias de plateforme** parce que c'est le nom que posent la plupart des
407
408
  hébergeurs. Quand les deux existent, la variable préfixée gagne — le préfixe `NF_` sert précisément à
@@ -686,8 +687,8 @@ C'est un défaut de configuration : rien à chercher côté réseau.
686
687
  même, en état dégradé annoncé. Chaque connexion est tentée indépendamment et journalisée en `ERROR`
687
688
  par `RedisService.init()` (`redis.ts:123`) : une connexion en échec n'empêche pas les suivantes.
688
689
 
689
- Ce que ce démarrage dégradé implique côté appelants — pourquoi le garde `if (!client)` des stores ne
690
- suffit pas après une ouverture ratée, ce que devient une commande pendant une reconnexion — est
690
+ Ce que ce démarrage dégradé implique côté appelants — pourquoi le garde `if (!client)` des stores couvre
691
+ aussi une ouverture ratée, ce que devient une commande pendant une reconnexion — est
691
692
  détaillé dans [Architecture interne](./architecture.md), section « Résilience ». C'est la lecture à
692
693
  faire avant une mise en production.
693
694
 
@@ -696,7 +697,7 @@ faire avant une mise en production.
696
697
  <!-- prettier-ignore -->
697
698
  | Symptôme | Cause | Correction |
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
+ | Le démarrage échoue avec `configuration invalide — <chemin>` | Clé inconnue (faute de frappe) : le schéma est strict | Corriger l'orthographe d'après les tables ci-dessus |
700
701
  | 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
702
  | `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
703
  | 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 |
@@ -707,7 +708,6 @@ faire avant une mise en production.
707
708
  | 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
709
  | 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 |
709
710
  | Une valeur changée à chaud ne prend pas | La configuration est **gelée** après le démarrage (`defineRedisConfig()` (`defineModuleConfig.ts:103`)) | Redémarrer le process |
710
- | L'auto-complétion ne propose aucune clé dans `use()` | Le module ne s'inscrit pas au registre de types des configurations de modules | S'appuyer sur les tables de cette page ; une clé fautive ne sera pas signalée à la compilation |
711
711
 
712
712
  ## 📡 Observabilité — Studio
713
713
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nodefony/redis",
3
- "version": "10.0.0-beta.1",
3
+ "version": "10.0.0-beta.2",
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",
@@ -47,23 +47,23 @@
47
47
  "esm"
48
48
  ],
49
49
  "dependencies": {
50
- "redis": "6.2.1",
50
+ "redis": "6.3.0",
51
51
  "tslib": "2.8.1"
52
52
  },
53
53
  "devDependencies": {
54
- "@nodefony/framework": "^10.0.0-beta.1",
55
- "@nodefony/http": "^10.0.0-beta.1",
56
- "@nodefony/security": "^10.0.0-beta.1",
54
+ "@nodefony/framework": "^10.0.0-beta.2",
55
+ "@nodefony/http": "^10.0.0-beta.2",
56
+ "@nodefony/security": "^10.0.0-beta.2",
57
57
  "@types/node": "26.6.3",
58
- "@vitest/coverage-v8": "5.0.2",
59
- "nodefony": "^10.0.0-beta.1",
60
- "vitest": "5.0.2"
58
+ "@vitest/coverage-v8": "5.0.3",
59
+ "nodefony": "^10.0.0-beta.2",
60
+ "vitest": "5.0.3"
61
61
  },
62
62
  "peerDependencies": {
63
- "@nodefony/framework": "^10.0.0-beta.1",
64
- "@nodefony/http": "^10.0.0-beta.1",
65
- "@nodefony/security": "^10.0.0-beta.1",
66
- "nodefony": "^10.0.0-beta.1",
63
+ "@nodefony/framework": "^10.0.0-beta.2",
64
+ "@nodefony/http": "^10.0.0-beta.2",
65
+ "@nodefony/security": "^10.0.0-beta.2",
66
+ "nodefony": "^10.0.0-beta.2",
67
67
  "zod": "^4.6.5"
68
68
  },
69
69
  "repository": {