@riverbankcms/sdk 0.129.1 → 0.130.2

package/dist/_dts/api/src/sdk-event-upsert.d.ts

@@ -1,7 +1,8 @@
-import type { SdkEntryUpsertSlotBlock, SdkEventContentInput, SdkPullEventSeries, SdkEventUpsertPaymentTermsInput, SdkEventUpsertPricingInput, SdkEventUpsertScheduleInput } from './sdkContracts';
+import type { SdkEntryUpsertSlotBlock, SdkEventContentInput, SdkPullEvent, SdkPullEventRun, SdkEventUpsertPaymentTermsInput, SdkEventUpsertPricingInput, SdkEventUpsertScheduleInput } from './sdkContracts';
+import { type BookingTimeZone, type UtcIsoDateTimeString } from '../../core/src/index';
 import { type SdkEventPaymentTerms, type SdkEventPaymentTermsIssue } from './sdk-event-payment-terms';
 import { type SdkEventPricing, type SdkEventPricingIssue } from './sdk-event-pricing';
-import { type ClassifySdkEventScheduleOptions, type SdkEventCanonicalSchedule, type SdkEventScheduleInput, type SdkEventScheduleIssue } from './sdk-event-schedule';
+import { type ClassifySdkEventScheduleOptions, type SdkEventCanonicalSchedule } from './sdk-event-schedule';
 import { z } from 'zod';
 export declare const sdkEventOccurrenceInputSchema: z.ZodObject<{
     startsAt: z.ZodString;
@@ -25,6 +26,7 @@ export declare const sdkEventUpsertOptionalFieldSchemas: {
     readonly preset: z.ZodOptional<z.ZodEnum<{
         course: "course";
         event: "event";
+        term: "term";
         performance: "performance";
         class: "class";
         workshop: "workshop";
@@ -41,55 +43,135 @@ export declare const sdkEventUpsertOptionalFieldSchemas: {
     }, z.core.$strip>>>;
     readonly capacity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 };
-export type SdkEventUpsertBody = Readonly<{
+export type SdkEventBookingScope = SdkPullEventRun['bookingScope'];
+export type SdkEventOccurrenceInput = Readonly<{
+    startsAt: string;
+    endsAt: string;
+    timeZone: string;
+}>;
+export type ValidatedSdkEventOccurrence = Readonly<{
+    startsAt: UtcIsoDateTimeString;
+    endsAt: UtcIsoDateTimeString;
+    timeZone: BookingTimeZone;
+}>;
+export type NonEmptySdkEventOccurrences = readonly [
+    ValidatedSdkEventOccurrence,
+    ...ValidatedSdkEventOccurrence[]
+];
+export type SdkEventTimingAuthority = Readonly<{
+    kind: 'authored_schedule';
+    schedule: SdkEventCanonicalSchedule;
+    bookingScope?: SdkEventBookingScope;
+}> | Readonly<{
+    kind: 'explicit_occurrences';
+    bookingScope: SdkEventBookingScope;
+    occurrences: NonEmptySdkEventOccurrences;
+    timeZone: BookingTimeZone;
+}>;
+export type SdkEventTimingIssue = Readonly<{
+    path: readonly string[];
+    message: string;
+}>;
+export type SdkEventTimingClassification = Readonly<{
+    ok: true;
+    timingAuthority: SdkEventTimingAuthority;
+}> | Readonly<{
+    ok: false;
+    issues: readonly SdkEventTimingIssue[];
+}>;
+type SdkEventRunUpsertCommon = Readonly<{
     identifier: string;
-    title: string;
-    slug: string;
-    path?: string | null;
-    status?: SdkPullEventSeries['status'];
-    visibility?: SdkPullEventSeries['visibility'];
-    preset?: SdkPullEventSeries['preset'];
-    bookingScope?: SdkPullEventSeries['bookingScope'];
-    occurrences?: SdkPullEventSeries['occurrences'];
-    schedule: SdkEventUpsertScheduleInput;
+    eventRef: string;
+    name?: string | null;
+    status?: SdkPullEventRun['status'];
+    visibility?: SdkPullEventRun['visibility'];
     capacity?: number | null;
     pricing?: SdkEventUpsertPricingInput;
     paymentTerms?: SdkEventUpsertPaymentTermsInput;
     venueRef?: string | null;
     categoryRef?: string | null;
-    content?: SdkEventContentInput;
     formRef?: string | null;
     settings?: Record<string, unknown>;
     presentation?: Record<string, unknown> | null;
     tags?: string[];
+}>;
+type SdkEventRunAuthoredScheduleInput = Readonly<{
+    schedule: SdkEventUpsertScheduleInput;
+    occurrences?: readonly [];
+    bookingScope?: SdkEventBookingScope;
+}>;
+type SdkEventRunExplicitOccurrencesInput = Readonly<{
+    occurrences: readonly [SdkEventOccurrenceInput, ...SdkEventOccurrenceInput[]];
+    bookingScope: SdkEventBookingScope;
+    schedule?: SdkEventUpsertScheduleInput;
+}>;
+export type SdkEventRunUpsertBody = SdkEventRunUpsertCommon & (SdkEventRunAuthoredScheduleInput | SdkEventRunExplicitOccurrencesInput);
+export type SdkEventUpsertBody = Readonly<{
+    identifier: string;
+    administrativeStatus?: SdkPullEvent['administrativeStatus'];
+    title: string;
+    slug: string;
+    path?: string | null;
+    preset: SdkPullEvent['preset'];
+    runRefs: readonly [string, ...string[]];
+    content?: SdkEventContentInput;
     blocks?: Record<string, SdkEntryUpsertSlotBlock[]>;
+    runs: readonly [SdkEventRunUpsertBody, ...SdkEventRunUpsertBody[]];
 }>;
-export type ValidatedSdkEventUpsertInput = Omit<SdkEventUpsertBody, 'schedule' | 'pricing'> & Readonly<{
-    schedule: SdkEventCanonicalSchedule;
+export type ValidatedSdkEventRunUpsertInput = Omit<SdkEventRunUpsertCommon, 'pricing' | 'paymentTerms'> & Readonly<{
+    timingAuthority: SdkEventTimingAuthority;
     pricing?: SdkEventPricing;
     paymentTerms?: SdkEventPaymentTerms;
 }>;
-export type SdkEventUpsertParseInput = Omit<SdkEventUpsertBody, 'schedule' | 'pricing' | 'paymentTerms'> & Readonly<{
-    schedule: SdkEventScheduleInput;
+export type SdkEventRunUpsertParseInput = Omit<SdkEventRunUpsertCommon, 'pricing' | 'paymentTerms'> & Readonly<{
+    schedule?: unknown;
+    occurrences?: readonly SdkEventOccurrenceInput[];
+    bookingScope?: SdkEventBookingScope;
     pricing?: unknown;
     paymentTerms?: unknown;
 }>;
+/** Legacy flat-series parser input retained for internal command adapters. */
+export type SdkEventUpsertParseInput = Omit<SdkEventRunUpsertParseInput, 'identifier' | 'eventRef'> & Readonly<{
+    identifier: string;
+    title: string;
+    slug: string;
+    path?: string | null;
+    preset?: SdkPullEvent['preset'];
+    content?: SdkEventContentInput;
+    blocks?: Record<string, SdkEntryUpsertSlotBlock[]>;
+}>;
 export type SdkEventUpsertValidationIssue = Readonly<{
-    source: 'schedule';
+    source: 'graph';
     path: readonly string[];
     message: string;
-    issue: SdkEventScheduleIssue;
+    issue: Readonly<{
+        kind: 'incoherentParentRunGraph';
+    }>;
 }> | Readonly<{
+    runIndex: number;
+    source: 'timing';
+    path: readonly string[];
+    message: string;
+    issue: SdkEventTimingIssue;
+}> | Readonly<{
+    runIndex: number;
     source: 'pricing';
     path: readonly string[];
     message: string;
     issue: SdkEventPricingIssue;
 }> | Readonly<{
+    runIndex: number;
     source: 'paymentTerms';
     path: readonly string[];
     message: string;
     issue: SdkEventPaymentTermsIssue;
 }>;
+export type ValidatedSdkEventUpsertInput = Omit<SdkEventUpsertBody, 'runs'> & Readonly<{
+    runs: readonly [
+        ValidatedSdkEventRunUpsertInput,
+        ...ValidatedSdkEventRunUpsertInput[]
+    ];
+}>;
 export type SdkEventUpsertValidationResult = Readonly<{
     ok: true;
     value: ValidatedSdkEventUpsertInput;
@@ -100,4 +182,16 @@ export type SdkEventUpsertValidationResult = Readonly<{
 export type ParseSdkEventUpsertInputOptions = Readonly<{
     schedule?: ClassifySdkEventScheduleOptions;
 }>;
-export declare function parseSdkEventUpsertInput(input: SdkEventUpsertParseInput, options?: ParseSdkEventUpsertInputOptions): SdkEventUpsertValidationResult;
+export declare function classifySdkEventTiming(input: Readonly<{
+    schedule?: unknown;
+    bookingScope?: SdkEventBookingScope;
+    occurrences?: readonly SdkEventOccurrenceInput[];
+}>, options?: ClassifySdkEventScheduleOptions): SdkEventTimingClassification;
+export declare function parseSdkEventUpsertInput(input: Omit<SdkEventUpsertBody, 'runs'> & Readonly<{
+    runs: readonly [
+        SdkEventRunUpsertParseInput,
+        ...SdkEventRunUpsertParseInput[]
+    ];
+}>, options?: ParseSdkEventUpsertInputOptions): SdkEventUpsertValidationResult;
+export declare function toSdkEventUpsertBody(input: ValidatedSdkEventUpsertInput): SdkEventUpsertBody;
+export {};

package/dist/_dts/api/src/sdkBlockUpsertContracts.d.ts

@@ -0,0 +1,48 @@
+import { z } from 'zod';
+import { type AppearancePresetId } from '../../theme-core/src/site-styles/index';
+export type SdkBlockAppearanceChoice = Readonly<{
+    kind: 'pinned';
+    appearancePresetId: AppearancePresetId;
+}> | Readonly<{
+    kind: 'automatic';
+}>;
+export type SdkBlockAppearanceOutcome = Readonly<{
+    kind: 'applied';
+    choice: SdkBlockAppearanceChoice;
+    effect: 'updated' | 'unchanged';
+}> | Readonly<{
+    kind: 'not-applied';
+    code: 'STALE_PAGE_DESIGN_STATE' | 'SAVE_PAGE_DESIGN_STATE_FAILED';
+    message: string;
+    retryable: true;
+}>;
+export type SdkBlockUpsertResponseFields<TWarning> = Readonly<{
+    warnings?: TWarning[];
+    /**
+     * Present only when appearance intent was explicit. Validation detected
+     * before the block write rejects the request; failures after a durable block
+     * write return HTTP 200 here as a retryable partial outcome.
+     */
+    appearance?: SdkBlockAppearanceOutcome;
+}>;
+export declare const sdkBlockAppearanceOutcomeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"applied">;
+    choice: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"pinned">;
+        appearancePresetId: z.ZodPipe<z.ZodString, z.ZodTransform<AppearancePresetId, string>>;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"automatic">;
+    }, z.core.$strip>], "kind">;
+    effect: z.ZodEnum<{
+        updated: "updated";
+        unchanged: "unchanged";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    kind: z.ZodLiteral<"not-applied">;
+    code: z.ZodEnum<{
+        STALE_PAGE_DESIGN_STATE: "STALE_PAGE_DESIGN_STATE";
+        SAVE_PAGE_DESIGN_STATE_FAILED: "SAVE_PAGE_DESIGN_STATE_FAILED";
+    }>;
+    message: z.ZodString;
+    retryable: z.ZodLiteral<true>;
+}, z.core.$strip>], "kind">;

package/dist/_dts/api/src/sdkContracts.d.ts

@@ -1,14 +1,19 @@
 import type { BlockContentSource, BlockContentSourceKind, FieldDefinition, FieldDefinitionInput, SdkCustomBlock, SdkCustomBlockInput, Theme } from '../../blocks/src/index';
 import type { ContentTypeSchema } from '../../content-model/src/index';
 import type { FooterCompositionV1, RichTextDoc } from '../../core/src/index';
+export type { SdkBlockAppearanceChoice, SdkBlockAppearanceOutcome } from './sdkBlockUpsertContracts';
 import type { LinkPayload } from './navigation/types';
 import type { JsonValue } from './shared-contracts';
 import type { SdkEventPricing, SdkEventPricingInput } from './sdk-event-pricing';
 import type { SdkEventPaymentTerms, SdkEventPaymentTermsInput } from './sdk-event-payment-terms';
-import type { EventOccurrenceStatus } from './bookingRecords';
+import type { SdkPullEventOccurrence } from './sdk-event-schedule';
 import type { SiteCommandApplicationResult } from '@riverbankcms/site-commands';
 import type { EventPreset } from './bookingConfig';
 import type { SdkThemeWire } from './sdkThemeWire';
+import type { SdkPullEventCategory } from './sdkEventCategoryContracts';
+export type { SdkPullEventCategory } from './sdkEventCategoryContracts';
+import type { SdkManagementEvent, SdkManagementEventOccurrence, SdkManagementEventRun } from './sdkManagedEventContracts';
+export type { SdkEventOccurrenceDeletionEligibility, SdkEventOccurrenceProvenance, SdkManagementEvent, SdkManagementEventOccurrence, SdkManagementEventRun, } from './sdkManagedEventContracts';
 /**
  * SDK Site Configuration Types
  *
@@ -580,9 +585,9 @@ export interface SdkCatalogSiteStyle {
      * `typography` object per style, not a preset-choice list (see deviation notes).
      */
     typography: Theme['typography'];
-    /** Canonical header layout+style pair (replaces the older single `defaultHeaderSelection` look id). */
+    /** Canonical header layout+style pair. */
     defaultHeaderSelection: SdkCatalogHeaderLayoutStyleChoice;
-    recommendedHeaderLookIds: string[];
+    recommendedHeaderSelections: SdkCatalogHeaderLayoutStyleChoice[];
     recommendedFooterLookIds: string[];
 }
 export interface SdkCatalogButtonStyleSelection {
@@ -632,9 +637,7 @@ export interface SdkCatalogCurrentSelection {
     /** The curated site style the active theme was compiled from (null when unknown). */
     siteStyleId: string | null;
     buttonStyleSelection: SdkCatalogButtonStyleSelection | null;
-    headerLayoutId: string | null;
-    headerStyleId: string | null;
-    headerLookId: string | null;
+    headerSelection: SdkCatalogHeaderLayoutStyleChoice | null;
     footerLookId: string | null;
 }
 export interface SdkCatalogThemeResponse {
@@ -642,7 +645,6 @@ export interface SdkCatalogThemeResponse {
     buttonStyles: SdkCatalogButtonStyle[];
     palettes: SdkCatalogPalette[];
     typographyPresets: SdkCatalogTypographyPreset[];
-    headerLookIds: string[];
     footerLookIds: string[];
     headerLayoutIds: string[];
     headerStyleIds: string[];
@@ -829,44 +831,18 @@ export interface SdkPullVenuesResponse {
     venues: SdkPullVenue[];
     meta: SdkPullMeta;
 }
-export interface SdkPullEventCategory {
-    identifier: string;
-    name: string;
-    description: string | null;
-    color: string | null;
-    sortOrder: number;
-    updatedAt: string;
-    createdAt: string;
-}
 export interface SdkPullEventCategoriesResponse {
     eventCategories: SdkPullEventCategory[];
     meta: SdkPullMeta;
 }
-export interface SdkPullEventSeries {
+export interface SdkPullEvent {
     identifier: string;
+    administrativeStatus: 'active' | 'archived';
     title: string;
     slug: string;
     path: string | null;
-    /**
-     * Mirrors `event_series.status` from the bookings system.
-     *
-     * IMPORTANT: This must be roundtrip-safe for SDK pull -> push workflows.
-     */
-    status: 'draft' | 'active' | 'archived' | 'cancelled' | 'completed';
-    /**
-     * Mirrors `event_series.visibility` from the bookings system.
-     *
-     * IMPORTANT: This must be roundtrip-safe for SDK pull -> push workflows.
-     */
-    visibility: 'private' | 'public' | 'unlisted';
     preset: EventPreset;
-    bookingScope: 'single_occurrence' | 'whole_series';
-    occurrences: readonly SdkPullEventOccurrence[];
-    capacity: number | null;
-    pricing: SdkEventPricing;
-    paymentTerms?: SdkEventPaymentTerms;
-    venueRef: string | null;
-    categoryRef: string | null;
+    runRefs: readonly [string, ...string[]];
     content: {
         summary?: string;
         body?: RichTextDoc;
@@ -875,20 +851,32 @@ export interface SdkPullEventSeries {
         };
         [key: string]: unknown;
     };
+    updatedAt: string;
+    createdAt: string;
+    contentUpdatedAt: string | null;
+    blocks?: SdkEntrySlotBlocks;
+}
+export interface SdkPullEventRun {
+    identifier: string;
+    eventRef: string;
+    name: string | null;
+    status: 'draft' | 'active' | 'archived' | 'cancelled' | 'completed';
+    visibility: 'private' | 'public' | 'unlisted';
+    bookingScope: 'single_occurrence' | 'whole_series';
+    occurrences: readonly SdkPullEventOccurrence[];
+    capacity: number | null;
+    pricing: SdkEventPricing;
+    paymentTerms?: SdkEventPaymentTerms;
+    venueRef: string | null;
+    categoryRef: string | null;
     formRef: string | null;
     settings: Record<string, unknown>;
     presentation: Record<string, unknown> | null;
     tags: string[];
     updatedAt: string;
     createdAt: string;
-    contentUpdatedAt: string | null;
-    blocks?: SdkEntrySlotBlocks;
 }
-export type SdkPullEventOccurrence = Readonly<{
-    startsAt: string;
-    endsAt: string;
-    timeZone: string;
-}>;
+export type { SdkPullEventOccurrence } from './sdk-event-schedule';
 export type SdkEventContentInput = {
     summary?: string;
     body?: string | RichTextDoc;
@@ -926,7 +914,8 @@ export type SdkEventUpsertScheduleInput = SdkEventCanonicalScheduleInput | SdkEv
 export type SdkEventUpsertPricingInput = SdkEventPricingInput;
 export type SdkEventUpsertPaymentTermsInput = SdkEventPaymentTermsInput;
 export interface SdkPullEventsResponse {
-    events: SdkPullEventSeries[];
+    events: SdkPullEvent[];
+    eventRuns: SdkPullEventRun[];
     meta: SdkPullMeta;
 }
 export interface SdkPulledEntry {
@@ -1038,34 +1027,6 @@ export type SdkManagementVenue = SdkPullVenue & {
 export type SdkManagementEventCategory = SdkPullEventCategory & {
     id: string;
 };
-export type SdkManagementEventSeries = SdkPullEventSeries & {
-    id: string;
-    schedule: SdkEventCanonicalScheduleInput;
-};
-export type SdkEventOccurrenceProvenance = 'manual' | 'recurrence_generated' | 'recurrence_exception';
-export type SdkEventOccurrenceDeletionEligibility = {
-    kind: 'allowed';
-} | {
-    kind: 'blocked_by_registrations';
-    registrations: number;
-} | {
-    kind: 'blocked_generated_occurrence';
-} | {
-    kind: 'blocked_completed_occurrence';
-};
-export interface SdkManagementEventOccurrence {
-    id: string;
-    seriesId: string;
-    startsAt: string;
-    endsAt: string;
-    timeZone: string;
-    status: EventOccurrenceStatus;
-    provenance: SdkEventOccurrenceProvenance;
-    capacityOverride: number | null;
-    capacity: number | null;
-    registrations: number;
-    deletionEligibility: SdkEventOccurrenceDeletionEligibility;
-}
 export type SdkEventOccurrenceScheduleInput = {
     startsAt: string;
     endsAt: string;
@@ -1117,10 +1078,7 @@ export interface SdkPullDraftsResponse {
     };
     meta: SdkPullMeta;
 }
-export type SdkUpsertBlockResponse = SdkCommandApplicationResult<SdkManagementBlock> & {
-    /** Non-blocking content warnings (e.g. theme-unavailable button variants). */
-    warnings?: SdkBlockContentWarning[];
-};
+export type SdkUpsertBlockResponse = SdkCommandApplicationResult<SdkManagementBlock> & import('./sdkBlockUpsertContracts').SdkBlockUpsertResponseFields<SdkBlockContentWarning>;
 export type SdkDeleteResponse = SdkCommandApplicationResult<Readonly<{
     deleted: true;
 }>>;
@@ -1205,11 +1163,17 @@ export interface SdkGetEventCategoryResponse {
     eventCategory: SdkManagementEventCategory;
 }
 export interface SdkListEventsResponse {
-    events: SdkManagementEventSeries[];
+    events: SdkManagementEvent[];
+    eventRuns: SdkManagementEventRun[];
 }
-export type SdkUpsertEventResponse = SdkCommandApplicationResult<SdkManagementEventSeries>;
+export type SdkManagementEventGraph = Readonly<{
+    event: SdkManagementEvent;
+    runs: readonly [SdkManagementEventRun, ...SdkManagementEventRun[]];
+}>;
+export type SdkUpsertEventResponse = SdkCommandApplicationResult<SdkManagementEventGraph>;
 export interface SdkGetEventResponse {
-    event: SdkManagementEventSeries;
+    event: SdkManagementEvent;
+    runs: readonly [SdkManagementEventRun, ...SdkManagementEventRun[]];
 }
 export interface SdkListEventOccurrencesResponse {
     occurrences: SdkManagementEventOccurrence[];

package/dist/_dts/api/src/sdkEventCategoryContracts.d.ts

@@ -0,0 +1,9 @@
+export interface SdkPullEventCategory {
+    identifier: string;
+    name: string;
+    description: string | null;
+    color: string | null;
+    sortOrder: number;
+    updatedAt: string;
+    createdAt: string;
+}

package/dist/_dts/api/src/sdkManagedEventContracts.d.ts

@@ -0,0 +1,35 @@
+import type { EventOccurrenceStatus } from './bookingRecords';
+import type { EventOfferingId, EventSeriesId, OccurrenceId } from '../../core/src/index';
+import type { SdkEventCanonicalScheduleInput, SdkPullEvent, SdkPullEventRun } from './sdkContracts';
+export type SdkManagementEvent = SdkPullEvent & {
+    id: EventOfferingId;
+};
+export type SdkManagementEventRun = SdkPullEventRun & {
+    id: EventSeriesId;
+    eventId: EventOfferingId;
+    schedule: SdkEventCanonicalScheduleInput;
+};
+export type SdkEventOccurrenceProvenance = 'manual' | 'recurrence_generated' | 'recurrence_exception';
+export type SdkEventOccurrenceDeletionEligibility = {
+    kind: 'allowed';
+} | {
+    kind: 'blocked_by_registrations';
+    registrations: number;
+} | {
+    kind: 'blocked_generated_occurrence';
+} | {
+    kind: 'blocked_completed_occurrence';
+};
+export interface SdkManagementEventOccurrence {
+    id: OccurrenceId;
+    seriesId: EventSeriesId;
+    startsAt: string;
+    endsAt: string;
+    timeZone: string;
+    status: EventOccurrenceStatus;
+    provenance: SdkEventOccurrenceProvenance;
+    capacityOverride: number | null;
+    capacity: number | null;
+    registrations: number;
+    deletionEligibility: SdkEventOccurrenceDeletionEligibility;
+}