@riverbankcms/sdk 0.148.0 → 0.149.0

package/dist/_dts/blocks/src/system/runtime/nodes/event-registration/useEventRegistrationWizard.d.ts

@@ -5,6 +5,7 @@ import { useWaitlistClaim } from '../../shared/useWaitlistClaim';
 import { useEventRegistrationStripeReturn } from './useEventRegistrationStripeReturn';
 import { useEventRegistrationSubmit } from './useEventRegistrationSubmit';
 import { useDiscountCodeUi } from './useDiscountCodeUi';
+import { useBookingNowIso } from '../../hooks/useBookingNowIso';
 export type EventRegistrationDetailsCompleteResult = Readonly<{
     ok: true;
     outcome: 'payment-step' | 'submitted';
@@ -30,9 +31,11 @@ export type EventRegistrationWizardDeps = Readonly<{
     useEventRegistrationStripeReturn: typeof useEventRegistrationStripeReturn;
     useEventRegistrationSubmit: typeof useEventRegistrationSubmit;
     useDiscountCodeUi: typeof useDiscountCodeUi;
+    useBookingNowIso: typeof useBookingNowIso;
 }>;
 export declare function useEventRegistrationWizard(options: UseEventRegistrationWizardOptions): {
     api: import("../../api").BoundBlockApiClient;
+    nowIso: string;
     anchorId: string;
     occurrenceContext: {
         id: string;
@@ -165,6 +168,7 @@ export declare function useEventRegistrationWizard(options: UseEventRegistration
 };
 export declare function useEventRegistrationWizardWithDeps(options: UseEventRegistrationWizardOptions, deps: EventRegistrationWizardDeps): {
     api: import("../../api").BoundBlockApiClient;
+    nowIso: string;
     anchorId: string;
     occurrenceContext: {
         id: string;

package/dist/_dts/blocks/src/system/runtime/nodes/events/shared/eventCollectionContract.d.ts

@@ -549,13 +549,13 @@ export declare const eventCollectionSourceSchemaShape: {
         siteTimeZone: z.ZodOptional<z.ZodString>;
         pricing: z.ZodType<import("../../../../../../../core/src/index").PublicEventPricing, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").PublicEventPricing, unknown>>;
         paymentTerms: z.ZodObject<{
-            allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            allowedOptions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"upfront">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"deferred_manual">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"instalment_plan">;
-                plan: z.ZodUnion<readonly [z.ZodObject<{
+                plan: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"deposit_plus_one_remainder">;
                     depositAmountCents: z.ZodNumber;
                     depositRefundability: z.ZodEnum<{
@@ -591,24 +591,24 @@ export declare const eventCollectionSourceSchemaShape: {
                         week: "week";
                         month: "month";
                     }>;
-                }, z.core.$strip>]>;
+                }, z.core.$strip>], "kind">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"flexible_balance">;
                 config: z.ZodObject<{
                     upfrontAmountCents: z.ZodNumber;
-                    dueDateRule: z.ZodUnion<readonly [z.ZodObject<{
+                    dueDateRule: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         kind: z.ZodLiteral<"relative_to_start_date">;
                         daysBeforeStart: z.ZodNumber;
                     }, z.core.$strip>, z.ZodObject<{
                         kind: z.ZodLiteral<"fixed_calendar_date">;
                         dueAt: z.ZodString;
-                    }, z.core.$strip>]>;
+                    }, z.core.$strip>], "kind">;
                     depositRefundability: z.ZodEnum<{
                         refundable: "refundable";
                         non_refundable: "non_refundable";
                     }>;
                 }, z.core.$strip>;
-            }, z.core.$strip>]>>;
+            }, z.core.$strip>], "kind">>;
         }, z.core.$strip>;
         cancellationPolicy: z.ZodObject<{
             refunds: z.ZodObject<{
@@ -1038,13 +1038,13 @@ export declare const eventCollectionSourceSchemaShape: {
         siteTimeZone: z.ZodOptional<z.ZodString>;
         pricing: z.ZodType<import("../../../../../../../core/src/index").PublicEventPricing, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").PublicEventPricing, unknown>>;
         paymentTerms: z.ZodObject<{
-            allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            allowedOptions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"upfront">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"deferred_manual">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"instalment_plan">;
-                plan: z.ZodUnion<readonly [z.ZodObject<{
+                plan: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"deposit_plus_one_remainder">;
                     depositAmountCents: z.ZodNumber;
                     depositRefundability: z.ZodEnum<{
@@ -1080,24 +1080,24 @@ export declare const eventCollectionSourceSchemaShape: {
                         week: "week";
                         month: "month";
                     }>;
-                }, z.core.$strip>]>;
+                }, z.core.$strip>], "kind">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"flexible_balance">;
                 config: z.ZodObject<{
                     upfrontAmountCents: z.ZodNumber;
-                    dueDateRule: z.ZodUnion<readonly [z.ZodObject<{
+                    dueDateRule: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         kind: z.ZodLiteral<"relative_to_start_date">;
                         daysBeforeStart: z.ZodNumber;
                     }, z.core.$strip>, z.ZodObject<{
                         kind: z.ZodLiteral<"fixed_calendar_date">;
                         dueAt: z.ZodString;
-                    }, z.core.$strip>]>;
+                    }, z.core.$strip>], "kind">;
                     depositRefundability: z.ZodEnum<{
                         refundable: "refundable";
                         non_refundable: "non_refundable";
                     }>;
                 }, z.core.$strip>;
-            }, z.core.$strip>]>>;
+            }, z.core.$strip>], "kind">>;
         }, z.core.$strip>;
         cancellationPolicy: z.ZodObject<{
             refunds: z.ZodObject<{
@@ -1588,13 +1588,13 @@ export declare const eventCollectionDisplaySchemaShape: {
         siteTimeZone: z.ZodOptional<z.ZodString>;
         pricing: z.ZodType<import("../../../../../../../core/src/index").PublicEventPricing, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").PublicEventPricing, unknown>>;
         paymentTerms: z.ZodObject<{
-            allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            allowedOptions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"upfront">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"deferred_manual">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"instalment_plan">;
-                plan: z.ZodUnion<readonly [z.ZodObject<{
+                plan: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"deposit_plus_one_remainder">;
                     depositAmountCents: z.ZodNumber;
                     depositRefundability: z.ZodEnum<{
@@ -1630,24 +1630,24 @@ export declare const eventCollectionDisplaySchemaShape: {
                         week: "week";
                         month: "month";
                     }>;
-                }, z.core.$strip>]>;
+                }, z.core.$strip>], "kind">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"flexible_balance">;
                 config: z.ZodObject<{
                     upfrontAmountCents: z.ZodNumber;
-                    dueDateRule: z.ZodUnion<readonly [z.ZodObject<{
+                    dueDateRule: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         kind: z.ZodLiteral<"relative_to_start_date">;
                         daysBeforeStart: z.ZodNumber;
                     }, z.core.$strip>, z.ZodObject<{
                         kind: z.ZodLiteral<"fixed_calendar_date">;
                         dueAt: z.ZodString;
-                    }, z.core.$strip>]>;
+                    }, z.core.$strip>], "kind">;
                     depositRefundability: z.ZodEnum<{
                         refundable: "refundable";
                         non_refundable: "non_refundable";
                     }>;
                 }, z.core.$strip>;
-            }, z.core.$strip>]>>;
+            }, z.core.$strip>], "kind">>;
         }, z.core.$strip>;
         cancellationPolicy: z.ZodObject<{
             refunds: z.ZodObject<{
@@ -2077,13 +2077,13 @@ export declare const eventCollectionDisplaySchemaShape: {
         siteTimeZone: z.ZodOptional<z.ZodString>;
         pricing: z.ZodType<import("../../../../../../../core/src/index").PublicEventPricing, unknown, z.core.$ZodTypeInternals<import("../../../../../../../core/src/index").PublicEventPricing, unknown>>;
         paymentTerms: z.ZodObject<{
-            allowedOptions: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
+            allowedOptions: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
                 kind: z.ZodLiteral<"upfront">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"deferred_manual">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"instalment_plan">;
-                plan: z.ZodUnion<readonly [z.ZodObject<{
+                plan: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"deposit_plus_one_remainder">;
                     depositAmountCents: z.ZodNumber;
                     depositRefundability: z.ZodEnum<{
@@ -2119,24 +2119,24 @@ export declare const eventCollectionDisplaySchemaShape: {
                         week: "week";
                         month: "month";
                     }>;
-                }, z.core.$strip>]>;
+                }, z.core.$strip>], "kind">;
             }, z.core.$strip>, z.ZodObject<{
                 kind: z.ZodLiteral<"flexible_balance">;
                 config: z.ZodObject<{
                     upfrontAmountCents: z.ZodNumber;
-                    dueDateRule: z.ZodUnion<readonly [z.ZodObject<{
+                    dueDateRule: z.ZodDiscriminatedUnion<[z.ZodObject<{
                         kind: z.ZodLiteral<"relative_to_start_date">;
                         daysBeforeStart: z.ZodNumber;
                     }, z.core.$strip>, z.ZodObject<{
                         kind: z.ZodLiteral<"fixed_calendar_date">;
                         dueAt: z.ZodString;
-                    }, z.core.$strip>]>;
+                    }, z.core.$strip>], "kind">;
                     depositRefundability: z.ZodEnum<{
                         refundable: "refundable";
                         non_refundable: "non_refundable";
                     }>;
                 }, z.core.$strip>;
-            }, z.core.$strip>]>>;
+            }, z.core.$strip>], "kind">>;
         }, z.core.$strip>;
         cancellationPolicy: z.ZodObject<{
             refunds: z.ZodObject<{

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/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/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/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>;
@@ -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>;