@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 +9 -8
- package/dist/_virtual/{_@oxc-project_runtime@0.151.0 → _@oxc-project_runtime@0.152.0}/helpers/esm/decorate.js +1 -1
- package/dist/_virtual/{_@oxc-project_runtime@0.151.0 → _@oxc-project_runtime@0.152.0}/helpers/esm/decorateMetadata.js +1 -1
- package/dist/index.js +2 -2
- package/docs/architecture.md +45 -55
- package/docs/configuration.md +6 -6
- package/package.json +12 -12
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
|
|
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
|
|
57
|
-
|
|
|
58
|
-
| `NF_REDIS_URL`
|
|
59
|
-
| `REDIS_URL`
|
|
60
|
-
| `NF_REDIS_HOST`
|
|
61
|
-
| `NF_REDIS_PORT`
|
|
62
|
-
| `NF_REDIS_PASSWORD`
|
|
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.
|
|
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.
|
|
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.
|
|
8
|
-
import __decorate from "./_virtual/_@oxc-project_runtime@0.
|
|
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";
|
package/docs/architecture.md
CHANGED
|
@@ -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
|
-
|
|
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)
|
|
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
|
-
|
|
491
|
-
|
|
492
|
-
avant
|
|
493
|
-
|
|
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
|
-
|
|
500
|
-
|
|
501
|
-
|
|
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 | `
|
|
525
|
-
| Écriture de session, client `null` |
|
|
526
|
-
| Écriture de jeton / passkey, client `null` |
|
|
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
|
-
(`
|
|
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
|
-
###
|
|
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
|
-
|
|
588
|
-
sur `"0"` sinon — repartir du début est faux au
|
|
589
|
-
|
|
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`)
|
|
600
|
-
|
|
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
|
|
655
|
-
|
|
|
656
|
-
|
|
|
657
|
-
|
|
|
658
|
-
|
|
|
659
|
-
|
|
|
660
|
-
|
|
|
661
|
-
|
|
|
662
|
-
|
|
|
663
|
-
|
|
|
664
|
-
|
|
|
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
|
-
- **
|
|
684
|
-
client
|
|
685
|
-
|
|
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
|
package/docs/configuration.md
CHANGED
|
@@ -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
|
|
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
|
|
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
|
|
690
|
-
|
|
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
|
-
|
|
|
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.
|
|
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.
|
|
50
|
+
"redis": "6.3.0",
|
|
51
51
|
"tslib": "2.8.1"
|
|
52
52
|
},
|
|
53
53
|
"devDependencies": {
|
|
54
|
-
"@nodefony/framework": "^10.0.0-beta.
|
|
55
|
-
"@nodefony/http": "^10.0.0-beta.
|
|
56
|
-
"@nodefony/security": "^10.0.0-beta.
|
|
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.
|
|
59
|
-
"nodefony": "^10.0.0-beta.
|
|
60
|
-
"vitest": "5.0.
|
|
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.
|
|
64
|
-
"@nodefony/http": "^10.0.0-beta.
|
|
65
|
-
"@nodefony/security": "^10.0.0-beta.
|
|
66
|
-
"nodefony": "^10.0.0-beta.
|
|
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": {
|