@nodefony/drizzle 10.0.0-alpha.1 → 10.0.0-alpha.3

package/dist/nodefony/command/migrateShared.js

@@ -4,7 +4,7 @@ import { missingHistoryColumn } from "../src/migrator/history.js";
 import { buildMigrator, readMigrationEnv, resolveConnector } from "../src/migrator/resolve.js";
 import { MigrationToolError, describeResolutionRefusal, moduleAbsent } from "../src/migrator/refusals.js";
 import { composeReport } from "../src/migrator/status.js";
-import { Command, resolveColorEnabled } from "nodefony";
+import { CONSOLE_DATA_RUN_PROFILE, Command, resolveColorEnabled } from "nodefony";
 //#region nodefony/command/migrateShared.ts
 /**
 * Socle commun des commandes `orm:*` — ce qui garantit qu'aucune d'elles ne
@@ -42,6 +42,20 @@ const MODULE_NAME = "drizzle";
 * différence entre un outil qu'on sait utiliser et un outil qu'on subit.
 */
 var OrmMigrateCommand = class extends Command {
+	/**
+	* Toutes les commandes `orm:*` parlent à la base — c'est leur définition.
+	*
+	* Déclaré ICI et pas dans le littéral d'options de chacune : la déclaration
+	* appartient à la FAMILLE, et une famille qui se déclare six fois finit par
+	* oublier la septième — l'oubli serait alors muet (la commande démarrerait
+	* sans connexion et ne trouverait pas de quoi migrer). Posé après `super()`,
+	* qui a déjà lu `options.runProfile` : une commande qui veut un profil autre
+	* peut donc encore le passer dans ses options, et il gagne.
+	*/
+	constructor(...args) {
+		super(...args);
+		this.runProfile ??= { ...CONSOLE_DATA_RUN_PROFILE };
+	}
 	/**
 	* Faut-il colorer la sortie ?
 	*

package/dist/nodefony/service/DrizzleService.js

@@ -7,8 +7,8 @@ import { describeDivergence } from "../src/migrator/divergence.js";
 import { DrizzleOrm } from "../src/orm-core/DrizzleOrm.js";
 import "../src/orm-core/index.js";
 import { dataLoss, renderDestructive, scanDestructive, summarizeDestructive } from "../src/migrator/destructive.js";
-import { BootConfigurationError, Service } from "nodefony";
-import { queryFlowMonitor, resolveOrmFlowEnabled } from "@nodefony/orm-core";
+import { BootConfigurationError, Service, runNeedsExternalServices } from "nodefony";
+import { diagnoseConnectionFailure, parseConnectionTarget, queryFlowMonitor, resolveOrmFlowEnabled } from "@nodefony/orm-core";
 import fs from "node:fs";
 import path from "node:path";
 //#region nodefony/service/DrizzleService.ts
@@ -84,7 +84,7 @@ var DrizzleService = class extends Service {
 		this.module = module;
 		this.module.hookKernel("onBoot", async () => {
 			queryFlowMonitor.setEnabled(resolveOrmFlowEnabled(this.kernel));
-			await this.connectAll().catch((e) => {
+			await this.connectAll(runNeedsExternalServices(this.kernel)).catch((e) => {
 				this.log(e, "ERROR");
 				throw e;
 			});
@@ -98,10 +98,17 @@ var DrizzleService = class 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.
+	*   Réservé au boot d'un run qui n'a pas déclaré `externalServices` : l'ORM
+	*   doit exister (c'est lui qui publie le plan d'administration) sans qu'un
+	*   socket ne s'ouvre. Le défaut `true` fait de l'appel direct un ordre.
+	*/
+	async connectAll(connect = true) {
 		const connectors = this.#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);
 	}
 	/**
 	* Chemin SQLite par défaut d'un connecteur, résolu AU BOOT (kernel présent —
@@ -116,7 +123,7 @@ var DrizzleService = class extends Service {
 		return defaultConnectorFilename(this.kernel, name);
 	}
 	/** Connecte un connecteur (crée le dossier de la base SQLite si nécessaire). */
-	async #connectOne(name, cfg) {
+	async #connectOne(name, cfg, connect = true) {
 		const dialect = cfg.dialect ?? "sqlite";
 		const ddl = resolveDdlMode(cfg.ddl, readMigrationEnv(this.kernel));
 		let filename;
@@ -146,11 +153,20 @@ var DrizzleService = class extends Service {
 			}
 		});
 		const target = dialect === "sqlite" ? filename : redactUrl(cfg.url);
+		if (!connect) {
+			this.#orms.set(name, orm);
+			this.log(`Drizzle « ${name} » enregistré SANS connexion (${dialect}: ${target}) — ce run n'a pas déclaré \`externalServices\`. Une commande qui lit ou écrit des données le déclare via son \`runProfile\` (CONSOLE_DATA_RUN_PROFILE).`, "DEBUG");
+			return;
+		}
 		try {
 			await orm.connect();
 		} catch (e) {
 			const cause = e instanceof Error ? e.message : String(e);
-			throw new BootConfigurationError(`Drizzle : le connecteur "${name}" (${dialect}: ${target}) n'a pas pu se connecter — corriger la configuration (infra déclarée NF_DATABASE_URL/connectors, base démarrée ?, entités portées sur ce dialecte ?) ou la retirer. Cause : ${cause}`, { cause: e });
+			const diagnosis = diagnoseConnectionFailure(e, dialect === "sqlite" ? {
+				host: null,
+				port: null
+			} : parseConnectionTarget(cfg.url));
+			throw new BootConfigurationError(`Drizzle : le connecteur "${name}" (${dialect}: ${target}) n'a pas pu se connecter — ${diagnosis.explanation} Si l'adresse est la bonne, vérifier l'infrastructure déclarée (NF_DATABASE_URL / connectors) et que les entités sont portées sur ce dialecte, ou retirer le connecteur. Cause : ${cause}`, { cause: e });
 		}
 		this.#orms.set(name, orm);
 		this.log(`Drizzle « ${name} » connecté (${dialect}: ${target}) — schéma : ${ddl} ${DDL_EXPLAINED[ddl]}`, "INFO");

package/dist/nodefony/src/orm-core/DrizzleOrm.js

@@ -6,7 +6,7 @@ import { failureFrom } from "../migrator/status.js";
 import { DrizzleRepository } from "./DrizzleRepository.js";
 import { DrizzleTransaction } from "./DrizzleTransaction.js";
 import { createRequire } from "node:module";
-import { Orm, entityRegistry } from "@nodefony/orm-core";
+import { CONNECT_TIMEOUT_MS, Orm, entityRegistry, parseConnectionTarget, withConnectDeadline } from "@nodefony/orm-core";
 import fs from "node:fs";
 import path from "node:path";
 import { is } from "drizzle-orm";
@@ -50,6 +50,22 @@ function renderCheck(check, dialect) {
 * Trappe SQL brut : {@link DrizzleOrm.getNativeConnection} expose le db Drizzle
 * (tag `sql`) pour les jointures arbitraires (ADR-0003 risque #1).
 */
+/**
+* L'adresse visée, écrite pour un humain et SANS son secret.
+*
+* Une URL de connexion porte le mot de passe : la recopier telle quelle dans
+* un message d'erreur le publie dans les journaux. `parseConnectionTarget` ne
+* rend que l'hôte et le port — c'est tout ce dont on a besoin pour aller voir
+* qui écoute.
+*
+* @param url - l'URL du connecteur, si elle existe.
+* @returns `hôte:port`, ou une désignation neutre quand l'URL ne dit rien.
+*/
+function describeTarget(url) {
+	const { host, port } = parseConnectionTarget(url);
+	if (host && port !== null) return `${host}:${port}`;
+	return host ?? "configuré";
+}
 var DrizzleOrm = class DrizzleOrm extends Orm {
 	#client = null;
 	/**
@@ -598,11 +614,13 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 		const pool = new PoolCtor({
 			connectionString: this.#url,
 			keepAlive: true,
-			keepAliveInitialDelayMillis: 1e4
+			keepAliveInitialDelayMillis: 1e4,
+			connectionTimeoutMillis: CONNECT_TIMEOUT_MS,
+			query_timeout: CONNECT_TIMEOUT_MS
 		});
 		this.#wirePgLifecycle(pool);
 		try {
-			await pool.query("SELECT 1");
+			await withConnectDeadline(pool.query("SELECT 1"), `la réponse de postgres ${describeTarget(this.#url)}`);
 		} catch (e) {
 			this.#unwireAll();
 			await pool.end().catch(() => void 0);
@@ -778,14 +796,15 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 				uri: this.#url,
 				timezone: "Z",
 				enableKeepAlive: true,
-				keepAliveInitialDelay: 1e4
+				keepAliveInitialDelay: 1e4,
+				connectTimeout: CONNECT_TIMEOUT_MS
 			});
 			this.#wireMysqlLifecycle(pool);
 		} catch (e) {
 			throw new Error(`DrizzleOrm "${this.name}": the mysql dialect needs the optional driver \`mysql2\` (run \`npm i mysql2\`). ${e.message}`, { cause: e });
 		}
 		try {
-			await pool.query("SELECT 1");
+			await withConnectDeadline(pool.query("SELECT 1"), `la réponse de mysql ${describeTarget(this.#url)}`);
 		} catch (e) {
 			this.#unwireAll();
 			await pool.end().catch(() => void 0);

package/dist/types/nodefony/command/migrateShared.d.ts

@@ -21,6 +21,17 @@ export interface IMigrateSharedOptions {
  * différence entre un outil qu'on sait utiliser et un outil qu'on subit.
  */
 export declare abstract class OrmMigrateCommand extends Command {
+    /**
+     * Toutes les commandes `orm:*` parlent à la base — c'est leur définition.
+     *
+     * Déclaré ICI et pas dans le littéral d'options de chacune : la déclaration
+     * appartient à la FAMILLE, et une famille qui se déclare six fois finit par
+     * oublier la septième — l'oubli serait alors muet (la commande démarrerait
+     * sans connexion et ne trouverait pas de quoi migrer). Posé après `super()`,
+     * qui a déjà lu `options.runProfile` : une commande qui veut un profil autre
+     * peut donc encore le passer dans ses options, et il gagne.
+     */
+    constructor(...args: ConstructorParameters<typeof Command>);
     /**
      * Faut-il colorer la sortie ?
      *

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

@@ -17,8 +17,15 @@ declare class DrizzleService 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.
+     *   Réservé au boot d'un run qui n'a pas déclaré `externalServices` : l'ORM
+     *   doit exister (c'est lui qui publie le plan d'administration) sans qu'un
+     *   socket ne s'ouvre. Le défaut `true` fait de l'appel direct un ordre.
+     */
+    connectAll(connect?: boolean): Promise<void>;
     /** Ferme toutes les connexions. */
     disconnectAll(): Promise<void>;
     /** Retourne l'ORM Drizzle d'un connecteur (défaut : `"default"`). */

package/dist/types/nodefony/src/orm-core/DrizzleOrm.d.ts

@@ -48,24 +48,6 @@ export interface DrizzleOrmOptions {
     /** Qui sait APPLIQUER — refuse hors développement, en le disant. */
     applyMigrations?: () => Promise<IOrmMigrationApplyReply>;
 }
-/**
- * Adapter Drizzle (driver `better-sqlite3`) **branché sur `@nodefony/orm-core`**
- * — 3ᵉ adapter du banc multi-ORM (P7.4), choix SQL #1 moderne.
- *
- * Particularité vs les autres ORM : Drizzle est **schema-as-code** — il n'y
- * a pas de « compilation » de modèle. `entity.schema` *est* déjà une table
- * Drizzle (`sqliteTable(...)`). L'adapter :
- * - dérive le DDL de chaque table via `getTableConfig()` et le crée (dev/test ;
- *   la prod passera par `drizzle-kit`) — pas de `sync()` natif côté Drizzle ;
- * - résout les relations déclaratives ({@link IEntityRelation}) en métadonnées
- *   d'**eager-load manuel** (cf {@link DrizzleRepository}), pour rester générique
- *   sans imposer la couche `relations()` de Drizzle ;
- * - pilote les transactions à la main (`BEGIN`/`COMMIT`/`ROLLBACK`) car
- *   `better-sqlite3` est synchrone (cf {@link DrizzleTransaction}).
- *
- * Trappe SQL brut : {@link DrizzleOrm.getNativeConnection} expose le db Drizzle
- * (tag `sql`) pour les jointures arbitraires (ADR-0003 risque #1).
- */
 export declare class DrizzleOrm extends Orm {
     #private;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodefony/drizzle",
-  "version": "10.0.0-alpha.1",
+  "version": "10.0.0-alpha.3",
   "description": "Moteur SQL de Nodefony sur Drizzle ORM (SQLite, PostgreSQL, MySQL) : dépôts typés, migrations de schéma et adoption d'une base existante",
   "nodefony": {
     "storeKind": "durable",
@@ -60,30 +60,30 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@nodefony/framework": "*",
-    "@nodefony/http": "*",
-    "@nodefony/orm-core": "*",
-    "@nodefony/security": "*",
-    "@nodefony/user": "*",
+    "@nodefony/framework": "^10.0.0-alpha.3",
+    "@nodefony/http": "^10.0.0-alpha.3",
+    "@nodefony/orm-core": "^10.0.0-alpha.3",
+    "@nodefony/security": "^10.0.0-alpha.3",
+    "@nodefony/user": "^10.0.0-alpha.3",
     "@types/better-sqlite3": "9.6.0",
     "@types/node": "26.4.1",
     "@types/pg": "8.23.1",
     "better-sqlite3": "13.0.3",
     "drizzle-kit": "0.31.10",
     "mysql2": "3.24.3",
-    "nodefony": "*",
+    "nodefony": "^10.0.0-alpha.3",
     "pg": "8.23.0",
     "rimraf": "6.1.3"
   },
   "peerDependencies": {
-    "@nodefony/framework": "*",
-    "@nodefony/http": "*",
-    "@nodefony/orm-core": "*",
-    "@nodefony/security": "*",
-    "@nodefony/user": "*",
+    "@nodefony/framework": "^10.0.0-alpha.3",
+    "@nodefony/http": "^10.0.0-alpha.3",
+    "@nodefony/orm-core": "^10.0.0-alpha.3",
+    "@nodefony/security": "^10.0.0-alpha.3",
+    "@nodefony/user": "^10.0.0-alpha.3",
     "better-sqlite3": "^13.0.0",
     "mysql2": "^3.24.0",
-    "nodefony": "*",
+    "nodefony": "^10.0.0-alpha.3",
     "pg": "^8.23.0"
   },
   "repository": {