@hot-updater/server 0.33.2 → 0.34.0

package/dist/db/pluginCore.cjs

@@ -50,12 +50,13 @@ const INIT_BUNDLE_ROLLBACK_UPDATE_INFO = {
 	fileHash: null
 };
 function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
+	const coreOptions = options;
 	const runWithMutationPlugin = async (operation) => {
-		const plugin = options?.createMutationPlugin?.() ?? getPlugin();
+		const plugin = coreOptions?.createMutationPlugin?.() ?? getPlugin();
 		try {
 			return await operation(plugin);
 		} finally {
-			if (options?.createMutationPlugin) await options.cleanupMutationPlugin?.(plugin);
+			if (coreOptions?.createMutationPlugin) await coreOptions.cleanupMutationPlugin?.(plugin);
 		}
 	};
 	const getSortedBundlePage = async (options, context) => {
@@ -114,9 +115,11 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 	return {
 		api: {
 			async getBundleById(id, context) {
+				await coreOptions?.beforeOperation?.();
 				return getPlugin().getBundleById(id, context);
 			},
 			async getUpdateInfo(args, context) {
+				await coreOptions?.beforeOperation?.();
 				const directGetUpdateInfo = getPlugin().getUpdateInfo;
 				if (directGetUpdateInfo) return context === void 0 ? await directGetUpdateInfo(args) : await directGetUpdateInfo(args, context);
 				const channel = args.channel ?? "production";
@@ -150,7 +153,7 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 				const info = await this.getUpdateInfo(args, context);
 				if (!info) return null;
 				const { storageUri, ...rest } = info;
-				const readStorageText = options?.readStorageText;
+				const readStorageText = coreOptions?.readStorageText;
 				if (info.id === _hot_updater_core.NIL_UUID || !readStorageText) {
 					const fileUrl = await resolveFileUrl(storageUri ?? null, context);
 					return {
@@ -188,12 +191,15 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 				};
 			},
 			async getChannels(context) {
+				await coreOptions?.beforeOperation?.();
 				return getPlugin().getChannels(context);
 			},
 			async getBundles(options, context) {
+				await coreOptions?.beforeOperation?.();
 				return getPlugin().getBundles(options, context);
 			},
 			async insertBundle(bundle, context) {
+				await coreOptions?.beforeOperation?.();
 				require_schemaEnhancements.assertBundlePersistenceConstraints(bundle);
 				await runWithMutationPlugin(async (plugin) => {
 					await plugin.appendBundle(bundle, context);
@@ -201,6 +207,7 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 				});
 			},
 			async updateBundleById(bundleId, newBundle, context) {
+				await coreOptions?.beforeOperation?.();
 				await runWithMutationPlugin(async (plugin) => {
 					const current = await plugin.getBundleById(bundleId, context);
 					if (!current) throw new Error("targetBundleId not found");
@@ -213,6 +220,7 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 				});
 			},
 			async deleteBundleById(bundleId, context) {
+				await coreOptions?.beforeOperation?.();
 				await runWithMutationPlugin(async (plugin) => {
 					const bundle = await plugin.getBundleById(bundleId, context);
 					if (!bundle) return;
@@ -223,10 +231,10 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 		},
 		adapterName: getPlugin().name,
 		createMigrator: () => {
-			throw new Error("createMigrator is only available for Kysely/Prisma/Drizzle database adapters.");
+			throw new Error("createMigrator is only available for Kysely/MongoDB database adapters.");
 		},
 		generateSchema: () => {
-			throw new Error("generateSchema is only available for Kysely/Prisma/Drizzle database adapters.");
+			throw new Error("generateSchema is only available for Drizzle/Prisma database adapters.");
 		}
 	};
 }

package/dist/db/pluginCore.mjs

@@ -49,12 +49,13 @@ const INIT_BUNDLE_ROLLBACK_UPDATE_INFO = {
 	fileHash: null
 };
 function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
+	const coreOptions = options;
 	const runWithMutationPlugin = async (operation) => {
-		const plugin = options?.createMutationPlugin?.() ?? getPlugin();
+		const plugin = coreOptions?.createMutationPlugin?.() ?? getPlugin();
 		try {
 			return await operation(plugin);
 		} finally {
-			if (options?.createMutationPlugin) await options.cleanupMutationPlugin?.(plugin);
+			if (coreOptions?.createMutationPlugin) await coreOptions.cleanupMutationPlugin?.(plugin);
 		}
 	};
 	const getSortedBundlePage = async (options, context) => {
@@ -113,9 +114,11 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 	return {
 		api: {
 			async getBundleById(id, context) {
+				await coreOptions?.beforeOperation?.();
 				return getPlugin().getBundleById(id, context);
 			},
 			async getUpdateInfo(args, context) {
+				await coreOptions?.beforeOperation?.();
 				const directGetUpdateInfo = getPlugin().getUpdateInfo;
 				if (directGetUpdateInfo) return context === void 0 ? await directGetUpdateInfo(args) : await directGetUpdateInfo(args, context);
 				const channel = args.channel ?? "production";
@@ -149,7 +152,7 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 				const info = await this.getUpdateInfo(args, context);
 				if (!info) return null;
 				const { storageUri, ...rest } = info;
-				const readStorageText = options?.readStorageText;
+				const readStorageText = coreOptions?.readStorageText;
 				if (info.id === NIL_UUID || !readStorageText) {
 					const fileUrl = await resolveFileUrl(storageUri ?? null, context);
 					return {
@@ -187,12 +190,15 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 				};
 			},
 			async getChannels(context) {
+				await coreOptions?.beforeOperation?.();
 				return getPlugin().getChannels(context);
 			},
 			async getBundles(options, context) {
+				await coreOptions?.beforeOperation?.();
 				return getPlugin().getBundles(options, context);
 			},
 			async insertBundle(bundle, context) {
+				await coreOptions?.beforeOperation?.();
 				assertBundlePersistenceConstraints(bundle);
 				await runWithMutationPlugin(async (plugin) => {
 					await plugin.appendBundle(bundle, context);
@@ -200,6 +206,7 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 				});
 			},
 			async updateBundleById(bundleId, newBundle, context) {
+				await coreOptions?.beforeOperation?.();
 				await runWithMutationPlugin(async (plugin) => {
 					const current = await plugin.getBundleById(bundleId, context);
 					if (!current) throw new Error("targetBundleId not found");
@@ -212,6 +219,7 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 				});
 			},
 			async deleteBundleById(bundleId, context) {
+				await coreOptions?.beforeOperation?.();
 				await runWithMutationPlugin(async (plugin) => {
 					const bundle = await plugin.getBundleById(bundleId, context);
 					if (!bundle) return;
@@ -222,10 +230,10 @@ function createPluginDatabaseCore(getPlugin, resolveFileUrl, options) {
 		},
 		adapterName: getPlugin().name,
 		createMigrator: () => {
-			throw new Error("createMigrator is only available for Kysely/Prisma/Drizzle database adapters.");
+			throw new Error("createMigrator is only available for Kysely/MongoDB database adapters.");
 		},
 		generateSchema: () => {
-			throw new Error("generateSchema is only available for Kysely/Prisma/Drizzle database adapters.");
+			throw new Error("generateSchema is only available for Drizzle/Prisma database adapters.");
 		}
 	};
 }

package/dist/db/schema/mongodb.cjs

@@ -0,0 +1,17 @@
+const require_registry = require("./registry.cjs");
+const require_sql = require("./sql.cjs");
+//#region src/db/schema/mongodb.ts
+const createMongoMigrationOperations = (settingsOperation) => [
+	...require_sql.hotUpdaterCreateTableOperations,
+	{
+		type: "custom",
+		sql: "create index bundles_id_idx on bundles(id)"
+	},
+	...require_registry.hotUpdaterSchema.tables.flatMap((table) => (table.indexes ?? []).filter((index) => require_registry.schemaIndexAppliesToProvider(index, "mongodb")).map((index) => ({
+		type: "custom",
+		sql: `create index ${index.name} on ${table.ormName}(${index.columns.join(", ")})`
+	}))),
+	...settingsOperation ? [settingsOperation] : []
+];
+//#endregion
+exports.createMongoMigrationOperations = createMongoMigrationOperations;

package/dist/db/schema/mongodb.mjs

@@ -0,0 +1,17 @@
+import { hotUpdaterSchema, schemaIndexAppliesToProvider } from "./registry.mjs";
+import { hotUpdaterCreateTableOperations } from "./sql.mjs";
+//#region src/db/schema/mongodb.ts
+const createMongoMigrationOperations = (settingsOperation) => [
+	...hotUpdaterCreateTableOperations,
+	{
+		type: "custom",
+		sql: "create index bundles_id_idx on bundles(id)"
+	},
+	...hotUpdaterSchema.tables.flatMap((table) => (table.indexes ?? []).filter((index) => schemaIndexAppliesToProvider(index, "mongodb")).map((index) => ({
+		type: "custom",
+		sql: `create index ${index.name} on ${table.ormName}(${index.columns.join(", ")})`
+	}))),
+	...settingsOperation ? [settingsOperation] : []
+];
+//#endregion
+export { createMongoMigrationOperations };

package/dist/db/schema/registry.cjs

@@ -0,0 +1,23 @@
+const require_index = require("../../schema/index.cjs");
+//#region src/db/schema/registry.ts
+const hotUpdaterSchema = require_index.hotUpdaterSchemaVersions[require_index.hotUpdaterSchemaVersions.length - 1];
+const getSchemaVersionIndex = (version) => require_index.hotUpdaterSchemaVersions.findIndex((schema) => schema.version === version);
+const getHotUpdaterSchemaVersion = (version) => {
+	const schema = require_index.hotUpdaterSchemaVersions.find((item) => item.version === version);
+	if (!schema) throw new Error(`Unsupported Hot Updater schema version: ${version}`);
+	return schema;
+};
+const getSchemaColumn = (table, name) => {
+	const column = table.columns.find((item) => item.ormName === name);
+	if (!column) throw new Error(`Unknown Hot Updater schema column: ${table.ormName}.${name}`);
+	return column;
+};
+const hotUpdaterDataTables = hotUpdaterSchema.tables.filter((table) => !table.internal);
+const schemaIndexAppliesToProvider = (index, provider) => !index.providers || index.providers.includes(provider);
+//#endregion
+exports.getHotUpdaterSchemaVersion = getHotUpdaterSchemaVersion;
+exports.getSchemaColumn = getSchemaColumn;
+exports.getSchemaVersionIndex = getSchemaVersionIndex;
+exports.hotUpdaterDataTables = hotUpdaterDataTables;
+exports.hotUpdaterSchema = hotUpdaterSchema;
+exports.schemaIndexAppliesToProvider = schemaIndexAppliesToProvider;

package/dist/db/schema/registry.mjs

@@ -0,0 +1,18 @@
+import { hotUpdaterSchemaVersions } from "../../schema/index.mjs";
+//#region src/db/schema/registry.ts
+const hotUpdaterSchema = hotUpdaterSchemaVersions[hotUpdaterSchemaVersions.length - 1];
+const getSchemaVersionIndex = (version) => hotUpdaterSchemaVersions.findIndex((schema) => schema.version === version);
+const getHotUpdaterSchemaVersion = (version) => {
+	const schema = hotUpdaterSchemaVersions.find((item) => item.version === version);
+	if (!schema) throw new Error(`Unsupported Hot Updater schema version: ${version}`);
+	return schema;
+};
+const getSchemaColumn = (table, name) => {
+	const column = table.columns.find((item) => item.ormName === name);
+	if (!column) throw new Error(`Unknown Hot Updater schema column: ${table.ormName}.${name}`);
+	return column;
+};
+const hotUpdaterDataTables = hotUpdaterSchema.tables.filter((table) => !table.internal);
+const schemaIndexAppliesToProvider = (index, provider) => !index.providers || index.providers.includes(provider);
+//#endregion
+export { getHotUpdaterSchemaVersion, getSchemaColumn, getSchemaVersionIndex, hotUpdaterDataTables, hotUpdaterSchema, schemaIndexAppliesToProvider };

package/dist/db/schema/sql.cjs

@@ -0,0 +1,84 @@
+require("../../schema/types.cjs");
+const require_registry = require("./registry.cjs");
+//#region src/db/schema/sql.ts
+const hotUpdaterCreateTableOperations = require_registry.hotUpdaterDataTables.map((table) => ({
+	type: "create-table",
+	value: {
+		ormName: table.ormName,
+		columns: Object.fromEntries(table.columns.map((column) => [column.ormName, {
+			ormName: column.ormName,
+			type: column.type
+		}]))
+	}
+}));
+const getSqlType = (type, provider) => {
+	if (provider === "sqlite") {
+		if (type === "bool" || type === "integer") return "integer";
+		return "text";
+	}
+	if (provider === "mysql") {
+		if (type === "uuid") return "char(36)";
+		if (type === "bool") return "boolean";
+		if (type === "integer") return "integer";
+		if (type === "json") return "json";
+		if (type.startsWith("varchar")) return type;
+		return "text";
+	}
+	if (type === "uuid") return "uuid";
+	if (type === "bool") return "boolean";
+	if (type === "integer") return "integer";
+	if (type === "json") return "json";
+	if (type.startsWith("varchar")) return type;
+	return "text";
+};
+const sqlStringLiteral = (value) => `'${value.replaceAll("'", "''")}'`;
+const sqlDefaultClause = (column, provider) => {
+	const value = column.default;
+	if (!value) return "";
+	if (provider === "mysql" && (column.type === "json" || column.type === "string")) return "";
+	if (value.type === "json") {
+		const json = sqlStringLiteral(JSON.stringify(value.value));
+		return provider === "postgresql" || provider === "cockroachdb" ? ` default ${json}::json` : ` default ${json}`;
+	}
+	if (typeof value.value === "string") return ` default ${sqlStringLiteral(value.value)}`;
+	return ` default ${String(value.value)}`;
+};
+const sqlColumnName = (table, column, provider) => table.ormName === "private_hot_updater_settings" && column.ormName === "key" && provider === "mysql" ? "`key`" : column.ormName;
+const sqlColumnDefinition = (table, column, provider) => {
+	const constraints = [column.primaryKey ? "primary key" : void 0, column.nullable ? void 0 : "not null"].filter(Boolean);
+	return [
+		sqlColumnName(table, column, provider),
+		getSqlType(column.type, provider),
+		...constraints
+	].join(" ") + sqlDefaultClause(column, provider);
+};
+const sqlIndexColumn = (table, columnName, provider) => {
+	const column = require_registry.getSchemaColumn(table, columnName);
+	return provider === "mysql" && column.type === "string" ? `${columnName}(255)` : columnName;
+};
+const createIndexSql = (table, index, provider) => `create index ${index.name} on ${table.ormName}(${index.columns.map((column) => sqlIndexColumn(table, column, provider)).join(", ")})`;
+const createForeignKeySql = (table, foreignKey) => `alter table ${table.ormName} add constraint ${foreignKey.name} foreign key (${foreignKey.columns.join(", ")}) references ${foreignKey.referencedTable}(${foreignKey.referencedColumns.join(", ")}) on update ${foreignKey.onUpdate} on delete ${foreignKey.onDelete}`;
+const createCheckSql = (table, check) => `alter table ${table.ormName} add constraint ${check.name} check (${check.expression})`;
+const inlineSqlChecks = (table, provider) => provider === "sqlite" ? (table.checks ?? []).filter((check) => check.sqliteInline).map((check) => `constraint ${check.name} check (${check.expression})`) : [];
+const createTableStatement = (table, provider) => {
+	const lines = [...table.columns.map((column) => sqlColumnDefinition(table, column, provider)), ...inlineSqlChecks(table, provider)];
+	return `create table if not exists ${table.ormName} (\n${lines.join(",\n")}\n)`;
+};
+const createForeignKeySqlStatements = (provider, relationMode = "foreign-keys") => {
+	if (relationMode !== "foreign-keys" || provider === "sqlite") return [];
+	return require_registry.hotUpdaterSchema.tables.flatMap((table) => (table.foreignKeys ?? []).map((foreignKey) => createForeignKeySql(table, foreignKey)));
+};
+const createTableSql = (provider, relationMode = "foreign-keys") => [
+	...require_registry.hotUpdaterSchema.tables.map((table) => createTableStatement(table, provider)),
+	...require_registry.hotUpdaterSchema.tables.flatMap((table) => (table.indexes ?? []).filter((index) => require_registry.schemaIndexAppliesToProvider(index, provider)).map((index) => createIndexSql(table, index, provider))),
+	...provider === "sqlite" ? [] : require_registry.hotUpdaterSchema.tables.flatMap((table) => (table.checks ?? []).map((check) => createCheckSql(table, check))),
+	...createForeignKeySqlStatements(provider, relationMode)
+];
+//#endregion
+exports.createCheckSql = createCheckSql;
+exports.createForeignKeySql = createForeignKeySql;
+exports.createIndexSql = createIndexSql;
+exports.createTableSql = createTableSql;
+exports.createTableStatement = createTableStatement;
+exports.hotUpdaterCreateTableOperations = hotUpdaterCreateTableOperations;
+exports.sqlColumnDefinition = sqlColumnDefinition;

package/dist/db/schema/sql.mjs

@@ -0,0 +1,78 @@
+import "../../schema/types.mjs";
+import { getSchemaColumn, hotUpdaterDataTables, hotUpdaterSchema, schemaIndexAppliesToProvider } from "./registry.mjs";
+//#region src/db/schema/sql.ts
+const hotUpdaterCreateTableOperations = hotUpdaterDataTables.map((table) => ({
+	type: "create-table",
+	value: {
+		ormName: table.ormName,
+		columns: Object.fromEntries(table.columns.map((column) => [column.ormName, {
+			ormName: column.ormName,
+			type: column.type
+		}]))
+	}
+}));
+const getSqlType = (type, provider) => {
+	if (provider === "sqlite") {
+		if (type === "bool" || type === "integer") return "integer";
+		return "text";
+	}
+	if (provider === "mysql") {
+		if (type === "uuid") return "char(36)";
+		if (type === "bool") return "boolean";
+		if (type === "integer") return "integer";
+		if (type === "json") return "json";
+		if (type.startsWith("varchar")) return type;
+		return "text";
+	}
+	if (type === "uuid") return "uuid";
+	if (type === "bool") return "boolean";
+	if (type === "integer") return "integer";
+	if (type === "json") return "json";
+	if (type.startsWith("varchar")) return type;
+	return "text";
+};
+const sqlStringLiteral = (value) => `'${value.replaceAll("'", "''")}'`;
+const sqlDefaultClause = (column, provider) => {
+	const value = column.default;
+	if (!value) return "";
+	if (provider === "mysql" && (column.type === "json" || column.type === "string")) return "";
+	if (value.type === "json") {
+		const json = sqlStringLiteral(JSON.stringify(value.value));
+		return provider === "postgresql" || provider === "cockroachdb" ? ` default ${json}::json` : ` default ${json}`;
+	}
+	if (typeof value.value === "string") return ` default ${sqlStringLiteral(value.value)}`;
+	return ` default ${String(value.value)}`;
+};
+const sqlColumnName = (table, column, provider) => table.ormName === "private_hot_updater_settings" && column.ormName === "key" && provider === "mysql" ? "`key`" : column.ormName;
+const sqlColumnDefinition = (table, column, provider) => {
+	const constraints = [column.primaryKey ? "primary key" : void 0, column.nullable ? void 0 : "not null"].filter(Boolean);
+	return [
+		sqlColumnName(table, column, provider),
+		getSqlType(column.type, provider),
+		...constraints
+	].join(" ") + sqlDefaultClause(column, provider);
+};
+const sqlIndexColumn = (table, columnName, provider) => {
+	const column = getSchemaColumn(table, columnName);
+	return provider === "mysql" && column.type === "string" ? `${columnName}(255)` : columnName;
+};
+const createIndexSql = (table, index, provider) => `create index ${index.name} on ${table.ormName}(${index.columns.map((column) => sqlIndexColumn(table, column, provider)).join(", ")})`;
+const createForeignKeySql = (table, foreignKey) => `alter table ${table.ormName} add constraint ${foreignKey.name} foreign key (${foreignKey.columns.join(", ")}) references ${foreignKey.referencedTable}(${foreignKey.referencedColumns.join(", ")}) on update ${foreignKey.onUpdate} on delete ${foreignKey.onDelete}`;
+const createCheckSql = (table, check) => `alter table ${table.ormName} add constraint ${check.name} check (${check.expression})`;
+const inlineSqlChecks = (table, provider) => provider === "sqlite" ? (table.checks ?? []).filter((check) => check.sqliteInline).map((check) => `constraint ${check.name} check (${check.expression})`) : [];
+const createTableStatement = (table, provider) => {
+	const lines = [...table.columns.map((column) => sqlColumnDefinition(table, column, provider)), ...inlineSqlChecks(table, provider)];
+	return `create table if not exists ${table.ormName} (\n${lines.join(",\n")}\n)`;
+};
+const createForeignKeySqlStatements = (provider, relationMode = "foreign-keys") => {
+	if (relationMode !== "foreign-keys" || provider === "sqlite") return [];
+	return hotUpdaterSchema.tables.flatMap((table) => (table.foreignKeys ?? []).map((foreignKey) => createForeignKeySql(table, foreignKey)));
+};
+const createTableSql = (provider, relationMode = "foreign-keys") => [
+	...hotUpdaterSchema.tables.map((table) => createTableStatement(table, provider)),
+	...hotUpdaterSchema.tables.flatMap((table) => (table.indexes ?? []).filter((index) => schemaIndexAppliesToProvider(index, provider)).map((index) => createIndexSql(table, index, provider))),
+	...provider === "sqlite" ? [] : hotUpdaterSchema.tables.flatMap((table) => (table.checks ?? []).map((check) => createCheckSql(table, check))),
+	...createForeignKeySqlStatements(provider, relationMode)
+];
+//#endregion
+export { createCheckSql, createForeignKeySql, createIndexSql, createTableSql, createTableStatement, hotUpdaterCreateTableOperations, sqlColumnDefinition };

package/dist/db/schema/sqlMigrations.cjs

@@ -0,0 +1,74 @@
+const require_index = require("../../schema/index.cjs");
+const require_registry = require("./registry.cjs");
+const require_sql = require("./sql.cjs");
+//#region src/db/schema/sqlMigrations.ts
+const nameMap = (items) => new Map((items ?? []).map((item) => [item.name, item]));
+const columnMap = (table) => new Map(table.columns.map((column) => [column.ormName, column]));
+const stableStringify = (value) => JSON.stringify(value);
+const assertSameSchemaValue = (location, left, right) => {
+	if (stableStringify(left) !== stableStringify(right)) throw new Error(`Unsupported Hot Updater schema change at ${location}. Add an explicit migration step before changing existing schema metadata.`);
+};
+const compareNamedItems = (location, previousItems, nextItems) => {
+	const nextItemsByName = nameMap(nextItems);
+	for (const previousItem of previousItems ?? []) {
+		const nextItem = nextItemsByName.get(previousItem.name);
+		if (!nextItem) throw new Error(`Unsupported Hot Updater schema change at ${location}.${previousItem.name}. Removing schema metadata requires an explicit migration step.`);
+		assertSameSchemaValue(`${location}.${previousItem.name}`, previousItem, nextItem);
+	}
+};
+const assertNoUnsupportedTableChanges = (previous, next, provider) => {
+	const nextColumns = columnMap(next);
+	for (const previousColumn of previous.columns) {
+		const nextColumn = nextColumns.get(previousColumn.ormName);
+		if (!nextColumn) throw new Error(`Unsupported Hot Updater schema change at ${previous.ormName}.${previousColumn.ormName}. Dropping columns requires an explicit migration step.`);
+		assertSameSchemaValue(`${previous.ormName}.${previousColumn.ormName}`, previousColumn, nextColumn);
+	}
+	compareNamedItems(`${previous.ormName}.indexes`, previous.indexes?.filter((index) => require_registry.schemaIndexAppliesToProvider(index, provider)), next.indexes?.filter((index) => require_registry.schemaIndexAppliesToProvider(index, provider)));
+	compareNamedItems(`${previous.ormName}.checks`, previous.checks, next.checks);
+	compareNamedItems(`${previous.ormName}.foreignKeys`, previous.foreignKeys, next.foreignKeys);
+};
+const createForeignKeySql = (table, foreignKey) => `alter table ${table.ormName} add constraint ${foreignKey.name} foreign key (${foreignKey.columns.join(", ")}) references ${foreignKey.referencedTable}(${foreignKey.referencedColumns.join(", ")}) on update ${foreignKey.onUpdate} on delete ${foreignKey.onDelete}`;
+const createCheckSql = (table, check) => `alter table ${table.ormName} add constraint ${check.name} check (${check.expression})`;
+const createAddedTableSql = (table, provider, relationMode) => [
+	require_sql.createTableStatement(table, provider),
+	...(table.indexes ?? []).filter((index) => require_registry.schemaIndexAppliesToProvider(index, provider)).map((index) => require_sql.createIndexSql(table, index, provider)),
+	...provider === "sqlite" ? [] : (table.checks ?? []).map((check) => createCheckSql(table, check)),
+	...relationMode === "foreign-keys" && provider !== "sqlite" ? (table.foreignKeys ?? []).map((foreignKey) => createForeignKeySql(table, foreignKey)) : []
+];
+const createChangedTableSql = (previous, next, provider, relationMode) => {
+	assertNoUnsupportedTableChanges(previous, next, provider);
+	const previousColumns = columnMap(previous);
+	const previousIndexes = nameMap(previous.indexes?.filter((index) => require_registry.schemaIndexAppliesToProvider(index, provider)));
+	const previousChecks = nameMap(previous.checks);
+	const previousForeignKeys = nameMap(previous.foreignKeys);
+	return [
+		...next.columns.filter((column) => !previousColumns.has(column.ormName)).map((column) => `alter table ${next.ormName} add column ${require_sql.sqlColumnDefinition(next, column, provider)}`),
+		...(next.indexes ?? []).filter((index) => require_registry.schemaIndexAppliesToProvider(index, provider)).filter((index) => !previousIndexes.has(index.name)).map((index) => require_sql.createIndexSql(next, index, provider)),
+		...provider === "sqlite" ? [] : (next.checks ?? []).filter((check) => !previousChecks.has(check.name)).map((check) => createCheckSql(next, check)),
+		...relationMode === "foreign-keys" && provider !== "sqlite" ? (next.foreignKeys ?? []).filter((foreignKey) => !previousForeignKeys.has(foreignKey.name)).map((foreignKey) => createForeignKeySql(next, foreignKey)) : []
+	];
+};
+const createSchemaMigrationSql = (fromVersion, toVersion, provider, relationMode = "foreign-keys") => {
+	const fromIndex = require_registry.getSchemaVersionIndex(fromVersion);
+	const toIndex = require_registry.getSchemaVersionIndex(toVersion);
+	if (fromIndex === -1) throw new Error(`Unsupported Hot Updater schema version: ${fromVersion}`);
+	if (toIndex === -1) throw new Error(`Unsupported Hot Updater schema version: ${toVersion}`);
+	if (fromIndex > toIndex) throw new Error(`Cannot migrate Hot Updater schema down to ${toVersion}.`);
+	const statements = [];
+	for (let index = fromIndex + 1; index <= toIndex; index += 1) {
+		const previous = require_index.hotUpdaterSchemaVersions[index - 1];
+		const next = require_index.hotUpdaterSchemaVersions[index];
+		const previousTables = new Map(previous.tables.map((table) => [table.ormName, table]));
+		for (const table of next.tables) {
+			if (table.internal) continue;
+			const previousTable = previousTables.get(table.ormName);
+			statements.push(...previousTable ? createChangedTableSql(previousTable, table, provider, relationMode) : createAddedTableSql(table, provider, relationMode));
+		}
+	}
+	return statements;
+};
+const createV029AlterSql = (provider) => createSchemaMigrationSql("0.21.0", "0.29.0", provider);
+const createV031AlterSql = (provider, relationMode = "foreign-keys") => createSchemaMigrationSql("0.29.0", "0.31.0", provider, relationMode);
+//#endregion
+exports.createV029AlterSql = createV029AlterSql;
+exports.createV031AlterSql = createV031AlterSql;

package/dist/db/schema/sqlMigrations.mjs

@@ -0,0 +1,73 @@
+import { hotUpdaterSchemaVersions } from "../../schema/index.mjs";
+import { getSchemaVersionIndex, schemaIndexAppliesToProvider } from "./registry.mjs";
+import { createIndexSql, createTableStatement, sqlColumnDefinition } from "./sql.mjs";
+//#region src/db/schema/sqlMigrations.ts
+const nameMap = (items) => new Map((items ?? []).map((item) => [item.name, item]));
+const columnMap = (table) => new Map(table.columns.map((column) => [column.ormName, column]));
+const stableStringify = (value) => JSON.stringify(value);
+const assertSameSchemaValue = (location, left, right) => {
+	if (stableStringify(left) !== stableStringify(right)) throw new Error(`Unsupported Hot Updater schema change at ${location}. Add an explicit migration step before changing existing schema metadata.`);
+};
+const compareNamedItems = (location, previousItems, nextItems) => {
+	const nextItemsByName = nameMap(nextItems);
+	for (const previousItem of previousItems ?? []) {
+		const nextItem = nextItemsByName.get(previousItem.name);
+		if (!nextItem) throw new Error(`Unsupported Hot Updater schema change at ${location}.${previousItem.name}. Removing schema metadata requires an explicit migration step.`);
+		assertSameSchemaValue(`${location}.${previousItem.name}`, previousItem, nextItem);
+	}
+};
+const assertNoUnsupportedTableChanges = (previous, next, provider) => {
+	const nextColumns = columnMap(next);
+	for (const previousColumn of previous.columns) {
+		const nextColumn = nextColumns.get(previousColumn.ormName);
+		if (!nextColumn) throw new Error(`Unsupported Hot Updater schema change at ${previous.ormName}.${previousColumn.ormName}. Dropping columns requires an explicit migration step.`);
+		assertSameSchemaValue(`${previous.ormName}.${previousColumn.ormName}`, previousColumn, nextColumn);
+	}
+	compareNamedItems(`${previous.ormName}.indexes`, previous.indexes?.filter((index) => schemaIndexAppliesToProvider(index, provider)), next.indexes?.filter((index) => schemaIndexAppliesToProvider(index, provider)));
+	compareNamedItems(`${previous.ormName}.checks`, previous.checks, next.checks);
+	compareNamedItems(`${previous.ormName}.foreignKeys`, previous.foreignKeys, next.foreignKeys);
+};
+const createForeignKeySql = (table, foreignKey) => `alter table ${table.ormName} add constraint ${foreignKey.name} foreign key (${foreignKey.columns.join(", ")}) references ${foreignKey.referencedTable}(${foreignKey.referencedColumns.join(", ")}) on update ${foreignKey.onUpdate} on delete ${foreignKey.onDelete}`;
+const createCheckSql = (table, check) => `alter table ${table.ormName} add constraint ${check.name} check (${check.expression})`;
+const createAddedTableSql = (table, provider, relationMode) => [
+	createTableStatement(table, provider),
+	...(table.indexes ?? []).filter((index) => schemaIndexAppliesToProvider(index, provider)).map((index) => createIndexSql(table, index, provider)),
+	...provider === "sqlite" ? [] : (table.checks ?? []).map((check) => createCheckSql(table, check)),
+	...relationMode === "foreign-keys" && provider !== "sqlite" ? (table.foreignKeys ?? []).map((foreignKey) => createForeignKeySql(table, foreignKey)) : []
+];
+const createChangedTableSql = (previous, next, provider, relationMode) => {
+	assertNoUnsupportedTableChanges(previous, next, provider);
+	const previousColumns = columnMap(previous);
+	const previousIndexes = nameMap(previous.indexes?.filter((index) => schemaIndexAppliesToProvider(index, provider)));
+	const previousChecks = nameMap(previous.checks);
+	const previousForeignKeys = nameMap(previous.foreignKeys);
+	return [
+		...next.columns.filter((column) => !previousColumns.has(column.ormName)).map((column) => `alter table ${next.ormName} add column ${sqlColumnDefinition(next, column, provider)}`),
+		...(next.indexes ?? []).filter((index) => schemaIndexAppliesToProvider(index, provider)).filter((index) => !previousIndexes.has(index.name)).map((index) => createIndexSql(next, index, provider)),
+		...provider === "sqlite" ? [] : (next.checks ?? []).filter((check) => !previousChecks.has(check.name)).map((check) => createCheckSql(next, check)),
+		...relationMode === "foreign-keys" && provider !== "sqlite" ? (next.foreignKeys ?? []).filter((foreignKey) => !previousForeignKeys.has(foreignKey.name)).map((foreignKey) => createForeignKeySql(next, foreignKey)) : []
+	];
+};
+const createSchemaMigrationSql = (fromVersion, toVersion, provider, relationMode = "foreign-keys") => {
+	const fromIndex = getSchemaVersionIndex(fromVersion);
+	const toIndex = getSchemaVersionIndex(toVersion);
+	if (fromIndex === -1) throw new Error(`Unsupported Hot Updater schema version: ${fromVersion}`);
+	if (toIndex === -1) throw new Error(`Unsupported Hot Updater schema version: ${toVersion}`);
+	if (fromIndex > toIndex) throw new Error(`Cannot migrate Hot Updater schema down to ${toVersion}.`);
+	const statements = [];
+	for (let index = fromIndex + 1; index <= toIndex; index += 1) {
+		const previous = hotUpdaterSchemaVersions[index - 1];
+		const next = hotUpdaterSchemaVersions[index];
+		const previousTables = new Map(previous.tables.map((table) => [table.ormName, table]));
+		for (const table of next.tables) {
+			if (table.internal) continue;
+			const previousTable = previousTables.get(table.ormName);
+			statements.push(...previousTable ? createChangedTableSql(previousTable, table, provider, relationMode) : createAddedTableSql(table, provider, relationMode));
+		}
+	}
+	return statements;
+};
+const createV029AlterSql = (provider) => createSchemaMigrationSql("0.21.0", "0.29.0", provider);
+const createV031AlterSql = (provider, relationMode = "foreign-keys") => createSchemaMigrationSql("0.29.0", "0.31.0", provider, relationMode);
+//#endregion
+export { createV029AlterSql, createV031AlterSql };

package/dist/db/schema/sqlOperations.cjs

@@ -0,0 +1,27 @@
+const require_types = require("../../schema/types.cjs");
+const require_registry = require("./registry.cjs");
+const require_sql = require("./sql.cjs");
+//#region src/db/schema/sqlOperations.ts
+const getSettingsInsertSql = (provider) => {
+	if (provider === "mysql") return `insert into ${require_types.HOT_UPDATER_SETTINGS_TABLE} (\`key\`, value) values ('version', '${require_types.HOT_UPDATER_SCHEMA_VERSION}') on duplicate key update value = '${require_types.HOT_UPDATER_SCHEMA_VERSION}'`;
+	return `insert into ${require_types.HOT_UPDATER_SETTINGS_TABLE} (key, value) values ('version', '${require_types.HOT_UPDATER_SCHEMA_VERSION}') on conflict (key) do update set value = '${require_types.HOT_UPDATER_SCHEMA_VERSION}'`;
+};
+const createSqlCreateOperations = (provider, relationMode, settingsOperation) => [
+	...require_sql.hotUpdaterCreateTableOperations,
+	...require_registry.hotUpdaterSchema.tables.flatMap((table) => (table.indexes ?? []).filter((index) => require_registry.schemaIndexAppliesToProvider(index, provider)).map((index) => ({
+		type: "custom",
+		sql: require_sql.createIndexSql(table, index, provider)
+	}))),
+	...provider === "sqlite" ? [] : require_registry.hotUpdaterSchema.tables.flatMap((table) => (table.checks ?? []).map((check) => ({
+		type: "custom",
+		sql: require_sql.createCheckSql(table, check)
+	}))),
+	...relationMode === "foreign-keys" && provider !== "sqlite" ? require_registry.hotUpdaterSchema.tables.flatMap((table) => (table.foreignKeys ?? []).map((foreignKey) => ({
+		type: "custom",
+		sql: require_sql.createForeignKeySql(table, foreignKey)
+	}))) : [],
+	...settingsOperation ? [settingsOperation] : []
+];
+//#endregion
+exports.createSqlCreateOperations = createSqlCreateOperations;
+exports.getSettingsInsertSql = getSettingsInsertSql;

package/dist/db/schema/sqlOperations.mjs

@@ -0,0 +1,26 @@
+import { HOT_UPDATER_SCHEMA_VERSION, HOT_UPDATER_SETTINGS_TABLE } from "../../schema/types.mjs";
+import { hotUpdaterSchema, schemaIndexAppliesToProvider } from "./registry.mjs";
+import { createCheckSql, createForeignKeySql, createIndexSql, hotUpdaterCreateTableOperations } from "./sql.mjs";
+//#region src/db/schema/sqlOperations.ts
+const getSettingsInsertSql = (provider) => {
+	if (provider === "mysql") return `insert into ${HOT_UPDATER_SETTINGS_TABLE} (\`key\`, value) values ('version', '${HOT_UPDATER_SCHEMA_VERSION}') on duplicate key update value = '${HOT_UPDATER_SCHEMA_VERSION}'`;
+	return `insert into ${HOT_UPDATER_SETTINGS_TABLE} (key, value) values ('version', '${HOT_UPDATER_SCHEMA_VERSION}') on conflict (key) do update set value = '${HOT_UPDATER_SCHEMA_VERSION}'`;
+};
+const createSqlCreateOperations = (provider, relationMode, settingsOperation) => [
+	...hotUpdaterCreateTableOperations,
+	...hotUpdaterSchema.tables.flatMap((table) => (table.indexes ?? []).filter((index) => schemaIndexAppliesToProvider(index, provider)).map((index) => ({
+		type: "custom",
+		sql: createIndexSql(table, index, provider)
+	}))),
+	...provider === "sqlite" ? [] : hotUpdaterSchema.tables.flatMap((table) => (table.checks ?? []).map((check) => ({
+		type: "custom",
+		sql: createCheckSql(table, check)
+	}))),
+	...relationMode === "foreign-keys" && provider !== "sqlite" ? hotUpdaterSchema.tables.flatMap((table) => (table.foreignKeys ?? []).map((foreignKey) => ({
+		type: "custom",
+		sql: createForeignKeySql(table, foreignKey)
+	}))) : [],
+	...settingsOperation ? [settingsOperation] : []
+];
+//#endregion
+export { createSqlCreateOperations, getSettingsInsertSql };