@carlonicora/nextjs-jsonapi 5.5.0 → 5.6.0

package/dist/billing/index.d.mts

@@ -1,7 +1,9 @@
 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, B as BillingFormatOptions, d as StripePriceInterface, r as PromotionCodeValidationResult, u as StripeCouponInterface, v as StripeCouponInput, w as StripeCouponRenameInput, y as StripeCouponCodeInput, x as StripeCouponCodeInterface, z as StripeCouponCodeFlagsInput, f as StripePriceInput, g as StripeProductInterface, h as StripeProductInput, I as InvoiceStatus, b as ProrationPreviewInterface, i as SubscriptionStatus, o as StripeUsageInterface } from '../format-options-D6c7FNDi.mjs';
+export { A as BillingTranslator } from '../format-options-D6c7FNDi.mjs';
 import { J as JsonApiHydratedDataInterface } from '../ApiDataInterface-BcZeXy5X.mjs';
+import { z } from 'zod';
 import '../feature.interface-CXb1-vNq.mjs';
 
 type SubscriptionSummaryCardProps = {
@@ -61,24 +63,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
@@ -112,6 +96,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 +119,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 +230,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 +335,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 +387,135 @@ type ProductsListProps = {
 };
 declare function ProductsList({ fullWidth }?: ProductsListProps): React.JSX.Element;
 
+declare function CouponContainer(): React.JSX.Element | null;
+
+declare function CouponDetails(): React.JSX.Element | null;
+
+/**
+ * Optional whole number of at least 1. The fields render as
+ * `<FormInput type="number">`, which hands back `+""` (0) for a cleared input,
+ * so 0, "" and NaN all mean "not set" — every limit here has a floor of 1.
+ */
+declare const optionalPositiveInt: () => z.ZodPreprocess<z.ZodOptional<z.ZodNumber>, unknown>;
+/**
+ * Optional decimal in MAJOR units, from `<FormInput type="decimal">` (a string
+ * that may use a comma as the separator). Converted to minor units on submit,
+ * exactly as PriceEditor does (`Math.round(value * 100)`).
+ */
+declare const optionalDecimal: () => z.ZodPreprocess<z.ZodOptional<z.ZodNumber>, unknown>;
+/** Mirrors StripeCouponCodePostAttributesDTO. */
+/**
+ * Optional point in time from `<FormDateTime allowEmpty>`, which writes "" when
+ * the value is cleared (FormDateTime.tsx:136, :241).
+ */
+declare const optionalDate: () => z.ZodPreprocess<z.ZodOptional<z.ZodDate>, unknown>;
+declare const couponCodeSchema: (t: (key: string) => string) => z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    firstTimeTransaction: z.ZodBoolean;
+    minimumAmount: z.ZodPreprocess<z.ZodOptional<z.ZodNumber>, unknown>;
+    minimumAmountCurrency: z.ZodString;
+    stripeCustomerId: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodPreprocess<z.ZodOptional<z.ZodDate>, unknown>;
+    maxRedemptions: z.ZodPreprocess<z.ZodOptional<z.ZodNumber>, unknown>;
+    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 schema preprocessors map
+ * "" back to undefined, so empty fields are still sent as absent.
+ */
+declare const couponCodeDefaults: () => z.input<ReturnType<typeof couponCodeSchema>>;
+/** 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 = {
+    form: any;
+    /** "" 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({ form, prefix }: CouponCodeFieldsProps): 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 +686,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, formatCurrency, formatDate, formatFixed, formatInterval, isStripeConfigured, optionalDate, optionalDecimal, optionalPositiveInt, priceLabel, promotionCodeDiscount, subscriptionDiscount, toCouponCodeInput, useBillingFormatOptions, useCouponContext, usePriceContext, useProductContext };

package/dist/billing/index.d.ts

@@ -1,7 +1,9 @@
 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, B as BillingFormatOptions, d as StripePriceInterface, r as PromotionCodeValidationResult, u as StripeCouponInterface, v as StripeCouponInput, w as StripeCouponRenameInput, y as StripeCouponCodeInput, x as StripeCouponCodeInterface, z as StripeCouponCodeFlagsInput, f as StripePriceInput, g as StripeProductInterface, h as StripeProductInput, I as InvoiceStatus, b as ProrationPreviewInterface, i as SubscriptionStatus, o as StripeUsageInterface } from '../format-options-BtX3o0Yu.js';
+export { A as BillingTranslator } from '../format-options-BtX3o0Yu.js';
 import { J as JsonApiHydratedDataInterface } from '../ApiDataInterface-BcZeXy5X.js';
+import { z } from 'zod';
 import '../feature.interface-BO25VLlx.js';
 
 type SubscriptionSummaryCardProps = {
@@ -61,24 +63,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
@@ -112,6 +96,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 +119,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 +230,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 +335,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 +387,135 @@ type ProductsListProps = {
 };
 declare function ProductsList({ fullWidth }?: ProductsListProps): React.JSX.Element;
 
+declare function CouponContainer(): React.JSX.Element | null;
+
+declare function CouponDetails(): React.JSX.Element | null;
+
+/**
+ * Optional whole number of at least 1. The fields render as
+ * `<FormInput type="number">`, which hands back `+""` (0) for a cleared input,
+ * so 0, "" and NaN all mean "not set" — every limit here has a floor of 1.
+ */
+declare const optionalPositiveInt: () => z.ZodPreprocess<z.ZodOptional<z.ZodNumber>, unknown>;
+/**
+ * Optional decimal in MAJOR units, from `<FormInput type="decimal">` (a string
+ * that may use a comma as the separator). Converted to minor units on submit,
+ * exactly as PriceEditor does (`Math.round(value * 100)`).
+ */
+declare const optionalDecimal: () => z.ZodPreprocess<z.ZodOptional<z.ZodNumber>, unknown>;
+/** Mirrors StripeCouponCodePostAttributesDTO. */
+/**
+ * Optional point in time from `<FormDateTime allowEmpty>`, which writes "" when
+ * the value is cleared (FormDateTime.tsx:136, :241).
+ */
+declare const optionalDate: () => z.ZodPreprocess<z.ZodOptional<z.ZodDate>, unknown>;
+declare const couponCodeSchema: (t: (key: string) => string) => z.ZodObject<{
+    code: z.ZodOptional<z.ZodString>;
+    firstTimeTransaction: z.ZodBoolean;
+    minimumAmount: z.ZodPreprocess<z.ZodOptional<z.ZodNumber>, unknown>;
+    minimumAmountCurrency: z.ZodString;
+    stripeCustomerId: z.ZodOptional<z.ZodString>;
+    expiresAt: z.ZodPreprocess<z.ZodOptional<z.ZodDate>, unknown>;
+    maxRedemptions: z.ZodPreprocess<z.ZodOptional<z.ZodNumber>, unknown>;
+    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 schema preprocessors map
+ * "" back to undefined, so empty fields are still sent as absent.
+ */
+declare const couponCodeDefaults: () => z.input<ReturnType<typeof couponCodeSchema>>;
+/** 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 = {
+    form: any;
+    /** "" 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({ form, prefix }: CouponCodeFieldsProps): 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 +686,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, formatCurrency, formatDate, formatFixed, formatInterval, isStripeConfigured, optionalDate, optionalDecimal, optionalPositiveInt, priceLabel, promotionCodeDiscount, subscriptionDiscount, toCouponCodeInput, useBillingFormatOptions, useCouponContext, usePriceContext, useProductContext };