@nodefony/drizzle 10.0.0-alpha.7 → 10.0.0-alpha.9

package/dist/nodefony/src/DrizzleTotpSecretStore.js

@@ -40,6 +40,16 @@ var DrizzleTotpSecretStore = class DrizzleTotpSecretStore {
 	get location() {
 		return this.#location;
 	}
+	/** Connecteur ORM qui porte ce store — posé par {@link DrizzleTotpSecretStore.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} connecté. L'entité
 	* (`registerTotpSecretEntity`) doit avoir été enregistrée **avant** `orm.connect()`.
@@ -47,7 +57,9 @@ var DrizzleTotpSecretStore = class DrizzleTotpSecretStore {
 	* @param orm - ORM Drizzle connecté hébergeant la table du store.
 	*/
 	static from(orm) {
-		return new DrizzleTotpSecretStore(orm.getRepository(TOTP_SECRET_ENTITY), orm.location);
+		const store = new DrizzleTotpSecretStore(orm.getRepository(TOTP_SECRET_ENTITY), orm.location);
+		store.#connector = orm.name;
+		return store;
 	}
 	/** Row plate → secret du contrat (recoveryCodes copié = mutable indépendant). */
 	#toSecret(row) {

package/dist/nodefony/src/DrizzleWebAuthnCredentialStore.js

@@ -39,6 +39,16 @@ var DrizzleWebAuthnCredentialStore = class DrizzleWebAuthnCredentialStore {
 	get location() {
 		return this.#location;
 	}
+	/** Connecteur ORM qui porte ce store — posé par {@link DrizzleWebAuthnCredentialStore.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} connecté. L'entité
 	* (`registerWebAuthnCredentialEntity`) doit avoir été enregistrée **avant**
@@ -47,7 +57,9 @@ var DrizzleWebAuthnCredentialStore = class DrizzleWebAuthnCredentialStore {
 	* @param orm - ORM Drizzle connecté hébergeant la table du store.
 	*/
 	static from(orm) {
-		return new DrizzleWebAuthnCredentialStore(orm.getRepository(WEBAUTHN_CREDENTIAL_ENTITY), orm.location);
+		const store = new DrizzleWebAuthnCredentialStore(orm.getRepository(WEBAUTHN_CREDENTIAL_ENTITY), orm.location);
+		store.#connector = orm.name;
+		return store;
 	}
 	/** Row plate → credential du contrat (`nickname?` omis si `null`). */
 	#toCredential(row) {

package/dist/nodefony/src/DrizzleWebhookStore.js

@@ -59,6 +59,16 @@ var DrizzleWebhookStore = class DrizzleWebhookStore {
 	get location() {
 		return this.#location;
 	}
+	/** Connecteur ORM qui porte ce store — posé par {@link DrizzleWebhookStore.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} connecté. L'entité
 	* (`registerWebhookEndpointEntity`) doit avoir été enregistrée **avant**
@@ -67,7 +77,9 @@ var DrizzleWebhookStore = class DrizzleWebhookStore {
 	* @param orm - ORM Drizzle connecté hébergeant la table du store.
 	*/
 	static from(orm) {
-		return new DrizzleWebhookStore(orm.getRepository(WEBHOOK_ENDPOINT_ENTITY), orm.location, orm.getNativeConnection(), orm.dialect);
+		const store = new DrizzleWebhookStore(orm.getRepository(WEBHOOK_ENDPOINT_ENTITY), orm.location, orm.getNativeConnection(), orm.dialect);
+		store.#connector = orm.name;
+		return store;
 	}
 	/** Row plate → endpoint du contrat (`events` mutable accepté en `readonly`). */
 	#toEndpoint(row) {

package/dist/nodefony/src/SessionStorage.js

@@ -41,6 +41,14 @@ var SessionStorage = class SessionStorage {
 		return typeof loc === "string" && loc.length > 0 ? loc : void 0;
 	}
 	/**
+	* 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() {
+		return ormRegistry.has("default") ? SESSION_CONNECTOR : void 0;
+	}
+	/**
 	* Repository de l'entité session, ou `null` si l'ORM n'est pas (ou plus)
 	* connecté.
 	*

package/dist/nodefony/src/frameworkConnector.js

@@ -0,0 +1,29 @@
+//#region nodefony/src/frameworkConnector.ts
+/**
+* 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.
+*/
+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.
+*/
+function ownsSharedMigrations(connector) {
+	return connector === FRAMEWORK_CONNECTOR;
+}
+//#endregion
+export { FRAMEWORK_CONNECTOR, ownsSharedMigrations };

package/dist/nodefony/src/memoryDatabase.js

@@ -0,0 +1,13 @@
+//#region nodefony/src/memoryDatabase.ts
+/**
+* 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`).
+*/
+const MEMORY_DATABASE = ":memory:";
+//#endregion
+export { MEMORY_DATABASE };

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

@@ -1,4 +1,5 @@
 import { MIGRATE_URL_ENV, MigrationLockTimeoutError, MigrationVerdictError } from "./types.js";
+import { alreadyInTargetState } from "./explain.js";
 import { openMigrationDriver } from "./drivers/index.js";
 import { deleteFailed, ensureHistorySchema, finishHistory, forgetEntries, insertHistory, readHistory } from "./history.js";
 import "./paths.js";
@@ -51,6 +52,21 @@ const ERROR_MAX_LENGTH = 2e3;
 * celle qu'il trouve seul est de recréer la base, ce qui emporte les données.
 */
 const REPRISE_SANS_DESTRUCTION = "REPRENDRE ne demande PAS de recréer la base. Deux voies, selon ce qui a échoué : corriger le fichier de migration puis lever le marqueur (« orm:migrate:repair ») et reprendre — un fichier corrigé après un échec est rejoué tel quel, son empreinte n'est pas comparée ; ou, si la mise au point demande plusieurs essais, la faire sur une base d'essai en posant « " + MIGRATE_URL_ENV + " », qui détourne la commande vers une AUTRE base et laisse celle-ci intacte — sous PowerShell, poser la variable s'écrit « $env:" + MIGRATE_URL_ENV + " = \"…\" », « env » n'y existant pas. Écrire la migration suivante est toujours préférable à défaire ce qui est déjà appliqué.";
+/**
+* La troisième voie de reprise — celle qu'aucun message ne nommait.
+*
+* Les deux voies écrites jusqu'ici (corriger le fichier, ou travailler sur une
+* base d'essai) supposent toutes deux que le fichier a tort. Quand le moteur
+* répond « c'est déjà ainsi », ni l'une ni l'autre ne mène quelque part : le
+* SQL est juste, la base est conforme, et rejouer redira la même chose. Sans
+* cette phrase, la boucle `repair` → `migrate` → même refus n'a pas de sortie
+* — et la seule qu'un agent trouve seul est de recréer la base.
+*
+* @param source - source de la migration (`app` ou `framework`).
+* @param tag - identité de la migration en échec.
+* @returns le paragraphe à insérer dans le verdict.
+*/
+const alreadyInTargetStateAdvice = (source, tag) => `Ce que dit ce message, c'est que la base est DÉJÀ dans l'état que cette migration vise : l'objet qu'elle crée existe, ou celui qu'elle retire n'a jamais existé sous ce nom. Corriger le fichier ne servira donc à rien, et le rejouer redira la même chose — c'est la boucle dans laquelle on tourne si on s'obstine. VÉRIFIE d'abord l'état réel (« nodefony inspect entities --json », ou le schéma de la table concernée) ; s'il correspond bien à ce que « ${source}/${tag} » voulait obtenir, la migration est SANS OBJET sur cette base : déclare-la appliquée plutôt que de la rejouer, avec « nodefony orm:migrate:baseline --up-to ${tag} ». Une cause courante en développement : la table a été créée par le schéma DÉRIVÉ du démarrage, qui pose les contraintes sans les nommer, là où une migration les nomme.`;
 var DrizzleMigrator = class {
 	#options;
 	#now;
@@ -592,7 +608,7 @@ var DrizzleMigrator = class {
 			tag: file.tag,
 			facts: { error: truncate(cause.message) },
 			actions: this.#recoveryActions()
-		}, `La migration « ${file.tag} » (source « ${file.source} ») a échoué : ${truncate(cause.message)}\n\n${state}\n\nSon échec est INSCRIT : le prochain passage refusera de reprendre tant que le marqueur n'aura pas été levé, après inspection.\n\n${REPRISE_SANS_DESTRUCTION}`);
+		}, `La migration « ${file.tag} » (source « ${file.source} ») a échoué : ${truncate(cause.message)}\n\n${state}\n\nSon échec est INSCRIT : le prochain passage refusera de reprendre tant que le marqueur n'aura pas été levé, après inspection.\n\n` + (alreadyInTargetState(cause.message) ? `${alreadyInTargetStateAdvice(file.source, file.tag)}\n\n` : "") + REPRISE_SANS_DESTRUCTION);
 	}
 	/**
 	* Les gestes qui sortent d'une migration en échec — **sans toucher à la base**.

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

@@ -1,4 +1,5 @@
 import { FORMAT_MARKER } from "./types.js";
+import { ownsSharedMigrations } from "../frameworkConnector.js";
 import "./kit.js";
 import { registerHooks } from "node:module";
 import { entityRegistry } from "@nodefony/orm-core";
@@ -410,5 +411,47 @@ function registeredTables(connector) {
 	}
 	return out;
 }
+/**
+* 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.
+*/
+function tablesOfConnector(tables, connector, owners = registeredOwners()) {
+	return tables.filter((t) => {
+		const claimed = owners.get(t.tableName);
+		return claimed === void 0 ? ownsSharedMigrations(connector) : claimed.has(connector);
+	});
+}
+/**
+* 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.
+*/
+function registeredOwners() {
+	const owners = /* @__PURE__ */ new Map();
+	for (const entity of entityRegistry.list()) {
+		const schema = entity.schema;
+		if (!is(schema, Table)) continue;
+		const table = getTableName(schema);
+		let set = owners.get(table);
+		if (set === void 0) {
+			set = /* @__PURE__ */ new Set();
+			owners.set(table, set);
+		}
+		set.add(entity.connector);
+	}
+	return owners;
+}
 //#endregion
-export { collectTables, dialectOf, entityFilesOf, importSpecifier, missingProviders, postgresSchemaOf, registeredTables, usurpedTables, writeCustomMigration, writeKitConfig, writeSchemaModule };
+export { collectTables, dialectOf, entityFilesOf, importSpecifier, missingProviders, postgresSchemaOf, registeredOwners, registeredTables, tablesOfConnector, usurpedTables, writeCustomMigration, writeKitConfig, writeSchemaModule };

package/dist/nodefony/src/migrator/drivers/sqliteDriver.js

@@ -1,5 +1,6 @@
 import { HISTORY_TABLE } from "../types.js";
 import { schemaReader } from "../catalog.js";
+import "../../memoryDatabase.js";
 //#region nodefony/src/migrator/drivers/sqliteDriver.ts
 /**
 * Pilote SQLite de l'applicateur — connexion `better-sqlite3` dédiée.

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

@@ -450,6 +450,8 @@ function renderStatus(report, style) {
 	if (report.sources.length === 0) out += `  ${style.dim("aucune source de migrations")}\n`;
 	if (report.divergence && !namesEverything(report.divergence)) out += renderDivergence(report.divergence, style);
 	out += `\n${renderBlocks(style, report.summary, meaningOf(report.verdict), report.nextActions)}`;
+	if (report.exitCode === EXIT.actionRequired) out += `\n${style.dim("code de sortie 1 — une action est requise, ce n'est pas un échec.")}\n`;
+	else if (report.exitCode === EXIT.error) out += `\n${style.dim("code de sortie 2 — la commande n'a pas pu travailler.")}\n`;
 	return out;
 }
 /** Combien d'écarts on déroule à l'écran avant de renvoyer au `--json`. */
@@ -561,5 +563,44 @@ const REFUSAL_MEANING = {
 	NF_MIGRATE_JOURNAL_MISMATCH: "Le journal d'une source annonce une migration dont le fichier n'est pas dans le dossier. La source est incohérente avec elle-même : une copie incomplète, un fichier ignoré par le gestionnaire de versions, ou un paquet publié sans ses migrations. Rien n'a été appliqué — l'applicateur ne devine jamais le contenu d'un fichier absent.",
 	NF_MIGRATE_UNKNOWN_SOURCE: "La source demandée n'est pas déclarée par cette application. Filtrer sur un nom inconnu ne touche aucune ligne et rend pourtant « rien à réparer » : le marqueur d'échec resterait en place, et la migration suivante échouerait pour la même raison."
 };
+/**
+* Les moteurs, chacun dans sa langue, disant « c'est DÉJÀ ainsi ».
+*
+* Reconnaître ce cas change le conseil du tout au tout : la migration n'a pas
+* échoué parce que la base est cassée, mais parce qu'elle est **déjà dans
+* l'état visé**. Le geste n'est alors ni de corriger le SQL ni de recréer la
+* base — c'est de déclarer la migration appliquée.
+*/
+const ALREADY_IN_TARGET_STATE = [
+	/\bno such (index|column|table|trigger|view)\b/iu,
+	/\b(table|index|trigger|view)\b.*\balready exists\b/iu,
+	/\bduplicate column name\b/iu,
+	/\balready exists\b/iu,
+	/\bdoes not exist\b/iu,
+	/\bduplicate key name\b/iu,
+	/\bcan't drop\b/iu,
+	/\bcheck that (column|it|the) .*exists\b/iu
+];
+/**
+* L'échec vient-il de ce que la base est DÉJÀ dans l'état que la migration vise ?
+*
+* Le cas est fréquent et sa sortie n'était nommée nulle part : le message de
+* reprise proposait de corriger le fichier ou de travailler sur une base
+* d'essai, deux voies qui ne mènent à rien quand le fichier est juste et la
+* base déjà conforme. Un agent placé devant ce refus tourne alors en rond
+* — `repair` lève le marqueur, `migrate` rejoue, le moteur redit la même
+* chose — puis finit par recréer la base, ce qui emporte les données.
+*
+* Constaté sur un agent tiers : un `DROP INDEX messages_content_unique` sur une
+* base dont l'unicité avait été posée INLINE par le DDL de démarrage, donc sans
+* index nommé. Trente-cinq minutes, deux bases détruites, la boucle brisée à la
+* main.
+*
+* @param message - le message d'erreur rendu par le moteur.
+* @returns `true` si l'échec dit « c'est déjà ainsi ».
+*/
+function alreadyInTargetState(message) {
+	return ALREADY_IN_TARGET_STATE.some((pattern) => pattern.test(message));
+}
 //#endregion
-export { EXIT, MIGRATION_FORMAT_VERSION, action, buildReport, describeDiscovery, divergenceIsBlocking, exitCodeOf, isAheadOnly, meaningOf, refusalInMode, renderRefusal, renderStatus, styleFor, verdictOf };
+export { EXIT, MIGRATION_FORMAT_VERSION, action, alreadyInTargetState, buildReport, describeDiscovery, divergenceIsBlocking, exitCodeOf, isAheadOnly, meaningOf, refusalInMode, renderRefusal, renderStatus, styleFor, verdictOf };

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

@@ -1,5 +1,5 @@
 import { FORMAT_MARKER } from "./types.js";
-import { MigrationToolError, generationFailed, generationNeedsAnswer, generationToolMissing, introspectFailed } from "./refusals.js";
+import { MigrationToolError, generationFailed, generationNeedsAnswer, generationToolMissing, generationTopLevelAwait, introspectFailed } from "./refusals.js";
 import { droppedTables, rebuiltTables } from "./destructive.js";
 import fs from "node:fs";
 import path from "node:path";
@@ -71,6 +71,8 @@ function runGenerate({ cwd, configRel, name, label, regenerateCommand }) {
 	});
 	const output = `${result.stdout ?? ""}${result.stderr ?? ""}`;
 	if (result.status !== 0 || !generationHappened(output)) {
+		const awaited = topLevelAwaitFailure(output);
+		if (awaited !== null) throw new MigrationToolError(generationTopLevelAwait(label, awaited.file, awaited.line, regenerateCommand ?? `nodefony orm:generate --name ${name}`));
 		if (isInteractivePromptFailure(output)) throw new MigrationToolError(generationNeedsAnswer(label, regenerateCommand ?? `nodefony orm:generate --name ${name}`));
 		throw new MigrationToolError(generationFailed(label, result.status, output));
 	}
@@ -273,6 +275,25 @@ function isInteractivePromptFailure(output) {
 	return /Interactive prompts require a TTY/i.test(output);
 }
 /**
+* Reconnaît le refus de l'outil devant un `await` de premier niveau.
+*
+* C'est l'esbuild de `drizzle-kit` qui le détecte, en transpilant le fichier en
+* CommonJS : sa ligne d'erreur nomme le fichier et la position. On la lit plutôt
+* que d'analyser nous-mêmes les sources — l'outil qui refuse est aussi celui qui
+* sait exactement où, sans faux positif. Fonction PURE, éprouvée sans process.
+*
+* @param output - sortie complète de l'outil.
+* @returns le fichier et la ligne, ou `null` si l'échec est d'une autre nature.
+*/
+function topLevelAwaitFailure(output) {
+	const plain = output.replace(/\u001B\[[0-9;]*m/g, "");
+	const m = /(?:^|\n)[^\S\n]*(\S[^\n]*?\.[cm]?[jt]sx?):(\d+):\d+: ERROR: Top-level await is currently not supported with the \\?"cjs\\?" output format/u.exec(plain);
+	return m ? {
+		file: m[1],
+		line: Number(m[2])
+	} : null;
+}
+/**
 * Pose le marqueur de format en tête des `.sql` d'un dossier qui ne l'ont pas.
 *
 * Écrit en fins de ligne `\n` quel que soit le système : le dépôt et le gabarit
@@ -296,4 +317,4 @@ function stampFormatMarker(dir) {
 	return stamped;
 }
 //#endregion
-export { FORMAT_MARKER, auditMigrationSql, generationHappened, isInteractivePromptFailure, resolveDrizzleKitBin, runGenerate, runIntrospect, stampFormatMarker };
+export { FORMAT_MARKER, auditMigrationSql, generationHappened, isInteractivePromptFailure, resolveDrizzleKitBin, runGenerate, runIntrospect, stampFormatMarker, topLevelAwaitFailure };

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

@@ -1,3 +1,4 @@
+import { ownsSharedMigrations } from "../frameworkConnector.js";
 import path from "node:path";
 import fs from "node:fs/promises";
 import { fileURLToPath } from "node:url";
@@ -15,6 +16,47 @@ const FRAMEWORK_RANK = 0;
 * celles des modules ; l'inverse n'arrive jamais.
 */
 const APP_RANK = 1e6;
+/**
+* Noms qui ne peuvent PAS désigner le dossier d'un connecteur secondaire : ce
+* sont ceux des dossiers de dialecte (et du journal) que le connecteur du
+* framework range déjà sous `migrations/`. Un connecteur `postgres` y lirait les
+* migrations de `default` comme les siennes.
+*/
+const RESERVED_MIGRATION_DIRS = [
+	"sqlite",
+	"postgres",
+	"mysql",
+	"meta"
+];
+/**
+* Le nom de ce connecteur collisionne-t-il avec un dossier de dialecte ?
+*
+* @param connector - nom du connecteur (clé de `connectors`).
+* @returns `true` pour un connecteur SECONDAIRE nommé comme un dossier réservé.
+*/
+function isReservedConnectorName(connector) {
+	return !ownsSharedMigrations(connector) && RESERVED_MIGRATION_DIRS.includes(connector);
+}
+/**
+* Dossier des migrations PROPRES à un connecteur — la seule règle qui dit où
+* elles vivent.
+*
+* Le connecteur du framework garde la racine (`migrations/<dialecte>`) : ses
+* migrations décrivent la base du framework et des entités de l'application.
+* Un connecteur secondaire reçoit son sous-dossier (`migrations/<connecteur>/
+* <dialecte>`) : sa base ne reçoit que ce qui y est écrit, et celle du
+* framework n'en voit rien — le dossier de dialecte qu'elle lit n'est pas le
+* même.
+*
+* @param appDir - dossier de migrations de l'application (`appMigrationsDir`).
+* @param connector - nom du connecteur.
+* @returns le dossier parent des sous-dossiers de dialecte, ou `undefined` sans
+*   racine d'application, ou pour un nom réservé ({@link isReservedConnectorName}).
+*/
+function connectorMigrationsDir(appDir, connector) {
+	if (appDir === void 0 || isReservedConnectorName(connector)) return;
+	return ownsSharedMigrations(connector) ? appDir : path.join(appDir, connector);
+}
 /** Dossier de migrations, mémoïsé — la remontée ne se fait qu'une fois. */
 let cachedDir = null;
 /**
@@ -68,10 +110,22 @@ async function frameworkMigrationsDir() {
 *
 * @param appDir - dossier de migrations de l'application, s'il y en a un.
 * @param options.framework - `false` quand le module est data-only.
+* @param options.connector - connecteur visé ; un connecteur secondaire ne
+*   reçoit que SES migrations ({@link connectorMigrationsDir}), jamais celles
+*   du framework. Omis : le registre complet (usage direct).
 * @returns le registre, prêt pour l'applicateur.
 */
 async function defaultMigrationSources(appDir, options = {}) {
 	const sources = [];
+	if (options.connector !== void 0 && !ownsSharedMigrations(options.connector)) {
+		const own = connectorMigrationsDir(appDir, options.connector);
+		if (own !== void 0) sources.push({
+			name: "app",
+			dir: own,
+			rank: APP_RANK
+		});
+		return sources;
+	}
 	if (options.framework !== false) sources.push({
 		name: FRAMEWORK_SOURCE,
 		dir: await frameworkMigrationsDir(),
@@ -85,4 +139,4 @@ async function defaultMigrationSources(appDir, options = {}) {
 	return sources;
 }
 //#endregion
-export { APP_RANK, APP_SOURCE, FRAMEWORK_RANK, FRAMEWORK_SOURCE, defaultMigrationSources, frameworkMigrationsDir };
+export { APP_RANK, APP_SOURCE, FRAMEWORK_RANK, FRAMEWORK_SOURCE, RESERVED_MIGRATION_DIRS, connectorMigrationsDir, defaultMigrationSources, frameworkMigrationsDir, isReservedConnectorName };

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

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