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

package/dist/nodefony/src/orphanEntities.js

@@ -0,0 +1,63 @@
+import { ormRegistry } from "./OrmRegistry.js";
+import { entityRegistry } from "./EntityRegistry.js";
+//#region nodefony/src/orphanEntities.ts
+/**
+* Entités inscrites sur un connecteur qu'aucun ORM n'a ouvert.
+*
+* Une telle entité ne sera servie par rien : son dépôt lèvera au premier
+* appel, loin de sa cause. Vécu : sur une infra MongoDB, le `User` d'une
+* application restait écrit en table SQL sur `default` — un connecteur que
+* Drizzle n'ouvre pas sur cette infra — et le boot n'en disait RIEN.
+*
+* @param entities - entités inscrites (registre des entités).
+* @param connectors - connecteurs ouverts (registre des ORM).
+* @returns les orphelines, dans l'ordre d'inscription.
+*/
+function findOrphanEntities(entities, connectors) {
+	return entities.filter((e) => !connectors.includes(e.connector));
+}
+/**
+* La phrase qui NOMME les orphelines et le remède — `null` s'il n'y en a pas.
+*
+* @param orphans - entités sans connecteur ouvert.
+* @param connectors - connecteurs ouverts, cités pour situer la faute.
+* @param declared - connecteurs DÉCLARÉS par les modules ORM (leur configuration).
+*/
+function describeOrphanEntities(orphans, connectors, declared = []) {
+	if (orphans.length === 0) return null;
+	const name = (e) => `${e.name}${e.module ? `@${e.module}` : ""} → « ${e.connector} »`;
+	const open = `Connecteurs ouverts : ${connectors.length > 0 ? connectors.join(", ") : "aucun"}.`;
+	const skipped = orphans.filter((e) => declared.includes(e.connector));
+	const unknown = orphans.filter((e) => !declared.includes(e.connector));
+	const parts = [];
+	if (unknown.length > 0) parts.push(`${unknown.length} entité(s) inscrite(s) sur un connecteur qu'aucun ORM n'a ouvert — rien ne les servira, leur dépôt lèvera au premier appel : ${unknown.map(name).join(", ")}. ${open} Une entité doit suivre la base déclarée (NF_DATABASE_URL) : table SQL sur une infra SQL, document sur MongoDB. État réel : npx nodefony inspect entities.`);
+	if (skipped.length > 0) parts.push(`${skipped.length} entité(s) sur un connecteur DÉCLARÉ mais jamais ouvert : ${skipped.map(name).join(", ")}. Ce n'est pas leur déclaration qui est en cause : un connecteur a échoué au démarrage (voir l'erreur de connexion plus haut), et ceux qui le suivent n'ont pas été ouverts. ${open}`);
+	return parts.join(" ");
+}
+/** Les démarrages déjà rapportés — un Kernel ne le dit qu'une fois. */
+const reported = /* @__PURE__ */ new WeakSet();
+/**
+* Signale UNE fois par démarrage les entités orphelines, au moment où tous les
+* ORM sont ouverts.
+*
+* Appelée par chaque module ORM (Drizzle, Mongoose) à `onReady` : la règle vit
+* ici, une fois, et le premier appel la rend — le second se tait, sans quoi une
+* application qui charge les deux ORM lirait deux fois le même avertissement.
+* La garde porte sur le KERNEL et non sur le process : un process qui démarre
+* plusieurs noyaux (une suite de tests) doit être prévenu à chacun.
+*
+* @param log - journal du module appelant.
+* @param owner - le démarrage concerné (le Kernel), clé de la garde.
+* @param declared - connecteurs que l'appelant a DÉCLARÉS (sa configuration).
+* @returns le message rendu, ou `null` (rien à dire, ou déjà dit).
+*/
+function reportOrphanEntities(log, owner, declared = []) {
+	if (reported.has(owner)) return null;
+	reported.add(owner);
+	const connectors = ormRegistry.list();
+	const message = describeOrphanEntities(findOrphanEntities(entityRegistry.list(), connectors), connectors, declared);
+	if (message !== null) log(message, "WARNING");
+	return message;
+}
+//#endregion
+export { describeOrphanEntities, findOrphanEntities, reportOrphanEntities };

package/dist/types/index.d.ts

@@ -7,15 +7,16 @@
  * Module, pas d'enregistrement dans `@modules()`. Les drivers concrets sont les
  * Modules ; ils s'enregistrent eux-mêmes dans le `OrmRegistry` à leur boot.
  */
-export type { IOrm, IEntity, IEntityRelation, IRepository, OrmCriteria, Criteria, FieldCriteria, FieldOperators, UpdateData, UpdateOperators, RepositoryReadOptions, ITransaction, IPage, IPageQuery, PageQuery, } from "./nodefony/interfaces/index.js";
+export type { IOrm, IEntity, IEntityIndex, IEntityRelation, IRepository, OrmCriteria, Criteria, FieldCriteria, FieldOperators, UpdateData, UpdateOperators, RepositoryReadOptions, ITransaction, IPage, IPageQuery, PageQuery, } from "./nodefony/interfaces/index.js";
 export { OPERATOR_KEYS, isFieldOperators, searchCriteria, LIKE_ESCAPE_CHAR, escapeLikeTerm, likePatternToRegExp, } from "./nodefony/src/criteria.js";
 export type { OperatorKey } from "./nodefony/src/criteria.js";
 export { UPDATE_OPERATOR_KEYS, isUpdateOperators, } from "./nodefony/src/criteria.js";
 export type { UpdateOperatorKey } from "./nodefony/src/criteria.js";
-export { UnknownCriteriaField, InvalidOrderOption, } from "./nodefony/src/errors.js";
+export { UnknownCriteriaField, InvalidOrderOption, ReferencedEntityError, SavepointNotSupportedError, } from "./nodefony/src/errors.js";
 export { assertOrderOption } from "./nodefony/src/readOptions.js";
 export { OrmRegistry, ormRegistry } from "./nodefony/src/OrmRegistry.js";
 export { EntityRegistry, entityRegistry } from "./nodefony/src/EntityRegistry.js";
+export { reportOrphanEntities } from "./nodefony/src/orphanEntities.js";
 export { Orm } from "./nodefony/src/Orm.js";
 export { Entity } from "./nodefony/src/Entity.js";
 export { AbstractCrudService } from "./nodefony/src/AbstractCrudService.js";
@@ -25,12 +26,12 @@ export { buildOrmGraph, buildConnectionHealth, buildOrmFlow, toDbml, toJsonSchem
 export { queryFlowMonitor } from "./nodefony/src/QueryFlowMonitor.js";
 export { connectionMonitor } from "./nodefony/src/ConnectionMonitor.js";
 export { buildOrmLeanHealth } from "./nodefony/src/buildOrmLeanHealth.js";
-export { diagnoseConnectionFailure, parseConnectionTarget, } from "./nodefony/src/connectionDiagnosis.js";
+export { diagnoseConnectionFailure, describeConnectFailure, parseConnectionTarget, REJECTED_MARKER, } from "./nodefony/src/connectionDiagnosis.js";
 export type { ConnectionVerdict, IConnectionDiagnosis, IConnectionTarget, } from "./nodefony/src/connectionDiagnosis.js";
 export { CONNECT_TIMEOUT_MS, withConnectDeadline, } from "./nodefony/src/connectDeadline.js";
 export { wireOrmAdminPlane, resolveOrmFlowEnabled, reportOrmBootLines, } from "./nodefony/src/ormWiring.js";
 export type { ISlowQuery, IQueryFlow, IOrmFlowReport, } from "./nodefony/interfaces/IOrmFlow.js";
-export type { IColumnInfo, IConnectionInfo, IRelationInfo, IEntityGraphNode, IOrmSummary, IOrmGraph, IConnectionError, IConnectionHealth, } from "./nodefony/interfaces/IOrmGraph.js";
+export type { IColumnInfo, IConnectionInfo, IRelationInfo, IEntityGraphNode, IOrmSummary, IOrmGraph, IConnectionError, IConnectionEvent, IOrmResilience, IConnectionHealth, } from "./nodefony/interfaces/IOrmGraph.js";
 export type { ILatencyWindow, IOrmStorageProbe, IOrmPoolProbe, IOrmProbe, } from "./nodefony/interfaces/IOrmProbe.js";
 export type { IOrmMigrationAction, IOrmMigrationEntry, IOrmMigrationSource, IOrmMigrationStatus, IOrmMigrationFailure, IOrmMigrationReply, IOrmPendingMigration, IOrmMigrationPlan, IOrmMigrationPlanReply, IOrmMigrationApplied, IOrmMigrationApplyReply, } from "./nodefony/interfaces/IOrmMigrations.js";
 export { isMigrationFailure } from "./nodefony/interfaces/IOrmMigrations.js";

package/dist/types/nodefony/interfaces/IEntity.d.ts

@@ -30,6 +30,19 @@ export interface IEntityRelation {
  * @typeParam S - type du schéma natif du driver.
  * @typeParam M - type du modèle compilé natif du driver.
  */
+/**
+ * Index COMPOSITE déclaré par une entité, pour l'adapter qui ne sait pas
+ * l'exprimer dans son schéma (Mongoose : un `SchemaDefinition` plat n'a d'index
+ * que par champ).
+ */
+export interface IEntityIndex {
+    /** Champs et sens, dans l'ORDRE de l'index (`1` croissant, `-1` décroissant). */
+    readonly fields: Readonly<Record<string, 1 | -1>>;
+    /** Contrainte d'unicité sur la combinaison. */
+    readonly unique?: boolean;
+    /** Nom de l'index en base (sinon celui que le driver dérive des champs). */
+    readonly name?: string;
+}
 export interface IEntity<S = unknown, M = unknown> {
     /** Nom logique de l'entité (clé de lookup, ex. `"User"`). */
     readonly name: string;
@@ -40,7 +53,7 @@ export interface IEntity<S = unknown, M = unknown> {
      * **Optionnel** : sert au regroupement dans le graphe canonique / ERD Studio.
      * Non renseigné → entité non rattachée (groupe « — » côté UI).
      */
-    readonly module?: string;
+    readonly module?: string | undefined;
     /**
      * **Classification** de l'entité (ex. domaine fonctionnel `"facturation"`,
      * `"comptabilité"`) — axe de regroupement **distinct** du `module`
@@ -48,7 +61,7 @@ export interface IEntity<S = unknown, M = unknown> {
      * base** (centaines de tables d'un même module) : l'ERD groupe/filtre par
      * `domain`. **Optionnel** ; non renseigné → retombe sur `module`.
      */
-    readonly domain?: string;
+    readonly domain?: string | undefined;
     /** Définition de schéma propre au driver (forme libre). */
     readonly schema: S;
     /** Modèle compilé natif, renseigné après connexion de l'ORM. */
@@ -59,7 +72,13 @@ export interface IEntity<S = unknown, M = unknown> {
      * schema-as-code (Drizzle) les expriment en colonnes → ce flag y est sans effet.
      * **Optionnel**, défaut `false`.
      */
-    readonly timestamps?: boolean;
+    readonly timestamps?: boolean | undefined;
     /** Relations déclarées vers d'autres entités (par nom logique). */
-    readonly relations?: ReadonlyArray<IEntityRelation>;
+    readonly relations?: ReadonlyArray<IEntityRelation> | undefined;
+    /**
+     * Index composites, appliqués par l'adapter qui les exprime hors schéma
+     * (Mongoose `schema.index()`). Les ORM schema-as-code (Drizzle) les déclarent
+     * dans leur table → ce champ y est sans effet. **Optionnel**.
+     */
+    readonly indexes?: ReadonlyArray<IEntityIndex> | undefined;
 }

package/dist/types/nodefony/interfaces/IOrm.d.ts

@@ -1,6 +1,6 @@
 import type { IRepository } from "./IRepository.js";
 import type { ITransaction } from "./ITransaction.js";
-import type { IColumnInfo, IConnectionInfo } from "./IOrmGraph.js";
+import type { IOrmResilience, IColumnInfo, IConnectionInfo } from "./IOrmGraph.js";
 import type { IOrmProbe } from "./IOrmProbe.js";
 import type { IOrmMigrationApplyReply, IOrmMigrationPlanReply, IOrmMigrationReply } from "./IOrmMigrations.js";
 /**
@@ -73,6 +73,15 @@ export interface IOrm {
      * @returns infos de connexion, ou `undefined` si non implémenté.
      */
     describeConnection?(): IConnectionInfo;
+    /**
+     * Décrit le mécanisme de résilience tel qu'il tourne (battement, perte en
+     * souffrance) pour le data plane. **Optionnel** : la classe `Orm` l'implémente
+     * pour tous ses adapters ; un ORM qui ne dérive pas d'elle laisse le
+     * diagnostic sans cette section.
+     *
+     * @returns l'état du mécanisme.
+     */
+    describeResilience?(): IOrmResilience;
     /**
      * Ping bas-coût de la connexion (round-trip réel vers la base) pour le
      * diagnostic du data plane. **Optionnel** : un adapter qui ne l'implémente pas

package/dist/types/nodefony/interfaces/IOrmFlow.d.ts

@@ -26,7 +26,7 @@ export interface ISlowQuery {
     /** Connecteur ORM (clé du registre). */
     connector: string;
     /** SQL paramétré et redacté (absent si l'adapter ne sait pas l'extraire). */
-    sql?: string;
+    sql?: string | undefined;
 }
 /**
  * Compteurs de flux d'UN connecteur ORM. Cumuls depuis le boot (le débit/s se

package/dist/types/nodefony/interfaces/IOrmGraph.d.ts

@@ -32,7 +32,7 @@ export interface IRelationInfo {
     /** Champ portant la relation côté entité courante. */
     field: string;
     /** Clé étrangère (explicite ou dérivée déterministe). */
-    foreignKey?: string;
+    foreignKey?: string | undefined;
 }
 /** Nœud du graphe : une entité avec ses colonnes et ses relations. */
 export interface IEntityGraphNode {
@@ -66,11 +66,11 @@ export interface IConnectionInfo {
      * `host:port/base` (serveur) ou URI redactée. **Jamais de credential** (mot de
      * passe retiré côté adapter).
      */
-    target?: string;
+    target?: string | undefined;
     /** Version du moteur/base (ex. SQLite `3.45.1`), si l'adapter peut l'obtenir. */
-    version?: string;
+    version?: string | undefined;
     /** Version de la lib ORM elle-même (ex. drizzle-orm `0.44.x`), si connue. */
-    ormVersion?: string;
+    ormVersion?: string | undefined;
 }
 /** Résumé d'un ORM/connecteur enregistré. */
 export interface IOrmSummary {
@@ -82,14 +82,18 @@ export interface IOrmSummary {
      * `IOrm.vendor` déclaré par chaque adapter (P7.1 industrialisation ORM).
      */
     vendor: string;
-    /** `true` si c'est le connecteur par défaut (`"default"`). */
+    /**
+     * `true` pour le connecteur par défaut : celui qui porte les stores de
+     * l'application (un RÔLE constaté, pas le nom `"default"` — repli sur ce nom
+     * seulement quand aucun store n'est porté par un ORM).
+     */
     default: boolean;
     /** État de la connexion. */
     connected: boolean;
     /** Nombre d'entités rattachées à cet ORM. */
     entityCount: number;
     /** Connexion sous-jacente (driver + cible), si l'adapter l'expose. */
-    connection?: IConnectionInfo;
+    connection?: IConnectionInfo | undefined;
 }
 /** Erreur de connexion horodatée (message **redacté** — jamais de credential). */
 export interface IConnectionError {
@@ -98,6 +102,37 @@ export interface IConnectionError {
     /** Horodatage epoch ms. */
     ts: number;
 }
+/**
+ * Un événement de vie de la connexion : une PERTE ou une REPRISE, constatée
+ * par l'adapter (événement du driver) ou par le battement de cœur.
+ */
+export interface IConnectionEvent {
+    /** `lost` : la base a cessé de répondre ; `restored` : elle répond à nouveau. */
+    kind: "lost" | "restored";
+    /** Horodatage epoch ms. */
+    ts: number;
+    /** Cause de la perte (credential déjà retiré) — absente pour une reprise. */
+    reason?: string | undefined;
+}
+/**
+ * Le mécanisme de résilience d'un connecteur, TEL QU'IL TOURNE dans ce process.
+ *
+ * Rend lisible ce qui décide de « connecté / perdu / rétabli » : un pilote qui
+ * surveille ses serveurs (MongoDB) le sait seul ; les autres ne l'apprennent
+ * que par une requête, d'où le battement de cœur que porte la classe `Orm`.
+ */
+export interface IOrmResilience {
+    /** Période du battement (ms) ; `0` = désactivé (`NF_ORM_HEARTBEAT_MS=0`). */
+    heartbeatMs: number;
+    /** Délai au-delà duquel un battement sans réponse vaut une perte (ms). */
+    heartbeatTimeoutMs: number;
+    /** Le battement tourne-t-il en ce moment ? */
+    heartbeatActive: boolean;
+    /** L'adapter sait-il répondre à `ping()` (condition du battement) ? */
+    pingable: boolean;
+    /** Une perte est-elle constatée et PAS ENCORE réparée ? */
+    lostPending: boolean;
+}
 /**
  * Diagnostic d'un connecteur — réponse de `/nodefony/orm/api/connection/health`.
  * Combine l'état figé ({@link IConnectionInfo}), les compteurs de cycle de vie
@@ -118,11 +153,11 @@ export interface IConnectionHealth {
     /** Base/driver (`sqlite`, `mongodb`…). */
     driver: string;
     /** Cible lisible (chemin relatif / host:port), jamais de credential. */
-    target?: string;
+    target?: string | undefined;
     /** Version moteur. */
-    version?: string;
+    version?: string | undefined;
     /** Version lib ORM. */
-    ormVersion?: string;
+    ormVersion?: string | undefined;
     /** État courant (`isConnected`). */
     connected: boolean;
     /** Connecté depuis (epoch ms), `null` si jamais connecté. */
@@ -131,8 +166,18 @@ export interface IConnectionHealth {
     uptimeMs: number | null;
     /** Nombre total de connexions réussies. */
     connectCount: number;
-    /** Reconnexions (connexions au-delà de la première). */
+    /** Reprises CONSTATÉES après une perte (jamais déduites des connexions). */
     reconnectCount: number;
+    /** Pertes constatées depuis le démarrage du process. */
+    lostCount: number;
+    /** Dernière perte (epoch ms), `null` si aucune. */
+    lastLostAt: number | null;
+    /** Dernière reprise (epoch ms), `null` si aucune. */
+    lastRestoredAt: number | null;
+    /** Pertes et reprises récentes (ring borné, plus récentes d'abord). */
+    events: IConnectionEvent[];
+    /** Mécanisme de détection et de reprise, si l'ORM le décrit. */
+    resilience?: IOrmResilience | undefined;
     /** Nombre total d'erreurs enregistrées (connexion + ping). */
     errorCount: number;
     /** Dernière erreur, `null` si aucune. */
@@ -150,11 +195,11 @@ export interface IConnectionHealth {
     /** Fenêtre glissante de latence (min/moy/max sur les N derniers pings). */
     latency: ILatencyWindow;
     /** Sonde de stockage (driver), si l'adapter l'expose. */
-    storage?: IOrmStorageProbe;
+    storage?: IOrmStorageProbe | undefined;
     /** Sonde de pool de connexions (driver), si l'adapter l'expose. */
-    pool?: IOrmPoolProbe;
+    pool?: IOrmPoolProbe | undefined;
     /** Métriques driver libres (clé→valeur). */
-    extra?: Record<string, string | number | boolean>;
+    extra?: Record<string, string | number | boolean> | undefined;
 }
 /** Graphe complet du modèle de données — réponse de `/nodefony/orm/api/graph`. */
 export interface IOrmGraph {

package/dist/types/nodefony/interfaces/IOrmProbe.d.ts

@@ -32,15 +32,15 @@ export interface ILatencyWindow {
  */
 export interface IOrmStorageProbe {
     /** Taille de la base (octets) — `pages × pageSize` (SQLite). */
-    sizeBytes?: number;
+    sizeBytes?: number | undefined;
     /** Nombre de pages allouées. */
-    pages?: number;
+    pages?: number | undefined;
     /** Taille d'une page (octets). */
-    pageSize?: number;
+    pageSize?: number | undefined;
     /** Mode de journalisation (SQLite : `wal`, `delete`, `memory`…). */
-    journalMode?: string;
+    journalMode?: string | undefined;
     /** Pages libres (fragmentation / espace récupérable au VACUUM). */
-    freePages?: number;
+    freePages?: number | undefined;
 }
 /**
  * Sonde de pool de connexions — pertinente pour les bases serveur (Mongo,
@@ -48,13 +48,13 @@ export interface IOrmStorageProbe {
  */
 export interface IOrmPoolProbe {
     /** Taille max configurée du pool. */
-    size?: number;
+    size?: number | undefined;
     /** Connexions disponibles (idle). */
-    available?: number;
+    available?: number | undefined;
     /** Connexions en cours d'utilisation. */
-    borrowed?: number;
+    borrowed?: number | undefined;
     /** Demandes en attente d'une connexion. */
-    pending?: number;
+    pending?: number | undefined;
 }
 /**
  * Sonde profonde driver-spécifique retournée par {@link IOrm.probe}. Tous les

package/dist/types/nodefony/interfaces/IPage.d.ts

@@ -20,5 +20,5 @@ export type { IPage, IPageQuery } from "nodefony";
  */
 export interface PageQuery<T = unknown> extends IPageQuery {
     /** Filtre typé optionnel appliqué avant la pagination (toutes les lignes si omis). */
-    criteria?: Criteria<T>;
+    criteria?: Criteria<T> | undefined;
 }

package/dist/types/nodefony/interfaces/IRepository.d.ts

@@ -23,23 +23,23 @@ export type OrmCriteria = Record<string, unknown>;
  */
 export interface FieldOperators<V> {
     /** Égalité stricte (équivalent à passer la valeur nue). */
-    $eq?: V;
+    $eq?: V | undefined;
     /** Différent de. */
-    $ne?: V;
+    $ne?: V | undefined;
     /** Strictement supérieur à. */
-    $gt?: V;
+    $gt?: V | undefined;
     /** Supérieur ou égal à. */
-    $gte?: V;
+    $gte?: V | undefined;
     /** Strictement inférieur à. */
-    $lt?: V;
+    $lt?: V | undefined;
     /** Inférieur ou égal à. */
-    $lte?: V;
+    $lte?: V | undefined;
     /** Appartient à l'ensemble. */
-    $in?: readonly V[];
+    $in?: readonly V[] | undefined;
     /** N'appartient pas à l'ensemble. */
-    $nin?: readonly V[];
+    $nin?: readonly V[] | undefined;
     /** Motif SQL `LIKE` (`%`/`_`) — pertinent pour les champs texte uniquement. */
-    $like?: string;
+    $like?: string | undefined;
     /**
      * Teste l'**absence de valeur** : `true` → `IS NULL`, `false` → `IS NOT NULL`
      * (Mongo : `$eq`/`$ne null`, qui couvre aussi le champ absent).
@@ -60,7 +60,7 @@ export interface FieldOperators<V> {
      * // les PAT qui ont une expiration
      * repo.find({ expiresAt: { $null: false } });
      */
-    $null?: boolean;
+    $null?: boolean | undefined;
 }
 /**
  * Opérateurs d'**écriture** applicables à un champ dans le `update` d'un
@@ -154,7 +154,7 @@ export type Criteria<T> = {
      * // les clés encore utilisables
      * repo.count({ revokedAt: null, $or: [{ expiresAt: null }, { expiresAt: { $gt: now } }] });
      */
-    $or?: ReadonlyArray<Criteria<T>>;
+    $or?: ReadonlyArray<Criteria<T>> | undefined;
 } & OrmCriteria;
 /**
  * Options de lecture (`find`/`findOne`) portables cross-ORM.
@@ -181,7 +181,7 @@ export interface RepositoryReadOptions {
      * la frontière qui la reçoit (`parsePageQuery` accepte `champ:sens` en casse
      * libre), jamais au repository.
      */
-    order?: Array<[string, "ASC" | "DESC"]>;
+    order?: Array<[string, "ASC" | "DESC"]> | undefined;
 }
 /**
  * Contrat CRUD minimal exposé par un repository, indépendant de l'ORM sous-jacent.

package/dist/types/nodefony/interfaces/ITransaction.d.ts

@@ -3,7 +3,7 @@
  *
  * Obtenue dans le callback de `IOrm.transaction()`. Les transactions cross-ORM
  * (2PC) ne sont PAS garanties : une transaction porte sur un seul ORM/connexion.
- * La sémantique des savepoints dépend du driver (peut être un no-op).
+ * Un moteur sans savepoints (MongoDB) les REFUSE : `SavepointNotSupportedError`.
  */
 export interface ITransaction {
     /** Valide définitivement les opérations de la transaction. */
@@ -14,12 +14,14 @@ export interface ITransaction {
      * Crée un point de sauvegarde nommé pour un rollback partiel ultérieur.
      *
      * @param name - identifiant du savepoint.
+     * @throws SavepointNotSupportedError si le moteur n'en porte pas (MongoDB).
      */
     savepoint(name: string): Promise<void>;
     /**
      * Annule jusqu'à un savepoint sans terminer la transaction.
      *
      * @param name - savepoint cible.
+     * @throws SavepointNotSupportedError si le moteur n'en porte pas (MongoDB).
      */
     rollbackTo(name: string): Promise<void>;
     /**

package/dist/types/nodefony/interfaces/index.d.ts

@@ -1,7 +1,7 @@
 export type { IOrm } from "./IOrm.js";
-export type { IEntity, IEntityRelation } from "./IEntity.js";
+export type { IEntity, IEntityIndex, IEntityRelation } from "./IEntity.js";
 export type { IRepository, OrmCriteria, Criteria, FieldCriteria, FieldOperators, UpdateData, UpdateOperators, RepositoryReadOptions, } from "./IRepository.js";
 export type { ITransaction } from "./ITransaction.js";
 export type { IPage, IPageQuery, PageQuery } from "./IPage.js";
-export type { IColumnInfo, IConnectionInfo, IRelationInfo, IEntityGraphNode, IOrmSummary, IOrmGraph, IConnectionError, IConnectionHealth, } from "./IOrmGraph.js";
+export type { IColumnInfo, IConnectionInfo, IRelationInfo, IEntityGraphNode, IOrmSummary, IOrmGraph, IConnectionError, IConnectionEvent, IOrmResilience, IConnectionHealth, } from "./IOrmGraph.js";
 export type { ILatencyWindow, IOrmStorageProbe, IOrmPoolProbe, IOrmProbe, } from "./IOrmProbe.js";

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

@@ -1,4 +1,5 @@
 import { Service } from "nodefony";
+import type { PartialInput } from "nodefony";
 import type { IRepository, Criteria, RepositoryReadOptions, IPage, PageQuery } from "../interfaces/index.js";
 import type { ServiceWiring } from "./serviceWiring.js";
 /**
@@ -102,10 +103,13 @@ export declare abstract class AbstractCrudService<T, R extends IRepository<T> =
     /**
      * 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`.
      */
-    create(data: Partial<T>): Promise<T>;
+    create(data: PartialInput<T>): Promise<T>;
     /**
      * Met à jour **au plus une** entité : `beforeUpdate` → persistance atomique
      * → `afterUpdate` → `onUpdated`.
@@ -120,10 +124,10 @@ export declare abstract class AbstractCrudService<T, R extends IRepository<T> =
      * 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).
      */
-    updateOne(criteria: Criteria<T>, data: Partial<T>): Promise<T | null>;
+    updateOne(criteria: Criteria<T>, data: PartialInput<T>): Promise<T | null>;
     /**
      * Supprime : `beforeDelete` → persistance → `afterDelete` → `onDeleted`.
      *
@@ -138,7 +142,7 @@ export declare abstract class AbstractCrudService<T, R extends IRepository<T> =
      * @param data - données entrantes.
      * @returns les données préparées à persister.
      */
-    protected beforeCreate(data: Partial<T>): Partial<T> | Promise<Partial<T>>;
+    protected beforeCreate(data: PartialInput<T>): PartialInput<T> | Promise<PartialInput<T>>;
     /** Effet de bord après création (ex. provisionner une ressource liée). */
     protected afterCreate(_entity: T): void | Promise<void>;
     /**
@@ -148,7 +152,7 @@ export declare abstract class AbstractCrudService<T, R extends IRepository<T> =
      * @param data - données entrantes.
      * @returns les données préparées à persister.
      */
-    protected beforeUpdate(_criteria: Criteria<T>, data: Partial<T>): Partial<T> | Promise<Partial<T>>;
+    protected beforeUpdate(_criteria: Criteria<T>, data: PartialInput<T>): PartialInput<T> | Promise<PartialInput<T>>;
     /** Effet de bord après mise à jour. */
     protected afterUpdate(_entity: T): void | Promise<void>;
     /** Garde/validation avant suppression (ex. interdire la suppression du dernier admin). */

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

@@ -1,4 +1,4 @@
-import type { IConnectionError } from "../interfaces/IOrmGraph.js";
+import type { IConnectionError, IConnectionEvent } from "../interfaces/IOrmGraph.js";
 import type { ILatencyWindow } from "../interfaces/IOrmProbe.js";
 /** Vue figée des compteurs du moniteur pour un connecteur. */
 export interface IConnectionMonitorCore {
@@ -8,6 +8,12 @@ export interface IConnectionMonitorCore {
     reconnectCount: number;
     /** Pertes de connexion constatées depuis le démarrage du process. */
     lostCount: number;
+    /** Dernière perte (epoch ms), `null` si aucune. */
+    lastLostAt: number | null;
+    /** Dernière reprise (epoch ms), `null` si aucune. */
+    lastRestoredAt: number | null;
+    /** Pertes et reprises récentes, plus récentes d'abord. */
+    events: IConnectionEvent[];
     errorCount: number;
     lastConnectMs: number | null;
     lastError: IConnectionError | null;
@@ -58,8 +64,9 @@ declare class ConnectionMonitor {
      * preuve de bonne santé.
      *
      * @param name - clé du connecteur.
+     * @param reason - cause lisible (credential déjà retiré), si connue.
      */
-    recordLost(name: string): void;
+    recordLost(name: string, reason?: string): void;
     /**
      * Enregistre une **reprise** de connexion constatée par l'adapter.
      *

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

@@ -25,7 +25,7 @@ export declare abstract class Entity<S = unknown, M = unknown> implements IEntit
     /** Modèle compilé natif, renseigné après connexion de l'ORM. */
     model?: M;
     /** Relations déclarées vers d'autres entités (par nom logique). */
-    readonly relations?: ReadonlyArray<IEntityRelation>;
+    readonly relations?: ReadonlyArray<IEntityRelation> | undefined;
     /**
      * Construit la définition de schéma propre au driver.
      *

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

@@ -1,6 +1,6 @@
 import { Service } from "nodefony";
 import type { Container, Event, DefaultOptionsService } from "nodefony";
-import type { IColumnInfo, IConnectionInfo, IOrm, IRepository, ITransaction } from "../interfaces/index.js";
+import type { IColumnInfo, IConnectionInfo, IOrm, IOrmResilience, IRepository, ITransaction } from "../interfaces/index.js";
 /**
  * Classe de base abstraite de tout ORM Nodefony — câble {@link Service} (DI,
  * Syslog, bus d'événements) et le contrat {@link IOrm}, et s'auto-enregistre
@@ -121,6 +121,14 @@ export declare abstract class Orm extends Service implements IOrm {
      * prochain battement pour rendre la main.
      */
     protected startHeartbeat(): void;
+    /**
+     * 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(): IOrmResilience;
     /** Arrête le battement et libère la minuterie. Idempotent. */
     protected stopHeartbeat(): void;
     /**

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

@@ -1,6 +1,22 @@
-import type { IAdminApi, IAdminRegistry } from "nodefony";
+import type { IAdminApi, IAdminRegistry, IStoreResolution } from "nodefony";
 import type { IConnectionHealth, IOrmGraph } from "../interfaces/IOrmGraph.js";
 import type { IOrmFlowReport } from "../interfaces/IOrmFlow.js";
+/** 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).
+ */
+export declare function storeCarrier(resolutions: readonly IStoreResolution[], names: readonly string[]): string | null;
 /** Construit le graphe canonique complet (optionnellement filtré par connecteur). */
 export declare function buildOrmGraph(connectorFilter?: string): IOrmGraph;
 /**

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

@@ -24,6 +24,12 @@ export type ConnectionVerdict =
 "unreachable"
 /** Un serveur a répondu, et il refuse — le port est bien tenu par quelqu'un. */
  | "answered"
+/**
+ * La connexion a ABOUTI, puis le serveur a refusé une INSTRUCTION — une
+ * table, une contrainte, un type. Ni l'adresse ni l'état de la base ne sont
+ * en cause : c'est le schéma envoyé qu'il faut corriger.
+ */
+ | "rejected"
 /** L'erreur ne permet de trancher ni dans un sens ni dans l'autre. */
  | "unknown";
 /** Diagnostic rendu à l'appelant, qui compose le message final. */
@@ -56,3 +62,26 @@ export declare function parseConnectionTarget(url?: string | null): IConnectionT
  * @returns le verdict, le code constaté et une explication déjà rédigée.
  */
 export declare function diagnoseConnectionFailure(error: unknown, target?: IConnectionTarget, platform?: string): IConnectionDiagnosis;
+/**
+ * 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é.
+ */
+export declare const REJECTED_MARKER = "s'est connect\u00E9, mais le serveur a refus\u00E9 une instruction \u2014 ";
+/**
+ * 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.
+ */
+export declare function describeConnectFailure(subject: string, diagnosis: IConnectionDiagnosis, cause: string, advice?: string): string;