autumn-js 1.4.47 → 1.4.49

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/dist/backend/adapters/express.js +1780 -792
  2. package/dist/backend/adapters/express.mjs +5 -5
  3. package/dist/backend/adapters/fetch.js +1780 -792
  4. package/dist/backend/adapters/fetch.mjs +5 -5
  5. package/dist/backend/adapters/hono.js +1780 -792
  6. package/dist/backend/adapters/hono.mjs +5 -5
  7. package/dist/backend/adapters/index.js +1780 -792
  8. package/dist/backend/adapters/index.mjs +8 -8
  9. package/dist/backend/adapters/next.js +1780 -792
  10. package/dist/backend/adapters/next.mjs +5 -5
  11. package/dist/backend/{chunk-6LQFPGW7.mjs → chunk-4J2TOGWE.mjs} +220 -60
  12. package/dist/backend/{chunk-XSFLWMJO.mjs → chunk-6X4JZECX.mjs} +1 -1
  13. package/dist/backend/{chunk-BRCDWBVZ.mjs → chunk-EUR3CZTF.mjs} +1 -1
  14. package/dist/backend/{chunk-LPQJUWEP.mjs → chunk-EVPPOVX5.mjs} +2 -2
  15. package/dist/{better-auth/chunk-U4Z36UKV.mjs → backend/chunk-L4HKBZCC.mjs} +1773 -1168
  16. package/dist/backend/{chunk-QXN5PMM3.mjs → chunk-N2SCUJPL.mjs} +2 -2
  17. package/dist/backend/{chunk-P5IBHZVY.mjs → chunk-QPDWSMZ5.mjs} +1 -1
  18. package/dist/backend/{chunk-BAMETKFC.mjs → chunk-XIBFK5EL.mjs} +1 -1
  19. package/dist/backend/core/handlers/coreHandler.d.mts +1 -1
  20. package/dist/backend/core/handlers/coreHandler.d.ts +1 -1
  21. package/dist/backend/core/handlers/coreHandler.js +1780 -792
  22. package/dist/backend/core/handlers/coreHandler.mjs +3 -3
  23. package/dist/backend/core/handlers/executeRoute.d.mts +1 -1
  24. package/dist/backend/core/handlers/executeRoute.d.ts +1 -1
  25. package/dist/backend/core/handlers/handleRouteByName.js +1780 -792
  26. package/dist/backend/core/handlers/handleRouteByName.mjs +3 -3
  27. package/dist/backend/core/handlers/index.d.mts +1 -1
  28. package/dist/backend/core/handlers/index.d.ts +1 -1
  29. package/dist/backend/core/handlers/index.js +1780 -792
  30. package/dist/backend/core/handlers/index.mjs +4 -4
  31. package/dist/backend/core/index.d.mts +1 -1
  32. package/dist/backend/core/index.d.ts +1 -1
  33. package/dist/backend/core/index.js +1780 -792
  34. package/dist/backend/core/index.mjs +4 -4
  35. package/dist/backend/core/routes/index.d.mts +1 -1
  36. package/dist/backend/core/routes/index.d.ts +1 -1
  37. package/dist/backend/core/routes/index.js +220 -60
  38. package/dist/backend/core/routes/index.mjs +1 -1
  39. package/dist/backend/core/routes/routeBuilder.d.mts +1 -1
  40. package/dist/backend/core/routes/routeBuilder.d.ts +1 -1
  41. package/dist/backend/core/routes/routeConfigs.d.mts +1 -1
  42. package/dist/backend/core/routes/routeConfigs.d.ts +1 -1
  43. package/dist/backend/core/routes/routeConfigs.js +220 -60
  44. package/dist/backend/core/routes/routeConfigs.mjs +1 -1
  45. package/dist/backend/core/types/handlerTypes.d.mts +1 -1
  46. package/dist/backend/core/types/handlerTypes.d.ts +1 -1
  47. package/dist/backend/core/types/index.d.mts +1 -1
  48. package/dist/backend/core/types/index.d.ts +1 -1
  49. package/dist/backend/core/types/routeTypes.d.mts +1 -1
  50. package/dist/backend/core/types/routeTypes.d.ts +1 -1
  51. package/dist/backend/index.d.mts +2 -2
  52. package/dist/backend/index.d.ts +2 -2
  53. package/dist/backend/index.js +1780 -792
  54. package/dist/backend/index.mjs +4 -4
  55. package/dist/backend/{routeTypes-4Nvx_kS7.d.mts → routeTypes-C_10hxA-.d.mts} +916 -130
  56. package/dist/backend/{routeTypes-5NBu7O27.d.ts → routeTypes-CqaUPWtn.d.ts} +916 -130
  57. package/dist/{backend/chunk-QPCIJMW3.mjs → better-auth/chunk-44MLRR2L.mjs} +1996 -945
  58. package/dist/better-auth/{chunk-XMGJ2JOK.mjs → chunk-TX2WZUZT.mjs} +1 -1
  59. package/dist/better-auth/{chunk-7UPP5FN5.mjs → chunk-ZHYDDOAE.mjs} +220 -60
  60. package/dist/better-auth/index.js +1780 -792
  61. package/dist/better-auth/index.mjs +3 -3
  62. package/dist/better-auth/utils/createAutumnEndpoint.js +220 -60
  63. package/dist/better-auth/utils/createAutumnEndpoint.mjs +2 -2
  64. package/dist/better-auth/utils/handleBetterAuthRoute.js +1780 -792
  65. package/dist/better-auth/utils/handleBetterAuthRoute.mjs +2 -2
  66. package/dist/better-auth/utils/index.js +1780 -792
  67. package/dist/better-auth/utils/index.mjs +3 -3
  68. package/dist/react/AutumnContext.d.mts +4 -4
  69. package/dist/react/AutumnContext.d.ts +4 -4
  70. package/dist/react/client/AutumnClient.d.mts +4 -4
  71. package/dist/react/client/AutumnClient.d.ts +4 -4
  72. package/dist/react/client/IAutumnClient.d.mts +4 -4
  73. package/dist/react/client/IAutumnClient.d.ts +4 -4
  74. package/dist/react/client/index.d.mts +4 -4
  75. package/dist/react/client/index.d.ts +4 -4
  76. package/dist/react/{customer-Bf5yt0Mo.d.mts → customer-BK_WEJ0J.d.mts} +17 -1
  77. package/dist/react/{customer-BQxqzdSE.d.ts → customer-CGLAquo9.d.ts} +17 -1
  78. package/dist/react/hooks/index.d.mts +4 -4
  79. package/dist/react/hooks/index.d.ts +4 -4
  80. package/dist/react/hooks/internal/check/balanceToAllowed.d.mts +2 -2
  81. package/dist/react/hooks/internal/check/balanceToAllowed.d.ts +2 -2
  82. package/dist/react/hooks/internal/check/customerToFeatures.d.mts +2 -2
  83. package/dist/react/hooks/internal/check/customerToFeatures.d.ts +2 -2
  84. package/dist/react/hooks/internal/check/findCreditSystemsByFeature.d.mts +2 -2
  85. package/dist/react/hooks/internal/check/findCreditSystemsByFeature.d.ts +2 -2
  86. package/dist/react/hooks/internal/check/getCreditCost.d.mts +2 -2
  87. package/dist/react/hooks/internal/check/getCreditCost.d.ts +2 -2
  88. package/dist/react/hooks/internal/getLocalCheckResponse.d.mts +3 -3
  89. package/dist/react/hooks/internal/getLocalCheckResponse.d.ts +3 -3
  90. package/dist/react/hooks/internal/useCustomerActions.d.mts +4 -4
  91. package/dist/react/hooks/internal/useCustomerActions.d.ts +4 -4
  92. package/dist/react/hooks/useAggregateEvents.d.mts +2 -2
  93. package/dist/react/hooks/useAggregateEvents.d.ts +2 -2
  94. package/dist/react/hooks/useCustomer.d.mts +3 -3
  95. package/dist/react/hooks/useCustomer.d.ts +3 -3
  96. package/dist/react/hooks/useEntity.d.mts +2 -2
  97. package/dist/react/hooks/useEntity.d.ts +2 -2
  98. package/dist/react/hooks/useListEvents.d.mts +2 -2
  99. package/dist/react/hooks/useListEvents.d.ts +2 -2
  100. package/dist/react/hooks/useListPlans.d.mts +3 -3
  101. package/dist/react/hooks/useListPlans.d.ts +3 -3
  102. package/dist/react/hooks/useReferrals.d.mts +2 -2
  103. package/dist/react/hooks/useReferrals.d.ts +2 -2
  104. package/dist/react/index.d.mts +4 -4
  105. package/dist/react/index.d.ts +4 -4
  106. package/dist/react/{list-plans-response-CgqelDUJ.d.mts → list-plans-response-BMWMbzkK.d.ts} +89 -20
  107. package/dist/react/{list-plans-response-jYoBA-Ci.d.ts → list-plans-response-kbT4GwSh.d.mts} +89 -20
  108. package/dist/react/{params-B3qR55v_.d.ts → params-D_8sPp60.d.ts} +258 -40
  109. package/dist/react/{params-DWlWVt04.d.mts → params-eTM9nRBb.d.mts} +258 -40
  110. package/dist/react/{plan-BoEfV7t8.d.mts → plan-Dji-zdws.d.mts} +53 -7
  111. package/dist/react/{plan-BoEfV7t8.d.ts → plan-Dji-zdws.d.ts} +53 -7
  112. package/dist/sdk/index.d.mts +2323 -1205
  113. package/dist/sdk/index.d.ts +2323 -1205
  114. package/dist/sdk/index.js +21373 -20046
  115. package/dist/sdk/index.mjs +21237 -20046
  116. package/package.json +2 -2
@@ -755,6 +755,16 @@ type AttachItemExpiry = {
755
755
  duration: AttachItemDuration;
756
756
  length: number;
757
757
  };
758
+ type AttachCreditSchemaItem3 = {
759
+ /**
760
+ * ID of the metered feature to remove from the credit system.
761
+ */
762
+ meteredFeatureId: string;
763
+ /**
764
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
765
+ */
766
+ excluded: true;
767
+ };
758
768
  type AttachDimensionsItem4 = {
759
769
  /**
760
770
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -973,9 +983,9 @@ type AttachItemMarkups = {
973
983
  */
974
984
  type AttachItemFeatureOverride = {
975
985
  /**
976
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
986
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
977
987
  */
978
- creditSchema?: Array<AttachCreditSchemaItem1 | AttachCreditSchemaItem2> | undefined;
988
+ creditSchema?: Array<AttachCreditSchemaItem1 | AttachCreditSchemaItem2 | AttachCreditSchemaItem3> | undefined;
979
989
  /**
980
990
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
981
991
  */
@@ -1261,6 +1271,16 @@ type AttachAddItemExpiry = {
1261
1271
  duration: AttachAddItemDuration;
1262
1272
  length: number;
1263
1273
  };
1274
+ type AttachCreditSchemaAddItem3 = {
1275
+ /**
1276
+ * ID of the metered feature to remove from the credit system.
1277
+ */
1278
+ meteredFeatureId: string;
1279
+ /**
1280
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
1281
+ */
1282
+ excluded: true;
1283
+ };
1264
1284
  type AttachDimensionsAddItem4 = {
1265
1285
  /**
1266
1286
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -1479,9 +1499,9 @@ type AttachAddItemMarkups = {
1479
1499
  */
1480
1500
  type AttachAddItemFeatureOverride = {
1481
1501
  /**
1482
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
1502
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
1483
1503
  */
1484
- creditSchema?: Array<AttachCreditSchemaAddItem1 | AttachCreditSchemaAddItem2> | undefined;
1504
+ creditSchema?: Array<AttachCreditSchemaAddItem1 | AttachCreditSchemaAddItem2 | AttachCreditSchemaAddItem3> | undefined;
1485
1505
  /**
1486
1506
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
1487
1507
  */
@@ -2118,6 +2138,7 @@ type AttachUpsertLicenseProration = {
2118
2138
  */
2119
2139
  onDecrease: AttachUpsertLicenseOnDecrease;
2120
2140
  };
2141
+
2121
2142
  /**
2122
2143
  * When rolled over units expire.
2123
2144
  */
@@ -2150,7 +2171,6 @@ type AttachUpsertLicenseRollover = {
2150
2171
  */
2151
2172
  expiryDurationLength?: number | undefined;
2152
2173
  };
2153
-
2154
2174
  declare const AttachUpsertLicenseDuration: {
2155
2175
  readonly Day: "day";
2156
2176
  readonly Week: "week";
@@ -2165,6 +2185,16 @@ type AttachUpsertLicenseExpiry = {
2165
2185
  duration: AttachUpsertLicenseDuration;
2166
2186
  length: number;
2167
2187
  };
2188
+ type AttachCreditSchemaUpsertLicense3 = {
2189
+ /**
2190
+ * ID of the metered feature to remove from the credit system.
2191
+ */
2192
+ meteredFeatureId: string;
2193
+ /**
2194
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
2195
+ */
2196
+ excluded: true;
2197
+ };
2168
2198
  type AttachDimensionsUpsertLicense4 = {
2169
2199
  /**
2170
2200
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -2383,9 +2413,9 @@ type AttachUpsertLicenseMarkups = {
2383
2413
  */
2384
2414
  type AttachUpsertLicenseFeatureOverride = {
2385
2415
  /**
2386
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
2416
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
2387
2417
  */
2388
- creditSchema?: Array<AttachCreditSchemaUpsertLicense1 | AttachCreditSchemaUpsertLicense2> | undefined;
2418
+ creditSchema?: Array<AttachCreditSchemaUpsertLicense1 | AttachCreditSchemaUpsertLicense2 | AttachCreditSchemaUpsertLicense3> | undefined;
2389
2419
  /**
2390
2420
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
2391
2421
  */
@@ -3229,6 +3259,18 @@ declare const BalanceType: {
3229
3259
  * 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.
3230
3260
  */
3231
3261
  type BalanceType = OpenEnum<typeof BalanceType>;
3262
+ /**
3263
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
3264
+ */
3265
+ declare const BalanceCombine: {
3266
+ readonly Sum: "sum";
3267
+ readonly Max: "max";
3268
+ readonly Min: "min";
3269
+ };
3270
+ /**
3271
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
3272
+ */
3273
+ type BalanceCombine = OpenEnum<typeof BalanceCombine>;
3232
3274
  type BalanceDimensions6 = {
3233
3275
  /**
3234
3276
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -3553,6 +3595,10 @@ type BalanceFeature = {
3553
3595
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
3554
3596
  */
3555
3597
  consumable: boolean;
3598
+ /**
3599
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
3600
+ */
3601
+ combine?: BalanceCombine | undefined;
3556
3602
  /**
3557
3603
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
3558
3604
  */
@@ -4208,6 +4254,16 @@ type BillingUpdateItemExpiry = {
4208
4254
  duration: BillingUpdateItemDuration;
4209
4255
  length: number;
4210
4256
  };
4257
+ type BillingUpdateCreditSchemaItem3 = {
4258
+ /**
4259
+ * ID of the metered feature to remove from the credit system.
4260
+ */
4261
+ meteredFeatureId: string;
4262
+ /**
4263
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
4264
+ */
4265
+ excluded: true;
4266
+ };
4211
4267
  type BillingUpdateDimensionsItem4 = {
4212
4268
  /**
4213
4269
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -4426,9 +4482,9 @@ type BillingUpdateItemMarkups = {
4426
4482
  */
4427
4483
  type BillingUpdateItemFeatureOverride = {
4428
4484
  /**
4429
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
4485
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
4430
4486
  */
4431
- creditSchema?: Array<BillingUpdateCreditSchemaItem1 | BillingUpdateCreditSchemaItem2> | undefined;
4487
+ creditSchema?: Array<BillingUpdateCreditSchemaItem1 | BillingUpdateCreditSchemaItem2 | BillingUpdateCreditSchemaItem3> | undefined;
4432
4488
  /**
4433
4489
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
4434
4490
  */
@@ -4714,6 +4770,16 @@ type BillingUpdateAddItemExpiry = {
4714
4770
  duration: BillingUpdateAddItemDuration;
4715
4771
  length: number;
4716
4772
  };
4773
+ type BillingUpdateCreditSchemaAddItem3 = {
4774
+ /**
4775
+ * ID of the metered feature to remove from the credit system.
4776
+ */
4777
+ meteredFeatureId: string;
4778
+ /**
4779
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
4780
+ */
4781
+ excluded: true;
4782
+ };
4717
4783
  type BillingUpdateDimensionsAddItem4 = {
4718
4784
  /**
4719
4785
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -4932,9 +4998,9 @@ type BillingUpdateAddItemMarkups = {
4932
4998
  */
4933
4999
  type BillingUpdateAddItemFeatureOverride = {
4934
5000
  /**
4935
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
5001
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
4936
5002
  */
4937
- creditSchema?: Array<BillingUpdateCreditSchemaAddItem1 | BillingUpdateCreditSchemaAddItem2> | undefined;
5003
+ creditSchema?: Array<BillingUpdateCreditSchemaAddItem1 | BillingUpdateCreditSchemaAddItem2 | BillingUpdateCreditSchemaAddItem3> | undefined;
4938
5004
  /**
4939
5005
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
4940
5006
  */
@@ -5571,6 +5637,7 @@ type BillingUpdateUpsertLicenseProration = {
5571
5637
  */
5572
5638
  onDecrease: BillingUpdateUpsertLicenseOnDecrease;
5573
5639
  };
5640
+
5574
5641
  /**
5575
5642
  * When rolled over units expire.
5576
5643
  */
@@ -5603,7 +5670,6 @@ type BillingUpdateUpsertLicenseRollover = {
5603
5670
  */
5604
5671
  expiryDurationLength?: number | undefined;
5605
5672
  };
5606
-
5607
5673
  declare const BillingUpdateUpsertLicenseDuration: {
5608
5674
  readonly Day: "day";
5609
5675
  readonly Week: "week";
@@ -5618,6 +5684,16 @@ type BillingUpdateUpsertLicenseExpiry = {
5618
5684
  duration: BillingUpdateUpsertLicenseDuration;
5619
5685
  length: number;
5620
5686
  };
5687
+ type BillingUpdateCreditSchemaUpsertLicense3 = {
5688
+ /**
5689
+ * ID of the metered feature to remove from the credit system.
5690
+ */
5691
+ meteredFeatureId: string;
5692
+ /**
5693
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
5694
+ */
5695
+ excluded: true;
5696
+ };
5621
5697
  type BillingUpdateDimensionsUpsertLicense4 = {
5622
5698
  /**
5623
5699
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -5836,9 +5912,9 @@ type BillingUpdateUpsertLicenseMarkups = {
5836
5912
  */
5837
5913
  type BillingUpdateUpsertLicenseFeatureOverride = {
5838
5914
  /**
5839
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
5915
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
5840
5916
  */
5841
- creditSchema?: Array<BillingUpdateCreditSchemaUpsertLicense1 | BillingUpdateCreditSchemaUpsertLicense2> | undefined;
5917
+ creditSchema?: Array<BillingUpdateCreditSchemaUpsertLicense1 | BillingUpdateCreditSchemaUpsertLicense2 | BillingUpdateCreditSchemaUpsertLicense3> | undefined;
5842
5918
  /**
5843
5919
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
5844
5920
  */
@@ -6633,6 +6709,18 @@ declare const FlagType2: {
6633
6709
  * 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.
6634
6710
  */
6635
6711
  type FlagType2 = OpenEnum<typeof FlagType2>;
6712
+ /**
6713
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
6714
+ */
6715
+ declare const CheckCombine2: {
6716
+ readonly Sum: "sum";
6717
+ readonly Max: "max";
6718
+ readonly Min: "min";
6719
+ };
6720
+ /**
6721
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
6722
+ */
6723
+ type CheckCombine2 = OpenEnum<typeof CheckCombine2>;
6636
6724
  type CheckDimensions12 = {
6637
6725
  /**
6638
6726
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -6957,6 +7045,10 @@ type CheckFeature2 = {
6957
7045
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
6958
7046
  */
6959
7047
  consumable: boolean;
7048
+ /**
7049
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
7050
+ */
7051
+ combine?: CheckCombine2 | undefined;
6960
7052
  /**
6961
7053
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
6962
7054
  */
@@ -7650,6 +7742,18 @@ declare const FlagType1: {
7650
7742
  * 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.
7651
7743
  */
7652
7744
  type FlagType1 = OpenEnum<typeof FlagType1>;
7745
+ /**
7746
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
7747
+ */
7748
+ declare const CheckCombine1: {
7749
+ readonly Sum: "sum";
7750
+ readonly Max: "max";
7751
+ readonly Min: "min";
7752
+ };
7753
+ /**
7754
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
7755
+ */
7756
+ type CheckCombine1 = OpenEnum<typeof CheckCombine1>;
7653
7757
  type CheckDimensions6 = {
7654
7758
  /**
7655
7759
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -7974,6 +8078,10 @@ type CheckFeature1 = {
7974
8078
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
7975
8079
  */
7976
8080
  consumable: boolean;
8081
+ /**
8082
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
8083
+ */
8084
+ combine?: CheckCombine1 | undefined;
7977
8085
  /**
7978
8086
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
7979
8087
  */
@@ -9413,6 +9521,16 @@ type ItemExpiry = {
9413
9521
  duration: ItemDuration;
9414
9522
  length: number;
9415
9523
  };
9524
+ type PlanCreditSchemaItemFeatureOverride3 = {
9525
+ /**
9526
+ * ID of the metered feature to remove from the credit system.
9527
+ */
9528
+ meteredFeatureId: string;
9529
+ /**
9530
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
9531
+ */
9532
+ excluded: true;
9533
+ };
9416
9534
  type PlanDimensionsItem4 = {
9417
9535
  /**
9418
9536
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -9631,9 +9749,9 @@ type ItemMarkups = {
9631
9749
  */
9632
9750
  type ItemFeatureOverride = {
9633
9751
  /**
9634
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
9752
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
9635
9753
  */
9636
- creditSchema?: Array<PlanCreditSchemaItemFeatureOverride1 | PlanCreditSchemaItemFeatureOverride2> | undefined;
9754
+ creditSchema?: Array<PlanCreditSchemaItemFeatureOverride1 | PlanCreditSchemaItemFeatureOverride2 | PlanCreditSchemaItemFeatureOverride3> | undefined;
9637
9755
  /**
9638
9756
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
9639
9757
  */
@@ -10355,6 +10473,16 @@ type VariantDetailsExpiry = {
10355
10473
  duration: VariantDetailsDuration;
10356
10474
  length: number;
10357
10475
  };
10476
+ type PlanCreditSchemaVariantDetails3 = {
10477
+ /**
10478
+ * ID of the metered feature to remove from the credit system.
10479
+ */
10480
+ meteredFeatureId: string;
10481
+ /**
10482
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
10483
+ */
10484
+ excluded: true;
10485
+ };
10358
10486
  type PlanDimensionsVariantDetails4 = {
10359
10487
  /**
10360
10488
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -10573,9 +10701,9 @@ type VariantDetailsMarkups = {
10573
10701
  */
10574
10702
  type VariantDetailsFeatureOverride = {
10575
10703
  /**
10576
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
10704
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
10577
10705
  */
10578
- creditSchema?: Array<PlanCreditSchemaVariantDetails1 | PlanCreditSchemaVariantDetails2> | undefined;
10706
+ creditSchema?: Array<PlanCreditSchemaVariantDetails1 | PlanCreditSchemaVariantDetails2 | PlanCreditSchemaVariantDetails3> | undefined;
10579
10707
  /**
10580
10708
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
10581
10709
  */
@@ -10946,6 +11074,7 @@ type PlanVariantDetailsUsageAlert = {
10946
11074
  */
10947
11075
  name?: string | undefined;
10948
11076
  };
11077
+
10949
11078
  type PlanVariantDetailsOverageAllowed1 = {
10950
11079
  /**
10951
11080
  * The feature ID this overage allowed control applies to.
@@ -10981,7 +11110,6 @@ type PlanVariantDetailsBillingControls1 = {
10981
11110
  */
10982
11111
  overageAllowed?: Array<PlanVariantDetailsOverageAllowed1> | undefined;
10983
11112
  };
10984
-
10985
11113
  /**
10986
11114
  * Billing interval (e.g. 'month', 'year').
10987
11115
  */
@@ -11256,6 +11384,16 @@ type UpsertLicenseExpiry = {
11256
11384
  duration: UpsertLicenseDuration;
11257
11385
  length: number;
11258
11386
  };
11387
+ type PlanCreditSchemaUpsertLicense3 = {
11388
+ /**
11389
+ * ID of the metered feature to remove from the credit system.
11390
+ */
11391
+ meteredFeatureId: string;
11392
+ /**
11393
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
11394
+ */
11395
+ excluded: true;
11396
+ };
11259
11397
  type PlanDimensionsUpsertLicense4 = {
11260
11398
  /**
11261
11399
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -11474,9 +11612,9 @@ type UpsertLicenseMarkups = {
11474
11612
  */
11475
11613
  type UpsertLicenseFeatureOverride = {
11476
11614
  /**
11477
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
11615
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
11478
11616
  */
11479
- creditSchema?: Array<PlanCreditSchemaUpsertLicense1 | PlanCreditSchemaUpsertLicense2> | undefined;
11617
+ creditSchema?: Array<PlanCreditSchemaUpsertLicense1 | PlanCreditSchemaUpsertLicense2 | PlanCreditSchemaUpsertLicense3> | undefined;
11480
11618
  /**
11481
11619
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
11482
11620
  */
@@ -12093,6 +12231,18 @@ declare const CreateEntityType: {
12093
12231
  * 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.
12094
12232
  */
12095
12233
  type CreateEntityType = OpenEnum<typeof CreateEntityType>;
12234
+ /**
12235
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
12236
+ */
12237
+ declare const CreateEntityCombine: {
12238
+ readonly Sum: "sum";
12239
+ readonly Max: "max";
12240
+ readonly Min: "min";
12241
+ };
12242
+ /**
12243
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
12244
+ */
12245
+ type CreateEntityCombine = OpenEnum<typeof CreateEntityCombine>;
12096
12246
  type CreateEntityDimensions6 = {
12097
12247
  /**
12098
12248
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -12417,6 +12567,10 @@ type CreateEntityFeature = {
12417
12567
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
12418
12568
  */
12419
12569
  consumable: boolean;
12570
+ /**
12571
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
12572
+ */
12573
+ combine?: CreateEntityCombine | undefined;
12420
12574
  /**
12421
12575
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
12422
12576
  */
@@ -12830,6 +12984,18 @@ declare const CreateFeatureTypeRequestBody: {
12830
12984
  * The type of the feature. 'single_use' features are consumed, like API calls, tokens, or messages. 'continuous_use' features are allocated, like seats, workspaces, or projects. 'credit_system' features are schemas that unify multiple 'single_use' features into a single credit system.
12831
12985
  */
12832
12986
  type CreateFeatureTypeRequestBody = ClosedEnum<typeof CreateFeatureTypeRequestBody>;
12987
+ /**
12988
+ * How grants of this feature from several plans combine. 'sum' (default) adds them up. 'max' or 'min' keeps only the highest or lowest grant among plan items with no price; priced items always add on top. Metered and credit system features only.
12989
+ */
12990
+ declare const CreateFeatureCombineRequest: {
12991
+ readonly Sum: "sum";
12992
+ readonly Max: "max";
12993
+ readonly Min: "min";
12994
+ };
12995
+ /**
12996
+ * How grants of this feature from several plans combine. 'sum' (default) adds them up. 'max' or 'min' keeps only the highest or lowest grant among plan items with no price; priced items always add on top. Metered and credit system features only.
12997
+ */
12998
+ type CreateFeatureCombineRequest = ClosedEnum<typeof CreateFeatureCombineRequest>;
12833
12999
  /**
12834
13000
  * Singular and plural display names for the feature in your user interface.
12835
13001
  */
@@ -13042,6 +13208,10 @@ type CreateFeatureParams = {
13042
13208
  * Whether this feature is consumable. A consumable feature is one that periodically resets and is consumed rather than allocated (like credits, API requests, etc.). Applicable only for 'metered' features.
13043
13209
  */
13044
13210
  consumable?: boolean | undefined;
13211
+ /**
13212
+ * How grants of this feature from several plans combine. 'sum' (default) adds them up. 'max' or 'min' keeps only the highest or lowest grant among plan items with no price; priced items always add on top. Metered and credit system features only.
13213
+ */
13214
+ combine?: CreateFeatureCombineRequest | undefined;
13045
13215
  /**
13046
13216
  * Singular and plural display names for the feature in your user interface.
13047
13217
  */
@@ -13085,6 +13255,18 @@ declare const CreateFeatureTypeResponse: {
13085
13255
  * 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.
13086
13256
  */
13087
13257
  type CreateFeatureTypeResponse = OpenEnum<typeof CreateFeatureTypeResponse>;
13258
+ /**
13259
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
13260
+ */
13261
+ declare const CreateFeatureCombineResponse: {
13262
+ readonly Sum: "sum";
13263
+ readonly Max: "max";
13264
+ readonly Min: "min";
13265
+ };
13266
+ /**
13267
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
13268
+ */
13269
+ type CreateFeatureCombineResponse = OpenEnum<typeof CreateFeatureCombineResponse>;
13088
13270
  type CreateFeatureDimensionsResponse6 = {
13089
13271
  /**
13090
13272
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -13409,6 +13591,10 @@ type CreateFeatureResponse = {
13409
13591
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
13410
13592
  */
13411
13593
  consumable: boolean;
13594
+ /**
13595
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
13596
+ */
13597
+ combine?: CreateFeatureCombineResponse | undefined;
13412
13598
  /**
13413
13599
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
13414
13600
  */
@@ -13790,7 +13976,7 @@ type CreateInvoiceCreditSchema1 = {
13790
13976
  */
13791
13977
  type CreateInvoiceFeatureOverride = {
13792
13978
  /**
13793
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
13979
+ * Replaces the feature's credit_schema entirely for this invoice.
13794
13980
  */
13795
13981
  creditSchema?: Array<CreateInvoiceCreditSchema1 | CreateInvoiceCreditSchema2> | undefined;
13796
13982
  };
@@ -14221,7 +14407,7 @@ type CreateInvoiceCreditSchemaLicenseQuantity1 = {
14221
14407
  */
14222
14408
  type CreateInvoiceLicenseQuantityFeatureOverride = {
14223
14409
  /**
14224
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
14410
+ * Replaces the feature's credit_schema entirely for this invoice.
14225
14411
  */
14226
14412
  creditSchema?: Array<CreateInvoiceCreditSchemaLicenseQuantity1 | CreateInvoiceCreditSchemaLicenseQuantity2> | undefined;
14227
14413
  };
@@ -14975,6 +15161,16 @@ type CreatePlanItemExpiryRequestBody = {
14975
15161
  duration: CreatePlanItemDurationRequestBody;
14976
15162
  length: number;
14977
15163
  };
15164
+ type CreatePlanCreditSchemaItemRequestBody3 = {
15165
+ /**
15166
+ * ID of the metered feature to remove from the credit system.
15167
+ */
15168
+ meteredFeatureId: string;
15169
+ /**
15170
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
15171
+ */
15172
+ excluded: true;
15173
+ };
14978
15174
  type CreatePlanDimensionsItemRequestBody4 = {
14979
15175
  /**
14980
15176
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -15193,9 +15389,9 @@ type CreatePlanItemMarkupsRequestBody = {
15193
15389
  */
15194
15390
  type CreatePlanItemFeatureOverrideRequestBody = {
15195
15391
  /**
15196
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
15392
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
15197
15393
  */
15198
- creditSchema?: Array<CreatePlanCreditSchemaItemRequestBody1 | CreatePlanCreditSchemaItemRequestBody2> | undefined;
15394
+ creditSchema?: Array<CreatePlanCreditSchemaItemRequestBody1 | CreatePlanCreditSchemaItemRequestBody2 | CreatePlanCreditSchemaItemRequestBody3> | undefined;
15199
15395
  /**
15200
15396
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
15201
15397
  */
@@ -15527,6 +15723,16 @@ type CreatePlanLicenseExpiryRequestBody = {
15527
15723
  duration: CreatePlanLicenseDurationRequestBody;
15528
15724
  length: number;
15529
15725
  };
15726
+ type CreatePlanCreditSchemaLicenseRequestBody3 = {
15727
+ /**
15728
+ * ID of the metered feature to remove from the credit system.
15729
+ */
15730
+ meteredFeatureId: string;
15731
+ /**
15732
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
15733
+ */
15734
+ excluded: true;
15735
+ };
15530
15736
  type CreatePlanDimensionsLicenseRequestBody4 = {
15531
15737
  /**
15532
15738
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -15745,9 +15951,9 @@ type CreatePlanLicenseMarkupsRequestBody = {
15745
15951
  */
15746
15952
  type CreatePlanLicenseFeatureOverrideRequestBody = {
15747
15953
  /**
15748
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
15954
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
15749
15955
  */
15750
- creditSchema?: Array<CreatePlanCreditSchemaLicenseRequestBody1 | CreatePlanCreditSchemaLicenseRequestBody2> | undefined;
15956
+ creditSchema?: Array<CreatePlanCreditSchemaLicenseRequestBody1 | CreatePlanCreditSchemaLicenseRequestBody2 | CreatePlanCreditSchemaLicenseRequestBody3> | undefined;
15751
15957
  /**
15752
15958
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
15753
15959
  */
@@ -16419,7 +16625,7 @@ type CreatePlanItemAdditionalCurrencyResponse = {
16419
16625
  */
16420
16626
  amount: number;
16421
16627
  };
16422
- type CreatePlanPriceItemToResponse = number | string;
16628
+
16423
16629
  type CreatePlanItemTierAdditionalCurrencyResponse = {
16424
16630
  /**
16425
16631
  * Three-letter Stripe-supported currency code (e.g. 'eur', 'gbp').
@@ -16434,9 +16640,8 @@ type CreatePlanItemTierAdditionalCurrencyResponse = {
16434
16640
  */
16435
16641
  flatAmount?: number | undefined;
16436
16642
  };
16437
-
16438
16643
  type CreatePlanPriceItemTierResponse = {
16439
- to: CreatePlanPriceItemToResponse;
16644
+ to: number | string;
16440
16645
  amount: number;
16441
16646
  flatAmount?: number | undefined;
16442
16647
  additionalCurrencies?: Array<CreatePlanItemTierAdditionalCurrencyResponse> | undefined;
@@ -16588,6 +16793,16 @@ type CreatePlanItemExpiryResponse = {
16588
16793
  duration: CreatePlanItemDurationResponse;
16589
16794
  length: number;
16590
16795
  };
16796
+ type CreatePlanCreditSchemaItemFeatureOverrideResponse3 = {
16797
+ /**
16798
+ * ID of the metered feature to remove from the credit system.
16799
+ */
16800
+ meteredFeatureId: string;
16801
+ /**
16802
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
16803
+ */
16804
+ excluded: true;
16805
+ };
16591
16806
  type CreatePlanDimensionsItemResponse4 = {
16592
16807
  /**
16593
16808
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -16806,9 +17021,9 @@ type CreatePlanItemMarkupsResponse = {
16806
17021
  */
16807
17022
  type CreatePlanItemFeatureOverrideResponse = {
16808
17023
  /**
16809
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
17024
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
16810
17025
  */
16811
- creditSchema?: Array<CreatePlanCreditSchemaItemFeatureOverrideResponse1 | CreatePlanCreditSchemaItemFeatureOverrideResponse2> | undefined;
17026
+ creditSchema?: Array<CreatePlanCreditSchemaItemFeatureOverrideResponse1 | CreatePlanCreditSchemaItemFeatureOverrideResponse2 | CreatePlanCreditSchemaItemFeatureOverrideResponse3> | undefined;
16812
17027
  /**
16813
17028
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
16814
17029
  */
@@ -17530,6 +17745,16 @@ type CreatePlanVariantDetailsExpiry = {
17530
17745
  duration: CreatePlanVariantDetailsDuration;
17531
17746
  length: number;
17532
17747
  };
17748
+ type CreatePlanCreditSchemaVariantDetails3 = {
17749
+ /**
17750
+ * ID of the metered feature to remove from the credit system.
17751
+ */
17752
+ meteredFeatureId: string;
17753
+ /**
17754
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
17755
+ */
17756
+ excluded: true;
17757
+ };
17533
17758
  type CreatePlanDimensionsVariantDetails4 = {
17534
17759
  /**
17535
17760
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -17748,9 +17973,9 @@ type CreatePlanVariantDetailsMarkups = {
17748
17973
  */
17749
17974
  type CreatePlanVariantDetailsFeatureOverride = {
17750
17975
  /**
17751
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
17976
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
17752
17977
  */
17753
- creditSchema?: Array<CreatePlanCreditSchemaVariantDetails1 | CreatePlanCreditSchemaVariantDetails2> | undefined;
17978
+ creditSchema?: Array<CreatePlanCreditSchemaVariantDetails1 | CreatePlanCreditSchemaVariantDetails2 | CreatePlanCreditSchemaVariantDetails3> | undefined;
17754
17979
  /**
17755
17980
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
17756
17981
  */
@@ -18292,6 +18517,7 @@ declare const CreatePlanUpsertLicenseAddItemPriceInterval: {
18292
18517
  * Billing interval. For consumable features, should match reset.interval.
18293
18518
  */
18294
18519
  type CreatePlanUpsertLicenseAddItemPriceInterval = OpenEnum<typeof CreatePlanUpsertLicenseAddItemPriceInterval>;
18520
+
18295
18521
  /**
18296
18522
  * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
18297
18523
  */
@@ -18371,7 +18597,6 @@ declare const CreatePlanUpsertLicenseOnDecrease: {
18371
18597
  * Credit behavior when quantity decreases mid-cycle.
18372
18598
  */
18373
18599
  type CreatePlanUpsertLicenseOnDecrease = OpenEnum<typeof CreatePlanUpsertLicenseOnDecrease>;
18374
-
18375
18600
  /**
18376
18601
  * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
18377
18602
  */
@@ -18431,6 +18656,16 @@ type CreatePlanUpsertLicenseExpiry = {
18431
18656
  duration: CreatePlanUpsertLicenseDuration;
18432
18657
  length: number;
18433
18658
  };
18659
+ type CreatePlanCreditSchemaUpsertLicense3 = {
18660
+ /**
18661
+ * ID of the metered feature to remove from the credit system.
18662
+ */
18663
+ meteredFeatureId: string;
18664
+ /**
18665
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
18666
+ */
18667
+ excluded: true;
18668
+ };
18434
18669
  type CreatePlanDimensionsUpsertLicense4 = {
18435
18670
  /**
18436
18671
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -18649,9 +18884,9 @@ type CreatePlanUpsertLicenseMarkups = {
18649
18884
  */
18650
18885
  type CreatePlanUpsertLicenseFeatureOverride = {
18651
18886
  /**
18652
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
18887
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
18653
18888
  */
18654
- creditSchema?: Array<CreatePlanCreditSchemaUpsertLicense1 | CreatePlanCreditSchemaUpsertLicense2> | undefined;
18889
+ creditSchema?: Array<CreatePlanCreditSchemaUpsertLicense1 | CreatePlanCreditSchemaUpsertLicense2 | CreatePlanCreditSchemaUpsertLicense3> | undefined;
18655
18890
  /**
18656
18891
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
18657
18892
  */
@@ -19101,6 +19336,16 @@ type CreatePlanLicenseExpiryResponse = {
19101
19336
  duration: CreatePlanLicenseDurationResponse;
19102
19337
  length: number;
19103
19338
  };
19339
+ type CreatePlanCreditSchemaLicenseResponse3 = {
19340
+ /**
19341
+ * ID of the metered feature to remove from the credit system.
19342
+ */
19343
+ meteredFeatureId: string;
19344
+ /**
19345
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
19346
+ */
19347
+ excluded: true;
19348
+ };
19104
19349
  type CreatePlanDimensionsLicenseResponse4 = {
19105
19350
  /**
19106
19351
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -19319,9 +19564,9 @@ type CreatePlanLicenseMarkupsResponse = {
19319
19564
  */
19320
19565
  type CreatePlanLicenseFeatureOverrideResponse = {
19321
19566
  /**
19322
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
19567
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
19323
19568
  */
19324
- creditSchema?: Array<CreatePlanCreditSchemaLicenseResponse1 | CreatePlanCreditSchemaLicenseResponse2> | undefined;
19569
+ creditSchema?: Array<CreatePlanCreditSchemaLicenseResponse1 | CreatePlanCreditSchemaLicenseResponse2 | CreatePlanCreditSchemaLicenseResponse3> | undefined;
19325
19570
  /**
19326
19571
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
19327
19572
  */
@@ -20498,6 +20743,16 @@ type UnscheduledPlanItemExpiry = {
20498
20743
  duration: UnscheduledPlanItemDuration;
20499
20744
  length: number;
20500
20745
  };
20746
+ type CreditSchemaUnscheduledPlanItem3 = {
20747
+ /**
20748
+ * ID of the metered feature to remove from the credit system.
20749
+ */
20750
+ meteredFeatureId: string;
20751
+ /**
20752
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
20753
+ */
20754
+ excluded: true;
20755
+ };
20501
20756
  type DimensionsUnscheduledPlanItem4 = {
20502
20757
  /**
20503
20758
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -20716,9 +20971,9 @@ type UnscheduledPlanItemMarkups = {
20716
20971
  */
20717
20972
  type UnscheduledPlanItemFeatureOverride = {
20718
20973
  /**
20719
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
20974
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
20720
20975
  */
20721
- creditSchema?: Array<CreditSchemaUnscheduledPlanItem1 | CreditSchemaUnscheduledPlanItem2> | undefined;
20976
+ creditSchema?: Array<CreditSchemaUnscheduledPlanItem1 | CreditSchemaUnscheduledPlanItem2 | CreditSchemaUnscheduledPlanItem3> | undefined;
20722
20977
  /**
20723
20978
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
20724
20979
  */
@@ -21004,6 +21259,16 @@ type UnscheduledPlanAddItemExpiry = {
21004
21259
  duration: UnscheduledPlanAddItemDuration;
21005
21260
  length: number;
21006
21261
  };
21262
+ type CreditSchemaUnscheduledPlanAddItem3 = {
21263
+ /**
21264
+ * ID of the metered feature to remove from the credit system.
21265
+ */
21266
+ meteredFeatureId: string;
21267
+ /**
21268
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
21269
+ */
21270
+ excluded: true;
21271
+ };
21007
21272
  type DimensionsUnscheduledPlanAddItem4 = {
21008
21273
  /**
21009
21274
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -21222,9 +21487,9 @@ type UnscheduledPlanAddItemMarkups = {
21222
21487
  */
21223
21488
  type UnscheduledPlanAddItemFeatureOverride = {
21224
21489
  /**
21225
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
21490
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
21226
21491
  */
21227
- creditSchema?: Array<CreditSchemaUnscheduledPlanAddItem1 | CreditSchemaUnscheduledPlanAddItem2> | undefined;
21492
+ creditSchema?: Array<CreditSchemaUnscheduledPlanAddItem1 | CreditSchemaUnscheduledPlanAddItem2 | CreditSchemaUnscheduledPlanAddItem3> | undefined;
21228
21493
  /**
21229
21494
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
21230
21495
  */
@@ -21736,6 +22001,7 @@ declare const UnscheduledPlanUpsertLicenseAddItemBillingMethod: {
21736
22001
  * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
21737
22002
  */
21738
22003
  type UnscheduledPlanUpsertLicenseAddItemBillingMethod = ClosedEnum<typeof UnscheduledPlanUpsertLicenseAddItemBillingMethod>;
22004
+
21739
22005
  /**
21740
22006
  * Pricing for usage beyond included units. Omit for free features.
21741
22007
  */
@@ -21790,7 +22056,6 @@ declare const UnscheduledPlanUpsertLicenseOnIncrease: {
21790
22056
  * Billing behavior when quantity increases mid-cycle.
21791
22057
  */
21792
22058
  type UnscheduledPlanUpsertLicenseOnIncrease = ClosedEnum<typeof UnscheduledPlanUpsertLicenseOnIncrease>;
21793
-
21794
22059
  /**
21795
22060
  * Credit behavior when quantity decreases mid-cycle.
21796
22061
  */
@@ -21864,6 +22129,16 @@ type UnscheduledPlanUpsertLicenseExpiry = {
21864
22129
  duration: UnscheduledPlanUpsertLicenseDuration;
21865
22130
  length: number;
21866
22131
  };
22132
+ type CreditSchemaUnscheduledPlanUpsertLicense3 = {
22133
+ /**
22134
+ * ID of the metered feature to remove from the credit system.
22135
+ */
22136
+ meteredFeatureId: string;
22137
+ /**
22138
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
22139
+ */
22140
+ excluded: true;
22141
+ };
21867
22142
  type DimensionsUnscheduledPlanUpsertLicense4 = {
21868
22143
  /**
21869
22144
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -22082,9 +22357,9 @@ type UnscheduledPlanUpsertLicenseMarkups = {
22082
22357
  */
22083
22358
  type UnscheduledPlanUpsertLicenseFeatureOverride = {
22084
22359
  /**
22085
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
22360
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
22086
22361
  */
22087
- creditSchema?: Array<CreditSchemaUnscheduledPlanUpsertLicense1 | CreditSchemaUnscheduledPlanUpsertLicense2> | undefined;
22362
+ creditSchema?: Array<CreditSchemaUnscheduledPlanUpsertLicense1 | CreditSchemaUnscheduledPlanUpsertLicense2 | CreditSchemaUnscheduledPlanUpsertLicense3> | undefined;
22088
22363
  /**
22089
22364
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
22090
22365
  */
@@ -22609,6 +22884,16 @@ type PhaseItemExpiry2 = {
22609
22884
  duration: PhaseItemDuration2;
22610
22885
  length: number;
22611
22886
  };
22887
+ type PhaseCreditSchemaItem3 = {
22888
+ /**
22889
+ * ID of the metered feature to remove from the credit system.
22890
+ */
22891
+ meteredFeatureId: string;
22892
+ /**
22893
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
22894
+ */
22895
+ excluded: true;
22896
+ };
22612
22897
  type PhaseDimensionsItem4 = {
22613
22898
  /**
22614
22899
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -22827,9 +23112,9 @@ type PhaseItemMarkups2 = {
22827
23112
  */
22828
23113
  type PhaseItemFeatureOverride2 = {
22829
23114
  /**
22830
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
23115
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
22831
23116
  */
22832
- creditSchema?: Array<PhaseCreditSchemaItem1 | PhaseCreditSchemaItem2> | undefined;
23117
+ creditSchema?: Array<PhaseCreditSchemaItem1 | PhaseCreditSchemaItem2 | PhaseCreditSchemaItem3> | undefined;
22833
23118
  /**
22834
23119
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
22835
23120
  */
@@ -23115,6 +23400,16 @@ type PhaseAddItemExpiry2 = {
23115
23400
  duration: PhaseAddItemDuration2;
23116
23401
  length: number;
23117
23402
  };
23403
+ type PhaseCreditSchemaAddItem3 = {
23404
+ /**
23405
+ * ID of the metered feature to remove from the credit system.
23406
+ */
23407
+ meteredFeatureId: string;
23408
+ /**
23409
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
23410
+ */
23411
+ excluded: true;
23412
+ };
23118
23413
  type PhaseDimensionsAddItem4 = {
23119
23414
  /**
23120
23415
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -23245,6 +23540,7 @@ type PhaseDimensionsAddItem1 = {
23245
23540
  tierBehavior: "graduated";
23246
23541
  tiers: Array<PhaseDimensionsAddItemTier1>;
23247
23542
  };
23543
+ type PhaseAddItemDimensionsUnion3 = PhaseDimensionsAddItem1 | PhaseDimensionsAddItem2;
23248
23544
  type PhaseAddItemMultipliers3 = {
23249
23545
  /**
23250
23546
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -23265,11 +23561,16 @@ declare const PhaseToAddItemEnum: {
23265
23561
  readonly Inf: "inf";
23266
23562
  };
23267
23563
  type PhaseToAddItemEnum = ClosedEnum<typeof PhaseToAddItemEnum>;
23564
+ /**
23565
+ * Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.
23566
+ */
23567
+ type PhaseAddItemFeatureOverrideToUnion2 = number | PhaseToAddItemEnum;
23568
+
23268
23569
  type PhaseAddItemFeatureOverrideTier2 = {
23269
23570
  /**
23270
23571
  * Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'.
23271
23572
  */
23272
- to: number | PhaseToAddItemEnum;
23573
+ to: PhaseAddItemFeatureOverrideToUnion2;
23273
23574
  /**
23274
23575
  * Credits consumed per billing-unit group within this tier.
23275
23576
  */
@@ -23288,7 +23589,7 @@ type PhaseCreditSchemaAddItem1 = {
23288
23589
  * Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.
23289
23590
  */
23290
23591
  dimensions?: {
23291
- [k: string]: PhaseDimensionsAddItem1 | PhaseDimensionsAddItem2;
23592
+ [k: string]: PhaseAddItemDimensionsUnion3;
23292
23593
  } | undefined;
23293
23594
  /**
23294
23595
  * Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
@@ -23299,7 +23600,6 @@ type PhaseCreditSchemaAddItem1 = {
23299
23600
  tierBehavior: "graduated";
23300
23601
  tiers: Array<PhaseAddItemFeatureOverrideTier2>;
23301
23602
  };
23302
- type PhaseAddItemCreditSchemaUnion2 = PhaseCreditSchemaAddItem1 | PhaseCreditSchemaAddItem2;
23303
23603
  type PhaseAddItemProviderMarkups2 = {
23304
23604
  markup: number;
23305
23605
  };
@@ -23308,7 +23608,6 @@ type PhaseAddItemModelMarkups2 = {
23308
23608
  inputCost?: number | undefined;
23309
23609
  outputCost?: number | undefined;
23310
23610
  };
23311
-
23312
23611
  /**
23313
23612
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
23314
23613
  */
@@ -23335,9 +23634,9 @@ type PhaseAddItemMarkups2 = {
23335
23634
  */
23336
23635
  type PhaseAddItemFeatureOverride2 = {
23337
23636
  /**
23338
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
23637
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
23339
23638
  */
23340
- creditSchema?: Array<PhaseAddItemCreditSchemaUnion2> | undefined;
23639
+ creditSchema?: Array<PhaseCreditSchemaAddItem1 | PhaseCreditSchemaAddItem2 | PhaseCreditSchemaAddItem3> | undefined;
23341
23640
  /**
23342
23641
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
23343
23642
  */
@@ -23976,6 +24275,16 @@ type PhaseUpsertLicenseExpiry2 = {
23976
24275
  duration: PhaseUpsertLicenseDuration2;
23977
24276
  length: number;
23978
24277
  };
24278
+ type PhaseCreditSchemaUpsertLicense3 = {
24279
+ /**
24280
+ * ID of the metered feature to remove from the credit system.
24281
+ */
24282
+ meteredFeatureId: string;
24283
+ /**
24284
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
24285
+ */
24286
+ excluded: true;
24287
+ };
23979
24288
  type PhaseDimensionsUpsertLicense4 = {
23980
24289
  /**
23981
24290
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -24186,9 +24495,9 @@ type PhaseUpsertLicenseMarkups2 = {
24186
24495
  */
24187
24496
  type PhaseUpsertLicenseFeatureOverride2 = {
24188
24497
  /**
24189
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
24498
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
24190
24499
  */
24191
- creditSchema?: Array<PhaseCreditSchemaUpsertLicense1 | PhaseCreditSchemaUpsertLicense2> | undefined;
24500
+ creditSchema?: Array<PhaseCreditSchemaUpsertLicense1 | PhaseCreditSchemaUpsertLicense2 | PhaseCreditSchemaUpsertLicense3> | undefined;
24192
24501
  /**
24193
24502
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
24194
24503
  */
@@ -25238,6 +25547,18 @@ declare const CustomerFlagsType: {
25238
25547
  * 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.
25239
25548
  */
25240
25549
  type CustomerFlagsType = OpenEnum<typeof CustomerFlagsType>;
25550
+ /**
25551
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
25552
+ */
25553
+ declare const CustomerCombine: {
25554
+ readonly Sum: "sum";
25555
+ readonly Max: "max";
25556
+ readonly Min: "min";
25557
+ };
25558
+ /**
25559
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
25560
+ */
25561
+ type CustomerCombine = OpenEnum<typeof CustomerCombine>;
25241
25562
  type CustomerDimensions6 = {
25242
25563
  /**
25243
25564
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -25562,6 +25883,10 @@ type CustomerFeature = {
25562
25883
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
25563
25884
  */
25564
25885
  consumable: boolean;
25886
+ /**
25887
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
25888
+ */
25889
+ combine?: CustomerCombine | undefined;
25565
25890
  /**
25566
25891
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
25567
25892
  */
@@ -27056,6 +27381,18 @@ declare const GetCustomerFlagsType: {
27056
27381
  * 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.
27057
27382
  */
27058
27383
  type GetCustomerFlagsType = OpenEnum<typeof GetCustomerFlagsType>;
27384
+ /**
27385
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
27386
+ */
27387
+ declare const GetCustomerCombine: {
27388
+ readonly Sum: "sum";
27389
+ readonly Max: "max";
27390
+ readonly Min: "min";
27391
+ };
27392
+ /**
27393
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
27394
+ */
27395
+ type GetCustomerCombine = OpenEnum<typeof GetCustomerCombine>;
27059
27396
  type GetCustomerDimensions6 = {
27060
27397
  /**
27061
27398
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -27380,6 +27717,10 @@ type GetCustomerFeature = {
27380
27717
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
27381
27718
  */
27382
27719
  consumable: boolean;
27720
+ /**
27721
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
27722
+ */
27723
+ combine?: GetCustomerCombine | undefined;
27383
27724
  /**
27384
27725
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
27385
27726
  */
@@ -28066,6 +28407,18 @@ declare const GetEntityType: {
28066
28407
  * 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.
28067
28408
  */
28068
28409
  type GetEntityType = OpenEnum<typeof GetEntityType>;
28410
+ /**
28411
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
28412
+ */
28413
+ declare const GetEntityCombine: {
28414
+ readonly Sum: "sum";
28415
+ readonly Max: "max";
28416
+ readonly Min: "min";
28417
+ };
28418
+ /**
28419
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
28420
+ */
28421
+ type GetEntityCombine = OpenEnum<typeof GetEntityCombine>;
28069
28422
  type GetEntityDimensions6 = {
28070
28423
  /**
28071
28424
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -28390,6 +28743,10 @@ type GetEntityFeature = {
28390
28743
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
28391
28744
  */
28392
28745
  consumable: boolean;
28746
+ /**
28747
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
28748
+ */
28749
+ combine?: GetEntityCombine | undefined;
28393
28750
  /**
28394
28751
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
28395
28752
  */
@@ -28809,6 +29166,18 @@ declare const GetFeatureType: {
28809
29166
  * 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.
28810
29167
  */
28811
29168
  type GetFeatureType = OpenEnum<typeof GetFeatureType>;
29169
+ /**
29170
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
29171
+ */
29172
+ declare const GetFeatureCombine: {
29173
+ readonly Sum: "sum";
29174
+ readonly Max: "max";
29175
+ readonly Min: "min";
29176
+ };
29177
+ /**
29178
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
29179
+ */
29180
+ type GetFeatureCombine = OpenEnum<typeof GetFeatureCombine>;
28812
29181
  type GetFeatureDimensions6 = {
28813
29182
  /**
28814
29183
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -29133,6 +29502,10 @@ type GetFeatureResponse = {
29133
29502
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
29134
29503
  */
29135
29504
  consumable: boolean;
29505
+ /**
29506
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
29507
+ */
29508
+ combine?: GetFeatureCombine | undefined;
29136
29509
  /**
29137
29510
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
29138
29511
  */
@@ -29529,6 +29902,16 @@ type GetPlanItemExpiry = {
29529
29902
  duration: GetPlanItemDuration;
29530
29903
  length: number;
29531
29904
  };
29905
+ type GetPlanCreditSchemaItemFeatureOverride3 = {
29906
+ /**
29907
+ * ID of the metered feature to remove from the credit system.
29908
+ */
29909
+ meteredFeatureId: string;
29910
+ /**
29911
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
29912
+ */
29913
+ excluded: true;
29914
+ };
29532
29915
  type GetPlanDimensionsItem4 = {
29533
29916
  /**
29534
29917
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -29747,9 +30130,9 @@ type GetPlanItemMarkups = {
29747
30130
  */
29748
30131
  type GetPlanItemFeatureOverride = {
29749
30132
  /**
29750
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
30133
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
29751
30134
  */
29752
- creditSchema?: Array<GetPlanCreditSchemaItemFeatureOverride1 | GetPlanCreditSchemaItemFeatureOverride2> | undefined;
30135
+ creditSchema?: Array<GetPlanCreditSchemaItemFeatureOverride1 | GetPlanCreditSchemaItemFeatureOverride2 | GetPlanCreditSchemaItemFeatureOverride3> | undefined;
29753
30136
  /**
29754
30137
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
29755
30138
  */
@@ -30471,6 +30854,16 @@ type GetPlanVariantDetailsExpiry = {
30471
30854
  duration: GetPlanVariantDetailsDuration;
30472
30855
  length: number;
30473
30856
  };
30857
+ type GetPlanCreditSchemaVariantDetails3 = {
30858
+ /**
30859
+ * ID of the metered feature to remove from the credit system.
30860
+ */
30861
+ meteredFeatureId: string;
30862
+ /**
30863
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
30864
+ */
30865
+ excluded: true;
30866
+ };
30474
30867
  type GetPlanDimensionsVariantDetails4 = {
30475
30868
  /**
30476
30869
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -30689,9 +31082,9 @@ type GetPlanVariantDetailsMarkups = {
30689
31082
  */
30690
31083
  type GetPlanVariantDetailsFeatureOverride = {
30691
31084
  /**
30692
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
31085
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
30693
31086
  */
30694
- creditSchema?: Array<GetPlanCreditSchemaVariantDetails1 | GetPlanCreditSchemaVariantDetails2> | undefined;
31087
+ creditSchema?: Array<GetPlanCreditSchemaVariantDetails1 | GetPlanCreditSchemaVariantDetails2 | GetPlanCreditSchemaVariantDetails3> | undefined;
30695
31088
  /**
30696
31089
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
30697
31090
  */
@@ -31024,6 +31417,7 @@ declare const GetPlanVariantDetailsBasis: {
31024
31417
  * What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
31025
31418
  */
31026
31419
  type GetPlanVariantDetailsBasis = OpenEnum<typeof GetPlanVariantDetailsBasis>;
31420
+
31027
31421
  /**
31028
31422
  * Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
31029
31423
  */
@@ -31062,7 +31456,6 @@ type GetPlanVariantDetailsUsageAlert = {
31062
31456
  */
31063
31457
  name?: string | undefined;
31064
31458
  };
31065
-
31066
31459
  type GetPlanVariantDetailsOverageAllowed = {
31067
31460
  /**
31068
31461
  * The feature ID this overage allowed control applies to.
@@ -31372,6 +31765,16 @@ type GetPlanUpsertLicenseExpiry = {
31372
31765
  duration: GetPlanUpsertLicenseDuration;
31373
31766
  length: number;
31374
31767
  };
31768
+ type GetPlanCreditSchemaUpsertLicense3 = {
31769
+ /**
31770
+ * ID of the metered feature to remove from the credit system.
31771
+ */
31772
+ meteredFeatureId: string;
31773
+ /**
31774
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
31775
+ */
31776
+ excluded: true;
31777
+ };
31375
31778
  type GetPlanDimensionsUpsertLicense4 = {
31376
31779
  /**
31377
31780
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -31590,9 +31993,9 @@ type GetPlanUpsertLicenseMarkups = {
31590
31993
  */
31591
31994
  type GetPlanUpsertLicenseFeatureOverride = {
31592
31995
  /**
31593
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
31996
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
31594
31997
  */
31595
- creditSchema?: Array<GetPlanCreditSchemaUpsertLicense1 | GetPlanCreditSchemaUpsertLicense2> | undefined;
31998
+ creditSchema?: Array<GetPlanCreditSchemaUpsertLicense1 | GetPlanCreditSchemaUpsertLicense2 | GetPlanCreditSchemaUpsertLicense3> | undefined;
31596
31999
  /**
31597
32000
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
31598
32001
  */
@@ -32042,6 +32445,16 @@ type GetPlanLicenseExpiry = {
32042
32445
  duration: GetPlanLicenseDuration;
32043
32446
  length: number;
32044
32447
  };
32448
+ type GetPlanCreditSchemaLicense3 = {
32449
+ /**
32450
+ * ID of the metered feature to remove from the credit system.
32451
+ */
32452
+ meteredFeatureId: string;
32453
+ /**
32454
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
32455
+ */
32456
+ excluded: true;
32457
+ };
32045
32458
  type GetPlanDimensionsLicense4 = {
32046
32459
  /**
32047
32460
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -32260,9 +32673,9 @@ type GetPlanLicenseMarkups = {
32260
32673
  */
32261
32674
  type GetPlanLicenseFeatureOverride = {
32262
32675
  /**
32263
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
32676
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
32264
32677
  */
32265
- creditSchema?: Array<GetPlanCreditSchemaLicense1 | GetPlanCreditSchemaLicense2> | undefined;
32678
+ creditSchema?: Array<GetPlanCreditSchemaLicense1 | GetPlanCreditSchemaLicense2 | GetPlanCreditSchemaLicense3> | undefined;
32266
32679
  /**
32267
32680
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
32268
32681
  */
@@ -34399,6 +34812,18 @@ declare const ListCustomersType: {
34399
34812
  * 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.
34400
34813
  */
34401
34814
  type ListCustomersType = OpenEnum<typeof ListCustomersType>;
34815
+ /**
34816
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
34817
+ */
34818
+ declare const ListCustomersCombine: {
34819
+ readonly Sum: "sum";
34820
+ readonly Max: "max";
34821
+ readonly Min: "min";
34822
+ };
34823
+ /**
34824
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
34825
+ */
34826
+ type ListCustomersCombine = OpenEnum<typeof ListCustomersCombine>;
34402
34827
  type ListCustomersDimensions6 = {
34403
34828
  /**
34404
34829
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -34723,6 +35148,10 @@ type ListCustomersFeature = {
34723
35148
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
34724
35149
  */
34725
35150
  consumable: boolean;
35151
+ /**
35152
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
35153
+ */
35154
+ combine?: ListCustomersCombine | undefined;
34726
35155
  /**
34727
35156
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
34728
35157
  */
@@ -35123,6 +35552,18 @@ declare const ListEntitiesType: {
35123
35552
  * 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.
35124
35553
  */
35125
35554
  type ListEntitiesType = OpenEnum<typeof ListEntitiesType>;
35555
+ /**
35556
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
35557
+ */
35558
+ declare const ListEntitiesCombine: {
35559
+ readonly Sum: "sum";
35560
+ readonly Max: "max";
35561
+ readonly Min: "min";
35562
+ };
35563
+ /**
35564
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
35565
+ */
35566
+ type ListEntitiesCombine = OpenEnum<typeof ListEntitiesCombine>;
35126
35567
  type ListEntitiesDimensions6 = {
35127
35568
  /**
35128
35569
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -35447,6 +35888,10 @@ type ListEntitiesFeature = {
35447
35888
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
35448
35889
  */
35449
35890
  consumable: boolean;
35891
+ /**
35892
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
35893
+ */
35894
+ combine?: ListEntitiesCombine | undefined;
35450
35895
  /**
35451
35896
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
35452
35897
  */
@@ -36024,6 +36469,18 @@ declare const ListFeaturesType: {
36024
36469
  * 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.
36025
36470
  */
36026
36471
  type ListFeaturesType = OpenEnum<typeof ListFeaturesType>;
36472
+ /**
36473
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
36474
+ */
36475
+ declare const ListFeaturesCombine: {
36476
+ readonly Sum: "sum";
36477
+ readonly Max: "max";
36478
+ readonly Min: "min";
36479
+ };
36480
+ /**
36481
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
36482
+ */
36483
+ type ListFeaturesCombine = OpenEnum<typeof ListFeaturesCombine>;
36027
36484
  type ListFeaturesDimensions6 = {
36028
36485
  /**
36029
36486
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -36345,6 +36802,10 @@ type ListFeaturesList = {
36345
36802
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
36346
36803
  */
36347
36804
  consumable: boolean;
36805
+ /**
36806
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
36807
+ */
36808
+ combine?: ListFeaturesCombine | undefined;
36348
36809
  /**
36349
36810
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
36350
36811
  */
@@ -37000,6 +37461,16 @@ type ListPlansItemExpiry = {
37000
37461
  duration: ListPlansItemDuration;
37001
37462
  length: number;
37002
37463
  };
37464
+ type ListPlansCreditSchemaItemFeatureOverride3 = {
37465
+ /**
37466
+ * ID of the metered feature to remove from the credit system.
37467
+ */
37468
+ meteredFeatureId: string;
37469
+ /**
37470
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
37471
+ */
37472
+ excluded: true;
37473
+ };
37003
37474
  type ListPlansDimensionsItem4 = {
37004
37475
  /**
37005
37476
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -37218,9 +37689,9 @@ type ListPlansItemMarkups = {
37218
37689
  */
37219
37690
  type ListPlansItemFeatureOverride = {
37220
37691
  /**
37221
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
37692
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
37222
37693
  */
37223
- creditSchema?: Array<ListPlansCreditSchemaItemFeatureOverride1 | ListPlansCreditSchemaItemFeatureOverride2> | undefined;
37694
+ creditSchema?: Array<ListPlansCreditSchemaItemFeatureOverride1 | ListPlansCreditSchemaItemFeatureOverride2 | ListPlansCreditSchemaItemFeatureOverride3> | undefined;
37224
37695
  /**
37225
37696
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
37226
37697
  */
@@ -37942,6 +38413,16 @@ type ListPlansVariantDetailsExpiry = {
37942
38413
  duration: ListPlansVariantDetailsDuration;
37943
38414
  length: number;
37944
38415
  };
38416
+ type ListPlansCreditSchemaVariantDetails3 = {
38417
+ /**
38418
+ * ID of the metered feature to remove from the credit system.
38419
+ */
38420
+ meteredFeatureId: string;
38421
+ /**
38422
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
38423
+ */
38424
+ excluded: true;
38425
+ };
37945
38426
  type ListPlansDimensionsVariantDetails4 = {
37946
38427
  /**
37947
38428
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -38160,9 +38641,9 @@ type ListPlansVariantDetailsMarkups = {
38160
38641
  */
38161
38642
  type ListPlansVariantDetailsFeatureOverride = {
38162
38643
  /**
38163
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
38644
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
38164
38645
  */
38165
- creditSchema?: Array<ListPlansCreditSchemaVariantDetails1 | ListPlansCreditSchemaVariantDetails2> | undefined;
38646
+ creditSchema?: Array<ListPlansCreditSchemaVariantDetails1 | ListPlansCreditSchemaVariantDetails2 | ListPlansCreditSchemaVariantDetails3> | undefined;
38166
38647
  /**
38167
38648
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
38168
38649
  */
@@ -38495,6 +38976,7 @@ declare const ListPlansVariantDetailsBasis: {
38495
38976
  * What 100% means. balance: every grant on the feature. included: the plan allowance only. recurring: grants that reset. usage_limit: the cap of the usage limit with the same feature and filter.
38496
38977
  */
38497
38978
  type ListPlansVariantDetailsBasis = OpenEnum<typeof ListPlansVariantDetailsBasis>;
38979
+
38498
38980
  /**
38499
38981
  * Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter.
38500
38982
  */
@@ -38533,7 +39015,6 @@ type ListPlansVariantDetailsUsageAlert = {
38533
39015
  */
38534
39016
  name?: string | undefined;
38535
39017
  };
38536
-
38537
39018
  type ListPlansVariantDetailsOverageAllowed = {
38538
39019
  /**
38539
39020
  * The feature ID this overage allowed control applies to.
@@ -38843,6 +39324,16 @@ type ListPlansVariantDetailsUpsertLicenseExpiry = {
38843
39324
  duration: ListPlansVariantDetailsUpsertLicenseDuration;
38844
39325
  length: number;
38845
39326
  };
39327
+ type ListPlansCreditSchemaVariantDetailsUpsertLicense3 = {
39328
+ /**
39329
+ * ID of the metered feature to remove from the credit system.
39330
+ */
39331
+ meteredFeatureId: string;
39332
+ /**
39333
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
39334
+ */
39335
+ excluded: true;
39336
+ };
38846
39337
  type ListPlansDimensionsVariantDetailsUpsertLicense4 = {
38847
39338
  /**
38848
39339
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -39061,9 +39552,9 @@ type ListPlansVariantDetailsUpsertLicenseMarkups = {
39061
39552
  */
39062
39553
  type ListPlansVariantDetailsUpsertLicenseFeatureOverride = {
39063
39554
  /**
39064
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
39555
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
39065
39556
  */
39066
- creditSchema?: Array<ListPlansCreditSchemaVariantDetailsUpsertLicense1 | ListPlansCreditSchemaVariantDetailsUpsertLicense2> | undefined;
39557
+ creditSchema?: Array<ListPlansCreditSchemaVariantDetailsUpsertLicense1 | ListPlansCreditSchemaVariantDetailsUpsertLicense2 | ListPlansCreditSchemaVariantDetailsUpsertLicense3> | undefined;
39067
39558
  /**
39068
39559
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
39069
39560
  */
@@ -39513,6 +40004,16 @@ type ListPlansLicenseExpiry = {
39513
40004
  duration: ListPlansLicenseDuration;
39514
40005
  length: number;
39515
40006
  };
40007
+ type ListPlansCreditSchemaLicense3 = {
40008
+ /**
40009
+ * ID of the metered feature to remove from the credit system.
40010
+ */
40011
+ meteredFeatureId: string;
40012
+ /**
40013
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
40014
+ */
40015
+ excluded: true;
40016
+ };
39516
40017
  type ListPlansDimensionsLicense4 = {
39517
40018
  /**
39518
40019
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -39731,9 +40232,9 @@ type ListPlansLicenseMarkups = {
39731
40232
  */
39732
40233
  type ListPlansLicenseFeatureOverride = {
39733
40234
  /**
39734
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
40235
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
39735
40236
  */
39736
- creditSchema?: Array<ListPlansCreditSchemaLicense1 | ListPlansCreditSchemaLicense2> | undefined;
40237
+ creditSchema?: Array<ListPlansCreditSchemaLicense1 | ListPlansCreditSchemaLicense2 | ListPlansCreditSchemaLicense3> | undefined;
39737
40238
  /**
39738
40239
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
39739
40240
  */
@@ -40160,6 +40661,16 @@ type ListPlansVariantAddItemExpiry = {
40160
40661
  duration: ListPlansVariantAddItemDuration;
40161
40662
  length: number;
40162
40663
  };
40664
+ type ListPlansCreditSchemaVariantAddItem3 = {
40665
+ /**
40666
+ * ID of the metered feature to remove from the credit system.
40667
+ */
40668
+ meteredFeatureId: string;
40669
+ /**
40670
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
40671
+ */
40672
+ excluded: true;
40673
+ };
40163
40674
  type ListPlansDimensionsVariantAddItem4 = {
40164
40675
  /**
40165
40676
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -40290,7 +40801,7 @@ type ListPlansDimensionsVariantAddItem1 = {
40290
40801
  tierBehavior: "graduated";
40291
40802
  tiers: Array<ListPlansDimensionsVariantAddItemTier1>;
40292
40803
  };
40293
- type ListPlansVariantAddItemDimensionsUnion1 = ListPlansDimensionsVariantAddItem1 | ListPlansDimensionsVariantAddItem2;
40804
+
40294
40805
  type ListPlansVariantAddItemMultipliers1 = {
40295
40806
  /**
40296
40807
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -40321,7 +40832,6 @@ type ListPlansVariantAddItemFeatureOverrideTier = {
40321
40832
  */
40322
40833
  creditCost: number;
40323
40834
  };
40324
-
40325
40835
  type ListPlansCreditSchemaVariantAddItem1 = {
40326
40836
  /**
40327
40837
  * ID of the metered feature that draws from this credit system.
@@ -40335,7 +40845,7 @@ type ListPlansCreditSchemaVariantAddItem1 = {
40335
40845
  * Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies.
40336
40846
  */
40337
40847
  dimensions?: {
40338
- [k: string]: ListPlansVariantAddItemDimensionsUnion1;
40848
+ [k: string]: ListPlansDimensionsVariantAddItem1 | ListPlansDimensionsVariantAddItem2;
40339
40849
  } | undefined;
40340
40850
  /**
40341
40851
  * Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed.
@@ -40380,9 +40890,9 @@ type ListPlansVariantAddItemMarkups = {
40380
40890
  */
40381
40891
  type ListPlansVariantAddItemFeatureOverride = {
40382
40892
  /**
40383
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
40893
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
40384
40894
  */
40385
- creditSchema?: Array<ListPlansCreditSchemaVariantAddItem1 | ListPlansCreditSchemaVariantAddItem2> | undefined;
40895
+ creditSchema?: Array<ListPlansCreditSchemaVariantAddItem1 | ListPlansCreditSchemaVariantAddItem2 | ListPlansCreditSchemaVariantAddItem3> | undefined;
40386
40896
  /**
40387
40897
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
40388
40898
  */
@@ -41062,6 +41572,16 @@ type ListPlansVariantUpsertLicenseExpiry = {
41062
41572
  duration: ListPlansVariantUpsertLicenseDuration;
41063
41573
  length: number;
41064
41574
  };
41575
+ type ListPlansCreditSchemaVariantUpsertLicense3 = {
41576
+ /**
41577
+ * ID of the metered feature to remove from the credit system.
41578
+ */
41579
+ meteredFeatureId: string;
41580
+ /**
41581
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
41582
+ */
41583
+ excluded: true;
41584
+ };
41065
41585
  type ListPlansDimensionsVariantUpsertLicense4 = {
41066
41586
  /**
41067
41587
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -41272,9 +41792,9 @@ type ListPlansVariantUpsertLicenseMarkups = {
41272
41792
  */
41273
41793
  type ListPlansVariantUpsertLicenseFeatureOverride = {
41274
41794
  /**
41275
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
41795
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
41276
41796
  */
41277
- creditSchema?: Array<ListPlansCreditSchemaVariantUpsertLicense1 | ListPlansCreditSchemaVariantUpsertLicense2> | undefined;
41797
+ creditSchema?: Array<ListPlansCreditSchemaVariantUpsertLicense1 | ListPlansCreditSchemaVariantUpsertLicense2 | ListPlansCreditSchemaVariantUpsertLicense3> | undefined;
41278
41798
  /**
41279
41799
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
41280
41800
  */
@@ -41785,6 +42305,16 @@ type VariantPlanExpiry = {
41785
42305
  duration: VariantPlanDuration;
41786
42306
  length: number;
41787
42307
  };
42308
+ type CreditSchemaVariantPlanFeatureOverride3 = {
42309
+ /**
42310
+ * ID of the metered feature to remove from the credit system.
42311
+ */
42312
+ meteredFeatureId: string;
42313
+ /**
42314
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
42315
+ */
42316
+ excluded: true;
42317
+ };
41788
42318
  type DimensionsVariantPlan4 = {
41789
42319
  /**
41790
42320
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -42003,9 +42533,9 @@ type VariantPlanMarkups = {
42003
42533
  */
42004
42534
  type VariantPlanFeatureOverride = {
42005
42535
  /**
42006
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
42536
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
42007
42537
  */
42008
- creditSchema?: Array<CreditSchemaVariantPlanFeatureOverride1 | CreditSchemaVariantPlanFeatureOverride2> | undefined;
42538
+ creditSchema?: Array<CreditSchemaVariantPlanFeatureOverride1 | CreditSchemaVariantPlanFeatureOverride2 | CreditSchemaVariantPlanFeatureOverride3> | undefined;
42009
42539
  /**
42010
42540
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
42011
42541
  */
@@ -42147,6 +42677,7 @@ declare const VariantEnv: {
42147
42677
  * Environment this plan belongs to ('sandbox' or 'live').
42148
42678
  */
42149
42679
  type VariantEnv = OpenEnum<typeof VariantEnv>;
42680
+
42150
42681
  /**
42151
42682
  * Miscellaneous plan-level configuration flags.
42152
42683
  */
@@ -42262,7 +42793,6 @@ declare const VariantPlanUsageLimitInterval: {
42262
42793
  * Interval for the cap, aligned to the customer's billing cycle.
42263
42794
  */
42264
42795
  type VariantPlanUsageLimitInterval = OpenEnum<typeof VariantPlanUsageLimitInterval>;
42265
-
42266
42796
  /**
42267
42797
  * Window alignment. 'billing_cycle' phases the interval to the customer's renewal time; 'utc' aligns to the UTC calendar.
42268
42798
  */
@@ -43568,6 +44098,16 @@ type MultiAttachExpiry = {
43568
44098
  duration: MultiAttachDuration;
43569
44099
  length: number;
43570
44100
  };
44101
+ type MultiAttachCreditSchema3 = {
44102
+ /**
44103
+ * ID of the metered feature to remove from the credit system.
44104
+ */
44105
+ meteredFeatureId: string;
44106
+ /**
44107
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
44108
+ */
44109
+ excluded: true;
44110
+ };
43571
44111
  type MultiAttachDimensions4 = {
43572
44112
  /**
43573
44113
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -43786,9 +44326,9 @@ type MultiAttachMarkups = {
43786
44326
  */
43787
44327
  type MultiAttachFeatureOverride = {
43788
44328
  /**
43789
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
44329
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
43790
44330
  */
43791
- creditSchema?: Array<MultiAttachCreditSchema1 | MultiAttachCreditSchema2> | undefined;
44331
+ creditSchema?: Array<MultiAttachCreditSchema1 | MultiAttachCreditSchema2 | MultiAttachCreditSchema3> | undefined;
43792
44332
  /**
43793
44333
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
43794
44334
  */
@@ -45043,6 +45583,16 @@ type PreviewAttachItemExpiry = {
45043
45583
  duration: PreviewAttachItemDuration;
45044
45584
  length: number;
45045
45585
  };
45586
+ type PreviewAttachCreditSchemaItem3 = {
45587
+ /**
45588
+ * ID of the metered feature to remove from the credit system.
45589
+ */
45590
+ meteredFeatureId: string;
45591
+ /**
45592
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
45593
+ */
45594
+ excluded: true;
45595
+ };
45046
45596
  type PreviewAttachDimensionsItem4 = {
45047
45597
  /**
45048
45598
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -45261,9 +45811,9 @@ type PreviewAttachItemMarkups = {
45261
45811
  */
45262
45812
  type PreviewAttachItemFeatureOverride = {
45263
45813
  /**
45264
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
45814
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
45265
45815
  */
45266
- creditSchema?: Array<PreviewAttachCreditSchemaItem1 | PreviewAttachCreditSchemaItem2> | undefined;
45816
+ creditSchema?: Array<PreviewAttachCreditSchemaItem1 | PreviewAttachCreditSchemaItem2 | PreviewAttachCreditSchemaItem3> | undefined;
45267
45817
  /**
45268
45818
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
45269
45819
  */
@@ -45549,6 +46099,16 @@ type PreviewAttachAddItemExpiry = {
45549
46099
  duration: PreviewAttachAddItemDuration;
45550
46100
  length: number;
45551
46101
  };
46102
+ type PreviewAttachCreditSchemaAddItem3 = {
46103
+ /**
46104
+ * ID of the metered feature to remove from the credit system.
46105
+ */
46106
+ meteredFeatureId: string;
46107
+ /**
46108
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
46109
+ */
46110
+ excluded: true;
46111
+ };
45552
46112
  type PreviewAttachDimensionsAddItem4 = {
45553
46113
  /**
45554
46114
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -45767,9 +46327,9 @@ type PreviewAttachAddItemMarkups = {
45767
46327
  */
45768
46328
  type PreviewAttachAddItemFeatureOverride = {
45769
46329
  /**
45770
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
46330
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
45771
46331
  */
45772
- creditSchema?: Array<PreviewAttachCreditSchemaAddItem1 | PreviewAttachCreditSchemaAddItem2> | undefined;
46332
+ creditSchema?: Array<PreviewAttachCreditSchemaAddItem1 | PreviewAttachCreditSchemaAddItem2 | PreviewAttachCreditSchemaAddItem3> | undefined;
45773
46333
  /**
45774
46334
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
45775
46335
  */
@@ -46406,6 +46966,7 @@ type PreviewAttachUpsertLicenseProration = {
46406
46966
  */
46407
46967
  onDecrease: PreviewAttachUpsertLicenseOnDecrease;
46408
46968
  };
46969
+
46409
46970
  /**
46410
46971
  * When rolled over units expire.
46411
46972
  */
@@ -46438,7 +46999,6 @@ type PreviewAttachUpsertLicenseRollover = {
46438
46999
  */
46439
47000
  expiryDurationLength?: number | undefined;
46440
47001
  };
46441
-
46442
47002
  declare const PreviewAttachUpsertLicenseDuration: {
46443
47003
  readonly Day: "day";
46444
47004
  readonly Week: "week";
@@ -46453,6 +47013,16 @@ type PreviewAttachUpsertLicenseExpiry = {
46453
47013
  duration: PreviewAttachUpsertLicenseDuration;
46454
47014
  length: number;
46455
47015
  };
47016
+ type PreviewAttachCreditSchemaUpsertLicense3 = {
47017
+ /**
47018
+ * ID of the metered feature to remove from the credit system.
47019
+ */
47020
+ meteredFeatureId: string;
47021
+ /**
47022
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
47023
+ */
47024
+ excluded: true;
47025
+ };
46456
47026
  type PreviewAttachDimensionsUpsertLicense4 = {
46457
47027
  /**
46458
47028
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -46671,9 +47241,9 @@ type PreviewAttachUpsertLicenseMarkups = {
46671
47241
  */
46672
47242
  type PreviewAttachUpsertLicenseFeatureOverride = {
46673
47243
  /**
46674
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
47244
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
46675
47245
  */
46676
- creditSchema?: Array<PreviewAttachCreditSchemaUpsertLicense1 | PreviewAttachCreditSchemaUpsertLicense2> | undefined;
47246
+ creditSchema?: Array<PreviewAttachCreditSchemaUpsertLicense1 | PreviewAttachCreditSchemaUpsertLicense2 | PreviewAttachCreditSchemaUpsertLicense3> | undefined;
46677
47247
  /**
46678
47248
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
46679
47249
  */
@@ -48058,6 +48628,16 @@ type PreviewMultiAttachExpiry = {
48058
48628
  duration: PreviewMultiAttachDuration;
48059
48629
  length: number;
48060
48630
  };
48631
+ type PreviewMultiAttachCreditSchema3 = {
48632
+ /**
48633
+ * ID of the metered feature to remove from the credit system.
48634
+ */
48635
+ meteredFeatureId: string;
48636
+ /**
48637
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
48638
+ */
48639
+ excluded: true;
48640
+ };
48061
48641
  type PreviewMultiAttachDimensions4 = {
48062
48642
  /**
48063
48643
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -48276,9 +48856,9 @@ type PreviewMultiAttachMarkups = {
48276
48856
  */
48277
48857
  type PreviewMultiAttachFeatureOverride = {
48278
48858
  /**
48279
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
48859
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
48280
48860
  */
48281
- creditSchema?: Array<PreviewMultiAttachCreditSchema1 | PreviewMultiAttachCreditSchema2> | undefined;
48861
+ creditSchema?: Array<PreviewMultiAttachCreditSchema1 | PreviewMultiAttachCreditSchema2 | PreviewMultiAttachCreditSchema3> | undefined;
48282
48862
  /**
48283
48863
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
48284
48864
  */
@@ -50186,6 +50766,16 @@ type PreviewUpdateItemExpiry = {
50186
50766
  duration: PreviewUpdateItemDuration;
50187
50767
  length: number;
50188
50768
  };
50769
+ type PreviewUpdateCreditSchemaItem3 = {
50770
+ /**
50771
+ * ID of the metered feature to remove from the credit system.
50772
+ */
50773
+ meteredFeatureId: string;
50774
+ /**
50775
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
50776
+ */
50777
+ excluded: true;
50778
+ };
50189
50779
  type PreviewUpdateDimensionsItem4 = {
50190
50780
  /**
50191
50781
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -50404,9 +50994,9 @@ type PreviewUpdateItemMarkups = {
50404
50994
  */
50405
50995
  type PreviewUpdateItemFeatureOverride = {
50406
50996
  /**
50407
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
50997
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
50408
50998
  */
50409
- creditSchema?: Array<PreviewUpdateCreditSchemaItem1 | PreviewUpdateCreditSchemaItem2> | undefined;
50999
+ creditSchema?: Array<PreviewUpdateCreditSchemaItem1 | PreviewUpdateCreditSchemaItem2 | PreviewUpdateCreditSchemaItem3> | undefined;
50410
51000
  /**
50411
51001
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
50412
51002
  */
@@ -50692,6 +51282,16 @@ type PreviewUpdateAddItemExpiry = {
50692
51282
  duration: PreviewUpdateAddItemDuration;
50693
51283
  length: number;
50694
51284
  };
51285
+ type PreviewUpdateCreditSchemaAddItem3 = {
51286
+ /**
51287
+ * ID of the metered feature to remove from the credit system.
51288
+ */
51289
+ meteredFeatureId: string;
51290
+ /**
51291
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
51292
+ */
51293
+ excluded: true;
51294
+ };
50695
51295
  type PreviewUpdateDimensionsAddItem4 = {
50696
51296
  /**
50697
51297
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -50910,9 +51510,9 @@ type PreviewUpdateAddItemMarkups = {
50910
51510
  */
50911
51511
  type PreviewUpdateAddItemFeatureOverride = {
50912
51512
  /**
50913
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
51513
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
50914
51514
  */
50915
- creditSchema?: Array<PreviewUpdateCreditSchemaAddItem1 | PreviewUpdateCreditSchemaAddItem2> | undefined;
51515
+ creditSchema?: Array<PreviewUpdateCreditSchemaAddItem1 | PreviewUpdateCreditSchemaAddItem2 | PreviewUpdateCreditSchemaAddItem3> | undefined;
50916
51516
  /**
50917
51517
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
50918
51518
  */
@@ -51549,6 +52149,7 @@ type PreviewUpdateUpsertLicenseProration = {
51549
52149
  */
51550
52150
  onDecrease: PreviewUpdateUpsertLicenseOnDecrease;
51551
52151
  };
52152
+
51552
52153
  /**
51553
52154
  * When rolled over units expire.
51554
52155
  */
@@ -51581,7 +52182,6 @@ type PreviewUpdateUpsertLicenseRollover = {
51581
52182
  */
51582
52183
  expiryDurationLength?: number | undefined;
51583
52184
  };
51584
-
51585
52185
  declare const PreviewUpdateUpsertLicenseDuration: {
51586
52186
  readonly Day: "day";
51587
52187
  readonly Week: "week";
@@ -51596,6 +52196,16 @@ type PreviewUpdateUpsertLicenseExpiry = {
51596
52196
  duration: PreviewUpdateUpsertLicenseDuration;
51597
52197
  length: number;
51598
52198
  };
52199
+ type PreviewUpdateCreditSchemaUpsertLicense3 = {
52200
+ /**
52201
+ * ID of the metered feature to remove from the credit system.
52202
+ */
52203
+ meteredFeatureId: string;
52204
+ /**
52205
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
52206
+ */
52207
+ excluded: true;
52208
+ };
51599
52209
  type PreviewUpdateDimensionsUpsertLicense4 = {
51600
52210
  /**
51601
52211
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -51814,9 +52424,9 @@ type PreviewUpdateUpsertLicenseMarkups = {
51814
52424
  */
51815
52425
  type PreviewUpdateUpsertLicenseFeatureOverride = {
51816
52426
  /**
51817
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
52427
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
51818
52428
  */
51819
- creditSchema?: Array<PreviewUpdateCreditSchemaUpsertLicense1 | PreviewUpdateCreditSchemaUpsertLicense2> | undefined;
52429
+ creditSchema?: Array<PreviewUpdateCreditSchemaUpsertLicense1 | PreviewUpdateCreditSchemaUpsertLicense2 | PreviewUpdateCreditSchemaUpsertLicense3> | undefined;
51820
52430
  /**
51821
52431
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
51822
52432
  */
@@ -53341,7 +53951,7 @@ type ReissueInvoiceCreditSchema1 = {
53341
53951
  */
53342
53952
  type ReissueInvoiceFeatureOverride = {
53343
53953
  /**
53344
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
53954
+ * Replaces the feature's credit_schema entirely for this invoice.
53345
53955
  */
53346
53956
  creditSchema?: Array<ReissueInvoiceCreditSchema1 | ReissueInvoiceCreditSchema2> | undefined;
53347
53957
  };
@@ -53772,7 +54382,7 @@ type ReissueInvoiceCreditSchemaLicenseQuantity1 = {
53772
54382
  */
53773
54383
  type ReissueInvoiceLicenseQuantityFeatureOverride = {
53774
54384
  /**
53775
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
54385
+ * Replaces the feature's credit_schema entirely for this invoice.
53776
54386
  */
53777
54387
  creditSchema?: Array<ReissueInvoiceCreditSchemaLicenseQuantity1 | ReissueInvoiceCreditSchemaLicenseQuantity2> | undefined;
53778
54388
  };
@@ -54743,6 +55353,16 @@ type SetupPaymentItemExpiry = {
54743
55353
  duration: SetupPaymentItemDuration;
54744
55354
  length: number;
54745
55355
  };
55356
+ type SetupPaymentCreditSchemaItem3 = {
55357
+ /**
55358
+ * ID of the metered feature to remove from the credit system.
55359
+ */
55360
+ meteredFeatureId: string;
55361
+ /**
55362
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
55363
+ */
55364
+ excluded: true;
55365
+ };
54746
55366
  type SetupPaymentDimensionsItem4 = {
54747
55367
  /**
54748
55368
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -54961,9 +55581,9 @@ type SetupPaymentItemMarkups = {
54961
55581
  */
54962
55582
  type SetupPaymentItemFeatureOverride = {
54963
55583
  /**
54964
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
55584
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
54965
55585
  */
54966
- creditSchema?: Array<SetupPaymentCreditSchemaItem1 | SetupPaymentCreditSchemaItem2> | undefined;
55586
+ creditSchema?: Array<SetupPaymentCreditSchemaItem1 | SetupPaymentCreditSchemaItem2 | SetupPaymentCreditSchemaItem3> | undefined;
54967
55587
  /**
54968
55588
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
54969
55589
  */
@@ -55249,6 +55869,16 @@ type SetupPaymentAddItemExpiry = {
55249
55869
  duration: SetupPaymentAddItemDuration;
55250
55870
  length: number;
55251
55871
  };
55872
+ type SetupPaymentCreditSchemaAddItem3 = {
55873
+ /**
55874
+ * ID of the metered feature to remove from the credit system.
55875
+ */
55876
+ meteredFeatureId: string;
55877
+ /**
55878
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
55879
+ */
55880
+ excluded: true;
55881
+ };
55252
55882
  type SetupPaymentDimensionsAddItem4 = {
55253
55883
  /**
55254
55884
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -55467,9 +56097,9 @@ type SetupPaymentAddItemMarkups = {
55467
56097
  */
55468
56098
  type SetupPaymentAddItemFeatureOverride = {
55469
56099
  /**
55470
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
56100
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
55471
56101
  */
55472
- creditSchema?: Array<SetupPaymentCreditSchemaAddItem1 | SetupPaymentCreditSchemaAddItem2> | undefined;
56102
+ creditSchema?: Array<SetupPaymentCreditSchemaAddItem1 | SetupPaymentCreditSchemaAddItem2 | SetupPaymentCreditSchemaAddItem3> | undefined;
55473
56103
  /**
55474
56104
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
55475
56105
  */
@@ -56106,6 +56736,7 @@ type SetupPaymentUpsertLicenseProration = {
56106
56736
  */
56107
56737
  onDecrease: SetupPaymentUpsertLicenseOnDecrease;
56108
56738
  };
56739
+
56109
56740
  /**
56110
56741
  * When rolled over units expire.
56111
56742
  */
@@ -56138,7 +56769,6 @@ type SetupPaymentUpsertLicenseRollover = {
56138
56769
  */
56139
56770
  expiryDurationLength?: number | undefined;
56140
56771
  };
56141
-
56142
56772
  declare const SetupPaymentUpsertLicenseDuration: {
56143
56773
  readonly Day: "day";
56144
56774
  readonly Week: "week";
@@ -56153,6 +56783,16 @@ type SetupPaymentUpsertLicenseExpiry = {
56153
56783
  duration: SetupPaymentUpsertLicenseDuration;
56154
56784
  length: number;
56155
56785
  };
56786
+ type SetupPaymentCreditSchemaUpsertLicense3 = {
56787
+ /**
56788
+ * ID of the metered feature to remove from the credit system.
56789
+ */
56790
+ meteredFeatureId: string;
56791
+ /**
56792
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
56793
+ */
56794
+ excluded: true;
56795
+ };
56156
56796
  type SetupPaymentDimensionsUpsertLicense4 = {
56157
56797
  /**
56158
56798
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -56371,9 +57011,9 @@ type SetupPaymentUpsertLicenseMarkups = {
56371
57011
  */
56372
57012
  type SetupPaymentUpsertLicenseFeatureOverride = {
56373
57013
  /**
56374
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
57014
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
56375
57015
  */
56376
- creditSchema?: Array<SetupPaymentCreditSchemaUpsertLicense1 | SetupPaymentCreditSchemaUpsertLicense2> | undefined;
57016
+ creditSchema?: Array<SetupPaymentCreditSchemaUpsertLicense1 | SetupPaymentCreditSchemaUpsertLicense2 | SetupPaymentCreditSchemaUpsertLicense3> | undefined;
56377
57017
  /**
56378
57018
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
56379
57019
  */
@@ -58825,6 +59465,18 @@ declare const UpdateCustomerType: {
58825
59465
  * 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.
58826
59466
  */
58827
59467
  type UpdateCustomerType = OpenEnum<typeof UpdateCustomerType>;
59468
+ /**
59469
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
59470
+ */
59471
+ declare const UpdateCustomerCombine: {
59472
+ readonly Sum: "sum";
59473
+ readonly Max: "max";
59474
+ readonly Min: "min";
59475
+ };
59476
+ /**
59477
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
59478
+ */
59479
+ type UpdateCustomerCombine = OpenEnum<typeof UpdateCustomerCombine>;
58828
59480
  type UpdateCustomerDimensions6 = {
58829
59481
  /**
58830
59482
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -59149,6 +59801,10 @@ type UpdateCustomerFeature = {
59149
59801
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
59150
59802
  */
59151
59803
  consumable: boolean;
59804
+ /**
59805
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
59806
+ */
59807
+ combine?: UpdateCustomerCombine | undefined;
59152
59808
  /**
59153
59809
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
59154
59810
  */
@@ -59744,6 +60400,18 @@ declare const UpdateEntityType: {
59744
60400
  * 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.
59745
60401
  */
59746
60402
  type UpdateEntityType = OpenEnum<typeof UpdateEntityType>;
60403
+ /**
60404
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
60405
+ */
60406
+ declare const UpdateEntityCombine: {
60407
+ readonly Sum: "sum";
60408
+ readonly Max: "max";
60409
+ readonly Min: "min";
60410
+ };
60411
+ /**
60412
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
60413
+ */
60414
+ type UpdateEntityCombine = OpenEnum<typeof UpdateEntityCombine>;
59747
60415
  type UpdateEntityDimensions6 = {
59748
60416
  /**
59749
60417
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -60068,6 +60736,10 @@ type UpdateEntityFeature = {
60068
60736
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
60069
60737
  */
60070
60738
  consumable: boolean;
60739
+ /**
60740
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
60741
+ */
60742
+ combine?: UpdateEntityCombine | undefined;
60071
60743
  /**
60072
60744
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
60073
60745
  */
@@ -60481,6 +61153,18 @@ declare const UpdateFeatureTypeRequestBody: {
60481
61153
  * The type of the feature. 'single_use' features are consumed, like API calls, tokens, or messages. 'continuous_use' features are allocated, like seats, workspaces, or projects. 'credit_system' features are schemas that unify multiple 'single_use' features into a single credit system.
60482
61154
  */
60483
61155
  type UpdateFeatureTypeRequestBody = ClosedEnum<typeof UpdateFeatureTypeRequestBody>;
61156
+ /**
61157
+ * How grants of this feature from several plans combine. 'sum' (default) adds them up. 'max' or 'min' keeps only the highest or lowest grant among plan items with no price; priced items always add on top. Metered and credit system features only.
61158
+ */
61159
+ declare const UpdateFeatureCombineRequest: {
61160
+ readonly Sum: "sum";
61161
+ readonly Max: "max";
61162
+ readonly Min: "min";
61163
+ };
61164
+ /**
61165
+ * How grants of this feature from several plans combine. 'sum' (default) adds them up. 'max' or 'min' keeps only the highest or lowest grant among plan items with no price; priced items always add on top. Metered and credit system features only.
61166
+ */
61167
+ type UpdateFeatureCombineRequest = ClosedEnum<typeof UpdateFeatureCombineRequest>;
60484
61168
  /**
60485
61169
  * Singular and plural display names for the feature in your user interface.
60486
61170
  */
@@ -60693,6 +61377,10 @@ type UpdateFeatureParams = {
60693
61377
  * Whether this feature is consumable. A consumable feature is one that periodically resets and is consumed rather than allocated (like credits, API requests, etc.). Applicable only for 'metered' features.
60694
61378
  */
60695
61379
  consumable?: boolean | undefined;
61380
+ /**
61381
+ * How grants of this feature from several plans combine. 'sum' (default) adds them up. 'max' or 'min' keeps only the highest or lowest grant among plan items with no price; priced items always add on top. Metered and credit system features only.
61382
+ */
61383
+ combine?: UpdateFeatureCombineRequest | undefined;
60696
61384
  /**
60697
61385
  * Singular and plural display names for the feature in your user interface.
60698
61386
  */
@@ -60744,6 +61432,18 @@ declare const UpdateFeatureTypeResponse: {
60744
61432
  * 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.
60745
61433
  */
60746
61434
  type UpdateFeatureTypeResponse = OpenEnum<typeof UpdateFeatureTypeResponse>;
61435
+ /**
61436
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
61437
+ */
61438
+ declare const UpdateFeatureCombineResponse: {
61439
+ readonly Sum: "sum";
61440
+ readonly Max: "max";
61441
+ readonly Min: "min";
61442
+ };
61443
+ /**
61444
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
61445
+ */
61446
+ type UpdateFeatureCombineResponse = OpenEnum<typeof UpdateFeatureCombineResponse>;
60747
61447
  type UpdateFeatureDimensionsResponse6 = {
60748
61448
  /**
60749
61449
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -61068,6 +61768,10 @@ type UpdateFeatureResponse = {
61068
61768
  * For metered features: true if usage resets periodically (API calls, credits), false if allocated persistently (seats, storage).
61069
61769
  */
61070
61770
  consumable: boolean;
61771
+ /**
61772
+ * How grants of this feature from several plans combine: 'sum' adds them up, 'max' / 'min' keep the highest / lowest grant among plan items with no price. Omitted when 'sum'.
61773
+ */
61774
+ combine?: UpdateFeatureCombineResponse | undefined;
61071
61775
  /**
61072
61776
  * Event names that trigger this feature's balance. Allows multiple features to respond to a single event.
61073
61777
  */
@@ -61535,6 +62239,16 @@ type UpdatePlanItemExpiryRequestBody = {
61535
62239
  duration: UpdatePlanItemDurationRequestBody;
61536
62240
  length: number;
61537
62241
  };
62242
+ type UpdatePlanCreditSchemaItemRequestBody3 = {
62243
+ /**
62244
+ * ID of the metered feature to remove from the credit system.
62245
+ */
62246
+ meteredFeatureId: string;
62247
+ /**
62248
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
62249
+ */
62250
+ excluded: true;
62251
+ };
61538
62252
  type UpdatePlanDimensionsItemRequestBody4 = {
61539
62253
  /**
61540
62254
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -61753,9 +62467,9 @@ type UpdatePlanItemMarkupsRequestBody = {
61753
62467
  */
61754
62468
  type UpdatePlanItemFeatureOverrideRequestBody = {
61755
62469
  /**
61756
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
62470
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
61757
62471
  */
61758
- creditSchema?: Array<UpdatePlanCreditSchemaItemRequestBody1 | UpdatePlanCreditSchemaItemRequestBody2> | undefined;
62472
+ creditSchema?: Array<UpdatePlanCreditSchemaItemRequestBody1 | UpdatePlanCreditSchemaItemRequestBody2 | UpdatePlanCreditSchemaItemRequestBody3> | undefined;
61759
62473
  /**
61760
62474
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
61761
62475
  */
@@ -62087,6 +62801,16 @@ type UpdatePlanLicenseExpiryRequestBody = {
62087
62801
  duration: UpdatePlanLicenseDurationRequestBody;
62088
62802
  length: number;
62089
62803
  };
62804
+ type UpdatePlanCreditSchemaLicenseRequestBody3 = {
62805
+ /**
62806
+ * ID of the metered feature to remove from the credit system.
62807
+ */
62808
+ meteredFeatureId: string;
62809
+ /**
62810
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
62811
+ */
62812
+ excluded: true;
62813
+ };
62090
62814
  type UpdatePlanDimensionsLicenseRequestBody4 = {
62091
62815
  /**
62092
62816
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -62305,9 +63029,9 @@ type UpdatePlanLicenseMarkupsRequestBody = {
62305
63029
  */
62306
63030
  type UpdatePlanLicenseFeatureOverrideRequestBody = {
62307
63031
  /**
62308
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
63032
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
62309
63033
  */
62310
- creditSchema?: Array<UpdatePlanCreditSchemaLicenseRequestBody1 | UpdatePlanCreditSchemaLicenseRequestBody2> | undefined;
63034
+ creditSchema?: Array<UpdatePlanCreditSchemaLicenseRequestBody1 | UpdatePlanCreditSchemaLicenseRequestBody2 | UpdatePlanCreditSchemaLicenseRequestBody3> | undefined;
62311
63035
  /**
62312
63036
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
62313
63037
  */
@@ -62889,6 +63613,7 @@ declare const UpdatePlanVariantAddItemPriceInterval: {
62889
63613
  * Billing interval. For consumable features, should match reset.interval.
62890
63614
  */
62891
63615
  type UpdatePlanVariantAddItemPriceInterval = ClosedEnum<typeof UpdatePlanVariantAddItemPriceInterval>;
63616
+
62892
63617
  /**
62893
63618
  * 'prepaid' for upfront payment (seats), 'usage_based' for pay-as-you-go.
62894
63619
  */
@@ -62941,7 +63666,6 @@ type UpdatePlanVariantPrice = {
62941
63666
  */
62942
63667
  maxPurchase?: number | null | undefined;
62943
63668
  };
62944
-
62945
63669
  /**
62946
63670
  * Billing behavior when quantity increases mid-cycle.
62947
63671
  */
@@ -63028,6 +63752,16 @@ type UpdatePlanVariantExpiry = {
63028
63752
  duration: UpdatePlanVariantDuration;
63029
63753
  length: number;
63030
63754
  };
63755
+ type UpdatePlanCreditSchemaVariant3 = {
63756
+ /**
63757
+ * ID of the metered feature to remove from the credit system.
63758
+ */
63759
+ meteredFeatureId: string;
63760
+ /**
63761
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
63762
+ */
63763
+ excluded: true;
63764
+ };
63031
63765
  type UpdatePlanDimensionsVariant4 = {
63032
63766
  /**
63033
63767
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -63246,9 +63980,9 @@ type UpdatePlanVariantMarkups = {
63246
63980
  */
63247
63981
  type UpdatePlanVariantFeatureOverride = {
63248
63982
  /**
63249
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
63983
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
63250
63984
  */
63251
- creditSchema?: Array<UpdatePlanCreditSchemaVariant1 | UpdatePlanCreditSchemaVariant2> | undefined;
63985
+ creditSchema?: Array<UpdatePlanCreditSchemaVariant1 | UpdatePlanCreditSchemaVariant2 | UpdatePlanCreditSchemaVariant3> | undefined;
63252
63986
  /**
63253
63987
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
63254
63988
  */
@@ -63931,6 +64665,16 @@ type UpdatePlanVariantUpsertLicenseExpiry = {
63931
64665
  duration: UpdatePlanVariantUpsertLicenseDuration;
63932
64666
  length: number;
63933
64667
  };
64668
+ type UpdatePlanCreditSchemaVariantUpsertLicense3 = {
64669
+ /**
64670
+ * ID of the metered feature to remove from the credit system.
64671
+ */
64672
+ meteredFeatureId: string;
64673
+ /**
64674
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
64675
+ */
64676
+ excluded: true;
64677
+ };
63934
64678
  type UpdatePlanDimensionsVariantUpsertLicense4 = {
63935
64679
  /**
63936
64680
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -64149,9 +64893,9 @@ type UpdatePlanVariantUpsertLicenseMarkups = {
64149
64893
  */
64150
64894
  type UpdatePlanVariantUpsertLicenseFeatureOverride = {
64151
64895
  /**
64152
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
64896
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
64153
64897
  */
64154
- creditSchema?: Array<UpdatePlanCreditSchemaVariantUpsertLicense1 | UpdatePlanCreditSchemaVariantUpsertLicense2> | undefined;
64898
+ creditSchema?: Array<UpdatePlanCreditSchemaVariantUpsertLicense1 | UpdatePlanCreditSchemaVariantUpsertLicense2 | UpdatePlanCreditSchemaVariantUpsertLicense3> | undefined;
64155
64899
  /**
64156
64900
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
64157
64901
  */
@@ -64643,6 +65387,7 @@ declare const UpdatePlanItemTierBehaviorResponse: {
64643
65387
  * How tiers price usage. 'graduated' (default) charges each unit at the rate of the tier it falls in. 'volume' picks one tier from total usage. On usage-based items it bills only usage past the included amount, at the rate of the tier total usage reaches, plus its flat_amount. On prepaid items it charges every unit, the included ones too, at that tier's rate plus its flat_amount.
64644
65388
  */
64645
65389
  type UpdatePlanItemTierBehaviorResponse = OpenEnum<typeof UpdatePlanItemTierBehaviorResponse>;
65390
+
64646
65391
  /**
64647
65392
  * Billing interval for this price. For consumable features, should match reset.interval.
64648
65393
  */
@@ -64681,7 +65426,6 @@ type UpdatePlanItemStripe = {
64681
65426
  type UpdatePlanItemProcessors = {
64682
65427
  stripe?: UpdatePlanItemStripe | null | undefined;
64683
65428
  };
64684
-
64685
65429
  type UpdatePlanItemPriceResponse = {
64686
65430
  /**
64687
65431
  * Price per billing_units after included usage is consumed. Mutually exclusive with tiers.
@@ -64780,6 +65524,16 @@ type UpdatePlanItemExpiryResponse = {
64780
65524
  duration: UpdatePlanItemDurationResponse;
64781
65525
  length: number;
64782
65526
  };
65527
+ type UpdatePlanCreditSchemaItemFeatureOverrideResponse3 = {
65528
+ /**
65529
+ * ID of the metered feature to remove from the credit system.
65530
+ */
65531
+ meteredFeatureId: string;
65532
+ /**
65533
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
65534
+ */
65535
+ excluded: true;
65536
+ };
64783
65537
  type UpdatePlanDimensionsItemResponse4 = {
64784
65538
  /**
64785
65539
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -64998,9 +65752,9 @@ type UpdatePlanItemMarkupsResponse = {
64998
65752
  */
64999
65753
  type UpdatePlanItemFeatureOverrideResponse = {
65000
65754
  /**
65001
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
65755
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
65002
65756
  */
65003
- creditSchema?: Array<UpdatePlanCreditSchemaItemFeatureOverrideResponse1 | UpdatePlanCreditSchemaItemFeatureOverrideResponse2> | undefined;
65757
+ creditSchema?: Array<UpdatePlanCreditSchemaItemFeatureOverrideResponse1 | UpdatePlanCreditSchemaItemFeatureOverrideResponse2 | UpdatePlanCreditSchemaItemFeatureOverrideResponse3> | undefined;
65004
65758
  /**
65005
65759
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
65006
65760
  */
@@ -65722,6 +66476,16 @@ type UpdatePlanVariantDetailsExpiry = {
65722
66476
  duration: UpdatePlanVariantDetailsDuration;
65723
66477
  length: number;
65724
66478
  };
66479
+ type UpdatePlanCreditSchemaVariantDetails3 = {
66480
+ /**
66481
+ * ID of the metered feature to remove from the credit system.
66482
+ */
66483
+ meteredFeatureId: string;
66484
+ /**
66485
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
66486
+ */
66487
+ excluded: true;
66488
+ };
65725
66489
  type UpdatePlanDimensionsVariantDetails4 = {
65726
66490
  /**
65727
66491
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -65940,9 +66704,9 @@ type UpdatePlanVariantDetailsMarkups = {
65940
66704
  */
65941
66705
  type UpdatePlanVariantDetailsFeatureOverride = {
65942
66706
  /**
65943
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
66707
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
65944
66708
  */
65945
- creditSchema?: Array<UpdatePlanCreditSchemaVariantDetails1 | UpdatePlanCreditSchemaVariantDetails2> | undefined;
66709
+ creditSchema?: Array<UpdatePlanCreditSchemaVariantDetails1 | UpdatePlanCreditSchemaVariantDetails2 | UpdatePlanCreditSchemaVariantDetails3> | undefined;
65946
66710
  /**
65947
66711
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
65948
66712
  */
@@ -66563,6 +67327,7 @@ declare const UpdatePlanUpsertLicenseOnDecreaseResponse: {
66563
67327
  * Credit behavior when quantity decreases mid-cycle.
66564
67328
  */
66565
67329
  type UpdatePlanUpsertLicenseOnDecreaseResponse = OpenEnum<typeof UpdatePlanUpsertLicenseOnDecreaseResponse>;
67330
+
66566
67331
  /**
66567
67332
  * Proration settings for prepaid features. Controls mid-cycle quantity change billing.
66568
67333
  */
@@ -66622,6 +67387,16 @@ type UpdatePlanVariantDetailsUpsertLicenseExpiry = {
66622
67387
  duration: UpdatePlanVariantDetailsUpsertLicenseDuration;
66623
67388
  length: number;
66624
67389
  };
67390
+ type UpdatePlanCreditSchemaVariantDetailsUpsertLicense3 = {
67391
+ /**
67392
+ * ID of the metered feature to remove from the credit system.
67393
+ */
67394
+ meteredFeatureId: string;
67395
+ /**
67396
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
67397
+ */
67398
+ excluded: true;
67399
+ };
66625
67400
  type UpdatePlanDimensionsVariantDetailsUpsertLicense4 = {
66626
67401
  /**
66627
67402
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -66638,7 +67413,6 @@ type UpdatePlanDimensionsVariantDetailsUpsertLicense4 = {
66638
67413
  */
66639
67414
  creditCost: number;
66640
67415
  };
66641
-
66642
67416
  declare const UpdatePlanDimensionsToVariantDetailsUpsertLicenseEnum2: {
66643
67417
  readonly Inf: "inf";
66644
67418
  };
@@ -66841,9 +67615,9 @@ type UpdatePlanVariantDetailsUpsertLicenseMarkups = {
66841
67615
  */
66842
67616
  type UpdatePlanVariantDetailsUpsertLicenseFeatureOverride = {
66843
67617
  /**
66844
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
67618
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
66845
67619
  */
66846
- creditSchema?: Array<UpdatePlanCreditSchemaVariantDetailsUpsertLicense1 | UpdatePlanCreditSchemaVariantDetailsUpsertLicense2> | undefined;
67620
+ creditSchema?: Array<UpdatePlanCreditSchemaVariantDetailsUpsertLicense1 | UpdatePlanCreditSchemaVariantDetailsUpsertLicense2 | UpdatePlanCreditSchemaVariantDetailsUpsertLicense3> | undefined;
66847
67621
  /**
66848
67622
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
66849
67623
  */
@@ -67293,6 +68067,16 @@ type UpdatePlanLicenseExpiryResponse = {
67293
68067
  duration: UpdatePlanLicenseDurationResponse;
67294
68068
  length: number;
67295
68069
  };
68070
+ type UpdatePlanCreditSchemaLicenseResponse3 = {
68071
+ /**
68072
+ * ID of the metered feature to remove from the credit system.
68073
+ */
68074
+ meteredFeatureId: string;
68075
+ /**
68076
+ * Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate.
68077
+ */
68078
+ excluded: true;
68079
+ };
67296
68080
  type UpdatePlanDimensionsLicenseResponse4 = {
67297
68081
  /**
67298
68082
  * Event properties this entry applies to. Every key must equal the tracked property, compared as strings.
@@ -67511,9 +68295,9 @@ type UpdatePlanLicenseMarkupsResponse = {
67511
68295
  */
67512
68296
  type UpdatePlanLicenseFeatureOverrideResponse = {
67513
68297
  /**
67514
- * For credit system features: replaces the feature's credit_schema entirely for customers on this plan.
68298
+ * For credit system features: merges into the feature's credit_schema by metered_feature_id for customers on this plan. A row with a rate overrides or adds that feature, a row with `excluded: true` removes it, and unlisted features keep the credit system's rate.
67515
68299
  */
67516
- creditSchema?: Array<UpdatePlanCreditSchemaLicenseResponse1 | UpdatePlanCreditSchemaLicenseResponse2> | undefined;
68300
+ creditSchema?: Array<UpdatePlanCreditSchemaLicenseResponse1 | UpdatePlanCreditSchemaLicenseResponse2 | UpdatePlanCreditSchemaLicenseResponse3> | undefined;
67517
68301
  /**
67518
68302
  * For AI credit system features: replaces the feature's markup chain entirely for customers on this plan. An unset level means no markup at that level rather than inheriting the feature's.
67519
68303
  */
@@ -69893,6 +70677,7 @@ declare class Features extends ClientSDK {
69893
70677
  * @param name - The name of the feature.
69894
70678
  * @param type - The type of the feature. 'single_use' features are consumed, like API calls, tokens, or messages. 'continuous_use' features are allocated, like seats, workspaces, or projects. 'credit_system' features are schemas that unify multiple 'single_use' features into a single credit system.
69895
70679
  * @param consumable - Whether this feature is consumable. A consumable feature is one that periodically resets and is consumed rather than allocated (like credits, API requests, etc.). Applicable only for 'metered' features. (optional)
70680
+ * @param combine - How grants of this feature from several plans combine. 'sum' (default) adds them up. 'max' or 'min' keeps only the highest or lowest grant among plan items with no price; priced items always add on top. Metered and credit system features only. (optional)
69896
70681
  * @param display - Singular and plural display names for the feature in your user interface. (optional)
69897
70682
  * @param creditSchema - A schema that maps metered feature IDs to flat or graduated credit costs. For classic credit systems only — AI credit systems use model_markups instead. (optional)
69898
70683
  * @param modelMarkups - Per-model markup overrides for AI credit systems. Maps model IDs to their markup configuration. (optional)
@@ -69947,6 +70732,7 @@ declare class Features extends ClientSDK {
69947
70732
  * @param name - The name of the feature. (optional)
69948
70733
  * @param type - The type of the feature. 'single_use' features are consumed, like API calls, tokens, or messages. 'continuous_use' features are allocated, like seats, workspaces, or projects. 'credit_system' features are schemas that unify multiple 'single_use' features into a single credit system. (optional)
69949
70734
  * @param consumable - Whether this feature is consumable. A consumable feature is one that periodically resets and is consumed rather than allocated (like credits, API requests, etc.). Applicable only for 'metered' features. (optional)
70735
+ * @param combine - How grants of this feature from several plans combine. 'sum' (default) adds them up. 'max' or 'min' keeps only the highest or lowest grant among plan items with no price; priced items always add on top. Metered and credit system features only. (optional)
69950
70736
  * @param display - Singular and plural display names for the feature in your user interface. (optional)
69951
70737
  * @param creditSchema - A schema that maps metered feature IDs to flat or graduated credit costs. For classic credit systems only — AI credit systems use model_markups instead. (optional)
69952
70738
  * @param modelMarkups - Per-model markup overrides for AI credit systems. Maps model IDs to their markup configuration. (optional)