riverbankcms 0.4.3 → 0.5.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

@@ -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,6 +313,174 @@ const bookingSettingsScenario = {
 	]
 };
 
+//#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 entryScenario = {
@@ -749,6 +929,10 @@ 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",
@@ -786,6 +970,21 @@ const acceptanceTuples = [
 		"--yes",
 		"--json"
 	], { expectedExitCode: 1 })],
+	["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 })],
 	["link", scratchExecute([
 		"link",
 		"--project",