@riverbankcms/sdk 0.147.0 → 0.148.0

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

package/dist/_dts/billing/src/components/index.d.ts

@@ -1,11 +1,20 @@
-import { type PlannerNoChange } from '../../../core/src/index';
-import { type BillingPlanId } from '../plans/types';
-export type BillingComponentInterval = 'month' | 'year';
+import { type Brand, type PlannerNoChange } from '../../../core/src/index';
+import { type BillingPlanId, type PaidBillingPlanId } from '../plans/types';
 export type BillingComponentCurrencyCode = string;
-export type BillingComponentId = string;
+export type BillingComponentId = Brand<string, 'BillingComponentId'>;
+export type BillingComponentIdempotencyKey = Brand<string, 'BillingComponentIdempotencyKey'>;
+export type BillingComponentSnapshotHash = Brand<string, 'BillingComponentSnapshotHash'>;
 export type BillingComponentSiteId = string;
 export type BillingComponentSiteDomainId = string;
-export type BillingComponentKind = 'plan_base' | 'custom_site_price' | 'extra_site' | 'managed_domain_overage';
+/** Brand a component id read from a trusted store (a database row or a fixture). */
+export declare const unsafeAsBillingComponentId: (id: string) => BillingComponentId;
+export declare const unsafeAsBillingComponentIdempotencyKey: (key: string) => BillingComponentIdempotencyKey;
+export declare const unsafeAsBillingComponentSnapshotHash: (hash: string) => BillingComponentSnapshotHash;
+/** Components derived on every read; they are never stored. */
+export type ComputedBillingComponentKind = 'plan_base' | 'custom_site_price';
+/** Components stored in `billing_components`; mirrors the database enum. */
+export type PersistedBillingComponentKind = 'extra_site' | 'managed_domain_overage';
+export type BillingComponentKind = ComputedBillingComponentKind | PersistedBillingComponentKind;
 export type BillingComponentPersistenceStatus = 'pending_acceptance' | 'accepted' | 'sync_failed' | 'registrar_failed' | 'registrar_succeeded_persist_failed' | 'active' | 'ending' | 'ended' | 'failed';
 export type EndableBillingComponentStatus = Extract<BillingComponentPersistenceStatus, 'active' | 'ending'>;
 export type EndableBillingComponentKind = Extract<BillingComponentKind, 'extra_site' | 'managed_domain_overage'>;
@@ -14,10 +23,9 @@ export type BillingComponentProposalPlan = Readonly<{
     pendingSourceKey: string;
     userId: string;
     siteId: string | null;
-    kind: 'extra_site' | 'managed_domain_overage';
+    kind: PersistedBillingComponentKind;
     amountCents: number;
     currency: string;
-    interval: BillingComponentInterval;
     sourceEntity: BillingComponentSourceEntityPlan;
     snapshotHash: string;
     pricingSnapshot: unknown;
@@ -51,7 +59,6 @@ export type BillingComponentBase<TKind extends BillingComponentKind, TOrigin ext
     source: BillingComponentSourceForKind<TKind>;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>;
 export type MacadamiaExtraSiteBillingComponentProposalPlan = BillingComponentProposalPlan & Readonly<{
     kind: 'extra_site';
@@ -122,9 +129,7 @@ export type BillingTotalPricePlan = BillingBasePricePlan & Readonly<{
     componentBreakdown: readonly BillingComponent[];
 }>;
 export type BillingComponentCompatibilityMismatch = Readonly<{
-    tag: 'component_interval_currency_mismatch';
-    componentInterval: BillingComponentInterval;
-    requestedInterval: BillingComponentInterval;
+    tag: 'component_currency_mismatch';
     componentCurrency: BillingComponentCurrencyCode;
     requestedCurrency: BillingComponentCurrencyCode;
 }>;
@@ -147,7 +152,6 @@ export type BillingComponentSummaryBase<TKind extends BillingComponentKind> = Re
     label: string;
     amountCents: number;
     formatted: string;
-    interval: BillingComponentInterval;
 }>;
 export type BillingComponentSummaryBasePlanComponent = BillingComponentSummaryBase<'plan_base'> & Readonly<{
     source: BillingComponentPlanSource;
@@ -208,13 +212,15 @@ export type MacadamiaExtraSitePricingSnapshot = Readonly<{
     planId: BillingPlanId;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>;
 export type ExtraSitePricingPolicy = Readonly<{
     includedSiteCount: number;
     currency: BillingComponentCurrencyCode;
-    extraSite: Readonly<{
+    extraSite: 
+    /** The plan an upgrade prompt names: the cheapest one that keeps what this plan has and adds extra sites. */
+    Readonly<{
         tag: 'not_supported';
+        minimumPlanId: PaidBillingPlanId;
     }> | Readonly<{
         tag: 'priced';
         monthlyAmountCents: number;
@@ -226,34 +232,22 @@ export type ConfiguredExtraSitePricingPolicy = ExtraSitePricingPolicy & Readonly
         monthlyAmountCents: number;
     }>;
 }>;
-export type MacadamiaSiteAllowancePricingInput = Readonly<{
-    includedLiveSiteCount: number;
-    extraSite: Readonly<{
-        tag: 'not_supported';
-    }> | Readonly<{
-        tag: 'priced';
-        monthlyPricePence: number;
-    }>;
-}>;
 export type ActiveExtraSiteComponentForReconciliation = Readonly<{
     componentId: BillingComponentId;
     siteId: BillingComponentSiteId;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>;
 export type MacadamiaExtraSiteReconciliationAction = Readonly<{
     tag: 'requires_acceptance';
     site: BillableMacadamiaSite;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }> | Readonly<{
     tag: 'create_missing';
     site: BillableMacadamiaSite;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }> | Readonly<{
     tag: 'end_at_period_end';
     component: ActiveExtraSiteComponentForReconciliation;
@@ -265,7 +259,7 @@ export type MacadamiaExtraSiteReconciliationAction = Readonly<{
 }> | Readonly<{
     tag: 'requires_plan_upgrade';
     site: BillableMacadamiaSite;
-    minimumPlanId: 'solo';
+    minimumPlanId: PaidBillingPlanId;
 }>;
 export type MacadamiaExtraSiteReconciliationPlan = PlannerNoChange | Readonly<{
     tag: 'changes_required';
@@ -281,13 +275,12 @@ export type MacadamiaExtraSiteLaunchDecision = Readonly<{
 }> | Readonly<{
     tag: 'requires_plan_upgrade';
     currentPlanId: BillingPlanId;
-    minimumPlanId: 'solo';
+    minimumPlanId: PaidBillingPlanId;
 }> | Readonly<{
     tag: 'requires_acceptance';
     currentPlanId: BillingPlanId;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>;
 export type MacadamiaSiteCreationBillingNotice = Readonly<{
     tag: 'none';
@@ -298,13 +291,12 @@ export type MacadamiaSiteCreationBillingNotice = Readonly<{
 }> | Readonly<{
     tag: 'upgrade_required_on_launch';
     currentPlanId: BillingPlanId;
-    minimumPlanId: 'solo';
+    minimumPlanId: PaidBillingPlanId;
 }> | Readonly<{
     tag: 'extra_site_charge_on_launch';
     currentPlanId: BillingPlanId;
     amountCents: number;
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>;
 export type MacadamiaExtraSiteProposalDecisionPlan = Extract<MacadamiaExtraSiteLaunchDecision, {
     tag: 'requires_acceptance';
@@ -378,7 +370,7 @@ export declare function planBillingComponentEndAtTimestamp(input: Readonly<{
     now: Date;
 }>): BillingComponentTimestampEndPlan;
 export declare function gbpPenceToAmountCents(amountPence: number, currency: BillingComponentCurrencyCode): number;
-export declare function buildMacadamiaExtraSitePricingPolicy(allowance: MacadamiaSiteAllowancePricingInput): ExtraSitePricingPolicy;
+export declare function buildMacadamiaExtraSitePricingPolicy(planId: BillingPlanId): ExtraSitePricingPolicy;
 export declare function buildManagedDomainRegistrarAttemptIdempotencyKey(input: Readonly<{
     componentId: string;
     domain: string;
@@ -408,14 +400,12 @@ export declare function classifyBillingModel(input: Readonly<{
 export declare function planExtraSiteComponents(input: Readonly<{
     sites: readonly BillableMacadamiaSite[];
     policy: ConfiguredExtraSitePricingPolicy;
-    interval?: BillingComponentInterval;
 }>): readonly BillingComponent[];
 export declare function planMacadamiaExtraSiteReconciliation(input: Readonly<{
     sites: readonly BillableMacadamiaSite[];
     activeExtraSiteComponents: readonly ActiveExtraSiteComponentForReconciliation[];
     acceptedSiteIds?: readonly BillingComponentSiteId[];
     policy: ExtraSitePricingPolicy;
-    interval?: BillingComponentInterval;
 }>): MacadamiaExtraSiteReconciliationPlan;
 export declare function evaluateMacadamiaExtraSiteLaunchDecision(input: Readonly<{
     siteId: BillingComponentSiteId;
@@ -426,14 +416,12 @@ export declare function evaluateMacadamiaExtraSiteLaunchDecision(input: Readonly
         componentId?: BillingComponentId;
     }>[];
     policy: ExtraSitePricingPolicy;
-    interval?: BillingComponentInterval;
 }>): MacadamiaExtraSiteLaunchDecision;
 export declare function macadamiaExtraSiteLaunchDecisionToCreationBillingNotice(decision: MacadamiaExtraSiteLaunchDecision): MacadamiaSiteCreationBillingNotice;
 export declare function evaluateMacadamiaSiteCreationBillingNotice(input: Readonly<{
     currentPlanId: BillingPlanId;
     currentLiveSiteCount: number;
     policy: ExtraSitePricingPolicy;
-    interval?: BillingComponentInterval;
 }>): MacadamiaSiteCreationBillingNotice;
 export declare function resolveBillingComponents(input: Readonly<{
     basePlan: BillingComponent;
@@ -454,16 +442,13 @@ export declare function toBillingSiteCostBreakdown(input: Readonly<{
 export declare function planCustomSitePriceComponents(input: Readonly<{
     siteBreakdown: readonly BillingSiteCostBreakdown[];
     currency: BillingComponentCurrencyCode;
-    interval: BillingComponentInterval;
 }>): readonly BillingComponent[];
 export declare function validateBillingComponentCompatibility(input: Readonly<{
     component: BillingComponent;
-    requestedInterval: BillingComponentInterval;
     requestedCurrency: BillingComponentCurrencyCode;
 }>): BillingComponentCompatibilityMismatch | null;
 export declare function planBillingTotalPrice(input: Readonly<{
     planId: string;
-    interval: BillingComponentInterval;
     currency: BillingComponentCurrencyCode;
     siteBreakdown: readonly BillingSiteCostBreakdown[];
     persistedComponents: readonly PersistedBillingComponent[];
@@ -521,5 +506,5 @@ export declare function asBillingComponentProposalPlan<TIdempotencyKey, TPending
  * programming/configuration error into every runtime caller.
  */
 export declare function asBillingComponentProposalPricingSnapshot<TPricingSnapshot>(value: unknown, parse: BillingComponentProposalPricingSnapshotParser<TPricingSnapshot>, description?: string): TPricingSnapshot;
-export declare function hashBillingComponentSnapshot(snapshot: unknown): string;
+export declare function hashBillingComponentSnapshot(snapshot: unknown): BillingComponentSnapshotHash;
 export declare function stableJson(value: unknown): string;

package/dist/_dts/billing/src/membership/index.d.ts

@@ -1,11 +1,10 @@
-import type { BillingInterval, BillingPlanId, PlanEntitlements } from '../plans/types';
+import type { BillingPlanId, PlanEntitlements } from '../plans/types';
 import { type SubscriptionRepository, type SubscriptionRecord } from '../subscriptions/store';
 import { type PlanStanding } from '../plans/standing';
 export interface MembershipState {
     userId: string;
     planStanding: 'paid' | 'payment_recovery' | 'free';
     planId: BillingPlanId;
-    interval: BillingInterval;
     status: SubscriptionRecord['status'];
     currentPeriodEnd: string;
     cancelAtPeriodEnd: boolean;
@@ -19,7 +18,6 @@ export interface MembershipSummary {
     planStanding: 'paid' | 'payment_recovery' | 'free';
     /** Effective entitlement plan. Provider subscription identity remains in the repository. */
     planId: BillingPlanId;
-    interval: BillingInterval;
     status: SubscriptionRecord['status'];
     currentPeriodEnd: string;
     cancelAtPeriodEnd: boolean;