@hot-updater/server 1.0.0-rc.14 → 1.0.0-rc.16

package/dist/adapters/drizzle.cjs

@@ -1,81 +1,42 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_registry = require("../db/schema/registry.cjs");
-const require_schemaGenerators = require("../db/schemaGenerators.cjs");
-const require_drizzleCrud = require("./drizzleCrud.cjs");
-const require_drizzleLazyDB = require("./drizzleLazyDB.cjs");
-let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
+const require_settingsMigrator = require("../db/settingsMigrator.cjs");
+const require_builtInDatabase = require("../db/builtInDatabase.cjs");
+const require_sqlAdapter = require("../database/sql/sqlAdapter.cjs");
+const require_sqlProviders = require("./sqlProviders.cjs");
+const require_engineDrizzleSchema = require("../db/engineDrizzleSchema.cjs");
+const require_drizzleExecutor = require("./drizzleExecutor.cjs");
 //#region src/adapters/drizzle.ts
-const createImplementation = (config) => {
-	const db = require_drizzleLazyDB.createLazyDB(config);
-	const crud = require_drizzleCrud.createDrizzleCrud(db, config.provider);
-	const transaction = db.transaction?.bind(db);
-	return {
-		...crud,
-		recordInsights: async (input) => {
-			await require_drizzleCrud.recordDrizzleInsights(db.resolve === void 0 ? db : await db.resolve(), config.provider, input);
-		},
-		deleteChannel: (input) => {
-			if (transaction === void 0) throw new Error("Drizzle channel deletion requires transaction support.");
-			return transaction((transactionDatabase) => require_drizzleCrud.createDrizzleCrud(transactionDatabase, config.provider).deleteChannel(input));
-		},
-		...transaction ? { delete: (input) => transaction((transactionDatabase) => require_drizzleCrud.createDrizzleCrud(transactionDatabase, config.provider).delete(input)) } : {},
-		...transaction ? { transaction: async (callback) => transaction((transaction) => callback(require_drizzleCrud.createDrizzleCrud(transaction, config.provider))) } : {}
-	};
-};
+/**
+* Hot Updater's database on a Drizzle instance: the storage engine through the
+* shared SQL core, fenced by the schema settings. `db generate` writes the
+* Drizzle schema drizzle-kit applies; `db migrate` then writes the settings
+* rows the fence checks.
+*/
 const drizzleAdapter = (config) => {
-	let adapter;
-	const getAdapter = () => {
-		adapter ??= (0, _hot_updater_plugin_core_internal.createDatabasePluginAdapter)("drizzle", createImplementation(config));
-		return adapter;
-	};
-	const plugin = (0, _hot_updater_plugin_core.createDatabasePlugin)({
-		name: "drizzle",
-		models: {
-			bundles: {
-				findById: (id) => getAdapter().models.bundles.findById(id),
-				findMany: (query) => getAdapter().models.bundles.findMany(query),
-				count: (where) => getAdapter().models.bundles.count(where)
-			},
-			bundlePatches: { findByBundleIds: (bundleIds) => getAdapter().models.bundlePatches.findByBundleIds(bundleIds) },
-			releases: {
-				findById: (id) => getAdapter().models.releases.findById(id),
-				findMany: (input) => getAdapter().models.releases.findMany(input),
-				findManyByScope: (input) => getAdapter().models.releases.findManyByScope(input)
-			},
-			releaseCatalogs: {
-				findByScopeKey: (scopeKey) => getAdapter().models.releaseCatalogs.findByScopeKey(scopeKey),
-				findMany: (input) => getAdapter().models.releaseCatalogs.findMany(input)
-			},
-			channels: {
-				insert: (input) => getAdapter().models.channels.insert(input),
-				list: (input) => getAdapter().models.channels.list(input),
-				delete: (input) => getAdapter().models.channels.delete(input)
-			},
-			insights: {
-				recordEvent: (input) => getAdapter().models.insights.recordEvent(input),
-				listEvents: (input) => getAdapter().models.insights.listEvents(input),
-				findLatestEvents: (input) => getAdapter().models.insights.findLatestEvents(input),
-				countLatestEvents: (input) => getAdapter().models.insights.countLatestEvents(input),
-				countEvents: (input) => getAdapter().models.insights.countEvents(input)
-			},
-			apiKeys: {
-				create: (row) => getAdapter().models.apiKeys.create(row),
-				findByHash: (hash) => getAdapter().models.apiKeys.findByHash(hash),
-				list: () => getAdapter().models.apiKeys.list(),
-				revoke: (input) => getAdapter().models.apiKeys.revoke(input)
-			}
-		},
-		commit: (input) => getAdapter().commit(input)
-	});
-	return Object.assign(plugin, {
-		adapterName: "drizzle",
-		provider: config.provider,
-		generateSchema: (version) => ({
-			code: require_schemaGenerators.generateDrizzleSchema(config.provider, version === "latest" ? require_registry.hotUpdaterSchema : require_registry.getHotUpdaterSchemaVersion(version)),
-			path: "hot-updater-schema.ts"
+	const provider = require_sqlProviders.checkSqlProvider("drizzleAdapter", config.provider);
+	const executor = require_drizzleExecutor.drizzleExecutor(config.db, provider);
+	return {
+		...require_builtInDatabase.createEngineDatabase({
+			name: "drizzle",
+			adapter: require_sqlAdapter.createSqlAdapter({ executor })
+		}),
+		provider,
+		generateSchema: ((version, _name, { schema } = require_builtInDatabase.builtInTarget) => {
+			if (version !== "latest" && version !== require_builtInDatabase.builtInSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+			return {
+				code: require_engineDrizzleSchema.generateDrizzleEngineSchema(provider, schema),
+				path: "hot-updater-schema.ts"
+			};
+		}),
+		createMigrator: ({ settings } = require_builtInDatabase.builtInTarget) => require_settingsMigrator.createSettingsMigrator({
+			adapterName: "drizzle",
+			executor,
+			settings,
+			applyTables: "`drizzle-kit push` (or your drizzle-kit migrations)"
 		})
-	});
+	};
 };
 //#endregion
+exports.DrizzleTransactionUnsupportedError = require_drizzleExecutor.DrizzleTransactionUnsupportedError;
+exports.SUPPORTED_DRIZZLE_DRIVERS = require_drizzleExecutor.SUPPORTED_DRIZZLE_DRIVERS;
 exports.drizzleAdapter = drizzleAdapter;

package/dist/adapters/drizzle.d.cts

@@ -1,12 +1,20 @@
-import { DatabaseAdapterWithCapabilities, ORMProvider } from "../db/types.cjs";
+import { ORMSQLProvider, ToolingDatabase } from "../db/types.cjs";
+import { DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS } from "./drizzleExecutor.cjs";
 //#region src/adapters/drizzle.d.ts
-type DrizzleProvider = Exclude<ORMProvider, "cockroachdb" | "mongodb" | "mssql">;
+type DrizzleProvider = ORMSQLProvider;
 interface DrizzleConfig {
+  /** A Drizzle database, or a function that returns one on first use. */
   readonly db: unknown | (() => unknown | Promise<unknown>);
   readonly provider: DrizzleProvider;
+  /** Ignored: Hot Updater reads through SQL; the schema file is for drizzle-kit. */
   readonly schema?: Record<string, unknown>;
-  readonly transaction?: boolean;
 }
-declare const drizzleAdapter: (config: DrizzleConfig) => DatabaseAdapterWithCapabilities;
+/**
+ * Hot Updater's database on a Drizzle instance: the storage engine through the
+ * shared SQL core, fenced by the schema settings. `db generate` writes the
+ * Drizzle schema drizzle-kit applies; `db migrate` then writes the settings
+ * rows the fence checks.
+ */
+declare const drizzleAdapter: (config: DrizzleConfig) => ToolingDatabase;
 //#endregion
-export { DrizzleConfig, DrizzleProvider, drizzleAdapter };
+export { DrizzleConfig, DrizzleProvider, DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS, drizzleAdapter };

package/dist/adapters/drizzle.d.mts

@@ -1,12 +1,20 @@
-import { DatabaseAdapterWithCapabilities, ORMProvider } from "../db/types.mjs";
+import { ORMSQLProvider, ToolingDatabase } from "../db/types.mjs";
+import { DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS } from "./drizzleExecutor.mjs";
 //#region src/adapters/drizzle.d.ts
-type DrizzleProvider = Exclude<ORMProvider, "cockroachdb" | "mongodb" | "mssql">;
+type DrizzleProvider = ORMSQLProvider;
 interface DrizzleConfig {
+  /** A Drizzle database, or a function that returns one on first use. */
   readonly db: unknown | (() => unknown | Promise<unknown>);
   readonly provider: DrizzleProvider;
+  /** Ignored: Hot Updater reads through SQL; the schema file is for drizzle-kit. */
   readonly schema?: Record<string, unknown>;
-  readonly transaction?: boolean;
 }
-declare const drizzleAdapter: (config: DrizzleConfig) => DatabaseAdapterWithCapabilities;
+/**
+ * Hot Updater's database on a Drizzle instance: the storage engine through the
+ * shared SQL core, fenced by the schema settings. `db generate` writes the
+ * Drizzle schema drizzle-kit applies; `db migrate` then writes the settings
+ * rows the fence checks.
+ */
+declare const drizzleAdapter: (config: DrizzleConfig) => ToolingDatabase;
 //#endregion
-export { DrizzleConfig, DrizzleProvider, drizzleAdapter };
+export { DrizzleConfig, DrizzleProvider, DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS, drizzleAdapter };

package/dist/adapters/drizzle.mjs

@@ -1,80 +1,39 @@
-import { getHotUpdaterSchemaVersion, hotUpdaterSchema } from "../db/schema/registry.mjs";
-import { generateDrizzleSchema } from "../db/schemaGenerators.mjs";
-import { createDrizzleCrud, recordDrizzleInsights } from "./drizzleCrud.mjs";
-import { createLazyDB } from "./drizzleLazyDB.mjs";
-import { createDatabasePlugin } from "@hot-updater/plugin-core";
-import { createDatabasePluginAdapter } from "@hot-updater/plugin-core/internal";
+import { createSettingsMigrator } from "../db/settingsMigrator.mjs";
+import { builtInSettings, builtInTarget, createEngineDatabase } from "../db/builtInDatabase.mjs";
+import { createSqlAdapter } from "../database/sql/sqlAdapter.mjs";
+import { checkSqlProvider } from "./sqlProviders.mjs";
+import { generateDrizzleEngineSchema } from "../db/engineDrizzleSchema.mjs";
+import { DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS, drizzleExecutor } from "./drizzleExecutor.mjs";
 //#region src/adapters/drizzle.ts
-const createImplementation = (config) => {
-	const db = createLazyDB(config);
-	const crud = createDrizzleCrud(db, config.provider);
-	const transaction = db.transaction?.bind(db);
-	return {
-		...crud,
-		recordInsights: async (input) => {
-			await recordDrizzleInsights(db.resolve === void 0 ? db : await db.resolve(), config.provider, input);
-		},
-		deleteChannel: (input) => {
-			if (transaction === void 0) throw new Error("Drizzle channel deletion requires transaction support.");
-			return transaction((transactionDatabase) => createDrizzleCrud(transactionDatabase, config.provider).deleteChannel(input));
-		},
-		...transaction ? { delete: (input) => transaction((transactionDatabase) => createDrizzleCrud(transactionDatabase, config.provider).delete(input)) } : {},
-		...transaction ? { transaction: async (callback) => transaction((transaction) => callback(createDrizzleCrud(transaction, config.provider))) } : {}
-	};
-};
+/**
+* Hot Updater's database on a Drizzle instance: the storage engine through the
+* shared SQL core, fenced by the schema settings. `db generate` writes the
+* Drizzle schema drizzle-kit applies; `db migrate` then writes the settings
+* rows the fence checks.
+*/
 const drizzleAdapter = (config) => {
-	let adapter;
-	const getAdapter = () => {
-		adapter ??= createDatabasePluginAdapter("drizzle", createImplementation(config));
-		return adapter;
-	};
-	const plugin = createDatabasePlugin({
-		name: "drizzle",
-		models: {
-			bundles: {
-				findById: (id) => getAdapter().models.bundles.findById(id),
-				findMany: (query) => getAdapter().models.bundles.findMany(query),
-				count: (where) => getAdapter().models.bundles.count(where)
-			},
-			bundlePatches: { findByBundleIds: (bundleIds) => getAdapter().models.bundlePatches.findByBundleIds(bundleIds) },
-			releases: {
-				findById: (id) => getAdapter().models.releases.findById(id),
-				findMany: (input) => getAdapter().models.releases.findMany(input),
-				findManyByScope: (input) => getAdapter().models.releases.findManyByScope(input)
-			},
-			releaseCatalogs: {
-				findByScopeKey: (scopeKey) => getAdapter().models.releaseCatalogs.findByScopeKey(scopeKey),
-				findMany: (input) => getAdapter().models.releaseCatalogs.findMany(input)
-			},
-			channels: {
-				insert: (input) => getAdapter().models.channels.insert(input),
-				list: (input) => getAdapter().models.channels.list(input),
-				delete: (input) => getAdapter().models.channels.delete(input)
-			},
-			insights: {
-				recordEvent: (input) => getAdapter().models.insights.recordEvent(input),
-				listEvents: (input) => getAdapter().models.insights.listEvents(input),
-				findLatestEvents: (input) => getAdapter().models.insights.findLatestEvents(input),
-				countLatestEvents: (input) => getAdapter().models.insights.countLatestEvents(input),
-				countEvents: (input) => getAdapter().models.insights.countEvents(input)
-			},
-			apiKeys: {
-				create: (row) => getAdapter().models.apiKeys.create(row),
-				findByHash: (hash) => getAdapter().models.apiKeys.findByHash(hash),
-				list: () => getAdapter().models.apiKeys.list(),
-				revoke: (input) => getAdapter().models.apiKeys.revoke(input)
-			}
-		},
-		commit: (input) => getAdapter().commit(input)
-	});
-	return Object.assign(plugin, {
-		adapterName: "drizzle",
-		provider: config.provider,
-		generateSchema: (version) => ({
-			code: generateDrizzleSchema(config.provider, version === "latest" ? hotUpdaterSchema : getHotUpdaterSchemaVersion(version)),
-			path: "hot-updater-schema.ts"
+	const provider = checkSqlProvider("drizzleAdapter", config.provider);
+	const executor = drizzleExecutor(config.db, provider);
+	return {
+		...createEngineDatabase({
+			name: "drizzle",
+			adapter: createSqlAdapter({ executor })
+		}),
+		provider,
+		generateSchema: ((version, _name, { schema } = builtInTarget) => {
+			if (version !== "latest" && version !== builtInSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+			return {
+				code: generateDrizzleEngineSchema(provider, schema),
+				path: "hot-updater-schema.ts"
+			};
+		}),
+		createMigrator: ({ settings } = builtInTarget) => createSettingsMigrator({
+			adapterName: "drizzle",
+			executor,
+			settings,
+			applyTables: "`drizzle-kit push` (or your drizzle-kit migrations)"
 		})
-	});
+	};
 };
 //#endregion
-export { drizzleAdapter };
+export { DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS, drizzleAdapter };

package/dist/adapters/drizzleExecutor.cjs

@@ -0,0 +1,114 @@
+let drizzle_orm = require("drizzle-orm");
+//#region src/adapters/drizzleExecutor.ts
+const SUPPORTED_DRIZZLE_DRIVERS = "node-postgres, postgres-js, PGlite, or Neon over WebSockets for PostgreSQL; mysql2 for MySQL; libSQL, better-sqlite3, or bun:sqlite for SQLite";
+var DrizzleTransactionUnsupportedError = class extends Error {
+	name = "DrizzleTransactionUnsupportedError";
+	constructor(cause) {
+		super(`This Drizzle driver cannot run interactive transactions, which Hot Updater needs. Use ${SUPPORTED_DRIZZLE_DRIVERS}.`, { cause });
+	}
+};
+/** The SQL core's statement as Drizzle SQL, each placeholder bound as a parameter. */
+const toSql = (dialect, { sql: text, params }) => {
+	const pattern = dialect === "postgresql" ? /\$(\d+)/gu : /\?/gu;
+	const chunks = [];
+	let last = 0;
+	let next = 0;
+	for (const match of text.matchAll(pattern)) {
+		chunks.push(drizzle_orm.sql.raw(text.slice(last, match.index)));
+		const position = dialect === "postgresql" ? Number(match[1]) - 1 : next++;
+		chunks.push(drizzle_orm.sql`${drizzle_orm.sql.param(params[position])}`);
+		last = match.index + match[0].length;
+	}
+	chunks.push(drizzle_orm.sql.raw(text.slice(last)));
+	return drizzle_orm.sql.join(chunks);
+};
+const over = (dialect, runner) => ({ async execute(statement) {
+	const query = toSql(dialect, statement);
+	if (dialect === "sqlite") return /^\s*SELECT\b/iu.test(statement.sql) ? {
+		rows: await runner.all(query),
+		changes: 0
+	} : {
+		rows: [],
+		changes: changesOf(await runner.run(query))
+	};
+	const result = await runner.execute(query);
+	const value = dialect === "mysql" && Array.isArray(result) ? result[0] : result;
+	return {
+		rows: Array.isArray(value) ? value : value.rows ?? [],
+		changes: Array.isArray(value) && dialect === "mysql" ? 0 : changesOf(value)
+	};
+} });
+const changesOf = (result) => {
+	const record = result ?? {};
+	const meta = record.meta;
+	return Number(record.rowCount ?? record.affectedRows ?? record.rowsAffected ?? record.changes ?? record.count ?? meta?.changes ?? 0);
+};
+/**
+* The SQL core's executor over a Drizzle database, or a function that
+* returns one. Async drivers run Drizzle's transactions; sync SQLite drivers
+* run one statement at a time, beginning transactions with BEGIN IMMEDIATE.
+* First use checks that the driver can run a transaction at all.
+*/
+const drizzleExecutor = (source, dialect) => {
+	const isSync = (runner) => dialect === "sqlite" && runner.resultKind === "sync";
+	let ready;
+	const resolve = () => {
+		ready ??= (async () => {
+			const runner = await (typeof source === "function" ? source() : source);
+			if (isSync(runner)) return runner;
+			let started = false;
+			try {
+				if (typeof runner.transaction !== "function") throw new TypeError("The Drizzle database has no transaction().");
+				await runner.transaction(async () => {
+					started = true;
+				});
+			} catch (error) {
+				if (!started) throw new DrizzleTransactionUnsupportedError(error);
+				throw error;
+			}
+			return runner;
+		})();
+		ready.catch(() => {
+			ready = void 0;
+		});
+		return ready;
+	};
+	let queue = Promise.resolve();
+	const serial = (task) => {
+		const result = queue.then(task);
+		queue = result.catch(() => void 0);
+		return result;
+	};
+	return {
+		dialect,
+		async execute(statement) {
+			const runner = await resolve();
+			const run = () => over(dialect, runner).execute(statement);
+			return isSync(runner) ? serial(run) : run();
+		},
+		async transaction(fn) {
+			const runner = await resolve();
+			if (!isSync(runner)) return await runner.transaction((tx) => fn(over(dialect, tx)));
+			return serial(async () => {
+				const connection = over(dialect, runner);
+				const raw = (text) => connection.execute({
+					sql: text,
+					params: []
+				});
+				await raw("BEGIN IMMEDIATE");
+				try {
+					const result = await fn(connection);
+					await raw("COMMIT");
+					return result;
+				} catch (error) {
+					await raw("ROLLBACK").catch(() => void 0);
+					throw error;
+				}
+			});
+		}
+	};
+};
+//#endregion
+exports.DrizzleTransactionUnsupportedError = DrizzleTransactionUnsupportedError;
+exports.SUPPORTED_DRIZZLE_DRIVERS = SUPPORTED_DRIZZLE_DRIVERS;
+exports.drizzleExecutor = drizzleExecutor;

package/dist/adapters/drizzleExecutor.d.cts

@@ -0,0 +1,9 @@
+import "../database/sql/sqlAdapter.cjs";
+//#region src/adapters/drizzleExecutor.d.ts
+declare const SUPPORTED_DRIZZLE_DRIVERS = "node-postgres, postgres-js, PGlite, or Neon over WebSockets for PostgreSQL; mysql2 for MySQL; libSQL, better-sqlite3, or bun:sqlite for SQLite";
+declare class DrizzleTransactionUnsupportedError extends Error {
+  readonly name = "DrizzleTransactionUnsupportedError";
+  constructor(cause: unknown);
+}
+//#endregion
+export { DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS };

package/dist/adapters/drizzleExecutor.d.mts

@@ -0,0 +1,9 @@
+import "../database/sql/sqlAdapter.mjs";
+//#region src/adapters/drizzleExecutor.d.ts
+declare const SUPPORTED_DRIZZLE_DRIVERS = "node-postgres, postgres-js, PGlite, or Neon over WebSockets for PostgreSQL; mysql2 for MySQL; libSQL, better-sqlite3, or bun:sqlite for SQLite";
+declare class DrizzleTransactionUnsupportedError extends Error {
+  readonly name = "DrizzleTransactionUnsupportedError";
+  constructor(cause: unknown);
+}
+//#endregion
+export { DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS };

package/dist/adapters/drizzleExecutor.mjs

@@ -0,0 +1,112 @@
+import { sql } from "drizzle-orm";
+//#region src/adapters/drizzleExecutor.ts
+const SUPPORTED_DRIZZLE_DRIVERS = "node-postgres, postgres-js, PGlite, or Neon over WebSockets for PostgreSQL; mysql2 for MySQL; libSQL, better-sqlite3, or bun:sqlite for SQLite";
+var DrizzleTransactionUnsupportedError = class extends Error {
+	name = "DrizzleTransactionUnsupportedError";
+	constructor(cause) {
+		super(`This Drizzle driver cannot run interactive transactions, which Hot Updater needs. Use ${SUPPORTED_DRIZZLE_DRIVERS}.`, { cause });
+	}
+};
+/** The SQL core's statement as Drizzle SQL, each placeholder bound as a parameter. */
+const toSql = (dialect, { sql: text, params }) => {
+	const pattern = dialect === "postgresql" ? /\$(\d+)/gu : /\?/gu;
+	const chunks = [];
+	let last = 0;
+	let next = 0;
+	for (const match of text.matchAll(pattern)) {
+		chunks.push(sql.raw(text.slice(last, match.index)));
+		const position = dialect === "postgresql" ? Number(match[1]) - 1 : next++;
+		chunks.push(sql`${sql.param(params[position])}`);
+		last = match.index + match[0].length;
+	}
+	chunks.push(sql.raw(text.slice(last)));
+	return sql.join(chunks);
+};
+const over = (dialect, runner) => ({ async execute(statement) {
+	const query = toSql(dialect, statement);
+	if (dialect === "sqlite") return /^\s*SELECT\b/iu.test(statement.sql) ? {
+		rows: await runner.all(query),
+		changes: 0
+	} : {
+		rows: [],
+		changes: changesOf(await runner.run(query))
+	};
+	const result = await runner.execute(query);
+	const value = dialect === "mysql" && Array.isArray(result) ? result[0] : result;
+	return {
+		rows: Array.isArray(value) ? value : value.rows ?? [],
+		changes: Array.isArray(value) && dialect === "mysql" ? 0 : changesOf(value)
+	};
+} });
+const changesOf = (result) => {
+	const record = result ?? {};
+	const meta = record.meta;
+	return Number(record.rowCount ?? record.affectedRows ?? record.rowsAffected ?? record.changes ?? record.count ?? meta?.changes ?? 0);
+};
+/**
+* The SQL core's executor over a Drizzle database, or a function that
+* returns one. Async drivers run Drizzle's transactions; sync SQLite drivers
+* run one statement at a time, beginning transactions with BEGIN IMMEDIATE.
+* First use checks that the driver can run a transaction at all.
+*/
+const drizzleExecutor = (source, dialect) => {
+	const isSync = (runner) => dialect === "sqlite" && runner.resultKind === "sync";
+	let ready;
+	const resolve = () => {
+		ready ??= (async () => {
+			const runner = await (typeof source === "function" ? source() : source);
+			if (isSync(runner)) return runner;
+			let started = false;
+			try {
+				if (typeof runner.transaction !== "function") throw new TypeError("The Drizzle database has no transaction().");
+				await runner.transaction(async () => {
+					started = true;
+				});
+			} catch (error) {
+				if (!started) throw new DrizzleTransactionUnsupportedError(error);
+				throw error;
+			}
+			return runner;
+		})();
+		ready.catch(() => {
+			ready = void 0;
+		});
+		return ready;
+	};
+	let queue = Promise.resolve();
+	const serial = (task) => {
+		const result = queue.then(task);
+		queue = result.catch(() => void 0);
+		return result;
+	};
+	return {
+		dialect,
+		async execute(statement) {
+			const runner = await resolve();
+			const run = () => over(dialect, runner).execute(statement);
+			return isSync(runner) ? serial(run) : run();
+		},
+		async transaction(fn) {
+			const runner = await resolve();
+			if (!isSync(runner)) return await runner.transaction((tx) => fn(over(dialect, tx)));
+			return serial(async () => {
+				const connection = over(dialect, runner);
+				const raw = (text) => connection.execute({
+					sql: text,
+					params: []
+				});
+				await raw("BEGIN IMMEDIATE");
+				try {
+					const result = await fn(connection);
+					await raw("COMMIT");
+					return result;
+				} catch (error) {
+					await raw("ROLLBACK").catch(() => void 0);
+					throw error;
+				}
+			});
+		}
+	};
+};
+//#endregion
+export { DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS, drizzleExecutor };

package/dist/adapters/kysely.cjs

@@ -1,38 +1,32 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_fixedMigrator = require("../db/fixedMigrator.cjs");
-const require_kyselyCrud = require("./kyselyCrud.cjs");
-let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
+const require_builtInDatabase = require("../db/builtInDatabase.cjs");
+const require_sqlAdapter = require("../database/sql/sqlAdapter.cjs");
+const require_engineSqlMigrator = require("../db/engineSqlMigrator.cjs");
+const require_kyselyExecutor = require("./kyselyExecutor.cjs");
+const require_sqlProviders = require("./sqlProviders.cjs");
 //#region src/adapters/kysely.ts
-const createImplementation = (config) => {
-	const db = config.db;
-	const relationMode = config.relationMode ?? "foreign-keys";
-	return {
-		...require_kyselyCrud.createKyselyCrud(db, config.provider, relationMode),
-		recordInsights: (input) => db.transaction().execute((transaction) => require_kyselyCrud.recordKyselyInsights(transaction, config.provider, input)),
-		deleteChannel: (input) => db.transaction().execute((transaction) => require_kyselyCrud.createKyselyCrud(transaction, config.provider, relationMode).deleteChannel(input)),
-		create: (input) => db.transaction().execute((transaction) => require_kyselyCrud.createKyselyCrud(transaction, config.provider, relationMode).create(input)),
-		update: (input) => db.transaction().execute((transaction) => require_kyselyCrud.createKyselyCrud(transaction, config.provider, relationMode).update(input)),
-		delete: (input) => db.transaction().execute((transaction) => require_kyselyCrud.createKyselyCrud(transaction, config.provider, relationMode).delete(input)),
-		transaction: (callback) => db.transaction().execute((transaction) => callback(require_kyselyCrud.createKyselyCrud(transaction, config.provider, relationMode)))
-	};
-};
+/**
+* Hot Updater's database on a Kysely instance: the storage engine through the
+* shared SQL core, fenced by the schema settings. `db migrate` and
+* `db generate --sql` apply the engine's SQL schema.
+*/
 const kyselyAdapter = (config) => {
-	const adapter = (0, _hot_updater_plugin_core_internal.createDatabasePluginAdapter)("kysely", createImplementation(config));
-	const plugin = (0, _hot_updater_plugin_core.createDatabasePlugin)({
-		name: "kysely",
-		models: adapter.models,
-		commit: adapter.commit
-	});
-	return Object.assign(plugin, {
-		adapterName: "kysely",
-		provider: config.provider,
-		createMigrator: () => require_fixedMigrator.createKyselyMigrator({
-			db: config.db,
-			provider: config.provider,
-			relationMode: config.relationMode
+	const provider = require_sqlProviders.checkSqlProvider("kyselyAdapter", config.provider);
+	const executor = require_kyselyExecutor.kyselyExecutor(config.db, provider);
+	return {
+		...require_builtInDatabase.createEngineDatabase({
+			name: "kysely",
+			adapter: require_sqlAdapter.createSqlAdapter({ executor })
+		}),
+		provider,
+		createMigrator: ({ schema, settings } = require_builtInDatabase.builtInTarget) => require_engineSqlMigrator.createEngineSqlMigrator({
+			adapterName: "kysely",
+			executor,
+			schema,
+			settings
 		})
-	});
+	};
 };
 //#endregion
 exports.kyselyAdapter = kyselyAdapter;
+exports.kyselyExecutor = require_kyselyExecutor.kyselyExecutor;

package/dist/adapters/kysely.d.cts

@@ -1,12 +1,16 @@
-import { DatabaseAdapterWithCapabilities, ORMSQLProvider, RelationMode } from "../db/types.cjs";
+import { ORMSQLProvider, ToolingDatabase } from "../db/types.cjs";
+import { kyselyExecutor } from "./kyselyExecutor.cjs";
 import { Kysely } from "kysely";
 //#region src/adapters/kysely.d.ts
-type KyselySQLProvider = Exclude<ORMSQLProvider, "mssql">;
 interface KyselyAdapterConfig<TDatabase extends object = object> {
   readonly db: Kysely<TDatabase>;
-  readonly provider: KyselySQLProvider;
-  readonly relationMode?: RelationMode;
+  readonly provider: ORMSQLProvider;
 }
-declare const kyselyAdapter: <TDatabase extends object>(config: KyselyAdapterConfig<TDatabase>) => DatabaseAdapterWithCapabilities;
+/**
+ * Hot Updater's database on a Kysely instance: the storage engine through the
+ * shared SQL core, fenced by the schema settings. `db migrate` and
+ * `db generate --sql` apply the engine's SQL schema.
+ */
+declare const kyselyAdapter: <TDatabase extends object>(config: KyselyAdapterConfig<TDatabase>) => ToolingDatabase;
 //#endregion
-export { KyselyAdapterConfig, type RelationMode, type KyselySQLProvider as SQLProvider, kyselyAdapter };
+export { KyselyAdapterConfig, type ORMSQLProvider as SQLProvider, kyselyAdapter, kyselyExecutor };

package/dist/adapters/kysely.d.mts

@@ -1,12 +1,16 @@
-import { DatabaseAdapterWithCapabilities, ORMSQLProvider, RelationMode } from "../db/types.mjs";
+import { ORMSQLProvider, ToolingDatabase } from "../db/types.mjs";
+import { kyselyExecutor } from "./kyselyExecutor.mjs";
 import { Kysely } from "kysely";
 //#region src/adapters/kysely.d.ts
-type KyselySQLProvider = Exclude<ORMSQLProvider, "mssql">;
 interface KyselyAdapterConfig<TDatabase extends object = object> {
   readonly db: Kysely<TDatabase>;
-  readonly provider: KyselySQLProvider;
-  readonly relationMode?: RelationMode;
+  readonly provider: ORMSQLProvider;
 }
-declare const kyselyAdapter: <TDatabase extends object>(config: KyselyAdapterConfig<TDatabase>) => DatabaseAdapterWithCapabilities;
+/**
+ * Hot Updater's database on a Kysely instance: the storage engine through the
+ * shared SQL core, fenced by the schema settings. `db migrate` and
+ * `db generate --sql` apply the engine's SQL schema.
+ */
+declare const kyselyAdapter: <TDatabase extends object>(config: KyselyAdapterConfig<TDatabase>) => ToolingDatabase;
 //#endregion
-export { KyselyAdapterConfig, type RelationMode, type KyselySQLProvider as SQLProvider, kyselyAdapter };
+export { KyselyAdapterConfig, type ORMSQLProvider as SQLProvider, kyselyAdapter, kyselyExecutor };