autumn-js 1.2.28 → 1.2.29

package/dist/react/{params-CeTb8jcT.d.mts → params-DiohUULB.d.ts}

@@ -1,4 +1,4 @@
-import { C as ClosedEnum, O as OpenEnum, B as Balance, P as Plan } from './plan-CRa-NBw0.mjs';
+import { C as ClosedEnum, O as OpenEnum, a as Balance, P as Plan } from './plan-2RG0aPsm.js';
 
 /**
  * Time range to aggregate events for. Either range or custom_range must be provided
@@ -22,6 +22,7 @@ type Range = ClosedEnum<typeof Range>;
 declare const BinSize: {
     readonly Day: "day";
     readonly Hour: "hour";
+    readonly Week: "week";
     readonly Month: "month";
 };
 /**
@@ -267,9 +268,9 @@ type AttachItemPrice = {
      */
     billingMethod: AttachItemBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -473,9 +474,9 @@ type AttachAddItemPrice = {
      */
     billingMethod: AttachAddItemBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -593,21 +594,27 @@ declare const AttachRemoveItemBillingMethod: {
  * Match items with this billing method (prepaid or usage_based).
  */
 type AttachRemoveItemBillingMethod = ClosedEnum<typeof AttachRemoveItemBillingMethod>;
-/**
- * Match items with this interval.
- */
-declare const AttachRemoveItemInterval: {
+declare const AttachIntervalRemoveItemEnum2: {
     readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
     readonly Quarter: "quarter";
     readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-/**
- * Match items with this interval.
- */
-type AttachRemoveItemInterval = ClosedEnum<typeof AttachRemoveItemInterval>;
+type AttachIntervalRemoveItemEnum2 = ClosedEnum<typeof AttachIntervalRemoveItemEnum2>;
+declare const AttachIntervalRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type AttachIntervalRemoveItemEnum1 = ClosedEnum<typeof AttachIntervalRemoveItemEnum1>;
 /**
  * Filter for matching plan items. All provided fields must match (AND).
  */
@@ -621,9 +628,13 @@ type AttachPlanItemFilter = {
      */
     billingMethod?: AttachRemoveItemBillingMethod | undefined;
     /**
-     * Match items with this interval.
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     */
+    interval?: AttachIntervalRemoveItemEnum1 | AttachIntervalRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
      */
-    interval?: AttachRemoveItemInterval | undefined;
+    intervalCount?: number | undefined;
 };
 /**
  * Unit of time for the trial ('day', 'month', 'year').
@@ -678,7 +689,7 @@ type AttachCustomize = {
      */
     price?: AttachBasePrice | null | undefined;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / update_items.
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
      */
     items?: Array<AttachItemPlanItem> | undefined;
     /**
@@ -1134,9 +1145,9 @@ type BillingUpdateItemPrice = {
      */
     billingMethod: BillingUpdateItemBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -1340,9 +1351,9 @@ type BillingUpdateAddItemPrice = {
      */
     billingMethod: BillingUpdateAddItemBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -1460,21 +1471,27 @@ declare const BillingUpdateRemoveItemBillingMethod: {
  * Match items with this billing method (prepaid or usage_based).
  */
 type BillingUpdateRemoveItemBillingMethod = ClosedEnum<typeof BillingUpdateRemoveItemBillingMethod>;
-/**
- * Match items with this interval.
- */
-declare const BillingUpdateRemoveItemInterval: {
+declare const BillingUpdateIntervalRemoveItemEnum2: {
     readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
     readonly Quarter: "quarter";
     readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-/**
- * Match items with this interval.
- */
-type BillingUpdateRemoveItemInterval = ClosedEnum<typeof BillingUpdateRemoveItemInterval>;
+type BillingUpdateIntervalRemoveItemEnum2 = ClosedEnum<typeof BillingUpdateIntervalRemoveItemEnum2>;
+declare const BillingUpdateIntervalRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type BillingUpdateIntervalRemoveItemEnum1 = ClosedEnum<typeof BillingUpdateIntervalRemoveItemEnum1>;
 /**
  * Filter for matching plan items. All provided fields must match (AND).
  */
@@ -1488,9 +1505,13 @@ type BillingUpdatePlanItemFilter = {
      */
     billingMethod?: BillingUpdateRemoveItemBillingMethod | undefined;
     /**
-     * Match items with this interval.
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
      */
-    interval?: BillingUpdateRemoveItemInterval | undefined;
+    interval?: BillingUpdateIntervalRemoveItemEnum1 | BillingUpdateIntervalRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     */
+    intervalCount?: number | undefined;
 };
 /**
  * Unit of time for the trial ('day', 'month', 'year').
@@ -1545,7 +1566,7 @@ type BillingUpdateCustomize = {
      */
     price?: BillingUpdateBasePrice | null | undefined;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / update_items.
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
      */
     items?: Array<BillingUpdateItemPlanItem> | undefined;
     /**
@@ -1835,15 +1856,16 @@ type CheckParams = {
     withPreview?: boolean | undefined;
 };
 /**
- * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
+ * 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.
  */
 declare const FlagType2: {
     readonly Boolean: "boolean";
     readonly Metered: "metered";
     readonly CreditSystem: "credit_system";
+    readonly AiCreditSystem: "ai_credit_system";
 };
 /**
- * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
+ * 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 = {
@@ -1856,6 +1878,14 @@ type CheckCreditSchema2 = {
      */
     creditCost: number;
 };
+type CheckModelMarkups2 = {
+    markup?: number | undefined;
+    inputCost?: number | undefined;
+    outputCost?: number | undefined;
+};
+type CheckProviderMarkups2 = {
+    markup: number;
+};
 /**
  * Display names for the feature in billing UI and customer-facing components.
  */
@@ -1882,7 +1912,7 @@ type CheckFeature2 = {
      */
     name: string;
     /**
-     * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
+     * 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;
     /**
@@ -1897,6 +1927,22 @@ type CheckFeature2 = {
      * For credit_system features: maps metered features to their credit costs.
      */
     creditSchema?: Array<CheckCreditSchema2> | undefined;
+    /**
+     * Per-model markup overrides for AI credit systems.
+     */
+    modelMarkups?: {
+        [k: string]: CheckModelMarkups2;
+    } | null | undefined;
+    /**
+     * Default percentage markup for AI credit systems. Use -100 to make usage free.
+     */
+    defaultMarkup?: number | undefined;
+    /**
+     * Per-provider default markup percentages for AI credit systems.
+     */
+    providerMarkups?: {
+        [k: string]: CheckProviderMarkups2;
+    } | null | undefined;
     /**
      * Display names for the feature in billing UI and customer-facing components.
      */
@@ -2300,15 +2346,16 @@ type CheckResponseBody2 = {
     preview?: Preview2 | undefined;
 };
 /**
- * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
+ * 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.
  */
 declare const FlagType1: {
     readonly Boolean: "boolean";
     readonly Metered: "metered";
     readonly CreditSystem: "credit_system";
+    readonly AiCreditSystem: "ai_credit_system";
 };
 /**
- * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
+ * 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 = {
@@ -2321,6 +2368,14 @@ type CheckCreditSchema1 = {
      */
     creditCost: number;
 };
+type CheckModelMarkups1 = {
+    markup?: number | undefined;
+    inputCost?: number | undefined;
+    outputCost?: number | undefined;
+};
+type CheckProviderMarkups1 = {
+    markup: number;
+};
 /**
  * Display names for the feature in billing UI and customer-facing components.
  */
@@ -2347,7 +2402,7 @@ type CheckFeature1 = {
      */
     name: string;
     /**
-     * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
+     * 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;
     /**
@@ -2362,6 +2417,22 @@ type CheckFeature1 = {
      * For credit_system features: maps metered features to their credit costs.
      */
     creditSchema?: Array<CheckCreditSchema1> | undefined;
+    /**
+     * Per-model markup overrides for AI credit systems.
+     */
+    modelMarkups?: {
+        [k: string]: CheckModelMarkups1;
+    } | null | undefined;
+    /**
+     * Default percentage markup for AI credit systems. Use -100 to make usage free.
+     */
+    defaultMarkup?: number | undefined;
+    /**
+     * Per-provider default markup percentages for AI credit systems.
+     */
+    providerMarkups?: {
+        [k: string]: CheckProviderMarkups1;
+    } | null | undefined;
     /**
      * Display names for the feature in billing UI and customer-facing components.
      */
@@ -2769,7 +2840,7 @@ type CheckResponse = CheckResponseBody1 | CheckResponseBody2;
 /**
  * The time interval for the purchase limit window.
  */
-declare const CustomerDataInterval: {
+declare const CustomerDataPurchaseLimitInterval: {
     readonly Hour: "hour";
     readonly Day: "day";
     readonly Week: "week";
@@ -2778,7 +2849,7 @@ declare const CustomerDataInterval: {
 /**
  * The time interval for the purchase limit window.
  */
-type CustomerDataInterval = ClosedEnum<typeof CustomerDataInterval>;
+type CustomerDataPurchaseLimitInterval = ClosedEnum<typeof CustomerDataPurchaseLimitInterval>;
 /**
  * Optional rate limit to cap how often auto top-ups occur.
  */
@@ -2786,7 +2857,7 @@ type CustomerDataPurchaseLimit = {
     /**
      * The time interval for the purchase limit window.
      */
-    interval: CustomerDataInterval;
+    interval: CustomerDataPurchaseLimitInterval;
     /**
      * Number of intervals in the purchase limit window.
      */
@@ -2828,7 +2899,7 @@ type CustomerDataSpendLimit = {
      */
     featureId?: string | undefined;
     /**
-     * Whether this spend limit is enabled.
+     * Whether the overage spend limit is enabled.
      */
     enabled?: boolean | undefined;
     /**
@@ -2836,6 +2907,33 @@ type CustomerDataSpendLimit = {
      */
     overageLimit?: number | undefined;
 };
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+declare const CustomerDataUsageLimitInterval: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+type CustomerDataUsageLimitInterval = ClosedEnum<typeof CustomerDataUsageLimitInterval>;
+type CustomerDataUsageLimit = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: CustomerDataUsageLimitInterval;
+};
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
@@ -2890,9 +2988,13 @@ type CustomerDataBillingControls = {
      */
     autoTopups?: Array<CustomerDataAutoTopup> | undefined;
     /**
-     * List of overage spend limits per feature.
+     * List of overage spend limits per feature (caps overage spend).
      */
     spendLimits?: Array<CustomerDataSpendLimit> | undefined;
+    /**
+     * List of hard usage caps per feature (max units per interval).
+     */
+    usageLimits?: Array<CustomerDataUsageLimit> | undefined;
     /**
      * List of usage alert configurations per feature.
      */
@@ -3124,15 +3226,16 @@ type GetEntityPurchase = {
     scope?: GetEntityPurchaseScope | undefined;
 };
 /**
- * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
+ * 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.
  */
 declare const GetEntityType: {
     readonly Boolean: "boolean";
     readonly Metered: "metered";
     readonly CreditSystem: "credit_system";
+    readonly AiCreditSystem: "ai_credit_system";
 };
 /**
- * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
+ * 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 = {
@@ -3145,6 +3248,14 @@ type GetEntityCreditSchema = {
      */
     creditCost: number;
 };
+type GetEntityModelMarkups = {
+    markup?: number | undefined;
+    inputCost?: number | undefined;
+    outputCost?: number | undefined;
+};
+type GetEntityProviderMarkups = {
+    markup: number;
+};
 /**
  * Display names for the feature in billing UI and customer-facing components.
  */
@@ -3171,7 +3282,7 @@ type GetEntityFeature = {
      */
     name: string;
     /**
-     * Feature type: 'boolean' for on/off access, 'metered' for usage-tracked features, 'credit_system' for unified credit pools.
+     * 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;
     /**
@@ -3186,6 +3297,22 @@ type GetEntityFeature = {
      * For credit_system features: maps metered features to their credit costs.
      */
     creditSchema?: Array<GetEntityCreditSchema> | undefined;
+    /**
+     * Per-model markup overrides for AI credit systems.
+     */
+    modelMarkups?: {
+        [k: string]: GetEntityModelMarkups;
+    } | null | undefined;
+    /**
+     * Default percentage markup for AI credit systems. Use -100 to make usage free.
+     */
+    defaultMarkup?: number | undefined;
+    /**
+     * Per-provider default markup percentages for AI credit systems.
+     */
+    providerMarkups?: {
+        [k: string]: GetEntityProviderMarkups;
+    } | null | undefined;
     /**
      * Display names for the feature in billing UI and customer-facing components.
      */
@@ -3223,7 +3350,7 @@ type GetEntitySpendLimit = {
      */
     featureId?: string | undefined;
     /**
-     * Whether this spend limit is enabled.
+     * Whether the overage spend limit is enabled.
      */
     enabled: boolean;
     /**
@@ -3231,6 +3358,37 @@ type GetEntitySpendLimit = {
      */
     overageLimit?: number | undefined;
 };
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+declare const GetEntityInterval: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+type GetEntityInterval = OpenEnum<typeof GetEntityInterval>;
+type GetEntityUsageLimit = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: GetEntityInterval;
+    /**
+     * Current usage already consumed in the active interval. Response-only; not stored on billing controls.
+     */
+    usage?: number | undefined;
+};
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
@@ -3281,9 +3439,13 @@ type GetEntityOverageAllowed = {
  */
 type GetEntityBillingControls = {
     /**
-     * List of overage spend limits per feature.
+     * List of spend limits per feature. Each entry caps overage (overage_limit) and/or per-interval usage (usage_limit).
      */
     spendLimits?: Array<GetEntitySpendLimit> | undefined;
+    /**
+     * List of hard usage caps per feature for this entity. An entity entry overrides the customer's for that feature.
+     */
+    usageLimits?: Array<GetEntityUsageLimit> | undefined;
     /**
      * List of usage alert configurations per feature.
      */
@@ -3646,9 +3808,9 @@ type MultiAttachPrice = {
      */
     billingMethod: MultiAttachBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -3907,7 +4069,7 @@ type MultiAttachSpendLimit = {
      */
     featureId?: string | undefined;
     /**
-     * Whether this spend limit is enabled.
+     * Whether the overage spend limit is enabled.
      */
     enabled?: boolean | undefined;
     /**
@@ -3915,6 +4077,33 @@ type MultiAttachSpendLimit = {
      */
     overageLimit?: number | undefined;
 };
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+declare const MultiAttachEntityDataInterval: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+type MultiAttachEntityDataInterval = ClosedEnum<typeof MultiAttachEntityDataInterval>;
+type MultiAttachUsageLimit = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: MultiAttachEntityDataInterval;
+};
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
@@ -3965,9 +4154,13 @@ type MultiAttachOverageAllowed = {
  */
 type MultiAttachBillingControls = {
     /**
-     * List of overage spend limits per feature.
+     * List of spend limits per feature. Each entry caps overage (overage_limit) and/or per-interval usage (usage_limit).
      */
     spendLimits?: Array<MultiAttachSpendLimit> | undefined;
+    /**
+     * List of hard usage caps per feature for this entity. An entity entry overrides the customer's for that feature.
+     */
+    usageLimits?: Array<MultiAttachUsageLimit> | undefined;
     /**
      * List of usage alert configurations per feature.
      */
@@ -4294,9 +4487,9 @@ type PreviewAttachItemPrice = {
      */
     billingMethod: PreviewAttachItemBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -4500,9 +4693,9 @@ type PreviewAttachAddItemPrice = {
      */
     billingMethod: PreviewAttachAddItemBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -4620,21 +4813,27 @@ declare const PreviewAttachRemoveItemBillingMethod: {
  * Match items with this billing method (prepaid or usage_based).
  */
 type PreviewAttachRemoveItemBillingMethod = ClosedEnum<typeof PreviewAttachRemoveItemBillingMethod>;
-/**
- * Match items with this interval.
- */
-declare const PreviewAttachRemoveItemInterval: {
+declare const PreviewAttachIntervalRemoveItemEnum2: {
     readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
     readonly Quarter: "quarter";
     readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-/**
- * Match items with this interval.
- */
-type PreviewAttachRemoveItemInterval = ClosedEnum<typeof PreviewAttachRemoveItemInterval>;
+type PreviewAttachIntervalRemoveItemEnum2 = ClosedEnum<typeof PreviewAttachIntervalRemoveItemEnum2>;
+declare const PreviewAttachIntervalRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type PreviewAttachIntervalRemoveItemEnum1 = ClosedEnum<typeof PreviewAttachIntervalRemoveItemEnum1>;
 /**
  * Filter for matching plan items. All provided fields must match (AND).
  */
@@ -4648,9 +4847,13 @@ type PreviewAttachPlanItemFilter = {
      */
     billingMethod?: PreviewAttachRemoveItemBillingMethod | undefined;
     /**
-     * Match items with this interval.
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     */
+    interval?: PreviewAttachIntervalRemoveItemEnum1 | PreviewAttachIntervalRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
      */
-    interval?: PreviewAttachRemoveItemInterval | undefined;
+    intervalCount?: number | undefined;
 };
 /**
  * Unit of time for the trial ('day', 'month', 'year').
@@ -4705,7 +4908,7 @@ type PreviewAttachCustomize = {
      */
     price?: PreviewAttachBasePrice | null | undefined;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / update_items.
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
      */
     items?: Array<PreviewAttachItemPlanItem> | undefined;
     /**
@@ -5413,9 +5616,9 @@ type PreviewMultiAttachPrice = {
      */
     billingMethod: PreviewMultiAttachBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -5674,7 +5877,7 @@ type PreviewMultiAttachSpendLimit = {
      */
     featureId?: string | undefined;
     /**
-     * Whether this spend limit is enabled.
+     * Whether the overage spend limit is enabled.
      */
     enabled?: boolean | undefined;
     /**
@@ -5682,6 +5885,33 @@ type PreviewMultiAttachSpendLimit = {
      */
     overageLimit?: number | undefined;
 };
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+declare const PreviewMultiAttachEntityDataInterval: {
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Year: "year";
+};
+/**
+ * Interval for the cap, aligned to the customer's billing cycle.
+ */
+type PreviewMultiAttachEntityDataInterval = ClosedEnum<typeof PreviewMultiAttachEntityDataInterval>;
+type PreviewMultiAttachUsageLimit = {
+    /**
+     * The feature this usage limit applies to.
+     */
+    featureId: string;
+    /**
+     * Maximum units allowed per interval.
+     */
+    limit: number;
+    /**
+     * Interval for the cap, aligned to the customer's billing cycle.
+     */
+    interval: PreviewMultiAttachEntityDataInterval;
+};
 /**
  * Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance.
  */
@@ -5732,9 +5962,13 @@ type PreviewMultiAttachOverageAllowed = {
  */
 type PreviewMultiAttachBillingControls = {
     /**
-     * List of overage spend limits per feature.
+     * List of spend limits per feature. Each entry caps overage (overage_limit) and/or per-interval usage (usage_limit).
      */
     spendLimits?: Array<PreviewMultiAttachSpendLimit> | undefined;
+    /**
+     * List of hard usage caps per feature for this entity. An entity entry overrides the customer's for that feature.
+     */
+    usageLimits?: Array<PreviewMultiAttachUsageLimit> | undefined;
     /**
      * List of usage alert configurations per feature.
      */
@@ -6302,9 +6536,9 @@ type PreviewUpdateItemPrice = {
      */
     billingMethod: PreviewUpdateItemBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -6508,9 +6742,9 @@ type PreviewUpdateAddItemPrice = {
      */
     billingMethod: PreviewUpdateAddItemBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -6628,21 +6862,27 @@ declare const PreviewUpdateRemoveItemBillingMethod: {
  * Match items with this billing method (prepaid or usage_based).
  */
 type PreviewUpdateRemoveItemBillingMethod = ClosedEnum<typeof PreviewUpdateRemoveItemBillingMethod>;
-/**
- * Match items with this interval.
- */
-declare const PreviewUpdateRemoveItemInterval: {
+declare const PreviewUpdateIntervalRemoveItemEnum2: {
     readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
     readonly Week: "week";
     readonly Month: "month";
     readonly Quarter: "quarter";
     readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-/**
- * Match items with this interval.
- */
-type PreviewUpdateRemoveItemInterval = ClosedEnum<typeof PreviewUpdateRemoveItemInterval>;
+type PreviewUpdateIntervalRemoveItemEnum2 = ClosedEnum<typeof PreviewUpdateIntervalRemoveItemEnum2>;
+declare const PreviewUpdateIntervalRemoveItemEnum1: {
+    readonly OneOff: "one_off";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type PreviewUpdateIntervalRemoveItemEnum1 = ClosedEnum<typeof PreviewUpdateIntervalRemoveItemEnum1>;
 /**
  * Filter for matching plan items. All provided fields must match (AND).
  */
@@ -6656,9 +6896,13 @@ type PreviewUpdatePlanItemFilter = {
      */
     billingMethod?: PreviewUpdateRemoveItemBillingMethod | undefined;
     /**
-     * Match items with this interval.
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
+     */
+    interval?: PreviewUpdateIntervalRemoveItemEnum1 | PreviewUpdateIntervalRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
      */
-    interval?: PreviewUpdateRemoveItemInterval | undefined;
+    intervalCount?: number | undefined;
 };
 /**
  * Unit of time for the trial ('day', 'month', 'year').
@@ -6713,7 +6957,7 @@ type PreviewUpdateCustomize = {
      */
     price?: PreviewUpdateBasePrice | null | undefined;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / update_items.
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
      */
     items?: Array<PreviewUpdateItemPlanItem> | undefined;
     /**
@@ -7392,9 +7636,9 @@ type SetupPaymentItemPrice = {
      */
     billingMethod: SetupPaymentItemBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -7598,9 +7842,9 @@ type SetupPaymentAddItemPrice = {
      */
     billingMethod: SetupPaymentAddItemBillingMethod;
     /**
-     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total.
+     * Max units purchasable beyond included. E.g. included=100, max_purchase=300 allows 400 total. Null for no limit.
      */
-    maxPurchase?: number | undefined;
+    maxPurchase?: number | null | undefined;
 };
 /**
  * Billing behavior when quantity increases mid-cycle.
@@ -7718,10 +7962,19 @@ declare const SetupPaymentRemoveItemBillingMethod: {
  * Match items with this billing method (prepaid or usage_based).
  */
 type SetupPaymentRemoveItemBillingMethod = ClosedEnum<typeof SetupPaymentRemoveItemBillingMethod>;
-/**
- * Match items with this interval.
- */
-declare const SetupPaymentRemoveItemInterval: {
+declare const SetupPaymentIntervalRemoveItemEnum2: {
+    readonly OneOff: "one_off";
+    readonly Minute: "minute";
+    readonly Hour: "hour";
+    readonly Day: "day";
+    readonly Week: "week";
+    readonly Month: "month";
+    readonly Quarter: "quarter";
+    readonly SemiAnnual: "semi_annual";
+    readonly Year: "year";
+};
+type SetupPaymentIntervalRemoveItemEnum2 = ClosedEnum<typeof SetupPaymentIntervalRemoveItemEnum2>;
+declare const SetupPaymentIntervalRemoveItemEnum1: {
     readonly OneOff: "one_off";
     readonly Week: "week";
     readonly Month: "month";
@@ -7729,10 +7982,7 @@ declare const SetupPaymentRemoveItemInterval: {
     readonly SemiAnnual: "semi_annual";
     readonly Year: "year";
 };
-/**
- * Match items with this interval.
- */
-type SetupPaymentRemoveItemInterval = ClosedEnum<typeof SetupPaymentRemoveItemInterval>;
+type SetupPaymentIntervalRemoveItemEnum1 = ClosedEnum<typeof SetupPaymentIntervalRemoveItemEnum1>;
 /**
  * Filter for matching plan items. All provided fields must match (AND).
  */
@@ -7746,9 +7996,13 @@ type SetupPaymentPlanItemFilter = {
      */
     billingMethod?: SetupPaymentRemoveItemBillingMethod | undefined;
     /**
-     * Match items with this interval.
+     * Match items with this interval. Accepts either a BillingInterval (price-side) or a ResetInterval (reset-side, includes day/hour/minute) so price-less items keyed by reset.interval can be disambiguated.
      */
-    interval?: SetupPaymentRemoveItemInterval | undefined;
+    interval?: SetupPaymentIntervalRemoveItemEnum1 | SetupPaymentIntervalRemoveItemEnum2 | undefined;
+    /**
+     * Match items with this interval_count. Disambiguates between items that share an interval but differ in count.
+     */
+    intervalCount?: number | undefined;
 };
 /**
  * Unit of time for the trial ('day', 'month', 'year').
@@ -7803,7 +8057,7 @@ type SetupPaymentCustomize = {
      */
     price?: SetupPaymentBasePrice | null | undefined;
     /**
-     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / update_items.
+     * Override the items in the plan (PUT-style — replaces all existing items). Mutually exclusive with add_items / remove_items / deprecated update_items.
      */
     items?: Array<SetupPaymentItemPlanItem> | undefined;
     /**
@@ -8047,4 +8301,4 @@ type ClientSetupPaymentParams = Omit<SetupPaymentParams, ProtectedFields> & {
 /** Get entity params without protected fields (for frontend use) */
 type ClientGetEntityParams = Prettify<Omit<GetEntityParams, ProtectedFields>>;
 
-export type { AggregateEventsList as A, BillingUpdateResponse as B, CheckResponse as C, GetEntityResponse as G, ListEventsList as L, MultiAttachResponse as M, OpenCustomerPortalResponse as O, PreviewAttachResponse as P, RedeemReferralCodeResponse as R, SetupPaymentResponse as S, Total as T, AggregateEventsResponse as a, AttachResponse as b, ClientAggregateEventsParams as c, ClientAttachParams as d, ClientCheckParams as e, ClientCreateReferralCodeParams as f, ClientGetEntityParams as g, ClientGetOrCreateCustomerParams as h, ClientListEventsParams as i, ClientListPlansParams as j, ClientMultiAttachParams as k, ClientOpenCustomerPortalParams as l, ClientPreviewAttachParams as m, ClientPreviewMultiAttachParams as n, ClientPreviewUpdateSubscriptionParams as o, ClientRedeemReferralCodeParams as p, ClientSetupPaymentParams as q, ClientUpdateSubscriptionParams as r, CreateReferralCodeResponse as s, ListEventsResponse as t, PreviewMultiAttachResponse as u, PreviewUpdateResponse as v, ProtectedFields as w };
+export type { AttachResponse as A, BillingUpdateResponse as B, ClientAggregateEventsParams as C, GetEntityResponse as G, ListEventsResponse as L, MultiAttachResponse as M, OpenCustomerPortalResponse as O, ProtectedFields as P, RedeemReferralCodeResponse as R, SetupPaymentResponse as S, Total as T, ClientAttachParams as a, ClientCreateReferralCodeParams as b, ClientGetEntityParams as c, ClientGetOrCreateCustomerParams as d, ClientListEventsParams as e, ClientMultiAttachParams as f, ClientOpenCustomerPortalParams as g, ClientPreviewAttachParams as h, ClientPreviewMultiAttachParams as i, ClientPreviewUpdateSubscriptionParams as j, ClientRedeemReferralCodeParams as k, ClientSetupPaymentParams as l, ClientUpdateSubscriptionParams as m, ClientCheckParams as n, CheckResponse as o, PreviewAttachResponse as p, PreviewUpdateResponse as q, PreviewMultiAttachResponse as r, AggregateEventsResponse as s, AggregateEventsList as t, ListEventsList as u, ClientListPlansParams as v, CreateReferralCodeResponse as w };