riverbankcms 0.5.0 → 0.7.0

package/dist/cli/init-docs/content/cli-reference.md

@@ -749,32 +749,27 @@ riverbankcms block list home --json
 
 ## Navigation Commands
 
-Manage navigation menus.
+Every site has three fixed locations: `main`, `footer`, and `legal`. Each owns its items. Locations cannot be renamed, reassigned, shared or deleted.
 
 ### navigation upsert
 
-Create or update a navigation menu.
+Replace the items in one location. An empty array clears its links and keeps the location.
 
 ```bash
-# With inline JSON
-riverbankcms navigation upsert <menu-name> --data '[{"label": "Home", "url": "/"}]'
-
-# With JSON file
-riverbankcms navigation upsert main --file ./main-nav.json
+riverbankcms navigation upsert main --data '[{"label":"Home","link":{"kind":"page","identifier":"home"}}]'
+riverbankcms navigation upsert footer --file ./footer-links.json
+riverbankcms navigation upsert legal --data '[]'
 ```
 
-**Example menu structure:**
+Example item array:
 
 ```json
 [
-  { "label": "Home", "url": "/" },
-  { "label": "About", "url": "/about" },
+  { "label": "Home", "link": { "kind": "page", "identifier": "home" } },
   {
     "label": "Products",
-    "url": "/products",
     "children": [
-      { "label": "Category A", "url": "/products/a" },
-      { "label": "Category B", "url": "/products/b" }
+      { "label": "Category A", "link": { "kind": "url", "href": "/products/a" } }
     ]
   }
 ]
@@ -782,17 +777,17 @@ riverbankcms navigation upsert main --file ./main-nav.json
 
 ### navigation get
 
-Retrieve a navigation menu.
+Read one fixed location.
 
 ```bash
-riverbankcms navigation get <menu-name>
 riverbankcms navigation get main
-riverbankcms navigation get main --json
+riverbankcms navigation get footer --json
+riverbankcms navigation get legal
 ```
 
 ### navigation list
 
-List all navigation menus.
+List all three locations, including those with no items.
 
 ```bash
 riverbankcms navigation list

package/dist/cli/init-docs/content/content-management.md

@@ -65,7 +65,8 @@ See `block-types.md` for the full list.
 
 Menu structures for site navigation.
 
-- Named menus (e.g., "main", "footer")
+- Three independent fixed locations: `main`, `footer`, and `legal`
+- Empty item lists clear a location; omitted locations are left unchanged
 - Hierarchical items with labels, URLs, and children
 
 **Local file structure:**
@@ -557,8 +558,7 @@ riverbankcms push --env=remote --yes
 {
   "menus": [
     {
-      "identifier": "main",
-      "name": "Main Navigation",
+      "location": "main",
       "items": [
         { "label": "Home", "link": { "kind": "page", "identifier": "home" } },
         {
@@ -582,8 +582,7 @@ riverbankcms push --env=remote --yes
       ]
     },
     {
-      "identifier": "footer",
-      "name": "Footer Navigation",
+      "location": "footer",
       "items": [
         { "label": "Privacy", "link": { "kind": "url", "href": "/privacy" } },
         { "label": "Terms", "link": { "kind": "url", "href": "/terms" } }
@@ -669,34 +668,45 @@ Footer links are managed via the site's footer navigation menu (see `content/nav
 {
   "identifier": "yoga-class",
   "title": "Morning Yoga Class",
-  "slug": "yoga-class",
-  "path": "/events/yoga-class",
-  "status": "active",
-  "visibility": "public",
   "preset": "class",
-  "bookingScope": "single_occurrence",
-  "occurrences": [
+  "runRefs": ["yoga-class"],
+  "runs": [
     {
-      "startsAt": "2026-01-05T15:00:00.000Z",
-      "endsAt": "2026-01-05T16:00:00.000Z",
-      "timeZone": "America/Los_Angeles"
-    },
-    {
-      "startsAt": "2026-01-12T15:00:00.000Z",
-      "endsAt": "2026-01-12T16:00:00.000Z",
-      "timeZone": "America/Los_Angeles"
+      "identifier": "yoga-class",
+      "eventRef": "yoga-class",
+      "status": "active",
+      "visibility": "public",
+      "bookingScope": "single_occurrence",
+      "occurrences": [
+        {
+          "startsAt": "2026-01-05T15:00:00.000Z",
+          "endsAt": "2026-01-05T16:00:00.000Z",
+          "timeZone": "America/Los_Angeles"
+        },
+        {
+          "startsAt": "2026-01-12T15:00:00.000Z",
+          "endsAt": "2026-01-12T16:00:00.000Z",
+          "timeZone": "America/Los_Angeles"
+        }
+      ],
+      "venueRef": "main-hall",
+      "categoryRef": "workshop",
+      "capacity": 30,
+      "bookingOffer": {
+        "bookingRequirement": "required",
+        "pricing": {
+          "kind": "single",
+          "currency": "USD",
+          "amount": 2500,
+          "acceptsPasses": true,
+          "acceptsMemberships": true
+        },
+        "paymentTerms": {
+          "allowedOptions": [{ "kind": "upfront" }]
+        }
+      }
     }
   ],
-  "venueRef": "main-hall",
-  "categoryRef": "workshop",
-  "capacity": 30,
-  "pricing": {
-    "requiresPayment": true,
-    "priceAmount": 2500,
-    "priceCurrency": "usd",
-    "acceptsPasses": true,
-    "acceptsMemberships": true
-  },
   "content": {
     "summary": "Start your day with energizing yoga",
     "body": "<p>Join us for a revitalizing morning yoga session.</p>"
@@ -724,15 +734,14 @@ Footer links are managed via the site's footer navigation menu (see `content/nav
 
 **Event field notes:**
 
-- `priceAmount` is in cents (2500 = $25.00)
+- `bookingOffer.pricing.amount` and tiered option `priceAmount` values are in cents (2500 = $25.00).
 - `preset` controls the event's presentation defaults; `bookingScope` controls
   whether a registration selects one occurrence or the complete series.
-- `occurrences` is the complete authored schedule. Instants use canonical UTC
+- Each run's `occurrences` is its complete authored schedule. Instants use canonical UTC
   ISO datetimes and every item carries the event's IANA timezone.
-- `venueRef` and `categoryRef` reference slugs/identifiers from venues and event-categories
+- Run `venueRef` and `categoryRef` values reference identifiers from venues and event-categories.
 - `status`: "draft", "active", "completed", "cancelled", or "archived"
 - `visibility`: "private", "public", or "unlisted"
-- `path` sets the draft route owned by the event's native page surface. Omit it to keep the CMS-generated route.
 - Event page content is owned by the native `eventOffering` or `eventSeries` page-surface subject.
 - `blocks` writes to the event page surface's template-defined surface slots. The default event template declares `blocks.main`.
 - Use stable block `identifier` values. Re-pushing the same event updates matching slot blocks instead of creating duplicates.

package/dist/cli/init-docs/content/workflow-isr-revalidation.md

@@ -30,7 +30,7 @@ import { blockOverrides } from '@/lib/block-overrides'
 import { getRiverbankClient } from '@/lib/riverbank-client'
 
 // Next.js route config values must remain statically analyzable literals.
-export const revalidate = 300
+export const revalidate = 60
 export const dynamicParams = true
 export const generateStaticParams = createGenerateStaticParams({
   getClient: getRiverbankClient,

package/dist/cli/init-docs/content/workflow-preview-mode.md

@@ -80,7 +80,7 @@ If you are upgrading an existing generated site, make sure your proxy imports `g
 
 Use `resolveRouteDecision` for middleware or redirect-only checks. It returns only `contentExists`, `redirect`, `notFound`, or `loadFailed`; use `resolveRouteOutcome` only when the caller needs the full content payload for rendering.
 
-Event registration endpoints use the `public-event-ticket-selection.v2` transport shape: pass `ticketSelections: [{ ticketTypeId, quantity }]`. Legacy top-level `ticketsCount` or `ticketTypeId` fields are rejected so stale clients fail visibly instead of silently selecting the wrong tickets.
+Event registration endpoints use the `public-event-ticket-selection.v2` transport shape: pass `ticketSelections: [{ pricingOptionId, quantity }]`. Retired `ticketTypeId` fields and top-level `ticketsCount` are rejected so stale clients fail visibly instead of silently selecting the wrong pricing option.
 
 ## Add Preview Keep-Alive Route
 

package/dist/{eventUpsertInputSchema-7QFvBuxF.mjs → eventUpsertInputSchema-CWglzaib.mjs}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { c as EVENT_PRESET_VALUES } from "./src-DKm0bLEA.mjs";
-import { a as classifySdkEventPricing, i as classifySdkEventSchedule, o as classifySdkEventPaymentTerms, r as sdkEventUpsertOptionalFieldSchemas } from "./sdk-event-upsert-Dy08IXYL.mjs";
+import { a as classifySdkEventBookingOffer, i as classifySdkEventSchedule, r as sdkEventUpsertOptionalFieldSchemas } from "./sdk-event-upsert-CS9tY-KW.mjs";
+import { l as EVENT_PRESET_VALUES } from "./src-DT7DBZtQ.mjs";
 import { z } from "zod";
 
 //#region ../blocks/src/lib/typeGuards.ts
@@ -3298,11 +3298,13 @@ const DEFAULT_TEMPLATE_DEFINITIONS = {
 			{
 				blockKind: "block.hero",
 				scope: "entry",
+				content: { _sectionStyles: { background: { type: "image" } } },
 				bindings: {
 					eyebrow: literalBinding("Event"),
 					headline: metaBinding("title"),
 					headlineInline: ENTRY_TITLE_INLINE_TEXT,
-					subheadline: EVENT_SUBHEADLINE_FALLBACK
+					subheadline: EVENT_SUBHEADLINE_FALLBACK,
+					"_sectionStyles.background.image": fieldBinding("image")
 				}
 			},
 			{
@@ -4733,60 +4735,53 @@ const eventScheduleInputSchema = z.object({
 	durationMinutes: z.number().int().positive().optional(),
 	startsAt: z.string().min(1).optional(),
 	endsAt: z.string().min(1).optional()
-}).superRefine((schedule, ctx) => {
-	const result = classifySdkEventSchedule(schedule, { requireCanonicalFields: true });
-	if (result.ok) return;
-	result.issues.forEach((issue) => ctx.addIssue({
-		code: "custom",
-		path: [...issue.path],
-		message: issue.message
-	}));
-}).transform((schedule) => {
+}).transform((schedule, ctx) => {
 	const result = classifySdkEventSchedule(schedule, { requireCanonicalFields: true });
-	if (!result.ok) throw new Error("Unreachable invalid event schedule");
+	if (!result.ok) {
+		result.issues.forEach((issue) => ctx.addIssue({
+			code: "custom",
+			path: [...issue.path],
+			message: issue.message
+		}));
+		return z.NEVER;
+	}
 	if (result.kind === "start-end") {
-		if (typeof schedule.startsAt !== "string" || typeof schedule.endsAt !== "string") throw new Error("Unreachable invalid start/end event schedule");
 		return {
-			startsAt: schedule.startsAt,
-			endsAt: schedule.endsAt
+			startsAt: result.startsAtIso,
+			endsAt: result.endsAtIso
 		};
 	}
 	if (result.kind === "start-duration") {
-		if (typeof schedule.startsAt !== "string" || typeof schedule.durationMinutes !== "number") throw new Error("Unreachable invalid start/duration event schedule");
 		return {
-			startsAt: schedule.startsAt,
-			durationMinutes: schedule.durationMinutes
+			startsAt: result.startsAtIso,
+			durationMinutes: (Date.parse(result.endsAtIso) - Date.parse(result.startsAtIso)) / 6e4
 		};
 	}
 	return result.canonical;
 });
 function classifiedSchema(classify$1) {
-	return z.unknown().superRefine((input, ctx) => {
+	return z.unknown().transform((input, ctx) => {
 		const result = classify$1(input);
-		if (result.ok) return;
+		if (result.ok) return result.value;
 		result.issues.forEach((issue) => ctx.addIssue({
 			code: "custom",
 			path: issue.path.map(String),
 			message: issue.message
 		}));
-	}).transform((input) => {
-		const result = classify$1(input);
-		if (!result.ok) throw new Error("Unreachable invalid classified input");
-		return result.value;
+		return z.NEVER;
 	});
 }
-const eventPricingInputSchema = classifiedSchema((input) => {
-	const result = classifySdkEventPricing(input);
-	return result.ok ? {
-		ok: true,
-		value: result.pricing
-	} : result;
-});
-const eventPaymentTermsInputSchema = classifiedSchema((input) => {
-	const result = classifySdkEventPaymentTerms(input);
-	return result.ok ? {
+const eventBookingOfferInputSchema = classifiedSchema((input) => {
+	const result = classifySdkEventBookingOffer(input);
+	return result.ok && result.bookingOffer ? {
 		ok: true,
-		value: result.paymentTerms
+		value: result.bookingOffer
+	} : result.ok ? {
+		ok: false,
+		issues: [{
+			path: [],
+			message: "Event bookingOffer is required"
+		}]
 	} : result;
 });
 const eventRunInputSchema = z.object({
@@ -4798,8 +4793,7 @@ const eventRunInputSchema = z.object({
 	bookingScope: z.enum(["single_occurrence", "whole_series"]),
 	occurrences: sdkEventUpsertOptionalFieldSchemas.occurrences.unwrap(),
 	schedule: eventScheduleInputSchema.optional(),
-	pricing: eventPricingInputSchema.optional(),
-	paymentTerms: eventPaymentTermsInputSchema.optional(),
+	bookingOffer: eventBookingOfferInputSchema.optional(),
 	capacity: sdkEventUpsertOptionalFieldSchemas.capacity,
 	venueRef: z.string().nullable().optional(),
 	categoryRef: z.string().nullable().optional(),
@@ -4807,7 +4801,7 @@ const eventRunInputSchema = z.object({
 	settings: z.record(z.string(), z.unknown()).optional(),
 	presentation: z.record(z.string(), z.unknown()).nullable().optional(),
 	tags: z.array(z.string()).optional()
-});
+}).strict();
 const eventUpsertInputSchema = z.object({
 	identifier: z.string().min(1).optional(),
 	title: z.string().min(1, "title is required"),
@@ -4817,7 +4811,7 @@ const eventUpsertInputSchema = z.object({
 	preset: z.enum(EVENT_PRESET_VALUES),
 	runRefs: z.tuple([z.string().min(1)], z.string().min(1)),
 	runs: z.tuple([eventRunInputSchema], eventRunInputSchema)
-}).superRefine((input, ctx) => input.runs.forEach((run, index) => {
+}).strict().superRefine((input, ctx) => input.runs.forEach((run, index) => {
 	if (new Set(run.occurrences.map((item) => item.timeZone)).size <= 1) return;
 	ctx.addIssue({
 		code: "custom",

package/dist/load-config-CZ9qKC9m.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import "./sdk-peer-BjTmH5Mt.mjs";
+import { t as loadConfigFile } from "./load-config-DBGNYfxV.mjs";
+
+export { loadConfigFile };

package/dist/{load-config-DKJkcASy.mjs → load-config-DBGNYfxV.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { n as assertCompatibleSdkPeer } from "./sdk-peer-sZF43pDS.mjs";
+import { n as assertCompatibleSdkPeer } from "./sdk-peer-BjTmH5Mt.mjs";
 import { dirname, resolve } from "path";
 import { createJiti } from "jiti";
 import { existsSync } from "fs";

package/dist/{plan-DPS1XAby.mjs → plan-DgjlCWxa.mjs}

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { At as ok, kt as err, nt as parseSiteId } from "./src-DKm0bLEA.mjs";
+import { Rt as err, dt as parseSiteId, zt as ok } from "./src-DT7DBZtQ.mjs";
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, parse, relative, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -561,7 +561,7 @@ import { dataLoaderOverrides } from '@/lib/data-loader-overrides.server';
 ${previewImports}
 
 // Next.js route config values must remain statically analyzable literals.
-export const revalidate = 300;
+export const revalidate = 60;
 export const dynamicParams = true;
 // Route discovery falls back to the homepage when the CMS is unavailable so
 // the scaffold verification build does not require a live API. Add
@@ -2014,18 +2014,26 @@ function starterContentTemplates(config) {
 			status: "published",
 			blocks: []
 		}),
-		jsonTemplate("content/navigation.json", { menus: [{
-			identifier: "main",
-			name: "Main",
-			isPrimary: true,
-			items: [{
-				label: "Home",
-				link: {
-					kind: "page",
-					identifier: "home"
-				}
-			}]
-		}] }),
+		jsonTemplate("content/navigation.json", { menus: [
+			{
+				location: "main",
+				items: [{
+					label: "Home",
+					link: {
+						kind: "page",
+						identifier: "home"
+					}
+				}]
+			},
+			{
+				location: "footer",
+				items: []
+			},
+			{
+				location: "legal",
+				items: []
+			}
+		] }),
 		jsonTemplate("content/settings.json", {
 			homepageId: "home",
 			seoDefaults: {

package/dist/scaffold/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import "../src-DKm0bLEA.mjs";
-import { a as prepareScaffoldExecution, d as loadGeneratedPackageRanges, i as preflightScaffoldTargets, l as deriveGeneratedPackageRanges, o as writeScaffoldFiles, r as preflightScaffoldPlan, s as deriveScaffoldLocalManifest, t as deriveScaffoldPlan, u as findPackageManifestPath } from "../plan-DPS1XAby.mjs";
+import "../src-DT7DBZtQ.mjs";
+import { a as prepareScaffoldExecution, d as loadGeneratedPackageRanges, i as preflightScaffoldTargets, l as deriveGeneratedPackageRanges, o as writeScaffoldFiles, r as preflightScaffoldPlan, s as deriveScaffoldLocalManifest, t as deriveScaffoldPlan, u as findPackageManifestPath } from "../plan-DgjlCWxa.mjs";
 
 export { deriveGeneratedPackageRanges, deriveScaffoldLocalManifest, deriveScaffoldPlan, findPackageManifestPath, loadGeneratedPackageRanges, preflightScaffoldPlan, preflightScaffoldTargets, prepareScaffoldExecution, writeScaffoldFiles };