@riverbankcms/sdk 0.104.3 → 0.108.0

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

@@ -1,5 +1,6 @@
 import type { FieldDefinition, FieldDefinitionInput, SdkCustomBlock, SdkCustomBlockInput, SiteFooterContent, Theme } from '../../blocks/src/index';
 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';
 /**
@@ -294,6 +295,27 @@ export interface SdkMediaFinalizeUploadResponse {
 export interface SdkPullMeta {
     pulledAt: string;
 }
+/**
+ * Explicitly describes payload truncation applied by a pull endpoint.
+ * Pagination metadata remains responsible for caller-requested pages.
+ */
+export type SdkPullTruncationMeta = {
+    truncated: false;
+    returned: number;
+    capPerType?: never;
+    capTotal?: never;
+    droppedTypes?: never;
+} | ({
+    truncated: true;
+    returned: number;
+    droppedTypes: readonly [string, ...string[]];
+} & ({
+    capPerType: number;
+    capTotal?: number;
+} | {
+    capPerType?: number;
+    capTotal: number;
+}));
 export interface SdkPullSiteInfoResponse {
     supabaseUrl: string;
     meta: {
@@ -336,6 +358,76 @@ export interface SdkPullPagesResponse {
     pages: SdkPullPage[];
     meta: SdkPullMeta;
 }
+export interface SdkGetPageBlock {
+    id: string;
+    identifier: string;
+    kind: string;
+    position: number;
+    data: Record<string, unknown>;
+    contentHash: string;
+}
+export interface SdkGetPageBlockResponse {
+    block: SdkGetPageBlock;
+}
+/**
+ * A single PATCH operation against a block's draft content.
+ *
+ * Discriminated on `op`. Only `set` exists today; additional operations
+ * (e.g. `unset`) extend this union without breaking existing callers.
+ *
+ * `path` must resolve to a manifest-defined field of the block (dot/bracket
+ * syntax, e.g. `title`, `items[0].label`, `cta.label`). Paths that do not
+ * resolve to a manifest field — including prototype-chain segments such as
+ * `__proto__` — are rejected with a 400 naming the offending operation index.
+ *
+ * Numeric repeater indices must address an EXISTING item (strictly below the
+ * current array length). To append or resize, `set` the whole repeater field.
+ */
+export type SdkPatchPageBlockOperation = Readonly<{
+    op: 'set';
+    path: string;
+    value: JsonValue;
+}>;
+/**
+ * Body for `PATCH pages/{identifier}/blocks/{blockIdentifier}`.
+ *
+ * Operations apply atomically to an in-memory copy of the block's draft
+ * data; the result is validated once against the block manifest, then
+ * persisted in a single guarded draft write (published rows are untouched —
+ * publish remains page-boundary). Any invalid operation aborts the whole
+ * request.
+ *
+ * `baseContentHash` is required and must equal the `contentHash` returned by
+ * the block GET. On mismatch (including a concurrent write landing between
+ * read and write) the endpoint returns 409 carrying
+ * `SdkPatchPageBlockStaleContentFieldError` in `fieldErrors`.
+ */
+export interface SdkPatchPageBlockBody {
+    operations: readonly SdkPatchPageBlockOperation[];
+    baseContentHash: string;
+}
+export declare const SDK_PATCH_STALE_CONTENT_FIELD = "baseContentHash";
+export declare const SDK_PATCH_STALE_CONTENT_CODE = "STALE_CONTENT";
+/**
+ * Typed stale-conflict detail for block PATCH 409 responses, transported in
+ * the standard envelope's `fieldErrors`. `message` is EXACTLY the current
+ * draft content hash (no prose) — echo it back as `baseContentHash` to
+ * retry. The SDK client surfaces this as a discriminated
+ * `BlockPatchStaleContentError` so callers never string-sniff.
+ */
+export interface SdkPatchPageBlockStaleContentFieldError {
+    field: typeof SDK_PATCH_STALE_CONTENT_FIELD;
+    code: typeof SDK_PATCH_STALE_CONTENT_CODE;
+    /** Exactly the current draft content hash. */
+    message: string;
+}
+/**
+ * Success response mirrors the block GET shape; `block.contentHash` is the
+ * NEW draft content hash (use it as `baseContentHash` for the next patch).
+ */
+export interface SdkPatchPageBlockResponse {
+    block: SdkGetPageBlock;
+}
 export interface SdkPullNavigationItem {
     id: string;
     menuId: string;
@@ -355,6 +447,7 @@ export interface SdkPullNavigationMenu {
     name: string;
     isPrimary: boolean;
     isFooter: boolean;
+    footerRole: 'main' | 'legal-policy' | null;
     items: SdkPullNavigationItem[];
     createdAt: string;
     updatedAt: string;
@@ -423,6 +516,12 @@ export interface SdkPullThemeResponse {
     theme: Theme | null;
     themeId: string | null;
     selectionId: string | null;
+    /**
+     * Current style-selection concurrency token. Pass this value as
+     * `baseSelectionVersion` when applying a style; it is 0 when no selection
+     * exists.
+     */
+    selectionVersion: number;
     meta: SdkPullThemeMeta;
 }
 export interface SdkPullFooterMeta extends SdkPullMeta {
@@ -622,8 +721,7 @@ export interface SdkPullEntriesResponse {
     }>;
     meta: SdkPullMeta & {
         entries: Record<string, SdkPullEntryTimestamps>;
-        truncated: boolean;
-        truncationMessage?: string;
+        truncation: SdkPullTruncationMeta;
     };
     pagination: SdkPullPagination;
 }
@@ -641,8 +739,7 @@ export interface SdkPullEntriesAllResponse {
         totalEntries: number;
         contentTypes: string[];
         entries: Record<string, SdkPullEntryTimestamps>;
-        truncated: boolean;
-        truncationMessage?: string;
+        truncation: SdkPullTruncationMeta;
     };
 }
 export interface SdkManagementPage {
@@ -700,6 +797,31 @@ export type SdkManagementCourseRun = SdkPullCourseRun & {
 export interface SdkPageResponse {
     page: SdkManagementPage;
 }
+export type SdkUpsertPageResponse = SdkPageResponse & SdkPublicationStageFields<SdkPagePublishErrorCode>;
+export interface SdkDraftPage {
+    identifier: string;
+    hasUnpublishedChanges: boolean;
+    status: 'draft' | 'published';
+}
+export interface SdkDraftEntry {
+    contentType: string;
+    identifier: string;
+    status: 'draft' | 'published';
+}
+/**
+ * Cross-type overview of everything with pending (unpublished) changes.
+ * Fully enumerated server-side — a resource appears here iff it is a draft or
+ * carries unpublished changes. There is no cap and no post-pagination filter.
+ */
+export interface SdkPullDraftsResponse {
+    pages: SdkDraftPage[];
+    entries: SdkDraftEntry[];
+    summary: {
+        pageCount: number;
+        entryCount: number;
+    };
+    meta: SdkPullMeta;
+}
 export interface SdkUpsertBlockResponse {
     block: SdkManagementBlock;
 }
@@ -709,9 +831,58 @@ export interface SdkDeleteResponse {
 export interface SdkReorderResponse {
     reordered: true;
 }
-export interface SdkUpsertEntryResponse {
-    entry: Omit<SdkManagementEntry, 'publishedData'>;
+/** Closed publish-failure code union for entry upserts. */
+export type SdkEntryPublishErrorCode = 'PUBLISH_ENTRY_FAILED';
+/** Closed publish-failure code union for page upserts. */
+export type SdkPagePublishErrorCode = 'PUBLISH_PAGE_FAILED';
+/**
+ * Machine-readable detail for a publish that failed after a successful save.
+ * `TCode` is the endpoint's closed code union — an entry response cannot carry
+ * a page code and vice versa. `message` is a sanitized public message; the raw
+ * internal cause is logged server-side, never sent over the wire.
+ */
+export interface SdkPublishError<TCode extends string> {
+    code: TCode;
+    message: string;
 }
+/**
+ * Outcome of the optional publish stage on an entry/page upsert.
+ *
+ * Mutation and publication are NOT atomic (page publish is explicitly
+ * non-transactional), so the save and the publish are reported as distinct
+ * stages. Modeled as a discriminated union on `published` so a success can
+ * never carry an error and a failure can never omit one.
+ *
+ * Accepted limitations (documented, not bugs to fix here):
+ * - Page publish is a non-transactional multi-step flow: a mid-loop failure can
+ *   leave partial published state (some blocks promoted). The envelope reports
+ *   `published: false` and re-running publish is safe/idempotent.
+ * - The entity returned alongside a successful publish comes from a re-read
+ *   after the publish, not an atomic snapshot; a concurrent write in that
+ *   window can be reflected in the returned entity.
+ */
+export type SdkPublicationOutcome<TCode extends string> = {
+    published: true;
+} | {
+    published: false;
+    publishError: SdkPublishError<TCode>;
+};
+/**
+ * Publication-stage fields for upsert responses, correlated so invalid states
+ * are unrepresentable: a draft upsert carries neither field (response is
+ * byte-identical to the pre-publication-intent contract), and a publish-intent
+ * upsert always carries both `saved: true` and a publication outcome.
+ */
+export type SdkPublicationStageFields<TCode extends string> = {
+    saved?: never;
+    publication?: never;
+} | {
+    saved: true;
+    publication: SdkPublicationOutcome<TCode>;
+};
+export type SdkUpsertEntryResponse = {
+    entry: Omit<SdkManagementEntry, 'publishedData'>;
+} & SdkPublicationStageFields<SdkEntryPublishErrorCode>;
 export interface SdkPublishOrUnpublishEntryResponse {
     entry: Omit<SdkManagementEntry, 'publishedData'>;
 }
@@ -772,6 +943,7 @@ export interface SdkUpsertNavigationMenuResponse {
         name: string;
         isPrimary: boolean;
         isFooter: boolean;
+        footerRole: 'main' | 'legal-policy' | null;
         items: SdkPullNavigationItem[];
         createdAt: string;
         updatedAt: string;

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

@@ -89,8 +89,8 @@ export declare const siteBannerSettingsSchema: z.ZodDiscriminatedUnion<[z.ZodObj
             routeId: z.ZodString;
             entityId: z.ZodString;
             entityType: z.ZodEnum<{
-                page: "page";
                 content: "content";
+                page: "page";
             }>;
             href: z.ZodString;
             title: z.ZodString;
@@ -155,8 +155,8 @@ export declare const siteBannerSettingsInputSchema: z.ZodDiscriminatedUnion<[z.Z
             routeId: z.ZodString;
             entityId: z.ZodString;
             entityType: z.ZodEnum<{
-                page: "page";
                 content: "content";
+                page: "page";
             }>;
             href: z.ZodString;
             title: z.ZodString;

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

@@ -540,6 +540,7 @@ export type SendShopOrderPaymentReminderResponse = {
     recipientEmail: string;
 };
 export type SettleShopOrderPaymentRequest = {
+    operationId: string;
     action: "mark_paid" | "mark_waived" | "record_partial_payment";
     amountCents?: number | null;
     externalReference?: string | null;