@riverbankcms/sdk 0.130.0 → 0.132.0

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

@@ -0,0 +1,91 @@
+import type { OrderPaymentMethod } from './orderTypes';
+export type ConfirmationEmailPaymentSummary = Readonly<{
+    kind: 'free';
+}> | Readonly<{
+    kind: 'manual_due';
+}> | Readonly<{
+    kind: 'managed_balance_due';
+    dueAt: string | null;
+}> | Readonly<{
+    kind: 'waived';
+}> | Readonly<{
+    kind: 'pass';
+    passName?: string;
+    passCreditsUsed?: number;
+}> | Readonly<{
+    kind: 'membership';
+    membershipName?: string;
+}> | Readonly<{
+    kind: 'monetary';
+    amountPaidCents: number;
+    amountOutstandingCents?: number;
+    dueAt?: string | null;
+    currency: string;
+    paymentMethod: Extract<OrderPaymentMethod, 'stripe' | 'store_credit' | 'mixed'>;
+}>;
+export type ConfirmationEmailTemplatePaymentFields = Readonly<{
+    paymentMethod?: 'free' | 'pass' | 'membership' | 'stripe' | 'manual' | 'waived';
+    amountPaid?: number;
+    amountOutstanding?: number;
+    currency?: string;
+    passName?: string;
+    passCreditsUsed?: number;
+    membershipName?: string;
+    managedBalanceDueAt?: string | null;
+}>;
+type NonMonetaryConfirmationPaymentMethod = 'free' | 'pass' | 'membership';
+export declare function settledOrderItemTotalCents(item: Readonly<{
+    netTotalCents: number | null;
+    totalCents: number | null;
+    creditCents: number | null;
+}>): number;
+export declare function buildOrderItemConfirmationEmailPaymentSummary(options: {
+    orderPaymentMethod: OrderPaymentMethod;
+    item: Readonly<{
+        netTotalCents: number | null;
+        totalCents: number | null;
+        creditCents: number | null;
+    }>;
+    currency: string;
+    flexibleBalanceDueAt?: string | null;
+    settlement: Readonly<{
+        kind: 'settled_in_full';
+    }> | Readonly<{
+        kind: 'collected';
+        collectedCents: number;
+    }>;
+}): ConfirmationEmailPaymentSummary;
+export declare function buildEventRegistrationConfirmationEmailPaymentSummary(options: Readonly<{
+    paymentMethod: NonMonetaryConfirmationPaymentMethod;
+    passCreditsUsed?: number;
+}>): ConfirmationEmailPaymentSummary;
+export declare function buildManualAttendeeConfirmationEmailPaymentSummary(options: Readonly<{
+    paymentMethod: NonMonetaryConfirmationPaymentMethod;
+    passName?: string;
+    passCreditsUsed?: number;
+    membershipName?: string;
+}>): ConfirmationEmailPaymentSummary;
+export declare function buildBundleConfirmationEmailPaymentSummary(options: Readonly<{
+    paymentMethod: Extract<NonMonetaryConfirmationPaymentMethod, 'pass' | 'membership'>;
+    passName?: string;
+    passCreditsUsed?: number;
+    membershipName?: string;
+}>): ConfirmationEmailPaymentSummary;
+export declare function buildTransferredAttendeeConfirmationEmailPaymentSummary(options: Readonly<{
+    paymentMethod: NonMonetaryConfirmationPaymentMethod | 'stripe';
+    amountPaidCents?: number | null;
+    currency?: string | null;
+}>): ConfirmationEmailPaymentSummary | undefined;
+export declare function buildCourseEnrollmentConfirmationEmailPaymentSummary(options: Readonly<{
+    paymentMethod: 'free' | 'membership' | 'stripe';
+    amountPaidCents?: number | null;
+    currency?: string | null;
+    membershipName?: string;
+}>): ConfirmationEmailPaymentSummary | undefined;
+export declare function buildBypassedCheckoutConfirmationEmailPaymentSummary(options: Readonly<{
+    bypassReason: 'free' | 'discount_free' | 'store_credit';
+    settledAmountCents: number;
+    currency: string;
+}>): ConfirmationEmailPaymentSummary;
+export declare function toConfirmationEmailTemplatePaymentFields(summary: ConfirmationEmailPaymentSummary | undefined): ConfirmationEmailTemplatePaymentFields;
+export {};

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

@@ -0,0 +1,74 @@
+import type { CheckoutLineId } from '../../../core/src/index';
+import { type NonNegativeCents, type Result } from '../../../core/src/index';
+import type { CurrencyCode } from './settlement';
+export declare const CHECKOUT_DISCOUNT_ALLOCATION_RULE_VERSION: "proportional-v1";
+export type CheckoutDiscountAllocationRuleVersion = typeof CHECKOUT_DISCOUNT_ALLOCATION_RULE_VERSION;
+export type DiscountApplicationSource = 'manual' | 'auto';
+export type DiscountApplicationLineSnapshot<TLineId extends string = CheckoutLineId> = Readonly<{
+    lineId: TLineId;
+    eligible: boolean;
+    basisSubtotalCents: NonNegativeCents;
+    discountCents: NonNegativeCents;
+}>;
+export type DiscountApplicationSnapshot<TLineId extends string = CheckoutLineId> = Readonly<{
+    discountCodeId: string | null;
+    discountRedemptionId: string | null;
+    code: string;
+    displayLabel: string;
+    source: DiscountApplicationSource;
+    currency: CurrencyCode;
+    totalDiscountCents: NonNegativeCents;
+    allocationRuleVersion: CheckoutDiscountAllocationRuleVersion;
+    items: readonly DiscountApplicationLineSnapshot<TLineId>[];
+}>;
+export type CheckoutDiscountApplicationError<TLineId extends string = CheckoutLineId> = Readonly<{
+    _tag: 'empty_cart';
+    message: string;
+}> | Readonly<{
+    _tag: 'invalid_discount_amount';
+    message: string;
+}> | Readonly<{
+    _tag: 'invalid_line_money';
+    lineId: TLineId;
+    field: 'subtotalCents';
+    message: string;
+}>;
+export type CheckoutDiscountApplicationDiscount = Readonly<{
+    discountCodeId: string | null;
+    redemptionId: string | null;
+    discountCode: string;
+    discountPublicLabel: string;
+    autoApplied: boolean;
+    amountDiscountCents: NonNegativeCents;
+}>;
+export type CheckoutDiscountApplicationSelection<TLineId extends string, TDiscount extends CheckoutDiscountApplicationDiscount> = Readonly<{
+    discount: TDiscount;
+    eligibleLineIds: ReadonlySet<TLineId>;
+}>;
+export type CheckoutDiscountApplicationLineInput<TLineId extends string, TPayload> = Readonly<{
+    lineId: TLineId;
+    subtotalCents: NonNegativeCents;
+    payload: TPayload;
+}>;
+export type CheckoutDiscountApplicationInput<TLineId extends string, TPayload, TDiscount extends CheckoutDiscountApplicationDiscount> = Readonly<{
+    currency: CurrencyCode;
+    items: readonly CheckoutDiscountApplicationLineInput<TLineId, TPayload>[];
+    selectedDiscount: CheckoutDiscountApplicationSelection<TLineId, TDiscount> | null;
+}>;
+export type CheckoutDiscountApplicationLine<TLineId extends string, TPayload> = Readonly<{
+    lineId: TLineId;
+    subtotalCents: NonNegativeCents;
+    discountCents: NonNegativeCents;
+    totalAfterDiscountCents: NonNegativeCents;
+    payload: TPayload;
+}>;
+export type CheckoutDiscountApplication<TLineId extends string, TPayload, TDiscount extends CheckoutDiscountApplicationDiscount> = Readonly<{
+    currency: CurrencyCode;
+    items: readonly CheckoutDiscountApplicationLine<TLineId, TPayload>[];
+    subtotalCents: NonNegativeCents;
+    discountCents: NonNegativeCents;
+    totalAfterDiscountCents: NonNegativeCents;
+    discount: TDiscount | null;
+    discountApplication: DiscountApplicationSnapshot<TLineId> | null;
+}>;
+export declare function planCheckoutDiscountApplication<TLineId extends string, TPayload, TDiscount extends CheckoutDiscountApplicationDiscount>(input: CheckoutDiscountApplicationInput<TLineId, TPayload, TDiscount>): Result<CheckoutDiscountApplication<TLineId, TPayload, TDiscount>, CheckoutDiscountApplicationError<TLineId>>;

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

@@ -0,0 +1,55 @@
+export * from './types';
+export * from './orderTypes';
+export * from './orderPlanningTypes';
+export * from './bookingInstalmentSchedule';
+export * from './cancellationPolicy';
+export * from './checkoutCollectionPlan';
+export * from './checkoutCommitPlan';
+export * from './checkoutDiscountContextPlanning';
+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';
+export * from './oneTimeCheckoutPlanning';
+export * from './order-number';
+export * from './orderCancellationPlan';
+export * from './orderConfirmationPlanning';
+export * from './orderCompletionEmailPlan';
+export * from './orderFulfillmentPlan';
+export * from './orderFulfillmentResult';
+export * from './orderHistoryLedgerFilters';
+export * from './orderHistorySource';
+export * from './orderInstalmentAdminSettlement';
+export * from './orderInstalmentClosure';
+export * from './orderInstalmentLifecycle';
+export * from './orderInstalmentPayoff';
+export * from './orderInstalmentPlan';
+export * from './orderItemMetadata';
+export * from './orderItemSupport';
+export * from './orderListFilters';
+export * from './orderPaymentState';
+export * from './orderPaymentReceipt';
+export * from './orderPaymentLinkPlanning';
+export * from './orderRefundPlanning';
+export * from './orderRefundPolicy';
+export * from './orderTotals';
+export * from './persistedCheckoutLines';
+export * from './pendingCheckoutSessionClaim';
+export * from './protectedDepositRefundPolicy';
+export * from './refundRailSplit';
+export * from './refundPolicy';
+export * from './settlement';
+export * from './shopRefundPlanning';
+export * from './stripeMinimumCharge';
+export * from './stateTransitions';

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

@@ -0,0 +1,86 @@
+import { type NonEmptyArray, type Result } from '../../../core/src/index';
+import { type CurrencyCode, type Money } from './settlement';
+import type { CartCheckout } from './types';
+import type { OrderPaymentMethod, OrderStatus } from './orderTypes';
+export type CheckoutPlanningError = {
+    _tag: 'CheckoutPlanningError';
+    code: 'empty_cart';
+    message: string;
+};
+type CheckoutPlanningSettledCart = Readonly<{
+    items: readonly unknown[];
+    subtotalCents: number;
+    discountCents: number;
+    creditCents: number;
+    totalAfterDiscountCents: number;
+    totalAfterCreditsCents: number;
+    currency: string;
+    discount: unknown;
+    discountApplication: unknown;
+}>;
+export type CheckoutPaymentPlanBase = Readonly<{
+    creditReservedCents: number;
+}>;
+export type StripeCheckoutPaymentPlan = CheckoutPaymentPlanBase & Readonly<{
+    kind: 'stripe';
+}>;
+export type BypassCheckoutPaymentPlan = CheckoutPaymentPlanBase & Readonly<{
+    kind: 'bypass';
+    bypassReason: 'free' | 'store_credit' | 'discount_free';
+}>;
+export type DeferredManualCheckoutPaymentPlan = CheckoutPaymentPlanBase & Readonly<{
+    kind: 'deferred_manual';
+}>;
+export type InstalmentCheckoutPaymentPlan = CheckoutPaymentPlanBase & Readonly<{
+    kind: 'instalment_plan';
+}>;
+export type FlexibleBalanceCheckoutPaymentPlan = CheckoutPaymentPlanBase & Readonly<{
+    kind: 'flexible_balance';
+    initialPaymentCents: number;
+}>;
+export type OneTimeCheckoutPlanningPaymentPlan = StripeCheckoutPaymentPlan | BypassCheckoutPaymentPlan | DeferredManualCheckoutPaymentPlan | InstalmentCheckoutPaymentPlan | FlexibleBalanceCheckoutPaymentPlan;
+type CheckoutPlanningContext = Readonly<Record<string, unknown>>;
+export type FlexibleBalanceInitialPaymentPlan = Readonly<{
+    kind: 'stripe';
+}> | Readonly<{
+    kind: 'none';
+}>;
+export type OrderSettlementPlan<TItem, TDiscount, TDiscountApplication> = Readonly<{
+    currency: CurrencyCode;
+    items: NonEmptyArray<TItem>;
+    subtotal: Money<CurrencyCode>;
+    discountTotal: Money<CurrencyCode>;
+    creditTotal: Money<CurrencyCode>;
+    totalAfterDiscount: Money<CurrencyCode>;
+    totalAfterCredits: Money<CurrencyCode>;
+    discount: TDiscount;
+    discountApplication: TDiscountApplication;
+}>;
+export type OrderDraftPlan = Readonly<{
+    status: OrderStatus;
+    paymentMethod: OrderPaymentMethod;
+    paidTotal: Money<CurrencyCode>;
+}>;
+export type OneTimeCheckoutPlan<TContext extends CheckoutPlanningContext, TSettledCart extends CheckoutPlanningSettledCart> = Readonly<{
+    ctx: TContext;
+    settlement: OrderSettlementPlan<TSettledCart['items'][number], TSettledCart['discount'], TSettledCart['discountApplication']>;
+    orderDraft: OrderDraftPlan;
+}>;
+export declare function buildOneTimeCheckoutPlan<TContext extends CheckoutPlanningContext, TSettledCart extends CheckoutPlanningSettledCart>(options: {
+    checkout: CartCheckout;
+    ctx: TContext;
+    settledCart: TSettledCart;
+    paymentPlan: OneTimeCheckoutPlanningPaymentPlan;
+}): Result<OneTimeCheckoutPlan<TContext, TSettledCart>, CheckoutPlanningError>;
+export declare function materializeSettledCart<TPlan extends Pick<OneTimeCheckoutPlan<CheckoutPlanningContext, CheckoutPlanningSettledCart>, 'settlement'>>(plan: TPlan): Readonly<{
+    items: TPlan['settlement']['items'];
+    subtotalCents: number;
+    discountCents: number;
+    creditCents: number;
+    totalAfterDiscountCents: number;
+    totalAfterCreditsCents: number;
+    currency: CurrencyCode;
+    discount: TPlan['settlement']['discount'];
+    discountApplication: TPlan['settlement']['discountApplication'];
+}>;
+export {};

package/dist/_dts/commerce/src/purchase/order-number.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Order numbering utilities.
+ *
+ * Generates human-readable order numbers from site slugs.
+ * Format: "{prefix}-{year}-{sequence}" (e.g., "MAC-2026-0001")
+ */
+/**
+ * Derives a deterministic order prefix from a site slug.
+ *
+ * Strategy: take the first letter of each word (split by hyphens), uppercase.
+ * Single-word slugs use the first 2-3 characters.
+ *
+ * The prefix is stored in the `sites` table (`order_prefix` column)
+ * on first order creation. Collisions are resolved by appending a
+ * numeric suffix (e.g., "YS2"). Site admins can customize via settings.
+ *
+ * @example
+ *   siteSlugToOrderPrefix("macadamia")       // "MAC"
+ *   siteSlugToOrderPrefix("bobs-barbershop") // "BB"
+ *   siteSlugToOrderPrefix("the-art-house")   // "TAH"
+ *   siteSlugToOrderPrefix("pilates")         // "PIL"
+ *   siteSlugToOrderPrefix("a")               // "A"
+ */
+export declare function siteSlugToOrderPrefix(slug: string): string;
+/**
+ * Generates a formatted order number string.
+ *
+ * @example
+ *   generateOrderNumber("MAC", 2026, 1)     // "MAC-2026-0001"
+ *   generateOrderNumber("MAC", 2026, 9999)  // "MAC-2026-9999"
+ *   generateOrderNumber("MAC", 2026, 10000) // "MAC-2026-10000"
+ */
+export declare function generateOrderNumber(prefix: string, year: number, sequenceNumber: number): string;

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

@@ -0,0 +1,19 @@
+import { type ShopRefundableOrderItem } from './orderItemSupport';
+import type { OrderItemPlanningRecord } from './orderPlanningTypes';
+import type { OrderPaymentMethod } from './orderTypes';
+export type CancelledOrderEmailItem = Readonly<{
+    title: string;
+    quantity: number;
+}>;
+export type OrderCancellationExecutionPlan<TItem extends OrderItemPlanningRecord = OrderItemPlanningRecord> = Readonly<{
+    itemsToCancel: readonly TItem[];
+    shopRefundItems: readonly ShopRefundableOrderItem<TItem>[];
+    directCancellationItems: readonly TItem[];
+    remainingActiveItems: readonly TItem[];
+}>;
+export declare function planOrderCancellationExecution<TItem extends OrderItemPlanningRecord>(options: Readonly<{
+    paymentMethod: OrderPaymentMethod;
+    allItems: readonly TItem[];
+    itemsToCancel: readonly TItem[];
+}>): OrderCancellationExecutionPlan<TItem>;
+export declare function toCancelledOrderEmailItems(items: readonly OrderItemPlanningRecord[]): readonly CancelledOrderEmailItem[];

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

@@ -0,0 +1,71 @@
+import type { EventTicketOrderItemMetadata, MembershipOrderItemMetadata, PassOrderItemMetadata } from './orderItemMetadata';
+import { type ConfirmationEmailPaymentSummary } from './confirmationEmailPayment';
+import type { OrderItemPlanningRecord } from './orderPlanningTypes';
+import type { OrderPaymentMethod } from './orderTypes';
+import type { AttendeeId } from '../../../core/src/index';
+export type OrderCompletionEmailAction = Readonly<{
+    kind: 'send_order_confirmation';
+    orderId: string;
+}> | Readonly<{
+    kind: 'send_event_confirmation';
+    attendeeId: AttendeeId;
+    metadata: EventTicketOrderItemMetadata;
+    paymentSummary: ConfirmationEmailPaymentSummary;
+}> | Readonly<{
+    kind: 'send_pass_bundle_confirmation';
+    attendeeId: AttendeeId;
+    metadata: PassOrderItemMetadata & Readonly<{
+        bundleFulfillment: NonNullable<PassOrderItemMetadata['bundleFulfillment']>;
+    }>;
+}> | Readonly<{
+    kind: 'send_course_enrollment_confirmation';
+    orderId: string;
+    enrollmentId: string;
+    paymentSummary: ConfirmationEmailPaymentSummary;
+}> | Readonly<{
+    kind: 'send_appointment_confirmation';
+    appointmentId: string;
+}> | Readonly<{
+    kind: 'send_membership_activation';
+    customerMembershipId: string;
+    amountPaidCents: number;
+}> | Readonly<{
+    kind: 'send_membership_bundle_confirmation';
+    attendeeId: AttendeeId;
+    metadata: MembershipOrderItemMetadata & Readonly<{
+        bundleFulfillment: NonNullable<MembershipOrderItemMetadata['bundleFulfillment']>;
+    }>;
+}>;
+export type OrderCompletionEmailWarning = Readonly<{
+    kind: 'missing_event_attendee_id';
+    orderItemId: string;
+    orderId: string;
+}> | Readonly<{
+    kind: 'missing_course_enrollment_id';
+    orderItemId: string;
+    orderId: string;
+}> | Readonly<{
+    kind: 'missing_appointment_id';
+    orderItemId: string;
+    orderId: string;
+}> | Readonly<{
+    kind: 'missing_customer_membership_id';
+    orderItemId: string;
+    orderId: string;
+}>;
+export type OrderCompletionEmailPlan = Readonly<{
+    actions: readonly OrderCompletionEmailAction[];
+    warnings: readonly OrderCompletionEmailWarning[];
+}>;
+export declare function buildOrderCompletionEmailPlan(options: Readonly<{
+    items: readonly OrderItemPlanningRecord[];
+    orderPaymentMethod: OrderPaymentMethod;
+    currency: string;
+    flexibleBalanceDueAt?: string | null;
+    settlement: Readonly<{
+        kind: 'settled_in_full';
+    }> | Readonly<{
+        kind: 'collected_by_item';
+        collectedCentsByOrderItemId: Readonly<Record<string, number>>;
+    }>;
+}>): OrderCompletionEmailPlan;

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

@@ -0,0 +1,120 @@
+import type { OrderInstalmentSummary } from '../../../core/src/index';
+import type { CreditProductUseCase } from './orderItemMetadata';
+import type { OrderPaymentMethod, OrderStatus } from './orderTypes';
+export type OrderConfirmationLineItem = Readonly<{
+    title: string;
+    subtitle?: string | null;
+    quantity: number;
+    amountCents: number;
+}>;
+export type OrderConfirmationPassDetail = Readonly<{
+    name: string;
+    productUseCase?: CreditProductUseCase;
+    creditsTotal: number;
+    expiresAt: string | null;
+    readyToUseNote: string;
+}>;
+export type PassOnlyOrderConfirmationVariant = Readonly<{
+    kind: 'pass_only';
+    passes: readonly [
+        OrderConfirmationPassDetail,
+        ...OrderConfirmationPassDetail[]
+    ];
+}>;
+export type StandardOrderConfirmationVariant = Readonly<{
+    kind: 'order';
+}>;
+export type OrderConfirmationVariant = PassOnlyOrderConfirmationVariant | StandardOrderConfirmationVariant;
+export type OrderConfirmationShippingDetails = Readonly<{
+    recipient: string | null;
+    addressLines: readonly string[];
+    costCents: number;
+    currency: string;
+    methodLabel?: string;
+}>;
+export type OrderConfirmationReceiptDetails = Readonly<{
+    orderNumber: string;
+    purchaseDate: string;
+    lineItems: readonly OrderConfirmationLineItem[];
+    subtotalCents: number;
+    discountCents: number;
+    creditCents: number;
+    taxCents: number;
+    shippingCents: number;
+    totalCents: number;
+    currency: string;
+    paymentMethodLabel: string;
+    paymentSummary: string | null;
+    paymentSchedule: Readonly<{
+        rows: readonly Readonly<{
+            label: string;
+            dueAt: string;
+            amountCents: number;
+        }>[];
+    }> | null;
+}>;
+export type OrderConfirmationTemplateVariables = Record<string, string | undefined>;
+export type OrderConfirmationEmailContent = Readonly<{
+    customerName: string;
+    siteTitle: string;
+    orderSubject: string;
+    heading: string;
+    introText: string;
+    orderReceiptDetails: OrderConfirmationReceiptDetails;
+    orderPassDetails?: Readonly<{
+        passes: readonly OrderConfirmationPassDetail[];
+    }>;
+    orderShippingDetails?: OrderConfirmationShippingDetails;
+    portalLink?: string;
+}>;
+export type OrderConfirmationContent = Readonly<{
+    customerDisplayName: string;
+    templateVars: OrderConfirmationTemplateVariables;
+    orderReceiptDetails: OrderConfirmationReceiptDetails;
+    emailData: OrderConfirmationEmailContent;
+}>;
+type OrderConfirmationOrderSource = Readonly<{
+    orderNumber: string;
+    subtotalCents: number;
+    discountCents: number;
+    creditCents: number;
+    taxCents: number;
+    shippingCents: number;
+    currency: string;
+    createdAt: string;
+    updatedAt: string | null;
+    status: OrderStatus;
+    paymentMethod: OrderPaymentMethod;
+    shippingAddressJson: unknown;
+    stripeShippingSnapshot: unknown;
+}>;
+export type OrderConfirmationSettlement = Readonly<{
+    collectedCents: number;
+}>;
+export type OrderConfirmationFormatters = Readonly<{
+    formatCurrencyAmount: (amountCents: number, currency: string) => string;
+    formatDateTime: (isoString: string) => string;
+    formatInstalmentStatusLabel: (row: OrderInstalmentSummary['rows'][number]) => string;
+    resolveCustomerDisplayName: (name: string | null, email: string) => string;
+}>;
+export declare function resolveOrderConfirmationShippingDetails(order: OrderConfirmationOrderSource): OrderConfirmationShippingDetails | undefined;
+export declare function resolveOrderConfirmationVariant<TItem extends Readonly<{
+    kind: string;
+}>>(items: readonly TItem[], passDetails: readonly OrderConfirmationPassDetail[]): OrderConfirmationVariant;
+export declare function resolveOrderConfirmationPaymentMethodLabel(paymentMethod: OrderPaymentMethod): string;
+export declare function resolveOrderConfirmationPaymentSummary(order: Pick<OrderConfirmationOrderSource, 'paymentMethod' | 'creditCents' | 'currency' | 'subtotalCents' | 'discountCents' | 'taxCents' | 'shippingCents'>, settlement: OrderConfirmationSettlement, formatCurrencyAmount: OrderConfirmationFormatters['formatCurrencyAmount']): string | null;
+export declare function buildOrderConfirmationContent(input: Readonly<{
+    order: OrderConfirmationOrderSource;
+    customerEmail: string;
+    customerName: string | null;
+    siteTitle: string | null;
+    confirmationVariant: OrderConfirmationVariant;
+    lineItems: readonly OrderConfirmationLineItem[];
+    passDetails: readonly OrderConfirmationPassDetail[];
+    instalmentPlan?: OrderInstalmentSummary | null;
+    settlement: OrderConfirmationSettlement;
+    shippingDetails?: OrderConfirmationShippingDetails;
+    portalLink?: string | null;
+    formatters: OrderConfirmationFormatters;
+}>): OrderConfirmationContent;
+export {};

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

@@ -0,0 +1,81 @@
+import { type AttendeeId, type Result } from '../../../core/src/index';
+import type { OrderItemPlanningRecord } from './orderPlanningTypes';
+import type { OrderPaymentMethod } from './orderTypes';
+export type OrderItemFulfillmentPlan = {
+    kind: 'event_ticket';
+    attendeeId: AttendeeId;
+    paymentStatus: 'completed' | 'not_required';
+} | {
+    kind: 'product';
+} | {
+    kind: 'pass';
+    existingCustomerPassId: string | null;
+    passId: string;
+    bundleFulfillment: {
+        attendeeId: AttendeeId;
+        eventInstanceId: string | null;
+        ticketsCount: number;
+    } | null;
+} | {
+    kind: 'course_enrollment';
+    enrollmentId: string;
+    eventSeriesId: string;
+    paymentMethod: 'stripe' | 'free' | 'membership';
+    paymentStatus: 'completed' | 'not_required';
+} | {
+    kind: 'appointment';
+    appointmentId: string;
+    nextStatus: 'confirmed';
+    customerName: string;
+    customerEmail: string;
+    displayName: string | null;
+} | {
+    kind: 'membership';
+};
+export declare function planOrderItemFulfillment(item: OrderItemPlanningRecord, orderPaymentMethod: OrderPaymentMethod): Result<OrderItemFulfillmentPlan, string>;
+export type OrderItemCancellationPlan = {
+    kind: 'event_ticket';
+    attendeeId: AttendeeId;
+} | {
+    kind: 'course_enrollment';
+    enrollmentId: string;
+} | {
+    kind: 'appointment';
+    appointmentId: string;
+} | {
+    kind: 'product';
+} | {
+    kind: 'pass';
+    customerPassId: string | null;
+    bundleAttendeeId: AttendeeId | null;
+} | {
+    kind: 'membership';
+    customerMembershipId: string | null;
+    bundleAttendeeId: AttendeeId | null;
+};
+export declare function planOrderItemCancellation(item: OrderItemPlanningRecord): Result<OrderItemCancellationPlan, string>;
+export type OrderItemRefundRevocationPlan = {
+    kind: 'event_ticket';
+    attendeeId: AttendeeId;
+} | {
+    kind: 'product';
+} | {
+    kind: 'course_enrollment';
+    enrollmentId: string;
+} | {
+    kind: 'appointment';
+    appointmentId: string;
+} | {
+    kind: 'pass';
+    customerPassId: string | null;
+    bundleAttendeeId: AttendeeId | null;
+} | {
+    kind: 'membership';
+    customerMembershipId: string | null;
+    bundleAttendeeId: AttendeeId | null;
+};
+export declare function planOrderItemRefundRevocation(item: OrderItemPlanningRecord): Result<OrderItemRefundRevocationPlan, string>;
+export declare function resolveCourseEnrollmentPaymentForFulfillment(orderPaymentMethod: OrderPaymentMethod): {
+    paymentMethod: 'stripe' | 'free' | 'membership';
+    paymentStatus: 'completed' | 'not_required';
+};

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

@@ -0,0 +1,8 @@
+export type OrderFulfillmentResult = {
+    totalCount: number;
+    fulfilledCount: number;
+    inProgressCount: number;
+    failedCount: number;
+    inProgressItemIds: string[];
+    failedItemIds: string[];
+};

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

@@ -0,0 +1 @@
+export type OrderHistoryLedgerFilter = 'all' | 'products' | 'bookings' | 'passes' | 'memberships';

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

@@ -0,0 +1,11 @@
+export type OrderHistorySource = 'live' | 'ledger';
+export declare function hasLiveOrderHistorySource<TRecord extends {
+    historySource: OrderHistorySource;
+}>(record: TRecord): record is TRecord & Readonly<{
+    historySource: 'live';
+}>;
+export declare function hasArchivedOrderHistorySource<TRecord extends {
+    historySource: OrderHistorySource;
+}>(record: TRecord): record is TRecord & Readonly<{
+    historySource: 'ledger';
+}>;