@riverbankcms/sdk 0.130.0 → 0.132.0

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

@@ -0,0 +1 @@
+export type { AccountRevokeSessionsBody, AccountRevokeSessionsResponse, AccountUpdatePasswordBody, AccountUpdatePasswordResponse, AuthFieldKey, AuthSubmissionErrorReason, AuthSubmissionSuccess, AuthSubmissionError, AuthSubmissionResult, ReauthSubmissionResult, DomainAvailability, SiteDomainRecord, SiteDomainContactPayload, RegistrarLifecycleState, RegistrarLifecycleMutationOutcome, RegistrarLifecycleMutationOperation, RegistrarLifecycleMutationBase, RegistrarLifecycleMutationResponse, ExposedRegistrarLifecycleMutationResponse, RegistrarLifecycleResponse, RegistrarBooleanMutationRequest, RegistrarRenewalCostEstimate, RegistrarProviderName, RegistrarRenewalRiskReason, RegistrarRenewalManualReviewReason, RegistrarRenewalManualReviewReasonWithoutExpiry, RegistrarRenewalManualReviewReasonWithExpiry, RegistrarRenewalFailedReason, RegistrarRenewalPosture, RegistrarAccountBalance, RegistrarRenewalPostureResponse, LookupSiteDomainRequest, LookupSiteDomainResponse, RegisterSiteDomainRequest, RegisterSiteDomainResponse, AddCustomDomainRequest, AddCustomDomainResponse, SetHomepageRequest, SetHomepageResponse, ContentRouteRecord, SeoOverviewResponse, SeoOverviewQuery, SeoOverviewTimePoint, SeoRangePreset, PerformanceOverviewResponse, PerformanceOverviewQuery, PerformanceRangePreset, SeoSearchPagesQuery, SeoSearchPagesResponse, SeoSearchQueriesQuery, SeoSearchQueriesResponse, SeoSearchSummary, ContentEntryRecord, ContentEntrySummary, FormSummary, ContentEntryDetail, ScheduledContentEntryOrPageResponse, PublishedContentEntryPreview, PublishedContentEntryPreviewResponse, PublishedPostPreview, PublishedPostPreviewResponse, ContentEntryListStage, ContentEntryListItem, ListPublishedEntriesResponse, ContentTypeTemplateSummary, PublicContentTypeFieldMeta, PublicContentTypeMeta, ListPublishedEntriesMeta, ContentTemplateSummary, ContentTemplateBlockSummary, ContentTemplateAddonSummary, ContentAddonDefinition, ContentTemplateDetailsResponse, UpdateContentTemplateBlockRequest, ApplyContentTemplateAddonRequest, StartImpersonationRequest, StartImpersonationResponse, StopImpersonationRequest, StopImpersonationResponse, UpsertAdminRoleRequest, RevokeAdminRoleRequest, AdminRoleMutationResponse, AdminProfileRole, DTOType, MfaFactorSummary, MfaOverviewPayload, MfaOverviewResponse, MfaTotpActivateRequest, MfaTotpEnrollResponse, MfaTotpVerifyRequest, MfaTotpVerifyResponse, MfaPhoneEnrollRequest, MfaPhoneEnrollResponse, MfaPhoneChallengeRequest, MfaPhoneChallengeResponse, MfaPhoneVerifyRequest, MfaBackupCodeSummary, MfaBackupCodesOverview, MfaBackupCodesOverviewResponse, MfaBackupCodesRotateResponse, CreateAdminInviteRequest, CreateAdminInviteResponse, CreateAdminUserRequest, CreateAdminUserResponse, ListAdminInvitesResponse, RevokeAdminInviteResponse, CreateAllowedDomainRequest, CreateAllowedDomainResponse, ListAllowedDomainsResponse, DeleteAllowedDomainResponse, AcceptAdminInviteRequest, AcceptAdminInviteResponse, AdminInvite, AllowedEmailDomain, AdminChangePlanRequest, AdminChangePlanResponse, ChangePlanRequest, ChangePlanResponse, BillingPriceOverride, AdminGetPriceOverrideQuery, AdminGetPriceOverrideResponse, AdminUpsertPriceOverrideRequest, AdminUpsertPriceOverrideResponse, AdminDeletePriceOverrideRequest, AdminDeletePriceOverrideResponse, DomainSearchResultResponse, AcceptedManagedDomainAddOnPricing, AnalyticsPreset, AnalyticsReportQuery, AnalyticsSeriesPoint, AnalyticsTopPage, AnalyticsReferrer, AnalyticsTotals, AnalyticsReportResponse, RegisterDomainRequestPayload, RegisterDomainResponse, DomainConfigResult, OperationalStaffSurfaces, SiteRole, StaffOperationalCapability, SiteMember, SiteMemberProfile, SiteInvitation, SiteAccessSummary, SitePlanSummaryResponse, ListSiteMembersResponse, InviteSiteMemberRequest, InviteSiteMemberResponse, UpdateSiteMemberRoleRequest, UpdateSiteMemberRoleResponse, RemoveSiteMemberResponse, RevokeSiteInvitationResponse, ResendSiteInvitationResponse, TransferSiteOwnershipRequest, TransferSiteOwnershipResponse, AcceptSiteInvitationRequest, AcceptSiteInvitationResponse, DevToolsImpersonationResponse, DevToolsSeedResponse, DowngradeRole, RoleDowngradeActualRole, SiteRoleDowngradeState, DevToolsGetSiteRoleDowngradeQuery, DevToolsSetSiteRoleDowngradeRequest, SitePagePayload, SiteBySlugResponse, BlockWithContentResponse, ContentDataResponse, RedirectHttpStatus, SdkRouteDecisionResponse, SdkRouteOutcomeResponse, BackupAccessImportResult, BackupImportResponse, PreviewKeyRecord, ApiKeyAccessLogRecord, ListSiteApiKeysResponse, CreateSiteApiKeyRequest, CreateSiteApiKeyResponse, RevokeSiteApiKeyResponse, ListSitePreviewKeysResponse, CreateSitePreviewKeyResponse, GetSiteApiKeyAccessLogsResponse, ApiKeyAccessLogsPagination, ManagementKeyRecord, ManagementKeyAccessMode, ListManagementKeysResponse, CreateManagementKeyRequest, CreateManagementKeyResponse, RevokeManagementKeyRequest, RevokeManagementKeyResponse, EventOnlineDetails, EventOnlineDetailsInput, StaffAssignmentMode, EventSeriesRecord, UpdateEventSeriesRequest, EventAttendeeRecord, BookingBeforeYouComeDeliveryIssue, BookingBeforeYouComeReadiness, BookingEventSeriesAttendeeGuest, BookingEventSeriesAttendee, BookingPaymentIssueReason, BookingPaymentAttentionSummary, EventOccurrenceRecord, EventOccurrenceOverrides, EventOccurrenceStatus, EventOccurrenceDeletionEligibility, EventOccurrenceListRecord, VenueRecord, VenueLocation, CreateVenueRequest, UpdateVenueRequest, DeleteVenueResponse, GeocodeVenueRequest, GeocodeVenueResponse, AiPlaygroundApplyRequest, AiPlaygroundApplyResponse, BillingStatusResponse, BillingCheckoutRequest, BillingCheckoutResponse, BillingSummaryResponse, BillingSummaryComponent, BillingSummaryComponentKind, BillingSummaryComponentSource, BillingSummaryBasePlanComponent, BillingSummarySiteComponent, BillingSummaryAddOnComponent, SiteBillingCostResponse, SitePurpose, AiBrandGuidelinesExample, SiteAiBrandGuidelinesPayload, SiteAiBrandGuidelinesResponse, SiteAiProfileEntityType, SiteAiProfileLocationMode, SiteAiProfilePayload, SiteAiProfileResponse, SiteBusinessAddressPayload, SiteBusinessAddressResponse, SiteContentSamplingStats, SiteContentSampledItem, AiBrandGuidelinesGenerationContextResponse, AiBrandGuidelinesGenerateRequest, AiBrandGuidelinesGenerateResponse, DeleteAccountRequest, DeleteAccountResponse, FontRecord, ExportBackupRequest, BackupPreviewRequest, BackupPreviewResponse, CreateBackupUploadUrlRequest, CreateBackupUploadUrlResponse, DeleteBackupUploadRequest, DeleteBackupUploadResponse, ImportBackupAsNewSiteRequest, ImportBackupAsNewSiteResponse, AdminSiteBillingArrangementManualReview, AdminSiteBillingArrangementResponse, AdminUpdateSiteBillingArrangementRequest, BulkOperationResult, SchedulePreviewRequest, SchedulePreviewResponse, AffectedOccurrence, ModifiedOccurrence, RegenerationSummary, AiGenerateSiteEntityType, AiGenerateSitePrimaryCta, AiGenerateSiteRequest, AiGenerateSiteResponse, AiSiteWizardIntakeTriageRequest, AiSiteWizardIntakeTriageResponse, AiSiteWizardTelemetryEvent, AiSiteWizardTelemetryRequest, AiSiteWizardTelemetryResponse, PublicOnboardingAttempt, PublicOnboardingAttemptPayload, PublicOnboardingLogoUploadRequest, PublicOnboardingLogoUploadResponse, PublicOnboardingLogoUploadUrlRequest, PublicOnboardingLogoUploadUrlResponse, PublicOnboardingAttemptStatus, PublicOnboardingSurfaceId, SiteGenerationScope, SiteGenerationFeatureKey, SiteWizardResumeSnapshot, SiteGenerationIntakePayload, SiteGenerationIntakeResponse, CalendarConnectionStatus, CalendarStatusResponse, DebugArtifact, DebugArtifacts, PageBlock, PageConverterOutput, PageConversionSuccess, PageConversionAttempt, PageConversionFailure, PageConversionResult, PageConvertResponse, PageConvertJobStatus, PageConvertJob, PageConvertJobEventType, PageConvertJobEvent, PageConvertJobsCreateRequest, PageConvertJobsCreateResponse, PageConvertJobsListResponse, PageConvertJobGetResponse, PageConvertJobRunResponse, PageConvertJobEventsResponse, NewsletterSettingsRecord, NewsletterSubscriberRecord, NewsletterListRecord, GetNewsletterSettingsResponse, UpdateNewsletterSettingsRequest, UpdateNewsletterSettingsResponse, ListNewsletterTagsResponse, ListNewsletterSubscribersResponse, UpsertNewsletterSubscriberRequest, UpsertNewsletterSubscriberResponse, ImportNewsletterSubscribersCsvResponse, ExportNewsletterSubscribersCsvResponse, GetNewsletterSubscriberResponse, UpdateNewsletterSubscriberRequest, UpdateNewsletterSubscriberResponse, DeleteNewsletterSubscriberResponse, AnonymizeNewsletterSubscriberResponse, ExportNewsletterSubscriberDataResponse, ListNewsletterListsResponse, CreateNewsletterListRequest, CreateNewsletterListResponse, UpdateNewsletterListRequest, UpdateNewsletterListResponse, DeleteNewsletterListResponse, ListNewsletterListMembersResponse, UpdateNewsletterListMembershipsRequest, UpdateNewsletterListMembershipsResponse, NewsletterTemplateRecord, ListNewsletterTemplatesResponse, CreateNewsletterTemplateRequest, CreateNewsletterTemplateResponse, GetNewsletterTemplateResponse, UpdateNewsletterTemplateRequest, UpdateNewsletterTemplateResponse, DeleteNewsletterTemplateResponse, PreviewNewsletterTemplateRequest, PreviewNewsletterTemplateResponse, NewsletterCampaignRecord, ListNewsletterCampaignsResponse, CreateNewsletterCampaignRequest, CreateNewsletterCampaignResponse, GetNewsletterCampaignResponse, UpdateNewsletterCampaignRequest, UpdateNewsletterCampaignResponse, DeleteNewsletterCampaignResponse, NewsletterCampaignRecipientsSummary, GetNewsletterCampaignRecipientsSummaryResponse, NewsletterCampaignStats, GetNewsletterCampaignStatsResponse, NewsletterSendJobRecord, NewsletterSendJobStatus, ListNewsletterSendJobsQuery, ListNewsletterSendJobsResponse, RetryNewsletterSendJobResponse, CancelNewsletterSendJobResponse, SiteLogActor, SiteContentActivityLogEntry, SiteFormSubmissionActivityLogEntry, SiteActivityLogEntry, ListSiteActivityLogsResponse, SiteEmailLogEntry, ListSiteEmailLogsResponse, SiteEmailEventLogEntry, ListSiteEmailEventLogsResponse, SitePublicErrorLogEntry, ListSitePublicErrorLogsResponse, } from './types';

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

@@ -201,6 +201,7 @@ export type MediaAssetResponse = {
     storageBucket: string | null;
     storagePath: string;
     filename: string;
+    identifier: string;
     mimeType: string;
     width: number | null;
     height: number | null;

package/dist/_dts/api/src/navigation/dashboardBookingsNav.d.ts

@@ -1,6 +1,5 @@
-import type { AppointmentResourceId } from "../../../core/src/index";
-import type { BookingSettingsSection, BookingVerticalConfig } from "../bookingConfig";
-import { type EventSeriesCanonicalBehaviour } from "../bookingVerticals";
+import { type AppointmentResourceId, type EventSeriesCanonicalBehaviour, type SiteVerticalBookingConfig } from "../../../core/src/index";
+import type { BookingSettingsSection } from "../bookingConfig";
 import { type StaffScope } from "../staffAccess";
 import type { SiteRole } from "../siteMembers";
 export type DashboardBookingModules = Readonly<{
@@ -87,4 +86,4 @@ export type DashboardBookingsNavGroupPlan = Readonly<{
     items: readonly DashboardBookingsNavItemPlan[];
 }>;
 export declare function resolveDashboardBookingsNavPolicy(modules: DashboardBookingModules, ctx: DashboardBookingsNavContext): DashboardBookingsNavPolicy;
-export declare function buildDashboardBookingsNavPlan(modules: DashboardBookingModules, ctx: DashboardBookingsNavContext, verticalConfig?: BookingVerticalConfig | null): readonly DashboardBookingsNavGroupPlan[];
+export declare function buildDashboardBookingsNavPlan(modules: DashboardBookingModules, ctx: DashboardBookingsNavContext, verticalConfig?: SiteVerticalBookingConfig | null): readonly DashboardBookingsNavGroupPlan[];

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

@@ -0,0 +1,8 @@
+/**
+ * First-party CLI OAuth protocol constants shared by the CLI and dashboard.
+ * Keep these values dependency-neutral: they describe the wire contract, not
+ * Supabase or a particular server implementation.
+ */
+export declare const RIVERBANK_CLI_OAUTH_CALLBACK_URL: "http://127.0.0.1:45454/oauth/callback";
+export declare const RIVERBANK_CLI_OAUTH_SCOPES: readonly ["email", "profile"];
+export declare const RIVERBANK_CLI_OAUTH_APPLICATION_NAME: "Riverbank CLI";

package/dist/_dts/api/src/preview-auth.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+/**
+ * Provider-neutral preview-session refresh contract.
+ *
+ * Auth-provider payloads (including snake_case token fields) must not cross
+ * the Riverbank dashboard boundary.
+ */
+export declare const previewRefreshRequestSchema: z.ZodObject<{
+    refreshToken: z.ZodString;
+}, z.core.$strict>;
+export type PreviewRefreshRequest = Readonly<z.infer<typeof previewRefreshRequestSchema>>;
+export declare const previewRefreshResponseSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    refreshToken: z.ZodString;
+}, z.core.$strict>;
+export type PreviewRefreshResponse = Readonly<z.infer<typeof previewRefreshResponseSchema>>;
+export type PreviewRefreshParseError = Readonly<{
+    tag: 'malformed_response';
+}>;
+export declare function parsePreviewRefreshResponse(value: unknown): Readonly<{
+    success: true;
+    data: PreviewRefreshResponse;
+}> | Readonly<{
+    success: false;
+    error: PreviewRefreshParseError;
+}>;

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

@@ -0,0 +1,11 @@
+export declare const PUBLIC_EVENT_ENDPOINT_DEFINITIONS: {
+    resolveEventSubroute: {
+        path: "/public/sites/{siteId}/events/subroutes/resolve";
+        method: "GET";
+        revalidate: 60;
+        tags: ("riverbank:site:{siteId}:public-events" | "event-subroute")[];
+        auth: "public";
+        responseKind: "json";
+        errors: never[];
+    };
+};

package/dist/_dts/api/src/publicExperience/eventEndpoints.d.ts

@@ -4,9 +4,10 @@
  * Merged into `PublicExperienceAPIEndpoints` by `../publicExperienceEndpoints`.
  */
 import type { APIEndpoint } from '../apiEndpointTypes';
-import type { PublicEventPricing } from '../../../core/src/index';
+import type { PublicEventBookingAvailability, PublicEventPricing } from '../../../core/src/index';
 import type { PublicEventDestination } from '../event-listing-destination';
-import type { BookingPaymentTermsConfig, BookingPricing, DirectCheckoutCollectionOptionKind, EventAttendanceMode, EventDeliveryMode, EventPricingMode, GenericEventPreset, PublicEventEligibilityTicketTypeRecord, PublicEventTicketTypeRecord } from '../bookingConfig';
+import type { BookingPaymentTermsConfig, BookingPricing, DirectCheckoutCollectionOptionKind, EventAttendanceMode, EventDeliveryMode, EventPricingMode, PublicEventEligibilityTicketTypeRecord, PublicEventTicketTypeRecord } from '../bookingConfig';
+import type { EventPreset } from '../../../core/src/index';
 import type { PublicTeamMemberSummary } from '../teamMembers';
 import type { EventTicketLineSummaryResponse, EventTicketSelectionRequest, PublicEventLoaderParams, PublicEventRecurrence, PublicEventScheduleScope } from './sharedTypes';
 export type PublicEventAPIEndpoints = {
@@ -19,7 +20,7 @@ export type PublicEventAPIEndpoints = {
         stage?: string;
     } & PublicEventLoaderParams, Array<{
         bookingScope: 'single_occurrence' | 'whole_series';
-        eventPreset?: GenericEventPreset;
+        eventPreset?: EventPreset;
         eventDestinationMode?: import('../event-destination-policy').EventDestinationMode;
         destination: PublicEventDestination;
         scheduleScope?: Exclude<PublicEventScheduleScope, 'any'>;
@@ -56,6 +57,7 @@ export type PublicEventAPIEndpoints = {
         slug: string;
         path: string | null;
         requiresRegistration: boolean;
+        bookingAvailability: PublicEventBookingAvailability;
         deliveryMode: EventDeliveryMode;
         attendanceModes: Array<{
             mode: EventAttendanceMode;
@@ -85,7 +87,7 @@ export type PublicEventAPIEndpoints = {
             color: string | null;
         } | null;
         teamMembers?: PublicTeamMemberSummary[];
-        status?: 'active' | 'draft' | 'archived';
+        status?: 'active' | 'draft' | 'cancelled' | 'completed' | 'archived';
         pricing: PublicEventPricing<PublicEventTicketTypeRecord>;
         paymentTerms: BookingPaymentTermsConfig;
         accessRestriction: 'none' | 'category';
@@ -129,20 +131,32 @@ export type PublicEventAPIEndpoints = {
             upcomingCount: number;
         }>;
     }>;
-    resolveEventOccurrence: APIEndpoint<never, {
+    resolveEventSubroute: APIEndpoint<never, {
         siteId: string;
-        eventSeriesIds: string;
+        kind: 'event-occurrence' | 'event-run';
+        subjectKind: 'eventOffering' | 'eventSeries';
+        subjectId: string;
         segment: string;
     }, {
-        occurrence: {
-            id: string;
-            seriesId: string;
-            startsAt: string;
-            endsAt: string;
-            timeZone: string;
-            status: string;
-            capacityOverride: number | null;
-            overridesJson: Record<string, unknown>;
+        subroute: {
+            kind: 'event-occurrence';
+            occurrence: {
+                id: string;
+                seriesId: string;
+                startsAt: string;
+                endsAt: string;
+                timeZone: string;
+                status: string;
+                capacityOverride: number | null;
+                overridesJson: Record<string, unknown>;
+            };
+        } | {
+            kind: 'event-run';
+            run: {
+                seriesId: string;
+                identifier: string;
+                name: string | null;
+            };
         } | null;
     }>;
     registerForEvent: APIEndpoint<{
@@ -156,7 +170,6 @@ export type PublicEventAPIEndpoints = {
         notes?: string;
         formData?: Record<string, unknown>;
         altchaSolution?: string | null;
-        stage?: 'preview' | 'published';
         paymentMethod?: 'free' | 'pass' | 'membership' | 'stripe' | 'pass_bundle' | 'membership_bundle';
         customerPassId?: string;
         customerMembershipId?: string;

package/dist/_dts/api/src/publicExperience/sharedTypes.d.ts

@@ -33,6 +33,8 @@ export type PublicEventLoaderParams = {
     eventPresets?: string;
     scheduleScope?: string;
     seriesId?: string;
+    seriesIds?: string;
+    runSeriesId?: string;
     seriesSlug?: string;
     includeOccurrenceId?: string;
     detailLevel?: string;

package/dist/_dts/api/src/publicExperience/wholeSeriesEndpoints.d.ts

@@ -12,6 +12,7 @@ export type PublicWholeSeriesAPIEndpoints = {
     listPublicWholeSeriesOfferings: APIEndpoint<never, {
         siteId: string;
         limit?: string;
+        eventSeriesIds?: string;
         stage?: string;
     }, Array<{
         eventSeriesId: string;
@@ -60,7 +61,6 @@ export type PublicWholeSeriesAPIEndpoints = {
         phone?: string;
         formData?: Record<string, unknown>;
         altchaSolution?: string | null;
-        stage?: 'preview' | 'published';
         paymentMethod?: 'free' | 'membership';
         customerMembershipId?: string;
         claimToken?: string;

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

@@ -26,10 +26,11 @@ export declare const sdkEventUpsertOptionalFieldSchemas: {
     readonly preset: z.ZodOptional<z.ZodEnum<{
         course: "course";
         event: "event";
-        performance: "performance";
         class: "class";
+        term: "term";
         workshop: "workshop";
         retreat: "retreat";
+        performance: "performance";
     }>>;
     readonly bookingScope: z.ZodOptional<z.ZodEnum<{
         single_occurrence: "single_occurrence";
@@ -107,6 +108,7 @@ type SdkEventRunExplicitOccurrencesInput = Readonly<{
 export type SdkEventRunUpsertBody = SdkEventRunUpsertCommon & (SdkEventRunAuthoredScheduleInput | SdkEventRunExplicitOccurrencesInput);
 export type SdkEventUpsertBody = Readonly<{
     identifier: string;
+    administrativeStatus?: SdkPullEvent['administrativeStatus'];
     title: string;
     slug: string;
     path?: string | null;

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/sdkBookingVerticalContracts.d.ts

@@ -0,0 +1,29 @@
+import type { ConfiguredSiteVerticalBookingConfig, SiteVerticalConfigIssue } from '../../core/src/index';
+import type { BookingSettingsCommandWarning } from '@riverbankcms/site-commands';
+import type { SdkCommandApplicationResult } from './sdkContracts';
+/** A non-fatal warning emitted when a historical booking config cannot be read. */
+export type SdkPullSettingsWarning = Readonly<{
+    code: 'invalid_booking_vertical_config';
+    issues: readonly SiteVerticalConfigIssue[];
+}>;
+type SdkConfigureBookingVerticalRequestBase = Readonly<{
+    verticalConfig: ConfiguredSiteVerticalBookingConfig;
+}>;
+/**
+ * Preview may establish the first observed revision. Apply must always carry
+ * that observation; `null` means the caller observed no persisted row.
+ */
+export type SdkConfigureBookingVerticalRequest = Readonly<SdkConfigureBookingVerticalRequestBase & {
+    mode: 'preview';
+    expectedRevision?: string | null;
+}> | Readonly<SdkConfigureBookingVerticalRequestBase & {
+    mode: 'apply';
+    expectedRevision: string | null;
+}>;
+export type SdkConfigureBookingVerticalResponse = SdkCommandApplicationResult<Readonly<{
+    verticalConfig: ConfiguredSiteVerticalBookingConfig;
+    revision: string | null;
+}>> & Readonly<{
+    warnings?: readonly BookingSettingsCommandWarning[];
+}>;
+export {};

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

@@ -1,14 +1,22 @@
 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 { SdkPullEventOccurrence } from './sdk-event-schedule';
 import type { SiteCommandApplicationResult } from '@riverbankcms/site-commands';
-import type { EventPreset } from './bookingConfig';
+import type { EventPreset } from '../../core/src/index';
 import type { SdkThemeWire } from './sdkThemeWire';
+import type { SdkCatalogButtonStyleControl } from './sdkThemeCatalogContracts';
+export type { SdkCatalogButtonRole, SdkCatalogButtonStyleControl, } from './sdkThemeCatalogContracts';
+import type { SdkPullEventCategory } from './sdkEventCategoryContracts';
+import type { SdkPullSettings } from './sdkSettingsContracts';
+export type { SdkConfigureBookingVerticalRequest, SdkConfigureBookingVerticalResponse, SdkPullSettingsWarning, } from './sdkBookingVerticalContracts';
+export type { SdkPullSettings, SdkPullSettingsResponse } from './sdkSettingsContracts';
+export type { SdkPullEventCategory } from './sdkEventCategoryContracts';
 import type { SdkManagementEvent, SdkManagementEventOccurrence, SdkManagementEventRun } from './sdkManagedEventContracts';
 export type { SdkEventOccurrenceDeletionEligibility, SdkEventOccurrenceProvenance, SdkManagementEvent, SdkManagementEventOccurrence, SdkManagementEventRun, } from './sdkManagedEventContracts';
 /**
@@ -272,7 +280,7 @@ export interface SdkBackfillIdentifiersResult {
 export interface ManagementMediaAsset {
     id: string;
     siteId: string;
-    identifier: string | null;
+    identifier: string;
     storageBucket: string;
     storagePath: string;
     filename: string;
@@ -298,7 +306,7 @@ export interface SdkMediaFinalizeUploadResponse {
     storagePath: string;
     status: 'created' | 'exists';
     assetId: string;
-    identifier: string | null;
+    identifier: string;
 }
 export interface SdkPullMeta {
     pulledAt: string;
@@ -488,26 +496,6 @@ export interface SdkPullNavigationResponse {
     menus: SdkPullNavigationMenu[];
     meta: SdkPullMeta;
 }
-export interface SdkPullSettings {
-    /** Site title (stored on `sites.title`). Present on pull; writable via PATCH. */
-    siteTitle?: string;
-    homepageId: string | null;
-    seoDefaults: {
-        title?: string;
-        description?: string;
-        ogImage?: string;
-        allowIndexingInProduction?: boolean;
-    } | null;
-    logoIdentifier?: string | null;
-    faviconIdentifier?: string | null;
-}
-export interface SdkPullSettingsResponse {
-    settings: SdkPullSettings;
-    warnings?: string[];
-    meta: SdkPullMeta & {
-        updatedAt: string | null;
-    };
-}
 export interface SdkPullFormField {
     id: string;
     label: string;
@@ -597,15 +585,7 @@ export interface SdkCatalogButtonStyle {
     accessibilityLabel: string;
     tags: Record<string, string>;
     defaultParameters: Record<string, unknown>;
-    controls: Array<{
-        kind: 'choice';
-        parameter: string;
-        label: string;
-        options: Array<{
-            value: string;
-            label: string;
-        }>;
-    }>;
+    controls: SdkCatalogButtonStyleControl[];
 }
 export interface SdkCatalogPalette {
     /** Human-readable source alias. */
@@ -828,21 +808,13 @@ 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 SdkPullEvent {
     identifier: string;
+    administrativeStatus: 'active' | 'archived';
     title: string;
     slug: string;
     path: string | null;
@@ -1083,10 +1055,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;
 }>>;

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

@@ -0,0 +1,23 @@
+/** SDK management endpoints that do not belong to a CRUD resource family. */
+export declare const SDK_ENDPOINT_DEFINITIONS: {
+    sdkUpdateSettings: {
+        path: "/sdk/{siteId}/settings";
+        method: "PATCH";
+        auth: "service";
+        responseKind: "json";
+        errors: ("validation:invalid_input" | "server:internal_error")[];
+    };
+    sdkConfigureBookingVertical: {
+        path: "/sdk/{siteId}/settings/booking/vertical";
+        method: "POST";
+        auth: "service";
+        responseKind: "json";
+    };
+    sdkSetupRevalidationWebhook: {
+        path: "/sdk/{siteId}/webhooks/revalidation/setup";
+        method: "POST";
+        auth: "service";
+        responseKind: "json";
+        errors: ("validation:invalid_input" | "server:internal_error")[];
+    };
+};

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/sdkSettingsContracts.d.ts

@@ -0,0 +1,25 @@
+import type { ConfiguredSiteVerticalBookingConfig } from '../../core/src/index';
+import type { SdkPullMeta } from './sdkContracts';
+import type { SdkPullSettingsWarning } from './sdkBookingVerticalContracts';
+export interface SdkPullSettings {
+    /** Site title (stored on `sites.title`). Present on pull; writable via PATCH. */
+    siteTitle?: string;
+    homepageId: string | null;
+    seoDefaults: {
+        title?: string;
+        description?: string;
+        ogImage?: string;
+        allowIndexingInProduction?: boolean;
+    } | null;
+    logoIdentifier?: string | null;
+    faviconIdentifier?: string | null;
+    /** Optional, configured booking vertical for SDK-owned booking surfaces. */
+    verticalConfig?: ConfiguredSiteVerticalBookingConfig;
+}
+export interface SdkPullSettingsResponse {
+    settings: SdkPullSettings;
+    warnings?: readonly (string | SdkPullSettingsWarning)[];
+    meta: SdkPullMeta & {
+        updatedAt: string | null;
+    };
+}

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

@@ -0,0 +1,20 @@
+import type { VariantRole } from '../../theme-core/src/buttons/index';
+export type SdkCatalogButtonRole = VariantRole;
+export type SdkCatalogButtonStyleControl = Readonly<{
+    kind: 'choice';
+    parameter: string;
+    label: string;
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+}> | Readonly<{
+    kind: 'button-hover-by-role';
+    parameter: string;
+    label: string;
+    roles: SdkCatalogButtonRole[];
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+}>;