@riverbankcms/sdk 0.146.0 → 0.148.0

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

@@ -1,15 +1,17 @@
+import type { SiteLifecycleAPIEndpoints } from './siteLifecycleEndpoints';
 import type { PublicProfile, RectificationHistoryPropagationPlan, RectificationIdentityBoundary, RectificationIssueUrl, RectificationSurface } from '../../core/src/index';
-import type { CamelizeKeys, DbRow, DbJson } from '../../db/src/index';
+import type { DbJson } from '../../db/src/index';
 import type { APIEndpoint } from './apiEndpointTypes';
 import type { BillingAPIEndpoints } from './billingEndpointTypes';
+import type { EditLeaseAPIEndpoints } from './editLeaseEndpoints';
 import type { CustomDomainConnectionSnapshot, DomainHostingStatus } from './domainConnection';
 import type { AdminListAllowedDomainsQueryOutput } from './schemas/admin-allowed-domains';
 import type { AdminListAxiomLogsQueryOutput, AdminListErrorLogsQueryOutput, AdminListSupabaseLogsQueryOutput, AdminListVercelLogsQueryOutput } from './schemas/admin-observability-logs';
 import type { AcceptAdminInviteRequest, AcceptAdminInviteResponse, AcceptSiteInvitationRequest, AcceptSiteInvitationResponse, AddCustomDomainRequest, AddCustomDomainResponse, AdminDeleteUserResponse, AuthInviteContinueRequest, AuthInviteContinueResponse, AuthInviteRegisterRequest, AuthInviteRegisterResponse, AuthResetCompleteRequest, AuthResetCompleteResponse, AuthSubmissionResult, BulkOperationResult, 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 { AccountRevokeSessionsBody, AccountRevokeSessionsResponse, AccountUpdatePasswordBody, AccountUpdatePasswordResponse } from './siteOperations';
 import type { BookingSessionCancelAppointmentRequest, BookingSessionCancelAppointmentResponse, BookingSessionCreateAppointmentRequest, BookingSessionCreateAppointmentResponse, BookingSessionGetAppointmentResponse, BookingSessionListEligibleAppointmentPackagesResponse, BookingSessionGetEventResponse, BookingSessionListAppointmentsResponse, BookingSessionListEventsResponse, BookingSessionListMembershipsResponse, BookingSessionListPassesResponse, BookingSessionMeResponse, BookingSessionUpdateMeRequest, BookingSessionUpdateMeResponse, PublicBookingAppointmentStatusResponse, PublicBookingAvailabilityQuery, PublicBookingAvailableDatesResponse, PublicBookingAvailableSlotsResponse, PublicBookingService, PublicBookingServicesResponse, 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 { ContentEntryOrPageResponse, ContentEntryEditorDetail, ContentEntryDetailResponse, PageRecord, ContentEntrySummary, ExportFormSubmissionsCsvQuery, ExportFormSubmissionsCsvResponse, CreateFormSubmissionRectificationAnnotationRequest, CreateFormSubmissionRectificationAnnotationResponse, FormRecord, FormSubmissionWithRectificationAnnotations, FormSummary, NavigationItemRecord, NavigationMenuWithItems, PublicFormRecord, PublishContentEntryBody, PublishedContentEntryOrPageResponse, RunSdkWorkflowResponse, ScheduledPublishingRouteResponse, DiscardedContentEntryOrPageResponse, 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';
@@ -28,7 +30,6 @@ export type { FooterCompositionSnapshot, FooterCompositionUpdateRequest, FooterC
  * that still belong to the aggregate contract layer but no longer need to live inline in
  * `types.ts`.
  */
-type Site = CamelizeKeys<DbRow<'sites'>>;
 export type PublicProfileSnapshot = Readonly<{
     kind: 'ready';
     profile: PublicProfile;
@@ -56,7 +57,7 @@ export type PublicProfileUpdateResponse = Readonly<{
 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 DsarSurfaceNameApi = 'booking_customer' | 'person_record' | 'appointment' | 'event_registration' | 'booking_question_answer' | 'order' | 'form_submission' | 'portal_session' | 'email_audit' | 'newsletter_subscriber';
 type DsarExecutableSurfaceNameApi = 'portal_session' | 'newsletter_subscriber' | 'form_submission';
 type DsarRunCountsApi = {
     matchedSurfaces: number;
@@ -145,20 +146,7 @@ type DsarExecutionOutcomeApi = {
     detail: string;
     message: string;
 };
-export type SiteManagementAPIEndpoints = BillingAPIEndpoints & PageSurfaceAPIEndpoints & {
-    createSite: APIEndpoint<{
-        title: string;
-    }, never, {
-        id: string;
-        title: string;
-    }>;
-    createSiteManual: APIEndpoint<CreateManualSiteRequest, never, CreateManualSiteResponse>;
-    updateSite: APIEndpoint<Partial<Site>, never, Partial<Site>>;
-    deleteSite: APIEndpoint<never, {
-        siteId: string;
-    }, {
-        ok: boolean;
-    }>;
+export type SiteManagementAPIEndpoints = BillingAPIEndpoints & EditLeaseAPIEndpoints & SiteLifecycleAPIEndpoints & PageSurfaceAPIEndpoints & {
     listContentEntries: APIEndpoint<never, {
         siteId: string;
         type: string;
@@ -216,7 +204,11 @@ export type SiteManagementAPIEndpoints = BillingAPIEndpoints & PageSurfaceAPIEnd
         siteId: string;
         type: string;
         entryId: string;
-    }, ContentEntryOrPageResponse>;
+    }, {
+        entry: ContentEntryEditorDetail;
+    } | {
+        entry: PageRecord;
+    }>;
     listContentEntryVersions: APIEndpoint<never, VersionHistoryListQuery & {
         siteId: string;
         type: string;
@@ -245,7 +237,9 @@ export type SiteManagementAPIEndpoints = BillingAPIEndpoints & PageSurfaceAPIEnd
         siteId: string;
         type: string;
         entryId: string;
-    }, ContentEntryOrPageResponse>;
+    }, ContentEntryDetailResponse & Readonly<{
+        optimisticHash: string;
+    }>>;
     runSdkWorkflow: APIEndpoint<never, {
         siteId: string;
         type: string;
@@ -258,7 +252,7 @@ export type SiteManagementAPIEndpoints = BillingAPIEndpoints & PageSurfaceAPIEnd
         entryId: string;
         runId: string;
     }, WorkflowRunStatusResponse>;
-    publishContentEntry: APIEndpoint<Record<string, unknown> | undefined, {
+    publishContentEntry: APIEndpoint<PublishContentEntryBody | undefined, {
         siteId: string;
         type: string;
         entryId: string;
@@ -269,17 +263,17 @@ export type SiteManagementAPIEndpoints = BillingAPIEndpoints & PageSurfaceAPIEnd
         siteId: string;
         type: string;
         entryId: string;
-    }, ScheduledContentEntryOrPageResponse>;
+    }, ScheduledPublishingRouteResponse>;
     cancelScheduledContentEntry: APIEndpoint<never, {
         siteId: string;
         type: string;
         entryId: string;
-    }, ScheduledContentEntryOrPageResponse>;
+    }, ScheduledPublishingRouteResponse>;
     discardContentEntry: APIEndpoint<never, {
         siteId: string;
         type: string;
         entryId: string;
-    }, ContentEntryOrPageResponse>;
+    }, DiscardedContentEntryOrPageResponse>;
     unpublishContentEntry: APIEndpoint<never, {
         siteId: string;
         type: string;

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

@@ -9,51 +9,51 @@ export declare const SITE_ROLE_PERMISSION_LEVEL: Record<SiteRole, number>;
  * Lower number sorts earlier in UI role pickers.
  */
 export declare const SITE_ROLE_DISPLAY_ORDER: Record<SiteRole, number>;
-export declare function getSiteMembers(apiClient: ApiClient, { siteId, options, }: {
+export declare function getSiteMembers(apiClient: ApiClient<'listSiteMembers'>, { siteId, options, }: {
     siteId: string;
     options?: RequestInit;
 }): Promise<ListSiteMembersResponse>;
-export declare function inviteSiteMember(apiClient: ApiClient, { siteId, body, options, }: {
+export declare function inviteSiteMember(apiClient: ApiClient<'inviteSiteMember'>, { siteId, body, options, }: {
     siteId: string;
     body: InviteSiteMemberRequest;
     options?: RequestInit;
 }): Promise<InviteSiteMemberResponse>;
-export declare function updateSiteMemberRole(apiClient: ApiClient, { siteId, memberId, body, options, }: {
+export declare function updateSiteMemberRole(apiClient: ApiClient<'updateSiteMemberRole'>, { siteId, memberId, body, options, }: {
     siteId: string;
     memberId: string;
     body: UpdateSiteMemberRoleRequest;
     options?: RequestInit;
 }): Promise<UpdateSiteMemberRoleResponse>;
-export declare function linkCurrentUserPractitioner(apiClient: ApiClient, { siteId, body, options, }: {
+export declare function linkCurrentUserPractitioner(apiClient: ApiClient<'linkCurrentUserPractitioner'>, { siteId, body, options, }: {
     siteId: string;
     body: LinkCurrentUserPractitionerRequest;
     options?: RequestInit;
 }): Promise<CurrentUserPractitionerLinkResponse>;
-export declare function unlinkCurrentUserPractitioner(apiClient: ApiClient, { siteId, options, }: {
+export declare function unlinkCurrentUserPractitioner(apiClient: ApiClient<'unlinkCurrentUserPractitioner'>, { siteId, options, }: {
     siteId: string;
     options?: RequestInit;
 }): Promise<CurrentUserPractitionerLinkResponse>;
-export declare function removeSiteMember(apiClient: ApiClient, { siteId, memberId, options, }: {
+export declare function removeSiteMember(apiClient: ApiClient<'removeSiteMember'>, { siteId, memberId, options, }: {
     siteId: string;
     memberId: string;
     options?: RequestInit;
 }): Promise<RemoveSiteMemberResponse>;
-export declare function revokeSiteInvitation(apiClient: ApiClient, { siteId, invitationId, options, }: {
+export declare function revokeSiteInvitation(apiClient: ApiClient<'revokeSiteInvitation'>, { siteId, invitationId, options, }: {
     siteId: string;
     invitationId: string;
     options?: RequestInit;
 }): Promise<RevokeSiteInvitationResponse>;
-export declare function resendSiteInvitation(apiClient: ApiClient, { siteId, invitationId, options, }: {
+export declare function resendSiteInvitation(apiClient: ApiClient<'resendSiteInvitation'>, { siteId, invitationId, options, }: {
     siteId: string;
     invitationId: string;
     options?: RequestInit;
 }): Promise<ResendSiteInvitationResponse>;
-export declare function transferSiteOwnership(apiClient: ApiClient, { siteId, body, options, }: {
+export declare function transferSiteOwnership(apiClient: ApiClient<'transferSiteOwnership'>, { siteId, body, options, }: {
     siteId: string;
     body: TransferSiteOwnershipRequest;
     options?: RequestInit;
 }): Promise<TransferSiteOwnershipResponse>;
-export declare function acceptSiteInvitation(apiClient: ApiClient, { body, options, }: {
+export declare function acceptSiteInvitation(apiClient: ApiClient<'acceptSiteInvitation'>, { body, options, }: {
     body: AcceptSiteInvitationRequest;
     options?: RequestInit;
 }): Promise<AcceptSiteInvitationResponse>;

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

@@ -89,8 +89,8 @@ export type AiBrandGuidelinesGenerateResponse = {
         stats: SiteContentSamplingStats;
     };
 };
-export type LaunchRequirementId = 'confirm_email' | 'review_generated_site' | 'configure_appointments' | 'configure_events' | 'configure_courses' | 'connect_payments' | 'connect_custom_domain' | 'add_first_offering' | 'add_cover_image' | 'add_public_contact';
-export type LaunchRequirementPackId = 'core' | 'bookings_appointments' | 'bookings_events' | 'bookings_courses' | 'payments' | 'domain' | 'offerings' | 'presence';
+export type LaunchRequirementId = 'confirm_email' | 'review_generated_site' | 'configure_appointments' | 'configure_events' | 'configure_courses' | 'connect_payments' | 'add_first_offering' | 'add_cover_image' | 'add_public_contact';
+export type LaunchRequirementPackId = 'core' | 'bookings_appointments' | 'bookings_events' | 'bookings_courses' | 'payments' | 'offerings' | 'presence';
 export type LaunchRequirementPriority = 'required' | 'recommended' | 'optional';
 export type LaunchRequirementState = 'complete' | 'pending';
 export type LaunchRequirementOwner = 'admin' | 'editor' | 'either';
@@ -129,9 +129,6 @@ export type LaunchRequirementAction = {
     label: string;
 };
 export type LaunchRequirementEvidence = {
-    kind: 'domain_connection';
-    domainIds: readonly string[];
-} | {
     kind: 'derived';
 } | {
     kind: 'acknowledged';
@@ -218,15 +215,6 @@ export type LaunchPublicContactPackState = {
 } | {
     kind: 'missing';
 };
-export type LaunchCustomDomainPackState = {
-    kind: 'connected';
-    domainIds: readonly string[];
-} | {
-    kind: 'pending_verification' | 'partially_connected' | 'check_unavailable';
-    domainIds: readonly string[];
-} | {
-    kind: 'pending_setup';
-};
 /**
  * The exact gap behind a pending requirement, so a presentation can name it
  * ("Set your hours", "Finish setting up Stripe") without re-deriving facts.
@@ -307,8 +295,22 @@ export declare const goLiveSiteRequestSchema: z.ZodObject<{
     acceptExtraSiteCharge: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type GoLiveSiteRequest = z.infer<typeof goLiveSiteRequestSchema>;
+/**
+ * Going live on a trialing plan takes the first payment. When the bank wants
+ * to check it, or the card is declined, the site stays unlaunched and the page
+ * completes the payment with this PaymentIntent client secret, then goes live
+ * again. The secret is never stored or logged.
+ */
 export type GoLiveSiteResponse = {
+    kind: 'launched';
     redirectPath: string;
+} | {
+    kind: 'payment_action_required';
+    clientSecret: string;
+    reason: 'authenticate' | 'new_card';
+    amountPence: number;
+    /** The payment's Stripe mode, which the publishable key must match. */
+    livemode: boolean;
 };
 export type OnboardingPreviewStatusResponse = {
     dashboardUnlocked: boolean;

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

@@ -7,7 +7,7 @@ import type { CheckRedirectQuery, CheckRedirectResponse, CreateRedirectRuleReque
 import type { CreateManagementKeyRequest, CreateManagementKeyResponse, CreateSiteApiKeyRequest, CreateSiteApiKeyResponse, CreateSitePreviewKeyRequest, CreateSitePreviewKeyResponse, CreateWebhookRequest, CreateWebhookResponse, DeleteBackupUploadRequest, DeleteBackupUploadResponse, DeleteWebhookResponse, GetSiteApiKeyAccessLogsResponse, ListSitePreviewKeysResponse, GetWebhookResponse, ImportBackupAsNewSiteRequest, ImportBackupAsNewSiteResponse, ImportSiteBackupRequest, ListManagementKeysResponse, ListSiteApiKeysResponse, ListWebhooksResponse, RevokeManagementKeyRequest, RevokeManagementKeyResponse, RevokeSiteApiKeyResponse, SdkDeploymentHealthResponse, SetupSdkDeploymentRevalidationWebhookRequest, SetupSdkDeploymentRevalidationWebhookResponse, SetupSdkRevalidationWebhookRequest, SetupSdkRevalidationWebhookResponse, UpdateWebhookRequest, UpdateWebhookResponse, BackupImportResponse, BackupPreviewRequest, BackupPreviewResponse, CreateBackupUploadUrlRequest, CreateBackupUploadUrlResponse } from './siteInfrastructure';
 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 { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkAddEventOccurrenceRequest, SdkBackfillIdentifiersResult, SdkEventOccurrenceResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventOccurrencesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaDeleteApplyResponse, SdkMediaDeletePreviewResponse, SdkMediaDownloadResponse, SdkMediaListResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCapabilitiesResponse, SdkConfigureBookingVerticalRequest, SdkConfigureBookingVerticalResponse, SdkDemoContentResponse, SdkDeleteResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkUpdateSettingsInput, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpdateEventOccurrenceRequest, SdkUpsertBlockResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertVenueResponse } from './sdkContracts';
+import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkAddEventOccurrenceRequest, SdkCancelEventOccurrenceRequest, SdkBackfillIdentifiersResult, SdkEventOccurrenceResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventOccurrencesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaDeleteApplyResponse, SdkMediaDeletePreviewResponse, SdkMediaDownloadResponse, SdkMediaListResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCapabilitiesResponse, SdkConfigureBookingVerticalRequest, SdkConfigureBookingVerticalResponse, SdkDemoContentResponse, SdkDeleteResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkUpdateSettingsInput, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpdateEventOccurrenceRequest, SdkUpsertBlockResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertVenueResponse } from './sdkContracts';
 import type { FooterCompositionUpdateRequest } from './siteManagementEndpoints';
 import type { SdkEventUpsertBody } from './sdk-event-upsert';
 import type { SdkEntryPaginationQueryInput } from './schemas/sdk-entries';
@@ -292,7 +292,9 @@ export type SitePlatformAPIEndpoints = import('./sdkEventLifecycle').SdkEventLif
         siteId: string;
         identifier: string;
         blockIdentifier: string;
-    }, SdkDeleteResponse>;
+    }, SdkDeleteResponse & Readonly<{
+        designSyncWarning?: import('./siteRuntimeEndpoints').PageBlockDesignSyncWarning;
+    }>>;
     sdkGetPageBlock: APIEndpoint<never, {
         siteId: string;
         identifier: string;
@@ -310,6 +312,8 @@ export type SitePlatformAPIEndpoints = import('./sdkEventLifecycle').SdkEventLif
         identifier: string;
     }, {
         reordered: true;
+        effect: import('@riverbankcms/site-commands').CommandEffect;
+        designSyncWarning?: import('./siteRuntimeEndpoints').PageBlockDesignSyncWarning;
     }>;
     sdkUpsertNavigationMenu: APIEndpoint<{
         location: 'main' | 'footer' | 'legal';
@@ -416,7 +420,7 @@ export type SitePlatformAPIEndpoints = import('./sdkEventLifecycle').SdkEventLif
         runIdentifier: string;
         occurrenceId: string;
     }, SdkEventOccurrenceResponse>;
-    sdkCancelEventOccurrence: APIEndpoint<never, {
+    sdkCancelEventOccurrence: APIEndpoint<SdkCancelEventOccurrenceRequest, {
         siteId: string;
         identifier: string;
         runIdentifier: 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, MediaDeleteResponse, MediaClassifyJobResponse, MediaJobSummaryResponse, MediaLabelSummary, MediaSettingsResponse } from './media';
 import type { MediaUsageCheckResponse } from './shared-contracts';
-import type { BlockWithContentResponse, BlockListItem, ContentEntryListStage, EntryPageContentSlotsResponse, PageSurfaceContentSlotsResponse, ListPublishedEntriesResponse, PageDraftRecord, PublishedBlockBaseline, PublishedContentEntryPreviewResponse, PublishedPostPreviewResponse, SdkBlockContent, SdkRuntimeContentByPathResponse, SdkRouteDecisionResponse, SdkRouteOutcomeResponse, SdkTemplate, SiteBySlugResponse, ThemePreferencesRecord } from './contentRuntime';
+import type { BlockWithContentResponse, BlockListItem, ContentEntryListStage, EntryPageContentSlotsResponse, PageSurfaceContentSlotsResponse, ListPublishedEntriesResponse, PageDraftRecord, PublishedContentEntryPreviewResponse, PublishedPostPreviewResponse, SdkBlockContent, SdkRuntimeContentByPathResponse, SdkRouteDecisionResponse, SdkRouteOutcomeResponse, SdkTemplate, SiteBySlugResponse, ThemePreferencesRecord } 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';
@@ -184,14 +184,8 @@ export type PageDesignEditorStateResponse = {
     revision: PageDesignRevisionToken;
     editorModel: PageDesignEditorReadModel;
 };
-export type PageBlockDesignSyncWarning = Readonly<{
-    kind: 'blocked' | 'failed' | 'skipped-invalid';
-    operation: 'create' | 'delete' | 'reorder';
-    message: string;
-    blocker?: string;
-    source?: 'draft' | 'published-fallback';
-    reason?: string;
-}>;
+import type { PageBlockDesignSyncWarning } from '@riverbankcms/site-commands';
+export type { PageBlockDesignSyncWarning } from '@riverbankcms/site-commands';
 /**
  * Site runtime endpoints cover theme generation, site lookup, media/content runtime
  * APIs, lightweight dev-tools helpers, and client-side analytics collection that used
@@ -468,7 +462,7 @@ export type SiteRuntimeAPIEndpoints = {
         slotKey: string;
     }, {
         ok: boolean;
-        block: Record<string, unknown>;
+        block: BlockListItem;
     }>;
     reorderEntrySlotBlocks: APIEndpoint<{
         blockIds: string[];
@@ -539,7 +533,7 @@ export type SiteRuntimeAPIEndpoints = {
         pageId: string;
     }, {
         ok: boolean;
-        block: Record<string, unknown>;
+        block: BlockListItem;
         designSyncWarning?: PageBlockDesignSyncWarning;
     }>;
     reorderBlocks: APIEndpoint<{
@@ -599,7 +593,6 @@ export type SiteRuntimeAPIEndpoints = {
         pageId: string;
     }, {
         page: PageDraftRecord;
-        publishedBlocks?: PublishedBlockBaseline[];
     }>;
     discardPageDraft: APIEndpoint<never, {
         siteId: string;

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

@@ -0,0 +1,31 @@
+/** Raw editor baselines travel together with their compare-and-set revisions. */
+export type SdkEditorRevision = Readonly<{
+    content: string;
+    metadata: string | null;
+    contentValues: Record<string, unknown>;
+    publishedContent: Record<string, unknown> | null;
+}>;
+export type SdkRuntimeEntry = {
+    id: string;
+    editorRevision?: SdkEditorRevision;
+    routeId: string | null;
+    type: string | null;
+    title: string;
+    slug: string | null;
+    status: string;
+    publishAt: string | null;
+    path: string | null;
+    draftPath: string | null;
+    content: Record<string, unknown>;
+    draftContent: Record<string, unknown> | null;
+    publishedContent: Record<string, unknown> | null;
+    metaTitle: string | null;
+    draftMetaTitle: string | null;
+    metaDescription: string | null;
+    draftMetaDescription: string | null;
+    ogImageId: string | null;
+    ogImageUrl: string | null;
+    canonicalUrl: string | null;
+    createdAt: string;
+    updatedAt: string;
+};

package/dist/_dts/billing/src/checkout/platform.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Platform Checkout for subscription setup.
+ *
+ * Creates Stripe Checkout sessions for users who need to set up a subscription
+ * to cover their platform costs (site fees, etc.). One builder serves both
+ * presentations: hosted Checkout, where the customer is redirected to Stripe's
+ * page, and embedded Checkout, mounted in our own page with a client secret.
+ */
+import { getStripeClient } from '../stripe/client';
+export type PlatformCheckoutStripeDeps = {
+    getStripeClient: typeof getStripeClient;
+};
+type PlatformCheckoutPresentationFields = {
+    /** Stripe's own page: the customer leaves our site and comes back to one of these. */
+    hosted: Readonly<{
+        successUrl: string;
+        cancelUrl: string;
+    }>;
+    /**
+     * Mounted in our page. Stripe forbids success and cancel URLs here, and
+     * comes back to `returnUrl` with the session id appended.
+     */
+    embedded: Readonly<{
+        returnUrl: string;
+    }>;
+};
+type PlatformCheckoutSessionHandles = {
+    hosted: Readonly<{
+        checkoutUrl: string;
+    }>;
+    /** `livemode` says which publishable key can mount the session. */
+    embedded: Readonly<{
+        clientSecret: string;
+        livemode: boolean;
+    }>;
+};
+export type PlatformCheckoutMode = keyof PlatformCheckoutPresentationFields;
+export type PlatformCheckoutPresentation<M extends PlatformCheckoutMode = PlatformCheckoutMode> = {
+    [K in M]: Readonly<{
+        mode: K;
+    }> & PlatformCheckoutPresentationFields[K];
+}[M];
+export type PlatformCheckoutSession<M extends PlatformCheckoutMode = PlatformCheckoutMode> = {
+    [K in M]: Readonly<{
+        kind: K;
+        sessionId: string;
+    }> & PlatformCheckoutSessionHandles[K];
+}[M];
+export type CreatePlatformCheckoutOptions<M extends PlatformCheckoutMode = PlatformCheckoutMode> = Readonly<{
+    /** Stable for one checkout attempt and safe to pass to Stripe retries. */
+    idempotencyKey: string;
+    /** Stripe customer ID */
+    customerId: string;
+    /** Total price in cents */
+    priceAmountCents: number;
+    /** Currency code (e.g., 'gbp') */
+    currency: string;
+    /** Stripe product ID for platform subscriptions */
+    productId: string;
+    /** Hosted or embedded, with the URLs each one allows. */
+    presentation: PlatformCheckoutPresentation<M>;
+    /** Trial period in days (optional) */
+    trialDays?: number;
+    /** Additional metadata */
+    metadata?: Record<string, string>;
+}>;
+export declare function withCheckoutSessionIdReturn(returnUrl: string): string;
+/**
+ * Create a Stripe Checkout session for platform subscription setup.
+ *
+ * Uses inline price_data so the database remains the source of truth for pricing.
+ * The result matches the requested presentation: a URL to redirect to for
+ * hosted Checkout, or a client secret to mount for embedded Checkout.
+ */
+export declare function createPlatformCheckoutSession<M extends PlatformCheckoutMode>(options: CreatePlatformCheckoutOptions<M>): Promise<PlatformCheckoutSession<M>>;
+export declare function createPlatformCheckoutSessionWithDeps<M extends PlatformCheckoutMode>(deps: PlatformCheckoutStripeDeps, options: CreatePlatformCheckoutOptions<M>): Promise<PlatformCheckoutSession<M>>;
+export {};