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

package/dist/handler.d.cts

@@ -1,49 +1,6 @@
-import { PaginatedResult } from "./types/index.cjs";
-import { AppUpdateAvailableInfo, AppVersionGetBundlesArgs, Bundle, FingerprintGetBundlesArgs } from "@hot-updater/core";
-import { DatabaseBundleQueryOptions, HotUpdaterContext } from "@hot-updater/plugin-core";
+import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.cjs";
 
 //#region src/handler.d.ts
-interface HandlerAPI<TContext = unknown> {
-  getAppUpdateInfo: (args: AppVersionGetBundlesArgs | FingerprintGetBundlesArgs, context?: HotUpdaterContext<TContext>) => Promise<AppUpdateAvailableInfo | null>;
-  getBundleById: (id: string, context?: HotUpdaterContext<TContext>) => Promise<Bundle | null>;
-  getBundles: (options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>) => Promise<PaginatedResult>;
-  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;
-  /**
-   * Route groups to mount. Omit this option to use the default route groups.
-   * When provided, both route groups must be specified explicitly.
-   * The `/version` endpoint is always mounted for diagnostics.
-   */
-  routes?: HandlerRoutes;
-}
-interface HandlerRoutes {
-  /**
-   * Controls whether update-check routes are mounted.
-   * Defaults to `true` only when `routes` is omitted.
-   */
-  updateCheck: boolean;
-  /**
-   * Controls whether bundle management routes are mounted.
-   * This includes `/api/bundles*`, which are used by the
-   * CLI `standaloneRepository` plugin.
-   * Defaults to `false` only when `routes` is omitted.
-   */
-  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>;
+declare function createHandlers(api: HandlerAPI): HotUpdaterHandlers;
 //#endregion
-export { HandlerAPI, HandlerOptions, HandlerRoutes, createHandler };
+export { createHandlers };

package/dist/handler.d.mts

@@ -1,49 +1,6 @@
-import { PaginatedResult } from "./types/index.mjs";
-import { DatabaseBundleQueryOptions, HotUpdaterContext } from "@hot-updater/plugin-core";
-import { AppUpdateAvailableInfo, AppVersionGetBundlesArgs, Bundle as Bundle$1, FingerprintGetBundlesArgs } from "@hot-updater/core";
+import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.mjs";
 
 //#region src/handler.d.ts
-interface HandlerAPI<TContext = unknown> {
-  getAppUpdateInfo: (args: AppVersionGetBundlesArgs | FingerprintGetBundlesArgs, context?: HotUpdaterContext<TContext>) => Promise<AppUpdateAvailableInfo | null>;
-  getBundleById: (id: string, context?: HotUpdaterContext<TContext>) => Promise<Bundle$1 | null>;
-  getBundles: (options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>) => Promise<PaginatedResult>;
-  insertBundle: (bundle: Bundle$1, context?: HotUpdaterContext<TContext>) => Promise<void>;
-  updateBundleById: (bundleId: string, bundle: Partial<Bundle$1>, 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;
-  /**
-   * Route groups to mount. Omit this option to use the default route groups.
-   * When provided, both route groups must be specified explicitly.
-   * The `/version` endpoint is always mounted for diagnostics.
-   */
-  routes?: HandlerRoutes;
-}
-interface HandlerRoutes {
-  /**
-   * Controls whether update-check routes are mounted.
-   * Defaults to `true` only when `routes` is omitted.
-   */
-  updateCheck: boolean;
-  /**
-   * Controls whether bundle management routes are mounted.
-   * This includes `/api/bundles*`, which are used by the
-   * CLI `standaloneRepository` plugin.
-   * Defaults to `false` only when `routes` is omitted.
-   */
-  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>;
+declare function createHandlers(api: HandlerAPI): HotUpdaterHandlers;
 //#endregion
-export { HandlerAPI, HandlerOptions, HandlerRoutes, createHandler };
+export { createHandlers };

package/dist/handler.mjs

@@ -1,293 +1,119 @@
+import { HandlerBadRequestError } from "./handlerErrors.mjs";
+import { createBundleRouteHandlers } from "./handlerBundleRoutes.mjs";
+import { createReleaseCatalogRouteHandlers } from "./handlerReleaseCatalogRoutes.mjs";
+import { createReleaseManagementRouteHandlers } from "./handlerReleaseManagementRoutes.mjs";
+import { createVersionRouteHandlers } from "./handlerVersionRoutes.mjs";
+import { createInsightsRouteHandlers, registerInsightsAdminRoutes, registerInsightsClientRoutes } from "./insights/routes.mjs";
 import { addRoute, createRouter, findRoute } from "./internalRouter.mjs";
-import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
-import { isGreaterOrEqual, normalize } from "verkit";
 //#region src/handler.ts
-var HandlerBadRequestError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "HandlerBadRequestError";
-	}
-};
-const SDK_VERSION_HEADER = "Hot-Updater-SDK-Version";
-const EXPLICIT_NO_UPDATE_MIN_SDK_VERSION = "0.31.0";
-const DEFAULT_BUNDLE_LIST_LIMIT = 50;
-const MAX_BUNDLE_LIST_LIMIT = 100;
-const supportsExplicitNoUpdateResponse = (request) => {
-	const sdkVersion = request.headers.get(SDK_VERSION_HEADER)?.trim();
-	if (!sdkVersion) return false;
-	const normalizedSdkVersion = normalize(sdkVersion);
-	return normalizedSdkVersion !== null && isGreaterOrEqual(normalizedSdkVersion, EXPLICIT_NO_UPDATE_MIN_SDK_VERSION);
-};
-const serializeUpdateInfo = (updateInfo, request) => {
-	if (updateInfo) return JSON.stringify(updateInfo);
-	if (supportsExplicitNoUpdateResponse(request)) return JSON.stringify({ status: "UP_TO_DATE" });
-	return JSON.stringify(null);
-};
-const handleVersion = async () => {
-	return new Response(JSON.stringify({ version: HOT_UPDATER_SERVER_VERSION }), {
-		status: 200,
-		headers: { "Content-Type": "application/json" }
+const withPrivateNoStore = (response) => {
+	const headers = new Headers(response.headers);
+	headers.set("cache-control", "private, no-store");
+	return new Response(response.body, {
+		headers,
+		status: response.status,
+		statusText: response.statusText
 	});
 };
-const decodeMaybe = (value) => {
-	if (value === void 0) return void 0;
+const errorResponse = (error, status) => Response.json({ error }, {
+	headers: { "cache-control": "private, no-store" },
+	status
+});
+const requiresApiKey = (handlerName) => handlerName === "appVersionReleaseCatalog" || handlerName === "fingerprintReleaseCatalog" || handlerName === "artifact" || handlerName === "appendBundleEvent";
+const createRequestHandler = ({ api, apiKeyAuth, privateResponses = false, routeHandlers, router }) => async (request) => {
 	try {
-		return decodeURIComponent(value);
-	} catch {
-		return value;
+		const match = findRoute(router, request.method, new URL(request.url).pathname);
+		if (!match) return errorResponse("Not found", 404);
+		if (apiKeyAuth !== void 0 && requiresApiKey(match.data)) {
+			let authenticated;
+			try {
+				authenticated = await apiKeyAuth.authenticate(request);
+			} catch {
+				return errorResponse("Service unavailable", 503);
+			}
+			if (!authenticated) return errorResponse("Unauthorized", 401);
+		}
+		const handler = routeHandlers[match.data];
+		if (!handler) return errorResponse("Handler not found", 500);
+		const response = await handler(match.params, request, api);
+		return privateResponses ? withPrivateNoStore(response) : response;
+	} catch (error) {
+		if (error instanceof HandlerBadRequestError) return errorResponse(error.message, 400);
+		console.error("Hot Updater handler error:", error);
+		return Response.json({ error: "Internal server error" }, {
+			headers: { "cache-control": "private, no-store" },
+			status: 500
+		});
 	}
 };
-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 parseBooleanSearchParam = (url, key) => {
-	const value = url.searchParams.get(key);
-	if (value === null) return;
-	if (value === "true") return true;
-	if (value === "false") return false;
-	throw new HandlerBadRequestError(`The '${key}' query parameter must be 'true' or 'false'.`);
-};
-const parseNullableStringSearchParam = (url, key) => {
-	const value = url.searchParams.get(key);
-	if (value === null) return;
-	return value === "null" ? null : value;
-};
-const parseStringArraySearchParam = (url, key) => {
-	const values = url.searchParams.getAll(key);
-	return values.length > 0 ? values : void 0;
-};
-const parsePositiveIntegerSearchParam = (url, key, defaultValue, maxValue) => {
-	const value = url.searchParams.get(key);
-	if (value === null) return defaultValue;
-	const parsed = Number(value);
-	if (!Number.isInteger(parsed) || parsed < 1 || parsed > maxValue) throw new HandlerBadRequestError(`The '${key}' query parameter must be a positive integer between 1 and ${maxValue}.`);
-	return parsed;
-};
-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,
-		fingerprintHash,
-		channel,
-		minBundleId,
-		bundleId,
-		cohort: decodeMaybe(params.cohort)
-	}, context);
-	return new Response(serializeUpdateInfo(updateInfo, request), {
-		status: 200,
-		headers: { "Content-Type": "application/json" }
-	});
-};
-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,
-		appVersion,
-		channel,
-		minBundleId,
-		bundleId,
-		cohort: decodeMaybe(params.cohort)
-	}, context);
-	return new Response(serializeUpdateInfo(updateInfo, request), {
-		status: 200,
-		headers: { "Content-Type": "application/json" }
-	});
-};
-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" }
-	});
-	return new Response(JSON.stringify(bundle), {
-		status: 200,
-		headers: { "Content-Type": "application/json" }
+const createDownloadStorageRouteHandler = (downloadStorageObject) => async (params) => {
+	const token = params.token;
+	const signature = params.signature;
+	if (!token || !signature) return errorResponse("Not found", 404);
+	const response = await downloadStorageObject(token, signature);
+	if (!response) return errorResponse("Not found", 404);
+	const headers = new Headers(response.headers);
+	if (!headers.has("cache-control")) headers.set("cache-control", "public, max-age=31536000, immutable");
+	return new Response(response.body, {
+		headers,
+		status: response.status,
+		statusText: response.statusText
 	});
 };
-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");
-	const limit = parsePositiveIntegerSearchParam(url, "limit", DEFAULT_BUNDLE_LIST_LIMIT, MAX_BUNDLE_LIST_LIMIT);
-	const pageParam = url.searchParams.get("page");
-	const offset = url.searchParams.get("offset");
-	const after = url.searchParams.get("after") ?? void 0;
-	const before = url.searchParams.get("before") ?? void 0;
-	const enabled = parseBooleanSearchParam(url, "enabled");
-	const targetAppVersion = parseNullableStringSearchParam(url, "targetAppVersion");
-	const targetAppVersionIn = parseStringArraySearchParam(url, "targetAppVersionIn");
-	const targetAppVersionNotNull = parseBooleanSearchParam(url, "targetAppVersionNotNull");
-	const fingerprintHash = parseNullableStringSearchParam(url, "fingerprintHash");
-	const idEq = url.searchParams.get("idEq") ?? void 0;
-	const idGt = url.searchParams.get("idGt") ?? void 0;
-	const idGte = url.searchParams.get("idGte") ?? void 0;
-	const idLt = url.searchParams.get("idLt") ?? void 0;
-	const idLte = url.searchParams.get("idLte") ?? void 0;
-	const idIn = parseStringArraySearchParam(url, "idIn");
-	const page = pageParam === null ? void 0 : Number.isInteger(Number(pageParam)) && Number(pageParam) > 0 ? Number(pageParam) : null;
-	if (offset !== null) throw new HandlerBadRequestError("The 'offset' query parameter has been removed. Use 'after' or 'before' cursor pagination instead.");
-	if (page === null) throw new HandlerBadRequestError("The 'page' query parameter must be a positive integer.");
-	if (platform !== null && !isPlatform(platform)) throw new HandlerBadRequestError(`Invalid platform: ${platform}. Expected 'ios' or 'android'.`);
-	const result = await api.getBundles({
-		where: {
-			...channel && { channel },
-			...platform && { platform },
-			...enabled !== void 0 && { enabled },
-			...idEq || idGt || idGte || idLt || idLte || idIn && idIn.length > 0 ? { id: {
-				...idEq && { eq: idEq },
-				...idGt && { gt: idGt },
-				...idGte && { gte: idGte },
-				...idLt && { lt: idLt },
-				...idLte && { lte: idLte },
-				...idIn && idIn.length > 0 && { in: idIn }
-			} } : {},
-			...targetAppVersion !== void 0 && { targetAppVersion },
-			...targetAppVersionIn && { targetAppVersionIn },
-			...targetAppVersionNotNull !== void 0 && { targetAppVersionNotNull },
-			...fingerprintHash !== void 0 && { fingerprintHash }
-		},
-		limit,
-		page,
-		cursor: after || before ? {
-			after,
-			before
-		} : void 0
-	}, context);
-	return new Response(JSON.stringify(result), {
-		status: 200,
-		headers: { "Content-Type": "application/json" }
-	});
-};
-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, context);
-	return new Response(JSON.stringify({ success: true }), {
-		status: 201,
-		headers: { "Content-Type": "application/json" }
-	});
-};
-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, context) => {
-	const response = { data: { channels: await api.getChannels(context) } };
-	return new Response(JSON.stringify(response), {
-		status: 200,
-		headers: { "Content-Type": "application/json" }
-	});
-};
-const routes = {
-	version: handleVersion,
-	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 runtime that
-* supports standard Request/Response objects.
-*/
-function createHandler(api, options = {}) {
-	const basePath = options.basePath ?? "/api";
-	const routeOptions = {
-		updateCheck: options.routes?.updateCheck ?? true,
-		bundles: options.routes?.bundles ?? false
-	};
-	const router = createRouter();
-	addRoute(router, "GET", "/version", "version");
-	if (routeOptions.updateCheck) {
-		addRoute(router, "GET", "/fingerprint/:platform/:fingerprintHash/:channel/:minBundleId/:bundleId", "fingerprintUpdateWithCohort");
-		addRoute(router, "GET", "/fingerprint/:platform/:fingerprintHash/:channel/:minBundleId/:bundleId/:cohort", "fingerprintUpdateWithCohort");
-		addRoute(router, "GET", "/app-version/:platform/:appVersion/:channel/:minBundleId/:bundleId", "appVersionUpdateWithCohort");
-		addRoute(router, "GET", "/app-version/:platform/:appVersion/:channel/:minBundleId/:bundleId/:cohort", "appVersionUpdateWithCohort");
-	}
-	if (routeOptions.bundles) {
-		addRoute(router, "GET", "/api/bundles/channels", "getChannels");
-		addRoute(router, "GET", "/api/bundles/:id", "getBundle");
-		addRoute(router, "GET", "/api/bundles", "getBundles");
-		addRoute(router, "POST", "/api/bundles", "createBundles");
-		addRoute(router, "PATCH", "/api/bundles/:id", "updateBundle");
-		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 = 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" }
-			});
-			const handler = routes[match.data];
-			if (!handler) return new Response(JSON.stringify({ error: "Handler not found" }), {
-				status: 500,
-				headers: { "Content-Type": "application/json" }
-			});
-			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",
-				message: error instanceof Error ? error.message : "Unknown error"
-			}), {
-				status: 500,
-				headers: { "Content-Type": "application/json" }
-			});
-		}
+function createHandlers(api) {
+	return createHotUpdaterHandlers(api);
+}
+function createHotUpdaterHandlers(api, insights, apiKeyAuth, downloadStorageObject) {
+	const routeHandlers = {
+		...createVersionRouteHandlers(),
+		...createReleaseCatalogRouteHandlers(apiKeyAuth?.headerName),
+		...createReleaseManagementRouteHandlers(),
+		...createBundleRouteHandlers(),
+		...insights === void 0 ? {} : createInsightsRouteHandlers(insights),
+		...downloadStorageObject === void 0 ? {} : { downloadStorageObject: createDownloadStorageRouteHandler(downloadStorageObject) }
 	};
+	const clientRouter = createRouter();
+	const addClientRoute = (method, path, handler) => addRoute(clientRouter, method, path, handler);
+	addClientRoute("GET", "/version", "version");
+	if (downloadStorageObject !== void 0) addClientRoute("GET", "/storage/:token/:signature", "downloadStorageObject");
+	addClientRoute("GET", "/release-catalogs/app-version/:platform/:channelKey/:appVersion", "appVersionReleaseCatalog");
+	addClientRoute("GET", "/release-catalogs/fingerprint/:platform/:channelKey/:fingerprintHash", "fingerprintReleaseCatalog");
+	addClientRoute("GET", "/artifacts/:targetBundleId/from/:currentBundleId", "artifact");
+	if (insights !== void 0) registerInsightsClientRoutes(addClientRoute);
+	const adminRouter = createRouter();
+	const addAdminRoute = (method, path, handler) => addRoute(adminRouter, method, path, handler);
+	addAdminRoute("GET", "/releases/:id", "getRelease");
+	addAdminRoute("GET", "/releases", "getReleases");
+	addAdminRoute("PATCH", "/releases/:id", "updateRelease");
+	addAdminRoute("POST", "/releases/:id/preflight", "preflightRelease");
+	addAdminRoute("DELETE", "/releases/:id", "deleteRelease");
+	addAdminRoute("GET", "/release-catalogs/:scopeKey", "getReleaseCatalogRow");
+	addAdminRoute("GET", "/release-catalogs", "getReleaseCatalogs");
+	addAdminRoute("POST", "/release-catalogs/:scopeKey/rebuild", "rebuildReleaseCatalog");
+	addAdminRoute("POST", "/database/commit", "commitDatabase");
+	addAdminRoute("GET", "/channels", "getChannels");
+	addAdminRoute("POST", "/channels", "createChannel");
+	addAdminRoute("DELETE", "/channels/:id", "deleteChannel");
+	addAdminRoute("GET", "/bundles/:id", "getBundle");
+	addAdminRoute("GET", "/bundles", "getBundles");
+	addAdminRoute("POST", "/bundles", "createBundles");
+	addAdminRoute("PATCH", "/bundles/:id", "updateBundle");
+	addAdminRoute("DELETE", "/bundles/:id", "deleteBundle");
+	if (insights !== void 0) registerInsightsAdminRoutes(addAdminRoute);
+	return Object.freeze({
+		client: createRequestHandler({
+			api,
+			apiKeyAuth,
+			routeHandlers,
+			router: clientRouter
+		}),
+		admin: createRequestHandler({
+			api,
+			privateResponses: true,
+			routeHandlers,
+			router: adminRouter
+		})
+	});
 }
 //#endregion
-export { createHandler };
+export { createHandlers, createHotUpdaterHandlers };

package/dist/handlerBundleRoutes.cjs

@@ -0,0 +1,155 @@
+const require_handlerErrors = require("./handlerErrors.cjs");
+const require_handlerParameters = require("./handlerParameters.cjs");
+//#region src/handlerBundleRoutes.ts
+const BUNDLE_LIST_BOUNDS = {
+	defaultValue: 50,
+	maxValue: 100
+};
+const isChannelText = (value) => {
+	if (typeof value !== "string" || value.length === 0) return false;
+	let codePoints = 0;
+	for (const _codePoint of value) {
+		codePoints += 1;
+		if (codePoints > 255) return false;
+	}
+	return true;
+};
+const requireChannelInsertInput = (value) => {
+	if (!value || typeof value !== "object" || Array.isArray(value) || !("row" in value) || !value.row || typeof value.row !== "object" || Array.isArray(value.row) || !("id" in value.row) || !isChannelText(value.row.id) || !("name" in value.row) || !isChannelText(value.row.name) || !("onConflict" in value) || value.onConflict !== "returnExisting") throw new require_handlerErrors.HandlerBadRequestError("Invalid Channel insert payload");
+	return {
+		row: {
+			id: value.row.id,
+			name: value.row.name
+		},
+		onConflict: value.onConflict
+	};
+};
+const requireBundlePatchPayload = (payload, bundleId) => {
+	if (!payload || typeof payload !== "object" || Array.isArray(payload)) throw new require_handlerErrors.HandlerBadRequestError("Invalid bundle payload");
+	const bundlePatch = payload;
+	if (bundlePatch.id !== void 0 && bundlePatch.id !== bundleId) throw new require_handlerErrors.HandlerBadRequestError("Bundle id mismatch");
+	const { id: _ignoredId, ...rest } = bundlePatch;
+	return rest;
+};
+const createBundleRouteHandlers = () => ({
+	getBundle: async (params, _request, api) => {
+		const bundle = await api.getBundleById(require_handlerParameters.requireRouteParam(params, "id"));
+		if (!bundle) return new Response(JSON.stringify({ error: "Bundle not found" }), {
+			status: 404,
+			headers: { "Content-Type": "application/json" }
+		});
+		return new Response(JSON.stringify(bundle), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+	},
+	getBundles: async (_params, request, api) => {
+		const url = new URL(request.url);
+		const platform = url.searchParams.get("platform");
+		const limit = require_handlerParameters.parsePositiveIntegerSearchParam(url, "limit", BUNDLE_LIST_BOUNDS);
+		const pageParam = url.searchParams.get("page");
+		const offset = url.searchParams.get("offset");
+		const after = url.searchParams.get("after") ?? void 0;
+		const before = url.searchParams.get("before") ?? void 0;
+		const orderDirection = url.searchParams.get("orderDirection");
+		const idEq = url.searchParams.get("idEq") ?? void 0;
+		const idGt = url.searchParams.get("idGt") ?? void 0;
+		const idGte = url.searchParams.get("idGte") ?? void 0;
+		const idLt = url.searchParams.get("idLt") ?? void 0;
+		const idLte = url.searchParams.get("idLte") ?? void 0;
+		const idIn = require_handlerParameters.parseStringArraySearchParam(url, "idIn");
+		const page = pageParam === null ? void 0 : Number.isSafeInteger(Number(pageParam)) && Number(pageParam) > 0 && Number.isSafeInteger((Number(pageParam) - 1) * limit) ? Number(pageParam) : null;
+		if (offset !== null) throw new require_handlerErrors.HandlerBadRequestError("The 'offset' query parameter has been removed. Use 'after' or 'before' cursor pagination instead.");
+		if (page === null) throw new require_handlerErrors.HandlerBadRequestError("The 'page' query parameter must be a positive integer.");
+		if (after !== void 0 && before !== void 0) throw new require_handlerErrors.HandlerBadRequestError("The 'after' and 'before' query parameters cannot be combined.");
+		if (page !== void 0 && (after !== void 0 || before !== void 0)) throw new require_handlerErrors.HandlerBadRequestError("The 'page' query parameter cannot be combined with 'after' or 'before'.");
+		if (platform !== null && !require_handlerParameters.isPlatform(platform)) throw new require_handlerErrors.HandlerBadRequestError(`Invalid platform: ${platform}. Expected 'ios' or 'android'.`);
+		if (orderDirection !== null && orderDirection !== "asc" && orderDirection !== "desc") throw new require_handlerErrors.HandlerBadRequestError("The 'orderDirection' query parameter must be 'asc' or 'desc'.");
+		const pagination = page === void 0 ? {
+			cursor: after !== void 0 ? { after } : before !== void 0 ? { before } : void 0,
+			page: void 0
+		} : {
+			cursor: void 0,
+			page
+		};
+		const result = await api.getBundles({
+			where: {
+				...platform && { platform },
+				...idEq || idGt || idGte || idLt || idLte || idIn?.length ? { id: {
+					...idEq && { eq: idEq },
+					...idGt && { gt: idGt },
+					...idGte && { gte: idGte },
+					...idLt && { lt: idLt },
+					...idLte && { lte: idLte },
+					...idIn?.length && { in: idIn }
+				} } : {}
+			},
+			limit,
+			...pagination,
+			...orderDirection && { orderBy: {
+				field: "id",
+				direction: orderDirection
+			} }
+		});
+		return new Response(JSON.stringify(result), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+	},
+	createBundles: async (_params, request, api) => {
+		const body = await request.json();
+		const bundles = Array.isArray(body) ? body : [body];
+		if (api.insertBundles) await api.insertBundles(bundles);
+		else {
+			if (bundles.length > 1) throw new require_handlerErrors.HandlerBadRequestError("This server does not support atomic bundle batches");
+			const bundle = bundles[0];
+			if (bundle !== void 0) await api.insertBundle(bundle);
+		}
+		return new Response(JSON.stringify({ success: true }), {
+			status: 201,
+			headers: { "Content-Type": "application/json" }
+		});
+	},
+	updateBundle: async (params, request, api) => {
+		const bundleId = require_handlerParameters.requireRouteParam(params, "id");
+		const body = await request.json();
+		const payload = Array.isArray(body) ? body[0] : body;
+		await api.updateBundleById(bundleId, requireBundlePatchPayload(payload, bundleId));
+		return new Response(JSON.stringify({ success: true }), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+	},
+	deleteBundle: async (params, _request, api) => {
+		await api.deleteBundleById(require_handlerParameters.requireRouteParam(params, "id"));
+		return new Response(JSON.stringify({ success: true }), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+	},
+	getChannels: async (_params, _request, api) => {
+		const response = { data: { channels: await api.getChannels() } };
+		return new Response(JSON.stringify(response), {
+			status: 200,
+			headers: { "Content-Type": "application/json" }
+		});
+	},
+	createChannel: async (_params, request, api) => {
+		const result = await api.insertChannel(requireChannelInsertInput(await request.json()));
+		return new Response(JSON.stringify({ data: result }), {
+			status: result.inserted ? 201 : 200,
+			headers: { "Content-Type": "application/json" }
+		});
+	},
+	deleteChannel: async (params, _request, api) => {
+		const result = await api.deleteChannel({ id: require_handlerParameters.decodeMaybe(require_handlerParameters.requireRouteParam(params, "id")) ?? "" });
+		if (result.deleted) return new Response(null, { status: 204 });
+		const status = result.reason === "not_found" ? 404 : 409;
+		return new Response(JSON.stringify({ data: result }), {
+			status,
+			headers: { "Content-Type": "application/json" }
+		});
+	}
+});
+//#endregion
+exports.createBundleRouteHandlers = createBundleRouteHandlers;