@hot-updater/plugin-remote-config 0.0.0-stage → 1.0.0-rc.41

package/dist/server/api.mjs

@@ -0,0 +1,174 @@
+import { EMPTY_REMOTE_CONFIG_TEMPLATE, resolveRemoteConfigValues, validateRemoteConfigTemplate } from "./template.mjs";
+import { DatabaseConstraintError } from "@hot-updater/plugin-core";
+//#region src/server/api.ts
+const ACTIVE_ID = "active";
+/** How long a server answers fetches from the active template it read last. */
+const ACTIVE_CACHE_TTL_MS = 5e3;
+const MAX_DESCRIPTION_LENGTH = 256;
+const MAX_VERSIONS_PAGE = 100;
+/**
+* An argument the API refuses, such as a negative `baseVersion`; the admin
+* routes answer it with `400`.
+*/
+var RemoteConfigInputError = class extends TypeError {
+	name = "RemoteConfigInputError";
+};
+const normalizeDescription = (description) => {
+	if (description === void 0 || description === null) return null;
+	if (typeof description !== "string") throw new RemoteConfigInputError("A version description is text.");
+	const trimmed = description.trim();
+	if (trimmed.length > MAX_DESCRIPTION_LENGTH) throw new RemoteConfigInputError(`A version description holds up to ${MAX_DESCRIPTION_LENGTH} characters.`);
+	return trimmed.length === 0 ? null : trimmed;
+};
+const requireVersionNumber = (value, name) => {
+	if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) throw new RemoteConfigInputError(`${name} must be a non-negative integer.`);
+	return value;
+};
+/** A template as its `json` column stores it; validation made it plain JSON. */
+const toColumn = (template) => template;
+const fromColumn = (value) => value;
+const toVersion = (row) => Object.freeze({
+	version: row.version,
+	description: row.description,
+	updateType: row.update_type === "ROLLBACK" ? "ROLLBACK" : "PUBLISH",
+	rollbackSource: row.rollback_source,
+	createdAtMs: row.created_at_ms
+});
+/** Remote Config's API over its tables. */
+const createRemoteConfigApi = ({ db, now }) => {
+	let cached = null;
+	let loading = null;
+	let generation = 0;
+	const readActive = async () => {
+		const row = await db.findOne("remote_config_active", { id: ACTIVE_ID });
+		return row === null ? {
+			version: 0,
+			template: EMPTY_REMOTE_CONFIG_TEMPLATE,
+			updatedAtMs: null
+		} : {
+			version: row.version,
+			template: fromColumn(row.template),
+			updatedAtMs: row.updated_at_ms
+		};
+	};
+	/** The active template for fetches: one read per server every few seconds at most. */
+	const servedActive = () => {
+		if (cached !== null && cached.expiresAt > now()) return Promise.resolve(cached.active);
+		if (loading !== null) return loading;
+		const started = generation;
+		const read = readActive().then((active) => {
+			if (generation === started) cached = {
+				active,
+				expiresAt: now() + ACTIVE_CACHE_TTL_MS
+			};
+			return active;
+		}).finally(() => {
+			if (loading === read) loading = null;
+		});
+		loading = read;
+		return read;
+	};
+	const commit = async (input) => {
+		const attempt = () => db.transaction(async (tx) => {
+			const active = await tx.findOne("remote_config_active", { id: ACTIVE_ID });
+			const currentVersion = active?.version ?? 0;
+			if (currentVersion !== input.baseVersion) return {
+				status: "conflict",
+				currentVersion
+			};
+			const version = currentVersion + 1;
+			const at = now();
+			const row = {
+				version,
+				template: toColumn(input.template),
+				description: input.description,
+				update_type: input.rollbackSource === null ? "PUBLISH" : "ROLLBACK",
+				rollback_source: input.rollbackSource,
+				created_at_ms: at
+			};
+			tx.create("remote_config_versions", row);
+			if (active === null) tx.create("remote_config_active", {
+				id: ACTIVE_ID,
+				version,
+				template: toColumn(input.template),
+				updated_at_ms: at
+			});
+			else tx.update("remote_config_active", active, {
+				version,
+				template: toColumn(input.template),
+				updated_at_ms: at
+			});
+			return {
+				status: "published",
+				version: toVersion(row)
+			};
+		});
+		try {
+			const result = await attempt();
+			if (result.status === "published") {
+				generation += 1;
+				cached = null;
+				loading = null;
+			}
+			return result;
+		} catch (error) {
+			if (error instanceof DatabaseConstraintError && (error.reason === "exists" || error.reason === "unique")) return {
+				status: "conflict",
+				currentVersion: (await readActive()).version
+			};
+			throw error;
+		}
+	};
+	return Object.freeze({
+		getActive: readActive,
+		publish: async ({ template, baseVersion, description }) => commit({
+			template: validateRemoteConfigTemplate(template),
+			baseVersion: requireVersionNumber(baseVersion, "baseVersion"),
+			description: normalizeDescription(description),
+			rollbackSource: null
+		}),
+		rollback: async ({ version, baseVersion, description }) => {
+			const source = await db.findOne("remote_config_versions", { version: requireVersionNumber(version, "version") });
+			if (source === null) return { status: "not_found" };
+			return commit({
+				template: fromColumn(source.template),
+				baseVersion: requireVersionNumber(baseVersion, "baseVersion"),
+				description: normalizeDescription(description) ?? `Rollback to version ${source.version}`,
+				rollbackSource: source.version
+			});
+		},
+		listVersions: async ({ limit = 20, cursor } = {}) => {
+			if (!Number.isSafeInteger(limit) || limit < 1 || limit > MAX_VERSIONS_PAGE) throw new RemoteConfigInputError(`limit must be an integer from 1 to ${MAX_VERSIONS_PAGE}.`);
+			const page = await db.findMany("remote_config_versions", {
+				index: "byVersion",
+				where: {},
+				order: "desc",
+				limit,
+				...cursor === void 0 ? {} : { cursor }
+			});
+			return Object.freeze({
+				versions: Object.freeze(page.rows.map(toVersion)),
+				...page.next === void 0 ? {} : { next: page.next }
+			});
+		},
+		getVersion: async (version) => {
+			const row = await db.findOne("remote_config_versions", { version: requireVersionNumber(version, "version") });
+			return row === null ? null : Object.freeze({
+				...toVersion(row),
+				template: fromColumn(row.template)
+			});
+		},
+		resolve: async (context) => {
+			const active = await servedActive();
+			return {
+				version: active.version,
+				values: resolveRemoteConfigValues(active.template, {
+					...context,
+					now: context.now ?? now()
+				})
+			};
+		}
+	});
+};
+//#endregion
+export { RemoteConfigInputError, createRemoteConfigApi };

package/dist/server/index.cjs

@@ -0,0 +1,48 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_template = require("./template.cjs");
+const require_api = require("./api.cjs");
+const require_official = require("./official.cjs");
+const require_routes = require("./routes.cjs");
+const require_schema = require("./schema.cjs");
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+//#region src/server/index.ts
+/**
+* Remote Config: parameters whose values the server picks per device by
+* conditions, published as versioned templates. Devices fetch their values
+* from `GET /remote-config` with the `remoteConfig()` client plugin; the
+* Console and `hotUpdater.api.remoteConfig` edit, publish, and roll back
+* templates.
+*/
+const remoteConfig = () => {
+	const plugin = (0, _hot_updater_plugin_core.definePlugin)({
+		id: "remoteConfig",
+		namespace: false,
+		schemaVersion: "1.0.0",
+		schema: require_schema.remoteConfigSchema,
+		init: ({ db, now }) => {
+			const api = require_api.createRemoteConfigApi({
+				db,
+				now
+			});
+			return {
+				api,
+				endpoints: require_routes.createRemoteConfigEndpoints(api)
+			};
+		}
+	});
+	return require_official.markOfficial(plugin);
+};
+//#endregion
+exports.EMPTY_REMOTE_CONFIG_TEMPLATE = require_template.EMPTY_REMOTE_CONFIG_TEMPLATE;
+exports.REMOTE_CONFIG_MAX_CONDITIONS = require_template.REMOTE_CONFIG_MAX_CONDITIONS;
+exports.REMOTE_CONFIG_MAX_PARAMETERS = require_template.REMOTE_CONFIG_MAX_PARAMETERS;
+exports.REMOTE_CONFIG_MAX_TEMPLATE_LENGTH = require_template.REMOTE_CONFIG_MAX_TEMPLATE_LENGTH;
+exports.RemoteConfigInputError = require_api.RemoteConfigInputError;
+exports.RemoteConfigValidationError = require_template.RemoteConfigValidationError;
+exports.evaluateRemoteConfig = require_template.evaluateRemoteConfig;
+exports.matchesRemoteConfigCondition = require_template.matchesRemoteConfigCondition;
+exports.matchesRemoteConfigRule = require_template.matchesRemoteConfigRule;
+exports.remoteConfig = remoteConfig;
+exports.remoteConfigSchema = require_schema.remoteConfigSchema;
+exports.resolveRemoteConfigValues = require_template.resolveRemoteConfigValues;
+exports.validateRemoteConfigTemplate = require_template.validateRemoteConfigTemplate;

package/dist/server/index.d.cts

@@ -0,0 +1,63 @@
+import { RemoteConfigDeviceContext, RemoteConfigFetchResponse } from "../shared/wire.cjs";
+import { RemoteConfigSchema, remoteConfigSchema } from "./schema.cjs";
+import { EMPTY_REMOTE_CONFIG_TEMPLATE, REMOTE_CONFIG_MAX_CONDITIONS, REMOTE_CONFIG_MAX_PARAMETERS, REMOTE_CONFIG_MAX_TEMPLATE_LENGTH, RemoteConfigCondition, RemoteConfigEvaluatedParameter, RemoteConfigEvaluationContext, RemoteConfigParameter, RemoteConfigParameterValue, RemoteConfigRule, RemoteConfigRuleType, RemoteConfigTemplate, RemoteConfigTemplateIssue, RemoteConfigValidationError, RemoteConfigValueType, evaluateRemoteConfig, matchesRemoteConfigCondition, matchesRemoteConfigRule, resolveRemoteConfigValues, validateRemoteConfigTemplate } from "./template.cjs";
+import { RemoteConfigActive, RemoteConfigApi, RemoteConfigInputError, RemoteConfigPublishResult, RemoteConfigVersion, RemoteConfigVersionDetail, RemoteConfigVersionsPage } from "./api.cjs";
+//#region src/server/index.d.ts
+/**
+ * Remote Config: parameters whose values the server picks per device by
+ * conditions, published as versioned templates. Devices fetch their values
+ * from `GET /remote-config` with the `remoteConfig()` client plugin; the
+ * Console and `hotUpdater.api.remoteConfig` edit, publish, and roll back
+ * templates.
+ */
+declare const remoteConfig: () => import("@hot-updater/plugin-core").HotUpdaterPlugin<"remoteConfig", {
+  readonly remote_config_active: import("@hot-updater/plugin-core").TableDefinition<{
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly version: {
+      readonly type: "integer";
+    };
+    readonly template: {
+      readonly type: "json";
+    };
+    readonly updated_at_ms: {
+      readonly type: "integer";
+    };
+  }, {}, {}, readonly ["id"]>;
+  readonly remote_config_versions: import("@hot-updater/plugin-core").TableDefinition<{
+    readonly version: {
+      readonly type: "integer";
+    };
+    readonly template: {
+      readonly type: "json";
+    };
+    readonly description: {
+      readonly type: "string";
+      readonly maxLength: 256;
+      readonly required: false;
+    };
+    readonly update_type: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly rollback_source: {
+      readonly type: "integer";
+      readonly required: false;
+    };
+    readonly created_at_ms: {
+      readonly type: "integer";
+    };
+  }, {}, {
+    readonly byVersion: {
+      readonly eq: readonly [];
+      readonly sort: readonly ["version"];
+    };
+  }, readonly ["version"]>;
+}, {
+  api: RemoteConfigApi;
+  endpoints: readonly import("@hot-updater/plugin-core").PluginEndpoint[];
+}, {}>;
+//#endregion
+export { EMPTY_REMOTE_CONFIG_TEMPLATE, REMOTE_CONFIG_MAX_CONDITIONS, REMOTE_CONFIG_MAX_PARAMETERS, REMOTE_CONFIG_MAX_TEMPLATE_LENGTH, type RemoteConfigActive, type RemoteConfigApi, type RemoteConfigCondition, type RemoteConfigDeviceContext, type RemoteConfigEvaluatedParameter, type RemoteConfigEvaluationContext, type RemoteConfigFetchResponse, RemoteConfigInputError, type RemoteConfigParameter, type RemoteConfigParameterValue, type RemoteConfigPublishResult, type RemoteConfigRule, type RemoteConfigRuleType, type RemoteConfigSchema, type RemoteConfigTemplate, type RemoteConfigTemplateIssue, RemoteConfigValidationError, type RemoteConfigValueType, type RemoteConfigVersion, type RemoteConfigVersionDetail, type RemoteConfigVersionsPage, evaluateRemoteConfig, matchesRemoteConfigCondition, matchesRemoteConfigRule, remoteConfig, remoteConfigSchema, resolveRemoteConfigValues, validateRemoteConfigTemplate };

package/dist/server/index.d.mts

@@ -0,0 +1,63 @@
+import { RemoteConfigDeviceContext, RemoteConfigFetchResponse } from "../shared/wire.mjs";
+import { RemoteConfigSchema, remoteConfigSchema } from "./schema.mjs";
+import { EMPTY_REMOTE_CONFIG_TEMPLATE, REMOTE_CONFIG_MAX_CONDITIONS, REMOTE_CONFIG_MAX_PARAMETERS, REMOTE_CONFIG_MAX_TEMPLATE_LENGTH, RemoteConfigCondition, RemoteConfigEvaluatedParameter, RemoteConfigEvaluationContext, RemoteConfigParameter, RemoteConfigParameterValue, RemoteConfigRule, RemoteConfigRuleType, RemoteConfigTemplate, RemoteConfigTemplateIssue, RemoteConfigValidationError, RemoteConfigValueType, evaluateRemoteConfig, matchesRemoteConfigCondition, matchesRemoteConfigRule, resolveRemoteConfigValues, validateRemoteConfigTemplate } from "./template.mjs";
+import { RemoteConfigActive, RemoteConfigApi, RemoteConfigInputError, RemoteConfigPublishResult, RemoteConfigVersion, RemoteConfigVersionDetail, RemoteConfigVersionsPage } from "./api.mjs";
+//#region src/server/index.d.ts
+/**
+ * Remote Config: parameters whose values the server picks per device by
+ * conditions, published as versioned templates. Devices fetch their values
+ * from `GET /remote-config` with the `remoteConfig()` client plugin; the
+ * Console and `hotUpdater.api.remoteConfig` edit, publish, and roll back
+ * templates.
+ */
+declare const remoteConfig: () => import("@hot-updater/plugin-core").HotUpdaterPlugin<"remoteConfig", {
+  readonly remote_config_active: import("@hot-updater/plugin-core").TableDefinition<{
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly version: {
+      readonly type: "integer";
+    };
+    readonly template: {
+      readonly type: "json";
+    };
+    readonly updated_at_ms: {
+      readonly type: "integer";
+    };
+  }, {}, {}, readonly ["id"]>;
+  readonly remote_config_versions: import("@hot-updater/plugin-core").TableDefinition<{
+    readonly version: {
+      readonly type: "integer";
+    };
+    readonly template: {
+      readonly type: "json";
+    };
+    readonly description: {
+      readonly type: "string";
+      readonly maxLength: 256;
+      readonly required: false;
+    };
+    readonly update_type: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly rollback_source: {
+      readonly type: "integer";
+      readonly required: false;
+    };
+    readonly created_at_ms: {
+      readonly type: "integer";
+    };
+  }, {}, {
+    readonly byVersion: {
+      readonly eq: readonly [];
+      readonly sort: readonly ["version"];
+    };
+  }, readonly ["version"]>;
+}, {
+  api: RemoteConfigApi;
+  endpoints: readonly import("@hot-updater/plugin-core").PluginEndpoint[];
+}, {}>;
+//#endregion
+export { EMPTY_REMOTE_CONFIG_TEMPLATE, REMOTE_CONFIG_MAX_CONDITIONS, REMOTE_CONFIG_MAX_PARAMETERS, REMOTE_CONFIG_MAX_TEMPLATE_LENGTH, type RemoteConfigActive, type RemoteConfigApi, type RemoteConfigCondition, type RemoteConfigDeviceContext, type RemoteConfigEvaluatedParameter, type RemoteConfigEvaluationContext, type RemoteConfigFetchResponse, RemoteConfigInputError, type RemoteConfigParameter, type RemoteConfigParameterValue, type RemoteConfigPublishResult, type RemoteConfigRule, type RemoteConfigRuleType, type RemoteConfigSchema, type RemoteConfigTemplate, type RemoteConfigTemplateIssue, RemoteConfigValidationError, type RemoteConfigValueType, type RemoteConfigVersion, type RemoteConfigVersionDetail, type RemoteConfigVersionsPage, evaluateRemoteConfig, matchesRemoteConfigCondition, matchesRemoteConfigRule, remoteConfig, remoteConfigSchema, resolveRemoteConfigValues, validateRemoteConfigTemplate };

package/dist/server/index.mjs

@@ -0,0 +1,35 @@
+import { EMPTY_REMOTE_CONFIG_TEMPLATE, REMOTE_CONFIG_MAX_CONDITIONS, REMOTE_CONFIG_MAX_PARAMETERS, REMOTE_CONFIG_MAX_TEMPLATE_LENGTH, RemoteConfigValidationError, evaluateRemoteConfig, matchesRemoteConfigCondition, matchesRemoteConfigRule, resolveRemoteConfigValues, validateRemoteConfigTemplate } from "./template.mjs";
+import { RemoteConfigInputError, createRemoteConfigApi } from "./api.mjs";
+import { markOfficial } from "./official.mjs";
+import { createRemoteConfigEndpoints } from "./routes.mjs";
+import { remoteConfigSchema } from "./schema.mjs";
+import { definePlugin } from "@hot-updater/plugin-core";
+//#region src/server/index.ts
+/**
+* Remote Config: parameters whose values the server picks per device by
+* conditions, published as versioned templates. Devices fetch their values
+* from `GET /remote-config` with the `remoteConfig()` client plugin; the
+* Console and `hotUpdater.api.remoteConfig` edit, publish, and roll back
+* templates.
+*/
+const remoteConfig = () => {
+	const plugin = definePlugin({
+		id: "remoteConfig",
+		namespace: false,
+		schemaVersion: "1.0.0",
+		schema: remoteConfigSchema,
+		init: ({ db, now }) => {
+			const api = createRemoteConfigApi({
+				db,
+				now
+			});
+			return {
+				api,
+				endpoints: createRemoteConfigEndpoints(api)
+			};
+		}
+	});
+	return markOfficial(plugin);
+};
+//#endregion
+export { EMPTY_REMOTE_CONFIG_TEMPLATE, REMOTE_CONFIG_MAX_CONDITIONS, REMOTE_CONFIG_MAX_PARAMETERS, REMOTE_CONFIG_MAX_TEMPLATE_LENGTH, RemoteConfigInputError, RemoteConfigValidationError, evaluateRemoteConfig, matchesRemoteConfigCondition, matchesRemoteConfigRule, remoteConfig, remoteConfigSchema, resolveRemoteConfigValues, validateRemoteConfigTemplate };

package/dist/server/official.cjs

@@ -0,0 +1,12 @@
+//#region src/server/official.ts
+/**
+* The brand of Hot Updater's own plugins, a registered symbol that
+* `@hot-updater/server` reads to reserve the id "remoteConfig" for this plugin.
+* Each official plugin package keeps this copy, so none imports another's
+* internals for it.
+*/
+const OFFICIAL = Symbol.for("@hot-updater/server/official-plugin");
+/** Marks a plugin one of Hot Updater's own factories made. */
+const markOfficial = (plugin) => Object.defineProperty(plugin, OFFICIAL, { value: true });
+//#endregion
+exports.markOfficial = markOfficial;

package/dist/server/official.mjs

@@ -0,0 +1,12 @@
+//#region src/server/official.ts
+/**
+* The brand of Hot Updater's own plugins, a registered symbol that
+* `@hot-updater/server` reads to reserve the id "remoteConfig" for this plugin.
+* Each official plugin package keeps this copy, so none imports another's
+* internals for it.
+*/
+const OFFICIAL = Symbol.for("@hot-updater/server/official-plugin");
+/** Marks a plugin one of Hot Updater's own factories made. */
+const markOfficial = (plugin) => Object.defineProperty(plugin, OFFICIAL, { value: true });
+//#endregion
+export { markOfficial };

package/dist/server/routes.cjs

@@ -0,0 +1,157 @@
+const require_template = require("./template.cjs");
+const require_api = require("./api.cjs");
+const require_wire = require("../shared/wire.cjs");
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+//#region src/server/routes.ts
+/** Seconds a client waits before it resends a request the busy database refused. */
+const RETRY_AFTER_SECONDS = 5;
+/** A shared cache keeps a device's values five seconds, as it keeps a Release Catalog. */
+const FETCH_CACHE_CONTROL = "public, max-age=0, s-maxage=5";
+const MAX_CONTEXT_LENGTH = 128;
+var BadRequestError = class extends Error {};
+const json = (body, status, headers = {}) => Response.json(body, {
+	headers: {
+		"cache-control": "private, no-store",
+		...headers
+	},
+	status
+});
+const run = async (operation) => {
+	try {
+		return await operation();
+	} catch (error) {
+		if (error instanceof require_template.RemoteConfigValidationError) return json({
+			error: error.message,
+			issues: error.issues
+		}, 400);
+		if (error instanceof BadRequestError || error instanceof require_api.RemoteConfigInputError || error instanceof _hot_updater_plugin_core.DatabaseCursorError) return json({ error: error.message }, 400);
+		if ((0, _hot_updater_plugin_core.isDatabaseBusyError)(error)) {
+			console.warn("[hot-updater] Remote Config answered 503: the database is busy.", error);
+			return json({ error: "Service unavailable" }, 503, { "retry-after": String(RETRY_AFTER_SECONDS) });
+		}
+		throw error;
+	}
+};
+const readContext = (request) => {
+	const query = new URL(request.url).searchParams;
+	const read = (field) => {
+		const value = query.get(require_wire.REMOTE_CONFIG_QUERY[field]);
+		if (value === null || value.length === 0) return null;
+		if (value.length > MAX_CONTEXT_LENGTH) throw new BadRequestError(`${field} is too long.`);
+		return value;
+	};
+	const platform = read("platform");
+	if (platform !== null && platform !== "ios" && platform !== "android") throw new BadRequestError("platform must be \"ios\" or \"android\".");
+	return {
+		platform,
+		appVersion: read("appVersion"),
+		channel: read("channel"),
+		cohort: read("cohort"),
+		fingerprintHash: read("fingerprintHash")
+	};
+};
+const bodyHash = async (body) => {
+	const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(body));
+	return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+};
+const readJsonBody = async (request) => {
+	const body = await request.json().catch(() => null);
+	if (typeof body !== "object" || body === null || Array.isArray(body)) throw new BadRequestError("The request body must be a JSON object.");
+	return body;
+};
+const versionParam = (params) => {
+	const text = params.version ?? "";
+	if (!/^\d{1,15}$/u.test(text)) throw new BadRequestError("The version must be a positive integer.");
+	return Number(text);
+};
+const publishResponse = (result) => result.status === "published" ? json(result.version, 200) : json({
+	error: `Version ${result.currentVersion} was published since; reload the template and publish again.`,
+	currentVersion: result.currentVersion
+}, 409);
+/**
+* Remote Config's routes: the devices' `GET /remote-config` on
+* `handlers.client`, and template management on `handlers.admin`.
+*/
+const createRemoteConfigEndpoints = (api) => [
+	{
+		method: "GET",
+		path: `/${require_wire.REMOTE_CONFIG_PATH}`,
+		access: "client",
+		handler: (request) => run(async () => {
+			const body = JSON.stringify(await api.resolve(readContext(request)));
+			const etag = `"sha256:${await bodyHash(body)}"`;
+			const headers = {
+				"cache-control": FETCH_CACHE_CONTROL,
+				"content-type": "application/json",
+				etag,
+				vary: "Accept-Encoding"
+			};
+			if (request.headers.get("if-none-match") === etag) return new Response(null, {
+				headers,
+				status: 304
+			});
+			return new Response(body, {
+				headers,
+				status: 200
+			});
+		})
+	},
+	{
+		method: "GET",
+		path: `/${require_wire.REMOTE_CONFIG_PATH}/template`,
+		access: "admin",
+		handler: () => run(async () => json(await api.getActive(), 200))
+	},
+	{
+		method: "PUT",
+		path: `/${require_wire.REMOTE_CONFIG_PATH}/template`,
+		access: "admin",
+		handler: (request) => run(async () => {
+			const body = await readJsonBody(request);
+			return publishResponse(await api.publish({
+				template: body.template,
+				baseVersion: body.baseVersion,
+				...body.description === void 0 ? {} : { description: body.description }
+			}));
+		})
+	},
+	{
+		method: "GET",
+		path: `/${require_wire.REMOTE_CONFIG_PATH}/versions`,
+		access: "admin",
+		handler: (request) => run(async () => {
+			const query = new URL(request.url).searchParams;
+			const limit = query.get("limit");
+			const cursor = query.get("cursor");
+			return json(await api.listVersions({
+				...limit === null ? {} : { limit: Number(limit) },
+				...cursor === null ? {} : { cursor }
+			}), 200);
+		})
+	},
+	{
+		method: "GET",
+		path: `/${require_wire.REMOTE_CONFIG_PATH}/versions/:version`,
+		access: "admin",
+		handler: (_request, params) => run(async () => {
+			const version = await api.getVersion(versionParam(params));
+			return version === null ? json({ error: "Version not found" }, 404) : json(version, 200);
+		})
+	},
+	{
+		method: "POST",
+		path: `/${require_wire.REMOTE_CONFIG_PATH}/versions/:version/rollback`,
+		access: "admin",
+		handler: (request, params) => run(async () => {
+			const body = await readJsonBody(request);
+			const result = await api.rollback({
+				version: versionParam(params),
+				baseVersion: body.baseVersion,
+				...body.description === void 0 ? {} : { description: body.description }
+			});
+			return result.status === "not_found" ? json({ error: "Version not found" }, 404) : publishResponse(result);
+		})
+	}
+];
+//#endregion
+exports.createRemoteConfigEndpoints = createRemoteConfigEndpoints;