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

package/dist/adapters/drizzle.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_settingsMigrator = require("../db/settingsMigrator.cjs");
-const require_builtInDatabase = require("../db/builtInDatabase.cjs");
+const require_coreDatabase = require("../db/coreDatabase.cjs");
 const require_sqlAdapter = require("../database/sql/sqlAdapter.cjs");
 const require_sqlProviders = require("./sqlProviders.cjs");
 const require_engineDrizzleSchema = require("../db/engineDrizzleSchema.cjs");
@@ -16,19 +16,19 @@ const drizzleAdapter = (config) => {
 	const provider = require_sqlProviders.checkSqlProvider("drizzleAdapter", config.provider);
 	const executor = require_drizzleExecutor.drizzleExecutor(config.db, provider);
 	return {
-		...require_builtInDatabase.createEngineDatabase({
+		...require_coreDatabase.createEngineDatabase({
 			name: "drizzle",
 			adapter: require_sqlAdapter.createSqlAdapter({ executor })
 		}),
 		provider,
-		generateSchema: ((version, _name, { schema } = require_builtInDatabase.builtInTarget) => {
-			if (version !== "latest" && version !== require_builtInDatabase.builtInSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+		generateSchema: ((version, _name, { schema } = require_coreDatabase.coreTarget) => {
+			if (version !== "latest" && version !== require_coreDatabase.coreSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
 			return {
 				code: require_engineDrizzleSchema.generateDrizzleEngineSchema(provider, schema),
 				path: "hot-updater-schema.ts"
 			};
 		}),
-		createMigrator: ({ settings } = require_builtInDatabase.builtInTarget) => require_settingsMigrator.createSettingsMigrator({
+		createMigrator: ({ settings } = require_coreDatabase.coreTarget) => require_settingsMigrator.createSettingsMigrator({
 			adapterName: "drizzle",
 			executor,
 			settings,

package/dist/adapters/drizzle.mjs

@@ -1,5 +1,5 @@
 import { createSettingsMigrator } from "../db/settingsMigrator.mjs";
-import { builtInSettings, builtInTarget, createEngineDatabase } from "../db/builtInDatabase.mjs";
+import { coreSettings, coreTarget, createEngineDatabase } from "../db/coreDatabase.mjs";
 import { createSqlAdapter } from "../database/sql/sqlAdapter.mjs";
 import { checkSqlProvider } from "./sqlProviders.mjs";
 import { generateDrizzleEngineSchema } from "../db/engineDrizzleSchema.mjs";
@@ -20,14 +20,14 @@ const drizzleAdapter = (config) => {
 			adapter: createSqlAdapter({ executor })
 		}),
 		provider,
-		generateSchema: ((version, _name, { schema } = builtInTarget) => {
-			if (version !== "latest" && version !== builtInSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+		generateSchema: ((version, _name, { schema } = coreTarget) => {
+			if (version !== "latest" && version !== coreSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
 			return {
 				code: generateDrizzleEngineSchema(provider, schema),
 				path: "hot-updater-schema.ts"
 			};
 		}),
-		createMigrator: ({ settings } = builtInTarget) => createSettingsMigrator({
+		createMigrator: ({ settings } = coreTarget) => createSettingsMigrator({
 			adapterName: "drizzle",
 			executor,
 			settings,

package/dist/adapters/kysely.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_builtInDatabase = require("../db/builtInDatabase.cjs");
+const require_coreDatabase = require("../db/coreDatabase.cjs");
 const require_sqlAdapter = require("../database/sql/sqlAdapter.cjs");
 const require_engineSqlMigrator = require("../db/engineSqlMigrator.cjs");
 const require_kyselyExecutor = require("./kyselyExecutor.cjs");
@@ -14,12 +14,12 @@ const kyselyAdapter = (config) => {
 	const provider = require_sqlProviders.checkSqlProvider("kyselyAdapter", config.provider);
 	const executor = require_kyselyExecutor.kyselyExecutor(config.db, provider);
 	return {
-		...require_builtInDatabase.createEngineDatabase({
+		...require_coreDatabase.createEngineDatabase({
 			name: "kysely",
 			adapter: require_sqlAdapter.createSqlAdapter({ executor })
 		}),
 		provider,
-		createMigrator: ({ schema, settings } = require_builtInDatabase.builtInTarget) => require_engineSqlMigrator.createEngineSqlMigrator({
+		createMigrator: ({ schema, settings } = require_coreDatabase.coreTarget) => require_engineSqlMigrator.createEngineSqlMigrator({
 			adapterName: "kysely",
 			executor,
 			schema,

package/dist/adapters/kysely.mjs

@@ -1,4 +1,4 @@
-import { builtInTarget, createEngineDatabase } from "../db/builtInDatabase.mjs";
+import { coreTarget, createEngineDatabase } from "../db/coreDatabase.mjs";
 import { createSqlAdapter } from "../database/sql/sqlAdapter.mjs";
 import { createEngineSqlMigrator } from "../db/engineSqlMigrator.mjs";
 import { kyselyExecutor } from "./kyselyExecutor.mjs";
@@ -18,7 +18,7 @@ const kyselyAdapter = (config) => {
 			adapter: createSqlAdapter({ executor })
 		}),
 		provider,
-		createMigrator: ({ schema, settings } = builtInTarget) => createEngineSqlMigrator({
+		createMigrator: ({ schema, settings } = coreTarget) => createEngineSqlMigrator({
 			adapterName: "kysely",
 			executor,
 			schema,

package/dist/adapters/mongodb.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_fence = require("../database/fence.cjs");
 const require_engineMigrator = require("../db/engineMigrator.cjs");
-const require_builtInDatabase = require("../db/builtInDatabase.cjs");
+const require_coreDatabase = require("../db/coreDatabase.cjs");
 const require_mongodbAdapter = require("./mongodbAdapter.cjs");
 //#region src/adapters/mongodb.ts
 /** Settings rows by their `key` field: the engine's rows and a v0 database's alike. */
@@ -17,12 +17,12 @@ const readSettings = (client) => async () => {
 const mongoAdapter = (config) => {
 	const adapter = require_mongodbAdapter.createMongoAdapter({ client: config.client });
 	return {
-		...require_builtInDatabase.createEngineDatabase({
+		...require_coreDatabase.createEngineDatabase({
 			name: "mongodb",
 			adapter
 		}),
 		provider: "mongodb",
-		createMigrator: ({ schema, settings } = require_builtInDatabase.builtInTarget) => require_engineMigrator.createEngineMigrator({
+		createMigrator: ({ schema, settings } = require_coreDatabase.coreTarget) => require_engineMigrator.createEngineMigrator({
 			adapterName: "mongodb",
 			adapter,
 			schema,

package/dist/adapters/mongodb.mjs

@@ -1,6 +1,6 @@
 import { SETTINGS_TABLE } from "../database/fence.mjs";
 import { createEngineMigrator } from "../db/engineMigrator.mjs";
-import { builtInTarget, createEngineDatabase } from "../db/builtInDatabase.mjs";
+import { coreTarget, createEngineDatabase } from "../db/coreDatabase.mjs";
 import { MongoTransactionUnsupportedError, createMongoAdapter } from "./mongodbAdapter.mjs";
 //#region src/adapters/mongodb.ts
 /** Settings rows by their `key` field: the engine's rows and a v0 database's alike. */
@@ -21,7 +21,7 @@ const mongoAdapter = (config) => {
 			adapter
 		}),
 		provider: "mongodb",
-		createMigrator: ({ schema, settings } = builtInTarget) => createEngineMigrator({
+		createMigrator: ({ schema, settings } = coreTarget) => createEngineMigrator({
 			adapterName: "mongodb",
 			adapter,
 			schema,

package/dist/adapters/mongodbAdapter.cjs

@@ -14,10 +14,22 @@ const byId = (_id, v) => v === void 0 ? { _id } : {
 	_id,
 	[_hot_updater_plugin_core_internal.DATABASE_VERSION_COLUMN]: v
 };
+/** MongoDB's TTL monitor deletes a document once its `_expireAt` passes. */
+const TTL = {
+	name: "_expireAt",
+	key: { _expireAt: 1 },
+	expireAfterSeconds: 0
+};
+/** When a row with retention expires; a null retention column never does. */
+const expireAt = ({ retention }, row) => {
+	const at = row[retention.column];
+	return typeof at === "number" ? new Date(at + retention.ms) : null;
+};
 /** Null columns are left out, so unique indexes skip them as SQL's do. */
 const toDocument = (table, row) => ({
 	_id: idOf(table, (0, _hot_updater_plugin_core_internal.rowKey)(table, row)),
-	...Object.fromEntries(table.columns.flatMap(({ name }) => row[name] === null || row[name] === void 0 ? [] : [[name, row[name]]]))
+	...Object.fromEntries(table.columns.flatMap(({ name }) => row[name] === null || row[name] === void 0 ? [] : [[name, row[name]]])),
+	...table.retention && { [TTL.name]: expireAt(table, row) }
 });
 /** `columns op bound` over a tuple prefix, expanded into ORs. */
 const compare = (columns, { values, inclusive }, op) => {
@@ -64,6 +76,10 @@ const createMongoAdapter = (options) => {
 				const $unset = {};
 				for (const [name, value] of Object.entries(op.set)) if (value === null) $unset[name] = "";
 				else $set[name] = value;
+				if (op.table.retention) $set[TTL.name] = expireAt(op.table, {
+					...op.previous,
+					...op.set
+				});
 				return update(byId(_id, op.guard.v), {
 					$set,
 					$unset
@@ -84,6 +100,7 @@ const createMongoAdapter = (options) => {
 					if (by !== void 0) set[name] = { $add: [stored, by] };
 					else if (start !== null) set[name] = stored;
 				}
+				if (op.table.retention) set[TTL.name] = expireAt(op.table, op.init);
 				await target.updateOne(byId(_id), [{ $set: set }], {
 					upsert: true,
 					session
@@ -163,6 +180,7 @@ const createMongoAdapter = (options) => {
 				await client.db().createCollection(tablePrefix + table.name).catch((error) => {
 					if (mongoError(error)?.code !== 48) throw error;
 				});
+				if (table.retention) await collection(table).createIndexes([TTL]);
 				if (table.indexes.length === 0) continue;
 				await collection(table).createIndexes(table.indexes.map((index) => indexDescription(table, index)));
 			}

package/dist/adapters/mongodbAdapter.mjs

@@ -14,10 +14,22 @@ const byId = (_id, v) => v === void 0 ? { _id } : {
 	_id,
 	[DATABASE_VERSION_COLUMN]: v
 };
+/** MongoDB's TTL monitor deletes a document once its `_expireAt` passes. */
+const TTL = {
+	name: "_expireAt",
+	key: { _expireAt: 1 },
+	expireAfterSeconds: 0
+};
+/** When a row with retention expires; a null retention column never does. */
+const expireAt = ({ retention }, row) => {
+	const at = row[retention.column];
+	return typeof at === "number" ? new Date(at + retention.ms) : null;
+};
 /** Null columns are left out, so unique indexes skip them as SQL's do. */
 const toDocument = (table, row) => ({
 	_id: idOf(table, rowKey(table, row)),
-	...Object.fromEntries(table.columns.flatMap(({ name }) => row[name] === null || row[name] === void 0 ? [] : [[name, row[name]]]))
+	...Object.fromEntries(table.columns.flatMap(({ name }) => row[name] === null || row[name] === void 0 ? [] : [[name, row[name]]])),
+	...table.retention && { [TTL.name]: expireAt(table, row) }
 });
 /** `columns op bound` over a tuple prefix, expanded into ORs. */
 const compare = (columns, { values, inclusive }, op) => {
@@ -64,6 +76,10 @@ const createMongoAdapter = (options) => {
 				const $unset = {};
 				for (const [name, value] of Object.entries(op.set)) if (value === null) $unset[name] = "";
 				else $set[name] = value;
+				if (op.table.retention) $set[TTL.name] = expireAt(op.table, {
+					...op.previous,
+					...op.set
+				});
 				return update(byId(_id, op.guard.v), {
 					$set,
 					$unset
@@ -84,6 +100,7 @@ const createMongoAdapter = (options) => {
 					if (by !== void 0) set[name] = { $add: [stored, by] };
 					else if (start !== null) set[name] = stored;
 				}
+				if (op.table.retention) set[TTL.name] = expireAt(op.table, op.init);
 				await target.updateOne(byId(_id), [{ $set: set }], {
 					upsert: true,
 					session
@@ -163,6 +180,7 @@ const createMongoAdapter = (options) => {
 				await client.db().createCollection(tablePrefix + table.name).catch((error) => {
 					if (mongoError(error)?.code !== 48) throw error;
 				});
+				if (table.retention) await collection(table).createIndexes([TTL]);
 				if (table.indexes.length === 0) continue;
 				await collection(table).createIndexes(table.indexes.map((index) => indexDescription(table, index)));
 			}

package/dist/adapters/prisma.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_settingsMigrator = require("../db/settingsMigrator.cjs");
-const require_builtInDatabase = require("../db/builtInDatabase.cjs");
+const require_coreDatabase = require("../db/coreDatabase.cjs");
 const require_sqlAdapter = require("../database/sql/sqlAdapter.cjs");
 const require_sqlProviders = require("./sqlProviders.cjs");
 const require_enginePrismaSchema = require("../db/enginePrismaSchema.cjs");
@@ -16,19 +16,19 @@ const prismaAdapter = (config) => {
 	const provider = require_sqlProviders.checkSqlProvider("prismaAdapter", config.provider);
 	const executor = require_prismaExecutor.prismaExecutor(config.prisma, provider);
 	return {
-		...require_builtInDatabase.createEngineDatabase({
+		...require_coreDatabase.createEngineDatabase({
 			name: "prisma",
 			adapter: require_sqlAdapter.createSqlAdapter({ executor })
 		}),
 		provider,
-		generateSchema: ((version, _name, { schema } = require_builtInDatabase.builtInTarget) => {
-			if (version !== "latest" && version !== require_builtInDatabase.builtInSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+		generateSchema: ((version, _name, { schema } = require_coreDatabase.coreTarget) => {
+			if (version !== "latest" && version !== require_coreDatabase.coreSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
 			return {
 				code: require_enginePrismaSchema.generatePrismaEngineSchema(provider, schema),
 				path: "prisma/schema.prisma"
 			};
 		}),
-		createMigrator: ({ schema, settings } = require_builtInDatabase.builtInTarget) => {
+		createMigrator: ({ schema, settings } = require_coreDatabase.coreTarget) => {
 			const collations = require_enginePrismaSchema.prismaCollationStatements(provider, schema);
 			return require_settingsMigrator.createSettingsMigrator({
 				adapterName: "prisma",

package/dist/adapters/prisma.mjs

@@ -1,5 +1,5 @@
 import { createSettingsMigrator } from "../db/settingsMigrator.mjs";
-import { builtInSettings, builtInTarget, createEngineDatabase } from "../db/builtInDatabase.mjs";
+import { coreSettings, coreTarget, createEngineDatabase } from "../db/coreDatabase.mjs";
 import { createSqlAdapter } from "../database/sql/sqlAdapter.mjs";
 import { checkSqlProvider } from "./sqlProviders.mjs";
 import { generatePrismaEngineSchema, prismaCollationStatements } from "../db/enginePrismaSchema.mjs";
@@ -20,14 +20,14 @@ const prismaAdapter = (config) => {
 			adapter: createSqlAdapter({ executor })
 		}),
 		provider,
-		generateSchema: ((version, _name, { schema } = builtInTarget) => {
-			if (version !== "latest" && version !== builtInSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
+		generateSchema: ((version, _name, { schema } = coreTarget) => {
+			if (version !== "latest" && version !== coreSettings["schema.core"]) throw new Error(`Invalid version ${version}`);
 			return {
 				code: generatePrismaEngineSchema(provider, schema),
 				path: "prisma/schema.prisma"
 			};
 		}),
-		createMigrator: ({ schema, settings } = builtInTarget) => {
+		createMigrator: ({ schema, settings } = coreTarget) => {
 			const collations = prismaCollationStatements(provider, schema);
 			return createSettingsMigrator({
 				adapterName: "prisma",

package/dist/assembly/assemblePlugins.cjs

@@ -1,22 +1,28 @@
+const require_aggregateBatching = require("../database/aggregateBatching.cjs");
+const require_retention = require("../database/retention.cjs");
 const require_resolveSchema = require("../database/resolveSchema.cjs");
 const require_database = require("../database/database.cjs");
 const require_reads = require("../core/reads.cjs");
 const require_schema = require("../core/schema.cjs");
 const require_api = require("../core/api.cjs");
 const require_fence = require("../database/fence.cjs");
-const require_builtIn = require("../plugins/builtIn.cjs");
-const require_builtInDatabase = require("../db/builtInDatabase.cjs");
+const require_coreDatabase = require("../db/coreDatabase.cjs");
+const require_configError = require("./configError.cjs");
+const require_clientPlugins = require("./clientPlugins.cjs");
 //#region src/assembly/assemblePlugins.ts
-/** A misconfigured `createHotUpdater` call, reported at startup. */
-var HotUpdaterConfigError = class extends Error {
-	name = "HotUpdaterConfigError";
-};
 const PLUGIN_KEYS = /* @__PURE__ */ new Set([
 	"id",
 	"provides",
 	"schemaVersion",
 	"schema",
-	"init"
+	"namespace",
+	"init",
+	"cli"
+]);
+const CLI_KEYS = /* @__PURE__ */ new Set([
+	"commands",
+	"clientCredential",
+	"clientPlugin"
 ]);
 const INSTANCE_KEYS = /* @__PURE__ */ new Set([
 	"api",
@@ -30,11 +36,12 @@ const METHODS = /* @__PURE__ */ new Set([
 	"PATCH",
 	"DELETE"
 ]);
-const BUILT_IN_ID = /^[a-z][A-Za-z0-9]*$/u;
-const PLUGIN_ID = /^[a-z][a-z0-9_]*$/u;
+/** An id that prefixes table names is a SQL name; one that does not may use camelCase. */
+const PREFIX_ID = /^[a-z][a-z0-9_]*$/u;
+const UNPREFIXED_ID = /^[a-z][A-Za-z0-9_]*$/u;
 const PATH = /^(\/(:?[A-Za-z0-9_.~-]+))+$/u;
 const fail = (message) => {
-	throw new HotUpdaterConfigError(message);
+	throw new require_configError.HotUpdaterConfigError(message);
 };
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const checkPlugin = (value, at) => {
@@ -43,12 +50,18 @@ const checkPlugin = (value, at) => {
 	const unknown = Object.keys(value).find((key) => !PLUGIN_KEYS.has(key));
 	if (unknown !== void 0) fail(`${at} has an unknown key "${unknown}".`);
 	const plugin = value;
-	const pattern = plugin[require_builtIn.builtInPlugin] ? BUILT_IN_ID : PLUGIN_ID;
+	if (plugin.namespace !== void 0 && plugin.namespace !== false) fail(`${at} may only set namespace: false.`);
+	const pattern = plugin.namespace === false ? UNPREFIXED_ID : PREFIX_ID;
 	if (typeof plugin.id !== "string" || !pattern.test(plugin.id)) fail(`${at} needs an id matching ${pattern.source}.`);
 	if (plugin.id === require_schema.coreModule.id) fail(`${at} uses the id "core", which is core's own.`);
 	if (typeof plugin.schemaVersion !== "string" || !isRecord(plugin.schema) || typeof plugin.init !== "function") fail(`Plugin "${plugin.id}" needs a schemaVersion, a schema, and init.`);
 	const provides = plugin.provides;
 	if (provides !== void 0 && (!isRecord(provides) || Object.entries(provides).some(([key, flag]) => key !== "clientAuth" || flag !== true))) fail(`Plugin "${plugin.id}" may only declare provides: { clientAuth: true }.`);
+	const cli = value.cli;
+	if (cli !== void 0) {
+		if (!isRecord(cli) || Object.keys(cli).some((key) => !CLI_KEYS.has(key)) || cli.commands !== void 0 && !Array.isArray(cli.commands)) fail(`Plugin "${plugin.id}" cli may only hold commands (an array), clientCredential, and clientPlugin.`);
+		if (cli.clientCredential !== void 0 && plugin.provides?.clientAuth !== true) fail(`Plugin "${plugin.id}" adds cli.clientCredential without declaring provides: { clientAuth: true }.`);
+	}
 	return plugin;
 };
 const checkEndpoint = (id, value) => {
@@ -82,7 +95,7 @@ const checkInstance = (plugin, instance) => {
 * database's storage adapter, and collects APIs, endpoints, and clientAuth.
 * Core's reads run on the same engine, so plugins read core through `ctx.core`.
 */
-const assemblePlugins = (value, adapter, { now = Date.now, storage = { resolveFileUrl: async () => null }, verify = false, onCachedRoutesChange } = {}) => {
+const assemblePlugins = (value, adapter, { now = Date.now, storage = { resolveFileUrl: async () => null }, verify = false, onCachedRoutesChange, batching } = {}) => {
 	if (!Array.isArray(value)) return fail("plugins must be an array of plugins.");
 	const plugins = value.map((plugin, position) => checkPlugin(plugin, `plugins[${position}]`));
 	const ids = /* @__PURE__ */ new Set();
@@ -90,22 +103,27 @@ const assemblePlugins = (value, adapter, { now = Date.now, storage = { resolveFi
 		if (ids.has(id)) fail(`Plugin "${id}" is registered twice.`);
 		ids.add(id);
 	}
-	const modules = plugins.map((plugin) => ({
-		id: plugin.id,
-		schema: plugin.schema,
-		...plugin[require_builtIn.builtInPlugin] ? {} : { namespace: plugin.id }
-	}));
-	const added = modules.filter(({ namespace }) => namespace !== void 0);
-	if (added.length > 0) {
-		const taken = added.find(({ id }) => require_builtInDatabase.builtInModules.some((module) => module.id === id));
-		if (taken !== void 0) fail(`Plugin "${taken.id}" uses a built-in plugin's id.`);
-		require_resolveSchema.validateSchema([...require_builtInDatabase.builtInModules, ...added]);
-	}
+	require_clientPlugins.clientPluginsOf(plugins);
+	const modules = plugins.map(require_coreDatabase.pluginModule);
+	if (modules.length > 0) require_resolveSchema.validateSchema([require_schema.coreModule, ...modules]);
 	const name = require_fence.fencedName(adapter);
+	const fenced = name === void 0 || plugins.length === 0 ? adapter : require_fence.withSchemaFence(adapter, name, require_coreDatabase.pluginSettings(plugins));
+	const schema = require_resolveSchema.resolveSchema([
+		require_schema.coreModule,
+		...modules,
+		...batching === void 0 ? [] : [require_aggregateBatching.aggregateBatchingModule]
+	]);
 	const engine = require_database.createDatabaseEngine({
-		adapter: name === void 0 || added.length === 0 ? adapter : require_fence.withSchemaFence(adapter, name, require_builtInDatabase.addedSettings(plugins)),
-		schema: require_resolveSchema.resolveSchema([require_schema.coreModule, ...modules]),
-		verify
+		adapter: verify ? fenced : require_retention.pruneDuringWrites(fenced, schema.tables, {
+			leaseTable: require_fence.SETTINGS_TABLE,
+			now
+		}),
+		schema,
+		verify,
+		...batching === void 0 ? {} : {
+			batching,
+			now
+		}
 	});
 	const coreDatabase = engine.database(require_schema.coreModule);
 	const core = require_api.createCoreApi(coreDatabase, storage, {
@@ -139,9 +157,10 @@ const assemblePlugins = (value, adapter, { now = Date.now, storage = { resolveFi
 		api,
 		endpoints,
 		...clientAuth === void 0 ? {} : { clientAuth },
-		...verify ? { measureReads: engine.measureReads } : {}
+		...verify ? { measureReads: engine.measureReads } : {},
+		flush: engine.flush
 	};
 };
 //#endregion
-exports.HotUpdaterConfigError = HotUpdaterConfigError;
+exports.HotUpdaterConfigError = require_configError.HotUpdaterConfigError;
 exports.assemblePlugins = assemblePlugins;

package/dist/assembly/assemblePlugins.d.cts

@@ -1,12 +1,8 @@
 import "../database/engine.cjs";
 import "../core/reads.cjs";
-import "../core/api.cjs";
 import "../plugins/definePlugin.cjs";
+import "../core/api.cjs";
+import { HotUpdaterConfigError } from "./configError.cjs";
+import { AggregateBatching } from "@hot-updater/plugin-core";
 import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
-//#region src/assembly/assemblePlugins.d.ts
-/** A misconfigured `createHotUpdater` call, reported at startup. */
-declare class HotUpdaterConfigError extends Error {
-  readonly name = "HotUpdaterConfigError";
-}
-//#endregion
 export { HotUpdaterConfigError };

package/dist/assembly/assemblePlugins.d.mts

@@ -1,12 +1,8 @@
 import "../database/engine.mjs";
 import "../core/reads.mjs";
-import "../core/api.mjs";
 import "../plugins/definePlugin.mjs";
+import "../core/api.mjs";
+import { HotUpdaterConfigError } from "./configError.mjs";
+import { AggregateBatching } from "@hot-updater/plugin-core";
 import { DatabaseAdapter } from "@hot-updater/plugin-core/internal";
-//#region src/assembly/assemblePlugins.d.ts
-/** A misconfigured `createHotUpdater` call, reported at startup. */
-declare class HotUpdaterConfigError extends Error {
-  readonly name = "HotUpdaterConfigError";
-}
-//#endregion
 export { HotUpdaterConfigError };

package/dist/assembly/assemblePlugins.mjs

@@ -1,22 +1,28 @@
+import { aggregateBatchingModule } from "../database/aggregateBatching.mjs";
+import { pruneDuringWrites } from "../database/retention.mjs";
 import { resolveSchema, validateSchema } from "../database/resolveSchema.mjs";
 import { createDatabaseEngine } from "../database/database.mjs";
 import { createCoreReads } from "../core/reads.mjs";
 import { coreModule } from "../core/schema.mjs";
 import { createCoreApi } from "../core/api.mjs";
-import { fencedName, withSchemaFence } from "../database/fence.mjs";
-import { builtInPlugin } from "../plugins/builtIn.mjs";
-import { addedSettings, builtInModules } from "../db/builtInDatabase.mjs";
+import { SETTINGS_TABLE, fencedName, withSchemaFence } from "../database/fence.mjs";
+import { pluginModule, pluginSettings } from "../db/coreDatabase.mjs";
+import { HotUpdaterConfigError } from "./configError.mjs";
+import { clientPluginsOf } from "./clientPlugins.mjs";
 //#region src/assembly/assemblePlugins.ts
-/** A misconfigured `createHotUpdater` call, reported at startup. */
-var HotUpdaterConfigError = class extends Error {
-	name = "HotUpdaterConfigError";
-};
 const PLUGIN_KEYS = /* @__PURE__ */ new Set([
 	"id",
 	"provides",
 	"schemaVersion",
 	"schema",
-	"init"
+	"namespace",
+	"init",
+	"cli"
+]);
+const CLI_KEYS = /* @__PURE__ */ new Set([
+	"commands",
+	"clientCredential",
+	"clientPlugin"
 ]);
 const INSTANCE_KEYS = /* @__PURE__ */ new Set([
 	"api",
@@ -30,8 +36,9 @@ const METHODS = /* @__PURE__ */ new Set([
 	"PATCH",
 	"DELETE"
 ]);
-const BUILT_IN_ID = /^[a-z][A-Za-z0-9]*$/u;
-const PLUGIN_ID = /^[a-z][a-z0-9_]*$/u;
+/** An id that prefixes table names is a SQL name; one that does not may use camelCase. */
+const PREFIX_ID = /^[a-z][a-z0-9_]*$/u;
+const UNPREFIXED_ID = /^[a-z][A-Za-z0-9_]*$/u;
 const PATH = /^(\/(:?[A-Za-z0-9_.~-]+))+$/u;
 const fail = (message) => {
 	throw new HotUpdaterConfigError(message);
@@ -43,12 +50,18 @@ const checkPlugin = (value, at) => {
 	const unknown = Object.keys(value).find((key) => !PLUGIN_KEYS.has(key));
 	if (unknown !== void 0) fail(`${at} has an unknown key "${unknown}".`);
 	const plugin = value;
-	const pattern = plugin[builtInPlugin] ? BUILT_IN_ID : PLUGIN_ID;
+	if (plugin.namespace !== void 0 && plugin.namespace !== false) fail(`${at} may only set namespace: false.`);
+	const pattern = plugin.namespace === false ? UNPREFIXED_ID : PREFIX_ID;
 	if (typeof plugin.id !== "string" || !pattern.test(plugin.id)) fail(`${at} needs an id matching ${pattern.source}.`);
 	if (plugin.id === coreModule.id) fail(`${at} uses the id "core", which is core's own.`);
 	if (typeof plugin.schemaVersion !== "string" || !isRecord(plugin.schema) || typeof plugin.init !== "function") fail(`Plugin "${plugin.id}" needs a schemaVersion, a schema, and init.`);
 	const provides = plugin.provides;
 	if (provides !== void 0 && (!isRecord(provides) || Object.entries(provides).some(([key, flag]) => key !== "clientAuth" || flag !== true))) fail(`Plugin "${plugin.id}" may only declare provides: { clientAuth: true }.`);
+	const cli = value.cli;
+	if (cli !== void 0) {
+		if (!isRecord(cli) || Object.keys(cli).some((key) => !CLI_KEYS.has(key)) || cli.commands !== void 0 && !Array.isArray(cli.commands)) fail(`Plugin "${plugin.id}" cli may only hold commands (an array), clientCredential, and clientPlugin.`);
+		if (cli.clientCredential !== void 0 && plugin.provides?.clientAuth !== true) fail(`Plugin "${plugin.id}" adds cli.clientCredential without declaring provides: { clientAuth: true }.`);
+	}
 	return plugin;
 };
 const checkEndpoint = (id, value) => {
@@ -82,7 +95,7 @@ const checkInstance = (plugin, instance) => {
 * database's storage adapter, and collects APIs, endpoints, and clientAuth.
 * Core's reads run on the same engine, so plugins read core through `ctx.core`.
 */
-const assemblePlugins = (value, adapter, { now = Date.now, storage = { resolveFileUrl: async () => null }, verify = false, onCachedRoutesChange } = {}) => {
+const assemblePlugins = (value, adapter, { now = Date.now, storage = { resolveFileUrl: async () => null }, verify = false, onCachedRoutesChange, batching } = {}) => {
 	if (!Array.isArray(value)) return fail("plugins must be an array of plugins.");
 	const plugins = value.map((plugin, position) => checkPlugin(plugin, `plugins[${position}]`));
 	const ids = /* @__PURE__ */ new Set();
@@ -90,22 +103,27 @@ const assemblePlugins = (value, adapter, { now = Date.now, storage = { resolveFi
 		if (ids.has(id)) fail(`Plugin "${id}" is registered twice.`);
 		ids.add(id);
 	}
-	const modules = plugins.map((plugin) => ({
-		id: plugin.id,
-		schema: plugin.schema,
-		...plugin[builtInPlugin] ? {} : { namespace: plugin.id }
-	}));
-	const added = modules.filter(({ namespace }) => namespace !== void 0);
-	if (added.length > 0) {
-		const taken = added.find(({ id }) => builtInModules.some((module) => module.id === id));
-		if (taken !== void 0) fail(`Plugin "${taken.id}" uses a built-in plugin's id.`);
-		validateSchema([...builtInModules, ...added]);
-	}
+	clientPluginsOf(plugins);
+	const modules = plugins.map(pluginModule);
+	if (modules.length > 0) validateSchema([coreModule, ...modules]);
 	const name = fencedName(adapter);
+	const fenced = name === void 0 || plugins.length === 0 ? adapter : withSchemaFence(adapter, name, pluginSettings(plugins));
+	const schema = resolveSchema([
+		coreModule,
+		...modules,
+		...batching === void 0 ? [] : [aggregateBatchingModule]
+	]);
 	const engine = createDatabaseEngine({
-		adapter: name === void 0 || added.length === 0 ? adapter : withSchemaFence(adapter, name, addedSettings(plugins)),
-		schema: resolveSchema([coreModule, ...modules]),
-		verify
+		adapter: verify ? fenced : pruneDuringWrites(fenced, schema.tables, {
+			leaseTable: SETTINGS_TABLE,
+			now
+		}),
+		schema,
+		verify,
+		...batching === void 0 ? {} : {
+			batching,
+			now
+		}
 	});
 	const coreDatabase = engine.database(coreModule);
 	const core = createCoreApi(coreDatabase, storage, {
@@ -139,7 +157,8 @@ const assemblePlugins = (value, adapter, { now = Date.now, storage = { resolveFi
 		api,
 		endpoints,
 		...clientAuth === void 0 ? {} : { clientAuth },
-		...verify ? { measureReads: engine.measureReads } : {}
+		...verify ? { measureReads: engine.measureReads } : {},
+		flush: engine.flush
 	};
 };
 //#endregion