@rebasepro/server 0.24.0 → 0.24.1-canary.gcb918fc

package/dist/{backup-CN0s50D2.js → backup-BnvkSLHi.js}

@@ -3,15 +3,16 @@ import __rebaseProcess from "process";
 globalThis.process ??= __rebaseProcess;
 __rebaseCreateRequire(import.meta.url);
 import { n as __exportAll } from "./rolldown-runtime-dW7B1o5h.js";
-import "./src-CatHFUym.js";
-import { a as parseEnvBoolean, r as isAlreadyExecutingSkip } from "./cron-scheduler-CYQgco86.js";
+import "./src-D5Y3N-S4.js";
+import { a as parseEnvBoolean, r as isAlreadyExecutingSkip } from "./cron-scheduler-idtLPoN-.js";
 import { r as logger } from "./logger-D-S-hO5e.js";
 import { r as errorHandler, t as ApiError } from "./errors-D6_y86c5.js";
-import { t as S3StorageController } from "./S3StorageController-CAwFRgjV.js";
-import { t as GCSStorageController } from "./GCSStorageController-BSiP1c-f.js";
+import { m as jwtOf } from "./jwt-BlvuKoR6.js";
+import { t as S3StorageController } from "./S3StorageController-BNg-pXiY.js";
+import { t as GCSStorageController } from "./GCSStorageController-fv6JAZ87.js";
+import { Hono } from "hono";
 import fs from "fs";
 import path from "path";
-import { Hono } from "hono";
 //#region src/backup/backup-common.ts
 /**
 * Storage-generic backup helpers used by the admin backup routes.
@@ -125,14 +126,16 @@ function isObjectBackupKey(dest, key) {
 */
 async function listBackupObjects(dest, storage) {
 	if (dest.kind === "local") {
-		if (!fs.existsSync(dest.path)) return [];
-		const dir = fs.statSync(dest.path).isDirectory() ? dest.path : path.dirname(dest.path);
-		if (!fs.existsSync(dir)) return [];
-		const files = fs.readdirSync(dir);
+		const stat = await fs.promises.stat(dest.path).catch(() => null);
+		if (!stat) return [];
+		const dir = stat.isDirectory() ? dest.path : path.dirname(dest.path);
+		const files = await fs.promises.readdir(dir);
 		const present = new Set(files);
-		return files.filter((f) => f.endsWith(DUMP_SUFFIX)).map((f) => {
+		const dumps = files.filter((f) => f.endsWith(DUMP_SUFFIX));
+		const stats = await mapBounded(dumps, LOCAL_STAT_CONCURRENCY, (f) => fs.promises.stat(path.join(dir, f)));
+		return dumps.map((f, i) => {
 			const full = path.join(dir, f);
-			const st = fs.statSync(full);
+			const st = stats[i];
 			const createdAt = parseBackupTimestamp(f) ?? st.mtime;
 			const globals = globalsKeyFor(f);
 			return {
@@ -160,6 +163,21 @@ async function listBackupObjects(dest, storage) {
 		};
 	}).sort(byNewest);
 }
+/** Stats in flight at once while listing a local backup folder. */
+var LOCAL_STAT_CONCURRENCY = 32;
+/** `fn` over `items`, at most `limit` at a time; results in input order. */
+async function mapBounded(items, limit, fn) {
+	const results = new Array(items.length);
+	let next = 0;
+	const worker = async () => {
+		while (next < items.length) {
+			const i = next++;
+			results[i] = await fn(items[i]);
+		}
+	};
+	await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));
+	return results;
+}
 function noControllerFor(dest) {
 	return `No storage controller for ${dest.kind === "s3" ? "s3" : "gs"}://${dest.bucket}${dest.prefix ? `/${dest.prefix}` : ""}, so its backups cannot be read.`;
 }
@@ -199,6 +217,22 @@ async function readBackupBytes(dest, key, storage) {
 	};
 }
 /**
+* Whether `key` names a backup the download route would serve, without
+* opening it: the same guards as {@link openBackupStream}, and the file or
+* object is there. An object store without `statObject` is taken at its key —
+* reading the object to find out would be the download itself.
+*/
+async function findBackup(dest, key, storage) {
+	if (dest.kind === "local") {
+		const resolved = resolveLocalBackupFile(dest, key);
+		return resolved ? { name: path.basename(resolved) } : null;
+	}
+	if (!storage) throw new Error(noControllerFor(dest));
+	if (!isObjectBackupKey(dest, key)) return null;
+	if (storage.statObject && !await storage.statObject(key, dest.bucket)) return null;
+	return { name: key.split("/").pop() || key };
+}
+/**
 * A single backup, opened for streaming, with its size. Same guards as
 * {@link readBackupBytes}.
 *
@@ -208,9 +242,11 @@ async function readBackupBytes(dest, key, storage) {
 * buffer for object storage — and a file over 2 GiB never downloaded at all:
 * `readFileSync` throws `ERR_FS_FILE_TOO_LARGE` there.
 *
-* A local file is read from disk as the response is written. Object storage
-* still arrives through {@link StorageController.getObject}, which is a
-* buffered `File` by contract; streaming that avoids the second copy.
+* A local file is read from disk as the response is written, and so is an
+* object through a controller with `getObjectStream` (the built-in S3 and GCS
+* ones). A custom controller without it still arrives through
+* {@link StorageController.getObject}, a buffered `File` by contract;
+* streaming that avoids the second copy.
 */
 async function openBackupStream(dest, key, storage) {
 	if (dest.kind === "local") {
@@ -225,12 +261,21 @@ async function openBackupStream(dest, key, storage) {
 	}
 	if (!storage) throw new Error(noControllerFor(dest));
 	if (!isObjectBackupKey(dest, key)) return null;
+	const name = key.split("/").pop() || key;
+	if (storage.getObjectStream) {
+		const object = await storage.getObjectStream(key, { bucket: dest.bucket });
+		return object ? {
+			stream: object.stream,
+			size: object.size,
+			name
+		} : null;
+	}
 	const file = await storage.getObject(key, dest.bucket);
 	if (!file) return null;
 	return {
 		stream: file.stream(),
 		size: file.size,
-		name: key.split("/").pop() || key
+		name
 	};
 }
 /** A file on disk as a web stream, read a chunk at a time as the response is written. */
@@ -261,6 +306,11 @@ function fileStream(filePath) {
 * uploads bucket, it is a local directory in development, and in production
 * without an uploads bucket there is none at all.
 */
+/** The destination `BACKUP_DESTINATION` names, or `null` when it is unset. */
+function backupDestinationFromEnv(env) {
+	const out = env.BACKUP_DESTINATION?.trim();
+	return out ? parseBackupDestination(out) : null;
+}
 /** The destination as `BACKUP_DESTINATION` spells it. */
 function describeBackupDestination(dest) {
 	if (dest.kind === "local") return dest.path;
@@ -276,7 +326,7 @@ function backupStorageFromEnv(dest, env) {
 		type: "gcs",
 		bucket: dest.bucket
 	});
-	if (!env.S3_ACCESS_KEY_ID || !env.S3_SECRET_ACCESS_KEY) throw new Error("S3_ACCESS_KEY_ID and S3_SECRET_ACCESS_KEY are not set in this server's environment. Set the same S3_* variables the backup cron uses.");
+	if (!env.S3_ACCESS_KEY_ID || !env.S3_SECRET_ACCESS_KEY) throw new Error("An S3 backup destination needs S3_ACCESS_KEY_ID and S3_SECRET_ACCESS_KEY in the environment — the same S3_* variables the backup cron uses.");
 	return new S3StorageController({
 		type: "s3",
 		bucket: dest.bucket,
@@ -295,18 +345,38 @@ function unreadable(dest, err) {
 	return ApiError.serviceUnavailable(`Cannot read the backups at ${describeBackupDestination(dest)}: ${reason}`);
 }
 /**
-* Admin REST routes for the Backups panel.
-*
-* Routes (mounted under `/admin/backups`, admin-guarded by the caller):
-*   GET /            → list available backups, and the scheduled job's last run
-*   GET /download    → download a backup's bytes (?key=…)
+* The `purpose` of a download link's token. `verifyAccessToken` refuses
+* any token with a purpose, and the storage, MFA and MCP verifiers each demand
+* their own, so a link is never a session or any other credential, and none of
+* those is a link.
 */
-function createBackupRoutes(config) {
-	const router = new Hono();
-	router.onError(errorHandler);
+var BACKUP_DOWNLOAD_PURPOSE = "backup-download";
+/** The token's audience: the one route that redeems it. */
+var BACKUP_DOWNLOAD_AUDIENCE = "rebase:admin/backups/download";
+/** What a link grants: one backup, at one destination. */
+function linkScope(dest, key) {
+	return `backup:${describeBackupDestination(dest)}:${key}`;
+}
+/**
+* Whether `token` is a live link for `key` at `dest`, signed by `jwt` — the
+* backend answering. Never throws: anything else is a no.
+*/
+async function linkGrants(jwt, token, dest, key) {
+	if (!jwt.isConfigured()) return false;
+	const claims = await jwt.verifyPurposeToken(BACKUP_DOWNLOAD_PURPOSE, token).catch(() => null);
+	return claims?.aud === BACKUP_DOWNLOAD_AUDIENCE && claims.scope === linkScope(dest, key);
+}
+/** The configured destination, or the 400 every backup route answers without one. */
+function destinationOf(config) {
+	const dest = config.getDestination();
+	if (!dest) throw ApiError.badRequest("Backups are not configured (set BACKUP_DESTINATION).");
+	return dest;
+}
+/** {@link BackupRoutesConfig.storageFor}, with its default, for a destination that has a controller. */
+function storageResolver(config) {
 	const storageFor = config.storageFor ?? ((dest) => backupStorageFromEnv(dest, process.env));
 	/** The controller for `dest`, or none for a local one. A destination it cannot read is an error, never `[]`. */
-	const storageOf = (dest) => {
+	return (dest) => {
 		if (dest.kind === "local") return void 0;
 		try {
 			return storageFor(dest);
@@ -314,6 +384,60 @@ function createBackupRoutes(config) {
 			throw unreadable(dest, err);
 		}
 	};
+}
+/** One backup's bytes as the response, streamed: a dump is the size of the database. See `openBackupStream`. */
+async function serveBackup(c, dest, key, storage) {
+	const result = await openBackupStream(dest, key, storage);
+	if (!result) throw ApiError.notFound(`Backup not found: ${key}`);
+	c.header("Content-Type", "application/octet-stream");
+	c.header("Content-Length", String(result.size));
+	c.header("Content-Disposition", `attachment; filename="${result.name}"`);
+	c.header("Cache-Control", "no-store");
+	return c.body(result.stream);
+}
+/**
+* `GET /download?key=…&token=…`: a download link spent in place of the bearer
+* header, for the one backup it names.
+*
+* Mount it at the backups prefix AHEAD of every gate on the admin prefix: the
+* auth adapter's own admin routers authenticate everything under `/admin`
+* before the Backups gate is reached. A request with no `token` passes
+* through untouched; one with a token is answered here — the backup, or a
+* 401 — and never falls through to the header: a bad link is a bad link.
+*
+* A browser cannot put a header on a navigation, so before links the SDK
+* fetched the dump and held it whole in the tab as a Blob. With a link the
+* browser streams it to disk.
+*/
+function createBackupLinkRoutes(config) {
+	const router = new Hono();
+	router.onError(errorHandler);
+	const storageOf = storageResolver(config);
+	router.get("/download", async (c, next) => {
+		const token = c.req.query("token");
+		if (token === void 0) return next();
+		const dest = destinationOf(config);
+		const key = c.req.query("key") ?? "";
+		if (!await linkGrants(jwtOf(c), token, dest, key)) throw ApiError.unauthenticated(`This download link is not valid for this backup, or it has expired. Links last 60 seconds: ask for a new one.`);
+		return serveBackup(c, dest, key, storageOf(dest));
+	});
+	return router;
+}
+/**
+* Admin REST routes for the Backups panel.
+*
+* Routes (mounted under `/admin/backups`, admin-guarded by the caller):
+*   GET  /              → list available backups, and the scheduled job's last run
+*   GET  /download      → download a backup's bytes (?key=…)
+*   POST /download-url  → a 60-second link to one backup, `{ key }` → {@link BackupDownloadLink}
+*
+* The link is spent at `GET /download?key=…&token=…`, which
+* {@link createBackupLinkRoutes} answers ahead of the gate.
+*/
+function createBackupRoutes(config) {
+	const router = new Hono();
+	router.onError(errorHandler);
+	const storageOf = storageResolver(config);
 	router.get("/", async (c) => {
 		const schedule = config.getSchedule ? await config.getSchedule() : null;
 		const dest = config.getDestination();
@@ -336,16 +460,29 @@ function createBackupRoutes(config) {
 		});
 	});
 	router.get("/download", async (c) => {
-		const dest = config.getDestination();
-		if (!dest) throw ApiError.badRequest("Backups are not configured (set BACKUP_DESTINATION).");
+		const dest = destinationOf(config);
 		const key = c.req.query("key");
 		if (!key) throw ApiError.badRequest("Missing 'key' query parameter.");
-		const result = await openBackupStream(dest, key, storageOf(dest));
-		if (!result) throw ApiError.notFound(`Backup not found: ${key}`);
-		c.header("Content-Type", "application/octet-stream");
-		c.header("Content-Length", String(result.size));
-		c.header("Content-Disposition", `attachment; filename="${result.name}"`);
-		return c.body(result.stream);
+		return serveBackup(c, dest, key, storageOf(dest));
+	});
+	router.post("/download-url", async (c) => {
+		const dest = destinationOf(config);
+		const body = await c.req.json().catch(() => null);
+		const key = typeof body === "object" && body !== null && "key" in body ? body.key : void 0;
+		if (typeof key !== "string" || !key) throw ApiError.badRequest("Send the backup's key: { \"key\": \"…\" }.");
+		if (!await findBackup(dest, key, storageOf(dest))) throw ApiError.notFound(`Backup not found: ${key}`);
+		const jwt = jwtOf(c);
+		if (!jwt.isConfigured()) throw ApiError.serviceUnavailable("Download links are signed with the JWT secret, and this server has none (auth.jwtSecret). Download through GET /download with the Authorization header instead.");
+		const token = await jwt.signPurposeToken(BACKUP_DOWNLOAD_PURPOSE, {
+			aud: BACKUP_DOWNLOAD_AUDIENCE,
+			scope: linkScope(dest, key)
+		}, 60);
+		const download = new URL("download", c.req.url).pathname;
+		return c.json({
+			url: `${download}?key=${encodeURIComponent(key)}&token=${encodeURIComponent(token)}`,
+			token,
+			expiresIn: 60
+		});
 	});
 	return router;
 }
@@ -429,7 +566,11 @@ async function readBackupSchedule(source) {
 //#endregion
 //#region src/backup/index.ts
 var backup_exports = /* @__PURE__ */ __exportAll({
+	BACKUP_DOWNLOAD_LINK_TTL_SECONDS: () => 60,
+	backupDestinationFromEnv: () => backupDestinationFromEnv,
+	createBackupLinkRoutes: () => createBackupLinkRoutes,
 	createBackupRoutes: () => createBackupRoutes,
+	findBackup: () => findBackup,
 	listAllObjectKeys: () => listAllObjectKeys,
 	listBackupObjects: () => listBackupObjects,
 	openBackupStream: () => openBackupStream,
@@ -439,6 +580,6 @@ var backup_exports = /* @__PURE__ */ __exportAll({
 	readBackupSchedule: () => readBackupSchedule
 });
 //#endregion
-export { parseBackupTimestamp as a, parseBackupDestination as i, createBackupRoutes as n, readBackupBytes as o, listBackupObjects as r, backup_exports as t };
+export { listBackupObjects as a, readBackupBytes as c, backupStorageFromEnv as i, createBackupLinkRoutes as n, parseBackupDestination as o, createBackupRoutes as r, parseBackupTimestamp as s, backup_exports as t };
 
-//# sourceMappingURL=backup-CN0s50D2.js.map
+//# sourceMappingURL=backup-BnvkSLHi.js.map

package/dist/backup-BnvkSLHi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-BnvkSLHi.js","names":[],"sources":["../src/backup/backup-common.ts","../src/backup/backup-storage.ts","../src/backup/backup-routes.ts","../src/backup/backup-schedule.ts","../src/backup/index.ts"],"sourcesContent":["/**\n * Storage-generic backup helpers used by the admin backup routes.\n *\n * These live in server (which owns {@link StorageController}) so the\n * admin API can list backups without depending on the Postgres driver —\n * `server` must not import from `server-postgres`. The `pg_dump`-side\n * copies of the tiny pure parsers live in `@rebasepro/server-postgres`;\n * keep the two in sync if the naming scheme ever changes.\n */\nimport fs from \"fs\";\nimport path from \"path\";\nimport type { BackupInfo, BackupDestinationKind } from \"@rebasepro/types\";\nimport type { StorageController } from \"../storage\";\nimport { logger } from \"../utils/logger\";\n\nexport type BackupDestination =\n    | { kind: \"local\"; path: string }\n    | { kind: \"s3\"; bucket: string; prefix: string }\n    | { kind: \"gcs\"; bucket: string; prefix: string };\n\n/** Parse a destination string (`s3://…`, `gs://…`, or a local path). */\nexport function parseBackupDestination(out: string): BackupDestination {\n    const s3 = out.match(/^s3:\\/\\/([^/]+)\\/?(.*)$/);\n    if (s3) return { kind: \"s3\", bucket: s3[1], prefix: s3[2].replace(/\\/+$/, \"\") };\n    const gcs = out.match(/^gs:\\/\\/([^/]+)\\/?(.*)$/);\n    if (gcs) return { kind: \"gcs\", bucket: gcs[1], prefix: gcs[2].replace(/\\/+$/, \"\") };\n    return { kind: \"local\", path: out };\n}\n\n/**\n * Recover the UTC creation time encoded in a `rebase-<db>-<ts>.dump` name.\n * Returns `null` for names that don't match, so foreign objects are ignored.\n */\nexport function parseBackupTimestamp(fileName: string): Date | null {\n    const base = fileName.split(\"/\").pop() ?? fileName;\n    const match = base.match(/-(\\d{8})T(\\d{6})Z\\.dump$/);\n    if (!match) return null;\n    const [, ymd, hms] = match;\n    const iso =\n        `${ymd.slice(0, 4)}-${ymd.slice(4, 6)}-${ymd.slice(6, 8)}` +\n        `T${hms.slice(0, 2)}:${hms.slice(2, 4)}:${hms.slice(4, 6)}Z`;\n    const date = new Date(iso);\n    return Number.isNaN(date.getTime()) ? null : date;\n}\n\n/**\n * A backup is two files: the `.dump`, and beside it a `.globals.sql` holding\n * the cluster roles the dump's GRANTs and RLS policies name. Without that\n * sidecar a restore into a fresh cluster stops at the first GRANT to a role\n * that does not exist there. The CLI uploads, restores and prunes the two as\n * a pair. This listing used to know only the `.dump`, so a backup downloaded\n * from Studio arrived without its roles.\n *\n * The suffix mirrors `globalsFileForDump` in `@rebasepro/server-postgres`.\n */\nconst DUMP_SUFFIX = \".dump\";\nconst GLOBALS_SUFFIX = \".globals.sql\";\n\nfunction globalsKeyFor(dumpKey: string): string {\n    return dumpKey.slice(0, -DUMP_SUFFIX.length) + GLOBALS_SUFFIX;\n}\n\n/** The only files the download route will serve. */\nfunction isBackupFile(key: string): boolean {\n    return key.endsWith(DUMP_SUFFIX) || key.endsWith(GLOBALS_SUFFIX);\n}\n\n/**\n * How many pages of an object-storage listing to read before giving up — at\n * the providers' 1,000 keys a page, 100,000 objects, or 50,000 backups.\n */\nconst MAX_LIST_PAGES = 100;\n\n/**\n * Every key under a prefix, across pages.\n *\n * S3 and GCS answer a listing a page at a time, in ascending key order, and a\n * backup's key is `rebase-<db>-<UTC timestamp>`. Reading one page therefore\n * returned the OLDEST thousand objects: with retention unset and an hourly\n * schedule, the newest backup the panel and `rebase db backups list` showed\n * stopped advancing after about three weeks, which reads as \"backups stopped\".\n */\nexport async function listAllObjectKeys(\n    storage: StorageController,\n    prefix: string,\n    bucket: string\n): Promise<string[]> {\n    const keys: string[] = [];\n    let pageToken: string | undefined;\n    for (let page = 0; page < MAX_LIST_PAGES; page++) {\n        const result = await storage.listObjects(prefix, { bucket, maxResults: 1000, pageToken });\n        for (const item of result.items) keys.push(item.fullPath);\n        pageToken = result.nextPageToken;\n        if (!pageToken) return keys;\n    }\n    logger.warn(\n        `[backups] Stopped listing ${bucket}/${prefix} after ${MAX_LIST_PAGES} pages (${keys.length} objects). ` +\n        \"Set BACKUP_RETENTION_DAYS so old backups are pruned, or give the backups a prefix of their own.\"\n    );\n    return keys;\n}\n\n/**\n * Whether an object key is one the backup routes may serve: a backup file, at\n * the destination's prefix and nowhere else.\n *\n * The local branch has always been held to the backup directory; this branch\n * checked only the suffix, so any `.dump` in the bucket — `uploads/x.dump`, a\n * neighbouring `nightlyish/` prefix — was readable by naming it. A key is taken\n * as written, so a scheme (`s3://other-bucket/…`, which S3StorageController\n * would follow) or a `.`/`..`/empty segment (which a filesystem-backed or\n * S3-compatible store may resolve) is refused rather than interpreted.\n */\nfunction isObjectBackupKey(dest: { prefix: string }, key: string): boolean {\n    if (!isBackupFile(key) || /^[a-z][a-z0-9+.-]*:\\/\\//i.test(key)) return false;\n    const segments = key.split(\"/\");\n    if (segments.some((segment) => segment === \"\" || segment === \".\" || segment === \"..\")) return false;\n    return dest.prefix === \"\" || key.startsWith(`${dest.prefix}/`);\n}\n\n/**\n * List the backups at a destination as {@link BackupInfo}, newest first.\n * One entry per `.dump`, with its `.globals.sql` sidecar attached as\n * `globalsKey` when there is one.\n */\nexport async function listBackupObjects(\n    dest: BackupDestination,\n    storage?: StorageController\n): Promise<BackupInfo[]> {\n    if (dest.kind === \"local\") {\n        // Asynchronous throughout, a few stats at a time. This runs on the\n        // Backups panel's request path, and a year of hourly backups is 8,760\n        // dumps: stat'ed synchronously, the server answered nothing else\n        // while it listed them.\n        const stat = await fs.promises.stat(dest.path).catch(() => null);\n        if (!stat) return [];\n        const dir = stat.isDirectory() ? dest.path : path.dirname(dest.path);\n        const files = await fs.promises.readdir(dir);\n        const present = new Set(files);\n        const dumps = files.filter((f) => f.endsWith(DUMP_SUFFIX));\n        const stats = await mapBounded(dumps, LOCAL_STAT_CONCURRENCY, (f) => fs.promises.stat(path.join(dir, f)));\n        return dumps\n            .map((f, i): BackupInfo => {\n                const full = path.join(dir, f);\n                const st = stats[i];\n                const createdAt = parseBackupTimestamp(f) ?? st.mtime;\n                const globals = globalsKeyFor(f);\n                return {\n                    key: full,\n                    name: f,\n                    sizeBytes: st.size,\n                    createdAt: createdAt.toISOString(),\n                    destinationKind: \"local\",\n                    ...(present.has(globals) ? { globalsKey: path.join(dir, globals) } : {})\n                };\n            })\n            .sort(byNewest);\n    }\n\n    // An empty list is a claim about the bucket. Without a controller for it\n    // nothing was read, and the panel said \"No backups yet.\" about a bucket\n    // full of them.\n    if (!storage) throw new Error(noControllerFor(dest));\n    const keys = await listAllObjectKeys(storage, dest.prefix ? `${dest.prefix}/` : \"\", dest.bucket);\n    const present = new Set(keys);\n    return keys\n        .filter((key) => key.endsWith(DUMP_SUFFIX))\n        .map((key): BackupInfo => {\n            const createdAt = parseBackupTimestamp(key);\n            const globals = globalsKeyFor(key);\n            return {\n                key,\n                name: key.split(\"/\").pop() || key,\n                createdAt: createdAt ? createdAt.toISOString() : undefined,\n                destinationKind: dest.kind as BackupDestinationKind,\n                ...(present.has(globals) ? { globalsKey: globals } : {})\n            };\n        })\n        .sort(byNewest);\n}\n\n/** Stats in flight at once while listing a local backup folder. */\nconst LOCAL_STAT_CONCURRENCY = 32;\n\n/** `fn` over `items`, at most `limit` at a time; results in input order. */\nasync function mapBounded<T, R>(items: readonly T[], limit: number, fn: (item: T) => Promise<R>): Promise<R[]> {\n    const results = new Array<R>(items.length);\n    let next = 0;\n    const worker = async () => {\n        while (next < items.length) {\n            const i = next++;\n            results[i] = await fn(items[i]);\n        }\n    };\n    await Promise.all(Array.from({ length: Math.min(limit, items.length) }, worker));\n    return results;\n}\n\nfunction noControllerFor(dest: { kind: \"s3\" | \"gcs\"; bucket: string; prefix: string }): string {\n    const scheme = dest.kind === \"s3\" ? \"s3\" : \"gs\";\n    return `No storage controller for ${scheme}://${dest.bucket}${dest.prefix ? `/${dest.prefix}` : \"\"}, so its backups cannot be read.`;\n}\n\nfunction byNewest(a: BackupInfo, b: BackupInfo): number {\n    const ta = a.createdAt ? Date.parse(a.createdAt) : 0;\n    const tb = b.createdAt ? Date.parse(b.createdAt) : 0;\n    return tb - ta;\n}\n\n/**\n * The absolute path of a local backup file, or `null` for anything the download\n * route must not serve: a path outside the backup directory, a file that is not\n * a backup, or one that does not exist.\n */\nfunction resolveLocalBackupFile(dest: { path: string }, key: string): string | null {\n    const stat = fs.existsSync(dest.path) ? fs.statSync(dest.path) : null;\n    const dir = stat?.isDirectory() ? dest.path : path.dirname(dest.path);\n    const resolvedDir = path.resolve(dir);\n    const resolved = path.resolve(key);\n    // Only allow reads inside the backup directory, and only backup files.\n    if (!resolved.startsWith(resolvedDir + path.sep) || !isBackupFile(resolved)) {\n        return null;\n    }\n    return fs.existsSync(resolved) ? resolved : null;\n}\n\n/** Read a single backup's bytes. Guards against path traversal for local. */\nexport async function readBackupBytes(\n    dest: BackupDestination,\n    key: string,\n    storage?: StorageController\n): Promise<{ bytes: Uint8Array<ArrayBuffer>; name: string } | null> {\n    if (dest.kind === \"local\") {\n        const resolved = resolveLocalBackupFile(dest, key);\n        if (!resolved) return null;\n        return { bytes: new Uint8Array(fs.readFileSync(resolved)), name: path.basename(resolved) };\n    }\n\n    if (!storage) throw new Error(noControllerFor(dest));\n    if (!isObjectBackupKey(dest, key)) return null;\n    const file = await storage.getObject(key, dest.bucket);\n    if (!file) return null;\n    return { bytes: new Uint8Array(await file.arrayBuffer()), name: key.split(\"/\").pop() || key };\n}\n\n/**\n * Whether `key` names a backup the download route would serve, without\n * opening it: the same guards as {@link openBackupStream}, and the file or\n * object is there. An object store without `statObject` is taken at its key —\n * reading the object to find out would be the download itself.\n */\nexport async function findBackup(\n    dest: BackupDestination,\n    key: string,\n    storage?: StorageController\n): Promise<{ name: string } | null> {\n    if (dest.kind === \"local\") {\n        const resolved = resolveLocalBackupFile(dest, key);\n        return resolved ? { name: path.basename(resolved) } : null;\n    }\n    if (!storage) throw new Error(noControllerFor(dest));\n    if (!isObjectBackupKey(dest, key)) return null;\n    if (storage.statObject && !(await storage.statObject(key, dest.bucket))) return null;\n    return { name: key.split(\"/\").pop() || key };\n}\n\n/**\n * A single backup, opened for streaming, with its size. Same guards as\n * {@link readBackupBytes}.\n *\n * What the download route serves. A dump is the size of the database, and\n * reading it whole put all of it on the API process's heap — twice for a local\n * destination (`readFileSync`, then a copy) and on top of the controller's own\n * buffer for object storage — and a file over 2 GiB never downloaded at all:\n * `readFileSync` throws `ERR_FS_FILE_TOO_LARGE` there.\n *\n * A local file is read from disk as the response is written, and so is an\n * object through a controller with `getObjectStream` (the built-in S3 and GCS\n * ones). A custom controller without it still arrives through\n * {@link StorageController.getObject}, a buffered `File` by contract;\n * streaming that avoids the second copy.\n */\nexport async function openBackupStream(\n    dest: BackupDestination,\n    key: string,\n    storage?: StorageController\n): Promise<{ stream: ReadableStream<Uint8Array>; size: number; name: string } | null> {\n    if (dest.kind === \"local\") {\n        const resolved = resolveLocalBackupFile(dest, key);\n        if (!resolved) return null;\n        const { size } = await fs.promises.stat(resolved);\n        return { stream: fileStream(resolved), size, name: path.basename(resolved) };\n    }\n\n    if (!storage) throw new Error(noControllerFor(dest));\n    if (!isObjectBackupKey(dest, key)) return null;\n    const name = key.split(\"/\").pop() || key;\n    if (storage.getObjectStream) {\n        const object = await storage.getObjectStream(key, { bucket: dest.bucket });\n        return object ? { stream: object.stream, size: object.size, name } : null;\n    }\n    const file = await storage.getObject(key, dest.bucket);\n    if (!file) return null;\n    return { stream: file.stream(), size: file.size, name };\n}\n\n/** A file on disk as a web stream, read a chunk at a time as the response is written. */\nfunction fileStream(filePath: string): ReadableStream<Uint8Array> {\n    const file = fs.createReadStream(filePath);\n    const chunks: AsyncIterator<Buffer> = file[Symbol.asyncIterator]();\n    return new ReadableStream<Uint8Array>({\n        async pull(controller) {\n            const next = await chunks.next();\n            if (next.done) controller.close();\n            else controller.enqueue(next.value);\n        },\n        cancel() {\n            file.destroy();\n        }\n    });\n}\n","/**\n * The storage controller that reads a backup bucket.\n *\n * A backup destination is its own bucket, named by `BACKUP_DESTINATION`, and\n * the documented backup cron writes to it through a controller it builds from\n * the `S3_*` variables (GCS: application default credentials) — as\n * `rebase db backups list` does. The admin routes have to read it the same way.\n * The app's file storage is not that controller: it is configured for the\n * uploads bucket, it is a local directory in development, and in production\n * without an uploads bucket there is none at all.\n */\nimport { parseEnvBoolean } from \"@rebasepro/types\";\nimport { GCSStorageController } from \"../storage/GCSStorageController\";\nimport { S3StorageController } from \"../storage/S3StorageController\";\nimport type { StorageController } from \"../storage/types\";\nimport { parseBackupDestination, type BackupDestination } from \"./backup-common\";\n\n/** A destination in object storage — `s3://bucket/prefix` or `gs://bucket/prefix`. */\nexport type ObjectBackupDestination = Exclude<BackupDestination, { kind: \"local\" }>;\n\n/** The destination `BACKUP_DESTINATION` names, or `null` when it is unset. */\nexport function backupDestinationFromEnv(env: Record<string, string | undefined>): BackupDestination | null {\n    const out = env.BACKUP_DESTINATION?.trim();\n    return out ? parseBackupDestination(out) : null;\n}\n\n/** The destination as `BACKUP_DESTINATION` spells it. */\nexport function describeBackupDestination(dest: BackupDestination): string {\n    if (dest.kind === \"local\") return dest.path;\n    const scheme = dest.kind === \"s3\" ? \"s3\" : \"gs\";\n    return `${scheme}://${dest.bucket}${dest.prefix ? `/${dest.prefix}` : \"\"}`;\n}\n\n/**\n * A controller for an object-storage destination's bucket, built from the\n * environment the way the backup cron and `rebase db backups list` build\n * theirs. Throws when an S3 destination has no credentials to read it with.\n */\nexport function backupStorageFromEnv(\n    dest: ObjectBackupDestination,\n    env: Record<string, string | undefined>\n): StorageController {\n    if (dest.kind === \"gcs\") {\n        return new GCSStorageController({ type: \"gcs\", bucket: dest.bucket });\n    }\n    // s3 also covers R2, MinIO and the other S3-compatible stores, through S3_ENDPOINT.\n    if (!env.S3_ACCESS_KEY_ID || !env.S3_SECRET_ACCESS_KEY) {\n        throw new Error(\n            \"An S3 backup destination needs S3_ACCESS_KEY_ID and S3_SECRET_ACCESS_KEY in the environment \" +\n            \"— the same S3_* variables the backup cron uses.\"\n        );\n    }\n    return new S3StorageController({\n        type: \"s3\",\n        bucket: dest.bucket,\n        region: env.S3_REGION || \"auto\",\n        accessKeyId: env.S3_ACCESS_KEY_ID,\n        secretAccessKey: env.S3_SECRET_ACCESS_KEY,\n        endpoint: env.S3_ENDPOINT,\n        // Unset stays unset, so the controller decides from the endpoint.\n        forcePathStyle: parseEnvBoolean(env.S3_FORCE_PATH_STYLE)\n    });\n}\n","import { Hono, type Context } from \"hono\";\nimport type { BackupDownloadLink, BackupListing, BackupScheduleStatus } from \"@rebasepro/types\";\nimport type { HonoEnv } from \"../api/types\";\nimport { ApiError, errorHandler } from \"../api/errors\";\nimport { jwtOf, type JwtService } from \"../auth/jwt\";\nimport type { StorageController } from \"../storage/types\";\nimport { BackupDestination, findBackup, listBackupObjects, openBackupStream } from \"./backup-common\";\nimport { backupStorageFromEnv, describeBackupDestination, type ObjectBackupDestination } from \"./backup-storage\";\n\nexport interface BackupRoutesConfig {\n    /**\n     * Resolve the current backup destination, or `null` when backups are not\n     * configured (`BACKUP_DESTINATION` unset). Read lazily so a restart isn't\n     * required to pick up config.\n     */\n    getDestination: () => BackupDestination | null;\n    /**\n     * The controller that reads an object-storage destination. It has to\n     * address the destination's own bucket — never the app's file storage,\n     * which is another bucket, a local directory, or nothing. Defaults to\n     * {@link backupStorageFromEnv} over `process.env`, which is how the backup\n     * cron builds the one it writes with.\n     */\n    storageFor?: (dest: ObjectBackupDestination) => StorageController;\n    /**\n     * The scheduled backup job and its last run — see `readBackupSchedule`.\n     * Omitted where this process has no cron scheduler; the listing then\n     * answers `schedule: null`.\n     */\n    getSchedule?: () => Promise<BackupScheduleStatus | null>;\n    /**\n     * True when this process does not run the scheduled jobs (the `api` role\n     * of a split deployment). A local destination read here is then this\n     * process's disk, not the one the scheduled backup writes to.\n     */\n    scheduledElsewhere?: boolean;\n}\n\n/** Why a destination could not be read, as the answer says it. */\nfunction unreadable(dest: BackupDestination, err: unknown): ApiError {\n    const reason = err instanceof Error ? err.message : String(err);\n    return ApiError.serviceUnavailable(`Cannot read the backups at ${describeBackupDestination(dest)}: ${reason}`);\n}\n\n// ─── Download links ──────────────────────────────────────────────────\n\n/**\n * The `purpose` of a download link's token. `verifyAccessToken` refuses\n * any token with a purpose, and the storage, MFA and MCP verifiers each demand\n * their own, so a link is never a session or any other credential, and none of\n * those is a link.\n */\nconst BACKUP_DOWNLOAD_PURPOSE = \"backup-download\";\n/** The token's audience: the one route that redeems it. */\nconst BACKUP_DOWNLOAD_AUDIENCE = \"rebase:admin/backups/download\";\n/** How long a link works. Long enough to start the download, not to pass around. */\nexport const BACKUP_DOWNLOAD_LINK_TTL_SECONDS = 60;\n\n/** What a link grants: one backup, at one destination. */\nfunction linkScope(dest: BackupDestination, key: string): string {\n    return `backup:${describeBackupDestination(dest)}:${key}`;\n}\n\n/**\n * Whether `token` is a live link for `key` at `dest`, signed by `jwt` — the\n * backend answering. Never throws: anything else is a no.\n */\nasync function linkGrants(jwt: JwtService, token: string, dest: BackupDestination, key: string): Promise<boolean> {\n    if (!jwt.isConfigured()) return false;\n    const claims = await jwt.verifyPurposeToken<{ aud?: unknown; scope?: unknown }>(BACKUP_DOWNLOAD_PURPOSE, token)\n        .catch(() => null);\n    return claims?.aud === BACKUP_DOWNLOAD_AUDIENCE && claims.scope === linkScope(dest, key);\n}\n\n/** The configured destination, or the 400 every backup route answers without one. */\nfunction destinationOf(config: Pick<BackupRoutesConfig, \"getDestination\">): BackupDestination {\n    const dest = config.getDestination();\n    if (!dest) throw ApiError.badRequest(\"Backups are not configured (set BACKUP_DESTINATION).\");\n    return dest;\n}\n\n/** {@link BackupRoutesConfig.storageFor}, with its default, for a destination that has a controller. */\nfunction storageResolver(config: Pick<BackupRoutesConfig, \"storageFor\">): (dest: BackupDestination) => StorageController | undefined {\n    const storageFor = config.storageFor ?? ((dest: ObjectBackupDestination) => backupStorageFromEnv(dest, process.env));\n    /** The controller for `dest`, or none for a local one. A destination it cannot read is an error, never `[]`. */\n    return (dest) => {\n        if (dest.kind === \"local\") return undefined;\n        try {\n            return storageFor(dest);\n        } catch (err) {\n            throw unreadable(dest, err);\n        }\n    };\n}\n\n/** One backup's bytes as the response, streamed: a dump is the size of the database. See `openBackupStream`. */\nasync function serveBackup(c: Context<HonoEnv>, dest: BackupDestination, key: string, storage: StorageController | undefined): Promise<Response> {\n    const result = await openBackupStream(dest, key, storage);\n    if (!result) {\n        throw ApiError.notFound(`Backup not found: ${key}`);\n    }\n    c.header(\"Content-Type\", \"application/octet-stream\");\n    c.header(\"Content-Length\", String(result.size));\n    c.header(\"Content-Disposition\", `attachment; filename=\"${result.name}\"`);\n    // A whole database, and on a link a URL that grants it: nothing in between keeps a copy.\n    c.header(\"Cache-Control\", \"no-store\");\n    return c.body(result.stream);\n}\n\n/**\n * `GET /download?key=…&token=…`: a download link spent in place of the bearer\n * header, for the one backup it names.\n *\n * Mount it at the backups prefix AHEAD of every gate on the admin prefix: the\n * auth adapter's own admin routers authenticate everything under `/admin`\n * before the Backups gate is reached. A request with no `token` passes\n * through untouched; one with a token is answered here — the backup, or a\n * 401 — and never falls through to the header: a bad link is a bad link.\n *\n * A browser cannot put a header on a navigation, so before links the SDK\n * fetched the dump and held it whole in the tab as a Blob. With a link the\n * browser streams it to disk.\n */\nexport function createBackupLinkRoutes(config: Pick<BackupRoutesConfig, \"getDestination\" | \"storageFor\">): Hono<HonoEnv> {\n    const router = new Hono<HonoEnv>();\n    router.onError(errorHandler);\n    const storageOf = storageResolver(config);\n    router.get(\"/download\", async (c, next) => {\n        const token = c.req.query(\"token\");\n        if (token === undefined) return next();\n        const dest = destinationOf(config);\n        const key = c.req.query(\"key\") ?? \"\";\n        if (!(await linkGrants(jwtOf(c), token, dest, key))) {\n            throw ApiError.unauthenticated(\n                \"This download link is not valid for this backup, or it has expired. Links last \" +\n                `${BACKUP_DOWNLOAD_LINK_TTL_SECONDS} seconds: ask for a new one.`\n            );\n        }\n        return serveBackup(c, dest, key, storageOf(dest));\n    });\n    return router;\n}\n\n/**\n * Admin REST routes for the Backups panel.\n *\n * Routes (mounted under `/admin/backups`, admin-guarded by the caller):\n *   GET  /              → list available backups, and the scheduled job's last run\n *   GET  /download      → download a backup's bytes (?key=…)\n *   POST /download-url  → a 60-second link to one backup, `{ key }` → {@link BackupDownloadLink}\n *\n * The link is spent at `GET /download?key=…&token=…`, which\n * {@link createBackupLinkRoutes} answers ahead of the gate.\n */\nexport function createBackupRoutes(config: BackupRoutesConfig): Hono<HonoEnv> {\n    const router = new Hono<HonoEnv>();\n    router.onError(errorHandler);\n\n    const storageOf = storageResolver(config);\n\n    router.get(\"/\", async (c) => {\n        // Read whether or not a destination is configured: a backup cron with\n        // no BACKUP_DESTINATION fails every run, and that is exactly what the\n        // panel has to be able to say.\n        const schedule = config.getSchedule ? await config.getSchedule() : null;\n        const dest = config.getDestination();\n        if (!dest) {\n            return c.json({ backups: [], destinationKind: \"local\", configured: false, schedule } satisfies BackupListing);\n        }\n        const backups = await listBackupObjects(dest, storageOf(dest)).catch((err: unknown) => {\n            throw unreadable(dest, err);\n        });\n        // Only where there is a scheduled backup to write elsewhere.\n        const localDiskOfThisProcess = dest.kind === \"local\" && config.scheduledElsewhere === true && schedule !== null;\n        return c.json({\n            backups,\n            destinationKind: dest.kind,\n            configured: true,\n            schedule,\n            ...(localDiskOfThisProcess ? { localDiskOfThisProcess } : {})\n        } satisfies BackupListing);\n    });\n\n    router.get(\"/download\", async (c) => {\n        const dest = destinationOf(config);\n        const key = c.req.query(\"key\");\n        if (!key) {\n            throw ApiError.badRequest(\"Missing 'key' query parameter.\");\n        }\n        return serveBackup(c, dest, key, storageOf(dest));\n    });\n\n    router.post(\"/download-url\", async (c) => {\n        const dest = destinationOf(config);\n        const body: unknown = await c.req.json().catch(() => null);\n        const key = typeof body === \"object\" && body !== null && \"key\" in body ? body.key : undefined;\n        if (typeof key !== \"string\" || !key) {\n            throw ApiError.badRequest(\"Send the backup's key: { \\\"key\\\": \\\"…\\\" }.\");\n        }\n        // The download route's own guards, so a link is never minted for a\n        // key it would refuse; and the backup is there, so the browser is not\n        // sent to a 404 in place of a file.\n        if (!(await findBackup(dest, key, storageOf(dest)))) {\n            throw ApiError.notFound(`Backup not found: ${key}`);\n        }\n        const jwt = jwtOf(c);\n        if (!jwt.isConfigured()) {\n            throw ApiError.serviceUnavailable(\n                \"Download links are signed with the JWT secret, and this server has none (auth.jwtSecret). \" +\n                \"Download through GET /download with the Authorization header instead.\"\n            );\n        }\n        const token = await jwt.signPurposeToken(\n            BACKUP_DOWNLOAD_PURPOSE,\n            { aud: BACKUP_DOWNLOAD_AUDIENCE, scope: linkScope(dest, key) },\n            BACKUP_DOWNLOAD_LINK_TTL_SECONDS\n        );\n        const download = new URL(\"download\", c.req.url).pathname;\n        return c.json({\n            url: `${download}?key=${encodeURIComponent(key)}&token=${encodeURIComponent(token)}`,\n            token,\n            expiresIn: BACKUP_DOWNLOAD_LINK_TTL_SECONDS\n        } satisfies BackupDownloadLink);\n    });\n\n    return router;\n}\n","/**\n * The scheduled backup job, as the Backups panel reports it.\n *\n * A backup that fails every night has to be visible where the backups are\n * listed. Before this the panel read the destination and nothing else, so a\n * cron that could not run `pg_dump` left an empty list under \"wait for the next\n * scheduled run\" — while each failure sat in `cron_logs`, one panel away.\n */\nimport type {\n    BackupRunOutcome,\n    BackupScheduleStatus,\n    CronJobDefinition,\n    CronJobLogEntry,\n    CronJobStatus,\n    RejectedCronJob\n} from \"@rebasepro/types\";\nimport { isAlreadyExecutingSkip } from \"../cron/cron-scheduler\";\nimport { logger } from \"../utils/logger\";\n\n/**\n * The mark `createBackupCron` (in `@rebasepro/server-postgres`) puts on the\n * definition it returns.\n *\n * A registry symbol, so it is the same value across two installed copies of\n * either package, and neither package has to import the other: `server` must\n * not depend on `server-postgres`. The job cannot be recognised any other way —\n * its id is the cron file's name and its display name is configurable.\n */\nexport const BACKUP_CRON_MARK: unique symbol = Symbol.for(\"rebase.backupCron\");\n\n/** Whether a cron definition is the scheduled backup. */\nexport function isBackupCronDefinition(definition: CronJobDefinition): boolean {\n    return Reflect.get(definition, BACKUP_CRON_MARK) === true;\n}\n\n/** The part of the cron scheduler this reads. */\nexport interface BackupScheduleSource {\n    jobIdsWhere(predicate: (definition: CronJobDefinition) => boolean): string[];\n    rejectedJobsWhere(predicate: (definition: CronJobDefinition) => boolean): RejectedCronJob[];\n    fetchJob(id: string): Promise<CronJobStatus | undefined>;\n    getJobLogsFromDb(id: string, limit?: number): Promise<CronJobLogEntry[]>;\n}\n\n/**\n * How many recent log entries to look through for the last scheduled run. A\n * skip — a slot that found the previous run still going — is logged as a\n * success with nothing done, and must not stand in for the run it skipped; nor\n * may a run someone started by hand, which is not the schedule's.\n */\nconst RECENT_RUNS = 50;\n\n/** A log entry as the panel reports a run. */\nfunction outcomeOf(entry: CronJobLogEntry): BackupRunOutcome {\n    return {\n        startedAt: entry.startedAt,\n        finishedAt: entry.finishedAt,\n        success: entry.success,\n        ...(entry.success || !entry.error ? {} : { error: entry.error }),\n        manual: entry.manual === true\n    };\n}\n\n/**\n * The scheduled backup job and its last run, or `null` when the deployment\n * has none — registered or refused.\n */\nexport async function readBackupSchedule(source: BackupScheduleSource): Promise<BackupScheduleStatus | null> {\n    const [jobId] = source.jobIdsWhere(isBackupCronDefinition);\n    if (jobId === undefined) {\n        // A refused job is not registered, and answered `null` here it read\n        // as \"no backup cron\" under a hint to add the file the project has.\n        const [refused] = source.rejectedJobsWhere(isBackupCronDefinition);\n        return refused\n            ? { jobId: refused.id, name: refused.name, schedule: refused.schedule, enabled: false, refused: refused.reason }\n            : null;\n    }\n\n    const job = await source.fetchJob(jobId);\n    if (!job) return null;\n    // Off because its own definition says so — the documented cron file\n    // exports `enabled: false` while BACKUP_SCHEDULE is unset — rather than\n    // paused by someone. Resuming that in Cron Jobs would run the placeholder.\n    const disabledInCode = !job.enabled &&\n        source.jobIdsWhere(definition => isBackupCronDefinition(definition) && definition.enabled === false).includes(jobId);\n\n    let recent: CronJobLogEntry[];\n    let historyError: string | undefined;\n    try {\n        recent = await source.getJobLogsFromDb(jobId, RECENT_RUNS);\n    } catch (err) {\n        // Said, not read as \"has not run yet\". The listing itself still\n        // answers: the backups at the destination are worth showing.\n        logger.error(`[backups] Could not read the run history of the backup job \"${jobId}\"`, { error: err });\n        recent = [];\n        historyError = \"The backup job's run history could not be read. The server log has the reason.\";\n    }\n    const runs = recent.filter(entry => !isAlreadyExecutingSkip(entry));\n    // \"Last scheduled backup\" is the schedule's: a later \"Run Now\" that worked\n    // hid a failed nightly, and a failed test run read as a failed nightly.\n    const lastScheduled = runs.find(entry => entry.manual !== true);\n    // A run by hand since then is reported too, as what it is.\n    const lastManual = runs.find(entry => entry.manual === true);\n    const manualSince = lastManual && (!lastScheduled || lastManual.startedAt > lastScheduled.startedAt)\n        ? lastManual\n        : undefined;\n\n    return {\n        jobId,\n        name: job.name,\n        schedule: job.schedule,\n        enabled: job.enabled,\n        ...(disabledInCode ? { disabledInCode } : {}),\n        ...(job.nextRunAt ? { nextRunAt: job.nextRunAt } : {}),\n        ...(historyError ? { historyError } : {}),\n        ...(lastScheduled ? { lastRun: outcomeOf(lastScheduled) } : {}),\n        ...(manualSince ? { lastManualRun: outcomeOf(manualSince) } : {})\n    };\n}\n","/**\n * Storage-generic backup helpers and admin routes for the Backups panel.\n * The `pg_dump`/`pg_restore` machinery lives in `@rebasepro/server-postgres`.\n */\nexport * from \"./backup-common\";\nexport { createBackupRoutes, createBackupLinkRoutes, BACKUP_DOWNLOAD_LINK_TTL_SECONDS } from \"./backup-routes\";\nexport { backupDestinationFromEnv, backupStorageFromEnv } from \"./backup-storage\";\nexport type { ObjectBackupDestination } from \"./backup-storage\";\nexport type { BackupRoutesConfig } from \"./backup-routes\";\nexport { readBackupSchedule, isBackupCronDefinition, BACKUP_CRON_MARK } from \"./backup-schedule\";\nexport type { BackupScheduleSource } from \"./backup-schedule\";\n"],"mappings":"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"}

package/dist/boot/boot.d.ts

@@ -1,6 +1,6 @@
 import { type Server } from "http";
 import { Hono } from "hono";
-import { type RebaseBackendInstance } from "../init.js";
+import type { RebaseBackendInstance } from "../init.js";
 import type { HonoEnv } from "../api/types.js";
 import { type Logger } from "../utils/logger.js";
 import { type RebaseBootEnv } from "./env.js";
@@ -166,7 +166,7 @@ export declare function warnOnDriverSkew(dataSources: InitializedDataSource[], r
 /**
  * Warn about a bundle whose shape makes provisioning impossible.
  *
- * `initializeRebaseBackend` provisions the collection schema for every boot
+ * `createRebaseBackend` provisions the collection schema for every boot
  * path, and it decides from what actually resolved: a project with no
  * collections reads them from the database and creates nothing. That rule is
  * right, but from inside the runtime it cannot tell "this project declares no

package/dist/boot/driver.d.ts

@@ -1,5 +1,6 @@
 import type { BackendBootstrapper, DatabaseAdapter } from "@rebasepro/types";
 import type { ResolvedDataSourceConfig } from "./sources.js";
+import type { PoolConnect } from "../metrics/pool-wait.js";
 /**
  * The connection handle a driver hands back at boot: the client object, the
  * pool to close on shutdown, and how to probe it.
@@ -19,6 +20,8 @@ export interface DriverConnection {
     pool?: {
         end: () => Promise<void>;
         query?: (sql: string) => Promise<unknown>;
+        /** Checks a connection out. Timed, when metrics are on — see `metrics/pool-wait.ts`. */
+        connect?: PoolConnect;
     };
     /** Some drivers expose a query directly instead of via a pool. */
     query?: (sql: string) => Promise<unknown>;

package/dist/boot/env.d.ts

@@ -167,10 +167,10 @@ export declare const bootEnvExtension: z.ZodObject<{
     REBASE_ROLE: z.ZodPipe<z.ZodDefault<z.ZodEnum<{
         "": "";
         functions: "functions";
+        worker: "worker";
         all: "all";
         api: "api";
-        worker: "worker";
-    }>>, z.ZodTransform<"functions" | "all" | "api" | "worker", "" | "functions" | "all" | "api" | "worker">>;
+    }>>, z.ZodTransform<"functions" | "worker" | "all" | "api", "" | "functions" | "worker" | "all" | "api">>;
     REBASE_CRON_SCHEDULER: z.ZodPipe<z.ZodOptional<z.ZodEnum<{
         "": "";
         true: "true";
@@ -195,6 +195,13 @@ export declare const bootEnvExtension: z.ZodObject<{
     REBASE_FUNCTIONS_ONLY: z.ZodOptional<z.ZodString>;
     REBASE_FUNCTIONS_EXCLUDE: z.ZodOptional<z.ZodString>;
     REBASE_FUNCTIONS_UPSTREAM: z.ZodOptional<z.ZodString>;
+    REBASE_LIVE_SCHEMA_REPOSITORY: z.ZodOptional<z.ZodString>;
+    REBASE_LIVE_SCHEMA_BRANCH: z.ZodOptional<z.ZodString>;
+    REBASE_LIVE_SCHEMA_COLLECTIONS_PATH: z.ZodOptional<z.ZodString>;
+    REBASE_LIVE_SCHEMA_GITHUB_TOKEN: z.ZodOptional<z.ZodString>;
+    REBASE_LIVE_SCHEMA_GITHUB_APP_ID: z.ZodOptional<z.ZodString>;
+    REBASE_LIVE_SCHEMA_GITHUB_APP_INSTALLATION_ID: z.ZodOptional<z.ZodString>;
+    REBASE_LIVE_SCHEMA_GITHUB_APP_PRIVATE_KEY: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type RebaseBootEnv = RebaseEnv & z.infer<typeof bootEnvExtension>;
 /**

package/dist/boot/http-server.d.ts

@@ -0,0 +1,22 @@
+import { type RequestListener, type Server } from "http";
+/**
+ * The largest request line plus headers the runtime accepts, in bytes.
+ *
+ * Node's default is 16 KB, and a request over it is answered 431 before any
+ * route sees it. The data API's own parameters reach that: a vector search
+ * carries its embedding as a JSON array in `?vector=`, and 768 dimensions of it
+ * are 16.7 KB of URL, 1,536 are 33 KB. 64 KB lets the common embedding sizes
+ * through up to 1,536 dimensions.
+ *
+ * A stopgap, not the fix. The proxy in front of most deployments has its own
+ * ceiling (nginx's is 8 KB) that no setting here moves, and 3,072 dimensions
+ * are 67 KB. `POST /api/data/<collection>/query` carries the same parameters in
+ * a body, and the SDK sends a vector search that way; this is for the URL a
+ * person or another client builds by hand.
+ *
+ * Not higher, because the bound is what it costs to hold a connection that is
+ * still sending its headers — the reason Node lowered it from 80 KB in 2018.
+ */
+export declare const RUNTIME_MAX_HEADER_SIZE: number;
+/** The runtime's HTTP server, with the header bound above. */
+export declare function createRuntimeHttpServer(listener: RequestListener): Server;

package/dist/boot/options.d.ts

@@ -1,5 +1,5 @@
 import type { CollectionConfig } from "@rebasepro/types";
-import type { RebaseAuthConfig } from "../init.js";
+import type { LiveSchemaConfig, RebaseAuthConfig } from "../backend/options.js";
 import type { EmailConfig } from "../email/index.js";
 import type { CaptchaConfig } from "../auth/captcha.js";
 import type { RebaseBootEnv } from "./env.js";
@@ -34,3 +34,18 @@ export declare function resolveEmailOptions(env: RebaseBootEnv): EmailConfig | u
  */
 export declare function resolveCaptchaOptions(env: RebaseBootEnv): CaptchaConfig | undefined;
 export declare function resolveAuthOptions(env: RebaseBootEnv, usersCollection: CollectionConfig | undefined): RebaseAuthConfig;
+/**
+ * Live schema editing for a built bundle, from the environment — or nothing.
+ *
+ * Opt-in: `undefined` unless `REBASE_LIVE_SCHEMA_REPOSITORY` names the
+ * repository to commit to, and then a bundle boots exactly as it did. A
+ * bundle has no code of its own to pass `liveSchema.repository` from, so this
+ * is the only way one can name a write target.
+ *
+ * A target that is named but cannot be reached — no credential, two
+ * credentials, half a GitHub App, a repository that is not `owner/name`, a
+ * collections path that leaves the repository — fails the boot. The other
+ * outcome is an "Edit collection" button that fails on press, on a deployment
+ * whose operator was sure they had configured it.
+ */
+export declare function resolveLiveSchemaOptions(env: RebaseBootEnv): LiveSchemaConfig | undefined;

package/dist/boot/provision.d.ts

@@ -11,8 +11,10 @@ import type { BackendBootstrapper, CollectionConfig, InitializedDriver } from "@
  * a green deploy and no failing check anywhere. It stayed that way for weeks.
  *
  * The fix is structural rather than a second copy of the logic in the other
- * path: `initializeRebaseBackend` is the one function BOTH paths go through, so
- * provisioning belongs there, and this module is what it calls.
+ * path: `createRebaseBackend` is the one function every path goes through —
+ * `initializeRebaseBackend` and the bundle boot are compositions of it — so
+ * provisioning belongs there, under its `provision` option, and this module is
+ * what it calls.
  */
 /** How the process-wide provisioning attempt turned out. */
 export type ProvisionOutcome = 

package/dist/boot/runtime-cors.d.ts

@@ -0,0 +1,17 @@
+import type { MiddlewareHandler } from "hono";
+import type { RebaseCorsOptions } from "./env.js";
+/**
+ * Hono's `cors()`, answering only the requests that are CORS preflights.
+ *
+ * `cors()` answers every `OPTIONS` itself and never calls the route, preflight
+ * or not. A plain `OPTIONS` is also a request in its own right: it is how a TUS
+ * client asks `/api/storage/tus` for `Tus-Version`, `Tus-Extension` and
+ * `Tus-Max-Size`. With `cors()` mounted in front of every route that request
+ * got a bare 204 and the TUS handler's `OPTIONS` route was unreachable.
+ *
+ * A preflight is an `OPTIONS` carrying `Access-Control-Request-Method` — the
+ * one header a browser always sends on one. Those are still answered here.
+ * Any other `OPTIONS` is handled like a `GET`: `cors()` adds the allow-origin,
+ * credentials and exposed headers, then the route answers.
+ */
+export declare function runtimeCors(options: RebaseCorsOptions): MiddlewareHandler;

package/dist/boot/sources.d.ts

@@ -66,6 +66,8 @@ export interface ResolvedDataSourceConfig {
     connectionString: string;
     adminConnectionString?: string;
     readConnectionString?: string;
+    /** The source's direct (non-pooled) URL, for the connections that hold a `LISTEN`. */
+    directConnectionString?: string;
     isDefault: boolean;
     poolConfig?: Record<string, number>;
 }

package/dist/boot/static-routing.d.ts

@@ -27,6 +27,15 @@ export declare function normalizeRequestHost(host: string): string;
  * deploy says is at an address is the app that answers there.
  */
 export declare function createStaticAppResolver(apps: readonly LoadedStaticApp[]): (request: StaticAppRequest) => LoadedStaticApp | undefined;
+/**
+ * The static apps that sit under the API's base path, and so are never served.
+ *
+ * The API's routes are mounted first and every app's fallback declines the API
+ * base path, so an app at or under it answers nothing. The reserved-path rule
+ * the CLI applies names the default `/api`; only the runtime knows
+ * `REBASE_BASE_PATH`, so a moved API is checked here.
+ */
+export declare function staticAppsShadowedByApi(apps: readonly LoadedStaticApp[], apiBasePath: string): LoadedStaticApp[];
 /** How one static app is mounted: what `serveSPA` needs beyond its own build. */
 export interface StaticAppMount {
     app: LoadedStaticApp;

package/dist/{contract-routes-fz8i4pxs.js → contract-routes-Ey6ftnKH.js}

@@ -3,26 +3,10 @@ import __rebaseProcess from "process";
 globalThis.process ??= __rebaseProcess;
 __rebaseCreateRequire(import.meta.url);
 import { n as __exportAll } from "./rolldown-runtime-dW7B1o5h.js";
-import "./src-CatHFUym.js";
+import "./src-D5Y3N-S4.js";
+import { t as SCHEMA_VERSION_HEADER } from "./project_manifest-R6y_KHms.js";
 import { r as logger } from "./logger-D-S-hO5e.js";
 import { Hono } from "hono";
-//#region ../types/src/types/project_manifest.ts
-/**
-* Whether `host` is a public DNS name an app can be given: lowercase labels of
-* letters, digits and hyphens, at least two of them, not an IP address and not
-* `localhost`. Internationalised names arrive here already in punycode.
-*/
-function isValidAppHost(host) {
-	if (host.length === 0 || host.length > 253 || host !== host.toLowerCase()) return false;
-	const labels = host.split(".");
-	if (labels.length < 2) return false;
-	const label = /^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$/;
-	if (!labels.every((part) => label.test(part))) return false;
-	return !/^[0-9]+$/.test(labels[labels.length - 1]);
-}
-/** Header carrying the schema version an SDK was generated from. */
-var SCHEMA_VERSION_HEADER = "x-rebase-schema";
-//#endregion
 //#region ../types/src/types/collection_contract.ts
 /** Depth limit for the walk — deep enough for real configs, finite for cyclic ones. */
 var MAX_DEPTH = 64;
@@ -288,6 +272,6 @@ function createContractRoutes(config) {
 	return router;
 }
 //#endregion
-export { isValidAppHost as a, SCHEMA_VERSION_HEADER as i, createContractRoutes as n, computeSchemaVersion as r, contract_routes_exports as t };
+export { createContractRoutes as n, computeSchemaVersion as r, contract_routes_exports as t };
 
-//# sourceMappingURL=contract-routes-fz8i4pxs.js.map
+//# sourceMappingURL=contract-routes-Ey6ftnKH.js.map