emdash 0.29.0 → 0.31.0

package/dist/{authorize-BmCwQCib.mjs → authorize-6WPZa1xZ.mjs}

@@ -1,7 +1,10 @@
-import { t as apiError } from "./error-CfJMLSkd.mjs";
-import { canActOnOwn, hasPermission } from "@emdash-cms/auth";
+import { t as apiError } from "./error-DJ98TRbQ.mjs";
+import { canActOnOwn, hasPermission, hasScope } from "@emdash-cms/auth";
 
 //#region src/api/authorize.ts
+function canReadMediaUsageCount(user, tokenScopes) {
+	return hasPermission(user, "content:read_drafts") && (!tokenScopes || hasScope(tokenScopes, "admin"));
+}
 /**
 * Check if user has a permission. Returns a 401/403 Response if not, or null if authorized.
 *
@@ -33,5 +36,5 @@ function requireOwnerPerm(user, ownerId, ownPermission, anyPermission) {
 }
 
 //#endregion
-export { requirePerm as n, requireOwnerPerm as t };
-//# sourceMappingURL=authorize-BmCwQCib.mjs.map
+export { requireOwnerPerm as n, requirePerm as r, canReadMediaUsageCount as t };
+//# sourceMappingURL=authorize-6WPZa1xZ.mjs.map

package/dist/authorize-6WPZa1xZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorize-6WPZa1xZ.mjs","names":[],"sources":["../src/api/authorize.ts"],"sourcesContent":["/**\n * Authorization helpers for API routes\n *\n * Thin wrappers around @emdash-cms/auth RBAC that return HTTP responses.\n * Auth middleware handles authentication; these handle authorization.\n */\n\nimport type { Permission, RoleLevel } from \"@emdash-cms/auth\";\nimport { hasPermission, canActOnOwn, hasScope } from \"@emdash-cms/auth\";\n\nimport { apiError } from \"./error.js\";\n\ninterface UserLike {\n\tid: string;\n\trole: RoleLevel;\n}\n\nexport function canReadMediaUsageCount(\n\tuser: UserLike | null | undefined,\n\ttokenScopes: string[] | undefined,\n): boolean {\n\treturn (\n\t\thasPermission(user, \"content:read_drafts\") && (!tokenScopes || hasScope(tokenScopes, \"admin\"))\n\t);\n}\n\n/**\n * Check if user has a permission. Returns a 401/403 Response if not, or null if authorized.\n *\n * Usage:\n * ```ts\n * const denied = requirePerm(user, \"schema:manage\");\n * if (denied) return denied;\n * ```\n */\nexport function requirePerm(\n\tuser: UserLike | null | undefined,\n\tpermission: Permission,\n): Response | null {\n\tif (!user) {\n\t\treturn apiError(\"UNAUTHORIZED\", \"Authentication required\", 401);\n\t}\n\tif (!hasPermission(user, permission)) {\n\t\treturn apiError(\"FORBIDDEN\", \"Insufficient permissions\", 403);\n\t}\n\treturn null;\n}\n\n/**\n * Check if user can act on a resource, considering ownership.\n * Returns a 401/403 Response if not, or null if authorized.\n *\n * Usage:\n * ```ts\n * const denied = requireOwnerPerm(user, item.authorId, \"content:edit_own\", \"content:edit_any\");\n * if (denied) return denied;\n * ```\n */\nexport function requireOwnerPerm(\n\tuser: UserLike | null | undefined,\n\townerId: string,\n\townPermission: Permission,\n\tanyPermission: Permission,\n): Response | null {\n\tif (!user) {\n\t\treturn apiError(\"UNAUTHORIZED\", \"Authentication required\", 401);\n\t}\n\tif (!canActOnOwn(user, ownerId, ownPermission, anyPermission)) {\n\t\treturn apiError(\"FORBIDDEN\", \"Insufficient permissions\", 403);\n\t}\n\treturn null;\n}\n"],"mappings":";;;;AAiBA,SAAgB,uBACf,MACA,aACU;AACV,QACC,cAAc,MAAM,sBAAsB,KAAK,CAAC,eAAe,SAAS,aAAa,QAAQ;;;;;;;;;;;AAa/F,SAAgB,YACf,MACA,YACkB;AAClB,KAAI,CAAC,KACJ,QAAO,SAAS,gBAAgB,2BAA2B,IAAI;AAEhE,KAAI,CAAC,cAAc,MAAM,WAAW,CACnC,QAAO,SAAS,aAAa,4BAA4B,IAAI;AAE9D,QAAO;;;;;;;;;;;;AAaR,SAAgB,iBACf,MACA,SACA,eACA,eACkB;AAClB,KAAI,CAAC,KACJ,QAAO,SAAS,gBAAgB,2BAA2B,IAAI;AAEhE,KAAI,CAAC,YAAY,MAAM,SAAS,eAAe,cAAc,CAC5D,QAAO,SAAS,aAAa,4BAA4B,IAAI;AAE9D,QAAO"}

package/dist/backup-Qr9PaGUo.mjs

@@ -0,0 +1,241 @@
+import { t as OptionsRepository } from "./options-BlmBHTvX.mjs";
+import { t as ErrorCode } from "./errors-DtEXIQQV.mjs";
+import { n as VERSION } from "./version-Ci6bw6YK.mjs";
+import { t as generateSnapshot } from "./snapshot-BdpUJKD-.mjs";
+
+//#region src/api/handlers/backup.ts
+/** Storage key prefix for scheduled/manual archives. */
+const BACKUP_STORAGE_PREFIX = "backups/";
+/**
+* Filename prefix within the backups/ folder. Included in the list() prefix
+* so LocalStorage (which matches directory + filename prefix, not flat keys
+* like S3/R2) finds the archives too.
+*/
+const BACKUP_FILE_PREFIX = "emdash-backup-";
+/** Options key holding the scheduled-backup settings. */
+const BACKUP_SETTINGS_KEY = "emdash:backups";
+/** Options key holding the ISO timestamp of the last scheduled run. */
+const BACKUP_LAST_RUN_KEY = "emdash:backups_last_run";
+/** Minimum interval between scheduled backups (23h — daily with cron jitter). */
+const SCHEDULED_BACKUP_INTERVAL_MS = 1380 * 60 * 1e3;
+/** Retention bounds for stored archives. */
+const BACKUP_RETENTION_MIN = 1;
+const BACKUP_RETENTION_MAX = 30;
+const BACKUP_RETENTION_DEFAULT = 7;
+/**
+* Options-table key prefixes included in backups. Site settings plus the
+* site-identity keys (`emdash:site_title`, `emdash:site_tagline`,
+* `emdash:site_url`). Never widen this to a prefix that can match secrets
+* (`emdash:preview_secret`, `plugin:`, `emdash:passkey_pending:`).
+*/
+const BACKUP_OPTION_PREFIXES = [
+	"site:",
+	"emdash:site_",
+	"emdash:locale"
+];
+/**
+* Archive filename shape. Strict allowlist — the download/delete routes
+* interpolate this into a storage key, so it must never contain `/` or `..`.
+* The random suffix makes names unguessable (defense in depth on top of the
+* media route's backups/ deny) and avoids same-second collisions.
+*/
+const ARCHIVE_NAME_PATTERN = /^emdash-backup-\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-[0-9a-f]{8}\.json$/;
+function isValidArchiveName(name) {
+	return ARCHIVE_NAME_PATTERN.test(name);
+}
+const DEFAULT_SETTINGS = {
+	enabled: false,
+	retention: BACKUP_RETENTION_DEFAULT
+};
+function clampRetention(value) {
+	if (!Number.isFinite(value)) return BACKUP_RETENTION_DEFAULT;
+	return Math.min(BACKUP_RETENTION_MAX, Math.max(BACKUP_RETENTION_MIN, Math.trunc(value)));
+}
+/**
+* Generate a full content backup as a JSON string.
+*
+* ponytail: the whole backup is materialized in memory. Fine for the sites
+* EmDash targets today; truly huge databases should use `wrangler d1 export`
+* (documented on the backups docs page). Upgrade path: stream table-by-table.
+*/
+async function generateBackupJson(db) {
+	const snapshot = await generateSnapshot(db, {
+		includeDrafts: true,
+		includeTrashed: true,
+		optionPrefixes: BACKUP_OPTION_PREFIXES
+	});
+	return JSON.stringify({
+		format: "emdash-backup",
+		formatVersion: 1,
+		emdashVersion: VERSION,
+		generatedAt: snapshot.generatedAt,
+		schema: snapshot.schema,
+		tables: snapshot.tables
+	});
+}
+/** Derive the archive filename for a given date (plus a random suffix). */
+function archiveNameForDate(date) {
+	return `emdash-backup-${date.toISOString().slice(0, 19).replaceAll(":", "-")}-${crypto.randomUUID().replaceAll("-", "").slice(0, 8)}.json`;
+}
+async function getBackupSettings(db) {
+	const stored = await new OptionsRepository(db).get(BACKUP_SETTINGS_KEY);
+	if (!stored) return { ...DEFAULT_SETTINGS };
+	return {
+		enabled: stored.enabled === true,
+		retention: clampRetention(stored.retention ?? BACKUP_RETENTION_DEFAULT)
+	};
+}
+async function updateBackupSettings(db, input) {
+	try {
+		const settings = {
+			enabled: input.enabled,
+			retention: clampRetention(input.retention)
+		};
+		await new OptionsRepository(db).set(BACKUP_SETTINGS_KEY, settings);
+		return {
+			success: true,
+			data: settings
+		};
+	} catch (error) {
+		console.error("[backup] Failed to update settings:", error);
+		return {
+			success: false,
+			error: {
+				code: ErrorCode.BACKUP_SETTINGS_ERROR,
+				message: "Failed to update backup settings"
+			}
+		};
+	}
+}
+/**
+* List stored archives, newest first.
+*
+* ponytail: single unpaginated list. The retention cap (max 30) bounds the
+* archive count, so one page always suffices.
+*/
+async function listBackupArchives(storage) {
+	try {
+		return {
+			success: true,
+			data: (await storage.list({
+				prefix: `${BACKUP_STORAGE_PREFIX}${BACKUP_FILE_PREFIX}`,
+				limit: 100
+			})).files.map((file) => ({
+				name: file.key.slice(8),
+				size: file.size,
+				lastModified: file.lastModified.toISOString()
+			})).filter((archive) => isValidArchiveName(archive.name)).toSorted((a, b) => a.name < b.name ? 1 : -1)
+		};
+	} catch (error) {
+		console.error("[backup] Failed to list archives:", error);
+		return {
+			success: false,
+			error: {
+				code: ErrorCode.BACKUP_LIST_ERROR,
+				message: "Failed to list backup archives"
+			}
+		};
+	}
+}
+/**
+* Create a backup and store it as an archive, then prune old archives
+* beyond `retention`.
+*/
+async function runBackupToStorage(db, storage, retention) {
+	try {
+		const json = await generateBackupJson(db);
+		const name = archiveNameForDate(/* @__PURE__ */ new Date());
+		const body = new TextEncoder().encode(json);
+		await storage.upload({
+			key: `${BACKUP_STORAGE_PREFIX}${name}`,
+			body,
+			contentType: "application/json"
+		});
+		await pruneArchives(storage, clampRetention(retention));
+		return {
+			success: true,
+			data: {
+				name,
+				size: body.byteLength,
+				lastModified: (/* @__PURE__ */ new Date()).toISOString()
+			}
+		};
+	} catch (error) {
+		console.error("[backup] Failed to create archive:", error);
+		return {
+			success: false,
+			error: {
+				code: ErrorCode.BACKUP_CREATE_ERROR,
+				message: "Failed to create backup archive"
+			}
+		};
+	}
+}
+/** Delete archives beyond the newest `keep`. Failures are logged, not fatal. */
+async function pruneArchives(storage, keep) {
+	const listed = await listBackupArchives(storage);
+	if (!listed.success) return;
+	for (const archive of listed.data.slice(keep)) try {
+		await storage.delete(`${BACKUP_STORAGE_PREFIX}${archive.name}`);
+	} catch (error) {
+		console.error(`[backup] Failed to prune archive ${archive.name}:`, error);
+	}
+}
+async function deleteBackupArchive(storage, name) {
+	if (!isValidArchiveName(name)) return {
+		success: false,
+		error: {
+			code: ErrorCode.VALIDATION_ERROR,
+			message: "Invalid archive name"
+		}
+	};
+	try {
+		await storage.delete(`${BACKUP_STORAGE_PREFIX}${name}`);
+		return {
+			success: true,
+			data: { deleted: true }
+		};
+	} catch (error) {
+		console.error(`[backup] Failed to delete archive ${name}:`, error);
+		return {
+			success: false,
+			error: {
+				code: ErrorCode.BACKUP_DELETE_ERROR,
+				message: "Failed to delete backup archive"
+			}
+		};
+	}
+}
+/**
+* Run a scheduled backup if enabled and due. Called from the maintenance
+* tick alongside scheduled publishing and system cleanup — never from a
+* request. Never throws.
+*
+* ponytail: last-run bookkeeping is a plain read-then-write, so two isolates
+* ticking simultaneously could both back up. Worst case is a duplicate
+* archive that retention prunes; not worth a lock.
+*/
+async function maybeRunScheduledBackup(db, storage) {
+	try {
+		if (!storage) return;
+		const settings = await getBackupSettings(db);
+		if (!settings.enabled) return;
+		const options = new OptionsRepository(db);
+		const lastRun = await options.get(BACKUP_LAST_RUN_KEY);
+		if (lastRun) {
+			const elapsed = Date.now() - Date.parse(lastRun);
+			if (Number.isFinite(elapsed) && elapsed < SCHEDULED_BACKUP_INTERVAL_MS) return;
+		}
+		const result = await runBackupToStorage(db, storage, settings.retention);
+		if (result.success) {
+			await options.set(BACKUP_LAST_RUN_KEY, (/* @__PURE__ */ new Date()).toISOString());
+			console.log(`[backup] Scheduled backup stored: ${result.data.name}`);
+		}
+	} catch (error) {
+		console.error("[backup] Scheduled backup failed:", error);
+	}
+}
+
+//#endregion
+export { deleteBackupArchive as a, isValidArchiveName as c, runBackupToStorage as d, updateBackupSettings as f, archiveNameForDate as i, listBackupArchives as l, BACKUP_RETENTION_MIN as n, generateBackupJson as o, BACKUP_STORAGE_PREFIX as r, getBackupSettings as s, BACKUP_RETENTION_MAX as t, maybeRunScheduledBackup as u };
+//# sourceMappingURL=backup-Qr9PaGUo.mjs.map

package/dist/backup-Qr9PaGUo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"backup-Qr9PaGUo.mjs","names":[],"sources":["../src/api/handlers/backup.ts"],"sourcesContent":["/**\n * Backup handlers — portable content backups, on demand and scheduled.\n *\n * A backup is the snapshot format (see `snapshot.ts`) wrapped in a small\n * envelope: all content (including drafts, scheduled, and trashed entries),\n * schema definitions, taxonomies, menus, widgets, revisions, media metadata,\n * and site settings.\n *\n * Deliberately NOT included:\n * - Users, sessions, credentials, API/OAuth tokens (auth data is neither\n *   portable nor safe in a user-downloadable file)\n * - Secrets (`emdash:preview_secret`, plugin config, passkey challenges)\n * - Media binaries (metadata only — the files live in the same bucket the\n *   scheduled archives are written to)\n *\n * For full point-in-time database recovery on Cloudflare, D1 Time Travel\n * covers the last 30 days out of the box; these backups complement it with\n * user-holdable, longer-lived archives.\n */\n\nimport type { Kysely } from \"kysely\";\n\nimport { OptionsRepository } from \"../../database/repositories/options.js\";\nimport type { Database } from \"../../database/types.js\";\nimport type { Storage } from \"../../storage/types.js\";\nimport { VERSION } from \"../../version.js\";\nimport { ErrorCode } from \"../errors.js\";\nimport type { ApiResult } from \"../types.js\";\nimport { generateSnapshot } from \"./snapshot.js\";\n\n// ── Constants ───────────────────────────────────────────────────\n\n/** Storage key prefix for scheduled/manual archives. */\nexport const BACKUP_STORAGE_PREFIX = \"backups/\";\n\n/**\n * Filename prefix within the backups/ folder. Included in the list() prefix\n * so LocalStorage (which matches directory + filename prefix, not flat keys\n * like S3/R2) finds the archives too.\n */\nconst BACKUP_FILE_PREFIX = \"emdash-backup-\";\n\n/** Options key holding the scheduled-backup settings. */\nexport const BACKUP_SETTINGS_KEY = \"emdash:backups\";\n\n/** Options key holding the ISO timestamp of the last scheduled run. */\nconst BACKUP_LAST_RUN_KEY = \"emdash:backups_last_run\";\n\n/** Minimum interval between scheduled backups (23h — daily with cron jitter). */\nconst SCHEDULED_BACKUP_INTERVAL_MS = 23 * 60 * 60 * 1000;\n\n/** Retention bounds for stored archives. */\nexport const BACKUP_RETENTION_MIN = 1;\nexport const BACKUP_RETENTION_MAX = 30;\nconst BACKUP_RETENTION_DEFAULT = 7;\n\n/**\n * Options-table key prefixes included in backups. Site settings plus the\n * site-identity keys (`emdash:site_title`, `emdash:site_tagline`,\n * `emdash:site_url`). Never widen this to a prefix that can match secrets\n * (`emdash:preview_secret`, `plugin:`, `emdash:passkey_pending:`).\n */\nconst BACKUP_OPTION_PREFIXES = [\"site:\", \"emdash:site_\", \"emdash:locale\"];\n\n/**\n * Archive filename shape. Strict allowlist — the download/delete routes\n * interpolate this into a storage key, so it must never contain `/` or `..`.\n * The random suffix makes names unguessable (defense in depth on top of the\n * media route's backups/ deny) and avoids same-second collisions.\n */\nconst ARCHIVE_NAME_PATTERN =\n\t/^emdash-backup-\\d{4}-\\d{2}-\\d{2}T\\d{2}-\\d{2}-\\d{2}-[0-9a-f]{8}\\.json$/;\n\nexport function isValidArchiveName(name: string): boolean {\n\treturn ARCHIVE_NAME_PATTERN.test(name);\n}\n\n// ── Types ───────────────────────────────────────────────────────\n\nexport interface BackupSettings {\n\t/** Whether daily scheduled backups to storage are enabled. */\n\tenabled: boolean;\n\t/** How many archives to keep in storage (oldest pruned first). */\n\tretention: number;\n}\n\nexport interface BackupArchive {\n\t/** Filename within the backups/ prefix (no path separators). */\n\tname: string;\n\t/** Size in bytes. */\n\tsize: number;\n\t/** Last-modified timestamp (ISO). */\n\tlastModified: string;\n}\n\nconst DEFAULT_SETTINGS: BackupSettings = {\n\tenabled: false,\n\tretention: BACKUP_RETENTION_DEFAULT,\n};\n\nfunction clampRetention(value: number): number {\n\tif (!Number.isFinite(value)) return BACKUP_RETENTION_DEFAULT;\n\treturn Math.min(BACKUP_RETENTION_MAX, Math.max(BACKUP_RETENTION_MIN, Math.trunc(value)));\n}\n\n// ── Export ──────────────────────────────────────────────────────\n\n/**\n * Generate a full content backup as a JSON string.\n *\n * ponytail: the whole backup is materialized in memory. Fine for the sites\n * EmDash targets today; truly huge databases should use `wrangler d1 export`\n * (documented on the backups docs page). Upgrade path: stream table-by-table.\n */\nexport async function generateBackupJson(db: Kysely<Database>): Promise<string> {\n\tconst snapshot = await generateSnapshot(db, {\n\t\tincludeDrafts: true,\n\t\tincludeTrashed: true,\n\t\toptionPrefixes: BACKUP_OPTION_PREFIXES,\n\t});\n\n\treturn JSON.stringify({\n\t\tformat: \"emdash-backup\",\n\t\tformatVersion: 1,\n\t\temdashVersion: VERSION,\n\t\tgeneratedAt: snapshot.generatedAt,\n\t\tschema: snapshot.schema,\n\t\ttables: snapshot.tables,\n\t});\n}\n\n/** Derive the archive filename for a given date (plus a random suffix). */\nexport function archiveNameForDate(date: Date): string {\n\t// 2026-07-09T08:45:12.345Z → emdash-backup-2026-07-09T08-45-12-1a2b3c4d.json\n\tconst stamp = date.toISOString().slice(0, 19).replaceAll(\":\", \"-\");\n\tconst suffix = crypto.randomUUID().replaceAll(\"-\", \"\").slice(0, 8);\n\treturn `emdash-backup-${stamp}-${suffix}.json`;\n}\n\n// ── Settings ────────────────────────────────────────────────────\n\nexport async function getBackupSettings(db: Kysely<Database>): Promise<BackupSettings> {\n\tconst options = new OptionsRepository(db);\n\tconst stored = await options.get<Partial<BackupSettings>>(BACKUP_SETTINGS_KEY);\n\tif (!stored) return { ...DEFAULT_SETTINGS };\n\treturn {\n\t\tenabled: stored.enabled === true,\n\t\tretention: clampRetention(stored.retention ?? BACKUP_RETENTION_DEFAULT),\n\t};\n}\n\nexport async function updateBackupSettings(\n\tdb: Kysely<Database>,\n\tinput: { enabled: boolean; retention: number },\n): Promise<ApiResult<BackupSettings>> {\n\ttry {\n\t\tconst settings: BackupSettings = {\n\t\t\tenabled: input.enabled,\n\t\t\tretention: clampRetention(input.retention),\n\t\t};\n\t\tconst options = new OptionsRepository(db);\n\t\tawait options.set(BACKUP_SETTINGS_KEY, settings);\n\t\treturn { success: true, data: settings };\n\t} catch (error) {\n\t\tconsole.error(\"[backup] Failed to update settings:\", error);\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: { code: ErrorCode.BACKUP_SETTINGS_ERROR, message: \"Failed to update backup settings\" },\n\t\t};\n\t}\n}\n\n// ── Archives in storage ─────────────────────────────────────────\n\n/**\n * List stored archives, newest first.\n *\n * ponytail: single unpaginated list. The retention cap (max 30) bounds the\n * archive count, so one page always suffices.\n */\nexport async function listBackupArchives(storage: Storage): Promise<ApiResult<BackupArchive[]>> {\n\ttry {\n\t\tconst result = await storage.list({\n\t\t\tprefix: `${BACKUP_STORAGE_PREFIX}${BACKUP_FILE_PREFIX}`,\n\t\t\tlimit: 100,\n\t\t});\n\t\tconst archives = result.files\n\t\t\t.map((file) => ({\n\t\t\t\tname: file.key.slice(BACKUP_STORAGE_PREFIX.length),\n\t\t\t\tsize: file.size,\n\t\t\t\tlastModified: file.lastModified.toISOString(),\n\t\t\t}))\n\t\t\t.filter((archive) => isValidArchiveName(archive.name))\n\t\t\t.toSorted((a, b) => (a.name < b.name ? 1 : -1));\n\t\treturn { success: true, data: archives };\n\t} catch (error) {\n\t\tconsole.error(\"[backup] Failed to list archives:\", error);\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: { code: ErrorCode.BACKUP_LIST_ERROR, message: \"Failed to list backup archives\" },\n\t\t};\n\t}\n}\n\n/**\n * Create a backup and store it as an archive, then prune old archives\n * beyond `retention`.\n */\nexport async function runBackupToStorage(\n\tdb: Kysely<Database>,\n\tstorage: Storage,\n\tretention: number,\n): Promise<ApiResult<BackupArchive>> {\n\ttry {\n\t\tconst json = await generateBackupJson(db);\n\t\tconst name = archiveNameForDate(new Date());\n\t\tconst body = new TextEncoder().encode(json);\n\n\t\tawait storage.upload({\n\t\t\tkey: `${BACKUP_STORAGE_PREFIX}${name}`,\n\t\t\tbody,\n\t\t\tcontentType: \"application/json\",\n\t\t});\n\n\t\tawait pruneArchives(storage, clampRetention(retention));\n\n\t\treturn {\n\t\t\tsuccess: true,\n\t\t\tdata: { name, size: body.byteLength, lastModified: new Date().toISOString() },\n\t\t};\n\t} catch (error) {\n\t\tconsole.error(\"[backup] Failed to create archive:\", error);\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: { code: ErrorCode.BACKUP_CREATE_ERROR, message: \"Failed to create backup archive\" },\n\t\t};\n\t}\n}\n\n/** Delete archives beyond the newest `keep`. Failures are logged, not fatal. */\nasync function pruneArchives(storage: Storage, keep: number): Promise<void> {\n\tconst listed = await listBackupArchives(storage);\n\tif (!listed.success) return;\n\n\tfor (const archive of listed.data.slice(keep)) {\n\t\ttry {\n\t\t\tawait storage.delete(`${BACKUP_STORAGE_PREFIX}${archive.name}`);\n\t\t} catch (error) {\n\t\t\tconsole.error(`[backup] Failed to prune archive ${archive.name}:`, error);\n\t\t}\n\t}\n}\n\nexport async function deleteBackupArchive(\n\tstorage: Storage,\n\tname: string,\n): Promise<ApiResult<{ deleted: true }>> {\n\tif (!isValidArchiveName(name)) {\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: { code: ErrorCode.VALIDATION_ERROR, message: \"Invalid archive name\" },\n\t\t};\n\t}\n\ttry {\n\t\tawait storage.delete(`${BACKUP_STORAGE_PREFIX}${name}`);\n\t\treturn { success: true, data: { deleted: true } };\n\t} catch (error) {\n\t\tconsole.error(`[backup] Failed to delete archive ${name}:`, error);\n\t\treturn {\n\t\t\tsuccess: false,\n\t\t\terror: { code: ErrorCode.BACKUP_DELETE_ERROR, message: \"Failed to delete backup archive\" },\n\t\t};\n\t}\n}\n\n// ── Scheduled runs ──────────────────────────────────────────────\n\n/**\n * Run a scheduled backup if enabled and due. Called from the maintenance\n * tick alongside scheduled publishing and system cleanup — never from a\n * request. Never throws.\n *\n * ponytail: last-run bookkeeping is a plain read-then-write, so two isolates\n * ticking simultaneously could both back up. Worst case is a duplicate\n * archive that retention prunes; not worth a lock.\n */\nexport async function maybeRunScheduledBackup(\n\tdb: Kysely<Database>,\n\tstorage: Storage | undefined,\n): Promise<void> {\n\ttry {\n\t\tif (!storage) return;\n\n\t\tconst settings = await getBackupSettings(db);\n\t\tif (!settings.enabled) return;\n\n\t\tconst options = new OptionsRepository(db);\n\t\tconst lastRun = await options.get<string>(BACKUP_LAST_RUN_KEY);\n\t\tif (lastRun) {\n\t\t\tconst elapsed = Date.now() - Date.parse(lastRun);\n\t\t\tif (Number.isFinite(elapsed) && elapsed < SCHEDULED_BACKUP_INTERVAL_MS) return;\n\t\t}\n\n\t\tconst result = await runBackupToStorage(db, storage, settings.retention);\n\t\tif (result.success) {\n\t\t\tawait options.set(BACKUP_LAST_RUN_KEY, new Date().toISOString());\n\t\t\tconsole.log(`[backup] Scheduled backup stored: ${result.data.name}`);\n\t\t}\n\t} catch (error) {\n\t\tconsole.error(\"[backup] Scheduled backup failed:\", error);\n\t}\n}\n"],"mappings":"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"}

package/dist/{base64-C74Msx8h.mjs → base64-B-PsqheR.mjs}

@@ -27,11 +27,15 @@ function encodeBase64(str) {
 }
 /** Decode a standard base64 string to a UTF-8 string. */
 function decodeBase64(base64) {
-	if (hasNative) return new TextDecoder().decode(Uint8Array.fromBase64(base64));
+	return new TextDecoder().decode(decodeBase64Bytes(base64));
+}
+/** Decode a standard base64 string to raw bytes (for binary payloads). */
+function decodeBase64Bytes(base64) {
+	if (hasNative) return Uint8Array.fromBase64(base64);
 	const binary = atob(base64);
 	const bytes = new Uint8Array(binary.length);
 	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
-	return new TextDecoder().decode(bytes);
+	return bytes;
 }
 /** Encode bytes as base64url without padding. */
 function encodeBase64url(bytes) {
@@ -55,5 +59,5 @@ function decodeBase64url(encoded) {
 }
 
 //#endregion
-export { encodeBase64url as i, decodeBase64url as n, encodeBase64 as r, decodeBase64 as t };
-//# sourceMappingURL=base64-C74Msx8h.mjs.map
+export { encodeBase64url as a, encodeBase64 as i, decodeBase64Bytes as n, decodeBase64url as r, decodeBase64 as t };
+//# sourceMappingURL=base64-B-PsqheR.mjs.map

package/dist/base64-B-PsqheR.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64-B-PsqheR.mjs","names":[],"sources":["../src/utils/base64.ts"],"sourcesContent":["/**\n * Base64 encoding/decoding utilities.\n *\n * Uses native Uint8Array.prototype.toBase64 / Uint8Array.fromBase64 when\n * available (workerd, Node 26+, modern browsers), falls back to btoa/atob.\n *\n * All base64url encoding uses the { alphabet: \"base64url\" } option natively\n * or manual character replacement as fallback.\n *\n * Delete the fallback paths when the minimum Node version supports these\n * methods natively.\n */\n\nconst hasNative =\n\ttypeof Uint8Array.prototype.toBase64 === \"function\" &&\n\ttypeof Uint8Array.fromBase64 === \"function\";\n\n// Regex patterns for base64url character replacement\nconst BASE64_PLUS_PATTERN = /\\+/g;\nconst BASE64_SLASH_PATTERN = /\\//g;\nconst BASE64_PADDING_PATTERN = /=+$/;\nconst BASE64URL_DASH_PATTERN = /-/g;\nconst BASE64URL_UNDERSCORE_PATTERN = /_/g;\n\n// ---------------------------------------------------------------------------\n// Standard base64 (for opaque tokens, cursors, Basic Auth, etc.)\n// ---------------------------------------------------------------------------\n\n/** Encode a UTF-8 string as standard base64. */\nexport function encodeBase64(str: string): string {\n\tconst bytes = new TextEncoder().encode(str);\n\tif (hasNative) return bytes.toBase64();\n\tlet binary = \"\";\n\tfor (const b of bytes) binary += String.fromCharCode(b);\n\treturn btoa(binary);\n}\n\n/** Decode a standard base64 string to a UTF-8 string. */\nexport function decodeBase64(base64: string): string {\n\treturn new TextDecoder().decode(decodeBase64Bytes(base64));\n}\n\n/** Decode a standard base64 string to raw bytes (for binary payloads). */\nexport function decodeBase64Bytes(base64: string): Uint8Array {\n\tif (hasNative) return Uint8Array.fromBase64(base64);\n\tconst binary = atob(base64);\n\tconst bytes = new Uint8Array(binary.length);\n\tfor (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);\n\treturn bytes;\n}\n\n// ---------------------------------------------------------------------------\n// Base64url (for tokens, HMAC signatures, PKCE, etc.)\n// ---------------------------------------------------------------------------\n\n/** Encode bytes as base64url without padding. */\nexport function encodeBase64url(bytes: Uint8Array): string {\n\tif (hasNative) return bytes.toBase64({ alphabet: \"base64url\", omitPadding: true });\n\tlet binary = \"\";\n\tfor (const b of bytes) binary += String.fromCharCode(b);\n\treturn btoa(binary)\n\t\t.replace(BASE64_PLUS_PATTERN, \"-\")\n\t\t.replace(BASE64_SLASH_PATTERN, \"_\")\n\t\t.replace(BASE64_PADDING_PATTERN, \"\");\n}\n\n/** Decode a base64url string (with or without padding) to bytes. */\nexport function decodeBase64url(encoded: string): Uint8Array {\n\tif (hasNative) return Uint8Array.fromBase64(encoded, { alphabet: \"base64url\" });\n\tconst base64 = encoded\n\t\t.replace(BASE64URL_DASH_PATTERN, \"+\")\n\t\t.replace(BASE64URL_UNDERSCORE_PATTERN, \"/\");\n\tconst padded = base64 + \"=\".repeat((4 - (base64.length % 4)) % 4);\n\tconst binary = atob(padded);\n\tconst bytes = new Uint8Array(binary.length);\n\tfor (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);\n\treturn bytes;\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAM,YACL,OAAO,WAAW,UAAU,aAAa,cACzC,OAAO,WAAW,eAAe;AAGlC,MAAM,sBAAsB;AAC5B,MAAM,uBAAuB;AAC7B,MAAM,yBAAyB;AAC/B,MAAM,yBAAyB;AAC/B,MAAM,+BAA+B;;AAOrC,SAAgB,aAAa,KAAqB;CACjD,MAAM,QAAQ,IAAI,aAAa,CAAC,OAAO,IAAI;AAC3C,KAAI,UAAW,QAAO,MAAM,UAAU;CACtC,IAAI,SAAS;AACb,MAAK,MAAM,KAAK,MAAO,WAAU,OAAO,aAAa,EAAE;AACvD,QAAO,KAAK,OAAO;;;AAIpB,SAAgB,aAAa,QAAwB;AACpD,QAAO,IAAI,aAAa,CAAC,OAAO,kBAAkB,OAAO,CAAC;;;AAI3D,SAAgB,kBAAkB,QAA4B;AAC7D,KAAI,UAAW,QAAO,WAAW,WAAW,OAAO;CACnD,MAAM,SAAS,KAAK,OAAO;CAC3B,MAAM,QAAQ,IAAI,WAAW,OAAO,OAAO;AAC3C,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IAAK,OAAM,KAAK,OAAO,WAAW,EAAE;AACvE,QAAO;;;AAQR,SAAgB,gBAAgB,OAA2B;AAC1D,KAAI,UAAW,QAAO,MAAM,SAAS;EAAE,UAAU;EAAa,aAAa;EAAM,CAAC;CAClF,IAAI,SAAS;AACb,MAAK,MAAM,KAAK,MAAO,WAAU,OAAO,aAAa,EAAE;AACvD,QAAO,KAAK,OAAO,CACjB,QAAQ,qBAAqB,IAAI,CACjC,QAAQ,sBAAsB,IAAI,CAClC,QAAQ,wBAAwB,GAAG;;;AAItC,SAAgB,gBAAgB,SAA6B;AAC5D,KAAI,UAAW,QAAO,WAAW,WAAW,SAAS,EAAE,UAAU,aAAa,CAAC;CAC/E,MAAM,SAAS,QACb,QAAQ,wBAAwB,IAAI,CACpC,QAAQ,8BAA8B,IAAI;CAC5C,MAAM,SAAS,SAAS,IAAI,QAAQ,IAAK,OAAO,SAAS,KAAM,EAAE;CACjE,MAAM,SAAS,KAAK,OAAO;CAC3B,MAAM,QAAQ,IAAI,WAAW,OAAO,OAAO;AAC3C,MAAK,IAAI,IAAI,GAAG,IAAI,OAAO,QAAQ,IAAK,OAAM,KAAK,OAAO,WAAW,EAAE;AACvE,QAAO"}

package/dist/{byline-BWb5H-65.mjs → byline-BTOxUlFF.mjs}

@@ -1,12 +1,12 @@
-import { o as __exportAll } from "./runner-jt65bF7F.mjs";
+import { o as __exportAll } from "./runner-BdeLEgad.mjs";
 import { t as validateIdentifier } from "./validate-VPnKoIzW.mjs";
-import { l as listTablesLike } from "./dialect-helpers-Cue7QQOR.mjs";
+import { c as listTablesLike } from "./dialect-helpers-BtOwo2us.mjs";
 import { a as invalidateBylineObjectCache, o as invalidateCollectionCache } from "./object-cache-Bok5j2ae.mjs";
-import { n as chunks, t as SQL_BATCH_SIZE } from "./chunks-BU5_nrAC.mjs";
-import { a as encodeCursor, i as decodeCursor, t as EmDashValidationError } from "./types-Ch8pFMEm.mjs";
+import { n as chunks, t as SQL_BATCH_SIZE } from "./chunks-Bq-5DPrD.mjs";
+import { a as encodeCursor, i as decodeCursor, t as EmDashValidationError } from "./types-CrRUFdej.mjs";
 import { t as withTransaction } from "./transaction-D0FOsb3X.mjs";
 import { i as setRequestCacheEntry, n as peekRequestCache, t as clearRequestCacheEntry } from "./request-cache-BSUptuJR.mjs";
-import { n as getBylineFieldDefs } from "./field-defs-cache-BVrNCgSj.mjs";
+import { n as getBylineFieldDefs } from "./field-defs-cache-KfNJ_qLQ.mjs";
 import { sql } from "kysely";
 import { ulid } from "ulidx";
 
@@ -886,4 +886,4 @@ var BylineRepository = class {
 
 //#endregion
 export { byline_exports as n, BylineRepository as t };
-//# sourceMappingURL=byline-BWb5H-65.mjs.map
+//# sourceMappingURL=byline-BTOxUlFF.mjs.map