@nodefony/drizzle 10.0.0-alpha.1

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

@@ -0,0 +1,91 @@
+//#region nodefony/src/migrator/types.ts
+/**
+* URL de connexion réservée au **travail de migration**.
+*
+* Elle porte le compte qui a le droit de modifier le schéma — un compte que les
+* exemplaires qui servent le trafic n'ont pas, et ne doivent pas avoir. C'est
+* tout son intérêt : le secret est monté dans le travail de migration
+* seulement.
+*
+* **Qui la lit, exactement** : les commandes `orm:migrate`,
+* `orm:migrate:status`, `orm:migrate:baseline` et `orm:migrate:repair`.
+* Personne d'autre — ni le démarrage de l'application, ni `orm:reset`, ni un
+* store. Une variable de privilège élevé qui fuiterait dans le chemin ordinaire
+* annulerait le moindre privilège qu'elle sert à installer.
+*
+* ⚠️ Elle doit désigner une connexion **directe** au serveur. Un répartiteur de
+* connexions en mode transaction (PgBouncer `transaction`) casse les verrous
+* consultatifs de session — et le verrou de l'applicateur en est un.
+*/
+const MIGRATE_URL_ENV = "NF_MIGRATE_DATABASE_URL";
+/**
+* Contrats de l'applicateur de migrations — verdicts, entrées de journal,
+* historique, plan, et le pilote à connexion unique dont il a besoin.
+*
+* **Pourquoi un fichier de types séparé** : ces formes traversent la frontière
+* npm (CLI, data plane d'administration, sonde de disponibilité, porte MCP) —
+* quatre consommateurs pour un seul producteur. Les tenir à part évite qu'un
+* import de l'applicateur tire les pilotes de base de données avec lui.
+*/
+/**
+* Nom de la table d'historique — **jamais qualifié d'un schéma**.
+*
+* Elle suit donc le `search_path` de la connexion, exactement comme les tables
+* d'entités. Écrire `public.nodefony_migrations` exclurait à vie le patron
+* PostgreSQL d'isolation par schéma sur une base mutualisée : déplacer ensuite
+* la table d'historique chez un utilisateur serait une migration de données,
+* pas un correctif.
+*/
+const HISTORY_TABLE = "nodefony_migrations";
+/**
+* Marqueur de format que porte la première ligne de chaque fichier `.sql`.
+*
+* Le format de découpe est celui de drizzle-kit, adopté à vie ; un défaut
+* découvert après publication ne pourrait plus être corrigé sans changer le
+* SENS de fichiers déjà livrés. Le marqueur donne la porte de sortie : un
+* fichier d'un autre format est **refusé en le nommant**, jamais lu au mieux.
+*/
+const FORMAT_MARKER = "-- nodefony:migration format=1";
+/** Séparateur de statements produit par drizzle-kit. */
+const STATEMENT_BREAKPOINT = "--> statement-breakpoint";
+/**
+* Le verrou d'applicateur n'a pas été obtenu dans le délai imparti.
+*
+* Une classe, et pas une `Error` nue, pour une raison précise : c'est ce qui
+* permet à l'applicateur de la reconnaître et de la rendre sous le code
+* `NF_MIGRATE_LOCK_TIMEOUT`, publié dans le contrat et lu par les
+* orchestrateurs pour décider d'ATTENDRE puis de reprendre. Levée nue, elle
+* tombait dans le fourre-tout des pannes : le code promis n'était jamais émis,
+* et les branches qui l'attendaient — jusqu'au code de sortie — étaient
+* inatteignables.
+*
+* Un verrou tenu n'est pas une panne : c'est le déploiement d'à côté qui
+* travaille, et la réponse est d'attendre.
+*/
+var MigrationLockTimeoutError = class extends Error {
+	timeoutMs;
+	/**
+	* @param timeoutMs - délai d'attente écoulé.
+	* @param message - phrase française destinée à un humain.
+	*/
+	constructor(timeoutMs, message) {
+		super(message);
+		this.timeoutMs = timeoutMs;
+		this.name = "MigrationLockTimeoutError";
+	}
+};
+/** Erreur portant un {@link IMigrationVerdict} — le message n'est qu'un rendu. */
+var MigrationVerdictError = class extends Error {
+	verdict;
+	/**
+	* @param verdict - verdict structuré, seule source de la décision.
+	* @param message - phrase française destinée à un humain.
+	*/
+	constructor(verdict, message) {
+		super(message);
+		this.verdict = verdict;
+		this.name = "MigrationVerdictError";
+	}
+};
+//#endregion
+export { FORMAT_MARKER, HISTORY_TABLE, MIGRATE_URL_ENV, MigrationLockTimeoutError, MigrationVerdictError, STATEMENT_BREAKPOINT };