@riverbankcms/sdk 0.132.0 → 0.135.0

package/dist/_dts/commerce/src/moneyContracts.d.ts

@@ -0,0 +1,178 @@
+import type { MoneyFilterQuery, MoneyItemKind, MoneyPeriodPreset } from './money';
+import type { OrderPaymentReceiptProvenance } from './purchase/orderPaymentReceipt';
+export type MoneyReportRequest = MoneyFilterQuery;
+export declare const MONEY_PAYMENTS_VIEWS: readonly ["successful", "refunds", "all"];
+export type MoneyPaymentsView = (typeof MONEY_PAYMENTS_VIEWS)[number];
+export type MoneyPaymentsRequest = MoneyFilterQuery & Readonly<{
+    search?: string;
+    view?: MoneyPaymentsView;
+    customerId?: string;
+    stripeCheckoutSessionId?: string;
+    limit?: number;
+    offset?: number;
+}>;
+export type MoneyComparisonMetric = Readonly<{
+    current: number;
+    previous: number;
+    delta: number;
+    deltaPercentage: number | null;
+}>;
+export type MoneyReportTaxSummary = Readonly<{
+    kind: 'hidden';
+}> | Readonly<{
+    kind: 'visible';
+    taxCollectedCents: MoneyComparisonMetric;
+}>;
+export type MoneyBreakdownDimension = 'item_kind' | 'event' | 'event_category' | 'venue' | 'pass' | 'membership' | 'product' | 'discount_code';
+export type MoneyBreakdownRow = Readonly<{
+    key: string;
+    label: string;
+    subtotalCents: number;
+    paidCents: number;
+    refundedCents: number;
+    discountCents: number;
+    netRevenueCents: number;
+    orderCount: number;
+}>;
+export type MoneyBreakdownSection = Readonly<{
+    dimension: MoneyBreakdownDimension;
+    rows: MoneyBreakdownRow[];
+}>;
+export type MoneyTimeSeriesGranularity = 'day' | 'week' | 'month';
+export type MoneyTimeSeriesBucket = Readonly<{
+    bucketStart: string;
+    bucketEnd: string;
+    label: string;
+    cashCollectedCents: number;
+    refundsCents: number;
+    netRevenueCents: number;
+    discountCents: number;
+    taxCollectedCents: number;
+    orderCount: number;
+}>;
+export type MoneyReportResponse = Readonly<{
+    range: Readonly<{
+        from: string;
+        to: string;
+        preset?: MoneyPeriodPreset | null;
+    }>;
+    comparisonRange: Readonly<{
+        from: string;
+        to: string;
+        preset?: MoneyPeriodPreset | null;
+    }>;
+    granularity: MoneyTimeSeriesGranularity;
+    summary: Readonly<{
+        currency: string;
+        currencies: readonly string[];
+        cashCollectedCents: MoneyComparisonMetric;
+        refundsCents: MoneyComparisonMetric;
+        netRevenueCents: MoneyComparisonMetric;
+        discountCents: MoneyComparisonMetric;
+        tax: MoneyReportTaxSummary;
+        orderCount: MoneyComparisonMetric;
+        averageCollectedPerOrderCents: MoneyComparisonMetric;
+    }>;
+    currentSeries: MoneyTimeSeriesBucket[];
+    comparisonSeries: MoneyTimeSeriesBucket[];
+    breakdowns: MoneyBreakdownSection[];
+}>;
+export type MoneyPaymentMethod = 'stripe' | 'mixed' | 'store_credit' | 'manual' | 'waived' | 'free' | 'pass_redemption' | 'membership_access' | null;
+export type MoneyPaymentProvider = 'stripe' | 'internal';
+export type MoneyReceiptStatus = 'paid' | 'partially_refunded' | 'refunded' | 'payment_reconciliation_pending';
+export type MoneyReceiptPurpose = 'initial_checkout' | 'flexible_balance_paydown' | 'instalment' | 'instalment_payoff' | 'subscription_renewal';
+export type MoneyReceiptRail = 'stripe_checkout' | 'stripe_invoice' | 'manual';
+export type MoneyPaymentAllocationItem = Readonly<{
+    kind: 'event';
+    sourceLabel: string;
+    eventAttendeeId: string;
+}> | Readonly<{
+    kind: 'event_series_registration';
+    sourceLabel: string;
+    eventSeriesId: string;
+    eventSeriesRegistrationId: string;
+}> | Readonly<{
+    kind: 'pass';
+    sourceLabel: string;
+    customerPassId: string;
+}> | Readonly<{
+    kind: 'membership';
+    sourceLabel: string;
+    customerMembershipId: string;
+}> | Readonly<{
+    kind: 'product';
+    sourceLabel: string;
+}>;
+export type MoneyPaymentAllocationSummary = Readonly<{
+    kind: 'single';
+    item: MoneyPaymentAllocationItem;
+}> | Readonly<{
+    kind: 'multiple';
+    itemKinds: readonly MoneyItemKind[];
+    sourceLabels: readonly string[];
+}> | Readonly<{
+    kind: 'unresolved';
+    itemKinds: readonly MoneyItemKind[];
+    sourceLabels: readonly string[];
+}>;
+export type MoneyPaymentRefundTarget = Exclude<MoneyPaymentAllocationItem, {
+    kind: 'product';
+}>;
+export type MoneyPaymentRefundUnavailableReason = 'manual_receipt' | 'provider_target_mismatch' | 'fully_refunded' | 'payment_reconciliation_pending';
+export type MoneyPaymentRefundAccess = Readonly<{
+    kind: 'entity';
+    target: MoneyPaymentRefundTarget;
+    onlineAction: Readonly<{
+        kind: 'available';
+    }> | Readonly<{
+        kind: 'unavailable';
+        reason: MoneyPaymentRefundUnavailableReason;
+    }>;
+}> | Readonly<{
+    kind: 'unavailable';
+    reason: 'multiple_allocations' | 'unresolved_allocation' | 'product';
+}>;
+export type MoneyPaymentListItem = Readonly<{
+    id: string;
+    orderId: string;
+    orderNumber: string | null;
+    allocation: MoneyPaymentAllocationSummary;
+    refundAccess: MoneyPaymentRefundAccess;
+    status: MoneyReceiptStatus;
+    purpose: MoneyReceiptPurpose;
+    rail: MoneyReceiptRail;
+    provenance: OrderPaymentReceiptProvenance;
+    paymentMethod: MoneyPaymentMethod;
+    provider: MoneyPaymentProvider;
+    amountPaidCents: number;
+    amountSubtotalCents: number;
+    /** Proven lower bound when exact receipt attribution is unresolved. */
+    knownRefundedCents: number;
+    amountRefundedCents: number | null;
+    amountDiscountCents: number;
+    currency: string;
+    orderTotalCents: number;
+    orderCollectedCents: number;
+    orderOutstandingCents: number;
+    paymentDueAt: string | null;
+    createdAt: string;
+    stripeCheckoutSessionId: string | null;
+    stripePaymentIntentId: string | null;
+    stripeInvoiceId: string | null;
+    stripeAccountId: string | null;
+    discountCode: string | null;
+    discountPublicLabel: string | null;
+    customer: Readonly<{
+        id: string;
+        email: string;
+        name: string | null;
+    }> | null;
+}>;
+export type MoneyPaymentsListResponse = Readonly<{
+    payments: MoneyPaymentListItem[];
+    pagination: Readonly<{
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    }>;
+}>;

package/dist/_dts/commerce/src/moneyDateUtils.d.ts

@@ -0,0 +1,22 @@
+import { type MoneyDateString } from '../../core/src/index';
+export type MoneyDateParts = Readonly<{
+    year: number;
+    month: number;
+    day: number;
+}>;
+export declare function getTimeZoneDateParts(date: Date, timeZone: string): MoneyDateParts;
+export declare function toTimeZoneMoneyDateString(date: Date, timeZone: string): MoneyDateString;
+export declare function createUtcDateFromParts(parts: MoneyDateParts): Date;
+export declare function createUtcDate(year: number, month: number, day: number): Date;
+export declare function parseUtcMoneyDate(value: string): Date;
+export declare function formatUtcDate(date: Date): MoneyDateString;
+export declare function startOfUtcDay(date: Date): Date;
+export declare function addUtcDays(date: Date, days: number): Date;
+export declare function inclusiveUtcDaySpan(from: string, to: string): number;
+export declare function daysInUtcMonth(year: number, month: number): number;
+export declare function shiftUtcYearMonth(year: number, month: number, offsetMonths: number): Readonly<{
+    year: number;
+    month: number;
+}>;
+export declare function quarterFromMonth(month: number): 1 | 2 | 3 | 4;
+export declare function quarterStartMonth(quarter: 1 | 2 | 3 | 4): number;

package/dist/_dts/commerce/src/moneyPayments.d.ts

@@ -0,0 +1,59 @@
+import { type CustomerId, type StripeCheckoutSessionId } from '../../core/src/index';
+import { MONEY_PAYMENTS_VIEWS, type MoneyPaymentsRequest, type MoneyPaymentsView } from './moneyContracts';
+import type { MoneyFilterParseIssue, MoneyFilterState } from './money';
+export { MONEY_PAYMENTS_VIEWS };
+export type { MoneyPaymentsView };
+export type MoneyPaymentsDeepLink = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'customer';
+    customerId: CustomerId;
+}> | Readonly<{
+    kind: 'checkoutSession';
+    stripeCheckoutSessionId: StripeCheckoutSessionId;
+}> | Readonly<{
+    kind: 'customerCheckoutSession';
+    customerId: CustomerId;
+    stripeCheckoutSessionId: StripeCheckoutSessionId;
+}>;
+export type MoneyPaymentsPageState = Readonly<{
+    search: string;
+    view: MoneyPaymentsView;
+    hasExplicitPeriod: boolean;
+    moneyFilters: MoneyFilterState;
+    deepLink: MoneyPaymentsDeepLink;
+}>;
+export type MoneyPaymentsPageParseIssue = MoneyFilterParseIssue | Readonly<{
+    kind: 'invalid_view';
+    value: string;
+}> | Readonly<{
+    kind: 'invalid_customer_id';
+    value: string;
+}> | Readonly<{
+    kind: 'empty_checkout_session_id';
+}>;
+export type MoneyPaymentsPageParseResult = Readonly<{
+    value: MoneyPaymentsPageState;
+    issues: readonly MoneyPaymentsPageParseIssue[];
+}>;
+export declare const DEFAULT_MONEY_PAYMENTS_VIEW: MoneyPaymentsView;
+export declare const DEFAULT_MONEY_PAYMENTS_PAGE_STATE: MoneyPaymentsPageState;
+export declare function isMoneyPaymentsView(value: unknown): value is MoneyPaymentsView;
+export declare function createMoneyPaymentsDeepLink(input: Readonly<{
+    customerId?: CustomerId | null;
+    stripeCheckoutSessionId?: StripeCheckoutSessionId | null;
+}>): MoneyPaymentsDeepLink;
+export declare function moneyPaymentsDeepLinkToFields(deepLink: MoneyPaymentsDeepLink): Readonly<{
+    customerId: CustomerId | null;
+    stripeCheckoutSessionId: StripeCheckoutSessionId | null;
+}>;
+export declare function hasMoneyPaymentsDeepLink(deepLink: MoneyPaymentsDeepLink): boolean;
+export declare function mergeMoneyPaymentsDeepLinks(base: MoneyPaymentsDeepLink, override: MoneyPaymentsDeepLink): MoneyPaymentsDeepLink;
+export declare function createDefaultMoneyPaymentsPageState(options?: Readonly<{
+    defaultView?: MoneyPaymentsView;
+}>): MoneyPaymentsPageState;
+export declare function parseMoneyPaymentsPageState(searchParams: URLSearchParams, options?: Readonly<{
+    defaultView?: MoneyPaymentsView;
+}>): MoneyPaymentsPageParseResult;
+export declare function serializeMoneyPaymentsPageState(state: MoneyPaymentsPageState): URLSearchParams;
+export declare function adaptMoneyPaymentsPageStateToRequest(state: MoneyPaymentsPageState): MoneyPaymentsRequest;

package/dist/_dts/commerce/src/moneyPlanningTime.d.ts

@@ -0,0 +1,4 @@
+import { type PlanningTimeOptions } from '../../core/src/index';
+export type MoneyPlanningTimeInput = PlanningTimeOptions;
+/** Shared clock seam for pure commerce report planners and date-range derivation. */
+export declare function resolveMoneyPlanningNow(input?: MoneyPlanningTimeInput): Date;

package/dist/_dts/commerce/src/moneyReceiptReadModel.d.ts

@@ -0,0 +1,68 @@
+import type { OrderPaymentReceiptProvenance } from './purchase/orderPaymentReceipt';
+import { type MoneyItemKind } from './money';
+import { type MoneyLineDimensionRefs, type MoneyPaymentsQuery, type MoneyRefundAllocationFact, type MoneyReportDataset, type MoneyReportTimeOptions } from './moneyReport';
+import type { MoneyPaymentsListResponse, MoneyReceiptPurpose, MoneyReceiptRail } from './moneyContracts';
+export type MoneyReceiptAllocationFact = Readonly<{
+    orderItemId: string;
+    itemKind: MoneyItemKind;
+    amountCents: number;
+    allocatedTaxCents: number;
+    sourceLabel: string;
+    amountSubtotalCents: number;
+    amountDiscountCents: number;
+    eventAttendeeId: string | null;
+    customerPassId: string | null;
+    customerMembershipId: string | null;
+    eventSeriesRegistrationId: string | null;
+    dimensions: MoneyLineDimensionRefs;
+}>;
+export type MoneyReceiptFact = Readonly<{
+    id: string;
+    orderId: string;
+    orderNumber: string | null;
+    customer: Readonly<{
+        id: string;
+        email: string;
+        name: string | null;
+    }> | null;
+    amountReceivedCents: number;
+    amountRefundedCents: number;
+    orderTotalCents: number;
+    orderCollectedCents: number;
+    orderOutstandingCents: number;
+    paymentDueAt: string | null;
+    currency: string;
+    paidAt: string;
+    purpose: MoneyReceiptPurpose;
+    rail: MoneyReceiptRail;
+    provenance: OrderPaymentReceiptProvenance;
+    appliedCents: number;
+    applicationState: 'applied' | 'reconciliation_needed';
+    stripeAccountId: string | null;
+    stripeCheckoutSessionId: string | null;
+    stripePaymentIntentId: string | null;
+    stripeInvoiceId: string | null;
+    manualExternalReference: string | null;
+    allocations: readonly MoneyReceiptAllocationFact[];
+}>;
+export type MoneyReceiptListQuery = Readonly<{
+    from?: string;
+    to?: string;
+    search?: string;
+    limit: number;
+    offset: number;
+}>;
+export type MoneyReceiptListItem = MoneyReceiptFact & Readonly<{
+    refundState: 'not_refunded' | 'partially_refunded' | 'fully_refunded';
+}>;
+export type MoneyReceiptListResponse = Readonly<{
+    receipts: readonly MoneyReceiptListItem[];
+    pagination: Readonly<{
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+    }>;
+}>;
+export declare function buildMoneyReceiptList(query: MoneyReceiptListQuery, facts: readonly MoneyReceiptFact[]): MoneyReceiptListResponse;
+export declare function buildMoneyReceiptPaymentsList(query: MoneyPaymentsQuery, facts: readonly MoneyReceiptFact[], options?: MoneyReportTimeOptions): MoneyPaymentsListResponse;
+export declare function buildMoneyReceiptReportDataset(facts: readonly MoneyReceiptFact[], refundAllocations: readonly MoneyRefundAllocationFact[]): MoneyReportDataset;

package/dist/_dts/commerce/src/moneyReport.d.ts

@@ -0,0 +1,105 @@
+import { type EventCategoryId, type EventSeriesId, type MembershipId, type MoneyDateString, type OrderId, type OrderItemId, type PassId, type ProductId, type VenueId } from '../../core/src/index';
+import { type MoneyPaymentsRequest, type MoneyPaymentsView, type MoneyReportRequest, type MoneyReportResponse } from './moneyContracts';
+import { type MoneyDateRange, type MoneyItemKind, type MoneyFilterSelection, type MoneyQueryRange, type MoneyQueryRangeError } from './money';
+import { type MoneyPlanningTimeInput } from './moneyPlanningTime';
+import { type Result } from '../../core/src/index';
+export type MoneyReportQuery = Readonly<{
+    range: Exclude<MoneyQueryRange, {
+        kind: 'all';
+    }>;
+    filters: MoneyFilterSelection;
+}>;
+export type MoneyPaymentsQuery = Readonly<{
+    range: MoneyQueryRange;
+    filters: MoneyFilterSelection;
+    search: string;
+    view: MoneyPaymentsView;
+    customerId: string | null;
+    stripeCheckoutSessionId: string | null;
+    limit: number;
+    offset: number;
+}>;
+export type MoneyDatedOfferingDimension = Readonly<{
+    kind: 'none';
+}> | Readonly<{
+    kind: 'canonical';
+    eventSeriesId: EventSeriesId;
+    eventSeriesLabel: string | null;
+    eventCategoryId: EventCategoryId | null;
+    eventCategoryLabel: string | null;
+    venueId: VenueId | null;
+    venueLabel: string | null;
+}> | Readonly<{
+    kind: 'historical_course';
+    label: string;
+}>;
+export type MoneyLineDimensionRefs = Readonly<{
+    datedOffering: MoneyDatedOfferingDimension;
+    passId: PassId | null;
+    passLabel: string | null;
+    membershipId: MembershipId | null;
+    membershipLabel: string | null;
+    productId: ProductId | null;
+    productLabel: string | null;
+    discountCode: string | null;
+    discountLabel: string | null;
+}>;
+export type MoneyReportReceiptAllocationFact = Readonly<{
+    orderItemId: OrderItemId;
+    orderId: OrderId;
+    itemKind: MoneyItemKind;
+    currency: string;
+    paidAt: string;
+    amountSubtotalCents: number;
+    amountDiscountCents: number;
+    amountCollectedCents: number;
+    allocatedTaxCents: number;
+    sourceLabel: string;
+    dimensions: MoneyLineDimensionRefs;
+}>;
+export type MoneyRefundAllocationFact = Readonly<{
+    refundId: string;
+    orderId: OrderId;
+    orderItemId: OrderItemId;
+    processedAt: string;
+    amountRefundedCents: number;
+    currency: string;
+    itemKind: MoneyItemKind;
+    sourceLabel: string;
+    dimensions: MoneyLineDimensionRefs;
+}>;
+export type MoneyReportDataset = Readonly<{
+    receiptAllocations: readonly MoneyReportReceiptAllocationFact[];
+    refundAllocations: readonly MoneyRefundAllocationFact[];
+}>;
+export type MoneyReportQueryError = MoneyQueryRangeError;
+type MoneyRangeBounds = Readonly<{
+    from: MoneyDateString;
+    to: MoneyDateString;
+}>;
+export type MoneyReportTimeOptions = MoneyPlanningTimeInput & Readonly<{
+    timeZone?: string;
+}>;
+type MoneyReportBuildOptions = MoneyReportTimeOptions & Readonly<{
+    comparisonRange?: MoneyDateRange;
+}>;
+export declare function resolveMoneyReportQuery(query: MoneyReportRequest): Result<MoneyReportQuery, MoneyReportQueryError>;
+export declare function resolveMoneyPaymentsQuery(query: MoneyPaymentsRequest): Result<MoneyPaymentsQuery, MoneyReportQueryError>;
+export declare function buildMoneyReport(query: MoneyReportQuery, dataset: MoneyReportDataset, options?: MoneyReportBuildOptions): MoneyReportResponse;
+export declare function matchesMoneyReceiptAllocation(allocation: MoneyReportReceiptAllocationFact, filters: MoneyFilterSelection): boolean;
+export declare function mapOrderItemKindToMoneyItemKind(kind: string): MoneyItemKind | null;
+export declare function resolveMoneyRangeBounds(range: Exclude<MoneyQueryRange, {
+    kind: 'all';
+}>, options?: MoneyReportTimeOptions): MoneyRangeBounds;
+export declare function buildMoneyRefundAllocationFact(input: Readonly<{
+    refundId: string;
+    orderId: string;
+    orderItemId: string;
+    processedAt: string;
+    amountRefundedCents: number;
+    currency: string;
+    itemKind: MoneyItemKind;
+    sourceLabel: string;
+    dimensions: MoneyLineDimensionRefs;
+}>): MoneyRefundAllocationFact;
+export {};

package/dist/_dts/commerce/src/moneyReportBreakdowns.d.ts

@@ -0,0 +1,3 @@
+import type { MoneyBreakdownSection } from './moneyContracts';
+import type { MoneyRefundAllocationFact, MoneyReportReceiptAllocationFact } from './moneyReport';
+export declare function buildMoneyBreakdowns(allocations: readonly MoneyReportReceiptAllocationFact[], refunds: readonly MoneyRefundAllocationFact[]): MoneyBreakdownSection[];

package/dist/_dts/commerce/src/moneyReportKindFilter.d.ts

@@ -0,0 +1,4 @@
+import type { MoneyItemKind } from './money';
+export type MoneyReportKindFilter = 'all' | 'multiple' | MoneyItemKind;
+export declare function getMoneyReportKindFilter(itemKinds: readonly MoneyItemKind[]): MoneyReportKindFilter;
+export declare function describeMoneyReportKindFilter(itemKinds: readonly MoneyItemKind[]): string;

package/dist/_dts/commerce/src/moneyReportPage.d.ts

@@ -0,0 +1,132 @@
+import type { MoneyBreakdownDimension, MoneyComparisonMetric, MoneyReportResponse } from './moneyContracts';
+import type { EventCategoryId, EventSeriesId, MembershipId, PassId, ProductId, VenueId } from '../../core/src/index';
+import { type MoneyReportKindFilter } from './moneyReportKindFilter';
+export { describeMoneyReportKindFilter, getMoneyReportKindFilter, type MoneyReportKindFilter, } from './moneyReportKindFilter';
+import { type MoneyDateRange, type MoneyFilterState, type MoneyFilterParseIssue, type MoneyItemKind, type MoneyPeriod, type MoneyPeriodPreset } from './money';
+import { type MoneyPlanningTimeInput } from './moneyPlanningTime';
+export type MoneyReportSummaryCard = Readonly<{
+    kind: 'money';
+    key: 'cashCollected' | 'refunds' | 'netRevenue' | 'taxCollected' | 'discounts' | 'averageCollectedPerOrder';
+    title: string;
+    description: string;
+    currency: string;
+    metric: MoneyComparisonMetric;
+    tone: 'default' | 'warning';
+}> | Readonly<{
+    kind: 'count';
+    key: 'orderCount';
+    title: string;
+    description: string;
+    metric: MoneyComparisonMetric;
+    tone: 'default';
+}>;
+export type MoneyReportPeriodControlValue = Readonly<{
+    preset: MoneyPeriodPreset | null;
+    from: string;
+    to: string;
+}>;
+export type MoneyReportFilterChip = Readonly<{
+    id: string;
+    label: string;
+}>;
+export type MoneyReportDrilldownSelection = Readonly<{
+    kind: 'item_kind';
+    itemKind: MoneyItemKind;
+}> | Readonly<{
+    kind: 'event_family';
+}> | Readonly<{
+    kind: 'event';
+    eventSeriesId: EventSeriesId;
+}> | Readonly<{
+    kind: 'event_category';
+    eventCategoryId: EventCategoryId;
+}> | Readonly<{
+    kind: 'venue';
+    venueId: VenueId;
+}> | Readonly<{
+    kind: 'pass';
+    passId: PassId;
+}> | Readonly<{
+    kind: 'membership';
+    membershipId: MembershipId;
+}> | Readonly<{
+    kind: 'product';
+    productId: ProductId;
+}> | Readonly<{
+    kind: 'discount_code';
+    discountCode: string;
+}>;
+export type MoneyReportFormatters = Readonly<{
+    formatMoney: (amountCents: number, currency: string) => string;
+    formatCount: (value: number) => string;
+    formatPercentage: (value: number) => string;
+}>;
+export type MoneyReportPagePeriod = Readonly<{
+    kind: 'current_month';
+}> | Readonly<{
+    kind: 'month';
+    year: number;
+    month: number;
+}> | Readonly<{
+    kind: 'current_quarter';
+}> | Readonly<{
+    kind: 'quarter';
+    year: number;
+    quarter: 1 | 2 | 3 | 4;
+}> | Readonly<{
+    kind: 'year_to_date';
+}> | Readonly<{
+    kind: 'rolling';
+    preset: MoneyPeriodPreset;
+}> | Readonly<{
+    kind: 'custom';
+    from: string;
+    to: string;
+}>;
+export type MoneyReportPageParseIssue = MoneyFilterParseIssue | Readonly<{
+    kind: 'invalid_report_period_kind';
+    value: string;
+}> | Readonly<{
+    kind: 'invalid_report_month';
+    value: string | null;
+}> | Readonly<{
+    kind: 'invalid_report_year';
+    value: string | null;
+}> | Readonly<{
+    kind: 'invalid_report_quarter';
+    value: string | null;
+}>;
+export type MoneyReportPageState = Readonly<{
+    period: MoneyReportPagePeriod;
+    filters: MoneyFilterState;
+    comparisonRange: MoneyDateRange;
+}>;
+export type MoneyReportPageParseResult = Readonly<{
+    value: MoneyReportPageState;
+    issues: readonly MoneyReportPageParseIssue[];
+}>;
+type MoneyReportPageTimeOptions = MoneyPlanningTimeInput & Readonly<{
+    timezone: string;
+}>;
+export declare function createDefaultMoneyReportPagePeriod(): MoneyReportPagePeriod;
+export declare function createDefaultMoneyReportPageState(options: MoneyReportPageTimeOptions): MoneyReportPageState;
+export declare function createMoneyReportPageState(period: MoneyReportPagePeriod, filters: MoneyFilterState, options: MoneyReportPageTimeOptions): MoneyReportPageState;
+export declare function parseMoneyReportPageState(searchParams: URLSearchParams, options: MoneyReportPageTimeOptions): MoneyReportPageParseResult;
+export declare function serializeMoneyReportPageState(state: MoneyReportPageState): URLSearchParams;
+export declare function hasNonDefaultMoneyReportPageFilters(state: MoneyReportPageState, options: MoneyReportPageTimeOptions): boolean;
+export declare function describeMoneyReportPagePeriod(period: MoneyReportPagePeriod): string;
+export declare function describeMoneyReportComparisonTarget(period: MoneyReportPagePeriod): string;
+export declare function resolveMoneyReportPagePeriod(period: MoneyReportPagePeriod, options: MoneyReportPageTimeOptions): Readonly<{
+    filterPeriod: MoneyPeriod;
+    comparisonRange: MoneyDateRange;
+}>;
+export declare function createMoneyReportSummaryCards(summary: MoneyReportResponse['summary']): readonly MoneyReportSummaryCard[];
+export declare function hasMoneyReportActivity(report: MoneyReportResponse): boolean;
+export declare function toMoneyReportPeriodControlValue(period: MoneyPeriod): MoneyReportPeriodControlValue;
+export declare function applyMoneyReportPeriodControlValue(filters: MoneyFilterState, next: MoneyReportPeriodControlValue): MoneyFilterState;
+export declare function applyMoneyReportKindFilter(filters: MoneyFilterState, next: Exclude<MoneyReportKindFilter, 'multiple'>): MoneyFilterState;
+export declare function buildMoneyReportActiveFilterChips(filters: MoneyFilterState): readonly MoneyReportFilterChip[];
+export declare function hasNonDefaultMoneyFilters(filters: MoneyFilterState): boolean;
+export declare function describeBreakdownDimension(dimension: MoneyBreakdownDimension): string;
+export declare function toMoneyReportDrilldownSelection(dimension: MoneyBreakdownDimension, rowKey: string): MoneyReportDrilldownSelection | null;
+export declare function applyMoneyReportDrilldownSelection(filters: MoneyFilterState, selection: MoneyReportDrilldownSelection): MoneyFilterState;

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

@@ -14,7 +14,7 @@ export type CheckoutCollectionPlan<TCountryCode extends string = string> = Reado
     billingAddressCollection: 'auto';
     allowedShippingCountries: NonEmptyArray<TCountryCode>;
 }>;
-export type CheckoutCollectionItemKind = 'event_ticket' | 'product' | 'pass' | 'course_enrollment' | 'appointment';
+export type CheckoutCollectionItemKind = 'event_ticket' | 'product' | 'pass' | 'event_series_registration' | 'appointment';
 export type CheckoutCollectionProductItem = Readonly<{
     validated: Readonly<{
         type: 'product';

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

@@ -76,7 +76,7 @@ export declare function buildTransferredAttendeeConfirmationEmailPaymentSummary(
     amountPaidCents?: number | null;
     currency?: string | null;
 }>): ConfirmationEmailPaymentSummary | undefined;
-export declare function buildCourseEnrollmentConfirmationEmailPaymentSummary(options: Readonly<{
+export declare function buildEventSeriesRegistrationConfirmationEmailPaymentSummary(options: Readonly<{
     paymentMethod: 'free' | 'membership' | 'stripe';
     amountPaidCents?: number | null;
     currency?: string | null;

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

@@ -18,9 +18,9 @@ export type OrderCompletionEmailAction = Readonly<{
         bundleFulfillment: NonNullable<PassOrderItemMetadata['bundleFulfillment']>;
     }>;
 }> | Readonly<{
-    kind: 'send_course_enrollment_confirmation';
+    kind: 'send_event_series_registration_confirmation';
     orderId: string;
-    enrollmentId: string;
+    registrationId: string;
     paymentSummary: ConfirmationEmailPaymentSummary;
 }> | Readonly<{
     kind: 'send_appointment_confirmation';
@@ -41,7 +41,7 @@ export type OrderCompletionEmailWarning = Readonly<{
     orderItemId: string;
     orderId: string;
 }> | Readonly<{
-    kind: 'missing_course_enrollment_id';
+    kind: 'missing_event_series_registration_id';
     orderItemId: string;
     orderId: string;
 }> | Readonly<{

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

@@ -17,8 +17,8 @@ export type OrderItemFulfillmentPlan = {
         ticketsCount: number;
     } | null;
 } | {
-    kind: 'course_enrollment';
-    enrollmentId: string;
+    kind: 'event_series_registration';
+    registrationId: string;
     eventSeriesId: string;
     paymentMethod: 'stripe' | 'free' | 'membership';
     paymentStatus: 'completed' | 'not_required';
@@ -37,8 +37,8 @@ export type OrderItemCancellationPlan = {
     kind: 'event_ticket';
     attendeeId: AttendeeId;
 } | {
-    kind: 'course_enrollment';
-    enrollmentId: string;
+    kind: 'event_series_registration';
+    registrationId: string;
 } | {
     kind: 'appointment';
     appointmentId: string;
@@ -54,28 +54,9 @@ export type OrderItemCancellationPlan = {
     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 type OrderItemRefundRevocationPlan = OrderItemCancellationPlan;
 export declare function planOrderItemRefundRevocation(item: OrderItemPlanningRecord): Result<OrderItemRefundRevocationPlan, string>;
-export declare function resolveCourseEnrollmentPaymentForFulfillment(orderPaymentMethod: OrderPaymentMethod): {
+export declare function resolveEventSeriesRegistrationPaymentForFulfillment(orderPaymentMethod: OrderPaymentMethod): {
     paymentMethod: 'stripe' | 'free' | 'membership';
     paymentStatus: 'completed' | 'not_required';
 };