@nodefony/redis 10.0.0-alpha.9 → 10.0.0-beta.1

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.
@@ -19,9 +19,9 @@ import { getTokenStoreFactory, getWebAuthnStoreFactory, registerTokenStore, regi
19
19
  */
20
20
  /** Résout le service redis du container — échec FRANC avec la cause exacte. */
21
21
  function resolveRedisService(store, container) {
22
- const service = container?.get?.("redis") ?? null;
22
+ const service = container?.get("redis") ?? null;
23
23
  if (!service) throw new Error(`${store} : service "redis" introuvable — le module @nodefony/redis est-il chargé (manifeste "modules") ?`);
24
- const kernel = service.module?.kernel ?? null;
24
+ const kernel = service.module.kernel ?? null;
25
25
  if (kernel && !runNeedsExternalServices(kernel)) throw new Error(`${store} : demandé EXPLICITEMENT dans un run qui n'ouvre aucune connexion. Le store serait créé sans client Redis : ses écritures seraient perdues et ses lectures rendraient vide, SANS erreur. ${durableStoreRemedy(false)} Un store "auto" n'atteint jamais ce point — il bascule en mémoire, véridiquement et avec sa raison ; seule une demande EXPLICITE arrive ici.`);
26
26
  return service;
27
27
  }
@@ -31,11 +31,11 @@ function resolveRedisService(store, container) {
31
31
  */
32
32
  function registerRedisFrameworkStores() {
33
33
  if (!getTokenStoreFactory("redis")) registerTokenStore("redis", (ctx) => {
34
- const service = resolveRedisService(`tokenStore "redis"`, ctx?.container);
35
- const days = ctx?.config?.tokenStore?.retentionRevokedDays;
34
+ const service = resolveRedisService(`tokenStore "redis"`, ctx.container);
35
+ const days = ctx.config.tokenStore.retentionRevokedDays;
36
36
  return RedisTokenStore.from(service, void 0, typeof days === "number" ? days * 864e5 : void 0);
37
37
  });
38
- if (!getWebAuthnStoreFactory("redis")) registerWebAuthnStore("redis", (ctx) => RedisWebAuthnCredentialStore.from(resolveRedisService(`passkeys.store "redis"`, ctx?.container)));
38
+ if (!getWebAuthnStoreFactory("redis")) registerWebAuthnStore("redis", (ctx) => RedisWebAuthnCredentialStore.from(resolveRedisService(`passkeys.store "redis"`, ctx.container)));
39
39
  }
40
40
  //#endregion
41
41
  export { registerRedisFrameworkStores };
@@ -132,7 +132,7 @@ var RedisService = class extends Service {
132
132
  if (!definition) throw new Error(`${this.name} connection "${name}" undefined in config`);
133
133
  const options = buildClientOptions(config, definition);
134
134
  const conn = new Connection(name, options, this);
135
- if (this.#connections === null) this.#connections = Object.create(null);
135
+ this.#connections ??= Object.create(null);
136
136
  this.#connections[name] = conn;
137
137
  await conn.create();
138
138
  this.fire("connection", conn.client, conn);
@@ -171,7 +171,7 @@ var RedisService = class extends Service {
171
171
  }
172
172
  return client;
173
173
  }
174
- if (!this.#unavailable) this.#unavailable = /* @__PURE__ */ new Set();
174
+ this.#unavailable ??= /* @__PURE__ */ new Set();
175
175
  if (!this.#unavailable.has(name)) {
176
176
  this.#unavailable.add(name);
177
177
  this.log(`connexion "${name}" indisponible (${client ? "socket fermé" : "jamais ouverte"}) — les consommateurs de cette connexion dégradent tant qu'elle ne revient pas`, "WARNING");
@@ -181,8 +181,8 @@ var RedisService = class extends Service {
181
181
  /** Ferme toutes les connexions ouvertes (idempotent). */
182
182
  async closeConnections() {
183
183
  if (!this.#connections) return;
184
- for (const name in this.#connections) try {
185
- await this.#connections[name].close();
184
+ for (const connection of Object.values(this.#connections)) try {
185
+ await connection.close();
186
186
  } catch (e) {
187
187
  this.log(e, "ERROR");
188
188
  }
@@ -83,7 +83,7 @@ var RedisTokenStore = class RedisTokenStore {
83
83
  }
84
84
  /** Préfixe effectif des clés, cloisonné par application (mémoïsé). */
85
85
  #prefix() {
86
- if (this.#prefixCache === null) this.#prefixCache = this.#resolvePrefix();
86
+ this.#prefixCache ??= this.#resolvePrefix();
87
87
  return this.#prefixCache;
88
88
  }
89
89
  #client() {
@@ -116,7 +116,7 @@ var RedisTokenStore = class RedisTokenStore {
116
116
  #encode(record) {
117
117
  const h = {};
118
118
  const put = (k, v) => {
119
- if (v !== null && v !== void 0) h[k] = String(v);
119
+ if (v !== null) h[k] = String(v);
120
120
  };
121
121
  put("id", record.id);
122
122
  put("kind", record.kind);
@@ -146,21 +146,22 @@ var RedisTokenStore = class RedisTokenStore {
146
146
  }
147
147
  /** Désérialise un HASH en record (`null` pour les champs absents). */
148
148
  #decode(h) {
149
- const str = (k) => k in h ? h[k] : null;
149
+ const str = (k) => h[k] ?? null;
150
150
  const num = (k) => k in h ? Number(h[k]) : null;
151
+ const req = (k) => h[k] ?? "";
151
152
  return {
152
- id: h.id,
153
+ id: req("id"),
153
154
  kind: h.kind,
154
- name: h.name,
155
+ name: req("name"),
155
156
  prefix: str("prefix"),
156
- subjectId: h.subjectId,
157
+ subjectId: req("subjectId"),
157
158
  subjectType: h.subjectType,
158
159
  tenantId: str("tenantId"),
159
160
  scopes: h.scopes ? JSON.parse(h.scopes) : [],
160
161
  audience: h.audience ? JSON.parse(h.audience) : [],
161
162
  resources: h.resources ? JSON.parse(h.resources) : null,
162
- secretHash: h.secretHash,
163
- hashAlg: h.hashAlg,
163
+ secretHash: req("secretHash"),
164
+ hashAlg: req("hashAlg"),
164
165
  clientId: str("clientId"),
165
166
  cnf: str("cnf"),
166
167
  family: str("family"),
@@ -253,7 +254,7 @@ var RedisTokenStore = class RedisTokenStore {
253
254
  MATCH: match,
254
255
  COUNT: 200
255
256
  });
256
- cursor = String(res.cursor);
257
+ cursor = res.cursor;
257
258
  for (const key of res.keys) {
258
259
  const h = await client.hGetAll(key);
259
260
  if (Object.keys(h).length > 0) out.push(this.#decode(h));
@@ -290,7 +291,7 @@ var RedisTokenStore = class RedisTokenStore {
290
291
  MATCH: `${this.#prefix()}:rec:*`,
291
292
  COUNT: limit
292
293
  });
293
- const next = String(res.cursor);
294
+ const next = res.cursor;
294
295
  const now = this.#now();
295
296
  const items = [];
296
297
  let consumed = 0;
@@ -58,7 +58,7 @@ var RedisWebAuthnCredentialStore = class RedisWebAuthnCredentialStore {
58
58
  }
59
59
  /** Préfixe effectif des clés, cloisonné par application (mémoïsé). */
60
60
  #prefix() {
61
- if (this.#prefixCache === null) this.#prefixCache = this.#resolvePrefix();
61
+ this.#prefixCache ??= this.#resolvePrefix();
62
62
  return this.#prefixCache;
63
63
  }
64
64
  #client() {
@@ -89,10 +89,11 @@ var RedisWebAuthnCredentialStore = class RedisWebAuthnCredentialStore {
89
89
  }
90
90
  /** Désérialise un HASH en credential (`lastUsedAt`/`nickname` absents → `null`/omis). */
91
91
  #decode(h) {
92
+ const req = (k) => h[k] ?? "";
92
93
  return {
93
- id: h.id,
94
- userId: h.userId,
95
- publicKey: h.publicKey,
94
+ id: req("id"),
95
+ userId: req("userId"),
96
+ publicKey: req("publicKey"),
96
97
  signCount: Number(h.signCount),
97
98
  transports: h.transports ? JSON.parse(h.transports) : [],
98
99
  backupEligible: h.backupEligible === "1",
@@ -194,7 +195,7 @@ var RedisWebAuthnCredentialStore = class RedisWebAuthnCredentialStore {
194
195
  MATCH: `${this.#prefix()}:cred:*`,
195
196
  COUNT: limit
196
197
  });
197
- const next = String(res.cursor);
198
+ const next = res.cursor;
198
199
  const items = [];
199
200
  let consumed = 0;
200
201
  for (const key of res.keys.slice(skip)) {
@@ -45,7 +45,7 @@ var RedisSessionStorage = class {
45
45
  * à la construction du storage).
46
46
  */
47
47
  #client() {
48
- if (!this.#service) this.#service = this.manager.get("redis") ?? null;
48
+ this.#service ??= this.manager.get("redis") ?? null;
49
49
  return this.#service?.getClient("main") ?? null;
50
50
  }
51
51
  /**
@@ -81,7 +81,10 @@ var RedisSessionStorage = class {
81
81
  updatedAt: now
82
82
  };
83
83
  const client = this.#client();
84
- if (client) await client.set(this.#key(id), JSON.stringify(payload), { EX: this.idleTimeoutS });
84
+ if (client) await client.set(this.#key(id), JSON.stringify(payload), { expiration: {
85
+ type: "EX",
86
+ value: this.idleTimeoutS
87
+ } });
85
88
  return payload;
86
89
  }
87
90
  async open() {
@@ -189,7 +192,7 @@ var RedisSessionStorage = class {
189
192
  MATCH: `${this.#prefix()}:*`,
190
193
  COUNT: limit
191
194
  });
192
- const next = String(res.cursor);
195
+ const next = res.cursor;
193
196
  const prefixLen = this.#prefix().length + 1;
194
197
  const items = [];
195
198
  let consumed = 0;
@@ -50,11 +50,11 @@ function buildClientOptions(config, connection) {
50
50
  ...connection.socket
51
51
  };
52
52
  options.socket = {
53
- host: socket.host,
54
- port: socket.port,
55
- family: socket.family,
56
- connectTimeout: socket.connectTimeout,
57
- tls: socket.tls === true ? true : void 0,
53
+ ...socket.host !== void 0 && { host: socket.host },
54
+ ...socket.port !== void 0 && { port: socket.port },
55
+ ...socket.family !== void 0 && { family: socket.family },
56
+ ...socket.connectTimeout !== void 0 && { connectTimeout: socket.connectTimeout },
57
+ ...socket.tls && { tls: true },
58
58
  reconnectStrategy
59
59
  };
60
60
  return options;
@@ -127,7 +127,7 @@ service par la chaîne `"redis"` dans le conteneur, jamais par un `import`. `Red
127
127
  `import type`, effacé à la compilation. Résultat, aucune dépendance runtime ne circule entre l'infra
128
128
  et la sécurité, dans aucun sens — et le graphe de modules reste acyclique.
129
129
 
130
- **Charger le module suffit.** `Redis.onKernelRegister()` (`index.ts:54`) valide la configuration puis
130
+ **Charger le module suffit.** `Redis.onKernelRegister()` (`index.ts:64`) valide la configuration puis
131
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'à
@@ -290,7 +290,7 @@ démarrage raté, la connexion existe, le client existe — mais il est fermé.
290
290
  Prenons une lecture de session. Elle traverse exactement quatre gestes :
291
291
 
292
292
  1. Le store résout le service **paresseusement**, au premier accès seulement :
293
- `RedisSessionStorage.#client()` (`SessionStorage.ts:96`) mémorise le service puis demande
293
+ `RedisSessionStorage.#client()` (`SessionStorage.ts:89`) mémorise le service puis demande
294
294
  `getClient("main")` à chaque appel. La résolution tardive est nécessaire — l'ordre de démarrage
295
295
  des modules n'est pas garanti, le store est construit avant que Redis soit prêt.
296
296
  2. `RedisService.getClient()` (`redis.ts:220`) rend le client de la connexion nommée, ou `null`.
@@ -340,7 +340,7 @@ pose **systématiquement** un `EX` : une clé de session sans TTL serait une ses
340
340
  défaut de sécurité, pas une commodité.
341
341
 
342
342
  L'expiration par inactivité (« idle ») est donc portée par Redis lui-même. Deux conséquences
343
- directes : `gc()` (`SessionStorage.ts:168`) est un **no-op** assumé — aucun balayage, aucune requête
343
+ directes : `gc()` (`SessionStorage.ts:151`) est un **no-op** assumé — aucun balayage, aucune requête
344
344
  de purge périodique — et `touch()` (`SessionStorage.ts:166`) se réduit à un `EXPIRE`, en O(1), **sans
345
345
  réécrire la valeur**. C'est le renouvellement le moins coûteux de tous les backends de session.
346
346
 
@@ -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:3943`) enveloppe l'appel dans un délai maximal de
453
+ le temps** : `Kernel.guardInitialize()` (`Kernel.ts:4043`) 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
 
@@ -485,7 +485,7 @@ Tous les stores commencent par le même geste : demander le client, et se replie
485
485
  garde ne se déclenche que dans deux situations exactes :
486
486
 
487
487
  - **avant** l'initialisation du service — la carte des connexions vaut encore `null` ;
488
- - **après** `RedisService.closeConnections()` (`redis.ts:247`), qui remet la carte à `null`.
488
+ - **après** `RedisService.closeConnections()` (`redis.ts:243`), 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
491
  `#connections` avant d'être ouverte (`redis.ts:76`) et que `Connection.create()` affecte son client
@@ -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:247`). `closeConnections()` (`redis.ts:247`) ferme chaque connexion, avale et journalise les
509
+ (`redis.ts:243`). `closeConnections()` (`redis.ts:243`) 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`).
@@ -635,7 +635,7 @@ 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:241`), qui journalise aussi la décision au format « `auto` → `redis` (infra
638
+ (`sessions-service.ts:258`), qui journalise aussi la décision au format « `auto` → `redis` (infra
639
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
@@ -643,7 +643,7 @@ c'est la contrepartie assumée de la séparation imposée par le protocole.
643
643
  haut, rendue visible.
644
644
  - **Carte du module** (`/nodefony/modules/redis`) : documentation, symboles, tests, couverture, et la
645
645
  configuration validée. Le formulaire est dérivé du JSON Schema publié par `Redis.configSchema()`
646
- (`index.ts:43`), jamais écrit à la main.
646
+ (`index.ts:53`), jamais écrit à la main.
647
647
 
648
648
  Le module **n'expose pas** de plan de données propre (`/nodefony/redis/api/*`) : il n'a ni état
649
649
  métier ni introspection spécifique. Ce qui compte de lui — quelles connexions, quel store gagne — est
@@ -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:1656`) fusionne la configuration de `use()` sous les défauts
537
+ `loadModulesFromManifest()` (`Kernel.ts:1714`) 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
@@ -671,18 +671,18 @@ Mieux vaut le savoir en concevant l'infrastructure qu'en la déployant.
671
671
  Deux échecs très différents partagent le même symptôme apparent — « Redis ne marche pas » — et se
672
672
  règlent à des endroits opposés.
673
673
 
674
- **La configuration est invalide.** `Redis.onKernelRegister()` (`index.ts:54`) valide avant tout le
674
+ **La configuration est invalide.** `Redis.onKernelRegister()` (`index.ts:64`) valide avant tout le
675
675
  reste et refuse de démarrer sur une valeur hors bornes. Le message nomme le champ fautif
676
676
  (`index.ts:68`) :
677
677
 
678
678
  ```
679
- [@nodefony/redis] Invalid config: globalOptions.socket.port: Too big: expected number to be <=65535
679
+ [@nodefony/redis] configuration invalide — globalOptions.socket.port : Too big: expected number to be <=65535
680
680
  ```
681
681
 
682
682
  C'est un défaut de configuration : rien à chercher côté réseau.
683
683
 
684
684
  **Le serveur ne répond pas.** La configuration est bonne, l'ouverture échoue. Le module est déclaré
685
- **non critique** — `Redis.critical` (`index.ts:36`) vaut `false` — donc l'application démarre quand
685
+ **non critique** — `Redis.critical` (`index.ts:46`) vaut `false` — donc l'application démarre quand
686
686
  même, en état dégradé annoncé. Chaque connexion est tentée indépendamment et journalisée en `ERROR`
687
687
  par `RedisService.init()` (`redis.ts:123`) : une connexion en échec n'empêche pas les suivantes.
688
688
 
@@ -712,7 +712,7 @@ faire avant une mise en production.
712
712
  ## 📡 Observabilité — Studio
713
713
 
714
714
  - **Carte du module** (`/nodefony/modules/redis`) : la configuration validée, rendue par un formulaire
715
- **dérivé** du JSON Schema que publie `Redis.configSchema()` (`index.ts:43`). Les champs marqués
715
+ **dérivé** du JSON Schema que publie `Redis.configSchema()` (`index.ts:53`). Les champs marqués
716
716
  secrets — `url`, `password` — y sont masqués par construction, pas par une liste d'exclusion tenue
717
717
  à la main.
718
718
  - **Écran Stores** (`/nodefony/stores`) : pour chaque brique, le store réellement retenu au démarrage
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nodefony/redis",
3
- "version": "10.0.0-alpha.9",
3
+ "version": "10.0.0-beta.1",
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",
@@ -51,19 +51,19 @@
51
51
  "tslib": "2.8.1"
52
52
  },
53
53
  "devDependencies": {
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
- "@types/node": "26.6.2",
58
- "@vitest/coverage-v8": "5.0.1",
59
- "nodefony": "^10.0.0-alpha.9",
60
- "vitest": "5.0.1"
54
+ "@nodefony/framework": "^10.0.0-beta.1",
55
+ "@nodefony/http": "^10.0.0-beta.1",
56
+ "@nodefony/security": "^10.0.0-beta.1",
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"
61
61
  },
62
62
  "peerDependencies": {
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",
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",
67
67
  "zod": "^4.6.5"
68
68
  },
69
69
  "repository": {