atmn 2.0.141 → 2.0.143

package/src/generated/emit.ts

@@ -17,6 +17,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"name",
 			"type",
 			"consumable",
+			"combine",
 			"creditSchema",
 			"modelMarkups",
 			"defaultMarkup",
@@ -46,6 +47,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 		],
 		paths: [
 			"archived",
+			"combine",
 			"consumable",
 			"creditSchema",
 			"creditSchema.billingUnits",
@@ -141,6 +143,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"items.featureOverride.creditSchema.dimensions.*.tiers",
 			"items.featureOverride.creditSchema.dimensions.*.tiers.creditCost",
 			"items.featureOverride.creditSchema.dimensions.*.tiers.to",
+			"items.featureOverride.creditSchema.excluded",
 			"items.featureOverride.creditSchema.meteredFeatureId",
 			"items.featureOverride.creditSchema.multipliers.*.match",
 			"items.featureOverride.creditSchema.tierBehavior",
@@ -169,6 +172,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"licenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers",
 			"licenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.creditCost",
 			"licenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.to",
+			"licenses.customize.addItems.featureOverride.creditSchema.excluded",
 			"licenses.customize.addItems.featureOverride.creditSchema.meteredFeatureId",
 			"licenses.customize.addItems.featureOverride.creditSchema.multipliers.*.match",
 			"licenses.customize.addItems.featureOverride.creditSchema.tierBehavior",
@@ -212,6 +216,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"variants.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers",
 			"variants.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.creditCost",
 			"variants.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.to",
+			"variants.customize.addItems.featureOverride.creditSchema.excluded",
 			"variants.customize.addItems.featureOverride.creditSchema.meteredFeatureId",
 			"variants.customize.addItems.featureOverride.creditSchema.multipliers.*.match",
 			"variants.customize.addItems.featureOverride.creditSchema.tierBehavior",
@@ -253,6 +258,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"variants.customize.items.featureOverride.creditSchema.dimensions.*.tiers",
 			"variants.customize.items.featureOverride.creditSchema.dimensions.*.tiers.creditCost",
 			"variants.customize.items.featureOverride.creditSchema.dimensions.*.tiers.to",
+			"variants.customize.items.featureOverride.creditSchema.excluded",
 			"variants.customize.items.featureOverride.creditSchema.meteredFeatureId",
 			"variants.customize.items.featureOverride.creditSchema.multipliers.*.match",
 			"variants.customize.items.featureOverride.creditSchema.tierBehavior",
@@ -284,6 +290,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tierBehavior",
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers",
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.creditCost",
+			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.excluded",
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.meteredFeatureId",
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.multipliers.*.match",
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.tierBehavior",
@@ -386,6 +393,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"items.featureOverride.creditSchema.dimensions.*.tiers",
 			"items.featureOverride.creditSchema.dimensions.*.tiers.creditCost",
 			"items.featureOverride.creditSchema.dimensions.*.tiers.to",
+			"items.featureOverride.creditSchema.excluded",
 			"items.featureOverride.creditSchema.meteredFeatureId",
 			"items.featureOverride.creditSchema.multipliers",
 			"items.featureOverride.creditSchema.multipliers.*.add",
@@ -462,6 +470,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"licenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers",
 			"licenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.creditCost",
 			"licenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.to",
+			"licenses.customize.addItems.featureOverride.creditSchema.excluded",
 			"licenses.customize.addItems.featureOverride.creditSchema.meteredFeatureId",
 			"licenses.customize.addItems.featureOverride.creditSchema.multipliers",
 			"licenses.customize.addItems.featureOverride.creditSchema.multipliers.*.add",
@@ -577,6 +586,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"variants.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers",
 			"variants.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.creditCost",
 			"variants.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.to",
+			"variants.customize.addItems.featureOverride.creditSchema.excluded",
 			"variants.customize.addItems.featureOverride.creditSchema.meteredFeatureId",
 			"variants.customize.addItems.featureOverride.creditSchema.multipliers",
 			"variants.customize.addItems.featureOverride.creditSchema.multipliers.*.add",
@@ -691,6 +701,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"variants.customize.items.featureOverride.creditSchema.dimensions.*.tiers",
 			"variants.customize.items.featureOverride.creditSchema.dimensions.*.tiers.creditCost",
 			"variants.customize.items.featureOverride.creditSchema.dimensions.*.tiers.to",
+			"variants.customize.items.featureOverride.creditSchema.excluded",
 			"variants.customize.items.featureOverride.creditSchema.meteredFeatureId",
 			"variants.customize.items.featureOverride.creditSchema.multipliers",
 			"variants.customize.items.featureOverride.creditSchema.multipliers.*.add",
@@ -779,6 +790,7 @@ export const COLLECTIONS: Readonly<Record<string, CollectionSpec>> = {
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers",
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.creditCost",
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.dimensions.*.tiers.to",
+			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.excluded",
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.meteredFeatureId",
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.multipliers",
 			"variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.multipliers.*.add",

package/src/generated/features.ts

@@ -8,6 +8,8 @@ export type Feature = {
 	type: "boolean" | "metered" | "credit_system" | "ai_credit_system";
 	/** 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. */
 	consumable?: boolean;
+	/** 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. */
+	combine?: "sum" | "max" | "min";
 	/** 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. */
 	creditSchema?: Array<
 		| {

package/src/generated/licenses.ts

@@ -137,7 +137,7 @@ export type License = {
 			};
 			/** Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema). */
 			featureOverride?: {
-				/** For credit system features: replaces the feature's credit_schema entirely for customers on this plan. */
+				/** 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. */
 				creditSchema?: Array<
 					| {
 							/** ID of the metered feature that draws from this credit system. */
@@ -234,6 +234,12 @@ export type License = {
 							/** Credits consumed per billing-unit group. */
 							creditCost: number;
 					  }
+					| {
+							/** ID of the metered feature to remove from the credit system. */
+							meteredFeatureId: string;
+							/** Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate. */
+							excluded: true;
+					  }
 				>;
 				/** 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. */
 				markups?: {

package/src/generated/lintRules.ts

@@ -12,6 +12,9 @@ export const LINT_RULES: LintRules = {
 			type: {
 				enum: ["boolean", "metered", "credit_system", "ai_credit_system"],
 			},
+			combine: {
+				enum: ["sum", "max", "min"],
+			},
 			defaultMarkup: {
 				minimum: -100,
 			},
@@ -426,28 +429,22 @@ export const LINT_RULES: LintRules = {
 	},
 	"plans.items.featureOverride.creditSchema": {
 		variants: {
-			on: "tierBehavior",
+			on: "excluded",
 			byValue: {
-				graduated: {
-					required: ["meteredFeatureId", "tierBehavior", "tiers"],
+				true: {
+					required: ["excluded", "meteredFeatureId"],
 					fields: {
 						meteredFeatureId: {
 							minLength: 1,
 						},
-						billingUnits: {
-							exclusiveMinimum: 0,
-						},
-						tierBehavior: {
-							enum: ["graduated"],
-						},
-						tiers: {
-							minItems: 1,
+						excluded: {
+							enum: [true],
 						},
 					},
 				},
 			},
 			fallback: {
-				required: ["creditCost", "meteredFeatureId"],
+				required: ["meteredFeatureId"],
 				fields: {
 					meteredFeatureId: {
 						minLength: 1,
@@ -455,9 +452,6 @@ export const LINT_RULES: LintRules = {
 					billingUnits: {
 						exclusiveMinimum: 0,
 					},
-					creditCost: {
-						minimum: 0,
-					},
 				},
 			},
 		},
@@ -699,28 +693,22 @@ export const LINT_RULES: LintRules = {
 	},
 	"plans.licenses.customize.addItems.featureOverride.creditSchema": {
 		variants: {
-			on: "tierBehavior",
+			on: "excluded",
 			byValue: {
-				graduated: {
-					required: ["meteredFeatureId", "tierBehavior", "tiers"],
+				true: {
+					required: ["excluded", "meteredFeatureId"],
 					fields: {
 						meteredFeatureId: {
 							minLength: 1,
 						},
-						billingUnits: {
-							exclusiveMinimum: 0,
-						},
-						tierBehavior: {
-							enum: ["graduated"],
-						},
-						tiers: {
-							minItems: 1,
+						excluded: {
+							enum: [true],
 						},
 					},
 				},
 			},
 			fallback: {
-				required: ["creditCost", "meteredFeatureId"],
+				required: ["meteredFeatureId"],
 				fields: {
 					meteredFeatureId: {
 						minLength: 1,
@@ -728,9 +716,6 @@ export const LINT_RULES: LintRules = {
 					billingUnits: {
 						exclusiveMinimum: 0,
 					},
-					creditCost: {
-						minimum: 0,
-					},
 				},
 			},
 		},
@@ -1049,28 +1034,22 @@ export const LINT_RULES: LintRules = {
 	},
 	"plans.variants.customize.addItems.featureOverride.creditSchema": {
 		variants: {
-			on: "tierBehavior",
+			on: "excluded",
 			byValue: {
-				graduated: {
-					required: ["meteredFeatureId", "tierBehavior", "tiers"],
+				true: {
+					required: ["excluded", "meteredFeatureId"],
 					fields: {
 						meteredFeatureId: {
 							minLength: 1,
 						},
-						billingUnits: {
-							exclusiveMinimum: 0,
-						},
-						tierBehavior: {
-							enum: ["graduated"],
-						},
-						tiers: {
-							minItems: 1,
+						excluded: {
+							enum: [true],
 						},
 					},
 				},
 			},
 			fallback: {
-				required: ["creditCost", "meteredFeatureId"],
+				required: ["meteredFeatureId"],
 				fields: {
 					meteredFeatureId: {
 						minLength: 1,
@@ -1078,9 +1057,6 @@ export const LINT_RULES: LintRules = {
 					billingUnits: {
 						exclusiveMinimum: 0,
 					},
-					creditCost: {
-						minimum: 0,
-					},
 				},
 			},
 		},
@@ -1407,28 +1383,22 @@ export const LINT_RULES: LintRules = {
 	},
 	"plans.variants.customize.items.featureOverride.creditSchema": {
 		variants: {
-			on: "tierBehavior",
+			on: "excluded",
 			byValue: {
-				graduated: {
-					required: ["meteredFeatureId", "tierBehavior", "tiers"],
+				true: {
+					required: ["excluded", "meteredFeatureId"],
 					fields: {
 						meteredFeatureId: {
 							minLength: 1,
 						},
-						billingUnits: {
-							exclusiveMinimum: 0,
-						},
-						tierBehavior: {
-							enum: ["graduated"],
-						},
-						tiers: {
-							minItems: 1,
+						excluded: {
+							enum: [true],
 						},
 					},
 				},
 			},
 			fallback: {
-				required: ["creditCost", "meteredFeatureId"],
+				required: ["meteredFeatureId"],
 				fields: {
 					meteredFeatureId: {
 						minLength: 1,
@@ -1436,9 +1406,6 @@ export const LINT_RULES: LintRules = {
 					billingUnits: {
 						exclusiveMinimum: 0,
 					},
-					creditCost: {
-						minimum: 0,
-					},
 				},
 			},
 		},
@@ -1705,28 +1672,22 @@ export const LINT_RULES: LintRules = {
 	"plans.variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema":
 		{
 			variants: {
-				on: "tierBehavior",
+				on: "excluded",
 				byValue: {
-					graduated: {
-						required: ["meteredFeatureId", "tierBehavior", "tiers"],
+					true: {
+						required: ["excluded", "meteredFeatureId"],
 						fields: {
 							meteredFeatureId: {
 								minLength: 1,
 							},
-							billingUnits: {
-								exclusiveMinimum: 0,
-							},
-							tierBehavior: {
-								enum: ["graduated"],
-							},
-							tiers: {
-								minItems: 1,
+							excluded: {
+								enum: [true],
 							},
 						},
 					},
 				},
 				fallback: {
-					required: ["creditCost", "meteredFeatureId"],
+					required: ["meteredFeatureId"],
 					fields: {
 						meteredFeatureId: {
 							minLength: 1,
@@ -1734,9 +1695,6 @@ export const LINT_RULES: LintRules = {
 						billingUnits: {
 							exclusiveMinimum: 0,
 						},
-						creditCost: {
-							minimum: 0,
-						},
 					},
 				},
 			},

package/src/generated/plans.ts

@@ -182,7 +182,7 @@ export type Plan = {
 		};
 		/** Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema). */
 		featureOverride?: {
-			/** For credit system features: replaces the feature's credit_schema entirely for customers on this plan. */
+			/** 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. */
 			creditSchema?: Array<
 				| {
 						/** ID of the metered feature that draws from this credit system. */
@@ -279,6 +279,12 @@ export type Plan = {
 						/** Credits consumed per billing-unit group. */
 						creditCost: number;
 				  }
+				| {
+						/** ID of the metered feature to remove from the credit system. */
+						meteredFeatureId: string;
+						/** Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate. */
+						excluded: true;
+				  }
 			>;
 			/** 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. */
 			markups?: {
@@ -587,7 +593,7 @@ export type Plan = {
 				};
 				/** Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema). */
 				featureOverride?: {
-					/** For credit system features: replaces the feature's credit_schema entirely for customers on this plan. */
+					/** 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. */
 					creditSchema?: Array<
 						| {
 								/** ID of the metered feature that draws from this credit system. */
@@ -684,6 +690,12 @@ export type Plan = {
 								/** Credits consumed per billing-unit group. */
 								creditCost: number;
 						  }
+						| {
+								/** ID of the metered feature to remove from the credit system. */
+								meteredFeatureId: string;
+								/** Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate. */
+								excluded: true;
+						  }
 					>;
 					/** 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. */
 					markups?: {
@@ -819,7 +831,7 @@ export type Plan = {
 				};
 				/** Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema). */
 				featureOverride?: {
-					/** For credit system features: replaces the feature's credit_schema entirely for customers on this plan. */
+					/** 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. */
 					creditSchema?: Array<
 						| {
 								/** ID of the metered feature that draws from this credit system. */
@@ -916,6 +928,12 @@ export type Plan = {
 								/** Credits consumed per billing-unit group. */
 								creditCost: number;
 						  }
+						| {
+								/** ID of the metered feature to remove from the credit system. */
+								meteredFeatureId: string;
+								/** Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate. */
+								excluded: true;
+						  }
 					>;
 					/** 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. */
 					markups?: {
@@ -1204,7 +1222,7 @@ export type Plan = {
 						};
 						/** Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema). */
 						featureOverride?: {
-							/** For credit system features: replaces the feature's credit_schema entirely for customers on this plan. */
+							/** 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. */
 							creditSchema?: Array<
 								| {
 										/** ID of the metered feature that draws from this credit system. */
@@ -1301,6 +1319,12 @@ export type Plan = {
 										/** Credits consumed per billing-unit group. */
 										creditCost: number;
 								  }
+								| {
+										/** ID of the metered feature to remove from the credit system. */
+										meteredFeatureId: string;
+										/** Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate. */
+										excluded: true;
+								  }
 							>;
 							/** 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. */
 							markups?: {
@@ -1499,7 +1523,7 @@ export type Plan = {
 				};
 				/** Overrides fields of this item's feature for customers on this plan (e.g. a credit system's credit_schema). */
 				featureOverride?: {
-					/** For credit system features: replaces the feature's credit_schema entirely for customers on this plan. */
+					/** 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. */
 					creditSchema?: Array<
 						| {
 								/** ID of the metered feature that draws from this credit system. */
@@ -1596,6 +1620,12 @@ export type Plan = {
 								/** Credits consumed per billing-unit group. */
 								creditCost: number;
 						  }
+						| {
+								/** ID of the metered feature to remove from the credit system. */
+								meteredFeatureId: string;
+								/** Removes this feature from the credit system for customers on this plan. Cannot be combined with a rate. */
+								excluded: true;
+						  }
 					>;
 					/** 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. */
 					markups?: {