@nodefony/drizzle 10.0.0-alpha.8 → 10.0.0-beta.1

package/dist/nodefony/src/migrator/refusals.js

@@ -1,5 +1,7 @@
 import { MIGRATE_URL_ENV } from "./types.js";
 import { action } from "./explain.js";
+import { FRAMEWORK_CONNECTOR } from "../frameworkConnector.js";
+import { RESERVED_MIGRATION_DIRS } from "./paths.js";
 import { knownConnectors } from "./resolve.js";
 //#region nodefony/src/migrator/refusals.ts
 /**
@@ -79,6 +81,30 @@ function generationNeedsAnswer(label, replay) {
 	};
 }
 /**
+* Un fichier lu par l'outil de génération porte un `await` de premier niveau.
+*
+* Nodefony est ESM, et l'application démarre très bien avec ce fichier. Mais
+* l'outil qui écrit les migrations (`drizzle-kit`) relit les fichiers de schéma
+* HORS de la chaîne de l'application, en les transpilant en CommonJS — où un
+* `await` de premier niveau n'existe pas. Sans ce refus, l'utilisateur recevait
+* une pile d'appels d'esbuild qui ne nomme ni l'outil ni le remède.
+*
+* @param label - ce qui était généré, tel qu'on le cite à l'utilisateur.
+* @param file - fichier fautif, tel que l'outil l'a nommé.
+* @param line - ligne de l'`await`.
+* @param replay - la commande à relancer une fois le fichier corrigé.
+* @returns le refus, prêt pour la ligne de commande comme pour l'écran.
+*/
+function generationTopLevelAwait(label, file, line, replay) {
+	return {
+		code: "NF_GENERATE_TOP_LEVEL_AWAIT",
+		summary: `${file}:${line} — un \`await\` de premier niveau empêche de générer ${label} ; rien n'a été écrit.`,
+		meaning: "L'application démarre avec ce fichier : elle est ESM. Mais l'outil qui écrit les migrations (drizzle-kit) relit les fichiers de schéma de son côté, en CommonJS, où un `await` de premier niveau n'existe pas. Un fichier d'entité DÉCLARE un schéma : ce qui se décide à l'exécution (choisir une entité selon l'infrastructure, importer un module à la demande) se place dans l'`index.ts` du module — `@entities([...])` accepte une liste calculée. La base n'est pas en cause : elle n'a pas été interrogée.",
+		nextActions: [action(replay)],
+		exitCode: 2
+	};
+}
+/**
 * L'outil de génération s'est arrêté, et ce qu'il a dit est remonté TEL QUEL.
 *
 * 🔴 Ne JAMAIS remplacer sa sortie par une hypothèse. Le fourre-tout des
@@ -176,6 +202,29 @@ function notConfigured(connector, driver) {
 	};
 }
 /**
+* Écrire une migration pour un connecteur secondaire dont le NOM est celui d'un
+* dossier de dialecte — refusé.
+*
+* Un connecteur secondaire range ses migrations sous `migrations/<connecteur>/`,
+* à côté des dossiers de dialecte du connecteur du framework. Nommé `postgres`,
+* son dossier SERAIT celui des migrations PostgreSQL du framework : il les
+* lirait comme les siennes, et les siennes seraient appliquées à la base du
+* framework. On le refuse en nommant la collision, plutôt que de le découvrir
+* au premier déploiement.
+*
+* @param connector - connecteur demandé.
+* @returns le refus, prêt pour la ligne de commande comme pour l'écran.
+*/
+function reservedConnectorName(connector) {
+	return {
+		code: "NF_MIGRATE_SECONDARY_CONNECTOR",
+		summary: `Le connecteur « ${connector} » porte le nom d'un dossier réservé (${RESERVED_MIGRATION_DIRS.join(", ")}) : ses migrations ne peuvent pas avoir de dossier propre. Rien n'a été écrit.`,
+		meaning: `Les migrations d'un connecteur secondaire vivent sous \`migrations/<connecteur>/<dialecte>\`, à côté des dossiers de dialecte du connecteur « ${FRAMEWORK_CONNECTOR} ». Le dossier \`migrations/${connector}\` est déjà l'un d'eux : les deux connecteurs y liraient les migrations de l'autre, et chacune serait appliquée à la mauvaise base. Renomme le connecteur dans \`connectors\` (par exemple « ${connector}_data ») : son nom ne sert qu'à le désigner.`,
+		nextActions: [action("nodefony inspect config --json")],
+		exitCode: 2
+	};
+}
+/**
 * Traduit une résolution qui n'est PAS `ready` en refus lisible.
 *
 * @param wanted - nom demandé par l'appelant.
@@ -222,4 +271,4 @@ function describeResolutionRefusal(wanted, resolution, config) {
 	};
 }
 //#endregion
-export { MigrationToolError, describeResolutionRefusal, formatToolOutput, generationFailed, generationNeedsAnswer, generationToolMissing, introspectFailed, moduleAbsent, notConfigured };
+export { MigrationToolError, describeResolutionRefusal, formatToolOutput, generationFailed, generationNeedsAnswer, generationToolMissing, generationTopLevelAwait, introspectFailed, moduleAbsent, notConfigured, reservedConnectorName };

package/dist/nodefony/src/migrator/resolve.js

@@ -1,6 +1,7 @@
 import { MIGRATE_URL_ENV } from "./types.js";
 import { resolveConnectorTarget } from "../connectorTarget.js";
-import { defaultMigrationSources } from "./paths.js";
+import { MEMORY_DATABASE } from "../memoryDatabase.js";
+import { connectorMigrationsDir, defaultMigrationSources } from "./paths.js";
 import { DrizzleMigrator } from "./DrizzleMigrator.js";
 import { parseDatabaseUrl, sqliteFilenameFromUrl } from "nodefony";
 import { ormRegistry } from "@nodefony/orm-core";
@@ -103,11 +104,20 @@ function generateApplyAllowed(env) {
 *
 * @param explicit - valeur écrite dans la configuration du connecteur, si elle l'est.
 * @param env - environnement constaté.
+* 🔴 **Une base VOLATILE (`:memory:`) dérive toujours son schéma**, en
+* production comprise. Rien d'autre ne peut la peupler : elle repart vide à
+* chaque démarrage, et une migration appliquée ne survit pas au processus. En
+* `none`, elle restait vide, le verdict de schéma tombait à `divergent` et la
+* sonde de disponibilité retenait la mise en service (vécu en CI : le connecteur
+* d'un module de banc, ouvert en production sous dérogation).
+*
 * @param appHasMigrations - l'application versionne au moins une migration.
+* @param volatile - la base est en mémoire (`:memory:`).
 * @returns le mode effectif.
 */
-function resolveDdlMode(explicit, env, appHasMigrations = false) {
+function resolveDdlMode(explicit, env, appHasMigrations = false, volatile = false) {
 	if (explicit) return explicit;
+	if (volatile) return "auto";
 	if (env.runtime === "development" || env.nodeEnv === "test") return appHasMigrations && env.nodeEnv !== "test" ? "migrate" : "auto";
 	return "none";
 }
@@ -142,6 +152,23 @@ function appVersionsMigrations(dir) {
 	return false;
 }
 /**
+* Des migrations versionnées CONCERNENT-elles ce connecteur ?
+*
+* C'est la question que pose la bascule `auto` → `migrate`, et elle n'est pas
+* « l'application versionne-t-elle des migrations ? » : celles de la racine
+* décrivent la base du framework. Posée telle quelle, elle faisait basculer en
+* `migrate` un connecteur secondaire qui n'en recevra jamais une — sa base
+* restait alors sans schéma, ni dérivé ni migré. On regarde donc le dossier
+* DU connecteur ({@link connectorMigrationsDir}).
+*
+* @param connector - nom du connecteur.
+* @param dir - dossier de migrations de l'application ({@link appMigrationsDir}).
+* @returns `true` si le dossier propre au connecteur porte au moins un `.sql`.
+*/
+function connectorVersionsMigrations(connector, dir) {
+	return appVersionsMigrations(connectorMigrationsDir(dir, connector));
+}
+/**
 * La conduite de la sonde de disponibilité face à un schéma en retard.
 *
 * En production, un exemplaire dont le schéma est en retard ne doit pas
@@ -158,6 +185,26 @@ function resolveCheckMode(explicit, env) {
 	return env.runtime === "production" ? "fail" : "warn";
 }
 /**
+* En schéma `auto`, faut-il ÉNONCER au démarrage les migrations enregistrées
+* que personne n'a appliquées ?
+*
+* Oui en développement, sauf conduite `off` — c'est ce conseil qui évite de
+* conclure à une base incohérente devant une colonne inconnue. Jamais sur une
+* base `:memory:` : elle repart VIDE à chaque démarrage, son historique aussi,
+* si bien que tout y paraît « à appliquer » à chaque fois — un avertissement
+* permanent qui n'apprend rien (vécu : le connecteur de banc `mediasoup`,
+* une fois déclaré, réclamait à chaque démarrage les migrations du framework
+* et de l'application, qui ne le concernent pas).
+*
+* @param check - conduite résolue ({@link resolveCheckMode}).
+* @param env - environnement constaté.
+* @param filename - fichier sqlite du connecteur, s'il en a un.
+* @returns `true` si le conseil doit être rendu.
+*/
+function adviseMigrations(check, env, filename) {
+	return check !== "off" && env.runtime === "development" && filename !== ":memory:";
+}
+/**
 * Décrit ce qui porte un connecteur, pour le nommer dans un refus.
 *
 * Un message qui dit seulement « ce connecteur ne porte pas de migrations »
@@ -177,10 +224,10 @@ function describeOwner(name) {
 			driver: ""
 		};
 	}
-	const klass = orm?.constructor?.name;
+	const klass = orm.constructor?.name;
 	let driver = "";
 	try {
-		driver = orm?.describeConnection?.().driver ?? "";
+		driver = orm.describeConnection?.().driver ?? "";
 	} catch {
 		driver = "";
 	}
@@ -221,7 +268,7 @@ const SQL_DRIVERS = /* @__PURE__ */ new Set([
 */
 function knownConnectors(config) {
 	const names = new Set(ormRegistry.list());
-	for (const name of Object.keys(config.connectors ?? {})) names.add(name);
+	for (const name of Object.keys(config.connectors)) names.add(name);
 	return [...names].sort();
 }
 /**
@@ -245,7 +292,7 @@ function knownConnectors(config) {
 * @returns la réponse, discriminée par `kind`.
 */
 function resolveConnector(connector, config, env, kernel, options = {}) {
-	const declared = config.connectors?.[connector];
+	const declared = config.connectors[connector];
 	if (!declared) {
 		if (ormRegistry.has(connector)) {
 			const owner = describeOwner(connector);
@@ -287,7 +334,7 @@ function resolveConnector(connector, config, env, kernel, options = {}) {
 			url: fromMigrateUrl && dialect !== "sqlite" ? parsedUrl.url : base.url
 		},
 		fromMigrateUrl,
-		ddl: resolveDdlMode(declared.ddl, env, appVersionsMigrations(appMigrationsDir(kernel, config.migrations.dir)))
+		ddl: resolveDdlMode(declared.ddl, env, connectorVersionsMigrations(connector, appMigrationsDir(kernel, config.migrations.dir)), declared.filename === MEMORY_DATABASE)
 	};
 }
 /**
@@ -335,7 +382,10 @@ function appMigrationsDir(kernel, dir) {
 */
 async function buildMigrator(resolution, config, kernel) {
 	const appDir = appMigrationsDir(kernel, config.migrations.dir);
-	const sources = await defaultMigrationSources(appDir, { framework: config.frameworkEntities !== false });
+	const sources = await defaultMigrationSources(appDir, {
+		framework: config.frameworkEntities !== false,
+		connector: resolution.connector
+	});
 	return new DrizzleMigrator({
 		connector: resolution.connector,
 		...resolution.target,
@@ -348,4 +398,4 @@ function resolveDivergenceMode(config) {
 	return config.migrations.divergence;
 }
 //#endregion
-export { MIGRATE_URL_ENV, appMigrationsDir, appVersionsMigrations, buildMigrator, generateApplyAllowed, knownConnectors, readMigrationEnv, resetAllowed, resolveCheckMode, resolveConnector, resolveDdlMode, resolveDivergenceMode };
+export { MEMORY_DATABASE, MIGRATE_URL_ENV, adviseMigrations, appMigrationsDir, appVersionsMigrations, buildMigrator, connectorVersionsMigrations, generateApplyAllowed, knownConnectors, readMigrationEnv, resetAllowed, resolveCheckMode, resolveConnector, resolveDdlMode, resolveDivergenceMode };

package/dist/nodefony/src/migrator/sources.js

@@ -71,7 +71,8 @@ async function readJournal(dir, source) {
 	}
 	let journal;
 	try {
-		journal = JSON.parse(raw);
+		const parsed = JSON.parse(raw);
+		journal = typeof parsed === "object" && parsed !== null ? parsed : {};
 	} catch (e) {
 		throw new MigrationVerdictError({
 			code: "NF_MIGRATE_UNKNOWN_FORMAT",
@@ -91,21 +92,25 @@ async function readJournal(dir, source) {
 		facts: { file },
 		nextActions: []
 	}, `Le journal des migrations « ${file} » ne porte pas de liste « entries » : ce n'est pas un journal que ce format sait lire.`);
-	if (!SUPPORTED_JOURNAL_VERSIONS.includes(String(journal.version))) throw new MigrationVerdictError({
+	const version = String(journal.version);
+	if (!SUPPORTED_JOURNAL_VERSIONS.includes(version)) throw new MigrationVerdictError({
 		code: "NF_MIGRATE_UNKNOWN_FORMAT",
 		connector: "",
 		source,
 		facts: {
 			file,
-			journalVersion: String(journal.version),
+			journalVersion: version,
 			supported: SUPPORTED_JOURNAL_VERSIONS
 		},
 		nextActions: [{
 			command: "npm update @nodefony/drizzle",
 			args: ["update", "@nodefony/drizzle"]
 		}]
-	}, `Le journal de migrations de la source « ${source} » est en version ${String(journal.version)}, que cette version du framework ne sait pas lire (reconnue : ${SUPPORTED_JOURNAL_VERSIONS.join(", ")}).`);
-	return journal;
+	}, `Le journal de migrations de la source « ${source} » est en version ${version}, que cette version du framework ne sait pas lire (reconnue : ${SUPPORTED_JOURNAL_VERSIONS.join(", ")}).`);
+	return {
+		version,
+		entries: journal.entries
+	};
 }
 /**
 * Lit un fichier de migration, valide son format et découpe ses statements.
@@ -370,8 +375,8 @@ function scanLine(line, needle, grammar, curseur) {
 */
 function delimiteurDollar(line, debut) {
 	let i = debut + 1;
-	while (i < line.length && /[A-Za-z0-9_]/.test(line[i])) {
-		if (i === debut + 1 && /[0-9]/.test(line[i])) return null;
+	while (i < line.length && /[A-Za-z0-9_]/.test(line.charAt(i))) {
+		if (i === debut + 1 && /[0-9]/.test(line.charAt(i))) return null;
 		i += 1;
 	}
 	return line[i] === "$" ? line.slice(debut, i + 1) : null;
@@ -390,7 +395,7 @@ function delimiteurDollar(line, debut) {
 function createdTables(files) {
 	const found = /* @__PURE__ */ new Set();
 	const pattern = /CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?[`"']?([A-Za-z0-9_$]+)[`"']?/gi;
-	for (const file of files) for (const statement of file.statements) for (const match of statement.matchAll(pattern)) found.add(match[1]);
+	for (const file of files) for (const statement of file.statements) for (const [, table] of statement.matchAll(pattern)) if (table !== void 0) found.add(table);
 	return [...found];
 }
 /**

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

@@ -1,4 +1,5 @@
 import { schemaReader, toDollarParams } from "../migrator/catalog.js";
+import "../memoryDatabase.js";
 import { notConfigured } from "../migrator/refusals.js";
 import { additiveSql, compareSchema, hasGap } from "../migrator/schemaDiff.js";
 import { describeTargetSafely } from "../safeTarget.js";
@@ -182,7 +183,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 	* @param options - options de connexion (`dialect`, `filename` sqlite, `url` pg).
 	*/
 	constructor(name, options = {}) {
-		super(name);
+		super(name, options.container);
 		this.#dialect = options.dialect ?? "sqlite";
 		this.#deriveSchema = options.deriveSchema !== false;
 		this.#filename = options.filename ?? ":memory:";
@@ -430,17 +431,18 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 	}
 	async onConnect() {
 		await this.#releasePrevious();
-		this.#tables = Object.create(null);
+		const tables = Object.create(null);
+		this.#tables = tables;
 		this.#relations = Object.create(null);
 		const entities = this.#ownEntities();
 		switch (this.#dialect) {
 			case "sqlite":
-				await this.#connectSqlite(entities);
+				await this.#connectSqlite(entities, tables);
 				break;
 			case "postgres":
-				await this.#connectPostgres(entities);
+				await this.#connectPostgres(entities, tables);
 				break;
-			case "mysql": await this.#connectMysql(entities);
+			case "mysql": await this.#connectMysql(entities, tables);
 		}
 		if (this.#deriveSchema) {
 			await this.#reconcileSchema();
@@ -460,7 +462,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 	* La méthode devient asynchrone pour cette seule raison ; le pilote, lui,
 	* reste synchrone une fois chargé (`client.exec`, `client.pragma`).
 	*/
-	async #connectSqlite(entities) {
+	async #connectSqlite(entities, tables) {
 		let Sqlite;
 		let sqliteDrizzle;
 		try {
@@ -470,7 +472,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 			Sqlite = resolved;
 			sqliteDrizzle = (await import("drizzle-orm/better-sqlite3")).drizzle;
 		} catch (e) {
-			throw new Error(`DrizzleOrm "${this.name}": the sqlite dialect needs the optional driver \`better-sqlite3\` (run \`npm i better-sqlite3\`). ${e.message}`, { cause: e });
+			throw new Error(`DrizzleOrm "${this.name}": the sqlite dialect needs the optional driver \`better-sqlite3\` (run \`npm i better-sqlite3\`). ` + e.message, { cause: e });
 		}
 		const client = new Sqlite(this.#filename);
 		if (this.#filename !== ":memory:") {
@@ -505,7 +507,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 		for (const entity of entities) {
 			this.#assertDialectTable(entity, SQLiteTable, "sqlite");
 			const table = entity.schema;
-			this.#tables[entity.name] = table;
+			tables[entity.name] = table;
 			entity.model = table;
 		}
 		if (!this.#deriveSchema) return;
@@ -536,12 +538,12 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 	#rawQuery = async (sql, params = []) => {
 		switch (this.#dialect) {
 			case "sqlite": {
-				const statement = this.#client.prepare(sql);
+				const statement = this.#sqliteClient().prepare(sql);
 				return statement.reader ? statement.all(...params) : [];
 			}
-			case "postgres": return (await this.#pgPool.query(toDollarParams(sql), params)).rows;
+			case "postgres": return (await this.#pgClient().query(toDollarParams(sql), params)).rows;
 			case "mysql": {
-				const [rows] = await this.#mysqlPool.query(sql, params);
+				const [rows] = await this.#mysqlClient().query(sql, params);
 				return Array.isArray(rows) ? rows : [];
 			}
 		}
@@ -554,13 +556,13 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 	async #rawExec(sql) {
 		switch (this.#dialect) {
 			case "sqlite":
-				this.#client.exec(sql);
+				this.#sqliteClient().exec(sql);
 				return;
 			case "postgres":
-				await this.#pgPool.query(sql);
+				await this.#pgClient().query(sql);
 				return;
 			case "mysql":
-				await this.#mysqlPool.query(sql);
+				await this.#mysqlClient().query(sql);
 				return;
 		}
 	}
@@ -639,20 +641,20 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 				case "sqlite": {
 					const t = table;
 					if (empechees.has(getTableConfig(t).name)) continue;
-					for (const statement of this.#createIndexesSQL(t)) this.#client.exec(statement);
+					for (const statement of this.#createIndexesSQL(t)) this.#sqliteClient().exec(statement);
 					break;
 				}
 				case "postgres": {
 					const t = table;
 					if (empechees.has(getTableConfig$1(t).name)) continue;
-					for (const statement of this.#createIndexesPgSQL(t)) await this.#pgPool.query(statement);
+					for (const statement of this.#createIndexesPgSQL(t)) await this.#pgClient().query(statement);
 					break;
 				}
 				case "mysql": {
 					const t = table;
 					if (empechees.has(getTableConfig$2(t).name)) continue;
 					for (const statement of this.#createIndexesMysqlSQL(t)) try {
-						await this.#mysqlPool.query(statement);
+						await this.#mysqlClient().query(statement);
 					} catch (error) {
 						if (error.code !== "ER_DUP_KEYNAME") throw error;
 					}
@@ -676,7 +678,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 	* déploiement SQLite ne les tire jamais. Pool partagé ; DDL dérivé pour dev/test
 	* (prod = drizzle-kit). Échec d'import → message actionnable (`npm i pg`).
 	*/
-	async #connectPostgres(entities) {
+	async #connectPostgres(entities, tables) {
 		if (!this.#url) throw new Error(`DrizzleOrm "${this.name}": dialect "postgres" requires a connection \`url\`.`);
 		let PoolCtor;
 		let pgDrizzle;
@@ -707,7 +709,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 		this.#pgPool = pool;
 		this.#db = pgDrizzle(pool);
 		try {
-			await this.#finishPostgres(entities, pool, pgDrizzle);
+			await this.#finishPostgres(entities, tables, pool, pgDrizzle);
 		} catch (e) {
 			this.#unwireAll();
 			await pool.end().catch(() => void 0);
@@ -718,11 +720,11 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 		}
 	}
 	/** Suite de la connexion postgres — isolée pour rendre `connect()` atomique. */
-	async #finishPostgres(entities, pool, pgDrizzle) {
+	async #finishPostgres(entities, tables, pool, pgDrizzle) {
 		this.#beginTx = async () => {
 			const cx = await pool.connect();
 			const puitsTx = (err) => {
-				this.connectionLost(`pg (transaction) : ${err?.message ?? String(err)}`);
+				this.connectionLost(`pg (transaction) : ${err instanceof Error ? err.message : String(err)}`);
 			};
 			cx.on("error", puitsTx);
 			/** Rend la connexion, en retirant d'abord NOTRE puits. */
@@ -747,7 +749,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 		for (const entity of entities) {
 			this.#assertDialectTable(entity, PgTable, "postgres");
 			const table = entity.schema;
-			this.#tables[entity.name] = table;
+			tables[entity.name] = table;
 			entity.model = table;
 		}
 		if (!this.#deriveSchema) return;
@@ -808,7 +810,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 	*/
 	#wirePgLifecycle(pool) {
 		const onError = (err) => {
-			this.connectionLost(`pg: ${err?.message ?? String(err)}`);
+			this.connectionLost(`pg: ${err instanceof Error ? err.message : String(err)}`);
 		};
 		const onConnect = () => {
 			this.connectionRestored();
@@ -852,7 +854,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 			this.connectionRestored();
 			cx.on("error", (err) => {
 				if (this.#mysqlPool !== pool) return;
-				this.connectionLost(`mysql: ${err?.message ?? String(err)}`);
+				this.connectionLost(`mysql: ${err instanceof Error ? err.message : String(err)}`);
 			});
 			cx.stream?.once("close", () => {
 				if (this.#mysqlPool !== pool) return;
@@ -872,7 +874,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 	* `datetime(3)` (kind `dateMs` du colKit) sont écrites/relues en UTC — mêmes
 	* instants que `timestamptz` PG, sans dépendre de la timezone du serveur.
 	*/
-	async #connectMysql(entities) {
+	async #connectMysql(entities, tables) {
 		if (!this.#url) throw new Error(`DrizzleOrm "${this.name}": dialect "mysql" requires a connection \`url\`.`);
 		let pool;
 		let mysqlDrizzle;
@@ -902,7 +904,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 		this.#mysqlPool = pool;
 		this.#db = mysqlDrizzle(pool);
 		try {
-			await this.#finishMysql(entities, pool, mysqlDrizzle);
+			await this.#finishMysql(entities, tables, pool, mysqlDrizzle);
 		} catch (e) {
 			this.#unwireAll();
 			await pool.end().catch(() => void 0);
@@ -913,7 +915,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 		}
 	}
 	/** Suite de la connexion mysql — isolée pour rendre `connect()` atomique. */
-	async #finishMysql(entities, pool, mysqlDrizzle) {
+	async #finishMysql(entities, tables, pool, mysqlDrizzle) {
 		this.#beginTx = async () => {
 			const cx = await pool.getConnection();
 			try {
@@ -936,7 +938,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 		for (const entity of entities) {
 			this.#assertDialectTable(entity, MySqlTable, "mysql");
 			const table = entity.schema;
-			this.#tables[entity.name] = table;
+			tables[entity.name] = table;
 			entity.model = table;
 		}
 		if (!this.#deriveSchema) return;
@@ -976,7 +978,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 		const table = this.#tables?.[name];
 		if (!this.#db) throw new Error(`DrizzleOrm "${this.name}": non connecté — impossible de rendre un dépôt pour "${name}". Les tables ne sont résolues qu'à la connexion. Si ce run est une commande en ligne, elle n'a pas déclaré \`externalServices\` (CONSOLE_DATA_RUN_PROFILE).`);
 		if (!table) throw new Error(`DrizzleOrm "${this.name}": no entity table registered under "${name}".`);
-		if (this.#repositories === null) this.#repositories = Object.create(null);
+		this.#repositories ??= Object.create(null);
 		let repository = this.#repositories[name];
 		if (repository === void 0) {
 			repository = new DrizzleRepository(this.#db, table, this.#relations?.[name] ?? {}, this.name, this.#dialect);
@@ -1009,6 +1011,25 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 			throw error;
 		}
 	}
+	/**
+	* Connexion SQLite courante — lève si le connecteur n'est pas ouvert. Les
+	* appelants ne passent ici qu'une fois `onConnect` engagé : la levée ne sert
+	* qu'à typer, et à dire la cause si l'ordre était un jour rompu.
+	*/
+	#sqliteClient() {
+		if (this.#client === null) throw new Error(`DrizzleOrm "${this.name}": not connected.`);
+		return this.#client;
+	}
+	/** Pool PostgreSQL courant — même contrat que {@link #sqliteClient}. */
+	#pgClient() {
+		if (this.#pgPool === null) throw new Error(`DrizzleOrm "${this.name}": not connected.`);
+		return this.#pgPool;
+	}
+	/** Pool MySQL courant — même contrat que {@link #sqliteClient}. */
+	#mysqlClient() {
+		if (this.#mysqlPool === null) throw new Error(`DrizzleOrm "${this.name}": not connected.`);
+		return this.#mysqlPool;
+	}
 	getNativeConnection() {
 		if (!this.#db) throw new Error(`DrizzleOrm "${this.name}": not connected.`);
 		return this.#db;
@@ -1122,7 +1143,7 @@ var DrizzleOrm = class DrizzleOrm extends Orm {
 	* @returns sonde `pool` (taille max, idle, empruntées, en attente).
 	*/
 	#probePgPool(pool) {
-		const max = pool.options?.max;
+		const max = pool.options.max;
 		return { pool: {
 			size: typeof max === "number" ? max : 10,
 			available: pool.idleCount,