@riverbankcms/sdk 0.123.0 → 0.125.0

package/dist/_dts/sdk/src/routing/entrySubroutes.d.ts

@@ -2,15 +2,16 @@
  * Entry subroute detection utilities.
  *
  * An "entry subroute" is a URL path with one extra segment under a content entry path:
- * - Parent entry: /courses/beginners
- * - Subroute URL: /courses/beginners/spring-2026
+ * - Parent entry: /events/yoga
+ * - Subroute URL: /events/yoga/2026-08-14
  *
  * Detection is intentionally generic:
  * - We parse the last segment.
  * - We validate segment shape from declared `segmentType`.
  * - We match the parent path against content type route patterns (when available).
  *
- * Resolution is performed by callers via `resolvePageContent({ resolveEntrySubroute })`.
+ * Event occurrence resolution is performed by callers via
+ * `resolvePageContent({ resolveSubroute })`.
  */
 import type { ContentTypeRoutingInfo } from './contentTypeResolver';
 type ContentTypeRoutingSubroute = NonNullable<ContentTypeRoutingInfo['subroutes']>[number];
@@ -26,7 +27,7 @@ export type ShouldAttemptEntrySubrouteArgs = {
     entryTypeKey: string | null;
     segment: string;
 };
-export type KnownEntrySubrouteKind = 'event-occurrence' | 'course-run';
+export type KnownEntrySubrouteKind = 'event-occurrence';
 /**
  * Parse a path into parent path and last segment.
  * Returns null when no parent/segment split exists.
@@ -47,7 +48,6 @@ export declare function isSubrouteSlugSegment(segment: string): boolean;
  * Default eligibility predicate for entry subroute resolution.
  *
  * - `event`: segment must be event-like (date or UUID)
- * - `course`: segment must be slug-like (`spring-2026`)
  * - `null`: used by fallback probing; keep it strict and only allow event-like segments
  * - others: not subroute-eligible
  */
@@ -57,7 +57,7 @@ export declare function defaultShouldAttemptEntrySubroute(args: ShouldAttemptEnt
  *
  * This is primarily used by SDK catch-all routing when local config does not
  * yet expose `routing.subroutes`, allowing generic resolver usage without
- * duplicating event/course-specific API calls.
+ * duplicating event-specific API calls.
  */
 export declare function inferKnownEntrySubrouteKind(args: ShouldAttemptEntrySubrouteArgs): KnownEntrySubrouteKind | null;
 export {};

package/dist/_dts/sdk/src/routing/index.d.ts

@@ -15,7 +15,5 @@ export type { EntrySubrouteCandidate, ShouldAttemptEntrySubrouteArgs, KnownEntry
 export { resolvePageContent } from './resolvePageContent';
 export { contentFound, contentLoadFailed, contentNotFound, RiverbankContentLoadError, } from './resolvePageContent';
 export type { OccurrenceData, EntrySubrouteData, LoadContentResult, PublicContentLoadError, PublicLoadStage, ResolvePageContentOptions, PageResolutionResult, RiverbankContentLoadErrorOptions, } from './resolvePageContent';
-export { resolveEntrySubrouteFromSegment } from './resolveEntrySubroute';
-export type { ResolveEntrySubrouteParams } from './resolveEntrySubroute';
 export { checkRedirectForPath } from './checkRedirect';
 export type { RedirectRule, RedirectResult, CheckRedirectParams, } from './checkRedirect';

package/dist/_dts/sdk/src/routing/resolveOccurrence.d.ts

@@ -32,9 +32,9 @@ export type ResolveOccurrenceParams = {
      */
     siteId: string;
     /**
-     * Parent content entry ID (the event entry)
+     * Event series IDs represented by the page authority.
      */
-    entryId: string;
+    eventSeriesIds: readonly [string, ...string[]];
     /**
      * URL segment to resolve - either a date (YYYY-MM-DD) or UUID
      */
@@ -56,7 +56,7 @@ export type ResolveOccurrenceParams = {
  *   const result = await resolveOccurrence({
  *     client,
  *     siteId: 'your-site-id',
- *     entryId: eventEntry.id,
+ *     eventSeriesIds: [pageSurface.subject.eventSeriesId],
  *     segment: params.occurrence, // e.g., "2025-01-15"
  *   });
  *

package/dist/_dts/sdk/src/routing/resolvePageContent.d.ts

@@ -7,20 +7,11 @@
  * Both SDK and frontend inject their own auth/loaders, but share the same resolution logic.
  */
 import type { ContentTypeRoutingInfo } from './contentTypeResolver';
-import type { ResolveEntrySubrouteResponse } from '../client/types';
-type ResolvedSubroute = NonNullable<ResolveEntrySubrouteResponse['subroute']>;
-export type OccurrenceData = Extract<ResolvedSubroute, {
-    kind: 'event-occurrence';
-}>['occurrence'];
-export type CourseRunData = Extract<ResolvedSubroute, {
-    kind: 'course-run';
-}>['run'];
+import type { ResolveEventOccurrenceResponse } from '../client/types';
+export type OccurrenceData = NonNullable<ResolveEventOccurrenceResponse['occurrence']>;
 export type EntrySubrouteData = {
     kind: 'event-occurrence';
     occurrence: OccurrenceData;
-} | {
-    kind: 'course-run';
-    run: CourseRunData;
 };
 export type PublicLoadStage = 'site_lookup' | 'content_lookup' | 'entry_subroute_lookup' | 'redirect_lookup' | 'content_normalization';
 export type PublicContentLoadError = {
@@ -98,42 +89,23 @@ export interface ResolvePageContentOptions<TContent> {
      * @returns Content load result
      */
     loadContent: (path: string) => Promise<LoadContentResult<TContent>>;
-    /**
-     * Resolve occurrence by entry ID and segment.
-     *
-     * @param entryId - The parent entry's ID
-     * @param segment - The occurrence segment (date or UUID)
-     * @returns Occurrence data if valid, null if invalid
-     */
-    resolveEntrySubroute: (args: {
-        entryId: string;
+    /** Resolve a subroute from the already-loaded parent page authority. */
+    resolveSubroute: (args: {
+        content: TContent;
         kind?: string | null;
-        entryTypeKey: string | null;
+        contentTypeKey: string | null;
         segment: string;
     }) => Promise<EntrySubrouteData | null>;
-    /**
-     * Check if content is an entry (vs a page).
-     * Used to determine if occurrence resolution is applicable.
-     */
-    isEntry: (content: TContent) => boolean;
-    /**
-     * Get the entry ID from content.
-     * Only called when isEntry returns true.
-     */
-    getEntryId: (content: TContent) => string;
-    /**
-     * Get the entry type key (content type key/slug) from content.
-     * Only called when isEntry returns true.
-     */
-    getEntryTypeKey: (content: TContent) => string | null;
+    /** Read the content type key for routing policy, regardless of owner kind. */
+    getContentTypeKey: (content: TContent) => string | null;
     /**
      * Optional optimization hook: decide whether to attempt subroute resolution
      * based on the content type and segment, before loading the parent content.
      *
      * If omitted, subroute resolution is attempted whenever the URL matches an
-     * occurrence pattern (event) or the fallback extractor (CMS-only types).
+     * event-occurrence pattern or the fallback extractor.
      */
-    shouldAttemptEntrySubroute?: (args: {
+    shouldAttemptSubroute?: (args: {
         entryTypeKey: string | null;
         segment: string;
     }) => boolean;
@@ -185,4 +157,3 @@ export type PageResolutionResult<TContent> = {
  * @returns Resolution result indicating success or failure
  */
 export declare function resolvePageContent<TContent>(options: ResolvePageContentOptions<TContent>): Promise<PageResolutionResult<TContent>>;
-export {};

package/dist/_dts/sdk/src/types/block-kinds.d.ts

@@ -7,7 +7,7 @@
  * `@riverbankcms/blocks` (which is not a public dependency). This list is a
  * stable public contract; keep it in sync with the internal blocks runtime.
  */
-export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.contact-newsletter", "block.appointment-booking", "block.weekly-slot-availability", "block.event-registration", "block.event-details", "block.course-registration", "block.course-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.recurring-schedule", "block.offerings-preview", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
+export declare const SYSTEM_BLOCK_KINDS: readonly ["block.hero", "block.intro", "block.columns", "block.collection", "block.feature-cards", "block.media-text", "block.cta-full", "block.single-button", "block.body-text", "block.location-map", "block.faq", "block.testimonials", "block.team-members", "block.embed", "block.blog-post", "block.blog-listing", "block.site-header", "block.site-footer", "block.form", "block.contact-newsletter", "block.appointment-booking", "block.weekly-slot-availability", "block.event-registration", "block.event-details", "block.event-spotlight", "block.event-listing", "block.event-calendar", "block.recurring-schedule", "block.offerings-preview", "block.shop", "block.product-list", "block.product-detail", "block.cart", "block.checkout", "block.gifting", "block.newsletter-signup", "block.image-gallery", "block.video-grid", "block.audio-player", "block.file-download"];
 export type SystemBlockKind = (typeof SYSTEM_BLOCK_KINDS)[number];
 export type CustomBlockKind = `custom.${string}`;
 export type BlockKind = SystemBlockKind | CustomBlockKind;

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.123.0";
+export declare const SDK_VERSION = "0.125.0";

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

@@ -1,5 +1,5 @@
 import type { Result, SiteId } from '../../core/src/index';
-import type { SiteCommand } from './commands';
+import type { SiteCommand } from './commandContract';
 import type { AllowedRuntime, SiteCommandResourceIds } from './domain';
 import type { SiteCommandRef } from './refs';
 export type SiteCommandExecutionContext = Readonly<{

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

@@ -0,0 +1,100 @@
+import { z } from 'zod';
+import { type AppointmentAvailabilityRef, type AppointmentResourceRef, type AppointmentServiceRef, type CommandRef } from './refs';
+export declare const upsertAppointmentServiceCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"upsertAppointmentService">;
+    ref: z.ZodPipe<z.ZodString, z.ZodTransform<AppointmentServiceRef, string>>;
+    input: z.ZodUnion<readonly [z.ZodObject<{
+        priceAmount: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        payment: z.ZodDefault<z.ZodObject<{
+            mode: z.ZodLiteral<"manual_request">;
+        }, z.core.$strict>>;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        durationMinutes: z.ZodNumber;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        locationType: z.ZodDefault<z.ZodEnum<{
+            virtual: "virtual";
+            in_person: "in_person";
+            hybrid: "hybrid";
+        }>>;
+        timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        buffers: z.ZodOptional<z.ZodObject<{
+            beforeMinutes: z.ZodDefault<z.ZodNumber>;
+            afterMinutes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        priceAmount: z.ZodOptional<z.ZodNull>;
+        payment: z.ZodObject<{
+            mode: z.ZodLiteral<"free">;
+        }, z.core.$strict>;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        durationMinutes: z.ZodNumber;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        locationType: z.ZodDefault<z.ZodEnum<{
+            virtual: "virtual";
+            in_person: "in_person";
+            hybrid: "hybrid";
+        }>>;
+        timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        buffers: z.ZodOptional<z.ZodObject<{
+            beforeMinutes: z.ZodDefault<z.ZodNumber>;
+            afterMinutes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>, z.ZodObject<{
+        priceAmount: z.ZodNumber;
+        payment: z.ZodObject<{
+            mode: z.ZodLiteral<"paid_online_intent">;
+        }, z.core.$strict>;
+        title: z.ZodString;
+        description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        durationMinutes: z.ZodNumber;
+        isActive: z.ZodDefault<z.ZodBoolean>;
+        locationType: z.ZodDefault<z.ZodEnum<{
+            virtual: "virtual";
+            in_person: "in_person";
+            hybrid: "hybrid";
+        }>>;
+        timezone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        buffers: z.ZodOptional<z.ZodObject<{
+            beforeMinutes: z.ZodDefault<z.ZodNumber>;
+            afterMinutes: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>]>;
+}, z.core.$strict>;
+export declare const upsertBookableResourceCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"upsertBookableResource">;
+    ref: z.ZodPipe<z.ZodString, z.ZodTransform<AppointmentResourceRef, string>>;
+    input: z.ZodObject<{
+        displayName: z.ZodString;
+        bio: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        timezone: z.ZodString;
+        colorHex: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        kind: z.ZodDefault<z.ZodLiteral<"practitioner">>;
+        capacity: z.ZodDefault<z.ZodLiteral<1>>;
+        publicVisibility: z.ZodDefault<z.ZodLiteral<"visible">>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const assignAppointmentServiceResourcesCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"assignAppointmentServiceResources">;
+    ref: z.ZodPipe<z.ZodString, z.ZodTransform<CommandRef, string>>;
+    input: z.ZodObject<{
+        serviceRef: z.ZodPipe<z.ZodString, z.ZodTransform<AppointmentServiceRef, string>>;
+        resourceRefs: z.ZodReadonly<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<AppointmentResourceRef, string>>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export declare const configureAppointmentAvailabilityCommandSchema: z.ZodObject<{
+    type: z.ZodLiteral<"configureAppointmentAvailability">;
+    ref: z.ZodPipe<z.ZodString, z.ZodTransform<AppointmentAvailabilityRef, string>>;
+    input: z.ZodObject<{
+        resourceRef: z.ZodPipe<z.ZodString, z.ZodTransform<AppointmentResourceRef, string>>;
+        serviceRef: z.ZodOptional<z.ZodNullable<z.ZodPipe<z.ZodString, z.ZodTransform<AppointmentServiceRef, string>>>>;
+        timezone: z.ZodString;
+        replaceScope: z.ZodDefault<z.ZodLiteral<"schedule">>;
+        windows: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            weekday: z.ZodNumber;
+            startTime: z.ZodString;
+            endTime: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>;
+}, z.core.$strict>;

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

@@ -1,8 +1,8 @@
-export declare const staticExecutionGapCodes: readonly ["event_occurrence_required", "event_ticket_single_occurrence_scope_unsupported", "event_manual_payment_unsupported", "event_external_payment_unsupported", "event_waitlist_requires_waitlist_adapter", "event_media_content_requires_media_adapter", "event_linked_content_requires_content_adapter", "event_delivery_mode_requires_booking_surface_adapter", "course_manual_payment_unsupported", "course_external_payment_unsupported", "course_waitlist_requires_waitlist_adapter", "course_staff_assignment_unsupported"];
+export declare const staticExecutionGapCodes: readonly ["event_occurrence_required", "event_ticket_single_occurrence_scope_unsupported", "event_manual_payment_unsupported", "event_external_payment_unsupported", "event_waitlist_requires_waitlist_adapter", "event_media_content_requires_media_adapter", "event_linked_content_requires_content_adapter", "event_delivery_mode_requires_booking_surface_adapter", "event_whole_series_page_fields_unsupported", "event_whole_series_passes_unsupported", "event_whole_series_pricing_unsupported", "event_whole_series_schedule_update_unsupported", "event_whole_series_staff_update_unsupported"];
 export type StaticExecutionGapCode = (typeof staticExecutionGapCodes)[number];
 export declare const plannerCapabilityGapCodes: readonly ["command_metadata_support_gap"];
 export type PlannerCapabilityGapCode = (typeof plannerCapabilityGapCodes)[number];
 export declare const adapterCapabilityGapCodes: readonly ["demo_recipe_adapter_missing", "media_manifest_storage_resolution_missing", "navigation_content_entry_refs_unsupported", "staff_site_user_requires_dashboard_user", "team_member_profile_requires_dashboard_user", "generated_navigation_command_unsupported"];
 export type AdapterCapabilityGapCode = (typeof adapterCapabilityGapCodes)[number];
-export declare const siteCommandCapabilityGapCodes: readonly ["event_occurrence_required", "event_ticket_single_occurrence_scope_unsupported", "event_manual_payment_unsupported", "event_external_payment_unsupported", "event_waitlist_requires_waitlist_adapter", "event_media_content_requires_media_adapter", "event_linked_content_requires_content_adapter", "event_delivery_mode_requires_booking_surface_adapter", "course_manual_payment_unsupported", "course_external_payment_unsupported", "course_waitlist_requires_waitlist_adapter", "course_staff_assignment_unsupported", "command_metadata_support_gap", "demo_recipe_adapter_missing", "media_manifest_storage_resolution_missing", "navigation_content_entry_refs_unsupported", "staff_site_user_requires_dashboard_user", "team_member_profile_requires_dashboard_user", "generated_navigation_command_unsupported"];
+export declare const siteCommandCapabilityGapCodes: readonly ["event_occurrence_required", "event_ticket_single_occurrence_scope_unsupported", "event_manual_payment_unsupported", "event_external_payment_unsupported", "event_waitlist_requires_waitlist_adapter", "event_media_content_requires_media_adapter", "event_linked_content_requires_content_adapter", "event_delivery_mode_requires_booking_surface_adapter", "event_whole_series_page_fields_unsupported", "event_whole_series_passes_unsupported", "event_whole_series_pricing_unsupported", "event_whole_series_schedule_update_unsupported", "event_whole_series_staff_update_unsupported", "command_metadata_support_gap", "demo_recipe_adapter_missing", "media_manifest_storage_resolution_missing", "navigation_content_entry_refs_unsupported", "staff_site_user_requires_dashboard_user", "team_member_profile_requires_dashboard_user", "generated_navigation_command_unsupported"];
 export type SiteCommandCapabilityGapCode = (typeof siteCommandCapabilityGapCodes)[number];