@riverbankcms/sdk 0.84.2 → 0.88.0

package/dist/_dts/sdk/src/cli/canonical-entry-policy.d.ts

@@ -0,0 +1,53 @@
+import type { PulledContent } from '../client/management';
+import type { LocalContent } from './content/reader';
+export declare const CANONICAL_EVENT_ENTRY_TYPE = "event";
+export declare const EVENT_MIGRATION_COMMAND = "riverbankcms migrate events";
+export declare const EVENT_PUSH_COMMAND = "riverbankcms push events";
+export declare const EVENT_PULL_COMMAND = "riverbankcms pull events";
+export type CanonicalEntrySurface = typeof CANONICAL_EVENT_ENTRY_TYPE;
+export type CanonicalEntryOperation = 'push' | 'pull';
+export type CanonicalEntryPolicy = Readonly<{
+    contentType: CanonicalEntrySurface;
+    migrationCommand: string;
+    commands: Readonly<Record<CanonicalEntryOperation, string>>;
+}>;
+export type CanonicalEntryScopeViolation = Readonly<{
+    contentType: CanonicalEntrySurface;
+    message: string;
+    suggestion: string;
+}>;
+export type CanonicalEntrySyncDecision = Readonly<{
+    tag: 'allow';
+}> | Readonly<{
+    tag: 'reject';
+    violation: CanonicalEntryScopeViolation;
+}> | Readonly<{
+    tag: 'allow-with-canonical-exclusions';
+    policies: readonly CanonicalEntryPolicy[];
+}>;
+export type CanonicalEntryFilterResult<TContent> = Readonly<{
+    content: TContent;
+    removedEntryCount: number;
+    removedContentTypes: readonly CanonicalEntrySurface[];
+}>;
+export declare function isCanonicalEventEntryType(contentType: string | undefined): contentType is CanonicalEntrySurface;
+export declare function getCanonicalEntryPolicy(contentType: string | undefined): CanonicalEntryPolicy | null;
+export declare function getCanonicalEntrySyncDecision(input: {
+    scope: string;
+    contentType?: string;
+    operation: CanonicalEntryOperation;
+}): CanonicalEntrySyncDecision;
+export declare function getCanonicalEntryScopeViolation(input: {
+    scope: string;
+    contentType?: string;
+    operation: CanonicalEntryOperation;
+}): CanonicalEntryScopeViolation | null;
+export declare function shouldExcludeCanonicalEntries(decision: CanonicalEntrySyncDecision): boolean;
+export declare function filterGenericEntryContentTypes(contentTypes: readonly string[]): string[];
+export declare function stripCanonicalEventEntriesFromLocalContent(content: LocalContent): CanonicalEntryFilterResult<LocalContent>;
+export declare function stripCanonicalEventEntriesFromPulledContent(content: PulledContent): CanonicalEntryFilterResult<PulledContent>;
+export declare function findLegacyEventEntryFiles(contentDir: string): Promise<string[]>;
+export declare function formatLegacyEventEntryWarning(files: readonly string[]): Readonly<{
+    files: readonly string[];
+    suggestion: string;
+}>;

package/dist/_dts/sdk/src/cli/commands/migrate.d.ts

@@ -5,6 +5,7 @@
  *
  * Usage:
  *   riverbankcms migrate entries [contentType] [--content-dir <dir>] [--dry-run] [--force] [--yes]
+ *   riverbankcms migrate events [--content-dir <dir>] [--dry-run] [--yes]
  */
 import { Command } from 'commander';
 export declare const migrateCommand: Command;

package/dist/_dts/sdk/src/cli/commands/pull.d.ts

@@ -15,12 +15,18 @@
  *   riverbankcms pull footer             # Pull footer content
  */
 import { Command } from 'commander';
-import type { PulledContent } from '../../client/management';
+import type { ManagementClient, PulledContent } from '../../client/management';
+import type { OutputContext } from '../output';
 import type { EntryBaseSnapshotTarget } from '../merge-remote/entrySnapshots';
 export declare function entryBaseSnapshotTargetForPull(input: Readonly<{
     isRemote: boolean;
     siteId: string;
 }>): EntryBaseSnapshotTarget;
+/**
+ * Fetch broad generic content, including paginated entry payloads when needed,
+ * then remove canonical/owner-managed entry types before diffing or writing.
+ */
+export declare function pullAllContentWithCanonicalEntryPolicy(client: ManagementClient, output: OutputContext): Promise<PulledContent>;
 export declare function createScopedPullContent(meta: PulledContent['meta'], overrides: Partial<Omit<PulledContent, 'meta'>>): PulledContent;
 /**
  * Determines whether the pull command should prompt for overwrite confirmation.

package/dist/_dts/sdk/src/cli/content/reader.d.ts

@@ -6,6 +6,7 @@
  */
 import type { NavigationAuthoringLinkInput, NavigationLocalItemInput } from '../../../../api/src/navigation';
 import type { SdkEventPricingInput } from '../../../../api/src/sdk-event-pricing';
+import type { EventPaymentTermsInput } from '../../client/management/types';
 import type { Theme } from '../../contracts';
 export interface LocalEntry {
     identifier: string;
@@ -172,6 +173,7 @@ export interface LocalEvent {
     schedule?: LocalEventSchedule;
     capacity?: number | null;
     pricing?: LocalEventPricing;
+    paymentTerms?: EventPaymentTermsInput;
     venueRef?: string | null;
     categoryRef?: string | null;
     content?: LocalEventContent;

package/dist/_dts/sdk/src/cli/migrations/events.d.ts

@@ -0,0 +1,73 @@
+import type { LocalEvent } from '../content/reader';
+export type EventMigrationPlanItem = Readonly<{
+    tag: 'mergeLegacyIntoEvent';
+    legacyFilePath: string;
+    eventFilePath: string;
+    eventIdentifier: string;
+    mergedEvent: LocalEvent;
+    mergedFields: readonly string[];
+}> | Readonly<{
+    tag: 'archiveLegacyOnly';
+    legacyFilePath: string;
+    eventFilePath: string;
+    eventIdentifier: string;
+    reason: string;
+}> | Readonly<{
+    tag: 'conflict';
+    legacyFilePath: string;
+    eventIdentifier: string;
+    conflicts: readonly string[];
+}> | Readonly<{
+    tag: 'ambiguousMatch';
+    legacyFilePath: string;
+    candidateEventIdentifiers: readonly string[];
+}> | Readonly<{
+    tag: 'unmappableLegacyFields';
+    legacyFilePath: string;
+    eventIdentifier?: string;
+    fields: readonly string[];
+}> | Readonly<{
+    tag: 'orphanedLegacy';
+    legacyFilePath: string;
+    legacyIdentifier: string;
+    reason: string;
+}> | Readonly<{
+    tag: 'invalidLegacyShape';
+    legacyFilePath: string;
+    reason: string;
+}>;
+export type WritableEventMigrationPlanItem = Extract<EventMigrationPlanItem, {
+    tag: 'mergeLegacyIntoEvent' | 'archiveLegacyOnly';
+}>;
+export type BlockedEventMigrationPlanItem = Exclude<EventMigrationPlanItem, WritableEventMigrationPlanItem>;
+export type EventMigrationPlan = Readonly<{
+    tag: 'writable';
+    contentDir: string;
+    items: readonly WritableEventMigrationPlanItem[];
+}> | Readonly<{
+    tag: 'blocked';
+    contentDir: string;
+    items: readonly EventMigrationPlanItem[];
+    blockers: readonly BlockedEventMigrationPlanItem[];
+}>;
+export type MigrateEventsResult = Readonly<{
+    status: 'writable' | 'blocked';
+    legacyFilesFound: number;
+    eventsToWrite: number;
+    legacyFilesToArchive: number;
+    merged: number;
+    archiveOnly: number;
+    conflicts: number;
+    ambiguous: number;
+    unmappable: number;
+    orphaned: number;
+    invalid: number;
+    dryRun: boolean;
+    items: readonly EventMigrationPlanItem[];
+}>;
+export type MigrateEventsOptions = Readonly<{
+    contentDir: string;
+    dryRun?: boolean;
+}>;
+export declare function planEventMigration(contentDir: string): Promise<EventMigrationPlan>;
+export declare function migrateEvents(options: MigrateEventsOptions): Promise<MigrateEventsResult>;

package/dist/_dts/sdk/src/client/types.d.ts

@@ -439,10 +439,16 @@ export interface RiverbankClient {
         limit?: number;
         from?: string;
         to?: string;
+        afterStartsAt?: string;
+        afterId?: string;
         stage?: string;
         categoryIds?: string;
         venueId?: string;
+        staffMemberId?: string;
         kind?: 'all' | 'courses' | 'events';
+        eventSurface?: string;
+        eventPresets?: string;
+        scheduleScope?: string;
         /** Optional: filter to a specific content entry (event series) */
         entryId?: string;
         /** Optional: filter to a specific seriesId */
@@ -465,6 +471,9 @@ export interface RiverbankClient {
         venueId?: string;
         staffMemberId?: string;
         kind?: string;
+        eventSurface?: string;
+        eventPresets?: string;
+        scheduleScope?: string;
         entryId?: string;
         seriesId?: string;
         includeOccurrenceId?: string;

package/dist/_dts/sdk/src/config/validation.d.ts

@@ -144,6 +144,7 @@ export declare const sdkLoaderEndpointSchema: z.ZodEnum<{
     getPublishedEntryPreview: "getPublishedEntryPreview";
     listPublishedEntries: "listPublishedEntries";
     getPublicEventDetails: "getPublicEventDetails";
+    listPublicRouteCandidates: "listPublicRouteCandidates";
 }>;
 export declare const loaderParamBindingSchema: z.ZodObject<{
     $bind: z.ZodObject<{
@@ -231,6 +232,7 @@ export declare const sdkConfigLoaderSchema: z.ZodObject<{
         getPublishedEntryPreview: "getPublishedEntryPreview";
         listPublishedEntries: "listPublishedEntries";
         getPublicEventDetails: "getPublicEventDetails";
+        listPublicRouteCandidates: "listPublicRouteCandidates";
     }>;
     params: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodObject<{
         $bind: z.ZodObject<{
@@ -294,6 +296,7 @@ export declare const sdkDataLoadersSchema: z.ZodOptional<z.ZodRecord<z.ZodString
         getPublishedEntryPreview: "getPublishedEntryPreview";
         listPublishedEntries: "listPublishedEntries";
         getPublicEventDetails: "getPublicEventDetails";
+        listPublicRouteCandidates: "listPublicRouteCandidates";
     }>;
     params: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodObject<{
         $bind: z.ZodObject<{

package/dist/_dts/sdk/src/contracts/system-block-content.d.ts

@@ -455,10 +455,13 @@ export type NewsletterSignupPreset = 'emailOnly' | 'emailName' | 'emailFirstLast
 export type NewsletterSignupContent = {
     title?: string | null;
     subtitle?: RichTextDoc | null;
+    listId?: string | null;
     preset: NewsletterSignupPreset;
+    includePhone?: boolean | null;
     buttonLabel?: string | null;
     successMessage?: string | null;
     privacyNote?: string | null;
+    tags?: string | null;
     _sectionStyles?: SectionStylesContent;
 };
 export type ContactNewsletterContent = {

package/dist/_dts/sdk/src/data/prefetchBlockData.d.ts

@@ -4,6 +4,7 @@
  */
 import type { PageOutline } from '../contracts';
 import type { SdkCustomBlock } from '../config/types';
+import { SUPPORTED_LOADER_ENDPOINTS, type SupportedLoaderEndpoint } from '../../../blocks/src/system/data/index';
 import type { RiverbankClient } from '../client/types';
 export type PrefetchContext = {
     siteId?: string;
@@ -12,15 +13,8 @@ export type PrefetchContext = {
     root?: Record<string, unknown>;
 };
 export type ResolvedBlockData = Record<string, Record<string, unknown>>;
-/**
- * Supported loader endpoints for SDK data fetching.
- * Only these endpoints can be used in block data loaders when using the SDK.
- *
- * This is the SDK's public contract for whitelisted endpoints.
- * In the monorepo we should keep it in sync with blocks' internal list.
- */
-export declare const SUPPORTED_LOADER_ENDPOINTS: readonly ["listPublishedEntries", "getPublishedEntryPreview", "listPublicEvents", "listPublicCourses", "listPublicTeamMembers", "listPublicProducts", "listPublicPasses", "listPublicMemberships", "getPublicFormById", "getPublicBookingServices", "getPublicEventDetails"];
-export type SupportedLoaderEndpoint = (typeof SUPPORTED_LOADER_ENDPOINTS)[number];
+export { SUPPORTED_LOADER_ENDPOINTS };
+export type { SupportedLoaderEndpoint };
 /**
  * Options for SDK block data prefetching.
  */

package/dist/_dts/sdk/src/manifest/passes/pass1-fields.d.ts

@@ -291,4 +291,4 @@ export interface ContentTypeSummaryForPrompt {
     isRouted: boolean;
 }
 export declare function buildContentTypePromptSection(contentTypes: ContentTypeSummaryForPrompt[]): string;
-export declare const PASS1_SYSTEM_PROMPT = "You are an expert at analyzing HTML/JSX markup to extract editable content fields for a CMS.\n\nYour task: Analyze the HTML/JSX markup and identify ALL pieces of content that should be editable by a user.\n\n## FIELD ECONOMY PRINCIPLES\n\n**Prefer fewer, smarter fields. CMS editors should not face 25-field forms.**\n\n1. **Use richText for formatted lists and multi-line content:**\n   - Opening hours \u2192 single richText with formatted list (not 6 separate text fields)\n   - Address with line breaks \u2192 single richText (not address1, address2, city, postcode)\n   - Feature lists, specs, ingredients \u2192 richText with bullet list\n\n   RichText supports: paragraphs, bold, italic, bullet lists, numbered lists, links.\n   The CMS editor can format content naturally without rigid field structure.\n\n2. **Use repeaters only when items need individual editing/reordering:**\n   - Testimonials with avatar + name + quote \u2192 repeater (each item is distinct)\n   - Team members with photo + bio \u2192 repeater\n   - Social links where user adds/removes platforms \u2192 repeater\n\n3. **Anti-patterns to AVOID:**\n   \u274C hoursMonFriDay, hoursMonFriTime, hoursSatDay... (6+ fields for hours table)\n   \u274C socialInstagram, socialFacebook, socialTwitter (proliferating similar fields)\n   \u274C address1, address2, city, state, zip (5 fields for one address)\n\n   \u2705 openingHours: single richText field with formatted content\n   \u2705 address: single richText field with line breaks\n   \u2705 socialLinks: repeater with { platform, url } IF user needs to add/remove links\n\n## Field Type Rules\n\n### Simple Fields\n- **text**: Short text (<200 chars), headings, labels, button text\n  - Set multiline: true for paragraphs or text with line breaks\n  - Set multiline: false for single-line text\n- **richText**: Formatted content with HTML tags (p, strong, em, ul, etc.)\n- **media**: Images (<img>) or videos (<video>)\n  - defaultValue: { \"src\": \"image-url\", \"alt\": \"description\" }\n- **link**: Anchors (<a>) or buttons that navigate\n  - defaultValue: { \"label\": \"visible text\" }\n  - Only extract the visible text - link destinations are configured in the CMS\n\n### Container Fields\n\n- **repeater**: List of similar items that editors can add/remove/reorder\n  - Use when: Multiple similar items (social links, features, team members)\n  - Requires: itemLabel (singular name for item), itemFields (array of nested fields)\n  - Example: Social links \u2192 repeater with itemFields: [{ id: \"platform\", type: \"text\" }, { id: \"url\", type: \"link\" }]\n\n- **group**: Related fields grouped together (NOT repeating)\n  - Use when: Logically related fields that should appear together in the CMS\n  - Requires: groupFields (array of nested fields)\n  - Example: Contact info \u2192 group with groupFields: [{ id: \"phone\", type: \"text\" }, { id: \"email\", type: \"text\" }]\n\n### When to use each type:\n- Single value \u2192 simple field (text, richText, media, link)\n- Formatted list where structure is static \u2192 richText (opening hours, address)\n- List where items can be added/removed/reordered \u2192 repeater\n- Related fields that belong together \u2192 group\n\n## Output Requirements\n\n1. Give each field a camelCase id (e.g., headline, ctaButton, heroImage)\n2. Extract the actual content as defaultValue\n3. Describe where each field appears in htmlContext\n4. Set required: true for primary content, false for optional\n\n## Examples\n\n### Example 1: Simple Fields\n\nInput HTML:\n```html\n<section>\n  <h1>Welcome to Our Site</h1>\n  <p>We build amazing products.</p>\n  <a href=\"/start\">Get Started</a>\n</section>\n```\n\nOutput:\n```json\n{\n  \"blockId\": \"custom.hero\",\n  \"blockTitle\": \"Hero Section\",\n  \"blockDescription\": \"Simple hero with headline, description, and CTA\",\n  \"category\": \"marketing\",\n  \"fields\": [\n    { \"id\": \"headline\", \"type\": \"text\", \"label\": \"Headline\", \"required\": true, \"multiline\": false, \"defaultValue\": \"Welcome to Our Site\", \"htmlContext\": \"h1 main heading\" },\n    { \"id\": \"description\", \"type\": \"text\", \"label\": \"Description\", \"required\": true, \"multiline\": false, \"defaultValue\": \"We build amazing products.\", \"htmlContext\": \"p below heading\" },\n    { \"id\": \"cta\", \"type\": \"link\", \"label\": \"Call to Action\", \"required\": false, \"multiline\": null, \"defaultValue\": { \"label\": \"Get Started\" }, \"htmlContext\": \"a button at bottom\" }\n  ],\n  \"contentTypeApproach\": { \"approach\": \"none\", \"rationale\": \"Single hero section, not list data\" }\n}\n```\n\n### Example 2: Repeater Field\n\nInput HTML with repeating social links:\n```html\n<footer>\n  <div class=\"social-links\">\n    <a href=\"https://instagram.com/...\"><svg>Instagram</svg></a>\n    <a href=\"https://facebook.com/...\"><svg>Facebook</svg></a>\n    <a href=\"https://twitter.com/...\"><svg>Twitter</svg></a>\n  </div>\n</footer>\n```\n\nOutput with repeater:\n```json\n{\n  \"blockId\": \"custom.footer\",\n  \"blockTitle\": \"Footer\",\n  \"blockDescription\": \"Footer with social links\",\n  \"category\": \"layout\",\n  \"fields\": [\n    {\n      \"id\": \"socialLinks\",\n      \"type\": \"repeater\",\n      \"label\": \"Social Links\",\n      \"required\": false,\n      \"itemLabel\": \"Link\",\n      \"itemFields\": [\n        { \"id\": \"platform\", \"type\": \"text\", \"label\": \"Platform\", \"required\": true },\n        { \"id\": \"url\", \"type\": \"link\", \"label\": \"URL\", \"required\": true }\n      ],\n      \"htmlContext\": \"Row of social media icon links\"\n    }\n  ],\n  \"contentTypeApproach\": { \"approach\": \"repeater\", \"rationale\": \"Social links are page-specific and editors need to add/remove platforms\" }\n}\n```\n";
+export declare const PASS1_SYSTEM_PROMPT = "You are an expert at analyzing HTML/JSX markup to extract editable content fields for a CMS.\n\nYour task: Analyze the HTML/JSX markup and identify ALL pieces of content that should be editable by a user.\n\n## FIELD ECONOMY PRINCIPLES\n\n**Prefer fewer, smarter fields. CMS editors should not face 25-field forms.**\n\n1. **Use richText for formatted lists and multi-line content:**\n   - Opening hours \u2192 single richText with formatted list (not 6 separate text fields)\n   - Address with line breaks \u2192 single richText with hard line breaks / Shift+Enter between lines (not address1, address2, city, postcode)\n   - Feature lists, specs, ingredients \u2192 richText with bullet list\n\n   RichText supports: paragraphs, hard line breaks, bold, italic, bullet lists, numbered lists, links.\n   The CMS editor can format content naturally without rigid field structure.\n   For line-oriented content like addresses, opening hours, and contact details, keep one logical paragraph and use hard line breaks between lines. In the CMS editor, authors create those line breaks with Shift+Enter; Enter creates a new paragraph.\n\n2. **Use repeaters only when items need individual editing/reordering:**\n   - Testimonials with avatar + name + quote \u2192 repeater (each item is distinct)\n   - Team members with photo + bio \u2192 repeater\n   - Social links where user adds/removes platforms \u2192 repeater\n\n3. **Anti-patterns to AVOID:**\n   \u274C hoursMonFriDay, hoursMonFriTime, hoursSatDay... (6+ fields for hours table)\n   \u274C socialInstagram, socialFacebook, socialTwitter (proliferating similar fields)\n   \u274C address1, address2, city, state, zip (5 fields for one address)\n\n   \u2705 openingHours: single richText field with formatted content / hard line breaks\n   \u2705 address: single richText field with hard line breaks (Shift+Enter in the editor)\n   \u2705 socialLinks: repeater with { platform, url } IF user needs to add/remove links\n\n## Field Type Rules\n\n### Simple Fields\n- **text**: Short text (<200 chars), headings, labels, button text\n  - Set multiline: true for paragraphs or text with line breaks\n  - Set multiline: false for single-line text\n- **richText**: Formatted content with HTML tags (p, strong, em, ul, etc.)\n- **media**: Images (<img>) or videos (<video>)\n  - defaultValue: { \"src\": \"image-url\", \"alt\": \"description\" }\n- **link**: Anchors (<a>) or buttons that navigate\n  - defaultValue: { \"label\": \"visible text\" }\n  - Only extract the visible text - link destinations are configured in the CMS\n\n### Container Fields\n\n- **repeater**: List of similar items that editors can add/remove/reorder\n  - Use when: Multiple similar items (social links, features, team members)\n  - Requires: itemLabel (singular name for item), itemFields (array of nested fields)\n  - Example: Social links \u2192 repeater with itemFields: [{ id: \"platform\", type: \"text\" }, { id: \"url\", type: \"link\" }]\n\n- **group**: Related fields grouped together (NOT repeating)\n  - Use when: Logically related fields that should appear together in the CMS\n  - Requires: groupFields (array of nested fields)\n  - Example: Contact info \u2192 group with groupFields: [{ id: \"phone\", type: \"text\" }, { id: \"email\", type: \"text\" }]\n\n### When to use each type:\n- Single value \u2192 simple field (text, richText, media, link)\n- Formatted list where structure is static \u2192 richText (opening hours, address; use hard line breaks / Shift+Enter for line-oriented text)\n- List where items can be added/removed/reordered \u2192 repeater\n- Related fields that belong together \u2192 group\n\n## Output Requirements\n\n1. Give each field a camelCase id (e.g., headline, ctaButton, heroImage)\n2. Extract the actual content as defaultValue\n3. Describe where each field appears in htmlContext\n4. Set required: true for primary content, false for optional\n\n## Examples\n\n### Example 1: Simple Fields\n\nInput HTML:\n```html\n<section>\n  <h1>Welcome to Our Site</h1>\n  <p>We build amazing products.</p>\n  <a href=\"/start\">Get Started</a>\n</section>\n```\n\nOutput:\n```json\n{\n  \"blockId\": \"custom.hero\",\n  \"blockTitle\": \"Hero Section\",\n  \"blockDescription\": \"Simple hero with headline, description, and CTA\",\n  \"category\": \"marketing\",\n  \"fields\": [\n    { \"id\": \"headline\", \"type\": \"text\", \"label\": \"Headline\", \"required\": true, \"multiline\": false, \"defaultValue\": \"Welcome to Our Site\", \"htmlContext\": \"h1 main heading\" },\n    { \"id\": \"description\", \"type\": \"text\", \"label\": \"Description\", \"required\": true, \"multiline\": false, \"defaultValue\": \"We build amazing products.\", \"htmlContext\": \"p below heading\" },\n    { \"id\": \"cta\", \"type\": \"link\", \"label\": \"Call to Action\", \"required\": false, \"multiline\": null, \"defaultValue\": { \"label\": \"Get Started\" }, \"htmlContext\": \"a button at bottom\" }\n  ],\n  \"contentTypeApproach\": { \"approach\": \"none\", \"rationale\": \"Single hero section, not list data\" }\n}\n```\n\n### Example 2: Repeater Field\n\nInput HTML with repeating social links:\n```html\n<footer>\n  <div class=\"social-links\">\n    <a href=\"https://instagram.com/...\"><svg>Instagram</svg></a>\n    <a href=\"https://facebook.com/...\"><svg>Facebook</svg></a>\n    <a href=\"https://twitter.com/...\"><svg>Twitter</svg></a>\n  </div>\n</footer>\n```\n\nOutput with repeater:\n```json\n{\n  \"blockId\": \"custom.footer\",\n  \"blockTitle\": \"Footer\",\n  \"blockDescription\": \"Footer with social links\",\n  \"category\": \"layout\",\n  \"fields\": [\n    {\n      \"id\": \"socialLinks\",\n      \"type\": \"repeater\",\n      \"label\": \"Social Links\",\n      \"required\": false,\n      \"itemLabel\": \"Link\",\n      \"itemFields\": [\n        { \"id\": \"platform\", \"type\": \"text\", \"label\": \"Platform\", \"required\": true },\n        { \"id\": \"url\", \"type\": \"link\", \"label\": \"URL\", \"required\": true }\n      ],\n      \"htmlContext\": \"Row of social media icon links\"\n    }\n  ],\n  \"contentTypeApproach\": { \"approach\": \"repeater\", \"rationale\": \"Social links are page-specific and editors need to add/remove platforms\" }\n}\n```\n";

package/dist/_dts/sdk/src/manifest/three-pass-converter.d.ts

@@ -10,28 +10,16 @@
  * This approach ensures CSS rules reference classNames that actually exist
  * in the layout by applying patches programmatically between passes.
  */
+import { parseRichTextInlineMarkdown, parseRichTextParagraphInlineMarkdown, type TipTapNode } from '../../../blocks/src/index';
 import type { HtmlToManifestInput, HtmlToManifestOutput, ConversionResult, ConverterOptions } from './types';
 import { DEFAULT_MANIFEST_MODEL } from './constants';
 export { DEFAULT_MANIFEST_MODEL };
-interface TipTapNode {
-    type: string;
-    content?: TipTapNode[];
-    text?: string;
-    marks?: Array<{
-        type: string;
-    }>;
-}
-/**
- * Parse inline markdown (bold only) into TipTap text nodes.
- *
- * Only bold (**text**) is supported because LLM-generated rich text defaults
- * typically only use bold for emphasis. Other markdown features (italic, links,
- * headings) are not expected in field default values and would add complexity
- * without meaningful benefit.
- */
-declare function parseInlineMarkdown(text: string): TipTapNode[];
 /**
  * Convert a plain string (or simple markdown) to TipTap doc format.
+ *
+ * Double newlines create semantic paragraphs. Single newlines remain inside the
+ * current paragraph as TipTap hardBreak nodes for line-oriented content such as
+ * addresses and opening hours.
  */
 declare function stringToTipTapDoc(text: string): TipTapNode;
 /**
@@ -70,7 +58,8 @@ export declare function validateManifestOutput(data: unknown): {
  * @internal
  */
 export declare const __testing: {
-    parseInlineMarkdown: typeof parseInlineMarkdown;
+    parseInlineMarkdown: typeof parseRichTextInlineMarkdown;
+    parseParagraphInlineMarkdown: typeof parseRichTextParagraphInlineMarkdown;
     stringToTipTapDoc: typeof stringToTipTapDoc;
     coerceRichTextDefaultValue: typeof coerceRichTextDefaultValue;
 };

package/dist/_dts/sdk/src/rendering/blocks-page-renderer.d.ts

@@ -2,11 +2,13 @@ import * as React from 'react';
 import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, ResolveImageUrlContextInput, RouteMap, Theme, ThemeTokens } from '../contracts';
 import type { SdkCustomBlock } from '../config/types';
 import type { BlockOverrides } from './overrides';
+import type { SiteBookingOfferingPresetSummary } from '../public-api/contracts';
 export type ComponentRegistry = Record<string, React.ElementType>;
 export type PageRendererDataContext = {
     siteId?: string;
     pageId?: string;
     resolvedData?: Record<string, Record<string, unknown>>;
+    bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
     previewStage?: 'published' | 'preview';
     routes?: RouteMap;
     pagesByIdentifier?: Record<string, string>;

package/dist/_dts/sdk/src/rendering/components/pageShared.d.ts

@@ -1,6 +1,7 @@
 import type { ReactElement } from 'react';
 import type { EntrySubrouteContextData, MediaAssetIndexItem, OccurrenceContextData, PageOutline, RouteMap, Theme, ThemeTokens } from '../../contracts';
 import type { ResolvedBlockData } from '../../data';
+import type { SiteBookingOfferingPresetSummary } from '../../public-api/contracts';
 import type { RuntimeSdkConfig } from '../helpers/loadPage';
 import { type ComponentRegistry } from '../blocks-page-renderer';
 import type { BlockOverrides } from '../overrides';
@@ -11,6 +12,7 @@ export type PageProps = {
     siteId: string;
     themeTokens?: ThemeTokens;
     resolvedData?: ResolvedBlockData;
+    bookingOfferingPresets?: readonly SiteBookingOfferingPresetSummary[];
     routeMap?: RouteMap;
     /** Page identifier to routeId lookup for { kind: 'page' } CTA links */
     pagesByIdentifier?: Record<string, string>;
@@ -89,4 +91,4 @@ export type PageHydrationBootstrapConfig = {
     mediaAssets?: readonly MediaAssetIndexItem[];
 };
 export declare function toPageHydrationBootstrapConfig(props: Pick<PageProps, 'siteId' | 'supabaseUrl' | 'mediaAssets'>): PageHydrationBootstrapConfig;
-export declare function PageContent({ page, theme, themeTokens: providedTokens, siteId, resolvedData, routeMap, pagesByIdentifier, entriesByIdentifier, wrapBlock, registry, usePlaceholders, blockOverrides, sdkConfig, customBlocks, supabaseUrl, mediaAssets, apiBaseUrl, portalToken, previewToken, dataContext, useThemeScope, }: PageProps): ReactElement;
+export declare function PageContent({ page, theme, themeTokens: providedTokens, siteId, resolvedData, bookingOfferingPresets, routeMap, pagesByIdentifier, entriesByIdentifier, wrapBlock, registry, usePlaceholders, blockOverrides, sdkConfig, customBlocks, supabaseUrl, mediaAssets, apiBaseUrl, portalToken, previewToken, dataContext, useThemeScope, }: PageProps): ReactElement;

package/dist/_dts/sdk/src/rendering/helpers/loadContent.d.ts

@@ -8,8 +8,8 @@ import type { MediaAssetIndexItem, RouteMap, Theme } from '../../contracts';
 import type { RiverbankClient, SiteResponse } from '../../client/types';
 import type { PageProps } from '../components/Page';
 import type { ResolvedBlockData } from '../../data/prefetchBlockData';
-import type { RuntimeSdkConfig } from './loadPage';
 import type { SdkCustomBlock } from '../../config/types';
+import { type RuntimeSdkConfig } from './pageRuntimeSupport';
 /**
  * Site data included in content results for metadata generation.
  */
@@ -92,6 +92,8 @@ export type PageContentResult = {
     customBlocks?: SdkCustomBlock[];
     /** Pre-fetched block data for data loaders */
     resolvedData: ResolvedBlockData;
+    /** Selected booking offering presets exposed to SSR blocks. */
+    bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
     /** Site data for metadata generation */
     site: SiteData;
     /**
@@ -112,7 +114,7 @@ export type PageContentResult = {
     /** ContentType -> identifier -> routeId lookup for { kind: 'entry' } CTA links */
     entriesByIdentifier?: Record<string, Record<string, string>>;
     /** Canonical media assets for resolving identifier-only media values in preview/edit UIs. */
-    mediaAssets?: MediaAssetIndexItem[];
+    mediaAssets?: readonly MediaAssetIndexItem[];
 };
 /**
  * Result when path resolves to a content entry
@@ -125,6 +127,8 @@ export type EntryContentResult = {
     templatePage: PageProps['page'] | null;
     /** Pre-fetched block data for template page data loaders */
     resolvedData: ResolvedBlockData;
+    /** Selected booking offering presets exposed to SSR blocks. */
+    bookingOfferingPresets?: PageProps['bookingOfferingPresets'];
     /** Data context for template blocks (includes entry content for bindings) */
     dataContext: {
         contentEntry: Record<string, unknown>;
@@ -155,7 +159,7 @@ export type EntryContentResult = {
     /** ContentType -> identifier -> routeId lookup for { kind: 'entry' } CTA links */
     entriesByIdentifier?: Record<string, Record<string, string>>;
     /** Canonical media assets for resolving identifier-only media values in preview/edit UIs. */
-    mediaAssets?: MediaAssetIndexItem[];
+    mediaAssets?: readonly MediaAssetIndexItem[];
 };
 /**
  * Discriminated union result from loadContent

package/dist/_dts/sdk/src/rendering/helpers/loadPage.d.ts

@@ -3,15 +3,15 @@
  *
  * Use this in server components, getServerSideProps, or API routes.
  */
-import type { RiverbankClient, SiteResponse } from '../../client/types';
-import type { MediaAssetIndexItem } from '../../contracts';
+import type { RiverbankClient } from '../../client/types';
 import type { PageProps } from '../components/Page';
 import type { DataLoaderOverrides } from '../../data/types';
+import { type RuntimeSdkConfig } from './pageRuntimeSupport';
 /**
  * SDK config from API response (without siteId which is stripped at storage).
  * This is the runtime representation - for defining configs, use RiverbankSiteConfig.
  */
-export type RuntimeSdkConfig = NonNullable<SiteResponse['sdkConfig']>;
+export type { RuntimeSdkConfig } from './pageRuntimeSupport';
 export type LoadPageParams = {
     client: RiverbankClient;
     siteId: string;
@@ -77,32 +77,12 @@ export type LoadPageParams = {
      */
     searchParams?: Record<string, string | string[] | undefined>;
 };
-export type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'usePlaceholders' | 'blockOverrides'> & {
+export type LoadPageResult = Omit<PageProps, 'registry' | 'wrapBlock' | 'usePlaceholders' | 'blockOverrides' | 'sdkConfig'> & {
     /**
      * SDK site configuration, if available.
      * Contains SDK-defined theme palette, section backgrounds, and style options.
      */
     sdkConfig: RuntimeSdkConfig | null;
-    /**
-     * Supabase storage URL for direct image access.
-     * SDK sites use this instead of NEXT_PUBLIC_SUPABASE_URL env var.
-     */
-    supabaseUrl?: string;
-    /**
-     * Canonical media sidecar for resolving identifier-only media values on first paint.
-     */
-    mediaAssets?: readonly MediaAssetIndexItem[];
-    /**
-     * Page identifier to routeId lookup for CTA link resolution.
-     * Used to resolve { kind: 'page', identifier: '...' } links at render time.
-     */
-    pagesByIdentifier?: Record<string, string>;
-    /**
-     * Entry identifier to routeId lookup for CTA link resolution.
-     * Maps contentTypeKey -> identifier -> routeId.
-     * Used to resolve { kind: 'entry', contentType: '...', identifier: '...' } links at render time.
-     */
-    entriesByIdentifier?: Record<string, Record<string, string>>;
 };
 /**
  * Server-side helper to fetch all data needed for <Page> component.

package/dist/_dts/sdk/src/rendering/helpers/pageRuntimeSupport.d.ts

@@ -0,0 +1,45 @@
+import type { MediaAssetIndexItem, PageOutline, RouteMap, Theme } from '../../contracts';
+import type { SiteBookingOfferingPresetSummary } from '../../public-api/contracts';
+import type { SiteResponse } from '../../client/types';
+import type { SdkCustomBlock } from '../../config/types';
+export type RuntimeSdkConfig = NonNullable<SiteResponse['sdkConfig']>;
+export type SiteData = SiteResponse['site'];
+export type SiteRenderSupport = Readonly<{
+    theme: Theme;
+    site: SiteData;
+    sdkConfig: RuntimeSdkConfig | null;
+    bookingOfferingPresets: readonly SiteBookingOfferingPresetSummary[];
+    customBlocks?: SdkCustomBlock[];
+    supabaseUrl?: string;
+    routeMap?: RouteMap;
+    pagesByIdentifier?: Record<string, string>;
+    entriesByIdentifier?: Record<string, Record<string, string>>;
+    mediaAssets?: readonly MediaAssetIndexItem[];
+}>;
+export type PageRecordForPreview = Readonly<{
+    id: string;
+    routeId?: string | null;
+    name: string;
+    path: string | null;
+    purpose: string;
+    status?: string | null;
+    draftStatus?: string | null;
+    publishedAt?: string | null;
+    draftTitle?: string | null;
+    draftPath?: string | null;
+    draftMetaTitle?: string | null;
+    draftMetaDescription?: string | null;
+    publishedMetaTitle?: string | null;
+    publishedMetaDescription?: string | null;
+    ogImageId?: string | null;
+}>;
+export declare function buildSiteRenderSupport(site: SiteResponse, mediaAssets: readonly MediaAssetIndexItem[] | undefined): SiteRenderSupport;
+export declare function collectMediaAssetSidecar(mediaAssets: readonly MediaAssetIndexItem[] | null | undefined): readonly MediaAssetIndexItem[] | undefined;
+export declare function buildPageOutline(input: Readonly<{
+    name: string;
+    path: string | null | undefined;
+    fallbackPath: string;
+    purpose: string;
+    blocks: readonly unknown[];
+}>): PageOutline;
+export declare function sanitizeSdkRuntimeBlockContent(blockKind: string, content: Record<string, unknown>): Record<string, unknown>;

package/dist/_dts/sdk/src/version.d.ts

@@ -8,4 +8,4 @@
  * 1. This constant
  * 2. The "version" field in package.json
  */
-export declare const SDK_VERSION = "0.84.2";
+export declare const SDK_VERSION = "0.88.0";

package/dist/_dts/site-commands/src/commands.d.ts

@@ -457,6 +457,24 @@ export declare const upsertEventSeriesCommandSchema: z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"ticket_types">;
             currency: z.ZodOptional<z.ZodString>;
+            ticketTypes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                identifier: z.ZodString;
+                cmsTicketTypeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                priceAmount: z.ZodNumber;
+                priceCurrency: z.ZodOptional<z.ZodString>;
+                isActive: z.ZodOptional<z.ZodBoolean>;
+                sortOrder: z.ZodOptional<z.ZodNumber>;
+                capacityLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                attendanceScope: z.ZodOptional<z.ZodEnum<{
+                    both: "both";
+                    in_person: "in_person";
+                    online: "online";
+                }>>;
+                saleStartsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                saleEndsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"manual_payment">;
             instructions: z.ZodOptional<z.ZodString>;
@@ -493,6 +511,7 @@ export declare const upsertEventSeriesCommandSchema: z.ZodObject<{
             contentEntryRef: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<ContentEntryRef, string>>>;
         }, z.core.$strict>>;
         settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        paymentTerms: z.ZodOptional<z.ZodUnknown>;
         presentation: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         tags: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
         staffRefs: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<StaffRef, string>>>>>;
@@ -1398,6 +1417,24 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"ticket_types">;
             currency: z.ZodOptional<z.ZodString>;
+            ticketTypes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                identifier: z.ZodString;
+                cmsTicketTypeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                priceAmount: z.ZodNumber;
+                priceCurrency: z.ZodOptional<z.ZodString>;
+                isActive: z.ZodOptional<z.ZodBoolean>;
+                sortOrder: z.ZodOptional<z.ZodNumber>;
+                capacityLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                attendanceScope: z.ZodOptional<z.ZodEnum<{
+                    both: "both";
+                    in_person: "in_person";
+                    online: "online";
+                }>>;
+                saleStartsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                saleEndsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            }, z.core.$strict>>>>;
         }, z.core.$strict>, z.ZodObject<{
             kind: z.ZodLiteral<"manual_payment">;
             instructions: z.ZodOptional<z.ZodString>;
@@ -1434,6 +1471,7 @@ export declare const siteCommandSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             contentEntryRef: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<ContentEntryRef, string>>>;
         }, z.core.$strict>>;
         settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        paymentTerms: z.ZodOptional<z.ZodUnknown>;
         presentation: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
         tags: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
         staffRefs: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<StaffRef, string>>>>>;
@@ -2254,6 +2292,24 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
             }, z.core.$strict>, z.ZodObject<{
                 kind: z.ZodLiteral<"ticket_types">;
                 currency: z.ZodOptional<z.ZodString>;
+                ticketTypes: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodObject<{
+                    identifier: z.ZodString;
+                    cmsTicketTypeId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    name: z.ZodString;
+                    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    priceAmount: z.ZodNumber;
+                    priceCurrency: z.ZodOptional<z.ZodString>;
+                    isActive: z.ZodOptional<z.ZodBoolean>;
+                    sortOrder: z.ZodOptional<z.ZodNumber>;
+                    capacityLimit: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+                    attendanceScope: z.ZodOptional<z.ZodEnum<{
+                        both: "both";
+                        in_person: "in_person";
+                        online: "online";
+                    }>>;
+                    saleStartsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                    saleEndsAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+                }, z.core.$strict>>>>;
             }, z.core.$strict>, z.ZodObject<{
                 kind: z.ZodLiteral<"manual_payment">;
                 instructions: z.ZodOptional<z.ZodString>;
@@ -2290,6 +2346,7 @@ export declare const siteCommandBatchSchema: z.ZodObject<{
                 contentEntryRef: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<ContentEntryRef, string>>>;
             }, z.core.$strict>>;
             settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            paymentTerms: z.ZodOptional<z.ZodUnknown>;
             presentation: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
             tags: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
             staffRefs: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<StaffRef, string>>>>>;