@riverbankcms/sdk 0.109.0 → 0.111.0

package/dist/_dts/blocks/src/system/runtime/components/registry.client.d.ts

@@ -2090,7 +2090,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 waitlistMessage?: string;
                 membershipMessage?: string;
                 buttonText?: string | null;
-                buttonVariant?: "primary" | "secondary" | "outline";
+                buttonVariant?: import("../../..").BlockButtonRole;
                 stage?: "preview" | "published";
             }>) => Readonly<{
                 display: Readonly<{
@@ -2124,7 +2124,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         waitlistMessage?: string;
                         membershipMessage?: string;
                         buttonText?: string | null;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         stage?: "preview" | "published";
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -2148,7 +2148,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         waitlistMessage?: string;
                         membershipMessage?: string;
                         buttonText?: string | null;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         stage?: "preview" | "published";
                     }>>;
                 }>;
@@ -2200,7 +2200,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     waitlistMessage?: string;
                     membershipMessage?: string;
                     buttonText?: string | null;
-                    buttonVariant?: "primary" | "secondary" | "outline";
+                    buttonVariant?: import("../../..").BlockButtonRole;
                     stage?: "preview" | "published";
                 }>) => Readonly<{
                     display: Readonly<{
@@ -2234,7 +2234,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             waitlistMessage?: string;
                             membershipMessage?: string;
                             buttonText?: string | null;
-                            buttonVariant?: "primary" | "secondary" | "outline";
+                            buttonVariant?: import("../../..").BlockButtonRole;
                             stage?: "preview" | "published";
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -2258,7 +2258,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             waitlistMessage?: string;
                             membershipMessage?: string;
                             buttonText?: string | null;
-                            buttonVariant?: "primary" | "secondary" | "outline";
+                            buttonVariant?: import("../../..").BlockButtonRole;
                             stage?: "preview" | "published";
                         }>>;
                     }>;
@@ -2445,7 +2445,7 @@ export declare const runtimeBackedBlockClientEntries: {
                 showCapacity?: boolean;
                 successMessage?: string;
                 waitlistMessage?: string;
-                buttonVariant?: "primary" | "secondary" | "outline";
+                buttonVariant?: import("../../..").BlockButtonRole;
                 overlayEnabled?: boolean;
                 spamProtectionEnabled?: boolean;
                 stage?: "preview" | "published";
@@ -2490,7 +2490,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         showCapacity?: boolean;
                         successMessage?: string;
                         waitlistMessage?: string;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         overlayEnabled?: boolean;
                         spamProtectionEnabled?: boolean;
                         stage?: "preview" | "published";
@@ -2522,7 +2522,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         showCapacity?: boolean;
                         successMessage?: string;
                         waitlistMessage?: string;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         overlayEnabled?: boolean;
                         spamProtectionEnabled?: boolean;
                         stage?: "preview" | "published";
@@ -2588,7 +2588,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     showCapacity?: boolean;
                     successMessage?: string;
                     waitlistMessage?: string;
-                    buttonVariant?: "primary" | "secondary" | "outline";
+                    buttonVariant?: import("../../..").BlockButtonRole;
                     overlayEnabled?: boolean;
                     spamProtectionEnabled?: boolean;
                     stage?: "preview" | "published";
@@ -2633,7 +2633,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             showCapacity?: boolean;
                             successMessage?: string;
                             waitlistMessage?: string;
-                            buttonVariant?: "primary" | "secondary" | "outline";
+                            buttonVariant?: import("../../..").BlockButtonRole;
                             overlayEnabled?: boolean;
                             spamProtectionEnabled?: boolean;
                             stage?: "preview" | "published";
@@ -2665,7 +2665,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             showCapacity?: boolean;
                             successMessage?: string;
                             waitlistMessage?: string;
-                            buttonVariant?: "primary" | "secondary" | "outline";
+                            buttonVariant?: import("../../..").BlockButtonRole;
                             overlayEnabled?: boolean;
                             spamProtectionEnabled?: boolean;
                             stage?: "preview" | "published";
@@ -2747,7 +2747,7 @@ export declare const runtimeBackedBlockClientEntries: {
                     passes: readonly import("../..").PublicPassProduct[];
                     memberships: readonly import("../..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
-                    buttonVariant: "primary" | "secondary" | "outline" | "link";
+                    buttonVariant: import("../../..").BlockButtonRole;
                 }>;
             }>;
             contracts: Readonly<{
@@ -2789,7 +2789,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
-                            buttonVariant: "primary" | "secondary" | "outline" | "link";
+                            buttonVariant: import("../../..").BlockButtonRole;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -2825,7 +2825,7 @@ export declare const runtimeBackedBlockClientEntries: {
                             passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
-                            buttonVariant: "primary" | "secondary" | "outline" | "link";
+                            buttonVariant: import("../../..").BlockButtonRole;
                         }>;
                     }>>;
                 }>;
@@ -2869,7 +2869,7 @@ export declare const runtimeBackedBlockClientEntries: {
                         passes: readonly import("../..").PublicPassProduct[];
                         memberships: readonly import("../..").PublicMembershipProduct[];
                         passPurchaseMode: "add_to_cart" | "buy_now";
-                        buttonVariant: "primary" | "secondary" | "outline" | "link";
+                        buttonVariant: import("../../..").BlockButtonRole;
                     }>;
                 }>;
                 contracts: Readonly<{
@@ -2911,7 +2911,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 passes: readonly import("../..").PublicPassProduct[];
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                                 passPurchaseMode: "add_to_cart" | "buy_now";
-                                buttonVariant: "primary" | "secondary" | "outline" | "link";
+                                buttonVariant: import("../../..").BlockButtonRole;
                             }>;
                         }>) => unknown;
                         decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -2947,7 +2947,7 @@ export declare const runtimeBackedBlockClientEntries: {
                                 passes: readonly import("../..").PublicPassProduct[];
                                 memberships: readonly import("../..").PublicMembershipProduct[];
                                 passPurchaseMode: "add_to_cart" | "buy_now";
-                                buttonVariant: "primary" | "secondary" | "outline" | "link";
+                                buttonVariant: import("../../..").BlockButtonRole;
                             }>;
                         }>>;
                     }>;

package/dist/_dts/blocks/src/system/runtime/components/runtime-backed-blocks.d.ts

@@ -1056,7 +1056,7 @@ export declare const runtimeBackedBlockServerEntries: {
                 waitlistMessage?: string;
                 membershipMessage?: string;
                 buttonText?: string | null;
-                buttonVariant?: "primary" | "secondary" | "outline";
+                buttonVariant?: import("../../..").BlockButtonRole;
                 stage?: "preview" | "published";
             }>) => Readonly<{
                 display: Readonly<{
@@ -1090,7 +1090,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         waitlistMessage?: string;
                         membershipMessage?: string;
                         buttonText?: string | null;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         stage?: "preview" | "published";
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -1114,7 +1114,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         waitlistMessage?: string;
                         membershipMessage?: string;
                         buttonText?: string | null;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         stage?: "preview" | "published";
                     }>>;
                 }>;
@@ -1232,7 +1232,7 @@ export declare const runtimeBackedBlockServerEntries: {
                 showCapacity?: boolean;
                 successMessage?: string;
                 waitlistMessage?: string;
-                buttonVariant?: "primary" | "secondary" | "outline";
+                buttonVariant?: import("../../..").BlockButtonRole;
                 overlayEnabled?: boolean;
                 spamProtectionEnabled?: boolean;
                 stage?: "preview" | "published";
@@ -1277,7 +1277,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         showCapacity?: boolean;
                         successMessage?: string;
                         waitlistMessage?: string;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         overlayEnabled?: boolean;
                         spamProtectionEnabled?: boolean;
                         stage?: "preview" | "published";
@@ -1309,7 +1309,7 @@ export declare const runtimeBackedBlockServerEntries: {
                         showCapacity?: boolean;
                         successMessage?: string;
                         waitlistMessage?: string;
-                        buttonVariant?: "primary" | "secondary" | "outline";
+                        buttonVariant?: import("../../..").BlockButtonRole;
                         overlayEnabled?: boolean;
                         spamProtectionEnabled?: boolean;
                         stage?: "preview" | "published";
@@ -1389,7 +1389,7 @@ export declare const runtimeBackedBlockServerEntries: {
                     passes: readonly import("../..").PublicPassProduct[];
                     memberships: readonly import("../..").PublicMembershipProduct[];
                     passPurchaseMode: "add_to_cart" | "buy_now";
-                    buttonVariant: "primary" | "secondary" | "outline" | "link";
+                    buttonVariant: import("../../..").BlockButtonRole;
                 }>;
             }>;
             contracts: Readonly<{
@@ -1431,7 +1431,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
-                            buttonVariant: "primary" | "secondary" | "outline" | "link";
+                            buttonVariant: import("../../..").BlockButtonRole;
                         }>;
                     }>) => unknown;
                     decode: (input: unknown) => import("../../../contracts").DecodeResult<Readonly<{
@@ -1467,7 +1467,7 @@ export declare const runtimeBackedBlockServerEntries: {
                             passes: readonly import("../..").PublicPassProduct[];
                             memberships: readonly import("../..").PublicMembershipProduct[];
                             passPurchaseMode: "add_to_cart" | "buy_now";
-                            buttonVariant: "primary" | "secondary" | "outline" | "link";
+                            buttonVariant: import("../../..").BlockButtonRole;
                         }>;
                     }>>;
                 }>;

package/dist/_dts/blocks/src/system/runtime/hooks/useHeadlessWholeSeriesRegistrationFlow.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import { type BlockApiConfig } from '../api';
+import type { CourseRegistrationClientProps } from '../nodes/course-registration/types';
+import { useCourseRegistrationWizard } from '../nodes/course-registration/useCourseRegistrationWizard';
+import type { HeadlessWholeSeriesRegistrationFlow, WholeSeriesRegistrationRunInput } from '../nodes/course-registration/whole-series-registration.headless.contract';
+export type { BlockApiConfig };
+export type { HeadlessWholeSeriesRegistrationFlow, WholeSeriesRegistrationAvailabilityModel, WholeSeriesRegistrationFlowActionResult, WholeSeriesRegistrationFlowActions, WholeSeriesRegistrationFlowStatus, WholeSeriesRegistrationFlowStep, WholeSeriesRegistrationFlowStepId, WholeSeriesRegistrationFlowView, WholeSeriesRegistrationPaymentModel, WholeSeriesRegistrationPaymentSelection, WholeSeriesRegistrationPricingInput, WholeSeriesRegistrationPricingModel, WholeSeriesRegistrationPricingOptionInput, WholeSeriesRegistrationRun, WholeSeriesRegistrationRunInput, WholeSeriesRegistrationRunsModel, WholeSeriesRegistrationSpamProtectionModel, WholeSeriesRegistrationWaitlistClaimModel, } from '../nodes/course-registration/whole-series-registration.headless.contract';
+export type HeadlessWholeSeriesRegistrationFlowOptions = Readonly<{
+    runs?: readonly WholeSeriesRegistrationRunInput[];
+    contentEntry?: CourseRegistrationClientProps['contentEntry'];
+    subject?: CourseRegistrationClientProps['subject'];
+}>;
+export type HeadlessWholeSeriesRegistrationProviderProps = Readonly<{
+    config: BlockApiConfig;
+    children?: React.ReactNode;
+}>;
+export type WholeSeriesRegistrationControllerDeps = Readonly<{
+    useCourseRegistrationWizard: typeof useCourseRegistrationWizard;
+}>;
+export declare function createWholeSeriesRegistrationBlockApiConfig(input: Readonly<{
+    siteId: string;
+    apiBaseUrl: string;
+    portalToken?: string | null;
+    previewToken?: string | null;
+    stage?: 'preview' | 'published';
+}>): BlockApiConfig;
+export declare function HeadlessWholeSeriesRegistrationProvider({ config, children, }: HeadlessWholeSeriesRegistrationProviderProps): React.ReactElement;
+export declare function useHeadlessWholeSeriesRegistrationFlow(options: HeadlessWholeSeriesRegistrationFlowOptions): HeadlessWholeSeriesRegistrationFlow;
+export declare function useWholeSeriesRegistrationControllerWithDeps(options: HeadlessWholeSeriesRegistrationFlowOptions, deps: WholeSeriesRegistrationControllerDeps): HeadlessWholeSeriesRegistrationFlow;

package/dist/_dts/blocks/src/system/runtime/nodes/buttonAffordance.d.ts

@@ -3,7 +3,7 @@
  *
  * A button can acquire a trailing icon from two places:
  *   1. The node itself (`trailingIcon` / `trailingIconColorToken` props).
- *   2. The active button personality/variant (`affordance`), supplied by the
+ *   2. The active button style/variant (`affordance`), supplied by the
  *      theme so a variant carries an affordance without per-node authoring.
  *
  * Node-level wins over the personality default. When neither supplies one, the

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/ErrorStep.d.ts

@@ -2,13 +2,14 @@
  * Error terminal state component.
  * Shows error message with retry option.
  */
+import type { BlockButtonRole } from '../../../constants/buttonRoles';
 type ErrorStepProps = {
     /** Error message to display */
     message: string;
     /** Button text */
     buttonText?: string;
     /** Button style variant */
-    buttonVariant?: 'primary' | 'secondary' | 'outline';
+    buttonVariant?: BlockButtonRole;
     /** Callback when retry is clicked */
     onRetry: () => void;
 };

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/PaymentFailedStep.d.ts

@@ -2,13 +2,14 @@
  * Payment failed terminal state component.
  * Shows when payment could not be processed.
  */
+import type { BlockButtonRole } from '../../../constants/buttonRoles';
 type PaymentFailedStepProps = {
     /** Error message to display */
     message?: string;
     /** Button text */
     buttonText?: string;
     /** Button style variant */
-    buttonVariant?: 'primary' | 'secondary' | 'outline';
+    buttonVariant?: BlockButtonRole;
     /** Callback when retry is clicked */
     onRetry: () => void;
 };

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/VerifyingTimeoutStep.d.ts

@@ -2,11 +2,12 @@
  * Verifying timeout terminal state component.
  * Shows when payment verification takes too long.
  */
+import type { BlockButtonRole } from '../../../constants/buttonRoles';
 type VerifyingTimeoutStepProps = {
     /** Button text */
     buttonText?: string;
     /** Button style variant */
-    buttonVariant?: 'primary' | 'secondary' | 'outline';
+    buttonVariant?: BlockButtonRole;
     /** Callback when check again is clicked */
     onCheckAgain: () => void;
     /** Optional support email to display */

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/types.d.ts

@@ -29,6 +29,20 @@ export type EnrollmentResult = {
     waitlistPosition?: number;
     usedMembership?: boolean;
 };
+export type CourseRegistrationWizardActionResult = Readonly<{
+    kind: 'state-updated';
+}> | Readonly<{
+    kind: 'checkout-redirect';
+    checkoutUrl: string;
+}> | Readonly<{
+    kind: 'validation-failed';
+}> | Readonly<{
+    kind: 'blocked';
+    message: string;
+}> | Readonly<{
+    kind: 'failed';
+    message: string;
+}>;
 /**
  * Content entry context from CMS
  */
@@ -105,3 +119,10 @@ export interface CourseRegistrationClientProps extends CourseRegistrationBasePro
     /** @deprecated Stage is now controlled by BlockApiProvider's isPreview config */
     stage?: 'preview' | 'published';
 }
+export type CourseRegistrationWizardOptions = Readonly<{
+    /**
+     * Receives checkout destinations for headless consumers. The default UI
+     * navigates automatically when this callback is absent.
+     */
+    onCheckoutRedirect?: (checkoutUrl: string) => void;
+}>;

package/dist/_dts/blocks/src/system/runtime/nodes/course-registration/useCourseRegistrationWizard.d.ts

@@ -1,8 +1,8 @@
 import type { PublicCourse } from '../../../blocks/courses/shared';
 import type { CourseEligibilityCheckResponse } from '../../api/types';
-import type { BookingMode, CourseRegistrationClientProps, EnrollmentResult, EnrollmentStep, FormData, PortalAuthState } from './types';
+import type { BookingMode, CourseRegistrationClientProps, CourseRegistrationWizardActionResult, CourseRegistrationWizardOptions, EnrollmentResult, EnrollmentStep, FormData, PortalAuthState } from './types';
 type PaymentChoice = 'checkout' | 'membership';
-export declare function useCourseRegistrationWizard(props: CourseRegistrationClientProps): {
+export declare function useCourseRegistrationWizard(props: CourseRegistrationClientProps, options?: CourseRegistrationWizardOptions): {
     api: import("../../api").BlockApiClient;
     scopedCourses: PublicCourse[];
     step: EnrollmentStep;
@@ -69,8 +69,8 @@ export declare function useCourseRegistrationWizard(props: CourseRegistrationCli
     hasPreSelectedCourse: boolean;
     hasCoursePayment: boolean;
     handleCourseSelect: (course: PublicCourse) => void;
-    handleSubmit: () => Promise<void>;
-    handlePaymentContinue: () => Promise<void>;
+    handleSubmit: () => Promise<CourseRegistrationWizardActionResult>;
+    handlePaymentContinue: () => Promise<CourseRegistrationWizardActionResult>;
     handleRetry: () => void;
     handleBookingModeChange: (mode: BookingMode) => void;
 };