@riverbankcms/sdk 0.78.0 → 0.78.2

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

@@ -135,6 +135,7 @@ riverbankcms push entries blog-post welcome  # Specific entry
 riverbankcms push pages                # All pages with blocks
 riverbankcms push pages home           # Specific page with blocks
 riverbankcms push navigation           # Navigation menus
+riverbankcms push settings             # Site settings / branding
 riverbankcms push forms                # Forms
 riverbankcms push theme                # Push content/themes/{activeTheme|current}.json
 riverbankcms push venues               # Event venues
@@ -158,7 +159,7 @@ riverbankcms push --dry-run --json-diff=full
 | `--force-update-asset` | Replace CMS media when identifiers conflict (local media sync only)                  |
 | `--allow-truncated`    | Push even if remote content was truncated (may cause incomplete sync)                |
 | `--json-diff [mode]`   | Output JSON diff: `summary` or `full`                                                |
-| `--with-config`        | Also push SDK config after content                                                   |
+| `--with-config`        | Also push SDK schema/config after file content                                       |
 | `--with-theme`         | Also push theme when pushing all content                                             |
 | `--sync-media`         | Sync media files from local to remote environment                                    |
 | `--overwrite-media`    | When using `--sync-media`, overwrite target media on checksum mismatch               |
@@ -248,7 +249,7 @@ For theme and footer pushes, stale resolution updates only the metadata timestam
 
 - Use `logoIdentifier` / `faviconIdentifier` to manage the site logo and favicon from the repo
 - The identifiers should match files in `content/media/`
-- `riverbankcms push` reuses the normal local-media upload flow before updating site settings
+- `riverbankcms push settings` reuses the normal local-media upload flow before updating site settings, without pushing unrelated content
 - `riverbankcms pull settings` warns and omits a branding field if the current CMS asset cannot be represented by an identifier yet
 - Dashboard branding edits and CLI pushes are last-write-wins on the same settings row, so pull before pushing after dashboard-side changes
 

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

@@ -193,12 +193,12 @@ Recommended workflow:
 
 1. Add the branding files to `content/media/`, for example `content/media/positive-play-primary-logo.svg`
 2. Reference those identifiers in `content/settings.json`
-3. Run `riverbankcms push`
+3. Run `riverbankcms push settings`
 4. Run `riverbankcms pull settings` if you want to confirm the CMS state round-trips cleanly
 
 Notes:
 
-- `riverbankcms push` uploads missing branding files through the normal local-media sync path before updating site settings
+- `riverbankcms push settings` uploads missing branding files through the normal local-media sync path before updating site settings, without pushing unrelated content
 - `riverbankcms pull settings` warns and omits `logoIdentifier` / `faviconIdentifier` if the current CMS branding asset has no media identifier yet
 - Dashboard branding edits and CLI pushes both update the same site settings row, so treat them as last-write-wins and pull before pushing after dashboard-side edits
 

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

@@ -43,9 +43,17 @@ Create `src/proxy.ts`:
 import { handlePreviewTokens } from '@riverbankcms/sdk/preview-next/middleware'
 import { NextResponse, type NextRequest } from 'next/server'
 
-export function proxy(request: NextRequest) {
+import { getCmsConfig } from './lib/env'
+
+export async function proxy(request: NextRequest) {
   if (process.env.RIVERBANK_PREVIEW_MODE === 'true') {
-    const response = handlePreviewTokens(request)
+    const { dashboardUrl } = getCmsConfig()
+    const response = await handlePreviewTokens(request, {
+      dashboardUrl: dashboardUrl ?? null,
+      onExchangeFailure: (failure) => {
+        console.warn('[riverbank] preview token exchange failed', failure)
+      },
+    })
     if (response) return response
   }
 
@@ -57,6 +65,10 @@ export const config = {
 }
 ```
 
+The example logs preview exchange failures with `console.warn`; replace it with your app logger if you already centralize server-side logging.
+
+If you are upgrading an existing generated site, make sure your proxy imports `getCmsConfig`, is declared `async`, and passes `dashboardUrl` into `handlePreviewTokens`. Without the dashboard URL, visits with `preview_code` cannot exchange the short-lived code for preview cookies.
+
 ## Add Preview Keep-Alive Route
 
 Create `src/app/api/preview/keep-alive/route.ts`:
@@ -127,6 +139,60 @@ export default Page
 export { generateMetadata }
 ```
 
+## Custom Header/Footer Chrome
+
+If your site replaces the SDK header or footer, pass that chrome into `PreviewLayoutProvider` only when there is an editable preview session. `RIVERBANK_PREVIEW_MODE=true` makes the route preview-capable, but `getPreviewSession()` tells you whether the current request actually has preview cookies. Regular visitors without preview cookies should keep the normal SDK `Layout`.
+
+In `src/app/layout.tsx`:
+
+```tsx
+import type { ReactNode } from 'react'
+
+import { Layout } from '@riverbankcms/sdk/rendering/server'
+import { PreviewLayoutProvider } from '@riverbankcms/sdk/preview-next/client'
+import { getPreviewSession } from '@riverbankcms/sdk/preview-next/session'
+
+import { getRiverbankClient, getSiteId } from '@/lib/riverbank-client'
+
+function SiteHeader() {
+  return <header>{/* your site header */}</header>
+}
+
+function SiteFooter() {
+  return <footer>{/* your site footer */}</footer>
+}
+
+export default async function RootLayout({ children }: { children: ReactNode }) {
+  const session = await getPreviewSession()
+  const hasEditablePreviewSession = Boolean(session?.canEdit && session?.token)
+  const headerNode = <SiteHeader />
+  const footerNode = <SiteFooter />
+
+  return (
+    <html lang="en">
+      <body>
+        {hasEditablePreviewSession ? (
+          <PreviewLayoutProvider headerNode={headerNode} footerNode={footerNode}>
+            {children}
+          </PreviewLayoutProvider>
+        ) : (
+          <Layout
+            client={getRiverbankClient()}
+            siteId={getSiteId()}
+            header={() => headerNode}
+            footer={() => footerNode}
+          >
+            {children}
+          </Layout>
+        )}
+      </body>
+    </html>
+  )
+}
+```
+
+If your custom chrome needs CMS navigation data, build the `headerNode` and `footerNode` from the same data used by your normal layout before branching. Calling `getPreviewSession()` in the root layout reads cookies, so the layout becomes dynamic.
+
 ## Import Preview CSS
 
 For Tailwind sites, add this to `src/app/globals.css`:

package/dist/client/{accordion-EVDEOUPR.mjs → accordion-PLYNJIIM.mjs}

@@ -1,5 +1,5 @@
-import { defineIslandPropsDecoder } from './chunk-65F47D7Y.mjs';
-import './chunk-IVNCUVAV.mjs';
+import { defineIslandPropsDecoder } from './chunk-JGXPTEI2.mjs';
+import './chunk-AUJ5DBZJ.mjs';
 
 // src/rendering/islands/enhancers/accordion.ts
 var decode = defineIslandPropsDecoder("accordion");

package/dist/client/analytics.mjs

@@ -66,7 +66,7 @@ function useAnalytics(config) {
         console.warn("[analytics] Failed to initialize client", error);
       }
     }
-    start();
+    void start();
     return () => {
       disposed = true;
       if (state.client) {

package/dist/client/{bookingForm-DIHBLC64.mjs → bookingForm-BXAP6AO7.mjs}

@@ -1,15 +1,15 @@
 "use client";
-import { usePolling } from './chunk-YDSEG6GZ.mjs';
-import { SpinnerNode } from './chunk-36WJCERQ.mjs';
-import { useDiscountCodeUi } from './chunk-PD6NBCEY.mjs';
-import { scrollToBlock, buildCheckoutReturnUrls, DiscountCodeDisclosure, formatPrice } from './chunk-VPPMNXCF.mjs';
+import { usePolling } from './chunk-DNRGY432.mjs';
+import { SpinnerNode } from './chunk-CE7IBGVW.mjs';
+import { useDiscountCodeUi } from './chunk-ZFHRN6W2.mjs';
+import { scrollToBlock, buildCheckoutReturnUrls, DiscountCodeDisclosure, formatPrice } from './chunk-UVQEJJTN.mjs';
 import { FieldValidationMessage, getFieldValidationControlProps } from './chunk-3DCJ45Z2.mjs';
 import './chunk-3PEDD5KJ.mjs';
 import { isSpamProtectionEnabled, getChallengeUrl, AltchaWidget } from './chunk-YLMKMCSJ.mjs';
 import { BlockApiProvider, useBlockApi, FeedbackMessage } from './chunk-UDNSI5PY.mjs';
 import { mountReactIsland } from './chunk-N7PBWBWQ.mjs';
-import { defineIslandPropsDecoder, resolveBookingSiteId, resolveDefaultBookingServiceId, getBookingRedirectStateFromLocation, deriveBookingFormViewState, logger, getBookingSuccessMessage, resolveAppointmentCheckoutVerificationState, themeButtonClassName, toSelectedCollectionOptionKind, assertNever11, prepareBookingSubmission, formatBookingSubmissionPreparationError, resolveBookingPaymentStep, BOOKING_FORM_DATA_RESERVED_KEYS, clearWorkflowFeedback, reportWorkflowError, reportWorkflowSuccess, okWith2, err2 } from './chunk-65F47D7Y.mjs';
-import { resolveBookingTimeZoneId, DEFAULT_BOOKING_TIME_ZONE, asFormId, asAppointmentResourceId, asCustomerPassId, asAppointmentServiceId, formatLocalScheduleDate, addLocalScheduleDays, parseBookingLocalDate, resolveFlexibleBalanceInitialPaymentCents, resolveFlexibleBalanceDueAt, getBookingInstalmentDepositRefundability, asPassId, splitAmountWithRemainderInFirst, addIntervalPreservingMonthAnchor, clampConfiguredAmount, getBookingInstalmentPlanIntervalCount, omitZeroAmountFutureRows, formatBookingInstant } from './chunk-IVNCUVAV.mjs';
+import { defineIslandPropsDecoder, resolveBookingSiteId, resolveDefaultBookingServiceId, getBookingRedirectStateFromLocation, deriveBookingFormViewState, logger, getBookingSuccessMessage, resolveAppointmentCheckoutVerificationState, themeButtonClassName, toSelectedCollectionOptionKind, assertNever11, prepareBookingSubmission, formatBookingSubmissionPreparationError, resolveBookingPaymentStep, BOOKING_FORM_DATA_RESERVED_KEYS, clearWorkflowFeedback, reportWorkflowError, reportWorkflowSuccess, okWith2, err2 } from './chunk-JGXPTEI2.mjs';
+import { resolveBookingTimeZoneId, DEFAULT_BOOKING_TIME_ZONE, unsafeAsFormId, unsafeAsAppointmentResourceId, unsafeAsCustomerPassId, unsafeAsAppointmentServiceId, formatLocalScheduleDate, addLocalScheduleDays, parseBookingLocalDate, resolveFlexibleBalanceInitialPaymentCents, resolveFlexibleBalanceDueAt, getBookingInstalmentDepositRefundability, unsafeAsPassId, splitAmountWithRemainderInFirst, addIntervalPreservingMonthAnchor, clampConfiguredAmount, getBookingInstalmentPlanIntervalCount, omitZeroAmountFutureRows, formatBookingInstant } from './chunk-AUJ5DBZJ.mjs';
 import React2, { useRef, useState, useMemo, useReducer, useEffect, useCallback, useLayoutEffect } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
@@ -223,7 +223,7 @@ function useAvailableDates({
     const endDate = formatLocalScheduleDate(
       addLocalScheduleDays(parseBookingLocalDate(today), initialDays)
     );
-    fetchDates(today, endDate, false);
+    void fetchDates(today, endDate, false);
   }, [serviceId, fetchDates, initialDays]);
   useVisibleTabPolling({
     enabled: Boolean(serviceId && loadedRange),
@@ -243,7 +243,7 @@ function useAvailableDates({
         BOOKING_FETCH_CHUNK_DAYS
       )
     );
-    fetchDates(start, end, true);
+    void fetchDates(start, end, true);
   }, [fetchDates, isLoading]);
   return {
     availableDates,
@@ -303,7 +303,7 @@ function useAvailableSlots({
         setSlots(
           result.slots.map((slot) => ({
             ...slot,
-            resourceId: asAppointmentResourceId(slot.resourceId)
+            resourceId: unsafeAsAppointmentResourceId(slot.resourceId)
           }))
         );
         setHasLoaded(true);
@@ -675,7 +675,7 @@ function formatScheduleDate(isoString, locale) {
 }
 
 // ../blocks/src/system/runtime/nodes/booking-form.headless.state.ts
-var asBookingFieldId = (id) => id;
+var unsafeAsBookingFieldId = (id) => id;
 function createEmptyBookingValidationErrors() {
   return { formError: null, fieldErrors: {} };
 }
@@ -745,13 +745,13 @@ function toOptionalBrandedId(value, brand) {
   return trimmed ? brand(trimmed) : void 0;
 }
 function toOptionalAppointmentServiceId(value) {
-  return toOptionalBrandedId(value, asAppointmentServiceId);
+  return toOptionalBrandedId(value, unsafeAsAppointmentServiceId);
 }
 function toOptionalAppointmentResourceId(value) {
-  return toOptionalBrandedId(value, asAppointmentResourceId);
+  return toOptionalBrandedId(value, unsafeAsAppointmentResourceId);
 }
 function toOptionalCustomerPassId(value) {
-  return toOptionalBrandedId(value, asCustomerPassId);
+  return toOptionalBrandedId(value, unsafeAsCustomerPassId);
 }
 function isBookingFieldValue(value) {
   return value === null || typeof value === "string" || typeof value === "number" || typeof value === "boolean" || Array.isArray(value) && value.every((item) => typeof item === "string");
@@ -905,7 +905,7 @@ function toBookingSlotView(slot) {
     key: `${slot.startAt}|${slot.endAt}|${slot.resourceId}`,
     startAt: slot.startAt,
     endAt: slot.endAt,
-    resourceId: asAppointmentResourceId(slot.resourceId),
+    resourceId: unsafeAsAppointmentResourceId(slot.resourceId),
     ...slot.resourceName ? { resourceName: slot.resourceName } : {},
     ...slot.label ? { label: slot.label } : {}
   };
@@ -1027,29 +1027,30 @@ function validateBookingField(field, value) {
   }
   if (isBlankFieldValue(value)) return null;
   const strValue = typeof value === "string" ? value : String(value);
-  switch (field.type) {
-    case "email":
-      return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(strValue) ? null : "Please enter a valid email address";
-    case "url":
-      try {
-        new URL(strValue);
-        return null;
-      } catch {
-        return "Please enter a valid URL";
-      }
-    case "tel":
-      return /^[+\d\s\-()]+$/.test(strValue) ? null : "Please enter a valid phone number";
-    case "number": {
-      const num = Number(value);
-      if (Number.isNaN(num)) return "Please enter a valid number";
-      if (field.min !== void 0 && num < field.min) {
-        return `Value must be at least ${field.min}`;
-      }
-      if (field.max !== void 0 && num > field.max) {
-        return `Value must be at most ${field.max}`;
-      }
+  if (field.type === "email") {
+    return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(strValue) ? null : "Please enter a valid email address";
+  }
+  if (field.type === "url") {
+    try {
+      new URL(strValue);
       return null;
+    } catch {
+      return "Please enter a valid URL";
+    }
+  }
+  if (field.type === "tel") {
+    return /^[+\d\s\-()]+$/.test(strValue) ? null : "Please enter a valid phone number";
+  }
+  if (field.type === "number") {
+    const num = Number(value);
+    if (Number.isNaN(num)) return "Please enter a valid number";
+    if (field.min !== void 0 && num < field.min) {
+      return `Value must be at least ${field.min}`;
+    }
+    if (field.max !== void 0 && num > field.max) {
+      return `Value must be at most ${field.max}`;
     }
+    return null;
   }
   if (typeof value === "string") {
     if (field.minLength && value.length < field.minLength) {
@@ -1148,7 +1149,7 @@ function buildBookingAvailabilityQuery(input) {
 }
 function deriveBookingFieldViews(input) {
   return (input.form?.schema?.fields ?? []).map((field) => {
-    const fieldId = asBookingFieldId(field.id);
+    const fieldId = unsafeAsBookingFieldId(field.id);
     const inputId = `${input.idPrefix}-${fieldId}`;
     const helpTextId = field.helpText ? `${inputId}-help` : null;
     const fieldValue = input.values[field.id] ?? null;
@@ -1305,8 +1306,8 @@ function resolveAppointmentPackagesModel(input) {
 function toHeadlessEligibleAppointmentPackage(appointmentPackage) {
   return {
     ...appointmentPackage,
-    customerPassId: asCustomerPassId(appointmentPackage.customerPassId),
-    passId: asPassId(appointmentPackage.passId)
+    customerPassId: unsafeAsCustomerPassId(appointmentPackage.customerPassId),
+    passId: unsafeAsPassId(appointmentPackage.passId)
   };
 }
 function resolveHeadlessBookingStatus(input) {
@@ -1366,7 +1367,7 @@ function omitRecordKey(record, key) {
 // ../blocks/src/system/runtime/hooks/useHeadlessBookingFlow.ts
 function useHeadlessBookingFlow(options) {
   const viewerTimeZone = options.viewerTimeZone ?? getRuntimeTimeZone();
-  const formKey = asFormId(options.formId);
+  const formKey = unsafeAsFormId(options.formId);
   const defaultServiceId = toOptionalAppointmentServiceId(
     options.initialServiceId ?? resolveDefaultBookingServiceId(options.form, options.services) ?? void 0
   );
@@ -1532,7 +1533,7 @@ function useHeadlessBookingFlow(options) {
       setResourcesState({
         tag: "loaded",
         value: (result.options ?? []).map((option) => ({
-          id: asAppointmentResourceId(option.id),
+          id: unsafeAsAppointmentResourceId(option.id),
           label: option.label
         }))
       });
@@ -1748,11 +1749,11 @@ function useHeadlessBookingFlow(options) {
     () => ({
       selectService: (serviceId) => dispatch({
         type: "service-selected",
-        serviceId: asAppointmentServiceId(serviceId)
+        serviceId: unsafeAsAppointmentServiceId(serviceId)
       }),
       selectResource: (resourceId) => dispatch({
         type: "resource-selected",
-        resourceId: resourceId ? asAppointmentResourceId(resourceId) : null
+        resourceId: resourceId ? unsafeAsAppointmentResourceId(resourceId) : null
       }),
       selectDate: (date) => dispatch({ type: "date-selected", date }),
       selectSlot: (slot) => dispatch({
@@ -1761,14 +1762,14 @@ function useHeadlessBookingFlow(options) {
       }),
       updateField: (fieldId, value) => dispatch({
         type: "field-updated",
-        fieldId: asBookingFieldId(fieldId),
+        fieldId: unsafeAsBookingFieldId(fieldId),
         value
       }),
-      markFieldTouched: (fieldId) => dispatch({ type: "field-touched", fieldId: asBookingFieldId(fieldId) }),
+      markFieldTouched: (fieldId) => dispatch({ type: "field-touched", fieldId: unsafeAsBookingFieldId(fieldId) }),
       selectPaymentOption: (kind) => dispatch({ type: "payment-option-selected", kind }),
       selectAppointmentPackage: (packageId) => dispatch({
         type: "appointment-package-selected",
-        packageId: packageId ? asCustomerPassId(packageId) : null
+        packageId: packageId ? unsafeAsCustomerPassId(packageId) : null
       }),
       setDiscountCode: (code) => {
         dispatch({ type: "discount-code-changed", code });
@@ -2603,7 +2604,7 @@ function DefaultFieldInput({
       ] }, option.value)) });
     case "checkbox":
       if (field.field.options && field.field.options.length > 1) {
-        const checkedValues = Array.isArray(value) ? value : [];
+        const checkedValues = toStringArray(value);
         return /* @__PURE__ */ jsx("div", { className: "rb-space-y-2", children: field.field.options.map((option) => /* @__PURE__ */ jsxs("label", { className: "rb-flex rb-items-center rb-gap-2 rb-cursor-pointer", children: [
           /* @__PURE__ */ jsx(
             "input",
@@ -2698,7 +2699,10 @@ function DefaultFieldInput({
           className: "form-input"
         }
       );
-    default:
+    case "text":
+    case "email":
+    case "tel":
+    case "url":
       return /* @__PURE__ */ jsx(
         "input",
         {
@@ -2715,6 +2719,9 @@ function DefaultFieldInput({
       );
   }
 }
+function toStringArray(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
 function DefaultBookingDiscount({
   booking
 }) {
@@ -2806,7 +2813,7 @@ function collapseHeadlessSlotsForDisplay(input) {
     visibleSlots.push({
       startAt: slot.startAt,
       endAt: slot.endAt,
-      resourceId: asAppointmentResourceId(slot.resourceId)
+      resourceId: unsafeAsAppointmentResourceId(slot.resourceId)
     });
   }
   return visibleSlots;