@riverbankcms/sdk 0.148.0 → 0.150.0

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

@@ -1,5 +1,5 @@
 import { type BlockButtonRole } from '../../constants/buttonRoles';
-import type { PublicMembershipProduct } from '../../blocks/shop.shared';
+import { type PublicMembershipProduct } from '../../blocks/shop.shared';
 import type { PublicProduct } from '../../blocks/products/shared';
 import { type CartDisplay, type CheckoutDisplay, type PassesMembershipsDisplay, type ProductDetailDisplay, type ProductListDisplay } from './commerce/shared/display';
 import type { CommerceCartItem } from './shop-commerce.shared';
@@ -112,7 +112,14 @@ export declare const shopBlockRuntime: Readonly<{
                 description: string | null;
                 priceLabel: string;
                 intervalLabel: string;
-                actionLabel: string;
+                action: Readonly<{
+                    kind: "purchase";
+                    label: string;
+                    product: import("../..").PurchasablePublicMembershipProduct;
+                }> | Readonly<{
+                    kind: "unavailable";
+                    label: string;
+                }>;
             }>[];
         }>;
         hydration: Readonly<{
@@ -161,7 +168,14 @@ export declare const shopBlockRuntime: Readonly<{
                         description: string | null;
                         priceLabel: string;
                         intervalLabel: string;
-                        actionLabel: string;
+                        action: Readonly<{
+                            kind: "purchase";
+                            label: string;
+                            product: import("../..").PurchasablePublicMembershipProduct;
+                        }> | Readonly<{
+                            kind: "unavailable";
+                            label: string;
+                        }>;
                     }>[];
                 }>;
                 hydration: Readonly<{
@@ -204,7 +218,14 @@ export declare const shopBlockRuntime: Readonly<{
                         description: string | null;
                         priceLabel: string;
                         intervalLabel: string;
-                        actionLabel: string;
+                        action: Readonly<{
+                            kind: "purchase";
+                            label: string;
+                            product: import("../..").PurchasablePublicMembershipProduct;
+                        }> | Readonly<{
+                            kind: "unavailable";
+                            label: string;
+                        }>;
                     }>[];
                 }>;
                 hydration: Readonly<{
@@ -565,7 +586,14 @@ export declare const shopInteractiveIslandPropsCodec: Readonly<{
                     description: string | null;
                     priceLabel: string;
                     intervalLabel: string;
-                    actionLabel: string;
+                    action: Readonly<{
+                        kind: "purchase";
+                        label: string;
+                        product: import("../..").PurchasablePublicMembershipProduct;
+                    }> | Readonly<{
+                        kind: "unavailable";
+                        label: string;
+                    }>;
                 }>[];
             }>;
             hydration: Readonly<{
@@ -618,7 +646,14 @@ export declare const shopInteractiveIslandPropsCodec: Readonly<{
                     description: string | null;
                     priceLabel: string;
                     intervalLabel: string;
-                    actionLabel: string;
+                    action: Readonly<{
+                        kind: "purchase";
+                        label: string;
+                        product: import("../..").PurchasablePublicMembershipProduct;
+                    }> | Readonly<{
+                        kind: "unavailable";
+                        label: string;
+                    }>;
                 }>[];
             }>;
             hydration: Readonly<{

package/dist/_dts/blocks/src/system/runtime/shared/bookingPaymentOptions.d.ts

@@ -1,5 +1,6 @@
+import { type BookingPaymentCollectionOptionKind } from '../../../../../core/src/index';
 import type { BlockBookingPaymentCollectionOption, BlockBookingPaymentTerms } from '../../blocks/shared/bookingPaymentTerms';
-export type BookingPaymentSelectionKind = 'upfront' | 'deferred_manual' | 'instalment_plan' | 'flexible_balance';
+export type BookingPaymentSelectionKind = BookingPaymentCollectionOptionKind;
 export type BookingPaymentOptionSummaryRow = Readonly<{
     label: string;
     value: string;
@@ -21,7 +22,6 @@ export type BookingPaymentSelectionViewModel = Readonly<{
 export declare function resolveBookingPaymentDueNowCents(input: Readonly<{
     option: BlockBookingPaymentCollectionOption;
     totalCents: number;
-    bookingStartAt?: string | null;
 }>): number;
 export declare function buildBookingPaymentSelectionViewModel(input: Readonly<{
     serviceTitle: string;
@@ -29,5 +29,10 @@ export declare function buildBookingPaymentSelectionViewModel(input: Readonly<{
     priceAmount?: number | null;
     priceCurrency?: string | null;
     bookingStartAt?: string | null;
+    /**
+     * When the booking is being made, as an ISO timestamp. Instalment schedules
+     * start from here, the same anchor the server uses (the order's creation).
+     */
+    nowIso: string;
     locale?: string;
 }>): BookingPaymentSelectionViewModel;

package/dist/_dts/blocks/src/system/runtime/shared/stripe/browserStripe.d.ts

@@ -0,0 +1,8 @@
+import type { Stripe } from '@stripe/stripe-js';
+import type { EmbeddedCheckoutBrowserContext } from '../../../../../../commerce/src/purchase/index';
+import type { BrowserStripeKey } from '../../../../../../commerce/src/purchase/index';
+export { checkBrowserStripeKey, type BrowserStripeKey } from '../../../../../../commerce/src/purchase/index';
+/** Pure entry loading stays inert until a payment surface calls this function. */
+export declare function loadBrowserStripe(context: EmbeddedCheckoutBrowserContext | Extract<BrowserStripeKey, {
+    tag: 'ready';
+}>): Promise<Stripe | null>;

package/dist/_dts/blocks/src/system/transforms/registry/eventCalendar.d.ts

@@ -20,4 +20,12 @@ declare const readJobSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const eventCalendarReadProfile: TransformDefinition;
 export declare const eventCalendarReadEnabled: TransformDefinition<z.infer<typeof readJobSchema>>;
+/**
+ * The week board's authored band paints `surfaceAlt` across the whole
+ * section, under whatever foreground the section resolved. That foreground is
+ * the page's only when the section paints nothing itself, so the band is
+ * honoured on a plain section and dropped when a Look or override already
+ * paints one (light band text on a pale board band otherwise).
+ */
+export declare const eventCalendarBanded: TransformDefinition;
 export {};

package/dist/_dts/commerce/src/purchase/bookingPaymentSelection.d.ts

@@ -0,0 +1,54 @@
+import type { AttendeeId, CheckoutLineId, BookingFlexibleBalanceConfig, BookingInstalmentPlanConfig, EventSeriesId, OccurrenceId } from '../../../core/src/index';
+/** Identity within one checkout; a cart line is a booking command before persistence. */
+export type BookingPaymentAttendeeReference = Readonly<{
+    kind: 'persisted';
+    attendeeId: AttendeeId;
+}> | Readonly<{
+    kind: 'checkout_command';
+    checkoutLineId: CheckoutLineId;
+}>;
+/**
+ * The booking a payment plan or flexible-balance contract collects for. A plan
+ * or contract may only cover checkout lines that belong to this booking.
+ */
+export type BookingPaymentBookingReference = Readonly<{
+    kind: 'appointment';
+    serviceId: string;
+    resourceId: string;
+    startAt: string;
+}> | Readonly<{
+    kind: 'event_ticket';
+    occurrenceId: OccurrenceId;
+    attendee: BookingPaymentAttendeeReference;
+}> | Readonly<{
+    kind: 'event_series_registration';
+    eventSeriesId: EventSeriesId;
+    attendee: BookingPaymentAttendeeReference;
+}>;
+/**
+ * How one booking is paid for, resolved from its payment terms and the
+ * customer's choice. Appointments and attendee bookings share this shape.
+ *
+ * `not_required` is the £0 path: nothing is due, so no option was chosen.
+ * Plans and contracts carry the booking they collect for and when it starts.
+ */
+export type BookingPaymentSelection = Readonly<{
+    kind: 'not_required';
+}> | Readonly<{
+    kind: 'upfront' | 'deferred_manual';
+}> | Readonly<{
+    kind: 'instalment_plan';
+    plan: BookingInstalmentPlanConfig;
+    booking: BookingPaymentBookingReference;
+    bookingStartAt: string;
+}> | Readonly<{
+    kind: 'flexible_balance';
+    config: BookingFlexibleBalanceConfig;
+    booking: BookingPaymentBookingReference;
+    bookingStartAt: string;
+}>;
+export type BookingPlanOrContractSelection = Extract<BookingPaymentSelection, {
+    kind: 'instalment_plan' | 'flexible_balance';
+}>;
+export declare function isBookingPlanOrContractSelection(selection: BookingPaymentSelection): selection is BookingPlanOrContractSelection;
+export declare function isSameBookingPaymentReference(left: BookingPaymentBookingReference, right: BookingPaymentBookingReference): boolean;

package/dist/_dts/commerce/src/purchase/checkoutCommitPlan.d.ts

@@ -6,7 +6,7 @@ export type CheckoutCommitOrderRecord = Readonly<{
     reconciliationState: OrderCheckoutReconciliationState;
 }>;
 export type CheckoutCommitOrderItemRecord = Readonly<Pick<OrderItemPlanningRecord, 'kind' | 'commitState' | 'reconciliationState' | 'fulfilledAt' | 'cancelledAt' | 'customerMembershipId'>>;
-export type CheckoutCommitPlanStepKind = 'consume_credit_reservation' | 'provision_memberships' | 'fulfill_order_items' | 'redeem_discount' | 'record_order_payment';
+export type CheckoutCommitPlanStepKind = 'consume_credit_reservation' | 'provision_memberships' | 'fulfill_order_items' | 'redeem_discount';
 export type NormalizedOrderCommitItem<TItem extends CheckoutCommitOrderItemRecord = CheckoutCommitOrderItemRecord> = Readonly<{
     item: TItem;
     commitState: OrderItemCommitState;
@@ -18,23 +18,68 @@ export type NormalizedOrderCommitSnapshot<TOrder extends CheckoutCommitOrderReco
     reconciliationState: OrderCheckoutReconciliationState;
     items: readonly NormalizedOrderCommitItem<TItem>[];
 }>;
-export type CheckoutCommitPlanStep = Readonly<{
-    kind: CheckoutCommitPlanStepKind;
+/** Bypass checkouts take no Stripe session, so nothing provisions memberships from one. */
+export type BypassCheckoutCommitPlanStepKind = Exclude<CheckoutCommitPlanStepKind, 'provision_memberships'>;
+export type CheckoutCommitPlanStep<TStep extends CheckoutCommitPlanStepKind = CheckoutCommitPlanStepKind> = Readonly<{
+    kind: TStep;
 }>;
-export type CheckoutCommitPlan<TOrder extends CheckoutCommitOrderRecord = CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord = CheckoutCommitOrderItemRecord> = Readonly<{
-    paymentRail: CheckoutPaymentRail;
+/** A bypass commit never records a payment: there is no cash to record. */
+export type BypassCheckoutCommitPlan<TOrder extends CheckoutCommitOrderRecord = CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord = CheckoutCommitOrderItemRecord> = Readonly<{
+    paymentRail: Extract<CheckoutPaymentRail, 'bypass'>;
+    normalized: NormalizedOrderCommitSnapshot<TOrder, TItem>;
+    steps: readonly CheckoutCommitPlanStep<BypassCheckoutCommitPlanStepKind>[];
+    paymentRecord: Extract<CheckoutCommitPaymentRecord, 'not_needed'>;
+}>;
+export type StripeCheckoutCommitPlan<TOrder extends CheckoutCommitOrderRecord = CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord = CheckoutCommitOrderItemRecord> = Readonly<{
+    paymentRail: Extract<CheckoutPaymentRail, 'stripe'>;
     normalized: NormalizedOrderCommitSnapshot<TOrder, TItem>;
     steps: readonly CheckoutCommitPlanStep[];
+    paymentRecord: CheckoutCommitPaymentRecord;
 }>;
-export declare function normalizeOrderCommitSnapshot<TOrder extends CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord>(input: {
-    order: TOrder;
-    items: readonly TItem[];
-}): NormalizedOrderCommitSnapshot<TOrder, TItem>;
-export declare function buildCheckoutCommitPlan<TOrder extends CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord>(input: {
-    paymentRail: CheckoutPaymentRail;
+export type CheckoutCommitPlan<TOrder extends CheckoutCommitOrderRecord = CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord = CheckoutCommitOrderItemRecord> = BypassCheckoutCommitPlan<TOrder, TItem> | StripeCheckoutCommitPlan<TOrder, TItem>;
+type CheckoutCommitPlanInputBase<TOrder extends CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord> = Readonly<{
     order: TOrder;
     items: readonly TItem[];
     creditReservationState: ReservationFinalizationState;
     hasDiscountRedemption: boolean;
-    paymentRecorded: boolean;
-}): CheckoutCommitPlan<TOrder, TItem>;
+}>;
+export type BypassCheckoutCommitPlanInput<TOrder extends CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord> = CheckoutCommitPlanInputBase<TOrder, TItem> & Readonly<{
+    paymentRail: Extract<CheckoutPaymentRail, 'bypass'>;
+}>;
+export type StripeCheckoutCommitPlanInput<TOrder extends CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord> = CheckoutCommitPlanInputBase<TOrder, TItem> & Readonly<{
+    paymentRail: Extract<CheckoutPaymentRail, 'stripe'>;
+    /**
+     * True when the commit has no payment of its own to record: the webhook
+     * recorded the session's receipt before the plan ran, or a subscription
+     * invoice owns the cash (its invoice.paid webhook records it).
+     */
+    paymentOwnedElsewhere: boolean;
+}>;
+/**
+ * Whether the commit records the order's payment once every step has
+ * completed. A Stripe checkout records here only when nothing else owns its
+ * payment (see `paymentOwnedElsewhere`): in practice a zero-total checkout,
+ * whose record completes the order without a cash receipt.
+ */
+export type CheckoutCommitPaymentRecord = 'record_after_steps' | 'not_needed';
+/**
+ * What a checkout commit has done so far that a failure has to undo. The two
+ * facts move independently: a resumed commit can start with fulfillment
+ * already committed and credit still held. `held` also covers a checkout
+ * with no credit reservation, since there is nothing consumed to refund.
+ */
+export type CheckoutCommitProgress = Readonly<{
+    credit: 'held' | 'consumed';
+    fulfillment: Extract<CheckoutCommitState, 'pending' | 'committed'>;
+}>;
+/** Progress before the first step: items an earlier run committed count as fulfilled. */
+export declare function initialCheckoutCommitProgress(normalized: Pick<NormalizedOrderCommitSnapshot, 'items'>): CheckoutCommitProgress;
+/** Progress after `step` completes. */
+export declare function advanceCheckoutCommitProgress(progress: CheckoutCommitProgress, step: CheckoutCommitPlanStepKind): CheckoutCommitProgress;
+export declare function normalizeOrderCommitSnapshot<TOrder extends CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord>(input: {
+    order: TOrder;
+    items: readonly TItem[];
+}): NormalizedOrderCommitSnapshot<TOrder, TItem>;
+export declare function buildCheckoutCommitPlan<TOrder extends CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord>(input: BypassCheckoutCommitPlanInput<TOrder, TItem>): BypassCheckoutCommitPlan<TOrder, TItem>;
+export declare function buildCheckoutCommitPlan<TOrder extends CheckoutCommitOrderRecord, TItem extends CheckoutCommitOrderItemRecord>(input: StripeCheckoutCommitPlanInput<TOrder, TItem>): StripeCheckoutCommitPlan<TOrder, TItem>;
+export {};

package/dist/_dts/commerce/src/purchase/checkoutCopy.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Customer copy shared by checkout surfaces, so one approved wording reaches
+ * every place that shows it.
+ */
+export declare const checkoutCopy: {
+    /** A payment is still being confirmed; checking again is safe. */
+    readonly checkoutStillConfirming: "We’re still confirming your payment. This can take a minute – you can check again, and you won’t be charged twice.";
+    /** A previous attempt can't be confirmed automatically; the business needs to check it. */
+    readonly checkoutAssistanceRequired: "We can’t confirm your last payment attempt yet. Please don’t pay again – contact the business so they can check it.";
+};

package/dist/_dts/commerce/src/purchase/checkoutErrorCodes.d.ts

@@ -1 +1 @@
-export type CheckoutErrorCode = "appointment_not_found" | "appointment_slot_unavailable" | "appointment_payment_terms_not_supported" | "booking_payment_terms_not_supported" | "checkout_amount_below_minimum" | "sliding_amount_required" | "sliding_amount_invalid" | "sliding_amount_below_min" | "sliding_amount_above_max" | "not_found" | "site_mismatch" | "registration_disabled" | "invalid_payment_method" | "payment_already_completed" | "invalid_payment_status" | "no_event_association" | "payment_not_required" | "customer_not_found" | "stripe_not_configured" | "stripe_commission_not_supported" | "stripe_tax_not_ready" | "stripe_tax_status_unavailable" | "whole_series_pricing_option_not_available" | "product_not_available" | "product_not_eligible" | "insufficient_credits" | "invalid_discount_code" | "unsupported_discount_scope" | "checkout_in_progress" | "stripe_error" | "internal_error";
+export type CheckoutErrorCode = "appointment_not_found" | "appointment_slot_unavailable" | "booking_payment_terms_not_supported" | "checkout_amount_below_minimum" | "sliding_amount_required" | "sliding_amount_invalid" | "sliding_amount_below_min" | "sliding_amount_above_max" | "not_found" | "site_mismatch" | "registration_disabled" | "invalid_payment_method" | "payment_already_completed" | "invalid_payment_status" | "no_event_association" | "payment_not_required" | "customer_not_found" | "stripe_not_configured" | "stripe_commission_not_supported" | "stripe_tax_not_ready" | "stripe_tax_status_unavailable" | "whole_series_pricing_option_not_available" | "product_not_available" | "product_not_eligible" | "insufficient_credits" | "invalid_discount_code" | "unsupported_discount_scope" | "checkout_in_progress" | "stripe_error" | "internal_error";

package/dist/_dts/commerce/src/purchase/checkoutPaymentPlanPlanning.d.ts

@@ -1,30 +1,25 @@
-import { type BookingFlexibleBalanceConfig } from '../../../core/src/index';
-export type CheckoutStripeRequiredPaymentObligation<TInstalmentPlan, TFlexibleBalanceConfig extends BookingFlexibleBalanceConfig> = Readonly<{
+import { type BookingFlexibleBalanceConfig, type BookingInstalmentPlanConfig } from '../../../core/src/index';
+import type { BookingPaymentSelection } from './bookingPaymentSelection';
+/**
+ * What a paid checkout has to collect, given its payment selection. Paying in
+ * full, having nothing due and not choosing at all are all collected as one
+ * card payment; the free and credit-covered cases bypass before this matters.
+ */
+export type CheckoutPaymentObligation = Readonly<{
     kind: 'stripe';
+}> | Readonly<{
+    kind: 'deferred_manual';
 }> | Readonly<{
     kind: 'instalment_plan';
-    planDefinition: TInstalmentPlan;
+    planDefinition: BookingInstalmentPlanConfig;
 }> | Readonly<{
     kind: 'flexible_balance';
-    config: TFlexibleBalanceConfig;
-    initialPaymentCents: number;
+    config: BookingFlexibleBalanceConfig;
+    configuredPaymentDueNowCents: number;
     bookingStartAt: string;
     dueAt: string;
 }>;
-export type CheckoutStripeRequiredPaymentTerms<TInstalmentPlan, TFlexibleBalanceConfig extends BookingFlexibleBalanceConfig> = Readonly<{
-    kind: 'standard';
-}> | Readonly<{
-    kind: 'instalment_plan';
-    planDefinition: TInstalmentPlan;
-}> | Readonly<{
-    kind: 'flexible_balance';
-    selection: Readonly<{
-        config: TFlexibleBalanceConfig;
-        bookingStartAt: string;
-        dueAt: string;
-    }>;
-}>;
-export declare function planStripeRequiredCheckoutPaymentObligation<TInstalmentPlan, TFlexibleBalanceConfig extends BookingFlexibleBalanceConfig>(input: Readonly<{
+export declare function planCheckoutPaymentObligation(input: Readonly<{
     totalAfterDiscountCents: number;
-    paymentTerms?: CheckoutStripeRequiredPaymentTerms<TInstalmentPlan, TFlexibleBalanceConfig>;
-}>): CheckoutStripeRequiredPaymentObligation<TInstalmentPlan, TFlexibleBalanceConfig>;
+    paymentSelection: BookingPaymentSelection;
+}>): CheckoutPaymentObligation;

package/dist/_dts/commerce/src/purchase/checkoutPaymentTerms.d.ts

@@ -1,53 +1,36 @@
-import { type BookingFlexibleBalanceConfig } from '../../../core/src/index';
-import { type Result } from '../../../core/src/index';
-export type CheckoutPaymentTermCollectionOptionKind = 'upfront' | 'deferred_manual' | 'instalment_plan' | 'flexible_balance';
+import { type BookingPaymentCollectionOptionKind, type Result } from '../../../core/src/index';
+import { type BookingPaymentSelection } from './bookingPaymentSelection';
+export type CheckoutPaymentTermCollectionOptionKind = BookingPaymentCollectionOptionKind;
 export type CheckoutPaymentTermsError = Readonly<{
     _tag: 'instalment_plan_not_supported';
 }> | Readonly<{
     _tag: 'flexible_balance_empty_cart';
-}> | Readonly<{
-    _tag: 'flexible_balance_requires_single_item';
 }> | Readonly<{
     _tag: 'flexible_balance_not_supported';
 }>;
-export type CheckoutAppointmentPaymentTermSelection<TInstalmentPlan, TFlexibleBalanceConfig extends BookingFlexibleBalanceConfig = BookingFlexibleBalanceConfig> = Readonly<{
-    kind: 'upfront' | 'deferred_manual';
-}> | Readonly<{
-    kind: 'instalment_plan';
-    plan: TInstalmentPlan;
-}> | Readonly<{
-    kind: 'flexible_balance';
-    config: TFlexibleBalanceConfig;
-}> | null;
-export type CheckoutAttendeeBookingPaymentTermSelection<TFlexibleBalanceConfig extends BookingFlexibleBalanceConfig = BookingFlexibleBalanceConfig> = Readonly<{
-    kind: 'upfront' | 'deferred_manual';
-}> | Readonly<{
-    kind: 'flexible_balance';
-    config: TFlexibleBalanceConfig;
-}> | null;
-export type CheckoutPaymentTermLine<TInstalmentPlan, TFlexibleBalanceConfig extends BookingFlexibleBalanceConfig = BookingFlexibleBalanceConfig> = Readonly<{
-    kind: 'appointment';
-    bookingStartAt: string;
-    selectedCollectionOption: CheckoutAppointmentPaymentTermSelection<TInstalmentPlan, TFlexibleBalanceConfig>;
-}> | Readonly<{
-    kind: 'attendee_booking';
-    bookingStartAt?: string | null;
-    selectedCollectionOption: CheckoutAttendeeBookingPaymentTermSelection<TFlexibleBalanceConfig>;
+/**
+ * A checkout line as payment terms see it. Bookings carry the selection their
+ * own terms resolved to; products and passes carry none.
+ */
+export type CheckoutPaymentTermLine = Readonly<{
+    kind: 'booking';
+    selection: BookingPaymentSelection;
 }> | Readonly<{
     kind: 'other';
 }>;
-export type CheckoutFlexibleBalanceSelection<TFlexibleBalanceConfig extends BookingFlexibleBalanceConfig = BookingFlexibleBalanceConfig> = Readonly<{
-    config: TFlexibleBalanceConfig;
-    bookingStartAt: string;
-    dueAt: string;
-}>;
-export type CheckoutPaymentTerms<TInstalmentPlan, TFlexibleBalanceConfig extends BookingFlexibleBalanceConfig = BookingFlexibleBalanceConfig> = Readonly<{
-    instalmentPlanDefinition: TInstalmentPlan | null;
-    flexibleBalanceSelection: CheckoutFlexibleBalanceSelection<TFlexibleBalanceConfig> | null;
-}>;
-type CheckoutPaymentTermsInput<TInstalmentPlan, TFlexibleBalanceConfig extends BookingFlexibleBalanceConfig> = Readonly<{
+type CheckoutPaymentTermsInput = Readonly<{
     requestedCollectionOptionKind?: CheckoutPaymentTermCollectionOptionKind;
-    items: readonly CheckoutPaymentTermLine<TInstalmentPlan, TFlexibleBalanceConfig>[];
+    items: readonly CheckoutPaymentTermLine[];
 }>;
-export declare function resolveCheckoutPaymentTerms<TInstalmentPlan, TFlexibleBalanceConfig extends BookingFlexibleBalanceConfig = BookingFlexibleBalanceConfig>(input: CheckoutPaymentTermsInput<TInstalmentPlan, TFlexibleBalanceConfig>): Result<CheckoutPaymentTerms<TInstalmentPlan, TFlexibleBalanceConfig>, CheckoutPaymentTermsError>;
+/**
+ * Resolves the one payment selection the whole checkout is paid with.
+ *
+ * A plan or contract only applies when the customer asked for it, and every
+ * line has to belong to the booking it collects for. Without a request the
+ * checkout pays whatever is due in full, even when a line's terms offered only
+ * a plan: that auto-selection stays on the line and isn't applied here.
+ */
+export declare function resolveCheckoutPaymentTerms(input: CheckoutPaymentTermsInput): Result<BookingPaymentSelection, CheckoutPaymentTermsError>;
+/** Checks an already resolved selection without choosing the payment option again. */
+export declare function validateCheckoutPaymentSelection(selection: BookingPaymentSelection, items: readonly CheckoutPaymentTermLine[]): Result<BookingPaymentSelection, CheckoutPaymentTermsError>;
 export {};

package/dist/_dts/commerce/src/purchase/checkoutPresentation.d.ts

@@ -0,0 +1,49 @@
+/** Browser-safe Checkout contracts shared by payment owners. */
+type CheckoutPresentationFields = {
+    hosted: Readonly<{
+        successUrl: string;
+        cancelUrl: string;
+    }>;
+    embedded: Readonly<{
+        returnUrl: string;
+        redirectOnCompletion: 'always' | 'if_required';
+    }>;
+};
+type CheckoutSessionFields = {
+    hosted: Readonly<{
+        checkoutUrl: string;
+    }>;
+    embedded: Readonly<{
+        clientSecret: string;
+        livemode: boolean;
+    }>;
+};
+export type CheckoutMode = keyof CheckoutPresentationFields;
+export type CheckoutPresentation<M extends CheckoutMode = CheckoutMode> = {
+    [K in CheckoutMode]: Readonly<{
+        mode: K;
+    }> & CheckoutPresentationFields[K];
+}[M];
+export type CheckoutSessionHandle<M extends CheckoutMode = CheckoutMode> = {
+    [K in CheckoutMode]: Readonly<{
+        kind: K;
+        sessionId: string;
+    }> & CheckoutSessionFields[K];
+}[M];
+export type EmbeddedCheckoutBrowserContext = Readonly<{
+    kind: 'connect';
+    publishableKey: string;
+    accountId: string;
+}> | Readonly<{
+    kind: 'direct';
+    publishableKey: string;
+}>;
+export type BrowserStripeKey = Readonly<{
+    tag: 'ready';
+    publishableKey: string;
+}> | Readonly<{
+    tag: 'unavailable';
+    reason: 'missing_key' | 'invalid_key' | 'mode_mismatch';
+}>;
+export declare function checkBrowserStripeKey(publishableKey: string | undefined, livemode: boolean): BrowserStripeKey;
+export {};

package/dist/_dts/commerce/src/purchase/checkoutSessionMetadata.d.ts

@@ -17,7 +17,7 @@ export declare const OrderCheckoutSessionMetadataSchema: z.ZodUnion<readonly [z.
     type: z.ZodLiteral<"order">;
     site_id: z.ZodString;
     order_id: z.ZodOptional<z.ZodString>;
-    customer_email: z.ZodString;
+    customer_email: z.ZodOptional<z.ZodString>;
     customer_name: z.ZodOptional<z.ZodString>;
     product_id: z.ZodOptional<z.ZodString>;
     attendee_id: z.ZodOptional<z.ZodString>;
@@ -32,9 +32,9 @@ export declare const OrderCheckoutSessionMetadataSchema: z.ZodUnion<readonly [z.
     credit_reserved_cents: z.ZodOptional<z.ZodString>;
     discount_code_amount_cents: z.ZodOptional<z.ZodString>;
     order_payment_reason: z.ZodOptional<z.ZodEnum<{
-        flexible_balance_paydown: "flexible_balance_paydown";
-        instalment_payoff: "instalment_payoff";
         flexible_balance_initial: "flexible_balance_initial";
+        instalment_payoff: "instalment_payoff";
+        flexible_balance_paydown: "flexible_balance_paydown";
     }>>;
     order_payment_plan_id: z.ZodOptional<z.ZodString>;
     order_flexible_balance_contract_id: z.ZodOptional<z.ZodString>;
@@ -48,7 +48,7 @@ export declare const OrderCheckoutSessionMetadataSchema: z.ZodUnion<readonly [z.
     type: z.ZodLiteral<"order">;
     site_id: z.ZodString;
     order_id: z.ZodOptional<z.ZodString>;
-    customer_email: z.ZodString;
+    customer_email: z.ZodOptional<z.ZodString>;
     customer_name: z.ZodOptional<z.ZodString>;
     product_id: z.ZodOptional<z.ZodString>;
     attendee_id: z.ZodOptional<z.ZodString>;
@@ -63,9 +63,9 @@ export declare const OrderCheckoutSessionMetadataSchema: z.ZodUnion<readonly [z.
     credit_reserved_cents: z.ZodOptional<z.ZodString>;
     discount_code_amount_cents: z.ZodOptional<z.ZodString>;
     order_payment_reason: z.ZodOptional<z.ZodEnum<{
-        flexible_balance_paydown: "flexible_balance_paydown";
-        instalment_payoff: "instalment_payoff";
         flexible_balance_initial: "flexible_balance_initial";
+        instalment_payoff: "instalment_payoff";
+        flexible_balance_paydown: "flexible_balance_paydown";
     }>>;
     order_payment_plan_id: z.ZodOptional<z.ZodString>;
     order_flexible_balance_contract_id: z.ZodOptional<z.ZodString>;

package/dist/_dts/commerce/src/purchase/checkoutStripeFinalizationPlanning.d.ts

@@ -1,5 +1,9 @@
 export type CheckoutStripeFinalizationPaymentPlanKind = 'stripe' | 'instalment_plan' | 'flexible_balance';
-export type CheckoutStripeSessionRecordUpdateTarget = 'order' | 'order_payment_plan' | 'flexible_balance_contract';
+/**
+ * The records besides the order that follow a newly created Stripe session.
+ * The order's own session is bound by the initial-session binder, never here.
+ */
+export type CheckoutStripeSessionRecordUpdateTarget = 'order_payment_plan' | 'flexible_balance_contract';
 export type CheckoutStripeSessionRecordUpdatePlan = Readonly<{
     target: CheckoutStripeSessionRecordUpdateTarget;
     orderId: string;

package/dist/_dts/commerce/src/purchase/checkoutStripeSessionPlanning.d.ts

@@ -1,11 +1,12 @@
 import { type Result } from '../../../core/src/index';
 import { type LineSettlementBreakdown } from './settlement';
 export type CheckoutStripeSessionPaymentPlan = Readonly<{
-    kind: 'stripe' | 'instalment_plan';
+    kind: 'stripe';
     creditReservationId?: string | null;
 }> | Readonly<{
-    kind: 'flexible_balance';
-    initialPaymentCents: number;
+    kind: 'instalment_plan' | 'flexible_balance';
+    /** Only this first payment is charged now; the rest is collected later. */
+    chargeNowCents: number;
     creditReservationId?: string | null;
 }>;
 export type CheckoutStripeSessionPaymentIntentPaymentPlan = Readonly<{
@@ -78,7 +79,7 @@ export type CheckoutStripeSessionPlanningError = Readonly<{
     amountCents: number;
     message: string;
 }> | Readonly<{
-    _tag: 'invalid_flexible_balance_initial_payment';
+    _tag: 'invalid_charge_now_amount';
     amountCents: number;
     message: string;
 }>;

package/dist/_dts/commerce/src/purchase/event-registration-errors.d.ts

@@ -1,4 +1,5 @@
 export type EventRegistrationErrorAction = 'none' | 'retry' | 'places' | 'start' | 'details' | 'payment-options' | 'portal' | 'event';
+export declare const unfinishedBookingAssistanceMessage = "We couldn\u2019t safely find your unfinished booking. Please contact the organiser before trying to book again.";
 export declare const eventRegistrationErrors: {
     readonly registrationClosed: {
         readonly message: "Booking is currently closed for this event. Please contact the organiser if you’d like to find out more.";
@@ -12,6 +13,14 @@ export declare const eventRegistrationErrors: {
         readonly message: "We couldn’t reach the payment provider. Please try again in a minute.";
         readonly action: "retry";
     };
+    readonly paymentHostUnavailable: {
+        readonly message: "Card payments aren’t available on this web address yet. Please contact the organiser to book.";
+        readonly action: "none";
+    };
+    readonly checkoutTemporarilyUnavailable: {
+        readonly message: "Event payments are temporarily unavailable while we make an update. Please try again later.";
+        readonly action: "retry";
+    };
     readonly paymentPageUnavailable: {
         readonly message: "We couldn’t open the payment page. Please refresh this page and try again. If this keeps happening, contact the organiser for help.";
         readonly action: "retry";

package/dist/_dts/commerce/src/purchase/index.d.ts

@@ -3,6 +3,7 @@ export * from './allocation';
 export * from './orderTypes';
 export * from './orderPlanningTypes';
 export * from './bookingInstalmentSchedule';
+export * from './bookingPaymentSelection';
 export * from './cancellationPolicy';
 export * from './checkoutCollectionPlan';
 export * from './checkoutCommitPlan';
@@ -11,14 +12,12 @@ export * from './checkoutErrorCodes';
 export * from './checkoutOrderItemProjection';
 export * from './checkoutPaymentFlow';
 export * from './checkoutPaymentPlanPlanning';
-export * from './checkoutPaymentTermPlanning';
 export * from './checkoutPaymentTerms';
 export * from './checkoutQuantity';
 export * from './checkoutSettlement';
 export * from './checkoutStripeFinalizationPlanning';
 export * from './checkoutStripeSessionPlanning';
 export * from './checkoutSessionMetadata';
-export * from './checkoutValidatedItemPlanning';
 export * from './canonicalRefundPlanner';
 export * from './confirmationEmailPayment';
 export * from './discountApplication';
@@ -34,7 +33,6 @@ export * from './orderHistorySource';
 export * from './orderInstalmentAdminSettlement';
 export * from './orderInstalmentClosure';
 export * from './orderInstalmentLifecycle';
-export * from './orderInstalmentPayoff';
 export * from './orderInstalmentPlan';
 export * from './orderItemMetadata';
 export * from './orderItemSupport';
@@ -54,7 +52,9 @@ export * from './settlement';
 export * from './shopRefundPlanning';
 export * from './stripeMinimumCharge';
 export * from './stripeCheckoutReturnUrl';
+export * from './checkoutCopy';
 export * from './stateTransitions';
 export * from './event-registration-errors';
 export * from './eventCheckoutRecoveryWindow';
 export { STRIPE_COMMISSION_FREE_REASONS, type StripeCommissionFreeReason, } from './stripeCommissionMetadata';
+export * from './checkoutPresentation';

package/dist/_dts/commerce/src/purchase/membershipOrderItemMetadata.d.ts

@@ -0,0 +1,4 @@
+import { type Result } from '../../../core/src/index';
+import type { StripeBookingCommissionOrderItemMetadata } from './stripeCommissionMetadata';
+import type { CheckoutLineMetadata, MembershipOrderItemMetadata } from './orderItemMetadata';
+export declare function parseMembershipOrderItemMetadata(raw: Record<string, unknown>, checkoutLine: CheckoutLineMetadata, commission: StripeBookingCommissionOrderItemMetadata): Result<MembershipOrderItemMetadata, string>;