@riverbankcms/sdk 0.139.0 → 0.140.0

package/dist/_dts/api/src/onboarding/surfaceData.d.ts

@@ -1,6 +1,6 @@
-import type { LogoFacts } from "../../../theme-core/src/site-styles/index";
-import type { BillingPlanId } from "../../../billing/src/plans/types";
-import type { SiteVerticalBookingConfig } from "../../../core/src/index";
+import type { LogoFacts } from '../../../theme-core/src/site-styles/index';
+import type { BillingPlanId } from '../../../billing/src/plans/types';
+import type { PublicExperience, SiteVerticalBookingConfig } from '../../../core/src/index';
 /**
  * Macadamia public-onboarding surface data.
  *
@@ -12,14 +12,14 @@ import type { SiteVerticalBookingConfig } from "../../../core/src/index";
  * Note: Do NOT use these API types as validation schemas. They document wire
  * contracts while the owning services validate and normalize inputs.
  */
-export type MacadamiaOnboardingSiteMode = "single_page" | "fuller_starter";
+export type MacadamiaOnboardingSiteMode = 'single_page' | 'fuller_starter';
 export type MacadamiaOnboardingMappedPalette = {
-    palette: Record<"primary" | "secondary" | "accent" | "background" | "surface" | "text", string>;
-    mode: "light" | "dark";
+    palette: Record<'primary' | 'secondary' | 'accent' | 'background' | 'surface' | 'text', string>;
+    mode: 'light' | 'dark';
 };
 export type MacadamiaOnboardingLogoPaletteRecommendation = {
     title: string;
-    palette: MacadamiaOnboardingMappedPalette["palette"];
+    palette: MacadamiaOnboardingMappedPalette['palette'];
 };
 export type MacadamiaOnboardingLogoAnalysis = {
     logoFacts: LogoFacts;
@@ -37,14 +37,14 @@ export type MacadamiaOnboardingVisualIdentity = {
     selectedPaletteKey: string | null;
     inspirationUrls: string[];
 };
-export type PublicOnboardingSurfaceId = "macadamia";
-export type MacadamiaOnboardingTeamMode = "solo" | "team";
-export type MacadamiaOnboardingOfferingKind = "classes" | "courses" | "workshops" | "retreats" | "performances" | "private_sessions";
-export type MacadamiaOnboardingStyleMood = "calm_grounding" | "warm_welcoming" | "modern_polished" | "natural_earthy" | "bright_uplifting" | "luxury_retreat";
-export type MacadamiaOnboardingFirstOfferingKind = "class" | "course" | "workshop" | "retreat" | "performance" | "private_session";
-export type MacadamiaOnboardingFirstOfferingDeliveryMode = "in_person" | "online" | "both";
-export type MacadamiaOnboardingFirstOfferingScheduleMode = "weekly" | "one_off";
-export type MacadamiaOnboardingWeekday = "monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday";
+export type PublicOnboardingSurfaceId = 'macadamia';
+export type MacadamiaOnboardingTeamMode = 'solo' | 'team';
+export type MacadamiaOnboardingOfferingKind = 'classes' | 'courses' | 'workshops' | 'retreats' | 'performances' | 'private_sessions';
+export type MacadamiaOnboardingStyleMood = 'calm_grounding' | 'warm_welcoming' | 'modern_polished' | 'natural_earthy' | 'bright_uplifting' | 'luxury_retreat';
+export type MacadamiaOnboardingFirstOfferingKind = 'class' | 'course' | 'workshop' | 'retreat' | 'performance' | 'private_session';
+export type MacadamiaOnboardingFirstOfferingDeliveryMode = 'in_person' | 'online' | 'both';
+export type MacadamiaOnboardingFirstOfferingScheduleMode = 'weekly' | 'one_off';
+export type MacadamiaOnboardingWeekday = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
 export type MacadamiaOnboardingEventSession = {
     clientId: string;
     startDate: string;
@@ -54,7 +54,7 @@ export type MacadamiaOnboardingEventSession = {
     isMultiDay: boolean;
 };
 export type MacadamiaOnboardingFirstOffering = {
-    kind: "class";
+    kind: 'class';
     title: string;
     description: string | null;
     deliveryMode: MacadamiaOnboardingFirstOfferingDeliveryMode;
@@ -63,21 +63,21 @@ export type MacadamiaOnboardingFirstOffering = {
     recurrenceRule: string;
     startTime: string;
     durationMinutes: number;
-    priceType: "free" | "paid";
+    priceType: 'free' | 'paid';
     priceAmount: number | null;
     capacity: number | null;
 } | {
-    kind: "course";
+    kind: 'course';
     title: string;
     description: string | null;
     deliveryMode: MacadamiaOnboardingFirstOfferingDeliveryMode;
     location: string | null;
-    priceType: "free" | "paid";
+    priceType: 'free' | 'paid';
     priceAmount: number | null;
     capacity: number | null;
     sessions: MacadamiaOnboardingEventSession[];
 } | {
-    kind: "workshop" | "retreat" | "performance";
+    kind: 'workshop' | 'retreat' | 'performance';
     title: string;
     description: string | null;
     deliveryMode: MacadamiaOnboardingFirstOfferingDeliveryMode;
@@ -86,21 +86,21 @@ export type MacadamiaOnboardingFirstOffering = {
     startDate: string;
     startTime: string;
     durationMinutes: number;
-    priceType: "free" | "paid";
+    priceType: 'free' | 'paid';
     priceAmount: number | null;
     capacity: number | null;
 } | {
-    kind: "private_session";
+    kind: 'private_session';
     title: string;
     description: string | null;
     deliveryMode: MacadamiaOnboardingFirstOfferingDeliveryMode;
     location: string | null;
     durationMinutes: number;
-    priceType: "free" | "paid";
+    priceType: 'free' | 'paid';
     priceAmount: number | null;
 };
 export type MacadamiaOnboardingDraftFirstOffering = {
-    kind: "class";
+    kind: 'class';
     title: string;
     description: string | null;
     deliveryMode: MacadamiaOnboardingFirstOfferingDeliveryMode | null;
@@ -109,21 +109,21 @@ export type MacadamiaOnboardingDraftFirstOffering = {
     recurrenceRule: string | null;
     startTime: string | null;
     durationMinutes: number | null;
-    priceType: "free" | "paid" | null;
+    priceType: 'free' | 'paid' | null;
     priceAmount: number | null;
     capacity: number | null;
 } | {
-    kind: "course";
+    kind: 'course';
     title: string;
     description: string | null;
     deliveryMode: MacadamiaOnboardingFirstOfferingDeliveryMode | null;
     location: string | null;
-    priceType: "free" | "paid" | null;
+    priceType: 'free' | 'paid' | null;
     priceAmount: number | null;
     capacity: number | null;
     sessions: MacadamiaOnboardingEventSession[];
 } | {
-    kind: "workshop" | "retreat" | "performance";
+    kind: 'workshop' | 'retreat' | 'performance';
     title: string;
     description: string | null;
     deliveryMode: MacadamiaOnboardingFirstOfferingDeliveryMode | null;
@@ -132,17 +132,17 @@ export type MacadamiaOnboardingDraftFirstOffering = {
     startDate: string | null;
     startTime: string | null;
     durationMinutes: number | null;
-    priceType: "free" | "paid" | null;
+    priceType: 'free' | 'paid' | null;
     priceAmount: number | null;
     capacity: number | null;
 } | {
-    kind: "private_session";
+    kind: 'private_session';
     title: string;
     description: string | null;
     deliveryMode: MacadamiaOnboardingFirstOfferingDeliveryMode | null;
     location: string | null;
     durationMinutes: number | null;
-    priceType: "free" | "paid" | null;
+    priceType: 'free' | 'paid' | null;
     priceAmount: number | null;
 };
 /**
@@ -156,7 +156,7 @@ export type MacadamiaOnboardingDraftFirstOffering = {
  * wizard (read as `website`), explicit `null` means the person has not chosen
  * yet, and a value is the chosen mode.
  */
-export type MacadamiaOnboardingPublicExperience = "website" | "hosted_booking";
+export type MacadamiaOnboardingPublicExperience = PublicExperience;
 /** Plan the person arrived with from pricing. Stored only; no billing action. */
 export type MacadamiaOnboardingPlanPreference = BillingPlanId;
 export type MacadamiaOnboardingSurfaceData = {

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

@@ -26,6 +26,14 @@ export declare const PUBLIC_BOOKING_AVAILABILITY_ENDPOINT_DEFINITIONS: {
         auth: "public";
         responseKind: "json";
     };
+    getPublicBookingServiceBySlug: {
+        path: "/public/bookings/services/by-slug/{slug}";
+        method: "GET";
+        revalidate: number;
+        tags: "riverbank:site:{siteId}:public-booking-services"[];
+        auth: "public";
+        responseKind: "json";
+    };
     getPublicBookingResourcesReference: {
         path: "/public/bookings/resources/reference";
         method: "GET";

package/dist/_dts/api/src/publicExperience/commerceEndpoints.d.ts

@@ -121,6 +121,7 @@ export type PublicCommerceAPIEndpoints = {
         customerId: string;
         amountCents: number;
         currency: string;
+        claimedByEmail: string;
     }>;
     createShopCheckout: APIEndpoint<{
         productType: 'pass' | 'membership';

package/dist/_dts/api/src/publicExperience/eventEndpoints.d.ts

@@ -3,9 +3,9 @@
  *
  * Merged into `PublicExperienceAPIEndpoints` by `../publicExperienceEndpoints`.
  */
-import type { APIEndpoint } from '../apiEndpointTypes';
 import type { EventRegistrationOptionsRequest, EventRegistrationOptionsResponse } from '../../../blocks/src/system/blocks/event-registration';
 import type { PublicWaitlistClaimResponse } from '../../../commerce/src/index';
+import type { APIEndpoint } from '../apiEndpointTypes';
 import type { DirectCheckoutCollectionOptionKind, EventAttendanceMode } from '../bookingConfig';
 import type { EventTicketLineSummaryResponse, EventTicketSelectionRequest, PublicEventLoaderParams } from './sharedTypes';
 /**
@@ -15,9 +15,9 @@ import type { EventTicketLineSummaryResponse, EventTicketSelectionRequest, Publi
  * constituent shape) and surfaced here as the wire contract. Nothing restates
  * it: the dashboard projection and every block consumer import these names.
  */
-export type { PublicEvent, PublicEventBase, PublicWholeSeriesRun, PublicWholeSeriesRunLifecycle, PublicWholeSeriesRunVisibility, PublicRunSession, } from '../../../blocks/src/system/blocks/events/shared/types';
+export type { PublicEvent, PublicEventBase, PublicRunSession, PublicWholeSeriesRun, PublicWholeSeriesRunLifecycle, PublicWholeSeriesRunVisibility, } from '../../../blocks/src/system/blocks/events/shared/types';
+import type { CalendarWindowPage, CalendarWindowRequest } from '../../../blocks/src/contracts/index';
 import type { PublicEvent } from '../../../blocks/src/system/blocks/events/shared/types';
-import type { CalendarWindowRequest, CalendarWindowPage } from '../../../blocks/src/contracts/index';
 export type PublicEventAPIEndpoints = {
     listPublicEventCalendarWindow: APIEndpoint<never, {
         siteId: string;
@@ -118,6 +118,7 @@ export type PublicEventAPIEndpoints = {
         customerMembershipId?: string;
         bundleProductId?: string;
         claimToken?: string;
+        waitlistEntryId?: string;
         guests?: Array<{
             name: string;
             email?: string | null;
@@ -169,6 +170,7 @@ export type PublicEventAPIEndpoints = {
             kind: 'occurrence';
             attendeeId: string;
         };
+        registrationCommandId?: string;
         checkoutType?: 'event' | 'pass_bundle' | 'membership_bundle';
         productId?: string;
         discountCode?: string;
@@ -195,6 +197,7 @@ export type PublicEventAPIEndpoints = {
             phone?: string | null;
         }>;
         claimToken?: string;
+        waitlistEntryId?: string;
         discountCode?: string;
         collectionOptionKind: DirectCheckoutCollectionOptionKind;
         checkoutAttemptId: string;
@@ -211,6 +214,7 @@ export type PublicEventAPIEndpoints = {
     } | {
         scope: 'wholeSeries';
         registrationId: string;
+        checkoutAttemptId: string;
         checkoutUrl: string | null;
         sessionId: string | null;
         bypassed: boolean;
@@ -269,6 +273,10 @@ export type PublicEventAPIEndpoints = {
     }, string>;
     resolveWaitlistClaim: APIEndpoint<{
         claimToken: string;
+        waitlistEntryId?: never;
+    } | {
+        waitlistEntryId: string;
+        claimToken?: never;
     }, {
         siteId: string;
     }, PublicWaitlistClaimResponse>;

package/dist/_dts/api/src/publicExperience/sharedTypes.d.ts

@@ -5,6 +5,7 @@
  */
 import type { AutoAppliedDiscountPreview } from '../bookingRecords';
 import type { MailingListSignupSourceRef, MailingListVisitorSelection } from '../../../core/src/index';
+import type { PublicEventLoaderParams } from '../../../blocks/src/system/blocks/events/shared/types';
 export type { MailingListSignupSourceRef } from '../../../core/src/index';
 export declare const PUBLIC_EVENT_TICKET_SELECTION_CONTRACT_VERSION: "public-event-ticket-selection.v2";
 export type EventTicketSelectionRequest = {
@@ -21,35 +22,8 @@ export type EventTicketLineSummaryResponse = {
     currency: string;
 };
 export type { PublicEventPriceDisplay, PublicEventPricing, } from '../../../core/src/index';
-/** Query parameters accepted by the public event list loaders. */
-export type PublicEventLoaderParams = {
-    limit?: string;
-    from?: string;
-    to?: string;
-    afterStartsAt?: string;
-    afterId?: string;
-    categoryIds?: string;
-    venueId?: string;
-    staffMemberId?: string;
-    eventSurface?: string;
-    eventPresets?: string;
-    scheduleScope?: string;
-    seriesId?: string;
-    seriesIds?: string;
-    runSeriesId?: string;
-    seriesSlug?: string;
-    includeOccurrenceId?: string;
-    /**
-     * What the read is asking for: `'occurrences'` (default) for a page of dates,
-     * `'runs'` for one row per whole-series run regardless of date, or
-     * `'catalogue'` for one representative occurrence per series. Catalogue
-     * reads are complete when `limit` is omitted; cursors and explicit limits
-     * apply after representative selection.
-     */
-    readIntent?: string;
-    detailLevel?: string;
-    readProfile?: string;
-};
+/** Query parameters accepted by the public Event list loaders. */
+export type { PublicEventLoaderParams } from '../../../blocks/src/system/blocks/events/shared/types';
 export type NewsletterSubscribeBody = {
     email: string;
     firstName?: string | null;

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

@@ -0,0 +1,65 @@
+/**
+ * The anonymous onboarding attempt, addressed by its opaque resume token.
+ *
+ * Every route here is reached before there is an account, so none of them can
+ * be scoped to a site or a user: the token is the whole credential. They are
+ * kept together so that stays obvious.
+ */
+export declare const PUBLIC_ONBOARDING_ATTEMPT_ENDPOINT_DEFINITIONS: {
+    createPublicOnboardingAttempt: {
+        path: "/public/onboarding/attempts";
+        method: "POST";
+        auth: "public";
+        errors: never[];
+        responseKind: "json";
+    };
+    createPublicOnboardingLogoUploadUrl: {
+        path: "/public/onboarding/attempts/{attemptToken}/logo-upload-url";
+        method: "POST";
+        auth: "public";
+        errors: never[];
+        responseKind: "json";
+    };
+    uploadPublicOnboardingLogo: {
+        path: "/public/onboarding/attempts/{attemptToken}/logo";
+        method: "POST";
+        auth: "public";
+        errors: never[];
+        responseKind: "json";
+    };
+    getPublicOnboardingAttempt: {
+        path: "/public/onboarding/attempts/{attemptToken}";
+        method: "GET";
+        auth: "public";
+        errors: never[];
+        responseKind: "json";
+    };
+    getPublicOnboardingAttemptProgress: {
+        path: "/public/onboarding/attempts/{attemptToken}/status";
+        method: "GET";
+        auth: "public";
+        errors: never[];
+        responseKind: "json";
+    };
+    updatePublicOnboardingAttempt: {
+        path: "/public/onboarding/attempts/{attemptToken}";
+        method: "PATCH";
+        auth: "public";
+        errors: never[];
+        responseKind: "json";
+    };
+    runPublicOnboardingAttempt: {
+        path: "/public/onboarding/attempts/{attemptToken}/run";
+        method: "POST";
+        auth: "public";
+        errors: never[];
+        responseKind: "json";
+    };
+    resendPublicOnboardingAttemptConfirmation: {
+        path: "/public/onboarding/attempts/{attemptToken}/resend-confirmation";
+        method: "POST";
+        auth: "public";
+        errors: never[];
+        responseKind: "json";
+    };
+};

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

@@ -0,0 +1,20 @@
+/**
+ * Endpoints whose success status does not mean the write happened.
+ *
+ * A revision-guarded write answers a lost race with 200 and a response that
+ * says so, because the client needs the authoritative document back in order
+ * to recover. That is a sound contract, but it means HTTP status is no longer
+ * the whole story: save plumbing that reads 2xx as "saved" will tell someone
+ * their changes are stored when they were rejected.
+ *
+ * Listing an endpoint here makes that impossible to overlook. Save helpers
+ * require callers of these endpoints to say how to read the outcome, and
+ * forbid the question everywhere else, so the answer cannot drift away from
+ * the contract.
+ *
+ * Add an endpoint here in the same change that gives its response a
+ * non-writing variant.
+ */
+export type SaveOutcomeBearingEndpoint = 'updatePublicProfile' | 'updateFooterComposition';
+/** Whether a completed request actually wrote what the caller sent. */
+export type SaveOutcome = 'saved' | 'not-saved';

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

@@ -1,6 +1,6 @@
 import type { BlockContentSource, BlockContentSourceKind, FieldDefinition, FieldDefinitionInput, SdkCustomBlock, SdkCustomBlockInput, Theme } from '../../blocks/src/index';
 import type { ContentTypeSchema } from '../../content-model/src/index';
-import type { FooterCompositionV1, RichTextDoc } from '../../core/src/index';
+import type { EventPreset, FooterCompositionV1, RichTextDoc } from '../../core/src/index';
 export type { SdkBlockAppearanceChoice, SdkBlockAppearanceOutcome, } from './sdkBlockUpsertContracts';
 import type { LinkPayload } from './navigation/types';
 import type { JsonValue } from './shared-contracts';
@@ -9,7 +9,6 @@ import type { ManagementMediaAsset } from './sdkMediaContracts';
 export type { ManagementMediaAsset, SdkMediaDeleteApplyResponse, SdkMediaDeletePreviewResponse, SdkMediaDownloadResponse, SdkMediaListResponse, } from './sdkMediaContracts';
 import type { SdkPullEventOccurrence } from './sdk-event-schedule';
 import type { SiteCommandApplicationResult } from '@riverbankcms/site-commands';
-import type { EventPreset } from '../../core/src/index';
 import type { SdkThemeWire } from './sdkThemeWire';
 import type { SdkCatalogButtonStyleControl } from './sdkThemeCatalogContracts';
 export type { SdkCatalogButtonRole, SdkCatalogButtonStyleControl, } from './sdkThemeCatalogContracts';
@@ -201,11 +200,7 @@ export interface RiverbankSiteConfigInput extends Omit<RiverbankSiteConfig, 'cus
     customBlocks?: SdkCustomBlockInput[];
     blockFieldExtensions?: SdkBlockFieldExtensionsInputMap;
 }
-export type PushSdkConfigRequest = {
-    config: RiverbankSiteConfigInput;
-    forceContentTypes?: boolean;
-    mode?: 'apply' | 'preview';
-};
+export type { PushSdkConfigRequest } from './sdkPushContracts';
 export type SyncCollectionResult = {
     created: number;
     updated: number;
@@ -243,21 +238,7 @@ export type SdkConfigSyncResult = {
     footerBlocks: SyncFooterBlocksResult;
     ignoredDocumentSections: IgnoredDocumentSyncSection[];
 };
-export type PushSdkConfigResponse = {
-    success: true;
-    mode: 'apply' | 'preview';
-    message: string;
-    /**
-     * Legacy all-content-shaped sync payload retained for published CLIs that
-     * still read document sync buckets such as `sync.pages.errors`.
-     */
-    sync: SdkContentSyncResult | null;
-    /**
-     * Schema/config-only push-config result. New clients should prefer this over
-     * `sync` so document sections stay unrepresentable in the active contract.
-     */
-    configSync: SdkConfigSyncResult | null;
-};
+export type { PushSdkConfigResponse } from './sdkPushContracts';
 export interface SdkBackfillPageResult {
     pagesUpdated: number;
     identifiersAssigned: Record<string, string>;

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

@@ -0,0 +1,18 @@
+import type { MailingListProviderScope } from '../../core/src/index';
+import type { RiverbankSiteConfigInput, SdkConfigSyncResult, SdkContentSyncResult } from './sdkContracts';
+export type PushSdkConfigRequest = {
+    config: RiverbankSiteConfigInput;
+    forceContentTypes?: boolean;
+    mode?: 'apply' | 'preview';
+    expectedMailingListProviderScope?: MailingListProviderScope;
+};
+export type PushSdkConfigResponse = {
+    success: true;
+    mode: 'apply' | 'preview';
+    message: string;
+    /** Legacy document-sync result read by already-published CLI versions. */
+    sync: SdkContentSyncResult | null;
+    /** Canonical schema/config-only result for current clients. */
+    configSync: SdkConfigSyncResult | null;
+    mailingListProviderScope: MailingListProviderScope | null;
+};