autumn-js 1.2.32 → 1.2.34

package/dist/react/{params-BquS51Ut.d.mts → params-D3ra6In7.d.mts}

@@ -1,4 +1,4 @@
-import { C as ClosedEnum, O as OpenEnum, a as Balance, P as Plan } from './plan-BKltGb1S.mjs';
+import { C as ClosedEnum, O as OpenEnum, a as Balance, P as Plan } from './plan-DOxbvjQY.mjs';
 
 /**
  * Time range to aggregate events for. Either range or custom_range must be provided
@@ -680,6 +680,192 @@ type AttachFreeTrialParams = {
      */
     onEnd?: AttachOnEnd | undefined;
 };
+/**
+ * The time interval for the purchase limit window.
+ */
+declare const AttachPurchaseLimitInterval: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+type AttachPurchaseLimitInterval = ClosedEnum<typeof AttachPurchaseLimitInterval>;
+/**
+ * Optional rate limit to cap how often auto top-ups occur.
+ */
+type AttachPurchaseLimit = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: AttachPurchaseLimitInterval;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+type AttachAutoTopup = {
+    /**
+     * The ID of the feature (credit balance) to auto top-up.
+     */
+    featureId: string;
+    /**
+     * Whether auto top-up is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * When the balance drops below this threshold, an auto top-up will be purchased.
+     */
+    threshold: number;
+    /**
+     * Amount of credits to add per auto top-up.
+     */
+    quantity: number;
+    /**
+     * Optional rate limit to cap how often auto top-ups occur.
+     */
+    purchaseLimit?: AttachPurchaseLimit | undefined;
+    /**
+     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     */
+    invoiceMode?: boolean | undefined;
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const AttachLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type AttachLimitType = ClosedEnum<typeof AttachLimitType>;
+type AttachSpendLimit = {
+    /**
+     * Optional feature ID this spend limit applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether the overage spend limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: AttachLimitType | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
+     */
+    overageLimit?: number | undefined;
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+declare const AttachUsageLimitInterval: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+type AttachUsageLimitInterval = ClosedEnum<typeof AttachUsageLimitInterval>;
+type AttachUsageLimit = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: AttachUsageLimitInterval;
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+declare const AttachThresholdType: {
+    readonly Usage: "usage";
+    readonly UsagePercentage: "usage_percentage";
+    readonly Remaining: "remaining";
+    readonly RemainingPercentage: "remaining_percentage";
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+type AttachThresholdType = ClosedEnum<typeof AttachThresholdType>;
+type AttachUsageAlert = {
+    /**
+     * The feature ID this alert applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether this usage alert is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100).
+     */
+    threshold: number;
+    /**
+     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+     */
+    thresholdType: AttachThresholdType;
+    /**
+     * Optional user-defined label to distinguish multiple alerts on the same feature.
+     */
+    name?: string | undefined;
+};
+type AttachOverageAllowed = {
+    /**
+     * The feature ID this overage allowed control applies to.
+     */
+    featureId: string;
+    /**
+     * Whether overage is allowed for this feature.
+     */
+    enabled?: boolean | undefined;
+};
+/**
+ * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+ */
+type AttachBillingControls = {
+    /**
+     * List of auto top-up configurations per feature.
+     */
+    autoTopups?: Array<AttachAutoTopup> | undefined;
+    /**
+     * List of overage spend limits per feature (caps overage spend).
+     */
+    spendLimits?: Array<AttachSpendLimit> | undefined;
+    /**
+     * List of hard usage caps per feature (max units per interval).
+     */
+    usageLimits?: Array<AttachUsageLimit> | undefined;
+    /**
+     * List of usage alert configurations per feature.
+     */
+    usageAlerts?: Array<AttachUsageAlert> | undefined;
+    /**
+     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
+     */
+    overageAllowed?: Array<AttachOverageAllowed> | undefined;
+};
 /**
  * Customize the plan to attach. Can override the price, items, free trial, or a combination.
  */
@@ -704,6 +890,10 @@ type AttachCustomize = {
      * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
      */
     freeTrial?: AttachFreeTrialParams | null | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: AttachBillingControls | undefined;
 };
 /**
  * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
@@ -1562,86 +1752,276 @@ type BillingUpdateFreeTrialParams = {
     onEnd?: BillingUpdateOnEnd | undefined;
 };
 /**
- * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+ * The time interval for the purchase limit window.
  */
-type BillingUpdateCustomize = {
-    /**
-     * Override the base price of the plan. Pass null to remove the base price.
-     */
-    price?: BillingUpdateBasePrice | null | undefined;
+declare const BillingUpdatePurchaseLimitInterval: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+type BillingUpdatePurchaseLimitInterval = ClosedEnum<typeof BillingUpdatePurchaseLimitInterval>;
+/**
+ * Optional rate limit to cap how often auto top-ups occur.
+ */
+type BillingUpdatePurchaseLimit = {
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     * The time interval for the purchase limit window.
      */
-    items?: Array<BillingUpdateItemPlanItem> | undefined;
+    interval: BillingUpdatePurchaseLimitInterval;
     /**
-     * Items to add to the plan.
+     * Number of intervals in the purchase limit window.
      */
-    addItems?: Array<BillingUpdateAddItemPlanItem> | undefined;
+    intervalCount?: number | undefined;
     /**
-     * Filters selecting items to remove from the plan.
+     * Maximum number of auto top-ups allowed within the interval.
      */
-    removeItems?: Array<BillingUpdatePlanItemFilter> | undefined;
+    limit: number;
+};
+type BillingUpdateAutoTopup = {
     /**
-     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     * The ID of the feature (credit balance) to auto top-up.
      */
-    freeTrial?: BillingUpdateFreeTrialParams | null | undefined;
-};
-/**
- * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
- */
-type BillingUpdateInvoiceMode = {
+    featureId: string;
     /**
-     * When true, creates an invoice and sends it to the customer instead of charging their card immediately. Uses Stripe's send_invoice collection method.
+     * Whether auto top-up is enabled.
      */
-    enabled: boolean;
+    enabled?: boolean | undefined;
     /**
-     * If true, enables the plan immediately even though the invoice is not paid yet.
+     * When the balance drops below this threshold, an auto top-up will be purchased.
      */
-    enablePlanImmediately?: boolean | undefined;
+    threshold: number;
     /**
-     * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
+     * Amount of credits to add per auto top-up.
      */
-    finalize?: boolean | undefined;
+    quantity: number;
     /**
-     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     * Optional rate limit to cap how often auto top-ups occur.
      */
-    invoiceTemplateId?: string | undefined;
+    purchaseLimit?: BillingUpdatePurchaseLimit | undefined;
     /**
-     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
      */
-    netTermsDays?: number | undefined;
+    invoiceMode?: boolean | undefined;
 };
 /**
- * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
-declare const BillingUpdateProrationBehavior: {
-    readonly ProrateImmediately: "prorate_immediately";
-    readonly None: "none";
+declare const BillingUpdateLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
 };
 /**
- * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
- */
-type BillingUpdateProrationBehavior = ClosedEnum<typeof BillingUpdateProrationBehavior>;
-/**
- * Controls when to return a checkout URL. 'always' returns a URL even if payment succeeds, 'if_required' only when payment action is needed, 'never' disables redirects.
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
-declare const BillingUpdateRedirectMode: {
-    readonly Always: "always";
-    readonly IfRequired: "if_required";
-    readonly Never: "never";
+type BillingUpdateLimitType = ClosedEnum<typeof BillingUpdateLimitType>;
+type BillingUpdateSpendLimit = {
+    /**
+     * Optional feature ID this spend limit applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether the overage spend limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: BillingUpdateLimitType | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
+     */
+    overageLimit?: number | undefined;
 };
 /**
- * Controls when to return a checkout URL. 'always' returns a URL even if payment succeeds, 'if_required' only when payment action is needed, 'never' disables redirects.
+ * Interval for the cap, aligned to the customer's billing cycle.
  */
-type BillingUpdateRedirectMode = ClosedEnum<typeof BillingUpdateRedirectMode>;
+declare const BillingUpdateUsageLimitInterval: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
 /**
- * A discount to apply. Can be either a reward ID or a promotion code.
+ * Interval for the cap, aligned to the customer's billing cycle.
  */
-type BillingUpdateAttachDiscount = {
+type BillingUpdateUsageLimitInterval = ClosedEnum<typeof BillingUpdateUsageLimitInterval>;
+type BillingUpdateUsageLimit = {
     /**
-     * The ID of the reward to apply as a discount.
+     * The feature this usage limit applies to.
      */
-    rewardId?: string | undefined;
+    featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: BillingUpdateUsageLimitInterval;
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+declare const BillingUpdateThresholdType: {
+    readonly Usage: "usage";
+    readonly UsagePercentage: "usage_percentage";
+    readonly Remaining: "remaining";
+    readonly RemainingPercentage: "remaining_percentage";
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+type BillingUpdateThresholdType = ClosedEnum<typeof BillingUpdateThresholdType>;
+type BillingUpdateUsageAlert = {
+    /**
+     * The feature ID this alert applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether this usage alert is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100).
+     */
+    threshold: number;
+    /**
+     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+     */
+    thresholdType: BillingUpdateThresholdType;
+    /**
+     * Optional user-defined label to distinguish multiple alerts on the same feature.
+     */
+    name?: string | undefined;
+};
+type BillingUpdateOverageAllowed = {
+    /**
+     * The feature ID this overage allowed control applies to.
+     */
+    featureId: string;
+    /**
+     * Whether overage is allowed for this feature.
+     */
+    enabled?: boolean | undefined;
+};
+/**
+ * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+ */
+type BillingUpdateBillingControls = {
+    /**
+     * List of auto top-up configurations per feature.
+     */
+    autoTopups?: Array<BillingUpdateAutoTopup> | undefined;
+    /**
+     * List of overage spend limits per feature (caps overage spend).
+     */
+    spendLimits?: Array<BillingUpdateSpendLimit> | undefined;
+    /**
+     * List of hard usage caps per feature (max units per interval).
+     */
+    usageLimits?: Array<BillingUpdateUsageLimit> | undefined;
+    /**
+     * List of usage alert configurations per feature.
+     */
+    usageAlerts?: Array<BillingUpdateUsageAlert> | undefined;
+    /**
+     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
+     */
+    overageAllowed?: Array<BillingUpdateOverageAllowed> | undefined;
+};
+/**
+ * Customize the plan to attach. Can override the price, items, free trial, or a combination.
+ */
+type BillingUpdateCustomize = {
+    /**
+     * Override the base price of the plan. Pass null to remove the base price.
+     */
+    price?: BillingUpdateBasePrice | null | undefined;
+    /**
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
+     */
+    items?: Array<BillingUpdateItemPlanItem> | undefined;
+    /**
+     * Items to add to the plan.
+     */
+    addItems?: Array<BillingUpdateAddItemPlanItem> | undefined;
+    /**
+     * Filters selecting items to remove from the plan.
+     */
+    removeItems?: Array<BillingUpdatePlanItemFilter> | undefined;
+    /**
+     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     */
+    freeTrial?: BillingUpdateFreeTrialParams | null | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: BillingUpdateBillingControls | undefined;
+};
+/**
+ * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
+ */
+type BillingUpdateInvoiceMode = {
+    /**
+     * When true, creates an invoice and sends it to the customer instead of charging their card immediately. Uses Stripe's send_invoice collection method.
+     */
+    enabled: boolean;
+    /**
+     * If true, enables the plan immediately even though the invoice is not paid yet.
+     */
+    enablePlanImmediately?: boolean | undefined;
+    /**
+     * If true, finalizes the invoice so it can be sent to the customer. If false, keeps it as a draft for manual review.
+     */
+    finalize?: boolean | undefined;
+    /**
+     * ID of an invoice template (configured in billing settings) whose footer (e.g. bank details) is applied to the invoice.
+     */
+    invoiceTemplateId?: string | undefined;
+    /**
+     * Number of days the customer has to pay the invoice before it is due (Stripe days_until_due).
+     */
+    netTermsDays?: number | undefined;
+};
+/**
+ * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+declare const BillingUpdateProrationBehavior: {
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly None: "none";
+};
+/**
+ * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
+ */
+type BillingUpdateProrationBehavior = ClosedEnum<typeof BillingUpdateProrationBehavior>;
+/**
+ * Controls when to return a checkout URL. 'always' returns a URL even if payment succeeds, 'if_required' only when payment action is needed, 'never' disables redirects.
+ */
+declare const BillingUpdateRedirectMode: {
+    readonly Always: "always";
+    readonly IfRequired: "if_required";
+    readonly Never: "never";
+};
+/**
+ * Controls when to return a checkout URL. 'always' returns a URL even if payment succeeds, 'if_required' only when payment action is needed, 'never' disables redirects.
+ */
+type BillingUpdateRedirectMode = ClosedEnum<typeof BillingUpdateRedirectMode>;
+/**
+ * A discount to apply. Can be either a reward ID or a promotion code.
+ */
+type BillingUpdateAttachDiscount = {
+    /**
+     * The ID of the reward to apply as a discount.
+     */
+    rewardId?: string | undefined;
     /**
      * The promotion code to apply as a discount.
      */
@@ -2030,7 +2410,7 @@ declare const FeatureType2: {
     readonly Static: "static";
 };
 type FeatureType2 = OpenEnum<typeof FeatureType2>;
-declare const CheckInterval2: {
+declare const CheckItemInterval2: {
     readonly Minute: "minute";
     readonly Hour: "hour";
     readonly Day: "day";
@@ -2040,7 +2420,7 @@ declare const CheckInterval2: {
     readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-type CheckInterval2 = OpenEnum<typeof CheckInterval2>;
+type CheckItemInterval2 = OpenEnum<typeof CheckItemInterval2>;
 declare const CheckTierBehavior2: {
     readonly Graduated: "graduated";
     readonly Volume: "volume";
@@ -2109,7 +2489,7 @@ type CheckItem2 = {
     /**
      * The reset or billing interval of the product item. If null, feature will have no reset date, and if there's a price, it will be billed one-off.
      */
-    interval?: CheckInterval2 | null | undefined;
+    interval?: CheckItemInterval2 | null | undefined;
     /**
      * The interval count of the product item.
      */
@@ -2202,6 +2582,192 @@ type CheckFreeTrial2 = {
      */
     trialAvailable: boolean | null;
 };
+/**
+ * The time interval for the purchase limit window.
+ */
+declare const CheckPurchaseLimitInterval2: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+type CheckPurchaseLimitInterval2 = OpenEnum<typeof CheckPurchaseLimitInterval2>;
+/**
+ * Optional rate limit to cap how often auto top-ups occur.
+ */
+type CheckPurchaseLimit2 = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: CheckPurchaseLimitInterval2;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount: number;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+type CheckAutoTopup2 = {
+    /**
+     * The ID of the feature (credit balance) to auto top-up.
+     */
+    featureId: string;
+    /**
+     * Whether auto top-up is enabled.
+     */
+    enabled: boolean;
+    /**
+     * When the balance drops below this threshold, an auto top-up will be purchased.
+     */
+    threshold: number;
+    /**
+     * Amount of credits to add per auto top-up.
+     */
+    quantity: number;
+    /**
+     * Optional rate limit to cap how often auto top-ups occur.
+     */
+    purchaseLimit?: CheckPurchaseLimit2 | undefined;
+    /**
+     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     */
+    invoiceMode?: boolean | undefined;
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const CheckLimitType2: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type CheckLimitType2 = OpenEnum<typeof CheckLimitType2>;
+type CheckSpendLimit2 = {
+    /**
+     * Optional feature ID this spend limit applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether the overage spend limit is enabled.
+     */
+    enabled: boolean;
+    /**
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: CheckLimitType2 | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
+     */
+    overageLimit?: number | undefined;
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+declare const CheckUsageLimitInterval2: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+type CheckUsageLimitInterval2 = OpenEnum<typeof CheckUsageLimitInterval2>;
+type CheckUsageLimit2 = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled: boolean;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: CheckUsageLimitInterval2;
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+declare const CheckThresholdType2: {
+    readonly Usage: "usage";
+    readonly UsagePercentage: "usage_percentage";
+    readonly Remaining: "remaining";
+    readonly RemainingPercentage: "remaining_percentage";
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+type CheckThresholdType2 = OpenEnum<typeof CheckThresholdType2>;
+type CheckUsageAlert2 = {
+    /**
+     * The feature ID this alert applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether this usage alert is enabled.
+     */
+    enabled: boolean;
+    /**
+     * The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100).
+     */
+    threshold: number;
+    /**
+     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+     */
+    thresholdType: CheckThresholdType2;
+    /**
+     * Optional user-defined label to distinguish multiple alerts on the same feature.
+     */
+    name?: string | undefined;
+};
+type CheckOverageAllowed2 = {
+    /**
+     * The feature ID this overage allowed control applies to.
+     */
+    featureId: string;
+    /**
+     * Whether overage is allowed for this feature.
+     */
+    enabled: boolean;
+};
+/**
+ * Plan-level billing controls used as customer defaults
+ */
+type CheckBillingControls2 = {
+    /**
+     * List of auto top-up configurations per feature.
+     */
+    autoTopups?: Array<CheckAutoTopup2> | undefined;
+    /**
+     * List of overage spend limits per feature (caps overage spend).
+     */
+    spendLimits?: Array<CheckSpendLimit2> | undefined;
+    /**
+     * List of hard usage caps per feature (max units per interval).
+     */
+    usageLimits?: Array<CheckUsageLimit2> | undefined;
+    /**
+     * List of usage alert configurations per feature.
+     */
+    usageAlerts?: Array<CheckUsageAlert2> | undefined;
+    /**
+     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
+     */
+    overageAllowed?: Array<CheckOverageAllowed2> | undefined;
+};
 /**
  * Scenario for when this product is used in attach flows
  */
@@ -2292,6 +2858,10 @@ type CheckProduct2 = {
      * ID of the base variant this product is derived from
      */
     baseVariantId: string | null;
+    /**
+     * Plan-level billing controls used as customer defaults
+     */
+    billingControls?: CheckBillingControls2 | undefined;
     /**
      * Scenario for when this product is used in attach flows
      */
@@ -2520,7 +3090,7 @@ declare const FeatureType1: {
     readonly Static: "static";
 };
 type FeatureType1 = OpenEnum<typeof FeatureType1>;
-declare const CheckInterval1: {
+declare const CheckItemInterval1: {
     readonly Minute: "minute";
     readonly Hour: "hour";
     readonly Day: "day";
@@ -2530,7 +3100,7 @@ declare const CheckInterval1: {
     readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-type CheckInterval1 = OpenEnum<typeof CheckInterval1>;
+type CheckItemInterval1 = OpenEnum<typeof CheckItemInterval1>;
 declare const CheckTierBehavior1: {
     readonly Graduated: "graduated";
     readonly Volume: "volume";
@@ -2599,7 +3169,7 @@ type CheckItem1 = {
     /**
      * The reset or billing interval of the product item. If null, feature will have no reset date, and if there's a price, it will be billed one-off.
      */
-    interval?: CheckInterval1 | null | undefined;
+    interval?: CheckItemInterval1 | null | undefined;
     /**
      * The interval count of the product item.
      */
@@ -2631,66 +3201,252 @@ type CheckItem1 = {
     /**
      * The entity feature ID of the product item if applicable.
      */
-    entityFeatureId?: string | null | undefined;
+    entityFeatureId?: string | null | undefined;
+    /**
+     * The display of the product item.
+     */
+    display?: ProductDisplay1 | null | undefined;
+    /**
+     * Used in customer context. Quantity of the feature the customer has prepaid for.
+     */
+    quantity?: number | null | undefined;
+    /**
+     * Used in customer context. Quantity of the feature the customer will prepay for in the next cycle.
+     */
+    nextCycleQuantity?: number | null | undefined;
+    /**
+     * Configuration for rollover and proration behavior of the feature.
+     */
+    config?: CheckConfig1 | null | undefined;
+};
+/**
+ * The duration type of the free trial
+ */
+declare const FreeTrialDuration1: {
+    readonly Day: "day";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * The duration type of the free trial
+ */
+type FreeTrialDuration1 = OpenEnum<typeof FreeTrialDuration1>;
+declare const CheckOnEnd1: {
+    readonly Bill: "bill";
+    readonly Revert: "revert";
+};
+type CheckOnEnd1 = OpenEnum<typeof CheckOnEnd1>;
+type CheckFreeTrial1 = {
+    /**
+     * The duration type of the free trial
+     */
+    duration: FreeTrialDuration1;
+    /**
+     * The length of the duration type specified
+     */
+    length: number;
+    /**
+     * Whether the free trial is limited to one per customer fingerprint
+     */
+    uniqueFingerprint: boolean;
+    /**
+     * Whether the free trial requires a card. If false, the customer can attach the product without going through a checkout flow or having a card on file.
+     */
+    cardRequired: boolean;
+    /**
+     * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+     */
+    onEnd?: CheckOnEnd1 | null | undefined;
+    /**
+     * Used in customer context. Whether the free trial is available for the customer if they were to attach the product.
+     */
+    trialAvailable: boolean | null;
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+declare const CheckPurchaseLimitInterval1: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+type CheckPurchaseLimitInterval1 = OpenEnum<typeof CheckPurchaseLimitInterval1>;
+/**
+ * Optional rate limit to cap how often auto top-ups occur.
+ */
+type CheckPurchaseLimit1 = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: CheckPurchaseLimitInterval1;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount: number;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+type CheckAutoTopup1 = {
+    /**
+     * The ID of the feature (credit balance) to auto top-up.
+     */
+    featureId: string;
+    /**
+     * Whether auto top-up is enabled.
+     */
+    enabled: boolean;
+    /**
+     * When the balance drops below this threshold, an auto top-up will be purchased.
+     */
+    threshold: number;
+    /**
+     * Amount of credits to add per auto top-up.
+     */
+    quantity: number;
+    /**
+     * Optional rate limit to cap how often auto top-ups occur.
+     */
+    purchaseLimit?: CheckPurchaseLimit1 | undefined;
+    /**
+     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     */
+    invoiceMode?: boolean | undefined;
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const CheckLimitType1: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type CheckLimitType1 = OpenEnum<typeof CheckLimitType1>;
+type CheckSpendLimit1 = {
+    /**
+     * Optional feature ID this spend limit applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether the overage spend limit is enabled.
+     */
+    enabled: boolean;
+    /**
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: CheckLimitType1 | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
+     */
+    overageLimit?: number | undefined;
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+declare const CheckUsageLimitInterval1: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+type CheckUsageLimitInterval1 = OpenEnum<typeof CheckUsageLimitInterval1>;
+type CheckUsageLimit1 = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled: boolean;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: CheckUsageLimitInterval1;
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+declare const CheckThresholdType1: {
+    readonly Usage: "usage";
+    readonly UsagePercentage: "usage_percentage";
+    readonly Remaining: "remaining";
+    readonly RemainingPercentage: "remaining_percentage";
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+type CheckThresholdType1 = OpenEnum<typeof CheckThresholdType1>;
+type CheckUsageAlert1 = {
+    /**
+     * The feature ID this alert applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether this usage alert is enabled.
+     */
+    enabled: boolean;
+    /**
+     * The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100).
+     */
+    threshold: number;
     /**
-     * The display of the product item.
+     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
      */
-    display?: ProductDisplay1 | null | undefined;
+    thresholdType: CheckThresholdType1;
     /**
-     * Used in customer context. Quantity of the feature the customer has prepaid for.
+     * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
-    quantity?: number | null | undefined;
+    name?: string | undefined;
+};
+type CheckOverageAllowed1 = {
     /**
-     * Used in customer context. Quantity of the feature the customer will prepay for in the next cycle.
+     * The feature ID this overage allowed control applies to.
      */
-    nextCycleQuantity?: number | null | undefined;
+    featureId: string;
     /**
-     * Configuration for rollover and proration behavior of the feature.
+     * Whether overage is allowed for this feature.
      */
-    config?: CheckConfig1 | null | undefined;
-};
-/**
- * The duration type of the free trial
- */
-declare const FreeTrialDuration1: {
-    readonly Day: "day";
-    readonly Month: "month";
-    readonly Year: "year";
+    enabled: boolean;
 };
 /**
- * The duration type of the free trial
+ * Plan-level billing controls used as customer defaults
  */
-type FreeTrialDuration1 = OpenEnum<typeof FreeTrialDuration1>;
-declare const CheckOnEnd1: {
-    readonly Bill: "bill";
-    readonly Revert: "revert";
-};
-type CheckOnEnd1 = OpenEnum<typeof CheckOnEnd1>;
-type CheckFreeTrial1 = {
-    /**
-     * The duration type of the free trial
-     */
-    duration: FreeTrialDuration1;
+type CheckBillingControls1 = {
     /**
-     * The length of the duration type specified
+     * List of auto top-up configurations per feature.
      */
-    length: number;
+    autoTopups?: Array<CheckAutoTopup1> | undefined;
     /**
-     * Whether the free trial is limited to one per customer fingerprint
+     * List of overage spend limits per feature (caps overage spend).
      */
-    uniqueFingerprint: boolean;
+    spendLimits?: Array<CheckSpendLimit1> | undefined;
     /**
-     * Whether the free trial requires a card. If false, the customer can attach the product without going through a checkout flow or having a card on file.
+     * List of hard usage caps per feature (max units per interval).
      */
-    cardRequired: boolean;
+    usageLimits?: Array<CheckUsageLimit1> | undefined;
     /**
-     * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+     * List of usage alert configurations per feature.
      */
-    onEnd?: CheckOnEnd1 | null | undefined;
+    usageAlerts?: Array<CheckUsageAlert1> | undefined;
     /**
-     * Used in customer context. Whether the free trial is available for the customer if they were to attach the product.
+     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
      */
-    trialAvailable: boolean | null;
+    overageAllowed?: Array<CheckOverageAllowed1> | undefined;
 };
 /**
  * Scenario for when this product is used in attach flows
@@ -2782,6 +3538,10 @@ type CheckProduct1 = {
      * ID of the base variant this product is derived from
      */
     baseVariantId: string | null;
+    /**
+     * Plan-level billing controls used as customer defaults
+     */
+    billingControls?: CheckBillingControls1 | undefined;
     /**
      * Scenario for when this product is used in attach flows
      */
@@ -2914,6 +3674,17 @@ type CustomerDataAutoTopup = {
      */
     invoiceMode?: boolean | undefined;
 };
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const CustomerDataLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type CustomerDataLimitType = ClosedEnum<typeof CustomerDataLimitType>;
 type CustomerDataSpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -2924,7 +3695,11 @@ type CustomerDataSpendLimit = {
      */
     enabled?: boolean | undefined;
     /**
-     * Maximum allowed overage spend for the target feature.
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: CustomerDataLimitType | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     overageLimit?: number | undefined;
 };
@@ -2946,6 +3721,10 @@ type CustomerDataUsageLimit = {
      * The feature this usage limit applies to.
      */
     featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled?: boolean | undefined;
     /**
      * Maximum units allowed per interval.
      */
@@ -3365,6 +4144,17 @@ type GetEntityFlags = {
      */
     feature?: GetEntityFeature | undefined;
 };
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const GetEntityLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type GetEntityLimitType = OpenEnum<typeof GetEntityLimitType>;
 type GetEntitySpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -3375,7 +4165,11 @@ type GetEntitySpendLimit = {
      */
     enabled: boolean;
     /**
-     * Maximum allowed overage spend for the target feature.
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: GetEntityLimitType | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     overageLimit?: number | undefined;
 };
@@ -3397,6 +4191,10 @@ type GetEntityUsageLimit = {
      * The feature this usage limit applies to.
      */
     featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled: boolean;
     /**
      * Maximum units allowed per interval.
      */
@@ -4084,6 +4882,17 @@ declare const MultiAttachRedirectMode: {
  * Controls when to return a checkout URL. 'always' returns a URL even if payment succeeds, 'if_required' only when payment action is needed, 'never' disables redirects.
  */
 type MultiAttachRedirectMode = ClosedEnum<typeof MultiAttachRedirectMode>;
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const MultiAttachLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type MultiAttachLimitType = ClosedEnum<typeof MultiAttachLimitType>;
 type MultiAttachSpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -4094,7 +4903,11 @@ type MultiAttachSpendLimit = {
      */
     enabled?: boolean | undefined;
     /**
-     * Maximum allowed overage spend for the target feature.
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: MultiAttachLimitType | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     overageLimit?: number | undefined;
 };
@@ -4116,6 +4929,10 @@ type MultiAttachUsageLimit = {
      * The feature this usage limit applies to.
      */
     featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled?: boolean | undefined;
     /**
      * Maximum units allowed per interval.
      */
@@ -4807,118 +5624,304 @@ type PreviewAttachAddItemPlanItem = {
      */
     unlimited?: boolean | undefined;
     /**
-     * Reset configuration for consumable features. Omit for non-consumable features like seats.
+     * Reset configuration for consumable features. Omit for non-consumable features like seats.
+     */
+    reset?: PreviewAttachAddItemReset | undefined;
+    /**
+     * Pricing for usage beyond included units. Omit for free features.
+     */
+    price?: PreviewAttachAddItemPrice | undefined;
+    /**
+     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+     */
+    proration?: PreviewAttachAddItemProration | undefined;
+    /**
+     * Rollover config for unused units. If set, unused included units carry over.
+     */
+    rollover?: PreviewAttachAddItemRollover | undefined;
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+declare const PreviewAttachRemoveItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+type PreviewAttachRemoveItemBillingMethod = ClosedEnum<typeof PreviewAttachRemoveItemBillingMethod>;
+declare const PreviewAttachIntervalRemoveItemEnum2: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type PreviewAttachIntervalRemoveItemEnum2 = ClosedEnum<typeof PreviewAttachIntervalRemoveItemEnum2>;
+declare const PreviewAttachIntervalRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type PreviewAttachIntervalRemoveItemEnum1 = ClosedEnum<typeof PreviewAttachIntervalRemoveItemEnum1>;
+/**
+ * Filter for matching plan items. All provided fields must match (AND).
+ */
+type PreviewAttachPlanItemFilter = {
+    /**
+     * Match items linked to this feature.
+     */
+    featureId?: string | undefined;
+    /**
+     * Match items with this billing method (prepaid or usage_based).
+     */
+    billingMethod?: PreviewAttachRemoveItemBillingMethod | undefined;
+    /**
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     */
+    interval?: PreviewAttachIntervalRemoveItemEnum1 | PreviewAttachIntervalRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     */
+    intervalCount?: number | undefined;
+};
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+declare const PreviewAttachDurationType: {
+    readonly Day: "day";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+type PreviewAttachDurationType = ClosedEnum<typeof PreviewAttachDurationType>;
+/**
+ * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ */
+declare const PreviewAttachOnEnd: {
+    readonly Bill: "bill";
+    readonly Revert: "revert";
+};
+/**
+ * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ */
+type PreviewAttachOnEnd = ClosedEnum<typeof PreviewAttachOnEnd>;
+/**
+ * Free trial configuration for a plan.
+ */
+type PreviewAttachFreeTrialParams = {
+    /**
+     * Number of duration_type periods the trial lasts.
+     */
+    durationLength: number;
+    /**
+     * Unit of time for the trial ('day', 'month', 'year').
+     */
+    durationType?: PreviewAttachDurationType | undefined;
+    /**
+     * If true, payment method required to start trial. Customer is charged after trial ends.
+     */
+    cardRequired?: boolean | undefined;
+    /**
+     * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+     */
+    onEnd?: PreviewAttachOnEnd | undefined;
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+declare const PreviewAttachPurchaseLimitInterval: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+type PreviewAttachPurchaseLimitInterval = ClosedEnum<typeof PreviewAttachPurchaseLimitInterval>;
+/**
+ * Optional rate limit to cap how often auto top-ups occur.
+ */
+type PreviewAttachPurchaseLimit = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: PreviewAttachPurchaseLimitInterval;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+type PreviewAttachAutoTopup = {
+    /**
+     * The ID of the feature (credit balance) to auto top-up.
+     */
+    featureId: string;
+    /**
+     * Whether auto top-up is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * When the balance drops below this threshold, an auto top-up will be purchased.
+     */
+    threshold: number;
+    /**
+     * Amount of credits to add per auto top-up.
+     */
+    quantity: number;
+    /**
+     * Optional rate limit to cap how often auto top-ups occur.
+     */
+    purchaseLimit?: PreviewAttachPurchaseLimit | undefined;
+    /**
+     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     */
+    invoiceMode?: boolean | undefined;
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const PreviewAttachLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type PreviewAttachLimitType = ClosedEnum<typeof PreviewAttachLimitType>;
+type PreviewAttachSpendLimit = {
+    /**
+     * Optional feature ID this spend limit applies to.
      */
-    reset?: PreviewAttachAddItemReset | undefined;
+    featureId?: string | undefined;
     /**
-     * Pricing for usage beyond included units. Omit for free features.
+     * Whether the overage spend limit is enabled.
      */
-    price?: PreviewAttachAddItemPrice | undefined;
+    enabled?: boolean | undefined;
     /**
-     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
      */
-    proration?: PreviewAttachAddItemProration | undefined;
+    limitType?: PreviewAttachLimitType | undefined;
     /**
-     * Rollover config for unused units. If set, unused included units carry over.
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
-    rollover?: PreviewAttachAddItemRollover | undefined;
-};
-/**
- * Match items with this billing method (prepaid or usage_based).
- */
-declare const PreviewAttachRemoveItemBillingMethod: {
-    readonly Prepaid: "prepaid";
-    readonly UsageBased: "usage_based";
+    overageLimit?: number | undefined;
 };
 /**
- * Match items with this billing method (prepaid or usage_based).
+ * Interval for the cap, aligned to the customer's billing cycle.
  */
-type PreviewAttachRemoveItemBillingMethod = ClosedEnum<typeof PreviewAttachRemoveItemBillingMethod>;
-declare const PreviewAttachIntervalRemoveItemEnum2: {
-    readonly OneOff: "one_off";
-    readonly Minute: "minute";
-    readonly Hour: "hour";
+declare const PreviewAttachUsageLimitInterval: {
     readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
-    readonly Quarter: "quarter";
-    readonly SemiAnnual: "semi_annual";
-    readonly Year: "year";
-};
-type PreviewAttachIntervalRemoveItemEnum2 = ClosedEnum<typeof PreviewAttachIntervalRemoveItemEnum2>;
-declare const PreviewAttachIntervalRemoveItemEnum1: {
-    readonly OneOff: "one_off";
-    readonly Week: "week";
-    readonly Month: "month";
-    readonly Quarter: "quarter";
-    readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-type PreviewAttachIntervalRemoveItemEnum1 = ClosedEnum<typeof PreviewAttachIntervalRemoveItemEnum1>;
 /**
- * Filter for matching plan items. All provided fields must match (AND).
+ * Interval for the cap, aligned to the customer's billing cycle.
  */
-type PreviewAttachPlanItemFilter = {
+type PreviewAttachUsageLimitInterval = ClosedEnum<typeof PreviewAttachUsageLimitInterval>;
+type PreviewAttachUsageLimit = {
     /**
-     * Match items linked to this feature.
+     * The feature this usage limit applies to.
      */
-    featureId?: string | undefined;
+    featureId: string;
     /**
-     * Match items with this billing method (prepaid or usage_based).
+     * Whether this usage limit is enabled.
      */
-    billingMethod?: PreviewAttachRemoveItemBillingMethod | undefined;
+    enabled?: boolean | undefined;
     /**
-     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     * Maximum units allowed per interval.
      */
-    interval?: PreviewAttachIntervalRemoveItemEnum1 | PreviewAttachIntervalRemoveItemEnum2 | undefined;
+    limit: number;
     /**
-     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     * Interval for the cap, aligned to the customer's billing cycle.
      */
-    intervalCount?: number | undefined;
+    interval: PreviewAttachUsageLimitInterval;
 };
 /**
- * Unit of time for the trial ('day', 'month', 'year').
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
-declare const PreviewAttachDurationType: {
-    readonly Day: "day";
-    readonly Month: "month";
-    readonly Year: "year";
+declare const PreviewAttachThresholdType: {
+    readonly Usage: "usage";
+    readonly UsagePercentage: "usage_percentage";
+    readonly Remaining: "remaining";
+    readonly RemainingPercentage: "remaining_percentage";
 };
 /**
- * Unit of time for the trial ('day', 'month', 'year').
- */
-type PreviewAttachDurationType = ClosedEnum<typeof PreviewAttachDurationType>;
-/**
- * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
-declare const PreviewAttachOnEnd: {
-    readonly Bill: "bill";
-    readonly Revert: "revert";
+type PreviewAttachThresholdType = ClosedEnum<typeof PreviewAttachThresholdType>;
+type PreviewAttachUsageAlert = {
+    /**
+     * The feature ID this alert applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether this usage alert is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100).
+     */
+    threshold: number;
+    /**
+     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+     */
+    thresholdType: PreviewAttachThresholdType;
+    /**
+     * Optional user-defined label to distinguish multiple alerts on the same feature.
+     */
+    name?: string | undefined;
+};
+type PreviewAttachOverageAllowed = {
+    /**
+     * The feature ID this overage allowed control applies to.
+     */
+    featureId: string;
+    /**
+     * Whether overage is allowed for this feature.
+     */
+    enabled?: boolean | undefined;
 };
 /**
- * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
- */
-type PreviewAttachOnEnd = ClosedEnum<typeof PreviewAttachOnEnd>;
-/**
- * Free trial configuration for a plan.
+ * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
  */
-type PreviewAttachFreeTrialParams = {
+type PreviewAttachBillingControls = {
     /**
-     * Number of duration_type periods the trial lasts.
+     * List of auto top-up configurations per feature.
      */
-    durationLength: number;
+    autoTopups?: Array<PreviewAttachAutoTopup> | undefined;
     /**
-     * Unit of time for the trial ('day', 'month', 'year').
+     * List of overage spend limits per feature (caps overage spend).
      */
-    durationType?: PreviewAttachDurationType | undefined;
+    spendLimits?: Array<PreviewAttachSpendLimit> | undefined;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * List of hard usage caps per feature (max units per interval).
      */
-    cardRequired?: boolean | undefined;
+    usageLimits?: Array<PreviewAttachUsageLimit> | undefined;
     /**
-     * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+     * List of usage alert configurations per feature.
      */
-    onEnd?: PreviewAttachOnEnd | undefined;
+    usageAlerts?: Array<PreviewAttachUsageAlert> | undefined;
+    /**
+     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
+     */
+    overageAllowed?: Array<PreviewAttachOverageAllowed> | undefined;
 };
 /**
  * Customize the plan to attach. Can override the price, items, free trial, or a combination.
@@ -4944,6 +5947,10 @@ type PreviewAttachCustomize = {
      * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
      */
     freeTrial?: PreviewAttachFreeTrialParams | null | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: PreviewAttachBillingControls | undefined;
 };
 /**
  * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
@@ -5896,6 +6903,17 @@ declare const PreviewMultiAttachRedirectMode: {
  * Controls when to return a checkout URL. 'always' returns a URL even if payment succeeds, 'if_required' only when payment action is needed, 'never' disables redirects.
  */
 type PreviewMultiAttachRedirectMode = ClosedEnum<typeof PreviewMultiAttachRedirectMode>;
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const PreviewMultiAttachLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type PreviewMultiAttachLimitType = ClosedEnum<typeof PreviewMultiAttachLimitType>;
 type PreviewMultiAttachSpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
@@ -5906,7 +6924,11 @@ type PreviewMultiAttachSpendLimit = {
      */
     enabled?: boolean | undefined;
     /**
-     * Maximum allowed overage spend for the target feature.
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: PreviewMultiAttachLimitType | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     overageLimit?: number | undefined;
 };
@@ -5928,6 +6950,10 @@ type PreviewMultiAttachUsageLimit = {
      * The feature this usage limit applies to.
      */
     featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled?: boolean | undefined;
     /**
      * Maximum units allowed per interval.
      */
@@ -6907,71 +7933,257 @@ declare const PreviewUpdateIntervalRemoveItemEnum1: {
     readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-type PreviewUpdateIntervalRemoveItemEnum1 = ClosedEnum<typeof PreviewUpdateIntervalRemoveItemEnum1>;
+type PreviewUpdateIntervalRemoveItemEnum1 = ClosedEnum<typeof PreviewUpdateIntervalRemoveItemEnum1>;
+/**
+ * Filter for matching plan items. All provided fields must match (AND).
+ */
+type PreviewUpdatePlanItemFilter = {
+    /**
+     * Match items linked to this feature.
+     */
+    featureId?: string | undefined;
+    /**
+     * Match items with this billing method (prepaid or usage_based).
+     */
+    billingMethod?: PreviewUpdateRemoveItemBillingMethod | undefined;
+    /**
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     */
+    interval?: PreviewUpdateIntervalRemoveItemEnum1 | PreviewUpdateIntervalRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     */
+    intervalCount?: number | undefined;
+};
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+declare const PreviewUpdateDurationType: {
+    readonly Day: "day";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+type PreviewUpdateDurationType = ClosedEnum<typeof PreviewUpdateDurationType>;
+/**
+ * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ */
+declare const PreviewUpdateOnEnd: {
+    readonly Bill: "bill";
+    readonly Revert: "revert";
+};
+/**
+ * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ */
+type PreviewUpdateOnEnd = ClosedEnum<typeof PreviewUpdateOnEnd>;
+/**
+ * Free trial configuration for a plan.
+ */
+type PreviewUpdateFreeTrialParams = {
+    /**
+     * Number of duration_type periods the trial lasts.
+     */
+    durationLength: number;
+    /**
+     * Unit of time for the trial ('day', 'month', 'year').
+     */
+    durationType?: PreviewUpdateDurationType | undefined;
+    /**
+     * If true, payment method required to start trial. Customer is charged after trial ends.
+     */
+    cardRequired?: boolean | undefined;
+    /**
+     * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+     */
+    onEnd?: PreviewUpdateOnEnd | undefined;
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+declare const PreviewUpdatePurchaseLimitInterval: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+type PreviewUpdatePurchaseLimitInterval = ClosedEnum<typeof PreviewUpdatePurchaseLimitInterval>;
+/**
+ * Optional rate limit to cap how often auto top-ups occur.
+ */
+type PreviewUpdatePurchaseLimit = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: PreviewUpdatePurchaseLimitInterval;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+type PreviewUpdateAutoTopup = {
+    /**
+     * The ID of the feature (credit balance) to auto top-up.
+     */
+    featureId: string;
+    /**
+     * Whether auto top-up is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * When the balance drops below this threshold, an auto top-up will be purchased.
+     */
+    threshold: number;
+    /**
+     * Amount of credits to add per auto top-up.
+     */
+    quantity: number;
+    /**
+     * Optional rate limit to cap how often auto top-ups occur.
+     */
+    purchaseLimit?: PreviewUpdatePurchaseLimit | undefined;
+    /**
+     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     */
+    invoiceMode?: boolean | undefined;
+};
 /**
- * Filter for matching plan items. All provided fields must match (AND).
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
-type PreviewUpdatePlanItemFilter = {
+declare const PreviewUpdateLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type PreviewUpdateLimitType = ClosedEnum<typeof PreviewUpdateLimitType>;
+type PreviewUpdateSpendLimit = {
     /**
-     * Match items linked to this feature.
+     * Optional feature ID this spend limit applies to.
      */
     featureId?: string | undefined;
     /**
-     * Match items with this billing method (prepaid or usage_based).
+     * Whether the overage spend limit is enabled.
      */
-    billingMethod?: PreviewUpdateRemoveItemBillingMethod | undefined;
+    enabled?: boolean | undefined;
     /**
-     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
      */
-    interval?: PreviewUpdateIntervalRemoveItemEnum1 | PreviewUpdateIntervalRemoveItemEnum2 | undefined;
+    limitType?: PreviewUpdateLimitType | undefined;
     /**
-     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
-    intervalCount?: number | undefined;
+    overageLimit?: number | undefined;
 };
 /**
- * Unit of time for the trial ('day', 'month', 'year').
+ * Interval for the cap, aligned to the customer's billing cycle.
  */
-declare const PreviewUpdateDurationType: {
+declare const PreviewUpdateUsageLimitInterval: {
     readonly Day: "day";
+    readonly Week: "week";
     readonly Month: "month";
     readonly Year: "year";
 };
 /**
- * Unit of time for the trial ('day', 'month', 'year').
+ * Interval for the cap, aligned to the customer's billing cycle.
  */
-type PreviewUpdateDurationType = ClosedEnum<typeof PreviewUpdateDurationType>;
+type PreviewUpdateUsageLimitInterval = ClosedEnum<typeof PreviewUpdateUsageLimitInterval>;
+type PreviewUpdateUsageLimit = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: PreviewUpdateUsageLimitInterval;
+};
 /**
- * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
-declare const PreviewUpdateOnEnd: {
-    readonly Bill: "bill";
-    readonly Revert: "revert";
+declare const PreviewUpdateThresholdType: {
+    readonly Usage: "usage";
+    readonly UsagePercentage: "usage_percentage";
+    readonly Remaining: "remaining";
+    readonly RemainingPercentage: "remaining_percentage";
 };
 /**
- * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
-type PreviewUpdateOnEnd = ClosedEnum<typeof PreviewUpdateOnEnd>;
+type PreviewUpdateThresholdType = ClosedEnum<typeof PreviewUpdateThresholdType>;
+type PreviewUpdateUsageAlert = {
+    /**
+     * The feature ID this alert applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether this usage alert is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100).
+     */
+    threshold: number;
+    /**
+     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+     */
+    thresholdType: PreviewUpdateThresholdType;
+    /**
+     * Optional user-defined label to distinguish multiple alerts on the same feature.
+     */
+    name?: string | undefined;
+};
+type PreviewUpdateOverageAllowed = {
+    /**
+     * The feature ID this overage allowed control applies to.
+     */
+    featureId: string;
+    /**
+     * Whether overage is allowed for this feature.
+     */
+    enabled?: boolean | undefined;
+};
 /**
- * Free trial configuration for a plan.
+ * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
  */
-type PreviewUpdateFreeTrialParams = {
+type PreviewUpdateBillingControls = {
     /**
-     * Number of duration_type periods the trial lasts.
+     * List of auto top-up configurations per feature.
      */
-    durationLength: number;
+    autoTopups?: Array<PreviewUpdateAutoTopup> | undefined;
     /**
-     * Unit of time for the trial ('day', 'month', 'year').
+     * List of overage spend limits per feature (caps overage spend).
      */
-    durationType?: PreviewUpdateDurationType | undefined;
+    spendLimits?: Array<PreviewUpdateSpendLimit> | undefined;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * List of hard usage caps per feature (max units per interval).
      */
-    cardRequired?: boolean | undefined;
+    usageLimits?: Array<PreviewUpdateUsageLimit> | undefined;
     /**
-     * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+     * List of usage alert configurations per feature.
      */
-    onEnd?: PreviewUpdateOnEnd | undefined;
+    usageAlerts?: Array<PreviewUpdateUsageAlert> | undefined;
+    /**
+     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
+     */
+    overageAllowed?: Array<PreviewUpdateOverageAllowed> | undefined;
 };
 /**
  * Customize the plan to attach. Can override the price, items, free trial, or a combination.
@@ -6997,6 +8209,10 @@ type PreviewUpdateCustomize = {
      * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
      */
     freeTrial?: PreviewUpdateFreeTrialParams | null | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: PreviewUpdateBillingControls | undefined;
 };
 /**
  * Invoice mode creates a draft or open invoice and sends it to the customer, instead of charging their card immediately. This uses Stripe's send_invoice collection method.
@@ -8090,6 +9306,192 @@ type SetupPaymentFreeTrialParams = {
      */
     onEnd?: SetupPaymentOnEnd | undefined;
 };
+/**
+ * The time interval for the purchase limit window.
+ */
+declare const SetupPaymentPurchaseLimitInterval: {
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+type SetupPaymentPurchaseLimitInterval = ClosedEnum<typeof SetupPaymentPurchaseLimitInterval>;
+/**
+ * Optional rate limit to cap how often auto top-ups occur.
+ */
+type SetupPaymentPurchaseLimit = {
+    /**
+     * The time interval for the purchase limit window.
+     */
+    interval: SetupPaymentPurchaseLimitInterval;
+    /**
+     * Number of intervals in the purchase limit window.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
+};
+type SetupPaymentAutoTopup = {
+    /**
+     * The ID of the feature (credit balance) to auto top-up.
+     */
+    featureId: string;
+    /**
+     * Whether auto top-up is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * When the balance drops below this threshold, an auto top-up will be purchased.
+     */
+    threshold: number;
+    /**
+     * Amount of credits to add per auto top-up.
+     */
+    quantity: number;
+    /**
+     * Optional rate limit to cap how often auto top-ups occur.
+     */
+    purchaseLimit?: SetupPaymentPurchaseLimit | undefined;
+    /**
+     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     */
+    invoiceMode?: boolean | undefined;
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+declare const SetupPaymentLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
+};
+/**
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ */
+type SetupPaymentLimitType = ClosedEnum<typeof SetupPaymentLimitType>;
+type SetupPaymentSpendLimit = {
+    /**
+     * Optional feature ID this spend limit applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether the overage spend limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     */
+    limitType?: SetupPaymentLimitType | undefined;
+    /**
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
+     */
+    overageLimit?: number | undefined;
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+declare const SetupPaymentUsageLimitInterval: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+type SetupPaymentUsageLimitInterval = ClosedEnum<typeof SetupPaymentUsageLimitInterval>;
+type SetupPaymentUsageLimit = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Whether this usage limit is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: SetupPaymentUsageLimitInterval;
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+declare const SetupPaymentThresholdType: {
+    readonly Usage: "usage";
+    readonly UsagePercentage: "usage_percentage";
+    readonly Remaining: "remaining";
+    readonly RemainingPercentage: "remaining_percentage";
+};
+/**
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ */
+type SetupPaymentThresholdType = ClosedEnum<typeof SetupPaymentThresholdType>;
+type SetupPaymentUsageAlert = {
+    /**
+     * The feature ID this alert applies to.
+     */
+    featureId?: string | undefined;
+    /**
+     * Whether this usage alert is enabled.
+     */
+    enabled?: boolean | undefined;
+    /**
+     * The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100).
+     */
+    threshold: number;
+    /**
+     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+     */
+    thresholdType: SetupPaymentThresholdType;
+    /**
+     * Optional user-defined label to distinguish multiple alerts on the same feature.
+     */
+    name?: string | undefined;
+};
+type SetupPaymentOverageAllowed = {
+    /**
+     * The feature ID this overage allowed control applies to.
+     */
+    featureId: string;
+    /**
+     * Whether overage is allowed for this feature.
+     */
+    enabled?: boolean | undefined;
+};
+/**
+ * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+ */
+type SetupPaymentBillingControls = {
+    /**
+     * List of auto top-up configurations per feature.
+     */
+    autoTopups?: Array<SetupPaymentAutoTopup> | undefined;
+    /**
+     * List of overage spend limits per feature (caps overage spend).
+     */
+    spendLimits?: Array<SetupPaymentSpendLimit> | undefined;
+    /**
+     * List of hard usage caps per feature (max units per interval).
+     */
+    usageLimits?: Array<SetupPaymentUsageLimit> | undefined;
+    /**
+     * List of usage alert configurations per feature.
+     */
+    usageAlerts?: Array<SetupPaymentUsageAlert> | undefined;
+    /**
+     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
+     */
+    overageAllowed?: Array<SetupPaymentOverageAllowed> | undefined;
+};
 /**
  * Customize the plan to attach. Can override the price, items, free trial, or a combination.
  */
@@ -8114,6 +9516,10 @@ type SetupPaymentCustomize = {
      * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
      */
     freeTrial?: SetupPaymentFreeTrialParams | null | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: SetupPaymentBillingControls | undefined;
 };
 /**
  * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
@@ -8343,4 +9749,4 @@ type ClientSetupPaymentParams = Omit<SetupPaymentParams, ProtectedFields> & {
 /** Get entity params without protected fields (for frontend use) */
 type ClientGetEntityParams = Prettify<Omit<GetEntityParams, ProtectedFields>>;
 
-export type { AttachResponse as A, BillingUpdateResponse as B, ClientAggregateEventsParams as C, GetEntityResponse as G, ListEventsResponse as L, MultiAttachResponse as M, OpenCustomerPortalResponse as O, ProtectedFields as P, RedeemReferralCodeResponse as R, SetupPaymentResponse as S, Total as T, ClientAttachParams as a, ClientCreateReferralCodeParams as b, ClientGetEntityParams as c, ClientGetOrCreateCustomerParams as d, ClientListEventsParams as e, ClientMultiAttachParams as f, ClientOpenCustomerPortalParams as g, ClientPreviewAttachParams as h, ClientPreviewMultiAttachParams as i, ClientPreviewUpdateSubscriptionParams as j, ClientRedeemReferralCodeParams as k, ClientSetupPaymentParams as l, ClientUpdateSubscriptionParams as m, ClientCheckParams as n, CheckResponse as o, PreviewAttachResponse as p, PreviewUpdateResponse as q, PreviewMultiAttachResponse as r, AggregateEventsResponse as s, AggregateEventsList as t, ListEventsList as u, ClientListPlansParams as v, CreateReferralCodeResponse as w };
+export type { AttachResponse as A, BillingUpdateResponse as B, ClientAggregateEventsParams as C, GetEntityResponse as G, ListEventsResponse as L, MultiAttachResponse as M, OpenCustomerPortalResponse as O, ProtectedFields as P, RedeemReferralCodeResponse as R, SetupPaymentResponse as S, Total as T, ClientAttachParams as a, ClientCreateReferralCodeParams as b, ClientGetEntityParams as c, ClientGetOrCreateCustomerParams as d, ClientListEventsParams as e, ClientMultiAttachParams as f, ClientOpenCustomerPortalParams as g, ClientPreviewAttachParams as h, ClientPreviewMultiAttachParams as i, ClientPreviewUpdateSubscriptionParams as j, ClientRedeemReferralCodeParams as k, ClientSetupPaymentParams as l, ClientUpdateSubscriptionParams as m, ClientCheckParams as n, CheckResponse as o, PreviewAttachResponse as p, PreviewUpdateResponse as q, PreviewMultiAttachResponse as r, CreateReferralCodeResponse as s, ClientListPlansParams as t, AggregateEventsResponse as u, AggregateEventsList as v, ListEventsList as w };