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

package/dist/database/sql/sqlSchema.cjs

@@ -80,6 +80,13 @@ const sqlTableShapes = (dialect, tables, tablePrefix = "") => tables.map((table)
 			columns: index.unique ? index.eq : columns
 		}];
 	});
+	const retention = table.retention && retentionOrder(table);
+	if (retention && !retention.indexed) indexes.push({
+		kind: "index",
+		name: shortSqlName(`${name}__retention`),
+		unique: false,
+		columns: retention.columns
+	});
 	return {
 		name,
 		columns: table.columns.map((column) => ({
@@ -107,9 +114,58 @@ const createTableStatements = (dialect, tables, tablePrefix = "") => {
 	};
 	return sqlTableShapes(dialect, tables, tablePrefix).flatMap(render);
 };
+/**
+* The order a prune walks a table's expired rows in, which ends with the
+* key so it is total: the columns of the first index that leads with the
+* retention column, or the key when it does, or else the column and the
+* key, which then need an index of their own (`indexed` false).
+*/
+const retentionOrder = (table) => {
+	const { column } = table.retention;
+	for (const index of table.indexes) {
+		const columns = [...index.eq, ...(0, _hot_updater_plugin_core_internal.indexOrderColumns)(table, index)];
+		if (!index.unique && !isMultiIndex(table, index) && columns[0] === column) return {
+			columns,
+			indexed: true
+		};
+	}
+	if (table.key[0] === column) return {
+		columns: table.key,
+		indexed: true
+	};
+	return {
+		columns: [column, ...table.key.filter((field) => field !== column)],
+		indexed: false
+	};
+};
+/**
+* The statements that delete up to `limit` expired rows of a table with
+* retention, oldest first in {@link retentionOrder}: its multi-valued index
+* entries, then the rows, which a concurrent write that moved the retention
+* column past `before` keeps. `before` renders the bound each time it
+* appears. MySQL deletes with ORDER BY and LIMIT. Elsewhere the cutoff is
+* the last of the `limit` oldest expired rows in that order, a row value
+* the index ranges over, and the shapes pass Supabase's apply RPC: no IN, no
+* AS, aliases `i` and `b`.
+*/
+const pruneStatements = (dialect, table, tablePrefix, limit) => {
+	const quote = (name) => quoteSql(dialect, name);
+	const name = quote(`${tablePrefix}${table.name}`);
+	const at = quote(table.retention.column);
+	const order = retentionOrder(table).columns.map(quote);
+	const list = (alias, direction = "") => order.map((column) => `${alias}.${column}${direction}`).join(", ");
+	const oldest = (before) => `SELECT ${list("i")} FROM ${name} i WHERE i.${at} <= ${before()} ORDER BY ${list("i", " ASC")} LIMIT ${limit}`;
+	const doomed = (alias, before) => `${alias}.${at} <= ${before()} AND (${list(alias)}) <= (SELECT ${list("b")} FROM (${oldest(before)}) b ORDER BY ${list("b", " DESC")} LIMIT 1)`;
+	const entries = table.indexes.filter((index) => isMultiIndex(table, index)).map((index) => quote(`${tablePrefix}${table.name}__${index.name}`));
+	const keyOf = (left, right) => table.key.map((column) => `${left}.${quote(column)} = ${right}.${quote(column)}`).join(" AND ");
+	if (dialect === "mysql") return [...entries.map((index) => (before) => `DELETE e FROM ${index} e JOIN (${oldest(before)}) d ON ${keyOf("e", "d")}`), (before) => `DELETE FROM ${name} WHERE ${at} <= ${before()} ORDER BY ${order.join(", ")} LIMIT ${limit}`];
+	return [...entries.map((index) => (before) => `DELETE FROM ${index} WHERE EXISTS (SELECT * FROM ${name} b WHERE ${keyOf("b", index)} AND ${doomed("b", before)})`), (before) => `DELETE FROM ${name} WHERE ${doomed(name, before)}`];
+};
 //#endregion
 exports.createTableStatements = createTableStatements;
 exports.isMultiIndex = isMultiIndex;
+exports.pruneStatements = pruneStatements;
 exports.quoteSql = quoteSql;
+exports.retentionOrder = retentionOrder;
 exports.shortSqlName = shortSqlName;
 exports.sqlTableShapes = sqlTableShapes;

package/dist/database/sql/sqlSchema.mjs

@@ -80,6 +80,13 @@ const sqlTableShapes = (dialect, tables, tablePrefix = "") => tables.map((table)
 			columns: index.unique ? index.eq : columns
 		}];
 	});
+	const retention = table.retention && retentionOrder(table);
+	if (retention && !retention.indexed) indexes.push({
+		kind: "index",
+		name: shortSqlName(`${name}__retention`),
+		unique: false,
+		columns: retention.columns
+	});
 	return {
 		name,
 		columns: table.columns.map((column) => ({
@@ -107,5 +114,52 @@ const createTableStatements = (dialect, tables, tablePrefix = "") => {
 	};
 	return sqlTableShapes(dialect, tables, tablePrefix).flatMap(render);
 };
+/**
+* The order a prune walks a table's expired rows in, which ends with the
+* key so it is total: the columns of the first index that leads with the
+* retention column, or the key when it does, or else the column and the
+* key, which then need an index of their own (`indexed` false).
+*/
+const retentionOrder = (table) => {
+	const { column } = table.retention;
+	for (const index of table.indexes) {
+		const columns = [...index.eq, ...indexOrderColumns(table, index)];
+		if (!index.unique && !isMultiIndex(table, index) && columns[0] === column) return {
+			columns,
+			indexed: true
+		};
+	}
+	if (table.key[0] === column) return {
+		columns: table.key,
+		indexed: true
+	};
+	return {
+		columns: [column, ...table.key.filter((field) => field !== column)],
+		indexed: false
+	};
+};
+/**
+* The statements that delete up to `limit` expired rows of a table with
+* retention, oldest first in {@link retentionOrder}: its multi-valued index
+* entries, then the rows, which a concurrent write that moved the retention
+* column past `before` keeps. `before` renders the bound each time it
+* appears. MySQL deletes with ORDER BY and LIMIT. Elsewhere the cutoff is
+* the last of the `limit` oldest expired rows in that order, a row value
+* the index ranges over, and the shapes pass Supabase's apply RPC: no IN, no
+* AS, aliases `i` and `b`.
+*/
+const pruneStatements = (dialect, table, tablePrefix, limit) => {
+	const quote = (name) => quoteSql(dialect, name);
+	const name = quote(`${tablePrefix}${table.name}`);
+	const at = quote(table.retention.column);
+	const order = retentionOrder(table).columns.map(quote);
+	const list = (alias, direction = "") => order.map((column) => `${alias}.${column}${direction}`).join(", ");
+	const oldest = (before) => `SELECT ${list("i")} FROM ${name} i WHERE i.${at} <= ${before()} ORDER BY ${list("i", " ASC")} LIMIT ${limit}`;
+	const doomed = (alias, before) => `${alias}.${at} <= ${before()} AND (${list(alias)}) <= (SELECT ${list("b")} FROM (${oldest(before)}) b ORDER BY ${list("b", " DESC")} LIMIT 1)`;
+	const entries = table.indexes.filter((index) => isMultiIndex(table, index)).map((index) => quote(`${tablePrefix}${table.name}__${index.name}`));
+	const keyOf = (left, right) => table.key.map((column) => `${left}.${quote(column)} = ${right}.${quote(column)}`).join(" AND ");
+	if (dialect === "mysql") return [...entries.map((index) => (before) => `DELETE e FROM ${index} e JOIN (${oldest(before)}) d ON ${keyOf("e", "d")}`), (before) => `DELETE FROM ${name} WHERE ${at} <= ${before()} ORDER BY ${order.join(", ")} LIMIT ${limit}`];
+	return [...entries.map((index) => (before) => `DELETE FROM ${index} WHERE EXISTS (SELECT * FROM ${name} b WHERE ${keyOf("b", index)} AND ${doomed("b", before)})`), (before) => `DELETE FROM ${name} WHERE ${doomed(name, before)}`];
+};
 //#endregion
-export { createTableStatements, isMultiIndex, quoteSql, shortSqlName, sqlTableShapes };
+export { createTableStatements, isMultiIndex, pruneStatements, quoteSql, retentionOrder, shortSqlName, sqlTableShapes };

package/dist/db/coreDatabase.cjs

@@ -0,0 +1,85 @@
+const require_resolveSchema = require("../database/resolveSchema.cjs");
+const require_schema = require("../core/schema.cjs");
+const require_fence = require("../database/fence.cjs");
+const require_schemaSettings = require("./schemaSettings.cjs");
+const require_engineMigrator = require("./engineMigrator.cjs");
+//#region src/db/coreDatabase.ts
+/** Core's tables: the tables every provider's tooling creates. */
+const coreSchema = require_resolveSchema.resolveSchema([require_schema.coreModule]);
+/** The settings rows a provider's database is fenced by. */
+const coreSettings = {
+	[require_fence.ENGINE_SCHEMA_KEY]: "1",
+	"schema.core": require_schema.HOT_UPDATER_SCHEMA_VERSION
+};
+/** What `hot-updater db` creates for a server without plugins. */
+const coreTarget = {
+	schema: coreSchema,
+	settings: coreSettings
+};
+/** Each plugin's `schema.<id>` settings row. */
+const pluginSettings = (plugins) => Object.fromEntries(plugins.map(({ id, schemaVersion }) => [`schema.${id}`, schemaVersion]));
+/** A plugin's schema as the engine resolves it: prefixed by its id unless it keeps its names. */
+const pluginModule = ({ id, schema, namespace }) => ({
+	id,
+	schema,
+	...namespace === false ? {} : { namespace: id }
+});
+/**
+* What `hot-updater db` creates for a server's plugins: core's tables, then
+* each plugin's tables with its `schema.<id>` settings row.
+*/
+const toolingTargetOf = (plugins) => plugins.length === 0 ? coreTarget : {
+	schema: require_resolveSchema.resolveSchema([require_schema.coreModule, ...plugins.map(pluginModule)]),
+	settings: {
+		...coreSettings,
+		...pluginSettings(plugins)
+	}
+};
+/**
+* Creates core's tables and those of `plugins`, then writes their settings
+* rows: what a provider's setup runs for the plugins its server runs.
+*/
+const migrateCoreSchema = (adapter, name, plugins = []) => {
+	const { schema, settings } = toolingTargetOf(plugins);
+	return require_schemaSettings.migrateSchema(adapter, name, schema.tables, settings);
+};
+/**
+* A provider's database on the storage engine: its adapter behind the schema
+* fence, which checks core's settings rows before the first read or write
+* and names `hot-updater db migrate` when they are missing or stale. When the
+* adapter creates its own tables, `hot-updater db migrate` creates core's
+* tables and the server's plugin tables, then writes their settings rows.
+*/
+const createEngineDatabase = ({ name, adapter, onCachedRoutesChange, aggregateBatching }) => {
+	const fenced = require_fence.withSchemaFence(adapter, name, coreSettings);
+	const createMigrator = ({ schema, settings } = coreTarget) => require_engineMigrator.createEngineMigrator({
+		adapterName: name,
+		adapter,
+		schema,
+		settings,
+		readSettings: async () => {
+			const rows = await require_fence.readSettings(adapter, Object.keys(settings)).catch((error) => {
+				if (require_fence.isMissingSchemaError(error)) return [];
+				throw error;
+			});
+			return new Map(rows.flatMap((row) => row === null ? [] : [[String(row.key), row.value]]));
+		}
+	});
+	return {
+		name,
+		adapter: fenced,
+		...onCachedRoutesChange === void 0 ? {} : { onCachedRoutesChange },
+		...aggregateBatching ? { aggregateBatching } : {},
+		...adapter.dispose === void 0 ? {} : { dispose: () => adapter.dispose() },
+		...adapter.migrations === void 0 ? {} : { createMigrator }
+	};
+};
+//#endregion
+exports.coreSchema = coreSchema;
+exports.coreSettings = coreSettings;
+exports.coreTarget = coreTarget;
+exports.createEngineDatabase = createEngineDatabase;
+exports.migrateCoreSchema = migrateCoreSchema;
+exports.pluginModule = pluginModule;
+exports.pluginSettings = pluginSettings;
+exports.toolingTargetOf = toolingTargetOf;

package/dist/db/coreDatabase.d.cts

@@ -0,0 +1,57 @@
+import { SchemaSettings } from "../database/fence.cjs";
+import { ModelShape } from "../database/definitions.cjs";
+import { ResolvedSchema } from "../database/resolveSchema.cjs";
+import { ToolingDatabase, ToolingTarget } from "./types.cjs";
+import "../database/index.cjs";
+import { AggregateBatching } from "@hot-updater/plugin-core";
+import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
+//#region src/db/coreDatabase.d.ts
+/** Core's tables: the tables every provider's tooling creates. */
+declare const coreSchema: ResolvedSchema;
+/** The settings rows a provider's database is fenced by. */
+declare const coreSettings: SchemaSettings;
+/** What `hot-updater db` creates for a server without plugins. */
+declare const coreTarget: ToolingTarget;
+/** A plugin as the tooling reads it: its id, its tables, and their version. */
+interface PluginTables {
+  readonly id: string;
+  readonly schemaVersion: string;
+  readonly schema: Readonly<Record<string, ModelShape>>;
+  /** `false` keeps the declared table names instead of prefixing them with the id. */
+  readonly namespace?: false;
+}
+/**
+ * What `hot-updater db` creates for a server's plugins: core's tables, then
+ * each plugin's tables with its `schema.<id>` settings row.
+ */
+declare const toolingTargetOf: (plugins: readonly PluginTables[]) => ToolingTarget;
+/**
+ * Creates core's tables and those of `plugins`, then writes their settings
+ * rows: what a provider's setup runs for the plugins its server runs.
+ */
+declare const migrateCoreSchema: (adapter: DatabaseAdapter, name: string, plugins?: readonly PluginTables[]) => Promise<void>;
+interface EngineDatabaseOptions {
+  readonly name: string;
+  readonly adapter: DatabaseAdapter;
+  /**
+   * Purges a CDN's copies of the cacheable client routes. Core calls it after
+   * a committed write that changes what those routes answer, since only core
+   * knows which of its tables they read.
+   */
+  readonly onCachedRoutesChange?: () => Promise<void>;
+  /**
+   * Batches aggregates declared `batched`, for stores that bill each write;
+   * `false` or absent commits them with each transaction.
+   */
+  readonly aggregateBatching?: AggregateBatching | false;
+}
+/**
+ * A provider's database on the storage engine: its adapter behind the schema
+ * fence, which checks core's settings rows before the first read or write
+ * and names `hot-updater db migrate` when they are missing or stale. When the
+ * adapter creates its own tables, `hot-updater db migrate` creates core's
+ * tables and the server's plugin tables, then writes their settings rows.
+ */
+declare const createEngineDatabase: ({ name, adapter, onCachedRoutesChange, aggregateBatching }: EngineDatabaseOptions) => ToolingDatabase;
+//#endregion
+export { EngineDatabaseOptions, PluginTables, coreSchema, coreSettings, coreTarget, createEngineDatabase, migrateCoreSchema, toolingTargetOf };

package/dist/db/coreDatabase.d.mts

@@ -0,0 +1,57 @@
+import { SchemaSettings } from "../database/fence.mjs";
+import { ModelShape } from "../database/definitions.mjs";
+import { ResolvedSchema } from "../database/resolveSchema.mjs";
+import { ToolingDatabase, ToolingTarget } from "./types.mjs";
+import "../database/index.mjs";
+import { AggregateBatching } from "@hot-updater/plugin-core";
+import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
+//#region src/db/coreDatabase.d.ts
+/** Core's tables: the tables every provider's tooling creates. */
+declare const coreSchema: ResolvedSchema;
+/** The settings rows a provider's database is fenced by. */
+declare const coreSettings: SchemaSettings;
+/** What `hot-updater db` creates for a server without plugins. */
+declare const coreTarget: ToolingTarget;
+/** A plugin as the tooling reads it: its id, its tables, and their version. */
+interface PluginTables {
+  readonly id: string;
+  readonly schemaVersion: string;
+  readonly schema: Readonly<Record<string, ModelShape>>;
+  /** `false` keeps the declared table names instead of prefixing them with the id. */
+  readonly namespace?: false;
+}
+/**
+ * What `hot-updater db` creates for a server's plugins: core's tables, then
+ * each plugin's tables with its `schema.<id>` settings row.
+ */
+declare const toolingTargetOf: (plugins: readonly PluginTables[]) => ToolingTarget;
+/**
+ * Creates core's tables and those of `plugins`, then writes their settings
+ * rows: what a provider's setup runs for the plugins its server runs.
+ */
+declare const migrateCoreSchema: (adapter: DatabaseAdapter, name: string, plugins?: readonly PluginTables[]) => Promise<void>;
+interface EngineDatabaseOptions {
+  readonly name: string;
+  readonly adapter: DatabaseAdapter;
+  /**
+   * Purges a CDN's copies of the cacheable client routes. Core calls it after
+   * a committed write that changes what those routes answer, since only core
+   * knows which of its tables they read.
+   */
+  readonly onCachedRoutesChange?: () => Promise<void>;
+  /**
+   * Batches aggregates declared `batched`, for stores that bill each write;
+   * `false` or absent commits them with each transaction.
+   */
+  readonly aggregateBatching?: AggregateBatching | false;
+}
+/**
+ * A provider's database on the storage engine: its adapter behind the schema
+ * fence, which checks core's settings rows before the first read or write
+ * and names `hot-updater db migrate` when they are missing or stale. When the
+ * adapter creates its own tables, `hot-updater db migrate` creates core's
+ * tables and the server's plugin tables, then writes their settings rows.
+ */
+declare const createEngineDatabase: ({ name, adapter, onCachedRoutesChange, aggregateBatching }: EngineDatabaseOptions) => ToolingDatabase;
+//#endregion
+export { EngineDatabaseOptions, PluginTables, coreSchema, coreSettings, coreTarget, createEngineDatabase, migrateCoreSchema, toolingTargetOf };

package/dist/db/coreDatabase.mjs

@@ -0,0 +1,78 @@
+import { resolveSchema } from "../database/resolveSchema.mjs";
+import { HOT_UPDATER_SCHEMA_VERSION, coreModule } from "../core/schema.mjs";
+import { ENGINE_SCHEMA_KEY, isMissingSchemaError, readSettings, withSchemaFence } from "../database/fence.mjs";
+import { migrateSchema } from "./schemaSettings.mjs";
+import { createEngineMigrator } from "./engineMigrator.mjs";
+//#region src/db/coreDatabase.ts
+/** Core's tables: the tables every provider's tooling creates. */
+const coreSchema = resolveSchema([coreModule]);
+/** The settings rows a provider's database is fenced by. */
+const coreSettings = {
+	[ENGINE_SCHEMA_KEY]: "1",
+	"schema.core": HOT_UPDATER_SCHEMA_VERSION
+};
+/** What `hot-updater db` creates for a server without plugins. */
+const coreTarget = {
+	schema: coreSchema,
+	settings: coreSettings
+};
+/** Each plugin's `schema.<id>` settings row. */
+const pluginSettings = (plugins) => Object.fromEntries(plugins.map(({ id, schemaVersion }) => [`schema.${id}`, schemaVersion]));
+/** A plugin's schema as the engine resolves it: prefixed by its id unless it keeps its names. */
+const pluginModule = ({ id, schema, namespace }) => ({
+	id,
+	schema,
+	...namespace === false ? {} : { namespace: id }
+});
+/**
+* What `hot-updater db` creates for a server's plugins: core's tables, then
+* each plugin's tables with its `schema.<id>` settings row.
+*/
+const toolingTargetOf = (plugins) => plugins.length === 0 ? coreTarget : {
+	schema: resolveSchema([coreModule, ...plugins.map(pluginModule)]),
+	settings: {
+		...coreSettings,
+		...pluginSettings(plugins)
+	}
+};
+/**
+* Creates core's tables and those of `plugins`, then writes their settings
+* rows: what a provider's setup runs for the plugins its server runs.
+*/
+const migrateCoreSchema = (adapter, name, plugins = []) => {
+	const { schema, settings } = toolingTargetOf(plugins);
+	return migrateSchema(adapter, name, schema.tables, settings);
+};
+/**
+* A provider's database on the storage engine: its adapter behind the schema
+* fence, which checks core's settings rows before the first read or write
+* and names `hot-updater db migrate` when they are missing or stale. When the
+* adapter creates its own tables, `hot-updater db migrate` creates core's
+* tables and the server's plugin tables, then writes their settings rows.
+*/
+const createEngineDatabase = ({ name, adapter, onCachedRoutesChange, aggregateBatching }) => {
+	const fenced = withSchemaFence(adapter, name, coreSettings);
+	const createMigrator = ({ schema, settings } = coreTarget) => createEngineMigrator({
+		adapterName: name,
+		adapter,
+		schema,
+		settings,
+		readSettings: async () => {
+			const rows = await readSettings(adapter, Object.keys(settings)).catch((error) => {
+				if (isMissingSchemaError(error)) return [];
+				throw error;
+			});
+			return new Map(rows.flatMap((row) => row === null ? [] : [[String(row.key), row.value]]));
+		}
+	});
+	return {
+		name,
+		adapter: fenced,
+		...onCachedRoutesChange === void 0 ? {} : { onCachedRoutesChange },
+		...aggregateBatching ? { aggregateBatching } : {},
+		...adapter.dispose === void 0 ? {} : { dispose: () => adapter.dispose() },
+		...adapter.migrations === void 0 ? {} : { createMigrator }
+	};
+};
+//#endregion
+export { coreSchema, coreSettings, coreTarget, createEngineDatabase, migrateCoreSchema, pluginModule, pluginSettings, toolingTargetOf };

package/dist/db/index.cjs

@@ -3,18 +3,22 @@ const require_baseCandidates = require("../core/baseCandidates.cjs");
 const require_api = require("../core/api.cjs");
 const require_fence = require("../database/fence.cjs");
 const require_engineSql = require("./engineSql.cjs");
+const require_clientPlugins = require("../assembly/clientPlugins.cjs");
 const require_version = require("../version.cjs");
 const require_createHotUpdaterCore = require("../createHotUpdaterCore.cjs");
 const require_databasePlugins = require("../assembly/databasePlugins.cjs");
+const require_pluginCli = require("../assembly/pluginCli.cjs");
 //#region src/db/index.ts
 const getDBMetadata = (hotUpdater) => {
 	const metadata = require_createHotUpdaterCore.getHotUpdaterCoreMetadata(hotUpdater);
 	if (!metadata) throw new Error("Database tooling requires a hotUpdater instance created by @hot-updater/server.");
 	return metadata;
 };
+/** A server's plugins as configured, whose commands the CLI adds. */
+const serverPluginsOf = (hotUpdater) => getDBMetadata(hotUpdater).plugins;
 /** Whether `hot-updater db generate` writes schema files for a server's database. */
 const generatesSchema = (hotUpdater) => getDBMetadata(hotUpdater).database.generateSchema !== void 0;
-/** The migrator for a server's database: its built-in tables and its plugins' tables. */
+/** The migrator for a server's database: core's tables and its plugins' tables. */
 function createMigrator(hotUpdater) {
 	const { database, target } = getDBMetadata(hotUpdater);
 	if (database.createMigrator === void 0) throw new Error(database.generateSchema === void 0 ? `The ${database.name} database has no migrator; its provider applies the schema.` : `The ${database.name} database applies its schema from migration files: run \`hot-updater db generate\`, then apply the file with the provider's tooling.`);
@@ -29,12 +33,18 @@ function generateSchema(hotUpdater, ...args) {
 //#endregion
 exports.HOT_UPDATER_SERVER_VERSION = require_version.HOT_UPDATER_SERVER_VERSION;
 exports.HotUpdaterSchemaMigrationRequiredError = require_fence.HotUpdaterSchemaMigrationRequiredError;
+exports.clientAuthOf = require_pluginCli.clientAuthOf;
+exports.clientPluginsOf = require_clientPlugins.clientPluginsOf;
 exports.createDatabaseCoreApi = require_api.createDatabaseCoreApi;
 exports.createDatabasePluginApis = require_databasePlugins.createDatabasePluginApis;
 exports.createMeasuredDatabase = require_databasePlugins.createMeasuredDatabase;
 exports.createMigrator = createMigrator;
+exports.generateClientCredential = require_pluginCli.generateClientCredential;
 exports.generateEngineSql = require_engineSql.generateEngineSql;
 exports.generateSchema = generateSchema;
 exports.generatesSchema = generatesSchema;
+exports.pluginCommandsOf = require_pluginCli.pluginCommandsOf;
+exports.provisionClientCredential = require_pluginCli.provisionClientCredential;
+exports.serverPluginsOf = serverPluginsOf;
 exports.settingsStatements = require_engineSql.settingsStatements;
 exports.targetBaseCandidateKey = require_baseCandidates.targetBaseCandidateKey;

package/dist/db/index.d.cts

@@ -1,7 +1,10 @@
 import { HotUpdaterSchemaMigrationRequiredError } from "../database/fence.cjs";
 import { DatabaseTooling, Migrator, SchemaGenerator, ToolingDatabase, ToolingTarget } from "./types.cjs";
+import { AnyHotUpdaterPlugin } from "../plugins/definePlugin.cjs";
 import { CoreApi, createDatabaseCoreApi } from "../core/api.cjs";
 import { MeasuredDatabase, MeasuredDatabaseOptions, createDatabasePluginApis, createMeasuredDatabase } from "../assembly/databasePlugins.cjs";
+import { ClientPluginSpec, clientPluginsOf } from "../assembly/clientPlugins.cjs";
+import { ClientAuthSpec, ClientCredentialSpec, PluginCommandEntry, ProvisionedClientCredential, clientAuthOf, generateClientCredential, pluginCommandsOf, provisionClientCredential } from "../assembly/pluginCli.cjs";
 import { targetBaseCandidateKey } from "../core/baseCandidates.cjs";
 import { EngineSqlOptions, generateEngineSql, settingsStatements } from "./engineSql.cjs";
 import { HOT_UPDATER_SERVER_VERSION } from "../version.cjs";
@@ -9,10 +12,12 @@ import { HOT_UPDATER_SERVER_VERSION } from "../version.cjs";
 type HotUpdaterDBTarget = {
   readonly adapterName: string;
 };
+/** A server's plugins as configured, whose commands the CLI adds. */
+declare const serverPluginsOf: (hotUpdater: HotUpdaterDBTarget) => readonly AnyHotUpdaterPlugin[];
 /** Whether `hot-updater db generate` writes schema files for a server's database. */
 declare const generatesSchema: (hotUpdater: HotUpdaterDBTarget) => boolean;
-/** The migrator for a server's database: its built-in tables and its plugins' tables. */
+/** The migrator for a server's database: core's tables and its plugins' tables. */
 declare function createMigrator(hotUpdater: HotUpdaterDBTarget): Migrator;
 declare function generateSchema(hotUpdater: HotUpdaterDBTarget, ...args: Parameters<SchemaGenerator>): ReturnType<SchemaGenerator>;
 //#endregion
-export { type CoreApi, type DatabaseTooling, type EngineSqlOptions, HOT_UPDATER_SERVER_VERSION, HotUpdaterDBTarget, HotUpdaterSchemaMigrationRequiredError, type MeasuredDatabase, type MeasuredDatabaseOptions, type Migrator, type SchemaGenerator, type ToolingDatabase, type ToolingTarget, createDatabaseCoreApi, createDatabasePluginApis, createMeasuredDatabase, createMigrator, generateEngineSql, generateSchema, generatesSchema, settingsStatements, targetBaseCandidateKey };
+export { type ClientAuthSpec, type ClientCredentialSpec, type ClientPluginSpec, type CoreApi, type DatabaseTooling, type EngineSqlOptions, HOT_UPDATER_SERVER_VERSION, HotUpdaterDBTarget, HotUpdaterSchemaMigrationRequiredError, type MeasuredDatabase, type MeasuredDatabaseOptions, type Migrator, type PluginCommandEntry, type ProvisionedClientCredential, type SchemaGenerator, type ToolingDatabase, type ToolingTarget, clientAuthOf, clientPluginsOf, createDatabaseCoreApi, createDatabasePluginApis, createMeasuredDatabase, createMigrator, generateClientCredential, generateEngineSql, generateSchema, generatesSchema, pluginCommandsOf, provisionClientCredential, serverPluginsOf, settingsStatements, targetBaseCandidateKey };

package/dist/db/index.d.mts

@@ -1,7 +1,10 @@
 import { HotUpdaterSchemaMigrationRequiredError } from "../database/fence.mjs";
 import { DatabaseTooling, Migrator, SchemaGenerator, ToolingDatabase, ToolingTarget } from "./types.mjs";
+import { AnyHotUpdaterPlugin } from "../plugins/definePlugin.mjs";
 import { CoreApi, createDatabaseCoreApi } from "../core/api.mjs";
 import { MeasuredDatabase, MeasuredDatabaseOptions, createDatabasePluginApis, createMeasuredDatabase } from "../assembly/databasePlugins.mjs";
+import { ClientPluginSpec, clientPluginsOf } from "../assembly/clientPlugins.mjs";
+import { ClientAuthSpec, ClientCredentialSpec, PluginCommandEntry, ProvisionedClientCredential, clientAuthOf, generateClientCredential, pluginCommandsOf, provisionClientCredential } from "../assembly/pluginCli.mjs";
 import { targetBaseCandidateKey } from "../core/baseCandidates.mjs";
 import { EngineSqlOptions, generateEngineSql, settingsStatements } from "./engineSql.mjs";
 import { HOT_UPDATER_SERVER_VERSION } from "../version.mjs";
@@ -9,10 +12,12 @@ import { HOT_UPDATER_SERVER_VERSION } from "../version.mjs";
 type HotUpdaterDBTarget = {
   readonly adapterName: string;
 };
+/** A server's plugins as configured, whose commands the CLI adds. */
+declare const serverPluginsOf: (hotUpdater: HotUpdaterDBTarget) => readonly AnyHotUpdaterPlugin[];
 /** Whether `hot-updater db generate` writes schema files for a server's database. */
 declare const generatesSchema: (hotUpdater: HotUpdaterDBTarget) => boolean;
-/** The migrator for a server's database: its built-in tables and its plugins' tables. */
+/** The migrator for a server's database: core's tables and its plugins' tables. */
 declare function createMigrator(hotUpdater: HotUpdaterDBTarget): Migrator;
 declare function generateSchema(hotUpdater: HotUpdaterDBTarget, ...args: Parameters<SchemaGenerator>): ReturnType<SchemaGenerator>;
 //#endregion
-export { type CoreApi, type DatabaseTooling, type EngineSqlOptions, HOT_UPDATER_SERVER_VERSION, HotUpdaterDBTarget, HotUpdaterSchemaMigrationRequiredError, type MeasuredDatabase, type MeasuredDatabaseOptions, type Migrator, type SchemaGenerator, type ToolingDatabase, type ToolingTarget, createDatabaseCoreApi, createDatabasePluginApis, createMeasuredDatabase, createMigrator, generateEngineSql, generateSchema, generatesSchema, settingsStatements, targetBaseCandidateKey };
+export { type ClientAuthSpec, type ClientCredentialSpec, type ClientPluginSpec, type CoreApi, type DatabaseTooling, type EngineSqlOptions, HOT_UPDATER_SERVER_VERSION, HotUpdaterDBTarget, HotUpdaterSchemaMigrationRequiredError, type MeasuredDatabase, type MeasuredDatabaseOptions, type Migrator, type PluginCommandEntry, type ProvisionedClientCredential, type SchemaGenerator, type ToolingDatabase, type ToolingTarget, clientAuthOf, clientPluginsOf, createDatabaseCoreApi, createDatabasePluginApis, createMeasuredDatabase, createMigrator, generateClientCredential, generateEngineSql, generateSchema, generatesSchema, pluginCommandsOf, provisionClientCredential, serverPluginsOf, settingsStatements, targetBaseCandidateKey };

package/dist/db/index.mjs

@@ -2,18 +2,22 @@ import { targetBaseCandidateKey } from "../core/baseCandidates.mjs";
 import { createDatabaseCoreApi } from "../core/api.mjs";
 import { HotUpdaterSchemaMigrationRequiredError } from "../database/fence.mjs";
 import { generateEngineSql, settingsStatements } from "./engineSql.mjs";
+import { clientPluginsOf } from "../assembly/clientPlugins.mjs";
 import { HOT_UPDATER_SERVER_VERSION } from "../version.mjs";
 import { getHotUpdaterCoreMetadata } from "../createHotUpdaterCore.mjs";
 import { createDatabasePluginApis, createMeasuredDatabase } from "../assembly/databasePlugins.mjs";
+import { clientAuthOf, generateClientCredential, pluginCommandsOf, provisionClientCredential } from "../assembly/pluginCli.mjs";
 //#region src/db/index.ts
 const getDBMetadata = (hotUpdater) => {
 	const metadata = getHotUpdaterCoreMetadata(hotUpdater);
 	if (!metadata) throw new Error("Database tooling requires a hotUpdater instance created by @hot-updater/server.");
 	return metadata;
 };
+/** A server's plugins as configured, whose commands the CLI adds. */
+const serverPluginsOf = (hotUpdater) => getDBMetadata(hotUpdater).plugins;
 /** Whether `hot-updater db generate` writes schema files for a server's database. */
 const generatesSchema = (hotUpdater) => getDBMetadata(hotUpdater).database.generateSchema !== void 0;
-/** The migrator for a server's database: its built-in tables and its plugins' tables. */
+/** The migrator for a server's database: core's tables and its plugins' tables. */
 function createMigrator(hotUpdater) {
 	const { database, target } = getDBMetadata(hotUpdater);
 	if (database.createMigrator === void 0) throw new Error(database.generateSchema === void 0 ? `The ${database.name} database has no migrator; its provider applies the schema.` : `The ${database.name} database applies its schema from migration files: run \`hot-updater db generate\`, then apply the file with the provider's tooling.`);
@@ -26,4 +30,4 @@ function generateSchema(hotUpdater, ...args) {
 	return database.generateSchema(version, name, target);
 }
 //#endregion
-export { HOT_UPDATER_SERVER_VERSION, HotUpdaterSchemaMigrationRequiredError, createDatabaseCoreApi, createDatabasePluginApis, createMeasuredDatabase, createMigrator, generateEngineSql, generateSchema, generatesSchema, settingsStatements, targetBaseCandidateKey };
+export { HOT_UPDATER_SERVER_VERSION, HotUpdaterSchemaMigrationRequiredError, clientAuthOf, clientPluginsOf, createDatabaseCoreApi, createDatabasePluginApis, createMeasuredDatabase, createMigrator, generateClientCredential, generateEngineSql, generateSchema, generatesSchema, pluginCommandsOf, provisionClientCredential, serverPluginsOf, settingsStatements, targetBaseCandidateKey };

package/dist/db/types.d.cts

@@ -52,7 +52,7 @@ interface Migrator {
 }
 /**
  * The tables `db migrate` and `db generate` create and the settings rows they
- * write: the built-in ones, and each third-party plugin's the server runs.
+ * write: core's, and those of each plugin the server runs.
  */
 interface ToolingTarget {
   readonly schema: ResolvedSchema;
@@ -64,8 +64,8 @@ type SchemaGenerator = (version: string | "latest", name?: string, target?: Tool
 };
 /**
  * What `hot-updater db generate` and `db migrate` run for a provider's
- * database, beside the database itself. Without a target they cover the
- * built-in tables.
+ * database, beside the database itself. Without a target they cover core's
+ * tables.
  */
 interface DatabaseTooling {
   readonly provider?: ORMProvider;

package/dist/db/types.d.mts

@@ -52,7 +52,7 @@ interface Migrator {
 }
 /**
  * The tables `db migrate` and `db generate` create and the settings rows they
- * write: the built-in ones, and each third-party plugin's the server runs.
+ * write: core's, and those of each plugin the server runs.
  */
 interface ToolingTarget {
   readonly schema: ResolvedSchema;
@@ -64,8 +64,8 @@ type SchemaGenerator = (version: string | "latest", name?: string, target?: Tool
 };
 /**
  * What `hot-updater db generate` and `db migrate` run for a provider's
- * database, beside the database itself. Without a target they cover the
- * built-in tables.
+ * database, beside the database itself. Without a target they cover core's
+ * tables.
  */
 interface DatabaseTooling {
   readonly provider?: ORMProvider;

package/dist/handler.cjs

@@ -1,6 +1,5 @@
 const require_fence = require("./database/fence.cjs");
-const require_routes = require("./insights/routes.cjs");
-const require_assemblePlugins = require("./assembly/assemblePlugins.cjs");
+const require_configError = require("./assembly/configError.cjs");
 const require_handlerErrors = require("./handlerErrors.cjs");
 const require_handlerAdminRoutes = require("./handlerAdminRoutes.cjs");
 const require_handlerReleaseCatalogRoutes = require("./handlerReleaseCatalogRoutes.cjs");
@@ -85,8 +84,6 @@ function createHotUpdaterHandlers({ api, clientPolicy, downloadStorageObject, en
 		...require_handlerVersionRoutes.createVersionRouteHandlers(plugins),
 		...require_handlerReleaseCatalogRoutes.createReleaseCatalogRouteHandlers(),
 		...require_handlerAdminRoutes.createAdminRouteHandlers(),
-		...Object.fromEntries(require_routes.INSIGHTS_ROUTES.map(({ handler }) => [handler, require_routes.insightsDisabled])),
-		appendBundleEvent: require_routes.createDroppedEventHandler(),
 		...downloadStorageObject === void 0 ? {} : { downloadStorageObject: createDownloadStorageRouteHandler(downloadStorageObject) }
 	};
 	const routes = [];
@@ -94,7 +91,7 @@ function createHotUpdaterHandlers({ api, clientPolicy, downloadStorageObject, en
 	const mount = (router, admin) => (method, path, handler) => {
 		const shape = `${admin ? "admin" : "client"} ${method} ${path.replaceAll(/:[^/]+/gu, ":")}`;
 		const taken = shapes.get(shape);
-		if (taken !== void 0) throw new require_assemblePlugins.HotUpdaterConfigError(`${handler} (${method} ${path}) collides with ${taken} on handlers.${admin ? "admin" : "client"}.`);
+		if (taken !== void 0) throw new require_configError.HotUpdaterConfigError(`${handler} (${method} ${path}) collides with ${taken} on handlers.${admin ? "admin" : "client"}.`);
 		shapes.set(shape, handler);
 		require_internalRouter.addRoute(router, method, path, handler);
 		routes.push({
@@ -103,13 +100,6 @@ function createHotUpdaterHandlers({ api, clientPolicy, downloadStorageObject, en
 			access: admin ? "admin" : PUBLIC_CLIENT_ROUTES.has(handler) ? "public" : "client"
 		});
 	};
-	/** The Insights routes no plugin endpoint serves, which answer that Insights is off. */
-	const mountInsights = (access, add) => {
-		for (const route of require_routes.INSIGHTS_ROUTES) {
-			const served = endpoints.some((endpoint) => endpoint.access === route.access && endpoint.method === route.method && endpoint.path === route.path);
-			if (route.access === access && !served) add(route.method, route.path, route.handler);
-		}
-	};
 	const clientRouter = require_internalRouter.createRouter();
 	const addClientRoute = mount(clientRouter, false);
 	addClientRoute("GET", "/version", "version");
@@ -117,12 +107,10 @@ function createHotUpdaterHandlers({ api, clientPolicy, downloadStorageObject, en
 	addClientRoute("GET", "/release-catalogs/app-version/:platform/:channelKey/:appVersion", "appVersionReleaseCatalog");
 	addClientRoute("GET", "/release-catalogs/fingerprint/:platform/:channelKey/:fingerprintHash", "fingerprintReleaseCatalog");
 	addClientRoute("GET", "/artifacts/v1/:targetBundleId/from/:currentBundleId", "artifactV1");
-	mountInsights("client", addClientRoute);
 	const adminRouter = require_internalRouter.createRouter();
 	const addAdminRoute = mount(adminRouter, true);
 	addAdminRoute("GET", "/version", "adminVersion");
 	for (const route of require_handlerAdminRoutes.ADMIN_ROUTES) addAdminRoute(route.method, route.path, route.handler);
-	mountInsights("admin", addAdminRoute);
 	for (const endpoint of endpoints) {
 		const name = `plugin ${endpoint.plugin}: ${endpoint.method} ${endpoint.path}`;
 		routeHandlers[name] = (params, request) => endpoint.handler(request, params);