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

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

@@ -431,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();
@@ -461,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 {
@@ -471,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:") {
@@ -506,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;
@@ -537,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 : [];
 			}
 		}
@@ -555,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;
 		}
 	}
@@ -640,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;
 					}
@@ -677,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;
@@ -708,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);
@@ -719,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. */
@@ -748,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;
@@ -809,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();
@@ -853,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;
@@ -873,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;
@@ -903,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);
@@ -914,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 {
@@ -937,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;
@@ -977,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);
@@ -1010,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;
@@ -1123,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,

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

@@ -83,11 +83,28 @@ var DrizzleRepository = class DrizzleRepository {
 		this.#dialect = dialect;
 		this.#transactional = transactional;
 	}
-	/** Colonne Drizzle d'une table par nom logique. */
+	/** Colonne Drizzle d'une table par nom logique ; `undefined` si elle n'existe pas. */
 	#col(table, name) {
 		return table[name];
 	}
 	/**
+	* Colonne EXIGÉE : un nom inconnu lève au lieu de partir dans le SQL.
+	*
+	* Strict (B2) : champ inconnu = erreur, pas un skip silencieux (qui ferait
+	* disparaître la condition → fuite « renvoie tout »), ni un `undefined` glissé
+	* dans un `ORDER BY` (rendu `no such column: asc`). Même contrat que Mongoose.
+	* Requêtes natives → `getNativeConnection()`.
+	*
+	* @param name - nom logique du champ (critère, tri, clé étrangère).
+	* @param table - table qui doit le porter (défaut : celle du repository).
+	* @throws UnknownCriteriaField si la table ne porte pas ce champ.
+	*/
+	#requireCol(name, table = this.#table) {
+		const col = this.#col(table, name);
+		if (col === void 0) throw new UnknownCriteriaField(name, getTableName(table), Object.keys(getTableColumns(table)));
+		return col;
+	}
+	/**
 	* Colonnes de la PK de la table (mémoïsées) : colonnes inline `.primaryKey()`
 	* d'abord (introspection core, valide sur tous les dialectes — couvre toutes
 	* les entités framework), sinon PK composite déclarée via `primaryKey({
@@ -128,7 +145,7 @@ var DrizzleRepository = class DrizzleRepository {
 		const qualified = sql.join(pk, sql.raw(", "));
 		const inner = where ? sql`select ${qualified} from ${this.#table} where ${where} limit 1` : sql`select ${qualified} from ${this.#table} limit 1`;
 		const output = sql.join(pk.map((col) => sql.identifier(col.name)), sql.raw(", "));
-		const first = pk[0];
+		const first = pk.at(0);
 		const target = pk.length === 1 && first ? sql`${first}` : sql`(${qualified})`;
 		return sql`${target} in (select ${output} from (${inner}) as picked)`;
 	}
@@ -229,12 +246,11 @@ var DrizzleRepository = class DrizzleRepository {
 		for (const [field, value] of Object.entries(criteria)) {
 			if (field === "$or") {
 				if (!Array.isArray(value)) throw new Error(`DrizzleRepository(${getTableName(this.#table)}): $or attend un tableau de critères.`);
-				const branches = value.map((branch) => this.#where(branch)).filter((branch) => branch !== void 0);
-				if (branches.length > 0) conds.push(branches.length === 1 ? branches[0] : or(...branches));
+				const [first, ...rest] = value.map((branch) => this.#where(branch)).filter((branch) => branch !== void 0);
+				if (first !== void 0) conds.push(rest.length === 0 ? first : or(first, ...rest));
 				continue;
 			}
-			const col = this.#col(this.#table, field);
-			if (!col) throw new UnknownCriteriaField(field, getTableName(this.#table), Object.keys(getTableColumns(this.#table)));
+			const col = this.#requireCol(field);
 			if (isFieldOperators(value)) this.#pushOperators(conds, col, value);
 			else if (value === null) conds.push(isNull(col));
 			else conds.push(eq(col, value));
@@ -305,14 +321,13 @@ var DrizzleRepository = class DrizzleRepository {
 			const conds = [];
 			let i = 0;
 			for (const [field, value] of Object.entries(criteria)) {
-				const col = this.#col(this.#table, field);
-				if (!col) throw new UnknownCriteriaField(field, getTableName(this.#table), Object.keys(getTableColumns(this.#table)));
+				const col = this.#requireCol(field);
 				conds.push(value === null ? isNull(col) : eq(col, sql.param(sql.placeholder(`p${i}`), col)));
 				i++;
 			}
 			if (conds.length > 0) query = query.where(conds.length === 1 ? conds[0] : and(...conds));
 		}
-		if (options?.order?.length) query = query.orderBy(...options.order.map(([field, dir]) => dir === "DESC" ? desc(this.#col(this.#table, field)) : asc(this.#col(this.#table, field))));
+		if (options?.order?.length) query = query.orderBy(...options.order.map(([field, dir]) => dir === "DESC" ? desc(this.#requireCol(field)) : asc(this.#requireCol(field))));
 		if (options?.limit !== void 0) query = query.limit(sql.placeholder("lim"));
 		else if (options?.offset !== void 0 && this.#dialect === "sqlite") query = query.limit(sql`-1`);
 		else if (options?.offset !== void 0 && this.#dialect === "mysql") query = query.limit(Number.MAX_SAFE_INTEGER);
@@ -335,7 +350,7 @@ var DrizzleRepository = class DrizzleRepository {
 		const shape = this.#selectShape(criteria, options);
 		if (shape === null) return null;
 		let cache = this.#preparedSelects;
-		if (cache === null) cache = this.#preparedSelects = /* @__PURE__ */ new Map();
+		cache ??= this.#preparedSelects = /* @__PURE__ */ new Map();
 		let entry = cache.get(shape.key);
 		if (entry === void 0) {
 			if (cache.size >= PREPARED_CACHE_MAX) return null;
@@ -364,12 +379,12 @@ var DrizzleRepository = class DrizzleRepository {
 		let query = this.#db.select().from(execTable(this.#table)).$dynamic();
 		const where = this.#where(criteria);
 		if (where) query = query.where(where);
-		if (options?.order?.length) query = query.orderBy(...options.order.map(([field, dir]) => dir === "DESC" ? desc(this.#col(this.#table, field)) : asc(this.#col(this.#table, field))));
+		if (options?.order?.length) query = query.orderBy(...options.order.map(([field, dir]) => dir === "DESC" ? desc(this.#requireCol(field)) : asc(this.#requireCol(field))));
 		if (options?.limit !== void 0) query = query.limit(options.limit);
 		else if (options?.offset !== void 0 && this.#dialect === "sqlite") query = query.limit(sql`-1`);
 		else if (options?.offset !== void 0 && this.#dialect === "mysql") query = query.limit(Number.MAX_SAFE_INTEGER);
 		if (options?.offset !== void 0) query = query.offset(options.offset);
-		return await this.#prof(query);
+		return this.#prof(query);
 	}
 	/** Eager-load manuel des relations déclarées (1 requête `IN (...)` par relation). */
 	async #populate(rows, relations) {
@@ -379,7 +394,7 @@ var DrizzleRepository = class DrizzleRepository {
 			if (!rel) throw new Error(`DrizzleRepository(${name}): relation "${name}" non déclarée.`);
 			if (rel.type === "one-to-many") {
 				const parentIds = rows.map((row) => row[rel.localKey]);
-				const fkCol = this.#col(rel.targetTable, rel.foreignKey);
+				const fkCol = this.#requireCol(rel.foreignKey, rel.targetTable);
 				const children = await this.#prof(this.#db.select().from(execTable(rel.targetTable)).where(inArray(fkCol, parentIds)));
 				const byParent = /* @__PURE__ */ new Map();
 				for (const child of children) {
@@ -391,7 +406,7 @@ var DrizzleRepository = class DrizzleRepository {
 				for (const row of rows) row[name] = byParent.get(row[rel.localKey]) ?? [];
 			} else {
 				const fkValues = rows.map((row) => row[rel.foreignKey]).filter((value) => value !== null && value !== void 0);
-				const idCol = this.#col(rel.targetTable, rel.targetKey);
+				const idCol = this.#requireCol(rel.targetKey, rel.targetTable);
 				const parents = fkValues.length > 0 ? await this.#prof(this.#db.select().from(execTable(rel.targetTable)).where(inArray(idCol, fkValues))) : [];
 				const byId = new Map(parents.map((p) => [p[rel.targetKey], p]));
 				for (const row of rows) row[name] = byId.get(row[rel.foreignKey]) ?? null;
@@ -441,8 +456,7 @@ var DrizzleRepository = class DrizzleRepository {
 				values[field] = value;
 				continue;
 			}
-			const col = this.#col(this.#table, field);
-			if (!col) throw new UnknownCriteriaField(field, getTableName(this.#table), Object.keys(getTableColumns(this.#table)));
+			const col = this.#requireCol(field);
 			const apply = (fn, v) => {
 				set[field] = sql`${sql.raw(fn)}(${col}, ${v})`;
 				values[field] = v;
@@ -457,9 +471,7 @@ var DrizzleRepository = class DrizzleRepository {
 	}
 	async upsert(criteria, update, insertOnly) {
 		const target = Object.keys(criteria).map((field) => {
-			const col = this.#col(this.#table, field);
-			if (!col) throw new UnknownCriteriaField(field, getTableName(this.#table), Object.keys(getTableColumns(this.#table)));
-			return col;
+			return this.#requireCol(field);
 		});
 		const write = this.#writeSet(update);
 		const values = {
@@ -486,8 +498,7 @@ var DrizzleRepository = class DrizzleRepository {
 	async increment(criteria, changes) {
 		const setObj = {};
 		for (const [field, delta] of Object.entries(changes)) {
-			const col = this.#col(this.#table, field);
-			if (!col) throw new UnknownCriteriaField(field, getTableName(this.#table), Object.keys(getTableColumns(this.#table)));
+			const col = this.#requireCol(field);
 			setObj[field] = sql`${col} + ${delta}`;
 		}
 		if (this.#dialect === "mysql") return this.#mysqlUpdateOneReturning(setObj, criteria);
@@ -511,7 +522,7 @@ var DrizzleRepository = class DrizzleRepository {
 	/** DELETE atomique d'AU PLUS une ligne (PK via `#pickOne`), RETURNING la ligne. */
 	async #deleteOneReturning(criteria) {
 		const pick = this.#pickOne(this.#where(criteria));
-		return await this.#prof(this.#db.delete(execTable(this.#table)).where(pick).returning());
+		return this.#prof(this.#db.delete(execTable(this.#table)).where(pick).returning());
 	}
 	/** PK obligatoire en mysql (les verbes re-SELECTent par PK). Fail-loud sinon. */
 	#requirePk(verb) {
@@ -522,7 +533,8 @@ var DrizzleRepository = class DrizzleRepository {
 	/** WHERE d'égalité sur la PK (valeurs plates lues par nom de colonne). */
 	#pkWhere(pk, values) {
 		const conds = pk.map((col) => eq(col, values[col.name]));
-		return conds.length === 1 ? conds[0] : and(...conds);
+		const [first, ...rest] = conds;
+		return first !== void 0 && rest.length === 0 ? first : and(...conds);
 	}
 	/** SELECT d'UNE ligne par valeurs de PK (relecture post-mutation mysql). */
 	async #selectByPk(pk, values) {
@@ -544,7 +556,7 @@ var DrizzleRepository = class DrizzleRepository {
 	async #mysqlUpdateOneReturning(set, criteria) {
 		const pk = this.#requirePk("updateOne");
 		const where = this.#where(criteria);
-		const target = (await this.#runSelect(criteria, { limit: 1 }))[0];
+		const target = (await this.#runSelect(criteria, { limit: 1 })).at(0);
 		if (!target) return null;
 		const pkCond = this.#pkWhere(pk, target);
 		const result = await this.#prof(this.#db.update(execTable(this.#table)).set(set).where(where ? and(pkCond, where) : pkCond));
@@ -556,7 +568,7 @@ var DrizzleRepository = class DrizzleRepository {
 	async #mysqlDeleteOneReturning(criteria) {
 		const pk = this.#requirePk("deleteOne");
 		const where = this.#where(criteria);
-		const target = (await this.#runSelect(criteria, { limit: 1 }))[0];
+		const target = (await this.#runSelect(criteria, { limit: 1 })).at(0);
 		if (!target) return null;
 		const pkCond = this.#pkWhere(pk, target);
 		const result = await this.#prof(this.#db.delete(execTable(this.#table)).where(where ? and(pkCond, where) : pkCond));
@@ -591,7 +603,7 @@ var DrizzleRepository = class DrizzleRepository {
 	*/
 	async countDistinct(field, criteria) {
 		const where = this.#where(criteria);
-		const builder = this.#db.select({ value: countDistinct(this.#col(this.#table, field)) }).from(execTable(this.#table)).$dynamic();
+		const builder = this.#db.select({ value: countDistinct(this.#requireCol(field)) }).from(execTable(this.#table)).$dynamic();
 		const rows = await this.#prof(where ? builder.where(where) : builder);
 		return Number(rows[0]?.value ?? 0);
 	}

package/dist/nodefony/src/queryKit.js

@@ -30,12 +30,12 @@ import { sql } from "drizzle-orm";
 */
 async function findUserIdBySocialProvider(db, dialect, provider, providerId) {
 	switch (dialect) {
-		case "sqlite": return (await db.all(sql`SELECT "id" AS id FROM ${ident("sqlite", USER_TABLE_NAME)}
+		case "sqlite": return db.all(sql`SELECT "id" AS id FROM ${ident("sqlite", USER_TABLE_NAME)}
             WHERE EXISTS (
               SELECT 1 FROM json_each(${ident("sqlite", USER_TABLE_NAME)}."socialProviders")
               WHERE json_extract(value, '$.provider') = ${provider}
                 AND json_extract(value, '$.providerId') = ${providerId}
-            ) LIMIT 1`))[0]?.id ?? null;
+            ) LIMIT 1`)[0]?.id ?? null;
 		case "postgres": {
 			const pattern = JSON.stringify([{
 				provider,
@@ -95,7 +95,7 @@ async function reserveIdempotencyKeyMysql(db, args) {
 	const [inserted] = await exec.execute(sql`INSERT IGNORE INTO ${sql.raw("`idempotency_key`")}
           (${sql.raw("`key`, `fingerprint`, `state`, `response`, `expiresAt`")})
         VALUES (${key}, ${fingerprint}, 'if', NULL, ${leaseExpiresAt})`);
-	if ((inserted?.affectedRows ?? 0) === 1) return true;
+	if ((inserted.affectedRows ?? 0) === 1) return true;
 	const [stolen] = await exec.execute(sql`UPDATE ${sql.raw("`idempotency_key`")}
         SET ${sql.raw("`fingerprint`")} = ${fingerprint},
             ${sql.raw("`state`")} = 'if',
@@ -103,7 +103,7 @@ async function reserveIdempotencyKeyMysql(db, args) {
             ${sql.raw("`expiresAt`")} = ${leaseExpiresAt}
         WHERE ${sql.raw("`key`")} = ${key}
           AND ${sql.raw("`expiresAt`")} < ${now}`);
-	return (stolen?.affectedRows ?? 0) > 0;
+	return (stolen.affectedRows ?? 0) > 0;
 }
 /** Identifiant quoté selon le dialecte (`"x"` SQL standard, `` `x` `` MySQL). */
 function ident(dialect, name) {
@@ -189,7 +189,7 @@ function orderBySql(dialect, order, allowed, fallback, tiebreaker) {
 /** Exécute un SELECT et normalise le retour en tableau de lignes (API native divergente). */
 async function runSelect(db, dialect, query) {
 	switch (dialect) {
-		case "sqlite": return await db.all(query);
+		case "sqlite": return db.all(query);
 		case "postgres": return (await db.execute(query)).rows;
 		case "mysql": {
 			const [rows] = await db.execute(query);

package/dist/types/nodefony/src/DrizzleUserRepository.d.ts

@@ -40,7 +40,7 @@ export declare class DrizzleUserRepository implements IUserRepository {
     updateMany(criteria: Criteria<IPasswordAuthenticatedUser>, data: Partial<IPasswordAuthenticatedUser>): Promise<number>;
     delete(criteria: Criteria<IPasswordAuthenticatedUser>): Promise<number>;
     count(criteria?: Criteria<IPasswordAuthenticatedUser>): Promise<number>;
-    countDistinct(field: keyof IPasswordAuthenticatedUser & string, criteria?: Criteria<IPasswordAuthenticatedUser>): Promise<number>;
+    countDistinct(field: Extract<keyof IPasswordAuthenticatedUser, string>, criteria?: Criteria<IPasswordAuthenticatedUser>): Promise<number>;
     withTransaction(tx: ITransaction): IUserRepository;
     findByIdentifier(identifier: string): Promise<IPasswordAuthenticatedUser | null>;
     /**

package/dist/types/nodefony/src/connectorTarget.d.ts

@@ -35,7 +35,7 @@ export declare function defaultConnectorFilename(kernel: Kernel | null, name: st
 export interface IConnectorTarget {
     dialect: SqlDialect;
     filename?: string;
-    url?: string;
+    url?: string | undefined;
 }
 /**
  * Résout les coordonnées d'un connecteur : dialecte, et fichier ou URL.

package/dist/types/nodefony/src/migrator/DrizzleMigrator.d.ts

@@ -10,7 +10,7 @@ export interface IDrizzleMigratorOptions extends IMigrationTarget {
     /** Registre de sources, espace de noms OUVERT. */
     sources: readonly IMigrationSource[];
     /** Délai d'attente du verrou (ms). */
-    lockTimeoutMs?: number;
+    lockTimeoutMs?: number | undefined;
     /** Qui applique — hôte du job par défaut. */
     appliedBy?: string;
     /** Horloge, injectable pour les tests. */
@@ -71,12 +71,12 @@ export declare class DrizzleMigrator {
      * @returns ce qui a été levé et ré-aligné.
      */
     repair(options?: {
-        source?: string;
-        updateHashes?: boolean;
+        source?: string | undefined;
+        updateHashes?: boolean | undefined;
         forget?: readonly {
             source: string;
             tag: string;
-        }[];
+        }[] | undefined;
     }): Promise<{
         cleared: {
             source: string;

package/dist/types/nodefony/src/migrator/destructive.d.ts

@@ -155,5 +155,5 @@ export declare function touchesExistingRows(files: readonly {
  */
 export declare function checkDataAdvice(connector: string, target?: {
     dialect: string;
-    target?: string;
+    target?: string | undefined;
 }): string;

package/dist/types/nodefony/src/migrator/drivers/index.d.ts

@@ -8,9 +8,9 @@ export interface IMigrationTarget {
     /** Dialecte du connecteur. */
     dialect: SqlDialect;
     /** Fichier SQLite (dialecte `sqlite`). */
-    filename?: string;
+    filename?: string | undefined;
     /** URL de connexion DIRECTE (dialectes `postgres` et `mysql`). */
-    url?: string;
+    url?: string | undefined;
 }
 /**
  * Ouvre le pilote à connexion unique du dialecte demandé.

package/dist/types/nodefony/src/migrator/explain.d.ts

@@ -108,15 +108,15 @@ export interface IMigrationEntryReport {
     /** Où en est cette migration pour CE connecteur. */
     status: "applied" | "pending" | "failed" | "drifted" | "missing";
     /** Début de l'application, en millisecondes — absent si jamais appliquée. */
-    appliedAt?: number;
+    appliedAt?: number | undefined;
     /** Durée de l'application, en millisecondes. */
-    durationMs?: number;
+    durationMs?: number | undefined;
     /** Ce qui l'a appliquée, tel que l'historique l'a retenu. */
-    appliedBy?: string;
+    appliedBy?: string | undefined;
     /** Déploiement qui l'a portée — groupe les migrations d'un même passage. */
-    runId?: string;
+    runId?: string | undefined;
     /** Motif de l'échec, quand elle a échoué. */
-    error?: string;
+    error?: string | undefined;
 }
 /**
  * La charge utile figée — cœur NEUTRE au premier niveau, spécifique du pilote
@@ -155,7 +155,7 @@ export interface IMigrationReport {
      * Son ABSENCE est un fait, pas un oubli : sur une base conforme, il n'y a
      * rien à nommer.
      */
-    divergence?: ISchemaComparison;
+    divergence?: ISchemaComparison | undefined;
     /**
      * Ce que le passage a DÉTRUIT, nommé — présent au seul run réel qui a
      * appliqué une migration destructive, absent partout ailleurs.
@@ -166,7 +166,7 @@ export interface IMigrationReport {
      * octet de ce qu'il relit ne la mentionne. Son absence est un fait : rien
      * n'a été détruit.
      */
-    destructive?: IDestructiveFinding[];
+    destructive?: IDestructiveFinding[] | undefined;
     /** Tout ce qui est propre au pilote SQL vit ici, et nulle part ailleurs. */
     driver: {
         kind: "sql";
@@ -174,9 +174,9 @@ export interface IMigrationReport {
         ddl: string;
         historyTable: string;
         /** La base visée, sans identifiant ni mot de passe. */
-        target?: string;
+        target?: string | undefined;
         /** `true` quand la cible vient de `NF_MIGRATE_DATABASE_URL`. */
-        fromMigrateUrl?: boolean;
+        fromMigrateUrl?: boolean | undefined;
     };
 }
 /** Grille des codes de sortie — **figée, jamais réaffectée**. */

package/dist/types/nodefony/src/migrator/name.d.ts

@@ -34,7 +34,7 @@ export type MigrationNameCheck = {
      * geste qui échoue est pire que ne rien proposer, parce qu'il fait perdre
      * un aller-retour ET la confiance dans les autres suggestions.
      */
-    suggestion?: string;
+    suggestion?: string | undefined;
 };
 /**
  * Dérive un nom acceptable d'une saisie qui ne l'est pas.

package/dist/types/nodefony/src/migrator/types.d.ts

@@ -98,9 +98,9 @@ export interface IMigrationVerdict {
     /** Connecteur concerné. */
     connector: string;
     /** Source de migrations concernée, quand le refus en désigne une. */
-    source?: string;
+    source?: string | undefined;
     /** Tag concerné, quand le refus en désigne un. */
-    tag?: string;
+    tag?: string | undefined;
     /** Faits constatés, sans mise en forme — de quoi rendre la phrase. */
     facts: Record<string, string | number | boolean | readonly string[]>;
     /** Ce qu'il faut faire ensuite, du plus direct au plus assumé. */

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

@@ -13,12 +13,12 @@ export interface DrizzleOrmOptions {
      */
     dialect?: SqlDialect;
     /** Fichier SQLite (`":memory:"` par défaut) — dialecte `sqlite` uniquement. */
-    filename?: string;
+    filename?: string | undefined;
     /**
      * Chaîne de connexion (`postgres://…`, `mysql://…`) — dialectes `postgres`/
      * `mysql`. Requise pour ces dialectes.
      */
-    url?: string;
+    url?: string | undefined;
     /**
      * Container du service qui construit l'ORM — il porte le `syslog` du kernel.
      *
@@ -28,7 +28,7 @@ export interface DrizzleOrmOptions {
      * échecs des sondes, jamais le diagnostic de la reprise. Omis en usage
      * direct (bancs de test) : l'ORM reste alors autonome, comme avant.
      */
-    container?: Container;
+    container?: Container | undefined;
     /**
      * Le schéma doit-il être DÉRIVÉ du code à la connexion ?
      *

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

@@ -15,7 +15,7 @@ import type { Criteria, IRepository, ITransaction, RepositoryReadOptions, Update
  * La surface d'exécution native qui DIVERGE (`db.all` vs `db.execute().rows`)
  * est routée par le `queryKit` — jamais ici.
  */
-export type DrizzleDb = BetterSQLite3Database<Record<string, never>>;
+export type DrizzleDb = BetterSQLite3Database;
 /** Table Drizzle multi-dialecte (l'union honnête des variantes colKit). */
 export type DrizzleTable = SQLiteTable | PgTable | MySqlTable;
 /** Colonne Drizzle dialecte-agnostique (classe de base — acceptée par les

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

@@ -24,9 +24,9 @@ export interface IResolvedForeignKey {
     /** Colonnes visées, dans le même ordre que {@link columns}. */
     readonly foreignColumns: readonly string[];
     /** Politique d'effacement du parent (`restrict`, `set null`, `cascade`…). */
-    readonly onDelete?: string;
+    readonly onDelete?: string | undefined;
     /** Politique de mise à jour de la clé du parent. */
-    readonly onUpdate?: string;
+    readonly onUpdate?: string | undefined;
 }
 /** Une table à créer, et les tables que ses clés étrangères désignent. */
 export interface ITableDependency {