@nodefony/orm-core 10.0.0-beta.2 → 10.0.0-beta.4

package/dist/nodefony/interfaces/IOrmMigrations.js

@@ -1,4 +1,4 @@
-//#region nodefony/interfaces/IOrmMigrations.ts
+// nodefony/interfaces/IOrmMigrations.ts
 /**
 * Y a-t-il un empêchement plutôt qu'un état ?
 *
@@ -8,5 +8,4 @@
 function isMigrationFailure(reply) {
 	return "error" in reply;
 }
-//#endregion
 export { isMigrationFailure };

package/dist/nodefony/src/AbstractCrudService.js

@@ -1,7 +1,7 @@
 import { omitUndefined } from "./omitUndefined.js";
 import { paginate } from "./paginate.js";
 import { Service } from "nodefony";
-//#region nodefony/src/AbstractCrudService.ts
+// nodefony/src/AbstractCrudService.ts
 /**
 * Service CRUD **générique** — socle réutilisable au-dessus d'un {@link IRepository}.
 *
@@ -199,5 +199,4 @@ var AbstractCrudService = class extends Service {
 	/** Effet de bord après suppression (ex. nettoyer un cache). */
 	afterDelete(_criteria, _removed) {}
 };
-//#endregion
 export { AbstractCrudService };

package/dist/nodefony/src/ConnectionMonitor.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/ConnectionMonitor.ts
+// 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). */
@@ -209,5 +209,4 @@ var ConnectionMonitor = class {
 };
 /** Singleton process-wide du moniteur de connexions. */
 const connectionMonitor = new ConnectionMonitor();
-//#endregion
 export { connectionMonitor };

package/dist/nodefony/src/Entity.js

@@ -1,5 +1,5 @@
 import { entityRegistry } from "./EntityRegistry.js";
-//#region nodefony/src/Entity.ts
+// nodefony/src/Entity.ts
 /**
 * Classe de base abstraite d'une entité, indépendante du driver ORM.
 *
@@ -38,5 +38,4 @@ var Entity = class {
 		return this;
 	}
 };
-//#endregion
 export { Entity };

package/dist/nodefony/src/EntityRegistry.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/EntityRegistry.ts
+// nodefony/src/EntityRegistry.ts
 /**
 * Registre cross-ORM des entités, indexé par nom logique puis par connecteur.
 *
@@ -111,5 +111,4 @@ var EntityRegistry = class {
 * (tests).
 */
 const entityRegistry = new EntityRegistry();
-//#endregion
 export { EntityRegistry, entityRegistry };

package/dist/nodefony/src/Orm.js

@@ -2,7 +2,7 @@ import { ormRegistry } from "./OrmRegistry.js";
 import { connectionMonitor } from "./ConnectionMonitor.js";
 import { Service } from "nodefony";
 import { performance } from "node:perf_hooks";
-//#region nodefony/src/Orm.ts
+// nodefony/src/Orm.ts
 /**
 * Période du battement, réglable par l'environnement (`0` le désactive).
 *
@@ -309,5 +309,4 @@ var Orm = class extends Service {
 		return { driver: "" };
 	}
 };
-//#endregion
 export { Orm };

package/dist/nodefony/src/OrmAdminApi.js

@@ -4,7 +4,7 @@ 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
+// nodefony/src/OrmAdminApi.ts
 /**
 * Producteur `IAdminApi` du **modèle de données ORM** — exposé sous
 * `/nodefony/orm/api/*`. Fondation « IA-first » : construit le graphe canonique
@@ -109,7 +109,7 @@ function buildOrmSummaries() {
 	const names = ormRegistry.list();
 	const carrier = storeCarrier(Nodefony.getKernel()?.storeResolutions ?? [], names);
 	return names.map((name) => {
-		let connected = false;
+		let connected;
 		let vendor = "";
 		let connection;
 		try {
@@ -136,7 +136,7 @@ function buildOrmSummaries() {
 */
 function buildEntityNode(connector, name) {
 	const entity = entityRegistry.get(name, connector);
-	let columns = [];
+	let columns;
 	try {
 		columns = ormRegistry.get(connector).describeEntity?.(name) ?? [];
 	} catch {
@@ -275,7 +275,7 @@ async function buildConnectionHealth(filter) {
 */
 function buildOrmFlow(filter) {
 	const connectors = ormRegistry.list().filter((n) => !filter || n === filter).map((name) => {
-		let vendor = "";
+		let vendor;
 		try {
 			vendor = vendorOf(ormRegistry.get(name));
 		} catch {
@@ -529,5 +529,4 @@ function registerOrmAdminApi(registry) {
 	if (registry.has("orm")) return;
 	registry.register(createOrmAdminApi());
 }
-//#endregion
 export { buildConnectionHealth, buildOrmFlow, buildOrmGraph, createOrmAdminApi, registerOrmAdminApi, storeCarrier, toDbml, toJsonSchema };

package/dist/nodefony/src/OrmRegistry.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/OrmRegistry.ts
+// nodefony/src/OrmRegistry.ts
 /**
 * Registre process-wide des instances ORM enregistrées sous un nom unique.
 *
@@ -71,5 +71,4 @@ var OrmRegistry = class {
 * instanciable séparément pour des registres isolés (tests).
 */
 const ormRegistry = new OrmRegistry();
-//#endregion
 export { OrmRegistry, ormRegistry };

package/dist/nodefony/src/QueryFlowMonitor.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/QueryFlowMonitor.ts
+// nodefony/src/QueryFlowMonitor.ts
 /** Taille max du ring de requêtes lentes (borne mémoire). */
 const MAX_SLOW = 20;
 /** Facteur de lissage EWMA (0–1) : plus haut = suit plus vite les variations. */
@@ -124,5 +124,4 @@ var QueryFlowMonitor = class {
 };
 /** Singleton process-wide de la sonde de flux ORM. */
 const queryFlowMonitor = new QueryFlowMonitor();
-//#endregion
 export { queryFlowMonitor };

package/dist/nodefony/src/buildOrmLeanHealth.js

@@ -1,7 +1,7 @@
 import { ormRegistry } from "./OrmRegistry.js";
 import { connectionMonitor } from "./ConnectionMonitor.js";
 import { queryFlowMonitor } from "./QueryFlowMonitor.js";
-//#region nodefony/src/buildOrmLeanHealth.ts
+// nodefony/src/buildOrmLeanHealth.ts
 /**
 * **Santé ORM lean per-instance** — somme process-wide de tous les connecteurs enregistrés,
 * destinée à voyager dans le report de sonde cluster (« ORM par worker »). C'est la fonction
@@ -50,5 +50,4 @@ function buildOrmLeanHealth() {
 		maxEwmaMs
 	};
 }
-//#endregion
 export { buildOrmLeanHealth, buildOrmLeanHealth as default };

package/dist/nodefony/src/connectDeadline.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/connectDeadline.ts
+// nodefony/src/connectDeadline.ts
 /**
 * Le DÉLAI DE GARDE d'une connexion à une base — une commande n'attend jamais
 * sans fin.
@@ -63,5 +63,4 @@ async function withConnectDeadline(work, what, ms = CONNECT_TIMEOUT_MS) {
 		if (timer !== void 0) clearTimeout(timer);
 	}
 }
-//#endregion
 export { CONNECT_TIMEOUT_MS, withConnectDeadline };

package/dist/nodefony/src/connectionDiagnosis.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/connectionDiagnosis.ts
+// nodefony/src/connectionDiagnosis.ts
 /**
 * Personne n'écoute : la couche transport a refusé ou n'a trouvé personne.
 * Ces codes viennent du système, pas du serveur de base de données.
@@ -68,29 +68,78 @@ function readCode(error) {
 	return typeof carrier.code === "number" ? String(carrier.code) : null;
 }
 /**
-* Extrait l'hôte et le port d'une URL de connexion, sans son secret.
+* Extrait l'hôte, le port, la base et le compte d'une URL de connexion, sans
+* son secret.
 *
 * @param url - URL de connexion (`postgres://…`, `mysql://…`, `mongodb://…`).
 * @returns l'adresse visée ; champs à `null` si l'URL est absente ou illisible.
 */
 function parseConnectionTarget(url) {
-	if (!url) return {
+	const none = {
 		host: null,
-		port: null
+		port: null,
+		database: null,
+		user: null
 	};
+	if (!url) return none;
 	try {
 		const parsed = new URL(url);
 		const port = parsed.port ? Number(parsed.port) : null;
+		const database = decodeURIComponent(parsed.pathname.slice(1));
+		const user = decodeURIComponent(parsed.username);
 		return {
 			host: parsed.hostname || null,
-			port: Number.isFinite(port) ? port : null
+			port: Number.isFinite(port) ? port : null,
+			database: database || null,
+			user: user || null
 		};
 	} catch {
-		return {
-			host: null,
-			port: null
-		};
+		return none;
+	}
+}
+/**
+* Identifiant PostgreSQL entre guillemets — un nom de base peut porter un
+* tiret ou une majuscule, que PostgreSQL plierait ou refuserait nu.
+*/
+function quotePgIdent(name) {
+	return `"${name.replaceAll("\"", "\"\"")}"`;
+}
+/** Identifiant MySQL/MariaDB entre accents graves. */
+function quoteMysqlIdent(name) {
+	return `\`${name.replaceAll("`", "``")}\``;
+}
+/** Chaîne SQL MySQL/MariaDB entre apostrophes (nom de compte d'un `GRANT`). */
+function quoteMysqlString(value) {
+	return `'${value.replaceAll("'", "''")}'`;
+}
+/**
+* La base désignée manque — ou, sous MySQL/MariaDB, le compte n'y a aucun
+* droit, ce que le serveur ne distingue pas.
+*
+* Les trois codes ne sortent qu'APRÈS l'acceptation du mot de passe (constaté :
+* un mauvais mot de passe rend `28P01` ou `ER_ACCESS_DENIED_ERROR`, même sur
+* une base absente). Vérifier les identifiants n'est donc pas le geste : il
+* faut créer la base, avec un compte qui en a le droit — l'application ne la
+* crée jamais, un compte capable de créer des bases l'est aussi d'en supprimer.
+*
+* @returns l'explication rédigée, ou `null` si le code n'est pas celui d'une
+*   base absente ou si l'URL ne nomme pas la base.
+*/
+function describeMissingDatabase(code, target, where, portHint) {
+	const database = target.database;
+	if (!database) return null;
+	const account = target.user ? ` « ${target.user} »` : "";
+	const how = "La créer avec un compte qui en a le droit (administrateur du serveur, ou celui du conteneur dans le décor docker), puis relancer : ";
+	const elsewhere = portHint ? ` Si cette base devrait déjà exister, vérifier que ce port est bien tenu par VOTRE serveur.${portHint}` : "";
+	if (code === "3D000") {
+		const owner = target.user ? ` OWNER ${quotePgIdent(target.user)}` : "";
+		return `la base « ${database} » n'existe pas sur le serveur ${where} (${code}) — le serveur a répondu et accepté le compte${account}, mais l'application ne crée jamais sa base (CREATE DATABASE est un privilège d'administration). ${how}CREATE DATABASE ${quotePgIdent(database)}${owner};${elsewhere}`;
 	}
+	if (code === "ER_BAD_DB_ERROR" || code === "ER_DBACCESS_DENIED_ERROR") {
+		const grant = target.user ? ` GRANT ALL PRIVILEGES ON ${quoteMysqlIdent(database)}.* TO ${quoteMysqlString(target.user)}@'%';` : "";
+		return `${code === "ER_DBACCESS_DENIED_ERROR" ? `le compte${account} n'a accès à aucune base « ${database} » sur le serveur ${where} (${code}) : soit elle n'existe pas, soit elle existe sans droit pour ce compte — MySQL ne dit pas lequel. ` : `la base « ${database} » n'existe pas sur le serveur ${where} (${code}). `}Le mot de passe a été accepté, et l'application ne crée jamais sa base (privilège d'administration). ${how}CREATE DATABASE IF NOT EXISTS ${quoteMysqlIdent(database)};${grant}` + elsewhere;
+	}
+	return null;
 }
 /**
 * La commande qui nomme QUI tient un port, sur la plateforme visée.
@@ -123,11 +172,20 @@ function diagnoseConnectionFailure(error, target = {
 		code,
 		explanation: `personne n'écoute sur ${where} (${code}) — la base n'est pas démarrée, ou l'adresse configurée n'est pas la sienne.`
 	};
-	if (code !== null && ANSWERED_CODES.has(code)) return {
-		verdict: "answered",
-		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 && ANSWERED_CODES.has(code)) {
+		const portHint = target.port !== null ? ` Pour savoir qui tient ce port : « docker ps --filter publish=${target.port} », ou « ${whoHoldsPort(target.port, platform)} ».` : "";
+		const missing = describeMissingDatabase(code, target, where, portHint);
+		if (missing !== null) return {
+			verdict: "answered",
+			code,
+			explanation: missing
+		};
+		return {
+			verdict: "answered",
+			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.${portHint}`
+		};
+	}
 	if (code !== null && provesEstablished(code)) return {
 		verdict: "rejected",
 		code,
@@ -168,5 +226,4 @@ function describeConnectFailure(subject, diagnosis, cause, advice = "") {
 	}
 	return `${subject} n'a pas pu se connecter — ${diagnosis.explanation}${advice} Cause : ${cause}`;
 }
-//#endregion
 export { REJECTED_MARKER, describeConnectFailure, diagnoseConnectionFailure, parseConnectionTarget };

package/dist/nodefony/src/criteria.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/criteria.ts
+// nodefony/src/criteria.ts
 /**
 * Liste figée des opérateurs riches reconnus dans un critère portable.
 *
@@ -173,5 +173,4 @@ function searchCriteria(q, fields) {
 	if (only !== void 0) return { [only]: { $like: likePattern } };
 	return { $or: fields.map((f) => ({ [f]: { $like: likePattern } })) };
 }
-//#endregion
 export { LIKE_ESCAPE_CHAR, OPERATOR_KEYS, UPDATE_OPERATOR_KEYS, escapeLikeTerm, isFieldOperators, isUpdateOperators, likePatternToRegExp, searchCriteria };

package/dist/nodefony/src/decorators/entitiesDecorator.js

@@ -1,5 +1,5 @@
 import { entityRegistry } from "../EntityRegistry.js";
-//#region nodefony/src/decorators/entitiesDecorator.ts
+// nodefony/src/decorators/entitiesDecorator.ts
 /** Connecteur retenu quand ni l'entité ni le décorateur n'en nomment un. */
 const DEFAULT_CONNECTOR = "default";
 /**
@@ -63,5 +63,4 @@ function entities(list, options = {}) {
 		return NewConstructorEntities;
 	};
 }
-//#endregion
 export { DEFAULT_CONNECTOR, entities };

package/dist/nodefony/src/decorators/entityDecorator.js

@@ -1,6 +1,6 @@
 import { entityRegistry } from "../EntityRegistry.js";
 import { setEntityMeta } from "./metadataStore.js";
-//#region nodefony/src/decorators/entityDecorator.ts
+// nodefony/src/decorators/entityDecorator.ts
 /**
 * Décore une classe comme entité multi-ORM et l'enregistre au chargement.
 *
@@ -47,5 +47,4 @@ function entity(options) {
 		return target;
 	};
 }
-//#endregion
 export { entity };

package/dist/nodefony/src/decorators/metadataStore.js

@@ -1,10 +1,10 @@
-//#region nodefony/src/decorators/metadataStore.ts
+// nodefony/src/decorators/metadataStore.ts
 /**
 * Stockage des métadonnées de décorateurs SANS `reflect-metadata`.
 *
 * orm-core est une lib pure : aucune dépendance runtime hors `nodefony`. Les
-* décorateurs `@entity`/`@repository` ne lisent jamais les types émis par TS
-* (`design:paramtypes`), donc un `WeakMap<classe, métadonnée>` process-wide
+* décorateurs `@entity`/`@repository` ne lisent jamais les métadonnées de type
+* émises par le compilateur, donc un `WeakMap<classe, métadonnée>` process-wide
 * suffit — clé = constructeur, GC-friendly (pas de fuite si la classe est
 * déréférencée). Aucun polyfill Reflect requis.
 */
@@ -34,5 +34,4 @@ function getRepositoryMeta(target) {
 function hasRepositoryMeta(target) {
 	return REPOSITORY_META.has(target);
 }
-//#endregion
 export { getEntityMeta, getRepositoryMeta, hasEntityMeta, hasRepositoryMeta, setEntityMeta, setRepositoryMeta };

package/dist/nodefony/src/decorators/repositoryDecorator.js

@@ -1,5 +1,5 @@
 import { setRepositoryMeta } from "./metadataStore.js";
-//#region nodefony/src/decorators/repositoryDecorator.ts
+// nodefony/src/decorators/repositoryDecorator.ts
 /**
 * Décore une classe comme repository d'une entité (tag métadonnée pur).
 *
@@ -31,5 +31,4 @@ function repository(name, options) {
 		return target;
 	};
 }
-//#endregion
 export { repository };

package/dist/nodefony/src/defineEntity.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/defineEntity.ts
+// nodefony/src/defineEntity.ts
 /**
 * Déclare une entité applicative. Fonction d'**identité typée** : elle ne fait
 * qu'attacher le type — aucun effet de bord, aucun enregistrement.
@@ -23,5 +23,4 @@
 function defineEntity(definition) {
 	return definition;
 }
-//#endregion
 export { defineEntity };

package/dist/nodefony/src/errors.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/errors.ts
+// nodefony/src/errors.ts
 /**
 * Erreurs typées du socle ORM — **data-level uniquement** (aucun couplage à une
 * couche API/transport : ces erreurs décrivent des fautes sur les données, pas
@@ -130,5 +130,4 @@ var SavepointNotSupportedError = class extends Error {
 		this.driver = driver;
 	}
 };
-//#endregion
 export { InvalidOrderOption, ReferencedEntityError, SavepointNotSupportedError, UnknownCriteriaField };

package/dist/nodefony/src/omitUndefined.js

@@ -1,4 +1,4 @@
-//#region nodefony/src/omitUndefined.ts
+// nodefony/src/omitUndefined.ts
 /**
 * Retire les clés qui valent `undefined` d'une donnée d'écriture partielle.
 *
@@ -26,5 +26,4 @@ function omitUndefined(data) {
 	}
 	return data;
 }
-//#endregion
 export { omitUndefined };

package/dist/nodefony/src/ormWiring.js

@@ -2,7 +2,7 @@ import { ormRegistry } from "./OrmRegistry.js";
 import { buildConnectionHealth, buildOrmFlow, registerOrmAdminApi } from "./OrmAdminApi.js";
 import { buildOrmLeanHealth } from "./buildOrmLeanHealth.js";
 import { setOrmHealthProvider, setOrmRichProvider } from "nodefony";
-//#region nodefony/src/ormWiring.ts
+// nodefony/src/ormWiring.ts
 /**
 * Branche le « plan d'administration » ORM dans le kernel — montage **idempotent**
 * appelé par CHAQUE driver à son `onKernelBoot`. Factorise la dette C5 : le bloc
@@ -74,5 +74,4 @@ function resolveOrmFlowEnabled(kernel) {
 	const flag = process.env.NF_ORM_FLOW;
 	return flag !== void 0 ? flag === "1" || flag === "true" : kernel?.environment !== "production";
 }
-//#endregion
 export { reportOrmBootLines, resolveOrmFlowEnabled, wireOrmAdminPlane };

package/dist/nodefony/src/orphanEntities.js

@@ -1,6 +1,6 @@
 import { ormRegistry } from "./OrmRegistry.js";
 import { entityRegistry } from "./EntityRegistry.js";
-//#region nodefony/src/orphanEntities.ts
+// nodefony/src/orphanEntities.ts
 /**
 * Entités inscrites sur un connecteur qu'aucun ORM n'a ouvert.
 *
@@ -59,5 +59,4 @@ function reportOrphanEntities(log, owner, declared = []) {
 	if (message !== null) log(message, "WARNING");
 	return message;
 }
-//#endregion
 export { describeOrphanEntities, findOrphanEntities, reportOrphanEntities };

package/dist/nodefony/src/paginate.js

@@ -1,6 +1,6 @@
 import { searchCriteria } from "./criteria.js";
 import { PageQueryError } from "nodefony";
-//#region nodefony/src/paginate.ts
+// nodefony/src/paginate.ts
 /**
 * Pagine un {@link IRepository} de façon **portable** — au-dessus des primitives
 * natives `find(criteria, { limit, offset, order })` et `count(criteria)` que tout
@@ -51,5 +51,4 @@ async function paginate(repo, page, options = {}) {
 		total: withTotal ? await repo.count(criteria) : void 0
 	};
 }
-//#endregion
 export { paginate };

package/dist/nodefony/src/readOptions.js

@@ -1,5 +1,5 @@
 import { InvalidOrderOption } from "./errors.js";
-//#region nodefony/src/readOptions.ts
+// nodefony/src/readOptions.ts
 /**
 * Décrit la FORME d'une valeur reçue, sans jamais en révéler le contenu.
 *
@@ -48,5 +48,4 @@ function assertOrderOption(order, entity) {
 		}
 	}
 }
-//#endregion
 export { assertOrderOption };

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

@@ -44,9 +44,17 @@ export interface IConnectionDiagnosis {
 export interface IConnectionTarget {
     host: string | null;
     port: number | null;
+    /**
+     * Nom de la base désignée par l'URL — de quoi NOMMER une base absente et
+     * écrire la commande qui la crée. Absent : la phrase n'en parle pas.
+     */
+    database?: string | null;
+    /** Compte de connexion (jamais son mot de passe) — propriétaire de la base à créer. */
+    user?: string | null;
 }
 /**
- * Extrait l'hôte et le port d'une URL de connexion, sans son secret.
+ * Extrait l'hôte, le port, la base et le compte d'une URL de connexion, sans
+ * son secret.
  *
  * @param url - URL de connexion (`postgres://…`, `mysql://…`, `mongodb://…`).
  * @returns l'adresse visée ; champs à `null` si l'URL est absente ou illisible.