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

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/nodefony/src/safeTarget.js

@@ -1,3 +1,4 @@
+import "./memoryDatabase.js";
 import path from "node:path";
 //#region nodefony/src/safeTarget.ts
 /**

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

@@ -107,6 +107,16 @@ export declare abstract class OrmMigrateCommand extends Command {
         }>;
         config: IDrizzleConfig;
     } | null;
+    /**
+     * Arrête une commande qui ÉCRIRAIT une migration pour un connecteur
+     * secondaire dont le nom est celui d'un dossier de dialecte — son dossier
+     * propre se confondrait avec celui des migrations du framework.
+     *
+     * @param connector - connecteur résolu.
+     * @param json - mode machine.
+     * @returns `true` si la commande est arrêtée.
+     */
+    protected refuseReservedConnector(connector: string, json?: boolean): boolean;
     /**
      * Construit l'applicateur d'un connecteur résolu.
      *

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

@@ -13,10 +13,14 @@ import type { IDrizzleConfig, IDrizzleConfigInput } from "../interfaces/IDrizzle
  * au boot — cf audit config ORM 2026-06 §3.2.
  *
  * @param config - configuration brute (sections omises = défauts sûrs).
+ * @param declared - ce que l'APPLICATION a écrit elle-même. Au boot, `config`
+ *   arrive déjà fusionné avec les défauts du module (`config.ts`) : on ne peut
+ *   plus y distinguer un `default` demandé d'un `default` posé par défaut. Omis,
+ *   `config` fait foi (appel direct, tests).
  * @returns config validée, surchargée par l'env, et gelée.
  * @throws ZodError si la config est invalide.
  */
-export declare function defineDrizzleConfig(config?: IDrizzleConfigInput): IDrizzleConfig;
+export declare function defineDrizzleConfig(config?: IDrizzleConfigInput, declared?: IDrizzleConfigInput): IDrizzleConfig;
 /**
  * JSON Schema introspectable de la config Drizzle — destiné au formulaire
  * d'édition Studio (futur) et à la documentation générée.

package/dist/types/nodefony/entity/userTable.d.ts

@@ -1,16 +1,59 @@
-import type { SQLiteTable } from "drizzle-orm/sqlite-core";
+import type { AnySQLiteColumn, SQLiteTable } from "drizzle-orm/sqlite-core";
+import type { AnyPgColumn, PgTable } from "drizzle-orm/pg-core";
+import type { AnyMySqlColumn, MySqlTable } from "drizzle-orm/mysql-core";
 import type { IEntity } from "@nodefony/orm-core";
 import type { SqlDialect } from "../interfaces/IDrizzleConfig.js";
+/**
+ * Factory de la table `User` — comme {@link FrameworkTableFactory}, mais sa clé
+ * primaire reste ATTEIGNABLE au type.
+ *
+ * 🔴 Sans cela, une application ne peut pas RÉFÉRENCER l'utilisateur, et c'est
+ * la première relation que quiconque écrit : `create entity Message
+ * "author:ref(User)"` rend `.references(() => userTable.id)`, qui ne compilait
+ * pas (`TS2339: Property 'id' does not exist on type 'SQLiteTable<TableConfig>'`).
+ * La table est bâtie depuis une spec dont les colonnes sont calculées
+ * (`Object.fromEntries`) : l'inférence les perd, et le type rendu ne porte plus
+ * aucune colonne — alors qu'elles existent toutes à l'exécution.
+ *
+ * Cette précision reste LOCALE à `User`, et n'est pas remontée dans le colKit :
+ * les tables du framework n'ont pas toutes une colonne `id` (`session` et
+ * `idempotency_key` portent une autre clé), donc l'y déclarer mentirait sur
+ * elles. `tests/unit/userTableReference.test.ts` garde le fait — par sa
+ * COMPILATION, qu'un cas d'exécution ne pourrait pas prouver.
+ */
+export interface UserTableFactory {
+    (dialect: "sqlite"): SQLiteTable & {
+        readonly id: AnySQLiteColumn;
+    };
+    (dialect: "postgres"): PgTable & {
+        readonly id: AnyPgColumn;
+    };
+    (dialect: "mysql"): MySqlTable & {
+        readonly id: AnyMySqlColumn;
+    };
+    (dialect?: SqlDialect): (SQLiteTable & {
+        readonly id: AnySQLiteColumn;
+    }) | (PgTable & {
+        readonly id: AnyPgColumn;
+    }) | (MySqlTable & {
+        readonly id: AnyMySqlColumn;
+    });
+}
 /**
  * Factory de la table `User` pour un dialecte donné (mémoïsée — une instance
  * par dialecte). Les trois dialectes sont portés (`sqlite` par défaut).
  */
-export declare const createUserTable: import("./colKit.js").FrameworkTableFactory;
+export declare const createUserTable: UserTableFactory;
 /**
  * Variante SQLite de la table `User` (dialecte par défaut) — export conservé
  * pour l'usage direct/banc-test (ex. module mediasoup).
+ *
+ * Son type n'est PAS réécrit en `SQLiteTable` : l'annoter ainsi effaçait la
+ * clé primaire que la factory vient d'exposer, et c'était la moitié du défaut.
  */
-export declare const userTable: SQLiteTable;
+export declare const userTable: SQLiteTable<import("drizzle-orm/sqlite-core").TableConfig> & {
+    readonly id: AnySQLiteColumn;
+};
 /**
  * Forme plate d'une ligne `User` renvoyée par le repository de base — le contrat
  * `IUserRow` de `@nodefony/user`, ré-exporté sous son nom historique.

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

@@ -1,3 +1,4 @@
+import { FRAMEWORK_CONNECTOR } from "./src/frameworkConnector.js";
 import type { SqlDialect } from "./config/config.js";
 /**
  * AUTO-ENREGISTREMENT des backends framework portés par Drizzle — « charger le
@@ -20,10 +21,10 @@ import type { SqlDialect } from "./config/config.js";
  * boot (« store inconnu ») — jamais de table fantôme ni d'erreur SQL différée.
  */
 /**
- * Connecteur conventionnel qui héberge le schéma framework (même convention que
- * `SESSION_CONNECTOR` : `"default"` pour Drizzle, `"nodefony"` pour Mongoose).
+ * Connecteur conventionnel qui héberge le schéma framework — défini dans
+ * `src/frameworkConnector.ts`, que les migrations lisent aussi.
  */
-export declare const FRAMEWORK_CONNECTOR = "default";
+export { FRAMEWORK_CONNECTOR };
 /** Bilan de l'auto-enregistrement (loggé par le module — jamais silencieux). */
 export interface IFrameworkStoresReport {
     /** Entités déclarées par l'auto-register (tables créées au connect). */

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

@@ -47,6 +47,12 @@ export declare class DrizzleAuditStore implements IAuditStore {
      * — lu par `readStoreLocation`. `undefined` = backend réseau ou `:memory:`.
      */
     get location(): string | undefined;
+    /**
+     * Connecteur ORM qui porte ce store, lu par `readStoreConnector` pour le
+     * registre des stores : la console rattache la brique à SON connecteur au
+     * lieu de le déduire. `undefined` pour un store construit sans ORM (bancs).
+     */
+    get connector(): string | undefined;
     /**
      * Construit le store depuis un {@link DrizzleOrm}. Le handle est résolu **lazy**
      * (gardé par `isConnected()` → `null` tant que l'ORM n'est pas/plus connecté).

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

@@ -73,8 +73,9 @@ export declare class DrizzleIdempotencyStore implements IIdempotencyStore {
      *   base ({@link DrizzleOrm.location}) pour Studio. Lazy (comme `resolveDb`) car
      *   le store est fabriqué AVANT le connect de l'ORM → l'emplacement n'est lisible
      *   qu'une fois l'ORM enregistré (lu au `onReady`, pas à la construction).
+     * @param connector - connecteur ORM qui porte la table, publié au registre des stores.
      */
-    constructor(resolveDb: () => DrizzleDb | null, now?: () => number, leaseMs?: number, ttlMs?: number, table?: DrizzleTable, resolveLocation?: () => string | undefined);
+    constructor(resolveDb: () => DrizzleDb | null, now?: () => number, leaseMs?: number, ttlMs?: number, table?: DrizzleTable, resolveLocation?: () => string | undefined, connector?: string);
     /**
      * Emplacement physique de la base (fichier SQLite) pour l'écran Studio « Stores »
      * — lu par `readStoreLocation`. Résolu **lazy** (l'ORM n'existe pas à la
@@ -82,6 +83,12 @@ export declare class DrizzleIdempotencyStore implements IIdempotencyStore {
      * ou sur un backend réseau (pg/mysql → voir l'infra déclarée).
      */
     get location(): string | undefined;
+    /**
+     * Connecteur ORM qui porte ce store, lu par `readStoreConnector` pour le
+     * registre des stores : la console rattache la brique à SON connecteur au
+     * lieu de le déduire. `undefined` pour un store construit sans ORM (bancs).
+     */
+    get connector(): string | undefined;
     /**
      * Construit le store depuis un {@link DrizzleOrm}. Le handle est résolu **lazy**
      * (gardé par `isConnected()` → `null` tant que l'ORM n'est pas/plus connecté).

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

@@ -46,6 +46,12 @@ export declare class DrizzleTokenStore implements ITokenStore {
      * — lu par `readStoreLocation`. `undefined` = backend réseau ou `:memory:`.
      */
     get location(): string | undefined;
+    /**
+     * Connecteur ORM qui porte ce store, lu par `readStoreConnector` pour le
+     * registre des stores : la console rattache la brique à SON connecteur au
+     * lieu de le déduire. `undefined` pour un store construit sans ORM (bancs).
+     */
+    get connector(): string | undefined;
     /**
      * Construit le store depuis un {@link DrizzleOrm} connecté. Les entités
      * (`registerTokenEntities`) doivent avoir été enregistrées **avant**

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

@@ -35,6 +35,12 @@ export declare class DrizzleTotpSecretStore implements ITotpSecretStore {
      * — lu par `readStoreLocation`. `undefined` = backend réseau ou `:memory:`.
      */
     get location(): string | undefined;
+    /**
+     * Connecteur ORM qui porte ce store, lu par `readStoreConnector` pour le
+     * registre des stores : la console rattache la brique à SON connecteur au
+     * lieu de le déduire. `undefined` pour un store construit sans ORM (bancs).
+     */
+    get connector(): string | undefined;
     /**
      * Construit le store depuis un {@link DrizzleOrm} connecté. L'entité
      * (`registerTotpSecretEntity`) doit avoir été enregistrée **avant** `orm.connect()`.

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/DrizzleWebAuthnCredentialStore.d.ts

@@ -34,6 +34,12 @@ export declare class DrizzleWebAuthnCredentialStore implements IWebAuthnCredenti
      * — lu par `readStoreLocation`. `undefined` = backend réseau ou `:memory:`.
      */
     get location(): string | undefined;
+    /**
+     * Connecteur ORM qui porte ce store, lu par `readStoreConnector` pour le
+     * registre des stores : la console rattache la brique à SON connecteur au
+     * lieu de le déduire. `undefined` pour un store construit sans ORM (bancs).
+     */
+    get connector(): string | undefined;
     /**
      * Construit le store depuis un {@link DrizzleOrm} connecté. L'entité
      * (`registerWebAuthnCredentialEntity`) doit avoir été enregistrée **avant**

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

@@ -51,6 +51,12 @@ export declare class DrizzleWebhookStore implements IWebhookStore {
      * — lu par `readStoreLocation`. `undefined` = backend réseau ou `:memory:`.
      */
     get location(): string | undefined;
+    /**
+     * Connecteur ORM qui porte ce store, lu par `readStoreConnector` pour le
+     * registre des stores : la console rattache la brique à SON connecteur au
+     * lieu de le déduire. `undefined` pour un store construit sans ORM (bancs).
+     */
+    get connector(): string | undefined;
     /**
      * Construit le store depuis un {@link DrizzleOrm} connecté. L'entité
      * (`registerWebhookEndpointEntity`) doit avoir été enregistrée **avant**

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

@@ -31,6 +31,12 @@ declare class SessionStorage implements ISessionStorage {
      * DÉFENSIVE (getter `location` optionnel) — l'ORM base `IOrm` ne l'expose pas.
      */
     get location(): string | undefined;
+    /**
+     * Connecteur ORM qui porte les sessions — lu par `readStoreConnector` pour le
+     * registre des stores. `undefined` tant que l'ORM de ce connecteur n'est pas
+     * enregistré : on ne publie pas un rattachement que rien ne porte.
+     */
+    get connector(): string | undefined;
     read(id: string): Promise<ISerializedSession>;
     start(id: string): Promise<ISerializedSession>;
     write(id: string, data: ISerializedSession): Promise<ISerializedSession>;

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/frameworkConnector.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Connecteur conventionnel qui héberge le schéma framework (même convention que
+ * `SESSION_CONNECTOR` : `"default"` pour Drizzle, `"nodefony"` pour Mongoose).
+ *
+ * Vit dans ce fichier sans dépendance parce que DEUX familles le lisent : le
+ * registre des stores (où résoudre les briques du framework) et les migrations
+ * (qui les reçoit). Une copie du littéral de chaque côté dériverait en silence.
+ */
+export declare const FRAMEWORK_CONNECTOR = "default";
+/**
+ * Ce connecteur possède-t-il les migrations du framework et de l'application ?
+ *
+ * **Seul le connecteur du framework les possède.** Le dossier des migrations de
+ * l'application (`migrations/<dialect>`) ne porte aucune notion de connecteur :
+ * il décrit UNE base, celle où vivent les briques du framework et les entités
+ * de l'application. Les attribuer à tout connecteur faisait qu'une base
+ * secondaire (analyse, base d'un module) en mode `migrate` y créait des tables
+ * qui ne lui appartiennent pas, et qu'en mode `auto` elle annonçait à chaque
+ * démarrage des migrations qui ne la concernent pas.
+ *
+ * @param connector - nom du connecteur (clé de `connectors`).
+ * @returns `true` pour le connecteur du framework, `false` pour tout autre.
+ */
+export declare function ownsSharedMigrations(connector: string): boolean;

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

@@ -0,0 +1,10 @@
+/**
+ * Nom de fichier d'une base SQLite en MÉMOIRE — volatile, elle repart vide à
+ * chaque démarrage.
+ *
+ * Module FEUILLE (aucun import) : l'adapter, le migrateur, les commandes et le
+ * service le consultent tous, et le placer dans l'un d'eux ferait importer le
+ * migrateur par l'adapter. Une seule écriture du littéral : c'est d'elle que
+ * dépend la règle « une base volatile dérive son schéma » (`resolveDdlMode`).
+ */
+export declare const MEMORY_DATABASE = ":memory:";

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/appSchema.d.ts

@@ -221,3 +221,28 @@ export declare function usurpedTables(tables: readonly IDiscoveredTable[], frame
  * @returns les entités et leur table, dans l'ordre du registre.
  */
 export declare function registeredTables(connector: string): IExpectedEntity[];
+/**
+ * Tables d'un connecteur parmi celles que les fichiers fournissent — le
+ * partage qui fait qu'une migration ne décrit que SA base.
+ *
+ * Une table appartient au connecteur de l'entité qui la déclare (le REGISTRE
+ * le sait, un fichier non). Une table qu'aucune entité ne réclame reste au
+ * connecteur du framework, comme avant que les connecteurs secondaires aient
+ * leurs migrations. Sans ce partage, la table d'une entité secondaire entrait
+ * AUSSI dans les migrations du framework : créée dans une base qui ne s'en sert
+ * jamais, et proposée à la suppression le jour où elle n'y figure plus.
+ *
+ * @param tables - tables fournies par les fichiers de l'application.
+ * @param connector - connecteur visé.
+ * @param owners - `table → connecteurs` qui la déclarent ; par défaut, le registre.
+ * @returns les tables de ce connecteur, dans l'ordre reçu.
+ */
+export declare function tablesOfConnector<T extends {
+    tableName: string;
+}>(tables: readonly T[], connector: string, owners?: ReadonlyMap<string, ReadonlySet<string>>): T[];
+/**
+ * Pour chaque table enregistrée, les connecteurs dont une entité la déclare.
+ *
+ * @returns la table de correspondance, lue dans le registre des entités.
+ */
+export declare function registeredOwners(): Map<string, Set<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é.