@nodefony/drizzle 10.0.0-alpha.1

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

@@ -0,0 +1,121 @@
+import { HISTORY_TABLE } from "../types.js";
+import { schemaReader } from "../catalog.js";
+//#region nodefony/src/migrator/drivers/sqliteDriver.ts
+/**
+* Pilote SQLite de l'applicateur — connexion `better-sqlite3` dédiée.
+*
+* **Pas de verrou explicite** : SQLite est à écrivain unique par nature. Ce
+* n'est pas un manque à combler, c'est la description exacte de la situation —
+* la sérialisation est faite par le moteur, et une table de verrou maison ne
+* ferait qu'ajouter une pièce à déverrouiller à la main le jour où un process
+* meurt.
+*/
+var SqliteMigrationDriver = class {
+	dialect = "sqlite";
+	transactionalDdl = true;
+	#database = null;
+	#filename;
+	/**
+	* @param filename - fichier de la base, ou `:memory:`.
+	*/
+	constructor(filename) {
+		this.#filename = filename;
+	}
+	/**
+	* La base, ou l'erreur qui dit ce qu'il manque.
+	*
+	* Un accès avant `connect()` est une faute de programmation, pas un cas
+	* d'exécution : le message le dit plutôt que de laisser tomber un
+	* `Cannot read properties of null` à trois appels de là.
+	*/
+	get #db() {
+		if (!this.#database) throw new Error("SqliteMigrationDriver : `connect()` n'a pas été appelé — le pilote `better-sqlite3` est chargé à la demande, comme `pg` et `mysql2`.");
+		return this.#database;
+	}
+	/**
+	* Ouvre la base, en chargeant le pilote à la demande.
+	*
+	* Même patron que `PostgresMigrationDriver.connect()` : `openMigrationDriver`
+	* enchaîne `new` puis `await connect()` pour les trois dialectes, et aucune
+	* application n'embarque un pilote qu'elle n'ouvre pas.
+	*
+	* @throws Error si le pilote `better-sqlite3` n'est pas installé.
+	*/
+	async connect() {
+		let Sqlite;
+		try {
+			const ns = await import("better-sqlite3");
+			const resolved = ns.default ?? ns;
+			if (typeof resolved !== "function") throw new Error("`better-sqlite3` did not expose a constructor");
+			Sqlite = resolved;
+		} catch (e) {
+			throw new Error(`Le dialecte sqlite exige le pilote optionnel \`better-sqlite3\` (\`npm i better-sqlite3\`). ${e.message}`, { cause: e });
+		}
+		const db = new Sqlite(this.#filename);
+		if (this.#filename !== ":memory:") {
+			db.pragma("journal_mode = WAL");
+			db.pragma("synchronous = NORMAL");
+		}
+		this.#database = db;
+	}
+	/** @inheritdoc */
+	exec(sql) {
+		this.#db.exec(sql);
+		return Promise.resolve();
+	}
+	/** @inheritdoc */
+	query(sql, params = []) {
+		const statement = this.#db.prepare(sql);
+		if (!statement.reader) {
+			statement.run(...params);
+			return Promise.resolve([]);
+		}
+		return Promise.resolve(statement.all(...params));
+	}
+	/** Lecture du catalogue — implémentation PARTAGÉE avec l'ORM. */
+	#catalog = schemaReader("sqlite", (sql, params) => this.query(sql, params));
+	/** @inheritdoc */
+	sameColumnName(declared, actual) {
+		return this.#catalog.sameColumnName(declared, actual);
+	}
+	/** @inheritdoc */
+	tableExists(table) {
+		return this.#catalog.tableExists(table);
+	}
+	/** @inheritdoc */
+	columnsOf(table) {
+		return this.#catalog.columnsOf(table);
+	}
+	/** @inheritdoc */
+	begin() {
+		return this.exec("BEGIN IMMEDIATE");
+	}
+	/** @inheritdoc */
+	commit() {
+		return this.exec("COMMIT");
+	}
+	/** @inheritdoc */
+	rollback() {
+		return this.exec("ROLLBACK");
+	}
+	/** @inheritdoc */
+	lock() {
+		return Promise.resolve();
+	}
+	/** @inheritdoc */
+	unlock() {
+		return Promise.resolve();
+	}
+	/** @inheritdoc */
+	close() {
+		this.#database?.close();
+		this.#database = null;
+		return Promise.resolve();
+	}
+	/** Table d'historique servie par ce pilote — pour les diagnostics. */
+	get historyTable() {
+		return HISTORY_TABLE;
+	}
+};
+//#endregion
+export { SqliteMigrationDriver };