@riverbankcms/sdk 0.107.0 → 0.109.0

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

@@ -1,32 +1,81 @@
-import type { RectificationHistoryPropagationPlan, RectificationIdentityBoundary, RectificationIssueUrl, RectificationSurface } from "../../core/src/index";
-import type { CamelizeKeys, DbRow, DbJson } from "../../db/src/index";
-import type { APIEndpoint } from "./apiEndpointTypes";
-import type { AcceptAdminInviteRequest, AcceptAdminInviteResponse, AcceptSiteInvitationRequest, AcceptSiteInvitationResponse, AddCustomDomainRequest, AddCustomDomainResponse, AdminChangePlanRequest, AdminChangePlanResponse, AdminDeleteUserResponse, AuthInviteContinueRequest, AuthInviteContinueResponse, AuthInviteRegisterRequest, AuthInviteRegisterResponse, AuthResetCompleteRequest, AuthResetCompleteResponse, AuthSubmissionResult, BulkOperationResult, ChangePlanRequest, ChangePlanResponse, CreateAdminInviteRequest, CreateAdminInviteResponse, CreateAdminUserRequest, CreateAdminUserResponse, CreateAllowedDomainRequest, CreateAllowedDomainResponse, DeleteAllowedDomainResponse, DomainConfigResult, DomainSearchResultResponse, CurrentUserPractitionerLinkResponse, InviteSiteMemberRequest, InviteSiteMemberResponse, LinkCurrentUserPractitionerRequest, ListAdminInvitesResponse, ListAllowedDomainsResponse, ListSiteMembersResponse, LookupSiteDomainRequest, LookupSiteDomainResponse, MfaBackupCodesOverviewResponse, MfaBackupCodesRotateResponse, MfaOverviewResponse, MfaPhoneChallengeRequest, MfaPhoneChallengeResponse, MfaPhoneEnrollRequest, MfaPhoneEnrollResponse, MfaPhoneVerifyRequest, MfaTotpActivateRequest, MfaTotpEnrollResponse, MfaTotpVerifyRequest, MfaTotpVerifyResponse, ReauthSubmissionResult, RegisterDomainRequestPayload, RegisterDomainResponse, RegistrarBooleanMutationRequest, RegistrarLifecycleResponse, RegistrarRenewalPostureResponse, RegisterSiteDomainRequest, RegisterSiteDomainResponse, RemoveSiteMemberResponse, RevokeAdminInviteResponse, RevokeSiteInvitationResponse, ResendSiteInvitationResponse, SetHomepageRequest, SetHomepageResponse, SiteDomainContactPayload, SiteDomainRecord, TransferSiteOwnershipRequest, TransferSiteOwnershipResponse, UpdateSiteMemberRoleRequest, UpdateSiteMemberRoleResponse } from "./accessAdmin";
-import type { AdminRoleMutationResponse, RevokeAdminRoleRequest, StartImpersonationRequest, StartImpersonationResponse, StopImpersonationRequest, StopImpersonationResponse, UpsertAdminRoleRequest } from "./admin/types";
-import type { AccountRevokeSessionsBody, AccountRevokeSessionsResponse, AccountUpdatePasswordBody, AccountUpdatePasswordResponse, CreateManualSiteRequest, CreateManualSiteResponse } from "./siteOperations";
-import type { BookingSessionCancelAppointmentRequest, BookingSessionCancelAppointmentResponse, BookingSessionCreateAppointmentRequest, BookingSessionCreateAppointmentResponse, BookingSessionGetAppointmentResponse, BookingSessionListEligibleAppointmentPackagesResponse, BookingSessionGetEventResponse, BookingSessionListAppointmentsResponse, BookingSessionListEventsResponse, BookingSessionListMembershipsResponse, BookingSessionListPassesResponse, BookingSessionMeResponse, BookingSessionUpdateMeRequest, BookingSessionUpdateMeResponse, PublicBookingAppointmentStatusResponse, PublicBookingAvailabilityQuery, PublicBookingAvailableDatesResponse, PublicBookingAvailableSlotsResponse, PublicBookingService, PublicWeeklySlotAvailabilityQuery, PublicWeeklySlotAvailabilityResponse, PublicCreateBookingAppointmentRequest, PublicCreateBookingAppointmentResponse, ReferenceOptionsResponse } from "./bookingOperations";
-import type { ContentEntryOrPageResponse, ContentEntrySummary, ExportFormSubmissionsCsvQuery, ExportFormSubmissionsCsvResponse, CreateFormSubmissionRectificationAnnotationRequest, CreateFormSubmissionRectificationAnnotationResponse, FormRecord, FormSubmissionWithRectificationAnnotations, FormSummary, NavigationItemRecord, NavigationMenuWithItems, PublicFormRecord, PublishedContentEntryOrPageResponse, RunSdkWorkflowResponse, ScheduledContentEntryOrPageResponse, WorkflowRunStatusResponse } from "./contentRuntime";
-import type { GetVersionHistoryResponse, ListVersionHistoryResponse, RestoreVersionHistoryRequest, RestoreVersionHistoryResponse, VersionHistoryListQuery } from "./contentVersionHistory";
-import type { ApplyContentTemplateAddonRequest, ContentTemplateDetailsResponse, CreateTemplateBlockRequest, GetTransformsResponse, ReorderTemplateBlocksRequest, SerializedContentTypeSummary, UpdateContentTemplateBlockBindingsRequest, UpdateContentTemplateBlockRequest } from "./contentTypes";
-import type { LinkPayload, RoutableContentItem, SitemapRouteItem } from "./navigation/types";
-import type { RouteMetadataPayload, RouteMetadataResponse } from "./routes";
-import type { SiteAnalyticsSettingsPayload, SiteAnalyticsSettingsResponse } from "./siteAnalytics";
-import type { SiteBannerSettingsPayload, SiteBannerSettingsResponse } from "./siteBanner";
-import type { GeneratedIconSetGenerateRequest, GeneratedIconSetGenerateResponse, GeneratedIconSetListRequest, GeneratedIconSetListResponse, SiteIconStyleGuideResponse, SiteIconStyleGuideUpdateRequest } from "./siteIcons";
-import type { AiBrandGuidelinesGenerateRequest, AiBrandGuidelinesGenerateResponse, AiBrandGuidelinesGenerationContextResponse, SiteAiBrandGuidelinesPayload, SiteAiBrandGuidelinesResponse, SiteAiProfilePayload, SiteAiProfileResponse, SiteGenerationIntakePayload, SiteGenerationIntakeResponse } from "./siteOnboarding";
-import type { SitePrivacySettingsPayload, SitePrivacySettingsResponse } from "./privacyPolicy";
-import type { MaintenanceSettingsPayload, MaintenanceSettingsResponse, SiteBusinessAddressPayload, SiteBusinessAddressResponse, SiteFooterBlocksEditorResponse, SiteGeneralSettingsPayload, SiteGeneralSettingsResponse, SiteLayoutSettingsPayload, SiteLayoutSettingsResponse, UpdateSiteDeploymentModePayload, UpdateSiteDeploymentModeResponse, UpdateSiteFooterBlocksPayload, UpdateSiteFooterBlocksResponse } from "./siteSettings";
+import type { FooterCompositionV1, PublicProfile, RectificationHistoryPropagationPlan, RectificationIdentityBoundary, RectificationIssueUrl, RectificationSurface } from '../../core/src/index';
+import type { CamelizeKeys, DbRow, DbJson } from '../../db/src/index';
+import type { APIEndpoint } from './apiEndpointTypes';
+import type { AcceptAdminInviteRequest, AcceptAdminInviteResponse, AcceptSiteInvitationRequest, AcceptSiteInvitationResponse, AddCustomDomainRequest, AddCustomDomainResponse, AdminChangePlanRequest, AdminChangePlanResponse, AdminDeleteUserResponse, AuthInviteContinueRequest, AuthInviteContinueResponse, AuthInviteRegisterRequest, AuthInviteRegisterResponse, AuthResetCompleteRequest, AuthResetCompleteResponse, AuthSubmissionResult, BulkOperationResult, ChangePlanRequest, ChangePlanResponse, CreateAdminInviteRequest, CreateAdminInviteResponse, CreateAdminUserRequest, CreateAdminUserResponse, CreateAllowedDomainRequest, CreateAllowedDomainResponse, DeleteAllowedDomainResponse, DomainConfigResult, DomainSearchResultResponse, CurrentUserPractitionerLinkResponse, InviteSiteMemberRequest, InviteSiteMemberResponse, LinkCurrentUserPractitionerRequest, ListAdminInvitesResponse, ListAllowedDomainsResponse, ListSiteMembersResponse, LookupSiteDomainRequest, LookupSiteDomainResponse, MfaBackupCodesOverviewResponse, MfaBackupCodesRotateResponse, MfaOverviewResponse, MfaPhoneChallengeRequest, MfaPhoneChallengeResponse, MfaPhoneEnrollRequest, MfaPhoneEnrollResponse, MfaPhoneVerifyRequest, MfaTotpActivateRequest, MfaTotpEnrollResponse, MfaTotpVerifyRequest, MfaTotpVerifyResponse, ReauthSubmissionResult, RegisterDomainRequestPayload, RegisterDomainResponse, RegistrarBooleanMutationRequest, RegistrarLifecycleResponse, RegistrarRenewalPostureResponse, RegisterSiteDomainRequest, RegisterSiteDomainResponse, RemoveSiteMemberResponse, RevokeAdminInviteResponse, RevokeSiteInvitationResponse, ResendSiteInvitationResponse, SetHomepageRequest, SetHomepageResponse, SiteDomainContactPayload, SiteDomainRecord, TransferSiteOwnershipRequest, TransferSiteOwnershipResponse, UpdateSiteMemberRoleRequest, UpdateSiteMemberRoleResponse } from './accessAdmin';
+import type { AdminRoleMutationResponse, RevokeAdminRoleRequest, StartImpersonationRequest, StartImpersonationResponse, StopImpersonationRequest, StopImpersonationResponse, UpsertAdminRoleRequest } from './admin/types';
+import type { AccountRevokeSessionsBody, AccountRevokeSessionsResponse, AccountUpdatePasswordBody, AccountUpdatePasswordResponse, CreateManualSiteRequest, CreateManualSiteResponse } from './siteOperations';
+import type { BookingSessionCancelAppointmentRequest, BookingSessionCancelAppointmentResponse, BookingSessionCreateAppointmentRequest, BookingSessionCreateAppointmentResponse, BookingSessionGetAppointmentResponse, BookingSessionListEligibleAppointmentPackagesResponse, BookingSessionGetEventResponse, BookingSessionListAppointmentsResponse, BookingSessionListEventsResponse, BookingSessionListMembershipsResponse, BookingSessionListPassesResponse, BookingSessionMeResponse, BookingSessionUpdateMeRequest, BookingSessionUpdateMeResponse, PublicBookingAppointmentStatusResponse, PublicBookingAvailabilityQuery, PublicBookingAvailableDatesResponse, PublicBookingAvailableSlotsResponse, PublicBookingService, PublicWeeklySlotAvailabilityQuery, PublicWeeklySlotAvailabilityResponse, PublicCreateBookingAppointmentRequest, PublicCreateBookingAppointmentResponse, ReferenceOptionsResponse } from './bookingOperations';
+import type { ContentEntryOrPageResponse, ContentEntrySummary, ExportFormSubmissionsCsvQuery, ExportFormSubmissionsCsvResponse, CreateFormSubmissionRectificationAnnotationRequest, CreateFormSubmissionRectificationAnnotationResponse, FormRecord, FormSubmissionWithRectificationAnnotations, FormSummary, NavigationItemRecord, NavigationMenuWithItems, PublicFormRecord, PublishedContentEntryOrPageResponse, RunSdkWorkflowResponse, ScheduledContentEntryOrPageResponse, WorkflowRunStatusResponse } from './contentRuntime';
+import type { GetVersionHistoryResponse, ListVersionHistoryResponse, RestoreVersionHistoryRequest, RestoreVersionHistoryResponse, VersionHistoryListQuery } from './contentVersionHistory';
+import type { ApplyContentTemplateAddonRequest, ContentTemplateDetailsResponse, CreateTemplateBlockRequest, GetTransformsResponse, ReorderTemplateBlocksRequest, SerializedContentTypeSummary, UpdateContentTemplateBlockBindingsRequest, UpdateContentTemplateBlockRequest } from './contentTypes';
+import type { LinkPayload, RoutableContentItem, SitemapRouteItem } from './navigation/types';
+import type { RouteMetadataPayload, RouteMetadataResponse } from './routes';
+import type { PageSurfaceEditorDocument } from './contentRuntime';
+import type { ContentRouteRecord } from './types';
+import type { SiteAnalyticsSettingsPayload, SiteAnalyticsSettingsResponse } from './siteAnalytics';
+import type { SiteBannerSettingsPayload, SiteBannerSettingsResponse } from './siteBanner';
+import type { GeneratedIconSetGenerateRequest, GeneratedIconSetGenerateResponse, GeneratedIconSetListRequest, GeneratedIconSetListResponse, SiteIconStyleGuideResponse, SiteIconStyleGuideUpdateRequest } from './siteIcons';
+import type { AiBrandGuidelinesGenerateRequest, AiBrandGuidelinesGenerateResponse, AiBrandGuidelinesGenerationContextResponse, SiteAiBrandGuidelinesPayload, SiteAiBrandGuidelinesResponse, SiteAiProfilePayload, SiteAiProfileResponse, SiteGenerationIntakePayload, SiteGenerationIntakeResponse } from './siteOnboarding';
+import type { SitePrivacySettingsPayload, SitePrivacySettingsResponse } from './privacyPolicy';
+import type { MaintenanceSettingsPayload, MaintenanceSettingsResponse, SiteBusinessAddressPayload, SiteBusinessAddressResponse, SiteFooterBlocksEditorResponse, SiteGeneralSettingsPayload, SiteGeneralSettingsResponse, SiteLayoutSettingsPayload, SiteLayoutSettingsResponse, UpdateSiteDeploymentModePayload, UpdateSiteDeploymentModeResponse, UpdateSiteFooterBlocksPayload, UpdateSiteFooterBlocksResponse } from './siteSettings';
 /**
  * Site-management endpoints collect dashboard/admin/auth/content-management API shapes
  * that still belong to the aggregate contract layer but no longer need to live inline in
  * `types.ts`.
  */
-type Site = CamelizeKeys<DbRow<"sites">>;
-type DsarRunKindApi = "preview_export" | "execute_actions";
-type DsarExecutionModeApi = "preview_only" | "confirmed_execute";
-type DsarRunStatusApi = "running" | "previewed" | "completed" | "partially_failed" | "failed";
-type DsarSurfaceNameApi = "booking_customer" | "person_record" | "appointment" | "event_registration" | "order" | "form_submission" | "portal_session" | "email_audit" | "newsletter_subscriber";
-type DsarExecutableSurfaceNameApi = "portal_session" | "newsletter_subscriber" | "form_submission";
+type Site = CamelizeKeys<DbRow<'sites'>>;
+export type FooterCompositionSnapshot = Readonly<{
+    kind: 'ready';
+    composition: FooterCompositionV1;
+    revision: number;
+}> | Readonly<{
+    kind: 'missing';
+}> | Readonly<{
+    kind: 'invalid';
+    message: string;
+}>;
+export type FooterCompositionUpdateRequest = Readonly<{
+    composition: FooterCompositionV1;
+    baseRevision: number;
+}>;
+export type FooterCompositionUpdateResponse = Readonly<{
+    kind: 'updated';
+    snapshot: Extract<FooterCompositionSnapshot, {
+        kind: 'ready';
+    }>;
+}> | Readonly<{
+    kind: 'conflict';
+    authoritative: FooterCompositionSnapshot;
+}>;
+export type PublicProfileSnapshot = Readonly<{
+    kind: 'ready';
+    profile: PublicProfile;
+    revision: number;
+    canonicalTimeZone: string;
+    hasBusinessAddress: boolean;
+    hasLogo: boolean;
+}> | Readonly<{
+    kind: 'invalid';
+    message: string;
+}>;
+export type PublicProfileUpdateRequest = Readonly<{
+    profile: PublicProfile;
+    baseRevision: number;
+}>;
+export type PublicProfileUpdateResponse = Readonly<{
+    kind: 'updated';
+    snapshot: Extract<PublicProfileSnapshot, {
+        kind: 'ready';
+    }>;
+}> | Readonly<{
+    kind: 'conflict';
+    authoritative: PublicProfileSnapshot;
+}>;
+type DsarRunKindApi = 'preview_export' | 'execute_actions';
+type DsarExecutionModeApi = 'preview_only' | 'confirmed_execute';
+type DsarRunStatusApi = 'running' | 'previewed' | 'completed' | 'partially_failed' | 'failed';
+type DsarSurfaceNameApi = 'booking_customer' | 'person_record' | 'appointment' | 'event_registration' | 'order' | 'form_submission' | 'portal_session' | 'email_audit' | 'newsletter_subscriber';
+type DsarExecutableSurfaceNameApi = 'portal_session' | 'newsletter_subscriber' | 'form_submission';
 type DsarRunCountsApi = {
     matchedSurfaces: number;
     includedSurfaces: number;
@@ -35,25 +84,25 @@ type DsarRunCountsApi = {
     failedActions: number;
 };
 type DsarPreviewExecutableDecisionApi = {
-    kind: "executable";
+    kind: 'executable';
     surface: DsarSurfaceNameApi;
-    action: "revoke_sessions" | "anonymize" | "hard_delete";
+    action: 'revoke_sessions' | 'anonymize' | 'hard_delete';
     rationale: string;
-    exportRepresentation: "raw_record" | "summary_record" | "metadata_only";
+    exportRepresentation: 'raw_record' | 'summary_record' | 'metadata_only';
     requiresConfirmation: true;
 };
 type DsarPreviewReportOnlyDecisionApi = {
-    kind: "report_only";
+    kind: 'report_only';
     surface: DsarSurfaceNameApi;
-    action: "retain_with_reason" | "manual_follow_up";
+    action: 'retain_with_reason' | 'manual_follow_up';
     rationale: string;
-    exportRepresentation: "raw_record" | "summary_record" | "metadata_only";
+    exportRepresentation: 'raw_record' | 'summary_record' | 'metadata_only';
     policySource?: string;
 };
 type DsarPreviewExcludedDecisionApi = {
-    kind: "excluded";
+    kind: 'excluded';
     surface: DsarSurfaceNameApi;
-    reason: "not_found" | "not_in_scope" | "not_yet_supported" | "insufficient_linkage";
+    reason: 'not_found' | 'not_in_scope' | 'not_yet_supported' | 'insufficient_linkage';
     rationale: string;
 };
 type DsarPreviewDecisionApi = DsarPreviewExecutableDecisionApi | DsarPreviewReportOnlyDecisionApi | DsarPreviewExcludedDecisionApi;
@@ -97,20 +146,20 @@ type DsarPreviewBundleApi = {
 };
 type DsarExecutionOutcomeApi = {
     surface: DsarExecutableSurfaceNameApi;
-    action: "revoke_sessions" | "anonymize";
-    status: "executed";
+    action: 'revoke_sessions' | 'anonymize';
+    status: 'executed';
     detail: string;
     changedCount: number;
 } | {
     surface: DsarExecutableSurfaceNameApi;
-    action: "revoke_sessions" | "anonymize";
-    status: "skipped";
+    action: 'revoke_sessions' | 'anonymize';
+    status: 'skipped';
     detail: string;
-    reason: "not_currently_executable" | "already_handled" | "not_found";
+    reason: 'not_currently_executable' | 'already_handled' | 'not_found';
 } | {
     surface: DsarExecutableSurfaceNameApi;
-    action: "revoke_sessions" | "anonymize";
-    status: "failed";
+    action: 'revoke_sessions' | 'anonymize';
+    status: 'failed';
     detail: string;
     message: string;
 };
@@ -215,6 +264,31 @@ export type SiteManagementAPIEndpoints = {
         type: string;
         entryId: string;
     }, ContentEntryOrPageResponse>;
+    updatePageSurfaceDraftContent: APIEndpoint<{
+        data: Record<string, unknown>;
+        optimisticHash: string;
+    }, {
+        siteId: string;
+        pageSurfaceId: string;
+    }, {
+        document: PageSurfaceEditorDocument;
+    }>;
+    discardPageSurfaceDraftContent: APIEndpoint<{
+        optimisticHash: string;
+    }, {
+        siteId: string;
+        pageSurfaceId: string;
+    }, {
+        document: PageSurfaceEditorDocument;
+    }>;
+    updatePageSurfaceRouteMetadata: APIEndpoint<Pick<RouteMetadataPayload, 'draftSlug' | 'draftMetaTitle' | 'draftMetaDescription' | 'ogImageId'> & {
+        expectedDraftUpdatedAt: string | null;
+    }, {
+        siteId: string;
+        pageSurfaceId: string;
+    }, {
+        route: ContentRouteRecord;
+    }>;
     runSdkWorkflow: APIEndpoint<never, {
         siteId: string;
         type: string;
@@ -345,7 +419,7 @@ export type SiteManagementAPIEndpoints = {
         domainId: string;
     }, {
         domain: string;
-        domainType: "registered" | "custom";
+        domainType: 'registered' | 'custom';
         configStatus: string | null;
         nameservers: {
             expected: string[];
@@ -545,6 +619,18 @@ export type SiteManagementAPIEndpoints = {
     updateSiteLayoutSettings: APIEndpoint<SiteLayoutSettingsPayload, {
         siteId: string;
     }, SiteLayoutSettingsResponse>;
+    getFooterComposition: APIEndpoint<never, {
+        siteId: string;
+    }, FooterCompositionSnapshot>;
+    updateFooterComposition: APIEndpoint<FooterCompositionUpdateRequest, {
+        siteId: string;
+    }, FooterCompositionUpdateResponse>;
+    getPublicProfile: APIEndpoint<never, {
+        siteId: string;
+    }, PublicProfileSnapshot>;
+    updatePublicProfile: APIEndpoint<PublicProfileUpdateRequest, {
+        siteId: string;
+    }, PublicProfileUpdateResponse>;
     updateSiteBannerSettings: APIEndpoint<SiteBannerSettingsPayload, {
         siteId: string;
     }, SiteBannerSettingsResponse>;
@@ -619,7 +705,7 @@ export type SiteManagementAPIEndpoints = {
     }, AdminDeleteUserResponse>;
     adminListAxiomLogs: APIEndpoint<never, {
         tail?: number;
-        mode?: "all" | "errors" | "warnings";
+        mode?: 'all' | 'errors' | 'warnings';
         since?: string;
         until?: string;
         search?: string;
@@ -629,7 +715,7 @@ export type SiteManagementAPIEndpoints = {
     }>;
     adminListErrorLogs: APIEndpoint<never, {
         tail?: number;
-        mode?: "errors" | "warnings";
+        mode?: 'errors' | 'warnings';
         since?: string;
         until?: string;
         search?: string;
@@ -639,15 +725,15 @@ export type SiteManagementAPIEndpoints = {
     }>;
     adminListRetentionJobRuns: APIEndpoint<never, {
         limit?: number;
-        jobKind?: "portal_session_cleanup" | "portal_exchange_code_cleanup" | "analytics_transition" | "webhook_delivery_log_cleanup" | "email_audit_body_cleanup" | "request_log_cleanup" | "newsletter_subscriber_minimization" | "form_submission_anonymization" | "booking_operational_retention_review" | "appointment_operational_retention_review" | "event_registration_retention_review" | "order_operational_minimization_review";
-        status?: "running" | "completed" | "partially_failed" | "failed";
-        executionMode?: "scheduled" | "manual" | "dry_run";
+        jobKind?: 'portal_session_cleanup' | 'portal_exchange_code_cleanup' | 'analytics_transition' | 'webhook_delivery_log_cleanup' | 'email_audit_body_cleanup' | 'request_log_cleanup' | 'newsletter_subscriber_minimization' | 'form_submission_anonymization' | 'booking_operational_retention_review' | 'appointment_operational_retention_review' | 'event_registration_retention_review' | 'order_operational_minimization_review';
+        status?: 'running' | 'completed' | 'partially_failed' | 'failed';
+        executionMode?: 'scheduled' | 'manual' | 'dry_run';
     }, {
         runs: Array<{
             id: string;
-            jobKind: "portal_session_cleanup" | "portal_exchange_code_cleanup" | "analytics_transition" | "webhook_delivery_log_cleanup" | "email_audit_body_cleanup" | "request_log_cleanup" | "newsletter_subscriber_minimization" | "form_submission_anonymization" | "booking_operational_retention_review" | "appointment_operational_retention_review" | "event_registration_retention_review" | "order_operational_minimization_review";
-            executionMode: "scheduled" | "manual" | "dry_run";
-            status: "running" | "completed" | "partially_failed" | "failed";
+            jobKind: 'portal_session_cleanup' | 'portal_exchange_code_cleanup' | 'analytics_transition' | 'webhook_delivery_log_cleanup' | 'email_audit_body_cleanup' | 'request_log_cleanup' | 'newsletter_subscriber_minimization' | 'form_submission_anonymization' | 'booking_operational_retention_review' | 'appointment_operational_retention_review' | 'event_registration_retention_review' | 'order_operational_minimization_review';
+            executionMode: 'scheduled' | 'manual' | 'dry_run';
+            status: 'running' | 'completed' | 'partially_failed' | 'failed';
             triggerSource: string;
             dataClasses: string[];
             startedAt: string;
@@ -710,11 +796,11 @@ export type SiteManagementAPIEndpoints = {
         counts: DsarRunCountsApi;
     }>;
     adminRunFormSubmissionRetention: APIEndpoint<{
-        executionMode: "dry_run" | "manual";
+        executionMode: 'dry_run' | 'manual';
         siteId?: string;
         limit?: number;
     }, never, {
-        outcome: "executed" | "already_running";
+        outcome: 'executed' | 'already_running';
         runId: string;
         beforeIso: string;
         candidateCount: number;
@@ -728,7 +814,7 @@ export type SiteManagementAPIEndpoints = {
     }>;
     adminListSupabaseLogs: APIEndpoint<never, {
         tail?: number;
-        mode?: "all" | "errors" | "warnings";
+        mode?: 'all' | 'errors' | 'warnings';
         since?: string;
         until?: string;
         search?: string;
@@ -738,7 +824,7 @@ export type SiteManagementAPIEndpoints = {
     }>;
     adminListVercelLogs: APIEndpoint<never, {
         tail?: number;
-        mode?: "all" | "errors" | "warnings";
+        mode?: 'all' | 'errors' | 'warnings';
         since?: string;
         until?: string;
         search?: string;
@@ -767,6 +853,7 @@ export type SiteManagementAPIEndpoints = {
         name: string;
         isPrimary?: boolean;
         isFooter?: boolean;
+        footerRole?: 'main' | 'legal-policy' | null;
         position?: number;
     }, {
         siteId: string;
@@ -783,6 +870,7 @@ export type SiteManagementAPIEndpoints = {
         name?: string;
         isPrimary?: boolean;
         isFooter?: boolean;
+        footerRole?: 'main' | 'legal-policy' | null;
         position?: number;
     }, {
         siteId: string;
@@ -798,7 +886,7 @@ export type SiteManagementAPIEndpoints = {
     }>;
     createNavigationItem: APIEndpoint<{
         label: string;
-        type: "link" | "dropdown";
+        type: 'link' | 'dropdown';
         link?: LinkPayload;
         parentId?: string | null;
         orderIndex?: number;
@@ -811,7 +899,7 @@ export type SiteManagementAPIEndpoints = {
     }>;
     updateNavigationItem: APIEndpoint<{
         label?: string;
-        type?: "link" | "dropdown";
+        type?: 'link' | 'dropdown';
         link?: LinkPayload;
         parentId?: string | null;
         orderIndex?: number;
@@ -966,12 +1054,8 @@ export type SiteManagementAPIEndpoints = {
         siteId: string;
         ids?: string;
     }, {
-        services: Array<{
-            id: string;
-            siteId: string;
-            title: string;
+        services: Array<Omit<PublicBookingService, 'description'> & {
             description?: string;
-            durationMinutes?: number;
         }>;
     }>;
     getPublicBookingService: APIEndpoint<never, {
@@ -1012,7 +1096,7 @@ export type SiteManagementAPIEndpoints = {
         appointmentId: string;
     }, BookingSessionCancelAppointmentResponse>;
     bookingSessionListEvents: APIEndpoint<never, {
-        status?: "confirmed" | "waitlist" | "cancelled";
+        status?: 'confirmed' | 'waitlist' | 'cancelled';
         upcoming?: string;
         occurrenceId?: string;
         limit?: string;

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

@@ -10,7 +10,7 @@ import type { CreateManagementKeyRequest, CreateManagementKeyResponse, CreateSit
 import type { GetSiteInspirationAnalysisResponse, ListSiteInspirationAnalysesResponse } from './siteGeneration';
 import type { ListGscPropertiesAdminResponse, AuthStatusResponse, CronAppointmentRemindersResponse, CronBillingStatusResponse, CronEventFeedbackEmailsResponse, CronEventOccurrencesResponse, CronEventRemindersResponse, CronMediaJobsQuery, CronMediaJobsResponse, CronNewsletterSendResponse, CronPaymentReconciliationResponse, CronSeoIngestResponse, CronWaitlistExpiryResponse } from './siteOperations';
 import type { ApplySiteStyleSelectionBody, ApplySiteStyleSelectionResponse } from './siteRuntimeEndpoints';
-import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkBackfillIdentifiersResult, SdkGetCourseResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkGetVenueResponse, SdkListCoursesResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkPullCourseProgram, SdkPullCourseSession, SdkPullCoursesResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullThemeResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpsertBlockResponse, SdkUpsertCourseResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertThemeResponse, SdkUpsertVenueResponse } from './sdkContracts';
+import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkBackfillIdentifiersResult, SdkGetCourseResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListCoursesResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkCatalogThemeResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCapabilitiesResponse, SdkDemoContentResponse, SdkPullCourseProgram, SdkPullCourseSession, SdkPullCoursesResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullThemeResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpsertBlockResponse, SdkUpsertCourseResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertThemeResponse, SdkUpsertVenueResponse } from './sdkContracts';
 import type { SdkEventUpsertBody } from './sdk-event-upsert';
 import type { StripeConnectDisconnectResponse, StripeConnectStartResponse, StripeConnectStatusResponse, UpdateStripeAutomaticTaxRequest } from './billing';
 import type { NavigationLinkInput } from './navigation/types';
@@ -186,6 +186,21 @@ export type SitePlatformAPIEndpoints = {
     sdkPullContentTypes: APIEndpoint<never, {
         siteId: string;
     }, SdkPullContentTypesResponse>;
+    sdkCatalogTheme: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCatalogThemeResponse>;
+    sdkCatalogBlocks: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCatalogBlocksResponse>;
+    sdkCatalogContentTypes: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCatalogContentTypesResponse>;
+    sdkCapabilities: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCapabilitiesResponse>;
+    sdkListDemoContent: APIEndpoint<never, {
+        siteId: string;
+    }, SdkDemoContentResponse>;
     sdkPullPages: APIEndpoint<never, {
         siteId: string;
     }, SdkPullPagesResponse>;
@@ -262,6 +277,11 @@ export type SitePlatformAPIEndpoints = {
         kind: string;
         data: Record<string, unknown>;
         position?: number;
+        /**
+         * Optional catalog-coherence precondition (`catalog/blocks`
+         * `activeTheme.selectionVersion`); mismatch → 409 tag `STALE_CATALOG`.
+         */
+        baseSelectionVersion?: number;
     }, {
         siteId: string;
         identifier: string;
@@ -278,6 +298,11 @@ export type SitePlatformAPIEndpoints = {
         identifier: string;
         blockIdentifier: string;
     }, SdkGetPageBlockResponse>;
+    sdkPatchPageBlock: APIEndpoint<SdkPatchPageBlockBody, {
+        siteId: string;
+        identifier: string;
+        blockIdentifier: string;
+    }, SdkPatchPageBlockResponse>;
     sdkReorderPageBlocks: APIEndpoint<{
         identifiers: string[];
     }, {
@@ -291,6 +316,7 @@ export type SitePlatformAPIEndpoints = {
         name: string;
         isPrimary?: boolean;
         isFooter?: boolean;
+        footerRole?: 'main' | 'legal-policy' | null;
         items: readonly SdkUpsertNavigationItemInput[];
     }, {
         siteId: string;
@@ -443,6 +469,13 @@ export type SitePlatformAPIEndpoints = {
         contentType: string;
         data: Record<string, unknown>;
         slug?: string;
+        /**
+         * Raw display ordinal, only accepted for content types with
+         * `ordering.mode: 'manual'` (400 fieldError otherwise). The server never
+         * displaces other entries; equal ordinals resolve deterministically by
+         * (manualOrder ASC, createdAt ASC, id ASC). Callers wanting insert-at-
+         * position semantics reassign ordinals for the affected entries.
+         */
         manualOrder?: number;
         blocks?: Record<string, SdkEntryUpsertSlotBlock[]>;
         publication?: 'draft' | 'publish';
@@ -478,6 +511,7 @@ export type SitePlatformAPIEndpoints = {
         identifier: string;
     }, SdkPublishOrUnpublishEntryResponse>;
     sdkUpdateSettings: APIEndpoint<{
+        siteTitle?: string;
         homepageId?: string | null;
         seoDefaults?: SdkPullSettings['seoDefaults'];
         logoIdentifier?: string | null;

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

@@ -8,7 +8,7 @@ import type { APIEndpoint } from './apiEndpointTypes';
 import type { AnalyticsReportQuery, AnalyticsReportResponse } from './analytics';
 import type { CreateMediaAssetBody, MediaAssetResponse, MediaAssetFileFilterContract, MediaBulkDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse } from './media';
 import type { MediaUsageCheckResponse } from './shared-contracts';
-import type { BlockWithContentResponse, BlockListItem, ContentEntryListStage, EntryPageContentSlotsResponse, ListPublishedEntriesResponse, PageDraftRecord, PublishedBlockBaseline, PublishedContentEntryPreviewResponse, PublishedPostPreviewResponse, SdkBlockContent, SdkRuntimeContentByPathResponse, SdkRouteDecisionResponse, SdkRouteOutcomeResponse, SdkTemplate, SiteBySlugResponse, ThemeGenerationTurn, ThemePreferencesRecord, ThemeRow } from './contentRuntime';
+import type { BlockWithContentResponse, BlockListItem, ContentEntryListStage, EntryPageContentSlotsResponse, PageSurfaceContentSlotsResponse, ListPublishedEntriesResponse, PageDraftRecord, PublishedBlockBaseline, PublishedContentEntryPreviewResponse, PublishedPostPreviewResponse, SdkBlockContent, SdkRuntimeContentByPathResponse, SdkRouteDecisionResponse, SdkRouteOutcomeResponse, SdkTemplate, SiteBySlugResponse, ThemeGenerationTurn, ThemePreferencesRecord, ThemeRow } from './contentRuntime';
 import type { GetVersionHistoryResponse, ListVersionHistoryResponse, RestoreVersionHistoryRequest, RestoreVersionHistoryResponse, VersionHistoryListQuery } from './contentVersionHistory';
 import type { CreateMediaUploadUrlRequest, CreateMediaUploadUrlResponse, CreateSiteLogoUploadUrlRequest, CreateSiteLogoUploadUrlResponse, MediaUploadFinalizeRequest, UploadSiteLogoRequest } from './siteInfrastructure';
 import type { DevToolsGetSiteRoleDowngradeQuery, DevToolsImpersonationResponse, DevToolsSeedResponse, DevToolsSetSiteRoleDowngradeRequest, SiteRoleDowngradeState } from './siteOperations';
@@ -26,37 +26,43 @@ export type SiteThemeSelectionsPayload = {
     headerLookId?: HeaderLookId | null;
     footerLookId?: FooterLookId | null;
 };
-export type ApplySiteStyleSelectionCommonBody = Readonly<{
-    siteStyleId: SiteStyleId;
-    /** Omitted or `null` selects the first button personality recommended by the site style; a value selects that personality. */
-    buttonPersonalityId?: ButtonPersonalityId | null;
-    /** Omitted selects the site style's authoritative concrete typography; a value applies submitted concrete typography. */
-    typography?: Theme['typography'];
-    /** Omitted or `null` selects the first header Look recommended by the site style; a value selects that Look. When both header pair fields are omitted, a supplied Look derives the canonical pair when it has one. */
-    headerLookId?: HeaderLookId | null;
-    /** Omitted or `null` selects the first footer Look recommended by the site style; a value selects that Look. */
-    footerLookId?: FooterLookId | null;
-    baseSelectionVersion: number;
-    /** Omitted or `null` lets the server target the current selection; a value targets that selection row. */
-    selectionId?: string | null;
+export type SiteStyleHeaderSelectionChange = Readonly<{
+    kind: 'default';
+}> | Readonly<{
+    kind: 'legacy';
+    headerLookId: HeaderLookId | null;
+}> | Readonly<{
+    kind: 'canonical';
+    headerLookId: HeaderLookId | null;
+    layoutId: HeaderLayoutId;
+    styleId: HeaderStyleId;
 }>;
-export type ApplySiteStyleSelectionHeaderBody = Readonly<{
-    /** Omit both fields to use the curated site style's canonical header default; when `headerLookId` is supplied, derive the pair from that Look when it has a canonical alias. */
-    headerLayoutId?: undefined;
-    headerStyleId?: undefined;
+export type SiteStyleSelectionChange = Readonly<{
+    kind: 'set-site-style';
+    siteStyleId: SiteStyleId;
 }> | Readonly<{
-    /** Send both fields as `null` to use the legacy header default. */
-    headerLayoutId: null;
-    headerStyleId: null;
+    kind: 'set-button-personality';
+    buttonPersonalityId: ButtonPersonalityId | null;
 }> | Readonly<{
-    /** Canonical header selections are atomic: layout and style must be supplied together. */
-    headerLayoutId: HeaderLayoutId;
-    headerStyleId: HeaderStyleId;
+    kind: 'set-palette';
+    command: PaletteCommand;
+}> | Readonly<{
+    kind: 'set-typography';
+    typography: Theme['typography'] | null;
+}> | Readonly<{
+    kind: 'set-header';
+    selection: SiteStyleHeaderSelectionChange;
+}> | Readonly<{
+    kind: 'set-footer-look';
+    footerLookId: FooterLookId | null;
+}>;
+export type ApplySiteStyleSelectionBody = Readonly<{
+    baseSelectionVersion: number;
+    /** Omitted or `null` lets the server target the current selection. */
+    selectionId?: string | null;
+    /** A non-empty, unique-axis batch. Unmentioned axes are preserved. */
+    changes: readonly [SiteStyleSelectionChange, ...SiteStyleSelectionChange[]];
 }>;
-export type ApplySiteStyleSelectionBody = ApplySiteStyleSelectionCommonBody & Readonly<{
-    /** Omitted selects the site style's recommended curated palette; a command applies that palette operation. */
-    paletteCommand?: PaletteCommand;
-}> & ApplySiteStyleSelectionHeaderBody;
 export type ApplySiteStyleSelectionResponse = Readonly<{
     success: boolean;
     themeId: string;
@@ -486,6 +492,46 @@ export type SiteRuntimeAPIEndpoints = {
     }, {
         ok: boolean;
     }>;
+    listPageSurfaceContentSlots: APIEndpoint<never, {
+        siteId: string;
+        pageSurfaceId: string;
+    }, PageSurfaceContentSlotsResponse>;
+    createPageSurfaceSlotBlock: APIEndpoint<{
+        kind: string;
+        position?: number;
+        purpose?: string;
+        expectedCompositionHash: string;
+    }, {
+        siteId: string;
+        pageSurfaceId: string;
+        slotKey: string;
+    }, {
+        ok: boolean;
+        block: BlockListItem;
+        compositionHash: string;
+    }>;
+    reorderPageSurfaceSlotBlocks: APIEndpoint<{
+        blockIds: string[];
+        expectedCompositionHash: string;
+    }, {
+        siteId: string;
+        pageSurfaceId: string;
+        slotKey: string;
+    }, {
+        ok: boolean;
+        compositionHash: string;
+    }>;
+    deletePageSurfaceSlotBlock: APIEndpoint<{
+        expectedCompositionHash: string;
+    }, {
+        siteId: string;
+        pageSurfaceId: string;
+        slotKey: string;
+        blockId: string;
+    }, {
+        ok: boolean;
+        compositionHash: string;
+    }>;
     createBlock: APIEndpoint<{
         kind: string;
         position?: number;

package/dist/_dts/block-form/src/widgets/BackgroundGradientWidget/BackgroundGradientField.d.ts

@@ -1,6 +1,7 @@
 import type { ReactNode } from 'react';
 import type { FieldWidgetProps } from '../../fields/props';
 import type { TextFieldConfig } from '../../fields/types';
+import { type GradientConfig } from '../../../../blocks/src/index';
 /**
  * BackgroundGradientField
  *
@@ -11,3 +12,11 @@ import type { TextFieldConfig } from '../../fields/types';
  * This is registered as a widget override with key 'backgroundGradient'.
  */
 export declare function BackgroundGradientField({ path, backend, config, }: FieldWidgetProps<string | null, TextFieldConfig>): ReactNode;
+/**
+ * Attempts to find a preset that matches the given CSS gradient string.
+ *
+ * This is a best-effort reverse lookup - if the CSS was generated from a preset,
+ * we can find and highlight that preset. If it's custom CSS, we return null
+ * and the widget shows no selection.
+ */
+export declare function findPresetFromCss(css: string | null, tokens: Record<string, string>): GradientConfig | null;

package/dist/_dts/block-form/src/widgets/BackgroundGradientWidget/BackgroundGradientWidget.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { GradientConfig } from '../../../../blocks/src/index';
+import { type GradientConfig, type GradientPreset } from '../../../../blocks/src/index';
 export type BackgroundGradientWidgetProps = {
     label: string;
     value: GradientConfig | null;
@@ -9,9 +9,8 @@ export type BackgroundGradientWidgetProps = {
     dataPath?: string;
 };
 /**
- * BackgroundGradientWidget
- *
  * Select a curated gradient from the theme-based library.
  * Gradients use theme color tokens, so they adapt to the site's palette.
  */
-export declare function BackgroundGradientWidget(props: BackgroundGradientWidgetProps): import("react").JSX.Element;
+export declare function BackgroundGradientWidget({ label, value, onChange, description, error, dataPath, }: BackgroundGradientWidgetProps): import("react").JSX.Element;
+export declare function gradientConfigFromPreset(preset: GradientPreset): GradientConfig;