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

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);

package/dist/types/index.d.cts

@@ -1,3 +1,3 @@
 import { HotUpdaterAPI } from "../createHotUpdaterCore.cjs";
-import { Bundle } from "@hot-updater/core";
+import { Bundle } from "@hot-updater/protocol";
 export type { Bundle };

package/dist/types/index.d.mts

@@ -1,3 +1,3 @@
 import { HotUpdaterAPI } from "../createHotUpdaterCore.mjs";
-import { Bundle } from "@hot-updater/core";
+import { Bundle } from "@hot-updater/protocol";
 export type { Bundle };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/server",
-  "version": "1.0.0-rc.18",
+  "version": "1.0.0-rc.21",
   "type": "module",
   "description": "React Native OTA solution for self-hosted",
   "sideEffects": false,
@@ -28,26 +28,6 @@
       "import": "./dist/adapters/prisma.mjs",
       "require": "./dist/adapters/prisma.cjs"
     },
-    "./database": {
-      "import": "./dist/database/index.mjs",
-      "require": "./dist/database/index.cjs"
-    },
-    "./db": {
-      "import": "./dist/db/index.mjs",
-      "require": "./dist/db/index.cjs"
-    },
-    "./diff": {
-      "import": "./dist/diff.mjs",
-      "require": "./dist/diff.cjs"
-    },
-    "./node": {
-      "import": "./dist/node.mjs",
-      "require": "./dist/node.cjs"
-    },
-    "./plugins": {
-      "import": "./dist/plugins/index.mjs",
-      "require": "./dist/plugins/index.cjs"
-    },
     "./plugins/api-keys": {
       "import": "./dist/plugins/api-keys/index.mjs",
       "require": "./dist/plugins/api-keys/index.cjs"
@@ -56,17 +36,13 @@
       "import": "./dist/plugins/insights/index.mjs",
       "require": "./dist/plugins/insights/index.cjs"
     },
-    "./package.json": "./package.json",
-    "./plugins/insights/testing": {
-      "import": "./dist/plugins/insights/testing/index.mjs"
-    }
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
-    "src",
     "package.json"
   ],
-  "license": "MIT",
+  "license": "SEE LICENSE IN LICENSE",
   "repository": {
     "type": "git",
     "url": "https://github.com/gronxb/hot-updater"
@@ -78,16 +54,16 @@
   "dependencies": {
     "rou3": "0.7.9",
     "verkit": "0.4.0",
-    "@hot-updater/bsdiff": "1.0.0-rc.14",
-    "@hot-updater/plugin-core": "1.0.0-rc.17",
-    "@hot-updater/core": "1.0.0-rc.15"
+    "@hot-updater/plugin-core": "1.0.0-rc.21",
+    "@hot-updater/protocol": "1.0.0-rc.21",
+    "@hot-updater/plugin-api-keys": "1.0.0-rc.21",
+    "@hot-updater/plugin-insights": "1.0.0-rc.21"
   },
   "peerDependencies": {
     "@prisma/client": "*",
     "drizzle-orm": "*",
     "kysely": "*",
-    "mongodb": "*",
-    "vitest": "^4.0.0"
+    "mongodb": "*"
   },
   "peerDependenciesMeta": {
     "@prisma/client": {
@@ -101,9 +77,6 @@
     },
     "mongodb": {
       "optional": true
-    },
-    "vitest": {
-      "optional": true
     }
   },
   "devDependencies": {
@@ -125,8 +98,13 @@
     "prisma": "6.19.3",
     "uuidv7": "^1.0.2",
     "wrangler": "^4.69.0",
-    "@hot-updater/standalone": "1.0.0-rc.17",
-    "@hot-updater/test-utils": "1.0.0-rc.17"
+    "@hot-updater/standalone": "1.0.0-rc.21",
+    "@hot-updater/test-utils": "1.0.0-rc.21"
+  },
+  "nx": {
+    "implicitDependencies": [
+      "!@hot-updater/test-utils"
+    ]
   },
   "scripts": {
     "build": "tsdown",

package/dist/_virtual/_rolldown/runtime.cjs

@@ -1,23 +0,0 @@
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
-exports.__toESM = __toESM;

package/dist/assembly/clientPlugins.d.cts

@@ -1,16 +0,0 @@
-//#region src/assembly/clientPlugins.d.ts
-/** A client plugin an app adds to `HotUpdater.init`'s `plugins`. */
-interface ClientPluginSpec {
-  /** The module that exports it. */
-  readonly module: string;
-  /** The export, which the app calls with no arguments. */
-  readonly name: string;
-}
-/**
- * The client plugins an app adds for the plugins, each once, in plugin
- * order: what init prints in `HotUpdater.init`'s `plugins`. A malformed one,
- * or one name from two modules, throws `HotUpdaterConfigError`.
- */
-declare const clientPluginsOf: (plugins: readonly unknown[]) => readonly ClientPluginSpec[];
-//#endregion
-export { ClientPluginSpec, clientPluginsOf };

package/dist/assembly/clientPlugins.d.mts

@@ -1,16 +0,0 @@
-//#region src/assembly/clientPlugins.d.ts
-/** A client plugin an app adds to `HotUpdater.init`'s `plugins`. */
-interface ClientPluginSpec {
-  /** The module that exports it. */
-  readonly module: string;
-  /** The export, which the app calls with no arguments. */
-  readonly name: string;
-}
-/**
- * The client plugins an app adds for the plugins, each once, in plugin
- * order: what init prints in `HotUpdater.init`'s `plugins`. A malformed one,
- * or one name from two modules, throws `HotUpdaterConfigError`.
- */
-declare const clientPluginsOf: (plugins: readonly unknown[]) => readonly ClientPluginSpec[];
-//#endregion
-export { ClientPluginSpec, clientPluginsOf };

package/dist/assembly/configError.cjs

@@ -1,7 +0,0 @@
-//#region src/assembly/configError.ts
-/** A misconfigured `createHotUpdater` call, reported at startup. */
-var HotUpdaterConfigError = class extends Error {
-	name = "HotUpdaterConfigError";
-};
-//#endregion
-exports.HotUpdaterConfigError = HotUpdaterConfigError;

package/dist/assembly/databasePlugins.cjs

@@ -1,27 +0,0 @@
-const require_api = require("../core/api.cjs");
-const require_assemblePlugins = require("./assemblePlugins.cjs");
-//#region src/assembly/databasePlugins.ts
-function createDatabasePluginApis(database, plugins, options = {}) {
-	const adapter = require_api.engineAdapterOf(database);
-	if (adapter === void 0) throw new Error(require_api.OFF_ENGINE_DATABASE);
-	const { aggregateBatching } = database;
-	return require_assemblePlugins.assemblePlugins(plugins, adapter, {
-		...options,
-		...aggregateBatching === void 0 ? {} : { batching: aggregateBatching }
-	}).api;
-}
-function createMeasuredDatabase(adapter, plugins, options = {}) {
-	const { core, api, clientAuth, measureReads } = require_assemblePlugins.assemblePlugins(plugins, adapter, {
-		...options,
-		verify: true
-	});
-	return {
-		core,
-		api,
-		...clientAuth === void 0 ? {} : { clientAuth },
-		measureReads
-	};
-}
-//#endregion
-exports.createDatabasePluginApis = createDatabasePluginApis;
-exports.createMeasuredDatabase = createMeasuredDatabase;

package/dist/assembly/databasePlugins.d.cts

@@ -1,43 +0,0 @@
-import { ReadMeasurement } from "../database/engine.cjs";
-import { CoreStorage } from "../core/reads.cjs";
-import { AnyHotUpdaterPlugin, ClientAuth, PluginApis } from "../plugins/definePlugin.cjs";
-import { CoreApi } from "../core/api.cjs";
-import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
-//#region src/assembly/databasePlugins.d.ts
-/**
- * The plugins' APIs by plugin id over a configured database, assembled as
- * `createHotUpdater` assembles them: how the console and the CLI run a
- * plugin in process, on the tables the server uses. A database off the
- * storage engine, `standaloneRepository` included, is refused: its server
- * runs the plugins.
- */
-declare function createDatabasePluginApis<const TPlugins extends readonly AnyHotUpdaterPlugin[]>(database: unknown, plugins: TPlugins, options?: {
-  readonly now?: () => number;
-}): PluginApis<TPlugins>;
-declare function createDatabasePluginApis(database: unknown, plugins: readonly unknown[], options?: {
-  readonly now?: () => number;
-}): Readonly<Record<string, unknown>>;
-interface MeasuredDatabaseOptions {
-  readonly now?: () => number;
-  /** How core reads bundle manifests and resolves file URLs, for artifact resolution. */
-  readonly storage?: CoreStorage;
-}
-/** Core and the plugins' APIs on one engine in verify mode, and its read meter. */
-interface MeasuredDatabase<TApi = Readonly<Record<string, unknown>>> {
-  readonly core: CoreApi;
-  readonly api: TApi;
-  /** The client-route policy, when a plugin provides one. */
-  readonly clientAuth?: ClientAuth;
-  /** Runs `read` and reports what it read at both boundaries. */
-  measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>>;
-}
-/**
- * Core and the plugins over a storage adapter, assembled as
- * `createHotUpdater` assembles them but on an engine in verify mode, with
- * that engine's `measureReads`: what read-budget suites measure. The adapter
- * runs as given, without the schema fence.
- */
-declare function createMeasuredDatabase<const TPlugins extends readonly AnyHotUpdaterPlugin[]>(adapter: DatabaseAdapter, plugins: TPlugins, options?: MeasuredDatabaseOptions): MeasuredDatabase<PluginApis<TPlugins>>;
-declare function createMeasuredDatabase(adapter: DatabaseAdapter, plugins: readonly unknown[], options?: MeasuredDatabaseOptions): MeasuredDatabase;
-//#endregion
-export { MeasuredDatabase, MeasuredDatabaseOptions, createDatabasePluginApis, createMeasuredDatabase };

package/dist/assembly/databasePlugins.d.mts

@@ -1,43 +0,0 @@
-import { ReadMeasurement } from "../database/engine.mjs";
-import { CoreStorage } from "../core/reads.mjs";
-import { AnyHotUpdaterPlugin, ClientAuth, PluginApis } from "../plugins/definePlugin.mjs";
-import { CoreApi } from "../core/api.mjs";
-import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
-//#region src/assembly/databasePlugins.d.ts
-/**
- * The plugins' APIs by plugin id over a configured database, assembled as
- * `createHotUpdater` assembles them: how the console and the CLI run a
- * plugin in process, on the tables the server uses. A database off the
- * storage engine, `standaloneRepository` included, is refused: its server
- * runs the plugins.
- */
-declare function createDatabasePluginApis<const TPlugins extends readonly AnyHotUpdaterPlugin[]>(database: unknown, plugins: TPlugins, options?: {
-  readonly now?: () => number;
-}): PluginApis<TPlugins>;
-declare function createDatabasePluginApis(database: unknown, plugins: readonly unknown[], options?: {
-  readonly now?: () => number;
-}): Readonly<Record<string, unknown>>;
-interface MeasuredDatabaseOptions {
-  readonly now?: () => number;
-  /** How core reads bundle manifests and resolves file URLs, for artifact resolution. */
-  readonly storage?: CoreStorage;
-}
-/** Core and the plugins' APIs on one engine in verify mode, and its read meter. */
-interface MeasuredDatabase<TApi = Readonly<Record<string, unknown>>> {
-  readonly core: CoreApi;
-  readonly api: TApi;
-  /** The client-route policy, when a plugin provides one. */
-  readonly clientAuth?: ClientAuth;
-  /** Runs `read` and reports what it read at both boundaries. */
-  measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>>;
-}
-/**
- * Core and the plugins over a storage adapter, assembled as
- * `createHotUpdater` assembles them but on an engine in verify mode, with
- * that engine's `measureReads`: what read-budget suites measure. The adapter
- * runs as given, without the schema fence.
- */
-declare function createMeasuredDatabase<const TPlugins extends readonly AnyHotUpdaterPlugin[]>(adapter: DatabaseAdapter, plugins: TPlugins, options?: MeasuredDatabaseOptions): MeasuredDatabase<PluginApis<TPlugins>>;
-declare function createMeasuredDatabase(adapter: DatabaseAdapter, plugins: readonly unknown[], options?: MeasuredDatabaseOptions): MeasuredDatabase;
-//#endregion
-export { MeasuredDatabase, MeasuredDatabaseOptions, createDatabasePluginApis, createMeasuredDatabase };

package/dist/assembly/databasePlugins.mjs

@@ -1,26 +0,0 @@
-import { OFF_ENGINE_DATABASE, engineAdapterOf } from "../core/api.mjs";
-import { assemblePlugins } from "./assemblePlugins.mjs";
-//#region src/assembly/databasePlugins.ts
-function createDatabasePluginApis(database, plugins, options = {}) {
-	const adapter = engineAdapterOf(database);
-	if (adapter === void 0) throw new Error(OFF_ENGINE_DATABASE);
-	const { aggregateBatching } = database;
-	return assemblePlugins(plugins, adapter, {
-		...options,
-		...aggregateBatching === void 0 ? {} : { batching: aggregateBatching }
-	}).api;
-}
-function createMeasuredDatabase(adapter, plugins, options = {}) {
-	const { core, api, clientAuth, measureReads } = assemblePlugins(plugins, adapter, {
-		...options,
-		verify: true
-	});
-	return {
-		core,
-		api,
-		...clientAuth === void 0 ? {} : { clientAuth },
-		measureReads
-	};
-}
-//#endregion
-export { createDatabasePluginApis, createMeasuredDatabase };

package/dist/assembly/pluginCli.cjs

@@ -1,125 +0,0 @@
-const require_configError = require("./configError.cjs");
-const require_clientPlugins = require("./clientPlugins.cjs");
-const require_assemblePlugins = require("./assemblePlugins.cjs");
-const require_databasePlugins = require("./databasePlugins.cjs");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
-//#region src/assembly/pluginCli.ts
-const COMMAND_NAME = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/u;
-const ARGUMENT_NAME = /^[A-Za-z][A-Za-z0-9]*$/u;
-const RESERVED_ARGUMENT = "configPath";
-const fail = (message) => {
-	throw new require_configError.HotUpdaterConfigError(message);
-};
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const pluginsOf = (value) => Array.isArray(value) ? value.filter(isRecord) : fail("plugins must be an array of plugins.");
-const checkCommand = (plugin, value, path) => {
-	const at = `Plugin "${plugin}" command "${[...path, isRecord(value) ? String(value.name) : "?"].join(" ")}"`;
-	if (!isRecord(value) || typeof value.name !== "string" || !COMMAND_NAME.test(value.name) || typeof value.description !== "string") return fail(`${at} needs a name of lowercase words joined by hyphens and a description.`);
-	const command = value;
-	if (typeof command.run === "function" === (command.commands !== void 0)) fail(`${at} needs either subcommands or run, not both.`);
-	const names = /* @__PURE__ */ new Set();
-	for (const argument of command.arguments ?? []) {
-		if (!isRecord(argument) || typeof argument.name !== "string" || !ARGUMENT_NAME.test(argument.name) || argument.name === RESERVED_ARGUMENT || names.has(argument.name) || typeof argument.description !== "string") fail(`${at} has an argument that needs a unique camelCase name other than "${RESERVED_ARGUMENT}" and a description.`);
-		names.add(argument.name);
-	}
-	for (const option of command.options ?? []) if (!isRecord(option) || typeof option.flags !== "string" || !option.flags.includes("--") || typeof option.description !== "string") fail(`${at} has an option that needs --flags and a description.`);
-	if (command.commands !== void 0) {
-		if (!Array.isArray(command.commands) || command.commands.length === 0) fail(`${at} needs at least one subcommand.`);
-		const subcommands = /* @__PURE__ */ new Set();
-		for (const subcommand of command.commands) {
-			const checked = checkCommand(plugin, subcommand, [...path, command.name]);
-			if (subcommands.has(checked.name)) fail(`${at} has two subcommands named "${checked.name}".`);
-			subcommands.add(checked.name);
-		}
-	}
-	return command;
-};
-/**
-* The top-level commands the plugins add, each checked. Two plugins may not
-* add the same command.
-*/
-const pluginCommandsOf = (plugins) => {
-	const entries = [];
-	for (const plugin of pluginsOf(plugins)) {
-		const commands = plugin.cli?.commands;
-		if (commands === void 0) continue;
-		const id = String(plugin.id);
-		if (!Array.isArray(commands)) fail(`Plugin "${id}" cli.commands must be an array.`);
-		for (const value of commands) {
-			const command = checkCommand(id, value, []);
-			const taken = entries.find((entry) => entry.command.name === command.name);
-			if (taken !== void 0) fail(`Plugins "${taken.plugin}" and "${id}" both add the command "${command.name}"; keep one.`);
-			entries.push({
-				plugin: id,
-				command
-			});
-		}
-	}
-	return entries;
-};
-/** The clientAuth plugin's credential contribution, checked. */
-const credentialOf = (plugins) => {
-	const plugin = pluginsOf(plugins).find(({ provides }) => provides?.clientAuth === true);
-	if (plugin === void 0) return void 0;
-	const id = String(plugin.id);
-	const credential = plugin.cli?.clientCredential;
-	if (!isRecord(credential) || typeof credential.label !== "string" || typeof credential.header !== "string" || typeof credential.env !== "string" || typeof credential.generate !== "function" || typeof credential.provision !== "function") return fail(`Plugin "${id}" provides clientAuth but no cli.clientCredential with a label, header, env, generate, and provision, so init cannot give an app its credential.`);
-	return {
-		plugin: id,
-		credential
-	};
-};
-/**
-* The client-route policy the plugins set: the plugin that provides
-* clientAuth, the headers its decision reads, and the credential an app
-* sends. Undefined when client routes are public. The plugins initialize on
-* a throwaway in-memory database, since `varyHeaders` live on the instance.
-*/
-const clientAuthOf = (plugins) => {
-	const found = credentialOf(plugins);
-	if (found === void 0) return void 0;
-	const { clientAuth } = require_assemblePlugins.assemblePlugins(plugins, (0, _hot_updater_plugin_core_internal.createMemoryAdapter)());
-	const { label, header, env } = found.credential;
-	return {
-		plugin: found.plugin,
-		varyHeaders: (clientAuth?.varyHeaders ?? []).map((name) => name.toLowerCase()),
-		credential: {
-			label,
-			header: header.toLowerCase(),
-			env
-		}
-	};
-};
-/**
-* A new client credential, made without a database, so tooling can save it
-* before it registers it. Undefined when client routes are public.
-*/
-const generateClientCredential = (plugins) => credentialOf(plugins)?.credential.generate();
-/**
-* Provisions the credential an app sends to client routes, through the
-* plugin that provides clientAuth, on the tables the server reads: a
-* credential saved in `env` is registered again rather than replaced.
-* Undefined when client routes are public.
-*/
-const provisionClientCredential = async (database, plugins, input) => {
-	const found = credentialOf(plugins);
-	if (found === void 0) return void 0;
-	const { label, header, env, provision } = found.credential;
-	const existing = input.env[env]?.trim();
-	const value = await provision(require_databasePlugins.createDatabasePluginApis(database, plugins)[found.plugin], {
-		...existing ? { existing } : {},
-		name: input.name
-	});
-	return {
-		label,
-		header: header.toLowerCase(),
-		env,
-		value
-	};
-};
-//#endregion
-exports.clientAuthOf = clientAuthOf;
-exports.clientPluginsOf = require_clientPlugins.clientPluginsOf;
-exports.generateClientCredential = generateClientCredential;
-exports.pluginCommandsOf = pluginCommandsOf;
-exports.provisionClientCredential = provisionClientCredential;

package/dist/assembly/pluginCli.d.cts

@@ -1,59 +0,0 @@
-import { PluginCommand } from "../plugins/definePlugin.cjs";
-import { ClientPluginSpec, clientPluginsOf } from "./clientPlugins.cjs";
-//#region src/assembly/pluginCli.d.ts
-/** A top-level command a plugin adds to `hot-updater`. */
-interface PluginCommandEntry {
-  /** The id of the plugin that adds it. */
-  readonly plugin: string;
-  readonly command: PluginCommand;
-}
-/** The credential an app sends to client routes. */
-interface ClientCredentialSpec {
-  /** Its name in output, such as "API key". */
-  readonly label: string;
-  /** The request header that carries it, lowercase. */
-  readonly header: string;
-  /** The environment variable init stores it in. */
-  readonly env: string;
-}
-/** The client-route policy a server's plugins set, as tooling needs it. */
-interface ClientAuthSpec {
-  /** The plugin that provides clientAuth. */
-  readonly plugin: string;
-  /** The request headers its decision reads, lowercase: what caches key on. */
-  readonly varyHeaders: readonly string[];
-  readonly credential: ClientCredentialSpec;
-}
-interface ProvisionedClientCredential extends ClientCredentialSpec {
-  readonly value: string;
-}
-/**
- * The top-level commands the plugins add, each checked. Two plugins may not
- * add the same command.
- */
-declare const pluginCommandsOf: (plugins: unknown) => readonly PluginCommandEntry[];
-/**
- * The client-route policy the plugins set: the plugin that provides
- * clientAuth, the headers its decision reads, and the credential an app
- * sends. Undefined when client routes are public. The plugins initialize on
- * a throwaway in-memory database, since `varyHeaders` live on the instance.
- */
-declare const clientAuthOf: (plugins: readonly unknown[]) => ClientAuthSpec | undefined;
-/**
- * A new client credential, made without a database, so tooling can save it
- * before it registers it. Undefined when client routes are public.
- */
-declare const generateClientCredential: (plugins: readonly unknown[]) => string | undefined;
-/**
- * Provisions the credential an app sends to client routes, through the
- * plugin that provides clientAuth, on the tables the server reads: a
- * credential saved in `env` is registered again rather than replaced.
- * Undefined when client routes are public.
- */
-declare const provisionClientCredential: (database: unknown, plugins: readonly unknown[], input: {
-  readonly env: Readonly<Record<string, string | undefined>>;
-  /** Names the credential where the plugin stores one. */
-  readonly name: string;
-}) => Promise<ProvisionedClientCredential | undefined>;
-//#endregion
-export { ClientAuthSpec, ClientCredentialSpec, type ClientPluginSpec, PluginCommandEntry, ProvisionedClientCredential, clientAuthOf, clientPluginsOf, generateClientCredential, pluginCommandsOf, provisionClientCredential };

package/dist/assembly/pluginCli.d.mts

@@ -1,59 +0,0 @@
-import { PluginCommand } from "../plugins/definePlugin.mjs";
-import { ClientPluginSpec, clientPluginsOf } from "./clientPlugins.mjs";
-//#region src/assembly/pluginCli.d.ts
-/** A top-level command a plugin adds to `hot-updater`. */
-interface PluginCommandEntry {
-  /** The id of the plugin that adds it. */
-  readonly plugin: string;
-  readonly command: PluginCommand;
-}
-/** The credential an app sends to client routes. */
-interface ClientCredentialSpec {
-  /** Its name in output, such as "API key". */
-  readonly label: string;
-  /** The request header that carries it, lowercase. */
-  readonly header: string;
-  /** The environment variable init stores it in. */
-  readonly env: string;
-}
-/** The client-route policy a server's plugins set, as tooling needs it. */
-interface ClientAuthSpec {
-  /** The plugin that provides clientAuth. */
-  readonly plugin: string;
-  /** The request headers its decision reads, lowercase: what caches key on. */
-  readonly varyHeaders: readonly string[];
-  readonly credential: ClientCredentialSpec;
-}
-interface ProvisionedClientCredential extends ClientCredentialSpec {
-  readonly value: string;
-}
-/**
- * The top-level commands the plugins add, each checked. Two plugins may not
- * add the same command.
- */
-declare const pluginCommandsOf: (plugins: unknown) => readonly PluginCommandEntry[];
-/**
- * The client-route policy the plugins set: the plugin that provides
- * clientAuth, the headers its decision reads, and the credential an app
- * sends. Undefined when client routes are public. The plugins initialize on
- * a throwaway in-memory database, since `varyHeaders` live on the instance.
- */
-declare const clientAuthOf: (plugins: readonly unknown[]) => ClientAuthSpec | undefined;
-/**
- * A new client credential, made without a database, so tooling can save it
- * before it registers it. Undefined when client routes are public.
- */
-declare const generateClientCredential: (plugins: readonly unknown[]) => string | undefined;
-/**
- * Provisions the credential an app sends to client routes, through the
- * plugin that provides clientAuth, on the tables the server reads: a
- * credential saved in `env` is registered again rather than replaced.
- * Undefined when client routes are public.
- */
-declare const provisionClientCredential: (database: unknown, plugins: readonly unknown[], input: {
-  readonly env: Readonly<Record<string, string | undefined>>;
-  /** Names the credential where the plugin stores one. */
-  readonly name: string;
-}) => Promise<ProvisionedClientCredential | undefined>;
-//#endregion
-export { ClientAuthSpec, ClientCredentialSpec, type ClientPluginSpec, PluginCommandEntry, ProvisionedClientCredential, clientAuthOf, clientPluginsOf, generateClientCredential, pluginCommandsOf, provisionClientCredential };