@riverbankcms/sdk 0.147.0 → 0.149.0

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

@@ -18,6 +18,7 @@ export type SdkBlockAppearanceOutcome = Readonly<{
 }>;
 export type SdkBlockUpsertResponseFields<TWarning> = Readonly<{
     warnings?: TWarning[];
+    designSyncWarning?: import('./siteRuntimeEndpoints').PageBlockDesignSyncWarning;
     /**
      * Present only when appearance intent was explicit. Validation detected
      * before the block write rejects the request; failures after a durable block
@@ -46,3 +47,23 @@ export declare const sdkBlockAppearanceOutcomeSchema: z.ZodDiscriminatedUnion<[z
     message: z.ZodString;
     retryable: z.ZodLiteral<true>;
 }, z.core.$strip>], "kind">;
+export declare const pageBlockDesignSyncWarningSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        failed: "failed";
+        blocked: "blocked";
+        "skipped-invalid": "skipped-invalid";
+    }>;
+    operation: z.ZodEnum<{
+        update: "update";
+        create: "create";
+        delete: "delete";
+        reorder: "reorder";
+    }>;
+    message: z.ZodString;
+    blocker: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodEnum<{
+        draft: "draft";
+        "published-fallback": "published-fallback";
+    }>>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;

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

@@ -461,6 +461,9 @@ export interface SdkPullFormField {
     required?: boolean;
     placeholder?: string;
     helpText?: string;
+    layout?: {
+        width?: 'full' | 'half';
+    };
     options?: Array<{
         value: string;
         label: string;
@@ -922,31 +925,7 @@ export type SdkManagementVenue = SdkPullVenue & {
 export type SdkManagementEventCategory = SdkPullEventCategory & {
     id: string;
 };
-export type SdkEventOccurrenceScheduleInput = {
-    startsAt: string;
-    endsAt: string;
-    durationMinutes?: never;
-} | {
-    startsAt: string;
-    endsAt?: never;
-    durationMinutes: number;
-};
-export type SdkAddEventOccurrenceRequest = SdkEventOccurrenceScheduleInput & {
-    capacity?: number;
-};
-export type SdkEventOccurrenceCapacityIntent = {
-    kind: 'override';
-    capacity: number;
-} | {
-    kind: 'inherit';
-};
-export type SdkUpdateEventOccurrenceRequest = {
-    schedule: SdkEventOccurrenceScheduleInput;
-    capacity?: SdkEventOccurrenceCapacityIntent;
-} | {
-    schedule?: never;
-    capacity: SdkEventOccurrenceCapacityIntent;
-};
+export type { SdkAddEventOccurrenceRequest, SdkCancelEventOccurrenceRequest, SdkEventOccurrenceCapacityIntent, SdkEventOccurrenceScheduleInput, SdkUpdateEventOccurrenceRequest, } from './sdkEventOccurrenceRequestContracts';
 export type SdkPageResponse = SdkCommandApplicationResult<SdkManagementPage>;
 export type SdkUpsertPageResponse = SdkPageResponse & SdkPublicationStageFields<SdkPagePublishErrorCode>;
 export interface SdkDraftPage {
@@ -977,9 +956,7 @@ export type SdkUpsertBlockResponse = SdkCommandApplicationResult<SdkManagementBl
 export type SdkDeleteResponse = SdkCommandApplicationResult<Readonly<{
     deleted: true;
 }>>;
-export interface SdkReorderResponse {
-    reordered: true;
-}
+export type SdkReorderResponse = NonNullable<import('./sitePlatformEndpoints').SitePlatformAPIEndpoints['sdkReorderPageBlocks']['response']>;
 /** Closed publish-failure code union for entry upserts. */
 export type SdkEntryPublishErrorCode = 'PUBLISH_ENTRY_FAILED';
 /** Closed publish-failure code union for page upserts. */

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

@@ -64,7 +64,7 @@ export declare const SDK_EVENT_ENDPOINT_DEFINITIONS: {
         method: "POST";
         auth: "service";
         responseKind: "json";
-        errors: ("resource:not_found" | "resource:conflict" | "server:internal_error")[];
+        errors: ("validation:invalid_input" | "resource:not_found" | "resource:conflict" | "server:internal_error")[];
     };
     sdkDeleteEventOccurrence: {
         path: "/sdk/{siteId}/events/{identifier}/runs/{runIdentifier}/occurrences/{occurrenceId}";

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

@@ -0,0 +1,43 @@
+/**
+ * Request bodies for the SDK's single-date event endpoints (add, update and
+ * cancel one date of a run). Re-exported from `sdkContracts`.
+ */
+export type SdkEventOccurrenceScheduleInput = {
+    startsAt: string;
+    endsAt: string;
+    durationMinutes?: never;
+} | {
+    startsAt: string;
+    endsAt?: never;
+    durationMinutes: number;
+};
+export type SdkAddEventOccurrenceRequest = SdkEventOccurrenceScheduleInput & {
+    capacity?: number;
+    /**
+     * Course runs only: whether everyone enrolled on the run is emailed about
+     * the new date. Defaults to `true`. Everyone enrolled gets the date either
+     * way. Ignored for ordinary events.
+     */
+    notifyAttendees?: boolean;
+};
+export type SdkCancelEventOccurrenceRequest = {
+    /**
+     * Course runs only: whether everyone enrolled on the run is emailed that
+     * the date was dropped. Defaults to `true`. Their places on the run are
+     * kept either way. Ignored for ordinary events.
+     */
+    notifyAttendees?: boolean;
+};
+export type SdkEventOccurrenceCapacityIntent = {
+    kind: 'override';
+    capacity: number;
+} | {
+    kind: 'inherit';
+};
+export type SdkUpdateEventOccurrenceRequest = {
+    schedule: SdkEventOccurrenceScheduleInput;
+    capacity?: SdkEventOccurrenceCapacityIntent;
+} | {
+    schedule?: never;
+    capacity: SdkEventOccurrenceCapacityIntent;
+};

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

@@ -79,8 +79,10 @@ export interface SdkManagementEventOccurrence {
     confirmedPlaces?: number;
     /**
      * Places held by every row that is not cancelled, so waitlisted and pending
-     * rows are counted too. This is the figure `deletionEligibility` is decided
-     * on: a date with anyone still attached to it cannot be deleted.
+     * rows are counted too. `deletionEligibility` is decided on the records a
+     * delete would lose, which also includes a course run's records of any
+     * status: a dropped course date keeps them so it can be put back, and
+     * cannot be deleted while it does.
      *
      * The name is kept for compatibility with published CLI output. For
      * "how full is this date", read `confirmedPlaces`.

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

@@ -10,6 +10,7 @@ export interface SdkPullEvent extends SdkPulledCourseBooking {
     slug: string;
     path: string | null;
     preset: EventPreset;
+    categoryRef: string | null;
     runRefs: readonly [string, ...string[]];
     content: {
         summary?: string;
@@ -36,10 +37,16 @@ export interface SdkPullEventRun {
     capacity: number | null;
     bookingOffer: SdkEventBookingOffer;
     venueRef: string | null;
-    categoryRef: string | null;
     formRef: string | null;
     settings: Record<string, unknown>;
-    presentation: Record<string, unknown> | null;
+    /**
+     * Ignored. Listing words come from the event's own page (`content`). The
+     * current server sends null only because CLIs published before issue 1538
+     * require the key, and servers from before then send a stored object, so
+     * readers accept anything here. It goes once the supported CLI floor passes
+     * that release.
+     */
+    presentation?: unknown;
     tags: string[];
     updatedAt: string;
     createdAt: string;

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

@@ -195,7 +195,7 @@ export type SeoSearchQueriesResponse = {
         pageCount: number;
     }>;
 };
-export declare function applySeoChanges(client: ApiClient, body: ApplySeoChangesRequest): Promise<ApplySeoChangesResponse>;
-export declare function getSeoOverview(apiClient: ApiClient, query: SeoOverviewQuery, options?: RequestInit): Promise<SeoOverviewResponse>;
-export declare function getSeoPages(apiClient: ApiClient, query: SeoSearchPagesQuery, options?: RequestInit): Promise<SeoSearchPagesResponse>;
-export declare function getSeoQueries(apiClient: ApiClient, query: SeoSearchQueriesQuery, options?: RequestInit): Promise<SeoSearchQueriesResponse>;
+export declare function applySeoChanges(client: ApiClient<'applySeoChanges'>, body: ApplySeoChangesRequest): Promise<ApplySeoChangesResponse>;
+export declare function getSeoOverview(apiClient: ApiClient<'getSeoOverview'>, query: SeoOverviewQuery, options?: RequestInit): Promise<SeoOverviewResponse>;
+export declare function getSeoPages(apiClient: ApiClient<'getSeoPages'>, query: SeoSearchPagesQuery, options?: RequestInit): Promise<SeoSearchPagesResponse>;
+export declare function getSeoQueries(apiClient: ApiClient<'getSeoQueries'>, query: SeoSearchQueriesQuery, options?: RequestInit): Promise<SeoSearchQueriesResponse>;

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

@@ -1,6 +1,6 @@
 import type { ApiClient } from './request';
 import type { AppointmentService, CreateAppointmentServiceRequest, UpdateAppointmentServiceRequest } from './types';
-export declare function listAppointmentServicesRequest(apiClient: ApiClient, siteId: string, options?: RequestInit): Promise<AppointmentService[]>;
-export declare function createAppointmentServiceRequest(apiClient: ApiClient, siteId: string, payload: CreateAppointmentServiceRequest, options?: RequestInit): Promise<AppointmentService>;
-export declare function updateAppointmentServiceRequest(apiClient: ApiClient, siteId: string, serviceId: string, payload: UpdateAppointmentServiceRequest, options?: RequestInit): Promise<AppointmentService>;
-export declare function deleteAppointmentServiceRequest(apiClient: ApiClient, siteId: string, serviceId: string, options?: RequestInit): Promise<void>;
+export declare function listAppointmentServicesRequest(apiClient: ApiClient<'listAppointmentServices'>, siteId: string, options?: RequestInit): Promise<AppointmentService[]>;
+export declare function createAppointmentServiceRequest(apiClient: ApiClient<'createAppointmentService'>, siteId: string, payload: CreateAppointmentServiceRequest, options?: RequestInit): Promise<AppointmentService>;
+export declare function updateAppointmentServiceRequest(apiClient: ApiClient<'updateAppointmentService'>, siteId: string, serviceId: string, payload: UpdateAppointmentServiceRequest, options?: RequestInit): Promise<AppointmentService>;
+export declare function deleteAppointmentServiceRequest(apiClient: ApiClient<'deleteAppointmentService'>, siteId: string, serviceId: string, options?: RequestInit): Promise<void>;

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

@@ -3,6 +3,7 @@ import type { PublicProfile, RectificationHistoryPropagationPlan, RectificationI
 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';
@@ -10,7 +11,7 @@ import type { AcceptAdminInviteRequest, AcceptAdminInviteResponse, AcceptSiteInv
 import type { AdminRoleMutationResponse, RevokeAdminRoleRequest, StartImpersonationRequest, StartImpersonationResponse, StopImpersonationRequest, StopImpersonationResponse, UpsertAdminRoleRequest } from './admin/types';
 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';
@@ -145,7 +146,7 @@ type DsarExecutionOutcomeApi = {
     detail: string;
     message: string;
 };
-export type SiteManagementAPIEndpoints = BillingAPIEndpoints & SiteLifecycleAPIEndpoints & PageSurfaceAPIEndpoints & {
+export type SiteManagementAPIEndpoints = BillingAPIEndpoints & EditLeaseAPIEndpoints & SiteLifecycleAPIEndpoints & PageSurfaceAPIEndpoints & {
     listContentEntries: APIEndpoint<never, {
         siteId: string;
         type: string;
@@ -203,7 +204,11 @@ export type SiteManagementAPIEndpoints = BillingAPIEndpoints & SiteLifecycleAPIE
         siteId: string;
         type: string;
         entryId: string;
-    }, ContentEntryOrPageResponse>;
+    }, {
+        entry: ContentEntryEditorDetail;
+    } | {
+        entry: PageRecord;
+    }>;
     listContentEntryVersions: APIEndpoint<never, VersionHistoryListQuery & {
         siteId: string;
         type: string;
@@ -232,7 +237,9 @@ export type SiteManagementAPIEndpoints = BillingAPIEndpoints & SiteLifecycleAPIE
         siteId: string;
         type: string;
         entryId: string;
-    }, ContentEntryOrPageResponse>;
+    }, ContentEntryDetailResponse & Readonly<{
+        optimisticHash: string;
+    }>>;
     runSdkWorkflow: APIEndpoint<never, {
         siteId: string;
         type: string;
@@ -245,7 +252,7 @@ export type SiteManagementAPIEndpoints = BillingAPIEndpoints & SiteLifecycleAPIE
         entryId: string;
         runId: string;
     }, WorkflowRunStatusResponse>;
-    publishContentEntry: APIEndpoint<Record<string, unknown> | undefined, {
+    publishContentEntry: APIEndpoint<PublishContentEntryBody | undefined, {
         siteId: string;
         type: string;
         entryId: string;
@@ -256,17 +263,17 @@ export type SiteManagementAPIEndpoints = BillingAPIEndpoints & SiteLifecycleAPIE
         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

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

@@ -1,6 +1,10 @@
 import type { AppointmentBookingQuestionsTask } from "./bookingOperations";
 import type { SiteRole } from "./siteMembers";
 import type { AdminManagedSubscriptionActionChoice, ManagedManualBillingReason, SiteBillingArrangement, SiteBillingArrangementChangeOrigin, SiteBillingArrangementKind, SiteBillingArrangementSubscriptionAction, SiteBillingManualReviewPayload, SiteBillingManualReviewResolutionAction, SiteBillingManualReviewStatus } from "../../billing/src/site-arrangements";
+/** Questions apply to the booking but its task can't be shown right now. */
+type AppointmentBookingQuestionsTaskState = AppointmentBookingQuestionsTask | {
+    kind: 'unavailable';
+};
 /**
  * Site Operations Contracts
  *
@@ -40,7 +44,7 @@ export type PortalAppointmentWithDetails = {
     status: string;
     notes?: string | null;
     createdAt: string;
-    beforeYouCome: AppointmentBookingQuestionsTask | null;
+    beforeYouCome: AppointmentBookingQuestionsTaskState | null;
     cancellation: {
         canCancel: boolean;
         canAutoRefundOnCancel: boolean;
@@ -547,7 +551,7 @@ export type ReopenFlexibleBalanceBookingAfterNonPaymentCancellationRequest = {
 export type FlexibleBalanceAdminActionResponse = {
     action: "cancelled" | "reopened";
     flexibleBalanceStatus: "cancelled_due_to_non_payment" | "overdue";
-    orderItemId: string;
+    orderId: string;
 };
 export type CreateShopOrderPaymentLinkResponse = {
     paymentLink: string;

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 {};