@riverbankcms/sdk 0.89.1 → 0.90.1

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

@@ -90,6 +90,9 @@ riverbankcms pull theme                # Theme to content/themes/current.json
 riverbankcms pull venues               # Event venues
 riverbankcms pull event-categories     # Event categories
 riverbankcms pull events               # Event series
+riverbankcms pull events summer-fest   # Specific event series
+riverbankcms pull courses              # Courses
+riverbankcms pull courses beginners    # Specific course
 riverbankcms pull --with-theme         # Pull content and theme together
 
 # Custom output directory
@@ -142,7 +145,7 @@ riverbankcms push forms                # Forms
 riverbankcms push theme                # Push content/themes/{activeTheme|current}.json
 riverbankcms push venues               # Event venues
 riverbankcms push event-categories     # Event categories
-riverbankcms push events               # Event series
+riverbankcms push events               # Event series, routes, and entry slot blocks
 riverbankcms push --with-theme         # Also push theme when pushing all content
 
 # JSON diff output for agents
@@ -826,6 +829,8 @@ riverbankcms event cancel summer-fest
 riverbankcms event delete summer-fest --yes
 ```
 
+`event upsert` and `push events` accept canonical event files with `path` and `blocks`. `path` updates the linked event content entry route. `blocks` maps slot keys to entry-slot blocks, for example `blocks.main` for the built-in event template. Use stable block identifiers so repeat pushes update existing slot blocks safely. Unknown slot keys or block kinds fail validation; default slots accept enabled SDK `custom.*` blocks, while explicit template `allowedBlocks` lists remain authoritative.
+
 ### course
 
 Manage course runs directly through the CLI.

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

@@ -284,6 +284,9 @@ riverbankcms pull forms
 riverbankcms pull venues               # Event venues
 riverbankcms pull event-categories     # Event categories
 riverbankcms pull events               # Event series
+riverbankcms pull events summer-fest   # Specific event series
+riverbankcms pull courses              # Courses
+riverbankcms pull courses beginners    # Specific course
 ```
 
 **Output directory structure:**
@@ -601,6 +604,7 @@ 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",
   "venueRef": "main-hall",
@@ -622,6 +626,24 @@ Footer links are managed via the site's footer navigation menu (see `content/nav
   "content": {
     "summary": "Start your day with energizing yoga",
     "body": "<p>Join us for a revitalizing morning yoga session.</p>"
+  },
+  "blocks": {
+    "main": [
+      {
+        "identifier": "class-introduction",
+        "kind": "block.body-text",
+        "content": {
+          "body": "<p>Bring a mat and arrive ten minutes early.</p>"
+        }
+      },
+      {
+        "identifier": "what-to-expect",
+        "kind": "custom.event-callout",
+        "content": {
+          "headline": "Gentle, steady, welcoming"
+        }
+      }
+    ]
   }
 }
 ```
@@ -634,6 +656,11 @@ Footer links are managed via the site's footer navigation menu (see `content/nav
 - `venueRef` and `categoryRef` reference slugs/identifiers from venues and event-categories
 - `status`: "draft", "active", "completed", "cancelled", or "archived"
 - `visibility`: "private", "public", or "unlisted"
+- `path` overrides the linked event content entry route. Omit it to keep the CMS-generated route.
+- `blocks` writes to the event template's `system.entry-slot` blocks. 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.
+- Default entry slots accept built-in content blocks plus enabled SDK custom blocks. If a template sets `allowedBlocks`, that explicit list is authoritative.
+- `riverbankcms push events` aborts when two `content/events/*.json` files use the same `identifier`; merge or delete stale duplicates before pushing.
 
 See `cli-reference.md` for event-related CLI commands: `riverbankcms push/pull venues|event-categories|events`.
 

package/dist/client/{accordion-MUCVNGQ7.mjs → accordion-4K7VGZ3I.mjs}

@@ -1,5 +1,5 @@
-import { defineIslandPropsDecoder } from './chunk-UQFY4AHX.mjs';
-import './chunk-25W2EQUN.mjs';
+import { defineIslandPropsDecoder } from './chunk-B4H6QMPY.mjs';
+import './chunk-3H5CLFKT.mjs';
 
 // src/rendering/islands/enhancers/accordion.ts
 var decode = defineIslandPropsDecoder("accordion");

package/dist/client/{bookingForm-PKD6EFIE.mjs → bookingForm-3QXA3CIS.mjs}

@@ -1,16 +1,15 @@
 "use client";
-import { usePolling } from './chunk-LQFDYWPJ.mjs';
-import { SpinnerNode } from './chunk-FHU6PFPM.mjs';
-import { useDiscountCodeUi } from './chunk-ZFHRN6W2.mjs';
+import { buildBookingPaymentSelectionViewModel, usePolling } from './chunk-5AJIMWKS.mjs';
+import { SpinnerNode } from './chunk-KNTLBQ3N.mjs';
 import { buildRouteIslandApiConfig } from './chunk-L4J5Y62O.mjs';
-import { scrollToBlock, buildCheckoutReturnUrls, DiscountCodeDisclosure, formatPrice } from './chunk-EY42X22F.mjs';
+import { scrollToBlock, useDiscountCodeUi, buildCheckoutReturnUrls, DiscountCodeDisclosure } from './chunk-SLY6UDAS.mjs';
 import { FieldValidationMessage, getFieldValidationControlProps } from './chunk-3DCJ45Z2.mjs';
 import './chunk-WBQG7VJA.mjs';
-import { isSpamProtectionEnabled, getChallengeUrl, AltchaWidget } from './chunk-SDIYSQAY.mjs';
-import { BlockApiProvider, useBlockApi, FeedbackMessage } from './chunk-STJ2NCQM.mjs';
+import { isSpamProtectionEnabled, getChallengeUrl, AltchaWidget } from './chunk-HIHOQGIP.mjs';
+import { BlockApiProvider, useBlockApi, FeedbackMessage } from './chunk-WHZQDPBZ.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-UQFY4AHX.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-25W2EQUN.mjs';
+import { defineIslandPropsDecoder, resolveBookingSiteId, resolveDefaultBookingServiceId, getBookingRedirectStateFromLocation, deriveBookingFormViewState, logger, getBookingSuccessMessage, resolveAppointmentCheckoutVerificationState, themeButtonClassName, toSelectedCollectionOptionKind, assertNever, prepareBookingSubmission, formatBookingSubmissionPreparationError, resolveBookingPaymentStep, BOOKING_FORM_DATA_RESERVED_KEYS, clearWorkflowFeedback, reportWorkflowError, reportWorkflowSuccess, okWith, err } from './chunk-B4H6QMPY.mjs';
+import { resolveBookingTimeZoneId, DEFAULT_BOOKING_TIME_ZONE, unsafeAsFormId, unsafeAsAppointmentResourceId, unsafeAsCustomerPassId, unsafeAsAppointmentServiceId, formatLocalScheduleDate, addLocalScheduleDays, parseBookingLocalDate, unsafeAsPassId, formatBookingInstant } from './chunk-3H5CLFKT.mjs';
 import React2, { useRef, useState, useMemo, useReducer, useEffect, useCallback, useLayoutEffect } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
@@ -205,7 +204,7 @@ function availableDatesReducer(state, action) {
     case "load-failed":
       return { tag: "error", data: state.data, message: action.message };
     default:
-      return assertNever11(action);
+      return assertNever(action);
   }
 }
 
@@ -256,11 +255,11 @@ function useAvailableDates({
           endDate: data.endDate,
           append
         });
-      } catch (err) {
+      } catch (err2) {
         if (requestId !== requestIdRef.current) return;
         dispatch({
           type: "load-failed",
-          message: err instanceof Error ? err.message : "Failed to load available dates"
+          message: err2 instanceof Error ? err2.message : "Failed to load available dates"
         });
       }
     },
@@ -326,7 +325,7 @@ function getAvailableSlots(state) {
     case "error":
       return state.slots;
     default:
-      return assertNever11(state);
+      return assertNever(state);
   }
 }
 function hasLoadedAvailableSlots(state) {
@@ -340,7 +339,7 @@ function hasLoadedAvailableSlots(state) {
     case "loaded":
       return true;
     default:
-      return assertNever11(state);
+      return assertNever(state);
   }
 }
 function isLoadingAvailableSlots(state) {
@@ -374,7 +373,7 @@ function availableSlotsReducer(state, action) {
         message: action.message
       };
     default:
-      return assertNever11(action);
+      return assertNever(action);
   }
 }
 
@@ -423,11 +422,11 @@ function useAvailableSlots({
             resourceId: unsafeAsAppointmentResourceId(slot.resourceId)
           }))
         });
-      } catch (err) {
+      } catch (err2) {
         if (requestId !== requestIdRef.current) return;
         dispatch({
           type: "load-failed",
-          message: err instanceof Error ? err.message : "Failed to load available times"
+          message: err2 instanceof Error ? err2.message : "Failed to load available times"
         });
       }
     },
@@ -480,7 +479,7 @@ function bookingSubmissionReducer(state, action) {
     case "feedback-cleared":
       return clearWorkflowFeedback(state);
     default:
-      return assertNever11(action);
+      return assertNever(action);
   }
 }
 function selectIsSubmitting(state) {
@@ -524,7 +523,7 @@ function useBookingSubmission(_siteId) {
         type: "submission-succeeded",
         message: response.type === "checkout_redirect" ? "Redirecting to secure checkout..." : "Booking submitted successfully."
       });
-      return okWith2(response);
+      return okWith(response);
     } catch (error) {
       console.error("Booking submission error:", error);
       const message = error instanceof Error ? error.message : "Failed to book appointment";
@@ -532,7 +531,7 @@ function useBookingSubmission(_siteId) {
         type: "submission-failed",
         message
       });
-      return err2(message);
+      return err(message);
     }
   };
   return {
@@ -544,253 +543,6 @@ function useBookingSubmission(_siteId) {
   };
 }
 
-// ../blocks/src/system/runtime/shared/bookingPaymentOptionCopy.ts
-function buildUpfrontBookingPaymentOptionCopy(formattedTotal) {
-  return {
-    title: "Pay in full",
-    description: "Pay everything today and your booking is confirmed.",
-    ctaLabel: `Pay ${formattedTotal} now`
-  };
-}
-function buildDeferredManualBookingPaymentOptionCopy() {
-  return {
-    title: "Pay offline",
-    description: "Book now and pay the business later, outside the platform.",
-    helperText: "Nothing is due today.",
-    ctaLabel: "Book now"
-  };
-}
-function buildInstalmentBookingPaymentOptionCopy(input) {
-  return {
-    title: "Payment plan",
-    description: describeInstalmentPlanCopy(input),
-    helperText: "You can pay the rest early any time in your customer portal.",
-    ctaLabel: `Pay ${input.formattedDueToday} now`
-  };
-}
-function describeInstalmentPlanCopy(input) {
-  if (input.depositRefundability) {
-    return `Pay ${input.formattedDueToday} today, then continue with scheduled payments. Your deposit is ${formatDepositRefundabilityLabel(input.depositRefundability)}.`;
-  }
-  if (input.futurePaymentCount === 0) {
-    return `Pay ${input.formattedDueToday} today.`;
-  }
-  if (input.futurePaymentCount === 1) {
-    return `Pay ${input.formattedDueToday} today, then one more payment later.`;
-  }
-  const formattedFirstFuture = input.formattedFirstFuture ?? input.formattedDueToday;
-  return `Pay ${input.formattedDueToday} today, then ${input.futurePaymentCount} more ${input.cadenceLabel} payments from ${formattedFirstFuture}.`;
-}
-function buildFlexibleBalanceBookingPaymentOptionCopy(input) {
-  return {
-    title: "Deposit now, pay the rest later",
-    description: `Pay ${input.formattedDueToday} today, then pay the remaining balance any time before ${input.dueDateLabel}. Your deposit is ${formatDepositRefundabilityLabel(input.depositRefundability)}.`,
-    helperText: "You can return in your customer portal to pay the rest before the due date.",
-    ctaLabel: `Pay ${input.formattedDueToday} now`
-  };
-}
-function formatDepositRefundabilityLabel(depositRefundability) {
-  return depositRefundability === "non_refundable" ? "non-refundable" : "refundable";
-}
-
-// ../blocks/src/system/runtime/shared/bookingPaymentOptions.ts
-function buildBookingPaymentSelectionViewModel(input) {
-  const currency = input.priceCurrency ?? "USD";
-  const totalCents = Math.max(0, input.priceAmount ?? 0);
-  const allowedOptions = input.paymentTerms?.allowedOptions ?? [{ kind: "upfront" }];
-  const mode = allowedOptions.length > 1 ? "choice_required" : "single_option";
-  return {
-    mode,
-    sectionTitle: mode === "choice_required" ? "Choose how you'd like to pay" : "Payment",
-    serviceTitle: input.serviceTitle,
-    options: allowedOptions.map((option) => buildBookingPaymentOptionViewModel({
-      option,
-      totalCents,
-      currency,
-      bookingStartAt: input.bookingStartAt,
-      locale: input.locale
-    }))
-  };
-}
-function buildBookingPaymentOptionViewModel(input) {
-  switch (input.option.kind) {
-    case "upfront": {
-      const formattedTotal = formatPrice(input.totalCents, input.currency, input.locale);
-      const copy = buildUpfrontBookingPaymentOptionCopy(formattedTotal);
-      return {
-        kind: "upfront",
-        title: copy.title,
-        description: copy.description,
-        summaryRows: [
-          { label: "Total", value: formattedTotal },
-          { label: "Due today", value: formattedTotal }
-        ],
-        ctaLabel: copy.ctaLabel
-      };
-    }
-    case "deferred_manual": {
-      const formattedTotal = formatPrice(input.totalCents, input.currency, input.locale);
-      const copy = buildDeferredManualBookingPaymentOptionCopy();
-      return {
-        kind: "deferred_manual",
-        title: copy.title,
-        description: copy.description,
-        summaryRows: [
-          { label: "Total", value: formattedTotal },
-          { label: "Due today", value: formatPrice(0, input.currency, input.locale) }
-        ],
-        helperText: copy.helperText,
-        ctaLabel: copy.ctaLabel
-      };
-    }
-    case "instalment_plan": {
-      const schedulePreview = buildInstalmentSchedulePreview({
-        totalCents: input.totalCents,
-        option: input.option,
-        bookingStartAt: input.bookingStartAt
-      });
-      const dueToday = schedulePreview[0]?.amountCents ?? input.totalCents;
-      const futureRows = schedulePreview.slice(1);
-      const formattedTotal = formatPrice(input.totalCents, input.currency, input.locale);
-      const formattedDueToday = formatPrice(dueToday, input.currency, input.locale);
-      const depositRefundability = getBookingInstalmentDepositRefundability(input.option.plan);
-      const copy = buildInstalmentBookingPaymentOptionCopy({
-        formattedDueToday,
-        futurePaymentCount: futureRows.length,
-        formattedFirstFuture: futureRows[0] ? formatPrice(futureRows[0].amountCents, input.currency, input.locale) : null,
-        cadenceLabel: getPaymentCadenceLabel(input.option.plan),
-        depositRefundability
-      });
-      return {
-        kind: "instalment_plan",
-        title: copy.title,
-        description: copy.description,
-        summaryRows: [
-          { label: "Total", value: formattedTotal },
-          { label: "Due today", value: formattedDueToday },
-          ...depositRefundability ? [{
-            label: "Deposit policy",
-            value: depositRefundability === "non_refundable" ? "Non-refundable" : "Refundable"
-          }] : [],
-          ...futureRows.map((row) => ({
-            label: formatScheduleDate(row.dueAt, input.locale),
-            value: formatPrice(row.amountCents, input.currency, input.locale)
-          }))
-        ],
-        helperText: copy.helperText,
-        ctaLabel: copy.ctaLabel
-      };
-    }
-    case "flexible_balance": {
-      const dueToday = resolveFlexibleBalanceInitialPaymentCents({
-        totalAmountCents: input.totalCents,
-        config: input.option.config
-      });
-      const formattedTotal = formatPrice(input.totalCents, input.currency, input.locale);
-      const formattedDueToday = formatPrice(dueToday, input.currency, input.locale);
-      const dueAt = resolveFlexibleBalanceDueAt({
-        bookingStartAt: input.bookingStartAt ?? (/* @__PURE__ */ new Date()).toISOString(),
-        dueDateRule: input.option.config.dueDateRule
-      });
-      const copy = buildFlexibleBalanceBookingPaymentOptionCopy({
-        formattedDueToday,
-        dueDateLabel: formatScheduleDate(dueAt, input.locale),
-        depositRefundability: input.option.config.depositRefundability
-      });
-      return {
-        kind: "flexible_balance",
-        title: copy.title,
-        description: copy.description,
-        summaryRows: [
-          { label: "Total", value: formattedTotal },
-          { label: "Due today", value: formattedDueToday },
-          { label: "Balance due by", value: formatScheduleDate(dueAt, input.locale) },
-          {
-            label: "Deposit policy",
-            value: input.option.config.depositRefundability === "non_refundable" ? "Non-refundable" : "Refundable"
-          }
-        ],
-        helperText: copy.helperText,
-        ctaLabel: copy.ctaLabel
-      };
-    }
-    default:
-      return assertNever11(input.option);
-  }
-}
-function buildInstalmentSchedulePreview(input) {
-  const startAt = input.bookingStartAt ?? (/* @__PURE__ */ new Date()).toISOString();
-  switch (input.option.plan.kind) {
-    case "deposit_plus_one_remainder": {
-      const deposit = clampConfiguredAmount(input.option.plan.depositAmountCents, input.totalCents);
-      const remainder = Math.max(0, input.totalCents - deposit);
-      return compactSchedulePreview([
-        { dueAt: startAt, amountCents: deposit },
-        {
-          dueAt: addIntervalPreservingMonthAnchor(
-            startAt,
-            input.option.plan.remainderDueCount,
-            input.option.plan.intervalUnit
-          ),
-          amountCents: remainder
-        }
-      ]);
-    }
-    case "deposit_plus_scheduled_instalments": {
-      const plan = input.option.plan;
-      const deposit = clampConfiguredAmount(plan.depositAmountCents, input.totalCents);
-      const remaining = Math.max(0, input.totalCents - deposit);
-      const instalments = splitAmountWithRemainderInFirst(
-        remaining,
-        plan.instalmentCount
-      );
-      return compactSchedulePreview([
-        { dueAt: startAt, amountCents: deposit },
-        ...instalments.map((amountCents, index) => ({
-          dueAt: addIntervalPreservingMonthAnchor(
-            startAt,
-            plan.intervalCount * (index + 1),
-            plan.intervalUnit
-          ),
-          amountCents
-        }))
-      ]);
-    }
-    case "equal_scheduled_instalments": {
-      const plan = input.option.plan;
-      const instalments = splitAmountWithRemainderInFirst(
-        input.totalCents,
-        plan.instalmentCount
-      );
-      return compactSchedulePreview(instalments.map((amountCents, index) => ({
-        dueAt: index === 0 ? startAt : addIntervalPreservingMonthAnchor(
-          startAt,
-          plan.intervalCount * index,
-          plan.intervalUnit
-        ),
-        amountCents
-      })));
-    }
-    default:
-      return assertNever11(input.option.plan);
-  }
-}
-function getPaymentCadenceLabel(plan) {
-  const intervalCount = getBookingInstalmentPlanIntervalCount(plan);
-  const unitLabel = intervalCount === 1 ? plan.intervalUnit : `${plan.intervalUnit}s`;
-  return intervalCount === 1 ? unitLabel : `every ${intervalCount} ${unitLabel}`;
-}
-function compactSchedulePreview(schedule) {
-  return omitZeroAmountFutureRows(schedule);
-}
-function formatScheduleDate(isoString, locale) {
-  const date = new Date(isoString);
-  if (!Number.isFinite(date.getTime())) {
-    return isoString;
-  }
-  return new Intl.DateTimeFormat(locale, { dateStyle: "medium" }).format(date);
-}
-
 // ../blocks/src/system/runtime/nodes/booking-form.headless.state.ts
 var unsafeAsBookingFieldId = (id) => id;
 function createEmptyBookingValidationErrors() {
@@ -996,7 +748,7 @@ function bookingFlowReducer(state, event) {
     case "reset":
       return event.initial;
     default:
-      return assertNever11(event);
+      return assertNever(event);
   }
 }
 function clearAvailabilityFeedback(feedback) {
@@ -1125,7 +877,7 @@ function validateBookingStep(input) {
       return Object.keys(errors).length > 0 ? { ok: false, errors: createFieldBookingValidationErrors(errors) } : { ok: true };
     }
     default:
-      return assertNever11(input.stepId);
+      return assertNever(input.stepId);
   }
 }
 function validateBookingFields(input) {
@@ -1417,7 +1169,7 @@ function resolveAppointmentPackagesModel(input) {
       };
     }
     default:
-      return assertNever11(input.state);
+      return assertNever(input.state);
   }
 }
 function toHeadlessEligibleAppointmentPackage(appointmentPackage) {
@@ -1741,7 +1493,10 @@ function useHeadlessBookingFlow(options) {
     state.selectedDate,
     state.selectedSlot
   ]);
-  const appointmentDiscountContext = selectedService && (selectedService.priceAmount ?? 0) > 0 ? { type: "appointment", serviceId: selectedService.id } : null;
+  const appointmentDiscountContext = useMemo(
+    () => selectedService && (selectedService.priceAmount ?? 0) > 0 ? { type: "appointment", serviceId: selectedService.id } : null,
+    [selectedService?.id, selectedService?.priceAmount]
+  );
   const discountUi = useDiscountCodeUi({
     api,
     discountContext: appointmentDiscountContext,
@@ -2327,7 +2082,7 @@ function DefaultBookingStepContent({
     case "custom-fields":
       return /* @__PURE__ */ jsx(DefaultDynamicFields, { fields: booking.fields.items, booking });
     default:
-      return assertNever11(stepId);
+      return assertNever(stepId);
   }
 }
 function DefaultServiceSelectionStep({