@riverbankcms/sdk 0.104.3 → 0.108.0

package/dist/_dts/api/src/cache-tags.d.ts

@@ -32,6 +32,7 @@ export declare const TAG_TEMPLATES: {
     readonly siteRouteOutcomes: "riverbank:site:{siteId}:route-outcomes";
     readonly routeById: "riverbank:route:{routeId}";
     readonly pageById: "riverbank:page:{pageId}";
+    readonly pageSurfaceById: "riverbank:page-surface:{pageSurfaceId}";
     readonly workflowRunById: "riverbank:workflow-run:{runId}";
     readonly siteForms: "riverbank:site:{siteId}:forms";
     readonly formById: "riverbank:form:{formId}";
@@ -74,6 +75,8 @@ export declare const tags: {
     readonly siteRouteOutcomes: (siteId: string) => string;
     readonly route: (routeId: string) => string;
     readonly page: (pageId: string) => string;
+    readonly pageSurface: (pageSurfaceId: string) => string;
+    readonly surfaceSlot: (surfaceSlotId: string) => string;
     readonly workflowRun: (runId: string) => string;
     readonly siteForms: (siteId: string) => string;
     readonly form: (formId: string) => string;

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

@@ -1,6 +1,6 @@
 import type { Block, SdkCustomBlock, SdkCustomBlockInput, SiteFont, Theme } from '../../blocks/src/index';
 import type { CamelizeKeys, DbRow } from '../../db/src/index';
-import type { CuratedPaletteId, PaletteOverrides, RuntimePaletteState } from '../../theme-core/src/palette/index';
+import type { AuthoritativeRuntimePaletteState } from '../../theme-core/src/palette/index';
 import type { ContentTypeRoutingInfo, PublicContentTypeMeta } from './contentTypes';
 import type { SiteRuntimePrivacyPolicy } from './privacyPolicy';
 import type { SitePagePayload } from './sitePages';
@@ -115,6 +115,16 @@ export type ContentEntryDetail<TContent> = {
     draftContent: TContent;
     publishedContent: TContent | null;
 };
+export type PageSurfaceEditorDocument<TContent = Record<string, unknown>> = {
+    owner: {
+        kind: 'pageSurface';
+        pageSurfaceId: string;
+    };
+    route: ContentRouteRecord;
+    draftContent: TContent;
+    publishedContent: TContent | null;
+    optimisticHash: string;
+};
 export type ContentEntryDetailResponse<TContent = Record<string, unknown>> = {
     entry: ContentEntryDetail<TContent>;
     optimisticHash?: string | null;
@@ -358,17 +368,11 @@ export type SiteBySlugResponse = {
      * Persisted Style configurator selections (Phase C). Optional so legacy
      * site_theme_selections rows (pre-migration) still satisfy the response
      * type — consumers fall back to the site style's defaults when null.
-    */
+     */
     selectionButtonPersonalityId?: string | null;
-    runtimePaletteState?: RuntimePaletteState | null;
-    /** Temporary legacy compatibility projection for stale runtime clients. */
-    selectionPaletteVariantId?: CuratedPaletteId | null;
-    selectionPaletteOverrides?: PaletteOverrides | null;
+    runtimePaletteState?: AuthoritativeRuntimePaletteState | null;
     selectionHeaderLayoutId?: string | null;
     selectionHeaderStyleId?: string | null;
-    selectionTypographyPresetId?: string | null;
-    selectionTypographyBodyFontOverride?: string | null;
-    selectionTypographyHeadingFontOverride?: string | null;
     selectionHeaderLookId?: string | null;
     selectionFooterLookId?: string | null;
     navigation: NavigationMenuWithItems[];
@@ -426,6 +430,7 @@ export type BlockListItem = {
     content?: Record<string, unknown> | null;
     draftContent?: Record<string, unknown> | null;
     publishedContent?: Record<string, unknown> | null;
+    optimisticHash?: string | null;
 };
 export type EntryPageContentSlotAllowedBlocks = Readonly<{
     kind: 'default';
@@ -443,6 +448,9 @@ export type EntryPageContentSlot = Readonly<{
     allowedBlocks: EntryPageContentSlotAllowedBlocks;
     blocks: readonly BlockListItem[];
 }>;
+export type PageSurfaceContentSlot = EntryPageContentSlot & Readonly<{
+    compositionHash: string;
+}>;
 export type EntryPageContentSlotWarning = Readonly<{
     kind: 'orphaned-slot-hidden';
     slotKey: string;
@@ -452,6 +460,10 @@ export type EntryPageContentSlotsResponse = Readonly<{
     slots: readonly EntryPageContentSlot[];
     warnings: readonly EntryPageContentSlotWarning[];
 }>;
+export type PageSurfaceContentSlotsResponse = Readonly<{
+    slots: readonly PageSurfaceContentSlot[];
+    warnings: readonly EntryPageContentSlotWarning[];
+}>;
 export type PublishedBlockBaseline = {
     id: string;
     kind: string;
@@ -672,10 +684,7 @@ export type SdkRuntimeEntryResponse = {
     contentTypeSchema: Record<string, unknown> | null;
     mediaAssets?: SdkRuntimeMediaAsset[];
 };
-export type SdkRuntimePageSurfaceSubject = Readonly<{
-    kind: 'eventSeries';
-    eventSeriesId: string;
-}>;
+export type SdkRuntimePageSurfaceSubject = import('../../core/src/index').EventPageSurfaceSubjectWire;
 export type SdkRuntimePageSurfaceContentSource = Readonly<{
     kind: 'pageSurface';
     contentTypeId: string;
@@ -685,7 +694,7 @@ export type SdkRuntimePageSurfaceContentSource = Readonly<{
 export type SdkRuntimePageSurface = {
     id: string;
     routeId: string;
-    readinessState: 'shippable';
+    readinessState: 'internal_pilot' | 'shippable';
     subject: SdkRuntimePageSurfaceSubject;
     title: string;
     slug: string | null;
@@ -735,10 +744,10 @@ export type SdkRouteOutcomeResponse = {
     message: string;
 };
 export type SdkRouteNonContentDecisionResponse = Exclude<SdkRouteOutcomeResponse, {
-    type: "content";
+    type: 'content';
 }>;
 export type SdkRouteDecisionResponse = {
-    type: "contentExists";
+    type: 'contentExists';
 } | SdkRouteNonContentDecisionResponse;
 export type BlockWithContentResponse = {
     id: string;

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

@@ -1,5 +1,5 @@
-import type { BookingPaymentOptionsSource, BookingPaymentTermsConfig, BookingPricing, BookingPricingInput, WaitlistOverride } from "./bookingConfig";
-import type { PublicTeamMemberSummary } from "./teamMembers";
+import type { BookingPaymentOptionsSource, BookingPaymentTermsConfig, BookingPricing, BookingPricingInput, WaitlistOverride } from './bookingConfig';
+import type { PublicTeamMemberSummary } from './teamMembers';
 /**
  * Course Contracts
  *
@@ -9,14 +9,14 @@ import type { PublicTeamMemberSummary } from "./teamMembers";
  * Note: Do NOT use these API types as validation schemas. They document wire
  * contracts while the owning services validate and normalize inputs.
  */
-export type CourseStatus = "draft" | "active" | "cancelled" | "archived" | "completed";
+export type CourseStatus = 'draft' | 'active' | 'cancelled' | 'archived' | 'completed';
 /**
  * Backwards-compatible alias for mutation-safe course statuses.
  *
  * Historically this excluded `completed`; keep that behavior so callers that
  * relied on `MutableCourseStatus` continue to typecheck.
  */
-export type MutableCourseStatus = Exclude<CourseStatus, "completed">;
+export type MutableCourseStatus = Exclude<CourseStatus, 'completed'>;
 export type CourseSessionInput = {
     startsAt: string;
     endsAt: string;
@@ -81,6 +81,21 @@ export type CourseRecord = {
     /** Seat-holding enrollments (enrolled, pending_payment, completed). */
     enrolledCount: number;
 };
+export type WholeSeriesRunCancellationSettlement = Readonly<{
+    kind: 'full_refund';
+    operationId: string;
+}> | Readonly<{
+    kind: 'custom_refund';
+    operationId: string;
+    refunds: readonly Readonly<{
+        enrollmentId: string;
+        amountCents: number;
+    }>[];
+}> | Readonly<{
+    kind: 'no_refund';
+    operationId: string;
+    note?: string | null;
+}>;
 export type PublicCourseSession = {
     id: string;
     startsAt: string;
@@ -95,6 +110,7 @@ export type PublicCourseVenue = {
 };
 export type PublicCourseDetails = {
     id: string;
+    seriesId: string;
     title: string;
     slug: string;
     description: unknown;
@@ -130,6 +146,7 @@ export type UpdateCourseRequest = {
     paymentOptionsSource?: BookingPaymentOptionsSource;
     status?: CourseStatus;
     cancelAndArchive?: boolean;
+    cancellationSettlement?: WholeSeriesRunCancellationSettlement;
     title?: string;
     venueId?: string | null;
     capacity?: number | null;
@@ -158,9 +175,43 @@ export type DuplicateCourseRequest = {
 export type DuplicateCourseResponse = {
     course: CourseRecord;
 };
-export type CourseEnrollmentStatus = "pending_payment" | "enrolled" | "waitlist" | "cancelled" | "completed";
-export type CourseEnrollmentPaymentMethod = "free" | "membership" | "stripe" | null;
-export type CourseEnrollmentPaymentStatus = "not_required" | "pending" | "completed" | "failed" | "refunded" | null;
+export type CourseContentOwnershipBlocker = "invalidScope" | "notSharedOfferingContent" | "notSeriesSpecificContent" | "invalidSlug" | "routePathConflict" | "missingOfferingSurface" | "missingProgramRoute" | "missingSourceContent" | "existingSeriesSurface" | "invalidSourceSlotComposition" | "missingSourceBlockContent" | "seriesSurfaceNotDraft" | "seriesContentChanged" | "stalePreview";
+export type CourseContentOwnershipRequest = {
+    action: "preview-separate" | "apply-separate";
+    eventSeriesId: string;
+    proposedSlug: string;
+} | {
+    action: "preview-shared" | "apply-shared";
+    eventSeriesId: string;
+};
+export type CourseContentOwnershipResponse = {
+    kind: "blocked";
+    blockers: readonly CourseContentOwnershipBlocker[];
+} | {
+    kind: "separate-preview";
+    proposedSlug: string;
+    proposedPath: string;
+    copiedSlotCount: number;
+    summary: readonly [
+        "Create a draft page for this run",
+        "Copy the shared content and editable sections",
+        "Give the run its own draft URL"
+    ];
+} | {
+    kind: "shared-preview";
+    summary: readonly [
+        "Remove this run's separate draft page",
+        "Use the shared course content again"
+    ];
+} | {
+    kind: "separate-applied";
+    pageSurfaceId: string;
+} | {
+    kind: "shared-applied";
+};
+export type CourseEnrollmentStatus = 'pending_payment' | 'enrolled' | 'waitlist' | 'cancelled' | 'completed';
+export type CourseEnrollmentPaymentMethod = 'free' | 'membership' | 'stripe' | null;
+export type CourseEnrollmentPaymentStatus = 'not_required' | 'pending' | 'completed' | 'failed' | 'refunded' | null;
 export type CourseEnrollmentRecord = {
     id: string;
     siteId: string;
@@ -194,7 +245,7 @@ export type ListCourseEnrollmentsResponse = {
         capacity: number | null;
     };
 };
-export type DashboardWaitlistEntryStatus = "waiting" | "invited" | "inviteExpired" | "cancelled";
+export type DashboardWaitlistEntryStatus = 'waiting' | 'invited' | 'inviteExpired' | 'cancelled';
 export type DashboardWaitlistEntry = {
     id: string;
     customerId: string;
@@ -227,14 +278,21 @@ export type AddCourseEnrollmentRequest = {
     customerName?: string;
     customerEmail?: string;
     customerPhone?: string | null;
-    status?: "enrolled" | "waitlist";
+    status?: 'enrolled' | 'waitlist';
+    settlement?: {
+        kind: 'complimentary';
+    };
     formSubmissionJson?: Record<string, unknown>;
 };
 export type AddCourseEnrollmentResponse = {
     enrollment: CourseEnrollmentRecord;
 };
 export type UpdateCourseEnrollmentRequest = {
-    status: "enrolled" | "waitlist" | "cancelled" | "completed";
+    status: 'enrolled' | 'waitlist' | 'cancelled' | 'completed';
+    settlement?: {
+        kind: 'complimentary';
+        operationId: string;
+    };
 };
 export type UpdateCourseEnrollmentResponse = {
     enrollment: CourseEnrollmentRecord;

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

@@ -1350,6 +1350,13 @@ export declare const API_ENDPOINTS: {
         readonly responseKind: "json";
         readonly errors: readonly ["validation:invalid_input", "resource:not_found", "resource:already_exists", "server:internal_error"];
     };
+    readonly changeCourseContentOwnership: {
+        readonly path: "/sites/{siteId}/bookings/courses/{courseId}/content-ownership";
+        readonly method: "POST";
+        readonly auth: "user";
+        readonly responseKind: "json";
+        readonly errors: readonly ["validation:invalid_input", "resource:not_found", "resource:conflict", "server:internal_error"];
+    };
     readonly addCourseEnrollment: {
         readonly path: "/sites/{siteId}/bookings/courses/{courseId}/enrollments";
         readonly method: "POST";
@@ -1704,6 +1711,30 @@ export declare const API_ENDPOINTS: {
         readonly auth: "user";
         readonly responseKind: "json";
     };
+    readonly updatePageSurfaceDraftContent: {
+        readonly path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/content";
+        readonly method: "PUT";
+        readonly errors: readonly ["validation:invalid_input", "resource:not_found", "resource:conflict", "server:internal_error"];
+        readonly tags: ["riverbank:site", "riverbank:page-surface:{pageSurfaceId}"];
+        readonly auth: "user";
+        readonly responseKind: "json";
+    };
+    readonly discardPageSurfaceDraftContent: {
+        readonly path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/content/draft";
+        readonly method: "DELETE";
+        readonly errors: readonly ["validation:invalid_input", "resource:not_found", "resource:conflict", "server:internal_error"];
+        readonly tags: ["riverbank:site", "riverbank:page-surface:{pageSurfaceId}"];
+        readonly auth: "user";
+        readonly responseKind: "json";
+    };
+    readonly updatePageSurfaceRouteMetadata: {
+        readonly path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/metadata";
+        readonly method: "PATCH";
+        readonly errors: readonly ["validation:invalid_input", "resource:not_found", "resource:conflict", "server:internal_error"];
+        readonly tags: ["riverbank:site", "riverbank:site:{siteId}:routable-content", "riverbank:page-surface:{pageSurfaceId}"];
+        readonly auth: "user";
+        readonly responseKind: "json";
+    };
     readonly runSdkWorkflow: {
         readonly path: "/sites/{siteId}/content/{type}/{entryId}/workflows/{workflowId}/run";
         readonly method: "POST";
@@ -2004,6 +2035,42 @@ export declare const API_ENDPOINTS: {
         readonly errors: readonly [];
         readonly responseKind: "json";
     };
+    readonly getFooterComposition: {
+        readonly path: "/sites/{siteId}/settings/footer-composition";
+        readonly method: "GET";
+        readonly revalidate: 120;
+        readonly tags: ["riverbank:site:{siteId}", "riverbank:site:{siteId}:settings"];
+        readonly auth: "user";
+        readonly errors: readonly ["resource:not_found", "server:internal_error"];
+        readonly responseKind: "json";
+    };
+    readonly updateFooterComposition: {
+        readonly path: "/sites/{siteId}/settings/footer-composition";
+        readonly method: "POST";
+        readonly tags: ["riverbank:site:{siteId}", "riverbank:site:{siteId}:settings"];
+        readonly auth: "user";
+        readonly demoMutation: import("./apiEndpointTypes").ApiDemoMutationPolicy;
+        readonly errors: readonly ["validation:invalid_input", "resource:not_found", "server:internal_error"];
+        readonly responseKind: "json";
+    };
+    readonly getPublicProfile: {
+        readonly path: "/sites/{siteId}/settings/public-profile";
+        readonly method: "GET";
+        readonly revalidate: 120;
+        readonly tags: ["riverbank:site:{siteId}", "riverbank:site:{siteId}:settings"];
+        readonly auth: "user";
+        readonly errors: readonly ["resource:not_found", "server:internal_error"];
+        readonly responseKind: "json";
+    };
+    readonly updatePublicProfile: {
+        readonly path: "/sites/{siteId}/settings/public-profile";
+        readonly method: "POST";
+        readonly tags: ["riverbank:site:{siteId}", "riverbank:site:{siteId}:settings"];
+        readonly auth: "user";
+        readonly demoMutation: import("./apiEndpointTypes").ApiDemoMutationPolicy;
+        readonly errors: readonly ["validation:invalid_input", "resource:not_found", "server:internal_error"];
+        readonly responseKind: "json";
+    };
     readonly updateSiteLayoutSettings: {
         readonly path: "/sites/{siteId}/settings/layout";
         readonly method: "POST";
@@ -2900,6 +2967,38 @@ export declare const API_ENDPOINTS: {
         readonly responseKind: "json";
         readonly errors: readonly ["resource:not_found"];
     };
+    readonly listPageSurfaceContentSlots: {
+        readonly path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/slots";
+        readonly method: "GET";
+        readonly tags: ["riverbank:site", "riverbank:page-surface:{pageSurfaceId}", "surface-slots", "blocks"];
+        readonly auth: "user";
+        readonly responseKind: "json";
+        readonly errors: readonly ["resource:not_found", "resource:conflict", "server:internal_error"];
+    };
+    readonly createPageSurfaceSlotBlock: {
+        readonly path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/slots/{slotKey}/blocks";
+        readonly method: "POST";
+        readonly tags: ["riverbank:site", "riverbank:page-surface:{pageSurfaceId}", "surface-slot-{slotKey}", "blocks"];
+        readonly auth: "user";
+        readonly responseKind: "json";
+        readonly errors: readonly ["validation:invalid_input", "resource:not_found", "resource:conflict", "server:internal_error"];
+    };
+    readonly reorderPageSurfaceSlotBlocks: {
+        readonly path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/slots/{slotKey}/blocks/reorder";
+        readonly method: "POST";
+        readonly tags: ["riverbank:site", "riverbank:page-surface:{pageSurfaceId}", "surface-slot-{slotKey}", "blocks"];
+        readonly auth: "user";
+        readonly responseKind: "json";
+        readonly errors: readonly ["validation:invalid_input", "resource:not_found", "resource:conflict", "server:internal_error"];
+    };
+    readonly deletePageSurfaceSlotBlock: {
+        readonly path: "/sites/{siteId}/page-surfaces/{pageSurfaceId}/slots/{slotKey}/blocks/{blockId}";
+        readonly method: "DELETE";
+        readonly tags: ["riverbank:site", "riverbank:page-surface:{pageSurfaceId}", "surface-slot-{slotKey}", "blocks"];
+        readonly auth: "user";
+        readonly responseKind: "json";
+        readonly errors: readonly ["resource:not_found", "resource:conflict", "server:internal_error"];
+    };
     readonly createBlock: {
         readonly path: "/sites/{siteId}/pages/{pageId}/blocks";
         readonly method: "POST";
@@ -4913,6 +5012,13 @@ export declare const API_ENDPOINTS: {
         readonly auth: "service";
         readonly responseKind: "json";
     };
+    readonly sdkPullDrafts: {
+        readonly path: "/sdk/{siteId}/pull/drafts";
+        readonly method: "GET";
+        readonly errors: readonly ["server:internal_error"];
+        readonly auth: "service";
+        readonly responseKind: "json";
+    };
     readonly sdkPullNavigation: {
         readonly path: "/sdk/{siteId}/pull/navigation";
         readonly method: "GET";
@@ -5003,6 +5109,13 @@ export declare const API_ENDPOINTS: {
         readonly auth: "service";
         readonly responseKind: "json";
     };
+    readonly sdkDeletePage: {
+        readonly path: "/sdk/{siteId}/pages/{identifier}";
+        readonly method: "DELETE";
+        readonly errors: readonly ["resource:not_found", "server:internal_error"];
+        readonly auth: "service";
+        readonly responseKind: "json";
+    };
     readonly sdkUpsertPageBlock: {
         readonly path: "/sdk/{siteId}/pages/{identifier}/blocks";
         readonly method: "POST";
@@ -5015,6 +5128,20 @@ export declare const API_ENDPOINTS: {
         readonly auth: "service";
         readonly responseKind: "json";
     };
+    readonly sdkGetPageBlock: {
+        readonly path: "/sdk/{siteId}/pages/{identifier}/blocks/{blockIdentifier}";
+        readonly method: "GET";
+        readonly errors: readonly ["resource:not_found", "server:internal_error"];
+        readonly auth: "service";
+        readonly responseKind: "json";
+    };
+    readonly sdkPatchPageBlock: {
+        readonly path: "/sdk/{siteId}/pages/{identifier}/blocks/{blockIdentifier}";
+        readonly method: "PATCH";
+        readonly errors: readonly ["validation:invalid_input", "resource:not_found", "resource:conflict", "billing:plan_limit_exceeded", "server:internal_error"];
+        readonly auth: "service";
+        readonly responseKind: "json";
+    };
     readonly sdkReorderPageBlocks: {
         readonly path: "/sdk/{siteId}/pages/{identifier}/blocks/reorder";
         readonly method: "POST";
@@ -5039,6 +5166,7 @@ export declare const API_ENDPOINTS: {
         readonly method: "POST";
         readonly auth: "service";
         readonly responseKind: "json";
+        readonly errors: readonly ["validation:invalid_input", "resource:not_found", "resource:conflict", "server:internal_error"];
     };
     readonly sdkApplySiteStyleSelection: {
         readonly path: "/sdk/{siteId}/theme/style-selection/apply";

package/dist/_dts/api/src/footer-settings.d.ts

@@ -0,0 +1 @@
+export * from './footerSettings';

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

@@ -0,0 +1,8 @@
+import type { SiteId } from "../../core/src/index";
+import type { FooterCompositionSnapshot, FooterCompositionUpdateRequest, FooterCompositionUpdateResponse, PublicProfileSnapshot, PublicProfileUpdateRequest, PublicProfileUpdateResponse } from "./siteManagementEndpoints";
+import type { ApiClient } from "./request";
+export type { FooterCompositionSnapshot, FooterCompositionUpdateRequest, FooterCompositionUpdateResponse, PublicProfileSnapshot, PublicProfileUpdateRequest, PublicProfileUpdateResponse, } from "./siteManagementEndpoints";
+export declare function getFooterComposition(apiClient: ApiClient, siteId: SiteId): Promise<FooterCompositionSnapshot>;
+export declare function updateFooterComposition(apiClient: ApiClient, siteId: SiteId, body: FooterCompositionUpdateRequest): Promise<FooterCompositionUpdateResponse>;
+export declare function getPublicProfile(apiClient: ApiClient, siteId: SiteId): Promise<PublicProfileSnapshot>;
+export declare function updatePublicProfile(apiClient: ApiClient, siteId: SiteId, body: PublicProfileUpdateRequest): Promise<PublicProfileUpdateResponse>;