@riverbankcms/sdk 0.108.0 → 0.111.0

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

@@ -1,21 +1,21 @@
-import type { CourseEnrollmentStatus } from "./courses";
+import type { CourseEnrollmentStatus } from './courses';
 export type ParticipantMessageTarget = {
-    kind: "event_series";
+    kind: 'event_series';
     seriesId: string;
 } | {
-    kind: "event_occurrence";
+    kind: 'event_occurrence';
     seriesId: string;
     occurrenceId: string;
 } | {
-    kind: "course";
+    kind: 'course';
     courseId: string;
     includeStatuses: CourseParticipantMessageStatus[];
 };
-export type CourseParticipantMessageStatus = Extract<CourseEnrollmentStatus, "enrolled" | "completed">;
+export type CourseParticipantMessageStatus = Extract<CourseEnrollmentStatus, 'enrolled' | 'completed'>;
 export type GetParticipantMessageRecipientsRequest = {
     target: ParticipantMessageTarget;
 };
-export type ParticipantRecipientExclusionReason = "missing_email" | "cancelled" | "waitlist" | "duplicate_email" | "payment_pending" | "context_cancelled" | "not_in_scope";
+export type ParticipantRecipientExclusionReason = 'missing_email' | 'cancelled' | 'waitlist' | 'duplicate_email' | 'payment_pending' | 'context_cancelled' | 'not_in_scope';
 export type ParticipantMessageRecipientPreview = {
     email: string;
     displayName: string | null;
@@ -38,7 +38,7 @@ export type ParticipantMessageRecipientSummary = {
     excludedByReason: Partial<Record<ParticipantRecipientExclusionReason, number>>;
     duplicateEmailCount: number;
     copyWarning: {
-        kind: "large_copy_list";
+        kind: 'large_copy_list';
         threshold: number;
         count: number;
     } | null;
@@ -53,15 +53,21 @@ export type ParticipantMessageRecipientsResponse = {
     copyText: string;
 };
 export type ParticipantMessageEmailReadiness = {
-    status: "ready";
+    status: 'ready';
     checkedAt: string;
+    identity: ParticipantMessageEmailIdentity;
 } | {
-    status: "blocked";
+    status: 'blocked';
     checkedAt: string;
     issues: ParticipantMessageEmailReadinessIssue[];
 };
+export type ParticipantMessageEmailIdentity = {
+    sender: string;
+    fromName: string;
+    replyToEmail: string | null;
+};
 export type ParticipantMessageEmailReadinessIssue = {
-    code: "email_transport_unavailable" | "email_identity_unavailable";
+    code: 'email_transport_unavailable' | 'email_identity_unavailable';
     message: string;
 };
 export type SendParticipantMessageRequest = {
@@ -90,7 +96,7 @@ export type ParticipantMessageSendResponse = {
     queuedCount: number;
     failedCount: number;
     duplicateCount: number;
-    status: "sent" | "queued" | "partial_failure" | "failed" | "duplicate";
+    status: 'sent' | 'queued' | 'partial_failure' | 'failed' | 'duplicate';
 };
 export type ListParticipantMessageHistoryRequest = {
     target: ParticipantMessageTarget;
@@ -104,7 +110,7 @@ export type ParticipantMessageHistoryEntry = {
     queuedCount: number;
     failedCount: number;
     duplicateCount: number;
-    status: "sent" | "queued" | "partial_failure" | "failed" | "duplicate";
+    status: 'sent' | 'queued' | 'partial_failure' | 'failed' | 'duplicate';
     createdAt: string;
     updatedAt: string;
 };

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

@@ -302,6 +302,7 @@ export type PublicExperienceAPIEndpoints = {
             id: string;
             startsAt: string;
             endsAt: string;
+            timeZone: string;
             capacityOverride?: number | null;
             overrides?: Record<string, unknown> | null;
         }>;

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

@@ -1,4 +1,5 @@
-import type { FieldDefinition, FieldDefinitionInput, SdkCustomBlock, SdkCustomBlockInput, SiteFooterContent, Theme } from '../../blocks/src/index';
+import type { BlockContentSource, BlockContentSourceKind, FieldDefinition, FieldDefinitionInput, SdkCustomBlock, SdkCustomBlockInput, SiteFooterContent, Theme } from '../../blocks/src/index';
+import type { ContentTypeSchema } from '../../content-model/src/index';
 import type { LinkPayload } from './navigation/types';
 import type { JsonValue } from './shared-contracts';
 import type { SdkEventPricing, SdkEventPricingInput } from './sdk-event-pricing';
@@ -405,6 +406,14 @@ export type SdkPatchPageBlockOperation = Readonly<{
 export interface SdkPatchPageBlockBody {
     operations: readonly SdkPatchPageBlockOperation[];
     baseContentHash: string;
+    /**
+     * Optional catalog-coherence precondition: the `activeTheme.selectionVersion`
+     * from `catalog/blocks`. When provided and the site's current style-selection
+     * version differs (the theme changed since the catalog was read), the write is
+     * rejected with 409 and error tag `STALE_CATALOG` instead of risking a
+     * confusing validation failure on a variant the stale catalog advertised.
+     */
+    baseSelectionVersion?: number;
 }
 export declare const SDK_PATCH_STALE_CONTENT_FIELD = "baseContentHash";
 export declare const SDK_PATCH_STALE_CONTENT_CODE = "STALE_CONTENT";
@@ -421,12 +430,28 @@ export interface SdkPatchPageBlockStaleContentFieldError {
     /** Exactly the current draft content hash. */
     message: string;
 }
+/**
+ * Non-blocking warning emitted on a block write. Currently used for button-variant
+ * values that ARE valid manifest options but the ACTIVE theme does not implement:
+ * the write is accepted (themes can change under content), but the variant will not
+ * render until a personality that provides it is selected.
+ */
+export interface SdkBlockContentWarning {
+    /** Data path of the value (e.g. `ctas[0].variant`). */
+    field: string;
+    code: 'theme-unavailable-variant';
+    message: string;
+    /** The offending value. */
+    value: string;
+}
 /**
  * Success response mirrors the block GET shape; `block.contentHash` is the
  * NEW draft content hash (use it as `baseContentHash` for the next patch).
  */
 export interface SdkPatchPageBlockResponse {
     block: SdkGetPageBlock;
+    /** Non-blocking content warnings (e.g. theme-unavailable button variants). */
+    warnings?: SdkBlockContentWarning[];
 }
 export interface SdkPullNavigationItem {
     id: string;
@@ -457,6 +482,8 @@ export interface SdkPullNavigationResponse {
     meta: SdkPullMeta;
 }
 export interface SdkPullSettings {
+    /** Site title (stored on `sites.title`). Present on pull; writable via PATCH. */
+    siteTitle?: string;
     homepageId: string | null;
     seoDefaults: {
         title?: string;
@@ -524,6 +551,235 @@ export interface SdkPullThemeResponse {
     selectionVersion: number;
     meta: SdkPullThemeMeta;
 }
+/** One curated-style recommendation choice; the catalog lists them in preference order. */
+export interface SdkCatalogChoice {
+    id: string;
+    note?: string;
+}
+export interface SdkCatalogHeaderLayoutStyleChoice {
+    layoutId: string;
+    styleId: string;
+}
+export interface SdkCatalogSiteStyle {
+    id: string;
+    name: string;
+    description: string;
+    /** Button style selections in preference order (first = default). */
+    buttonStyleChoices: SdkCatalogButtonStyleSelection[];
+    defaultButtonStyleSelection: SdkCatalogButtonStyleSelection;
+    /** Curated palette recommendations (value-keys) in preference order (first = default). */
+    paletteRecommendations: SdkCatalogChoice[];
+    defaultPaletteValueKey: string;
+    /**
+     * Concrete typography the style applies. NOTE: current theme-core carries a resolved
+     * `typography` object per style, not a preset-choice list (see deviation notes).
+     */
+    typography: Theme['typography'];
+    /** Canonical header layout+style pair (replaces the older single `defaultHeaderSelection` look id). */
+    defaultHeaderSelection: SdkCatalogHeaderLayoutStyleChoice;
+    recommendedHeaderLookIds: string[];
+    recommendedFooterLookIds: string[];
+}
+export interface SdkCatalogButtonStyleSelection {
+    styleId: string;
+    parameters: Record<string, unknown>;
+    note?: string;
+}
+export interface SdkCatalogButtonStyle {
+    id: string;
+    accessibilityLabel: string;
+    tags: Record<string, string>;
+    defaultParameters: Record<string, unknown>;
+    controls: Array<{
+        kind: 'choice';
+        parameter: string;
+        label: string;
+        options: Array<{
+            value: string;
+            label: string;
+        }>;
+    }>;
+}
+export interface SdkCatalogPalette {
+    /** Human-readable source alias. */
+    authoringKey: string;
+    /** Canonical persistence/runtime identity (colors+mode hash). */
+    valueKey: string;
+    name: string;
+    description: string;
+    mode: string;
+}
+export interface SdkCatalogTypographyPreset {
+    /** Recipe id: `serif-editorial` | `clean-sans` | `classic-serif` | `friendly-sans`. */
+    id: string;
+    /** Concrete typography this preset resolves to. */
+    typography: Theme['typography'];
+}
+/**
+ * The site's current resolved selection, so one catalog read primes an apply.
+ * Carries everything the apply endpoint requires — including `siteStyleId`
+ * (read from the active compiled theme). This is the single wire shape;
+ * services map to it explicitly (no structural pass-through of domain rows).
+ */
+export interface SdkCatalogCurrentSelection {
+    /** Pass as `baseSelectionVersion` on apply; 0 when no selection exists. */
+    selectionVersion: number;
+    /** The curated site style the active theme was compiled from (null when unknown). */
+    siteStyleId: string | null;
+    buttonStyleSelection: SdkCatalogButtonStyleSelection | null;
+    paletteValueKey: string | null;
+    headerLayoutId: string | null;
+    headerStyleId: string | null;
+    headerLookId: string | null;
+    footerLookId: string | null;
+}
+export interface SdkCatalogThemeResponse {
+    siteStyles: SdkCatalogSiteStyle[];
+    buttonStyles: SdkCatalogButtonStyle[];
+    palettes: SdkCatalogPalette[];
+    typographyPresets: SdkCatalogTypographyPreset[];
+    headerLookIds: string[];
+    footerLookIds: string[];
+    headerLayoutIds: string[];
+    headerStyleIds: string[];
+    currentSelection: SdkCatalogCurrentSelection;
+    meta: SdkPullMeta;
+}
+/**
+ * Content-source classification, derived DIRECTLY from the blocks package's
+ * authoring type (`BlockContentSource` / `blockContentSourceKinds`) so the wire
+ * union can never drift from what block definitions declare.
+ */
+export type SdkCatalogContentSourceKind = BlockContentSourceKind;
+export type SdkCatalogContentSource = BlockContentSource;
+export interface SdkCatalogSelectOption {
+    value: string;
+    label: string;
+}
+export interface SdkCatalogField {
+    id: string;
+    type: string;
+    label?: string;
+    required: boolean;
+    /** Present for `select` fields. */
+    options?: SdkCatalogSelectOption[];
+    /** Present for container fields (group/repeater/tabGroup/modal). */
+    fields?: SdkCatalogField[];
+}
+/** Machine-readable reason a manifest variant option is not currently renderable. */
+export type SdkCatalogVariantUnavailableReason = 'not-implemented-by-personality';
+/** Where a resolved variant value originates. */
+export type SdkCatalogVariantSource = 'manifest' | 'theme' | 'both';
+/**
+ * One button-variant option, discriminated on `availability`:
+ * - `available`   — the active theme implements it (never carries a reason).
+ * - `unavailable` — a manifest option the active theme does NOT implement;
+ *                   always carries a machine-readable `reason`. Writes accept it
+ *                   with a warning.
+ * - `unknown`     — the site has no active theme/button system, so availability
+ *                   cannot be determined; only manifest options appear.
+ */
+export type SdkCatalogVariantOption = Readonly<{
+    value: string;
+    availability: 'available';
+    source: SdkCatalogVariantSource;
+}> | Readonly<{
+    value: string;
+    availability: 'unavailable';
+    source: 'manifest';
+    reason: SdkCatalogVariantUnavailableReason;
+}> | Readonly<{
+    value: string;
+    availability: 'unknown';
+    source: 'manifest';
+}>;
+export interface SdkCatalogVariantAvailability {
+    /** Structural field-id path of the button-variant field (e.g. `ctas.variant`). */
+    fieldPath: string;
+    variants: SdkCatalogVariantOption[];
+}
+export interface SdkCatalogBlock {
+    identifier: string;
+    title: string;
+    category?: string;
+    contentSource: SdkCatalogContentSource;
+    fields: SdkCatalogField[];
+    /** Button-variant availability against the active theme (shared resolver). */
+    variantAvailability: SdkCatalogVariantAvailability[];
+}
+/**
+ * The active-theme context the blocks catalog was computed against. `selectionVersion`
+ * doubles as an optional write precondition: pass it as `baseSelectionVersion` on block
+ * upsert/PATCH to fail loudly (409, tag `STALE_CATALOG`) if the theme changed since
+ * the catalog was read — a catalog-advertised theme-only variant may otherwise be
+ * rejected after a mid-air theme change.
+ */
+export type SdkCatalogActiveTheme = Readonly<{
+    state: 'active';
+    selectionVersion: number;
+}> | Readonly<{
+    state: 'none';
+}>;
+export interface SdkCatalogBlocksResponse {
+    blocks: SdkCatalogBlock[];
+    /** Theme context the variant availability was computed against. */
+    activeTheme: SdkCatalogActiveTheme;
+    meta: SdkPullMeta;
+}
+export interface SdkCatalogContentType {
+    key: string;
+    name: string;
+    hasPages: boolean;
+    routePattern: string | null;
+    isSingleton: boolean;
+    /** Normalized stored field DSL (NOT generated JSON Schema). */
+    schema: ContentTypeSchema;
+}
+export interface SdkCatalogContentTypesResponse {
+    contentTypes: SdkCatalogContentType[];
+    meta: SdkPullMeta;
+}
+export interface SdkCapabilityCatalogLink {
+    /** Relative path under `/api/sdk/{siteId}`. */
+    path: string;
+    /** Stable content hash of the catalog body, for caching + drift detection. */
+    contentHash: string;
+}
+export interface SdkCapabilitiesResponse {
+    apiVersion: string;
+    catalogs: {
+        theme: SdkCapabilityCatalogLink;
+        blocks: SdkCapabilityCatalogLink;
+        contentTypes: SdkCapabilityCatalogLink;
+    };
+    meta: SdkPullMeta;
+}
+/** One provenance ledger row: a resource a demo recipe run created/linked on this site. */
+export interface SdkDemoSeedProvenanceEntry {
+    id: string;
+    /** The recipe run that created/linked the resource. */
+    runId: string;
+    /** The command ref within the run (e.g. `content:testimonial-ava`). */
+    commandKey: string;
+    /** The command type (e.g. `upsertContentEntry`). */
+    commandType: string;
+    /** Closed resource kind (e.g. `content`, `customer`, `page`, `staff`). */
+    resourceKind: string;
+    /** The recipe resource ref (e.g. `content:testimonial-ava`). */
+    resourceRef: string;
+    /** The concrete resource id. */
+    resourceId: string;
+    /**
+     * `created` — the run authored this resource (a cleanup candidate);
+     * `existing` — the run only linked/configured a pre-existing resource.
+     */
+    disposition: 'created' | 'existing';
+    createdAt: string;
+}
+export interface SdkDemoContentResponse {
+    items: SdkDemoSeedProvenanceEntry[];
+    meta: SdkPullMeta;
+}
 export interface SdkPullFooterMeta extends SdkPullMeta {
     updatedAt: string | null;
 }
@@ -824,6 +1080,8 @@ export interface SdkPullDraftsResponse {
 }
 export interface SdkUpsertBlockResponse {
     block: SdkManagementBlock;
+    /** Non-blocking content warnings (e.g. theme-unavailable button variants). */
+    warnings?: SdkBlockContentWarning[];
 }
 export interface SdkDeleteResponse {
     deleted: true;

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

@@ -250,11 +250,16 @@ export type CreateSitePreviewKeyResponse = {
     keyId: string;
     message: string;
 };
+/** Access mode for a management API key: read-only or full write access. */
+export type ManagementKeyAccessMode = 'read' | 'write';
 export type ManagementKeyRecord = {
     id: string;
     name: string | null;
     keyPrefix: string;
     keyHint: string | null;
+    accessMode: ManagementKeyAccessMode;
+    /** ISO timestamp when the key expires, or null if it never expires. */
+    expiresAt: string | null;
     createdAt: string;
     lastUsedAt: string | null;
 };
@@ -263,10 +268,18 @@ export type ListManagementKeysResponse = {
 };
 export type CreateManagementKeyRequest = {
     name?: string;
+    /** Defaults to 'write' when omitted (preserves prior all-access behavior). */
+    accessMode?: ManagementKeyAccessMode;
+    /** Optional ISO timestamp; must be in the future. Null/omitted = never expires. */
+    expiresAt?: string | null;
 };
 export type CreateManagementKeyResponse = {
     key: string;
     keyId: string;
+    /** Normalized access mode the key was issued with. */
+    accessMode: ManagementKeyAccessMode;
+    /** Normalized expiry (ISO) or null when the key never expires. */
+    expiresAt: string | null;
     message: string;
 };
 export type RevokeManagementKeyRequest = {

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

@@ -10,7 +10,7 @@ import type { GetVersionHistoryResponse, ListVersionHistoryResponse, RestoreVers
 import type { ApplyContentTemplateAddonRequest, ContentTemplateDetailsResponse, CreateTemplateBlockRequest, GetTransformsResponse, ReorderTemplateBlocksRequest, SerializedContentTypeSummary, UpdateContentTemplateBlockBindingsRequest, UpdateContentTemplateBlockRequest } from './contentTypes';
 import type { LinkPayload, RoutableContentItem, SitemapRouteItem } from './navigation/types';
 import type { RouteMetadataPayload, RouteMetadataResponse } from './routes';
-import type { PageSurfaceEditorDocument } from './contentRuntime';
+import type { PageSurfaceEditorDocument, PublishEventOfferingPageSurfaceResponse } from './contentRuntime';
 import type { ContentRouteRecord } from './types';
 import type { SiteAnalyticsSettingsPayload, SiteAnalyticsSettingsResponse } from './siteAnalytics';
 import type { SiteBannerSettingsPayload, SiteBannerSettingsResponse } from './siteBanner';
@@ -289,6 +289,10 @@ export type SiteManagementAPIEndpoints = {
     }, {
         route: ContentRouteRecord;
     }>;
+    publishEventOfferingPageSurface: APIEndpoint<never, {
+        siteId: string;
+        pageSurfaceId: string;
+    }, PublishEventOfferingPageSurfaceResponse>;
     runSdkWorkflow: APIEndpoint<never, {
         siteId: string;
         type: string;
@@ -1054,12 +1058,8 @@ export type SiteManagementAPIEndpoints = {
         siteId: string;
         ids?: string;
     }, {
-        services: Array<{
-            id: string;
-            siteId: string;
-            title: string;
+        services: Array<Omit<PublicBookingService, 'description'> & {
             description?: string;
-            durationMinutes?: number;
         }>;
     }>;
     getPublicBookingService: APIEndpoint<never, {

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

@@ -1,11 +1,12 @@
 import type { AppointmentBookingQuestionsTask } from "./bookingOperations";
 import type { SiteRole } from "./siteMembers";
-import type { AdminManagedSubscriptionActionChoice, ManagedManualBillingReason, SiteBillingArrangement, SiteBillingArrangementKind, SiteBillingArrangementSubscriptionAction, SiteBillingManualReviewPayload, SiteBillingManualReviewResolutionAction, SiteBillingManualReviewStatus } from "../../billing/src/site-arrangements";
+import type { AdminManagedSubscriptionActionChoice, ManagedManualBillingReason, SiteBillingArrangement, SiteBillingArrangementChangeOrigin, SiteBillingArrangementKind, SiteBillingArrangementSubscriptionAction, SiteBillingManualReviewPayload, SiteBillingManualReviewResolutionAction, SiteBillingManualReviewStatus } from "../../billing/src/site-arrangements";
 /**
  * Site Operations Contracts
  *
  * These types cover admin-facing site operations and operational responses:
- * site-cost admin actions, dev-tools state, cron job summaries, site logs,
+ * site-billing-arrangement admin actions, dev-tools state, cron job summaries,
+ * site logs,
  * manual site scaffolding, and shop-order admin workflows.
  *
  * Note: Do NOT use these API types as validation schemas. They document wire
@@ -67,7 +68,7 @@ export type AccountUpdatePasswordResponse = {
     ok: boolean;
     passwordSetAt?: string | null;
 };
-export type AdminSiteCostResponse = {
+export type AdminSiteBillingArrangementResponse = {
     site: {
         id: string;
         name: string;
@@ -84,16 +85,6 @@ export type AdminSiteCostResponse = {
         email: string;
     } | null;
     history: Array<{
-        id: string;
-        previousCostCents: number;
-        newCostCents: number;
-        changedBy: string;
-        reason: string | null;
-        createdAt: string;
-        formattedPreviousCost: string;
-        formattedNewCost: string;
-    }>;
-    arrangementHistory: Array<{
         id: string;
         previousArrangement: SiteBillingArrangementKind;
         newArrangement: SiteBillingArrangementKind;
@@ -107,13 +98,14 @@ export type AdminSiteCostResponse = {
         reason: string | null;
         subscriptionAction: SiteBillingArrangementSubscriptionAction;
         subscriptionActionResult: unknown;
+        changeOrigin: SiteBillingArrangementChangeOrigin;
         createdAt: string;
         formattedPreviousCost: string;
         formattedNewCost: string;
     }>;
-    manualReviews: AdminSiteCostManualReview[];
+    manualReviews: AdminSiteBillingArrangementManualReview[];
 };
-export type AdminSiteCostManualReview = SiteBillingManualReviewPayload & {
+export type AdminSiteBillingArrangementManualReview = SiteBillingManualReviewPayload & {
     id: string;
     status: SiteBillingManualReviewStatus;
     resolutionAction: SiteBillingManualReviewResolutionAction | null;
@@ -130,12 +122,12 @@ export type AdminSiteBillingArrangementRequest = {
     reason: ManagedManualBillingReason;
     note?: string | null;
 };
-export type AdminUpdateSiteCostRequest = {
+export type AdminUpdateSiteBillingArrangementRequest = {
     arrangement: AdminSiteBillingArrangementRequest;
     subscriptionAction?: AdminManagedSubscriptionActionChoice;
     reason?: string;
 };
-export type AdminSiteCostUpdateSyncResult = {
+export type AdminSiteBillingArrangementUpdateSyncResult = {
     status: "not_applicable";
     message: null;
 } | {
@@ -157,8 +149,8 @@ export type AdminSiteCostUpdateSyncResult = {
     status: "manual_review_required";
     message: string;
 };
-export type AdminUpdateSiteCostResponse = AdminSiteCostResponse & {
-    subscriptionSync: AdminSiteCostUpdateSyncResult;
+export type AdminUpdateSiteBillingArrangementResponse = AdminSiteBillingArrangementResponse & {
+    subscriptionSync: AdminSiteBillingArrangementUpdateSyncResult;
 };
 export type AdminScheduleBillingComponentEndRequest = {
     reason?: string;

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

@@ -10,7 +10,7 @@ import type { CreateManagementKeyRequest, CreateManagementKeyResponse, CreateSit
 import type { GetSiteInspirationAnalysisResponse, ListSiteInspirationAnalysesResponse } from './siteGeneration';
 import type { ListGscPropertiesAdminResponse, AuthStatusResponse, CronAppointmentRemindersResponse, CronBillingStatusResponse, CronEventFeedbackEmailsResponse, CronEventOccurrencesResponse, CronEventRemindersResponse, CronMediaJobsQuery, CronMediaJobsResponse, CronNewsletterSendResponse, CronPaymentReconciliationResponse, CronSeoIngestResponse, CronWaitlistExpiryResponse } from './siteOperations';
 import type { ApplySiteStyleSelectionBody, ApplySiteStyleSelectionResponse } from './siteRuntimeEndpoints';
-import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkBackfillIdentifiersResult, SdkGetCourseResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListCoursesResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkPullCourseProgram, SdkPullCourseSession, SdkPullCoursesResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullThemeResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpsertBlockResponse, SdkUpsertCourseResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertThemeResponse, SdkUpsertVenueResponse } from './sdkContracts';
+import type { ManagementMediaAsset, MediaResolveResponse, PushSdkConfigRequest, PushSdkConfigResponse, SdkBackfillIdentifiersResult, SdkGetCourseResponse, SdkGetEntryResponse, SdkGetEventCategoryResponse, SdkGetEventResponse, SdkGetFormResponse, SdkGetPageBlockResponse, SdkPatchPageBlockBody, SdkPatchPageBlockResponse, SdkGetVenueResponse, SdkListCoursesResponse, SdkListEntriesResponse, SdkListEventCategoriesResponse, SdkListEventsResponse, SdkListFormsResponse, SdkListVenuesResponse, SdkMediaFinalizeUploadResponse, SdkMediaUploadUrlResponse, SdkPageResponse, SdkEntryUpsertSlotBlock, SdkPublishOrUnpublishEntryResponse, SdkPullContentTypesResponse, SdkCatalogThemeResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCapabilitiesResponse, SdkDemoContentResponse, SdkPullCourseProgram, SdkPullCourseSession, SdkPullCoursesResponse, SdkPullEntriesAllResponse, SdkPullEntriesByTypeResponse, SdkPullEntriesResponse, SdkPullEventCategoriesResponse, SdkPullEventsResponse, SdkPullFooterResponse, SdkPullFormSchema, SdkPullFormsResponse, SdkPullFormSettings, SdkPullDraftsResponse, SdkPullNavigationResponse, SdkPullPagesResponse, SdkPullSettings, SdkPullSettingsResponse, SdkPullSiteInfoResponse, SdkPullThemeResponse, SdkPullVenue, SdkPullVenuesResponse, SdkUpdateSettingsResponse, SdkUpsertBlockResponse, SdkUpsertCourseResponse, SdkUpsertEntryResponse, SdkUpsertPageResponse, SdkUpsertEventCategoryResponse, SdkUpsertEventResponse, SdkUpsertFooterResponse, SdkUpsertFormResponse, SdkUpsertNavigationMenuResponse, SdkUpsertThemeResponse, SdkUpsertVenueResponse } from './sdkContracts';
 import type { SdkEventUpsertBody } from './sdk-event-upsert';
 import type { StripeConnectDisconnectResponse, StripeConnectStartResponse, StripeConnectStatusResponse, UpdateStripeAutomaticTaxRequest } from './billing';
 import type { NavigationLinkInput } from './navigation/types';
@@ -186,6 +186,21 @@ export type SitePlatformAPIEndpoints = {
     sdkPullContentTypes: APIEndpoint<never, {
         siteId: string;
     }, SdkPullContentTypesResponse>;
+    sdkCatalogTheme: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCatalogThemeResponse>;
+    sdkCatalogBlocks: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCatalogBlocksResponse>;
+    sdkCatalogContentTypes: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCatalogContentTypesResponse>;
+    sdkCapabilities: APIEndpoint<never, {
+        siteId: string;
+    }, SdkCapabilitiesResponse>;
+    sdkListDemoContent: APIEndpoint<never, {
+        siteId: string;
+    }, SdkDemoContentResponse>;
     sdkPullPages: APIEndpoint<never, {
         siteId: string;
     }, SdkPullPagesResponse>;
@@ -262,6 +277,11 @@ export type SitePlatformAPIEndpoints = {
         kind: string;
         data: Record<string, unknown>;
         position?: number;
+        /**
+         * Optional catalog-coherence precondition (`catalog/blocks`
+         * `activeTheme.selectionVersion`); mismatch → 409 tag `STALE_CATALOG`.
+         */
+        baseSelectionVersion?: number;
     }, {
         siteId: string;
         identifier: string;
@@ -449,6 +469,13 @@ export type SitePlatformAPIEndpoints = {
         contentType: string;
         data: Record<string, unknown>;
         slug?: string;
+        /**
+         * Raw display ordinal, only accepted for content types with
+         * `ordering.mode: 'manual'` (400 fieldError otherwise). The server never
+         * displaces other entries; equal ordinals resolve deterministically by
+         * (manualOrder ASC, createdAt ASC, id ASC). Callers wanting insert-at-
+         * position semantics reassign ordinals for the affected entries.
+         */
         manualOrder?: number;
         blocks?: Record<string, SdkEntryUpsertSlotBlock[]>;
         publication?: 'draft' | 'publish';
@@ -484,6 +511,7 @@ export type SitePlatformAPIEndpoints = {
         identifier: string;
     }, SdkPublishOrUnpublishEntryResponse>;
     sdkUpdateSettings: APIEndpoint<{
+        siteTitle?: string;
         homepageId?: string | null;
         seoDefaults?: SdkPullSettings['seoDefaults'];
         logoIdentifier?: string | null;