@riverbankcms/sdk 0.129.1 → 0.130.2

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

@@ -1,6 +1,11 @@
-import type { EventOnlineDetails, EventOnlineDetailsInput } from './bookingRecords';
+import type { EventOnlineDetails } from './bookingRecords';
 import type { SiteVerticalBookingConfig } from './bookingVerticals';
-import type { EventListingDestinationInput } from './event-listing-destination';
+import type { CreateEventRequest } from './eventManagementContracts';
+import { DEFAULT_EVENT_TYPE_PRESETS } from './eventSeriesPresentationPreset';
+import type { EventPreset } from './eventSeriesPresentationPreset';
+import { BOOKING_SETTINGS_SECTION_KEYS } from './bookingSettingsSections';
+export { BOOKING_SETTINGS_SECTION_KEYS, BOOKING_SETTINGS_SECTION_LABELS, } from './bookingSettingsSections';
+export type { EventPreset, GenericEventPreset, OrdinaryEventPreset, WholeSeriesEventPreset, } from './eventSeriesPresentationPreset';
 import type { EventPricingMode, StaffMemberId, UserId } from '../../core/src/index';
 export type { EventPricingMode } from '../../core/src/index';
 /**
@@ -122,8 +127,7 @@ export type BookingPricingInput = {
     paymentTerms?: BookingPaymentTermsConfig;
     options?: readonly BookingPricingOptionInput[];
 };
-export type EventPreset = 'event' | 'class' | 'course' | 'workshop' | 'retreat' | 'performance';
-export type GenericEventPreset = Exclude<EventPreset, 'course'>;
+export { DEFAULT_EVENT_TYPE_PRESETS };
 export type EventTicketTypeCapacityMode = 'limited' | 'unlimited';
 export type EventDeliveryMode = 'in_person' | 'online' | 'hybrid';
 export type EventAttendanceMode = 'in_person' | 'online';
@@ -227,60 +231,10 @@ export type EventSeriesRecord = {
     createdAt: string;
     updatedAt: string;
 };
-export type CreateEventSeriesRequest = {
-    preset?: GenericEventPreset;
-    verticalPresetId?: string | null;
-    pricingMode?: EventPricingMode;
-    title: string;
-    slug?: string;
-    startDate?: string;
-    defaultStartTime?: string;
-    durationMinutes?: number;
-    recurrenceRule?: string | null;
-    exceptionsJson?: string[];
-    venueId?: string | null;
-    capacity?: number | null;
-    deliveryMode?: EventDeliveryMode;
-    capacityByAttendanceMode?: EventCapacityByAttendanceMode;
-    visibility?: 'public' | 'private' | 'unlisted';
-    eventCategoryId?: string | null;
-    status?: 'draft' | 'active' | 'archived' | 'cancelled' | 'completed';
-    listingDestination?: EventListingDestinationInput;
-    /** Arbitrary per-series settings persisted to event_series.settings_json (server-validated). */
-    settingsJson?: Record<string, unknown>;
-    formId?: string | null;
-    priceDisplay?: string | null;
-    tags?: string[];
-    paymentTerms?: BookingPaymentTermsConfig;
-    paymentOptionsSource?: BookingPaymentOptionsSource;
-    requiresPayment?: boolean;
-    priceAmount?: number | null;
-    slidingMinAmount?: number | null;
-    slidingMaxAmount?: number | null;
-    slidingSuggestedAmount?: number | null;
-    acceptsPasses?: boolean;
-    acceptsMemberships?: boolean;
-    waitlistMode?: WaitlistOverride;
-    staffMemberIds?: string[];
-    mainHostStaffMemberId?: string | null;
-    ticketTypes?: EventTicketTypeInput[];
-    onlineDetails?: EventOnlineDetailsInput | null;
-    manualDates?: Array<{
-        startsAt: string;
-        endsAt: string;
-    }>;
-};
-export type UpdateEventSeriesRequest = Partial<Omit<CreateEventSeriesRequest, 'status' | 'preset'>> & {
-    status?: 'active' | 'draft' | 'archived' | 'cancelled' | 'completed';
+export type { CreateEventRecord, CreateEventRequest, EventCreationIntent, EventPageAuthorityRecord, EventRecord, ExplicitEventOccurrenceInput, } from './eventManagementContracts';
+export type UpdateEventSeriesRequest = Partial<Omit<CreateEventRequest, 'creationIntent' | 'initializationCommandId'>> & {
     migrationTicketTypeId?: string | null;
     migrationTicketTypeIndex?: number | null;
-    /**
-     * Explicitly cancel future sessions as part of archiving.
-     *
-     * Archiving does not silently auto-cancel active/future schedules. Set this
-     * flag when the caller intends a "cancel and archive" action.
-     */
-    cancelAndArchive?: boolean;
     /** If true, regenerate future occurrences based on updated schedule */
     regenerateSchedule?: boolean;
 };
@@ -426,6 +380,8 @@ export { DEFAULT_EVENT_DESTINATION_POLICY, eventDestinationModeValues, eventDest
 export type BookingSettings = {
     modules: BookingModuleToggles;
     verticalConfig?: BookingVerticalConfig;
+    /** Event types available when a site has no vertical-specific catalogue. */
+    eventTypePresets?: readonly EventPreset[];
     paymentDefaults: BookingPaymentDefaults;
     /** Site-wide mode for person and encounter records. */
     personRecordMode: PersonRecordMode;
@@ -483,14 +439,6 @@ export type BookingSettings = {
 };
 export type BookingSettingsSection = 'basics' | 'payments' | 'events' | 'appointments' | 'messages';
 export declare const BOOKING_SETTINGS_SECTIONS: readonly ["basics", "payments", "events", "appointments", "messages"];
-export declare const BOOKING_SETTINGS_SECTION_LABELS: Record<BookingSettingsSection, string>;
-export declare const BOOKING_SETTINGS_SECTION_KEYS: {
-    readonly basics: readonly ["modules", "verticalConfig", "personRecordMode", "defaultTimezone", "calendarDisplay", "icsFeedsEnabled", "waitlists", "teamMemberProfilePages"];
-    readonly payments: readonly ["paymentDefaults", "currency", "refundsIssueCredit"];
-    readonly events: readonly ["defaultVenueId", "eventReminderHours", "eventReminderOverrides", "eventScheduleWindowMonths", "eventOrganizerNotifications", "eventOrganizerEmail", "eventTicketingDefaultEnabled", "collectAllAttendeeDetails", "eventBookingPolicies", "defaultEventImage", "eventDestinationPolicy"];
-    readonly appointments: readonly ["appointmentReminderHours", "appointmentReminderOverrides", "appointmentRescheduleHours", "appointmentDefaultMinLeadMinutes", "appointmentDefaultMaxBookingNoticeMinutes", "appointmentBookingPolicies"];
-    readonly messages: readonly ["remindersEnabled", "notificationSettings", "appointmentStaffReminder", "appointmentStaffChangeNotifications", "eventFeedback", "appointmentFollowUp"];
-};
 type BookingSettingsSectionValues = {
     [Section in BookingSettingsSection]: Pick<BookingSettings, (typeof BOOKING_SETTINGS_SECTION_KEYS)[Section][number]>;
 };

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

@@ -3,10 +3,13 @@ import type { CreateBlackoutRequest, CreateBlackoutResponse, DeleteBlackoutRespo
 import type { CalendarStatusResponse, BookingCalendarFeedMutationResponse, BookingCalendarFeedStatusResponse, DisconnectCalendarResponse, UpdateCalendarPreferencesRequest, UpdateCalendarPreferencesResponse } from './calendar';
 import type { BookingRequirementConfigRequest, BookingRequirementConfigResponse, CreateAppointmentRequest, CreateAppointmentResponse } from './bookings';
 import type { BookingClosureConflictResponse, CreateBookingClosureRequest, CreateBookingClosureResponse, DeleteBookingClosureResponse, GetBookingClosureResponse, ListBookingClosuresResponse, PreviewBookingClosureResponse, BookingClosureRequest } from './bookingClosures';
-import type { BookingSettingsResponse, CreateEventSeriesRequest, EventSeriesRecord, UpdateBookingSettingsRequest, UpdateEventSeriesRequest } from './bookingConfig';
+import type { BookingSettingsResponse, EventSeriesRecord, UpdateBookingSettingsRequest, UpdateEventSeriesRequest } from './bookingConfig';
+import type * as Events from './eventManagementContracts';
+import type * as EventEndpoints from './bookingManagementEventEndpointTypes';
+import type { EventOfferingId, EventSeriesId } from '../../core/src/index';
 import type { AdjustCustomerPassDetailsRequest, AdjustCustomerPassDetailsResponse, AssignCustomerMembershipRequest, AssignCustomerMembershipResponse, AssignCustomerPassRequest, AssignCustomerPassResponse, CancelCustomerMembershipAtPeriodEndRequest, CancelCustomerMembershipAtPeriodEndResponse, ConvertCreditRefundToCashRequest, ConvertCreditRefundToCashResponse, ListCustomerMembershipPaymentRefundsResponse, ListCustomerMembershipPaymentsResponse, ListCustomerPassRefundsResponse, RefundCustomerMembershipPaymentRequest, RefundCustomerMembershipPaymentResponse, RefundCustomerPassRequest, RefundCustomerPassResponse } from './bookingAdjustments';
 import type { AppointmentResourceResponse, AppointmentReservationLifecycleRequest, AppointmentReservationResponse, AppointmentServiceResponse, BookingAppointmentWithDetails, CreateAppointmentResourceRequest, CreateAppointmentResourceWithAccountAccessRequest, CreateAppointmentResourceWithAccountAccessResponse, CreateAppointmentReservationRequest, CreateAppointmentReservationRunRequest, CreateAppointmentReservationRunResponse, CreateAppointmentServiceRequest, CreateTeamMemberProfileResponse, DiscardTeamMemberProfileDraftResponse, DeleteServiceResponse, EndAppointmentReservationRequest, ListAppointmentResourcesResponse, ListAppointmentReservationsRequest, ListAppointmentReservationsResponse, ListAppointmentServicesResponse, ListCourseEnrollmentRefundsResponse, ListEventAttendeeRefundsResponse, ListEventAttendeeTransfersResponse, OpsCancelEventAttendeeRequest, OpsCancelEventAttendeeResponse, OpsEventAttendeeDetailsResponse, OpsListUpcomingEventOccurrencesResponse, OpsOccurrenceAttendeesResponse, OpsRefundEventAttendeeResponse, OpsUpdateEventAttendeeCheckinRequest, OpsUpdateEventAttendeeCheckinResponse, OpsValidateEventTicketRequest, OpsValidateEventTicketResponse, PreviewAppointmentReservationRunRequest, PreviewAppointmentReservationRunResponse, ReferenceOptionsResponse, RemoveAppointmentResourceResponse, RefundCourseEnrollmentRequest, RefundCourseEnrollmentResponse, RefundEventAttendeeRequest, RefundEventAttendeeResponse, TransferEventAttendeeRequest, TransferEventAttendeeResponse, UpdateAppointmentResourceRequest, UpdateAppointmentReservationRequest, UpdateAppointmentServiceRequest, PublishTeamMemberProfileRequest, PublishTeamMemberProfileResponse, CancelScheduledTeamMemberProfileResponse, ScheduleTeamMemberProfileRequest, ScheduleTeamMemberProfileResponse, TeamMemberProfileContentResponse, UnpublishTeamMemberProfileResponse, UpdateTeamMemberProfileContentRequest, UpdateTeamMemberProfilePolicyRequest, UpdateTeamMemberProfilePolicyResponse, UpdateTeamMemberProfileRouteMetadataRequest, UpdateTeamMemberProfileRouteMetadataResponse } from './bookingOperations';
-import type { AddEventOccurrenceAttendeeRequest, AddEventOccurrenceAttendeeResponse, AdjustCustomerCreditRequest, AdjustCustomerCreditResponse, BookingEventSeriesAttendee, BookingMembershipResponse, BookingPassResponse, CheckEventAdminEligibilityRequest, CheckEventAdminEligibilityResponse, CreateBookingCustomerRequest, CreateBookingCustomerResponse, RectifyBookingCustomerProfileRequest, RectifyBookingCustomerProfileResponse, RectifyBookingParticipantIdentityRequest, RectifyBookingParticipantIdentityResponse, CreateBookingMembershipRequest, CreateBookingPassRequest, CreateDiscountCodeRequest, CreateEventCategoryRequest, CreateOccurrenceRequest, CreateVenueRequest, DeleteDiscountCodeResponse, DeleteVenueResponse, DiscountCodeResponse, EventCategoryResponse, EventOccurrenceListRecord, EventOccurrenceRecord, GeocodeVenueRequest, GeocodeVenueResponse, GetCustomerCreditResponse, GetMoneyReportRequest, GetMoneyReportResponse, ExportBookingQuestionAnswersCsvRequest, ExportBookingLedgerCsvRequest, ListBookingActivityRequest, ListBookingActivityResponse, ListBookingCustomersRequest, ListBookingCustomersResponse, ListBookingMembershipsRequest, ListBookingMembershipsResponse, ListBookingPassesRequest, ListBookingPassesResponse, ListCustomerAttendancesRequest, ListCustomerAttendancesResponse, ListCustomerMembershipsResponse, ListCustomerPassesResponse, CreatePersonRecordEntryRequest, CreatePersonRecordEntryResponse, ListDiscountCodesResponse, ListDiscountRedemptionsRequest, ListDiscountRedemptionsResponse, ListEventCategoriesResponse, ListMoneyPaymentsRequest, ListMoneyPaymentsResponse, ListSiteCustomerMembershipsRequest, ListSiteCustomerMembershipsResponse, ListSiteCustomerPassesRequest, ListSiteCustomerPassesResponse, UpdateBookingMembershipRequest, UpdateBookingPassRequest, UpdateDiscountCodeRequest, UpdateEventCategoryRequest, UpdateVenueRequest, VenueRecord } from './bookingRecords';
+import type { AddEventOccurrenceAttendeeRequest, AddEventOccurrenceAttendeeResponse, AdjustCustomerCreditRequest, AdjustCustomerCreditResponse, BookingEventSeriesAttendee, BookingMembershipResponse, BookingPassResponse, CheckEventAdminEligibilityRequest, CheckEventAdminEligibilityResponse, CreateBookingCustomerRequest, CreateBookingCustomerResponse, RectifyBookingCustomerProfileRequest, RectifyBookingCustomerProfileResponse, RectifyBookingParticipantIdentityRequest, RectifyBookingParticipantIdentityResponse, CreateBookingMembershipRequest, CreateBookingPassRequest, CreateDiscountCodeRequest, CreateEventCategoryRequest, CreateOccurrenceRequest, CreateVenueRequest, DeleteDiscountCodeResponse, DeleteVenueResponse, DiscountCodeResponse, EventCategoryResponse, EventOccurrenceRecord, GeocodeVenueRequest, GeocodeVenueResponse, GetCustomerCreditResponse, GetMoneyReportRequest, GetMoneyReportResponse, ExportBookingQuestionAnswersCsvRequest, ExportBookingLedgerCsvRequest, ListBookingActivityRequest, ListBookingActivityResponse, ListBookingCustomersRequest, ListBookingCustomersResponse, ListBookingMembershipsRequest, ListBookingMembershipsResponse, ListBookingPassesRequest, ListBookingPassesResponse, ListCustomerAttendancesRequest, ListCustomerAttendancesResponse, ListCustomerMembershipsResponse, ListCustomerPassesResponse, CreatePersonRecordEntryRequest, CreatePersonRecordEntryResponse, ListDiscountCodesResponse, ListDiscountRedemptionsRequest, ListDiscountRedemptionsResponse, ListEventCategoriesResponse, ListMoneyPaymentsRequest, ListMoneyPaymentsResponse, ListSiteCustomerMembershipsRequest, ListSiteCustomerMembershipsResponse, ListSiteCustomerPassesRequest, ListSiteCustomerPassesResponse, UpdateBookingMembershipRequest, UpdateBookingPassRequest, UpdateDiscountCodeRequest, UpdateEventCategoryRequest, UpdateVenueRequest, VenueRecord } from './bookingRecords';
 import type * as OccurrenceScheduling from './occurrenceScheduling';
 import type { ApplyAppointmentSetupRequest, ApplyAppointmentSetupResponse, AppointmentSetupResponse } from './appointmentSetup';
 import type { AddCourseEnrollmentRequest, AddCourseEnrollmentResponse, CourseRecord, CreateCourseRequest, CreateCourseResponse, CourseContentOwnershipRequest, CourseContentOwnershipResponse, DashboardWaitlistListResponse, DeleteCourseResponse, DeleteEventOfferingResponse, DuplicateCourseRequest, DuplicateCourseResponse, ListCourseEnrollmentsResponse, UpdateCourseEnrollmentRequest, UpdateCourseEnrollmentResponse, UpdateCourseRequest, UpdateCourseResponse, WaitlistDashboardActionResponse } from './courses';
@@ -568,28 +571,29 @@ export type BookingManagementAPIEndpoints = {
         courseId: string;
         enrollmentId: string;
     }, UpdateCourseEnrollmentResponse>;
-    listEventSeries: APIEndpoint<never, {
+    listEvents: APIEndpoint<never, {
         siteId: string;
         status?: 'draft' | 'active' | 'archived' | 'cancelled' | 'completed';
         visibility?: 'public' | 'private' | 'unlisted';
-    }, EventSeriesRecord[]>;
-    exportEventSeriesCsv: APIEndpoint<never, {
+    }, Events.EventRecord[]>;
+    createEvent: APIEndpoint<Events.CreateEventRequest, {
         siteId: string;
-    }, Blob>;
-    createEventSeries: APIEndpoint<CreateEventSeriesRequest, {
-        siteId: string;
-    }, EventSeriesRecord>;
+    }, Events.CreateEventRecord>;
+    transitionEventLifecycle: EventEndpoints.Lifecycle;
     getEventSeries: APIEndpoint<never, {
         siteId: string;
-        seriesId: string;
+        eventId: EventOfferingId;
+        seriesId: EventSeriesId;
     }, EventSeriesRecord>;
     updateEventSeries: APIEndpoint<UpdateEventSeriesRequest, {
         siteId: string;
-        seriesId: string;
+        eventId: EventOfferingId;
+        seriesId: EventSeriesId;
     }, EventSeriesRecord>;
     deleteEventSeries: APIEndpoint<never, {
         siteId: string;
-        seriesId: string;
+        eventId: EventOfferingId;
+        seriesId: EventSeriesId;
     }, {
         success: boolean;
     }>;
@@ -686,10 +690,7 @@ export type BookingManagementAPIEndpoints = {
         siteId: string;
         attendeeId: string;
     }, ListEventAttendeeTransfersResponse>;
-    listEventSeriesOccurrences: APIEndpoint<never, {
-        siteId: string;
-        seriesId: string;
-    }, EventOccurrenceListRecord[]>;
+    listEventSeriesOccurrences: EventEndpoints.OccurrenceList;
     createEventOccurrence: APIEndpoint<CreateOccurrenceRequest, {
         siteId: string;
         seriesId: string;

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

@@ -0,0 +1,15 @@
+import type { EventOfferingId } from '../../core/src/index';
+import type { APIEndpoint } from './apiEndpointTypes';
+import type { EventOccurrenceListRecord } from './bookingRecords';
+import type { EventLifecycleTransitionRequest, EventLifecycleTransitionResponse } from './eventManagementContracts';
+export type Lifecycle = APIEndpoint<EventLifecycleTransitionRequest, {
+    siteId: string;
+    eventId: EventOfferingId;
+}, EventLifecycleTransitionResponse>;
+export type OccurrenceList = APIEndpoint<never, {
+    siteId: string;
+    seriesId: string;
+    timeScope?: 'all' | 'current' | 'past';
+    limit?: number;
+    offset?: number;
+}, EventOccurrenceListRecord[]>;

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

@@ -718,6 +718,7 @@ export type BookingActivityListItem = {
         orderId: string | null;
         appointmentId: string | null;
         eventAttendeeId: string | null;
+        eventOfferingId: string | null;
         eventSeriesId: string | null;
         eventOccurrenceId: string | null;
         courseEnrollmentId: string | null;

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

@@ -0,0 +1,9 @@
+import type { BookingSettingsSection } from './bookingConfig';
+export declare const BOOKING_SETTINGS_SECTION_LABELS: Record<BookingSettingsSection, string>;
+export declare const BOOKING_SETTINGS_SECTION_KEYS: {
+    readonly basics: readonly ["modules", "verticalConfig", "eventTypePresets", "personRecordMode", "defaultTimezone", "calendarDisplay", "icsFeedsEnabled", "waitlists", "teamMemberProfilePages"];
+    readonly payments: readonly ["paymentDefaults", "currency", "refundsIssueCredit"];
+    readonly events: readonly ["defaultVenueId", "eventReminderHours", "eventReminderOverrides", "eventScheduleWindowMonths", "eventOrganizerNotifications", "eventOrganizerEmail", "eventTicketingDefaultEnabled", "collectAllAttendeeDetails", "eventBookingPolicies", "defaultEventImage", "eventDestinationPolicy"];
+    readonly appointments: readonly ["appointmentReminderHours", "appointmentReminderOverrides", "appointmentRescheduleHours", "appointmentDefaultMinLeadMinutes", "appointmentDefaultMaxBookingNoticeMinutes", "appointmentBookingPolicies"];
+    readonly messages: readonly ["remindersEnabled", "notificationSettings", "appointmentStaffReminder", "appointmentStaffChangeNotifications", "eventFeedback", "appointmentFollowUp"];
+};

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

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+export { EVENT_SERIES_BEHAVIOURS } from './eventSeriesPresentationPreset';
 import { BOOKING_DEFAULTS_BY_BEHAVIOUR, BOOKING_ENGINE_BY_BEHAVIOUR, VERTICAL_BOOKING_PRESETS, VERTICAL_DEFINITIONS } from './bookingVerticalCatalog';
 export { BOOKING_DEFAULTS_BY_BEHAVIOUR, BOOKING_ENGINE_BY_BEHAVIOUR, VERTICAL_BOOKING_PRESETS, VERTICAL_DEFINITIONS, };
 export type VerticalBookingPresetDefinition = (typeof VERTICAL_BOOKING_PRESETS)[number];
@@ -12,7 +13,6 @@ export type VerticalPresetAvailability = (typeof VERTICAL_PRESET_AVAILABILITIES)
 export declare const VERTICAL_IDS: readonly ["yoga_wellness", "fitness_pt", "dance_school", "physiotherapy_physical_health", "massage_bodywork", "therapist_practitioner", "beauty_spa", "consultant_coach", "training_provider", "retreat_centre", "music_school", "voice_singing", "performing_arts_school", "community_wellbeing", "venue_event_space"];
 export type VerticalId = (typeof VERTICAL_IDS)[number];
 export type EventSeriesCanonicalBehaviour = Extract<CanonicalBookingBehaviour, 'class' | 'course' | 'workshop' | 'retreat' | 'performance'>;
-export declare const EVENT_SERIES_BEHAVIOURS: readonly ["class", "course", "workshop", "retreat", "performance"];
 export type EventSeriesVerticalPresetId = Extract<VerticalPresetId, `${string}.${string}`>;
 export type EventSeriesVerticalPresetDefinition = VerticalBookingPresetDefinition & {
     canonicalBehaviour: EventSeriesCanonicalBehaviour;
@@ -123,7 +123,7 @@ export declare function isEventSeriesCanonicalBehaviour(behaviour: CanonicalBook
 export declare function isEventSeriesVerticalPresetDefinition(presetDefinition: VerticalBookingPresetDefinition): presetDefinition is EventSeriesVerticalPresetDefinition;
 export declare function canonicalBehaviourToEventPreset(behaviour: EventSeriesCanonicalBehaviour): EventSeriesCanonicalBehaviour;
 export declare function validateEventSeriesVerticalPreset(input: Readonly<{
-    canonicalPreset: EventSeriesCanonicalBehaviour;
+    canonicalPreset: EventSeriesCanonicalBehaviour | 'term';
     verticalPresetId: string | null | undefined;
 }>): EventSeriesVerticalPresetValidationResult;
 export declare function createConfiguredSiteVerticalBookingConfig(verticalId: VerticalId, selectedPresetIds: NonEmptyVerticalPresetIds): ConfiguredSiteVerticalBookingConfig;

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

@@ -5,6 +5,7 @@ import type { AiPlaygroundApplyRequest, AiPlaygroundApplyResponse } from "./aiPl
 import type { BillingCheckoutRequest, BillingCheckoutResponse, BillingStatusResponse, BillingSummaryResponse, SiteBillingCheckoutResponse, SiteBillingCostResponse } from "./billing";
 import type { CreateSiteFontUploadUrlRequest, CreateSiteFontUploadUrlResponse, DeleteSiteFontFileRequest, DeleteSiteFontFileResponse, ExportBackupRequest, FontRecord, GetSiteFontResponse, ListPublicSiteFontsResponse, ListSiteFontsResponse, UpdateSiteFontRequest, UpdateSiteFontResponse, UploadSiteFontRequest, UploadSiteFontResponse } from "./siteAssets";
 import type { AdminSiteBillingArrangementResponse, AdminResolveSiteBillingManualReviewRequest, AdminResolveSiteBillingManualReviewResponse, AdminScheduleBillingComponentEndRequest, AdminScheduleBillingComponentEndResponse, AdminUpdateSiteBillingArrangementRequest, AdminUpdateSiteBillingArrangementResponse, CancelFlexibleBalanceBookingDueToNonPaymentRequest, CancelShopOrderItemRequest, CancelShopOrderItemResponse, CancelShopOrderRequest, CancelShopOrderResponse, CreateShopOrderPaymentLinkResponse, CreateOrderShipmentRequest, CreateOrderShipmentResponse, EditShopOrderAddressRequest, FlexibleBalanceAdminActionResponse, PortalAppointmentWithDetails, RefundShopOrderResponse, ReopenFlexibleBalanceBookingAfterNonPaymentCancellationRequest, SendShopOrderPaymentReminderResponse, SettleShopOrderPaymentRequest, SettleShopOrderPaymentResponse, ShopOrderDigitalFulfillmentRequest, ShopOrderDigitalFulfillmentResponse } from "./siteOperations";
+import type { PreviewRefreshRequest, PreviewRefreshResponse } from './preview-auth';
 export type DemoClaimBlueprintSlug = 'lotus-studio' | 'healing-hands' | 'isobel-studio' | 'clayfield';
 /**
  * Commerce and portal endpoints cover billing/account actions, portal customer flows,
@@ -280,6 +281,7 @@ export type CommercePortalAPIEndpoints = {
         siteId: string;
         expiresAt: string;
     }>;
+    previewRefreshSession: APIEndpoint<PreviewRefreshRequest, never, PreviewRefreshResponse>;
     portalExchangeCode: APIEndpoint<{
         portalCode: string;
         callbackOrigin?: string;

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

@@ -341,16 +341,14 @@ export type SiteBySlugResponse = {
         url: string;
         mimeType: string;
     } | null;
-    theme: Theme;
+    theme: Theme | null;
     themeId?: string | null;
     selectionId?: string | null;
     selectionVersion?: number | null;
     selectionUpdatedAt?: string | null;
-    /** Canonical persisted style selection; null only when no current selection exists. */
+    /** Canonical persisted Style configurator selections, absent only when no selection row exists. */
     selectionButtonStyleSelection?: import('../../theme-core/src/buttons/index').ButtonStyleSelection | null;
-    selectionHeaderLayoutId?: string | null;
-    selectionHeaderStyleId?: string | null;
-    selectionHeaderLookId?: string | null;
+    selectionHeaderSelection?: import('../../theme-core/src/site-styles/index').HeaderLayoutStyleSelection | null;
     selectionFooterLookId?: string | null;
     navigation: NavigationMenuWithItems[];
     /** Whether portal navigation links should be rendered for this site. */