@carlonicora/nextjs-jsonapi 5.5.0 → 5.7.0

package/dist/billing/index.d.mts

@@ -1,7 +1,10 @@
 import * as React from 'react';
 import { ReactNode } from 'react';
-import { j as StripeSubscriptionInterface, P as PaymentMethodInterface, S as StripeCustomerInterface, a as StripeInvoiceInterface, M as MeterInterface, o as MeterSummaryInterface, d as StripePriceInterface, f as StripePriceInput, g as StripeProductInterface, h as StripeProductInput, I as InvoiceStatus, b as ProrationPreviewInterface, i as SubscriptionStatus, q as PromotionCodeValidationResult, n as StripeUsageInterface } from '../stripe-promotion-code.interface-ClZ7DxS9.mjs';
+import { k as StripeSubscriptionInterface, P as PaymentMethodInterface, S as StripeCustomerInterface, a as StripeInvoiceInterface, M as MeterInterface, p as MeterSummaryInterface, F as BillingFormatOptions, r as PromotionCodeValidationResult, u as StripeCouponInterface, x as StripeCouponInput, y as StripeCouponRenameInput, A as StripeCouponCodeInput, z as StripeCouponCodeInterface, B as StripeCouponCodeFlagsInput, d as StripePriceInterface, f as StripePriceInput, g as StripeProductInterface, h as StripeProductInput, I as InvoiceStatus, b as ProrationPreviewInterface, i as SubscriptionStatus, o as StripeUsageInterface } from '../currency-DT_dveBx.mjs';
+export { G as BillingTranslator, D as formatCurrency, E as formatFixed, C as formatInterval } from '../currency-DT_dveBx.mjs';
 import { J as JsonApiHydratedDataInterface } from '../ApiDataInterface-BcZeXy5X.mjs';
+import { FieldValues, UseFormReturn } from 'react-hook-form';
+import { z } from 'zod';
 import '../feature.interface-CXb1-vNq.mjs';
 
 type SubscriptionSummaryCardProps = {
@@ -61,45 +64,6 @@ declare function StripeProvider({ children }: {
 }): React.JSX.Element;
 declare function isStripeConfigured(): boolean;
 
-/** A message translator, as returned by `useTranslations()`. */
-type BillingTranslator = (key: string, values?: Record<string, any>) => string;
-/**
- * What the billing formatters need from the caller's React context. The
- * formatters are plain functions and cannot call hooks, so a component reads
- * `useI18nLocale()` and `useTranslations()` and passes both here.
- *
- * Both are optional so existing callers keep their output: without a `locale`
- * the formatters use "en-US", without `t` they return the English literals they
- * always returned.
- */
-type BillingFormatOptions = {
-    /** BCP 47 locale for `Intl` (the app's active locale, from `useI18nLocale()`). */
-    locale?: string;
-    /** Translator for the words the formatters emit. */
-    t?: BillingTranslator;
-};
-
-/**
- * Format price recurring interval for display
- * @param price - Stripe price object
- * @param options - `t` translates the interval words; without it the output is English
- * @returns Formatted interval string (e.g., "/month", "/year", "/2 weeks", "one-time")
- */
-declare function formatInterval(price: StripePriceInterface, options?: BillingFormatOptions): string;
-/**
- * Format currency amount from cents to localized currency string
- * @param amount - Amount in cents
- * @param currency - Currency code (e.g., "USD", "EUR", "GBP")
- * @param options - `locale` drives number formatting; defaults to "en-US"
- * @returns Formatted currency string (e.g., "$9.99", "€9,99")
- */
-declare function formatCurrency(amount: number | undefined, currency: string, options?: BillingFormatOptions): string;
-/**
- * `value.toFixed(digits)` with the locale's decimal separator ("12.5" in English,
- * "12,5" in Italian). No grouping, so English output matches `toFixed` exactly.
- */
-declare function formatFixed(value: number, locale: string | undefined, digits: number): string;
-
 /**
  * Format a date to a localized date string
  * @param date - Date object or ISO string
@@ -112,6 +76,22 @@ declare function formatDate(date: Date | string | undefined, options?: BillingFo
 /** The active locale and translator, ready to pass to the billing formatters. */
 declare function useBillingFormatOptions(): Required<BillingFormatOptions>;
 
+/** A discount as the billing screens apply it: a percentage, or an amount in minor units. */
+type BillingDiscount = {
+    discountType: "percent_off" | "amount_off";
+    discountValue: number;
+    currency?: string;
+};
+/** The discount a valid promotion code (typed or automatic) gives, or null. */
+declare function promotionCodeDiscount(code: PromotionCodeValidationResult | null | undefined): BillingDiscount | null;
+/** The discount a subscription already carries in Stripe, or null. */
+declare function subscriptionDiscount(subscription: StripeSubscriptionInterface | null | undefined): BillingDiscount | null;
+/**
+ * The amount after the discount, in the same minor units; null when there is no
+ * discount or nothing to discount. An amount discount never goes below zero.
+ */
+declare function applyDiscount(amount: number | undefined, discount: BillingDiscount | null): number | null;
+
 type BillingAlertBannerProps = {
     subscription: StripeSubscriptionInterface;
     onUpdatePayment?: () => void;
@@ -119,6 +99,34 @@ type BillingAlertBannerProps = {
 };
 declare function BillingAlertBanner({ subscription, onUpdatePayment, onAddPayment }: BillingAlertBannerProps): React.JSX.Element | null;
 
+interface CouponContextType {
+    coupon: StripeCouponInterface | undefined;
+    setCoupon: (value: StripeCouponInterface | undefined) => void;
+    reloadCoupon: () => Promise<void>;
+    createCoupon: (input: StripeCouponInput) => Promise<StripeCouponInterface>;
+    renameCoupon: (input: StripeCouponRenameInput) => Promise<StripeCouponInterface>;
+    refreshCounts: (id?: string) => Promise<void>;
+    createCode: (input: StripeCouponCodeInput) => Promise<StripeCouponCodeInterface>;
+    updateCodeFlags: (input: StripeCouponCodeFlagsInput) => Promise<StripeCouponCodeInterface>;
+    /** Bumped by every mutation. Mounted lists re-fetch on it. */
+    catalogueVersion: number;
+    refreshCatalogue: () => void;
+}
+type CouponProviderProps = {
+    children: ReactNode;
+    dehydratedCoupon?: JsonApiHydratedDataInterface;
+    /**
+     * Publish breadcrumbs + title into SharedProvider. Pass `false` when this
+     * provider is mounted INSIDE another entity's page (the Codes tab of the
+     * products page mounts CouponProvider that way): SharedProvider replaces its
+     * value for the subtree rather than merging (SharedContext.tsx:35-37), so a
+     * nested provider that publishes chrome would blank the host page's title.
+     */
+    publishChrome?: boolean;
+};
+declare const CouponProvider: ({ children, dehydratedCoupon, publishChrome }: CouponProviderProps) => React.JSX.Element;
+declare const useCouponContext: () => CouponContextType;
+
 interface PriceContextType {
     price: StripePriceInterface | undefined;
     setPrice: (value: StripePriceInterface | undefined) => void;
@@ -202,8 +210,13 @@ type PaymentMethodFormProps = {
     onSuccess: () => void;
     onCancel: () => void;
     isLoading?: boolean;
+    /**
+     * Always make the new card the customer's default and hide the checkbox. The
+     * subscription wizard needs this: the next attempt must charge the card just added.
+     */
+    alwaysSetDefault?: boolean;
 };
-declare function PaymentMethodForm({ onSuccess, onCancel, isLoading }: PaymentMethodFormProps): React.JSX.Element;
+declare function PaymentMethodForm({ onSuccess, onCancel, isLoading, alwaysSetDefault, }: PaymentMethodFormProps): React.JSX.Element;
 
 type PaymentMethodsListProps = {
     paymentMethods: PaymentMethodInterface[];
@@ -302,15 +315,19 @@ declare function PricesList({ productId, fullWidth }: PricesListProps): React.JS
 declare function ProductContainer(): React.JSX.Element | null;
 
 /**
- * Page container for the administrative product list.
+ * Page container for the administrative products page: two tabs, Products and
+ * Codes, with `sectionKey`s so the URL keeps the tab (`?section=codes`).
  *
  * Client component by necessity: `module={Modules.StripeProduct}` is a registry
  * entry carrying an icon component and methods, which a Server Component cannot
  * pass across the boundary. Routes mount this container instead — the same
  * shape as every other list page.
  *
- * No `forceHeader`: ContentListTable draws its own header row with the title
- * and the create action, exactly as the company and user list pages do.
+ * No `fullWidth`, on the page or the lists: the page keeps its title bar and
+ * each ContentListTable keeps its own bordered card in the tab (see ProductContainer). CouponProvider
+ * is nested with `publishChrome={false}`: SharedProvider REPLACES its value for
+ * the subtree (SharedContext.tsx:35-37), so a nested provider publishing chrome
+ * would blank the products page's own title.
  */
 declare function ProductsListContainer(): React.JSX.Element;
 
@@ -350,11 +367,145 @@ type ProductsListProps = {
 };
 declare function ProductsList({ fullWidth }?: ProductsListProps): React.JSX.Element;
 
+declare function CouponContainer(): React.JSX.Element | null;
+
+declare function CouponDetails(): React.JSX.Element | null;
+
+/**
+ * What a number or decimal `<FormInput>` holds: "" until something is typed, a
+ * number from `type="number"` (`+""` is 0 when cleared, NaN on garbage), a
+ * string from `type="decimal"` (may use a comma as the separator).
+ *
+ * The schemas below validate this raw value and never transform it, so the
+ * form's values have one type before and after validation. The `parse*`
+ * functions turn it into the number that is sent, on submit.
+ */
+type RawNumber = string | number | null | undefined;
+/**
+ * Optional whole number of at least 1. 0, "" and NaN all mean "not set": every
+ * limit here has a floor of 1.
+ */
+declare function parseOptionalPositiveInt(value: RawNumber): number | undefined;
+/**
+ * Optional decimal in MAJOR units. Converted to minor units on submit, exactly
+ * as PriceEditor does (`Math.round(value * 100)`).
+ */
+declare function parseOptionalDecimal(value: RawNumber): number | undefined;
+declare const optionalPositiveInt: () => z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+declare const optionalDecimal: () => z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+/**
+ * Optional point in time from `<FormDateTime allowEmpty>`, which writes "" when
+ * the value is cleared (FormDateTime.tsx:136, :241).
+ */
+declare const optionalDate: () => z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"">]>>>;
+/** Mirrors StripeCouponCodePostAttributesDTO. */
+declare const couponCodeSchema: (t: (key: string) => string) => z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    firstTimeTransaction: z.ZodBoolean;
+    minimumAmount: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    minimumAmountCurrency: z.ZodString;
+    stripeCustomerId: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"">]>>>;
+    maxRedemptions: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    automatic: z.ZodBoolean;
+}, z.core.$strip>;
+type CouponCodeFormValues = z.infer<ReturnType<typeof couponCodeSchema>>;
+/**
+ * Every text/number input starts as "" (never undefined): FormInput spreads
+ * `field.value` onto a Base UI input, and undefined → value flips it from
+ * uncontrolled to controlled (console warning). The parse functions map ""
+ * to undefined, so empty fields are still sent as absent.
+ */
+declare const couponCodeDefaults: () => CouponCodeFormValues;
+/** Form values → the code attributes the models serialise. Unset fields are left out. */
+declare const toCouponCodeInput: (values: CouponCodeFormValues) => Omit<StripeCouponCodeInput, "id" | "couponId">;
+declare const couponCurrencyOptions: {
+    id: string;
+    text: string;
+}[];
+type CouponCodeFieldsProps<T extends FieldValues> = {
+    form: UseFormReturn<T>;
+    /** "" for CouponCodeEditor, "firstCode." when nested inside CouponEditor. */
+    prefix?: string;
+};
+/** The fields of a customer-facing code, shared by CouponEditor (first code) and CouponCodeEditor. */
+declare function CouponCodeFields<T extends FieldValues>({ form, prefix }: CouponCodeFieldsProps<T>): React.JSX.Element;
+
+type CouponRefresherProps = {
+    coupon: StripeCouponInterface;
+};
+/**
+ * Re-reads the coupon and its codes from Stripe and writes the usage counts to
+ * our copy. Counts go stale only for subscriptions made outside our endpoints
+ * (the Stripe dashboard); this button fixes that.
+ */
+declare function CouponRefresher({ coupon }: CouponRefresherProps): React.JSX.Element;
+
+type CouponEditorProps = {
+    coupon?: StripeCouponInterface;
+    propagateChanges?: (coupon: StripeCouponInterface) => void;
+    onSuccess?: () => void | Promise<void>;
+    trigger?: ReactNode;
+    forceShow?: boolean;
+    onClose?: () => void;
+    dialogOpen?: boolean;
+    onDialogOpenChange?: (open: boolean) => void;
+};
+declare function CouponEditor(props: CouponEditorProps): React.JSX.Element;
+
+type CouponCodeEditorProps = {
+    couponId: string;
+    onSuccess?: () => void | Promise<void>;
+    trigger?: ReactNode;
+    forceShow?: boolean;
+    onClose?: () => void;
+    dialogOpen?: boolean;
+    onDialogOpenChange?: (open: boolean) => void;
+};
+declare function CouponCodeEditor(props: CouponCodeEditorProps): React.JSX.Element;
+
+type CouponsListProps = {
+    /**
+     * Pass this whenever the list is the page's own content inside a
+     * `RoundPageContainer fullWidth`. Without it ContentListTable wraps itself in
+     * `rounded-md border`, drawing a second bordered card inside the page's
+     * rounded shell.
+     */
+    fullWidth?: boolean;
+};
+declare function CouponsList({ fullWidth }?: CouponsListProps): React.JSX.Element;
+
+type CouponCodesListProps = {
+    couponId: string;
+};
+declare function CouponCodesList({ couponId }: CouponCodesListProps): React.JSX.Element;
+
+type CouponCodeStatus = "active" | "inactive" | "expired" | "used_up";
+
+type CouponCodeActionsProps = {
+    code: StripeCouponCodeInterface;
+    status: CouponCodeStatus;
+};
+/**
+ * Row controls of a code: the "Apply automatically" switch and the deactivate /
+ * reactivate button. The button sits behind ConfirmDialog, which is controlled
+ * and trigger-less by design — the caller owns the trigger button, so none of
+ * Base UI's trigger-composition pitfalls apply (no asChild, no nested <button>).
+ */
+declare function CouponCodeActions({ code, status }: CouponCodeActionsProps): React.JSX.Element;
+
 type SubscriptionsContainerProps = {
     onOpenWizard?: (subscription?: StripeSubscriptionInterface) => void;
     hasActiveRecurringSubscription?: boolean;
+    /**
+     * The list a parent already holds (the billing dashboard). When given, the container
+     * shows it instead of loading its own, and a change asks the parent to refresh through
+     * `onSubscriptionsChange`, so the dialog and the cards behind it never disagree.
+     */
+    subscriptions?: StripeSubscriptionInterface[];
+    onSubscriptionsChange?: () => void;
 };
-declare function SubscriptionsContainer({ onOpenWizard, hasActiveRecurringSubscription }: SubscriptionsContainerProps): React.JSX.Element;
+declare function SubscriptionsContainer({ onOpenWizard, hasActiveRecurringSubscription, subscriptions: parentSubscriptions, onSubscriptionsChange, }: SubscriptionsContainerProps): React.JSX.Element;
 
 type SubscriptionDetailsProps = {
     subscription: StripeSubscriptionInterface;
@@ -525,4 +676,4 @@ type PromoCodeInputProps = {
 };
 declare function PromoCodeInput({ appliedCode, isValidating, error, onApply, onRemove, disabled, }: PromoCodeInputProps): React.JSX.Element;
 
-export { BillingAlertBanner, BillingDashboardContainer, BillingDetailModal, type BillingFormatOptions, type BillingInterval, type BillingTranslator, BillingUsageSummaryCard, CancelSubscriptionDialog, CustomerInfoCard, IntervalToggle, type IntervalToggleProps, InvoiceDetails, InvoiceStatusBadge, InvoicesContainer, InvoicesList, InvoicesSummaryCard, PaymentMethodCard, PaymentMethodEditor, PaymentMethodForm, PaymentMethodSummaryCard, PaymentMethodsContainer, PaymentMethodsList, PriceArchiver, PriceContainer, type PriceContextType, PriceDetails, PriceEditor, type PriceEditorProps, PriceProvider, type PriceProviderProps, PricesList, PricingCard, type PricingCardProps, ProductArchiver, ProductContainer, type ProductContextType, ProductDetails, ProductEditor, type ProductEditorProps, ProductPricingList, type ProductPricingListProps, ProductPricingRow, type ProductPricingRowProps, ProductProvider, type ProductProviderProps, ProductsList, ProductsListContainer, PromoCodeInput, ProrationPreview, StripeProvider, SubscriptionConfirmation, SubscriptionDetails, SubscriptionStatusBadge, SubscriptionSummaryCard, SubscriptionWizard, type SubscriptionWizardProps, SubscriptionsContainer, SubscriptionsList, UsageContainer, UsageHistoryTable, UsageSummaryCard, UsageSummaryCards, WizardProgressIndicator, WizardStepPaymentMethod, WizardStepPlanSelection, WizardStepReview, formatCurrency, formatDate, formatFixed, formatInterval, isStripeConfigured, priceLabel, useBillingFormatOptions, usePriceContext, useProductContext };
+export { BillingAlertBanner, BillingDashboardContainer, BillingDetailModal, type BillingDiscount, BillingFormatOptions, type BillingInterval, BillingUsageSummaryCard, CancelSubscriptionDialog, CouponCodeActions, CouponCodeEditor, type CouponCodeEditorProps, CouponCodeFields, type CouponCodeFormValues, CouponCodesList, CouponContainer, type CouponContextType, CouponDetails, CouponEditor, type CouponEditorProps, CouponProvider, type CouponProviderProps, CouponRefresher, CouponsList, CustomerInfoCard, IntervalToggle, type IntervalToggleProps, InvoiceDetails, InvoiceStatusBadge, InvoicesContainer, InvoicesList, InvoicesSummaryCard, PaymentMethodCard, PaymentMethodEditor, PaymentMethodForm, PaymentMethodSummaryCard, PaymentMethodsContainer, PaymentMethodsList, PriceArchiver, PriceContainer, type PriceContextType, PriceDetails, PriceEditor, type PriceEditorProps, PriceProvider, type PriceProviderProps, PricesList, PricingCard, type PricingCardProps, ProductArchiver, ProductContainer, type ProductContextType, ProductDetails, ProductEditor, type ProductEditorProps, ProductPricingList, type ProductPricingListProps, ProductPricingRow, type ProductPricingRowProps, ProductProvider, type ProductProviderProps, ProductsList, ProductsListContainer, PromoCodeInput, ProrationPreview, StripeProvider, SubscriptionConfirmation, SubscriptionDetails, SubscriptionStatusBadge, SubscriptionSummaryCard, SubscriptionWizard, type SubscriptionWizardProps, SubscriptionsContainer, SubscriptionsList, UsageContainer, UsageHistoryTable, UsageSummaryCard, UsageSummaryCards, WizardProgressIndicator, WizardStepPaymentMethod, WizardStepPlanSelection, WizardStepReview, applyDiscount, couponCodeDefaults, couponCodeSchema, couponCurrencyOptions, formatDate, isStripeConfigured, optionalDate, optionalDecimal, optionalPositiveInt, parseOptionalDecimal, parseOptionalPositiveInt, priceLabel, promotionCodeDiscount, subscriptionDiscount, toCouponCodeInput, useBillingFormatOptions, useCouponContext, usePriceContext, useProductContext };

package/dist/billing/index.d.ts

@@ -1,7 +1,10 @@
 import * as React from 'react';
 import { ReactNode } from 'react';
-import { j as StripeSubscriptionInterface, P as PaymentMethodInterface, S as StripeCustomerInterface, a as StripeInvoiceInterface, M as MeterInterface, o as MeterSummaryInterface, d as StripePriceInterface, f as StripePriceInput, g as StripeProductInterface, h as StripeProductInput, I as InvoiceStatus, b as ProrationPreviewInterface, i as SubscriptionStatus, q as PromotionCodeValidationResult, n as StripeUsageInterface } from '../stripe-promotion-code.interface-C3qqh3mi.js';
+import { k as StripeSubscriptionInterface, P as PaymentMethodInterface, S as StripeCustomerInterface, a as StripeInvoiceInterface, M as MeterInterface, p as MeterSummaryInterface, F as BillingFormatOptions, r as PromotionCodeValidationResult, u as StripeCouponInterface, x as StripeCouponInput, y as StripeCouponRenameInput, A as StripeCouponCodeInput, z as StripeCouponCodeInterface, B as StripeCouponCodeFlagsInput, d as StripePriceInterface, f as StripePriceInput, g as StripeProductInterface, h as StripeProductInput, I as InvoiceStatus, b as ProrationPreviewInterface, i as SubscriptionStatus, o as StripeUsageInterface } from '../currency-pK9eRYRC.js';
+export { G as BillingTranslator, D as formatCurrency, E as formatFixed, C as formatInterval } from '../currency-pK9eRYRC.js';
 import { J as JsonApiHydratedDataInterface } from '../ApiDataInterface-BcZeXy5X.js';
+import { FieldValues, UseFormReturn } from 'react-hook-form';
+import { z } from 'zod';
 import '../feature.interface-BO25VLlx.js';
 
 type SubscriptionSummaryCardProps = {
@@ -61,45 +64,6 @@ declare function StripeProvider({ children }: {
 }): React.JSX.Element;
 declare function isStripeConfigured(): boolean;
 
-/** A message translator, as returned by `useTranslations()`. */
-type BillingTranslator = (key: string, values?: Record<string, any>) => string;
-/**
- * What the billing formatters need from the caller's React context. The
- * formatters are plain functions and cannot call hooks, so a component reads
- * `useI18nLocale()` and `useTranslations()` and passes both here.
- *
- * Both are optional so existing callers keep their output: without a `locale`
- * the formatters use "en-US", without `t` they return the English literals they
- * always returned.
- */
-type BillingFormatOptions = {
-    /** BCP 47 locale for `Intl` (the app's active locale, from `useI18nLocale()`). */
-    locale?: string;
-    /** Translator for the words the formatters emit. */
-    t?: BillingTranslator;
-};
-
-/**
- * Format price recurring interval for display
- * @param price - Stripe price object
- * @param options - `t` translates the interval words; without it the output is English
- * @returns Formatted interval string (e.g., "/month", "/year", "/2 weeks", "one-time")
- */
-declare function formatInterval(price: StripePriceInterface, options?: BillingFormatOptions): string;
-/**
- * Format currency amount from cents to localized currency string
- * @param amount - Amount in cents
- * @param currency - Currency code (e.g., "USD", "EUR", "GBP")
- * @param options - `locale` drives number formatting; defaults to "en-US"
- * @returns Formatted currency string (e.g., "$9.99", "€9,99")
- */
-declare function formatCurrency(amount: number | undefined, currency: string, options?: BillingFormatOptions): string;
-/**
- * `value.toFixed(digits)` with the locale's decimal separator ("12.5" in English,
- * "12,5" in Italian). No grouping, so English output matches `toFixed` exactly.
- */
-declare function formatFixed(value: number, locale: string | undefined, digits: number): string;
-
 /**
  * Format a date to a localized date string
  * @param date - Date object or ISO string
@@ -112,6 +76,22 @@ declare function formatDate(date: Date | string | undefined, options?: BillingFo
 /** The active locale and translator, ready to pass to the billing formatters. */
 declare function useBillingFormatOptions(): Required<BillingFormatOptions>;
 
+/** A discount as the billing screens apply it: a percentage, or an amount in minor units. */
+type BillingDiscount = {
+    discountType: "percent_off" | "amount_off";
+    discountValue: number;
+    currency?: string;
+};
+/** The discount a valid promotion code (typed or automatic) gives, or null. */
+declare function promotionCodeDiscount(code: PromotionCodeValidationResult | null | undefined): BillingDiscount | null;
+/** The discount a subscription already carries in Stripe, or null. */
+declare function subscriptionDiscount(subscription: StripeSubscriptionInterface | null | undefined): BillingDiscount | null;
+/**
+ * The amount after the discount, in the same minor units; null when there is no
+ * discount or nothing to discount. An amount discount never goes below zero.
+ */
+declare function applyDiscount(amount: number | undefined, discount: BillingDiscount | null): number | null;
+
 type BillingAlertBannerProps = {
     subscription: StripeSubscriptionInterface;
     onUpdatePayment?: () => void;
@@ -119,6 +99,34 @@ type BillingAlertBannerProps = {
 };
 declare function BillingAlertBanner({ subscription, onUpdatePayment, onAddPayment }: BillingAlertBannerProps): React.JSX.Element | null;
 
+interface CouponContextType {
+    coupon: StripeCouponInterface | undefined;
+    setCoupon: (value: StripeCouponInterface | undefined) => void;
+    reloadCoupon: () => Promise<void>;
+    createCoupon: (input: StripeCouponInput) => Promise<StripeCouponInterface>;
+    renameCoupon: (input: StripeCouponRenameInput) => Promise<StripeCouponInterface>;
+    refreshCounts: (id?: string) => Promise<void>;
+    createCode: (input: StripeCouponCodeInput) => Promise<StripeCouponCodeInterface>;
+    updateCodeFlags: (input: StripeCouponCodeFlagsInput) => Promise<StripeCouponCodeInterface>;
+    /** Bumped by every mutation. Mounted lists re-fetch on it. */
+    catalogueVersion: number;
+    refreshCatalogue: () => void;
+}
+type CouponProviderProps = {
+    children: ReactNode;
+    dehydratedCoupon?: JsonApiHydratedDataInterface;
+    /**
+     * Publish breadcrumbs + title into SharedProvider. Pass `false` when this
+     * provider is mounted INSIDE another entity's page (the Codes tab of the
+     * products page mounts CouponProvider that way): SharedProvider replaces its
+     * value for the subtree rather than merging (SharedContext.tsx:35-37), so a
+     * nested provider that publishes chrome would blank the host page's title.
+     */
+    publishChrome?: boolean;
+};
+declare const CouponProvider: ({ children, dehydratedCoupon, publishChrome }: CouponProviderProps) => React.JSX.Element;
+declare const useCouponContext: () => CouponContextType;
+
 interface PriceContextType {
     price: StripePriceInterface | undefined;
     setPrice: (value: StripePriceInterface | undefined) => void;
@@ -202,8 +210,13 @@ type PaymentMethodFormProps = {
     onSuccess: () => void;
     onCancel: () => void;
     isLoading?: boolean;
+    /**
+     * Always make the new card the customer's default and hide the checkbox. The
+     * subscription wizard needs this: the next attempt must charge the card just added.
+     */
+    alwaysSetDefault?: boolean;
 };
-declare function PaymentMethodForm({ onSuccess, onCancel, isLoading }: PaymentMethodFormProps): React.JSX.Element;
+declare function PaymentMethodForm({ onSuccess, onCancel, isLoading, alwaysSetDefault, }: PaymentMethodFormProps): React.JSX.Element;
 
 type PaymentMethodsListProps = {
     paymentMethods: PaymentMethodInterface[];
@@ -302,15 +315,19 @@ declare function PricesList({ productId, fullWidth }: PricesListProps): React.JS
 declare function ProductContainer(): React.JSX.Element | null;
 
 /**
- * Page container for the administrative product list.
+ * Page container for the administrative products page: two tabs, Products and
+ * Codes, with `sectionKey`s so the URL keeps the tab (`?section=codes`).
  *
  * Client component by necessity: `module={Modules.StripeProduct}` is a registry
  * entry carrying an icon component and methods, which a Server Component cannot
  * pass across the boundary. Routes mount this container instead — the same
  * shape as every other list page.
  *
- * No `forceHeader`: ContentListTable draws its own header row with the title
- * and the create action, exactly as the company and user list pages do.
+ * No `fullWidth`, on the page or the lists: the page keeps its title bar and
+ * each ContentListTable keeps its own bordered card in the tab (see ProductContainer). CouponProvider
+ * is nested with `publishChrome={false}`: SharedProvider REPLACES its value for
+ * the subtree (SharedContext.tsx:35-37), so a nested provider publishing chrome
+ * would blank the products page's own title.
  */
 declare function ProductsListContainer(): React.JSX.Element;
 
@@ -350,11 +367,145 @@ type ProductsListProps = {
 };
 declare function ProductsList({ fullWidth }?: ProductsListProps): React.JSX.Element;
 
+declare function CouponContainer(): React.JSX.Element | null;
+
+declare function CouponDetails(): React.JSX.Element | null;
+
+/**
+ * What a number or decimal `<FormInput>` holds: "" until something is typed, a
+ * number from `type="number"` (`+""` is 0 when cleared, NaN on garbage), a
+ * string from `type="decimal"` (may use a comma as the separator).
+ *
+ * The schemas below validate this raw value and never transform it, so the
+ * form's values have one type before and after validation. The `parse*`
+ * functions turn it into the number that is sent, on submit.
+ */
+type RawNumber = string | number | null | undefined;
+/**
+ * Optional whole number of at least 1. 0, "" and NaN all mean "not set": every
+ * limit here has a floor of 1.
+ */
+declare function parseOptionalPositiveInt(value: RawNumber): number | undefined;
+/**
+ * Optional decimal in MAJOR units. Converted to minor units on submit, exactly
+ * as PriceEditor does (`Math.round(value * 100)`).
+ */
+declare function parseOptionalDecimal(value: RawNumber): number | undefined;
+declare const optionalPositiveInt: () => z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+declare const optionalDecimal: () => z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+/**
+ * Optional point in time from `<FormDateTime allowEmpty>`, which writes "" when
+ * the value is cleared (FormDateTime.tsx:136, :241).
+ */
+declare const optionalDate: () => z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"">]>>>;
+/** Mirrors StripeCouponCodePostAttributesDTO. */
+declare const couponCodeSchema: (t: (key: string) => string) => z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    firstTimeTransaction: z.ZodBoolean;
+    minimumAmount: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    minimumAmountCurrency: z.ZodString;
+    stripeCustomerId: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodLiteral<"">]>>>;
+    maxRedemptions: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>>;
+    automatic: z.ZodBoolean;
+}, z.core.$strip>;
+type CouponCodeFormValues = z.infer<ReturnType<typeof couponCodeSchema>>;
+/**
+ * Every text/number input starts as "" (never undefined): FormInput spreads
+ * `field.value` onto a Base UI input, and undefined → value flips it from
+ * uncontrolled to controlled (console warning). The parse functions map ""
+ * to undefined, so empty fields are still sent as absent.
+ */
+declare const couponCodeDefaults: () => CouponCodeFormValues;
+/** Form values → the code attributes the models serialise. Unset fields are left out. */
+declare const toCouponCodeInput: (values: CouponCodeFormValues) => Omit<StripeCouponCodeInput, "id" | "couponId">;
+declare const couponCurrencyOptions: {
+    id: string;
+    text: string;
+}[];
+type CouponCodeFieldsProps<T extends FieldValues> = {
+    form: UseFormReturn<T>;
+    /** "" for CouponCodeEditor, "firstCode." when nested inside CouponEditor. */
+    prefix?: string;
+};
+/** The fields of a customer-facing code, shared by CouponEditor (first code) and CouponCodeEditor. */
+declare function CouponCodeFields<T extends FieldValues>({ form, prefix }: CouponCodeFieldsProps<T>): React.JSX.Element;
+
+type CouponRefresherProps = {
+    coupon: StripeCouponInterface;
+};
+/**
+ * Re-reads the coupon and its codes from Stripe and writes the usage counts to
+ * our copy. Counts go stale only for subscriptions made outside our endpoints
+ * (the Stripe dashboard); this button fixes that.
+ */
+declare function CouponRefresher({ coupon }: CouponRefresherProps): React.JSX.Element;
+
+type CouponEditorProps = {
+    coupon?: StripeCouponInterface;
+    propagateChanges?: (coupon: StripeCouponInterface) => void;
+    onSuccess?: () => void | Promise<void>;
+    trigger?: ReactNode;
+    forceShow?: boolean;
+    onClose?: () => void;
+    dialogOpen?: boolean;
+    onDialogOpenChange?: (open: boolean) => void;
+};
+declare function CouponEditor(props: CouponEditorProps): React.JSX.Element;
+
+type CouponCodeEditorProps = {
+    couponId: string;
+    onSuccess?: () => void | Promise<void>;
+    trigger?: ReactNode;
+    forceShow?: boolean;
+    onClose?: () => void;
+    dialogOpen?: boolean;
+    onDialogOpenChange?: (open: boolean) => void;
+};
+declare function CouponCodeEditor(props: CouponCodeEditorProps): React.JSX.Element;
+
+type CouponsListProps = {
+    /**
+     * Pass this whenever the list is the page's own content inside a
+     * `RoundPageContainer fullWidth`. Without it ContentListTable wraps itself in
+     * `rounded-md border`, drawing a second bordered card inside the page's
+     * rounded shell.
+     */
+    fullWidth?: boolean;
+};
+declare function CouponsList({ fullWidth }?: CouponsListProps): React.JSX.Element;
+
+type CouponCodesListProps = {
+    couponId: string;
+};
+declare function CouponCodesList({ couponId }: CouponCodesListProps): React.JSX.Element;
+
+type CouponCodeStatus = "active" | "inactive" | "expired" | "used_up";
+
+type CouponCodeActionsProps = {
+    code: StripeCouponCodeInterface;
+    status: CouponCodeStatus;
+};
+/**
+ * Row controls of a code: the "Apply automatically" switch and the deactivate /
+ * reactivate button. The button sits behind ConfirmDialog, which is controlled
+ * and trigger-less by design — the caller owns the trigger button, so none of
+ * Base UI's trigger-composition pitfalls apply (no asChild, no nested <button>).
+ */
+declare function CouponCodeActions({ code, status }: CouponCodeActionsProps): React.JSX.Element;
+
 type SubscriptionsContainerProps = {
     onOpenWizard?: (subscription?: StripeSubscriptionInterface) => void;
     hasActiveRecurringSubscription?: boolean;
+    /**
+     * The list a parent already holds (the billing dashboard). When given, the container
+     * shows it instead of loading its own, and a change asks the parent to refresh through
+     * `onSubscriptionsChange`, so the dialog and the cards behind it never disagree.
+     */
+    subscriptions?: StripeSubscriptionInterface[];
+    onSubscriptionsChange?: () => void;
 };
-declare function SubscriptionsContainer({ onOpenWizard, hasActiveRecurringSubscription }: SubscriptionsContainerProps): React.JSX.Element;
+declare function SubscriptionsContainer({ onOpenWizard, hasActiveRecurringSubscription, subscriptions: parentSubscriptions, onSubscriptionsChange, }: SubscriptionsContainerProps): React.JSX.Element;
 
 type SubscriptionDetailsProps = {
     subscription: StripeSubscriptionInterface;
@@ -525,4 +676,4 @@ type PromoCodeInputProps = {
 };
 declare function PromoCodeInput({ appliedCode, isValidating, error, onApply, onRemove, disabled, }: PromoCodeInputProps): React.JSX.Element;
 
-export { BillingAlertBanner, BillingDashboardContainer, BillingDetailModal, type BillingFormatOptions, type BillingInterval, type BillingTranslator, BillingUsageSummaryCard, CancelSubscriptionDialog, CustomerInfoCard, IntervalToggle, type IntervalToggleProps, InvoiceDetails, InvoiceStatusBadge, InvoicesContainer, InvoicesList, InvoicesSummaryCard, PaymentMethodCard, PaymentMethodEditor, PaymentMethodForm, PaymentMethodSummaryCard, PaymentMethodsContainer, PaymentMethodsList, PriceArchiver, PriceContainer, type PriceContextType, PriceDetails, PriceEditor, type PriceEditorProps, PriceProvider, type PriceProviderProps, PricesList, PricingCard, type PricingCardProps, ProductArchiver, ProductContainer, type ProductContextType, ProductDetails, ProductEditor, type ProductEditorProps, ProductPricingList, type ProductPricingListProps, ProductPricingRow, type ProductPricingRowProps, ProductProvider, type ProductProviderProps, ProductsList, ProductsListContainer, PromoCodeInput, ProrationPreview, StripeProvider, SubscriptionConfirmation, SubscriptionDetails, SubscriptionStatusBadge, SubscriptionSummaryCard, SubscriptionWizard, type SubscriptionWizardProps, SubscriptionsContainer, SubscriptionsList, UsageContainer, UsageHistoryTable, UsageSummaryCard, UsageSummaryCards, WizardProgressIndicator, WizardStepPaymentMethod, WizardStepPlanSelection, WizardStepReview, formatCurrency, formatDate, formatFixed, formatInterval, isStripeConfigured, priceLabel, useBillingFormatOptions, usePriceContext, useProductContext };
+export { BillingAlertBanner, BillingDashboardContainer, BillingDetailModal, type BillingDiscount, BillingFormatOptions, type BillingInterval, BillingUsageSummaryCard, CancelSubscriptionDialog, CouponCodeActions, CouponCodeEditor, type CouponCodeEditorProps, CouponCodeFields, type CouponCodeFormValues, CouponCodesList, CouponContainer, type CouponContextType, CouponDetails, CouponEditor, type CouponEditorProps, CouponProvider, type CouponProviderProps, CouponRefresher, CouponsList, CustomerInfoCard, IntervalToggle, type IntervalToggleProps, InvoiceDetails, InvoiceStatusBadge, InvoicesContainer, InvoicesList, InvoicesSummaryCard, PaymentMethodCard, PaymentMethodEditor, PaymentMethodForm, PaymentMethodSummaryCard, PaymentMethodsContainer, PaymentMethodsList, PriceArchiver, PriceContainer, type PriceContextType, PriceDetails, PriceEditor, type PriceEditorProps, PriceProvider, type PriceProviderProps, PricesList, PricingCard, type PricingCardProps, ProductArchiver, ProductContainer, type ProductContextType, ProductDetails, ProductEditor, type ProductEditorProps, ProductPricingList, type ProductPricingListProps, ProductPricingRow, type ProductPricingRowProps, ProductProvider, type ProductProviderProps, ProductsList, ProductsListContainer, PromoCodeInput, ProrationPreview, StripeProvider, SubscriptionConfirmation, SubscriptionDetails, SubscriptionStatusBadge, SubscriptionSummaryCard, SubscriptionWizard, type SubscriptionWizardProps, SubscriptionsContainer, SubscriptionsList, UsageContainer, UsageHistoryTable, UsageSummaryCard, UsageSummaryCards, WizardProgressIndicator, WizardStepPaymentMethod, WizardStepPlanSelection, WizardStepReview, applyDiscount, couponCodeDefaults, couponCodeSchema, couponCurrencyOptions, formatDate, isStripeConfigured, optionalDate, optionalDecimal, optionalPositiveInt, parseOptionalDecimal, parseOptionalPositiveInt, priceLabel, promotionCodeDiscount, subscriptionDiscount, toCouponCodeInput, useBillingFormatOptions, useCouponContext, usePriceContext, useProductContext };