autumn-js 1.2.53 → 1.2.55

package/dist/react/{params-BGfGRnue.d.ts → params-BiUwODRL.d.mts}

@@ -1,4 +1,4 @@
-import { C as ClosedEnum, O as OpenEnum, a as Balance, P as Plan } from './plan-DEGPMYmh.js';
+import { C as ClosedEnum, O as OpenEnum, a as Balance, P as Plan } from './plan-C96AilzT.mjs';
 
 /**
  * Time range to aggregate events for. Either range or custom_range must be provided
@@ -60,7 +60,7 @@ type EventsAggregateParams = {
      */
     featureId: string | Array<string>;
     /**
-     * Property to group events by (e.g. "properties.region"), or "$customer_id" / "$entity_id" / "$plan_id" to group by those columns
+     * Property to group events by (e.g. "properties.region"), or "$customer_id" / "$entity_id" / "$plan_id" to group by those columns. When aggregate_on is "deducted", "$feature_id" groups deductions by the tracked feature that consumed each balance.
      */
     groupBy?: string | undefined;
     /**
@@ -229,6 +229,50 @@ type AttachFeatureQuantity = {
      */
     adjustable?: boolean | undefined;
 };
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+declare const AttachDurationType: {
+    readonly Day: "day";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+type AttachDurationType = ClosedEnum<typeof AttachDurationType>;
+/**
+ * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ */
+declare const AttachOnEnd: {
+    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 AttachOnEnd = ClosedEnum<typeof AttachOnEnd>;
+/**
+ * Free trial configuration for a plan.
+ */
+type AttachFreeTrialParams = {
+    /**
+     * Number of duration_type periods the trial lasts.
+     */
+    durationLength: number;
+    /**
+     * Unit of time for the trial ('day', 'month', 'year').
+     */
+    durationType?: AttachDurationType | undefined;
+    /**
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
+     */
+    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?: AttachOnEnd | undefined;
+};
 /**
  * Billing interval (e.g. 'month', 'year').
  */
@@ -259,7 +303,7 @@ type AttachAdditionalCurrency = {
  */
 type AttachBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -811,11 +855,15 @@ type AttachPlanItemFilter = {
      * 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;
 };
 /**
  * Unit of time for the trial ('day', 'month', 'year').
  */
-declare const AttachDurationType: {
+declare const AttachCustomizeDurationType: {
     readonly Day: "day";
     readonly Month: "month";
     readonly Year: "year";
@@ -823,22 +871,22 @@ declare const AttachDurationType: {
 /**
  * Unit of time for the trial ('day', 'month', 'year').
  */
-type AttachDurationType = ClosedEnum<typeof AttachDurationType>;
+type AttachCustomizeDurationType = ClosedEnum<typeof AttachCustomizeDurationType>;
 /**
  * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
  */
-declare const AttachOnEnd: {
+declare const AttachCustomizeOnEnd: {
     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 AttachOnEnd = ClosedEnum<typeof AttachOnEnd>;
+type AttachCustomizeOnEnd = ClosedEnum<typeof AttachCustomizeOnEnd>;
 /**
  * Free trial configuration for a plan.
  */
-type AttachFreeTrialParams = {
+type AttachCustomizeFreeTrialParams = {
     /**
      * Number of duration_type periods the trial lasts.
      */
@@ -846,15 +894,15 @@ type AttachFreeTrialParams = {
     /**
      * Unit of time for the trial ('day', 'month', 'year').
      */
-    durationType?: AttachDurationType | undefined;
+    durationType?: AttachCustomizeDurationType | undefined;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
      */
     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?: AttachOnEnd | undefined;
+    onEnd?: AttachCustomizeOnEnd | undefined;
 };
 /**
  * The time interval for the purchase limit window.
@@ -1107,7 +1155,7 @@ type AttachUpsertLicenseAdditionalCurrency = {
  */
 type AttachUpsertLicenseBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -1403,6 +1451,10 @@ type AttachUpsertLicensePlanItemFilter = {
      * 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 AttachUpsertLicenseCustomize = {
     price?: AttachUpsertLicenseBasePrice | null | undefined;
@@ -1418,6 +1470,9 @@ type AttachUpsertLicense = {
         [k: string]: any;
     } | undefined;
 };
+type AttachRemoveLicense = {
+    licensePlanId: string;
+};
 /**
  * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
  */
@@ -1441,7 +1496,7 @@ 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;
+    freeTrial?: AttachCustomizeFreeTrialParams | null | undefined;
     /**
      * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
      */
@@ -1450,6 +1505,10 @@ type AttachCustomize = {
      * 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<AttachUpsertLicense> | undefined;
+    /**
+     * License links to drop, keyed by license_plan_id. Parallel to remove_items.
+     */
+    removeLicenses?: Array<AttachRemoveLicense> | 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.
@@ -1590,6 +1649,10 @@ type AttachParams = {
      * The version of the plan to attach.
      */
     version?: number | undefined;
+    /**
+     * Free trial for this plan. A shorthand for customize.free_trial, which takes precedence when both are given.
+     */
+    freeTrial?: AttachFreeTrialParams | null | undefined;
     /**
      * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
      */
@@ -1623,9 +1686,9 @@ type AttachParams = {
      */
     newBillingSubscription?: boolean | undefined;
     /**
-     * Reset the billing cycle anchor immediately with 'now'.
+     * Reset the billing cycle immediately with 'now', or schedule a reset at a future Unix timestamp in milliseconds.
      */
-    billingCycleAnchor?: "now" | undefined;
+    billingCycleAnchor?: string | number | undefined;
     /**
      * When the plan change should take effect. 'immediate' applies now, 'end_of_cycle' schedules for the end of the current billing cycle. By default, upgrades are immediate and downgrades are scheduled.
      */
@@ -1679,7 +1742,7 @@ type AttachParams = {
      */
     noBillingChanges?: boolean | undefined;
     /**
-     * If true, the customer's plan is activated immediately even when payment is deferred (invoice mode) or pending (Stripe checkout). For Stripe checkout, the customer_product is inserted before the customer completes the hosted form.
+     * If true, the customer's plan is activated immediately even when payment is deferred (invoice mode) or pending (Stripe checkout). For Stripe checkout, the customer_product is inserted before the customer completes the hosted form. Set it here rather than on `invoice_mode`, which only covers the invoice-unpaid case.
      */
     enablePlanImmediately?: boolean | undefined;
     /**
@@ -1789,6 +1852,50 @@ type BillingUpdateFeatureQuantity = {
      */
     adjustable?: boolean | undefined;
 };
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+declare const BillingUpdateDurationType: {
+    readonly Day: "day";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+type BillingUpdateDurationType = ClosedEnum<typeof BillingUpdateDurationType>;
+/**
+ * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ */
+declare const BillingUpdateOnEnd: {
+    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 BillingUpdateOnEnd = ClosedEnum<typeof BillingUpdateOnEnd>;
+/**
+ * Free trial configuration for a plan.
+ */
+type BillingUpdateFreeTrialParams = {
+    /**
+     * Number of duration_type periods the trial lasts.
+     */
+    durationLength: number;
+    /**
+     * Unit of time for the trial ('day', 'month', 'year').
+     */
+    durationType?: BillingUpdateDurationType | undefined;
+    /**
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
+     */
+    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?: BillingUpdateOnEnd | undefined;
+};
 /**
  * Billing interval (e.g. 'month', 'year').
  */
@@ -1819,7 +1926,7 @@ type BillingUpdateAdditionalCurrency = {
  */
 type BillingUpdateBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -2371,11 +2478,15 @@ type BillingUpdatePlanItemFilter = {
      * 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;
 };
 /**
  * Unit of time for the trial ('day', 'month', 'year').
  */
-declare const BillingUpdateDurationType: {
+declare const BillingUpdateCustomizeDurationType: {
     readonly Day: "day";
     readonly Month: "month";
     readonly Year: "year";
@@ -2383,22 +2494,22 @@ declare const BillingUpdateDurationType: {
 /**
  * Unit of time for the trial ('day', 'month', 'year').
  */
-type BillingUpdateDurationType = ClosedEnum<typeof BillingUpdateDurationType>;
+type BillingUpdateCustomizeDurationType = ClosedEnum<typeof BillingUpdateCustomizeDurationType>;
 /**
  * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
  */
-declare const BillingUpdateOnEnd: {
+declare const BillingUpdateCustomizeOnEnd: {
     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 BillingUpdateOnEnd = ClosedEnum<typeof BillingUpdateOnEnd>;
+type BillingUpdateCustomizeOnEnd = ClosedEnum<typeof BillingUpdateCustomizeOnEnd>;
 /**
  * Free trial configuration for a plan.
  */
-type BillingUpdateFreeTrialParams = {
+type BillingUpdateCustomizeFreeTrialParams = {
     /**
      * Number of duration_type periods the trial lasts.
      */
@@ -2406,15 +2517,15 @@ type BillingUpdateFreeTrialParams = {
     /**
      * Unit of time for the trial ('day', 'month', 'year').
      */
-    durationType?: BillingUpdateDurationType | undefined;
+    durationType?: BillingUpdateCustomizeDurationType | undefined;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
      */
     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?: BillingUpdateOnEnd | undefined;
+    onEnd?: BillingUpdateCustomizeOnEnd | undefined;
 };
 /**
  * The time interval for the purchase limit window.
@@ -2667,7 +2778,7 @@ type BillingUpdateUpsertLicenseAdditionalCurrency = {
  */
 type BillingUpdateUpsertLicenseBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -2963,6 +3074,10 @@ type BillingUpdateUpsertLicensePlanItemFilter = {
      * 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 BillingUpdateUpsertLicenseCustomize = {
     price?: BillingUpdateUpsertLicenseBasePrice | null | undefined;
@@ -2978,6 +3093,9 @@ type BillingUpdateUpsertLicense = {
         [k: string]: any;
     } | undefined;
 };
+type BillingUpdateRemoveLicense = {
+    licensePlanId: string;
+};
 /**
  * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
  */
@@ -3001,7 +3119,7 @@ type BillingUpdateCustomize = {
     /**
      * 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;
+    freeTrial?: BillingUpdateCustomizeFreeTrialParams | null | undefined;
     /**
      * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
      */
@@ -3010,6 +3128,10 @@ type BillingUpdateCustomize = {
      * 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<BillingUpdateUpsertLicense> | undefined;
+    /**
+     * License links to drop, keyed by license_plan_id. Parallel to remove_items.
+     */
+    removeLicenses?: Array<BillingUpdateRemoveLicense> | 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.
@@ -3148,6 +3270,10 @@ type UpdateSubscriptionParams = {
      * The version of the plan to attach.
      */
     version?: number | undefined;
+    /**
+     * Free trial for this plan. A shorthand for customize.free_trial, which takes precedence when both are given.
+     */
+    freeTrial?: BillingUpdateFreeTrialParams | null | undefined;
     /**
      * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
      */
@@ -3177,9 +3303,9 @@ type UpdateSubscriptionParams = {
      */
     cancelAction?: BillingUpdateCancelAction | undefined;
     /**
-     * Reset the billing cycle anchor immediately with 'now'
+     * Reset the billing cycle immediately with 'now', or schedule a reset at a future Unix timestamp in milliseconds.
      */
-    billingCycleAnchor?: "now" | undefined;
+    billingCycleAnchor?: string | number | undefined;
     /**
      * If true, the subscription is updated internally without applying billing changes in Stripe.
      */
@@ -3188,6 +3314,12 @@ type UpdateSubscriptionParams = {
      * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
      */
     refundLastPayment?: BillingUpdateRefundLastPayment | undefined;
+    /**
+     * Additional parameters to pass into the Stripe subscription update or cancel call.
+     */
+    subscriptionParams?: {
+        [k: string]: any;
+    } | undefined;
     /**
      * Controls whether balances should be recalculated during the subscription update.
      */
@@ -3344,16 +3476,57 @@ declare const FlagType2: {
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools, 'ai_credit_system' for model-based token pricing.
  */
 type FlagType2 = OpenEnum<typeof FlagType2>;
-type CheckCreditSchema2 = {
+type CheckCreditSchema6 = {
+    meteredFeatureId: "";
+    /**
+     * Number of metered-feature units priced together. Defaults to one when omitted.
+     */
+    billingUnits?: number | undefined;
+    /**
+     * Credits consumed per billing-unit group.
+     */
+    creditCost: number;
+};
+type CheckCreditSchema5 = {
     /**
      * ID of the metered feature that draws from this credit system.
      */
     meteredFeatureId: string;
     /**
-     * Credits consumed per unit of the metered feature.
+     * Number of metered-feature units priced together. Defaults to one when omitted.
+     */
+    billingUnits?: number | undefined;
+    /**
+     * Credits consumed per billing-unit group.
+     */
+    creditCost: number;
+};
+declare const CheckToEnum2: {
+    readonly Inf: "inf";
+};
+type CheckToEnum2 = ClosedEnum<typeof CheckToEnum2>;
+type CheckTier2 = {
+    /**
+     * Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.
+     */
+    to: number | CheckToEnum2;
+    /**
+     * Credits consumed per billing-unit group within this tier.
      */
     creditCost: number;
 };
+type CheckCreditSchema4 = {
+    /**
+     * ID of the metered feature that draws from this credit system.
+     */
+    meteredFeatureId: string;
+    /**
+     * Number of metered-feature units priced together. Defaults to one when omitted.
+     */
+    billingUnits?: number | undefined;
+    tierBehavior: "graduated";
+    tiers: Array<CheckTier2>;
+};
 type CheckModelMarkups2 = {
     markup?: number | undefined;
     inputCost?: number | undefined;
@@ -3375,6 +3548,22 @@ type FlagDisplay2 = {
      */
     plural?: string | null | undefined;
 };
+type CheckStripe2 = {
+    /**
+     * Stripe product ID this feature's usage prices bill under.
+     */
+    productId?: string | undefined;
+    /**
+     * Stripe meter ID used to create this feature's metered price.
+     */
+    meterId?: string | undefined;
+};
+/**
+ * Processor mappings for this feature. Present when a Stripe product or meter is set.
+ */
+type CheckProcessors2 = {
+    stripe?: CheckStripe2 | undefined;
+};
 /**
  * The full feature object if expanded.
  */
@@ -3400,9 +3589,13 @@ type CheckFeature2 = {
      */
     eventNames?: Array<string> | undefined;
     /**
-     * For credit_system features: maps metered features to their credit costs.
+     * For classic credit systems: maps metered features to flat or graduated credit costs.
+     */
+    creditSchema?: Array<CheckCreditSchema4 | CheckCreditSchema5 | CheckCreditSchema6> | undefined;
+    /**
+     * Whether usage of this classic credit system should be itemized as invoice credits.
      */
-    creditSchema?: Array<CheckCreditSchema2> | undefined;
+    invoiceCredit?: boolean | undefined;
     /**
      * Per-model markup overrides for AI credit systems.
      */
@@ -3427,6 +3620,10 @@ type CheckFeature2 = {
      * Whether the feature is archived and hidden from the dashboard.
      */
     archived: boolean;
+    /**
+     * Processor mappings for this feature. Present when a Stripe product or meter is set.
+     */
+    processors?: CheckProcessors2 | undefined;
 };
 type Flag2 = {
     /**
@@ -4055,16 +4252,57 @@ declare const FlagType1: {
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools, 'ai_credit_system' for model-based token pricing.
  */
 type FlagType1 = OpenEnum<typeof FlagType1>;
-type CheckCreditSchema1 = {
+type CheckCreditSchema3 = {
+    meteredFeatureId: "";
+    /**
+     * Number of metered-feature units priced together. Defaults to one when omitted.
+     */
+    billingUnits?: number | undefined;
+    /**
+     * Credits consumed per billing-unit group.
+     */
+    creditCost: number;
+};
+type CheckCreditSchema2 = {
     /**
      * ID of the metered feature that draws from this credit system.
      */
     meteredFeatureId: string;
     /**
-     * Credits consumed per unit of the metered feature.
+     * Number of metered-feature units priced together. Defaults to one when omitted.
+     */
+    billingUnits?: number | undefined;
+    /**
+     * Credits consumed per billing-unit group.
      */
     creditCost: number;
 };
+declare const CheckToEnum1: {
+    readonly Inf: "inf";
+};
+type CheckToEnum1 = ClosedEnum<typeof CheckToEnum1>;
+type CheckTier1 = {
+    /**
+     * Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.
+     */
+    to: number | CheckToEnum1;
+    /**
+     * Credits consumed per billing-unit group within this tier.
+     */
+    creditCost: number;
+};
+type CheckCreditSchema1 = {
+    /**
+     * ID of the metered feature that draws from this credit system.
+     */
+    meteredFeatureId: string;
+    /**
+     * Number of metered-feature units priced together. Defaults to one when omitted.
+     */
+    billingUnits?: number | undefined;
+    tierBehavior: "graduated";
+    tiers: Array<CheckTier1>;
+};
 type CheckModelMarkups1 = {
     markup?: number | undefined;
     inputCost?: number | undefined;
@@ -4086,6 +4324,22 @@ type FlagDisplay1 = {
      */
     plural?: string | null | undefined;
 };
+type CheckStripe1 = {
+    /**
+     * Stripe product ID this feature's usage prices bill under.
+     */
+    productId?: string | undefined;
+    /**
+     * Stripe meter ID used to create this feature's metered price.
+     */
+    meterId?: string | undefined;
+};
+/**
+ * Processor mappings for this feature. Present when a Stripe product or meter is set.
+ */
+type CheckProcessors1 = {
+    stripe?: CheckStripe1 | undefined;
+};
 /**
  * The full feature object if expanded.
  */
@@ -4111,9 +4365,13 @@ type CheckFeature1 = {
      */
     eventNames?: Array<string> | undefined;
     /**
-     * For credit_system features: maps metered features to their credit costs.
+     * For classic credit systems: maps metered features to flat or graduated credit costs.
+     */
+    creditSchema?: Array<CheckCreditSchema1 | CheckCreditSchema2 | CheckCreditSchema3> | undefined;
+    /**
+     * Whether usage of this classic credit system should be itemized as invoice credits.
      */
-    creditSchema?: Array<CheckCreditSchema1> | undefined;
+    invoiceCredit?: boolean | undefined;
     /**
      * Per-model markup overrides for AI credit systems.
      */
@@ -4138,6 +4396,10 @@ type CheckFeature1 = {
      * Whether the feature is archived and hidden from the dashboard.
      */
     archived: boolean;
+    /**
+     * Processor mappings for this feature. Present when a Stripe product or meter is set.
+     */
+    processors?: CheckProcessors1 | undefined;
 };
 type Flag1 = {
     /**
@@ -5218,16 +5480,57 @@ declare const GetEntityType: {
  * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools, 'ai_credit_system' for model-based token pricing.
  */
 type GetEntityType = OpenEnum<typeof GetEntityType>;
-type GetEntityCreditSchema = {
+type GetEntityCreditSchema3 = {
+    meteredFeatureId: "";
+    /**
+     * Number of metered-feature units priced together. Defaults to one when omitted.
+     */
+    billingUnits?: number | undefined;
+    /**
+     * Credits consumed per billing-unit group.
+     */
+    creditCost: number;
+};
+type GetEntityCreditSchema2 = {
     /**
      * ID of the metered feature that draws from this credit system.
      */
     meteredFeatureId: string;
     /**
-     * Credits consumed per unit of the metered feature.
+     * Number of metered-feature units priced together. Defaults to one when omitted.
+     */
+    billingUnits?: number | undefined;
+    /**
+     * Credits consumed per billing-unit group.
+     */
+    creditCost: number;
+};
+declare const GetEntityToEnum: {
+    readonly Inf: "inf";
+};
+type GetEntityToEnum = ClosedEnum<typeof GetEntityToEnum>;
+type GetEntityTier = {
+    /**
+     * Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.
+     */
+    to: number | GetEntityToEnum;
+    /**
+     * Credits consumed per billing-unit group within this tier.
      */
     creditCost: number;
 };
+type GetEntityCreditSchema1 = {
+    /**
+     * ID of the metered feature that draws from this credit system.
+     */
+    meteredFeatureId: string;
+    /**
+     * Number of metered-feature units priced together. Defaults to one when omitted.
+     */
+    billingUnits?: number | undefined;
+    tierBehavior: "graduated";
+    tiers: Array<GetEntityTier>;
+};
 type GetEntityModelMarkups = {
     markup?: number | undefined;
     inputCost?: number | undefined;
@@ -5249,6 +5552,22 @@ type GetEntityDisplay = {
      */
     plural?: string | null | undefined;
 };
+type GetEntityStripe = {
+    /**
+     * Stripe product ID this feature's usage prices bill under.
+     */
+    productId?: string | undefined;
+    /**
+     * Stripe meter ID used to create this feature's metered price.
+     */
+    meterId?: string | undefined;
+};
+/**
+ * Processor mappings for this feature. Present when a Stripe product or meter is set.
+ */
+type GetEntityProcessors = {
+    stripe?: GetEntityStripe | undefined;
+};
 /**
  * The full feature object if expanded.
  */
@@ -5274,9 +5593,13 @@ type GetEntityFeature = {
      */
     eventNames?: Array<string> | undefined;
     /**
-     * For credit_system features: maps metered features to their credit costs.
+     * For classic credit systems: maps metered features to flat or graduated credit costs.
      */
-    creditSchema?: Array<GetEntityCreditSchema> | undefined;
+    creditSchema?: Array<GetEntityCreditSchema1 | GetEntityCreditSchema2 | GetEntityCreditSchema3> | undefined;
+    /**
+     * Whether usage of this classic credit system should be itemized as invoice credits.
+     */
+    invoiceCredit?: boolean | undefined;
     /**
      * Per-model markup overrides for AI credit systems.
      */
@@ -5301,6 +5624,10 @@ type GetEntityFeature = {
      * Whether the feature is archived and hidden from the dashboard.
      */
     archived: boolean;
+    /**
+     * Processor mappings for this feature. Present when a Stripe product or meter is set.
+     */
+    processors?: GetEntityProcessors | undefined;
 };
 type GetEntityFlags = {
     /**
@@ -5799,7 +6126,7 @@ type MultiAttachAdditionalCurrency = {
  */
 type MultiAttachBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -6140,7 +6467,7 @@ type MultiAttachFreeTrialParams = {
      */
     durationType?: MultiAttachDurationType | undefined;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
      */
     cardRequired?: boolean | undefined;
     /**
@@ -6417,6 +6744,10 @@ type MultiAttachParams = {
      * How to handle billing. 'prorate_immediately' charges/credits prorated amounts now, 'none' does not charge/credit anything.
      */
     billingBehavior?: MultiAttachBillingBehavior | undefined;
+    /**
+     * Pass 'now' to reset the billing cycle of every plan on the subscription to the time of this request.
+     */
+    billingCycleAnchor?: "now" | undefined;
     /**
      * URL to redirect to after successful checkout.
      */
@@ -6567,6 +6898,50 @@ type PreviewAttachFeatureQuantityRequest = {
      */
     adjustable?: boolean | 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, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
+     */
+    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;
+};
 /**
  * Billing interval (e.g. 'month', 'year').
  */
@@ -6597,7 +6972,7 @@ type PreviewAttachAdditionalCurrency = {
  */
 type PreviewAttachBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -7149,11 +7524,15 @@ type PreviewAttachPlanItemFilter = {
      * 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;
 };
 /**
  * Unit of time for the trial ('day', 'month', 'year').
  */
-declare const PreviewAttachDurationType: {
+declare const PreviewAttachCustomizeDurationType: {
     readonly Day: "day";
     readonly Month: "month";
     readonly Year: "year";
@@ -7161,22 +7540,22 @@ declare const PreviewAttachDurationType: {
 /**
  * Unit of time for the trial ('day', 'month', 'year').
  */
-type PreviewAttachDurationType = ClosedEnum<typeof PreviewAttachDurationType>;
+type PreviewAttachCustomizeDurationType = ClosedEnum<typeof PreviewAttachCustomizeDurationType>;
 /**
  * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
  */
-declare const PreviewAttachOnEnd: {
+declare const PreviewAttachCustomizeOnEnd: {
     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>;
+type PreviewAttachCustomizeOnEnd = ClosedEnum<typeof PreviewAttachCustomizeOnEnd>;
 /**
  * Free trial configuration for a plan.
  */
-type PreviewAttachFreeTrialParams = {
+type PreviewAttachCustomizeFreeTrialParams = {
     /**
      * Number of duration_type periods the trial lasts.
      */
@@ -7184,15 +7563,15 @@ type PreviewAttachFreeTrialParams = {
     /**
      * Unit of time for the trial ('day', 'month', 'year').
      */
-    durationType?: PreviewAttachDurationType | undefined;
+    durationType?: PreviewAttachCustomizeDurationType | undefined;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
      */
     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;
+    onEnd?: PreviewAttachCustomizeOnEnd | undefined;
 };
 /**
  * The time interval for the purchase limit window.
@@ -7445,7 +7824,7 @@ type PreviewAttachUpsertLicenseAdditionalCurrency = {
  */
 type PreviewAttachUpsertLicenseBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -7741,6 +8120,10 @@ type PreviewAttachUpsertLicensePlanItemFilter = {
      * 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 PreviewAttachUpsertLicenseCustomize = {
     price?: PreviewAttachUpsertLicenseBasePrice | null | undefined;
@@ -7756,6 +8139,9 @@ type PreviewAttachUpsertLicense = {
         [k: string]: any;
     } | undefined;
 };
+type PreviewAttachRemoveLicense = {
+    licensePlanId: string;
+};
 /**
  * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
  */
@@ -7779,7 +8165,7 @@ 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;
+    freeTrial?: PreviewAttachCustomizeFreeTrialParams | null | undefined;
     /**
      * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
      */
@@ -7788,6 +8174,10 @@ type PreviewAttachCustomize = {
      * 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<PreviewAttachUpsertLicense> | undefined;
+    /**
+     * License links to drop, keyed by license_plan_id. Parallel to remove_items.
+     */
+    removeLicenses?: Array<PreviewAttachRemoveLicense> | 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.
@@ -7928,6 +8318,10 @@ type PreviewAttachParams = {
      * The version of the plan to attach.
      */
     version?: number | undefined;
+    /**
+     * Free trial for this plan. A shorthand for customize.free_trial, which takes precedence when both are given.
+     */
+    freeTrial?: PreviewAttachFreeTrialParams | null | undefined;
     /**
      * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
      */
@@ -7961,9 +8355,9 @@ type PreviewAttachParams = {
      */
     newBillingSubscription?: boolean | undefined;
     /**
-     * Reset the billing cycle anchor immediately with 'now'.
+     * Reset the billing cycle immediately with 'now', or schedule a reset at a future Unix timestamp in milliseconds.
      */
-    billingCycleAnchor?: "now" | undefined;
+    billingCycleAnchor?: string | number | undefined;
     /**
      * When the plan change should take effect. 'immediate' applies now, 'end_of_cycle' schedules for the end of the current billing cycle. By default, upgrades are immediate and downgrades are scheduled.
      */
@@ -8017,7 +8411,7 @@ type PreviewAttachParams = {
      */
     noBillingChanges?: boolean | undefined;
     /**
-     * If true, the customer's plan is activated immediately even when payment is deferred (invoice mode) or pending (Stripe checkout). For Stripe checkout, the customer_product is inserted before the customer completes the hosted form.
+     * If true, the customer's plan is activated immediately even when payment is deferred (invoice mode) or pending (Stripe checkout). For Stripe checkout, the customer_product is inserted before the customer completes the hosted form. Set it here rather than on `invoice_mode`, which only covers the invoice-unpaid case.
      */
     enablePlanImmediately?: boolean | undefined;
     /**
@@ -8344,6 +8738,10 @@ type PreviewAttachResponse = {
      * The three-letter ISO currency code. All amounts are in the currency's major unit (e.g., dollars for USD).
      */
     currency: string;
+    /**
+     * True when this change clears the customer's usage balances, so the approver can see usage will reset.
+     */
+    resetsUsage?: boolean | undefined;
     /**
      * Preview of the next billing cycle, if applicable. This shows what the customer will be charged in subsequent cycles.
      */
@@ -8408,7 +8806,7 @@ type PreviewMultiAttachAdditionalCurrency = {
  */
 type PreviewMultiAttachBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -8749,7 +9147,7 @@ type PreviewMultiAttachFreeTrialParams = {
      */
     durationType?: PreviewMultiAttachDurationType | undefined;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
      */
     cardRequired?: boolean | undefined;
     /**
@@ -9026,6 +9424,10 @@ type PreviewMultiAttachParams = {
      * How to handle billing. 'prorate_immediately' charges/credits prorated amounts now, 'none' does not charge/credit anything.
      */
     billingBehavior?: PreviewMultiAttachBillingBehavior | undefined;
+    /**
+     * Pass 'now' to reset the billing cycle of every plan on the subscription to the time of this request.
+     */
+    billingCycleAnchor?: "now" | undefined;
     /**
      * URL to redirect to after successful checkout.
      */
@@ -9365,6 +9767,10 @@ type PreviewMultiAttachResponse = {
      * The three-letter ISO currency code. All amounts are in the currency's major unit (e.g., dollars for USD).
      */
     currency: string;
+    /**
+     * True when this change clears the customer's usage balances, so the approver can see usage will reset.
+     */
+    resetsUsage?: boolean | undefined;
     /**
      * Preview of the next billing cycle, if applicable. This shows what the customer will be charged in subsequent cycles.
      */
@@ -9416,6 +9822,50 @@ type PreviewUpdateFeatureQuantityRequest = {
      */
     adjustable?: boolean | 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, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
+     */
+    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;
+};
 /**
  * Billing interval (e.g. 'month', 'year').
  */
@@ -9446,7 +9896,7 @@ type PreviewUpdateAdditionalCurrency = {
  */
 type PreviewUpdateBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -9998,11 +10448,15 @@ type PreviewUpdatePlanItemFilter = {
      * 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;
 };
 /**
  * Unit of time for the trial ('day', 'month', 'year').
  */
-declare const PreviewUpdateDurationType: {
+declare const PreviewUpdateCustomizeDurationType: {
     readonly Day: "day";
     readonly Month: "month";
     readonly Year: "year";
@@ -10010,22 +10464,22 @@ declare const PreviewUpdateDurationType: {
 /**
  * Unit of time for the trial ('day', 'month', 'year').
  */
-type PreviewUpdateDurationType = ClosedEnum<typeof PreviewUpdateDurationType>;
+type PreviewUpdateCustomizeDurationType = ClosedEnum<typeof PreviewUpdateCustomizeDurationType>;
 /**
  * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
  */
-declare const PreviewUpdateOnEnd: {
+declare const PreviewUpdateCustomizeOnEnd: {
     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>;
+type PreviewUpdateCustomizeOnEnd = ClosedEnum<typeof PreviewUpdateCustomizeOnEnd>;
 /**
  * Free trial configuration for a plan.
  */
-type PreviewUpdateFreeTrialParams = {
+type PreviewUpdateCustomizeFreeTrialParams = {
     /**
      * Number of duration_type periods the trial lasts.
      */
@@ -10033,15 +10487,15 @@ type PreviewUpdateFreeTrialParams = {
     /**
      * Unit of time for the trial ('day', 'month', 'year').
      */
-    durationType?: PreviewUpdateDurationType | undefined;
+    durationType?: PreviewUpdateCustomizeDurationType | undefined;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
      */
     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;
+    onEnd?: PreviewUpdateCustomizeOnEnd | undefined;
 };
 /**
  * The time interval for the purchase limit window.
@@ -10294,7 +10748,7 @@ type PreviewUpdateUpsertLicenseAdditionalCurrency = {
  */
 type PreviewUpdateUpsertLicenseBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -10590,6 +11044,10 @@ type PreviewUpdateUpsertLicensePlanItemFilter = {
      * 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 PreviewUpdateUpsertLicenseCustomize = {
     price?: PreviewUpdateUpsertLicenseBasePrice | null | undefined;
@@ -10605,6 +11063,9 @@ type PreviewUpdateUpsertLicense = {
         [k: string]: any;
     } | undefined;
 };
+type PreviewUpdateRemoveLicense = {
+    licensePlanId: string;
+};
 /**
  * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
  */
@@ -10628,7 +11089,7 @@ 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;
+    freeTrial?: PreviewUpdateCustomizeFreeTrialParams | null | undefined;
     /**
      * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
      */
@@ -10637,6 +11098,10 @@ type PreviewUpdateCustomize = {
      * 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<PreviewUpdateUpsertLicense> | undefined;
+    /**
+     * License links to drop, keyed by license_plan_id. Parallel to remove_items.
+     */
+    removeLicenses?: Array<PreviewUpdateRemoveLicense> | 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.
@@ -10775,6 +11240,10 @@ type PreviewUpdateParams = {
      * The version of the plan to attach.
      */
     version?: number | undefined;
+    /**
+     * Free trial for this plan. A shorthand for customize.free_trial, which takes precedence when both are given.
+     */
+    freeTrial?: PreviewUpdateFreeTrialParams | null | undefined;
     /**
      * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
      */
@@ -10804,9 +11273,9 @@ type PreviewUpdateParams = {
      */
     cancelAction?: PreviewUpdateCancelAction | undefined;
     /**
-     * Reset the billing cycle anchor immediately with 'now'
+     * Reset the billing cycle immediately with 'now', or schedule a reset at a future Unix timestamp in milliseconds.
      */
-    billingCycleAnchor?: "now" | undefined;
+    billingCycleAnchor?: string | number | undefined;
     /**
      * If true, the subscription is updated internally without applying billing changes in Stripe.
      */
@@ -10815,6 +11284,12 @@ type PreviewUpdateParams = {
      * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
      */
     refundLastPayment?: PreviewUpdateRefundLastPayment | undefined;
+    /**
+     * Additional parameters to pass into the Stripe subscription update or cancel call.
+     */
+    subscriptionParams?: {
+        [k: string]: any;
+    } | undefined;
     /**
      * Controls whether balances should be recalculated during the subscription update.
      */
@@ -11146,6 +11621,10 @@ type PreviewUpdateResponse = {
      * The three-letter ISO currency code. All amounts are in the currency's major unit (e.g., dollars for USD).
      */
     currency: string;
+    /**
+     * True when this change clears the customer's usage balances, so the approver can see usage will reset.
+     */
+    resetsUsage?: boolean | undefined;
     /**
      * Preview of the next billing cycle, if applicable. This shows what the customer will be charged in subsequent cycles.
      */
@@ -11218,6 +11697,50 @@ type SetupPaymentFeatureQuantity = {
      */
     adjustable?: boolean | undefined;
 };
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+declare const SetupPaymentDurationType: {
+    readonly Day: "day";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Unit of time for the trial ('day', 'month', 'year').
+ */
+type SetupPaymentDurationType = ClosedEnum<typeof SetupPaymentDurationType>;
+/**
+ * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
+ */
+declare const SetupPaymentOnEnd: {
+    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 SetupPaymentOnEnd = ClosedEnum<typeof SetupPaymentOnEnd>;
+/**
+ * Free trial configuration for a plan.
+ */
+type SetupPaymentFreeTrialParams = {
+    /**
+     * Number of duration_type periods the trial lasts.
+     */
+    durationLength: number;
+    /**
+     * Unit of time for the trial ('day', 'month', 'year').
+     */
+    durationType?: SetupPaymentDurationType | undefined;
+    /**
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
+     */
+    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?: SetupPaymentOnEnd | undefined;
+};
 /**
  * Billing interval (e.g. 'month', 'year').
  */
@@ -11248,7 +11771,7 @@ type SetupPaymentAdditionalCurrency = {
  */
 type SetupPaymentBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -11800,11 +12323,15 @@ type SetupPaymentPlanItemFilter = {
      * 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;
 };
 /**
  * Unit of time for the trial ('day', 'month', 'year').
  */
-declare const SetupPaymentDurationType: {
+declare const SetupPaymentCustomizeDurationType: {
     readonly Day: "day";
     readonly Month: "month";
     readonly Year: "year";
@@ -11812,22 +12339,22 @@ declare const SetupPaymentDurationType: {
 /**
  * Unit of time for the trial ('day', 'month', 'year').
  */
-type SetupPaymentDurationType = ClosedEnum<typeof SetupPaymentDurationType>;
+type SetupPaymentCustomizeDurationType = ClosedEnum<typeof SetupPaymentCustomizeDurationType>;
 /**
  * Behavior when the trial ends. 'bill' charges the customer (default). 'revert' expires the trial and restores the customer's previous plan.
  */
-declare const SetupPaymentOnEnd: {
+declare const SetupPaymentCustomizeOnEnd: {
     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 SetupPaymentOnEnd = ClosedEnum<typeof SetupPaymentOnEnd>;
+type SetupPaymentCustomizeOnEnd = ClosedEnum<typeof SetupPaymentCustomizeOnEnd>;
 /**
  * Free trial configuration for a plan.
  */
-type SetupPaymentFreeTrialParams = {
+type SetupPaymentCustomizeFreeTrialParams = {
     /**
      * Number of duration_type periods the trial lasts.
      */
@@ -11835,15 +12362,15 @@ type SetupPaymentFreeTrialParams = {
     /**
      * Unit of time for the trial ('day', 'month', 'year').
      */
-    durationType?: SetupPaymentDurationType | undefined;
+    durationType?: SetupPaymentCustomizeDurationType | undefined;
     /**
-     * If true, payment method required to start trial. Customer is charged after trial ends.
+     * If true, a payment method is required to start the trial and the customer is charged when it ends. Defaults to false.
      */
     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?: SetupPaymentOnEnd | undefined;
+    onEnd?: SetupPaymentCustomizeOnEnd | undefined;
 };
 /**
  * The time interval for the purchase limit window.
@@ -12096,7 +12623,7 @@ type SetupPaymentUpsertLicenseAdditionalCurrency = {
  */
 type SetupPaymentUpsertLicenseBasePrice = {
     /**
-     * Base price amount for the plan.
+     * Base price amount for the plan, in major currency units (e.g. dollars).
      */
     amount: number;
     /**
@@ -12392,6 +12919,10 @@ type SetupPaymentUpsertLicensePlanItemFilter = {
      * 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 SetupPaymentUpsertLicenseCustomize = {
     price?: SetupPaymentUpsertLicenseBasePrice | null | undefined;
@@ -12407,6 +12938,9 @@ type SetupPaymentUpsertLicense = {
         [k: string]: any;
     } | undefined;
 };
+type SetupPaymentRemoveLicense = {
+    licensePlanId: string;
+};
 /**
  * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
  */
@@ -12430,7 +12964,7 @@ 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;
+    freeTrial?: SetupPaymentCustomizeFreeTrialParams | null | undefined;
     /**
      * Override the plan's billing controls (auto top-ups, spend limits, usage limits, usage alerts, overage allowed) for this customer.
      */
@@ -12439,6 +12973,10 @@ type SetupPaymentCustomize = {
      * 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<SetupPaymentUpsertLicense> | undefined;
+    /**
+     * License links to drop, keyed by license_plan_id. Parallel to remove_items.
+     */
+    removeLicenses?: Array<SetupPaymentRemoveLicense> | undefined;
 };
 /**
  * How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.
@@ -12531,6 +13069,10 @@ type SetupPaymentParams = {
      * The version of the plan to attach.
      */
     version?: number | undefined;
+    /**
+     * Free trial for this plan. A shorthand for customize.free_trial, which takes precedence when both are given.
+     */
+    freeTrial?: SetupPaymentFreeTrialParams | null | undefined;
     /**
      * Customize the plan to attach. Can override the price, items, licenses, free trial, or a combination.
      */
@@ -12552,9 +13094,9 @@ type SetupPaymentParams = {
      */
     successUrl?: string | undefined;
     /**
-     * Reset the billing cycle anchor immediately with 'now'.
+     * Reset the billing cycle immediately with 'now', or schedule a reset at a future Unix timestamp in milliseconds.
      */
-    billingCycleAnchor?: "now" | undefined;
+    billingCycleAnchor?: string | number | undefined;
     /**
      * Unix timestamp in milliseconds for when the attached plan should start. Future dates create a scheduled subscription.
      */
@@ -12600,7 +13142,7 @@ type SetupPaymentParams = {
      */
     noBillingChanges?: boolean | undefined;
     /**
-     * If true, the customer's plan is activated immediately even when payment is deferred (invoice mode) or pending (Stripe checkout). For Stripe checkout, the customer_product is inserted before the customer completes the hosted form.
+     * If true, the customer's plan is activated immediately even when payment is deferred (invoice mode) or pending (Stripe checkout). For Stripe checkout, the customer_product is inserted before the customer completes the hosted form. Set it here rather than on `invoice_mode`, which only covers the invoice-unpaid case.
      */
     enablePlanImmediately?: boolean | undefined;
     /**