@riverbankcms/sdk 0.107.0 → 0.108.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;
@@ -1012,7 +1100,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, 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';
@@ -278,6 +278,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 +296,7 @@ export type SitePlatformAPIEndpoints = {
         name: string;
         isPrimary?: boolean;
         isFooter?: boolean;
+        footerRole?: 'main' | 'legal-policy' | null;
         items: readonly SdkUpsertNavigationItemInput[];
     }, {
         siteId: string;

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';
@@ -486,6 +486,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/blocks/src/primitives/layout/Section.d.ts

@@ -2,7 +2,6 @@ import React from "react";
 import type { PrimitiveProps } from "../types";
 declare const Section: React.ForwardRefExoticComponent<PrimitiveProps & {
     background?: string;
-    allowOverflow?: boolean;
     /** Data slot attribute for CSS targeting */
     "data-slot"?: string;
 } & React.RefAttributes<HTMLElement>>;

package/dist/_dts/blocks/src/rendering/server.d.ts

@@ -4,4 +4,5 @@ export { makeDefaultBlockComponent, renderBlock } from '../system/componentFacto
 export { getDefaultComponentRegistry } from '../system/runtime/components';
 export { siteHeaderManifest } from '../system/blocks/site-header';
 export { siteFooterManifest } from '../system/blocks/site-footer';
+export { buildFooterRuntimeViewModel, type FooterRuntimeModule, type FooterRuntimeViewModel, } from '../system/blocks/site-footer-runtime';
 export { resolveFooterRenderPlan } from '../../../theme-core/src/footer/mode';

package/dist/_dts/blocks/src/system/blocks/site-footer-runtime.d.ts

@@ -0,0 +1,50 @@
+import { type FooterCompositionV1, type FooterMembershipKey, type FooterModuleId, type PublicProfile } from '../../../../core/src/index';
+export type FooterRuntimeModule = Readonly<{
+    id: FooterModuleId;
+    kind: 'brand' | 'navigation' | 'legal-navigation' | 'business-address' | 'contact' | 'opening-hours' | 'social-links' | 'supporting-text' | 'legal';
+    heading: string | null;
+    navigationClassName?: string;
+    showLogo?: boolean;
+    showTitle?: boolean;
+    address?: string;
+    contactLinks?: readonly Readonly<{
+        href: string;
+        label: string;
+    }>[];
+    openingHours?: readonly Readonly<{
+        weekday: string;
+        hours: string;
+    }>[];
+    timeZone?: string;
+    socialLinks?: readonly Readonly<{
+        href: string;
+        label: string;
+        icon: string | null;
+    }>[];
+    content?: Readonly<Record<string, unknown>>;
+}>;
+export type FooterRuntimeViewModel = Readonly<{
+    membershipKey: FooterMembershipKey;
+    regions: readonly FooterRuntimeRegion[];
+}>;
+export type FooterRuntimeGroup = Readonly<{
+    kind: 'identity' | 'main-navigation' | 'visit' | 'legal-ending';
+    modules: readonly FooterRuntimeModule[];
+}>;
+export type FooterRuntimeRegion = Readonly<{
+    kind: 'main' | 'bottom';
+    className: string;
+    groups: readonly FooterRuntimeGroup[];
+}>;
+type FooterRuntimeViewModelInput = Readonly<{
+    composition: FooterCompositionV1;
+    publicProfile: PublicProfile;
+    businessAddress: string | null;
+    hasFooterNavigation: boolean;
+    hasLegalPolicyNavigation?: boolean;
+    hasLogo?: boolean;
+    legalRegion?: 'integrated' | 'separate';
+    layoutVariant?: 'simple' | 'columns' | 'split';
+}>;
+export declare function buildFooterRuntimeViewModel(input: FooterRuntimeViewModelInput): FooterRuntimeViewModel;
+export {};

package/dist/_dts/blocks/src/system/blocks/site-footer.d.ts

@@ -1,53 +1,14 @@
-import type { NodeDefinition } from "../node";
-import type { SystemBlockDefinition } from "../registry";
-export declare const siteFooterManifest: import("..").DefinedBlockManifest<import("..").BlockContentShapeInput<{
-    readonly id: "block.site-footer";
-    readonly title: "Site Footer";
-    readonly category: "layout";
-    readonly fragments: readonly [{
-        readonly fragment: import("..").DefinedFragment<{
-            readonly fields: readonly [{
-                readonly id: "bodyText";
-                readonly type: "richText";
-                readonly label: "Body text";
-                readonly description: "Appears in the main footer area.";
-                readonly ui: {
-                    readonly variant: "limited";
-                };
-            }, {
-                readonly id: "bottomText";
-                readonly type: "richText";
-                readonly label: "Bottom bar text";
-                readonly description: "Appears in the optional footer bottom bar.";
-                readonly ui: {
-                    readonly variant: "limited";
-                };
-            }];
-        }>;
-        readonly fieldPriority: 0;
-    }];
+import type { SystemBlockDefinition } from '../registry';
+import type { FooterRuntimeViewModel } from './site-footer-runtime';
+export declare const siteFooterManifest: import("..").DefinedBlockManifest<{
     readonly skipSectionStyles: true;
-    readonly additionalFields: readonly [{
-        readonly id: "showBusinessAddress";
-        readonly type: "boolean";
-        readonly label: "Add business address to site footer?";
-        readonly required: false;
-        readonly defaultValue: false;
-        readonly ui: {
-            readonly intent: "content";
-        };
-    }];
-    readonly layout: NodeDefinition;
-    readonly description: "Site-wide footer with navigation links and optional columns.";
-    readonly styleTokens: {
-        readonly spacing: "md";
-    };
-    readonly paletteHidden: true;
-}>>;
-export type SiteFooterVariant = "simple" | "columns" | "split";
-export type SiteFooterContent = {
+}>;
+export type SiteFooterVariant = 'simple' | 'columns' | 'split';
+export type SiteFooterContent = Readonly<{
+    /** Legacy storage-only fields. The V1 runtime does not read these values. */
     bodyText?: unknown;
     bottomText?: unknown;
     showBusinessAddress?: boolean | null;
-};
+    footerRuntime?: FooterRuntimeViewModel | null;
+}>;
 export declare const siteFooterBlockDefinition: SystemBlockDefinition<SiteFooterContent>;

package/dist/_dts/blocks/src/system/constants/background.d.ts

@@ -54,7 +54,7 @@ export declare const BACKGROUND_POSITION_PRESETS: readonly [{
     readonly value: "right bottom";
     readonly label: "Right Bottom";
 }];
-export declare const BACKGROUND_POSITION_PRESET_VALUES: ("left" | "right" | "top" | "bottom" | "center" | "right center" | "top left" | "top right" | "bottom left" | "bottom right" | "top center" | "bottom center" | "left center" | "left top" | "right top" | "left bottom" | "right bottom")[];
+export declare const BACKGROUND_POSITION_PRESET_VALUES: ("bottom" | "left" | "right" | "top" | "center" | "right center" | "top left" | "top right" | "bottom left" | "bottom right" | "top center" | "bottom center" | "left center" | "left top" | "right top" | "left bottom" | "right bottom")[];
 /**
  * Maps position keywords to rb-* anchor positioning classes.
  * Used for positioning scaled/overflow images within their containers.

package/dist/_dts/blocks/src/system/icons/registry.d.ts

@@ -2,7 +2,8 @@ import { type CtaIconName } from './cta';
 import { type SemanticIconId } from './semantic';
 import { type IconPickerPreset } from './presets';
 import type { IconComponent } from './svg';
-export type IconName = CtaIconName | SemanticIconId;
+import { type SocialIconName } from './social';
+export type IconName = CtaIconName | SemanticIconId | SocialIconName;
 export type IconIdForPreset<Preset extends IconPickerPreset> = Preset extends 'cta' ? CtaIconName : Preset extends 'feature' ? SemanticIconId : never;
 export type IconPickerOption<Preset extends IconPickerPreset = IconPickerPreset> = {
     id: IconIdForPreset<Preset>;

package/dist/_dts/blocks/src/system/icons/social.d.ts

@@ -0,0 +1,5 @@
+import { type IconComponent } from './svg';
+export declare const SOCIAL_ICON_NAMES: readonly ["SocialFacebook", "SocialInstagram", "SocialLinkedIn", "SocialTikTok", "SocialX", "SocialYouTube"];
+export type SocialIconName = (typeof SOCIAL_ICON_NAMES)[number];
+export declare function isSocialIconName(value: unknown): value is SocialIconName;
+export declare function getSocialIconComponent(value: unknown): IconComponent | null;

package/dist/_dts/blocks/src/system/icons/svg.d.ts

@@ -13,6 +13,7 @@ export type IconSvgProps = Omit<SVGProps<SVGSVGElement>, 'width' | 'height'> & {
     title?: string;
 };
 export type IconComponent = React.ComponentType<IconSvgProps>;
+export declare function createIcon(displayName: string, children: React.ReactNode): IconComponent;
 export declare const ArrowDownIcon: IconComponent;
 export declare const ArrowLeftIcon: IconComponent;
 export declare const ArrowRightIcon: IconComponent;