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

package/dist/core/baseCandidates.mjs

@@ -1,47 +1,6 @@
 import { parseCompiledCatalog } from "../db/releaseCatalog.mjs";
-import { createReleaseCatalogScopeKey, encodeChannelKey, parseReleaseCatalogScopeKey } from "@hot-updater/core";
-import { normalizeRange, rangesIntersect } from "verkit";
+import { rangesIntersect } from "verkit";
 //#region src/core/baseCandidates.ts
-/**
-* A new bundle's base-candidate key: the Release Catalog scope its devices
-* update from, and for an app version its normalized range; null for a
-* target without a valid range.
-*/
-const targetBaseCandidateKey = (target) => {
-	const channelKey = encodeChannelKey(target.channel);
-	if (target.fingerprintHash) return JSON.stringify([createReleaseCatalogScopeKey({
-		channelKey,
-		fingerprintHash: target.fingerprintHash,
-		platform: target.platform,
-		strategy: "FINGERPRINT"
-	})]);
-	const range = target.appVersion === null ? null : normalizeRange(target.appVersion);
-	return range === null ? null : JSON.stringify([createReleaseCatalogScopeKey({
-		channelKey,
-		platform: target.platform,
-		strategy: "APP_VERSION"
-	}), range]);
-};
-/** The scope and range a base-candidate key names; null for any other string. */
-const parseBaseCandidateKey = (key) => {
-	try {
-		const parsed = JSON.parse(key);
-		if (!Array.isArray(parsed) || typeof parsed[0] !== "string") return null;
-		const [scopeKey, text] = parsed;
-		const { strategy } = parseReleaseCatalogScopeKey(scopeKey);
-		if (strategy === "FINGERPRINT") return parsed.length === 1 ? {
-			scopeKey,
-			range: null
-		} : null;
-		const range = parsed.length === 2 && typeof text === "string" ? normalizeRange(text) : null;
-		return range === null ? null : {
-			scopeKey,
-			range
-		};
-	} catch {
-		return null;
-	}
-};
 /** A compiled segment as a range: its version when it holds exactly one. */
 const segmentRange = ({ lower, upper }) => lower?.inclusive && upper?.inclusive && lower.version === upper.version ? lower.version : [lower === null ? "" : `${lower.inclusive ? ">=" : ">"}${lower.version}`, upper === null ? "" : `${upper.inclusive ? "<=" : "<"}${upper.version}`].join(" ").trim() || "*";
 /**
@@ -66,4 +25,4 @@ const baseBundleIdsOf = (row, range, bundleId, limit) => {
 	return ids;
 };
 //#endregion
-export { baseBundleIdsOf, parseBaseCandidateKey, targetBaseCandidateKey };
+export { baseBundleIdsOf };

package/dist/core/operations.cjs

@@ -1,10 +1,8 @@
-const require_errors = require("../database/errors.cjs");
 const require_reads = require("./reads.cjs");
 const require_writes = require("./writes.cjs");
 const require_releases = require("./releases.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
-let _hot_updater_core = require("@hot-updater/core");
+let _hot_updater_protocol = require("@hot-updater/protocol");
 //#region src/core/operations.ts
 /** Carries a preflight's result out of the transaction it stops, so nothing is written. */
 var Preflight = class extends Error {
@@ -27,13 +25,13 @@ const dryRun = async (db, read) => {
 };
 /** A channel's catalog scope for a platform, and a fingerprint when it has one. */
 const scopeOf = (channel, platform, fingerprintHash) => {
-	const channelKey = (0, _hot_updater_core.encodeChannelKey)(channel.name);
+	const channelKey = (0, _hot_updater_protocol.encodeChannelKey)(channel.name);
 	return fingerprintHash === null ? {
 		channelId: channel.id,
 		channelName: channel.name,
 		fingerprintHash,
 		platform,
-		scopeKey: (0, _hot_updater_core.createReleaseCatalogScopeKey)({
+		scopeKey: (0, _hot_updater_protocol.createReleaseCatalogScopeKey)({
 			channelKey,
 			platform,
 			strategy: "APP_VERSION"
@@ -44,7 +42,7 @@ const scopeOf = (channel, platform, fingerprintHash) => {
 		channelName: channel.name,
 		fingerprintHash,
 		platform,
-		scopeKey: (0, _hot_updater_core.createReleaseCatalogScopeKey)({
+		scopeKey: (0, _hot_updater_protocol.createReleaseCatalogScopeKey)({
 			channelKey,
 			fingerprintHash,
 			platform,
@@ -65,7 +63,7 @@ const loadTarget = async (tx, { releaseId, expectedRevision }) => {
 		release,
 		scope: {
 			channelId: release.channel_id,
-			channelName: (0, _hot_updater_core.decodeChannelKey)(catalog.channel_key),
+			channelName: (0, _hot_updater_protocol.decodeChannelKey)(catalog.channel_key),
 			fingerprintHash: release.fingerprint_hash,
 			platform: release.platform,
 			scopeKey: release.scope_key,
@@ -96,7 +94,7 @@ const catalogScope = async (tx, scopeKey) => {
 	if (row === null) throw new Error(`Release catalog "${scopeKey}" was not found.`);
 	return {
 		channelId: row.channel_id,
-		channelName: (0, _hot_updater_core.decodeChannelKey)(row.channel_key),
+		channelName: (0, _hot_updater_protocol.decodeChannelKey)(row.channel_key),
 		fingerprintHash: row.fingerprint_hash,
 		platform: row.platform,
 		scopeKey: row.scope_key,
@@ -110,7 +108,7 @@ const catalogScope = async (tx, scopeKey) => {
 */
 const createCoreOperations = (db, { now = Date.now } = {}) => {
 	const ensureChannel = async (name) => (await require_writes.insertChannel(db, {
-		id: `channel:${(0, _hot_updater_core.encodeChannelKey)(name)}`,
+		id: `channel:${(0, _hot_updater_protocol.encodeChannelKey)(name)}`,
 		name
 	})).row;
 	/**
@@ -121,7 +119,7 @@ const createCoreOperations = (db, { now = Date.now } = {}) => {
 		for (let attempt = 1;; attempt += 1) try {
 			return await write();
 		} catch (error) {
-			if (attempt < 3 && error instanceof require_errors.DatabaseConstraintError && error.reason === "not_found" && error.model === "channels") continue;
+			if (attempt < 3 && error instanceof _hot_updater_plugin_core.DatabaseConstraintError && error.reason === "not_found" && error.model === "channels") continue;
 			throw error;
 		}
 	};
@@ -218,7 +216,8 @@ const createCoreOperations = (db, { now = Date.now } = {}) => {
 		deleteRelease: (input) => db.transaction(async (tx) => {
 			const { release, scope } = await loadTarget(tx, input);
 			if (release.enabled) throw new _hot_updater_plugin_core.ReleaseManagementError("ENABLED_RELEASE", `Disable Release "${release.id}" before hard deletion.`);
-			return mutationResult(await require_releases.changeRelease(tx, {
+			const bundle = release.bundle_id === null ? null : await tx.findOne("bundles", { id: release.bundle_id });
+			const result = mutationResult(await require_releases.changeRelease(tx, {
 				scope,
 				change: {
 					operation: "delete",
@@ -226,6 +225,8 @@ const createCoreOperations = (db, { now = Date.now } = {}) => {
 				},
 				updatedAtMs: now()
 			}));
+			if (bundle !== null && (bundle._refs_releases_bundle_id ?? 0) <= 1) await require_writes.deleteBundle(tx, bundle);
+			return result;
 		}),
 		promoteRelease: (input) => withChannels(async () => {
 			const checkSource = (source) => {
@@ -340,7 +341,7 @@ const createCoreOperations = (db, { now = Date.now } = {}) => {
 					}
 				});
 			} catch (error) {
-				if (error instanceof require_errors.DatabaseConstraintError && error.reason === "referenced") throw new _hot_updater_plugin_core_internal.DatabaseRowReferencedError();
+				if (error instanceof _hot_updater_plugin_core.DatabaseConstraintError && error.reason === "referenced") throw new _hot_updater_plugin_core.DatabaseRowReferencedError();
 				throw error;
 			}
 		}

package/dist/core/operations.mjs

@@ -1,10 +1,8 @@
-import { DatabaseConstraintError } from "../database/errors.mjs";
 import { toBundleRow, toReleaseRow } from "./reads.mjs";
 import { deleteBundle, deleteChannel, insertChannel, replaceBundlePatches, updateBundle } from "./writes.mjs";
 import { changeRelease, changeReleases, readCatalog, rebuildScope } from "./releases.mjs";
-import { DatabaseBundleNotFoundError, ReleaseCatalogMutationError, ReleaseManagementError, bundleToPatchRows, bundleToRow, createUUIDv7After, isUUIDv7, rowToBundle } from "@hot-updater/plugin-core";
-import { DatabaseRowReferencedError } from "@hot-updater/plugin-core/internal";
-import { createReleaseCatalogScopeKey, decodeChannelKey, encodeChannelKey } from "@hot-updater/core";
+import { DatabaseBundleNotFoundError, DatabaseConstraintError, DatabaseRowReferencedError, ReleaseCatalogMutationError, ReleaseManagementError, bundleToPatchRows, bundleToRow, createUUIDv7After, isUUIDv7, rowToBundle } from "@hot-updater/plugin-core";
+import { createReleaseCatalogScopeKey, decodeChannelKey, encodeChannelKey } from "@hot-updater/protocol";
 //#region src/core/operations.ts
 /** Carries a preflight's result out of the transaction it stops, so nothing is written. */
 var Preflight = class extends Error {
@@ -218,7 +216,8 @@ const createCoreOperations = (db, { now = Date.now } = {}) => {
 		deleteRelease: (input) => db.transaction(async (tx) => {
 			const { release, scope } = await loadTarget(tx, input);
 			if (release.enabled) throw new ReleaseManagementError("ENABLED_RELEASE", `Disable Release "${release.id}" before hard deletion.`);
-			return mutationResult(await changeRelease(tx, {
+			const bundle = release.bundle_id === null ? null : await tx.findOne("bundles", { id: release.bundle_id });
+			const result = mutationResult(await changeRelease(tx, {
 				scope,
 				change: {
 					operation: "delete",
@@ -226,6 +225,8 @@ const createCoreOperations = (db, { now = Date.now } = {}) => {
 				},
 				updatedAtMs: now()
 			}));
+			if (bundle !== null && (bundle._refs_releases_bundle_id ?? 0) <= 1) await deleteBundle(tx, bundle);
+			return result;
 		}),
 		promoteRelease: (input) => withChannels(async () => {
 			const checkSource = (source) => {

package/dist/core/reads.cjs

@@ -2,7 +2,7 @@ const require_releaseCatalog = require("../db/releaseCatalog.cjs");
 const require_updateArtifacts = require("../db/updateArtifacts.cjs");
 const require_baseCandidates = require("./baseCandidates.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
-let _hot_updater_core = require("@hot-updater/core");
+let _hot_updater_protocol = require("@hot-updater/protocol");
 //#region src/core/reads.ts
 const PAGE = 500;
 const pick = (fields) => (row) => Object.fromEntries(fields.map((field) => [field, row[field]]));
@@ -108,8 +108,8 @@ const createCoreReads = (db, storage) => {
 		/** Artifact resolution: one batch read of both bundles and one unique read of their patch. */
 		async getArtifactInfo(targetBundleId, currentBundleId, artifactProtocolVersion) {
 			const { readStorageText } = storage;
-			if (artifactProtocolVersion !== _hot_updater_core.ARTIFACT_PROTOCOL_VERSION || readStorageText === void 0) return null;
-			const withCurrent = currentBundleId !== _hot_updater_core.NIL_UUID;
+			if (artifactProtocolVersion !== _hot_updater_protocol.ARTIFACT_PROTOCOL_VERSION || readStorageText === void 0) return null;
+			const withCurrent = currentBundleId !== _hot_updater_protocol.NIL_UUID;
 			const [[target, current], patch] = await Promise.all([db.findByKeys("bundles", withCurrent ? [{ id: targetBundleId }, { id: currentBundleId }] : [{ id: targetBundleId }]), withCurrent ? db.findOne("bundle_patches", {
 				bundle_id: targetBundleId,
 				base_bundle_id: currentBundleId
@@ -172,7 +172,7 @@ const createCoreReads = (db, storage) => {
 		},
 		/** Auto-patch bases for a new bundle: one point read of its scope's catalog. */
 		async findBaseBundleIds(candidateKey, bundleId, limit) {
-			const query = require_baseCandidates.parseBaseCandidateKey(candidateKey);
+			const query = (0, _hot_updater_plugin_core.parseBaseCandidateKey)(candidateKey);
 			if (query === null) return [];
 			const row = await db.findOne("release_catalogs", { scope_key: query.scopeKey });
 			return row === null ? [] : require_baseCandidates.baseBundleIdsOf(toCatalogRow(row), query.range, bundleId, limit);

package/dist/core/reads.d.cts

@@ -1,48 +1,9 @@
-import "../database/engineReads.cjs";
-import { HotUpdaterDatabase } from "../database/database.cjs";
-import { ReleaseCatalogRequest } from "../db/releaseCatalog.cjs";
-import { CoreSchema } from "./schema.cjs";
-import { BundleDetail, BundlePatchRow, ChannelRow, KeysetInput, ReleaseCatalogRow, ReleaseFilter, ReleaseRow } from "@hot-updater/plugin-core";
-import { ArtifactInfo, ReleaseCatalog } from "@hot-updater/core";
+import { CoreSchema, HotUpdaterDatabase } from "@hot-updater/plugin-core";
 //#region src/core/reads.d.ts
 type CoreDatabase = HotUpdaterDatabase<CoreSchema>;
 interface CoreStorage {
   readonly readStorageText?: (storageUri: string) => Promise<string | null>;
   readonly resolveFileUrl: (storageUri: string | null) => Promise<string | null>;
 }
-/** Core's reads, each through one declared index or key. */
-declare const createCoreReads: (db: CoreDatabase, storage: CoreStorage) => {
-  /** The update check: one point read of its scope's catalog. */
-  getReleaseCatalog(input: ReleaseCatalogRequest): Promise<ReleaseCatalog | null>;
-  /** Artifact resolution: one batch read of both bundles and one unique read of their patch. */
-  getArtifactInfo(targetBundleId: string, currentBundleId: string, artifactProtocolVersion: 1): Promise<ArtifactInfo | null>;
-  /** A bundle, its patches, and how many patches start from it. */
-  getBundle(id: string): Promise<BundleDetail | null>;
-  /** One page of the patches that start from a bundle, by target bundle id. */
-  /** Each base bundle's reference counter: one batch read of the bundle rows, and no patches. */
-  countBundleChildren(baseBundleIds: readonly string[]): Promise<Record<string, number>>;
-  listPatchesFromBase(baseBundleId: string, input: KeysetInput): Promise<BundlePatchRow[]>;
-  /** One page of bundles with their patches, oldest or newest first, optionally for one platform. */
-  listBundles(input: KeysetInput & {
-    readonly platform?: "ios" | "android";
-  }): Promise<BundleDetail[]>;
-  /** Bundles in total or for one platform: one counter row. */
-  countBundles(platform?: "ios" | "android"): Promise<number>;
-  /** Auto-patch bases for a new bundle: one point read of its scope's catalog. */
-  findBaseBundleIds(candidateKey: string, bundleId: string, limit: number): Promise<string[]>;
-  getRelease(id: string): Promise<ReleaseRow | null>;
-  /** One page of releases through the index its filter names. */
-  listReleases(input: KeysetInput & {
-    readonly filter: ReleaseFilter;
-  }): Promise<ReleaseRow[]>;
-  /** A scope's newest release id: `byScope` descending, limit 1. */
-  latestReleaseId(scopeKey: string): Promise<string | null>;
-  getReleaseCatalogRow(scopeKey: string): Promise<ReleaseCatalogRow | null>;
-  listReleaseCatalogs(input: KeysetInput): Promise<ReleaseCatalogRow[]>;
-  /** Every channel, by name. */
-  listChannels(): Promise<ChannelRow[]>;
-  findChannelByName(name: string): Promise<ChannelRow | null>;
-};
-type CoreReads = ReturnType<typeof createCoreReads>;
 //#endregion
-export { type BundleDetail, CoreDatabase, CoreReads, CoreStorage, type KeysetInput, type ReleaseFilter, createCoreReads };
+export { CoreDatabase, CoreStorage };

package/dist/core/reads.d.mts

@@ -1,48 +1,9 @@
-import "../database/engineReads.mjs";
-import { HotUpdaterDatabase } from "../database/database.mjs";
-import { ReleaseCatalogRequest } from "../db/releaseCatalog.mjs";
-import { CoreSchema } from "./schema.mjs";
-import { BundleDetail, BundlePatchRow, ChannelRow, KeysetInput, ReleaseCatalogRow, ReleaseFilter, ReleaseRow } from "@hot-updater/plugin-core";
-import { ArtifactInfo, ReleaseCatalog } from "@hot-updater/core";
+import { CoreSchema, HotUpdaterDatabase } from "@hot-updater/plugin-core";
 //#region src/core/reads.d.ts
 type CoreDatabase = HotUpdaterDatabase<CoreSchema>;
 interface CoreStorage {
   readonly readStorageText?: (storageUri: string) => Promise<string | null>;
   readonly resolveFileUrl: (storageUri: string | null) => Promise<string | null>;
 }
-/** Core's reads, each through one declared index or key. */
-declare const createCoreReads: (db: CoreDatabase, storage: CoreStorage) => {
-  /** The update check: one point read of its scope's catalog. */
-  getReleaseCatalog(input: ReleaseCatalogRequest): Promise<ReleaseCatalog | null>;
-  /** Artifact resolution: one batch read of both bundles and one unique read of their patch. */
-  getArtifactInfo(targetBundleId: string, currentBundleId: string, artifactProtocolVersion: 1): Promise<ArtifactInfo | null>;
-  /** A bundle, its patches, and how many patches start from it. */
-  getBundle(id: string): Promise<BundleDetail | null>;
-  /** One page of the patches that start from a bundle, by target bundle id. */
-  /** Each base bundle's reference counter: one batch read of the bundle rows, and no patches. */
-  countBundleChildren(baseBundleIds: readonly string[]): Promise<Record<string, number>>;
-  listPatchesFromBase(baseBundleId: string, input: KeysetInput): Promise<BundlePatchRow[]>;
-  /** One page of bundles with their patches, oldest or newest first, optionally for one platform. */
-  listBundles(input: KeysetInput & {
-    readonly platform?: "ios" | "android";
-  }): Promise<BundleDetail[]>;
-  /** Bundles in total or for one platform: one counter row. */
-  countBundles(platform?: "ios" | "android"): Promise<number>;
-  /** Auto-patch bases for a new bundle: one point read of its scope's catalog. */
-  findBaseBundleIds(candidateKey: string, bundleId: string, limit: number): Promise<string[]>;
-  getRelease(id: string): Promise<ReleaseRow | null>;
-  /** One page of releases through the index its filter names. */
-  listReleases(input: KeysetInput & {
-    readonly filter: ReleaseFilter;
-  }): Promise<ReleaseRow[]>;
-  /** A scope's newest release id: `byScope` descending, limit 1. */
-  latestReleaseId(scopeKey: string): Promise<string | null>;
-  getReleaseCatalogRow(scopeKey: string): Promise<ReleaseCatalogRow | null>;
-  listReleaseCatalogs(input: KeysetInput): Promise<ReleaseCatalogRow[]>;
-  /** Every channel, by name. */
-  listChannels(): Promise<ChannelRow[]>;
-  findChannelByName(name: string): Promise<ChannelRow | null>;
-};
-type CoreReads = ReturnType<typeof createCoreReads>;
 //#endregion
-export { type BundleDetail, CoreDatabase, CoreReads, CoreStorage, type KeysetInput, type ReleaseFilter, createCoreReads };
+export { CoreDatabase, CoreStorage };

package/dist/core/reads.mjs

@@ -1,8 +1,8 @@
 import { projectReleaseCatalogRow, releaseCatalogScopeKeyOf } from "../db/releaseCatalog.mjs";
 import { resolveManifestArtifacts } from "../db/updateArtifacts.mjs";
-import { baseBundleIdsOf, parseBaseCandidateKey } from "./baseCandidates.mjs";
-import { rowToBundle } from "@hot-updater/plugin-core";
-import { ARTIFACT_PROTOCOL_VERSION, NIL_UUID } from "@hot-updater/core";
+import { baseBundleIdsOf } from "./baseCandidates.mjs";
+import { parseBaseCandidateKey, rowToBundle } from "@hot-updater/plugin-core";
+import { ARTIFACT_PROTOCOL_VERSION, NIL_UUID } from "@hot-updater/protocol";
 //#region src/core/reads.ts
 const PAGE = 500;
 const pick = (fields) => (row) => Object.fromEntries(fields.map((field) => [field, row[field]]));

package/dist/core/releases.cjs

@@ -1,19 +1,19 @@
 const require_reads = require("./reads.cjs");
 const require_writes = require("./writes.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
-let _hot_updater_core = require("@hot-updater/core");
+let _hot_updater_protocol = require("@hot-updater/protocol");
 //#region src/core/releases.ts
 const PAGE = 500;
 const fail = (code, message) => {
 	throw new _hot_updater_plugin_core.ReleaseCatalogMutationError(code, message);
 };
 const checkScope = (scope) => {
-	const channelKey = (0, _hot_updater_core.encodeChannelKey)(scope.channelName);
-	const expected = scope.strategy === "APP_VERSION" ? (0, _hot_updater_core.createReleaseCatalogScopeKey)({
+	const channelKey = (0, _hot_updater_protocol.encodeChannelKey)(scope.channelName);
+	const expected = scope.strategy === "APP_VERSION" ? (0, _hot_updater_protocol.createReleaseCatalogScopeKey)({
 		channelKey,
 		platform: scope.platform,
 		strategy: "APP_VERSION"
-	}) : (0, _hot_updater_core.createReleaseCatalogScopeKey)({
+	}) : (0, _hot_updater_protocol.createReleaseCatalogScopeKey)({
 		channelKey,
 		fingerprintHash: scope.fingerprintHash ?? "",
 		platform: scope.platform,
@@ -63,7 +63,7 @@ const writeCatalog = async (tx, scope, stored, enabled, updatedAtMs) => {
 		catalog_id: stored.catalog?.catalog_id ?? (0, _hot_updater_plugin_core.createUUIDv7)(),
 		strategy: scope.strategy,
 		channel_id: scope.channelId,
-		channel_key: (0, _hot_updater_core.encodeChannelKey)(scope.channelName),
+		channel_key: (0, _hot_updater_protocol.encodeChannelKey)(scope.channelName),
 		platform: scope.platform,
 		fingerprint_hash: scope.fingerprintHash,
 		generation,
@@ -172,7 +172,7 @@ const rebuildScope = async (tx, scope, updatedAtMs) => {
 		releases: enabled.map(_hot_updater_plugin_core.releaseRowToRelease)
 	});
 	const current = stored.catalog;
-	if (current !== null && current.strategy === scope.strategy && current.channel_id === scope.channelId && current.channel_key === (0, _hot_updater_core.encodeChannelKey)(scope.channelName) && current.platform === scope.platform && current.fingerprint_hash === scope.fingerprintHash && current.catalog_hash === compilation.catalogHash) return {
+	if (current !== null && current.strategy === scope.strategy && current.channel_id === scope.channelId && current.channel_key === (0, _hot_updater_protocol.encodeChannelKey)(scope.channelName) && current.platform === scope.platform && current.fingerprint_hash === scope.fingerprintHash && current.catalog_hash === compilation.catalogHash) return {
 		catalog: current,
 		current,
 		changed: false,

package/dist/core/releases.mjs

@@ -1,7 +1,7 @@
 import { toCatalogRow, toReleaseRow } from "./reads.mjs";
 import { insertBundle } from "./writes.mjs";
 import { ReleaseCatalogMutationError, compileReleaseCatalog, createUUIDv7, createUUIDv7After, isUUIDv7, releaseRowToRelease } from "@hot-updater/plugin-core";
-import { createReleaseCatalogScopeKey, encodeChannelKey } from "@hot-updater/core";
+import { createReleaseCatalogScopeKey, encodeChannelKey } from "@hot-updater/protocol";
 //#region src/core/releases.ts
 const PAGE = 500;
 const fail = (code, message) => {

package/dist/core/writes.cjs

@@ -1,5 +1,5 @@
-const require_errors = require("../database/errors.cjs");
 const require_reads = require("./reads.cjs");
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/core/writes.ts
 const PAGE = 500;
 /** Moves one bundle into or out of its platform's total and the overall total. */
@@ -69,7 +69,7 @@ const insertChannel = async (db, row) => {
 			};
 		});
 	} catch (error) {
-		if (attempt < 3 && error instanceof require_errors.DatabaseConstraintError && (error.reason === "unique" || error.reason === "exists")) continue;
+		if (attempt < 3 && error instanceof _hot_updater_plugin_core.DatabaseConstraintError && (error.reason === "unique" || error.reason === "exists")) continue;
 		throw error;
 	}
 };

package/dist/core/writes.mjs

@@ -1,5 +1,5 @@
-import { DatabaseConstraintError } from "../database/errors.mjs";
 import { toChannelRow } from "./reads.mjs";
+import { DatabaseConstraintError } from "@hot-updater/plugin-core";
 //#region src/core/writes.ts
 const PAGE = 500;
 /** Moves one bundle into or out of its platform's total and the overall total. */

package/dist/createHotUpdaterCore.cjs

@@ -1,5 +1,4 @@
-const require_coreDatabase = require("./db/coreDatabase.cjs");
-const require_configError = require("./assembly/configError.cjs");
+const require_clientPlugins = require("./assembly/clientPlugins.cjs");
 const require_assemblePlugins = require("./assembly/assemblePlugins.cjs");
 const require_handler = require("./handler.cjs");
 const require_storageAccess = require("./storageAccess.cjs");
@@ -16,42 +15,34 @@ const isAdapter = (value) => isRecord(value) && [
 const databaseOf = (value) => {
 	if (isRecord(value) && typeof value.name === "string") {
 		if (isAdapter(value.adapter)) return value;
-		if ("core" in value && "fetchAdmin" in value) throw new require_configError.HotUpdaterConfigError("standaloneRepository reaches a server's admin API from the CLI and console. createHotUpdater needs the server's own database, such as kyselyAdapter(...).");
+		if ("core" in value && "fetchAdmin" in value) throw new _hot_updater_plugin_core.HotUpdaterConfigError("standaloneRepository reaches a server's admin API from the CLI and console. createHotUpdater needs the server's own database, such as kyselyAdapter(...).");
 	}
-	throw new require_configError.HotUpdaterConfigError("database must be a Hot Updater 1.0 database, such as kyselyAdapter(...) or postgres(...). Upgrade the provider package that created it.");
+	throw new _hot_updater_plugin_core.HotUpdaterConfigError("database must be a Hot Updater 1.0 database, such as kyselyAdapter(...) or postgres(...). Upgrade the provider package that created it.");
 };
 /** `"public"`, or nothing; a `clientAccess` object says what replaced it. */
 const isPublic = (value) => {
 	if (value === void 0) return false;
 	if (value === "public") return true;
-	throw new require_configError.HotUpdaterConfigError(isRecord(value) ? "clientAccess objects were removed in 1.0. Set clientAccess: \"public\", or add a plugin that provides clientAuth to plugins." : "clientAccess must be \"public\"; to protect client routes, add a plugin that provides clientAuth to plugins.");
+	throw new _hot_updater_plugin_core.HotUpdaterConfigError(isRecord(value) ? "clientAccess objects were removed in 1.0. Set clientAccess: \"public\", or add a plugin that provides clientAuth to plugins." : "clientAccess must be \"public\"; to protect client routes, add a plugin that provides clientAuth to plugins.");
 };
-const hotUpdaterCoreMetadata = Symbol.for("@hot-updater/server/core-metadata");
-function getHotUpdaterCoreMetadata(hotUpdater) {
-	return hotUpdater[hotUpdaterCoreMetadata];
-}
 function createHotUpdater(options) {
 	for (const key of ["authorityId", "catalogId"]) if (Object.hasOwn(options, key)) throw new TypeError(`Remove ${key} from createHotUpdater options. Catalog identity is managed internally.`);
 	const database = databaseOf(options.database);
-	const storagePlugins = (options.storage ?? []).map((storage) => {
-		(0, _hot_updater_plugin_core.assertStorageOperations)(storage, ["get", "getDownloadUrl"]);
-		return storage;
-	});
-	const { downloadStorageObject, readStorageText, resolveFileUrl } = require_storageAccess.createStorageAccess(storagePlugins);
+	const storage = Object.freeze([...options.storage ?? []]);
+	const { downloadStorageObject, readStorageText, resolveFileUrl } = require_storageAccess.createStorageAccess(storage);
 	const publicClients = isPublic(options.clientAccess);
-	const plugins = require_assemblePlugins.assemblePlugins(options.plugins ?? [], database.adapter, {
-		storage: {
-			readStorageText,
-			resolveFileUrl
-		},
-		...database.onCachedRoutesChange === void 0 ? {} : { onCachedRoutesChange: () => database.onCachedRoutesChange() },
-		...database.aggregateBatching === void 0 ? {} : { batching: database.aggregateBatching }
-	});
+	const configured = Object.freeze([...options.plugins ?? []]);
+	const plugins = require_assemblePlugins.assemblePlugins(configured, database, { storage: {
+		readStorageText,
+		resolveFileUrl
+	} });
+	const clientPlugins = Object.freeze(require_clientPlugins.clientPluginsOf(configured));
 	const clientAuth = plugins.clientAuth;
-	if (clientAuth !== void 0 && publicClients) throw new require_configError.HotUpdaterConfigError(`Plugin "${clientAuth.plugin}" provides clientAuth, so remove clientAccess.`);
-	if (clientAuth === void 0 && !publicClients) throw new require_configError.HotUpdaterConfigError("Set clientAccess to \"public\", or add a plugin that provides clientAuth.");
+	if (clientAuth !== void 0 && publicClients) throw new _hot_updater_plugin_core.HotUpdaterConfigError(`Plugin "${clientAuth.plugin}" provides clientAuth, so remove clientAccess.`);
+	if (clientAuth === void 0 && !publicClients) throw new _hot_updater_plugin_core.HotUpdaterConfigError("Set clientAccess to \"public\", or add a plugin that provides clientAuth.");
+	const varyHeaders = Object.freeze((clientAuth?.varyHeaders ?? []).map((header) => header.toLowerCase()));
 	const clientPolicy = clientAuth === void 0 ? void 0 : {
-		varyHeaders: clientAuth.varyHeaders.map((header) => header.toLowerCase()),
+		varyHeaders,
 		authenticate: (request) => clientAuth.authenticate(request.headers)
 	};
 	const handlers = require_handler.createHotUpdaterHandlers({
@@ -61,24 +52,33 @@ function createHotUpdater(options) {
 		endpoints: plugins.endpoints,
 		plugins: Object.keys(plugins.api)
 	});
-	const api = {
+	let serving = false;
+	return {
 		adapterName: database.name,
-		handlers,
+		get handlers() {
+			if (!serving) {
+				for (const adapter of storage) (0, _hot_updater_plugin_core.assertStorageOperations)(adapter, ["get", "getDownloadUrl"]);
+				serving = true;
+			}
+			return handlers;
+		},
 		core: plugins.core,
 		api: plugins.api,
-		flush: plugins.flush
+		flush: plugins.flush,
+		database,
+		storage,
+		plugins: configured,
+		clientPlugins,
+		clientEndpoints: Object.freeze(plugins.endpoints.filter((endpoint) => endpoint.access === "client").map(({ plugin, method, path }) => Object.freeze({
+			plugin,
+			method,
+			path
+		}))),
+		...clientAuth === void 0 ? {} : { clientAuth: Object.freeze({
+			plugin: clientAuth.plugin,
+			varyHeaders
+		}) }
 	};
-	Object.defineProperty(api, hotUpdaterCoreMetadata, {
-		enumerable: false,
-		value: {
-			database,
-			target: require_coreDatabase.toolingTargetOf(options.plugins ?? []),
-			plugins: options.plugins ?? []
-		}
-	});
-	return api;
 }
 //#endregion
 exports.createHotUpdater = createHotUpdater;
-exports.getHotUpdaterCoreMetadata = getHotUpdaterCoreMetadata;
-exports.hotUpdaterCoreMetadata = hotUpdaterCoreMetadata;

package/dist/createHotUpdaterCore.d.cts

@@ -1,15 +1,43 @@
-import { ToolingDatabase } from "./db/types.cjs";
-import { AnyHotUpdaterPlugin, PluginApis } from "./plugins/definePlugin.cjs";
 import { CoreApi } from "./core/api.cjs";
+import { AnyHotUpdaterPlugin, PluginApis } from "./plugins/definePlugin.cjs";
 import { HotUpdaterHandlers } from "./handlerTypes.cjs";
 import "./handler.cjs";
-import { StoragePlugin } from "@hot-updater/plugin-core";
+import { PluginClientPlugin, StorageAdapter, ToolingDatabase } from "@hot-updater/plugin-core";
 //#region src/createHotUpdaterCore.d.ts
+/** A plugin's endpoint on `handlers.client`. */
+interface ClientEndpoint {
+  /** The id of the plugin that adds it. */
+  readonly plugin: string;
+  readonly method: string;
+  /** Relative to the handler's mount; `:name` segments are parameters. */
+  readonly path: string;
+}
+/** The plugin that decides who may call client routes. */
+interface ClientAuthProvider {
+  /** Its id. */
+  readonly plugin: string;
+  /**
+   * The request headers its decision reads, lowercase: what a cache in
+   * front of the server, such as a CDN, keys client routes on.
+   */
+  readonly varyHeaders: readonly string[];
+}
 type RuntimeHotUpdaterAPI<TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly AnyHotUpdaterPlugin[]> = {
+  /**
+   * The routes a host mounts. On first access every storage adapter must
+   * serve downloads (`get` and `getDownloadUrl`), so a server fails where it
+   * mounts them, while tooling that only reads the definition, such as the
+   * CLI, can list storage that only uploads.
+   */
   readonly handlers: HotUpdaterHandlers;
-  /** Core's reads and typed writes: bundles, Releases, Catalogs, and channels. */
+  /**
+   * Core's reads and typed writes: bundles, Releases, Catalogs, and
+   * channels. The CLI and the console write through it, so their writes
+   * take the server's path: the plugins' schema fence, pruning during
+   * writes, the storage's file URLs, and the database's CDN purge.
+   */
   readonly core: CoreApi;
-  /** Each plugin's API by plugin id. */
+  /** Each plugin's API by plugin id, which the CLI's and the console's plugin features call. */
   readonly api: PluginApis<TPlugins>;
   /** The database's name, which `hot-updater db` commands read. */
   readonly adapterName: string;
@@ -20,6 +48,28 @@ type RuntimeHotUpdaterAPI<TPlugins extends readonly AnyHotUpdaterPlugin[] = read
    * it before it exits.
    */
   readonly flush: () => Promise<void>;
+  /**
+   * The database as configured. `hot-updater db` runs its tooling
+   * (`createMigrator`, `generateSchema`), and tooling done with the server
+   * closes it (`dispose`).
+   */
+  readonly database: ToolingDatabase;
+  /** The storage as configured, in order, as a frozen copy. */
+  readonly storage: readonly StorageAdapter[];
+  /** The plugins as configured, as a frozen copy, whose tables tooling creates. */
+  readonly plugins: TPlugins;
+  /**
+   * The client plugins an app adds to `HotUpdater.init`'s `plugins` for
+   * these plugins, each once, in plugin order: what init prints.
+   */
+  readonly clientPlugins: readonly PluginClientPlugin[];
+  /**
+   * The plugins' endpoints on `handlers.client`, which a host that routes
+   * by path, such as a CDN in front of the server, sends to it.
+   */
+  readonly clientEndpoints: readonly ClientEndpoint[];
+  /** The plugin that guards client routes; absent when they are public. */
+  readonly clientAuth?: ClientAuthProvider;
 };
 type HotUpdaterAPI = RuntimeHotUpdaterAPI;
 declare const REMOVED_CLIENT_ACCESS = "clientAccess objects were removed in 1.0: set clientAccess: \"public\", or add a plugin that provides clientAuth";
@@ -62,11 +112,14 @@ type ClientAccessRule<TPlugins extends readonly AnyHotUpdaterPlugin[]> = number
 type CreateHotUpdaterOptions<TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly []> = {
   /** A provider's database on the storage engine, such as `kyselyAdapter(...)` or `postgres(...)`. */
   readonly database: ToolingDatabase;
-  /** Storage implementations used to read provider-specific storage URIs. */
-  readonly storage?: readonly StoragePlugin[];
+  /**
+   * Where bundles are stored: the server reads and signs the URIs of each
+   * adapter's protocol.
+   */
+  readonly storage?: readonly StorageAdapter[];
   /** The plugins the server runs; at most one provides clientAuth. Defaults to none. */
   readonly plugins?: TPlugins;
 } & ClientAccessRule<TPlugins>;
 declare function createHotUpdater<const TPlugins extends readonly AnyHotUpdaterPlugin[] = readonly []>(options: CreateHotUpdaterOptions<TPlugins>): RuntimeHotUpdaterAPI<NoInfer<TPlugins>>;
 //#endregion
-export { ClientAccessPolicy, ClientAccessRule, CreateHotUpdaterOptions, HotUpdaterAPI, RemovedClientAccess, RuntimeHotUpdaterAPI, createHotUpdater };
+export { ClientAccessPolicy, ClientAccessRule, ClientAuthProvider, ClientEndpoint, CreateHotUpdaterOptions, HotUpdaterAPI, RemovedClientAccess, RuntimeHotUpdaterAPI, createHotUpdater };