config.ts

1export type BucketSource =2	| {3			kind: "s3";4			endpoint: string;5			name: string;6			region: string;7			accessKeyId: string;8			secretAccessKey: string;9	  }10	// A directory laid out exactly like the bucket (Koh 3's folder remote), for development and tests.11	| { kind: "folder"; path: string };1213export type Config = {14	domain: string;15	dataDir: string;16	adminPasswordHash: string;17	bucket: BucketSource;18};1920export class ConfigError extends Error {}2122const HOSTNAME = new RegExp(23	String.raw`^[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*` +24		String.raw`(:([1-9]\d{0,3}|[1-5]\d{4}|6[0-4]\d{3}|65[0-4]\d{2}|655[0-2]\d|6553[0-5]))?$`,25	"i",26);2728export function parseConfig(text: string): Config {29	let raw: unknown;30	try {31		raw = Bun.TOML.parse(text);32	} catch (cause) {33		throw new ConfigError(`kepr.toml is not valid TOML: ${(cause as Error).message}`);34	}35	const top = asTable(raw, "kepr.toml");36	const bucket = asTable(top.bucket, "[bucket]");37	const adminPasswordHash = requireString(top, "admin_password_hash");38	if (!adminPasswordHash.startsWith("$argon2id$")) {39		throw new ConfigError("admin_password_hash must be an Argon2id hash ($argon2id$...)");40	}41	const domain = requireString(top, "domain");42	// Pages, feeds and install.sh put it in URLs and a shell script as is.43	if (!HOSTNAME.test(domain))44		throw new ConfigError("domain must be a bare hostname, with an optional :port");45	return {46		domain,47		dataDir: requireString(top, "data_dir"),48		adminPasswordHash,49		bucket: parseBucket(bucket),50	};51}5253export async function loadConfig(path: string): Promise<Config> {54	const file = Bun.file(path);55	if (!(await file.exists())) throw new ConfigError(`${path} not found`);56	return parseConfig(await file.text());57}5859function parseBucket(bucket: Record<string, unknown>): BucketSource {60	if (bucket.folder !== undefined) {61		const s3Keys = ["endpoint", "name", "region", "access_key_id", "secret_access_key"];62		const mixed = s3Keys.filter((key) => bucket[key] !== undefined);63		if (mixed.length > 0) {64			throw new ConfigError(`[bucket] folder cannot be combined with ${mixed.join(", ")}`);65		}66		return { kind: "folder", path: requireString(bucket, "folder", "[bucket] ") };67	}68	const endpoint = requireString(bucket, "endpoint", "[bucket] ");69	if (!URL.canParse(endpoint)) throw new ConfigError("[bucket] endpoint must be a URL");70	return {71		kind: "s3",72		endpoint,73		name: requireString(bucket, "name", "[bucket] "),74		region: requireString(bucket, "region", "[bucket] "),75		accessKeyId: requireString(bucket, "access_key_id", "[bucket] "),76		secretAccessKey: requireString(bucket, "secret_access_key", "[bucket] "),77	};78}7980function asTable(value: unknown, name: string): Record<string, unknown> {81	if (typeof value !== "object" || value === null || Array.isArray(value)) {82		throw new ConfigError(`${name} is missing or not a table`);83	}84	return value as Record<string, unknown>;85}8687function requireString(table: Record<string, unknown>, key: string, section = ""): string {88	const value = table[key];89	if (typeof value !== "string" || value.trim() === "") {90		throw new ConfigError(`${section}${key} is required and must be a non-empty string`);91	}92	return value;93}