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

package/dist/server/api.d.cts

@@ -0,0 +1,85 @@
+import { RemoteConfigFetchResponse } from "../shared/wire.cjs";
+import { RemoteConfigEvaluationContext, RemoteConfigTemplate } from "./template.cjs";
+import "@hot-updater/plugin-core";
+//#region src/server/api.d.ts
+/** A published version's record, without its template. */
+interface RemoteConfigVersion {
+  readonly version: number;
+  readonly description: string | null;
+  /** `ROLLBACK` when the version copies `rollbackSource`. */
+  readonly updateType: "PUBLISH" | "ROLLBACK";
+  readonly rollbackSource: number | null;
+  readonly createdAtMs: number;
+}
+interface RemoteConfigVersionDetail extends RemoteConfigVersion {
+  readonly template: RemoteConfigTemplate;
+}
+/** The template devices receive now. */
+interface RemoteConfigActive {
+  /** 0, with an empty template, before the first publish. */
+  readonly version: number;
+  readonly template: RemoteConfigTemplate;
+  readonly updatedAtMs: number | null;
+}
+/**
+ * How a publish or a rollback ended: `conflict` when another publish moved
+ * the active version past `baseVersion` first, so a stale edit never
+ * replaces a newer template.
+ */
+type RemoteConfigPublishResult = {
+  readonly status: "published";
+  readonly version: RemoteConfigVersion;
+} | {
+  readonly status: "conflict";
+  readonly currentVersion: number;
+};
+interface RemoteConfigVersionsPage {
+  /** Newest first. */
+  readonly versions: readonly RemoteConfigVersion[];
+  /** Pass as `cursor` for the next page; absent on the last one. */
+  readonly next?: string;
+}
+/** `hotUpdater.api.remoteConfig`. */
+interface RemoteConfigApi {
+  /** The active template and its version. */
+  getActive(): Promise<RemoteConfigActive>;
+  /**
+   * Validates and publishes a template as the next version. Throws
+   * `RemoteConfigValidationError` for an invalid template.
+   */
+  publish(input: {
+    readonly template: unknown;
+    /** The version the edit started from; 0 before the first publish. */
+    readonly baseVersion: number;
+    readonly description?: string;
+  }): Promise<RemoteConfigPublishResult>;
+  /** Publishes a copy of an earlier version; `not_found` when it does not exist. */
+  rollback(input: {
+    readonly version: number;
+    readonly baseVersion: number;
+    readonly description?: string;
+  }): Promise<RemoteConfigPublishResult | {
+    readonly status: "not_found";
+  }>;
+  /** One page of published versions, newest first. */
+  listVersions(input?: {
+    readonly limit?: number;
+    readonly cursor?: string;
+  }): Promise<RemoteConfigVersionsPage>;
+  /** One version with its template, or null. */
+  getVersion(version: number): Promise<RemoteConfigVersionDetail | null>;
+  /**
+   * What a device with this context receives from `GET /remote-config`, at
+   * `context.now` or, without it, now.
+   */
+  resolve(context: RemoteConfigEvaluationContext): Promise<RemoteConfigFetchResponse>;
+}
+/**
+ * An argument the API refuses, such as a negative `baseVersion`; the admin
+ * routes answer it with `400`.
+ */
+declare class RemoteConfigInputError extends TypeError {
+  readonly name = "RemoteConfigInputError";
+}
+//#endregion
+export { RemoteConfigActive, RemoteConfigApi, RemoteConfigInputError, RemoteConfigPublishResult, RemoteConfigVersion, RemoteConfigVersionDetail, RemoteConfigVersionsPage };

package/dist/server/api.d.mts

@@ -0,0 +1,85 @@
+import { RemoteConfigFetchResponse } from "../shared/wire.mjs";
+import { RemoteConfigEvaluationContext, RemoteConfigTemplate } from "./template.mjs";
+import "@hot-updater/plugin-core";
+//#region src/server/api.d.ts
+/** A published version's record, without its template. */
+interface RemoteConfigVersion {
+  readonly version: number;
+  readonly description: string | null;
+  /** `ROLLBACK` when the version copies `rollbackSource`. */
+  readonly updateType: "PUBLISH" | "ROLLBACK";
+  readonly rollbackSource: number | null;
+  readonly createdAtMs: number;
+}
+interface RemoteConfigVersionDetail extends RemoteConfigVersion {
+  readonly template: RemoteConfigTemplate;
+}
+/** The template devices receive now. */
+interface RemoteConfigActive {
+  /** 0, with an empty template, before the first publish. */
+  readonly version: number;
+  readonly template: RemoteConfigTemplate;
+  readonly updatedAtMs: number | null;
+}
+/**
+ * How a publish or a rollback ended: `conflict` when another publish moved
+ * the active version past `baseVersion` first, so a stale edit never
+ * replaces a newer template.
+ */
+type RemoteConfigPublishResult = {
+  readonly status: "published";
+  readonly version: RemoteConfigVersion;
+} | {
+  readonly status: "conflict";
+  readonly currentVersion: number;
+};
+interface RemoteConfigVersionsPage {
+  /** Newest first. */
+  readonly versions: readonly RemoteConfigVersion[];
+  /** Pass as `cursor` for the next page; absent on the last one. */
+  readonly next?: string;
+}
+/** `hotUpdater.api.remoteConfig`. */
+interface RemoteConfigApi {
+  /** The active template and its version. */
+  getActive(): Promise<RemoteConfigActive>;
+  /**
+   * Validates and publishes a template as the next version. Throws
+   * `RemoteConfigValidationError` for an invalid template.
+   */
+  publish(input: {
+    readonly template: unknown;
+    /** The version the edit started from; 0 before the first publish. */
+    readonly baseVersion: number;
+    readonly description?: string;
+  }): Promise<RemoteConfigPublishResult>;
+  /** Publishes a copy of an earlier version; `not_found` when it does not exist. */
+  rollback(input: {
+    readonly version: number;
+    readonly baseVersion: number;
+    readonly description?: string;
+  }): Promise<RemoteConfigPublishResult | {
+    readonly status: "not_found";
+  }>;
+  /** One page of published versions, newest first. */
+  listVersions(input?: {
+    readonly limit?: number;
+    readonly cursor?: string;
+  }): Promise<RemoteConfigVersionsPage>;
+  /** One version with its template, or null. */
+  getVersion(version: number): Promise<RemoteConfigVersionDetail | null>;
+  /**
+   * What a device with this context receives from `GET /remote-config`, at
+   * `context.now` or, without it, now.
+   */
+  resolve(context: RemoteConfigEvaluationContext): Promise<RemoteConfigFetchResponse>;
+}
+/**
+ * An argument the API refuses, such as a negative `baseVersion`; the admin
+ * routes answer it with `400`.
+ */
+declare class RemoteConfigInputError extends TypeError {
+  readonly name = "RemoteConfigInputError";
+}
+//#endregion
+export { RemoteConfigActive, RemoteConfigApi, RemoteConfigInputError, RemoteConfigPublishResult, RemoteConfigVersion, RemoteConfigVersionDetail, RemoteConfigVersionsPage };

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,50 @@
+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");
+const require_admin = require("./admin.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.createRemoteConfigAdminApi = require_admin.createRemoteConfigAdminApi;
+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,64 @@
+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";
+import { RemoteConfigAdminApi, RemoteConfigAdminApiOptions, createRemoteConfigAdminApi } from "./admin.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 RemoteConfigAdminApi, type RemoteConfigAdminApiOptions, 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, createRemoteConfigAdminApi, evaluateRemoteConfig, matchesRemoteConfigCondition, matchesRemoteConfigRule, remoteConfig, remoteConfigSchema, resolveRemoteConfigValues, validateRemoteConfigTemplate };

package/dist/server/index.d.mts

@@ -0,0 +1,64 @@
+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";
+import { RemoteConfigAdminApi, RemoteConfigAdminApiOptions, createRemoteConfigAdminApi } from "./admin.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 RemoteConfigAdminApi, type RemoteConfigAdminApiOptions, 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, createRemoteConfigAdminApi, evaluateRemoteConfig, matchesRemoteConfigCondition, matchesRemoteConfigRule, remoteConfig, remoteConfigSchema, resolveRemoteConfigValues, validateRemoteConfigTemplate };

package/dist/server/index.mjs

@@ -0,0 +1,36 @@
+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 { createRemoteConfigAdminApi } from "./admin.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, createRemoteConfigAdminApi, 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 };