@hot-updater/server 1.0.0-rc.3 → 1.0.0-rc.30

package/LICENSE

@@ -1,6 +1,6 @@
-MIT License
+MIT License with Hosted Service Attribution
 
-Copyright (c) 2023 Sungyu Kang 
+Copyright (c) 2023 Sungyu Kang
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -12,6 +12,16 @@ furnished to do so, subject to the following conditions:
 The above copyright notice and this permission notice shall be included in all
 copies or substantial portions of the Software.
 
+Hosted service attribution. If you make the Software, a modified version of
+it, or a service built on it available to third parties as a hosted or managed
+service, that is, a service that third parties use to deliver updates to their
+own apps, you must display the notice "Powered by hot-updater" with a link to
+https://hot-updater.dev or https://github.com/gronxb/hot-updater where the
+users of that service can reasonably see it, such as the service's dashboard,
+the footer of its website, or its about page. This condition does not apply
+when you run the Software only for your own apps, or for apps that you build
+or operate for your clients.
+
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
@@ -19,15 +29,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
-
----
-
-ADDITIONAL DISCLAIMER
-
-The authors of this software shall not be held responsible for any legal issues,
-regulatory violations, policy violations, or disputes arising from the use,
-distribution, or integration of this software.
-
-Users are solely responsible for ensuring compliance with all applicable laws,
-regulations, and third-party policies (including but not limited to app store
-policies).

package/dist/adapters/drizzle.cjs

@@ -1,83 +1,40 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_registry = require("../db/schema/registry.cjs");
-const require_schemaGenerators = require("../db/schemaGenerators.cjs");
-const require_insightsTransaction = require("./insightsTransaction.cjs");
-const require_drizzleCrud = require("./drizzleCrud.cjs");
-const require_drizzleLazyDB = require("./drizzleLazyDB.cjs");
+const require_sqlProviders = require("./sqlProviders.cjs");
+const require_engineDrizzleSchema = require("../db/engineDrizzleSchema.cjs");
+const require_drizzleExecutor = require("./drizzleExecutor.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
 //#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: (input) => {
-			if (transaction === void 0) throw new Error("Drizzle Insights recording requires transaction support.");
-			return require_insightsTransaction.runInsightsTransaction(() => transaction((transactionDatabase) => require_drizzleCrud.recordDrizzleInsights(transactionDatabase, 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: {
-				record: (input) => getAdapter().models.insights.record(input),
-				listEvents: (input) => getAdapter().models.insights.listEvents(input),
-				findInstallations: (input) => getAdapter().models.insights.findInstallations(input),
-				countInstallations: (input) => getAdapter().models.insights.countInstallations(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 {
+		...(0, _hot_updater_plugin_core.createEngineDatabase)({
+			name: "drizzle",
+			adapter: (0, _hot_updater_plugin_core.createSqlAdapter)({ executor })
+		}),
+		provider,
+		generateSchema: ((version, _name, { schema } = _hot_updater_plugin_core.coreTarget) => {
+			if (version !== "latest" && version !== _hot_updater_plugin_core.coreSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+			return {
+				code: require_engineDrizzleSchema.generateDrizzleEngineSchema(provider, schema),
+				path: "hot-updater-schema.ts"
+			};
+		}),
+		createMigrator: ({ settings } = _hot_updater_plugin_core.coreTarget) => (0, _hot_updater_plugin_core.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 { DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS } from "./drizzleExecutor.cjs";
+import { SqlDialect, ToolingDatabase } from "@hot-updater/plugin-core";
 //#region src/adapters/drizzle.d.ts
-type DrizzleProvider = Exclude<ORMProvider, "cockroachdb" | "mongodb" | "mssql">;
+type DrizzleProvider = SqlDialect;
 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 { DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS } from "./drizzleExecutor.mjs";
+import { SqlDialect, ToolingDatabase } from "@hot-updater/plugin-core";
 //#region src/adapters/drizzle.d.ts
-type DrizzleProvider = Exclude<ORMProvider, "cockroachdb" | "mongodb" | "mssql">;
+type DrizzleProvider = SqlDialect;
 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,82 +1,37 @@
-import { getHotUpdaterSchemaVersion, hotUpdaterSchema } from "../db/schema/registry.mjs";
-import { generateDrizzleSchema } from "../db/schemaGenerators.mjs";
-import { runInsightsTransaction } from "./insightsTransaction.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 { checkSqlProvider } from "./sqlProviders.mjs";
+import { generateDrizzleEngineSchema } from "../db/engineDrizzleSchema.mjs";
+import { DrizzleTransactionUnsupportedError, SUPPORTED_DRIZZLE_DRIVERS, drizzleExecutor } from "./drizzleExecutor.mjs";
+import { coreSettings, coreTarget, createEngineDatabase, createSettingsMigrator, createSqlAdapter } from "@hot-updater/plugin-core";
 //#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: (input) => {
-			if (transaction === void 0) throw new Error("Drizzle Insights recording requires transaction support.");
-			return runInsightsTransaction(() => transaction((transactionDatabase) => recordDrizzleInsights(transactionDatabase, 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: {
-				record: (input) => getAdapter().models.insights.record(input),
-				listEvents: (input) => getAdapter().models.insights.listEvents(input),
-				findInstallations: (input) => getAdapter().models.insights.findInstallations(input),
-				countInstallations: (input) => getAdapter().models.insights.countInstallations(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 } = coreTarget) => {
+			if (version !== "latest" && version !== coreSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+			return {
+				code: generateDrizzleEngineSchema(provider, schema),
+				path: "hot-updater-schema.ts"
+			};
+		}),
+		createMigrator: ({ settings } = coreTarget) => 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 { SqlDialect, SqlExecutor } from "@hot-updater/plugin-core";
+//#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 { SqlDialect, SqlExecutor } from "@hot-updater/plugin-core";
+//#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,39 +1,30 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_fixedMigrator = require("../db/fixedMigrator.cjs");
-const require_insightsTransaction = require("./insightsTransaction.cjs");
-const require_kyselyCrud = require("./kyselyCrud.cjs");
+const require_kyselyExecutor = require("./kyselyExecutor.cjs");
+const require_sqlProviders = require("./sqlProviders.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
 //#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) => require_insightsTransaction.runInsightsTransaction(() => 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 {
+		...(0, _hot_updater_plugin_core.createEngineDatabase)({
+			name: "kysely",
+			adapter: (0, _hot_updater_plugin_core.createSqlAdapter)({ executor })
+		}),
+		provider,
+		createMigrator: ({ schema, settings } = _hot_updater_plugin_core.coreTarget) => (0, _hot_updater_plugin_core.createEngineSqlMigrator)({
+			adapterName: "kysely",
+			executor,
+			schema,
+			settings
 		})
-	});
+	};
 };
 //#endregion
 exports.kyselyAdapter = kyselyAdapter;
+exports.kyselyExecutor = require_kyselyExecutor.kyselyExecutor;