@nodefony/redis 10.0.0-alpha.2 → 10.0.0-alpha.4

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.148.0/helpers/esm/decorate.js
1
+ //#region \0@oxc-project+runtime@0.149.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.148.0/helpers/esm/decorateMetadata.js
1
+ //#region \0@oxc-project+runtime@0.149.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.148.0/helpers/esm/decorateMetadata.js";
8
- import __decorate from "./_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorate.js";
7
+ import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
8
+ import __decorate from "./_virtual/_@oxc-project_runtime@0.149.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";
@@ -1,5 +1,6 @@
1
1
  import { RedisTokenStore } from "./src/RedisTokenStore.js";
2
2
  import { RedisWebAuthnCredentialStore } from "./src/RedisWebAuthnCredentialStore.js";
3
+ import { durableStoreRemedy, runNeedsExternalServices } from "nodefony";
3
4
  import { getTokenStoreFactory, getWebAuthnStoreFactory, registerTokenStore, registerWebAuthnStore } from "@nodefony/security";
4
5
  //#region nodefony/registerStores.ts
5
6
  /**
@@ -20,6 +21,8 @@ import { getTokenStoreFactory, getWebAuthnStoreFactory, registerTokenStore, regi
20
21
  function resolveRedisService(store, container) {
21
22
  const service = container?.get?.("redis") ?? null;
22
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;
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.`);
23
26
  return service;
24
27
  }
25
28
  /**
@@ -1,7 +1,7 @@
1
1
  import Connection from "../src/Connection.js";
2
2
  import { buildClientOptions } from "../src/buildClientOptions.js";
3
3
  import { resolveKeyPrefix } from "../src/keyNamespace.js";
4
- import { Nodefony, Service } from "nodefony";
4
+ import { Nodefony, Service, runNeedsExternalServices } from "nodefony";
5
5
  //#region nodefony/service/redis.ts
6
6
  const serviceName = "redis";
7
7
  /**
@@ -85,6 +85,20 @@ var RedisService = class extends Service {
85
85
  * Ouvre toutes les connexions déclarées dans la config (si `enabled`).
86
86
  * Appelé par le cycle de vie du Module. Une connexion en échec est loguée
87
87
  * sans bloquer les autres (résilience boot).
88
+ *
89
+ * 🔴 **C'est le BOOT qui décide, pas `createConnection`.** Un run qui ne
90
+ * déclare pas `externalServices` — `nodefony inspect`, `build`, toute commande
91
+ * en ligne qui ne lit ni n'écrit de données — n'ouvre AUCUNE socket ici, même
92
+ * avec `NF_REDIS_URL` posé dans l'environnement d'un pod. Appelée
93
+ * explicitement, `createConnection` reste un ORDRE et n'est jamais gardée :
94
+ * la garder ferait échouer un appelant qui a précisément demandé la connexion.
95
+ * Symétrique de `DrizzleService`, qui interroge la même fonction au même
96
+ * moment de son cycle. [[feedback_single_source_rule]]
97
+ *
98
+ * **Sans kernel, la garde ne s'applique pas** : il n'y a alors PAS de boot —
99
+ * personne n'a de profil d'exécution —, donc `init()` n'est plus « ce que le
100
+ * boot fait de lui-même » mais un ORDRE, au même titre que `createConnection`.
101
+ * C'est le cas d'un service instancié à la main (banc, script, outil).
88
102
  */
89
103
  async init() {
90
104
  const config = this.#resolveConfig();
@@ -92,6 +106,11 @@ var RedisService = class extends Service {
92
106
  this.log("Module Redis désactivé (enabled=false) — 0 connexion", "INFO");
93
107
  return this;
94
108
  }
109
+ const kernel = this.module.kernel;
110
+ if (kernel && !runNeedsExternalServices(kernel)) {
111
+ this.log("Ce run ne déclare pas `externalServices` — 0 connexion Redis ouverte (une commande qui lit ou écrit des données le déclare via CONSOLE_DATA_RUN_PROFILE). La config, elle, n'est pas en cause.", "INFO");
112
+ return this;
113
+ }
95
114
  for (const name in config.connections) try {
96
115
  await this.createConnection(name);
97
116
  } catch (e) {
@@ -45,7 +45,7 @@ export default Redis;
45
45
  export { RedisService, redis };
46
46
  export { default as RedisSessionStorage } from "./nodefony/src/SessionStorage.js";
47
47
  export { defineRedisConfig, redisConfigJsonSchema };
48
- export { redisConfigSchema, type RedisConfig } from "./nodefony/config/config.js";
48
+ export { redisConfigSchema } from "./nodefony/config/config.js";
49
49
  export type { IRedisConfig, IRedisConfigInput, IRedisConnectionConfig, } from "./nodefony/interfaces/IRedisConfig.js";
50
50
  export { RedisTokenStore } from "./nodefony/src/RedisTokenStore.js";
51
51
  export type { RedisClientLike } from "./nodefony/src/RedisTokenStore.js";
@@ -32,10 +32,10 @@ export declare const redisConfigSchema: z.ZodObject<{
32
32
  }, z.core.$strict>>>;
33
33
  }, z.core.$strict>;
34
34
  /** Type de sortie (config normalisée + défauts appliqués). */
35
- export type RedisConfig = z.infer<typeof redisConfigSchema>;
35
+ export type IRedisConfig = z.infer<typeof redisConfigSchema>;
36
36
  /**
37
37
  * Défauts du module, matérialisés depuis le schéma (source unique). Toujours
38
38
  * valides par construction ; passés au `super(..., config)` du Module class.
39
39
  */
40
- declare const config: RedisConfig;
40
+ declare const config: IRedisConfig;
41
41
  export default config;
@@ -42,6 +42,20 @@ declare class RedisService extends Service {
42
42
  * Ouvre toutes les connexions déclarées dans la config (si `enabled`).
43
43
  * Appelé par le cycle de vie du Module. Une connexion en échec est loguée
44
44
  * sans bloquer les autres (résilience boot).
45
+ *
46
+ * 🔴 **C'est le BOOT qui décide, pas `createConnection`.** Un run qui ne
47
+ * déclare pas `externalServices` — `nodefony inspect`, `build`, toute commande
48
+ * en ligne qui ne lit ni n'écrit de données — n'ouvre AUCUNE socket ici, même
49
+ * avec `NF_REDIS_URL` posé dans l'environnement d'un pod. Appelée
50
+ * explicitement, `createConnection` reste un ORDRE et n'est jamais gardée :
51
+ * la garder ferait échouer un appelant qui a précisément demandé la connexion.
52
+ * Symétrique de `DrizzleService`, qui interroge la même fonction au même
53
+ * moment de son cycle. [[feedback_single_source_rule]]
54
+ *
55
+ * **Sans kernel, la garde ne s'applique pas** : il n'y a alors PAS de boot —
56
+ * personne n'a de profil d'exécution —, donc `init()` n'est plus « ce que le
57
+ * boot fait de lui-même » mais un ORDRE, au même titre que `createConnection`.
58
+ * C'est le cas d'un service instancié à la main (banc, script, outil).
45
59
  */
46
60
  init(): Promise<this>;
47
61
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@nodefony/redis",
3
- "version": "10.0.0-alpha.2",
3
+ "version": "10.0.0-alpha.4",
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,20 +51,20 @@
51
51
  "tslib": "2.8.1"
52
52
  },
53
53
  "devDependencies": {
54
- "@nodefony/framework": "^10.0.0-alpha.2",
55
- "@nodefony/http": "^10.0.0-alpha.2",
56
- "@nodefony/security": "^10.0.0-alpha.2",
54
+ "@nodefony/framework": "^10.0.0-alpha.4",
55
+ "@nodefony/http": "^10.0.0-alpha.4",
56
+ "@nodefony/security": "^10.0.0-alpha.4",
57
57
  "@types/node": "26.4.1",
58
58
  "@vitest/coverage-v8": "5.0.0",
59
- "nodefony": "^10.0.0-alpha.2",
59
+ "nodefony": "^10.0.0-alpha.4",
60
60
  "rimraf": "6.1.3",
61
61
  "vitest": "5.0.0"
62
62
  },
63
63
  "peerDependencies": {
64
- "@nodefony/framework": "^10.0.0-alpha.2",
65
- "@nodefony/http": "^10.0.0-alpha.2",
66
- "@nodefony/security": "^10.0.0-alpha.2",
67
- "nodefony": "^10.0.0-alpha.2",
64
+ "@nodefony/framework": "^10.0.0-alpha.4",
65
+ "@nodefony/http": "^10.0.0-alpha.4",
66
+ "@nodefony/security": "^10.0.0-alpha.4",
67
+ "nodefony": "^10.0.0-alpha.4",
68
68
  "zod": "^4.4.3"
69
69
  },
70
70
  "repository": {