@hot-updater/server 0.28.0 → 0.29.0

package/dist/db/pluginCore.mjs

@@ -0,0 +1,176 @@
+import { NIL_UUID, isCohortEligibleForUpdate } from "@hot-updater/core";
+import { semverSatisfies } from "@hot-updater/plugin-core";
+//#region src/db/pluginCore.ts
+const PAGE_SIZE = 100;
+const DESC_ORDER = {
+	field: "id",
+	direction: "desc"
+};
+const bundleMatchesQueryWhere = (bundle, where) => {
+	if (!where) return true;
+	if (where.channel !== void 0 && bundle.channel !== where.channel) return false;
+	if (where.platform !== void 0 && bundle.platform !== where.platform) return false;
+	if (where.enabled !== void 0 && bundle.enabled !== where.enabled) return false;
+	if (where.id?.eq !== void 0 && bundle.id !== where.id.eq) return false;
+	if (where.id?.gt !== void 0 && bundle.id.localeCompare(where.id.gt) <= 0) return false;
+	if (where.id?.gte !== void 0 && bundle.id.localeCompare(where.id.gte) < 0) return false;
+	if (where.id?.lt !== void 0 && bundle.id.localeCompare(where.id.lt) >= 0) return false;
+	if (where.id?.lte !== void 0 && bundle.id.localeCompare(where.id.lte) > 0) return false;
+	if (where.id?.in && !where.id.in.includes(bundle.id)) return false;
+	if (where.targetAppVersionNotNull && bundle.targetAppVersion === null) return false;
+	if (where.targetAppVersion !== void 0 && bundle.targetAppVersion !== where.targetAppVersion) return false;
+	if (where.targetAppVersionIn && !where.targetAppVersionIn.includes(bundle.targetAppVersion ?? "")) return false;
+	if (where.fingerprintHash !== void 0 && bundle.fingerprintHash !== where.fingerprintHash) return false;
+	return true;
+};
+const sortBundles = (bundles, orderBy) => {
+	const direction = orderBy?.direction ?? "desc";
+	return bundles.slice().sort((a, b) => {
+		const result = a.id.localeCompare(b.id);
+		return direction === "asc" ? result : -result;
+	});
+};
+const makeResponse = (bundle, status) => ({
+	id: bundle.id,
+	message: bundle.message,
+	shouldForceUpdate: status === "ROLLBACK" ? true : bundle.shouldForceUpdate,
+	status,
+	storageUri: bundle.storageUri,
+	fileHash: bundle.fileHash
+});
+const INIT_BUNDLE_ROLLBACK_UPDATE_INFO = {
+	message: null,
+	id: NIL_UUID,
+	shouldForceUpdate: true,
+	status: "ROLLBACK",
+	storageUri: null,
+	fileHash: null
+};
+function createPluginDatabaseCore(plugin, resolveFileUrl) {
+	const getSortedBundlePage = async (options, context) => {
+		const result = await plugin.getBundles({
+			...options,
+			orderBy: options.orderBy ?? DESC_ORDER
+		}, context);
+		return {
+			...result,
+			data: sortBundles(result.data, options.orderBy ?? DESC_ORDER)
+		};
+	};
+	const isEligibleForUpdate = (bundle, cohort) => {
+		return isCohortEligibleForUpdate(bundle.id, cohort, bundle.rolloutCohortCount, bundle.targetCohorts);
+	};
+	const findUpdateInfoByScanning = async ({ args, queryWhere, isCandidate, context }) => {
+		let offset = 0;
+		while (true) {
+			const { data, pagination } = await getSortedBundlePage({
+				where: queryWhere,
+				limit: PAGE_SIZE,
+				offset,
+				orderBy: DESC_ORDER
+			}, context);
+			for (const bundle of data) {
+				if (!bundleMatchesQueryWhere(bundle, queryWhere) || !isCandidate(bundle)) continue;
+				if (args.bundleId === NIL_UUID) {
+					if (isEligibleForUpdate(bundle, args.cohort)) return makeResponse(bundle, "UPDATE");
+					continue;
+				}
+				const compareResult = bundle.id.localeCompare(args.bundleId);
+				if (compareResult > 0) {
+					if (isEligibleForUpdate(bundle, args.cohort)) return makeResponse(bundle, "UPDATE");
+					continue;
+				}
+				if (compareResult === 0) {
+					if (isEligibleForUpdate(bundle, args.cohort)) return null;
+					continue;
+				}
+				return makeResponse(bundle, "ROLLBACK");
+			}
+			if (!pagination.hasNextPage) break;
+			offset += PAGE_SIZE;
+		}
+		if (args.bundleId === NIL_UUID) return null;
+		if (args.minBundleId && args.bundleId.localeCompare(args.minBundleId) <= 0) return null;
+		return INIT_BUNDLE_ROLLBACK_UPDATE_INFO;
+	};
+	const getBaseWhere = ({ platform, channel, minBundleId }) => ({
+		platform,
+		channel,
+		enabled: true,
+		id: { gte: minBundleId }
+	});
+	return {
+		api: {
+			async getBundleById(id, context) {
+				return plugin.getBundleById(id, context);
+			},
+			async getUpdateInfo(args, context) {
+				const channel = args.channel ?? "production";
+				const minBundleId = args.minBundleId ?? NIL_UUID;
+				const baseWhere = getBaseWhere({
+					platform: args.platform,
+					channel,
+					minBundleId
+				});
+				if (args._updateStrategy === "fingerprint") return findUpdateInfoByScanning({
+					args,
+					queryWhere: {
+						...baseWhere,
+						fingerprintHash: args.fingerprintHash
+					},
+					context,
+					isCandidate: (bundle) => {
+						return bundle.enabled && bundle.platform === args.platform && bundle.channel === channel && bundle.id.localeCompare(minBundleId) >= 0 && bundle.fingerprintHash === args.fingerprintHash;
+					}
+				});
+				return findUpdateInfoByScanning({
+					args,
+					queryWhere: { ...baseWhere },
+					context,
+					isCandidate: (bundle) => {
+						return bundle.enabled && bundle.platform === args.platform && bundle.channel === channel && bundle.id.localeCompare(minBundleId) >= 0 && !!bundle.targetAppVersion && semverSatisfies(bundle.targetAppVersion, args.appVersion);
+					}
+				});
+			},
+			async getAppUpdateInfo(args, context) {
+				const info = await this.getUpdateInfo(args, context);
+				if (!info) return null;
+				const { storageUri, ...rest } = info;
+				const fileUrl = await resolveFileUrl(storageUri ?? null, context);
+				return {
+					...rest,
+					fileUrl
+				};
+			},
+			async getChannels(context) {
+				return plugin.getChannels(context);
+			},
+			async getBundles(options, context) {
+				return plugin.getBundles(options, context);
+			},
+			async insertBundle(bundle, context) {
+				await plugin.appendBundle(bundle, context);
+				await plugin.commitBundle(context);
+			},
+			async updateBundleById(bundleId, newBundle, context) {
+				await plugin.updateBundle(bundleId, newBundle, context);
+				await plugin.commitBundle(context);
+			},
+			async deleteBundleById(bundleId, context) {
+				const bundle = await plugin.getBundleById(bundleId, context);
+				if (!bundle) return;
+				await plugin.deleteBundle(bundle, context);
+				await plugin.commitBundle(context);
+			}
+		},
+		adapterName: plugin.name,
+		createMigrator: () => {
+			throw new Error("createMigrator is only available for Kysely/Prisma/Drizzle database adapters.");
+		},
+		generateSchema: () => {
+			throw new Error("generateSchema is only available for Kysely/Prisma/Drizzle database adapters.");
+		}
+	};
+}
+//#endregion
+export { createPluginDatabaseCore };

package/dist/db/types.cjs

@@ -1,4 +1,3 @@
-
 //#region src/db/types.ts
 function isDatabasePluginFactory(adapter) {
 	return typeof adapter === "function";
@@ -6,7 +5,6 @@ function isDatabasePluginFactory(adapter) {
 function isDatabasePlugin(adapter) {
 	return typeof adapter === "object" && adapter !== null && "getBundleById" in adapter && "getBundles" in adapter && "getChannels" in adapter;
 }
-
 //#endregion
 exports.isDatabasePlugin = isDatabasePlugin;
-exports.isDatabasePluginFactory = isDatabasePluginFactory;
+exports.isDatabasePluginFactory = isDatabasePluginFactory;

package/dist/db/types.d.cts

@@ -1,31 +1,24 @@
 import { PaginationInfo } from "../types/index.cjs";
-import { DatabasePlugin, StoragePlugin } from "@hot-updater/plugin-core";
-import { FumaDBAdapter } from "fumadb/adapters";
+import { DatabaseBundleQueryOptions, DatabasePlugin, HotUpdaterContext, StoragePlugin } from "@hot-updater/plugin-core";
 import { AppUpdateInfo, Bundle, GetBundlesArgs, UpdateInfo } from "@hot-updater/core";
+import { FumaDBAdapter } from "fumadb/adapters";
 
 //#region src/db/types.d.ts
-type DatabasePluginFactory = () => DatabasePlugin;
-type DatabaseAdapter = FumaDBAdapter | DatabasePlugin | DatabasePluginFactory;
-interface DatabaseAPI {
-  getBundleById(id: string): Promise<Bundle | null>;
-  getUpdateInfo(args: GetBundlesArgs): Promise<UpdateInfo | null>;
-  getAppUpdateInfo(args: GetBundlesArgs): Promise<AppUpdateInfo | null>;
-  getChannels(): Promise<string[]>;
-  getBundles(options: {
-    where?: {
-      channel?: string;
-      platform?: string;
-    };
-    limit: number;
-    offset: number;
-  }): Promise<{
+type DatabasePluginFactory<TContext = unknown> = () => DatabasePlugin<TContext>;
+type DatabaseAdapter<TContext = unknown> = FumaDBAdapter | 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>;
+  getChannels(context?: HotUpdaterContext<TContext>): Promise<string[]>;
+  getBundles(options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>): Promise<{
     data: Bundle[];
     pagination: PaginationInfo;
   }>;
-  insertBundle(bundle: Bundle): Promise<void>;
-  updateBundleById(bundleId: string, newBundle: Partial<Bundle>): Promise<void>;
-  deleteBundleById(bundleId: string): Promise<void>;
+  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 = () => StoragePlugin;
+type StoragePluginFactory<TContext = unknown> = () => StoragePlugin<TContext>;
 //#endregion
 export { DatabaseAPI, DatabaseAdapter, StoragePluginFactory };

package/dist/db/types.d.mts

@@ -0,0 +1,24 @@
+import { PaginationInfo } 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";
+
+//#region src/db/types.d.ts
+type DatabasePluginFactory<TContext = unknown> = () => DatabasePlugin<TContext>;
+type DatabaseAdapter<TContext = unknown> = FumaDBAdapter | 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>;
+  getChannels(context?: HotUpdaterContext<TContext>): Promise<string[]>;
+  getBundles(options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>): Promise<{
+    data: Bundle[];
+    pagination: PaginationInfo;
+  }>;
+  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>;
+//#endregion
+export { DatabaseAPI, DatabaseAdapter, StoragePluginFactory };

package/dist/db/{types.js → types.mjs}

@@ -5,6 +5,5 @@ function isDatabasePluginFactory(adapter) {
 function isDatabasePlugin(adapter) {
 	return typeof adapter === "object" && adapter !== null && "getBundleById" in adapter && "getBundles" in adapter && "getChannels" in adapter;
 }
-
 //#endregion
-export { isDatabasePlugin, isDatabasePluginFactory };
+export { isDatabasePlugin, isDatabasePluginFactory };

package/dist/handler.cjs

@@ -1,44 +1,88 @@
-const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
-let rou3 = require("rou3");
-rou3 = require_rolldown_runtime.__toESM(rou3);
-
+const require_internalRouter = require("./internalRouter.cjs");
 //#region src/handler.ts
+var HandlerBadRequestError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "HandlerBadRequestError";
+	}
+};
 const handleVersion = async () => {
-	return new Response(JSON.stringify({ version: "0.28.0" }), {
+	return new Response(JSON.stringify({ version: "0.29.0" }), {
 		status: 200,
 		headers: { "Content-Type": "application/json" }
 	});
 };
-const handleFingerprintUpdate = async (params, _request, api) => {
+const decodeMaybe = (value) => {
+	if (value === void 0) return void 0;
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		return value;
+	}
+};
+const isPlatform = (value) => {
+	return value === "ios" || value === "android";
+};
+const requireRouteParam = (params, key) => {
+	const value = params[key];
+	if (!value) throw new HandlerBadRequestError(`Missing route parameter: ${key}`);
+	return value;
+};
+const requirePlatformParam = (params) => {
+	const platform = requireRouteParam(params, "platform");
+	if (!isPlatform(platform)) throw new HandlerBadRequestError(`Invalid platform: ${platform}. Expected 'ios' or 'android'.`);
+	return platform;
+};
+const requireBundlePatchPayload = (payload, bundleId) => {
+	if (!payload || typeof payload !== "object" || Array.isArray(payload)) throw new HandlerBadRequestError("Invalid bundle payload");
+	const bundlePatch = payload;
+	if (bundlePatch.id !== void 0 && bundlePatch.id !== bundleId) throw new HandlerBadRequestError("Bundle id mismatch");
+	const { id: _ignoredId, ...rest } = bundlePatch;
+	return rest;
+};
+const handleFingerprintUpdateWithCohort = async (params, _request, api, context) => {
+	const platform = requirePlatformParam(params);
+	const fingerprintHash = requireRouteParam(params, "fingerprintHash");
+	const channel = requireRouteParam(params, "channel");
+	const minBundleId = requireRouteParam(params, "minBundleId");
+	const bundleId = requireRouteParam(params, "bundleId");
 	const updateInfo = await api.getAppUpdateInfo({
 		_updateStrategy: "fingerprint",
-		platform: params.platform,
-		fingerprintHash: params.fingerprintHash,
-		channel: params.channel,
-		minBundleId: params.minBundleId,
-		bundleId: params.bundleId
-	});
+		platform,
+		fingerprintHash,
+		channel,
+		minBundleId,
+		bundleId,
+		cohort: decodeMaybe(params.cohort)
+	}, context);
 	return new Response(JSON.stringify(updateInfo), {
 		status: 200,
 		headers: { "Content-Type": "application/json" }
 	});
 };
-const handleAppVersionUpdate = async (params, _request, api) => {
+const handleAppVersionUpdateWithCohort = async (params, _request, api, context) => {
+	const platform = requirePlatformParam(params);
+	const appVersion = requireRouteParam(params, "appVersion");
+	const channel = requireRouteParam(params, "channel");
+	const minBundleId = requireRouteParam(params, "minBundleId");
+	const bundleId = requireRouteParam(params, "bundleId");
 	const updateInfo = await api.getAppUpdateInfo({
 		_updateStrategy: "appVersion",
-		platform: params.platform,
-		appVersion: params.appVersion,
-		channel: params.channel,
-		minBundleId: params.minBundleId,
-		bundleId: params.bundleId
-	});
+		platform,
+		appVersion,
+		channel,
+		minBundleId,
+		bundleId,
+		cohort: decodeMaybe(params.cohort)
+	}, context);
 	return new Response(JSON.stringify(updateInfo), {
 		status: 200,
 		headers: { "Content-Type": "application/json" }
 	});
 };
-const handleGetBundle = async (params, _request, api) => {
-	const bundle = await api.getBundleById(params.id);
+const handleGetBundle = async (params, _request, api, context) => {
+	const bundleId = requireRouteParam(params, "id");
+	const bundle = await api.getBundleById(bundleId, context);
 	if (!bundle) return new Response(JSON.stringify({ error: "Bundle not found" }), {
 		status: 404,
 		headers: { "Content-Type": "application/json" }
@@ -48,12 +92,13 @@ const handleGetBundle = async (params, _request, api) => {
 		headers: { "Content-Type": "application/json" }
 	});
 };
-const handleGetBundles = async (_params, request, api) => {
+const handleGetBundles = async (_params, request, api, context) => {
 	const url = new URL(request.url);
 	const channel = url.searchParams.get("channel") ?? void 0;
-	const platform = url.searchParams.get("platform") ?? void 0;
+	const platform = url.searchParams.get("platform");
 	const limit = Number(url.searchParams.get("limit")) || 50;
 	const offset = Number(url.searchParams.get("offset")) || 0;
+	if (platform !== null && !isPlatform(platform)) throw new HandlerBadRequestError(`Invalid platform: ${platform}. Expected 'ios' or 'android'.`);
 	const result = await api.getBundles({
 		where: {
 			...channel && { channel },
@@ -61,30 +106,41 @@ const handleGetBundles = async (_params, request, api) => {
 		},
 		limit,
 		offset
-	});
+	}, context);
 	return new Response(JSON.stringify(result.data), {
 		status: 200,
 		headers: { "Content-Type": "application/json" }
 	});
 };
-const handleCreateBundles = async (_params, request, api) => {
+const handleCreateBundles = async (_params, request, api, context) => {
 	const body = await request.json();
 	const bundles = Array.isArray(body) ? body : [body];
-	for (const bundle of bundles) await api.insertBundle(bundle);
+	for (const bundle of bundles) await api.insertBundle(bundle, context);
 	return new Response(JSON.stringify({ success: true }), {
 		status: 201,
 		headers: { "Content-Type": "application/json" }
 	});
 };
-const handleDeleteBundle = async (params, _request, api) => {
-	await api.deleteBundleById(params.id);
+const handleUpdateBundle = async (params, request, api, context) => {
+	const bundleId = requireRouteParam(params, "id");
+	const body = await request.json();
+	const bundlePatch = requireBundlePatchPayload(Array.isArray(body) ? body[0] : body, bundleId);
+	await api.updateBundleById(bundleId, bundlePatch, context);
+	return new Response(JSON.stringify({ success: true }), {
+		status: 200,
+		headers: { "Content-Type": "application/json" }
+	});
+};
+const handleDeleteBundle = async (params, _request, api, context) => {
+	const bundleId = requireRouteParam(params, "id");
+	await api.deleteBundleById(bundleId, context);
 	return new Response(JSON.stringify({ success: true }), {
 		status: 200,
 		headers: { "Content-Type": "application/json" }
 	});
 };
-const handleGetChannels = async (_params, _request, api) => {
-	const channels = await api.getChannels();
+const handleGetChannels = async (_params, _request, api, context) => {
+	const channels = await api.getChannels(context);
 	return new Response(JSON.stringify({ channels }), {
 		status: 200,
 		headers: { "Content-Type": "application/json" }
@@ -92,35 +148,45 @@ const handleGetChannels = async (_params, _request, api) => {
 };
 const routes = {
 	version: handleVersion,
-	fingerprintUpdate: handleFingerprintUpdate,
-	appVersionUpdate: handleAppVersionUpdate,
+	fingerprintUpdateWithCohort: handleFingerprintUpdateWithCohort,
+	appVersionUpdateWithCohort: handleAppVersionUpdateWithCohort,
 	getBundle: handleGetBundle,
 	getBundles: handleGetBundles,
 	createBundles: handleCreateBundles,
+	updateBundle: handleUpdateBundle,
 	deleteBundle: handleDeleteBundle,
 	getChannels: handleGetChannels
 };
 /**
 * Creates a Web Standard Request handler for Hot Updater API
-* This handler is framework-agnostic and works with any framework
-* that supports Web Standard Request/Response (Hono, Elysia, etc.)
+* This handler is framework-agnostic and works with any runtime that
+* supports standard Request/Response objects.
 */
 function createHandler(api, options = {}) {
 	const basePath = options.basePath ?? "/api";
-	const router = (0, rou3.createRouter)();
-	(0, rou3.addRoute)(router, "GET", "/version", "version");
-	(0, rou3.addRoute)(router, "GET", "/fingerprint/:platform/:fingerprintHash/:channel/:minBundleId/:bundleId", "fingerprintUpdate");
-	(0, rou3.addRoute)(router, "GET", "/app-version/:platform/:appVersion/:channel/:minBundleId/:bundleId", "appVersionUpdate");
-	(0, rou3.addRoute)(router, "GET", "/api/bundles/channels", "getChannels");
-	(0, rou3.addRoute)(router, "GET", "/api/bundles/:id", "getBundle");
-	(0, rou3.addRoute)(router, "GET", "/api/bundles", "getBundles");
-	(0, rou3.addRoute)(router, "POST", "/api/bundles", "createBundles");
-	(0, rou3.addRoute)(router, "DELETE", "/api/bundles/:id", "deleteBundle");
-	return async (request) => {
+	const updateCheckEnabled = options.routes?.updateCheck ?? true;
+	const bundlesEnabled = options.routes?.bundles ?? true;
+	const router = require_internalRouter.createRouter();
+	if (updateCheckEnabled) {
+		require_internalRouter.addRoute(router, "GET", "/fingerprint/:platform/:fingerprintHash/:channel/:minBundleId/:bundleId", "fingerprintUpdateWithCohort");
+		require_internalRouter.addRoute(router, "GET", "/fingerprint/:platform/:fingerprintHash/:channel/:minBundleId/:bundleId/:cohort", "fingerprintUpdateWithCohort");
+		require_internalRouter.addRoute(router, "GET", "/app-version/:platform/:appVersion/:channel/:minBundleId/:bundleId", "appVersionUpdateWithCohort");
+		require_internalRouter.addRoute(router, "GET", "/app-version/:platform/:appVersion/:channel/:minBundleId/:bundleId/:cohort", "appVersionUpdateWithCohort");
+	}
+	if (bundlesEnabled) {
+		require_internalRouter.addRoute(router, "GET", "/version", "version");
+		require_internalRouter.addRoute(router, "GET", "/api/bundles/channels", "getChannels");
+		require_internalRouter.addRoute(router, "GET", "/api/bundles/:id", "getBundle");
+		require_internalRouter.addRoute(router, "GET", "/api/bundles", "getBundles");
+		require_internalRouter.addRoute(router, "POST", "/api/bundles", "createBundles");
+		require_internalRouter.addRoute(router, "PATCH", "/api/bundles/:id", "updateBundle");
+		require_internalRouter.addRoute(router, "DELETE", "/api/bundles/:id", "deleteBundle");
+	}
+	return async (request, context) => {
 		try {
 			const path = new URL(request.url).pathname;
 			const method = request.method;
-			const match = (0, rou3.findRoute)(router, method, path.startsWith(basePath) ? path.slice(basePath.length) : path);
+			const match = require_internalRouter.findRoute(router, method, path.startsWith(basePath) ? path.slice(basePath.length) : path);
 			if (!match) return new Response(JSON.stringify({ error: "Not found" }), {
 				status: 404,
 				headers: { "Content-Type": "application/json" }
@@ -130,8 +196,12 @@ function createHandler(api, options = {}) {
 				status: 500,
 				headers: { "Content-Type": "application/json" }
 			});
-			return await handler(match.params || {}, request, api);
+			return await handler(match.params || {}, request, api, context);
 		} catch (error) {
+			if (error instanceof HandlerBadRequestError) return new Response(JSON.stringify({ error: error.message }), {
+				status: 400,
+				headers: { "Content-Type": "application/json" }
+			});
 			console.error("Hot Updater handler error:", error);
 			return new Response(JSON.stringify({
 				error: "Internal server error",
@@ -143,6 +213,5 @@ function createHandler(api, options = {}) {
 		}
 	};
 }
-
 //#endregion
-exports.createHandler = createHandler;
+exports.createHandler = createHandler;

package/dist/handler.d.cts

@@ -1,24 +1,19 @@
 import { PaginationInfo } from "./types/index.cjs";
+import { DatabaseBundleQueryOptions, HotUpdaterContext } from "@hot-updater/plugin-core";
 import { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, FingerprintGetBundlesArgs } from "@hot-updater/core";
 
 //#region src/handler.d.ts
-interface HandlerAPI {
-  getAppUpdateInfo: (args: AppVersionGetBundlesArgs | FingerprintGetBundlesArgs) => Promise<AppUpdateInfo | null>;
-  getBundleById: (id: string) => Promise<Bundle | null>;
-  getBundles: (options: {
-    where?: {
-      channel?: string;
-      platform?: string;
-    };
-    limit: number;
-    offset: number;
-  }) => Promise<{
+interface HandlerAPI<TContext = unknown> {
+  getAppUpdateInfo: (args: AppVersionGetBundlesArgs | FingerprintGetBundlesArgs, context?: HotUpdaterContext<TContext>) => Promise<AppUpdateInfo | null>;
+  getBundleById: (id: string, context?: HotUpdaterContext<TContext>) => Promise<Bundle | null>;
+  getBundles: (options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>) => Promise<{
     data: Bundle[];
     pagination: PaginationInfo;
   }>;
-  insertBundle: (bundle: Bundle) => Promise<void>;
-  deleteBundleById: (bundleId: string) => Promise<void>;
-  getChannels: () => Promise<string[]>;
+  insertBundle: (bundle: Bundle, context?: HotUpdaterContext<TContext>) => Promise<void>;
+  updateBundleById: (bundleId: string, bundle: Partial<Bundle>, context?: HotUpdaterContext<TContext>) => Promise<void>;
+  deleteBundleById: (bundleId: string, context?: HotUpdaterContext<TContext>) => Promise<void>;
+  getChannels: (context?: HotUpdaterContext<TContext>) => Promise<string[]>;
 }
 interface HandlerOptions {
   /**
@@ -26,12 +21,27 @@ interface HandlerOptions {
    * @default "/api"
    */
   basePath?: string;
+  routes?: HandlerRoutes;
+}
+interface HandlerRoutes {
+  /**
+   * Controls whether update-check routes are mounted.
+   * @default true
+   */
+  updateCheck?: boolean;
+  /**
+   * Controls whether bundle management routes are mounted.
+   * This includes `/version` and `/api/bundles*`, which are used by the
+   * CLI `standaloneRepository` plugin.
+   * @default true
+   */
+  bundles?: boolean;
 }
 /**
  * Creates a Web Standard Request handler for Hot Updater API
- * This handler is framework-agnostic and works with any framework
- * that supports Web Standard Request/Response (Hono, Elysia, etc.)
+ * This handler is framework-agnostic and works with any runtime that
+ * supports standard Request/Response objects.
  */
-declare function createHandler(api: HandlerAPI, options?: HandlerOptions): (request: Request) => Promise<Response>;
+declare function createHandler<TContext = unknown>(api: HandlerAPI<TContext>, options?: HandlerOptions): (request: Request, context?: HotUpdaterContext<TContext>) => Promise<Response>;
 //#endregion
-export { HandlerAPI, HandlerOptions, createHandler };
+export { HandlerAPI, HandlerOptions, HandlerRoutes, createHandler };

package/dist/handler.d.mts

@@ -0,0 +1,47 @@
+import { PaginationInfo } from "./types/index.mjs";
+import { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, FingerprintGetBundlesArgs } from "@hot-updater/core";
+import { DatabaseBundleQueryOptions, HotUpdaterContext } from "@hot-updater/plugin-core";
+
+//#region src/handler.d.ts
+interface HandlerAPI<TContext = unknown> {
+  getAppUpdateInfo: (args: AppVersionGetBundlesArgs | FingerprintGetBundlesArgs, context?: HotUpdaterContext<TContext>) => Promise<AppUpdateInfo | null>;
+  getBundleById: (id: string, context?: HotUpdaterContext<TContext>) => Promise<Bundle | null>;
+  getBundles: (options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>) => Promise<{
+    data: Bundle[];
+    pagination: PaginationInfo;
+  }>;
+  insertBundle: (bundle: Bundle, context?: HotUpdaterContext<TContext>) => Promise<void>;
+  updateBundleById: (bundleId: string, bundle: Partial<Bundle>, context?: HotUpdaterContext<TContext>) => Promise<void>;
+  deleteBundleById: (bundleId: string, context?: HotUpdaterContext<TContext>) => Promise<void>;
+  getChannels: (context?: HotUpdaterContext<TContext>) => Promise<string[]>;
+}
+interface HandlerOptions {
+  /**
+   * Base path for all routes
+   * @default "/api"
+   */
+  basePath?: string;
+  routes?: HandlerRoutes;
+}
+interface HandlerRoutes {
+  /**
+   * Controls whether update-check routes are mounted.
+   * @default true
+   */
+  updateCheck?: boolean;
+  /**
+   * Controls whether bundle management routes are mounted.
+   * This includes `/version` and `/api/bundles*`, which are used by the
+   * CLI `standaloneRepository` plugin.
+   * @default true
+   */
+  bundles?: boolean;
+}
+/**
+ * Creates a Web Standard Request handler for Hot Updater API
+ * This handler is framework-agnostic and works with any runtime that
+ * supports standard Request/Response objects.
+ */
+declare function createHandler<TContext = unknown>(api: HandlerAPI<TContext>, options?: HandlerOptions): (request: Request, context?: HotUpdaterContext<TContext>) => Promise<Response>;
+//#endregion
+export { HandlerAPI, HandlerOptions, HandlerRoutes, createHandler };