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

package/dist/db/engineDrizzleSchema.cjs

@@ -0,0 +1,54 @@
+const require_fence = require("../database/fence.cjs");
+const require_sqlSchema = require("../database/sql/sqlSchema.cjs");
+//#region src/db/engineDrizzleSchema.ts
+const drizzle = {
+	postgresql: {
+		module: "drizzle-orm/pg-core",
+		table: "pgTable"
+	},
+	mysql: {
+		module: "drizzle-orm/mysql-core",
+		table: "mysqlTable"
+	},
+	sqlite: {
+		module: "drizzle-orm/sqlite-core",
+		table: "sqliteTable"
+	}
+};
+const literal = (value) => JSON.stringify(value);
+/**
+* The Drizzle schema `drizzle-kit` applies for the engine's tables: every
+* column typed exactly as the engine's DDL, keys, indexes, index tables, and
+* the settings table. The engine keeps references itself, so there are no
+* foreign keys. `hot-updater db migrate` then writes only the settings rows.
+*/
+const generateDrizzleEngineSchema = (dialect, schema) => {
+	const { module, table: tableFunction } = drizzle[dialect];
+	const tables = [...schema.tables, require_fence.SETTINGS_TABLE];
+	const blocks = [];
+	const emit = (shape) => {
+		const columns = shape.columns.map((column) => `  ${literal(column.name)}: column(${literal(column.type)})(${literal(column.name)})${column.notNull ? ".notNull()" : ""}${column.default === void 0 ? "" : `.default(${column.default})`},`);
+		const at = (name) => `table[${literal(name)}]`;
+		const extras = [`primaryKey({ columns: [${shape.key.map(at).join(", ")}] })`, ...shape.indexes.flatMap((index) => index.kind === "index" ? [`${index.unique ? "uniqueIndex" : "index"}(${literal(index.name)}).on(${index.columns.map(at).join(", ")})`] : [])];
+		blocks.push(`export const ${shape.name} = ${tableFunction}(${literal(shape.name)}, {\n${columns.join("\n")}\n}, (table) => [\n${extras.map((extra) => `  ${extra},`).join("\n")}\n]);`);
+		for (const index of shape.indexes) if (index.kind === "table") emit(index.table);
+	};
+	for (const shape of require_sqlSchema.sqlTableShapes(dialect, tables)) emit(shape);
+	return [
+		"// Generated by `hot-updater db generate` from Hot Updater's schema. Do not edit.",
+		`import { ${[
+			"customType",
+			"index",
+			"primaryKey",
+			"uniqueIndex"
+		].filter((name) => name === "customType" ? true : blocks.some((block) => block.includes(`${name}(`))).concat(tableFunction).sort().join(", ")} } from ${literal(module)};`,
+		"",
+		"/** A column typed exactly as Hot Updater's SQL schema declares it. */",
+		"const column = (type: string) =>",
+		"  customType<{ data: unknown; driverData: unknown }>({ dataType: () => type });",
+		"",
+		...blocks.flatMap((block) => [block, ""])
+	].join("\n");
+};
+//#endregion
+exports.generateDrizzleEngineSchema = generateDrizzleEngineSchema;

package/dist/db/engineDrizzleSchema.mjs

@@ -0,0 +1,54 @@
+import { SETTINGS_TABLE } from "../database/fence.mjs";
+import { sqlTableShapes } from "../database/sql/sqlSchema.mjs";
+//#region src/db/engineDrizzleSchema.ts
+const drizzle = {
+	postgresql: {
+		module: "drizzle-orm/pg-core",
+		table: "pgTable"
+	},
+	mysql: {
+		module: "drizzle-orm/mysql-core",
+		table: "mysqlTable"
+	},
+	sqlite: {
+		module: "drizzle-orm/sqlite-core",
+		table: "sqliteTable"
+	}
+};
+const literal = (value) => JSON.stringify(value);
+/**
+* The Drizzle schema `drizzle-kit` applies for the engine's tables: every
+* column typed exactly as the engine's DDL, keys, indexes, index tables, and
+* the settings table. The engine keeps references itself, so there are no
+* foreign keys. `hot-updater db migrate` then writes only the settings rows.
+*/
+const generateDrizzleEngineSchema = (dialect, schema) => {
+	const { module, table: tableFunction } = drizzle[dialect];
+	const tables = [...schema.tables, SETTINGS_TABLE];
+	const blocks = [];
+	const emit = (shape) => {
+		const columns = shape.columns.map((column) => `  ${literal(column.name)}: column(${literal(column.type)})(${literal(column.name)})${column.notNull ? ".notNull()" : ""}${column.default === void 0 ? "" : `.default(${column.default})`},`);
+		const at = (name) => `table[${literal(name)}]`;
+		const extras = [`primaryKey({ columns: [${shape.key.map(at).join(", ")}] })`, ...shape.indexes.flatMap((index) => index.kind === "index" ? [`${index.unique ? "uniqueIndex" : "index"}(${literal(index.name)}).on(${index.columns.map(at).join(", ")})`] : [])];
+		blocks.push(`export const ${shape.name} = ${tableFunction}(${literal(shape.name)}, {\n${columns.join("\n")}\n}, (table) => [\n${extras.map((extra) => `  ${extra},`).join("\n")}\n]);`);
+		for (const index of shape.indexes) if (index.kind === "table") emit(index.table);
+	};
+	for (const shape of sqlTableShapes(dialect, tables)) emit(shape);
+	return [
+		"// Generated by `hot-updater db generate` from Hot Updater's schema. Do not edit.",
+		`import { ${[
+			"customType",
+			"index",
+			"primaryKey",
+			"uniqueIndex"
+		].filter((name) => name === "customType" ? true : blocks.some((block) => block.includes(`${name}(`))).concat(tableFunction).sort().join(", ")} } from ${literal(module)};`,
+		"",
+		"/** A column typed exactly as Hot Updater's SQL schema declares it. */",
+		"const column = (type: string) =>",
+		"  customType<{ data: unknown; driverData: unknown }>({ dataType: () => type });",
+		"",
+		...blocks.flatMap((block) => [block, ""])
+	].join("\n");
+};
+//#endregion
+export { generateDrizzleEngineSchema };

package/dist/db/engineMigrator.cjs

@@ -0,0 +1,53 @@
+const require_schema = require("../core/schema.cjs");
+const require_fixedMigratorShared = require("./fixedMigratorShared.cjs");
+const require_schemaSettings = require("./schemaSettings.cjs");
+const require_settingsMigrator = require("./settingsMigrator.cjs");
+//#region src/db/engineMigrator.ts
+/**
+* `hot-updater db migrate` for a store whose adapter creates its own tables
+* (MongoDB and the key-value stores): the tables and indexes, then the
+* settings rows, applied when a setting is missing or different, and refused
+* on a database from before the engine.
+*/
+const createEngineMigrator = (options) => {
+	const getVersion = async () => require_settingsMigrator.storedSchemaVersion(await options.readSettings());
+	const makeResult = async (migrate = {}) => {
+		require_fixedMigratorShared.assertSupportedMigrationMode(migrate);
+		const stored = await options.readSettings();
+		require_settingsMigrator.refusePreEngineDatabase(options.adapterName, stored);
+		if (Object.entries(options.settings).every(([key, value]) => stored.get(key) === value)) return require_fixedMigratorShared.getEmptyMigrationResult();
+		return {
+			operations: [...options.schema.tables.map((table) => ({
+				type: "create-table",
+				value: {
+					ormName: table.name,
+					columns: Object.fromEntries(table.columns.map((column) => [column.name, {
+						ormName: column.name,
+						type: column.type
+					}]))
+				}
+			})), ...migrate.updateSettings === false ? [] : [{
+				type: "custom",
+				description: `Write the schema settings: ${Object.keys(options.settings).join(", ")}`
+			}]],
+			execute: () => require_schemaSettings.migrateSchema(options.adapter, options.adapterName, options.schema.tables, options.settings)
+		};
+	};
+	return {
+		getVersion,
+		getNameVariants: async () => void 0,
+		next: async () => await getVersion() === "1.0.0" ? void 0 : { version: require_schema.HOT_UPDATER_SCHEMA_VERSION },
+		previous: async () => void 0,
+		up: makeResult,
+		down: async () => {
+			throw new Error("No previous schema to migrate to.");
+		},
+		migrateTo: async (version, migrate) => {
+			if (version !== "1.0.0") throw new Error(`Invalid version ${version}`);
+			return makeResult(migrate);
+		},
+		migrateToLatest: makeResult
+	};
+};
+//#endregion
+exports.createEngineMigrator = createEngineMigrator;

package/dist/db/engineMigrator.mjs

@@ -0,0 +1,53 @@
+import { HOT_UPDATER_SCHEMA_VERSION } from "../core/schema.mjs";
+import { assertSupportedMigrationMode, getEmptyMigrationResult } from "./fixedMigratorShared.mjs";
+import { migrateSchema } from "./schemaSettings.mjs";
+import { refusePreEngineDatabase, storedSchemaVersion } from "./settingsMigrator.mjs";
+//#region src/db/engineMigrator.ts
+/**
+* `hot-updater db migrate` for a store whose adapter creates its own tables
+* (MongoDB and the key-value stores): the tables and indexes, then the
+* settings rows, applied when a setting is missing or different, and refused
+* on a database from before the engine.
+*/
+const createEngineMigrator = (options) => {
+	const getVersion = async () => storedSchemaVersion(await options.readSettings());
+	const makeResult = async (migrate = {}) => {
+		assertSupportedMigrationMode(migrate);
+		const stored = await options.readSettings();
+		refusePreEngineDatabase(options.adapterName, stored);
+		if (Object.entries(options.settings).every(([key, value]) => stored.get(key) === value)) return getEmptyMigrationResult();
+		return {
+			operations: [...options.schema.tables.map((table) => ({
+				type: "create-table",
+				value: {
+					ormName: table.name,
+					columns: Object.fromEntries(table.columns.map((column) => [column.name, {
+						ormName: column.name,
+						type: column.type
+					}]))
+				}
+			})), ...migrate.updateSettings === false ? [] : [{
+				type: "custom",
+				description: `Write the schema settings: ${Object.keys(options.settings).join(", ")}`
+			}]],
+			execute: () => migrateSchema(options.adapter, options.adapterName, options.schema.tables, options.settings)
+		};
+	};
+	return {
+		getVersion,
+		getNameVariants: async () => void 0,
+		next: async () => await getVersion() === "1.0.0" ? void 0 : { version: HOT_UPDATER_SCHEMA_VERSION },
+		previous: async () => void 0,
+		up: makeResult,
+		down: async () => {
+			throw new Error("No previous schema to migrate to.");
+		},
+		migrateTo: async (version, migrate) => {
+			if (version !== "1.0.0") throw new Error(`Invalid version ${version}`);
+			return makeResult(migrate);
+		},
+		migrateToLatest: makeResult
+	};
+};
+//#endregion
+export { createEngineMigrator };

package/dist/db/enginePrismaSchema.cjs

@@ -0,0 +1,85 @@
+const require_fence = require("../database/fence.cjs");
+const require_sqlSchema = require("../database/sql/sqlSchema.cjs");
+//#region src/db/enginePrismaSchema.ts
+const SCALARS = {
+	TEXT: "String",
+	INTEGER: "BigInt",
+	REAL: "Float",
+	bigint: "BigInt",
+	"double precision": "Float",
+	double: "Float",
+	boolean: "Boolean",
+	jsonb: "Json",
+	json: "Json"
+};
+/**
+* A column's Prisma type from the DDL type the shared SQL schema gives it.
+* MySQL's ASCII keys become `VarBinary`: the same bytes and order as
+* `ascii_bin`, within InnoDB's key limit without a character set.
+*/
+const prismaColumn = (provider, { type }) => {
+	const length = /^varchar\((\d+)\)/u.exec(type)?.[1];
+	if (provider === "mysql" && type.includes("CHARACTER SET")) {
+		if (type.includes("CHARACTER SET ascii") && length) return {
+			scalar: "Bytes",
+			native: `@db.VarBinary(${length})`
+		};
+		return {
+			scalar: "String",
+			native: length ? `@db.VarChar(${length})` : "@db.LongText",
+			collate: true
+		};
+	}
+	if (provider === "postgresql" && type.includes("COLLATE")) return {
+		scalar: "String",
+		...length ? { native: `@db.VarChar(${length})` } : {},
+		collate: true
+	};
+	return { scalar: SCALARS[type] ?? "String" };
+};
+/** Prisma fields start with a letter: `_v` becomes `hu_v`, mapped back to `_v`. */
+const fieldName = (column) => column.startsWith("_") ? `hu${column}` : column;
+const list = (columns) => `[${columns.map(fieldName).join(", ")}]`;
+const flatten = (shapes) => shapes.flatMap((shape) => [shape, ...flatten(shape.indexes.flatMap((index) => index.kind === "table" ? [index.table] : []))]);
+const shapesOf = (provider, schema) => flatten(require_sqlSchema.sqlTableShapes(provider, [...schema.tables, require_fence.SETTINGS_TABLE]));
+const renderField = (provider, column) => {
+	const { scalar, native } = prismaColumn(provider, column);
+	const name = fieldName(column.name);
+	return [
+		`${name} ${scalar}${column.notNull ? "" : "?"}`,
+		...native === void 0 ? [] : [native],
+		...column.default === void 0 ? [] : [`@default(${column.default})`],
+		...name === column.name ? [] : [`@map(${JSON.stringify(column.name)})`]
+	].join(" ");
+};
+/**
+* Hot Updater's tables as Prisma models, for `prisma db push` or
+* `prisma migrate`: keys, indexes, index tables, and the settings table.
+* The engine keeps references itself, so the models have no relations.
+*/
+const generatePrismaEngineSchema = (provider, schema) => shapesOf(provider, schema).map((shape) => {
+	const lines = [
+		...shape.columns.map((column) => renderField(provider, column)),
+		`@@id(${list(shape.key)})`,
+		...shape.indexes.flatMap((index) => index.kind === "index" ? [`@@${index.unique ? "unique" : "index"}(${list(index.columns)}, map: ${JSON.stringify(index.name)})`] : [])
+	];
+	return `model ${shape.name} {\n${lines.map((line) => `  ${line}`).join("\n")}\n}`;
+}).join("\n\n");
+/**
+* The collations Prisma cannot declare, which `hot-updater db migrate` sets
+* after Prisma created the tables: `COLLATE "C"` on PostgreSQL and binary
+* UTF-8 on MySQL, so strings compare by their bytes as the engine expects.
+* The settings table is only read by key, and the migrator has already read
+* it: altering it would invalidate PostgreSQL's cached plan for that read.
+*/
+const prismaCollationStatements = (provider, schema) => {
+	if (provider !== "postgresql" && provider !== "mysql") return [];
+	const quote = (name) => require_sqlSchema.quoteSql(provider, name);
+	return shapesOf(provider, schema).filter((shape) => shape.name !== require_fence.SETTINGS_TABLE.name).flatMap((shape) => {
+		const changes = shape.columns.filter((column) => prismaColumn(provider, column).collate).map((column) => provider === "postgresql" ? `ALTER COLUMN ${quote(column.name)} TYPE ${column.type}` : `MODIFY ${quote(column.name)} ${column.type}${column.notNull ? " NOT NULL" : " NULL"}`);
+		return changes.length === 0 ? [] : [`ALTER TABLE ${quote(shape.name)} ${changes.join(", ")}`];
+	});
+};
+//#endregion
+exports.generatePrismaEngineSchema = generatePrismaEngineSchema;
+exports.prismaCollationStatements = prismaCollationStatements;

package/dist/db/enginePrismaSchema.d.cts

@@ -0,0 +1,5 @@
+import "../database/resolveSchema.cjs";
+//#region src/db/enginePrismaSchema.d.ts
+type PrismaProvider = "postgresql" | "mysql" | "sqlite";
+//#endregion
+export { PrismaProvider };

package/dist/db/enginePrismaSchema.d.mts

@@ -0,0 +1,5 @@
+import "../database/resolveSchema.mjs";
+//#region src/db/enginePrismaSchema.d.ts
+type PrismaProvider = "postgresql" | "mysql" | "sqlite";
+//#endregion
+export { PrismaProvider };

package/dist/db/enginePrismaSchema.mjs

@@ -0,0 +1,84 @@
+import { SETTINGS_TABLE } from "../database/fence.mjs";
+import { quoteSql, sqlTableShapes } from "../database/sql/sqlSchema.mjs";
+//#region src/db/enginePrismaSchema.ts
+const SCALARS = {
+	TEXT: "String",
+	INTEGER: "BigInt",
+	REAL: "Float",
+	bigint: "BigInt",
+	"double precision": "Float",
+	double: "Float",
+	boolean: "Boolean",
+	jsonb: "Json",
+	json: "Json"
+};
+/**
+* A column's Prisma type from the DDL type the shared SQL schema gives it.
+* MySQL's ASCII keys become `VarBinary`: the same bytes and order as
+* `ascii_bin`, within InnoDB's key limit without a character set.
+*/
+const prismaColumn = (provider, { type }) => {
+	const length = /^varchar\((\d+)\)/u.exec(type)?.[1];
+	if (provider === "mysql" && type.includes("CHARACTER SET")) {
+		if (type.includes("CHARACTER SET ascii") && length) return {
+			scalar: "Bytes",
+			native: `@db.VarBinary(${length})`
+		};
+		return {
+			scalar: "String",
+			native: length ? `@db.VarChar(${length})` : "@db.LongText",
+			collate: true
+		};
+	}
+	if (provider === "postgresql" && type.includes("COLLATE")) return {
+		scalar: "String",
+		...length ? { native: `@db.VarChar(${length})` } : {},
+		collate: true
+	};
+	return { scalar: SCALARS[type] ?? "String" };
+};
+/** Prisma fields start with a letter: `_v` becomes `hu_v`, mapped back to `_v`. */
+const fieldName = (column) => column.startsWith("_") ? `hu${column}` : column;
+const list = (columns) => `[${columns.map(fieldName).join(", ")}]`;
+const flatten = (shapes) => shapes.flatMap((shape) => [shape, ...flatten(shape.indexes.flatMap((index) => index.kind === "table" ? [index.table] : []))]);
+const shapesOf = (provider, schema) => flatten(sqlTableShapes(provider, [...schema.tables, SETTINGS_TABLE]));
+const renderField = (provider, column) => {
+	const { scalar, native } = prismaColumn(provider, column);
+	const name = fieldName(column.name);
+	return [
+		`${name} ${scalar}${column.notNull ? "" : "?"}`,
+		...native === void 0 ? [] : [native],
+		...column.default === void 0 ? [] : [`@default(${column.default})`],
+		...name === column.name ? [] : [`@map(${JSON.stringify(column.name)})`]
+	].join(" ");
+};
+/**
+* Hot Updater's tables as Prisma models, for `prisma db push` or
+* `prisma migrate`: keys, indexes, index tables, and the settings table.
+* The engine keeps references itself, so the models have no relations.
+*/
+const generatePrismaEngineSchema = (provider, schema) => shapesOf(provider, schema).map((shape) => {
+	const lines = [
+		...shape.columns.map((column) => renderField(provider, column)),
+		`@@id(${list(shape.key)})`,
+		...shape.indexes.flatMap((index) => index.kind === "index" ? [`@@${index.unique ? "unique" : "index"}(${list(index.columns)}, map: ${JSON.stringify(index.name)})`] : [])
+	];
+	return `model ${shape.name} {\n${lines.map((line) => `  ${line}`).join("\n")}\n}`;
+}).join("\n\n");
+/**
+* The collations Prisma cannot declare, which `hot-updater db migrate` sets
+* after Prisma created the tables: `COLLATE "C"` on PostgreSQL and binary
+* UTF-8 on MySQL, so strings compare by their bytes as the engine expects.
+* The settings table is only read by key, and the migrator has already read
+* it: altering it would invalidate PostgreSQL's cached plan for that read.
+*/
+const prismaCollationStatements = (provider, schema) => {
+	if (provider !== "postgresql" && provider !== "mysql") return [];
+	const quote = (name) => quoteSql(provider, name);
+	return shapesOf(provider, schema).filter((shape) => shape.name !== SETTINGS_TABLE.name).flatMap((shape) => {
+		const changes = shape.columns.filter((column) => prismaColumn(provider, column).collate).map((column) => provider === "postgresql" ? `ALTER COLUMN ${quote(column.name)} TYPE ${column.type}` : `MODIFY ${quote(column.name)} ${column.type}${column.notNull ? " NOT NULL" : " NULL"}`);
+		return changes.length === 0 ? [] : [`ALTER TABLE ${quote(shape.name)} ${changes.join(", ")}`];
+	});
+};
+//#endregion
+export { generatePrismaEngineSchema, prismaCollationStatements };

package/dist/db/engineSql.cjs

@@ -0,0 +1,26 @@
+const require_fence = require("../database/fence.cjs");
+const require_sqlSchema = require("../database/sql/sqlSchema.cjs");
+//#region src/db/engineSql.ts
+const literal = (text) => `'${text.replaceAll("'", "''")}'`;
+/** Upserts of the settings rows the fence reads. */
+const settingsStatements = (dialect, settings, tablePrefix = "") => {
+	const quote = (name) => require_sqlSchema.quoteSql(dialect, name);
+	const [key, value, version] = [
+		"key",
+		"value",
+		"_v"
+	].map(quote);
+	return Object.entries(settings).map(([name, text]) => {
+		const insert = `INSERT INTO ${quote(tablePrefix + require_fence.SETTINGS_TABLE.name)} (${key}, ${value}, ${version}) VALUES (${literal(name)}, ${literal(text)}, 0)`;
+		return dialect === "mysql" ? `${insert} ON DUPLICATE KEY UPDATE ${value} = VALUES(${value})` : `${insert} ON CONFLICT (${key}) DO UPDATE SET ${value} = excluded.${value}`;
+	});
+};
+/**
+* A resolved schema as SQL: its tables and indexes, then the settings rows
+* last, so the fence passes only once everything exists. There are no
+* database foreign keys: the engine keeps references itself.
+*/
+const generateEngineSql = (dialect, schema, settings, options = {}) => [...require_sqlSchema.createTableStatements(dialect, [...schema.tables, require_fence.SETTINGS_TABLE], options.tablePrefix), ...settingsStatements(dialect, settings, options.tablePrefix)];
+//#endregion
+exports.generateEngineSql = generateEngineSql;
+exports.settingsStatements = settingsStatements;

package/dist/db/engineSql.d.cts

@@ -0,0 +1,17 @@
+import { SchemaSettings } from "../database/fence.cjs";
+import { ResolvedSchema } from "../database/resolveSchema.cjs";
+import { SqlDialect } from "../database/sql/sqlSchema.cjs";
+//#region src/db/engineSql.d.ts
+interface EngineSqlOptions {
+  readonly tablePrefix?: string;
+}
+/** Upserts of the settings rows the fence reads. */
+declare const settingsStatements: (dialect: SqlDialect, settings: SchemaSettings, tablePrefix?: string) => string[];
+/**
+ * A resolved schema as SQL: its tables and indexes, then the settings rows
+ * last, so the fence passes only once everything exists. There are no
+ * database foreign keys: the engine keeps references itself.
+ */
+declare const generateEngineSql: (dialect: SqlDialect, schema: ResolvedSchema, settings: SchemaSettings, options?: EngineSqlOptions) => string[];
+//#endregion
+export { EngineSqlOptions, generateEngineSql, settingsStatements };

package/dist/db/engineSql.d.mts

@@ -0,0 +1,17 @@
+import { SchemaSettings } from "../database/fence.mjs";
+import { ResolvedSchema } from "../database/resolveSchema.mjs";
+import { SqlDialect } from "../database/sql/sqlSchema.mjs";
+//#region src/db/engineSql.d.ts
+interface EngineSqlOptions {
+  readonly tablePrefix?: string;
+}
+/** Upserts of the settings rows the fence reads. */
+declare const settingsStatements: (dialect: SqlDialect, settings: SchemaSettings, tablePrefix?: string) => string[];
+/**
+ * A resolved schema as SQL: its tables and indexes, then the settings rows
+ * last, so the fence passes only once everything exists. There are no
+ * database foreign keys: the engine keeps references itself.
+ */
+declare const generateEngineSql: (dialect: SqlDialect, schema: ResolvedSchema, settings: SchemaSettings, options?: EngineSqlOptions) => string[];
+//#endregion
+export { EngineSqlOptions, generateEngineSql, settingsStatements };

package/dist/db/engineSql.mjs

@@ -0,0 +1,25 @@
+import { SETTINGS_TABLE } from "../database/fence.mjs";
+import { createTableStatements, quoteSql } from "../database/sql/sqlSchema.mjs";
+//#region src/db/engineSql.ts
+const literal = (text) => `'${text.replaceAll("'", "''")}'`;
+/** Upserts of the settings rows the fence reads. */
+const settingsStatements = (dialect, settings, tablePrefix = "") => {
+	const quote = (name) => quoteSql(dialect, name);
+	const [key, value, version] = [
+		"key",
+		"value",
+		"_v"
+	].map(quote);
+	return Object.entries(settings).map(([name, text]) => {
+		const insert = `INSERT INTO ${quote(tablePrefix + SETTINGS_TABLE.name)} (${key}, ${value}, ${version}) VALUES (${literal(name)}, ${literal(text)}, 0)`;
+		return dialect === "mysql" ? `${insert} ON DUPLICATE KEY UPDATE ${value} = VALUES(${value})` : `${insert} ON CONFLICT (${key}) DO UPDATE SET ${value} = excluded.${value}`;
+	});
+};
+/**
+* A resolved schema as SQL: its tables and indexes, then the settings rows
+* last, so the fence passes only once everything exists. There are no
+* database foreign keys: the engine keeps references itself.
+*/
+const generateEngineSql = (dialect, schema, settings, options = {}) => [...createTableStatements(dialect, [...schema.tables, SETTINGS_TABLE], options.tablePrefix), ...settingsStatements(dialect, settings, options.tablePrefix)];
+//#endregion
+export { generateEngineSql, settingsStatements };

package/dist/db/engineSqlMigrator.cjs

@@ -0,0 +1,66 @@
+const require_schema = require("../core/schema.cjs");
+const require_fixedMigratorShared = require("./fixedMigratorShared.cjs");
+const require_engineSql = require("./engineSql.cjs");
+const require_settingsMigrator = require("./settingsMigrator.cjs");
+//#region src/db/engineSqlMigrator.ts
+/** Runs the statements in one transaction where the dialect's DDL is transactional. */
+const run = async (executor, statements) => {
+	const each = async (connection) => {
+		for (const sql of statements) await connection.execute({
+			sql,
+			params: []
+		});
+	};
+	await (executor.dialect === "mysql" ? each(executor) : executor.transaction(each));
+};
+/**
+* `hot-updater db migrate` and `db generate` for an SQL provider on the
+* engine: the generated SQL schema, applied when a settings row is missing or
+* different, and refused on a database from before the engine.
+*/
+const createEngineSqlMigrator = (options) => {
+	/** No settings table yet reads as an empty database. */
+	const read = async () => await require_settingsMigrator.readStoredSettings(options.executor, options.tablePrefix) ?? /* @__PURE__ */ new Map();
+	const getVersion = async () => require_settingsMigrator.storedSchemaVersion(await read());
+	const makeResult = async (migrate = {}) => {
+		require_fixedMigratorShared.assertSupportedMigrationMode(migrate);
+		const stored = await read();
+		require_settingsMigrator.refusePreEngineDatabase(options.adapterName, stored);
+		if (Object.entries(options.settings).every(([key, value]) => stored.get(key) === value)) return require_fixedMigratorShared.getEmptyMigrationResult();
+		const statements = require_engineSql.generateEngineSql(options.executor.dialect, options.schema, options.settings, options);
+		return {
+			operations: [...options.schema.tables.map((table) => ({
+				type: "create-table",
+				value: {
+					ormName: table.name,
+					columns: Object.fromEntries(table.columns.map((column) => [column.name, {
+						ormName: column.name,
+						type: column.type
+					}]))
+				}
+			})), ...migrate.updateSettings === false ? [] : [{
+				type: "custom",
+				description: `Write the schema settings: ${Object.keys(options.settings).join(", ")}`
+			}]],
+			getSQL: () => statements.map((statement) => `${statement};`).join("\n\n"),
+			execute: () => run(options.executor, statements)
+		};
+	};
+	return {
+		getVersion,
+		getNameVariants: async () => void 0,
+		next: async () => await getVersion() === "1.0.0" ? void 0 : { version: require_schema.HOT_UPDATER_SCHEMA_VERSION },
+		previous: async () => void 0,
+		up: makeResult,
+		down: async () => {
+			throw new Error("No previous schema to migrate to.");
+		},
+		migrateTo: async (version, migrate) => {
+			if (version !== "1.0.0") throw new Error(`Invalid version ${version}`);
+			return makeResult(migrate);
+		},
+		migrateToLatest: makeResult
+	};
+};
+//#endregion
+exports.createEngineSqlMigrator = createEngineSqlMigrator;

package/dist/db/engineSqlMigrator.mjs

@@ -0,0 +1,66 @@
+import { HOT_UPDATER_SCHEMA_VERSION } from "../core/schema.mjs";
+import { assertSupportedMigrationMode, getEmptyMigrationResult } from "./fixedMigratorShared.mjs";
+import { generateEngineSql } from "./engineSql.mjs";
+import { readStoredSettings, refusePreEngineDatabase, storedSchemaVersion } from "./settingsMigrator.mjs";
+//#region src/db/engineSqlMigrator.ts
+/** Runs the statements in one transaction where the dialect's DDL is transactional. */
+const run = async (executor, statements) => {
+	const each = async (connection) => {
+		for (const sql of statements) await connection.execute({
+			sql,
+			params: []
+		});
+	};
+	await (executor.dialect === "mysql" ? each(executor) : executor.transaction(each));
+};
+/**
+* `hot-updater db migrate` and `db generate` for an SQL provider on the
+* engine: the generated SQL schema, applied when a settings row is missing or
+* different, and refused on a database from before the engine.
+*/
+const createEngineSqlMigrator = (options) => {
+	/** No settings table yet reads as an empty database. */
+	const read = async () => await readStoredSettings(options.executor, options.tablePrefix) ?? /* @__PURE__ */ new Map();
+	const getVersion = async () => storedSchemaVersion(await read());
+	const makeResult = async (migrate = {}) => {
+		assertSupportedMigrationMode(migrate);
+		const stored = await read();
+		refusePreEngineDatabase(options.adapterName, stored);
+		if (Object.entries(options.settings).every(([key, value]) => stored.get(key) === value)) return getEmptyMigrationResult();
+		const statements = generateEngineSql(options.executor.dialect, options.schema, options.settings, options);
+		return {
+			operations: [...options.schema.tables.map((table) => ({
+				type: "create-table",
+				value: {
+					ormName: table.name,
+					columns: Object.fromEntries(table.columns.map((column) => [column.name, {
+						ormName: column.name,
+						type: column.type
+					}]))
+				}
+			})), ...migrate.updateSettings === false ? [] : [{
+				type: "custom",
+				description: `Write the schema settings: ${Object.keys(options.settings).join(", ")}`
+			}]],
+			getSQL: () => statements.map((statement) => `${statement};`).join("\n\n"),
+			execute: () => run(options.executor, statements)
+		};
+	};
+	return {
+		getVersion,
+		getNameVariants: async () => void 0,
+		next: async () => await getVersion() === "1.0.0" ? void 0 : { version: HOT_UPDATER_SCHEMA_VERSION },
+		previous: async () => void 0,
+		up: makeResult,
+		down: async () => {
+			throw new Error("No previous schema to migrate to.");
+		},
+		migrateTo: async (version, migrate) => {
+			if (version !== "1.0.0") throw new Error(`Invalid version ${version}`);
+			return makeResult(migrate);
+		},
+		migrateToLatest: makeResult
+	};
+};
+//#endregion
+export { createEngineSqlMigrator };

package/dist/db/fixedMigratorShared.cjs

@@ -1,4 +1,3 @@
-const require_types = require("../schema/types.cjs");
 //#region src/db/fixedMigratorShared.ts
 const getEmptyMigrationResult = () => ({
 	operations: [],
@@ -8,16 +7,6 @@ const getEmptyMigrationResult = () => ({
 const assertSupportedMigrationMode = (options) => {
 	if (options.mode === "from-database") throw new Error("Hot Updater migrations support only mode: 'from-schema'.");
 };
-const unsupportedSchemaUpgradeMessage = (version) => `Hot Updater v1 cannot migrate schema ${version} in place. Create a new empty database and run migrate or generate against schema ${require_types.HOT_UPDATER_SCHEMA_VERSION}.`;
-const assertCurrentOrEmptySchemaVersion = (currentVersion) => {
-	if (currentVersion !== void 0 && currentVersion !== "1.0.0") throw new Error(unsupportedSchemaUpgradeMessage(currentVersion));
-};
-const inferLegacyCoreSchemaVersion = (legacyVersion) => legacyVersion;
-const isCurrentSchemaVersion = (currentVersion) => currentVersion === require_types.HOT_UPDATER_SCHEMA_VERSION;
 //#endregion
-exports.assertCurrentOrEmptySchemaVersion = assertCurrentOrEmptySchemaVersion;
 exports.assertSupportedMigrationMode = assertSupportedMigrationMode;
 exports.getEmptyMigrationResult = getEmptyMigrationResult;
-exports.inferLegacyCoreSchemaVersion = inferLegacyCoreSchemaVersion;
-exports.isCurrentSchemaVersion = isCurrentSchemaVersion;
-exports.unsupportedSchemaUpgradeMessage = unsupportedSchemaUpgradeMessage;