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

package/dist/assembly/pluginCli.mjs

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

package/dist/core/baseCandidates.d.cts

@@ -1,17 +0,0 @@
-import { ReleaseCatalogRow } from "@hot-updater/plugin-core";
-//#region src/core/baseCandidates.d.ts
-/** A new bundle's auto-patch target: where it is released, and to whom. */
-interface BaseCandidateTarget {
-  readonly channel: string;
-  readonly platform: "ios" | "android";
-  readonly fingerprintHash: string | null;
-  readonly appVersion: string | null;
-}
-/**
- * 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.
- */
-declare const targetBaseCandidateKey: (target: BaseCandidateTarget) => string | null;
-//#endregion
-export { BaseCandidateTarget, targetBaseCandidateKey };

package/dist/core/baseCandidates.d.mts

@@ -1,17 +0,0 @@
-import { ReleaseCatalogRow } from "@hot-updater/plugin-core";
-//#region src/core/baseCandidates.d.ts
-/** A new bundle's auto-patch target: where it is released, and to whom. */
-interface BaseCandidateTarget {
-  readonly channel: string;
-  readonly platform: "ios" | "android";
-  readonly fingerprintHash: string | null;
-  readonly appVersion: string | null;
-}
-/**
- * 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.
- */
-declare const targetBaseCandidateKey: (target: BaseCandidateTarget) => string | null;
-//#endregion
-export { BaseCandidateTarget, targetBaseCandidateKey };

package/dist/core/schema.cjs

@@ -1,279 +0,0 @@
-const require_schema = require("../database/schema.cjs");
-//#region src/core/schema.ts
-/** A channel's id is `channel:` and its name's channel key, so ids share channel_key's bound. */
-const CHANNEL_ID = {
-	type: "string",
-	maxLength: 1408,
-	ascii: true
-};
-/** Core's schema version: the `schema.core` settings row. */
-const HOT_UPDATER_SCHEMA_VERSION = "1.0.0";
-const coreSchema = {
-	bundles: require_schema.defineTable({
-		id: {
-			type: "string",
-			maxLength: 36
-		},
-		platform: {
-			type: "string",
-			maxLength: 16
-		},
-		git_commit_hash: {
-			type: "string",
-			maxLength: 255,
-			required: false
-		},
-		metadata: { type: "json" },
-		manifest_storage_uri: { type: "string" },
-		manifest_file_hash: { type: "string" },
-		asset_base_storage_uri: { type: "string" }
-	}, {
-		key: ["id"],
-		indexes: {
-			byPlatform: {
-				eq: ["platform"],
-				sort: ["id"]
-			},
-			all: {
-				eq: [],
-				sort: ["id"]
-			}
-		}
-	}),
-	bundle_patches: require_schema.defineTable({
-		id: {
-			type: "string",
-			maxLength: 255
-		},
-		bundle_id: {
-			type: "string",
-			maxLength: 36,
-			references: {
-				model: "bundles",
-				onDelete: "cascade"
-			}
-		},
-		base_bundle_id: {
-			type: "string",
-			maxLength: 36,
-			references: {
-				model: "bundles",
-				onDelete: "cascade"
-			}
-		},
-		base_file_hash: { type: "string" },
-		patch_file_hash: { type: "string" },
-		patch_storage_uri: { type: "string" },
-		byte_size: { type: "integer" },
-		order_index: { type: "integer" }
-	}, {
-		key: ["id"],
-		indexes: {
-			pair: {
-				eq: ["bundle_id", "base_bundle_id"],
-				sort: [],
-				unique: true
-			},
-			byBundle: {
-				eq: ["bundle_id"],
-				sort: ["order_index"],
-				root: { model: "bundles" }
-			},
-			byBase: {
-				eq: ["base_bundle_id"],
-				sort: ["bundle_id"]
-			}
-		}
-	}),
-	releases: require_schema.defineTable({
-		id: {
-			type: "string",
-			maxLength: 36
-		},
-		revision: { type: "integer" },
-		scope_key: {
-			type: "string",
-			maxLength: 2048,
-			ascii: true
-		},
-		channel_id: {
-			...CHANNEL_ID,
-			references: {
-				model: "channels",
-				onDelete: "restrict"
-			}
-		},
-		platform: {
-			type: "string",
-			maxLength: 16
-		},
-		kind: {
-			type: "string",
-			maxLength: 16
-		},
-		bundle_id: {
-			type: "string",
-			maxLength: 36,
-			required: false,
-			references: {
-				model: "bundles",
-				onDelete: "restrict"
-			}
-		},
-		strategy: {
-			type: "string",
-			maxLength: 16
-		},
-		target_app_version: {
-			type: "string",
-			required: false
-		},
-		fingerprint_hash: {
-			type: "string",
-			maxLength: 255,
-			required: false
-		},
-		enabled: { type: "boolean" },
-		should_force_update: { type: "boolean" },
-		message: {
-			type: "string",
-			required: false
-		},
-		rollout_cohort_count: { type: "integer" },
-		target_cohorts: { type: "json" },
-		operation: {
-			type: "string",
-			maxLength: 16
-		},
-		source_release_id: {
-			type: "string",
-			maxLength: 36,
-			required: false,
-			references: {
-				model: "releases",
-				onDelete: "none"
-			}
-		},
-		created_at_ms: { type: "integer" },
-		updated_at_ms: { type: "integer" }
-	}, {
-		key: ["id"],
-		indexes: {
-			byScope: {
-				eq: ["scope_key"],
-				sort: ["id"],
-				root: { model: "release_catalogs" }
-			},
-			byScopeEnabled: {
-				eq: ["scope_key", "enabled"],
-				sort: ["id"],
-				root: { model: "release_catalogs" }
-			},
-			byChannelPlatform: {
-				eq: ["channel_id", "platform"],
-				sort: ["id"]
-			},
-			byChannelPlatformEnabled: {
-				eq: [
-					"channel_id",
-					"platform",
-					"enabled"
-				],
-				sort: ["id"]
-			},
-			byBundle: {
-				eq: ["bundle_id"],
-				sort: ["id"]
-			},
-			all: {
-				eq: [],
-				sort: ["id"]
-			}
-		}
-	}),
-	release_catalogs: require_schema.defineTable({
-		scope_key: {
-			type: "string",
-			maxLength: 2048,
-			ascii: true
-		},
-		catalog_id: {
-			type: "string",
-			maxLength: 255
-		},
-		strategy: {
-			type: "string",
-			maxLength: 16
-		},
-		channel_id: {
-			...CHANNEL_ID,
-			references: {
-				model: "channels",
-				onDelete: "none"
-			}
-		},
-		channel_key: {
-			type: "string",
-			maxLength: 1400,
-			ascii: true
-		},
-		platform: {
-			type: "string",
-			maxLength: 16
-		},
-		fingerprint_hash: {
-			type: "string",
-			maxLength: 255,
-			required: false
-		},
-		generation: { type: "integer" },
-		payload: { type: "string" },
-		catalog_hash: {
-			type: "string",
-			maxLength: 71
-		},
-		byte_size: { type: "integer" },
-		is_tombstone: { type: "boolean" },
-		updated_at_ms: { type: "integer" }
-	}, {
-		key: ["scope_key"],
-		indexes: { all: {
-			eq: [],
-			sort: ["scope_key"]
-		} }
-	}),
-	channels: require_schema.defineTable({
-		id: CHANNEL_ID,
-		name: {
-			type: "string",
-			maxLength: 255,
-			unique: true
-		}
-	}, {
-		key: ["id"],
-		indexes: { all: {
-			eq: [],
-			sort: ["name"]
-		} }
-	}),
-	bundle_totals: require_schema.defineAggregate({ platform_key: {
-		type: "string",
-		maxLength: 16
-	} }, {
-		key: ["platform_key"],
-		counters: ["bundles"],
-		indexes: { byPlatform: {
-			eq: ["platform_key"],
-			sort: []
-		} }
-	})
-};
-/** Core's module: always installed, never a plugin. */
-const coreModule = {
-	id: "core",
-	schema: coreSchema
-};
-//#endregion
-exports.HOT_UPDATER_SCHEMA_VERSION = HOT_UPDATER_SCHEMA_VERSION;
-exports.coreModule = coreModule;
-exports.coreSchema = coreSchema;