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

package/dist/createHotUpdaterCore.mjs

@@ -1,100 +1,85 @@
+import { HotUpdaterConfigError } from "./assembly/configError.mjs";
+import { clientPluginsOf } from "./assembly/clientPlugins.mjs";
+import { assemblePlugins } from "./assembly/assemblePlugins.mjs";
 import { createHotUpdaterHandlers } from "./handler.mjs";
-import { createInsightsProvider } from "./insights/provider.mjs";
-import { authenticateApiKey, createApiKeyManagement, normalizeApiKeyHeaderName } from "./apiKeys.mjs";
-import { createDatabasePluginCore } from "./db/databasePluginCore.mjs";
-import { createSchemaReadinessChecker } from "./db/schemaReadiness.mjs";
-import { isDatabasePlugin } from "./db/types.mjs";
 import { createStorageAccess } from "./storageAccess.mjs";
 import { assertStorageOperations } from "@hot-updater/plugin-core";
 //#region src/createHotUpdaterCore.ts
-const normalizeClientAccess = (value) => {
-	if (value === null || typeof value !== "object" || Array.isArray(value)) throw new TypeError("clientAccess must be an object.");
-	const policy = value;
-	if (policy.type === "public") return { type: "public" };
-	if (policy.type === "api-key") return {
-		headerName: normalizeApiKeyHeaderName(policy.headerName),
-		type: "api-key"
-	};
-	throw new TypeError("clientAccess.type must be either \"public\" or \"api-key\".");
+const isRecord = (value) => typeof value === "object" && value !== null;
+const isAdapter = (value) => isRecord(value) && [
+	"fits",
+	"get",
+	"query",
+	"write"
+].every((method) => typeof value[method] === "function");
+/** The configured database, when it runs on the storage engine. */
+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 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 HotUpdaterConfigError("database must be a Hot Updater 1.0 database, such as kyselyAdapter(...) or postgres(...). Upgrade the provider package that created it.");
 };
-const hotUpdaterCoreMetadata = Symbol.for("@hot-updater/server/core-metadata");
-function getHotUpdaterCoreMetadata(hotUpdater) {
-	return hotUpdater[hotUpdaterCoreMetadata];
-}
-function createHotUpdaterCore(options) {
+/** `"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 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.");
+};
+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 = options.database;
-	const storagePlugins = (options.storage ?? []).map((storage) => {
-		assertStorageOperations(storage, ["get", "getDownloadUrl"]);
-		return storage;
-	});
-	const { downloadStorageObject, readStorageText, resolveFileUrl } = createStorageAccess(storagePlugins);
-	const adapterCapabilities = database;
-	if (!isDatabasePlugin(database)) throw new Error("@hot-updater/server only supports database plugins.");
-	const plugin = database;
-	const adapterName = adapterCapabilities.adapterName ?? plugin.name;
-	const assertSchemaReady = createSchemaReadinessChecker(adapterName, adapterCapabilities.createMigrator);
-	const core = createDatabasePluginCore(plugin, resolveFileUrl, {
-		beforeOperation: assertSchemaReady,
-		readStorageText
-	});
-	const clientAccess = normalizeClientAccess(options.clientAccess);
-	const insights = createInsightsProvider({
-		async record(input) {
-			await assertSchemaReady();
-			return plugin.models.insights.record(input);
-		},
-		async listEvents(input) {
-			await assertSchemaReady();
-			return plugin.models.insights.listEvents(input);
-		},
-		async findInstallations(input) {
-			await assertSchemaReady();
-			return plugin.models.insights.findInstallations(input);
-		},
-		async countInstallations(input) {
-			await assertSchemaReady();
-			return plugin.models.insights.countInstallations(input);
-		},
-		async countEvents(input) {
-			await assertSchemaReady();
-			return plugin.models.insights.countEvents(input);
-		}
-	});
-	const apiKeys = createApiKeyManagement({
-		apiKeys: plugin.models.apiKeys,
-		beforeOperation: assertSchemaReady
-	});
-	const handlers = createHotUpdaterHandlers(core.api, insights, clientAccess.type === "api-key" ? {
-		authenticate: (request) => authenticateApiKey({
-			apiKeys: plugin.models.apiKeys,
-			beforeLookup: assertSchemaReady,
-			headerName: clientAccess.headerName,
-			request
-		}),
-		headerName: clientAccess.headerName
-	} : void 0, downloadStorageObject);
-	const api = Object.assign({
-		adapterName: adapterCapabilities.adapterName ?? core.adapterName,
-		insights,
-		apiKeys,
-		handlers
-	}, core.api);
-	Object.defineProperty(api, hotUpdaterCoreMetadata, {
-		enumerable: false,
-		value: {
-			adapterCapabilities,
-			core
-		}
+	const database = databaseOf(options.database);
+	const storage = Object.freeze([...options.storage ?? []]);
+	const { downloadStorageObject, readStorageText, resolveFileUrl } = createStorageAccess(storage);
+	const publicClients = isPublic(options.clientAccess);
+	const configured = Object.freeze([...options.plugins ?? []]);
+	const plugins = assemblePlugins(configured, database, { storage: {
+		readStorageText,
+		resolveFileUrl
+	} });
+	const clientPlugins = Object.freeze(clientPluginsOf(configured));
+	const clientAuth = plugins.clientAuth;
+	if (clientAuth !== void 0 && publicClients) throw new HotUpdaterConfigError(`Plugin "${clientAuth.plugin}" provides clientAuth, so remove clientAccess.`);
+	if (clientAuth === void 0 && !publicClients) throw new 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,
+		authenticate: (request) => clientAuth.authenticate(request.headers)
+	};
+	const handlers = createHotUpdaterHandlers({
+		api: { core: plugins.core },
+		...clientPolicy === void 0 ? {} : { clientPolicy },
+		downloadStorageObject,
+		endpoints: plugins.endpoints,
+		plugins: Object.keys(plugins.api)
 	});
+	let serving = false;
 	return {
-		api,
-		adapterCapabilities,
-		core
+		adapterName: database.name,
+		get handlers() {
+			if (!serving) {
+				for (const adapter of storage) assertStorageOperations(adapter, ["get", "getDownloadUrl"]);
+				serving = true;
+			}
+			return handlers;
+		},
+		core: plugins.core,
+		api: plugins.api,
+		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
+		}) }
 	};
 }
-function createHotUpdater(options) {
-	return createHotUpdaterCore(options).api;
-}
 //#endregion
-export { createHotUpdater, createHotUpdaterCore, getHotUpdaterCoreMetadata, hotUpdaterCoreMetadata };
+export { createHotUpdater };

package/dist/db/engineDrizzleSchema.cjs

@@ -0,0 +1,53 @@
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+//#region src/db/engineDrizzleSchema.ts
+const drizzle = {
+	postgresql: {
+		module: "drizzle-orm/pg-core",
+		table: "pgTable"
+	},
+	mysql: {
+		module: "drizzle-orm/mysql-core",
+		table: "mysqlTable"
+	},
+	sqlite: {
+		module: "drizzle-orm/sqlite-core",
+		table: "sqliteTable"
+	}
+};
+const literal = (value) => JSON.stringify(value);
+/**
+* The Drizzle schema `drizzle-kit` applies for the engine's tables: every
+* column typed exactly as the engine's DDL, keys, indexes, index tables, and
+* the settings table. The engine keeps references itself, so there are no
+* foreign keys. `hot-updater db migrate` then writes only the settings rows.
+*/
+const generateDrizzleEngineSchema = (dialect, schema) => {
+	const { module, table: tableFunction } = drizzle[dialect];
+	const tables = [...schema.tables, _hot_updater_plugin_core.SETTINGS_TABLE];
+	const blocks = [];
+	const emit = (shape) => {
+		const columns = shape.columns.map((column) => `  ${literal(column.name)}: column(${literal(column.type)})(${literal(column.name)})${column.notNull ? ".notNull()" : ""}${column.default === void 0 ? "" : `.default(${column.default})`},`);
+		const at = (name) => `table[${literal(name)}]`;
+		const extras = [`primaryKey({ columns: [${shape.key.map(at).join(", ")}] })`, ...shape.indexes.flatMap((index) => index.kind === "index" ? [`${index.unique ? "uniqueIndex" : "index"}(${literal(index.name)}).on(${index.columns.map(at).join(", ")})`] : [])];
+		blocks.push(`export const ${shape.name} = ${tableFunction}(${literal(shape.name)}, {\n${columns.join("\n")}\n}, (table) => [\n${extras.map((extra) => `  ${extra},`).join("\n")}\n]);`);
+		for (const index of shape.indexes) if (index.kind === "table") emit(index.table);
+	};
+	for (const shape of (0, _hot_updater_plugin_core.sqlTableShapes)(dialect, tables)) emit(shape);
+	return [
+		"// Generated by `hot-updater db generate` from Hot Updater's schema. Do not edit.",
+		`import { ${[
+			"customType",
+			"index",
+			"primaryKey",
+			"uniqueIndex"
+		].filter((name) => name === "customType" ? true : blocks.some((block) => block.includes(`${name}(`))).concat(tableFunction).sort().join(", ")} } from ${literal(module)};`,
+		"",
+		"/** A column typed exactly as Hot Updater's SQL schema declares it. */",
+		"const column = (type: string) =>",
+		"  customType<{ data: unknown; driverData: unknown }>({ dataType: () => type });",
+		"",
+		...blocks.flatMap((block) => [block, ""])
+	].join("\n");
+};
+//#endregion
+exports.generateDrizzleEngineSchema = generateDrizzleEngineSchema;

package/dist/db/engineDrizzleSchema.mjs

@@ -0,0 +1,53 @@
+import { SETTINGS_TABLE, sqlTableShapes } from "@hot-updater/plugin-core";
+//#region src/db/engineDrizzleSchema.ts
+const drizzle = {
+	postgresql: {
+		module: "drizzle-orm/pg-core",
+		table: "pgTable"
+	},
+	mysql: {
+		module: "drizzle-orm/mysql-core",
+		table: "mysqlTable"
+	},
+	sqlite: {
+		module: "drizzle-orm/sqlite-core",
+		table: "sqliteTable"
+	}
+};
+const literal = (value) => JSON.stringify(value);
+/**
+* The Drizzle schema `drizzle-kit` applies for the engine's tables: every
+* column typed exactly as the engine's DDL, keys, indexes, index tables, and
+* the settings table. The engine keeps references itself, so there are no
+* foreign keys. `hot-updater db migrate` then writes only the settings rows.
+*/
+const generateDrizzleEngineSchema = (dialect, schema) => {
+	const { module, table: tableFunction } = drizzle[dialect];
+	const tables = [...schema.tables, SETTINGS_TABLE];
+	const blocks = [];
+	const emit = (shape) => {
+		const columns = shape.columns.map((column) => `  ${literal(column.name)}: column(${literal(column.type)})(${literal(column.name)})${column.notNull ? ".notNull()" : ""}${column.default === void 0 ? "" : `.default(${column.default})`},`);
+		const at = (name) => `table[${literal(name)}]`;
+		const extras = [`primaryKey({ columns: [${shape.key.map(at).join(", ")}] })`, ...shape.indexes.flatMap((index) => index.kind === "index" ? [`${index.unique ? "uniqueIndex" : "index"}(${literal(index.name)}).on(${index.columns.map(at).join(", ")})`] : [])];
+		blocks.push(`export const ${shape.name} = ${tableFunction}(${literal(shape.name)}, {\n${columns.join("\n")}\n}, (table) => [\n${extras.map((extra) => `  ${extra},`).join("\n")}\n]);`);
+		for (const index of shape.indexes) if (index.kind === "table") emit(index.table);
+	};
+	for (const shape of sqlTableShapes(dialect, tables)) emit(shape);
+	return [
+		"// Generated by `hot-updater db generate` from Hot Updater's schema. Do not edit.",
+		`import { ${[
+			"customType",
+			"index",
+			"primaryKey",
+			"uniqueIndex"
+		].filter((name) => name === "customType" ? true : blocks.some((block) => block.includes(`${name}(`))).concat(tableFunction).sort().join(", ")} } from ${literal(module)};`,
+		"",
+		"/** A column typed exactly as Hot Updater's SQL schema declares it. */",
+		"const column = (type: string) =>",
+		"  customType<{ data: unknown; driverData: unknown }>({ dataType: () => type });",
+		"",
+		...blocks.flatMap((block) => [block, ""])
+	].join("\n");
+};
+//#endregion
+export { generateDrizzleEngineSchema };

package/dist/db/enginePrismaSchema.cjs

@@ -0,0 +1,84 @@
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+//#region src/db/enginePrismaSchema.ts
+const SCALARS = {
+	TEXT: "String",
+	INTEGER: "BigInt",
+	REAL: "Float",
+	bigint: "BigInt",
+	"double precision": "Float",
+	double: "Float",
+	boolean: "Boolean",
+	jsonb: "Json",
+	json: "Json"
+};
+/**
+* A column's Prisma type from the DDL type the shared SQL schema gives it.
+* MySQL's ASCII keys become `VarBinary`: the same bytes and order as
+* `ascii_bin`, within InnoDB's key limit without a character set.
+*/
+const prismaColumn = (provider, { type }) => {
+	const length = /^varchar\((\d+)\)/u.exec(type)?.[1];
+	if (provider === "mysql" && type.includes("CHARACTER SET")) {
+		if (type.includes("CHARACTER SET ascii") && length) return {
+			scalar: "Bytes",
+			native: `@db.VarBinary(${length})`
+		};
+		return {
+			scalar: "String",
+			native: length ? `@db.VarChar(${length})` : "@db.LongText",
+			collate: true
+		};
+	}
+	if (provider === "postgresql" && type.includes("COLLATE")) return {
+		scalar: "String",
+		...length ? { native: `@db.VarChar(${length})` } : {},
+		collate: true
+	};
+	return { scalar: SCALARS[type] ?? "String" };
+};
+/** Prisma fields start with a letter: `_v` becomes `hu_v`, mapped back to `_v`. */
+const fieldName = (column) => column.startsWith("_") ? `hu${column}` : column;
+const list = (columns) => `[${columns.map(fieldName).join(", ")}]`;
+const flatten = (shapes) => shapes.flatMap((shape) => [shape, ...flatten(shape.indexes.flatMap((index) => index.kind === "table" ? [index.table] : []))]);
+const shapesOf = (provider, schema) => flatten((0, _hot_updater_plugin_core.sqlTableShapes)(provider, [...schema.tables, _hot_updater_plugin_core.SETTINGS_TABLE]));
+const renderField = (provider, column) => {
+	const { scalar, native } = prismaColumn(provider, column);
+	const name = fieldName(column.name);
+	return [
+		`${name} ${scalar}${column.notNull ? "" : "?"}`,
+		...native === void 0 ? [] : [native],
+		...column.default === void 0 ? [] : [`@default(${column.default})`],
+		...name === column.name ? [] : [`@map(${JSON.stringify(column.name)})`]
+	].join(" ");
+};
+/**
+* Hot Updater's tables as Prisma models, for `prisma db push` or
+* `prisma migrate`: keys, indexes, index tables, and the settings table.
+* The engine keeps references itself, so the models have no relations.
+*/
+const generatePrismaEngineSchema = (provider, schema) => shapesOf(provider, schema).map((shape) => {
+	const lines = [
+		...shape.columns.map((column) => renderField(provider, column)),
+		`@@id(${list(shape.key)})`,
+		...shape.indexes.flatMap((index) => index.kind === "index" ? [`@@${index.unique ? "unique" : "index"}(${list(index.columns)}, map: ${JSON.stringify(index.name)})`] : [])
+	];
+	return `model ${shape.name} {\n${lines.map((line) => `  ${line}`).join("\n")}\n}`;
+}).join("\n\n");
+/**
+* The collations Prisma cannot declare, which `hot-updater db migrate` sets
+* after Prisma created the tables: `COLLATE "C"` on PostgreSQL and binary
+* UTF-8 on MySQL, so strings compare by their bytes as the engine expects.
+* The settings table is only read by key, and the migrator has already read
+* it: altering it would invalidate PostgreSQL's cached plan for that read.
+*/
+const prismaCollationStatements = (provider, schema) => {
+	if (provider !== "postgresql" && provider !== "mysql") return [];
+	const quote = (name) => (0, _hot_updater_plugin_core.quoteSql)(provider, name);
+	return shapesOf(provider, schema).filter((shape) => shape.name !== _hot_updater_plugin_core.SETTINGS_TABLE.name).flatMap((shape) => {
+		const changes = shape.columns.filter((column) => prismaColumn(provider, column).collate).map((column) => provider === "postgresql" ? `ALTER COLUMN ${quote(column.name)} TYPE ${column.type}` : `MODIFY ${quote(column.name)} ${column.type}${column.notNull ? " NOT NULL" : " NULL"}`);
+		return changes.length === 0 ? [] : [`ALTER TABLE ${quote(shape.name)} ${changes.join(", ")}`];
+	});
+};
+//#endregion
+exports.generatePrismaEngineSchema = generatePrismaEngineSchema;
+exports.prismaCollationStatements = prismaCollationStatements;

package/dist/db/enginePrismaSchema.d.cts

@@ -0,0 +1,5 @@
+import "@hot-updater/plugin-core";
+//#region src/db/enginePrismaSchema.d.ts
+type PrismaProvider = "postgresql" | "mysql" | "sqlite";
+//#endregion
+export { PrismaProvider };

package/dist/db/enginePrismaSchema.d.mts

@@ -0,0 +1,5 @@
+import "@hot-updater/plugin-core";
+//#region src/db/enginePrismaSchema.d.ts
+type PrismaProvider = "postgresql" | "mysql" | "sqlite";
+//#endregion
+export { PrismaProvider };

package/dist/db/enginePrismaSchema.mjs

@@ -0,0 +1,83 @@
+import { SETTINGS_TABLE, quoteSql, sqlTableShapes } from "@hot-updater/plugin-core";
+//#region src/db/enginePrismaSchema.ts
+const SCALARS = {
+	TEXT: "String",
+	INTEGER: "BigInt",
+	REAL: "Float",
+	bigint: "BigInt",
+	"double precision": "Float",
+	double: "Float",
+	boolean: "Boolean",
+	jsonb: "Json",
+	json: "Json"
+};
+/**
+* A column's Prisma type from the DDL type the shared SQL schema gives it.
+* MySQL's ASCII keys become `VarBinary`: the same bytes and order as
+* `ascii_bin`, within InnoDB's key limit without a character set.
+*/
+const prismaColumn = (provider, { type }) => {
+	const length = /^varchar\((\d+)\)/u.exec(type)?.[1];
+	if (provider === "mysql" && type.includes("CHARACTER SET")) {
+		if (type.includes("CHARACTER SET ascii") && length) return {
+			scalar: "Bytes",
+			native: `@db.VarBinary(${length})`
+		};
+		return {
+			scalar: "String",
+			native: length ? `@db.VarChar(${length})` : "@db.LongText",
+			collate: true
+		};
+	}
+	if (provider === "postgresql" && type.includes("COLLATE")) return {
+		scalar: "String",
+		...length ? { native: `@db.VarChar(${length})` } : {},
+		collate: true
+	};
+	return { scalar: SCALARS[type] ?? "String" };
+};
+/** Prisma fields start with a letter: `_v` becomes `hu_v`, mapped back to `_v`. */
+const fieldName = (column) => column.startsWith("_") ? `hu${column}` : column;
+const list = (columns) => `[${columns.map(fieldName).join(", ")}]`;
+const flatten = (shapes) => shapes.flatMap((shape) => [shape, ...flatten(shape.indexes.flatMap((index) => index.kind === "table" ? [index.table] : []))]);
+const shapesOf = (provider, schema) => flatten(sqlTableShapes(provider, [...schema.tables, SETTINGS_TABLE]));
+const renderField = (provider, column) => {
+	const { scalar, native } = prismaColumn(provider, column);
+	const name = fieldName(column.name);
+	return [
+		`${name} ${scalar}${column.notNull ? "" : "?"}`,
+		...native === void 0 ? [] : [native],
+		...column.default === void 0 ? [] : [`@default(${column.default})`],
+		...name === column.name ? [] : [`@map(${JSON.stringify(column.name)})`]
+	].join(" ");
+};
+/**
+* Hot Updater's tables as Prisma models, for `prisma db push` or
+* `prisma migrate`: keys, indexes, index tables, and the settings table.
+* The engine keeps references itself, so the models have no relations.
+*/
+const generatePrismaEngineSchema = (provider, schema) => shapesOf(provider, schema).map((shape) => {
+	const lines = [
+		...shape.columns.map((column) => renderField(provider, column)),
+		`@@id(${list(shape.key)})`,
+		...shape.indexes.flatMap((index) => index.kind === "index" ? [`@@${index.unique ? "unique" : "index"}(${list(index.columns)}, map: ${JSON.stringify(index.name)})`] : [])
+	];
+	return `model ${shape.name} {\n${lines.map((line) => `  ${line}`).join("\n")}\n}`;
+}).join("\n\n");
+/**
+* The collations Prisma cannot declare, which `hot-updater db migrate` sets
+* after Prisma created the tables: `COLLATE "C"` on PostgreSQL and binary
+* UTF-8 on MySQL, so strings compare by their bytes as the engine expects.
+* The settings table is only read by key, and the migrator has already read
+* it: altering it would invalidate PostgreSQL's cached plan for that read.
+*/
+const prismaCollationStatements = (provider, schema) => {
+	if (provider !== "postgresql" && provider !== "mysql") return [];
+	const quote = (name) => quoteSql(provider, name);
+	return shapesOf(provider, schema).filter((shape) => shape.name !== SETTINGS_TABLE.name).flatMap((shape) => {
+		const changes = shape.columns.filter((column) => prismaColumn(provider, column).collate).map((column) => provider === "postgresql" ? `ALTER COLUMN ${quote(column.name)} TYPE ${column.type}` : `MODIFY ${quote(column.name)} ${column.type}${column.notNull ? " NOT NULL" : " NULL"}`);
+		return changes.length === 0 ? [] : [`ALTER TABLE ${quote(shape.name)} ${changes.join(", ")}`];
+	});
+};
+//#endregion
+export { generatePrismaEngineSchema, prismaCollationStatements };

package/dist/db/releaseCatalog.cjs

@@ -1,65 +1,42 @@
-const require_updateArtifacts = require("./updateArtifacts.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/db/releaseCatalog.ts
+/** A stored catalog payload, checked against its strategy's shape. */
 const parseCompiledCatalog = (payload, strategy) => {
 	const parsed = JSON.parse(payload);
-	if (typeof parsed !== "object" || parsed === null || Reflect.get(parsed, "schemaVersion") !== _hot_updater_core.RELEASE_CATALOG_SCHEMA_VERSION || Reflect.get(parsed, "strategy") !== strategy || Reflect.get(parsed, "fallbackPolicy") !== _hot_updater_core.RELEASE_CATALOG_FALLBACK_POLICY || !Array.isArray(Reflect.get(parsed, "releaseDescriptors"))) throw new Error("Stored Release catalog payload is invalid");
+	if (typeof parsed !== "object" || parsed === null || Reflect.get(parsed, "schemaVersion") !== _hot_updater_protocol.RELEASE_CATALOG_SCHEMA_VERSION || Reflect.get(parsed, "strategy") !== strategy || Reflect.get(parsed, "fallbackPolicy") !== _hot_updater_protocol.RELEASE_CATALOG_FALLBACK_POLICY || !Array.isArray(Reflect.get(parsed, "releaseDescriptors"))) throw new Error("Stored Release catalog payload is invalid");
 	if (strategy === "APP_VERSION" && !Array.isArray(Reflect.get(parsed, "segments"))) throw new Error("Stored app-version Release catalog is invalid");
 	if (strategy === "FINGERPRINT" && !Array.isArray(Reflect.get(parsed, "releaseIndexes"))) throw new Error("Stored fingerprint Release catalog is invalid");
 	return parsed;
 };
-const createReleaseCatalogReader = (database) => async (input) => {
-	const scopeKey = input.strategy === "APP_VERSION" ? (0, _hot_updater_core.createReleaseCatalogScopeKey)({
-		channelKey: input.channelKey,
-		platform: input.platform,
-		strategy: "APP_VERSION"
-	}) : (0, _hot_updater_core.createReleaseCatalogScopeKey)({
-		channelKey: input.channelKey,
-		fingerprintHash: input.fingerprintHash,
-		platform: input.platform,
-		strategy: "FINGERPRINT"
-	});
-	const row = await database.models.releaseCatalogs.findByScopeKey(scopeKey);
+/** The scope key an update check reads. */
+const releaseCatalogScopeKeyOf = (input) => input.strategy === "APP_VERSION" ? (0, _hot_updater_protocol.createReleaseCatalogScopeKey)({
+	channelKey: input.channelKey,
+	platform: input.platform,
+	strategy: "APP_VERSION"
+}) : (0, _hot_updater_protocol.createReleaseCatalogScopeKey)({
+	channelKey: input.channelKey,
+	fingerprintHash: input.fingerprintHash,
+	platform: input.platform,
+	strategy: "FINGERPRINT"
+});
+/** Projects a stored catalog row for one update check; null when the row is not this scope's. */
+const projectReleaseCatalogRow = (row, input, scopeKey = releaseCatalogScopeKeyOf(input)) => {
 	if (row === null || row.platform !== input.platform || row.strategy !== input.strategy || row.channel_key !== input.channelKey || row.scope_key !== scopeKey || row.fingerprint_hash !== (input.strategy === "FINGERPRINT" ? input.fingerprintHash : null)) return null;
 	const compiled = parseCompiledCatalog(row.payload, input.strategy);
-	const releases = (0, _hot_updater_plugin_core.projectCompiledCatalog)(compiled, input.strategy === "APP_VERSION" ? input.appVersion : void 0);
-	const rollbackReleases = (0, _hot_updater_plugin_core.projectCompiledRollbackCatalog)(compiled, input.strategy === "APP_VERSION" ? input.appVersion : void 0);
+	const appVersion = input.strategy === "APP_VERSION" ? input.appVersion : void 0;
 	return {
 		catalogId: row.catalog_id,
 		catalogHash: row.catalog_hash,
-		fallbackPolicy: _hot_updater_core.RELEASE_CATALOG_FALLBACK_POLICY,
+		fallbackPolicy: _hot_updater_protocol.RELEASE_CATALOG_FALLBACK_POLICY,
 		generation: row.generation,
-		releases,
-		rollbackReleases,
-		schemaVersion: _hot_updater_core.RELEASE_CATALOG_SCHEMA_VERSION,
+		releases: (0, _hot_updater_plugin_core.projectCompiledCatalog)(compiled, appVersion),
+		rollbackReleases: (0, _hot_updater_plugin_core.projectCompiledRollbackCatalog)(compiled, appVersion),
+		schemaVersion: _hot_updater_protocol.RELEASE_CATALOG_SCHEMA_VERSION,
 		scopeKey
 	};
 };
-const createArtifactResolver = (input) => {
-	const databaseClient = (0, _hot_updater_plugin_core.createDatabaseClient)(input.database);
-	return async (targetBundleId, currentBundleId) => {
-		const [targetBundle, currentBundle] = await Promise.all([databaseClient.getBundleById(targetBundleId), currentBundleId === _hot_updater_core.NIL_UUID ? null : databaseClient.getBundleById(currentBundleId)]);
-		if (targetBundle === null) return null;
-		const fileUrl = await input.resolveFileUrl(targetBundle.storageUri);
-		const base = {
-			fileHash: targetBundle.fileHash,
-			fileUrl
-		};
-		if (input.readStorageText === void 0) return base;
-		const manifest = await require_updateArtifacts.resolveManifestArtifacts({
-			archiveUrlUsable: fileUrl !== null,
-			currentBundle,
-			readStorageText: input.readStorageText,
-			resolveFileUrl: input.resolveFileUrl,
-			targetBundle
-		});
-		return manifest === null ? base : {
-			...base,
-			...manifest
-		};
-	};
-};
 //#endregion
-exports.createArtifactResolver = createArtifactResolver;
-exports.createReleaseCatalogReader = createReleaseCatalogReader;
+exports.parseCompiledCatalog = parseCompiledCatalog;
+exports.projectReleaseCatalogRow = projectReleaseCatalogRow;
+exports.releaseCatalogScopeKeyOf = releaseCatalogScopeKeyOf;

package/dist/db/releaseCatalog.mjs

@@ -1,7 +1,7 @@
-import { resolveManifestArtifacts } from "./updateArtifacts.mjs";
-import { createDatabaseClient, projectCompiledCatalog, projectCompiledRollbackCatalog } from "@hot-updater/plugin-core";
-import { NIL_UUID, RELEASE_CATALOG_FALLBACK_POLICY, RELEASE_CATALOG_SCHEMA_VERSION, createReleaseCatalogScopeKey } from "@hot-updater/core";
+import { projectCompiledCatalog, projectCompiledRollbackCatalog } from "@hot-updater/plugin-core";
+import { RELEASE_CATALOG_FALLBACK_POLICY, RELEASE_CATALOG_SCHEMA_VERSION, createReleaseCatalogScopeKey } from "@hot-updater/protocol";
 //#region src/db/releaseCatalog.ts
+/** A stored catalog payload, checked against its strategy's shape. */
 const parseCompiledCatalog = (payload, strategy) => {
 	const parsed = JSON.parse(payload);
 	if (typeof parsed !== "object" || parsed === null || Reflect.get(parsed, "schemaVersion") !== RELEASE_CATALOG_SCHEMA_VERSION || Reflect.get(parsed, "strategy") !== strategy || Reflect.get(parsed, "fallbackPolicy") !== RELEASE_CATALOG_FALLBACK_POLICY || !Array.isArray(Reflect.get(parsed, "releaseDescriptors"))) throw new Error("Stored Release catalog payload is invalid");
@@ -9,56 +9,32 @@ const parseCompiledCatalog = (payload, strategy) => {
 	if (strategy === "FINGERPRINT" && !Array.isArray(Reflect.get(parsed, "releaseIndexes"))) throw new Error("Stored fingerprint Release catalog is invalid");
 	return parsed;
 };
-const createReleaseCatalogReader = (database) => async (input) => {
-	const scopeKey = input.strategy === "APP_VERSION" ? createReleaseCatalogScopeKey({
-		channelKey: input.channelKey,
-		platform: input.platform,
-		strategy: "APP_VERSION"
-	}) : createReleaseCatalogScopeKey({
-		channelKey: input.channelKey,
-		fingerprintHash: input.fingerprintHash,
-		platform: input.platform,
-		strategy: "FINGERPRINT"
-	});
-	const row = await database.models.releaseCatalogs.findByScopeKey(scopeKey);
+/** The scope key an update check reads. */
+const releaseCatalogScopeKeyOf = (input) => input.strategy === "APP_VERSION" ? createReleaseCatalogScopeKey({
+	channelKey: input.channelKey,
+	platform: input.platform,
+	strategy: "APP_VERSION"
+}) : createReleaseCatalogScopeKey({
+	channelKey: input.channelKey,
+	fingerprintHash: input.fingerprintHash,
+	platform: input.platform,
+	strategy: "FINGERPRINT"
+});
+/** Projects a stored catalog row for one update check; null when the row is not this scope's. */
+const projectReleaseCatalogRow = (row, input, scopeKey = releaseCatalogScopeKeyOf(input)) => {
 	if (row === null || row.platform !== input.platform || row.strategy !== input.strategy || row.channel_key !== input.channelKey || row.scope_key !== scopeKey || row.fingerprint_hash !== (input.strategy === "FINGERPRINT" ? input.fingerprintHash : null)) return null;
 	const compiled = parseCompiledCatalog(row.payload, input.strategy);
-	const releases = projectCompiledCatalog(compiled, input.strategy === "APP_VERSION" ? input.appVersion : void 0);
-	const rollbackReleases = projectCompiledRollbackCatalog(compiled, input.strategy === "APP_VERSION" ? input.appVersion : void 0);
+	const appVersion = input.strategy === "APP_VERSION" ? input.appVersion : void 0;
 	return {
 		catalogId: row.catalog_id,
 		catalogHash: row.catalog_hash,
 		fallbackPolicy: RELEASE_CATALOG_FALLBACK_POLICY,
 		generation: row.generation,
-		releases,
-		rollbackReleases,
+		releases: projectCompiledCatalog(compiled, appVersion),
+		rollbackReleases: projectCompiledRollbackCatalog(compiled, appVersion),
 		schemaVersion: RELEASE_CATALOG_SCHEMA_VERSION,
 		scopeKey
 	};
 };
-const createArtifactResolver = (input) => {
-	const databaseClient = createDatabaseClient(input.database);
-	return async (targetBundleId, currentBundleId) => {
-		const [targetBundle, currentBundle] = await Promise.all([databaseClient.getBundleById(targetBundleId), currentBundleId === NIL_UUID ? null : databaseClient.getBundleById(currentBundleId)]);
-		if (targetBundle === null) return null;
-		const fileUrl = await input.resolveFileUrl(targetBundle.storageUri);
-		const base = {
-			fileHash: targetBundle.fileHash,
-			fileUrl
-		};
-		if (input.readStorageText === void 0) return base;
-		const manifest = await resolveManifestArtifacts({
-			archiveUrlUsable: fileUrl !== null,
-			currentBundle,
-			readStorageText: input.readStorageText,
-			resolveFileUrl: input.resolveFileUrl,
-			targetBundle
-		});
-		return manifest === null ? base : {
-			...base,
-			...manifest
-		};
-	};
-};
 //#endregion
-export { createArtifactResolver, createReleaseCatalogReader };
+export { parseCompiledCatalog, projectReleaseCatalogRow, releaseCatalogScopeKeyOf };