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

package/README.md

@@ -16,29 +16,29 @@ npm install @nodefony/drizzle@alpha drizzle-orm better-sqlite3
 
 ## Utilisation comme module Nodefony (bootable)
 
-Ajouter `@nodefony/drizzle` à `@modules()` de l'app : le `DrizzleService` connecte
-au boot un ORM par connecteur configuré (c'est l'ORM SQL par défaut recommandé).
+Ajouter `@nodefony/drizzle` au manifeste `modules` de `nodefony.config.ts` : le `DrizzleService`
+connecte au boot un ORM par connecteur configuré (c'est l'ORM SQL par défaut recommandé).
 
 ```typescript
-@modules([
-  "@nodefony/drizzle", // connecte au boot, ferme au shutdown
-  "@nodefony/http",
-  // ...
-])
-class App extends Module {}
+// nodefony.config.ts
+import { defineConfig, use } from "nodefony";
+
+export default defineConfig({
+  modules: [
+    "@nodefony/http",
+    // connecte au boot, ferme au shutdown ; sans `filename`, la base vit sous var/databases/
+    use("@nodefony/drizzle", {
+      connectors: { default: { dialect: "sqlite" } },
+    }),
+  ],
+});
 ```
 
-Config par défaut (`nodefony/config/config.ts`) — surchargeable côté app via
-`nodefony/config/modules/drizzle-config.ts` :
-
-```typescript
-export default {
-  connectors: {
-    default: { filename: "<root>/var/databases/nodefony-drizzle.db" },
-    // ":memory:" ou absent → base éphémère
-  },
-};
-```
+Le schéma (`nodefony/config/config.ts`) porte les défauts ; l'application les surcharge par
+`use("@nodefony/drizzle", { … })`, par `NF_DATABASE_URL` (dialecte déduit du schéma d'URL) ou par
+l'override générique `NF__DRIZZLE__<CHEMIN>`. Sans `filename`, un connecteur SQLite écrit dans
+`<app>/var/databases/nodefony-drizzle.db` (`nodefony-<connecteur>.db` pour les autres) ;
+`filename: ":memory:"` donne une base éphémère, pour les tests.
 
 Au runtime, l'ORM est récupérable via le registre :
 

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

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

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

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

package/dist/index.js

@@ -5,6 +5,7 @@ import { EXIT, MIGRATION_FORMAT_VERSION, action, buildReport, exitCodeOf, meanin
 import { MYSQL_LOCK_NAME_SQL } from "./nodefony/src/migrator/drivers/mysqlDriver.js";
 import { PG_LOCK_KEY } from "./nodefony/src/migrator/drivers/postgresDriver.js";
 import { openMigrationDriver } from "./nodefony/src/migrator/drivers/index.js";
+import { FRAMEWORK_CONNECTOR } from "./nodefony/src/frameworkConnector.js";
 import { APP_RANK, APP_SOURCE, FRAMEWORK_RANK, FRAMEWORK_SOURCE, defaultMigrationSources, frameworkMigrationsDir } from "./nodefony/src/migrator/paths.js";
 import { migrationHash } from "./nodefony/src/migrator/hash.js";
 import { loadSources, orderSources } from "./nodefony/src/migrator/sources.js";
@@ -30,15 +31,15 @@ import { DrizzleWebAuthnCredentialStore } from "./nodefony/src/DrizzleWebAuthnCr
 import { DrizzleTotpSecretStore } from "./nodefony/src/DrizzleTotpSecretStore.js";
 import { DrizzleWebhookStore } from "./nodefony/src/DrizzleWebhookStore.js";
 import { DrizzleIdempotencyStore } from "./nodefony/src/DrizzleIdempotencyStore.js";
-import { FRAMEWORK_CONNECTOR, isFrameworkFallbackEntity, registerDrizzleFrameworkStores } from "./nodefony/registerStores.js";
+import { isFrameworkFallbackEntity, registerDrizzleFrameworkStores } from "./nodefony/registerStores.js";
 import OrmGenerate from "./nodefony/command/orm-generate.js";
 import OrmMigrate from "./nodefony/command/orm-migrate.js";
 import OrmMigrateStatus from "./nodefony/command/orm-migrate-status.js";
 import OrmMigrateBaseline from "./nodefony/command/orm-migrate-baseline.js";
 import OrmMigrateRepair from "./nodefony/command/orm-migrate-repair.js";
 import OrmReset from "./nodefony/command/orm-reset.js";
-import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorateMetadata.js";
-import __decorate from "./_virtual/_@oxc-project_runtime@0.150.0/helpers/esm/decorate.js";
+import __decorateMetadata from "./_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorateMetadata.js";
+import __decorate from "./_virtual/_@oxc-project_runtime@0.151.0/helpers/esm/decorate.js";
 import SessionStorage from "./nodefony/src/SessionStorage.js";
 import "./nodefony/src/migrator/index.js";
 import { DrizzleUserRepository } from "./nodefony/src/DrizzleUserRepository.js";
@@ -76,11 +77,13 @@ let Drizzle = class Drizzle extends Module {
 	* (convention Zod, alignée sur `@nodefony/mongoose` — audit config ORM 2026-06).
 	*/
 	async onKernelRegister() {
-		const validated = defineDrizzleConfig(this.options ?? {});
+		const validated = defineDrizzleConfig(this.options, this.appOptions ?? {});
 		this.options = validated;
 		registerUserStore("drizzle");
-		if (validated.frameworkEntities !== false) {
-			const dialect = validated.connectors?.default?.dialect ?? "sqlite";
+		const frameworkHost = validated.connectors.default;
+		if (validated.frameworkEntities && frameworkHost === void 0) this.log(`pas de connecteur "${FRAMEWORK_CONNECTOR}" (infrastructure déclarée non SQL) : schéma framework non déclaré sur drizzle — les stores durables vont au backend de cette infrastructure`, "INFO");
+		if (validated.frameworkEntities && frameworkHost !== void 0) {
+			const dialect = frameworkHost.dialect;
 			const report = registerDrizzleFrameworkStores(dialect);
 			if (report.unported.length) this.log(`schéma framework : entités non portées sur "${dialect}" → stores drizzle indisponibles pour [${report.unported.join(", ")}] (chantier multi-dialecte Ph.2.1)`, "WARNING");
 			if (report.appOwned.length) this.log(`schéma framework : entités déjà enregistrées par l'app [${report.appOwned.join(", ")}] — auto-register respecte l'app`, "DEBUG");

package/dist/nodefony/command/migrateShared.js

@@ -1,8 +1,9 @@
 import { HISTORY_TABLE, MigrationVerdictError } from "../src/migrator/types.js";
 import { EXIT, action, describeDiscovery, refusalInMode, renderRefusal, styleFor } from "../src/migrator/explain.js";
 import { missingHistoryColumn } from "../src/migrator/history.js";
+import { isReservedConnectorName } from "../src/migrator/paths.js";
 import { buildMigrator, readMigrationEnv, resolveConnector } from "../src/migrator/resolve.js";
-import { MigrationToolError, describeResolutionRefusal, moduleAbsent } from "../src/migrator/refusals.js";
+import { MigrationToolError, describeResolutionRefusal, moduleAbsent, reservedConnectorName } from "../src/migrator/refusals.js";
 import { composeReport } from "../src/migrator/status.js";
 import { CONSOLE_DATA_RUN_PROFILE, Command, resolveColorEnabled } from "nodefony";
 //#region nodefony/command/migrateShared.ts
@@ -180,6 +181,21 @@ var OrmMigrateCommand = class extends Command {
 		};
 	}
 	/**
+	* 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.
+	*/
+	refuseReservedConnector(connector, json) {
+		if (!isReservedConnectorName(connector)) return false;
+		const refusal = reservedConnectorName(connector);
+		this.fail(connector, refusal.code, refusal.summary, refusal.meaning, refusal.nextActions, json, refusal.exitCode);
+		return true;
+	}
+	/**
 	* Construit l'applicateur d'un connecteur résolu.
 	*
 	* @param resolution - connecteur prêt.

package/dist/nodefony/command/orm-generate.js

@@ -1,13 +1,14 @@
 import { HISTORY_TABLE } from "../src/migrator/types.js";
 import { EXIT, action } from "../src/migrator/explain.js";
 import { openMigrationDriver } from "../src/migrator/drivers/index.js";
-import { frameworkMigrationsDir } from "../src/migrator/paths.js";
+import { ownsSharedMigrations } from "../src/frameworkConnector.js";
+import { connectorMigrationsDir, frameworkMigrationsDir } from "../src/migrator/paths.js";
 import { createdTables, frameworkTables, loadSources } from "../src/migrator/sources.js";
 import { appMigrationsDir, generateApplyAllowed, readMigrationEnv } from "../src/migrator/resolve.js";
 import { summarizeGap } from "../src/migrator/schemaDiff.js";
 import { gapAgainstDeclared } from "../src/migrator/divergence.js";
 import { auditMigrationSql, runGenerate, stampFormatMarker } from "../src/migrator/kit.js";
-import { collectTables, entityFilesOf, missingProviders, registeredTables, usurpedTables, writeCustomMigration, writeKitConfig, writeSchemaModule } from "../src/migrator/appSchema.js";
+import { collectTables, entityFilesOf, missingProviders, registeredTables, tablesOfConnector, usurpedTables, writeCustomMigration, writeKitConfig, writeSchemaModule } from "../src/migrator/appSchema.js";
 import { checkMigrationName } from "../src/migrator/name.js";
 import { repairRebuildCopy } from "../src/migrator/rebuildCopy.js";
 import { readJournal, tablesPresentIn } from "../src/migrator/adopt.js";
@@ -113,6 +114,7 @@ var OrmGenerate = class extends OrmMigrateCommand {
 		if (!resolved) return this;
 		const { resolution, config } = resolved;
 		const connector = resolution.connector;
+		if (this.refuseReservedConnector(connector, opts.json)) return this;
 		const name = this.#nameOrFail(opts, connector);
 		if (name === null) return this;
 		const root = this.#projectRoot();
@@ -121,7 +123,8 @@ var OrmGenerate = class extends OrmMigrateCommand {
 			this.fail(connector, "NF_MIGRATE_UNAVAILABLE", "La racine de l'application n'a pas pu être résolue : impossible de savoir où écrire les migrations.", "Le dossier des migrations se résout depuis la racine de l'application, jamais depuis le répertoire courant — sans quoi la commande serait juste ou fausse selon l'endroit d'où on la tape.", [action("nodefony inspect config --json")], opts.json);
 			return this;
 		}
-		const outDir = path.join(migrationsDir, resolution.dialect);
+		const connectorDir = connectorMigrationsDir(migrationsDir, connector) ?? migrationsDir;
+		const outDir = path.join(connectorDir, resolution.dialect);
 		const relative = (p) => path.relative(root, p).split(path.sep).join("/");
 		try {
 			if (opts.custom === true) {
@@ -169,8 +172,9 @@ var OrmGenerate = class extends OrmMigrateCommand {
 		const frameworkRoot = path.dirname(await frameworkMigrationsDir());
 		const belongsToFramework = (file) => !path.relative(frameworkRoot, file).startsWith("..");
 		const mine = found.filter((t) => !belongsToFramework(t.file));
-		const tables = mine.filter((t) => t.dialect === dialect);
-		const otherDialect = mine.filter((t) => t.dialect !== dialect).map((t) => ({
+		const ofConnector = tablesOfConnector(mine, connector);
+		const tables = ofConnector.filter((t) => t.dialect === dialect);
+		const otherDialect = ofConnector.filter((t) => t.dialect !== dialect).map((t) => ({
 			table: t.tableName,
 			dialect: t.dialect ?? "inconnu",
 			file: relative(t.file)
@@ -181,7 +185,7 @@ var OrmGenerate = class extends OrmMigrateCommand {
 			otherDialect,
 			unreadable
 		};
-		const framework = new Set(await frameworkTables(dialect));
+		const framework = new Set(ownsSharedMigrations(connector) ? await frameworkTables(dialect) : []);
 		const usurped = usurpedTables(tables, framework);
 		if (usurped.length > 0) {
 			const list = usurped.map((t) => `  • « ${t.tableName} », exportée par ${relative(t.file)} (${t.exportName})`).join("\n");
@@ -223,7 +227,7 @@ var OrmGenerate = class extends OrmMigrateCommand {
 				configRel: relative(configFile),
 				name,
 				label: `le connecteur « ${connector} » (${dialect})`,
-				regenerateCommand: `nodefony orm:generate --name ${name}`
+				regenerateCommand: ownsSharedMigrations(connector) ? `nodefony orm:generate --name ${name}` : `nodefony orm:generate --connector ${connector} --name ${name}`
 			});
 		} finally {
 			await fs.rm(work, {
@@ -242,7 +246,7 @@ var OrmGenerate = class extends OrmMigrateCommand {
 				], opts.json, EXIT.actionRequired);
 				return this;
 			}
-			return await this.#emit({
+			return this.#emit({
 				formatVersion: 1,
 				connector,
 				generated: false,
@@ -285,11 +289,11 @@ var OrmGenerate = class extends OrmMigrateCommand {
 			], opts.json, EXIT.actionRequired, discovery);
 			return this;
 		}
-		return await this.#emit({
+		return this.#emit({
 			formatVersion: 1,
 			connector,
 			generated: true,
-			tag: added[added.length - 1],
+			tag: added.at(-1) ?? null,
 			files: written,
 			warnings,
 			unreadable,

package/dist/nodefony/command/orm-migrate-baseline.js

@@ -1,5 +1,7 @@
 import { HISTORY_TABLE } from "../src/migrator/types.js";
 import { EXIT, MIGRATION_FORMAT_VERSION, action, renderStatus } from "../src/migrator/explain.js";
+import { ownsSharedMigrations } from "../src/frameworkConnector.js";
+import { connectorMigrationsDir } from "../src/migrator/paths.js";
 import { frameworkTables } from "../src/migrator/sources.js";
 import { appMigrationsDir } from "../src/migrator/resolve.js";
 import { summarizeGap } from "../src/migrator/schemaDiff.js";
@@ -119,13 +121,14 @@ var OrmMigrateBaseline = class extends OrmMigrateCommand {
 	* @returns ce qui a été écrit, ou `null` si la commande a déjà refusé.
 	*/
 	async #fromDatabase(opts, resolution, config) {
+		if (this.refuseReservedConnector(resolution.connector, opts.json)) return null;
 		const root = this.kernel.path;
 		const dir = appMigrationsDir(this.kernel, config.migrations.dir);
 		if (dir === void 0) {
 			this.fail(resolution.connector, "NF_MIGRATE_UNAVAILABLE", "La racine de l'application n'a pas pu être résolue : impossible de savoir où écrire la migration de référence.", "Le dossier des migrations se résout depuis la racine de l'application, jamais depuis le répertoire courant — sans quoi la commande serait juste ou fausse selon l'endroit d'où on la tape.", [action("nodefony inspect config --json")], opts.json);
 			return null;
 		}
-		const outDir = path.join(dir, resolution.dialect);
+		const outDir = path.join(connectorMigrationsDir(dir, resolution.connector) ?? dir, resolution.dialect);
 		const journal = await readJournal(outDir);
 		if (journal !== null && journal.entries.length > 0) {
 			this.fail(resolution.connector, "NF_MIGRATE_BASELINE_NOT_EMPTY", `Rien n'a été écrit : ce dossier porte déjà ${journal.entries.length} migration(s) (${outDir}).`, "La lecture de la base ne sert qu'à DÉMARRER un historique qui n'existe pas encore. Ici il en existe un : c'est lui qui fait foi, et la base s'adopte alors telle quelle. Si ces migrations décrivent bien l'état de la base, `orm:migrate:baseline` sans option les inscrit ; si elles décrivent autre chose, c'est un écart à regarder, pas une référence à réécrire.", [action(`nodefony orm:migrate:status --connector ${resolution.connector} --json`), action(`nodefony orm:migrate:baseline --connector ${resolution.connector}`)], opts.json, EXIT.actionRequired);
@@ -141,7 +144,7 @@ var OrmMigrateBaseline = class extends OrmMigrateCommand {
 			outDir,
 			dialect: resolution.dialect,
 			target: resolution.target,
-			excludedTables: [...await frameworkTables(resolution.dialect), HISTORY_TABLE],
+			excludedTables: [...ownsSharedMigrations(resolution.connector) ? await frameworkTables(resolution.dialect) : [], HISTORY_TABLE],
 			declaredTables: registeredTables(resolution.connector).map((t) => t.table),
 			name: verdict.name,
 			workDir: path.join(root, "node_modules", ".cache", "nodefony", "orm-adopt")

package/dist/nodefony/command/orm-reset.js

@@ -1,4 +1,5 @@
 import { action } from "../src/migrator/explain.js";
+import "../src/memoryDatabase.js";
 import { openMigrationDriver } from "../src/migrator/drivers/index.js";
 import { readHistory } from "../src/migrator/history.js";
 import { readMigrationEnv, resetAllowed } from "../src/migrator/resolve.js";

package/dist/nodefony/config/defineModuleConfig.js

@@ -10,13 +10,25 @@ import { z } from "zod";
 *
 * - Infra `database` (`NF_DATABASE_URL`, alias `DATABASE_URL`) de famille SQL →
 *   dialecte + cible du connecteur primaire (`default`, sinon le premier) :
-*   `sqlite:…` → `filename` ; `postgres://…`/`mysql://…` → `url`. Une URL
-*   `mongodb://` est IGNORÉE ici (l'infra appartient alors à `@nodefony/mongoose`).
+*   `sqlite:…` → `filename` ; `postgres://…`/`mysql://…` → `url`.
+* - Infra `database` d'une AUTRE famille (`mongodb://…`) : l'URL appartient à
+*   `@nodefony/mongoose`, Drizzle ne la lit pas — et il ne crée pas non plus le
+*   connecteur `default` que son schéma pose par défaut. Ce connecteur-là, personne
+*   ne l'a demandé : il ouvrait une base SQLite parallèle où le schéma du
+*   framework se déclarait en double. Un `default` ÉCRIT par l'application, lui,
+*   est gardé — c'est ce qui sépare « par défaut » de « demandé ».
+*
+* @param config - config validée (défauts du schéma posés)
+* @param declaredDefault - l'application a-t-elle écrit un connecteur `default` ?
 */
-function applyEnvOverrides(config) {
+function applyEnvOverrides(config, declaredDefault) {
 	const database = resolveInfra(process.env).database;
-	if (database && database.family === "sql" && database.dialect) {
-		const target = config.connectors.default ? "default" : Object.keys(config.connectors)[0];
+	if (database && database.family !== "sql" && !declaredDefault) {
+		delete config.connectors.default;
+		return config;
+	}
+	if (database?.family === "sql" && database.dialect) {
+		const target = Object.hasOwn(config.connectors, "default") ? "default" : Object.keys(config.connectors)[0];
 		const connector = target ? config.connectors[target] : void 0;
 		if (connector) {
 			connector.dialect = database.dialect;
@@ -45,12 +57,16 @@ function applyEnvOverrides(config) {
 * 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.
 */
-function defineDrizzleConfig(config = {}) {
+function defineDrizzleConfig(config = {}, declared = config) {
 	const parsed = parseModuleConfig(drizzleConfigSchema, config, "@nodefony/drizzle");
-	return Object.freeze(applyEnvOverrides(parsed));
+	return Object.freeze(applyEnvOverrides(parsed, declared.connectors?.default !== void 0));
 }
 /**
 * JSON Schema introspectable de la config Drizzle — destiné au formulaire

package/dist/nodefony/entity/userTable.js

@@ -81,6 +81,9 @@ const createUserTable = createFrameworkTableFactory(USER_TABLE_SPEC);
 /**
 * 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.
 */
 const userTable = createUserTable("sqlite");
 /**
@@ -133,7 +136,7 @@ function userTableColumns(table, dialect) {
 	const columns = dialect === "postgres" ? getTableConfig$1(table).columns : dialect === "mysql" ? getTableConfig$2(table).columns : getTableConfig(table).columns;
 	return new Map(columns.map((column) => [column.name, {
 		notNull: column.notNull,
-		isUnique: column.isUnique ?? false,
+		isUnique: column.isUnique,
 		primary: column.primary
 	}]));
 }

package/dist/nodefony/registerStores.js

@@ -1,3 +1,4 @@
+import { FRAMEWORK_CONNECTOR } from "./src/frameworkConnector.js";
 import { DrizzleOrm } from "./src/orm-core/DrizzleOrm.js";
 import "./src/orm-core/index.js";
 import { TOKEN_ENTITY_NAMES, registerTokenEntities } from "./entity/tokenEntity.js";
@@ -19,31 +20,6 @@ import { assertUserContract } from "@nodefony/user";
 import { getAuditStoreFactory, getTokenStoreFactory, getTotpStoreFactory, getWebAuthnStoreFactory, getWebhookStoreFactory, registerAuditStore, registerTokenStore, registerTotpStore, registerWebAuthnStore, registerWebhookStore } from "@nodefony/security";
 import { getIdempotencyStoreFactory, registerIdempotencyStore } from "@nodefony/framework";
 //#region nodefony/registerStores.ts
-/**
-* AUTO-ENREGISTREMENT des backends framework portés par Drizzle — « charger le
-* module = ses backends deviennent sélectionnables par simple nom ».
-*
-* Appelé par `Drizzle.onKernelRegister` (config validée → dialecte du connecteur
-* `default` connu, AVANT le connect de `onBoot` → les tables sont créées au
-* connect). Remplace l'« approche B » historique où chaque application devait
-* câbler `registerXStore(...)` + `registerXEntities(...)` à la main.
-*
-* Deux garde-fous préservent la main de l'application (customisation) :
-* - **entité** : `entityRegistry.has(name, orm)` → une entité déjà enregistrée
-*   par l'app est respectée (jamais de doublon-throw) ;
-* - **fabrique** : `getXStoreFactory("drizzle")` → une fabrique déjà posée par
-*   l'app garde la main (le registre est premier-arrivé-premier-servi ici).
-*
-* Une brique dont l'entité n'est PAS portée sur le dialecte configuré n'est NI
-* déclarée NI fabricable : les registres reflètent le RÉEL (`listXStores()` ne
-* promet jamais un backend qui échouerait), et la sélectionner échoue franc au
-* 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).
-*/
-const FRAMEWORK_CONNECTOR = "default";
 /** Portage par entité (chantier multi-dialecte — Ph.2.1 allume les cases). */
 const ALL_DIALECTS = [
 	"sqlite",
@@ -133,7 +109,7 @@ function registerDrizzleFrameworkStores(dialect) {
 		if (getTokenStoreFactory("drizzle")) return;
 		registerTokenStore("drizzle", (ctx) => {
 			const orm = resolveConnectedOrm(`tokenStore "drizzle"`, dialect);
-			const days = ctx?.config?.tokenStore?.retentionRevokedDays;
+			const days = ctx.config.tokenStore.retentionRevokedDays;
 			return DrizzleTokenStore.from(orm, void 0, typeof days === "number" ? days * 864e5 : void 0);
 		});
 	});
@@ -141,7 +117,7 @@ function registerDrizzleFrameworkStores(dialect) {
 		if (getAuditStoreFactory("drizzle")) return;
 		registerAuditStore("drizzle", (ctx) => {
 			const orm = resolveConnectedOrm(`audit.store "drizzle"`, dialect);
-			const days = ctx?.config?.audit?.retentionDays;
+			const days = ctx.config.audit.retentionDays;
 			return DrizzleAuditStore.from(orm, void 0, typeof days === "number" ? days * 864e5 : void 0);
 		});
 	});
@@ -177,7 +153,7 @@ function registerDrizzleFrameworkStores(dialect) {
 				} catch {
 					return;
 				}
-			});
+			}, FRAMEWORK_CONNECTOR);
 		});
 	});
 	if (report.appOwned.includes("User")) assertAppUserEntityHonoursContract(dialect);

package/dist/nodefony/service/DrizzleService.js

@@ -1,14 +1,16 @@
 import { buildReport, isAheadOnly, meaningOf } from "../src/migrator/explain.js";
 import { defaultConnectorFilename } from "../src/connectorTarget.js";
+import { MEMORY_DATABASE } from "../src/memoryDatabase.js";
+import { FRAMEWORK_CONNECTOR, ownsSharedMigrations } from "../src/frameworkConnector.js";
 import { defaultMigrationSources } from "../src/migrator/paths.js";
 import { DrizzleMigrator } from "../src/migrator/DrizzleMigrator.js";
-import { appMigrationsDir, appVersionsMigrations, readMigrationEnv, resetAllowed, resolveCheckMode, resolveDdlMode } from "../src/migrator/resolve.js";
+import { adviseMigrations, appMigrationsDir, connectorVersionsMigrations, readMigrationEnv, resetAllowed, resolveCheckMode, resolveDdlMode } from "../src/migrator/resolve.js";
 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, runNeedsExternalServices } from "nodefony";
-import { diagnoseConnectionFailure, parseConnectionTarget, queryFlowMonitor, resolveOrmFlowEnabled } from "@nodefony/orm-core";
+import { describeConnectFailure, diagnoseConnectionFailure, parseConnectionTarget, queryFlowMonitor, reportOrphanEntities, resolveOrmFlowEnabled } from "@nodefony/orm-core";
 import fs from "node:fs";
 import path from "node:path";
 //#region nodefony/service/DrizzleService.ts
@@ -35,7 +37,7 @@ const READINESS_POLL_MS = 15e3;
 * suffit.
 */
 const DDL_EXPLAINED = {
-	auto: "(dérivé du code au démarrage — développement ; les colonnes manquantes qui acceptent le vide sont ajoutées)",
+	auto: "(dérivé du code au démarrage ; les colonnes manquantes qui acceptent le vide sont ajoutées)",
 	migrate: "(migrations appliquées au démarrage, sous verrou — un seul exemplaire assumé)",
 	none: "(personne ne touche au schéma ici — un travail externe lance « nodefony orm:migrate »)"
 };
@@ -80,22 +82,39 @@ var DrizzleService = class extends Service {
 	*/
 	#watchers = null;
 	constructor(module) {
-		super(serviceName, module.container, module.notificationsCenter, module.options ?? {});
+		super(serviceName, module.container, module.notificationsCenter, module.options);
 		this.module = module;
 		this.module.hookKernel("onBoot", async () => {
 			queryFlowMonitor.setEnabled(resolveOrmFlowEnabled(this.kernel));
 			await this.connectAll(runNeedsExternalServices(this.kernel));
 		});
+		this.module.hookKernel("onReady", () => {
+			reportOrphanEntities((message, severity) => this.log(message, severity), this.kernel ?? this, Object.keys(this.#config()?.connectors ?? {}));
+		});
 		this.kernel?.once("onTerminate", async () => {
 			this.#stopWatchers();
 			await this.disconnectAll().catch(() => {});
 		});
 	}
-	/** Config validée (Zod) exposée par le Module (`this.module.config`). */
+	/**
+	* Config du module telle que le service la TROUVE.
+	*
+	* Validée par Zod au boot du kernel ; mais le service se construit aussi hors
+	* kernel (bancs, usage direct) avec une config partielle, voire absente — et
+	* « config absente → rien à connecter » est un contrat couvert par
+	* `DrizzleService.test.ts`. Le type le dit, donc chaque lecture garde.
+	*/
 	#config() {
 		return this.module.config;
 	}
 	/**
+	* Config VALIDÉE, pour les lecteurs de migrations du plan d'administration :
+	* seul un kernel les appelle, et un kernel a validé la config au boot.
+	*/
+	#validatedConfig() {
+		return this.module.config;
+	}
+	/**
 	* Connecte tous les connecteurs déclarés en config (validée Zod).
 	*
 	* @param connect - `false` pour ENREGISTRER les ORM sans ouvrir de connexion.
@@ -122,30 +141,31 @@ var DrizzleService = class extends Service {
 	/** Connecte un connecteur (crée le dossier de la base SQLite si nécessaire). */
 	async #connectOne(name, cfg, connect = true) {
 		const dialect = cfg.dialect ?? "sqlite";
-		const ddl = resolveDdlMode(cfg.ddl, readMigrationEnv(this.kernel), appVersionsMigrations(appMigrationsDir(this.kernel, this.#config().migrations?.dir ?? "migrations")));
+		const ddl = resolveDdlMode(cfg.ddl, readMigrationEnv(this.kernel), connectorVersionsMigrations(name, appMigrationsDir(this.kernel, this.#config()?.migrations?.dir ?? "migrations")), cfg.filename === MEMORY_DATABASE);
 		let filename;
 		if (dialect === "sqlite") {
 			filename = cfg.filename ?? this.#defaultFilename(name);
 			if (filename !== ":memory:") fs.mkdirSync(path.dirname(filename), { recursive: true });
 		}
 		const orm = new DrizzleOrm(name, {
+			container: this.container ?? void 0,
 			dialect,
 			filename,
 			url: cfg.url,
 			deriveSchema: ddl === "auto",
 			migrationStatus: async () => {
 				const { migrationStatusFor } = await import("../src/migrator/status.js");
-				const result = await migrationStatusFor(name, this.#config(), this.kernel);
+				const result = await migrationStatusFor(name, this.#validatedConfig(), this.kernel);
 				return result.ok ? result.report : result.failure;
 			},
 			migrationPlan: async () => {
 				const { migrationPlanFor } = await import("../src/migrator/status.js");
-				const result = await migrationPlanFor(name, this.#config(), this.kernel);
+				const result = await migrationPlanFor(name, this.#validatedConfig(), this.kernel);
 				return result.ok ? result.plan : result.failure;
 			},
 			applyMigrations: async () => {
 				const { applyMigrationsFor } = await import("../src/migrator/status.js");
-				const result = await applyMigrationsFor(name, this.#config(), this.kernel);
+				const result = await applyMigrationsFor(name, this.#validatedConfig(), this.kernel);
 				return result.ok ? result.run : result.failure;
 			}
 		});
@@ -163,7 +183,7 @@ var DrizzleService = class extends Service {
 				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 });
+			throw new BootConfigurationError(describeConnectFailure(`Drizzle : le connecteur "${name}" (${dialect}: ${target})`, diagnosis, cause, " 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: e });
 		}
 		this.#orms.set(name, orm);
 		this.log(`Drizzle « ${name} » connecté (${dialect}: ${target}) — schéma : ${ddl} ${DDL_EXPLAINED[ddl]}`, "INFO");
@@ -189,20 +209,26 @@ var DrizzleService = class extends Service {
 		const kernel = this.kernel;
 		const config = this.#config();
 		const env = readMigrationEnv(kernel);
-		const check = resolveCheckMode(config.migrations?.check, env);
+		const check = resolveCheckMode(config?.migrations?.check, env);
 		const adviseOnly = ddl === "auto";
-		if (adviseOnly && (check === "off" || env.runtime !== "development")) return;
+		const appDir = appMigrationsDir(kernel, config?.migrations?.dir ?? "migrations");
+		const hasMigrations = ownsSharedMigrations(name) || connectorVersionsMigrations(name, appDir);
+		if (adviseOnly && (!hasMigrations || !adviseMigrations(check, env, filename))) return;
+		if (!hasMigrations) this.log(`Drizzle « ${name} » : \`ddl: "migrate"\` sans migration à appliquer — « ${name} » n'est pas le connecteur du framework (« ${FRAMEWORK_CONNECTOR} ») et aucune migration n'est versionnée sous son dossier. Son schéma n'est ni dérivé ni migré par le framework : \`nodefony orm:generate --connector ${name}\` écrit sa première migration.`, "WARNING");
 		const target = {
 			dialect,
 			filename,
 			url: cfg.url
 		};
-		const sources = await defaultMigrationSources(appMigrationsDir(kernel, config.migrations?.dir ?? "migrations"), { framework: config.frameworkEntities !== false });
+		const sources = await defaultMigrationSources(appDir, {
+			framework: config?.frameworkEntities !== false,
+			connector: name
+		});
 		const migrator = new DrizzleMigrator({
 			connector: name,
 			...target,
 			sources,
-			lockTimeoutMs: config.migrations?.lockTimeoutMs
+			lockTimeoutMs: config?.migrations?.lockTimeoutMs
 		});
 		if (adviseOnly) {
 			await this.#publishReadiness(name, migrator, ddl, "warn");
@@ -244,7 +270,7 @@ var DrizzleService = class extends Service {
 		if (!kernel) return;
 		try {
 			const plan = await migrator.status();
-			const mode = this.#config().migrations?.divergence ?? "report";
+			const mode = this.#config()?.migrations?.divergence ?? "report";
 			const report = buildReport(plan, {
 				ddl,
 				divergence: mode === "off" ? null : await describeDivergence(plan),
@@ -269,7 +295,7 @@ var DrizzleService = class extends Service {
 	*/
 	#watch(name, migrator, ddl, check) {
 		if (check === "off") return;
-		if (this.#watchers === null) this.#watchers = /* @__PURE__ */ new Map();
+		this.#watchers ??= /* @__PURE__ */ new Map();
 		const timer = setInterval(() => {
 			this.#publishReadiness(name, migrator, ddl, check).catch(() => void 0);
 		}, READINESS_POLL_MS);

package/dist/nodefony/src/DrizzleAuditStore.js

@@ -71,6 +71,16 @@ var DrizzleAuditStore = class DrizzleAuditStore {
 	get location() {
 		return this.#location;
 	}
+	/** Connecteur ORM qui porte ce store — posé par {@link DrizzleAuditStore.from}. */
+	#connector;
+	/**
+	* 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() {
+		return this.#connector;
+	}
 	/**
 	* 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é).
@@ -83,7 +93,9 @@ var DrizzleAuditStore = class DrizzleAuditStore {
 	* @param retentionMs - fenêtre de rétention (ms).
 	*/
 	static from(orm, now, retentionMs) {
-		return new DrizzleAuditStore(() => orm.isConnected() ? orm.getNativeConnection() : null, now, retentionMs, createAuditEventTable(orm.dialect), orm.location);
+		const store = new DrizzleAuditStore(() => orm.isConnected() ? orm.getNativeConnection() : null, now, retentionMs, createAuditEventTable(orm.dialect), orm.location);
+		store.#connector = orm.name;
+		return store;
 	}
 	async append(event) {
 		const db = this.#resolveDb();
@@ -133,7 +145,7 @@ var DrizzleAuditStore = class DrizzleAuditStore {
 		const hasNext = rows.length > limit;
 		const pageRows = hasNext ? rows.slice(0, limit) : rows;
 		const items = pageRows.map((row) => this.#toEvent(row));
-		const last = pageRows[pageRows.length - 1];
+		const last = pageRows.at(-1);
 		return {
 			items,
 			limit,