autumn-js 1.2.53 → 1.2.55

package/dist/react/{list-plans-op-jsAtkFHJ.d.ts → list-plans-op-ZRs2lBAB.d.mts}

@@ -1,4 +1,4 @@
-import { O as OpenEnum } from './plan-DEGPMYmh.js';
+import { O as OpenEnum } from './plan-C96AilzT.mjs';
 
 type ListPlansAdditionalCurrency = {
     /**
@@ -40,7 +40,7 @@ type ListPlansPriceDisplay = {
 };
 type ListPlansPrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -381,645 +381,654 @@ declare const ListPlansEnv: {
  */
 type ListPlansEnv = OpenEnum<typeof ListPlansEnv>;
 /**
- * Billing interval (e.g. 'month', 'year').
+ * Miscellaneous plan-level configuration flags.
  */
-declare const ListPlansPriceVariantDetailsInterval: {
-    readonly OneOff: "one_off";
+type ListPlansConfig = {
+    /**
+     * If true, entitlements attached to this plan will still reset on schedule even when the customer's product is in a past_due state.
+     */
+    ignorePastDue: boolean;
+};
+/**
+ * The time interval for the purchase limit window.
+ */
+declare const ListPlansPurchaseLimitInterval: {
+    readonly Hour: "hour";
+    readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
-    readonly Quarter: "quarter";
-    readonly SemiAnnual: "semi_annual";
-    readonly Year: "year";
 };
 /**
- * Billing interval (e.g. 'month', 'year').
+ * The time interval for the purchase limit window.
  */
-type ListPlansPriceVariantDetailsInterval = OpenEnum<typeof ListPlansPriceVariantDetailsInterval>;
-type ListPlansVariantDetailsAdditionalCurrency = {
+type ListPlansPurchaseLimitInterval = OpenEnum<typeof ListPlansPurchaseLimitInterval>;
+/**
+ * Optional rate limit to cap how often auto top-ups occur.
+ */
+type ListPlansPurchaseLimit = {
     /**
-     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     * The time interval for the purchase limit window.
      */
-    currency: string;
+    interval: ListPlansPurchaseLimitInterval;
     /**
-     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     * Number of intervals in the purchase limit window.
      */
-    amount: number;
+    intervalCount: number;
+    /**
+     * Maximum number of auto top-ups allowed within the interval.
+     */
+    limit: number;
 };
-/**
- * Base price configuration for a plan.
- */
-type ListPlansBasePrice = {
+type ListPlansAutoTopup = {
     /**
-     * Base price amount for the plan.
+     * The ID of the feature (credit balance) to auto top-up.
      */
-    amount: number;
+    featureId: string;
     /**
-     * Billing interval (e.g. 'month', 'year').
+     * Whether auto top-up is enabled.
      */
-    interval: ListPlansPriceVariantDetailsInterval;
+    enabled: boolean;
     /**
-     * Number of intervals per billing cycle. Defaults to 1.
+     * When the balance drops below this threshold, an auto top-up will be purchased.
      */
-    intervalCount?: number | undefined;
+    threshold: number;
     /**
-     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     * Amount of credits to add per auto top-up.
      */
-    additionalCurrencies?: Array<ListPlansVariantDetailsAdditionalCurrency> | undefined;
+    quantity: number;
+    /**
+     * Optional rate limit to cap how often auto top-ups occur.
+     */
+    purchaseLimit?: ListPlansPurchaseLimit | undefined;
+    /**
+     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     */
+    invoiceMode?: boolean | undefined;
 };
 /**
- * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
-declare const ListPlansAddItemResetInterval: {
-    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";
+declare const ListPlansLimitType: {
+    readonly Absolute: "absolute";
+    readonly UsagePercentage: "usage_percentage";
 };
 /**
- * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
- */
-type ListPlansAddItemResetInterval = OpenEnum<typeof ListPlansAddItemResetInterval>;
-/**
- * Reset configuration for consumable features. Omit for non-consumable features like seats.
+ * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
-type ListPlansVariantDetailsReset = {
+type ListPlansLimitType = OpenEnum<typeof ListPlansLimitType>;
+type ListPlansSpendLimit = {
     /**
-     * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
+     * Optional feature ID this spend limit applies to.
      */
-    interval: ListPlansAddItemResetInterval;
+    featureId?: string | undefined;
     /**
-     * Number of intervals between resets. Defaults to 1.
+     * Whether the overage spend limit is enabled.
      */
-    intervalCount?: number | undefined;
-};
-type ListPlansAddItemAdditionalCurrency = {
+    enabled: boolean;
     /**
-     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
      */
-    currency: string;
+    limitType?: ListPlansLimitType | undefined;
     /**
-     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
-    amount: number;
-};
-type ListPlansVariantDetailsTier = {
-    to?: any | undefined;
-    amount: number;
-    flatAmount?: number | undefined;
-    additionalCurrencies?: Array<any | null> | undefined;
-};
-declare const ListPlansVariantDetailsTierBehavior: {
-    readonly Graduated: "graduated";
-    readonly Volume: "volume";
+    overageLimit?: number | undefined;
+    /**
+     * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
+     */
+    skipOverageBilling?: boolean | undefined;
 };
-type ListPlansVariantDetailsTierBehavior = OpenEnum<typeof ListPlansVariantDetailsTierBehavior>;
 /**
- * Billing interval. For consumable features, should match reset.interval.
+ * Interval for the cap, aligned to the customer's billing cycle.
  */
-declare const ListPlansAddItemPriceInterval: {
-    readonly OneOff: "one_off";
+declare const ListPlansUsageLimitInterval: {
+    readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
-    readonly Quarter: "quarter";
-    readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
 /**
- * Billing interval. For consumable features, should match reset.interval.
+ * Interval for the cap, aligned to the customer's billing cycle.
  */
-type ListPlansAddItemPriceInterval = OpenEnum<typeof ListPlansAddItemPriceInterval>;
+type ListPlansUsageLimitInterval = OpenEnum<typeof ListPlansUsageLimitInterval>;
 /**
- * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+ * Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.
  */
-declare const ListPlansAddItemBillingMethod: {
-    readonly Prepaid: "prepaid";
-    readonly UsageBased: "usage_based";
+declare const ListPlansAnchor: {
+    readonly BillingCycle: "billing_cycle";
+    readonly Utc: "utc";
 };
 /**
- * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+ * Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.
  */
-type ListPlansAddItemBillingMethod = OpenEnum<typeof ListPlansAddItemBillingMethod>;
+type ListPlansAnchor = OpenEnum<typeof ListPlansAnchor>;
 /**
- * Pricing for usage beyond included units. Omit for free features.
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
  */
-type ListPlansVariantDetailsPrice = {
-    /**
-     * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
-     */
-    amount?: number | undefined;
-    /**
-     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
-     */
-    additionalCurrencies?: Array<ListPlansAddItemAdditionalCurrency> | undefined;
+type ListPlansFilter = {
+    properties: {
+        [k: string]: string;
+    };
+};
+type ListPlansUsageLimit = {
     /**
-     * Tiered pricing.  Either 'amount' or 'tiers' is required.
+     * The feature this usage limit applies to.
      */
-    tiers?: Array<ListPlansVariantDetailsTier> | undefined;
-    tierBehavior?: ListPlansVariantDetailsTierBehavior | undefined;
+    featureId: string;
     /**
-     * Billing interval. For consumable features, should match reset.interval.
+     * Whether this usage limit is enabled.
      */
-    interval: ListPlansAddItemPriceInterval;
+    enabled: boolean;
     /**
-     * Number of intervals per billing cycle. Defaults to 1.
+     * Maximum units allowed per interval.
      */
-    intervalCount: number;
+    limit: number;
     /**
-     * Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
+     * Interval for the cap, aligned to the customer's billing cycle.
      */
-    billingUnits: number;
+    interval: ListPlansUsageLimitInterval;
     /**
-     * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+     * Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.
      */
-    billingMethod: ListPlansAddItemBillingMethod;
+    anchor?: ListPlansAnchor | undefined;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
      */
-    maxPurchase?: number | null | undefined;
-};
-/**
- * Billing behavior when quantity increases mid-cycle.
- */
-declare const ListPlansOnIncrease: {
-    readonly BillImmediately: "bill_immediately";
-    readonly ProrateImmediately: "prorate_immediately";
-    readonly ProrateNextCycle: "prorate_next_cycle";
-    readonly BillNextCycle: "bill_next_cycle";
+    filter?: ListPlansFilter | undefined;
 };
 /**
- * Billing behavior when quantity increases mid-cycle.
- */
-type ListPlansOnIncrease = OpenEnum<typeof ListPlansOnIncrease>;
-/**
- * Credit behavior when quantity decreases mid-cycle.
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
-declare const ListPlansOnDecrease: {
-    readonly Prorate: "prorate";
-    readonly ProrateImmediately: "prorate_immediately";
-    readonly ProrateNextCycle: "prorate_next_cycle";
-    readonly None: "none";
-    readonly NoProrations: "no_prorations";
+declare const ListPlansThresholdType: {
+    readonly Usage: "usage";
+    readonly UsagePercentage: "usage_percentage";
+    readonly Remaining: "remaining";
+    readonly RemainingPercentage: "remaining_percentage";
 };
 /**
- * Credit behavior when quantity decreases mid-cycle.
- */
-type ListPlansOnDecrease = OpenEnum<typeof ListPlansOnDecrease>;
-/**
- * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+ * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
-type ListPlansProration = {
-    /**
-     * Billing behavior when quantity increases mid-cycle.
-     */
-    onIncrease: ListPlansOnIncrease;
+type ListPlansThresholdType = OpenEnum<typeof ListPlansThresholdType>;
+type ListPlansUsageAlert = {
     /**
-     * Credit behavior when quantity decreases mid-cycle.
+     * The feature ID this alert applies to.
      */
-    onDecrease: ListPlansOnDecrease;
-};
-/**
- * When rolled over units expire.
- */
-declare const ListPlansVariantDetailsExpiryDurationType: {
-    readonly Month: "month";
-    readonly Forever: "forever";
-};
-/**
- * When rolled over units expire.
- */
-type ListPlansVariantDetailsExpiryDurationType = OpenEnum<typeof ListPlansVariantDetailsExpiryDurationType>;
-/**
- * Rollover config for unused units. If set, unused included units carry over.
- */
-type ListPlansVariantDetailsRollover = {
+    featureId?: string | undefined;
     /**
-     * Max rollover units. Omit for unlimited rollover.
+     * Whether this usage alert is enabled.
      */
-    max?: number | undefined;
+    enabled: boolean;
     /**
-     * Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
+     * 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).
      */
-    maxPercentage?: number | undefined;
+    threshold: number;
     /**
-     * When rolled over units expire.
+     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
      */
-    expiryDurationType: ListPlansVariantDetailsExpiryDurationType;
+    thresholdType: ListPlansThresholdType;
     /**
-     * Number of periods before expiry.
+     * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
-    expiryDurationLength?: number | undefined;
+    name?: string | undefined;
 };
-/**
- * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
- */
-type ListPlansPlanItem = {
+type ListPlansOverageAllowed = {
     /**
-     * The ID of the feature to configure.
+     * The feature ID this overage allowed control applies to.
      */
     featureId: string;
     /**
-     * Number of free units included. Balance resets to this each interval for consumable features.
-     */
-    included?: number | undefined;
-    /**
-     * If true, customer has unlimited access to this feature.
+     * Whether overage is allowed for this feature.
      */
-    unlimited?: boolean | undefined;
+    enabled: boolean;
+};
+/**
+ * Plan-level billing controls used as customer defaults.
+ */
+type ListPlansBillingControls = {
     /**
-     * Whether entity-level grants contribute to a shared customer balance.
+     * List of auto top-up configurations per feature.
      */
-    pooled: boolean;
+    autoTopups?: Array<ListPlansAutoTopup> | undefined;
     /**
-     * Reset configuration for consumable features. Omit for non-consumable features like seats.
+     * List of overage spend limits per feature (caps overage spend).
      */
-    reset?: ListPlansVariantDetailsReset | undefined;
+    spendLimits?: Array<ListPlansSpendLimit> | undefined;
     /**
-     * Pricing for usage beyond included units. Omit for free features.
+     * List of hard usage caps per feature (max units per interval).
      */
-    price?: ListPlansVariantDetailsPrice | undefined;
+    usageLimits?: Array<ListPlansUsageLimit> | undefined;
     /**
-     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+     * List of usage alert configurations per feature.
      */
-    proration?: ListPlansProration | undefined;
+    usageAlerts?: Array<ListPlansUsageAlert> | undefined;
     /**
-     * Rollover config for unused units. If set, unused included units carry over.
+     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
      */
-    rollover?: ListPlansVariantDetailsRollover | undefined;
+    overageAllowed?: Array<ListPlansOverageAllowed> | undefined;
 };
 /**
- * Match items with this billing method (prepaid or usage_based).
+ * The customer's current status with this plan. 'active' if attached, 'scheduled' if pending activation.
  */
-declare const ListPlansRemoveItemBillingMethod: {
-    readonly Prepaid: "prepaid";
-    readonly UsageBased: "usage_based";
+declare const ListPlansStatus: {
+    readonly Active: "active";
+    readonly Scheduled: "scheduled";
 };
 /**
- * Match items with this billing method (prepaid or usage_based).
+ * The customer's current status with this plan. 'active' if attached, 'scheduled' if pending activation.
  */
-type ListPlansRemoveItemBillingMethod = OpenEnum<typeof ListPlansRemoveItemBillingMethod>;
-declare const ListPlansIntervalRemoveItemEnum2: {
-    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 ListPlansIntervalRemoveItemEnum2 = OpenEnum<typeof ListPlansIntervalRemoveItemEnum2>;
-declare const ListPlansIntervalRemoveItemEnum1: {
-    readonly OneOff: "one_off";
-    readonly Week: "week";
-    readonly Month: "month";
-    readonly Quarter: "quarter";
-    readonly SemiAnnual: "semi_annual";
-    readonly Year: "year";
+type ListPlansStatus = OpenEnum<typeof ListPlansStatus>;
+/**
+ * The action that would occur if this plan were attached to the customer.
+ */
+declare const ListPlansAttachAction: {
+    readonly Activate: "activate";
+    readonly Upgrade: "upgrade";
+    readonly Downgrade: "downgrade";
+    readonly None: "none";
+    readonly Purchase: "purchase";
 };
-type ListPlansIntervalRemoveItemEnum1 = OpenEnum<typeof ListPlansIntervalRemoveItemEnum1>;
 /**
- * Filter for matching plan items. All provided fields must match (AND).
+ * The action that would occur if this plan were attached to the customer.
  */
-type ListPlansPlanItemFilter = {
+type ListPlansAttachAction = OpenEnum<typeof ListPlansAttachAction>;
+type ListPlansCustomerEligibility = {
     /**
-     * Match items linked to this feature.
+     * Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.
      */
-    featureId?: string | undefined;
+    trialAvailable?: boolean | undefined;
     /**
-     * Match items with this billing method (prepaid or usage_based).
+     * The customer's current status with this plan. 'active' if attached, 'scheduled' if pending activation.
      */
-    billingMethod?: ListPlansRemoveItemBillingMethod | undefined;
+    status?: ListPlansStatus | 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.
+     * Whether the customer's active instance of this plan is set to cancel.
      */
-    interval?: ListPlansIntervalRemoveItemEnum1 | ListPlansIntervalRemoveItemEnum2 | undefined;
+    canceling?: boolean | undefined;
     /**
-     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     * Whether the customer is currently on a free trial of this plan.
      */
-    intervalCount?: number | undefined;
+    trialing?: boolean | undefined;
+    /**
+     * The action that would occur if this plan were attached to the customer.
+     */
+    attachAction: ListPlansAttachAction;
 };
 /**
- * Unit of time for the trial ('day', 'month', 'year').
+ * Billing interval (e.g. 'month', 'year').
  */
-declare const ListPlansVariantDetailsDurationType: {
-    readonly Day: "day";
+declare const ListPlansPriceVariantDetailsInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
     readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
 /**
- * Unit of time for the trial ('day', 'month', 'year').
- */
-type ListPlansVariantDetailsDurationType = OpenEnum<typeof ListPlansVariantDetailsDurationType>;
-/**
- * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ * Billing interval (e.g. 'month', 'year').
  */
-declare const ListPlansVariantDetailsOnEnd: {
-    readonly Bill: "bill";
-    readonly Revert: "revert";
+type ListPlansPriceVariantDetailsInterval = OpenEnum<typeof ListPlansPriceVariantDetailsInterval>;
+type ListPlansVariantDetailsAdditionalCurrency = {
+    /**
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
+     */
+    currency: string;
+    /**
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
+     */
+    amount: number;
 };
 /**
- * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
- */
-type ListPlansVariantDetailsOnEnd = OpenEnum<typeof ListPlansVariantDetailsOnEnd>;
-/**
- * Free trial configuration for a plan.
+ * Base price configuration for a plan.
  */
-type ListPlansFreeTrialParams = {
+type ListPlansBasePrice = {
     /**
-     * Number of duration_type periods the trial lasts.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
-    durationLength: number;
+    amount: number;
     /**
-     * Unit of time for the trial ('day', 'month', 'year').
+     * Billing interval (e.g. 'month', 'year').
      */
-    durationType: ListPlansVariantDetailsDurationType;
+    interval: ListPlansPriceVariantDetailsInterval;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * Number of intervals per billing cycle. Defaults to 1.
      */
-    cardRequired: boolean;
+    intervalCount?: number | undefined;
     /**
-     * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
      */
-    onEnd?: ListPlansVariantDetailsOnEnd | undefined;
+    additionalCurrencies?: Array<ListPlansVariantDetailsAdditionalCurrency> | undefined;
 };
 /**
- * The time interval for the purchase limit window.
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
  */
-declare const ListPlansVariantDetailsPurchaseLimitInterval: {
+declare const ListPlansAddItemResetInterval: {
+    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";
 };
 /**
- * The time interval for the purchase limit window.
+ * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
  */
-type ListPlansVariantDetailsPurchaseLimitInterval = OpenEnum<typeof ListPlansVariantDetailsPurchaseLimitInterval>;
+type ListPlansAddItemResetInterval = OpenEnum<typeof ListPlansAddItemResetInterval>;
 /**
- * Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
+ * Reset configuration for consumable features. Omit for non-consumable features like seats.
  */
-type ListPlansVariantDetailsPurchaseLimit = {
-    /**
-     * The time interval for the purchase limit window.
-     */
-    interval: ListPlansVariantDetailsPurchaseLimitInterval;
-    /**
-     * Number of intervals in the purchase limit window.
-     */
-    intervalCount: number;
+type ListPlansVariantDetailsReset = {
     /**
-     * Maximum number of auto top-ups allowed within the interval.
+     * Interval at which balance resets (e.g. 'month', 'year'). For consumable features only.
      */
-    limit: number;
+    interval: ListPlansAddItemResetInterval;
     /**
-     * Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+     * Number of intervals between resets. Defaults to 1.
      */
-    count?: number | undefined;
+    intervalCount?: number | undefined;
 };
-type ListPlansVariantDetailsAutoTopup = {
-    /**
-     * 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;
+type ListPlansAddItemAdditionalCurrency = {
     /**
-     * Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
+     * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
      */
-    purchaseLimit?: ListPlansVariantDetailsPurchaseLimit | undefined;
+    currency: string;
     /**
-     * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
+     * Price amount in this currency. Set explicitly per currency, not converted from the base amount.
      */
-    invoiceMode?: boolean | undefined;
+    amount: number;
+};
+type ListPlansVariantDetailsTier = {
+    to?: any | undefined;
+    amount: number;
+    flatAmount?: number | undefined;
+    additionalCurrencies?: Array<any | null> | undefined;
+};
+declare const ListPlansVariantDetailsTierBehavior: {
+    readonly Graduated: "graduated";
+    readonly Volume: "volume";
 };
+type ListPlansVariantDetailsTierBehavior = OpenEnum<typeof ListPlansVariantDetailsTierBehavior>;
 /**
- * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-declare const ListPlansVariantDetailsLimitType: {
-    readonly Absolute: "absolute";
-    readonly UsagePercentage: "usage_percentage";
+declare const ListPlansAddItemPriceInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
 };
 /**
- * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+ * Billing interval. For consumable features, should match reset.interval.
  */
-type ListPlansVariantDetailsLimitType = OpenEnum<typeof ListPlansVariantDetailsLimitType>;
-type ListPlansVariantDetailsSpendLimit = {
+type ListPlansAddItemPriceInterval = OpenEnum<typeof ListPlansAddItemPriceInterval>;
+/**
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+ */
+declare const ListPlansAddItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
+ */
+type ListPlansAddItemBillingMethod = OpenEnum<typeof ListPlansAddItemBillingMethod>;
+/**
+ * Pricing for usage beyond included units. Omit for free features.
+ */
+type ListPlansVariantDetailsPrice = {
     /**
-     * Optional feature ID this spend limit applies to.
+     * Price per billing_units after included usage. Either 'amount' or 'tiers' is required.
      */
-    featureId?: string | undefined;
+    amount?: number | undefined;
+    /**
+     * Amounts in additional currencies for this flat price. The base 'amount' is in the org's default currency. Only valid with 'amount', not 'tiers'.
+     */
+    additionalCurrencies?: Array<ListPlansAddItemAdditionalCurrency> | undefined;
+    /**
+     * Tiered pricing.  Either 'amount' or 'tiers' is required.
+     */
+    tiers?: Array<ListPlansVariantDetailsTier> | undefined;
+    tierBehavior?: ListPlansVariantDetailsTierBehavior | undefined;
+    /**
+     * Billing interval. For consumable features, should match reset.interval.
+     */
+    interval: ListPlansAddItemPriceInterval;
     /**
-     * Whether the overage spend limit is enabled.
+     * Number of intervals per billing cycle. Defaults to 1.
      */
-    enabled: boolean;
+    intervalCount: number;
     /**
-     * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
+     * Units per price increment. Usage is rounded UP when billed (e.g. billing_units=100 means 101 rounds to 200).
      */
-    limitType?: ListPlansVariantDetailsLimitType | undefined;
+    billingUnits: number;
     /**
-     * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
+     * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
      */
-    overageLimit?: number | undefined;
+    billingMethod: ListPlansAddItemBillingMethod;
     /**
-     * When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    skipOverageBilling?: boolean | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
- * Interval for the cap, aligned to the customer's billing cycle.
+ * Billing behavior when quantity increases mid-cycle.
  */
-declare const ListPlansVariantDetailsUsageLimitInterval: {
-    readonly Day: "day";
-    readonly Week: "week";
-    readonly Month: "month";
-    readonly Year: "year";
+declare const ListPlansOnIncrease: {
+    readonly BillImmediately: "bill_immediately";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly BillNextCycle: "bill_next_cycle";
 };
 /**
- * Interval for the cap, aligned to the customer's billing cycle.
+ * Billing behavior when quantity increases mid-cycle.
  */
-type ListPlansVariantDetailsUsageLimitInterval = OpenEnum<typeof ListPlansVariantDetailsUsageLimitInterval>;
+type ListPlansOnIncrease = OpenEnum<typeof ListPlansOnIncrease>;
 /**
- * Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.
+ * Credit behavior when quantity decreases mid-cycle.
  */
-declare const ListPlansVariantDetailsAnchor: {
-    readonly BillingCycle: "billing_cycle";
-    readonly Utc: "utc";
+declare const ListPlansOnDecrease: {
+    readonly Prorate: "prorate";
+    readonly ProrateImmediately: "prorate_immediately";
+    readonly ProrateNextCycle: "prorate_next_cycle";
+    readonly None: "none";
+    readonly NoProrations: "no_prorations";
 };
 /**
- * Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.
+ * Credit behavior when quantity decreases mid-cycle.
  */
-type ListPlansVariantDetailsAnchor = OpenEnum<typeof ListPlansVariantDetailsAnchor>;
+type ListPlansOnDecrease = OpenEnum<typeof ListPlansOnDecrease>;
 /**
- * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
  */
-type ListPlansVariantDetailsFilter = {
-    properties: {
-        [k: string]: string;
-    };
-};
-type ListPlansVariantDetailsUsageLimit = {
-    /**
-     * 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: ListPlansVariantDetailsUsageLimitInterval;
+type ListPlansProration = {
     /**
-     * Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.
+     * Billing behavior when quantity increases mid-cycle.
      */
-    anchor?: ListPlansVariantDetailsAnchor | undefined;
+    onIncrease: ListPlansOnIncrease;
     /**
-     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     * Credit behavior when quantity decreases mid-cycle.
      */
-    filter?: ListPlansVariantDetailsFilter | undefined;
+    onDecrease: ListPlansOnDecrease;
 };
 /**
- * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ * When rolled over units expire.
  */
-declare const ListPlansVariantDetailsThresholdType: {
-    readonly Usage: "usage";
-    readonly UsagePercentage: "usage_percentage";
-    readonly Remaining: "remaining";
-    readonly RemainingPercentage: "remaining_percentage";
+declare const ListPlansVariantDetailsExpiryDurationType: {
+    readonly Month: "month";
+    readonly Forever: "forever";
 };
 /**
- * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+ * When rolled over units expire.
  */
-type ListPlansVariantDetailsThresholdType = OpenEnum<typeof ListPlansVariantDetailsThresholdType>;
-type ListPlansVariantDetailsUsageAlert = {
-    /**
-     * The feature ID this alert applies to.
-     */
-    featureId?: string | undefined;
+type ListPlansVariantDetailsExpiryDurationType = OpenEnum<typeof ListPlansVariantDetailsExpiryDurationType>;
+/**
+ * Rollover config for unused units. If set, unused included units carry over.
+ */
+type ListPlansVariantDetailsRollover = {
     /**
-     * Whether this usage alert is enabled.
+     * Max rollover units. Omit for unlimited rollover.
      */
-    enabled: boolean;
+    max?: number | 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).
+     * Maximum rollover as a percentage (0-100) of included + prepaid grant. Mutually exclusive with max.
      */
-    threshold: number;
+    maxPercentage?: number | undefined;
     /**
-     * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
+     * When rolled over units expire.
      */
-    thresholdType: ListPlansVariantDetailsThresholdType;
+    expiryDurationType: ListPlansVariantDetailsExpiryDurationType;
     /**
-     * Optional user-defined label to distinguish multiple alerts on the same feature.
+     * Number of periods before expiry.
      */
-    name?: string | undefined;
+    expiryDurationLength?: number | undefined;
 };
-type ListPlansVariantDetailsOverageAllowed = {
+/**
+ * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
+ */
+type ListPlansPlanItem = {
     /**
-     * The feature ID this overage allowed control applies to.
+     * The ID of the feature to configure.
      */
     featureId: string;
     /**
-     * Whether overage is allowed for this feature.
+     * Number of free units included. Balance resets to this each interval for consumable features.
      */
-    enabled: boolean;
-};
-/**
- * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
- */
-type ListPlansVariantDetailsBillingControls = {
+    included?: number | undefined;
     /**
-     * List of auto top-up configurations per feature.
+     * If true, customer has unlimited access to this feature.
      */
-    autoTopups?: Array<ListPlansVariantDetailsAutoTopup> | undefined;
+    unlimited?: boolean | undefined;
     /**
-     * List of overage spend limits per feature (caps overage spend).
+     * Whether entity-level grants contribute to a shared customer balance.
      */
-    spendLimits?: Array<ListPlansVariantDetailsSpendLimit> | undefined;
+    pooled: boolean;
     /**
-     * List of hard usage caps per feature (max units per interval).
+     * Reset configuration for consumable features. Omit for non-consumable features like seats.
      */
-    usageLimits?: Array<ListPlansVariantDetailsUsageLimit> | undefined;
+    reset?: ListPlansVariantDetailsReset | undefined;
     /**
-     * List of usage alert configurations per feature.
+     * Pricing for usage beyond included units. Omit for free features.
      */
-    usageAlerts?: Array<ListPlansVariantDetailsUsageAlert> | undefined;
+    price?: ListPlansVariantDetailsPrice | undefined;
     /**
-     * List of overage allowed controls per feature. When enabled, usage can exceed balance.
+     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
      */
-    overageAllowed?: Array<ListPlansVariantDetailsOverageAllowed> | undefined;
+    proration?: ListPlansProration | undefined;
+    /**
+     * Rollover config for unused units. If set, unused included units carry over.
+     */
+    rollover?: ListPlansVariantDetailsRollover | undefined;
 };
 /**
- * The customization that transforms the base plan into this variant.
+ * Match items with this billing method (prepaid or usage_based).
  */
-type ListPlansCustomize = {
+declare const ListPlansRemoveItemBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+type ListPlansRemoveItemBillingMethod = OpenEnum<typeof ListPlansRemoveItemBillingMethod>;
+declare const ListPlansIntervalRemoveItemEnum2: {
+    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 ListPlansIntervalRemoveItemEnum2 = OpenEnum<typeof ListPlansIntervalRemoveItemEnum2>;
+declare const ListPlansIntervalRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type ListPlansIntervalRemoveItemEnum1 = OpenEnum<typeof ListPlansIntervalRemoveItemEnum1>;
+/**
+ * Filter for matching plan items. All provided fields must match (AND).
+ */
+type ListPlansPlanItemFilter = {
     /**
-     * Override the base price of the plan. Pass null to remove the base price.
+     * Match items linked to this feature.
      */
-    price?: ListPlansBasePrice | null | undefined;
+    featureId?: string | undefined;
     /**
-     * Items to add to the plan.
+     * Match items with this billing method (prepaid or usage_based).
      */
-    addItems?: Array<ListPlansPlanItem> | undefined;
+    billingMethod?: ListPlansRemoveItemBillingMethod | undefined;
     /**
-     * Filters selecting items to remove from the plan.
+     * 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.
      */
-    removeItems?: Array<ListPlansPlanItemFilter> | undefined;
+    interval?: ListPlansIntervalRemoveItemEnum1 | ListPlansIntervalRemoveItemEnum2 | undefined;
     /**
-     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
      */
-    freeTrial?: ListPlansFreeTrialParams | null | undefined;
+    intervalCount?: number | undefined;
     /**
-     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     * Match items whose grant equals this included usage. Omitted is a wildcard.
      */
-    billingControls?: ListPlansVariantDetailsBillingControls | undefined;
+    included?: number | undefined;
 };
 /**
- * Details about how this variant relates to its latest base plan.
+ * Unit of time for the trial ('day', 'month', 'year').
  */
-type ListPlansVariantDetails = {
+declare const ListPlansVariantDetailsDurationType: {
+    readonly Day: "day";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+type ListPlansVariantDetailsDurationType = OpenEnum<typeof ListPlansVariantDetailsDurationType>;
+/**
+ * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ */
+declare const ListPlansVariantDetailsOnEnd: {
+    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 ListPlansVariantDetailsOnEnd = OpenEnum<typeof ListPlansVariantDetailsOnEnd>;
+/**
+ * Free trial configuration for a plan.
+ */
+type ListPlansFreeTrialParams = {
     /**
-     * The ID of the base plan this variant was derived from.
+     * Number of duration_type periods the trial lasts.
      */
-    basePlanId: string;
+    durationLength: number;
     /**
-     * The customization that transforms the base plan into this variant.
+     * Unit of time for the trial ('day', 'month', 'year').
      */
-    customize?: ListPlansCustomize | undefined;
-};
-/**
- * Miscellaneous plan-level configuration flags.
- */
-type ListPlansConfig = {
+    durationType: ListPlansVariantDetailsDurationType;
+    /**
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
+     */
+    cardRequired: boolean;
     /**
-     * If true, entitlements attached to this plan will still reset on schedule even when the customer's product is in a past_due state.
+     * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
      */
-    ignorePastDue: boolean;
+    onEnd?: ListPlansVariantDetailsOnEnd | undefined;
 };
 /**
  * The time interval for the purchase limit window.
  */
-declare const ListPlansPurchaseLimitInterval: {
+declare const ListPlansVariantDetailsPurchaseLimitInterval: {
     readonly Hour: "hour";
     readonly Day: "day";
     readonly Week: "week";
@@ -1028,15 +1037,15 @@ declare const ListPlansPurchaseLimitInterval: {
 /**
  * The time interval for the purchase limit window.
  */
-type ListPlansPurchaseLimitInterval = OpenEnum<typeof ListPlansPurchaseLimitInterval>;
+type ListPlansVariantDetailsPurchaseLimitInterval = OpenEnum<typeof ListPlansVariantDetailsPurchaseLimitInterval>;
 /**
- * Optional rate limit to cap how often auto top-ups occur.
+ * Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
  */
-type ListPlansPurchaseLimit = {
+type ListPlansVariantDetailsPurchaseLimit = {
     /**
      * The time interval for the purchase limit window.
      */
-    interval: ListPlansPurchaseLimitInterval;
+    interval: ListPlansVariantDetailsPurchaseLimitInterval;
     /**
      * Number of intervals in the purchase limit window.
      */
@@ -1045,8 +1054,12 @@ type ListPlansPurchaseLimit = {
      * Maximum number of auto top-ups allowed within the interval.
      */
     limit: number;
+    /**
+     * Set the current window's consumed auto top-up count. Omit to leave runtime state unchanged.
+     */
+    count?: number | undefined;
 };
-type ListPlansAutoTopup = {
+type ListPlansVariantDetailsAutoTopup = {
     /**
      * The ID of the feature (credit balance) to auto top-up.
      */
@@ -1064,9 +1077,9 @@ type ListPlansAutoTopup = {
      */
     quantity: number;
     /**
-     * Optional rate limit to cap how often auto top-ups occur.
+     * Optional rate limit to cap how often auto top-ups occur. Pass count to set the current window's consumed top-ups.
      */
-    purchaseLimit?: ListPlansPurchaseLimit | undefined;
+    purchaseLimit?: ListPlansVariantDetailsPurchaseLimit | undefined;
     /**
      * When true, auto top-up creates a send_invoice invoice instead of auto-charging.
      */
@@ -1075,15 +1088,15 @@ type ListPlansAutoTopup = {
 /**
  * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
  */
-declare const ListPlansLimitType: {
+declare const ListPlansVariantDetailsLimitType: {
     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 ListPlansLimitType = OpenEnum<typeof ListPlansLimitType>;
-type ListPlansSpendLimit = {
+type ListPlansVariantDetailsLimitType = OpenEnum<typeof ListPlansVariantDetailsLimitType>;
+type ListPlansVariantDetailsSpendLimit = {
     /**
      * Optional feature ID this spend limit applies to.
      */
@@ -1095,7 +1108,7 @@ type ListPlansSpendLimit = {
     /**
      * How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance.
      */
-    limitType?: ListPlansLimitType | undefined;
+    limitType?: ListPlansVariantDetailsLimitType | undefined;
     /**
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
@@ -1108,7 +1121,7 @@ type ListPlansSpendLimit = {
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
  */
-declare const ListPlansUsageLimitInterval: {
+declare const ListPlansVariantDetailsUsageLimitInterval: {
     readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
@@ -1117,27 +1130,27 @@ declare const ListPlansUsageLimitInterval: {
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
  */
-type ListPlansUsageLimitInterval = OpenEnum<typeof ListPlansUsageLimitInterval>;
+type ListPlansVariantDetailsUsageLimitInterval = OpenEnum<typeof ListPlansVariantDetailsUsageLimitInterval>;
 /**
  * Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.
  */
-declare const ListPlansAnchor: {
+declare const ListPlansVariantDetailsAnchor: {
     readonly BillingCycle: "billing_cycle";
     readonly Utc: "utc";
 };
 /**
  * Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.
  */
-type ListPlansAnchor = OpenEnum<typeof ListPlansAnchor>;
+type ListPlansVariantDetailsAnchor = OpenEnum<typeof ListPlansVariantDetailsAnchor>;
 /**
  * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
  */
-type ListPlansFilter = {
+type ListPlansVariantDetailsFilter = {
     properties: {
         [k: string]: string;
     };
 };
-type ListPlansUsageLimit = {
+type ListPlansVariantDetailsUsageLimit = {
     /**
      * The feature this usage limit applies to.
      */
@@ -1153,20 +1166,20 @@ type ListPlansUsageLimit = {
     /**
      * Interval for the cap, aligned to the customer's billing cycle.
      */
-    interval: ListPlansUsageLimitInterval;
+    interval: ListPlansVariantDetailsUsageLimitInterval;
     /**
      * Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.
      */
-    anchor?: ListPlansAnchor | undefined;
+    anchor?: ListPlansVariantDetailsAnchor | undefined;
     /**
      * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
      */
-    filter?: ListPlansFilter | undefined;
+    filter?: ListPlansVariantDetailsFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
-declare const ListPlansThresholdType: {
+declare const ListPlansVariantDetailsThresholdType: {
     readonly Usage: "usage";
     readonly UsagePercentage: "usage_percentage";
     readonly Remaining: "remaining";
@@ -1175,8 +1188,8 @@ declare const ListPlansThresholdType: {
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
-type ListPlansThresholdType = OpenEnum<typeof ListPlansThresholdType>;
-type ListPlansUsageAlert = {
+type ListPlansVariantDetailsThresholdType = OpenEnum<typeof ListPlansVariantDetailsThresholdType>;
+type ListPlansVariantDetailsUsageAlert = {
     /**
      * The feature ID this alert applies to.
      */
@@ -1192,13 +1205,13 @@ type ListPlansUsageAlert = {
     /**
      * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
      */
-    thresholdType: ListPlansThresholdType;
+    thresholdType: ListPlansVariantDetailsThresholdType;
     /**
      * Optional user-defined label to distinguish multiple alerts on the same feature.
      */
     name?: string | undefined;
 };
-type ListPlansOverageAllowed = {
+type ListPlansVariantDetailsOverageAllowed = {
     /**
      * The feature ID this overage allowed control applies to.
      */
@@ -1209,76 +1222,243 @@ type ListPlansOverageAllowed = {
     enabled: boolean;
 };
 /**
- * Plan-level billing controls used as customer defaults.
+ * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
  */
-type ListPlansBillingControls = {
+type ListPlansVariantDetailsBillingControls = {
     /**
      * List of auto top-up configurations per feature.
      */
-    autoTopups?: Array<ListPlansAutoTopup> | undefined;
+    autoTopups?: Array<ListPlansVariantDetailsAutoTopup> | undefined;
     /**
      * List of overage spend limits per feature (caps overage spend).
      */
-    spendLimits?: Array<ListPlansSpendLimit> | undefined;
+    spendLimits?: Array<ListPlansVariantDetailsSpendLimit> | undefined;
     /**
      * List of hard usage caps per feature (max units per interval).
      */
-    usageLimits?: Array<ListPlansUsageLimit> | undefined;
+    usageLimits?: Array<ListPlansVariantDetailsUsageLimit> | undefined;
     /**
      * List of usage alert configurations per feature.
      */
-    usageAlerts?: Array<ListPlansUsageAlert> | undefined;
+    usageAlerts?: Array<ListPlansVariantDetailsUsageAlert> | undefined;
     /**
      * List of overage allowed controls per feature. When enabled, usage can exceed balance.
      */
-    overageAllowed?: Array<ListPlansOverageAllowed> | undefined;
+    overageAllowed?: Array<ListPlansVariantDetailsOverageAllowed> | undefined;
 };
 /**
- * The customer's current status with this plan. 'active' if attached, 'scheduled' if pending activation.
+ * Billing interval (e.g. 'month', 'year').
  */
-declare const ListPlansStatus: {
-    readonly Active: "active";
-    readonly Scheduled: "scheduled";
+declare const ListPlansUpsertLicenseInterval: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
 };
 /**
- * The customer's current status with this plan. 'active' if attached, 'scheduled' if pending activation.
+ * Billing interval (e.g. 'month', 'year').
  */
-type ListPlansStatus = OpenEnum<typeof ListPlansStatus>;
+type ListPlansUpsertLicenseInterval = OpenEnum<typeof ListPlansUpsertLicenseInterval>;
+type ListPlansUpsertLicenseAdditionalCurrency = {
+    currency?: any | undefined;
+    amount?: any | undefined;
+};
 /**
- * The action that would occur if this plan were attached to the customer.
+ * Base price configuration for a plan.
  */
-declare const ListPlansAttachAction: {
-    readonly Activate: "activate";
-    readonly Upgrade: "upgrade";
-    readonly Downgrade: "downgrade";
-    readonly None: "none";
-    readonly Purchase: "purchase";
+type ListPlansUpsertLicenseBasePrice = {
+    /**
+     * Base price amount for the plan, in major currency units (e.g. dollars).
+     */
+    amount: number;
+    /**
+     * Billing interval (e.g. 'month', 'year').
+     */
+    interval: ListPlansUpsertLicenseInterval;
+    /**
+     * Number of intervals per billing cycle. Defaults to 1.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Base price amounts in additional currencies. The base 'amount' is in the org's default currency.
+     */
+    additionalCurrencies?: Array<ListPlansUpsertLicenseAdditionalCurrency> | undefined;
 };
 /**
- * The action that would occur if this plan were attached to the customer.
+ * Reset configuration for consumable features. Omit for non-consumable features like seats.
  */
-type ListPlansAttachAction = OpenEnum<typeof ListPlansAttachAction>;
-type ListPlansCustomerEligibility = {
+type ListPlansUpsertLicenseReset = {
+    interval?: any | undefined;
+    intervalCount?: any | undefined;
+};
+/**
+ * Pricing for usage beyond included units. Omit for free features.
+ */
+type ListPlansUpsertLicensePrice = {
+    stripePriceId?: any | undefined;
+    amount?: any | undefined;
+    additionalCurrencies?: any | undefined;
+    tiers?: any | undefined;
+    tierBehavior?: any | undefined;
+    interval?: any | undefined;
+    intervalCount?: any | undefined;
+    billingUnits?: any | undefined;
+    billingMethod?: any | undefined;
+    maxPurchase?: any | undefined;
+};
+/**
+ * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+ */
+type ListPlansUpsertLicenseProration = {
+    onIncrease?: any | undefined;
+    onDecrease?: any | undefined;
+};
+/**
+ * Rollover config for unused units. If set, unused included units carry over.
+ */
+type ListPlansUpsertLicenseRollover = {
+    max?: any | undefined;
+    maxPercentage?: any | undefined;
+    expiryDurationType?: any | undefined;
+    expiryDurationLength?: any | undefined;
+};
+/**
+ * Configuration for a feature item in a plan, including usage limits, pricing, and rollover settings.
+ */
+type ListPlansUpsertLicensePlanItem = {
     /**
-     * Whether the trial on this plan is available to this customer. For example, if the customer used the trial in the past, this will be false.
+     * The ID of the feature to configure.
      */
-    trialAvailable?: boolean | undefined;
+    featureId: string;
     /**
-     * The customer's current status with this plan. 'active' if attached, 'scheduled' if pending activation.
+     * Number of free units included. Balance resets to this each interval for consumable features.
      */
-    status?: ListPlansStatus | undefined;
+    included?: number | undefined;
     /**
-     * Whether the customer's active instance of this plan is set to cancel.
+     * If true, customer has unlimited access to this feature.
      */
-    canceling?: boolean | undefined;
+    unlimited?: boolean | undefined;
     /**
-     * Whether the customer is currently on a free trial of this plan.
+     * Whether entity-level grants contribute to a shared customer balance.
      */
-    trialing?: boolean | undefined;
+    pooled: boolean;
     /**
-     * The action that would occur if this plan were attached to the customer.
+     * Reset configuration for consumable features. Omit for non-consumable features like seats.
      */
-    attachAction: ListPlansAttachAction;
+    reset?: ListPlansUpsertLicenseReset | undefined;
+    /**
+     * Pricing for usage beyond included units. Omit for free features.
+     */
+    price?: ListPlansUpsertLicensePrice | undefined;
+    /**
+     * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
+     */
+    proration?: ListPlansUpsertLicenseProration | undefined;
+    /**
+     * Rollover config for unused units. If set, unused included units carry over.
+     */
+    rollover?: ListPlansUpsertLicenseRollover | undefined;
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+declare const ListPlansUpsertLicenseBillingMethod: {
+    readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
+};
+/**
+ * Match items with this billing method (prepaid or usage_based).
+ */
+type ListPlansUpsertLicenseBillingMethod = OpenEnum<typeof ListPlansUpsertLicenseBillingMethod>;
+/**
+ * Filter for matching plan items. All provided fields must match (AND).
+ */
+type ListPlansUpsertLicensePlanItemFilter = {
+    /**
+     * Match items linked to this feature.
+     */
+    featureId?: string | undefined;
+    /**
+     * Match items with this billing method (prepaid or usage_based).
+     */
+    billingMethod?: ListPlansUpsertLicenseBillingMethod | 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?: any | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     */
+    intervalCount?: number | undefined;
+    /**
+     * Match items whose grant equals this included usage. Omitted is a wildcard.
+     */
+    included?: number | undefined;
+};
+type ListPlansUpsertLicenseCustomize = {
+    price?: ListPlansUpsertLicenseBasePrice | null | undefined;
+    addItems?: Array<ListPlansUpsertLicensePlanItem> | undefined;
+    removeItems?: Array<ListPlansUpsertLicensePlanItemFilter> | undefined;
+};
+type ListPlansUpsertLicense = {
+    licensePlanId: string;
+    included?: number | undefined;
+    prepaidOnly?: boolean | undefined;
+    customize?: ListPlansUpsertLicenseCustomize | null | undefined;
+    metadata?: {
+        [k: string]: any;
+    } | undefined;
+};
+type ListPlansRemoveLicense = {
+    licensePlanId: string;
+};
+/**
+ * The customization that transforms the base plan into this variant.
+ */
+type ListPlansCustomize = {
+    /**
+     * Override the base price of the plan. Pass null to remove the base price.
+     */
+    price?: ListPlansBasePrice | null | undefined;
+    /**
+     * Items to add to the plan.
+     */
+    addItems?: Array<ListPlansPlanItem> | undefined;
+    /**
+     * Filters selecting items to remove from the plan.
+     */
+    removeItems?: Array<ListPlansPlanItemFilter> | undefined;
+    /**
+     * Override the plan's default free trial. Pass an object to set a custom trial, or null to remove the trial entirely.
+     */
+    freeTrial?: ListPlansFreeTrialParams | null | undefined;
+    /**
+     * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
+     */
+    billingControls?: ListPlansVariantDetailsBillingControls | undefined;
+    /**
+     * License links to add or override for this customer, keyed by license_plan_id. Omitted fields inherit the plan catalog link (included defaults to 1 when the license is not in the catalog). A bare entry restores the license to pure catalog inheritance.
+     */
+    upsertLicenses?: Array<ListPlansUpsertLicense> | undefined;
+    /**
+     * License links to drop, keyed by license_plan_id. Parallel to remove_items.
+     */
+    removeLicenses?: Array<ListPlansRemoveLicense> | undefined;
+};
+/**
+ * Details about how this variant relates to its latest base plan.
+ */
+type ListPlansVariantDetails = {
+    /**
+     * The ID of the base plan this variant was derived from.
+     */
+    basePlanId: string;
+    /**
+     * The customization that transforms the base plan into this variant.
+     */
+    customize?: ListPlansCustomize | undefined;
 };
 /**
  * A plan defines a set of features, pricing, and entitlements that can be attached to customers.
@@ -1304,6 +1484,14 @@ type ListPlansList = {
      * Version number of the plan. Incremented when plan configuration changes.
      */
     version: number;
+    /**
+     * User-facing version identity. Defaults to v{n} when the version is minted.
+     */
+    versionSlug?: string | null | undefined;
+    /**
+     * Whether this is the active version of the plan. At most one version is active.
+     */
+    active?: boolean | undefined;
     /**
      * Whether this is an add-on plan that can be attached alongside a main plan.
      */
@@ -1336,14 +1524,6 @@ type ListPlansList = {
      * Whether the plan is archived. Archived plans cannot be attached to new customers.
      */
     archived: boolean;
-    /**
-     * Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.
-     */
-    baseVariantId: string | null;
-    /**
-     * Details about how this variant relates to its latest base plan.
-     */
-    variantDetails?: ListPlansVariantDetails | undefined;
     /**
      * Miscellaneous plan-level configuration flags.
      */
@@ -1359,6 +1539,14 @@ type ListPlansList = {
         [k: string]: any;
     };
     customerEligibility?: ListPlansCustomerEligibility | undefined;
+    /**
+     * Deprecated. Use variant_details.base_plan_id instead. If this is a variant, the ID of the base plan it was created from.
+     */
+    baseVariantId: string | null;
+    /**
+     * Details about how this variant relates to its latest base plan.
+     */
+    variantDetails?: ListPlansVariantDetails | undefined;
 };
 /**
  * OK