@riverbankcms/sdk 0.136.0 → 0.138.0

package/CHANGELOG.md

@@ -7,6 +7,115 @@ and then gets the version it went out in.
 
 ## Unreleased
 
+### Breaking: canonical Event booking offers (#1326)
+
+Event pricing now uses the canonical `free | single | tiered | sliding_scale`
+contract. `PublicEventTicketTypeRecord` has been removed; consumers must use
+canonical pricing options and handle explicit unavailable pricing. Management
+writers must send canonical booking offers. Coordinate SDK consumers with the
+Event pricing database cutover; the release workflow assigns the package version.
+
+### Theme contract changes (#1318)
+
+- **`saveSiteChromeSelection`'s header body no longer carries a `theme`.** The
+  surface used to send the whole compiled theme alongside `layoutId`, `styleId`
+  and `preferences` — the Phase 4b dual write — and the server compared the two
+  headers and logged a mismatch. The server has been the author of those bytes
+  since 4b, so the second copy was only ever a measurement: it is gone, and with
+  it the `theme:site_chrome_selection:header_compilation_mismatch` log. The
+  footer surface still sends a theme, because a footer save's change *is* a
+  theme. The save response is unchanged and still returns the persisted theme,
+  which is what a client reconciles to.
+
+- **`sdkUpsertTheme`'s update body takes a theme with no `header`.** `POST
+  /sdk/{siteId}/theme` used to accept and persist whatever `theme.header` an SDK
+  consumer sent, which was the last route through which raw header bytes reached
+  persistence. `theme` is now `SdkThemeWireWithoutHeader` (exported from
+  `@riverbankcms/api`), and the header is compiled server-side from the site's
+  stored selection and `header_preferences` against the site style the body
+  authors. A body carrying a `header` is rejected rather than silently stripped.
+  A site whose current theme row cannot be read is refused rather than
+  re-provisioned.
+
+- **`saveSiteTheme`'s body takes a theme with no `header`.** `theme` is now
+  `Omit<Theme, 'header'>` (`ThemeWithoutHeader`, exported from
+  `@riverbankcms/api`), derived at the route from `themeSchema.omit({ header:
+  true })`. The header is compiled server-side from the row's stored selection
+  and `header_preferences`; `headerSelection` still names the selection to
+  compile for. This was the last path by which hand-written header bytes could
+  reach persistence. A save against a site with no current theme selection is
+  now refused with `THEME_SELECTION_NOT_FOUND` rather than falling back to a
+  site-style default, and the header selection it stores is the one the shared
+  pipeline resolves — which applies the site style's **curated** repair, not
+  only the catalogue's. A body naming a (layout, style) pair the site style does
+  not offer now stores the repaired pair, so the persisted ids and the persisted
+  bytes always name the same selection.
+
+- **`HeaderPreferences` gains a required `brandPresentation` field**
+  (`'recommended' | 'plain'`), and `headerPreferencesSchema` requires it. It
+  says whether the header wears a brand presentation block at all. `'plain'` is
+  the state several live rows persist — no `logo` object — which the record
+  could not express before, so a recompile would have given those sites a logo
+  treatment they have never rendered. This is a **widening**: `'recommended'` is
+  the default and reproduces the previous behaviour exactly, and the header
+  parity lockfile is unchanged. Consumers that construct a `HeaderPreferences`
+  literal must add the field; consumers that only read one are unaffected.
+
+- **`readHeaderPreferences` is no longer exported.** It gained a fourth
+  argument — the two headers the brand-presentation modes compile to, because
+  the mode is derived by comparing the persisted `logo` against both — and the
+  type of that argument was never on the package surface, so the export was a
+  function no consumer could call. Deriving a record from persisted bytes goes
+  through `recompileSiteChromeHeaderFromPersistedIntent`, which builds the
+  candidates itself and has always been the supported way to do it.
+
+- **`headerPreferencesWireSchema` is exported alongside `headerPreferencesSchema`.** It is the
+  same record with `brandPresentation` defaulting to `'recommended'`, for bodies arriving from a
+  client build that predates the field. The field is not client-authored — the server reads the
+  mode off the row — so defaulting it on the wire loses nothing, and the persisted schema keeps
+  requiring it so a stored record can never be incomplete.
+
+- **`headerLogoShapeContext` is exported from
+  `@riverbankcms/theme-core/site-styles`.** It is the one definition of "the
+  site's logo as the header pipeline sees it", from an asset (or its absence)
+  and the accommodation the row persists. The dashboard's server lookup and the
+  #1318 Phase 4c migration generator both go through it.
+
+- **`APIEndpoints` no longer carries `createTheme`, and `POST /ai/chat/create-theme`
+  no longer exists.** The endpoint generated theme proposals from a site id and
+  had no caller anywhere — not in the dashboard, not in the SDK's own
+  `PublicAPIEndpoints`, not in the e2e or integration suites. Site creation goes
+  through `generateThemes` (`POST /theme/generate`), which is what the wizard has
+  always called. The `ThemeGenerationTurn` type it was the sole user of is
+  removed with it.
+
+- **`APIEndpoints` no longer carries `generateThemes`, and `POST /theme/generate`
+  no longer exists.** It generated three AI theme proposals for a site, and its
+  only caller was the site-creation wizard's theme step, which no navigation
+  ever reached — the page was reachable only by typing its URL. The step and the
+  whole generator chain behind it are gone. Like `createTheme`, this endpoint is
+  not in `PublicAPIEndpoints`, so the SDK's hand-written public surface is
+  unchanged; what narrows is the bundled `@riverbankcms/api` declarations.
+  `ThemeRow` stays exported from the package — it was only ever this endpoint's
+  response element there, but it is a general row type.
+
+- **`header.maxWidth` is now optional on the way in.** It gained a schema
+  default of `'container'`, so `SdkThemeWire` (`z.input<typeof themeSchema>`)
+  accepts a theme body that omits it, where before the field was required and a
+  body without it failed to parse. This is a widening — every theme that parsed
+  before still parses, and the parsed value is unchanged, since the field only
+  ever holds `'container'` in practice. Nothing authors it any more: the field
+  is layout-owned, and full-bleed headers will come back as a layout facet
+  rather than a free-form value if they are ever wanted.
+
+- **`header.interactionPalette` accepts a fourth value, `'quiet'`.** The header
+  hover-colour vocabulary was `primary | secondary | accent`, all of which fill
+  the nav link with a colour on hover and focus. `'quiet'` means "no fill" — the
+  header style's own hover treatment stands and the palette step writes nothing.
+  This is a widening of the persisted theme enum, so every theme that parsed
+  before still parses and no existing value changes meaning; a consumer that
+  exhaustively switches on the palette needs a branch for it.
+
 ### Breaking: manifest content uses explicit trust stages (#1245)
 
 - SDK rendering now exposes `RenderablePageOutline` values whose blocks carry a

package/README.md

@@ -2384,6 +2384,7 @@ Define loaders declaratively in your block definition. These are restricted to w
 | `listPublishedEntries` | Fetch published content entries |
 | `getPublishedEntryPreview` | Fetch a single entry by slug |
 | `listPublicEvents` | Fetch events |
+| `listPublicEventCalendarWindow` | Fetch a bounded calendar month window with explicit completeness and continuation metadata |
 | `getPublicFormById` | Fetch form configuration |
 | `getPublicBookingServices` | Fetch booking services |
 
@@ -3446,10 +3447,12 @@ fetch the occurrence payload. The result is passed to event blocks via
 `dataContext.entrySubrouteContext` as
 `{ kind: 'event-occurrence'; occurrence }`.
 
-Whole-series offerings use canonical Event paths such as `/events/beginners`.
-Course details and registration blocks select the canonical series from the
-page's `eventOffering` or `eventSeries` subject; nested course-run routes are
-not part of the SDK contract.
+Whole-series Events use canonical Event paths such as `/events/beginners`.
+Event details and registration blocks select the canonical series from the
+page's `eventOffering` or `eventSeries` subject; nested run routes are not part
+of the SDK contract. There is no separate whole-series read operation — a
+whole-series Event arrives as a `PublicEvent` with
+`bookingScope: 'whole_series'` and a `run` member.
 
 Invalid subroute segments (e.g., `/events/yoga-class/invalid-date`) return a 404.
 

package/dist/{PreviewEditorSidebar-BU5ZlhQR.mjs → PreviewEditorSidebar-BVPur_CU.mjs}

@@ -1,8 +1,8 @@
 "use client";
-import { $ as FooterComposerPanel, $a as Monitor, $i as SelectItem, A as markApplySaved, Aa as Button, Ar as getHeaderStyle, B as resetTypographyToSaved, Ba as X$1, Bt as useEditorUiStoreInstance, C as applyTypographyDraftPatch, Ca as DropdownMenu, Ci as updateButtonStyleHoverPreference, D as dismissWarnings, Da as DropdownMenuSeparator, E as deriveStyleConfiguratorCapabilities, Ea as DropdownMenuLabel, Ei as themeButtonClassName, En as ThemeScope, Er as getCuratedSiteStyle, F as previewCuratedPalette, Fi as paletteColorsSchema, H as styleConfiguratorHistoryEntryForPersistedSelection, I as previewFooterLook, Ia as assertNever$1, Ir as curatedPalettes, Ka as Smartphone, L as previewHeaderLayout, M as openRow, Ma as cn, Mi as VARIANT_ROLES, N as palettePreviewProjection, Nt as BlockEditor, O as isPreviewingChange, Oa as DropdownMenuTrigger, Or as findFooterLook, P as previewButtonStyle, Pa as unsafeAsEditorBlockId, Pi as paletteColorEntries, Q as resolvePreviewSidebarTab, Qi as SelectContent, R as previewHeaderStyle, S as applyResolvedSelections, Sa as Surface, Si as resolveButtonStyleSelection, T as createStyleConfiguratorState, Ta as DropdownMenuItem, Ti as buttonStyleSelectionKey, U as syncStyleConfiguratorState, V as setPaletteColors, W as toggleRow, Wa as Tablet, Z as createOptimisticActionRunner, Zi as Select, _ as PREVIEW_DESIGN_SAVE_ERROR_MESSAGE, _n as listEntryPageContentSlots, aa as Popover, an as resolveContentTitle, at as useUISelector, b as cycleSiteChromeSelectionId, ba as CollapsibleContent, bi as buttonStyleSelectionParameterValue, c as selectionSnapshotFromApplySiteStyleSelectionResponse, ca as Input, cn as ManifestForm, co as ChevronDown, ct as useEntryController, d as resolveStyleConfiguratorInitialSnapshot, da as TabsList, dn as FormRenderer, ea as SelectTrigger, eo as Maximize2, fa as TabsTrigger, ia as SearchInput, in as resolvePageRouteSlug, it as ContentFieldsForm, j as markApplySaving, k as markApplyFailed, kr as getHeaderLayout, l as deriveSiteStylePreviewUpdate, la as Tabs, lo as Check, n as useSiteChromeCustomizeOptional, na as Callout, oa as PopoverContent, oo as ChevronRight, p as usePreviewDesignCoordinator, pn as createStoreBackend, qa as SlidersHorizontal, ra as CalloutDescription, rn as deriveRouteMetadataPresentation, s as buildApplySiteStyleSelectionBody, sa as PopoverTrigger, so as ChevronLeft, ta as SelectValue, tn as isAdapterReferenceKind, to as LoaderCircle, u as planSiteStylePreviewChange, ua as TabsContent, un as createManifestValidation, v as reportPreviewDesignError, w as cancelPreview, wa as DropdownMenuContent, wi as updateButtonStyleSelectionChoice, wr as curatedSiteStyles, x as planSiteChromeSelection, xa as CollapsibleTrigger, xi as findButtonStyleRecipe, y as buildSiteChromeSelectionModels, ya as Collapsible, yi as buttonStyleHoverPreferenceValue, z as previewSiteStyle, zt as useEditorUiStore } from "./SiteChromeCustomizeContext-B6d5zkog.mjs";
-import { d as unwrapResponse, f as getDashboardUrl, r as usePreviewAuth } from "./previewAuthStore-DbqBol0V.mjs";
-import { t as Separator } from "./separator-DaPLtJ1f.mjs";
-import { S as getSiteFontsStorageUrl, _ as usePreviewBlockCustomizeSelectionOptional, b as buildFontPreviewUrl, d as buildPreviewDashboardSetupUrl, f as resolvePreviewDashboardSetupHandoff, g as useBlockCustomizeControls, h as usePreviewSiteFontStorageUrl, m as resolvePreviewSidebarChromeModel, p as resolvePreviewEditorGuidanceModel, u as canInspectSiteStyle, v as PreviewFormProvider, x as generateFontFaceCss, y as previewWidgetOverrides } from "./SdkPreviewModeRuntime-CnWmj-2B.mjs";
+import { $ as FooterComposerPanel, A as markApplySaving, Aa as DropdownMenuLabel, Ai as resolveButtonStyleSelection, Ar as getHeaderLayout, B as setPaletteColors, Ba as assertNever$1, Bi as paletteColorsSchema, Bt as useEditorUiStoreInstance, C as cancelPreview, Ca as Collapsible, D as isPreviewingChange, Da as DropdownMenu, Di as buttonStyleHoverPreferenceValue, E as dismissWarnings, Ea as Surface, En as ThemeScope, Er as getCuratedSiteStyle, F as previewFooterLook, Fi as themeButtonClassName, H as syncStyleConfiguratorState, I as previewHeaderLayout, Ia as cn, Ja as Tablet, L as previewHeaderStyle, Lr as curatedPalettes, M as palettePreviewProjection, Ma as DropdownMenuTrigger, Mi as updateButtonStyleSelectionChoice, N as previewButtonStyle, Ni as buttonStyleSelectionKey, Nt as BlockEditor, O as markApplyFailed, Oa as DropdownMenuContent, Oi as buttonStyleSelectionParameterValue, P as previewCuratedPalette, Pa as Button, Q as resolvePreviewSidebarTab, R as previewSiteStyle, Ra as unsafeAsEditorBlockId, Ri as VARIANT_ROLES, S as applyTypographyDraftPatch, T as deriveStyleConfiguratorCapabilities, Ta as CollapsibleTrigger, U as toggleRow, V as styleConfiguratorHistoryEntryForPersistedSelection, Wa as X$1, X as resolveStyleConfiguratorInitialSnapshot, Xa as Smartphone, Z as createOptimisticActionRunner, Za as SlidersHorizontal, _ as reportPreviewDesignError, _n as listEntryPageContentSlots, aa as SelectValue, an as resolveContentTitle, ao as LoaderCircle, at as useUISelector, b as planSiteChromeSelection, c as selectionSnapshotFromApplySiteStyleSelectionResponse, ca as SearchInput, cn as ManifestForm, ct as useEntryController, da as PopoverTrigger, dn as FormRenderer, do as ChevronLeft, f as usePreviewDesignCoordinator, fa as Input, fo as ChevronDown, g as PREVIEW_DESIGN_SAVE_ERROR_MESSAGE, ga as TabsTrigger, ha as TabsList, ia as SelectTrigger, in as resolvePageRouteSlug, io as Maximize2, it as ContentFieldsForm, j as openRow, ja as DropdownMenuSeparator, ji as updateButtonStyleHoverPreference, jr as getHeaderStyle, k as markApplySaved, ka as DropdownMenuItem, ki as findButtonStyleRecipe, kr as findFooterLook, l as deriveSiteStylePreviewUpdate, la as Popover, ma as TabsContent, n as useSiteChromeCustomizeOptional, na as SelectContent, oa as Callout, pa as Tabs, pn as createStoreBackend, po as Check, ra as SelectItem, rn as deriveRouteMetadataPresentation, ro as Monitor, s as buildApplySiteStyleSelectionBody, sa as CalloutDescription, ta as Select, tn as isAdapterReferenceKind, u as planConfiguratorPreview, ua as PopoverContent, un as createManifestValidation, uo as ChevronRight, v as buildSiteChromeSelectionModels, w as createStyleConfiguratorState, wa as CollapsibleContent, wr as curatedSiteStyles, x as applyResolvedSelections, y as cycleSiteChromeSelectionId, z as resetTypographyToSaved, zi as paletteColorEntries, zt as useEditorUiStore } from "./SiteChromeCustomizeContext-BHFgMjde.mjs";
+import { d as unwrapResponse, f as getDashboardUrl, r as usePreviewAuth } from "./previewAuthStore-BkEgnYPP.mjs";
+import { t as Separator } from "./separator-BeqDLneQ.mjs";
+import { S as getSiteFontsStorageUrl, _ as usePreviewBlockCustomizeSelectionOptional, b as buildFontPreviewUrl, d as buildPreviewDashboardSetupUrl, f as resolvePreviewDashboardSetupHandoff, g as useBlockCustomizeControls, h as usePreviewSiteFontStorageUrl, m as resolvePreviewSidebarChromeModel, p as resolvePreviewEditorGuidanceModel, u as canInspectSiteStyle, v as PreviewFormProvider, x as generateFontFaceCss, y as previewWidgetOverrides } from "./SdkPreviewModeRuntime-Tda6qw4z.mjs";
 import React, { createContext, forwardRef, useCallback, useContext, useEffect, useId, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore, useTransition } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
@@ -1165,11 +1165,8 @@ function EntrySlotBlockEditorPanel({ siteId, dashboardBaseUrl, typeKey, entryId,
 		if (!editor) return false;
 		if (!focusRequest?.blockId) return false;
 		if (!selectedBlocks.some((block) => block.id === focusRequest.blockId)) return false;
-		editor.focusField({
-			blockId: focusRequest.blockId,
-			fieldPath: focusRequest.fieldPath ?? void 0,
-			itemIndex: focusRequest.itemIndex ?? void 0
-		});
+		const { requestId: _requestId, ...target } = focusRequest;
+		editor.focusField(target);
 		uiStore.getState().clearFocus();
 		return true;
 	}, [
@@ -3670,7 +3667,7 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 			clearPreview("style-configurator");
 			return;
 		}
-		previewTheme("style-configurator", planSiteStylePreviewChange({
+		previewTheme("style-configurator", planConfiguratorPreview({
 			siteStyle,
 			selection: state.previewed,
 			headerLogoContext,
@@ -3706,7 +3703,7 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 			const next = previewSiteStyle(current, siteStyleId);
 			const siteStyle = getCuratedSiteStyle(siteStyleId);
 			if (!siteStyle) return next;
-			const result = planSiteStylePreviewChange({
+			const result = planConfiguratorPreview({
 				siteStyle,
 				selection: next.previewed,
 				headerLogoContext,
@@ -3754,7 +3751,7 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 			if (!current) return current;
 			const siteStyle = getCuratedSiteStyle(current.previewed.siteStyleId);
 			if (!siteStyle) return current;
-			return applyTypographyDraftPatch(current, planSiteStylePreviewChange({
+			return applyTypographyDraftPatch(current, planConfiguratorPreview({
 				siteStyle,
 				selection: current.previewed,
 				headerLogoContext,
@@ -3876,7 +3873,7 @@ function StyleConfigurator({ siteId, apiClient, theme, selectionId, selectionVer
 	});
 	const currentPalette = palettePreviewProjection(state.previewed.palette);
 	const paletteControlsDisabled = saving || !stagedCapabilities.canPreviewStaged;
-	const currentPreviewPlan = planSiteStylePreviewChange({
+	const currentPreviewPlan = planConfiguratorPreview({
 		siteStyle: currentSiteStyle,
 		selection: state.previewed,
 		headerLogoContext,
@@ -4476,11 +4473,8 @@ function PreviewEditorSidebar({ surfaceId, siteId, dashboardBaseUrl = null, page
 		if (entryData) return;
 		const req = focusRequest;
 		if (!req?.blockId) return;
-		blockEditorRef.current?.focusField({
-			blockId: req.blockId,
-			fieldPath: req.fieldPath ?? void 0,
-			itemIndex: req.itemIndex ?? void 0
-		});
+		const { requestId: _requestId, ...target } = req;
+		blockEditorRef.current?.focusField(target);
 		uiStore.getState().clearFocus();
 	}, [
 		entryData,

package/dist/{PreviewEditorUI-9XkHL-bC.mjs → PreviewEditorUI-DLhWX8oh.mjs}

@@ -1,7 +1,7 @@
 "use client";
-import { Aa as Button, At as useEditor, Bt as useEditorUiStoreInstance, Ca as DropdownMenu, Ga as Sparkles, Ha as Undo2, Ji as Tooltip, Ma as cn, Oa as DropdownMenuTrigger, Qa as Palette, Rt as classifyHistoryShortcut, Ta as DropdownMenuItem, Ua as TriangleAlert, Xa as Pencil, Xi as TooltipTrigger, Xt as useMultiAutosave, Ya as Redo2, Yi as TooltipContent, Za as PenLine, _a as DialogHeader, a as previewDesignHistoryDomainForCommand, ao as EllipsisVertical, co as ChevronDown, ha as DialogDescription, i as usePreviewDesignHistoryOrder, io as Eye, ja as cva, lt as useEntryEditorController, ma as DialogContent, n as useSiteChromeCustomizeOptional, o as selectPreviewDesignHistoryDomain, pa as Dialog, to as LoaderCircle, va as DialogTitle, wa as DropdownMenuContent, zt as useEditorUiStore } from "./SiteChromeCustomizeContext-B6d5zkog.mjs";
-import { d as unwrapResponse, r as usePreviewAuth } from "./previewAuthStore-DbqBol0V.mjs";
-import { C as FixedBottomSurface, a as usePreviewPageDesignEditorState, c as applyPreviewChromeSurfaceToElement, l as resolvePreviewChromeSurface, o as PREVIEW_CHROME_PORTAL_CLASS_NAME, s as PREVIEW_CHROME_THEME_CLASS_NAME } from "./SdkPreviewModeRuntime-CnWmj-2B.mjs";
+import { $a as Redo2, $i as TooltipContent, At as useEditor, Bt as useEditorUiStoreInstance, Da as DropdownMenu, Fa as cva, Ia as cn, Ka as Undo2, Ma as DropdownMenuTrigger, Oa as DropdownMenuContent, Pa as Button, Qi as Tooltip, Rt as classifyHistoryShortcut, Sa as DialogTitle, Xt as useMultiAutosave, Ya as Sparkles, _a as Dialog, a as previewDesignHistoryDomainForCommand, ao as LoaderCircle, co as Eye, ea as TooltipTrigger, eo as Pencil, fo as ChevronDown, i as usePreviewDesignHistoryOrder, ka as DropdownMenuItem, lo as EllipsisVertical, lt as useEntryEditorController, n as useSiteChromeCustomizeOptional, no as Palette, o as selectPreviewDesignHistoryDomain, qa as TriangleAlert, to as PenLine, va as DialogContent, xa as DialogHeader, ya as DialogDescription, zt as useEditorUiStore } from "./SiteChromeCustomizeContext-BHFgMjde.mjs";
+import { d as unwrapResponse, r as usePreviewAuth } from "./previewAuthStore-BkEgnYPP.mjs";
+import { C as FixedBottomSurface, a as usePreviewPageDesignEditorState, c as applyPreviewChromeSurfaceToElement, l as resolvePreviewChromeSurface, o as PREVIEW_CHROME_PORTAL_CLASS_NAME, s as PREVIEW_CHROME_THEME_CLASS_NAME } from "./SdkPreviewModeRuntime-Tda6qw4z.mjs";
 import * as React$1 from "react";
 import { useCallback, useEffect, useMemo, useState, useTransition } from "react";
 import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";

package/dist/{PreviewQueryProvider-wbEpXryy.mjs → PreviewQueryProvider-BguJY1SW.mjs}

@@ -1,5 +1,5 @@
 "use client";
-import { n as markPreviewAuthExpired, s as ApiRequestError } from "./previewAuthStore-DbqBol0V.mjs";
+import { n as markPreviewAuthExpired, s as ApiRequestError } from "./previewAuthStore-BkEgnYPP.mjs";
 import { createContext, useContext, useRef } from "react";
 import { jsx } from "react/jsx-runtime";
 import { MutationCache, QueryCache, QueryClient, QueryClientProvider } from "@tanstack/react-query";