autumn-js 1.2.35 → 1.2.37

package/dist/backend/{routeTypes-CX_fRpB1.d.ts → routeTypes-B0zHyzyX.d.ts}

@@ -1,4 +1,4 @@
-import { b as ClosedEnum, O as OpenEnum, c as CustomerExpand, G as GetOrCreateCustomerParams, R as ResolvedIdentity } from './authTypes-B33BAaz1.js';
+import { b as ClosedEnum, O as OpenEnum, c as CustomerExpand, G as GetOrCreateCustomerParams, R as ResolvedIdentity } from './authTypes-jU7ON-I5.js';
 import { z } from 'zod/v4';
 import { ProtectedBodyField } from './core/utils/sanitizeBody.js';
 import { BackendResult } from './core/types/responseTypes.js';
@@ -888,6 +888,10 @@ type AttachSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -902,6 +906,14 @@ declare const AttachUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type AttachUsageLimitInterval = ClosedEnum<typeof AttachUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type AttachFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type AttachUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -919,6 +931,10 @@ type AttachUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: AttachUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: AttachFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -1273,6 +1289,7 @@ declare const AttachCode: {
     readonly ThreedsRequired: "3ds_required";
     readonly PaymentMethodRequired: "payment_method_required";
     readonly PaymentFailed: "payment_failed";
+    readonly PaymentProcessing: "payment_processing";
 };
 /**
  * The type of action required to complete the payment.
@@ -2292,6 +2309,10 @@ type BillingUpdateSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -2306,6 +2327,14 @@ declare const BillingUpdateUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type BillingUpdateUsageLimitInterval = ClosedEnum<typeof BillingUpdateUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type BillingUpdateFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type BillingUpdateUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -2323,6 +2352,10 @@ type BillingUpdateUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: BillingUpdateUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: BillingUpdateFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -2496,6 +2529,17 @@ declare const BillingUpdateCancelAction: {
  * Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation.
  */
 type BillingUpdateCancelAction = ClosedEnum<typeof BillingUpdateCancelAction>;
+/**
+ * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ */
+declare const BillingUpdateRefundLastPayment: {
+    readonly Prorated: "prorated";
+    readonly Full: "full";
+};
+/**
+ * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ */
+type BillingUpdateRefundLastPayment = ClosedEnum<typeof BillingUpdateRefundLastPayment>;
 /**
  * Controls whether balances should be recalculated during the subscription update.
  */
@@ -2575,6 +2619,10 @@ type UpdateSubscriptionParams = {
      * If true, the subscription is updated internally without applying billing changes in Stripe.
      */
     noBillingChanges?: boolean | undefined;
+    /**
+     * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+     */
+    refundLastPayment?: BillingUpdateRefundLastPayment | undefined;
     /**
      * Controls whether balances should be recalculated during the subscription update.
      */
@@ -2616,6 +2664,7 @@ declare const BillingUpdateCode: {
     readonly ThreedsRequired: "3ds_required";
     readonly PaymentMethodRequired: "payment_method_required";
     readonly PaymentFailed: "payment_failed";
+    readonly PaymentProcessing: "payment_processing";
 };
 /**
  * The type of action required to complete the payment.
@@ -3123,6 +3172,10 @@ type CheckSpendLimit2 = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -3137,6 +3190,14 @@ declare const CheckUsageLimitInterval2: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type CheckUsageLimitInterval2 = OpenEnum<typeof CheckUsageLimitInterval2>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type CheckFilter2 = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type CheckUsageLimit2 = {
     /**
      * The feature this usage limit applies to.
@@ -3154,6 +3215,10 @@ type CheckUsageLimit2 = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: CheckUsageLimitInterval2;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: CheckFilter2 | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -3244,7 +3309,7 @@ declare const ProductScenario2: {
  * Scenario for when this product is used in attach flows
  */
 type ProductScenario2 = OpenEnum<typeof ProductScenario2>;
-type Properties2 = {
+type CheckProperties2 = {
     /**
      * True if the product has no base price or usage prices
      */
@@ -3323,7 +3388,7 @@ type CheckProduct2 = {
      * Scenario for when this product is used in attach flows
      */
     scenario?: ProductScenario2 | undefined;
-    properties?: Properties2 | undefined;
+    properties?: CheckProperties2 | undefined;
 };
 /**
  * Upgrade/upsell information when access is denied. Only present if with_preview was true and allowed is false.
@@ -3803,6 +3868,10 @@ type CheckSpendLimit1 = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -3817,6 +3886,14 @@ declare const CheckUsageLimitInterval1: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type CheckUsageLimitInterval1 = OpenEnum<typeof CheckUsageLimitInterval1>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type CheckFilter1 = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type CheckUsageLimit1 = {
     /**
      * The feature this usage limit applies to.
@@ -3834,6 +3911,10 @@ type CheckUsageLimit1 = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: CheckUsageLimitInterval1;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: CheckFilter1 | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -3924,7 +4005,7 @@ declare const ProductScenario1: {
  * Scenario for when this product is used in attach flows
  */
 type ProductScenario1 = OpenEnum<typeof ProductScenario1>;
-type Properties1 = {
+type CheckProperties1 = {
     /**
      * True if the product has no base price or usage prices
      */
@@ -4003,7 +4084,7 @@ type CheckProduct1 = {
      * Scenario for when this product is used in attach flows
      */
     scenario?: ProductScenario1 | undefined;
-    properties?: Properties1 | undefined;
+    properties?: CheckProperties1 | undefined;
 };
 /**
  * Upgrade/upsell information when access is denied. Only present if with_preview was true and allowed is false.
@@ -4253,6 +4334,10 @@ type CustomerDataSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -4267,6 +4352,14 @@ declare const CustomerDataUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type CustomerDataUsageLimitInterval = ClosedEnum<typeof CustomerDataUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type CustomerDataFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type CustomerDataUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -4284,6 +4377,10 @@ type CustomerDataUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: CustomerDataUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: CustomerDataFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -5168,6 +5265,10 @@ type PlanVariantDetailsSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -5182,6 +5283,14 @@ declare const PlanVariantDetailsUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type PlanVariantDetailsUsageLimitInterval = OpenEnum<typeof PlanVariantDetailsUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type PlanVariantDetailsFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type PlanVariantDetailsUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -5199,6 +5308,10 @@ type PlanVariantDetailsUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: PlanVariantDetailsUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: PlanVariantDetailsFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -5401,6 +5514,10 @@ type PlanSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -5415,6 +5532,14 @@ declare const PlanUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type PlanUsageLimitInterval = OpenEnum<typeof PlanUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type PlanFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type PlanUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -5432,6 +5557,10 @@ type PlanUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: PlanUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: PlanFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -5656,6 +5785,10 @@ type CreateEntitySpendLimitRequest = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -5670,6 +5803,14 @@ declare const CreateEntityIntervalRequestBody: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type CreateEntityIntervalRequestBody = ClosedEnum<typeof CreateEntityIntervalRequestBody>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type CreateEntityFilterRequest = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type CreateEntityUsageLimitRequest = {
     /**
      * The feature this usage limit applies to.
@@ -5687,6 +5828,10 @@ type CreateEntityUsageLimitRequest = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: CreateEntityIntervalRequestBody;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: CreateEntityFilterRequest | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -6053,6 +6198,10 @@ type CreateEntitySpendLimitResponse = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -6067,6 +6216,14 @@ declare const CreateEntityIntervalResponse: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type CreateEntityIntervalResponse = OpenEnum<typeof CreateEntityIntervalResponse>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type CreateEntityFilterResponse = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type CreateEntityUsageLimitResponse = {
     /**
      * The feature this usage limit applies to.
@@ -6084,6 +6241,10 @@ type CreateEntityUsageLimitResponse = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: CreateEntityIntervalResponse;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: CreateEntityFilterResponse | undefined;
     /**
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
@@ -6794,6 +6955,10 @@ type CreatePlanSpendLimitRequest = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -6808,6 +6973,14 @@ declare const CreatePlanUsageLimitIntervalRequestBody: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type CreatePlanUsageLimitIntervalRequestBody = ClosedEnum<typeof CreatePlanUsageLimitIntervalRequestBody>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type CreatePlanFilterRequest = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type CreatePlanUsageLimitRequest = {
     /**
      * The feature this usage limit applies to.
@@ -6825,6 +6998,10 @@ type CreatePlanUsageLimitRequest = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: CreatePlanUsageLimitIntervalRequestBody;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: CreatePlanFilterRequest | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -7701,6 +7878,10 @@ type CreatePlanVariantDetailsSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -7715,6 +7896,14 @@ declare const CreatePlanVariantDetailsUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type CreatePlanVariantDetailsUsageLimitInterval = OpenEnum<typeof CreatePlanVariantDetailsUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type CreatePlanVariantDetailsFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type CreatePlanVariantDetailsUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -7732,6 +7921,10 @@ type CreatePlanVariantDetailsUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: CreatePlanVariantDetailsUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: CreatePlanVariantDetailsFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -7934,6 +8127,10 @@ type CreatePlanSpendLimitResponse = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -7948,6 +8145,14 @@ declare const CreatePlanUsageLimitIntervalResponse: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type CreatePlanUsageLimitIntervalResponse = OpenEnum<typeof CreatePlanUsageLimitIntervalResponse>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type CreatePlanFilterResponse = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type CreatePlanUsageLimitResponse = {
     /**
      * The feature this usage limit applies to.
@@ -7965,6 +8170,10 @@ type CreatePlanUsageLimitResponse = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: CreatePlanUsageLimitIntervalResponse;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: CreatePlanFilterResponse | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -8875,6 +9084,10 @@ type CreateScheduleSpendLimit2 = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -8889,6 +9102,14 @@ declare const CreateScheduleUsageLimitInterval2: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type CreateScheduleUsageLimitInterval2 = ClosedEnum<typeof CreateScheduleUsageLimitInterval2>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type CreateScheduleFilter2 = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type CreateScheduleUsageLimit2 = {
     /**
      * The feature this usage limit applies to.
@@ -8906,6 +9127,10 @@ type CreateScheduleUsageLimit2 = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: CreateScheduleUsageLimitInterval2;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: CreateScheduleFilter2 | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -9157,6 +9382,7 @@ declare const CreateScheduleCode: {
     readonly ThreedsRequired: "3ds_required";
     readonly PaymentMethodRequired: "payment_method_required";
     readonly PaymentFailed: "payment_failed";
+    readonly PaymentProcessing: "payment_processing";
 };
 /**
  * The type of action required to complete the payment.
@@ -9328,6 +9554,10 @@ type CustomerSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -9342,6 +9572,14 @@ declare const CustomerUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type CustomerUsageLimitInterval = OpenEnum<typeof CustomerUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type CustomerFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type CustomerUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -9359,6 +9597,10 @@ type CustomerUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: CustomerUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: CustomerFilter | undefined;
     /**
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
@@ -10293,6 +10535,10 @@ type GetCustomerSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -10307,6 +10553,14 @@ declare const GetCustomerUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type GetCustomerUsageLimitInterval = OpenEnum<typeof GetCustomerUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type GetCustomerFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type GetCustomerUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -10324,6 +10578,10 @@ type GetCustomerUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: GetCustomerUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: GetCustomerFilter | undefined;
     /**
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
@@ -11253,6 +11511,10 @@ type GetEntitySpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -11267,6 +11529,14 @@ declare const GetEntityInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type GetEntityInterval = OpenEnum<typeof GetEntityInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type GetEntityFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type GetEntityUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -11284,6 +11554,10 @@ type GetEntityUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: GetEntityInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: GetEntityFilter | undefined;
     /**
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
@@ -12312,6 +12586,10 @@ type GetPlanVariantDetailsSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -12326,6 +12604,14 @@ declare const GetPlanVariantDetailsUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type GetPlanVariantDetailsUsageLimitInterval = OpenEnum<typeof GetPlanVariantDetailsUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type GetPlanVariantDetailsFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type GetPlanVariantDetailsUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -12343,6 +12629,10 @@ type GetPlanVariantDetailsUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: GetPlanVariantDetailsUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: GetPlanVariantDetailsFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -12545,6 +12835,10 @@ type GetPlanSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -12559,6 +12853,14 @@ declare const GetPlanUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type GetPlanUsageLimitInterval = OpenEnum<typeof GetPlanUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type GetPlanFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type GetPlanUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -12576,6 +12878,10 @@ type GetPlanUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: GetPlanUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: GetPlanFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -12873,7 +13179,7 @@ declare class ConnectionError extends HTTPClientError {
 }
 
 /**
- * Optional identity fields to upsert if the customer is new.
+ * Optional identity fields upserted onto the customer (applied to existing customers too).
  */
 type ImportCustomerData = {
     /**
@@ -12959,34 +13265,39 @@ type ImportFeatureQuantity = {
     quantity: number;
 };
 declare const ImportInterval: {
+    readonly Lifetime: "lifetime";
+    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 ImportInterval = ClosedEnum<typeof ImportInterval>;
 /**
- * Selects the included vs prepaid entitlement line when a feature has both.
+ * Selects the included vs prepaid vs usage-based (pay-per-use) entitlement line when a feature has several.
  */
 declare const ImportBillingBehavior: {
     readonly Included: "included";
     readonly Prepaid: "prepaid";
+    readonly UsageBased: "usage_based";
 };
 /**
- * Selects the included vs prepaid entitlement line when a feature has both.
+ * Selects the included vs prepaid vs usage-based (pay-per-use) entitlement line when a feature has several.
  */
 type ImportBillingBehavior = ClosedEnum<typeof ImportBillingBehavior>;
 /**
  * Disambiguates which entitlement line to target when the feature has multiple.
  */
-type Filter = {
+type ImportFilter = {
     /**
-     * Reset interval selecting which entitlement line to target when a feature has several (null = the non-resetting one-off line).
+     * Reset interval selecting which entitlement line to target when a feature has several ('lifetime' or null = the non-resetting one-off line).
      */
     interval?: ImportInterval | null | undefined;
     /**
-     * Selects the included vs prepaid entitlement line when a feature has both.
+     * Selects the included vs prepaid vs usage-based (pay-per-use) entitlement line when a feature has several.
      */
     billingBehavior?: ImportBillingBehavior | undefined;
 };
@@ -12998,7 +13309,7 @@ type ImportBalance = {
     /**
      * Disambiguates which entitlement line to target when the feature has multiple.
      */
-    filter?: Filter | undefined;
+    filter?: ImportFilter | undefined;
     /**
      * Units already consumed; remaining balance is derived from the plan allowance minus this.
      */
@@ -13069,7 +13380,7 @@ type DfuFlashParams = {
      */
     customerId: string;
     /**
-     * Optional identity fields to upsert if the customer is new.
+     * Optional identity fields upserted onto the customer (applied to existing customers too).
      */
     customerData?: ImportCustomerData | undefined;
     /**
@@ -13323,6 +13634,10 @@ type ListCustomersSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -13337,6 +13652,14 @@ declare const ListCustomersUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type ListCustomersUsageLimitInterval = OpenEnum<typeof ListCustomersUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type ListCustomersFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type ListCustomersUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -13354,6 +13677,10 @@ type ListCustomersUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: ListCustomersUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: ListCustomersFilter | undefined;
     /**
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
@@ -14134,6 +14461,10 @@ type ListEntitiesSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -14148,6 +14479,14 @@ declare const ListEntitiesInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type ListEntitiesInterval = OpenEnum<typeof ListEntitiesInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type ListEntitiesFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type ListEntitiesUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -14165,6 +14504,10 @@ type ListEntitiesUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: ListEntitiesInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: ListEntitiesFilter | undefined;
     /**
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
@@ -15342,6 +15685,10 @@ type ListPlansVariantDetailsSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -15356,6 +15703,14 @@ declare const ListPlansVariantDetailsUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type ListPlansVariantDetailsUsageLimitInterval = OpenEnum<typeof ListPlansVariantDetailsUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type ListPlansVariantDetailsFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type ListPlansVariantDetailsUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -15373,6 +15728,10 @@ type ListPlansVariantDetailsUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: ListPlansVariantDetailsUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: ListPlansVariantDetailsFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -15575,6 +15934,10 @@ type ListPlansSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -15589,6 +15952,14 @@ declare const ListPlansUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type ListPlansUsageLimitInterval = OpenEnum<typeof ListPlansUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type ListPlansFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type ListPlansUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -15606,6 +15977,10 @@ type ListPlansUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: ListPlansUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: ListPlansFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -16424,6 +16799,10 @@ type MultiAttachSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -16438,6 +16817,14 @@ declare const MultiAttachEntityDataInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type MultiAttachEntityDataInterval = ClosedEnum<typeof MultiAttachEntityDataInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type MultiAttachFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type MultiAttachUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -16455,6 +16842,10 @@ type MultiAttachUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: MultiAttachEntityDataInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: MultiAttachFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -16621,6 +17012,7 @@ declare const MultiAttachCode: {
     readonly ThreedsRequired: "3ds_required";
     readonly PaymentMethodRequired: "payment_method_required";
     readonly PaymentFailed: "payment_failed";
+    readonly PaymentProcessing: "payment_processing";
 };
 /**
  * The type of action required to complete the payment.
@@ -17335,6 +17727,10 @@ type PreviewAttachSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -17349,6 +17745,14 @@ declare const PreviewAttachUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type PreviewAttachUsageLimitInterval = ClosedEnum<typeof PreviewAttachUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type PreviewAttachFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type PreviewAttachUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -17366,6 +17770,10 @@ type PreviewAttachUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: PreviewAttachUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: PreviewAttachFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -18445,6 +18853,10 @@ type PreviewMultiAttachSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -18459,6 +18871,14 @@ declare const PreviewMultiAttachEntityDataInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type PreviewMultiAttachEntityDataInterval = ClosedEnum<typeof PreviewMultiAttachEntityDataInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type PreviewMultiAttachFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type PreviewMultiAttachUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -18476,6 +18896,10 @@ type PreviewMultiAttachUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: PreviewMultiAttachEntityDataInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: PreviewMultiAttachFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -19597,6 +20021,10 @@ type PreviewUpdateSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -19611,6 +20039,14 @@ declare const PreviewUpdateUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type PreviewUpdateUsageLimitInterval = ClosedEnum<typeof PreviewUpdateUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type PreviewUpdateFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type PreviewUpdateUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -19628,6 +20064,10 @@ type PreviewUpdateUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: PreviewUpdateUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: PreviewUpdateFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -19801,6 +20241,17 @@ declare const PreviewUpdateCancelAction: {
  * Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation.
  */
 type PreviewUpdateCancelAction = ClosedEnum<typeof PreviewUpdateCancelAction>;
+/**
+ * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ */
+declare const PreviewUpdateRefundLastPayment: {
+    readonly Prorated: "prorated";
+    readonly Full: "full";
+};
+/**
+ * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+ */
+type PreviewUpdateRefundLastPayment = ClosedEnum<typeof PreviewUpdateRefundLastPayment>;
 /**
  * Controls whether balances should be recalculated during the subscription update.
  */
@@ -19880,6 +20331,10 @@ type PreviewUpdateParams = {
      * If true, the subscription is updated internally without applying billing changes in Stripe.
      */
     noBillingChanges?: boolean | undefined;
+    /**
+     * Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment.
+     */
+    refundLastPayment?: PreviewUpdateRefundLastPayment | undefined;
     /**
      * Controls whether balances should be recalculated during the subscription update.
      */
@@ -20977,6 +21432,10 @@ type SetupPaymentSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -20991,6 +21450,14 @@ declare const SetupPaymentUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type SetupPaymentUsageLimitInterval = ClosedEnum<typeof SetupPaymentUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type SetupPaymentFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type SetupPaymentUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -21008,6 +21475,10 @@ type SetupPaymentUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: SetupPaymentUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: SetupPaymentFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -21947,6 +22418,10 @@ type UpdateCustomerSpendLimitRequest = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -21961,6 +22436,14 @@ declare const UpdateCustomerUsageLimitIntervalRequestBody: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type UpdateCustomerUsageLimitIntervalRequestBody = ClosedEnum<typeof UpdateCustomerUsageLimitIntervalRequestBody>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type UpdateCustomerFilterRequest = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type UpdateCustomerUsageLimitRequest = {
     /**
      * The feature this usage limit applies to.
@@ -21978,6 +22461,10 @@ type UpdateCustomerUsageLimitRequest = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: UpdateCustomerUsageLimitIntervalRequestBody;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: UpdateCustomerFilterRequest | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -22227,6 +22714,10 @@ type UpdateCustomerSpendLimitResponse = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -22241,6 +22732,14 @@ declare const UpdateCustomerUsageLimitIntervalResponse: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type UpdateCustomerUsageLimitIntervalResponse = OpenEnum<typeof UpdateCustomerUsageLimitIntervalResponse>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type UpdateCustomerFilterResponse = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type UpdateCustomerUsageLimitResponse = {
     /**
      * The feature this usage limit applies to.
@@ -22258,6 +22757,10 @@ type UpdateCustomerUsageLimitResponse = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: UpdateCustomerUsageLimitIntervalResponse;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: UpdateCustomerFilterResponse | undefined;
     /**
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
@@ -22732,6 +23235,10 @@ type UpdateEntitySpendLimitRequest = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -22746,6 +23253,14 @@ declare const UpdateEntityIntervalRequestBody: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type UpdateEntityIntervalRequestBody = ClosedEnum<typeof UpdateEntityIntervalRequestBody>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type UpdateEntityFilterRequest = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type UpdateEntityUsageLimitRequest = {
     /**
      * The feature this usage limit applies to.
@@ -22763,6 +23278,10 @@ type UpdateEntityUsageLimitRequest = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: UpdateEntityIntervalRequestBody;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: UpdateEntityFilterRequest | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -23117,6 +23636,10 @@ type UpdateEntitySpendLimitResponse = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -23131,6 +23654,14 @@ declare const UpdateEntityIntervalResponse: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type UpdateEntityIntervalResponse = OpenEnum<typeof UpdateEntityIntervalResponse>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type UpdateEntityFilterResponse = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type UpdateEntityUsageLimitResponse = {
     /**
      * The feature this usage limit applies to.
@@ -23148,6 +23679,10 @@ type UpdateEntityUsageLimitResponse = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: UpdateEntityIntervalResponse;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: UpdateEntityFilterResponse | undefined;
     /**
      * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
      */
@@ -23866,6 +24401,10 @@ type UpdatePlanSpendLimitRequest = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -23880,6 +24419,14 @@ declare const UpdatePlanUsageLimitIntervalRequestBody: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type UpdatePlanUsageLimitIntervalRequestBody = ClosedEnum<typeof UpdatePlanUsageLimitIntervalRequestBody>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type UpdatePlanFilterRequest = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type UpdatePlanUsageLimitRequest = {
     /**
      * The feature this usage limit applies to.
@@ -23897,6 +24444,10 @@ type UpdatePlanUsageLimitRequest = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: UpdatePlanUsageLimitIntervalRequestBody;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: UpdatePlanFilterRequest | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -24391,6 +24942,10 @@ type VariantSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -24405,6 +24960,14 @@ declare const VariantUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type VariantUsageLimitInterval = ClosedEnum<typeof VariantUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type VariantFilter = {
+    properties: {
+        [k: string]: string | number | boolean;
+    };
+};
 type VariantUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -24422,6 +24985,10 @@ type VariantUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: VariantUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: VariantFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -25382,6 +25949,10 @@ type UpdatePlanVariantDetailsSpendLimit = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -25396,6 +25967,14 @@ declare const UpdatePlanVariantDetailsUsageLimitInterval: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type UpdatePlanVariantDetailsUsageLimitInterval = OpenEnum<typeof UpdatePlanVariantDetailsUsageLimitInterval>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type UpdatePlanVariantDetailsFilter = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type UpdatePlanVariantDetailsUsageLimit = {
     /**
      * The feature this usage limit applies to.
@@ -25413,6 +25992,10 @@ type UpdatePlanVariantDetailsUsageLimit = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: UpdatePlanVariantDetailsUsageLimitInterval;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: UpdatePlanVariantDetailsFilter | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -25615,6 +26198,10 @@ type UpdatePlanSpendLimitResponse = {
      * Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage.
      */
     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;
 };
 /**
  * Interval for the cap, aligned to the customer's billing cycle.
@@ -25629,6 +26216,14 @@ declare const UpdatePlanUsageLimitIntervalResponse: {
  * Interval for the cap, aligned to the customer's billing cycle.
  */
 type UpdatePlanUsageLimitIntervalResponse = OpenEnum<typeof UpdatePlanUsageLimitIntervalResponse>;
+/**
+ * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+ */
+type UpdatePlanFilterResponse = {
+    properties: {
+        [k: string]: any;
+    };
+};
 type UpdatePlanUsageLimitResponse = {
     /**
      * The feature this usage limit applies to.
@@ -25646,6 +26241,10 @@ type UpdatePlanUsageLimitResponse = {
      * Interval for the cap, aligned to the customer's billing cycle.
      */
     interval: UpdatePlanUsageLimitIntervalResponse;
+    /**
+     * When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature.
+     */
+    filter?: UpdatePlanFilterResponse | undefined;
 };
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
@@ -26097,7 +26696,7 @@ declare class Billing extends ClientSDK {
      * @example
      * ```typescript
      * // Schedule a transition from a trial plan to a paid plan
-     * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1783265198891,"plans":[{"planId":"trial_plan"}]},{"startsAt":1784474798891,"plans":[{"planId":"pro_plan"}]}] });
+     * const response = await client.billing.createSchedule({ customerId: "cus_123", phases: [{"startsAt":1783539171816,"plans":[{"planId":"trial_plan"}]},{"startsAt":1784748771816,"plans":[{"planId":"pro_plan"}]}] });
      * ```
      *
      * @param customerId - The ID of the customer to create the schedule for.
@@ -26258,6 +26857,7 @@ declare class Billing extends ClientSDK {
      * @param cancelAction - Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation. (optional)
      * @param billingCycleAnchor - Reset the billing cycle anchor immediately with 'now' (optional)
      * @param noBillingChanges - If true, the subscription is updated internally without applying billing changes in Stripe. (optional)
+     * @param refundLastPayment - Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment. (optional)
      * @param recalculateBalances - Controls whether balances should be recalculated during the subscription update. (optional)
      * @param carryOverUsages - Whether to carry over usages from the previous plan. (optional)
      *
@@ -26289,6 +26889,7 @@ declare class Billing extends ClientSDK {
      * @param cancelAction - Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation. (optional)
      * @param billingCycleAnchor - Reset the billing cycle anchor immediately with 'now' (optional)
      * @param noBillingChanges - If true, the subscription is updated internally without applying billing changes in Stripe. (optional)
+     * @param refundLastPayment - Controls how the last payment is refunded on immediate cancellation. 'prorated' refunds the unused portion, 'full' refunds the entire last payment. (optional)
      * @param recalculateBalances - Controls whether balances should be recalculated during the subscription update. (optional)
      * @param carryOverUsages - Whether to carry over usages from the previous plan. (optional)
      *