@nodefony/orm-core 10.0.0-alpha.8 → 10.0.0-beta.1

package/dist/index.js

@@ -1,8 +1,9 @@
 import { LIKE_ESCAPE_CHAR, OPERATOR_KEYS, UPDATE_OPERATOR_KEYS, escapeLikeTerm, isFieldOperators, isUpdateOperators, likePatternToRegExp, searchCriteria } from "./nodefony/src/criteria.js";
-import { InvalidOrderOption, UnknownCriteriaField } from "./nodefony/src/errors.js";
+import { InvalidOrderOption, ReferencedEntityError, SavepointNotSupportedError, UnknownCriteriaField } from "./nodefony/src/errors.js";
 import { assertOrderOption } from "./nodefony/src/readOptions.js";
 import { OrmRegistry, ormRegistry } from "./nodefony/src/OrmRegistry.js";
 import { EntityRegistry, entityRegistry } from "./nodefony/src/EntityRegistry.js";
+import { reportOrphanEntities } from "./nodefony/src/orphanEntities.js";
 import { connectionMonitor } from "./nodefony/src/ConnectionMonitor.js";
 import { Orm } from "./nodefony/src/Orm.js";
 import { Entity } from "./nodefony/src/Entity.js";
@@ -11,7 +12,7 @@ import { AbstractCrudService } from "./nodefony/src/AbstractCrudService.js";
 import { queryFlowMonitor } from "./nodefony/src/QueryFlowMonitor.js";
 import { buildConnectionHealth, buildOrmFlow, buildOrmGraph, createOrmAdminApi, registerOrmAdminApi, toDbml, toJsonSchema } from "./nodefony/src/OrmAdminApi.js";
 import { buildOrmLeanHealth } from "./nodefony/src/buildOrmLeanHealth.js";
-import { diagnoseConnectionFailure, parseConnectionTarget } from "./nodefony/src/connectionDiagnosis.js";
+import { REJECTED_MARKER, describeConnectFailure, diagnoseConnectionFailure, parseConnectionTarget } from "./nodefony/src/connectionDiagnosis.js";
 import { CONNECT_TIMEOUT_MS, withConnectDeadline } from "./nodefony/src/connectDeadline.js";
 import { reportOrmBootLines, resolveOrmFlowEnabled, wireOrmAdminPlane } from "./nodefony/src/ormWiring.js";
 import { isMigrationFailure } from "./nodefony/interfaces/IOrmMigrations.js";
@@ -21,4 +22,4 @@ import { DEFAULT_CONNECTOR, entities } from "./nodefony/src/decorators/entitiesD
 import { repository } from "./nodefony/src/decorators/repositoryDecorator.js";
 import "./nodefony/src/decorators/index.js";
 import { defineEntity } from "./nodefony/src/defineEntity.js";
-export { AbstractCrudService, CONNECT_TIMEOUT_MS, DEFAULT_CONNECTOR, Entity, EntityRegistry, InvalidOrderOption, LIKE_ESCAPE_CHAR, OPERATOR_KEYS, Orm, OrmRegistry, UPDATE_OPERATOR_KEYS, UnknownCriteriaField, assertOrderOption, buildConnectionHealth, buildOrmFlow, buildOrmGraph, buildOrmLeanHealth, connectionMonitor, createOrmAdminApi, defineEntity, diagnoseConnectionFailure, entities, entity, entityRegistry, escapeLikeTerm, getEntityMeta, getRepositoryMeta, hasEntityMeta, hasRepositoryMeta, isFieldOperators, isMigrationFailure, isUpdateOperators, likePatternToRegExp, ormRegistry, paginate, parseConnectionTarget, queryFlowMonitor, registerOrmAdminApi, reportOrmBootLines, repository, resolveOrmFlowEnabled, searchCriteria, toDbml, toJsonSchema, wireOrmAdminPlane, withConnectDeadline };
+export { AbstractCrudService, CONNECT_TIMEOUT_MS, DEFAULT_CONNECTOR, Entity, EntityRegistry, InvalidOrderOption, LIKE_ESCAPE_CHAR, OPERATOR_KEYS, Orm, OrmRegistry, REJECTED_MARKER, ReferencedEntityError, SavepointNotSupportedError, UPDATE_OPERATOR_KEYS, UnknownCriteriaField, assertOrderOption, buildConnectionHealth, buildOrmFlow, buildOrmGraph, buildOrmLeanHealth, connectionMonitor, createOrmAdminApi, defineEntity, describeConnectFailure, diagnoseConnectionFailure, entities, entity, entityRegistry, escapeLikeTerm, getEntityMeta, getRepositoryMeta, hasEntityMeta, hasRepositoryMeta, isFieldOperators, isMigrationFailure, isUpdateOperators, likePatternToRegExp, ormRegistry, paginate, parseConnectionTarget, queryFlowMonitor, registerOrmAdminApi, reportOrmBootLines, reportOrphanEntities, repository, resolveOrmFlowEnabled, searchCriteria, toDbml, toJsonSchema, wireOrmAdminPlane, withConnectDeadline };

package/dist/nodefony/src/AbstractCrudService.js

@@ -1,3 +1,4 @@
+import { omitUndefined } from "./omitUndefined.js";
 import { paginate } from "./paginate.js";
 import { Service } from "nodefony";
 //#region nodefony/src/AbstractCrudService.ts
@@ -115,12 +116,15 @@ var AbstractCrudService = class extends Service {
 	/**
 	* Crée une entité : `beforeCreate` → persistance → `afterCreate` → `onCreated`.
 	*
+	* Une clé qui vaut `undefined` vaut clé absente : elle est retirée avant la
+	* persistance (cf `omitUndefined`), quel que soit l'adaptateur.
+	*
 	* @param data - champs de l'entité à créer.
 	* @returns l'entité persistée. Émet `onCreated`.
 	*/
 	async create(data) {
 		const prepared = await this.beforeCreate(data);
-		const entity = await this.repository.create(prepared);
+		const entity = await this.repository.create(omitUndefined(prepared));
 		await this.afterCreate(entity);
 		this.fire("onCreated", entity);
 		return entity;
@@ -139,12 +143,12 @@ var AbstractCrudService = class extends Service {
 	* on la remontera dans un service le jour où un usage métier la réclame.
 	*
 	* @param criteria - filtre de sélection (champ inconnu → `UnknownCriteriaField`).
-	* @param data - champs à modifier.
+	* @param data - champs à modifier ; une clé `undefined` n'est pas touchée.
 	* @returns l'entité mise à jour, ou `null` si aucune ne correspond (pas d'event).
 	*/
 	async updateOne(criteria, data) {
 		const prepared = await this.beforeUpdate(criteria, data);
-		const updated = await this.repository.updateOne(criteria, prepared);
+		const updated = await this.repository.updateOne(criteria, omitUndefined(prepared));
 		if (updated !== null) {
 			await this.afterUpdate(updated);
 			this.fire("onUpdated", updated);

package/dist/nodefony/src/ConnectionMonitor.js

@@ -1,6 +1,8 @@
 //#region nodefony/src/ConnectionMonitor.ts
 /** Taille max du ring d'erreurs récentes (borne mémoire). */
 const MAX_RECENT_ERRORS = 12;
+/** Taille max de la chronologie pertes/reprises (borne mémoire). */
+const MAX_EVENTS = 20;
 /** Taille de la fenêtre glissante de latence (min/moy/max). */
 const MAX_LATENCY_SAMPLES = 30;
 /** Fenêtre de latence vide. */
@@ -18,6 +20,9 @@ const EMPTY_CORE = {
 	connectCount: 0,
 	reconnectCount: 0,
 	lostCount: 0,
+	lastLostAt: null,
+	lastRestoredAt: null,
+	events: [],
 	errorCount: 0,
 	lastConnectMs: null,
 	lastError: null,
@@ -46,7 +51,7 @@ var ConnectionMonitor = class {
 	#stats = null;
 	/** Crée/retourne les stats mutables d'un connecteur (alloue à la demande). */
 	#ensure(name) {
-		if (this.#stats === null) this.#stats = /* @__PURE__ */ new Map();
+		this.#stats ??= /* @__PURE__ */ new Map();
 		let s = this.#stats.get(name);
 		if (s === void 0) {
 			s = {
@@ -54,6 +59,9 @@ var ConnectionMonitor = class {
 				connectCount: 0,
 				reconnectCount: 0,
 				lostCount: 0,
+				lastLostAt: null,
+				lastRestoredAt: null,
+				events: null,
 				errorCount: 0,
 				lastConnectMs: null,
 				lastError: null,
@@ -72,7 +80,7 @@ var ConnectionMonitor = class {
 	*/
 	recordPing(name, ms) {
 		const s = this.#ensure(name);
-		if (s.latencies === null) s.latencies = [];
+		s.latencies ??= [];
 		s.latencies.push(ms);
 		if (s.latencies.length > MAX_LATENCY_SAMPLES) s.latencies.shift();
 	}
@@ -99,11 +107,19 @@ var ConnectionMonitor = class {
 	* preuve de bonne santé.
 	*
 	* @param name - clé du connecteur.
+	* @param reason - cause lisible (credential déjà retiré), si connue.
 	*/
-	recordLost(name) {
+	recordLost(name, reason) {
 		const s = this.#ensure(name);
+		const ts = Date.now();
 		s.lostCount += 1;
 		s.connectedSince = null;
+		s.lastLostAt = ts;
+		this.#pushEvent(s, {
+			kind: "lost",
+			ts,
+			reason
+		});
 	}
 	/**
 	* Enregistre une **reprise** de connexion constatée par l'adapter.
@@ -112,8 +128,20 @@ var ConnectionMonitor = class {
 	*/
 	recordReconnect(name) {
 		const s = this.#ensure(name);
+		const ts = Date.now();
 		s.reconnectCount += 1;
-		s.connectedSince = Date.now();
+		s.connectedSince = ts;
+		s.lastRestoredAt = ts;
+		this.#pushEvent(s, {
+			kind: "restored",
+			ts
+		});
+	}
+	/** Ajoute un événement en tête de la chronologie (allouée au 1ᵉʳ, bornée). */
+	#pushEvent(s, e) {
+		s.events ??= [];
+		s.events.unshift(e);
+		if (s.events.length > MAX_EVENTS) s.events.length = MAX_EVENTS;
 	}
 	/**
 	* Enregistre une erreur (connexion échouée ou ping en échec).
@@ -129,7 +157,7 @@ var ConnectionMonitor = class {
 			ts: Date.now()
 		};
 		s.lastError = err;
-		if (s.recentErrors === null) s.recentErrors = [];
+		s.recentErrors ??= [];
 		s.recentErrors.unshift(err);
 		if (s.recentErrors.length > MAX_RECENT_ERRORS) s.recentErrors.length = MAX_RECENT_ERRORS;
 	}
@@ -144,9 +172,10 @@ var ConnectionMonitor = class {
 		if (s === void 0) return EMPTY_CORE;
 		const lat = s.latencies;
 		let latency = EMPTY_LATENCY;
-		if (lat && lat.length) {
-			let min = lat[0];
-			let max = lat[0];
+		const last = lat?.at(-1);
+		if (lat && last !== void 0) {
+			let min = last;
+			let max = last;
 			let sum = 0;
 			for (const v of lat) {
 				if (v < min) min = v;
@@ -154,7 +183,7 @@ var ConnectionMonitor = class {
 				sum += v;
 			}
 			latency = {
-				last: lat[lat.length - 1],
+				last,
 				min: Math.round(min * 100) / 100,
 				avg: Math.round(sum / lat.length * 100) / 100,
 				max: Math.round(max * 100) / 100,
@@ -167,6 +196,9 @@ var ConnectionMonitor = class {
 			connectCount: s.connectCount,
 			reconnectCount: s.reconnectCount,
 			lostCount: s.lostCount,
+			lastLostAt: s.lastLostAt,
+			lastRestoredAt: s.lastRestoredAt,
+			events: s.events ?? [],
 			errorCount: s.errorCount,
 			lastConnectMs: s.lastConnectMs,
 			lastError: s.lastError,

package/dist/nodefony/src/EntityRegistry.js

@@ -20,7 +20,7 @@ var EntityRegistry = class {
 	* @throws si cette entité est déjà enregistrée sur le même connecteur.
 	*/
 	register(entity) {
-		if (this.#entities === null) this.#entities = Object.create(null);
+		this.#entities ??= Object.create(null);
 		const store = this.#entities;
 		let bucket = store[entity.name];
 		if (bucket === void 0) {
@@ -49,7 +49,10 @@ var EntityRegistry = class {
 		}
 		const connectors = Object.keys(bucket);
 		if (connectors.length > 1) throw new Error(`EntityRegistry: entity "${name}" exists on multiple connectors (${connectors.join(", ")}); specify one.`);
-		return bucket[connectors[0]];
+		const only = connectors[0];
+		const entity = only === void 0 ? void 0 : bucket[only];
+		if (entity === void 0) throw new Error(`EntityRegistry: no entity registered under "${name}".`);
+		return entity;
 	}
 	/**
 	* Indique si une entité (optionnellement sur un connecteur précis) est enregistrée.
@@ -72,7 +75,10 @@ var EntityRegistry = class {
 		const out = [];
 		for (const name in this.#entities) {
 			const bucket = this.#entities[name];
-			for (const connector in bucket) out.push(bucket[connector]);
+			for (const connector in bucket) {
+				const entity = bucket[connector];
+				if (entity !== void 0) out.push(entity);
+			}
 		}
 		return out;
 	}

package/dist/nodefony/src/Orm.js

@@ -126,7 +126,7 @@ var Orm = class extends Service {
 		if (!this.alive) return;
 		this.alive = false;
 		this.#lostPending = true;
-		connectionMonitor.recordLost(this.name);
+		connectionMonitor.recordLost(this.name, reason);
 		this.log(`connexion perdue : ${reason}`, "WARNING");
 		this.fire("onOrmLost", this, reason);
 	}
@@ -194,9 +194,25 @@ var Orm = class extends Service {
 		const timer = setInterval(() => {
 			this.#beat();
 		}, this.heartbeatMs);
-		timer.unref?.();
+		timer.unref();
 		this.#heartbeat = timer;
 	}
+	/**
+	* Décrit le mécanisme de résilience TEL QU'IL TOURNE — lecture pure, pour
+	* le data plane (`connection/health`) : période et montre du battement,
+	* battement actif ou non, perte en souffrance.
+	*
+	* @returns l'état du mécanisme dans ce process.
+	*/
+	describeResilience() {
+		return {
+			heartbeatMs: this.heartbeatMs,
+			heartbeatTimeoutMs: this.heartbeatTimeoutMs,
+			heartbeatActive: this.#heartbeat !== null,
+			pingable: typeof this.ping === "function",
+			lostPending: this.#lostPending
+		};
+	}
 	/** Arrête le battement et libère la minuterie. Idempotent. */
 	stopHeartbeat() {
 		if (this.#heartbeat !== null) {
@@ -248,7 +264,7 @@ var Orm = class extends Service {
 				watchdog = setTimeout(() => {
 					rejeter(/* @__PURE__ */ new Error(`aucune réponse en ${this.heartbeatTimeoutMs} ms`));
 				}, this.heartbeatTimeoutMs);
-				watchdog.unref?.();
+				watchdog.unref();
 			})]);
 			this.connectionRestored();
 		} catch (e) {

package/dist/nodefony/src/OrmAdminApi.js

@@ -2,6 +2,7 @@ import { ormRegistry } from "./OrmRegistry.js";
 import { entityRegistry } from "./EntityRegistry.js";
 import { connectionMonitor } from "./ConnectionMonitor.js";
 import { queryFlowMonitor } from "./QueryFlowMonitor.js";
+import { Nodefony } from "nodefony";
 import { performance } from "node:perf_hooks";
 //#region nodefony/src/OrmAdminApi.ts
 /**
@@ -76,9 +77,38 @@ async function migrationCapability(request, capability, missingMessage) {
 	return fn.call(orm);
 }
 /** Résumé des ORM enregistrés (statut connexion + nombre d'entités). */
+/**
+* Connecteur qui porte les stores de l'application — le connecteur PAR DÉFAUT.
+*
+* « Défaut » est un RÔLE, pas un nom : sur une infra MongoDB les briques
+* durables vivent sur `nodefony` (Mongoose), et marquer `default` (Drizzle)
+* parce qu'il s'appelle ainsi désignait une base que personne n'utilise. Le
+* rôle se CONSTATE dans le registre des stores (#474) : le connecteur qui porte
+* le plus de briques durables, puis de briques tout court.
+*
+* @param resolutions - registre des stores du kernel (`storeResolutions`).
+* @param names - connecteurs enregistrés ; une brique sur un autre nom est ignorée.
+* @returns le nom du connecteur, ou `null` si aucune brique n'est portée par
+*   un ORM (le repli sur le nom `default` s'applique alors).
+*/
+function storeCarrier(resolutions, names) {
+	const score = /* @__PURE__ */ new Map();
+	for (const r of resolutions) {
+		if (!r.connector || !names.includes(r.connector)) continue;
+		score.set(r.connector, (score.get(r.connector) ?? 0) + (r.nature === "durable" ? 1e3 : 1));
+	}
+	let best = null;
+	for (const name of names) {
+		const s = score.get(name) ?? 0;
+		if (s > 0 && (best === null || s > (score.get(best) ?? 0))) best = name;
+	}
+	return best;
+}
 function buildOrmSummaries() {
 	const entities = entityRegistry.list();
-	return ormRegistry.list().map((name) => {
+	const names = ormRegistry.list();
+	const carrier = storeCarrier(Nodefony.getKernel()?.storeResolutions ?? [], names);
+	return names.map((name) => {
 		let connected = false;
 		let vendor = "";
 		let connection;
@@ -93,7 +123,7 @@ function buildOrmSummaries() {
 		return {
 			name,
 			vendor,
-			default: name === "default",
+			default: carrier === null ? name === "default" : name === carrier,
 			connected,
 			entityCount: entities.filter((e) => e.connector === name).length,
 			connection
@@ -162,8 +192,10 @@ async function buildConnectionHealth(filter) {
 		let storage;
 		let pool;
 		let extra;
+		let resilience;
 		try {
 			const inst = ormRegistry.get(name);
+			resilience = inst.describeResilience?.();
 			connected = inst.isConnected();
 			vendor = vendorOf(inst);
 			const c = inst.describeConnection?.();
@@ -211,6 +243,11 @@ async function buildConnectionHealth(filter) {
 			uptimeMs: core.uptimeMs,
 			connectCount: core.connectCount,
 			reconnectCount: core.reconnectCount,
+			lostCount: core.lostCount,
+			lastLostAt: core.lastLostAt,
+			lastRestoredAt: core.lastRestoredAt,
+			events: core.events,
+			resilience,
 			errorCount: core.errorCount,
 			lastError: core.lastError,
 			recentErrors: core.recentErrors,
@@ -312,8 +349,8 @@ function jsonSchemaType(nativeType) {
 	const t = nativeType.toLowerCase();
 	if (/\b(serial|bigint|smallint|tinyint|mediumint|int|integer)\b/.test(t)) return { type: "integer" };
 	if (/(real|float|double|decimal|numeric|number)/.test(t)) return { type: "number" };
-	if (/bool/.test(t)) return { type: "boolean" };
-	if (/json/.test(t)) return { type: "object" };
+	if (t.includes("bool")) return { type: "boolean" };
+	if (t.includes("json")) return { type: "object" };
 	if (/(date|time|timestamp)/.test(t)) return {
 		type: "string",
 		format: "date-time"
@@ -385,7 +422,7 @@ function createOrmAdminApi() {
 			path: "entity/{name}",
 			summary: "Une entité (colonnes + relations) — ?connector= si homonymes",
 			handler: (request) => {
-				const name = request.params.name ?? "";
+				const name = request.params.name;
 				const connector = oneParam(request, "connector");
 				try {
 					const found = entityRegistry.list().find((e) => e.name === name && (!connector || e.connector === connector));
@@ -409,16 +446,21 @@ function createOrmAdminApi() {
 		},
 		{
 			path: "counts",
-			summary: "Nombre de lignes par entité (COUNT(*)) — ?connector= pour filtrer. Lazy : 1 COUNT par table.",
+			summary: "Nombre de lignes par entité (COUNT(*)) — ?connector= pour filtrer. Lazy : 1 COUNT par table. Clé = nom de l'entité, qualifiée `connecteur:nom` quand plusieurs connecteurs portent ce nom.",
 			handler: async (request) => {
 				const connector = oneParam(request, "connector");
 				const counts = {};
 				const entities = entityRegistry.list().filter((e) => !connector || e.connector === connector);
-				for (const e of entities) try {
-					const inst = ormRegistry.get(e.connector);
-					counts[e.name] = inst.isConnected() ? await inst.getRepository(e.name).count() : -1;
-				} catch {
-					counts[e.name] = -1;
+				const homonyms = /* @__PURE__ */ new Map();
+				for (const e of entities) homonyms.set(e.name, (homonyms.get(e.name) ?? 0) + 1);
+				for (const e of entities) {
+					const key = (homonyms.get(e.name) ?? 0) > 1 ? `${e.connector}:${e.name}` : e.name;
+					try {
+						const inst = ormRegistry.get(e.connector);
+						counts[key] = inst.isConnected() ? await inst.getRepository(e.name).count() : -1;
+					} catch {
+						counts[key] = -1;
+					}
 				}
 				return counts;
 			}
@@ -488,4 +530,4 @@ function registerOrmAdminApi(registry) {
 	registry.register(createOrmAdminApi());
 }
 //#endregion
-export { buildConnectionHealth, buildOrmFlow, buildOrmGraph, createOrmAdminApi, registerOrmAdminApi, toDbml, toJsonSchema };
+export { buildConnectionHealth, buildOrmFlow, buildOrmGraph, createOrmAdminApi, registerOrmAdminApi, storeCarrier, toDbml, toJsonSchema };

package/dist/nodefony/src/OrmRegistry.js

@@ -22,7 +22,7 @@ var OrmRegistry = class {
 	* @throws si un ORM du même nom est déjà enregistré (erreur de configuration).
 	*/
 	register(name, orm) {
-		if (this.#orms === null) this.#orms = /* @__PURE__ */ new Map();
+		this.#orms ??= /* @__PURE__ */ new Map();
 		if (this.#orms.has(name)) throw new Error(`OrmRegistry: an ORM named "${name}" is already registered.`);
 		this.#orms.set(name, orm);
 	}

package/dist/nodefony/src/QueryFlowMonitor.js

@@ -51,7 +51,7 @@ var QueryFlowMonitor = class {
 	}
 	/** Crée/retourne les stats mutables d'un connecteur (alloue à la demande). */
 	#ensure(connector) {
-		if (this.#stats === null) this.#stats = /* @__PURE__ */ new Map();
+		this.#stats ??= /* @__PURE__ */ new Map();
 		let s = this.#stats.get(connector);
 		if (s === void 0) {
 			s = {
@@ -85,7 +85,7 @@ var QueryFlowMonitor = class {
 		s.ewmaMs = s.ewmaMs === null ? durationMs : EWMA_ALPHA * durationMs + .8 * s.ewmaMs;
 		if (durationMs >= this.slowMs) {
 			s.slowTotal += 1;
-			if (s.slow === null) s.slow = [];
+			s.slow ??= [];
 			s.slow.unshift({
 				ts: Date.now(),
 				durationMs,

package/dist/nodefony/src/connectDeadline.js

@@ -57,7 +57,7 @@ async function withConnectDeadline(work, what, ms = CONNECT_TIMEOUT_MS) {
 			timer = setTimeout(() => {
 				reject(/* @__PURE__ */ new Error(`délai dépassé (${ms} ms) en attendant ${what} — le serveur a accepté la connexion sans répondre, ou n'a jamais répondu. Vérifier que le service visé est bien celui qui écoute, et qu'il est en état de servir.`));
 			}, ms);
-			timer.unref?.();
+			timer.unref();
 		})]);
 	} finally {
 		if (timer !== void 0) clearTimeout(timer);

package/dist/nodefony/src/connectionDiagnosis.js

@@ -31,15 +31,41 @@ const ANSWERED_CODES = /* @__PURE__ */ new Set([
 	"AuthenticationFailed",
 	"Unauthorized"
 ]);
+/**
+* Classes SQLSTATE (PostgreSQL) qui décrivent la CONNEXION elle-même, pas une
+* instruction : `08` exception de connexion, `57` intervention de l'opérateur
+* (arrêt, base qui démarre). Tout autre SQLSTATE est rendu par un serveur à qui
+* l'on parlait déjà.
+*/
+const CONNECTION_SQLSTATE_CLASSES = /* @__PURE__ */ new Set(["08", "57"]);
+/**
+* Refus MySQL/MariaDB émis PENDANT l'établissement : le serveur n'a encore
+* exécuté aucune instruction. Tout autre `ER_*` vient d'un serveur connecté.
+*/
+const MYSQL_CONNECTION_PHASE = /* @__PURE__ */ new Set([
+	"ER_CON_COUNT_ERROR",
+	"ER_TOO_MANY_USER_CONNECTIONS",
+	"ER_HOST_IS_BLOCKED",
+	"ER_SERVER_SHUTDOWN"
+]);
+/**
+* Le code prouve-t-il que la connexion avait ABOUTI quand le refus est tombé ?
+*
+* Ce n'est vrai que d'un code produit par le SERVEUR en réponse à une
+* instruction : un SQLSTATE PostgreSQL hors des classes de connexion, ou un
+* `ER_*` MySQL hors de la phase d'établissement. Les codes de refus connus
+* ({@link ANSWERED_CODES}) sont tranchés AVANT.
+*/
+function provesEstablished(code) {
+	if (/^[0-9A-Z]{5}$/.test(code) && /[0-9]/.test(code)) return !CONNECTION_SQLSTATE_CLASSES.has(code.slice(0, 2));
+	return code.startsWith("ER_") && !MYSQL_CONNECTION_PHASE.has(code);
+}
 /** Lit le code que le driver a posé sur l'erreur, sans rien supposer de sa forme. */
 function readCode(error) {
 	if (typeof error !== "object" || error === null) return null;
 	const carrier = error;
-	for (const raw of [carrier.code, carrier.codeName]) {
-		if (typeof raw === "string" && raw.length > 0) return raw;
-		if (typeof raw === "number") return String(raw);
-	}
-	return null;
+	for (const raw of [carrier.code, carrier.codeName]) if (typeof raw === "string" && raw.length > 0) return raw;
+	return typeof carrier.code === "number" ? String(carrier.code) : null;
 }
 /**
 * Extrait l'hôte et le port d'une URL de connexion, sans son secret.
@@ -102,11 +128,45 @@ function diagnoseConnectionFailure(error, target = {
 		code,
 		explanation: `un serveur a RÉPONDU sur ${where} puis a refusé (${code}) — donc quelque chose tient bien ce port. Ce peut être la base attendue avec de mauvais identifiants, mais aussi UN AUTRE SERVEUR (le conteneur d'un autre projet, par exemple) : le refus vient alors d'une base qui n'est pas la vôtre, et vérifier les identifiants ne mène nulle part.${target.port !== null ? ` Pour savoir qui tient ce port : « docker ps --filter publish=${target.port} », ou « ${whoHoldsPort(target.port, platform)} ».` : ""}`
 	};
+	if (code !== null && provesEstablished(code)) return {
+		verdict: "rejected",
+		code,
+		explanation: `la connexion à ${where} a ABOUTI, puis le serveur a refusé une instruction (${code}) — ce n'est ni l'adresse ni l'état de la base : c'est le schéma envoyé (une table, une contrainte, un type) qu'il faut corriger.`
+	};
 	return {
 		verdict: "unknown",
 		code,
 		explanation: `échec de connexion à ${where}${code ? ` (${code})` : ""} — vérifier que l'infrastructure déclarée (NF_DATABASE_URL / connectors) désigne bien la base attendue, et qu'elle est démarrée.`
 	};
 }
+/**
+* Marqueur de la phrase « connecté, puis refusé » — lu par `create app`
+* (`migrationFailureCause`, cœur) pour NE PAS conclure à une base injoignable.
+* Le cœur ne peut pas importer ce paquet : sa copie est éprouvée contre
+* celle-ci par un test de parité.
+*/
+const REJECTED_MARKER = "s'est connecté, mais le serveur a refusé une instruction — ";
+/**
+* Compose le message d'échec au démarrage d'un connecteur — UNE rédaction pour
+* tous les adapters.
+*
+* 🔴 Un refus d'instruction (verdict `rejected`) ne commence JAMAIS par « n'a
+* pas pu se connecter » : c'était faux, et la phrase envoyait vérifier
+* l'adresse et l'état d'une base qui répondait très bien. La cause du pilote
+* passe alors EN TÊTE — c'est elle qui nomme la table ou la contrainte.
+*
+* @param subject - sujet de la phrase (`Drizzle : le connecteur "x" (…)`).
+* @param diagnosis - verdict de {@link diagnoseConnectionFailure}.
+* @param cause - message brut du pilote.
+* @param advice - conseil propre à l'adapter, pour un échec de CONNEXION.
+* @returns le message complet.
+*/
+function describeConnectFailure(subject, diagnosis, cause, advice = "") {
+	if (diagnosis.verdict === "rejected") {
+		const explanation = diagnosis.explanation.charAt(0).toUpperCase() + diagnosis.explanation.slice(1);
+		return `${subject} ${REJECTED_MARKER}${cause}${diagnosis.code ? ` (${diagnosis.code})` : ""}. ${explanation}`;
+	}
+	return `${subject} n'a pas pu se connecter — ${diagnosis.explanation}${advice} Cause : ${cause}`;
+}
 //#endregion
-export { diagnoseConnectionFailure, parseConnectionTarget };
+export { REJECTED_MARKER, describeConnectFailure, diagnoseConnectionFailure, parseConnectionTarget };

package/dist/nodefony/src/criteria.js

@@ -124,8 +124,8 @@ function escapeLikeTerm(text) {
 function likePatternToRegExp(pattern) {
 	let source = "";
 	for (let i = 0; i < pattern.length; i++) {
-		const c = pattern[i];
-		if (c === "\\" && i + 1 < pattern.length) source += escapeRegExpChar(pattern[++i]);
+		const c = pattern.charAt(i);
+		if (c === "\\" && i + 1 < pattern.length) source += escapeRegExpChar(pattern.charAt(++i));
 		else if (c === "%") source += ".*";
 		else if (c === "_") source += ".";
 		else source += escapeRegExpChar(c);
@@ -169,7 +169,8 @@ function searchCriteria(q, fields) {
 	const term = q?.trim();
 	if (!term || fields.length === 0) return null;
 	const likePattern = `${escapeLikeTerm(term)}%`;
-	if (fields.length === 1) return { [fields[0]]: { $like: likePattern } };
+	const only = fields.length === 1 ? fields[0] : void 0;
+	if (only !== void 0) return { [only]: { $like: likePattern } };
 	return { $or: fields.map((f) => ({ [f]: { $like: likePattern } })) };
 }
 //#endregion

package/dist/nodefony/src/errors.js

@@ -72,5 +72,63 @@ var InvalidOrderOption = class extends Error {
 		this.received = received;
 	}
 };
+/**
+* Levée quand une suppression viserait une entité encore RÉFÉRENCÉE par une
+* relation obligatoire d'une autre entité.
+*
+* C'est le pendant, pour un moteur sans clé étrangère (MongoDB), du `restrict`
+* que le SQL généré pose sur une colonne de référence obligatoire : le parent
+* ne part pas tant qu'un enfant le désigne. Sans cette garde, la suppression
+* passait et `?include=` rendait ensuite `null` à la place du parent — une
+* application passée du SQL à MongoDB perdait en silence une garantie qu'elle
+* croyait avoir.
+*
+* Erreur de DONNÉES : c'est la surface API qui la projette (le rendu d'erreur
+* HTTP la reconnaît par son `name` et répond 409).
+*/
+var ReferencedEntityError = class extends Error {
+	/** Entité dont la suppression est refusée (nom logique). */
+	entity;
+	/** Entité qui la référence encore (nom logique). */
+	referencedBy;
+	/** Champ de référence de {@link ReferencedEntityError.referencedBy}. */
+	field;
+	/**
+	* @param entity - entité dont la suppression est refusée.
+	* @param referencedBy - entité qui la référence encore.
+	* @param field - champ de référence obligatoire qui la désigne.
+	*/
+	constructor(entity, referencedBy, field) {
+		super(`Cannot delete "${entity}": still referenced by "${referencedBy}.${field}" (required reference). Delete or reassign the "${referencedBy}" entries first.`);
+		this.name = "ReferencedEntityError";
+		this.entity = entity;
+		this.referencedBy = referencedBy;
+		this.field = field;
+	}
+};
+/**
+* Levée par `ITransaction.savepoint()` / `rollbackTo()` sur un moteur qui ne porte
+* PAS de savepoints (MongoDB).
+*
+* Refuser vaut mieux que se taire : un `rollbackTo()` rendu en no-op laissait
+* l'appelant croire ses écritures annulées alors qu'elles restaient en base. Le
+* refus tombe dès `savepoint()`, pas au `rollbackTo()` : le chemin d'erreur, où
+* l'on annule, est celui qu'on teste le moins — la faute doit se voir au premier
+* essai. Pour annuler, terminer la transaction entière (`rollback()`, ou laisser
+* le callback de `IOrm.transaction()` lever).
+*/
+var SavepointNotSupportedError = class extends Error {
+	/** Moteur qui refuse (valeur de `describeConnection().driver`). */
+	driver;
+	/**
+	* @param driver - moteur qui ne porte pas de savepoints.
+	* @param operation - opération refusée (`savepoint` ou `rollbackTo`).
+	*/
+	constructor(driver, operation) {
+		super(`${operation}() is not supported by the "${driver}" driver: it has no savepoints. Roll back the whole transaction instead (rollback(), or throw from the transaction callback).`);
+		this.name = "SavepointNotSupportedError";
+		this.driver = driver;
+	}
+};
 //#endregion
-export { InvalidOrderOption, UnknownCriteriaField };
+export { InvalidOrderOption, ReferencedEntityError, SavepointNotSupportedError, UnknownCriteriaField };

package/dist/nodefony/src/omitUndefined.js

@@ -0,0 +1,30 @@
+//#region nodefony/src/omitUndefined.ts
+/**
+* Retire les clés qui valent `undefined` d'une donnée d'écriture partielle.
+*
+* `undefined` et clé absente veulent dire « ne pas toucher » : Drizzle ignore
+* déjà une valeur `undefined`, Mongoose (≥ 6) la retire d'une mise à jour. La
+* règle est posée ICI, une fois, au seuil de la persistance, au lieu d'être
+* un comportement propre à chaque adaptateur.
+*
+* Rend l'objet reçu TEL QUEL quand aucune clé ne vaut `undefined` — le cas
+* courant d'un corps JSON, qui ne peut pas en porter : aucune allocation.
+*
+* @param data - données d'écriture, clés `undefined` admises
+* @returns les mêmes données, sans aucune clé `undefined`
+*/
+function omitUndefined(data) {
+	const source = data;
+	for (const key of Object.keys(source)) {
+		if (source[key] !== void 0) continue;
+		const out = {};
+		for (const k of Object.keys(source)) {
+			const value = source[k];
+			if (value !== void 0) out[k] = value;
+		}
+		return out;
+	}
+	return data;
+}
+//#endregion
+export { omitUndefined };