riverbankcms 0.4.3 → 0.6.0

package/README.md

@@ -30,3 +30,42 @@ a new identifier, or delete and upload the asset again in the dashboard.
 Every persisted media asset now has a canonical, site-unique identifier. Backup
 restore preserves an existing asset's identifier and rejects an archive that
 tries to replace it.
+
+## Media library commands
+
+Linked SDK projects can manage library assets by stable identifier:
+
+```sh
+riverbankcms media add ./hero.jpg --env local
+riverbankcms media list --search hero --env both
+riverbankcms media download hero --output ./downloads --env remote
+riverbankcms media delete hero --dry-run --env both
+riverbankcms media delete hero --yes --env both
+```
+
+`media add` accepts explicit regular files only. For multiple files, identifiers
+come from filenames; `--identifier` and `--title` are single-file options. Add
+and delete preflight every selected environment before mutation, and delete
+refuses assets still referenced by content. `media download` preserves the
+stored safe filename, refuses overwrites unless `--overwrite` is present, and
+uses `local/` and `remote/` subdirectories for `--env both`.
+
+These commands manage library records and bytes. They do not rewrite media
+references inside pages, entries, blocks, or other content.
+
+## Account site backups
+
+Signed-in account owners can export a safe-profile backup and import it as a
+new, independent site without linking a project:
+
+```sh
+riverbankcms sites export my-site --account-env staging
+riverbankcms sites import my-site-backup.zip --account-env local
+```
+
+Exports include media and exclude memberships, access, and credentials. The
+default filename is `<site-slug>-backup.zip`; existing files require
+`--overwrite`. Imports are limited to 100 MB, show the server preview before a
+single confirmation, always create a fresh site identity, and never run
+`riverbankcms link` automatically. Use `--yes` for JSON or non-interactive
+imports.

package/dist/acceptance/matrix.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-import "../src-DKm0bLEA.mjs";
-import "../sdk-event-upsert-Dy08IXYL.mjs";
-import { t as eventUpsertInputSchema } from "../eventUpsertInputSchema-7QFvBuxF.mjs";
+import "../sdk-event-upsert-CvFCbzNc.mjs";
+import "../src-X9oZOIoK.mjs";
+import { t as eventUpsertInputSchema } from "../eventUpsertInputSchema-CtkDnYlQ.mjs";
 
 //#region src/acceptance/matrix-builders.ts
 const workflow = (scenario, stepId) => ({
@@ -56,6 +56,18 @@ const writeFileStep = (id, path, content) => ({
 	path,
 	content: `${JSON.stringify(content, null, 2)}\n`
 });
+const writeBase64FileStep = (id, path, base64) => ({
+	kind: "write_base64_file",
+	id,
+	path,
+	base64
+});
+const assertFilesEqualStep = (id, leftPath, rightPath) => ({
+	kind: "assert_files_equal",
+	id,
+	leftPath,
+	rightPath
+});
 const assertJsonFileStep = (id, path, jsonPath, expected) => ({
 	kind: "assert_json_file",
 	id,
@@ -301,8 +313,300 @@ const bookingSettingsScenario = {
 	]
 };
 
+//#endregion
+//#region src/acceptance/event-scenario.ts
+const eventAcceptanceInput = eventUpsertInputSchema.parse({
+	title: "CLI acceptance event",
+	slug: "acceptance-event",
+	preset: "event",
+	runRefs: ["acceptance-event"],
+	runs: [{
+		identifier: "acceptance-event",
+		eventRef: "acceptance-event",
+		bookingScope: "whole_series",
+		occurrences: [{
+			startsAt: "2026-12-01T10:00:00.000Z",
+			endsAt: "2026-12-01T11:00:00.000Z",
+			timeZone: "Europe/London"
+		}],
+		bookingOffer: {
+			bookingRequirement: "required",
+			pricing: {
+				kind: "free",
+				currency: "GBP"
+			},
+			paymentTerms: { allowedOptions: [{ kind: "upfront" }] }
+		}
+	}]
+});
+const eventScenario = {
+	id: "event-occurrence-lifecycle",
+	steps: [
+		commandStep("upsert", "event upsert", [
+			"event",
+			"upsert",
+			"acceptance-event",
+			"--data",
+			JSON.stringify(eventAcceptanceInput),
+			"--env=local",
+			"--json"
+		]),
+		{
+			kind: "known_identifier",
+			id: "event-identifier",
+			value: "acceptance-event"
+		},
+		commandStep("get", "event get", [
+			"event",
+			"get",
+			capture("event-identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("list-occurrences", "event occurrence list", [
+			"event",
+			"occurrence",
+			"list",
+			capture("event-identifier"),
+			capture("event-identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("add-occurrence", "event occurrence add", [
+			"event",
+			"occurrence",
+			"add",
+			capture("event-identifier"),
+			capture("event-identifier"),
+			"--starts-at",
+			"2026-12-10T10:00:00Z",
+			"--duration-minutes",
+			"60",
+			"--env=local",
+			"--json"
+		]),
+		commandStep("update-occurrence", "event occurrence update", [
+			"event",
+			"occurrence",
+			"update",
+			capture("event-identifier"),
+			capture("event-identifier"),
+			capture("add-occurrence", "result", "id"),
+			"--capacity",
+			"20",
+			"--env=local",
+			"--json"
+		]),
+		commandStep("cancel-occurrence", "event occurrence cancel", [
+			"event",
+			"occurrence",
+			"cancel",
+			capture("event-identifier"),
+			capture("event-identifier"),
+			capture("add-occurrence", "result", "id"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("delete-occurrence", "event occurrence delete", [
+			"event",
+			"occurrence",
+			"delete",
+			capture("event-identifier"),
+			capture("event-identifier"),
+			capture("add-occurrence", "result", "id"),
+			"--yes",
+			"--env=local",
+			"--json"
+		]),
+		commandStep("cancel-event", "event cancel", [
+			"event",
+			"cancel",
+			capture("event-identifier"),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("delete-event", "event delete", [
+			"event",
+			"delete",
+			capture("event-identifier"),
+			"--yes",
+			"--env=local",
+			"--json"
+		])
+	]
+};
+
+//#endregion
+//#region src/acceptance/media-scenario.ts
+const ONE_PIXEL_PNG = "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAOaQqR0AAAAASUVORK5CYII=";
+const mediaScenario = {
+	id: "media-library-lifecycle",
+	steps: [
+		writeBase64FileStep("fixture", ".acceptance/media/acceptance-media.png", ONE_PIXEL_PNG),
+		commandStep("add", "media add", [
+			"media",
+			"add",
+			".acceptance/media/acceptance-media.png",
+			"--identifier",
+			"acceptance-media",
+			"--yes",
+			"--env=local",
+			"--json"
+		], { jsonAssertions: [{
+			jsonPath: [
+				"result",
+				"environments",
+				"0",
+				"result",
+				"items",
+				"0",
+				"status"
+			],
+			expected: "created"
+		}] }),
+		commandStep("repeat", "media add", [
+			"media",
+			"add",
+			".acceptance/media/acceptance-media.png",
+			"--identifier",
+			"acceptance-media",
+			"--yes",
+			"--env=local",
+			"--json"
+		], { jsonAssertions: [{
+			jsonPath: [
+				"result",
+				"environments",
+				"0",
+				"result",
+				"items",
+				"0",
+				"status"
+			],
+			expected: "unchanged"
+		}] }),
+		commandStep("alias-conflict", "media add", [
+			"media",
+			"add",
+			".acceptance/media/acceptance-media.png",
+			"--identifier",
+			"acceptance-media-alias",
+			"--yes",
+			"--env=local",
+			"--json"
+		], { expectedExitCode: 1 }),
+		commandStep("list", "media list", [
+			"media",
+			"list",
+			"--search",
+			"acceptance-media",
+			"--env=local",
+			"--json"
+		], { jsonAssertions: [{
+			jsonPath: [
+				"result",
+				"environments",
+				"0",
+				"result",
+				"items",
+				"0",
+				"identifier"
+			],
+			expected: "acceptance-media"
+		}] }),
+		commandStep("download", "media download", [
+			"media",
+			"download",
+			"acceptance-media",
+			"--output",
+			".acceptance/media-download",
+			"--env=local",
+			"--json"
+		]),
+		assertFilesEqualStep("download-local-equal", ".acceptance/media/acceptance-media.png", ".acceptance/media-download/acceptance-media.png"),
+		commandStep("reference-page", "page upsert", [
+			"page",
+			"upsert",
+			"acceptance-media-page",
+			"--title",
+			"CLI acceptance media page",
+			"--path",
+			"/cli-acceptance-media",
+			"--env=local",
+			"--json"
+		]),
+		commandStep("reference-block", "block upsert", [
+			"block",
+			"upsert",
+			capture("reference-page", "result", "identifier"),
+			"acceptance-media-block",
+			"--kind",
+			"block.media-text",
+			"--data",
+			JSON.stringify({
+				text: richText("CLI acceptance media reference."),
+				images: [{ image: { identifier: "acceptance-media" } }]
+			}),
+			"--env=local",
+			"--json"
+		]),
+		commandStep("guarded-delete", "media delete", [
+			"media",
+			"delete",
+			"acceptance-media",
+			"--yes",
+			"--env=local",
+			"--json"
+		], { expectedExitCode: 1 }),
+		commandStep("remove-reference", "delete block", [
+			"delete",
+			"block",
+			capture("reference-page", "result", "identifier"),
+			capture("reference-block", "result", "identifier"),
+			"--yes",
+			"--env=local",
+			"--json"
+		]),
+		commandStep("delete-preview", "media delete", [
+			"media",
+			"delete",
+			"acceptance-media",
+			"--dry-run",
+			"--env=local",
+			"--json"
+		], { jsonAssertions: [{
+			jsonPath: [
+				"result",
+				"environments",
+				"0",
+				"result",
+				"kind"
+			],
+			expected: "dry_run"
+		}] }),
+		commandStep("delete", "media delete", [
+			"media",
+			"delete",
+			"acceptance-media",
+			"--yes",
+			"--env=local",
+			"--json"
+		], { jsonAssertions: [{
+			jsonPath: [
+				"result",
+				"environments",
+				"0",
+				"result",
+				"kind"
+			],
+			expected: "deleted"
+		}] })
+	]
+};
+
 //#endregion
 //#region src/acceptance/matrix.ts
+const expectedCommandFailure = { expectedExitCode: 1 };
 const entryScenario = {
 	id: "entry-lifecycle",
 	steps: [
@@ -457,119 +761,6 @@ const blockScenario = {
 		])
 	]
 };
-const eventAcceptanceInput = eventUpsertInputSchema.parse({
-	title: "CLI acceptance event",
-	slug: "acceptance-event",
-	preset: "event",
-	runRefs: ["acceptance-event"],
-	runs: [{
-		identifier: "acceptance-event",
-		eventRef: "acceptance-event",
-		bookingScope: "whole_series",
-		occurrences: [{
-			startsAt: "2026-12-01T10:00:00.000Z",
-			endsAt: "2026-12-01T11:00:00.000Z",
-			timeZone: "Europe/London"
-		}],
-		pricing: { requiresPayment: false }
-	}]
-});
-const eventScenario = {
-	id: "event-occurrence-lifecycle",
-	steps: [
-		commandStep("upsert", "event upsert", [
-			"event",
-			"upsert",
-			"acceptance-event",
-			"--data",
-			JSON.stringify(eventAcceptanceInput),
-			"--env=local",
-			"--json"
-		]),
-		{
-			kind: "known_identifier",
-			id: "event-identifier",
-			value: "acceptance-event"
-		},
-		commandStep("get", "event get", [
-			"event",
-			"get",
-			capture("event-identifier"),
-			"--env=local",
-			"--json"
-		]),
-		commandStep("list-occurrences", "event occurrence list", [
-			"event",
-			"occurrence",
-			"list",
-			capture("event-identifier"),
-			capture("event-identifier"),
-			"--env=local",
-			"--json"
-		]),
-		commandStep("add-occurrence", "event occurrence add", [
-			"event",
-			"occurrence",
-			"add",
-			capture("event-identifier"),
-			capture("event-identifier"),
-			"--starts-at",
-			"2026-12-10T10:00:00Z",
-			"--duration-minutes",
-			"60",
-			"--env=local",
-			"--json"
-		]),
-		commandStep("update-occurrence", "event occurrence update", [
-			"event",
-			"occurrence",
-			"update",
-			capture("event-identifier"),
-			capture("event-identifier"),
-			capture("add-occurrence", "result", "id"),
-			"--capacity",
-			"20",
-			"--env=local",
-			"--json"
-		]),
-		commandStep("cancel-occurrence", "event occurrence cancel", [
-			"event",
-			"occurrence",
-			"cancel",
-			capture("event-identifier"),
-			capture("event-identifier"),
-			capture("add-occurrence", "result", "id"),
-			"--env=local",
-			"--json"
-		]),
-		commandStep("delete-occurrence", "event occurrence delete", [
-			"event",
-			"occurrence",
-			"delete",
-			capture("event-identifier"),
-			capture("event-identifier"),
-			capture("add-occurrence", "result", "id"),
-			"--yes",
-			"--env=local",
-			"--json"
-		]),
-		commandStep("cancel-event", "event cancel", [
-			"event",
-			"cancel",
-			capture("event-identifier"),
-			"--env=local",
-			"--json"
-		]),
-		commandStep("delete-event", "event delete", [
-			"event",
-			"delete",
-			capture("event-identifier"),
-			"--yes",
-			"--env=local",
-			"--json"
-		])
-	]
-};
 /**
 * Every entry is keyed by the complete Commander leaf path.  The automated
 * runner executes representatives and grouped scratch workflows; provider and
@@ -666,7 +857,7 @@ const acceptanceTuples = [
 		cwd: "nested",
 		output: "non-empty"
 	})],
-	["init", scratchExecute(["init", "--json"], { expectedExitCode: 1 })],
+	["init", scratchExecute(["init", "--json"], expectedCommandFailure)],
 	["identifiers backfill", scratchExecute([
 		"identifiers",
 		"backfill",
@@ -684,7 +875,7 @@ const acceptanceTuples = [
 		"verify",
 		"--env=local",
 		"--json"
-	], { expectedExitCode: 1 })],
+	], expectedCommandFailure)],
 	["publish-all", scratchDryRun([
 		"publish-all",
 		"post",
@@ -703,7 +894,7 @@ const acceptanceTuples = [
 		"post",
 		"--env=local",
 		"--json"
-	], { expectedExitCode: 1 })],
+	], expectedCommandFailure)],
 	["event list", scratchExecute([
 		"event",
 		"list",
@@ -749,34 +940,38 @@ const acceptanceTuples = [
 		"--json"
 	])],
 	["settings booking configure", workflow(bookingSettingsScenario, "apply")],
+	["media add", workflow(mediaScenario, "add")],
+	["media list", workflow(mediaScenario, "list")],
+	["media download", workflow(mediaScenario, "download")],
+	["media delete", workflow(mediaScenario, "delete")],
 	["login", scratchExecute([
 		"login",
 		"--account-env=local",
 		"--json"
-	], { expectedExitCode: 1 })],
+	], expectedCommandFailure)],
 	["logout", scratchExecute([
 		"logout",
 		"--account-env=local",
 		"--json"
-	], { expectedExitCode: 1 })],
+	], expectedCommandFailure)],
 	["whoami", scratchExecute([
 		"whoami",
 		"--account-env=local",
 		"--json"
-	], { expectedExitCode: 1 })],
+	], expectedCommandFailure)],
 	["auth revoke", scratchExecute([
 		"auth",
 		"revoke",
 		"--account-env=local",
 		"--yes",
 		"--json"
-	], { expectedExitCode: 1 })],
+	], expectedCommandFailure)],
 	["sites list", scratchExecute([
 		"sites",
 		"list",
 		"--account-env=local",
 		"--json"
-	], { expectedExitCode: 1 })],
+	], expectedCommandFailure)],
 	["sites create", scratchExecute([
 		"sites",
 		"create",
@@ -785,7 +980,7 @@ const acceptanceTuples = [
 		"Acceptance site",
 		"--yes",
 		"--json"
-	], { expectedExitCode: 1 })],
+	], expectedCommandFailure)],
 	["link", scratchExecute([
 		"link",
 		"--project",
@@ -795,13 +990,28 @@ const acceptanceTuples = [
 		"--no-preview",
 		"--account-env=local",
 		"--json"
-	], { expectedExitCode: 1 })],
+	], expectedCommandFailure)],
 	["recover", scratchExecute([
 		"recover",
 		"--project",
 		".",
 		"--account-env=local",
 		"--json"
+	], expectedCommandFailure)],
+	["sites export", scratchExecute([
+		"sites",
+		"export",
+		"acceptance-site",
+		"--account-env=local",
+		"--json"
+	], { expectedExitCode: 1 })],
+	["sites import", scratchExecute([
+		"sites",
+		"import",
+		"acceptance-backup.zip",
+		"--account-env=local",
+		"--yes",
+		"--json"
 	], { expectedExitCode: 1 })],
 	["migrate entries", scratchDryRun([
 		"migrate",