@hot-updater/server 0.33.2 → 0.35.0

package/dist/db/fixedMigrator.mjs

@@ -0,0 +1,135 @@
+import { HOT_UPDATER_SCHEMA_VERSION, HOT_UPDATER_SETTINGS_TABLE } from "../schema/types.mjs";
+import { hotUpdaterSchema, schemaIndexAppliesToProvider } from "./schema/registry.mjs";
+import { createTableSql } from "./schema/sql.mjs";
+import { createMongoMigrationOperations } from "./schema/mongodb.mjs";
+import { createV029AlterSql, createV031AlterSql } from "./schema/sqlMigrations.mjs";
+import { createSqlCreateOperations, getSettingsInsertSql } from "./schema/sqlOperations.mjs";
+//#region src/db/fixedMigrator.ts
+const getEmptyResult = () => ({
+	operations: [],
+	execute: async () => {},
+	getSQL: () => ""
+});
+const assertSupportedMigrationMode = (options) => {
+	if (options.mode === "from-database") throw new Error("Hot Updater migrations support only mode: 'from-schema'.");
+};
+const isMissingSettingsTableError = (error) => {
+	if (!(error instanceof Error)) return false;
+	const message = error.message.toLowerCase();
+	return message.includes("private_hot_updater_settings") && (message.includes("does not exist") || message.includes("no such table") || message.includes("doesn't exist") || message.includes("not found"));
+};
+const isMongoNamespaceExistsError = (error) => {
+	if (!(error instanceof Error)) return false;
+	const mongoError = error;
+	return mongoError.code === 48 || mongoError.codeName === "NamespaceExists";
+};
+const ignoreExistingCollection = (error) => {
+	if (isMongoNamespaceExistsError(error)) return;
+	throw error;
+};
+const toCustomOperations = (statements, settingsOperation) => [...statements.map((statement) => ({
+	type: "custom",
+	sql: statement
+})), ...settingsOperation ? [settingsOperation] : []];
+const assertSupportedSchemaVersion = (currentVersion) => {
+	if (currentVersion !== void 0 && currentVersion !== "0.21.0" && currentVersion !== "0.29.0") throw new Error(`Unsupported Hot Updater schema version: ${currentVersion}`);
+};
+const createKyselyMigrator = ({ db, provider, relationMode = "foreign-keys" }) => {
+	const getVersion = async () => {
+		try {
+			const row = await db.selectFrom(HOT_UPDATER_SETTINGS_TABLE).select("value").where("key", "=", "version").executeTakeFirst();
+			return typeof row?.value === "string" ? row.value : void 0;
+		} catch (error) {
+			if (!isMissingSettingsTableError(error)) throw error;
+			return;
+		}
+	};
+	const makeResult = async (options = {}) => {
+		assertSupportedMigrationMode(options);
+		const currentVersion = await getVersion();
+		if (currentVersion === "0.31.0") return getEmptyResult();
+		assertSupportedSchemaVersion(currentVersion);
+		const settingsStatement = getSettingsInsertSql(provider);
+		const settingsOperation = options.updateSettings === false ? void 0 : {
+			type: "custom",
+			sql: settingsStatement
+		};
+		const executableSettingsStatements = options.updateSettings === false ? [] : [settingsStatement];
+		const statements = currentVersion === void 0 ? [...createTableSql(provider, relationMode), settingsStatement] : [
+			...currentVersion === "0.21.0" ? createV029AlterSql(provider) : [],
+			...currentVersion === "0.21.0" || currentVersion === "0.29.0" ? createV031AlterSql(provider, relationMode) : [],
+			...executableSettingsStatements
+		];
+		return {
+			operations: currentVersion === void 0 ? createSqlCreateOperations(provider, relationMode, settingsOperation) : toCustomOperations([...currentVersion === "0.21.0" ? createV029AlterSql(provider) : [], ...currentVersion === "0.21.0" || currentVersion === "0.29.0" ? createV031AlterSql(provider, relationMode) : []], settingsOperation),
+			getSQL: () => statements.map((statement) => `${statement};`).join("\n\n"),
+			execute: async () => {
+				const { sql } = await import("kysely");
+				for (const statement of statements) await sql.raw(statement).execute(db);
+			}
+		};
+	};
+	return {
+		getVersion,
+		getNameVariants: async () => void 0,
+		next: async () => await getVersion() === "0.31.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, options) => {
+			if (version !== "0.31.0") throw new Error(`Invalid version ${version}`);
+			return makeResult(options);
+		},
+		migrateToLatest: makeResult
+	};
+};
+const createMongoMigrator = (client) => {
+	const settings = client.db().collection(HOT_UPDATER_SETTINGS_TABLE);
+	const getVersion = async () => {
+		const row = await settings.findOne({ key: "version" });
+		return typeof row?.value === "string" ? row.value : void 0;
+	};
+	const makeResult = async (options = {}) => {
+		assertSupportedMigrationMode(options);
+		if (await getVersion() === "0.31.0") return getEmptyResult();
+		return {
+			operations: createMongoMigrationOperations(options.updateSettings === false ? void 0 : {
+				type: "custom",
+				key: "version",
+				value: HOT_UPDATER_SCHEMA_VERSION
+			}),
+			execute: async () => {
+				const db = client.db();
+				for (const table of hotUpdaterSchema.tables) {
+					if (table.internal) continue;
+					await db.createCollection(table.ormName).catch(ignoreExistingCollection);
+				}
+				await db.collection("bundles").createIndex({ id: 1 }, { name: "bundles_id_idx" });
+				for (const table of hotUpdaterSchema.tables) {
+					if (table.internal) continue;
+					for (const index of (table.indexes ?? []).filter((item) => schemaIndexAppliesToProvider(item, "mongodb"))) await db.collection(table.ormName).createIndex(Object.fromEntries(index.columns.map((column) => [column, 1])), { name: index.name });
+				}
+				if (options.updateSettings !== false) await settings.updateOne({ key: "version" }, { $set: { value: HOT_UPDATER_SCHEMA_VERSION } }, { upsert: true });
+			}
+		};
+	};
+	return {
+		getVersion,
+		getNameVariants: async () => void 0,
+		next: async () => await getVersion() === "0.31.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, options) => {
+			if (version !== "0.31.0") throw new Error(`Invalid version ${version}`);
+			return makeResult(options);
+		},
+		migrateToLatest: makeResult
+	};
+};
+//#endregion
+export { createKyselyMigrator, createMongoMigrator };

package/dist/db/index.cjs

@@ -1,45 +1,27 @@
-require("../_virtual/_rolldown/runtime.cjs");
-require("./createBundleDiff.cjs");
-require("../version.cjs");
-const require_handler = require("../handler.cjs");
-const require_route = require("../route.cjs");
-const require_storageAccess = require("../storageAccess.cjs");
-const require_types = require("./types.cjs");
-const require_ormCore = require("./ormCore.cjs");
-const require_pluginCore = require("./pluginCore.cjs");
-let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_version = require("../version.cjs");
+const require_schemaReadiness = require("./schemaReadiness.cjs");
+const require_createHotUpdaterCore = require("../createHotUpdaterCore.cjs");
+const require_schemaGenerators = require("./schemaGenerators.cjs");
+const require_createBundleDiff = require("./createBundleDiff.cjs");
 //#region src/db/index.ts
-function createHotUpdater(options) {
-	const basePath = require_route.normalizeBasePath(options.basePath ?? "/api");
-	const { readStorageText, resolveFileUrl } = require_storageAccess.createStorageAccess((options.storages ?? options.storagePlugins ?? []).map((plugin) => {
-		const storagePlugin = typeof plugin === "function" ? plugin() : plugin;
-		(0, _hot_updater_plugin_core.assertRuntimeStoragePlugin)(storagePlugin);
-		return storagePlugin;
-	}));
-	const database = options.database;
-	const core = require_types.isDatabasePluginFactory(database) || require_types.isDatabasePlugin(database) ? (() => {
-		const plugin = require_types.isDatabasePluginFactory(database) ? database() : database;
-		return require_pluginCore.createPluginDatabaseCore(() => plugin, resolveFileUrl, require_types.isDatabasePluginFactory(database) ? {
-			createMutationPlugin: () => database(),
-			readStorageText
-		} : { readStorageText });
-	})() : require_ormCore.createOrmDatabaseCore({
-		database,
-		readStorageText,
-		resolveFileUrl
-	});
-	const api = {
-		basePath,
-		adapterName: core.adapterName,
-		createMigrator: core.createMigrator,
-		generateSchema: core.generateSchema,
-		handler: require_handler.createHandler(core.api, {
-			basePath,
-			routes: options.routes
-		})
-	};
-	Object.defineProperties(api, Object.getOwnPropertyDescriptors(core.api));
-	return api;
+const getDBMetadata = (hotUpdater) => {
+	const metadata = require_createHotUpdaterCore.getHotUpdaterCoreMetadata(hotUpdater);
+	if (!metadata) throw new Error("Database tooling requires a hotUpdater instance created by @hot-updater/server.");
+	return metadata;
+};
+function createMigrator(hotUpdater) {
+	const { adapterCapabilities, core } = getDBMetadata(hotUpdater);
+	return (adapterCapabilities.createMigrator ?? core.createMigrator)();
+}
+function generateSchema(hotUpdater, ...args) {
+	const { adapterCapabilities, core } = getDBMetadata(hotUpdater);
+	const schemaGenerator = adapterCapabilities.generateSchema ?? core.generateSchema;
+	return require_schemaGenerators.generateSchemaFromHotUpdaterSchema(hotUpdater.adapterName, adapterCapabilities.provider, args[0], schemaGenerator(...args));
 }
 //#endregion
-exports.createHotUpdater = createHotUpdater;
+exports.HOT_UPDATER_SERVER_VERSION = require_version.HOT_UPDATER_SERVER_VERSION;
+exports.HotUpdaterSchemaMigrationRequiredError = require_schemaReadiness.HotUpdaterSchemaMigrationRequiredError;
+exports.createBundleDiff = require_createBundleDiff.createBundleDiff;
+exports.createMigrator = createMigrator;
+exports.generateSchema = generateSchema;

package/dist/db/index.d.cts

@@ -1,32 +1,13 @@
+import { Migrator, SchemaGenerator } from "./types.cjs";
 import { CreateBundleDiffDependencies, CreateBundleDiffInput, CreateBundleDiffOptions, createBundleDiff } from "./createBundleDiff.cjs";
-import { HandlerRoutes } from "../handler.cjs";
-import { HotUpdaterClient, HotUpdaterDB, Migrator } from "./ormCore.cjs";
+import { HotUpdaterSchemaMigrationRequiredError } from "./schemaReadiness.cjs";
 import { HOT_UPDATER_SERVER_VERSION } from "../version.cjs";
-import { DatabaseAPI, DatabaseAdapter, StoragePluginFactory } from "./types.cjs";
-import { HotUpdaterContext, RuntimeStoragePlugin } from "@hot-updater/plugin-core";
 
 //#region src/db/index.d.ts
-type HotUpdaterAPI<TContext = unknown> = DatabaseAPI<TContext> & {
-  basePath: string;
-  handler: (request: Request, context?: HotUpdaterContext<TContext>) => Promise<Response>;
-  adapterName: string;
-  createMigrator: () => Migrator;
-  generateSchema: HotUpdaterClient["generateSchema"];
+type HotUpdaterDBTarget = {
+  readonly adapterName: string;
 };
-interface CreateHotUpdaterOptions<TContext = unknown> {
-  database: DatabaseAdapter<TContext>;
-  /**
-   * Storage plugins for handling file uploads and downloads.
-   */
-  storages?: (RuntimeStoragePlugin<TContext> | StoragePluginFactory<TContext>)[];
-  /**
-   * @deprecated Use `storages` instead. This field will be removed in a future version.
-   */
-  storagePlugins?: (RuntimeStoragePlugin<TContext> | StoragePluginFactory<TContext>)[];
-  basePath?: string;
-  cwd?: string;
-  routes?: HandlerRoutes;
-}
-declare function createHotUpdater<TContext = unknown>(options: CreateHotUpdaterOptions<TContext>): HotUpdaterAPI<TContext>;
+declare function createMigrator(hotUpdater: HotUpdaterDBTarget): Migrator;
+declare function generateSchema(hotUpdater: HotUpdaterDBTarget, ...args: Parameters<SchemaGenerator>): ReturnType<SchemaGenerator>;
 //#endregion
-export { CreateHotUpdaterOptions, HotUpdaterAPI, createHotUpdater };
+export { CreateBundleDiffDependencies, CreateBundleDiffInput, CreateBundleDiffOptions, HOT_UPDATER_SERVER_VERSION, HotUpdaterDBTarget, HotUpdaterSchemaMigrationRequiredError, type Migrator, type SchemaGenerator, createBundleDiff, createMigrator, generateSchema };

package/dist/db/index.d.mts

@@ -1,32 +1,13 @@
+import { Migrator, SchemaGenerator } from "./types.mjs";
 import { CreateBundleDiffDependencies, CreateBundleDiffInput, CreateBundleDiffOptions, createBundleDiff } from "./createBundleDiff.mjs";
-import { HandlerRoutes } from "../handler.mjs";
-import { HotUpdaterClient, HotUpdaterDB, Migrator } from "./ormCore.mjs";
+import { HotUpdaterSchemaMigrationRequiredError } from "./schemaReadiness.mjs";
 import { HOT_UPDATER_SERVER_VERSION } from "../version.mjs";
-import { DatabaseAPI, DatabaseAdapter, StoragePluginFactory } from "./types.mjs";
-import { HotUpdaterContext, RuntimeStoragePlugin } from "@hot-updater/plugin-core";
 
 //#region src/db/index.d.ts
-type HotUpdaterAPI<TContext = unknown> = DatabaseAPI<TContext> & {
-  basePath: string;
-  handler: (request: Request, context?: HotUpdaterContext<TContext>) => Promise<Response>;
-  adapterName: string;
-  createMigrator: () => Migrator;
-  generateSchema: HotUpdaterClient["generateSchema"];
+type HotUpdaterDBTarget = {
+  readonly adapterName: string;
 };
-interface CreateHotUpdaterOptions<TContext = unknown> {
-  database: DatabaseAdapter<TContext>;
-  /**
-   * Storage plugins for handling file uploads and downloads.
-   */
-  storages?: (RuntimeStoragePlugin<TContext> | StoragePluginFactory<TContext>)[];
-  /**
-   * @deprecated Use `storages` instead. This field will be removed in a future version.
-   */
-  storagePlugins?: (RuntimeStoragePlugin<TContext> | StoragePluginFactory<TContext>)[];
-  basePath?: string;
-  cwd?: string;
-  routes?: HandlerRoutes;
-}
-declare function createHotUpdater<TContext = unknown>(options: CreateHotUpdaterOptions<TContext>): HotUpdaterAPI<TContext>;
+declare function createMigrator(hotUpdater: HotUpdaterDBTarget): Migrator;
+declare function generateSchema(hotUpdater: HotUpdaterDBTarget, ...args: Parameters<SchemaGenerator>): ReturnType<SchemaGenerator>;
 //#endregion
-export { CreateHotUpdaterOptions, HotUpdaterAPI, createHotUpdater };
+export { CreateBundleDiffDependencies, CreateBundleDiffInput, CreateBundleDiffOptions, HOT_UPDATER_SERVER_VERSION, HotUpdaterDBTarget, HotUpdaterSchemaMigrationRequiredError, type Migrator, type SchemaGenerator, createBundleDiff, createMigrator, generateSchema };

package/dist/db/index.mjs

@@ -1,44 +1,22 @@
-import "./createBundleDiff.mjs";
-import "../version.mjs";
-import { createHandler } from "../handler.mjs";
-import { normalizeBasePath } from "../route.mjs";
-import { createStorageAccess } from "../storageAccess.mjs";
-import { isDatabasePlugin, isDatabasePluginFactory } from "./types.mjs";
-import { createOrmDatabaseCore } from "./ormCore.mjs";
-import { createPluginDatabaseCore } from "./pluginCore.mjs";
-import { assertRuntimeStoragePlugin } from "@hot-updater/plugin-core";
+import { HOT_UPDATER_SERVER_VERSION } from "../version.mjs";
+import { HotUpdaterSchemaMigrationRequiredError } from "./schemaReadiness.mjs";
+import { getHotUpdaterCoreMetadata } from "../createHotUpdaterCore.mjs";
+import { generateSchemaFromHotUpdaterSchema } from "./schemaGenerators.mjs";
+import { createBundleDiff } from "./createBundleDiff.mjs";
 //#region src/db/index.ts
-function createHotUpdater(options) {
-	const basePath = normalizeBasePath(options.basePath ?? "/api");
-	const { readStorageText, resolveFileUrl } = createStorageAccess((options.storages ?? options.storagePlugins ?? []).map((plugin) => {
-		const storagePlugin = typeof plugin === "function" ? plugin() : plugin;
-		assertRuntimeStoragePlugin(storagePlugin);
-		return storagePlugin;
-	}));
-	const database = options.database;
-	const core = isDatabasePluginFactory(database) || isDatabasePlugin(database) ? (() => {
-		const plugin = isDatabasePluginFactory(database) ? database() : database;
-		return createPluginDatabaseCore(() => plugin, resolveFileUrl, isDatabasePluginFactory(database) ? {
-			createMutationPlugin: () => database(),
-			readStorageText
-		} : { readStorageText });
-	})() : createOrmDatabaseCore({
-		database,
-		readStorageText,
-		resolveFileUrl
-	});
-	const api = {
-		basePath,
-		adapterName: core.adapterName,
-		createMigrator: core.createMigrator,
-		generateSchema: core.generateSchema,
-		handler: createHandler(core.api, {
-			basePath,
-			routes: options.routes
-		})
-	};
-	Object.defineProperties(api, Object.getOwnPropertyDescriptors(core.api));
-	return api;
+const getDBMetadata = (hotUpdater) => {
+	const metadata = getHotUpdaterCoreMetadata(hotUpdater);
+	if (!metadata) throw new Error("Database tooling requires a hotUpdater instance created by @hot-updater/server.");
+	return metadata;
+};
+function createMigrator(hotUpdater) {
+	const { adapterCapabilities, core } = getDBMetadata(hotUpdater);
+	return (adapterCapabilities.createMigrator ?? core.createMigrator)();
+}
+function generateSchema(hotUpdater, ...args) {
+	const { adapterCapabilities, core } = getDBMetadata(hotUpdater);
+	const schemaGenerator = adapterCapabilities.generateSchema ?? core.generateSchema;
+	return generateSchemaFromHotUpdaterSchema(hotUpdater.adapterName, adapterCapabilities.provider, args[0], schemaGenerator(...args));
 }
 //#endregion
-export { createHotUpdater };
+export { HOT_UPDATER_SERVER_VERSION, HotUpdaterSchemaMigrationRequiredError, createBundleDiff, createMigrator, generateSchema };

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 };