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

package/dist/_virtual/{_@oxc-project_runtime@0.148.0 → _@oxc-project_runtime@0.149.0}/helpers/esm/decorate.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.148.0/helpers/esm/decorate.js
+//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorate.js
 function __decorate(decorators, target, key, desc) {
 	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
 	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);

package/dist/_virtual/{_@oxc-project_runtime@0.148.0 → _@oxc-project_runtime@0.149.0}/helpers/esm/decorateMetadata.js

@@ -1,4 +1,4 @@
-//#region \0@oxc-project+runtime@0.148.0/helpers/esm/decorateMetadata.js
+//#region \0@oxc-project+runtime@0.149.0/helpers/esm/decorateMetadata.js
 function __decorateMetadata(k, v) {
 	if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }

package/dist/index.js

@@ -12,8 +12,8 @@ import { MongooseTokenStore } from "./nodefony/src/MongooseTokenStore.js";
 import { MongooseWebAuthnCredentialStore } from "./nodefony/src/MongooseWebAuthnCredentialStore.js";
 import { MongooseWebhookStore } from "./nodefony/src/MongooseWebhookStore.js";
 import { FRAMEWORK_CONNECTOR, registerMongooseFrameworkStores } from "./nodefony/registerStores.js";
-import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorateMetadata.js";
-import __decorate from "./_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorate.js";
+import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorateMetadata.js";
+import __decorate from "./_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
 import sessionEntity_default, { SESSION_CONNECTOR, sessionSchema as schema } from "./nodefony/entity/sessionEntity.js";
 import SessionStorage from "./nodefony/src/SessionStorage.js";
 import { createUserEntity, registerUserEntity, userSchema } from "./nodefony/entity/userEntity.js";

package/dist/nodefony/config/config.js

@@ -13,7 +13,7 @@ import { z } from "zod";
 * (`interfaces/IMongooseConfig.ts`) importent le schéma D'ICI (nœud bas : ce fichier
 * n'importe que `zod` → pas de cycle).
 *
-* Le type TS est dérivé via `z.infer<>` ({@link MongooseConfig}), et la config est
+* Le type TS est dérivé via `z.infer<>` ({@link IMongooseConfig}), et la config est
 * validée au boot du Module class (hook `onKernelRegister`, via le builder
 * {@link defineMongooseConfig}) → plante propre avec messages clairs si la config
 * est invalide, plutôt qu'un `undefined.x` silencieux en runtime.

package/dist/nodefony/entity/sessionEntity.js

@@ -1,4 +1,4 @@
-import __decorate from "../../_virtual/_@oxc-project_runtime@0.148.0/helpers/esm/decorate.js";
+import __decorate from "../../_virtual/_@oxc-project_runtime@0.149.0/helpers/esm/decorate.js";
 import { entity } from "@nodefony/orm-core";
 //#region nodefony/entity/sessionEntity.ts
 /** ORM cible du stockage de session (connecteur par défaut du module). */

package/dist/nodefony/registerStores.js

@@ -44,7 +44,7 @@ function resolveConnectedOrm(store) {
 		throw new Error(`${store} : ORM "${FRAMEWORK_CONNECTOR}" introuvable — charger @nodefony/mongoose AVANT @nodefony/security dans le manifeste "modules".`);
 	}
 	if (!(orm instanceof MongooseOrm)) throw new Error(`${store} : l'ORM "${FRAMEWORK_CONNECTOR}" n'est pas un MongooseOrm (connecteur homonyme d'un autre driver ?).`);
-	if (!orm.isConnected()) throw new Error(`${store} : ORM "${FRAMEWORK_CONNECTOR}" non connecté au montage du store (ordre de boot).`);
+	if (!orm.isConnected()) throw new Error(`${store} : ORM "${FRAMEWORK_CONNECTOR}" enregistré mais NON CONNECTÉ. Deux causes constatables : soit ce run n'a pas déclaré \`externalServices\` (une commande qui lit ou écrit des données le déclare via CONSOLE_DATA_RUN_PROFILE), soit le store a été demandé avant la connexion (ordre de boot). Un store "auto" n'atteint jamais ce point : seule une demande EXPLICITE le fait.`);
 	return orm;
 }
 /**

package/dist/nodefony/service/MongooseService.js

@@ -1,7 +1,7 @@
 import { MongooseOrm } from "../src/orm-core/MongooseOrm.js";
 import mongoose from "mongoose";
-import { Service } from "nodefony";
-import { queryFlowMonitor, resolveOrmFlowEnabled } from "@nodefony/orm-core";
+import { Service, runNeedsExternalServices } from "nodefony";
+import { diagnoseConnectionFailure, parseConnectionTarget, queryFlowMonitor, resolveOrmFlowEnabled } from "@nodefony/orm-core";
 //#region nodefony/service/MongooseService.ts
 const serviceName = "mongoose";
 /**
@@ -25,10 +25,7 @@ var MongooseService = class MongooseService extends Service {
 		this.module = module;
 		this.module.hookKernel("onBoot", async () => {
 			queryFlowMonitor.setEnabled(resolveOrmFlowEnabled(this.kernel));
-			await this.connectAll().catch((e) => {
-				this.log(e, "ERROR");
-				throw e;
-			});
+			await this.connectAll(runNeedsExternalServices(this.kernel));
 		});
 		this.kernel?.once("onTerminate", async () => {
 			await this.disconnectAll().catch(() => {});
@@ -38,12 +35,18 @@ var MongooseService = class MongooseService extends Service {
 	#config() {
 		return this.module.config;
 	}
-	/** Connecte tous les connecteurs déclarés en config (validée Zod). */
-	async connectAll() {
+	/**
+	* Connecte tous les connecteurs déclarés en config (validée Zod).
+	*
+	* @param connect - `false` pour ENREGISTRER les ORM sans ouvrir de connexion
+	*   (boot d'un run qui n'a pas déclaré `externalServices`). Défaut `true` :
+	*   un appel direct est un ordre.
+	*/
+	async connectAll(connect = true) {
 		const config = this.#config();
 		if (config?.debug) mongoose.set("debug", true);
 		const connectors = config?.connectors ?? {};
-		for (const [name, cfg] of Object.entries(connectors)) await this.#connectOne(name, cfg);
+		for (const [name, cfg] of Object.entries(connectors)) await this.#connectOne(name, cfg, connect);
 	}
 	/** Assemble l'URI de connexion à partir de la config (`uri` ou composants). */
 	static buildUri(cfg) {
@@ -74,10 +77,21 @@ var MongooseService = class MongooseService extends Service {
 		};
 	}
 	/** Connecte un connecteur (URI + options d'auth/pool). */
-	async #connectOne(name, cfg) {
+	async #connectOne(name, cfg, connect = true) {
 		const uri = MongooseService.buildUri(cfg);
 		const orm = new MongooseOrm(name, uri, MongooseService.buildConnectOptions(cfg));
-		await orm.connect();
+		if (!connect) {
+			this.#orms.set(name, orm);
+			this.log(`Mongoose « ${name} » enregistré SANS connexion (${orm.safeTarget()}) — ce run n'a pas déclaré \`externalServices\`.`, "DEBUG");
+			return;
+		}
+		try {
+			await orm.connect();
+		} catch (e) {
+			const diagnosis = diagnoseConnectionFailure(e, parseConnectionTarget(uri));
+			const cause = e instanceof Error ? e.message : String(e);
+			throw new Error(`Mongoose : le connecteur "${name}" (${orm.safeTarget()}) n'a pas pu se connecter — ${diagnosis.explanation} Cause : ${cause}`, { cause: e });
+		}
 		this.#orms.set(name, orm);
 		this.log(`Mongoose ORM "${name}" connected (${orm.safeTarget()})`, "INFO");
 	}

package/dist/types/index.d.ts

@@ -51,7 +51,7 @@ declare class Mongoose extends Module<IMongooseConfig> {
 export default Mongoose;
 export { mongoose, MongooseService };
 export { defineMongooseConfig, mongooseConfigJsonSchema };
-export { mongooseConfigSchema, type MongooseConfig, } from "./nodefony/config/config.js";
+export { mongooseConfigSchema } from "./nodefony/config/config.js";
 export type { IMongooseConfig, IMongooseConfigInput, IMongooseConnectorConfig, } from "./nodefony/interfaces/IMongooseConfig.js";
 export { default as SessionStorage } from "./nodefony/src/SessionStorage.js";
 export { default as SessionEntity, sessionSchema, SESSION_CONNECTOR, } from "./nodefony/entity/sessionEntity.js";

package/dist/types/nodefony/config/config.d.ts

@@ -12,10 +12,10 @@ export declare const mongooseConfigSchema: z.ZodObject<{
     frameworkEntities: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$strict>;
 /** Type de sortie (config normalisée + défauts appliqués). */
-export type MongooseConfig = z.infer<typeof mongooseConfigSchema>;
+export type IMongooseConfig = z.infer<typeof mongooseConfigSchema>;
 /**
  * Défauts du module, matérialisés depuis le schéma (source unique). Toujours
  * valides par construction ; passés au `super(..., config)` du Module class.
  */
-declare const config: MongooseConfig;
+declare const config: IMongooseConfig;
 export default config;

package/dist/types/nodefony/service/MongooseService.d.ts

@@ -19,8 +19,14 @@ declare class MongooseService extends Service {
     #private;
     module: Module;
     constructor(module: Module);
-    /** Connecte tous les connecteurs déclarés en config (validée Zod). */
-    connectAll(): Promise<void>;
+    /**
+     * Connecte tous les connecteurs déclarés en config (validée Zod).
+     *
+     * @param connect - `false` pour ENREGISTRER les ORM sans ouvrir de connexion
+     *   (boot d'un run qui n'a pas déclaré `externalServices`). Défaut `true` :
+     *   un appel direct est un ordre.
+     */
+    connectAll(connect?: boolean): Promise<void>;
     /** Assemble l'URI de connexion à partir de la config (`uri` ou composants). */
     static buildUri(cfg: IMongooseConnectorConfig): string;
     /**

package/docs/configuration.md

@@ -109,7 +109,7 @@ Le schéma (`mongooseConfigSchema` (`config.ts:83`)) porte les valeurs d'usine s
 `.default(…)`, et chaque champ son `.describe(…)`. Les défauts effectifs du module ne sont pas
 retapés à la main : ils sont **matérialisés depuis le schéma lui-même**
 (`mongooseConfigSchema.parse({})` (`config.ts:122`)). Changer un défaut = changer le `.default()`,
-et nulle part ailleurs. Le type TypeScript suit le même chemin : `MongooseConfig` (`config.ts:116`)
+et nulle part ailleurs. Le type TypeScript suit le même chemin : `IMongooseConfig` (`config.ts:131`)
 est **inféré** du schéma, jamais redéclaré.
 
 Le builder (`defineMongooseConfig()` (`defineModuleConfig.ts:61`)) tient en trois gestes — valider,
@@ -267,7 +267,7 @@ ainsi qu'une application lit une base métier et écrit dans une base d'archives
 L'adresse se donne de deux façons, jamais les deux à la fois utilement :
 
 - **En pièces détachées** — `host`, `port`, `dbname` : lisible, adapté au développement. Le service
-  les assemble en `mongodb://hôte:port/base` (`MongooseService.buildUri()` (`MongooseService.ts:76`)).
+  les assemble en `mongodb://hôte:port/base` (`MongooseService.buildUri()` (`MongooseService.ts:94`)).
 - **En une URI** — `uri` (`config.ts:41`) : la seule forme capable d'exprimer un replica set, un
   `mongodb+srv`, des options de requête. **Dès qu'`uri` est présent, les trois autres champs ne sont
   plus lus du tout.**
@@ -320,7 +320,7 @@ description des options du driver.
 
 ### `debug` — voir passer les requêtes
 
-`debug` (`config.ts:85`) active la trace intégrée de Mongoose (`connectAll()` (`MongooseService.ts:63`)).
+`debug` (`config.ts:85`) active la trace intégrée de Mongoose (`connectAll()` (`MongooseService.ts:81`)).
 Chaque opération part sur la sortie standard, avec sa collection, son filtre et ses champs.
 
 C'est un **réglage de processus, pas de connecteur** : il vaut pour toutes les connexions à la fois.
@@ -405,7 +405,7 @@ NF__MONGOOSE__CONNECTORS__NODEFONY__DBNAME=recette    # champ imbriqué
 NF__MONGOOSE__CONNECTORS__NODEFONY__PORT=27018        # coercé en nombre
 ```
 
-Ces overrides sont posés **avant** la validation Zod (`Kernel.applyEnvConfigOverrides()` (`Kernel.ts:1600`)) :
+Ces overrides sont posés **avant** la validation Zod (`Kernel.applyEnvConfigOverrides()` (`Kernel.ts:1708`)) :
 une valeur aberrante est donc rejetée comme si tu l'avais écrite dans ton fichier. C'est voulu — un
 réglage d'environnement invalide doit casser aussi fort qu'un réglage de code.
 
@@ -436,7 +436,7 @@ De la plus faible à la plus forte priorité :
 
 1. **Les défauts du schéma** — `localhost:27017/nodefony`, `debug: false`, `frameworkEntities: true`.
 2. **Ta config d'app** — `use("@nodefony/mongoose", { … })`, fusionnée en profondeur sous les défauts
-   (`Kernel.loadModulesFromManifest()` (`Kernel.ts:1150`)).
+   (`Kernel.loadModulesFromManifest()` (`Kernel.ts:1600`)).
 3. **Un override venu d'un autre module** — la clé `module-mongoose` dans la config d'un module tiers.
 4. **`NF__MONGOOSE__…`** — l'override générique d'environnement.
 5. **La validation Zod** — types, bornes, défauts des champs restés absents.
@@ -549,9 +549,9 @@ use("@nodefony/mongoose", {
 ```
 
 Les deux connexions s'ouvrent en série au démarrage, dans l'ordre de déclaration
-(`connectAll()` (`MongooseService.ts:63`)), et se ferment toutes à l'arrêt
-(`disconnectAll()` (`MongooseService.ts:134`)). Un service peut demander l'une ou l'autre par son nom
-(`getOrm()` (`MongooseService.ts:142`)), mais l'usage courant reste le registre d'ORM.
+(`connectAll()` (`MongooseService.ts:81`)), et se ferment toutes à l'arrêt
+(`disconnectAll()` (`MongooseService.ts:181`)). Un service peut demander l'une ou l'autre par son nom
+(`getOrm()` (`MongooseService.ts:189`)), mais l'usage courant reste le registre d'ORM.
 
 ## 🔐 Le secret de connexion
 
@@ -665,7 +665,7 @@ coûteux à diagnostiquer qu'un serveur qui refuse de démarrer.
 
 Le cas courant : la config est parfaite, mais Mongo n'est pas joignable — conteneur pas encore prêt,
 réseau coupé, identifiants périmés. Le comportement **dépend de l'environnement**, arbitré par la
-politique de boot du cœur (`Kernel.isBootErrorFatal()` (`Kernel.ts:2665`)) :
+politique de boot du cœur (`Kernel.isBootErrorFatal()` (`Kernel.ts:2757`)) :
 
 | Environnement       | Ce qui se passe                                                                        |
 | ------------------- | -------------------------------------------------------------------------------------- |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodefony/mongoose",
-  "version": "10.0.0-alpha.2",
+  "version": "10.0.0-alpha.4",
   "description": "Moteur MongoDB de Nodefony sur Mongoose : dépôts typés conformes au contrat orm-core",
   "nodefony": {
     "storeKind": "durable",
@@ -52,22 +52,22 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@nodefony/http": "^10.0.0-alpha.2",
-    "@nodefony/orm-core": "^10.0.0-alpha.2",
-    "@nodefony/security": "^10.0.0-alpha.2",
-    "@nodefony/user": "^10.0.0-alpha.2",
+    "@nodefony/http": "^10.0.0-alpha.4",
+    "@nodefony/orm-core": "^10.0.0-alpha.4",
+    "@nodefony/security": "^10.0.0-alpha.4",
+    "@nodefony/user": "^10.0.0-alpha.4",
     "@types/node": "26.4.1",
     "mongodb-memory-server": "11.2.0",
-    "nodefony": "^10.0.0-alpha.2",
+    "nodefony": "^10.0.0-alpha.4",
     "rimraf": "6.1.3",
     "vitest": "5.0.0"
   },
   "peerDependencies": {
-    "@nodefony/http": "^10.0.0-alpha.2",
-    "@nodefony/orm-core": "^10.0.0-alpha.2",
-    "@nodefony/security": "^10.0.0-alpha.2",
-    "@nodefony/user": "^10.0.0-alpha.2",
-    "nodefony": "^10.0.0-alpha.2"
+    "@nodefony/http": "^10.0.0-alpha.4",
+    "@nodefony/orm-core": "^10.0.0-alpha.4",
+    "@nodefony/security": "^10.0.0-alpha.4",
+    "@nodefony/user": "^10.0.0-alpha.4",
+    "nodefony": "^10.0.0-alpha.4"
   },
   "repository": {
     "type": "git",