@hot-updater/server 1.0.0-rc.2 → 1.0.0-rc.21

package/dist/handlerTypes.d.cts

@@ -1,62 +1,9 @@
-import { ReleaseCatalogRequest } from "./db/releaseCatalog.cjs";
-import { PaginatedResult } from "./types/index.cjs";
-import { ArtifactInfo, Bundle, ReleaseCatalog } from "@hot-updater/core";
-import { ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, ChannelRow, DatabaseBundleQueryOptions, DatabaseCommit, DatabaseCommitResult, ReleaseCatalogMutationPreflight, ReleaseCatalogMutationResult, ReleaseCatalogRebuildResult, ReleaseCatalogRow, ReleasePolicyPatch, ReleaseRow } from "@hot-updater/plugin-core";
+import "./core/api.cjs";
 //#region src/handlerTypes.d.ts
-interface HandlerAPI {
-  getReleaseCatalog?: (input: ReleaseCatalogRequest) => Promise<ReleaseCatalog | null>;
-  getArtifactInfo?: (targetBundleId: string, currentBundleId: string) => Promise<ArtifactInfo | null>;
-  getReleaseById?: (id: string) => Promise<ReleaseRow | null>;
-  getReleasesByScope?: (input: {
-    readonly scopeKey: string;
-    readonly afterReleaseId?: string;
-    readonly limit: number;
-  }) => Promise<readonly ReleaseRow[]>;
-  getReleases?: (input: {
-    readonly afterReleaseId?: string;
-    readonly beforeReleaseId?: string;
-    readonly bundleId?: string;
-    readonly channelId?: string;
-    readonly enabled?: boolean;
-    readonly platform?: "ios" | "android";
-    readonly targetAppVersion?: string;
-    readonly limit: number;
-  }) => Promise<readonly ReleaseRow[]>;
-  getReleaseCatalogByScopeKey?: (scopeKey: string) => Promise<ReleaseCatalogRow | null>;
-  getReleaseCatalogs?: (input: {
-    readonly afterScopeKey?: string;
-    readonly limit: number;
-  }) => Promise<readonly ReleaseCatalogRow[]>;
-  updateReleasePolicy?: (input: {
-    readonly expectedRevision?: number;
-    readonly patch: ReleasePolicyPatch;
-    readonly releaseId: string;
-  }) => Promise<ReleaseCatalogMutationResult>;
-  preflightReleasePolicy?: (input: {
-    readonly expectedRevision?: number;
-    readonly patch: ReleasePolicyPatch;
-    readonly releaseId: string;
-  }) => Promise<ReleaseCatalogMutationPreflight>;
-  deleteRelease?: (input: {
-    readonly expectedRevision?: number;
-    readonly releaseId: string;
-  }) => Promise<ReleaseCatalogMutationResult>;
-  rebuildReleaseCatalog?: (scopeKey: string) => Promise<ReleaseCatalogRebuildResult>;
-  commitDatabase?: (input: DatabaseCommit) => Promise<DatabaseCommitResult>;
-  getBundleById: (id: string) => Promise<Bundle | null>;
-  getBundles: (options: DatabaseBundleQueryOptions) => Promise<PaginatedResult>;
-  insertBundle: (bundle: Bundle) => Promise<void>;
-  insertBundles?: (bundles: readonly Bundle[]) => Promise<void>;
-  updateBundleById: (bundleId: string, bundle: Partial<Bundle>) => Promise<void>;
-  deleteBundleById: (bundleId: string) => Promise<void>;
-  getChannels: () => Promise<readonly ChannelRow[]>;
-  insertChannel: (input: ChannelInsertInput) => Promise<ChannelInsertResult>;
-  deleteChannel: (input: ChannelDeleteInput) => Promise<ChannelDeleteResult>;
-}
 type HotUpdaterHandler = (request: Request) => Promise<Response>;
 interface HotUpdaterHandlers {
   readonly client: HotUpdaterHandler;
   readonly admin: HotUpdaterHandler;
 }
 //#endregion
-export { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers };
+export { HotUpdaterHandler, HotUpdaterHandlers };

package/dist/handlerTypes.d.mts

@@ -1,62 +1,9 @@
-import { ReleaseCatalogRequest } from "./db/releaseCatalog.mjs";
-import { PaginatedResult } from "./types/index.mjs";
-import { ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, ChannelRow, DatabaseBundleQueryOptions, DatabaseCommit, DatabaseCommitResult, ReleaseCatalogMutationPreflight, ReleaseCatalogMutationResult, ReleaseCatalogRebuildResult, ReleaseCatalogRow, ReleasePolicyPatch, ReleaseRow } from "@hot-updater/plugin-core";
-import { ArtifactInfo, Bundle as Bundle$1, ReleaseCatalog } from "@hot-updater/core";
+import "./core/api.mjs";
 //#region src/handlerTypes.d.ts
-interface HandlerAPI {
-  getReleaseCatalog?: (input: ReleaseCatalogRequest) => Promise<ReleaseCatalog | null>;
-  getArtifactInfo?: (targetBundleId: string, currentBundleId: string) => Promise<ArtifactInfo | null>;
-  getReleaseById?: (id: string) => Promise<ReleaseRow | null>;
-  getReleasesByScope?: (input: {
-    readonly scopeKey: string;
-    readonly afterReleaseId?: string;
-    readonly limit: number;
-  }) => Promise<readonly ReleaseRow[]>;
-  getReleases?: (input: {
-    readonly afterReleaseId?: string;
-    readonly beforeReleaseId?: string;
-    readonly bundleId?: string;
-    readonly channelId?: string;
-    readonly enabled?: boolean;
-    readonly platform?: "ios" | "android";
-    readonly targetAppVersion?: string;
-    readonly limit: number;
-  }) => Promise<readonly ReleaseRow[]>;
-  getReleaseCatalogByScopeKey?: (scopeKey: string) => Promise<ReleaseCatalogRow | null>;
-  getReleaseCatalogs?: (input: {
-    readonly afterScopeKey?: string;
-    readonly limit: number;
-  }) => Promise<readonly ReleaseCatalogRow[]>;
-  updateReleasePolicy?: (input: {
-    readonly expectedRevision?: number;
-    readonly patch: ReleasePolicyPatch;
-    readonly releaseId: string;
-  }) => Promise<ReleaseCatalogMutationResult>;
-  preflightReleasePolicy?: (input: {
-    readonly expectedRevision?: number;
-    readonly patch: ReleasePolicyPatch;
-    readonly releaseId: string;
-  }) => Promise<ReleaseCatalogMutationPreflight>;
-  deleteRelease?: (input: {
-    readonly expectedRevision?: number;
-    readonly releaseId: string;
-  }) => Promise<ReleaseCatalogMutationResult>;
-  rebuildReleaseCatalog?: (scopeKey: string) => Promise<ReleaseCatalogRebuildResult>;
-  commitDatabase?: (input: DatabaseCommit) => Promise<DatabaseCommitResult>;
-  getBundleById: (id: string) => Promise<Bundle$1 | null>;
-  getBundles: (options: DatabaseBundleQueryOptions) => Promise<PaginatedResult>;
-  insertBundle: (bundle: Bundle$1) => Promise<void>;
-  insertBundles?: (bundles: readonly Bundle$1[]) => Promise<void>;
-  updateBundleById: (bundleId: string, bundle: Partial<Bundle$1>) => Promise<void>;
-  deleteBundleById: (bundleId: string) => Promise<void>;
-  getChannels: () => Promise<readonly ChannelRow[]>;
-  insertChannel: (input: ChannelInsertInput) => Promise<ChannelInsertResult>;
-  deleteChannel: (input: ChannelDeleteInput) => Promise<ChannelDeleteResult>;
-}
 type HotUpdaterHandler = (request: Request) => Promise<Response>;
 interface HotUpdaterHandlers {
   readonly client: HotUpdaterHandler;
   readonly admin: HotUpdaterHandler;
 }
 //#endregion
-export { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers };
+export { HotUpdaterHandler, HotUpdaterHandlers };

package/dist/handlerVersionRoutes.cjs

@@ -1,10 +1,26 @@
 const require_version = require("./version.cjs");
 //#region src/handlerVersionRoutes.ts
 const HOT_UPDATER_INFRASTRUCTURE_GENERATION = 1;
-const createVersionRouteHandlers = () => ({ version: async () => Response.json({
-	infrastructureGeneration: 1,
-	version: require_version.HOT_UPDATER_SERVER_VERSION
-}) });
+/**
+* `/version` on both mounts. The admin mount also lists the ids of the
+* plugins the server runs, sorted; apps never learn which plugins a server
+* runs.
+*/
+const createVersionRouteHandlers = (plugins = []) => {
+	const version = {
+		adminProtocol: 2,
+		infrastructureGeneration: 1,
+		version: require_version.HOT_UPDATER_SERVER_VERSION
+	};
+	const adminVersion = {
+		...version,
+		plugins: [...plugins].sort()
+	};
+	return {
+		version: async () => Response.json(version),
+		adminVersion: async () => Response.json(adminVersion)
+	};
+};
 //#endregion
 exports.HOT_UPDATER_INFRASTRUCTURE_GENERATION = HOT_UPDATER_INFRASTRUCTURE_GENERATION;
 exports.createVersionRouteHandlers = createVersionRouteHandlers;

package/dist/handlerVersionRoutes.mjs

@@ -1,9 +1,25 @@
 import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
 //#region src/handlerVersionRoutes.ts
 const HOT_UPDATER_INFRASTRUCTURE_GENERATION = 1;
-const createVersionRouteHandlers = () => ({ version: async () => Response.json({
-	infrastructureGeneration: 1,
-	version: HOT_UPDATER_SERVER_VERSION
-}) });
+/**
+* `/version` on both mounts. The admin mount also lists the ids of the
+* plugins the server runs, sorted; apps never learn which plugins a server
+* runs.
+*/
+const createVersionRouteHandlers = (plugins = []) => {
+	const version = {
+		adminProtocol: 2,
+		infrastructureGeneration: 1,
+		version: HOT_UPDATER_SERVER_VERSION
+	};
+	const adminVersion = {
+		...version,
+		plugins: [...plugins].sort()
+	};
+	return {
+		version: async () => Response.json(version),
+		adminVersion: async () => Response.json(adminVersion)
+	};
+};
 //#endregion
 export { HOT_UPDATER_INFRASTRUCTURE_GENERATION, createVersionRouteHandlers };

package/dist/index.cjs

@@ -1,16 +1,16 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_version = require("./version.cjs");
 const require_handlerVersionRoutes = require("./handlerVersionRoutes.cjs");
-const require_handler = require("./handler.cjs");
-const require_provider = require("./insights/provider.cjs");
-const require_apiKeys = require("./apiKeys.cjs");
 const require_createHotUpdaterCore = require("./createHotUpdaterCore.cjs");
-exports.API_KEY_HEADER_NAME = require_apiKeys.API_KEY_HEADER_NAME;
+const require_node = require("./node.cjs");
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 exports.HOT_UPDATER_INFRASTRUCTURE_GENERATION = require_handlerVersionRoutes.HOT_UPDATER_INFRASTRUCTURE_GENERATION;
 exports.HOT_UPDATER_SERVER_VERSION = require_version.HOT_UPDATER_SERVER_VERSION;
-exports.createApiKey = require_apiKeys.createApiKey;
-exports.createHandlers = require_handler.createHandlers;
+Object.defineProperty(exports, "HotUpdaterConfigError", {
+	enumerable: true,
+	get: function() {
+		return _hot_updater_plugin_core.HotUpdaterConfigError;
+	}
+});
 exports.createHotUpdater = require_createHotUpdaterCore.createHotUpdater;
-exports.createInsightsProvider = require_provider.createInsightsProvider;
-exports.provisionApiKey = require_apiKeys.provisionApiKey;
-exports.registerApiKey = require_apiKeys.registerApiKey;
+exports.toNodeHandler = require_node.toNodeHandler;

package/dist/index.d.cts

@@ -1,11 +1,10 @@
-import { API_KEY_HEADER_NAME, ApiKeyManagementAPI, ApiKeyMetadata, CreatedApiKey, createApiKey, provisionApiKey, registerApiKey } from "./apiKeys.cjs";
-import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.cjs";
-import { ActiveInstallationWindow, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsScope, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./insights/domain.cjs";
-import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } from "./insights/types.cjs";
-import { createHandlers } from "./handler.cjs";
-import { ClientAccessPolicy, CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater } from "./createHotUpdaterCore.cjs";
-import { Bundle, ChannelsResponse, DataResponse, Paginated, PaginatedResult, PaginationInfo, PaginationOptions } from "./types/index.cjs";
+import { HotUpdaterConfigError } from "./assembly/configError.cjs";
+import "./assembly/assemblePlugins.cjs";
+import { HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.cjs";
+import "./handler.cjs";
+import { ClientAccessPolicy, ClientAccessRule, ClientAuthProvider, ClientEndpoint, CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater } from "./createHotUpdaterCore.cjs";
+import { Bundle } from "./types/index.cjs";
 import { HOT_UPDATER_SERVER_VERSION } from "./version.cjs";
-import { createInsightsProvider } from "./insights/provider.cjs";
 import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.cjs";
-export { API_KEY_HEADER_NAME, type ActiveInstallationWindow, type ApiKeyManagementAPI, type ApiKeyMetadata, type Bundle, ChannelsResponse, type ClientAccessPolicy, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CreateHotUpdaterOptions, type CreatedApiKey, type CursorPage, DataResponse, type EventCursorPage, type EventHistoryRow, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HotUpdaterAPI, type HotUpdaterHandler, type HotUpdaterHandlers, type InsightsBundleSelection, type InsightsCountMeasurement, type InsightsEventPageInput, type InsightsInstallationEventPageInput, type InsightsProvider, type InsightsScope, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type ReportingOverview, type RuntimeHotUpdaterAPI, createApiKey, createHandlers, createHotUpdater, createInsightsProvider, provisionApiKey, registerApiKey };
+import { toNodeHandler } from "./node.cjs";
+export { type Bundle, type ClientAccessPolicy, type ClientAccessRule, type ClientAuthProvider, type ClientEndpoint, type CreateHotUpdaterOptions, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HotUpdaterAPI, HotUpdaterConfigError, type HotUpdaterHandler, type HotUpdaterHandlers, type RuntimeHotUpdaterAPI, createHotUpdater, toNodeHandler };

package/dist/index.d.mts

@@ -1,11 +1,10 @@
-import { API_KEY_HEADER_NAME, ApiKeyManagementAPI, ApiKeyMetadata, CreatedApiKey, createApiKey, provisionApiKey, registerApiKey } from "./apiKeys.mjs";
-import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.mjs";
-import { ActiveInstallationWindow, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsScope, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./insights/domain.mjs";
-import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } from "./insights/types.mjs";
-import { createHandlers } from "./handler.mjs";
-import { ClientAccessPolicy, CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater } from "./createHotUpdaterCore.mjs";
-import { Bundle, ChannelsResponse, DataResponse, Paginated, PaginatedResult, PaginationInfo, PaginationOptions } from "./types/index.mjs";
+import { HotUpdaterConfigError } from "./assembly/configError.mjs";
+import "./assembly/assemblePlugins.mjs";
+import { HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.mjs";
+import "./handler.mjs";
+import { ClientAccessPolicy, ClientAccessRule, ClientAuthProvider, ClientEndpoint, CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater } from "./createHotUpdaterCore.mjs";
+import { Bundle } from "./types/index.mjs";
 import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
-import { createInsightsProvider } from "./insights/provider.mjs";
 import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mjs";
-export { API_KEY_HEADER_NAME, type ActiveInstallationWindow, type ApiKeyManagementAPI, type ApiKeyMetadata, type Bundle, ChannelsResponse, type ClientAccessPolicy, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CreateHotUpdaterOptions, type CreatedApiKey, type CursorPage, DataResponse, type EventCursorPage, type EventHistoryRow, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HotUpdaterAPI, type HotUpdaterHandler, type HotUpdaterHandlers, type InsightsBundleSelection, type InsightsCountMeasurement, type InsightsEventPageInput, type InsightsInstallationEventPageInput, type InsightsProvider, type InsightsScope, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type ReportingOverview, type RuntimeHotUpdaterAPI, createApiKey, createHandlers, createHotUpdater, createInsightsProvider, provisionApiKey, registerApiKey };
+import { toNodeHandler } from "./node.mjs";
+export { type Bundle, type ClientAccessPolicy, type ClientAccessRule, type ClientAuthProvider, type ClientEndpoint, type CreateHotUpdaterOptions, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HotUpdaterAPI, HotUpdaterConfigError, type HotUpdaterHandler, type HotUpdaterHandlers, type RuntimeHotUpdaterAPI, createHotUpdater, toNodeHandler };

package/dist/index.mjs

@@ -1,7 +1,6 @@
+import { HotUpdaterConfigError } from "./assembly/configError.mjs";
 import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
 import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mjs";
-import { createHandlers } from "./handler.mjs";
-import { createInsightsProvider } from "./insights/provider.mjs";
-import { API_KEY_HEADER_NAME, createApiKey, provisionApiKey, registerApiKey } from "./apiKeys.mjs";
 import { createHotUpdater } from "./createHotUpdaterCore.mjs";
-export { API_KEY_HEADER_NAME, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, createApiKey, createHandlers, createHotUpdater, createInsightsProvider, provisionApiKey, registerApiKey };
+import { toNodeHandler } from "./node.mjs";
+export { HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, HotUpdaterConfigError, createHotUpdater, toNodeHandler };

package/dist/node.cjs

@@ -1,6 +1,5 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_version = require("./version.cjs");
-const require_handlerVersionRoutes = require("./handlerVersionRoutes.cjs");
+require("./version.cjs");
+require("./handlerVersionRoutes.cjs");
 //#region src/node.ts
 /**
 * Converts a Hot Updater handler to a Node.js-compatible middleware
@@ -8,7 +7,7 @@ const require_handlerVersionRoutes = require("./handlerVersionRoutes.cjs");
 *
 * @example
 * ```typescript
-* import { toNodeHandler } from "@hot-updater/server/node";
+* import { toNodeHandler } from "@hot-updater/server";
 * import express from "express";
 *
 * const app = express();
@@ -54,6 +53,4 @@ function toNodeHandler(handler) {
 	};
 }
 //#endregion
-exports.HOT_UPDATER_INFRASTRUCTURE_GENERATION = require_handlerVersionRoutes.HOT_UPDATER_INFRASTRUCTURE_GENERATION;
-exports.HOT_UPDATER_SERVER_VERSION = require_version.HOT_UPDATER_SERVER_VERSION;
 exports.toNodeHandler = toNodeHandler;

package/dist/node.d.cts

@@ -8,7 +8,7 @@ import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.cj
  *
  * @example
  * ```typescript
- * import { toNodeHandler } from "@hot-updater/server/node";
+ * import { toNodeHandler } from "@hot-updater/server";
  * import express from "express";
  *
  * const app = express();
@@ -28,4 +28,4 @@ import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.cj
  */
 declare function toNodeHandler(handler: HotUpdaterHandler): (req: any, res: any, next?: any) => Promise<void>;
 //#endregion
-export { HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, toNodeHandler };
+export { toNodeHandler };

package/dist/node.d.mts

@@ -8,7 +8,7 @@ import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mj
  *
  * @example
  * ```typescript
- * import { toNodeHandler } from "@hot-updater/server/node";
+ * import { toNodeHandler } from "@hot-updater/server";
  * import express from "express";
  *
  * const app = express();
@@ -28,4 +28,4 @@ import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mj
  */
 declare function toNodeHandler(handler: HotUpdaterHandler): (req: any, res: any, next?: any) => Promise<void>;
 //#endregion
-export { HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, toNodeHandler };
+export { toNodeHandler };

package/dist/node.mjs

@@ -1,5 +1,5 @@
-import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
-import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mjs";
+import "./version.mjs";
+import "./handlerVersionRoutes.mjs";
 //#region src/node.ts
 /**
 * Converts a Hot Updater handler to a Node.js-compatible middleware
@@ -7,7 +7,7 @@ import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mj
 *
 * @example
 * ```typescript
-* import { toNodeHandler } from "@hot-updater/server/node";
+* import { toNodeHandler } from "@hot-updater/server";
 * import express from "express";
 *
 * const app = express();
@@ -53,4 +53,4 @@ function toNodeHandler(handler) {
 	};
 }
 //#endregion
-export { HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, toNodeHandler };
+export { toNodeHandler };

package/dist/package.cjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.0.0-rc.2";
+var version = "1.0.0-rc.21";
 //#endregion
 Object.defineProperty(exports, "version", {
 	enumerable: true,

package/dist/package.mjs

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "1.0.0-rc.2";
+var version = "1.0.0-rc.21";
 //#endregion
 export { version };

package/dist/plugins/api-keys/index.cjs

@@ -0,0 +1,9 @@
+var _hot_updater_plugin_api_keys_server = require("@hot-updater/plugin-api-keys/server");
+Object.keys(_hot_updater_plugin_api_keys_server).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _hot_updater_plugin_api_keys_server[k];
+		}
+	});
+});

package/dist/plugins/api-keys/index.d.cts

@@ -0,0 +1 @@
+export * from "@hot-updater/plugin-api-keys/server";

package/dist/plugins/api-keys/index.d.mts

@@ -0,0 +1 @@
+export * from "@hot-updater/plugin-api-keys/server";

package/dist/plugins/api-keys/index.mjs

@@ -0,0 +1,2 @@
+export * from "@hot-updater/plugin-api-keys/server";
+export {};

package/dist/plugins/definePlugin.d.cts

@@ -0,0 +1,2 @@
+import { AnyHotUpdaterPlugin, PluginApis } from "@hot-updater/plugin-core";
+export type { AnyHotUpdaterPlugin, PluginApis };

package/dist/plugins/definePlugin.d.mts

@@ -0,0 +1,2 @@
+import { AnyHotUpdaterPlugin, PluginApis } from "@hot-updater/plugin-core";
+export type { AnyHotUpdaterPlugin, PluginApis };

package/dist/plugins/insights/index.cjs

@@ -0,0 +1,9 @@
+var _hot_updater_plugin_insights_server = require("@hot-updater/plugin-insights/server");
+Object.keys(_hot_updater_plugin_insights_server).forEach(function(k) {
+	if (k !== "default" && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function() {
+			return _hot_updater_plugin_insights_server[k];
+		}
+	});
+});

package/dist/plugins/insights/index.d.cts

@@ -0,0 +1 @@
+export * from "@hot-updater/plugin-insights/server";

package/dist/plugins/insights/index.d.mts

@@ -0,0 +1 @@
+export * from "@hot-updater/plugin-insights/server";

package/dist/plugins/insights/index.mjs

@@ -0,0 +1,2 @@
+export * from "@hot-updater/plugin-insights/server";
+export {};

package/dist/plugins/official.cjs

@@ -0,0 +1,30 @@
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+//#region src/plugins/official.ts
+/**
+* The brand Hot Updater's own plugin factories set. It is a registered
+* symbol, not a module-private one, so a plugin made by one package's ESM
+* build still carries it when another's CommonJS build reads it, as a config
+* loaded through `require` may; no plugin sets it by accident. Each official
+* plugin package sets it with a copy of its own, so no package imports
+* another's internals for it. It guards Hot Updater's ids against a
+* clash, not against a determined impostor.
+*/
+const OFFICIAL = Symbol.for("@hot-updater/server/official-plugin");
+/**
+* The ids of Hot Updater's own plugins. The console and tooling tell
+* features apart by plugin id, so no other plugin may take one.
+*/
+const OFFICIAL_IDS = /* @__PURE__ */ new Set(["insights", "apiKeys"]);
+/** Whether one of Hot Updater's own factories made `plugin`. */
+const isOfficialPlugin = (plugin) => typeof plugin === "object" && plugin !== null && Reflect.get(plugin, OFFICIAL) === true;
+/**
+* Refuses a plugin that takes one of Hot Updater's own ids without being
+* that plugin: `at` names it in the error, such as `plugins[0]`.
+*/
+const checkReservedId = (plugin, at) => {
+	const id = typeof plugin === "object" && plugin !== null ? Reflect.get(plugin, "id") : void 0;
+	if (typeof id === "string" && OFFICIAL_IDS.has(id) && !isOfficialPlugin(plugin)) throw new _hot_updater_plugin_core.HotUpdaterConfigError(`${at} takes the id "${id}", which is reserved for Hot Updater's ${id}() plugin; give this plugin another id.`);
+};
+//#endregion
+exports.checkReservedId = checkReservedId;
+exports.isOfficialPlugin = isOfficialPlugin;

package/dist/plugins/official.mjs

@@ -0,0 +1,29 @@
+import { HotUpdaterConfigError } from "../assembly/configError.mjs";
+//#region src/plugins/official.ts
+/**
+* The brand Hot Updater's own plugin factories set. It is a registered
+* symbol, not a module-private one, so a plugin made by one package's ESM
+* build still carries it when another's CommonJS build reads it, as a config
+* loaded through `require` may; no plugin sets it by accident. Each official
+* plugin package sets it with a copy of its own, so no package imports
+* another's internals for it. It guards Hot Updater's ids against a
+* clash, not against a determined impostor.
+*/
+const OFFICIAL = Symbol.for("@hot-updater/server/official-plugin");
+/**
+* The ids of Hot Updater's own plugins. The console and tooling tell
+* features apart by plugin id, so no other plugin may take one.
+*/
+const OFFICIAL_IDS = /* @__PURE__ */ new Set(["insights", "apiKeys"]);
+/** Whether one of Hot Updater's own factories made `plugin`. */
+const isOfficialPlugin = (plugin) => typeof plugin === "object" && plugin !== null && Reflect.get(plugin, OFFICIAL) === true;
+/**
+* Refuses a plugin that takes one of Hot Updater's own ids without being
+* that plugin: `at` names it in the error, such as `plugins[0]`.
+*/
+const checkReservedId = (plugin, at) => {
+	const id = typeof plugin === "object" && plugin !== null ? Reflect.get(plugin, "id") : void 0;
+	if (typeof id === "string" && OFFICIAL_IDS.has(id) && !isOfficialPlugin(plugin)) throw new HotUpdaterConfigError(`${at} takes the id "${id}", which is reserved for Hot Updater's ${id}() plugin; give this plugin another id.`);
+};
+//#endregion
+export { checkReservedId, isOfficialPlugin };

package/dist/storageAccess.cjs

@@ -20,22 +20,25 @@ const tokensEqual = (left, right) => {
 	for (let index = 0; index < length; index += 1) difference |= (leftBytes[index] ?? 0) ^ (rightBytes[index] ?? 0);
 	return difference === 0;
 };
-const createStorageAccess = (storagePlugins) => {
+const createStorageAccess = (storageAdapters) => {
 	const protocols = /* @__PURE__ */ new Set();
-	for (const storage of storagePlugins) {
-		if (protocols.has(storage.protocol)) throw new Error(`Multiple storage plugins handle protocol: ${storage.protocol}`);
+	for (const storage of storageAdapters) {
+		if (protocols.has(storage.protocol)) throw new Error(`Multiple storage adapters handle protocol: ${storage.protocol}`);
 		protocols.add(storage.protocol);
 	}
-	const findStorage = (protocol) => storagePlugins.find((item) => item.protocol === protocol);
+	const findStorage = (protocol) => storageAdapters.find((item) => item.protocol === protocol);
 	const readStorageResponse = async (storageUri) => {
 		const protocol = getStorageProtocol(storageUri);
 		const storage = findStorage(protocol);
-		if (storage) return (await storage.get({ storageUri })).response;
+		if (storage) {
+			if (!storage.get) return null;
+			return (await storage.get({ storageUri })).response;
+		}
 		if (isRemoteUrlProtocol(protocol)) {
 			const response = await fetch(storageUri);
 			return response.ok ? response : null;
 		}
-		throw new Error(`No storage plugin for protocol: ${protocol}`);
+		throw new Error(`No storage adapter for protocol: ${protocol}`);
 	};
 	const resolveFileUrl = async (storageUri) => {
 		if (!storageUri) return null;
@@ -43,9 +46,9 @@ const createStorageAccess = (storagePlugins) => {
 		const storage = findStorage(protocol);
 		if (!storage) {
 			if (isRemoteUrlProtocol(protocol)) return storageUri;
-			throw new Error(`No storage plugin for protocol: ${protocol}`);
+			throw new Error(`No storage adapter for protocol: ${protocol}`);
 		}
-		if (!storage.getDownloadUrl) throw new Error(`Storage plugin "${storage.name}" does not implement getDownloadUrl.`);
+		if (!storage.getDownloadUrl) return null;
 		const { url: downloadUrl } = await storage.getDownloadUrl({ storageUri });
 		try {
 			return assertRemoteUrl(downloadUrl);
@@ -58,7 +61,7 @@ const createStorageAccess = (storagePlugins) => {
 		return (await readStorageResponse(storageUri))?.text() ?? null;
 	};
 	return {
-		downloadStorageObject: storagePlugins.some((storage) => storage.getDownloadUrl !== void 0) ? async (storageUriToken, encodedSignature) => {
+		downloadStorageObject: storageAdapters.some((storage) => storage.getDownloadUrl !== void 0) ? async (storageUriToken, encodedSignature) => {
 			const requestedPath = `/storage/${storageUriToken}/${encodedSignature}`;
 			const requested = (0, _hot_updater_plugin_core.parseStorageDownloadPath)(requestedPath);
 			if (!requested) return null;
@@ -68,7 +71,7 @@ const createStorageAccess = (storagePlugins) => {
 			} catch {
 				return null;
 			}
-			if (!storage?.getDownloadUrl) return null;
+			if (!storage?.getDownloadUrl || !storage.get) return null;
 			const { url: downloadUrl } = await storage.getDownloadUrl({ storageUri: requested.storageUri });
 			try {
 				new URL(downloadUrl);

package/dist/storageAccess.mjs

@@ -20,22 +20,25 @@ const tokensEqual = (left, right) => {
 	for (let index = 0; index < length; index += 1) difference |= (leftBytes[index] ?? 0) ^ (rightBytes[index] ?? 0);
 	return difference === 0;
 };
-const createStorageAccess = (storagePlugins) => {
+const createStorageAccess = (storageAdapters) => {
 	const protocols = /* @__PURE__ */ new Set();
-	for (const storage of storagePlugins) {
-		if (protocols.has(storage.protocol)) throw new Error(`Multiple storage plugins handle protocol: ${storage.protocol}`);
+	for (const storage of storageAdapters) {
+		if (protocols.has(storage.protocol)) throw new Error(`Multiple storage adapters handle protocol: ${storage.protocol}`);
 		protocols.add(storage.protocol);
 	}
-	const findStorage = (protocol) => storagePlugins.find((item) => item.protocol === protocol);
+	const findStorage = (protocol) => storageAdapters.find((item) => item.protocol === protocol);
 	const readStorageResponse = async (storageUri) => {
 		const protocol = getStorageProtocol(storageUri);
 		const storage = findStorage(protocol);
-		if (storage) return (await storage.get({ storageUri })).response;
+		if (storage) {
+			if (!storage.get) return null;
+			return (await storage.get({ storageUri })).response;
+		}
 		if (isRemoteUrlProtocol(protocol)) {
 			const response = await fetch(storageUri);
 			return response.ok ? response : null;
 		}
-		throw new Error(`No storage plugin for protocol: ${protocol}`);
+		throw new Error(`No storage adapter for protocol: ${protocol}`);
 	};
 	const resolveFileUrl = async (storageUri) => {
 		if (!storageUri) return null;
@@ -43,9 +46,9 @@ const createStorageAccess = (storagePlugins) => {
 		const storage = findStorage(protocol);
 		if (!storage) {
 			if (isRemoteUrlProtocol(protocol)) return storageUri;
-			throw new Error(`No storage plugin for protocol: ${protocol}`);
+			throw new Error(`No storage adapter for protocol: ${protocol}`);
 		}
-		if (!storage.getDownloadUrl) throw new Error(`Storage plugin "${storage.name}" does not implement getDownloadUrl.`);
+		if (!storage.getDownloadUrl) return null;
 		const { url: downloadUrl } = await storage.getDownloadUrl({ storageUri });
 		try {
 			return assertRemoteUrl(downloadUrl);
@@ -58,7 +61,7 @@ const createStorageAccess = (storagePlugins) => {
 		return (await readStorageResponse(storageUri))?.text() ?? null;
 	};
 	return {
-		downloadStorageObject: storagePlugins.some((storage) => storage.getDownloadUrl !== void 0) ? async (storageUriToken, encodedSignature) => {
+		downloadStorageObject: storageAdapters.some((storage) => storage.getDownloadUrl !== void 0) ? async (storageUriToken, encodedSignature) => {
 			const requestedPath = `/storage/${storageUriToken}/${encodedSignature}`;
 			const requested = parseStorageDownloadPath(requestedPath);
 			if (!requested) return null;
@@ -68,7 +71,7 @@ const createStorageAccess = (storagePlugins) => {
 			} catch {
 				return null;
 			}
-			if (!storage?.getDownloadUrl) return null;
+			if (!storage?.getDownloadUrl || !storage.get) return null;
 			const { url: downloadUrl } = await storage.getDownloadUrl({ storageUri: requested.storageUri });
 			try {
 				new URL(downloadUrl);