@riverbankcms/sdk 0.81.0 → 0.84.0

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

@@ -5,6 +5,7 @@
  */
 import type { LinkPayload, NavigationLinkInput } from '../../public-api/contracts';
 import type { SiteCommandOf } from '../../../../site-commands/src/index';
+import type { SdkEventPricing, SdkEventPricingInput, SdkEventTicketTypeInput } from '../../../../api/src/sdk-event-pricing';
 import type { Theme } from '../../contracts';
 export interface ManagementClientConfig {
     /**
@@ -40,13 +41,27 @@ export interface ManagementEntry {
     updatedAt: string;
     publishedAt: string | null;
     manualOrder: number;
+    blocks?: EntrySlotBlocks;
 }
+export interface EntrySlotBlock {
+    identifier: string | null;
+    kind: string;
+    content: Record<string, unknown>;
+}
+export type EntrySlotBlocks = Record<string, EntrySlotBlock[]>;
+export interface EntrySlotBlockInput {
+    identifier?: string | null;
+    kind: string;
+    content: Record<string, unknown>;
+}
+export type EntrySlotBlocksInput = Record<string, EntrySlotBlockInput[]>;
 export interface EntryUpsertInput {
     identifier: string;
     contentType: string;
     data: Record<string, unknown>;
     slug?: string;
     manualOrder?: number;
+    blocks?: EntrySlotBlocksInput;
 }
 export interface ManagementPage {
     id: string;
@@ -355,17 +370,31 @@ export interface EventSchedule {
     defaultStartTime: string;
     durationMinutes: number;
 }
+export interface EventStartEndSchedule {
+    /** Start/end schedules are currently supported for one-off SDK-managed events only. */
+    recurrenceRule?: null;
+    /** ISO datetime. Local datetime strings are treated as event-local wall time by the API. */
+    startsAt: string;
+    /** ISO datetime. Must be after startsAt and no more than the shared event duration maximum. */
+    endsAt: string;
+    durationMinutes?: never;
+}
+export interface EventStartDurationSchedule {
+    /** Start/duration schedules are currently supported for one-off SDK-managed events only. */
+    recurrenceRule?: null;
+    /** ISO datetime. Local datetime strings are treated as event-local wall time by the API. */
+    startsAt: string;
+    /** Must be no more than the shared event duration maximum. */
+    durationMinutes: number;
+    endsAt?: never;
+}
+export type EventScheduleUpsertInput = EventSchedule | EventStartEndSchedule | EventStartDurationSchedule;
+export type EventTicketTypeInput = SdkEventTicketTypeInput;
 /**
  * Pricing configuration for an event series.
  */
-export interface EventPricing {
-    requiresPayment: boolean;
-    priceAmount: number | null;
-    priceCurrency: string | null;
-    priceDisplay: string | null;
-    acceptsPasses: boolean;
-    acceptsMemberships: boolean;
-}
+export type EventPricing = SdkEventPricing;
+export type EventPricingInput = SdkEventPricingInput;
 /**
  * Event content data (embedded from content_entry).
  */
@@ -413,9 +442,9 @@ export interface EventSeriesUpsertInput {
     slug: string;
     status?: 'draft' | 'active' | 'archived' | 'cancelled';
     visibility?: 'private' | 'public' | 'unlisted';
-    schedule: EventSchedule;
+    schedule: EventScheduleUpsertInput;
     capacity?: number | null;
-    pricing?: Partial<EventPricing>;
+    pricing?: EventPricingInput;
     /** Venue slug - resolved to venue_id on push */
     venueRef?: string | null;
     /** Category identifier - resolved to event_category_id on push */
@@ -590,6 +619,7 @@ export interface PulledEntries {
          */
         title: string;
         manualOrder?: number;
+        blocks?: EntrySlotBlocks;
     }>;
     meta: {
         pulledAt: string;

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

@@ -64,11 +64,26 @@ export interface GetEntriesBaseParams extends SdkMethodOptions {
     order?: 'newest' | 'oldest' | 'title' | 'manual';
     /** If true, includes draft entries (requires API key with site access) */
     preview?: boolean;
-    /** Selection mode: 'query' for automatic, 'manual' for specific entry IDs */
+    /** Selection mode: 'query' for automatic, 'manual' for specific entry refs */
     mode?: 'query' | 'manual';
-    /** Entry IDs to fetch when mode is 'manual' */
+    /** Entry UUIDs, stable identifiers, or slugs to fetch when mode is 'manual' */
     entryIds?: string[];
 }
+export type GetEntriesByIdentifiersParams = {
+    /** The site ID */
+    siteId: string;
+    /** The content type key (e.g., 'blog-post', 'meditation') */
+    contentType: string;
+    /**
+     * Stable entry references to resolve in order.
+     *
+     * Each value may be an entry UUID, `content_entries.identifier`, or route slug.
+     * Empty values are ignored and duplicate refs collapse to their first occurrence.
+     */
+    identifiers: readonly string[];
+    /** If true, includes draft entries (requires API key with site access) */
+    preview?: boolean;
+} & SdkMethodOptions;
 /**
  * Source of the data returned by a resilient fetch
  */
@@ -327,7 +342,7 @@ export interface RiverbankClient {
      * @param params.order - Sort order: 'newest' (published_at desc) or 'oldest' (published_at asc)
      * @param params.preview - If true, includes draft entries (requires API key with site access)
      * @param params.mode - 'query' for automatic fetching, 'manual' for specific entry IDs
-     * @param params.entryIds - Array of entry IDs to fetch (only used when mode is 'manual')
+     * @param params.entryIds - Array of entry refs to fetch (only used when mode is 'manual')
      * @param params.includeMeta - If true, returns pagination metadata with the response
      *
      * @example
@@ -350,7 +365,7 @@ export interface RiverbankClient {
      * });
      * // page3.entries, page3.total, page3.hasMore, page3.currentPage
      *
-     * // Fetch specific entries by ID (manual mode)
+     * // Fetch specific entries by stable refs (manual mode)
      * const specific = await client.getEntries({
      *   siteId: 'site-id',
      *   contentType: 'blog-post',
@@ -370,6 +385,23 @@ export interface RiverbankClient {
     getEntries(params: GetEntriesBaseParams & {
         includeMeta?: boolean;
     }): Promise<EntriesResponse | EntriesResponseWithMeta>;
+    /**
+     * Fetch a manually ordered set of content entries by stable refs.
+     *
+     * Refs resolve as entry UUIDs, stable entry identifiers, then route slugs. Missing
+     * refs are omitted. Returned entries preserve the order of the requested refs
+     * after empty values and duplicates are removed.
+     *
+     * @example
+     * ```ts
+     * const { entries } = await client.getEntriesByIdentifiers({
+     *   siteId: 'site-id',
+     *   contentType: 'meditation',
+     *   identifiers: ['metta-meditation', 'resting-in-compassion'],
+     * });
+     * ```
+     */
+    getEntriesByIdentifiers(params: GetEntriesByIdentifiersParams): Promise<EntriesResponse>;
     /**
      * Fetch a specific content entry by slug
      */

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

@@ -30,4 +30,4 @@ export { Page } from './rendering/components/Page';
 export type { PageProps } from './rendering/components/Page';
 export type { ContentEntryData } from './rendering/helpers/loadContent';
 export { createRiverbankClient } from './client/index';
-export type { RiverbankClient, RiverbankClientConfig, SdkCorrelationHeaderName, SdkCorrelationHeaders, } from './client/types';
+export type { RiverbankClient, RiverbankClientConfig, GetEntriesByIdentifiersParams, SdkCorrelationHeaderName, SdkCorrelationHeaders, } from './client/types';

package/dist/_dts/sdk/src/config/content-types.d.ts

@@ -9,7 +9,7 @@
  */
 import type { FieldDefinition } from './field-definitions';
 import type { BlockKind } from '../types';
-import type { NavigationLinkInput } from '../public-api/contracts';
+import type { NavigationAuthoringLinkInput, NavigationConfigItemInput } from '../../../api/src/navigation';
 import type { BindingTransformName } from '../contracts/bindings';
 export type { FieldDefinition } from './field-definitions';
 export declare const TEMPLATE_BINDING_META_PATHS: readonly ["title", "slug", "publishedAt", "createdAt", "updatedAt"];
@@ -259,9 +259,7 @@ export interface EntryConfig {
 /**
  * Navigation link types for menu items.
  */
-export type NavigationLinkType = NavigationLinkInput | {
-    kind: 'dropdown';
-};
+export type NavigationLinkType = NavigationAuthoringLinkInput;
 /**
  * Navigation item definition.
  *
@@ -276,16 +274,7 @@ export type NavigationLinkType = NavigationLinkInput | {
  * }
  * ```
  */
-export interface NavigationItemConfig {
-    /** Display label */
-    label: string;
-    /** Link configuration */
-    link: NavigationLinkType;
-    /** Is this a CTA button? */
-    isCta?: boolean;
-    /** Child items (for dropdown menus, max 1 level) */
-    children?: NavigationItemConfig[];
-}
+export type NavigationItemConfig = NavigationConfigItemInput;
 /**
  * Navigation menu definition.
  *

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

@@ -7,6 +7,7 @@ import { z } from 'zod';
 import type { ContentConfig, ContentTypeConfig } from './content-types';
 import { TEMPLATE_BINDING_META_PATHS } from './content-types';
 import { type BindingTransformName } from '../contracts/bindings';
+import type { NavigationConfigItemInput } from '../../../api/src/navigation';
 export declare const contentTypeConfigSchema: z.ZodType<ContentTypeConfig>;
 type BindingSourceType = {
     source: 'field';
@@ -90,229 +91,23 @@ export declare const entryConfigSchema: z.ZodObject<{
     metaTitle: z.ZodOptional<z.ZodString>;
     metaDescription: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export declare const navigationItemConfigSchema: z.ZodType<{
-    label: string;
-    link: {
-        kind: 'page';
-        identifier: string;
-    } | {
-        kind: 'entry';
-        contentType: string;
-        identifier: string;
-    } | {
-        kind: 'external';
-        href: string;
-    } | {
-        kind: 'url';
-        href: string;
-    } | {
-        kind: 'portal';
-        path?: string;
-        labels?: {
-            loggedOut?: string;
-            loggedIn?: string;
-        };
-    } | {
-        kind: 'cart';
-        badge: 'show-count' | 'hidden';
-        label: {
-            kind: 'icon-only';
-        } | {
-            kind: 'icon-with-label';
-            label: string;
-        };
-    } | {
-        kind: 'dropdown';
-    };
-    isCta?: boolean;
-    children?: Array<{
-        label: string;
-        link: {
-            kind: 'page';
-            identifier: string;
-        } | {
-            kind: 'entry';
-            contentType: string;
-            identifier: string;
-        } | {
-            kind: 'external';
-            href: string;
-        } | {
-            kind: 'url';
-            href: string;
-        } | {
-            kind: 'portal';
-            path?: string;
-            labels?: {
-                loggedOut?: string;
-                loggedIn?: string;
-            };
-        } | {
-            kind: 'cart';
-            badge: 'show-count' | 'hidden';
-            label: {
-                kind: 'icon-only';
-            } | {
-                kind: 'icon-with-label';
-                label: string;
-            };
-        } | {
-            kind: 'dropdown';
-        };
-        isCta?: boolean;
-        children?: unknown[];
-    }>;
-}>;
+export declare const navigationItemConfigSchema: z.ZodType<NavigationConfigItemInput>;
 export declare const navigationMenuConfigSchema: z.ZodObject<{
     identifier: z.ZodString;
     name: z.ZodString;
     isPrimary: z.ZodOptional<z.ZodBoolean>;
     isFooter: z.ZodOptional<z.ZodBoolean>;
-    items: z.ZodArray<z.ZodType<{
+    items: z.ZodArray<z.ZodType<Readonly<{
         label: string;
-        link: {
-            kind: "page";
-            identifier: string;
-        } | {
-            kind: "entry";
-            contentType: string;
-            identifier: string;
-        } | {
-            kind: "external";
-            href: string;
-        } | {
-            kind: "url";
-            href: string;
-        } | {
-            kind: "portal";
-            path?: string;
-            labels?: {
-                loggedOut?: string;
-                loggedIn?: string;
-            };
-        } | {
-            kind: "cart";
-            badge: "show-count" | "hidden";
-            label: {
-                kind: "icon-only";
-            } | {
-                kind: "icon-with-label";
-                label: string;
-            };
-        } | {
-            kind: "dropdown";
-        };
+        link: import("../../../api/src/index").NavigationAuthoringLinkInput;
         isCta?: boolean;
-        children?: Array<{
-            label: string;
-            link: {
-                kind: "page";
-                identifier: string;
-            } | {
-                kind: "entry";
-                contentType: string;
-                identifier: string;
-            } | {
-                kind: "external";
-                href: string;
-            } | {
-                kind: "url";
-                href: string;
-            } | {
-                kind: "portal";
-                path?: string;
-                labels?: {
-                    loggedOut?: string;
-                    loggedIn?: string;
-                };
-            } | {
-                kind: "cart";
-                badge: "show-count" | "hidden";
-                label: {
-                    kind: "icon-only";
-                } | {
-                    kind: "icon-with-label";
-                    label: string;
-                };
-            } | {
-                kind: "dropdown";
-            };
-            isCta?: boolean;
-            children?: unknown[];
-        }>;
-    }, unknown, z.core.$ZodTypeInternals<{
+        children?: readonly NavigationConfigItemInput[];
+    }>, unknown, z.core.$ZodTypeInternals<Readonly<{
         label: string;
-        link: {
-            kind: "page";
-            identifier: string;
-        } | {
-            kind: "entry";
-            contentType: string;
-            identifier: string;
-        } | {
-            kind: "external";
-            href: string;
-        } | {
-            kind: "url";
-            href: string;
-        } | {
-            kind: "portal";
-            path?: string;
-            labels?: {
-                loggedOut?: string;
-                loggedIn?: string;
-            };
-        } | {
-            kind: "cart";
-            badge: "show-count" | "hidden";
-            label: {
-                kind: "icon-only";
-            } | {
-                kind: "icon-with-label";
-                label: string;
-            };
-        } | {
-            kind: "dropdown";
-        };
+        link: import("../../../api/src/index").NavigationAuthoringLinkInput;
         isCta?: boolean;
-        children?: Array<{
-            label: string;
-            link: {
-                kind: "page";
-                identifier: string;
-            } | {
-                kind: "entry";
-                contentType: string;
-                identifier: string;
-            } | {
-                kind: "external";
-                href: string;
-            } | {
-                kind: "url";
-                href: string;
-            } | {
-                kind: "portal";
-                path?: string;
-                labels?: {
-                    loggedOut?: string;
-                    loggedIn?: string;
-                };
-            } | {
-                kind: "cart";
-                badge: "show-count" | "hidden";
-                label: {
-                    kind: "icon-only";
-                } | {
-                    kind: "icon-with-label";
-                    label: string;
-                };
-            } | {
-                kind: "dropdown";
-            };
-            isCta?: boolean;
-            children?: unknown[];
-        }>;
-    }, unknown>>>;
+        children?: readonly NavigationConfigItemInput[];
+    }>, unknown>>>;
 }, z.core.$strip>;
 export declare const siteSettingsConfigSchema: z.ZodObject<{
     homepagePath: z.ZodOptional<z.ZodString>;

package/dist/_dts/sdk/src/config/field-definitions.d.ts

@@ -19,6 +19,18 @@ export type MediaDeliveryOptions = {
     strategy?: 'default' | 'columnsAuto' | 'imageGalleryVariant';
     strategyOptions?: Record<string, unknown>;
 };
+export type FieldVisibilityPredicate = {
+    field: string;
+    equals?: unknown;
+    notEquals?: unknown;
+    oneOf?: unknown[];
+    notIn?: unknown[];
+    minItems?: number;
+    maxItems?: number;
+};
+export type FieldVisibilityCondition = FieldVisibilityPredicate | {
+    allOf: FieldVisibilityPredicate[];
+};
 export type FieldUi = Partial<{
     widget: string;
     preset: 'disclosure';
@@ -48,13 +60,7 @@ export type FieldUi = Partial<{
     showValue: boolean;
     pattern: string;
     placeholder: string;
-    visibleWhen: {
-        field: string;
-        equals?: unknown;
-        notEquals?: unknown;
-        oneOf?: unknown[];
-        notIn?: unknown[];
-    };
+    visibleWhen: FieldVisibilityCondition;
     modalConfig: {
         buttonLabel?: string;
         description?: string;

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

@@ -65,6 +65,14 @@ export interface SdkConfigLoader {
     mode?: 'server' | 'client';
     when?: LoaderWhenValue;
 }
+export interface PreviewCustomizeManifestCuration {
+    /**
+     * Field IDs to consider for Preview Customize quick controls, in priority
+     * order. When `previewCustomize` is omitted, fields stay in the full
+     * Customize panel.
+     */
+    quickFieldPriority: string[];
+}
 export interface SdkCustomBlock {
     id: `custom.${string}`;
     title: string;
@@ -83,6 +91,7 @@ export interface SdkCustomBlock {
         description?: string;
         icon?: string;
     }>;
+    previewCustomize?: PreviewCustomizeManifestCuration;
 }
 /**
  * Allowed spacing values in section styles.

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

@@ -133,17 +133,17 @@ export declare const siteStyleConfigSchema: z.ZodOptional<z.ZodObject<{
  * Derived from SUPPORTED_LOADER_ENDPOINTS - the single source of truth.
  */
 export declare const sdkLoaderEndpointSchema: z.ZodEnum<{
-    listPublishedEntries: "listPublishedEntries";
-    getPublishedEntryPreview: "getPublishedEntryPreview";
+    getPublicFormById: "getPublicFormById";
+    getPublicBookingServices: "getPublicBookingServices";
     listPublicEvents: "listPublicEvents";
-    getPublicEventDetails: "getPublicEventDetails";
+    listPublicPasses: "listPublicPasses";
     listPublicCourses: "listPublicCourses";
     listPublicTeamMembers: "listPublicTeamMembers";
-    listPublicProducts: "listPublicProducts";
-    listPublicPasses: "listPublicPasses";
     listPublicMemberships: "listPublicMemberships";
-    getPublicFormById: "getPublicFormById";
-    getPublicBookingServices: "getPublicBookingServices";
+    listPublicProducts: "listPublicProducts";
+    getPublishedEntryPreview: "getPublishedEntryPreview";
+    listPublishedEntries: "listPublishedEntries";
+    getPublicEventDetails: "getPublicEventDetails";
 }>;
 export declare const loaderParamBindingSchema: z.ZodObject<{
     $bind: z.ZodObject<{
@@ -220,17 +220,17 @@ export declare const loaderWhenValueSchema: z.ZodUnion<readonly [z.ZodBoolean, z
  */
 export declare const sdkConfigLoaderSchema: z.ZodObject<{
     endpoint: z.ZodEnum<{
-        listPublishedEntries: "listPublishedEntries";
-        getPublishedEntryPreview: "getPublishedEntryPreview";
+        getPublicFormById: "getPublicFormById";
+        getPublicBookingServices: "getPublicBookingServices";
         listPublicEvents: "listPublicEvents";
-        getPublicEventDetails: "getPublicEventDetails";
+        listPublicPasses: "listPublicPasses";
         listPublicCourses: "listPublicCourses";
         listPublicTeamMembers: "listPublicTeamMembers";
-        listPublicProducts: "listPublicProducts";
-        listPublicPasses: "listPublicPasses";
         listPublicMemberships: "listPublicMemberships";
-        getPublicFormById: "getPublicFormById";
-        getPublicBookingServices: "getPublicBookingServices";
+        listPublicProducts: "listPublicProducts";
+        getPublishedEntryPreview: "getPublishedEntryPreview";
+        listPublishedEntries: "listPublishedEntries";
+        getPublicEventDetails: "getPublicEventDetails";
     }>;
     params: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodObject<{
         $bind: z.ZodObject<{
@@ -283,17 +283,17 @@ export declare const sdkConfigLoaderSchema: z.ZodObject<{
  */
 export declare const sdkDataLoadersSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
     endpoint: z.ZodEnum<{
-        listPublishedEntries: "listPublishedEntries";
-        getPublishedEntryPreview: "getPublishedEntryPreview";
+        getPublicFormById: "getPublicFormById";
+        getPublicBookingServices: "getPublicBookingServices";
         listPublicEvents: "listPublicEvents";
-        getPublicEventDetails: "getPublicEventDetails";
+        listPublicPasses: "listPublicPasses";
         listPublicCourses: "listPublicCourses";
         listPublicTeamMembers: "listPublicTeamMembers";
-        listPublicProducts: "listPublicProducts";
-        listPublicPasses: "listPublicPasses";
         listPublicMemberships: "listPublicMemberships";
-        getPublicFormById: "getPublicFormById";
-        getPublicBookingServices: "getPublicBookingServices";
+        listPublicProducts: "listPublicProducts";
+        getPublishedEntryPreview: "getPublishedEntryPreview";
+        listPublishedEntries: "listPublishedEntries";
+        getPublicEventDetails: "getPublicEventDetails";
     }>;
     params: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean, z.ZodObject<{
         $bind: z.ZodObject<{