@hot-updater/server 0.30.12 → 0.31.0

package/dist/db/schemaEnhancements.cjs

@@ -0,0 +1,171 @@
+const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
+let _hot_updater_core = require("@hot-updater/core");
+let semver = require("semver");
+semver = require_runtime.__toESM(semver);
+//#region src/db/schemaEnhancements.ts
+const normalizeNullableString = (value) => {
+	if (value === null || value === void 0) return null;
+	const normalized = value.trim();
+	return normalized.length > 0 ? normalized : null;
+};
+const appendPrismaModelLines = (code, modelName, lines, options) => {
+	const pattern = new RegExp(`model ${modelName} \\{\\n([\\s\\S]*?)\\n\\}`, "m");
+	return code.replace(pattern, (full, body) => {
+		const bodyLines = body.split("\n");
+		const existingLines = new Set(bodyLines.map((line) => line.trim()).filter(Boolean));
+		const additions = lines.filter((line) => !existingLines.has(line)).map((line) => `  ${line}`);
+		if (additions.length === 0) return full;
+		if (options?.position === "beforeAttributes") {
+			const insertIndex = bodyLines.findIndex((line) => line.trim().startsWith("@@"));
+			if (insertIndex === -1) bodyLines.push(...additions);
+			else bodyLines.splice(insertIndex, 0, ...additions);
+			return `model ${modelName} {\n${bodyLines.join("\n")}\n}`;
+		}
+		return `model ${modelName} {\n${body}\n${additions.join("\n")}\n}`;
+	});
+};
+const getPrismaDatasourceProvider = (code) => {
+	return code.match(/datasource\s+\w+\s+\{[\s\S]*?provider\s*=\s*"([^"]+)"[\s\S]*?\}/m)?.[1] ?? null;
+};
+const ensureDrizzleIndexImport = (code) => code.replace(/import \{ ([^}]+) \} from "(drizzle-orm\/[^"]+-core)"/, (_full, imports, modulePath) => {
+	const values = imports.split(",").map((value) => value.trim()).filter(Boolean);
+	if (!values.includes("index")) values.push("index");
+	return `import { ${values.join(", ")} } from "${modulePath}"`;
+});
+const ensureDrizzleMetadataDefault = (code) => code.replace(/metadata: json\("metadata"\)\.notNull\(\)(?!\.default\(\{\}\))/, "metadata: json(\"metadata\").notNull().default({})").replace(/metadata: blob\("metadata", \{ mode: "json" \}\)\.notNull\(\)(?!\.default\(\{\}\))/, "metadata: blob(\"metadata\", { mode: \"json\" }).notNull().default({})");
+const removeUnusedDrizzleRelationMany = (code) => code.replace(/export const bundle_patchesRelations = relations\(bundle_patches, \(\{ one, many \}\) => \(\{/, "export const bundle_patchesRelations = relations(bundle_patches, ({ one }) => ({");
+const ensureTrailingComma = (line) => {
+	const trimmed = line.trim();
+	if (!trimmed || trimmed.endsWith(",") || trimmed.endsWith("[")) return line;
+	return `${line},`;
+};
+const updateDrizzleTableBlock = (code, tableName, callbackLines) => {
+	const blockStart = code.indexOf(`export const ${tableName} = `);
+	if (blockStart === -1) return code;
+	const nextBlockStart = code.indexOf("\n\nexport const ", blockStart + 1);
+	const blockEnd = nextBlockStart === -1 ? code.length : nextBlockStart;
+	const block = code.slice(blockStart, blockEnd);
+	if (block.includes(", (table) => [")) {
+		const callbackPattern = /, \(table\) => \[\n([\s\S]*?)\n\]\)\s*$/;
+		const match = block.match(callbackPattern);
+		if (!match) return code;
+		const callbackBody = match[1] ?? "";
+		const existingLines = callbackBody.split("\n").map((line) => line.trim()).filter(Boolean);
+		const additions = callbackLines.filter((line) => !existingLines.includes(line));
+		if (additions.length === 0) return code;
+		const callbackBodyLines = callbackBody.split("\n");
+		for (let index = callbackBodyLines.length - 1; index >= 0; index -= 1) if (callbackBodyLines[index]?.trim()) {
+			callbackBodyLines[index] = ensureTrailingComma(callbackBodyLines[index]);
+			break;
+		}
+		const nextCallbackBody = [...callbackBodyLines, ...additions.map((line) => `  ${line}`)].join("\n");
+		const nextBlock = block.replace(callbackPattern, `, (table) => [\n${nextCallbackBody}\n])`);
+		return `${code.slice(0, blockStart)}${nextBlock}${code.slice(blockEnd)}`;
+	}
+	const callbackBody = callbackLines.map((line) => `  ${line}`).join("\n");
+	const nextBlock = block.replace(/\n\}\)\s*$/, `\n}, (table) => [\n${callbackBody}\n])`);
+	return `${code.slice(0, blockStart)}${nextBlock}${code.slice(blockEnd)}`;
+};
+const addCustomSqlOperation = (result, sql) => {
+	const normalizedSql = sql.trim();
+	if (!result.operations.some((operation) => {
+		return operation["type"] === "custom" && typeof operation["sql"] === "string" && operation["sql"].trim() === normalizedSql;
+	})) result.operations.push({
+		type: "custom",
+		sql: normalizedSql
+	});
+};
+const getMigrationCustomSql = (provider, targetVersion) => {
+	const statements = [];
+	const hasRolloutColumns = semver.default.gte(targetVersion, "0.29.0");
+	const hasPatchTable = semver.default.gte(targetVersion, "0.31.0");
+	if (provider === "postgresql") {
+		statements.push("create index bundles_target_app_version_idx on bundles(target_app_version)", "create index bundles_fingerprint_hash_idx on bundles(fingerprint_hash)", "create index bundles_channel_idx on bundles(channel)", "alter table bundles add constraint check_version_or_fingerprint check ((target_app_version is not null) or (fingerprint_hash is not null))");
+		if (hasRolloutColumns) statements.push("create index bundles_rollout_idx on bundles(rollout_cohort_count)", "alter table bundles add constraint bundles_rollout_cohort_count_check check (rollout_cohort_count >= 0 and rollout_cohort_count <= 1000)");
+		if (hasPatchTable) statements.push("create index bundle_patches_bundle_id_idx on bundle_patches(bundle_id)", "create index bundle_patches_base_bundle_id_idx on bundle_patches(base_bundle_id)");
+		return statements;
+	}
+	if (provider === "mysql") {
+		statements.push("create index bundles_target_app_version_idx on bundles(target_app_version(255))", "create index bundles_fingerprint_hash_idx on bundles(fingerprint_hash(255))", "create index bundles_channel_idx on bundles(channel(255))", "alter table bundles add constraint check_version_or_fingerprint check ((target_app_version is not null) or (fingerprint_hash is not null))");
+		if (hasRolloutColumns) statements.push("create index bundles_rollout_idx on bundles(rollout_cohort_count)", "alter table bundles add constraint bundles_rollout_cohort_count_check check (rollout_cohort_count >= 0 and rollout_cohort_count <= 1000)");
+		if (hasPatchTable) statements.push("create index bundle_patches_bundle_id_idx on bundle_patches(bundle_id)", "create index bundle_patches_base_bundle_id_idx on bundle_patches(base_bundle_id)");
+		return statements;
+	}
+	statements.push("create index bundles_target_app_version_idx on bundles(target_app_version)", "create index bundles_fingerprint_hash_idx on bundles(fingerprint_hash)", "create index bundles_channel_idx on bundles(channel)");
+	if (hasRolloutColumns) statements.push("create index bundles_rollout_idx on bundles(rollout_cohort_count)");
+	if (hasPatchTable) statements.push("create index bundle_patches_bundle_id_idx on bundle_patches(bundle_id)", "create index bundle_patches_base_bundle_id_idx on bundle_patches(base_bundle_id)");
+	return statements;
+};
+const enhanceUpwardMigrationResult = (result, provider, targetVersion) => {
+	for (const sql of getMigrationCustomSql(provider, targetVersion)) addCustomSqlOperation(result, sql);
+	return result;
+};
+const assertBundlePersistenceConstraints = (bundle) => {
+	const targetAppVersion = normalizeNullableString(bundle.targetAppVersion);
+	const fingerprintHash = normalizeNullableString(bundle.fingerprintHash);
+	if (!targetAppVersion && !fingerprintHash) throw new Error("Bundle must define either targetAppVersion or fingerprintHash.");
+	const rolloutCohortCount = bundle.rolloutCohortCount;
+	if (rolloutCohortCount !== null && rolloutCohortCount !== void 0) {
+		if (!Number.isInteger(rolloutCohortCount) || rolloutCohortCount < 0 || rolloutCohortCount > _hot_updater_core.DEFAULT_ROLLOUT_COHORT_COUNT) throw new Error(`rolloutCohortCount must be an integer between 0 and ${_hot_updater_core.DEFAULT_ROLLOUT_COHORT_COUNT}.`);
+	}
+	for (const cohort of bundle.targetCohorts ?? []) if (!(0, _hot_updater_core.isValidCohort)(cohort)) throw new Error(`Invalid target cohort "${cohort}". ${_hot_updater_core.INVALID_COHORT_ERROR_MESSAGE}`);
+};
+const enhanceGeneratedSchema = (adapterName, code, provider) => {
+	if (adapterName === "prisma") {
+		const datasourceProvider = provider ?? getPrismaDatasourceProvider(code);
+		let nextCode = code;
+		if (datasourceProvider !== "sqlite") nextCode = nextCode.replace(/^(\s*metadata\s+Json)(?!\s+@default\("?\{\}"?\))(.*)$/m, "$1 @default(\"{}\")$2");
+		nextCode = appendPrismaModelLines(nextCode, "bundles", ["patches bundle_patches[] @relation(\"bundle_patches_bundles_patches\")", "baseForPatches bundle_patches[] @relation(\"bundle_patches_bundles_baseForPatches\")"], { position: "beforeAttributes" });
+		nextCode = appendPrismaModelLines(nextCode, "bundles", [
+			"@@index([target_app_version], map: \"bundles_target_app_version_idx\")",
+			"@@index([fingerprint_hash], map: \"bundles_fingerprint_hash_idx\")",
+			"@@index([channel], map: \"bundles_channel_idx\")",
+			"@@index([rollout_cohort_count], map: \"bundles_rollout_idx\")"
+		]);
+		return appendPrismaModelLines(nextCode, "bundle_patches", ["@@index([bundle_id], map: \"bundle_patches_bundle_id_idx\")", "@@index([base_bundle_id], map: \"bundle_patches_base_bundle_id_idx\")"]);
+	}
+	if (adapterName === "drizzle") {
+		let nextCode = ensureDrizzleMetadataDefault(code);
+		nextCode = removeUnusedDrizzleRelationMany(nextCode);
+		nextCode = ensureDrizzleIndexImport(nextCode);
+		nextCode = updateDrizzleTableBlock(nextCode, "bundles", [
+			"index(\"bundles_target_app_version_idx\").on(table.target_app_version),",
+			"index(\"bundles_fingerprint_hash_idx\").on(table.fingerprint_hash),",
+			"index(\"bundles_channel_idx\").on(table.channel),",
+			"index(\"bundles_rollout_idx\").on(table.rollout_cohort_count),"
+		]);
+		nextCode = updateDrizzleTableBlock(nextCode, "bundle_patches", ["index(\"bundle_patches_bundle_id_idx\").on(table.bundle_id),", "index(\"bundle_patches_base_bundle_id_idx\").on(table.base_bundle_id),"]);
+		return nextCode;
+	}
+	return code;
+};
+const wrapKyselyMigrator = (migrator, provider, latestVersion) => {
+	if (!provider) return migrator;
+	return {
+		...migrator,
+		async up(...args) {
+			const next = await migrator.next();
+			const result = await migrator.up(...args);
+			if (next) enhanceUpwardMigrationResult(result, provider, next.version);
+			return result;
+		},
+		async migrateTo(...args) {
+			const version = args[0];
+			const options = args[1];
+			const currentVersion = await migrator.getVersion();
+			const result = await migrator.migrateTo(version, options);
+			if (!currentVersion || semver.default.gt(version, currentVersion)) enhanceUpwardMigrationResult(result, provider, version);
+			return result;
+		},
+		async migrateToLatest(...args) {
+			const currentVersion = await migrator.getVersion();
+			const result = await migrator.migrateToLatest(...args);
+			if (!currentVersion || semver.default.gt(latestVersion, currentVersion)) enhanceUpwardMigrationResult(result, provider, latestVersion);
+			return result;
+		}
+	};
+};
+//#endregion
+exports.assertBundlePersistenceConstraints = assertBundlePersistenceConstraints;
+exports.enhanceGeneratedSchema = enhanceGeneratedSchema;
+exports.wrapKyselyMigrator = wrapKyselyMigrator;

package/dist/db/schemaEnhancements.mjs

@@ -0,0 +1,167 @@
+import { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, isValidCohort } from "@hot-updater/core";
+import semver from "semver";
+//#region src/db/schemaEnhancements.ts
+const normalizeNullableString = (value) => {
+	if (value === null || value === void 0) return null;
+	const normalized = value.trim();
+	return normalized.length > 0 ? normalized : null;
+};
+const appendPrismaModelLines = (code, modelName, lines, options) => {
+	const pattern = new RegExp(`model ${modelName} \\{\\n([\\s\\S]*?)\\n\\}`, "m");
+	return code.replace(pattern, (full, body) => {
+		const bodyLines = body.split("\n");
+		const existingLines = new Set(bodyLines.map((line) => line.trim()).filter(Boolean));
+		const additions = lines.filter((line) => !existingLines.has(line)).map((line) => `  ${line}`);
+		if (additions.length === 0) return full;
+		if (options?.position === "beforeAttributes") {
+			const insertIndex = bodyLines.findIndex((line) => line.trim().startsWith("@@"));
+			if (insertIndex === -1) bodyLines.push(...additions);
+			else bodyLines.splice(insertIndex, 0, ...additions);
+			return `model ${modelName} {\n${bodyLines.join("\n")}\n}`;
+		}
+		return `model ${modelName} {\n${body}\n${additions.join("\n")}\n}`;
+	});
+};
+const getPrismaDatasourceProvider = (code) => {
+	return code.match(/datasource\s+\w+\s+\{[\s\S]*?provider\s*=\s*"([^"]+)"[\s\S]*?\}/m)?.[1] ?? null;
+};
+const ensureDrizzleIndexImport = (code) => code.replace(/import \{ ([^}]+) \} from "(drizzle-orm\/[^"]+-core)"/, (_full, imports, modulePath) => {
+	const values = imports.split(",").map((value) => value.trim()).filter(Boolean);
+	if (!values.includes("index")) values.push("index");
+	return `import { ${values.join(", ")} } from "${modulePath}"`;
+});
+const ensureDrizzleMetadataDefault = (code) => code.replace(/metadata: json\("metadata"\)\.notNull\(\)(?!\.default\(\{\}\))/, "metadata: json(\"metadata\").notNull().default({})").replace(/metadata: blob\("metadata", \{ mode: "json" \}\)\.notNull\(\)(?!\.default\(\{\}\))/, "metadata: blob(\"metadata\", { mode: \"json\" }).notNull().default({})");
+const removeUnusedDrizzleRelationMany = (code) => code.replace(/export const bundle_patchesRelations = relations\(bundle_patches, \(\{ one, many \}\) => \(\{/, "export const bundle_patchesRelations = relations(bundle_patches, ({ one }) => ({");
+const ensureTrailingComma = (line) => {
+	const trimmed = line.trim();
+	if (!trimmed || trimmed.endsWith(",") || trimmed.endsWith("[")) return line;
+	return `${line},`;
+};
+const updateDrizzleTableBlock = (code, tableName, callbackLines) => {
+	const blockStart = code.indexOf(`export const ${tableName} = `);
+	if (blockStart === -1) return code;
+	const nextBlockStart = code.indexOf("\n\nexport const ", blockStart + 1);
+	const blockEnd = nextBlockStart === -1 ? code.length : nextBlockStart;
+	const block = code.slice(blockStart, blockEnd);
+	if (block.includes(", (table) => [")) {
+		const callbackPattern = /, \(table\) => \[\n([\s\S]*?)\n\]\)\s*$/;
+		const match = block.match(callbackPattern);
+		if (!match) return code;
+		const callbackBody = match[1] ?? "";
+		const existingLines = callbackBody.split("\n").map((line) => line.trim()).filter(Boolean);
+		const additions = callbackLines.filter((line) => !existingLines.includes(line));
+		if (additions.length === 0) return code;
+		const callbackBodyLines = callbackBody.split("\n");
+		for (let index = callbackBodyLines.length - 1; index >= 0; index -= 1) if (callbackBodyLines[index]?.trim()) {
+			callbackBodyLines[index] = ensureTrailingComma(callbackBodyLines[index]);
+			break;
+		}
+		const nextCallbackBody = [...callbackBodyLines, ...additions.map((line) => `  ${line}`)].join("\n");
+		const nextBlock = block.replace(callbackPattern, `, (table) => [\n${nextCallbackBody}\n])`);
+		return `${code.slice(0, blockStart)}${nextBlock}${code.slice(blockEnd)}`;
+	}
+	const callbackBody = callbackLines.map((line) => `  ${line}`).join("\n");
+	const nextBlock = block.replace(/\n\}\)\s*$/, `\n}, (table) => [\n${callbackBody}\n])`);
+	return `${code.slice(0, blockStart)}${nextBlock}${code.slice(blockEnd)}`;
+};
+const addCustomSqlOperation = (result, sql) => {
+	const normalizedSql = sql.trim();
+	if (!result.operations.some((operation) => {
+		return operation["type"] === "custom" && typeof operation["sql"] === "string" && operation["sql"].trim() === normalizedSql;
+	})) result.operations.push({
+		type: "custom",
+		sql: normalizedSql
+	});
+};
+const getMigrationCustomSql = (provider, targetVersion) => {
+	const statements = [];
+	const hasRolloutColumns = semver.gte(targetVersion, "0.29.0");
+	const hasPatchTable = semver.gte(targetVersion, "0.31.0");
+	if (provider === "postgresql") {
+		statements.push("create index bundles_target_app_version_idx on bundles(target_app_version)", "create index bundles_fingerprint_hash_idx on bundles(fingerprint_hash)", "create index bundles_channel_idx on bundles(channel)", "alter table bundles add constraint check_version_or_fingerprint check ((target_app_version is not null) or (fingerprint_hash is not null))");
+		if (hasRolloutColumns) statements.push("create index bundles_rollout_idx on bundles(rollout_cohort_count)", "alter table bundles add constraint bundles_rollout_cohort_count_check check (rollout_cohort_count >= 0 and rollout_cohort_count <= 1000)");
+		if (hasPatchTable) statements.push("create index bundle_patches_bundle_id_idx on bundle_patches(bundle_id)", "create index bundle_patches_base_bundle_id_idx on bundle_patches(base_bundle_id)");
+		return statements;
+	}
+	if (provider === "mysql") {
+		statements.push("create index bundles_target_app_version_idx on bundles(target_app_version(255))", "create index bundles_fingerprint_hash_idx on bundles(fingerprint_hash(255))", "create index bundles_channel_idx on bundles(channel(255))", "alter table bundles add constraint check_version_or_fingerprint check ((target_app_version is not null) or (fingerprint_hash is not null))");
+		if (hasRolloutColumns) statements.push("create index bundles_rollout_idx on bundles(rollout_cohort_count)", "alter table bundles add constraint bundles_rollout_cohort_count_check check (rollout_cohort_count >= 0 and rollout_cohort_count <= 1000)");
+		if (hasPatchTable) statements.push("create index bundle_patches_bundle_id_idx on bundle_patches(bundle_id)", "create index bundle_patches_base_bundle_id_idx on bundle_patches(base_bundle_id)");
+		return statements;
+	}
+	statements.push("create index bundles_target_app_version_idx on bundles(target_app_version)", "create index bundles_fingerprint_hash_idx on bundles(fingerprint_hash)", "create index bundles_channel_idx on bundles(channel)");
+	if (hasRolloutColumns) statements.push("create index bundles_rollout_idx on bundles(rollout_cohort_count)");
+	if (hasPatchTable) statements.push("create index bundle_patches_bundle_id_idx on bundle_patches(bundle_id)", "create index bundle_patches_base_bundle_id_idx on bundle_patches(base_bundle_id)");
+	return statements;
+};
+const enhanceUpwardMigrationResult = (result, provider, targetVersion) => {
+	for (const sql of getMigrationCustomSql(provider, targetVersion)) addCustomSqlOperation(result, sql);
+	return result;
+};
+const assertBundlePersistenceConstraints = (bundle) => {
+	const targetAppVersion = normalizeNullableString(bundle.targetAppVersion);
+	const fingerprintHash = normalizeNullableString(bundle.fingerprintHash);
+	if (!targetAppVersion && !fingerprintHash) throw new Error("Bundle must define either targetAppVersion or fingerprintHash.");
+	const rolloutCohortCount = bundle.rolloutCohortCount;
+	if (rolloutCohortCount !== null && rolloutCohortCount !== void 0) {
+		if (!Number.isInteger(rolloutCohortCount) || rolloutCohortCount < 0 || rolloutCohortCount > DEFAULT_ROLLOUT_COHORT_COUNT) throw new Error(`rolloutCohortCount must be an integer between 0 and ${DEFAULT_ROLLOUT_COHORT_COUNT}.`);
+	}
+	for (const cohort of bundle.targetCohorts ?? []) if (!isValidCohort(cohort)) throw new Error(`Invalid target cohort "${cohort}". ${INVALID_COHORT_ERROR_MESSAGE}`);
+};
+const enhanceGeneratedSchema = (adapterName, code, provider) => {
+	if (adapterName === "prisma") {
+		const datasourceProvider = provider ?? getPrismaDatasourceProvider(code);
+		let nextCode = code;
+		if (datasourceProvider !== "sqlite") nextCode = nextCode.replace(/^(\s*metadata\s+Json)(?!\s+@default\("?\{\}"?\))(.*)$/m, "$1 @default(\"{}\")$2");
+		nextCode = appendPrismaModelLines(nextCode, "bundles", ["patches bundle_patches[] @relation(\"bundle_patches_bundles_patches\")", "baseForPatches bundle_patches[] @relation(\"bundle_patches_bundles_baseForPatches\")"], { position: "beforeAttributes" });
+		nextCode = appendPrismaModelLines(nextCode, "bundles", [
+			"@@index([target_app_version], map: \"bundles_target_app_version_idx\")",
+			"@@index([fingerprint_hash], map: \"bundles_fingerprint_hash_idx\")",
+			"@@index([channel], map: \"bundles_channel_idx\")",
+			"@@index([rollout_cohort_count], map: \"bundles_rollout_idx\")"
+		]);
+		return appendPrismaModelLines(nextCode, "bundle_patches", ["@@index([bundle_id], map: \"bundle_patches_bundle_id_idx\")", "@@index([base_bundle_id], map: \"bundle_patches_base_bundle_id_idx\")"]);
+	}
+	if (adapterName === "drizzle") {
+		let nextCode = ensureDrizzleMetadataDefault(code);
+		nextCode = removeUnusedDrizzleRelationMany(nextCode);
+		nextCode = ensureDrizzleIndexImport(nextCode);
+		nextCode = updateDrizzleTableBlock(nextCode, "bundles", [
+			"index(\"bundles_target_app_version_idx\").on(table.target_app_version),",
+			"index(\"bundles_fingerprint_hash_idx\").on(table.fingerprint_hash),",
+			"index(\"bundles_channel_idx\").on(table.channel),",
+			"index(\"bundles_rollout_idx\").on(table.rollout_cohort_count),"
+		]);
+		nextCode = updateDrizzleTableBlock(nextCode, "bundle_patches", ["index(\"bundle_patches_bundle_id_idx\").on(table.bundle_id),", "index(\"bundle_patches_base_bundle_id_idx\").on(table.base_bundle_id),"]);
+		return nextCode;
+	}
+	return code;
+};
+const wrapKyselyMigrator = (migrator, provider, latestVersion) => {
+	if (!provider) return migrator;
+	return {
+		...migrator,
+		async up(...args) {
+			const next = await migrator.next();
+			const result = await migrator.up(...args);
+			if (next) enhanceUpwardMigrationResult(result, provider, next.version);
+			return result;
+		},
+		async migrateTo(...args) {
+			const version = args[0];
+			const options = args[1];
+			const currentVersion = await migrator.getVersion();
+			const result = await migrator.migrateTo(version, options);
+			if (!currentVersion || semver.gt(version, currentVersion)) enhanceUpwardMigrationResult(result, provider, version);
+			return result;
+		},
+		async migrateToLatest(...args) {
+			const currentVersion = await migrator.getVersion();
+			const result = await migrator.migrateToLatest(...args);
+			if (!currentVersion || semver.gt(latestVersion, currentVersion)) enhanceUpwardMigrationResult(result, provider, latestVersion);
+			return result;
+		}
+	};
+};
+//#endregion
+export { assertBundlePersistenceConstraints, enhanceGeneratedSchema, wrapKyselyMigrator };

package/dist/db/types.cjs

@@ -1,3 +1,4 @@
+const require_index = require("../node_modules/.pnpm/fumadb@0.2.2_drizzle-orm@0.44.7_@cloudflare_workers-types@4.20260313.1_@electric-sql_pg_c72c8c754becd21f6d6662e8fbd28e7f/node_modules/fumadb/dist/index.cjs");
 //#region src/db/types.ts
 function isDatabasePluginFactory(adapter) {
 	return typeof adapter === "function";
@@ -5,6 +6,11 @@ function isDatabasePluginFactory(adapter) {
 function isDatabasePlugin(adapter) {
 	return typeof adapter === "object" && adapter !== null && "getBundleById" in adapter && "getBundles" in adapter && "getChannels" in adapter;
 }
+function getSQLProvider(provider) {
+	if (!provider) return;
+	return require_index.sqlProviders.includes(provider) ? provider : void 0;
+}
 //#endregion
+exports.getSQLProvider = getSQLProvider;
 exports.isDatabasePlugin = isDatabasePlugin;
 exports.isDatabasePluginFactory = isDatabasePluginFactory;

package/dist/db/types.d.cts

@@ -1,21 +1,33 @@
+import { Provider } from "../node_modules/.pnpm/fumadb@0.2.2_drizzle-orm@0.44.7_@cloudflare_workers-types@4.20260313.1_@electric-sql_pg_c72c8c754becd21f6d6662e8fbd28e7f/node_modules/fumadb/dist/index-CMqePMTF.cjs";
 import { PaginatedResult } from "../types/index.cjs";
-import { DatabaseBundleQueryOptions, DatabasePlugin, HotUpdaterContext, StoragePlugin } from "@hot-updater/plugin-core";
-import { AppUpdateInfo, Bundle, GetBundlesArgs, UpdateInfo } from "@hot-updater/core";
-import { FumaDBAdapter } from "fumadb/adapters";
+import { AppUpdateAvailableInfo, Bundle, GetBundlesArgs, UpdateInfo } from "@hot-updater/core";
+import { DatabaseBundleQueryOptions, DatabasePlugin, HotUpdaterContext, RuntimeStoragePlugin } from "@hot-updater/plugin-core";
 
 //#region src/db/types.d.ts
 type DatabasePluginFactory<TContext = unknown> = () => DatabasePlugin<TContext>;
-type DatabaseAdapter<TContext = unknown> = FumaDBAdapter | DatabasePlugin<TContext> | DatabasePluginFactory<TContext>;
+type ORMProvider = Provider;
+interface ORMDatabaseAdapter {
+  name: string;
+  provider?: ORMProvider;
+  createORM(this: any, schema: any): unknown;
+  getSchemaVersion(this: any): Promise<string | undefined>;
+  generateSchema?: (this: any, schema: any, schemaName: string) => {
+    code: string;
+    path: string;
+  };
+  createMigrationEngine?: (this: any) => unknown;
+}
+type DatabaseAdapter<TContext = unknown> = ORMDatabaseAdapter | DatabasePlugin<TContext> | DatabasePluginFactory<TContext>;
 interface DatabaseAPI<TContext = unknown> {
   getBundleById(id: string, context?: HotUpdaterContext<TContext>): Promise<Bundle | null>;
   getUpdateInfo(args: GetBundlesArgs, context?: HotUpdaterContext<TContext>): Promise<UpdateInfo | null>;
-  getAppUpdateInfo(args: GetBundlesArgs, context?: HotUpdaterContext<TContext>): Promise<AppUpdateInfo | null>;
+  getAppUpdateInfo(args: GetBundlesArgs, context?: HotUpdaterContext<TContext>): Promise<AppUpdateAvailableInfo | null>;
   getChannels(context?: HotUpdaterContext<TContext>): Promise<string[]>;
   getBundles(options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>): Promise<PaginatedResult>;
   insertBundle(bundle: Bundle, context?: HotUpdaterContext<TContext>): Promise<void>;
   updateBundleById(bundleId: string, newBundle: Partial<Bundle>, context?: HotUpdaterContext<TContext>): Promise<void>;
   deleteBundleById(bundleId: string, context?: HotUpdaterContext<TContext>): Promise<void>;
 }
-type StoragePluginFactory<TContext = unknown> = () => StoragePlugin<TContext>;
+type StoragePluginFactory<TContext = unknown> = () => RuntimeStoragePlugin<TContext>;
 //#endregion
-export { DatabaseAPI, DatabaseAdapter, StoragePluginFactory };
+export { DatabaseAPI, DatabaseAdapter, ORMDatabaseAdapter, StoragePluginFactory };

package/dist/db/types.d.mts

@@ -1,21 +1,33 @@
+import { Provider } from "../node_modules/.pnpm/fumadb@0.2.2_drizzle-orm@0.44.7_@cloudflare_workers-types@4.20260313.1_@electric-sql_pg_c72c8c754becd21f6d6662e8fbd28e7f/node_modules/fumadb/dist/index-CMqePMTF.mjs";
 import { PaginatedResult } from "../types/index.mjs";
-import { AppUpdateInfo, Bundle, GetBundlesArgs, UpdateInfo } from "@hot-updater/core";
-import { DatabaseBundleQueryOptions, DatabasePlugin, HotUpdaterContext, StoragePlugin } from "@hot-updater/plugin-core";
-import { FumaDBAdapter } from "fumadb/adapters";
+import { DatabaseBundleQueryOptions, DatabasePlugin, HotUpdaterContext, RuntimeStoragePlugin } from "@hot-updater/plugin-core";
+import { AppUpdateAvailableInfo, Bundle as Bundle$1, GetBundlesArgs, UpdateInfo } from "@hot-updater/core";
 
 //#region src/db/types.d.ts
 type DatabasePluginFactory<TContext = unknown> = () => DatabasePlugin<TContext>;
-type DatabaseAdapter<TContext = unknown> = FumaDBAdapter | DatabasePlugin<TContext> | DatabasePluginFactory<TContext>;
+type ORMProvider = Provider;
+interface ORMDatabaseAdapter {
+  name: string;
+  provider?: ORMProvider;
+  createORM(this: any, schema: any): unknown;
+  getSchemaVersion(this: any): Promise<string | undefined>;
+  generateSchema?: (this: any, schema: any, schemaName: string) => {
+    code: string;
+    path: string;
+  };
+  createMigrationEngine?: (this: any) => unknown;
+}
+type DatabaseAdapter<TContext = unknown> = ORMDatabaseAdapter | DatabasePlugin<TContext> | DatabasePluginFactory<TContext>;
 interface DatabaseAPI<TContext = unknown> {
-  getBundleById(id: string, context?: HotUpdaterContext<TContext>): Promise<Bundle | null>;
+  getBundleById(id: string, context?: HotUpdaterContext<TContext>): Promise<Bundle$1 | null>;
   getUpdateInfo(args: GetBundlesArgs, context?: HotUpdaterContext<TContext>): Promise<UpdateInfo | null>;
-  getAppUpdateInfo(args: GetBundlesArgs, context?: HotUpdaterContext<TContext>): Promise<AppUpdateInfo | null>;
+  getAppUpdateInfo(args: GetBundlesArgs, context?: HotUpdaterContext<TContext>): Promise<AppUpdateAvailableInfo | null>;
   getChannels(context?: HotUpdaterContext<TContext>): Promise<string[]>;
   getBundles(options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>): Promise<PaginatedResult>;
-  insertBundle(bundle: Bundle, context?: HotUpdaterContext<TContext>): Promise<void>;
-  updateBundleById(bundleId: string, newBundle: Partial<Bundle>, context?: HotUpdaterContext<TContext>): Promise<void>;
+  insertBundle(bundle: Bundle$1, context?: HotUpdaterContext<TContext>): Promise<void>;
+  updateBundleById(bundleId: string, newBundle: Partial<Bundle$1>, context?: HotUpdaterContext<TContext>): Promise<void>;
   deleteBundleById(bundleId: string, context?: HotUpdaterContext<TContext>): Promise<void>;
 }
-type StoragePluginFactory<TContext = unknown> = () => StoragePlugin<TContext>;
+type StoragePluginFactory<TContext = unknown> = () => RuntimeStoragePlugin<TContext>;
 //#endregion
-export { DatabaseAPI, DatabaseAdapter, StoragePluginFactory };
+export { DatabaseAPI, DatabaseAdapter, ORMDatabaseAdapter, StoragePluginFactory };

package/dist/db/types.mjs

@@ -1,3 +1,4 @@
+import { sqlProviders } from "../node_modules/.pnpm/fumadb@0.2.2_drizzle-orm@0.44.7_@cloudflare_workers-types@4.20260313.1_@electric-sql_pg_c72c8c754becd21f6d6662e8fbd28e7f/node_modules/fumadb/dist/index.mjs";
 //#region src/db/types.ts
 function isDatabasePluginFactory(adapter) {
 	return typeof adapter === "function";
@@ -5,5 +6,9 @@ function isDatabasePluginFactory(adapter) {
 function isDatabasePlugin(adapter) {
 	return typeof adapter === "object" && adapter !== null && "getBundleById" in adapter && "getBundles" in adapter && "getChannels" in adapter;
 }
+function getSQLProvider(provider) {
+	if (!provider) return;
+	return sqlProviders.includes(provider) ? provider : void 0;
+}
 //#endregion
-export { isDatabasePlugin, isDatabasePluginFactory };
+export { getSQLProvider, isDatabasePlugin, isDatabasePluginFactory };

package/dist/db/updateArtifacts.cjs

@@ -0,0 +1,127 @@
+require("../_virtual/_rolldown/runtime.cjs");
+let _hot_updater_core = require("@hot-updater/core");
+//#region src/db/updateArtifacts.ts
+const HBC_ASSET_PATH_RE = /\.bundle$/;
+const BR_COMPRESSED_ASSET_PATH_RE = /(^|\/)index\.[^/]+\.bundle$/;
+const resolveUniqueHbcAssetPath = (manifest) => {
+	const candidates = Object.keys(manifest.assets).sort((left, right) => left.localeCompare(right)).filter((candidate) => HBC_ASSET_PATH_RE.test(candidate));
+	return candidates.length === 1 ? candidates[0] : null;
+};
+const isBundleManifest = (value) => {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const manifest = value;
+	if (typeof manifest.bundleId !== "string") return false;
+	if (!manifest.assets || typeof manifest.assets !== "object") return false;
+	return Object.values(manifest.assets).every((asset) => {
+		if (!asset || typeof asset !== "object" || Array.isArray(asset)) return false;
+		const manifestAsset = asset;
+		return typeof manifestAsset.fileHash === "string" && (manifestAsset.signature === void 0 || typeof manifestAsset.signature === "string");
+	});
+};
+const createChildStorageUri = (baseStorageUri, relativePath) => {
+	const baseUrl = new URL(baseStorageUri);
+	baseUrl.pathname = `${baseUrl.pathname.replace(/\/+$/, "")}/${relativePath.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/")}`;
+	return baseUrl.toString();
+};
+const parseBundleMetadata = (value) => {
+	if (!value) return;
+	let parsedValue = value;
+	if (typeof parsedValue === "string") try {
+		parsedValue = JSON.parse(parsedValue);
+	} catch {
+		return;
+	}
+	if (!parsedValue || typeof parsedValue !== "object" || Array.isArray(parsedValue)) return;
+	return (0, _hot_updater_core.stripBundleArtifactMetadata)(parsedValue);
+};
+async function fetchBundleManifest(storageUri, readStorageText, resolveFileUrl, context) {
+	const [storageText, fileUrl] = await Promise.all([readStorageText(storageUri, context), resolveFileUrl(storageUri, context)]);
+	if (storageText === null) return null;
+	let payload;
+	try {
+		payload = JSON.parse(storageText);
+	} catch {
+		return null;
+	}
+	if (!isBundleManifest(payload)) return null;
+	if (!fileUrl) return null;
+	return {
+		fileUrl,
+		manifest: payload
+	};
+}
+async function resolveChangedAssets({ assetBaseStorageUri, currentManifest, currentBundle, resolveFileUrl, targetBundle, targetManifest, context }) {
+	const patchDescriptor = await resolveHbcPatchDescriptor({
+		currentBundle,
+		resolveFileUrl,
+		targetBundle,
+		targetManifest,
+		context
+	});
+	const changedEntries = await Promise.all(Object.entries(targetManifest.assets).map(async ([assetPath, asset]) => {
+		if ((currentManifest?.assets[assetPath])?.fileHash === asset.fileHash) return null;
+		const usesBrotliAsset = BR_COMPRESSED_ASSET_PATH_RE.test(assetPath);
+		const storageUri = createChildStorageUri(assetBaseStorageUri, usesBrotliAsset ? `${assetPath}.br` : assetPath);
+		const patch = patchDescriptor?.assetPath === assetPath ? patchDescriptor.patch : null;
+		let fileUrl = null;
+		try {
+			fileUrl = await resolveFileUrl(storageUri, context);
+		} catch (error) {
+			if (!patch) throw error;
+		}
+		if (!fileUrl && !patch) return false;
+		const changedAsset = { fileHash: asset.fileHash };
+		if (fileUrl) {
+			changedAsset.file = { url: fileUrl };
+			if (usesBrotliAsset) changedAsset.file.compression = "br";
+		}
+		if (patch) changedAsset.patch = patch;
+		return [assetPath, changedAsset];
+	}));
+	if (changedEntries.some((entry) => entry === false)) return null;
+	return Object.fromEntries(changedEntries.filter((entry) => entry !== null));
+}
+async function resolveHbcPatchDescriptor({ currentBundle, resolveFileUrl, targetBundle, targetManifest, context }) {
+	const matchingPatch = targetBundle && currentBundle ? (0, _hot_updater_core.getBundlePatch)(targetBundle, currentBundle.id) : null;
+	const patchAssetPath = resolveUniqueHbcAssetPath(targetManifest);
+	if (!currentBundle || !matchingPatch || !patchAssetPath || !matchingPatch.patchStorageUri || !matchingPatch.patchFileHash || !matchingPatch.baseFileHash) return null;
+	const patchUrl = await resolveFileUrl(matchingPatch.patchStorageUri, context);
+	if (!patchUrl) return null;
+	return {
+		assetPath: patchAssetPath,
+		patch: {
+			algorithm: "bsdiff",
+			baseBundleId: matchingPatch.baseBundleId,
+			baseFileHash: matchingPatch.baseFileHash,
+			patchFileHash: matchingPatch.patchFileHash,
+			patchUrl
+		}
+	};
+}
+async function resolveManifestArtifacts({ currentBundle, resolveFileUrl, readStorageText, targetBundle, context }) {
+	const manifestStorageUri = targetBundle ? (0, _hot_updater_core.getManifestStorageUri)(targetBundle) : null;
+	const manifestFileHash = targetBundle ? (0, _hot_updater_core.getManifestFileHash)(targetBundle) : null;
+	const assetBaseStorageUri = targetBundle ? (0, _hot_updater_core.getAssetBaseStorageUri)(targetBundle) : null;
+	if (!manifestStorageUri || !manifestFileHash || !assetBaseStorageUri) return null;
+	const currentManifestStorageUri = currentBundle ? (0, _hot_updater_core.getManifestStorageUri)(currentBundle) : null;
+	const [targetManifestResult, currentManifestResult] = await Promise.all([fetchBundleManifest(manifestStorageUri, readStorageText, resolveFileUrl, context), currentManifestStorageUri ? fetchBundleManifest(currentManifestStorageUri, readStorageText, resolveFileUrl, context) : null]);
+	if (!targetManifestResult) return null;
+	const changedAssets = await resolveChangedAssets({
+		assetBaseStorageUri,
+		currentManifest: currentManifestResult?.manifest ?? null,
+		currentBundle,
+		resolveFileUrl,
+		targetBundle,
+		targetManifest: targetManifestResult.manifest,
+		context
+	});
+	if (!changedAssets) return null;
+	return {
+		changedAssets,
+		manifestFileHash,
+		manifestUrl: targetManifestResult.fileUrl
+	};
+}
+//#endregion
+exports.parseBundleMetadata = parseBundleMetadata;
+exports.resolveManifestArtifacts = resolveManifestArtifacts;