@riverbankcms/sdk 0.129.1 → 0.130.0

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;
@@ -41,55 +42,134 @@ 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;
+    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 +180,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/sdkContracts.d.ts

@@ -5,10 +5,12 @@ 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 { SdkManagementEvent, SdkManagementEventOccurrence, SdkManagementEventRun } from './sdkManagedEventContracts';
+export type { SdkEventOccurrenceDeletionEligibility, SdkEventOccurrenceProvenance, SdkManagementEvent, SdkManagementEventOccurrence, SdkManagementEventRun, } from './sdkManagedEventContracts';
 /**
  * SDK Site Configuration Types
  *
@@ -580,9 +582,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 +634,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 +642,6 @@ export interface SdkCatalogThemeResponse {
     buttonStyles: SdkCatalogButtonStyle[];
     palettes: SdkCatalogPalette[];
     typographyPresets: SdkCatalogTypographyPreset[];
-    headerLookIds: string[];
     footerLookIds: string[];
     headerLayoutIds: string[];
     headerStyleIds: string[];
@@ -842,31 +841,13 @@ export interface SdkPullEventCategoriesResponse {
     eventCategories: SdkPullEventCategory[];
     meta: SdkPullMeta;
 }
-export interface SdkPullEventSeries {
+export interface SdkPullEvent {
     identifier: string;
     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 +856,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 +919,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 +1032,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;
@@ -1205,11 +1171,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/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;
+}