atmn 1.1.23 → 1.1.24

package/dist/cli.js

@@ -65988,85 +65988,8 @@ var init_expandParam = __esm(() => {
   });
 });
 
-// ../../shared/models/cusModels/billingControls/overageAllowed.ts
-var DbOverageAllowedSchema;
-var init_overageAllowed = __esm(() => {
-  init_v4();
-  DbOverageAllowedSchema = exports_external.object({
-    feature_id: exports_external.string().meta({
-      description: "The feature ID this overage allowed control applies to."
-    }),
-    enabled: exports_external.boolean().default(false).meta({
-      description: "Whether overage is allowed for this feature."
-    })
-  });
-});
-
-// ../../shared/models/cusModels/billingControls/spendLimit.ts
-var SpendLimitType, DbSpendLimitSchema;
-var init_spendLimit = __esm(() => {
-  init_v4();
-  SpendLimitType = exports_external.enum(["absolute", "usage_percentage"]);
-  DbSpendLimitSchema = exports_external.object({
-    feature_id: exports_external.string().optional().meta({
-      description: "Optional feature ID this spend limit applies to."
-    }),
-    enabled: exports_external.boolean().default(false).meta({
-      description: "Whether the overage spend limit is enabled."
-    }),
-    limit_type: SpendLimitType.optional().meta({
-      description: "How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance."
-    }),
-    overage_limit: exports_external.number().min(0).optional().meta({
-      description: "Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage."
-    }),
-    skip_overage_billing: exports_external.boolean().optional().meta({
-      description: "When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally."
-    })
-  }).refine((data) => data.overage_limit === undefined && data.skip_overage_billing === undefined || data.feature_id !== undefined, {
-    message: "feature_id is required when overage_limit or skip_overage_billing is provided",
-    path: ["feature_id"]
-  });
-});
-
-// ../../shared/models/cusModels/billingControls/usageAlert.ts
-var UsageAlertThresholdType, DbUsageAlertSchema;
-var init_usageAlert = __esm(() => {
-  init_v4();
-  UsageAlertThresholdType = exports_external.enum([
-    "usage",
-    "usage_percentage",
-    "remaining",
-    "remaining_percentage"
-  ]);
-  DbUsageAlertSchema = exports_external.object({
-    feature_id: exports_external.string().optional().meta({
-      description: "The feature ID this alert applies to."
-    }),
-    enabled: exports_external.boolean().default(true).meta({
-      description: "Whether this usage alert is enabled."
-    }),
-    threshold: exports_external.number().min(0).meta({
-      description: "The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100)."
-    }),
-    threshold_type: UsageAlertThresholdType.meta({
-      description: "Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance."
-    }),
-    name: exports_external.string().optional().meta({
-      description: "Optional user-defined label to distinguish multiple alerts on the same feature."
-    })
-  }).check((ctx) => {
-    const { threshold_type, threshold } = ctx.value;
-    if (threshold_type === "remaining_percentage" && threshold > 100) {
-      ctx.issues.push({
-        code: "custom",
-        input: threshold,
-        path: ["threshold"],
-        message: "Threshold must be between 0 and 100 for remaining_percentage"
-      });
-    }
-  });
-});
+// ../../shared/models/cusModels/billingControls/identity/featureIdIdentity.ts
+var featureIdIdentity = (control) => control.feature_id || undefined;
 
 // ../../shared/models/productModels/intervals/resetInterval.ts
 var ResetInterval;
@@ -66148,6 +66071,214 @@ var init_usageLimit = __esm(() => {
   };
 });
 
+// ../../shared/models/cusModels/billingControls/usageAlert.ts
+var UsageAlertThresholdType, BALANCE_BASES, USAGE_ALERT_BASES, DEFAULT_USAGE_ALERT_BASIS = "balance", UsageAlertBasisSchema, DbUsageAlertSchema;
+var init_usageAlert = __esm(() => {
+  init_v4();
+  init_usageLimit();
+  UsageAlertThresholdType = exports_external.enum([
+    "usage",
+    "usage_percentage",
+    "remaining",
+    "remaining_percentage"
+  ]);
+  BALANCE_BASES = ["balance", "included", "recurring"];
+  USAGE_ALERT_BASES = [...BALANCE_BASES, "usage_limit"];
+  UsageAlertBasisSchema = exports_external.enum(USAGE_ALERT_BASES);
+  DbUsageAlertSchema = exports_external.object({
+    feature_id: exports_external.string().optional().meta({
+      description: "The feature ID this alert applies to."
+    }),
+    enabled: exports_external.boolean().default(true).meta({
+      description: "Whether this usage alert is enabled."
+    }),
+    threshold: exports_external.number().min(0).meta({
+      description: "The threshold value that triggers the alert. For usage or remaining, this is an absolute count. For usage_percentage or remaining_percentage, this is a percentage (0-100)."
+    }),
+    threshold_type: UsageAlertThresholdType.meta({
+      description: "Whether the threshold is an absolute count or a percentage of the usage allowance or remaining balance."
+    }),
+    basis: UsageAlertBasisSchema.default(DEFAULT_USAGE_ALERT_BASIS).meta({
+      description: "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."
+    }),
+    filter: UsageLimitFilterSchema.optional().meta({
+      description: "Only valid with basis usage_limit. Points the alert at the usage limit carrying the same filter."
+    }),
+    name: exports_external.string().optional().meta({
+      description: "Optional user-defined label to distinguish multiple alerts on the same feature."
+    })
+  }).check((ctx) => {
+    const { feature_id, threshold_type, threshold, basis, filter: filter2 } = ctx.value;
+    if (threshold_type === "remaining_percentage" && threshold > 100) {
+      ctx.issues.push({
+        code: "custom",
+        input: threshold,
+        path: ["threshold"],
+        message: "Threshold must be between 0 and 100 for remaining_percentage"
+      });
+    }
+    if (basis === "usage_limit" && !feature_id) {
+      ctx.issues.push({
+        code: "custom",
+        input: feature_id,
+        path: ["feature_id"],
+        message: "feature_id is required when basis is usage_limit"
+      });
+    }
+    if (filter2 && basis !== "usage_limit") {
+      ctx.issues.push({
+        code: "custom",
+        input: filter2,
+        path: ["filter"],
+        message: "filter is only valid when basis is usage_limit"
+      });
+    }
+  });
+});
+
+// ../../shared/models/cusModels/billingControls/identity/usageAlertIdentity.ts
+var usageAlertIdentity = (alert) => [
+  alert.feature_id ?? "",
+  alert.basis ?? DEFAULT_USAGE_ALERT_BASIS,
+  usageLimitFilterKey(alert.filter),
+  alert.threshold_type,
+  alert.threshold
+].join("|");
+var init_usageAlertIdentity = __esm(() => {
+  init_usageAlert();
+  init_usageLimit();
+});
+
+// ../../shared/models/cusModels/billingControls/identity/usageLimitIdentity.ts
+var usageLimitIdentity = (usageLimit) => `${usageLimit.feature_id}|${usageLimitFilterKey(usageLimit.filter)}`;
+var init_usageLimitIdentity = __esm(() => {
+  init_usageLimit();
+});
+
+// ../../shared/models/cusModels/billingControls/duplicates/findDuplicateInControls.ts
+var findDuplicateInControls = ({
+  controlKey,
+  controls,
+  rule
+}) => {
+  const seen = new Set;
+  for (const [index3, control] of controls.entries()) {
+    const identity2 = rule.identityOf(control);
+    if (identity2 === undefined)
+      continue;
+    if (seen.has(identity2)) {
+      return {
+        code: "custom",
+        message: rule.message,
+        input: control[rule.field],
+        path: [controlKey, index3, rule.field]
+      };
+    }
+    seen.add(identity2);
+  }
+  return;
+};
+
+// ../../shared/models/cusModels/billingControls/duplicates/duplicateChecks.ts
+var duplicateCheck = ({
+  controlKey,
+  ...rule
+}) => (billingControls) => findDuplicateInControls({
+  controlKey,
+  controls: billingControls[controlKey] ?? [],
+  rule
+}), DUPLICATE_CHECKS;
+var init_duplicateChecks = __esm(() => {
+  init_usageAlertIdentity();
+  init_usageLimitIdentity();
+  DUPLICATE_CHECKS = [
+    duplicateCheck({
+      controlKey: "auto_topups",
+      identityOf: featureIdIdentity,
+      field: "feature_id",
+      message: "Only one auto top-up entry is allowed per feature_id"
+    }),
+    duplicateCheck({
+      controlKey: "spend_limits",
+      identityOf: featureIdIdentity,
+      field: "feature_id",
+      message: "Only one spend limit entry is allowed per feature_id"
+    }),
+    duplicateCheck({
+      controlKey: "usage_limits",
+      identityOf: usageLimitIdentity,
+      field: "feature_id",
+      message: "Only one usage limit entry is allowed per feature_id and filter"
+    }),
+    duplicateCheck({
+      controlKey: "usage_alerts",
+      identityOf: usageAlertIdentity,
+      field: "threshold",
+      message: "Only one usage alert entry is allowed per feature_id, basis, filter, threshold_type and threshold"
+    }),
+    duplicateCheck({
+      controlKey: "overage_allowed",
+      identityOf: featureIdIdentity,
+      field: "feature_id",
+      message: "Only one overage_allowed entry is allowed per feature_id"
+    })
+  ];
+});
+
+// ../../shared/models/cusModels/billingControls/duplicates/findDuplicateBillingControlIssue.ts
+var findDuplicateBillingControlIssue = (billingControls) => {
+  for (const check4 of DUPLICATE_CHECKS) {
+    const issue2 = check4(billingControls);
+    if (issue2)
+      return issue2;
+  }
+  return;
+};
+var init_findDuplicateBillingControlIssue = __esm(() => {
+  init_duplicateChecks();
+});
+
+// ../../shared/models/cusModels/billingControls/overageAllowed.ts
+var DbOverageAllowedSchema;
+var init_overageAllowed = __esm(() => {
+  init_v4();
+  DbOverageAllowedSchema = exports_external.object({
+    feature_id: exports_external.string().meta({
+      description: "The feature ID this overage allowed control applies to."
+    }),
+    enabled: exports_external.boolean().default(false).meta({
+      description: "Whether overage is allowed for this feature."
+    })
+  });
+});
+
+// ../../shared/models/cusModels/billingControls/spendLimit.ts
+var SpendLimitType, DbSpendLimitSchema;
+var init_spendLimit = __esm(() => {
+  init_v4();
+  SpendLimitType = exports_external.enum(["absolute", "usage_percentage"]);
+  DbSpendLimitSchema = exports_external.object({
+    feature_id: exports_external.string().optional().meta({
+      description: "Optional feature ID this spend limit applies to."
+    }),
+    enabled: exports_external.boolean().default(false).meta({
+      description: "Whether the overage spend limit is enabled."
+    }),
+    limit_type: SpendLimitType.optional().meta({
+      description: "How overage_limit is interpreted: an absolute overage cap (default) or a percentage of the main-plan allowance."
+    }),
+    overage_limit: exports_external.number().min(0).optional().meta({
+      description: "Overage cap for the feature: absolute units, or a percent (e.g. 120) when limit_type is usage_percentage."
+    }),
+    skip_overage_billing: exports_external.boolean().optional().meta({
+      description: "When true, overage for this feature is not posted to Stripe. Usage tracking and balance resets still behave normally."
+    })
+  }).refine((data) => data.overage_limit === undefined && data.skip_overage_billing === undefined || data.feature_id !== undefined, {
+    message: "feature_id is required when overage_limit or skip_overage_billing is provided",
+    path: ["feature_id"]
+  });
+});
+
 // ../../shared/models/cusModels/billingControls/entityBillingControls.ts
 var EntityBillingControlsSchema;
 var init_entityBillingControls = __esm(() => {
@@ -66185,6 +66316,18 @@ var init_purchaseLimitInterval = __esm(() => {
   PurchaseLimitIntervalEnum = exports_external.enum(PurchaseLimitInterval);
 });
 
+// ../../shared/models/cusModels/billingControls/classify/isUsageLimitBasisAlert.ts
+var isUsageLimitBasisAlert = (alert) => alert.basis === "usage_limit";
+
+// ../../shared/models/cusModels/billingControls/identity/usageAlertTargetLimitIdentity.ts
+var usageAlertTargetLimitIdentity = (alert) => usageLimitIdentity({
+  feature_id: alert.feature_id ?? "",
+  filter: alert.filter
+});
+var init_usageAlertTargetLimitIdentity = __esm(() => {
+  init_usageLimitIdentity();
+});
+
 // ../../shared/models/cusModels/billingControls/customerBillingControls.ts
 var BILLING_CONTROL_KEYS, AutoTopupPurchaseLimitSchema, AutoTopupPurchaseLimitParamsSchema, AutoTopupSchema, AutoTopupParamsSchema, ExpandedPurchaseLimitSchema, AutoTopupResponseSchema, CustomerBillingControlsSchema, DbBillingControlsSchema, normalizeBillingControlsForCompare = (billingControls) => {
   if (!billingControls)
@@ -66205,12 +66348,17 @@ var BILLING_CONTROL_KEYS, AutoTopupPurchaseLimitSchema, AutoTopupPurchaseLimitPa
 }, CustomerBillingControlsParamsSchema;
 var init_customerBillingControls = __esm(() => {
   init_v4();
+  init_findDuplicateBillingControlIssue();
   init_entityBillingControls();
   init_overageAllowed();
   init_purchaseLimitInterval();
   init_spendLimit();
   init_usageAlert();
   init_usageLimit();
+  init_usageAlertIdentity();
+  init_usageAlertTargetLimitIdentity();
+  init_usageLimitIdentity();
+  init_usageAlert();
   init_usageLimit();
   BILLING_CONTROL_KEYS = [
     "auto_topups",
@@ -66311,63 +66459,9 @@ var init_customerBillingControls = __esm(() => {
       description: "List of auto top-up configurations per feature."
     })
   }).check((ctx) => {
-    const billingControls = ctx.value;
-    const autoTopupFeatureIds = new Set;
-    for (const [index3, autoTopup] of (billingControls.auto_topups ?? []).entries()) {
-      if (autoTopupFeatureIds.has(autoTopup.feature_id)) {
-        ctx.issues.push({
-          code: "custom",
-          message: "Only one auto top-up entry is allowed per feature_id",
-          input: autoTopup.feature_id,
-          path: ["auto_topups", index3, "feature_id"]
-        });
-        return;
-      }
-      autoTopupFeatureIds.add(autoTopup.feature_id);
-    }
-    const spendLimitFeatureIds = new Set;
-    for (const [index3, spendLimit] of (billingControls.spend_limits ?? []).entries()) {
-      if (!spendLimit.feature_id) {
-        continue;
-      }
-      if (spendLimitFeatureIds.has(spendLimit.feature_id)) {
-        ctx.issues.push({
-          code: "custom",
-          message: "Only one spend limit entry is allowed per feature_id",
-          input: spendLimit.feature_id,
-          path: ["spend_limits", index3, "feature_id"]
-        });
-        return;
-      }
-      spendLimitFeatureIds.add(spendLimit.feature_id);
-    }
-    const usageLimitIdentities = new Set;
-    for (const [index3, usageLimit] of (billingControls.usage_limits ?? []).entries()) {
-      const identity2 = `${usageLimit.feature_id}|${usageLimitFilterKey(usageLimit.filter)}`;
-      if (usageLimitIdentities.has(identity2)) {
-        ctx.issues.push({
-          code: "custom",
-          message: "Only one usage limit entry is allowed per feature_id and filter",
-          input: usageLimit.feature_id,
-          path: ["usage_limits", index3, "feature_id"]
-        });
-        return;
-      }
-      usageLimitIdentities.add(identity2);
-    }
-    const overageAllowedFeatureIds = new Set;
-    for (const [index3, overageAllowed] of (billingControls.overage_allowed ?? []).entries()) {
-      if (overageAllowedFeatureIds.has(overageAllowed.feature_id)) {
-        ctx.issues.push({
-          code: "custom",
-          message: "Only one overage_allowed entry is allowed per feature_id",
-          input: overageAllowed.feature_id,
-          path: ["overage_allowed", index3, "feature_id"]
-        });
-        return;
-      }
-      overageAllowedFeatureIds.add(overageAllowed.feature_id);
-    }
+    const issue2 = findDuplicateBillingControlIssue(ctx.value);
+    if (issue2)
+      ctx.issues.push(issue2);
   });
 });
 
@@ -69057,24 +69151,185 @@ var init_basePrice = __esm(() => {
   });
 });
 
+// ../../shared/models/featureModels/featureEnums.ts
+var FeatureType, FeatureUsageType;
+var init_featureEnums = __esm(() => {
+  ((FeatureType2) => {
+    FeatureType2["Boolean"] = "boolean";
+    FeatureType2["Metered"] = "metered";
+    FeatureType2["CreditSystem"] = "credit_system";
+    FeatureType2["AiCreditSystem"] = "ai_credit_system";
+  })(FeatureType ||= {});
+  ((FeatureUsageType2) => {
+    FeatureUsageType2["Single"] = "single_use";
+    FeatureUsageType2["Continuous"] = "continuous_use";
+  })(FeatureUsageType ||= {});
+});
+
+// ../../shared/models/featureModels/featureConfig/creditConfig.ts
+var CreditTierSchema, flatCreditRateShape, graduatedCreditRateShape, CreditMatchSchema, CreditDimensionBaseSchema, CreditDimensionSchema, CreditMultiplierSchema, USAGE_ATTRIBUTION_DIMENSION_SEPARATOR = "::", CREDIT_DIMENSION_NAME_MAX_LENGTH = 64, CreditDimensionNameSchema, CreditSchemaItemBaseSchema, FlatCreditSchemaItemSchema, GraduatedCreditSchemaItemSchema, CreditSchemaItemSchema, MarkupEntrySchema, ProviderMarkupsSchema, CreditSystemConfigSchema, FeatureConfigOverrideSchema, ModelMarkupsSchema;
+var init_creditConfig = __esm(() => {
+  init_v4();
+  init_featureEnums();
+  CreditTierSchema = exports_external.object({
+    to: exports_external.union([exports_external.number(), exports_external.literal("inf")]),
+    credit_amount: exports_external.number()
+  });
+  flatCreditRateShape = {
+    credit_amount: exports_external.number(),
+    tier_behavior: exports_external.never().optional(),
+    tiers: exports_external.never().optional()
+  };
+  graduatedCreditRateShape = {
+    credit_amount: exports_external.never().optional(),
+    tier_behavior: exports_external.literal("graduated"),
+    tiers: exports_external.array(CreditTierSchema)
+  };
+  CreditMatchSchema = exports_external.record(exports_external.string(), exports_external.union([exports_external.string(), exports_external.number(), exports_external.boolean()]).transform(String));
+  CreditDimensionBaseSchema = exports_external.object({
+    match: CreditMatchSchema,
+    priority: exports_external.number().int().optional()
+  });
+  CreditDimensionSchema = exports_external.union([
+    CreditDimensionBaseSchema.extend(flatCreditRateShape),
+    CreditDimensionBaseSchema.extend(graduatedCreditRateShape)
+  ]);
+  CreditMultiplierSchema = exports_external.object({
+    match: CreditMatchSchema,
+    factor: exports_external.number().positive().optional(),
+    add: exports_external.number().optional()
+  }).refine((multiplier) => multiplier.factor !== undefined || multiplier.add !== undefined, {
+    message: "A multiplier needs a factor or an add"
+  });
+  CreditDimensionNameSchema = exports_external.string().min(1).max(CREDIT_DIMENSION_NAME_MAX_LENGTH).refine((name) => !name.includes(USAGE_ATTRIBUTION_DIMENSION_SEPARATOR), {
+    message: `Dimension names cannot contain "${USAGE_ATTRIBUTION_DIMENSION_SEPARATOR}"`
+  });
+  CreditSchemaItemBaseSchema = exports_external.object({
+    metered_feature_id: exports_external.string(),
+    feature_amount: exports_external.number().optional(),
+    dimensions: exports_external.record(CreditDimensionNameSchema, CreditDimensionSchema).optional(),
+    multipliers: exports_external.record(CreditDimensionNameSchema, CreditMultiplierSchema).optional()
+  });
+  FlatCreditSchemaItemSchema = CreditSchemaItemBaseSchema.extend(flatCreditRateShape);
+  GraduatedCreditSchemaItemSchema = CreditSchemaItemBaseSchema.extend(graduatedCreditRateShape);
+  CreditSchemaItemSchema = exports_external.union([
+    FlatCreditSchemaItemSchema,
+    GraduatedCreditSchemaItemSchema
+  ]);
+  MarkupEntrySchema = exports_external.object({
+    markup: exports_external.number().min(-100)
+  });
+  ProviderMarkupsSchema = exports_external.record(exports_external.string(), MarkupEntrySchema).nullish();
+  CreditSystemConfigSchema = exports_external.object({
+    schema: exports_external.array(CreditSchemaItemSchema),
+    invoice_credit: exports_external.boolean().optional(),
+    usage_type: exports_external.nativeEnum(FeatureUsageType),
+    default_markup: exports_external.number().min(-100).optional(),
+    provider_markups: ProviderMarkupsSchema
+  });
+  FeatureConfigOverrideSchema = exports_external.strictObject({
+    schema: exports_external.array(CreditSchemaItemSchema).optional()
+  });
+  ModelMarkupsSchema = exports_external.record(exports_external.string(), MarkupEntrySchema.extend({
+    markup: exports_external.number().min(-100).optional(),
+    input_cost: exports_external.number().min(0).optional(),
+    output_cost: exports_external.number().min(0).optional()
+  })).nullish();
+});
+
+// ../../shared/utils/featureUtils/creditDimensions/creditTierRules.ts
+var VIOLATION_MESSAGES, findCreditTierViolations = (boundaries) => {
+  const violations = [];
+  const violate = (index3, reason) => violations.push({ index: index3, reason, message: VIOLATION_MESSAGES[reason] });
+  let previousBoundary = 0;
+  for (const [index3, boundary] of boundaries.entries()) {
+    const isLastTier = index3 === boundaries.length - 1;
+    if (boundary === "inf") {
+      if (!isLastTier)
+        violate(index3, "non_final_infinity");
+      continue;
+    }
+    if (!Number.isFinite(boundary) || boundary <= previousBoundary) {
+      violate(index3, "not_increasing");
+    }
+    previousBoundary = boundary;
+    if (isLastTier)
+      violate(index3, "final_not_infinity");
+  }
+  return violations;
+};
+var init_creditTierRules = __esm(() => {
+  VIOLATION_MESSAGES = {
+    non_final_infinity: "Only the final tier may use an 'inf' boundary.",
+    not_increasing: "Tier boundaries must be strictly increasing.",
+    final_not_infinity: "The final tier must use an 'inf' boundary."
+  };
+});
+
 // ../../shared/api/features/creditRateCard.ts
-var ApiCreditSchemaItemBaseSchema, ApiCreditTierSchema, ApiFlatCreditSchemaItemSchema, ApiGraduatedCreditSchemaItemSchema, ApiCreditSchemaItemSchema, ApiLegacyFlatCreditSchemaItemSchema, ApiCreditSchemaResponseItemSchema, isGraduatedCreditSchemaItem = (item) => ("tier_behavior" in item) && item.tier_behavior === "graduated";
+var ApiCreditTierSchema, refineGraduatedTiers = (item, ctx) => {
+  const violations = findCreditTierViolations(item.tiers.map((tier) => tier.to));
+  for (const { index: index3, message } of violations) {
+    ctx.addIssue({
+      code: "custom",
+      message,
+      path: ["tiers", index3, "to"]
+    });
+  }
+}, ApiCreditMatchSchema, ApiCreditDimensionBaseSchema, ApiCreditDimensionSchema, ApiCreditMultiplierSchema, ApiCreditSchemaItemBaseSchema, ApiFlatCreditSchemaItemSchema, ApiGraduatedCreditSchemaItemSchema, ApiCreditSchemaItemSchema, ApiLegacyFlatCreditSchemaItemSchema, ApiCreditSchemaResponseItemSchema, isGraduatedCreditSchemaItem = (item) => ("tier_behavior" in item) && item.tier_behavior === "graduated";
 var init_creditRateCard = __esm(() => {
   init_v4();
+  init_creditConfig();
+  init_creditTierRules();
+  ApiCreditTierSchema = exports_external.object({
+    to: exports_external.union([exports_external.number().positive(), exports_external.enum(["inf"])]).meta({
+      description: "Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'."
+    }),
+    credit_cost: exports_external.number().min(0).meta({
+      description: "Credits consumed per billing-unit group within this tier."
+    })
+  });
+  ApiCreditMatchSchema = CreditMatchSchema.meta({
+    description: "Event properties this entry applies to. Every key must equal the tracked property, compared as strings."
+  });
+  ApiCreditDimensionBaseSchema = exports_external.object({
+    match: ApiCreditMatchSchema,
+    priority: exports_external.number().int().optional().meta({
+      description: "Breaks ties between dimensions that match the same number of keys. Higher wins."
+    })
+  });
+  ApiCreditDimensionSchema = exports_external.union([
+    ApiCreditDimensionBaseSchema.extend({
+      tier_behavior: exports_external.literal("graduated"),
+      tiers: exports_external.array(ApiCreditTierSchema).min(1)
+    }).strict().superRefine(refineGraduatedTiers),
+    ApiCreditDimensionBaseSchema.extend({
+      credit_cost: exports_external.number().min(0).meta({
+        description: "Credits consumed per billing-unit group when this dimension matches."
+      })
+    }).strict()
+  ]);
+  ApiCreditMultiplierSchema = exports_external.object({
+    match: ApiCreditMatchSchema,
+    factor: exports_external.number().positive().optional().meta({
+      description: "Multiplies the matched rate. All matching multipliers stack."
+    }),
+    add: exports_external.number().optional().meta({
+      description: "Added to the rate after every factor is applied, in credits per billing-unit group."
+    })
+  }).strict().refine((multiplier) => multiplier.factor !== undefined || multiplier.add !== undefined, { message: "A multiplier needs a factor or an add." });
   ApiCreditSchemaItemBaseSchema = exports_external.object({
     metered_feature_id: exports_external.string().nonempty().meta({
       description: "ID of the metered feature that draws from this credit system."
     }),
     billing_units: exports_external.number().positive().optional().meta({
       description: "Number of metered-feature units priced together. Defaults to one when omitted."
-    })
-  });
-  ApiCreditTierSchema = exports_external.object({
-    to: exports_external.union([exports_external.number().positive(), exports_external.enum(["inf"])]).meta({
-      description: "Inclusive upper usage boundary for this graduated tier. The final tier must be 'inf'."
     }),
-    credit_cost: exports_external.number().min(0).meta({
-      description: "Credits consumed per billing-unit group within this tier."
+    dimensions: exports_external.record(CreditDimensionNameSchema, ApiCreditDimensionSchema).optional().meta({
+      description: "Named rates chosen by event properties. The most specific match sets the rate; with no match the item's own rate applies."
+    }),
+    multipliers: exports_external.record(CreditDimensionNameSchema, ApiCreditMultiplierSchema).optional().meta({
+      description: "Named adjustments chosen by event properties. Every match applies: factors multiply, then adds are summed."
     })
   });
   ApiFlatCreditSchemaItemSchema = ApiCreditSchemaItemBaseSchema.extend({
@@ -69085,37 +69340,7 @@ var init_creditRateCard = __esm(() => {
   ApiGraduatedCreditSchemaItemSchema = ApiCreditSchemaItemBaseSchema.extend({
     tier_behavior: exports_external.literal("graduated"),
     tiers: exports_external.array(ApiCreditTierSchema).min(1)
-  }).strict().superRefine((item, ctx) => {
-    let previousBoundary = 0;
-    for (const [index3, tier] of item.tiers.entries()) {
-      const isLastTier = index3 === item.tiers.length - 1;
-      if (tier.to === "inf") {
-        if (!isLastTier) {
-          ctx.addIssue({
-            code: "custom",
-            message: "Only the final tier may use an 'inf' boundary.",
-            path: ["tiers", index3, "to"]
-          });
-        }
-        continue;
-      }
-      if (tier.to <= previousBoundary) {
-        ctx.addIssue({
-          code: "custom",
-          message: "Tier boundaries must be strictly increasing.",
-          path: ["tiers", index3, "to"]
-        });
-      }
-      previousBoundary = tier.to;
-      if (isLastTier) {
-        ctx.addIssue({
-          code: "custom",
-          message: "The final tier must use an 'inf' boundary.",
-          path: ["tiers", index3, "to"]
-        });
-      }
-    }
-  });
+  }).strict().superRefine(refineGraduatedTiers);
   ApiCreditSchemaItemSchema = exports_external.union([
     ApiGraduatedCreditSchemaItemSchema,
     ApiFlatCreditSchemaItemSchema
@@ -70259,7 +70484,6 @@ var init_apiPlanV1 = __esm(() => {
   });
   ApiPlanExpandedV1Schema = ApiPlanV1Schema.extend({
     licenses: exports_external.array(ApiPlanLicenseV1Schema).optional().meta({
-      internal: true,
       description: "Plans offered as assignable licenses under this plan. Omitted when the plan has none."
     }),
     variants: exports_external.array(ApiPlanVariantV1Schema).optional().meta({
@@ -70542,16 +70766,6 @@ var init_cancelAction = __esm(() => {
   });
 });
 
-// ../../shared/api/billing/common/subscriptionParams.ts
-var SubscriptionParamsSchema;
-var init_subscriptionParams = __esm(() => {
-  init_v4();
-  SubscriptionParamsSchema = exports_external.record(exports_external.string(), exports_external.unknown()).meta({
-    title: "SubscriptionParams",
-    description: "Additional parameters to pass into the Stripe subscription update or cancel call."
-  });
-});
-
 // ../../shared/api/billing/common/customLineItem.ts
 var CustomLineItemSchema;
 var init_customLineItem = __esm(() => {
@@ -70565,6 +70779,16 @@ var init_customLineItem = __esm(() => {
     })
   });
 });
+// ../../shared/api/billing/common/subscriptionParams.ts
+var SubscriptionParamsSchema;
+var init_subscriptionParams = __esm(() => {
+  init_v4();
+  SubscriptionParamsSchema = exports_external.record(exports_external.string(), exports_external.unknown()).meta({
+    title: "SubscriptionParams",
+    description: "Additional parameters to pass into the Stripe subscription update or cancel call."
+  });
+});
+
 // ../../shared/api/billing/common/featureQuantity/featureQuantityParamsV0.ts
 var FeatureQuantityParamsV0Schema;
 var init_featureQuantityParamsV0 = __esm(() => {
@@ -71034,6 +71258,7 @@ var init_customerBillingControls2 = __esm(() => {
 var ApiEntityBillingControlsSchema, ApiEntityBillingControlsParamsBaseSchema, ApiEntityBillingControlsParamsSchema;
 var init_entityBillingControls2 = __esm(() => {
   init_v4();
+  init_findDuplicateBillingControlIssue();
   init_overageAllowed();
   init_spendLimit();
   init_usageAlert();
@@ -71071,48 +71296,42 @@ var init_entityBillingControls2 = __esm(() => {
     })
   });
   ApiEntityBillingControlsParamsSchema = ApiEntityBillingControlsParamsBaseSchema.check((ctx) => {
-    const billingControls = ctx.value;
-    const spendLimitFeatureIds = new Set;
-    for (const [index3, spendLimit] of (billingControls.spend_limits ?? []).entries()) {
-      if (!spendLimit.feature_id) {
-        continue;
-      }
-      if (spendLimitFeatureIds.has(spendLimit.feature_id)) {
-        ctx.issues.push({
-          code: "custom",
-          message: "Only one spend limit entry is allowed per feature_id",
-          input: spendLimit.feature_id,
-          path: ["spend_limits", index3, "feature_id"]
-        });
-        return;
-      }
-      spendLimitFeatureIds.add(spendLimit.feature_id);
-    }
-    const usageLimitFeatureIds = new Set;
-    for (const [index3, usageLimit] of (billingControls.usage_limits ?? []).entries()) {
-      if (usageLimitFeatureIds.has(usageLimit.feature_id)) {
-        ctx.issues.push({
-          code: "custom",
-          message: "Only one usage limit entry is allowed per feature_id",
-          input: usageLimit.feature_id,
-          path: ["usage_limits", index3, "feature_id"]
-        });
-        return;
-      }
-      usageLimitFeatureIds.add(usageLimit.feature_id);
-    }
-    const overageAllowedFeatureIds = new Set;
-    for (const [index3, overageAllowed] of (billingControls.overage_allowed ?? []).entries()) {
-      if (overageAllowedFeatureIds.has(overageAllowed.feature_id)) {
-        ctx.issues.push({
-          code: "custom",
-          message: "Only one overage_allowed entry is allowed per feature_id",
-          input: overageAllowed.feature_id,
-          path: ["overage_allowed", index3, "feature_id"]
-        });
-        return;
-      }
-      overageAllowedFeatureIds.add(overageAllowed.feature_id);
+    const issue2 = findDuplicateBillingControlIssue(ctx.value);
+    if (issue2)
+      ctx.issues.push(issue2);
+  });
+});
+
+// ../../shared/utils/billingControlUtils/filterUnresolvableUsageLimitAlerts.ts
+var filterUnresolvableUsageLimitAlerts = ({
+  usageAlerts,
+  usageLimitLists
+}) => {
+  const limitIdentities = new Set(usageLimitLists.flatMap((list) => (list ?? []).map(usageLimitIdentity)));
+  return usageAlerts.flatMap((usageAlert, index3) => isUsageLimitBasisAlert(usageAlert) && !limitIdentities.has(usageAlertTargetLimitIdentity(usageAlert)) ? [{ index: index3, usageAlert }] : []);
+};
+var init_filterUnresolvableUsageLimitAlerts = __esm(() => {
+  init_usageAlertTargetLimitIdentity();
+  init_usageLimitIdentity();
+});
+
+// ../../shared/api/billingControls/planBillingControls.ts
+var PlanBillingControlsParamsSchema;
+var init_planBillingControls = __esm(() => {
+  init_customerBillingControls();
+  init_filterUnresolvableUsageLimitAlerts();
+  PlanBillingControlsParamsSchema = CustomerBillingControlsParamsSchema.check((ctx) => {
+    const unresolvable = filterUnresolvableUsageLimitAlerts({
+      usageAlerts: ctx.value.usage_alerts ?? [],
+      usageLimitLists: [ctx.value.usage_limits ?? []]
+    });
+    for (const { index: index3, usageAlert } of unresolvable) {
+      ctx.issues.push({
+        code: "custom",
+        message: `No usage limit on this plan matches the usage_limit alert for feature ${usageAlert.feature_id}`,
+        input: usageAlert,
+        path: ["usage_alerts", index3, "basis"]
+      });
     }
   });
 });
@@ -71124,6 +71343,7 @@ var init_billingControls = __esm(() => {
   init_customerBillingControls2();
   init_entityBillingControls2();
   init_overageAllowed2();
+  init_planBillingControls();
   init_spendLimit2();
   init_usageAlert2();
   init_usageLimit2();
@@ -72360,69 +72580,6 @@ var init_catalogMappingModels = __esm(() => {
   });
 });
 
-// ../../shared/models/featureModels/featureEnums.ts
-var FeatureType, FeatureUsageType;
-var init_featureEnums = __esm(() => {
-  ((FeatureType2) => {
-    FeatureType2["Boolean"] = "boolean";
-    FeatureType2["Metered"] = "metered";
-    FeatureType2["CreditSystem"] = "credit_system";
-    FeatureType2["AiCreditSystem"] = "ai_credit_system";
-  })(FeatureType ||= {});
-  ((FeatureUsageType2) => {
-    FeatureUsageType2["Single"] = "single_use";
-    FeatureUsageType2["Continuous"] = "continuous_use";
-  })(FeatureUsageType ||= {});
-});
-
-// ../../shared/models/featureModels/featureConfig/creditConfig.ts
-var CreditSchemaItemBaseSchema, CreditTierSchema, FlatCreditSchemaItemSchema, GraduatedCreditSchemaItemSchema, CreditSchemaItemSchema, MarkupEntrySchema, ProviderMarkupsSchema, CreditSystemConfigSchema, FeatureConfigOverrideSchema, ModelMarkupsSchema;
-var init_creditConfig = __esm(() => {
-  init_v4();
-  init_featureEnums();
-  CreditSchemaItemBaseSchema = exports_external.object({
-    metered_feature_id: exports_external.string(),
-    feature_amount: exports_external.number().optional()
-  });
-  CreditTierSchema = exports_external.object({
-    to: exports_external.union([exports_external.number(), exports_external.literal("inf")]),
-    credit_amount: exports_external.number()
-  });
-  FlatCreditSchemaItemSchema = CreditSchemaItemBaseSchema.extend({
-    credit_amount: exports_external.number(),
-    tier_behavior: exports_external.never().optional(),
-    tiers: exports_external.never().optional()
-  });
-  GraduatedCreditSchemaItemSchema = CreditSchemaItemBaseSchema.extend({
-    credit_amount: exports_external.never().optional(),
-    tier_behavior: exports_external.literal("graduated"),
-    tiers: exports_external.array(CreditTierSchema)
-  });
-  CreditSchemaItemSchema = exports_external.union([
-    FlatCreditSchemaItemSchema,
-    GraduatedCreditSchemaItemSchema
-  ]);
-  MarkupEntrySchema = exports_external.object({
-    markup: exports_external.number().min(-100)
-  });
-  ProviderMarkupsSchema = exports_external.record(exports_external.string(), MarkupEntrySchema).nullish();
-  CreditSystemConfigSchema = exports_external.object({
-    schema: exports_external.array(CreditSchemaItemSchema),
-    invoice_credit: exports_external.boolean().optional(),
-    usage_type: exports_external.nativeEnum(FeatureUsageType),
-    default_markup: exports_external.number().min(-100).optional(),
-    provider_markups: ProviderMarkupsSchema
-  });
-  FeatureConfigOverrideSchema = exports_external.strictObject({
-    schema: exports_external.array(CreditSchemaItemSchema).optional()
-  });
-  ModelMarkupsSchema = exports_external.record(exports_external.string(), MarkupEntrySchema.extend({
-    markup: exports_external.number().min(-100).optional(),
-    input_cost: exports_external.number().min(0).optional(),
-    output_cost: exports_external.number().min(0).optional()
-  })).nullish();
-});
-
 // ../../shared/api/features/crud/common/baseFeatureParamsV1.ts
 var BaseFeatureV1ParamsSchema;
 var init_baseFeatureParamsV1 = __esm(() => {
@@ -72537,11 +72694,11 @@ var CreatePlanParamsV1Schema, CreatePlanParamsV2Schema;
 var init_createPlanParamsV1 = __esm(() => {
   init_freeTrialParamsV1();
   init_basePrice();
-  init_customerBillingControls();
   init_productConfig();
   init_productMetadata();
   init_utils9();
   init_v4();
+  init_planBillingControls();
   init_createPlanItemParamsV1();
   init_planLicenseParams();
   CreatePlanParamsV1Schema = exports_external.object({
@@ -72579,7 +72736,7 @@ var init_createPlanParamsV1 = __esm(() => {
     config: ProductConfigParamsSchema.optional().meta({
       description: "Miscellaneous plan-level configuration flags."
     }),
-    billing_controls: CustomerBillingControlsParamsSchema.optional().meta({
+    billing_controls: PlanBillingControlsParamsSchema.optional().meta({
       description: "Plan-level billing controls used as customer defaults."
     }),
     metadata: ProductMetadataSchema.optional().meta({
@@ -76689,9 +76846,10 @@ var init_priceEnums = __esm(() => {
 });
 
 // ../../shared/api/versionUtils/ApiVersion.ts
-var ApiVersion, API_VERSIONS, LATEST_VERSION = "2.3.0" /* V2_3 */;
+var ApiVersion, API_VERSIONS, LATEST_VERSION = "2.4.0" /* V2_4 */;
 var init_ApiVersion = __esm(() => {
   ((ApiVersion2) => {
+    ApiVersion2["V2_4"] = "2.4.0";
     ApiVersion2["V2_3"] = "2.3.0";
     ApiVersion2["V2_2"] = "2.2.0";
     ApiVersion2["V2_1"] = "2.1.0";
@@ -77046,6 +77204,12 @@ var init_formatUtils = __esm(() => {
 var init_mathUtils = __esm(() => {
   init_decimal();
 });
+
+// ../../shared/utils/common/objectUtils.ts
+var mapRecordValues = ({
+  record: record2,
+  mapValue
+}) => Object.fromEntries(Object.entries(record2).map(([key, value]) => [key, mapValue(value)]));
 // ../../shared/utils/common/index.ts
 var init_common2 = __esm(() => {
   init_formatUtils();
@@ -77083,9 +77247,16 @@ var init_cusEntsToCurrentBalance = __esm(() => {
   init_classifyCusEntUtils();
   init_getRolloverFields();
 });
+
+// ../../shared/utils/productUtils/priceUtils/findPrice/findPrepaidQuantityTargetPrice.ts
+var init_findPrepaidQuantityTargetPrice = __esm(() => {
+  init_intervalUtils();
+  init_classifyPriceUtils();
+});
 // ../../shared/utils/cusEntUtils/balanceUtils/cusEntsToPrepaidQuantity.ts
 var init_cusEntsToPrepaidQuantity = __esm(() => {
   init_cusEntToCusPrice();
+  init_findPrepaidQuantityTargetPrice();
   init_decimal();
   init_shared();
 });
@@ -77179,11 +77350,20 @@ var init_findFeatureUtils = __esm(() => {
   init_featureErrClasses();
 });
 
+// ../../shared/utils/featureUtils/classifyFeature/hasCreditDimensionRules.ts
+var hasCreditDimensionRules = (item) => Object.keys(item.dimensions ?? {}).length > 0 || Object.keys(item.multipliers ?? {}).length > 0;
+
 // ../../shared/api/versionUtils/versionRegistry.ts
 var VERSION_REGISTRY;
 var init_versionRegistry = __esm(() => {
   init_ApiVersion();
   VERSION_REGISTRY = {
+    ["2.4.0" /* V2_4 */]: {
+      semver: "2.4.0" /* V2_4 */,
+      calver: "2026-09-04",
+      releasedAt: new Date("2026-09-04").getTime(),
+      description: "Customer object no longer returns entity-level data"
+    },
     ["2.3.0" /* V2_3 */]: {
       semver: "2.3.0" /* V2_3 */,
       calver: "2026-05-13",
@@ -77831,10 +78011,21 @@ var init_V0_2_CusProductChange = __esm(() => {
 });
 
 // ../../shared/models/orgModels/orgConfig.ts
-var InvoicePaymentMethodSchema, OrgConfigSchema;
+var OrgUsageAlertsSchema, InvoicePaymentMethodSchema, OrgConfigSchema;
 var init_orgConfig = __esm(() => {
   init_v4();
   init_usageAlert();
+  OrgUsageAlertsSchema = exports_external.array(DbUsageAlertSchema).optional().default([]).check((ctx) => {
+    const index3 = ctx.value.findIndex(isUsageLimitBasisAlert);
+    if (index3 === -1)
+      return;
+    ctx.issues.push({
+      code: "custom",
+      message: "Org-level usage alerts cannot use basis usage_limit",
+      input: ctx.value[index3],
+      path: [index3, "basis"]
+    });
+  });
   InvoicePaymentMethodSchema = exports_external.enum([
     "card",
     "customer_balance",
@@ -77845,8 +78036,8 @@ var init_orgConfig = __esm(() => {
     "link"
   ]);
   OrgConfigSchema = exports_external.object({
-    usage_alerts: exports_external.array(DbUsageAlertSchema).optional().default([]),
-    sandbox_usage_alerts: exports_external.array(DbUsageAlertSchema).optional().default([]),
+    usage_alerts: OrgUsageAlertsSchema,
+    sandbox_usage_alerts: OrgUsageAlertsSchema,
     bill_upgrade_immediately: exports_external.boolean().default(true),
     convert_to_charge_automatically: exports_external.boolean().default(true),
     anchor_start_of_month: exports_external.boolean().default(false),
@@ -79018,7 +79209,7 @@ var apiCreditSchemaToV0 = ({
     return null;
   const legacyCreditSchema = [];
   for (const item of creditSchema) {
-    if (isGraduatedCreditSchemaItem(item) || (item.billing_units ?? 1) !== 1) {
+    if (isGraduatedCreditSchemaItem(item) || hasCreditDimensionRules(item) || (item.billing_units ?? 1) !== 1) {
       return null;
     }
     legacyCreditSchema.push({
@@ -79640,7 +79831,7 @@ var toApiFeature = ({ feature }) => {
   }
   let creditSchema;
   if (feature.type === "credit_system" /* CreditSystem */ && feature.config?.schema) {
-    const canRepresentSchema = feature.config.schema.every((item) => item.tier_behavior !== "graduated" && (item.feature_amount === undefined || item.feature_amount === 1));
+    const canRepresentSchema = feature.config.schema.every((item) => item.tier_behavior !== "graduated" && !hasCreditDimensionRules(item) && (item.feature_amount === undefined || item.feature_amount === 1));
     if (canRepresentSchema) {
       creditSchema = feature.config.schema.flatMap((item) => item.tier_behavior === "graduated" ? [] : [
         {
@@ -80838,6 +81029,28 @@ var init_V2_2_PlanInheritedBillingControls = __esm(() => {
   });
 });
 
+// ../../shared/api/customers/changes/V2.3_CustomerEntityData.ts
+var NoOpSchema2, V2_3_CustomerEntityData;
+var init_V2_3_CustomerEntityData = __esm(() => {
+  init_ApiVersion();
+  init_VersionChange();
+  init_v4();
+  NoOpSchema2 = exports_external.any();
+  V2_3_CustomerEntityData = defineVersionChange({
+    name: "V2_3_CustomerEntityData",
+    newVersion: "2.4.0" /* V2_4 */,
+    oldVersion: "2.3.0" /* V2_3 */,
+    description: [
+      "Customer object aggregated entity-level subscriptions and balances before V2_4"
+    ],
+    affectedResources: ["customer" /* Customer */],
+    newSchema: NoOpSchema2,
+    oldSchema: NoOpSchema2,
+    hasSideEffects: true,
+    transformResponse: ({ input }) => input
+  });
+});
+
 // ../../shared/utils/productV3Utils/productItemUtils/productV3ItemUtils.ts
 function productV2ToBasePrice({
   product
@@ -83176,6 +83389,10 @@ var init_V2_0_AggregateEventsChange = __esm(() => {
 
 // ../../shared/api/versionUtils/versionChangeUtils/versionChangeRegistry.ts
 function registerAllVersionChanges() {
+  VersionChangeRegistryClass.register({
+    version: "2.4.0" /* V2_4 */,
+    changes: V2_4_CHANGES
+  });
   VersionChangeRegistryClass.register({
     version: "2.3.0" /* V2_3 */,
     changes: V2_3_CHANGES
@@ -83213,7 +83430,7 @@ function registerAllVersionChanges() {
     changes: V0_1_CHANGES
   });
 }
-var V2_3_CHANGES, V2_2_CHANGES, V2_1_CHANGES, V2_CHANGES, V1_4_CHANGES, V1_2_CHANGES, V1_1_CHANGES, V0_2_CHANGES, V0_1_CHANGES;
+var V2_4_CHANGES, V2_3_CHANGES, V2_2_CHANGES, V2_1_CHANGES, V2_CHANGES, V1_4_CHANGES, V1_2_CHANGES, V1_1_CHANGES, V0_2_CHANGES, V0_1_CHANGES;
 var init_versionChangeRegistry = __esm(() => {
   init_V0_1_CustomerChange();
   init_V0_2_CustomerChange();
@@ -83231,6 +83448,7 @@ var init_versionChangeRegistry = __esm(() => {
   init_V1_2_InvoiceChange();
   init_V2_0_CustomerChange();
   init_V2_2_PlanInheritedBillingControls();
+  init_V2_3_CustomerEntityData();
   init_V1_2_ProductChanges();
   init_V2_0_PlanChanges();
   init_V2_1_PlanChanges();
@@ -83247,6 +83465,9 @@ var init_versionChangeRegistry = __esm(() => {
   init_V2_0_AggregateEventsChange();
   init_ApiVersion();
   init_VersionChangeRegistryClass();
+  V2_4_CHANGES = [
+    V2_3_CustomerEntityData
+  ];
   V2_3_CHANGES = [
     V2_2_PlanInheritedBillingControls
   ];
@@ -83327,43 +83548,57 @@ var featureToApiProcessors = (feature) => {
       ...meter_id ? { meter_id } : {}
     }
   };
-}, apiCreditSchemaItemToDb = (credit) => {
-  const base3 = {
-    metered_feature_id: credit.metered_feature_id,
-    ...credit.billing_units === undefined ? {} : { feature_amount: credit.billing_units }
-  };
-  if (isGraduatedCreditSchemaItem(credit)) {
-    return {
-      ...base3,
-      tier_behavior: "graduated",
-      tiers: credit.tiers.map((tier) => ({
-        to: tier.to,
-        credit_amount: tier.credit_cost
-      }))
-    };
-  }
-  return { ...base3, credit_amount: credit.credit_cost };
-}, apiFeatureOverrideToDb = (override) => ({
+}, apiCreditRateToDb = (rate) => ("tier_behavior" in rate) ? {
+  tier_behavior: "graduated",
+  tiers: rate.tiers.map((tier) => ({
+    to: tier.to,
+    credit_amount: tier.credit_cost
+  }))
+} : { credit_amount: rate.credit_cost }, dbCreditRateToApi = (rate) => ("tier_behavior" in rate) ? {
+  tier_behavior: "graduated",
+  tiers: rate.tiers.map((tier) => ({
+    to: tier.to,
+    credit_cost: tier.credit_amount
+  }))
+} : { credit_cost: rate.credit_amount }, apiCreditDimensionToDb = (dimension) => ({
+  match: dimension.match,
+  ...dimension.priority === undefined ? {} : { priority: dimension.priority },
+  ...apiCreditRateToDb(dimension)
+}), dbCreditDimensionToApi = (dimension) => ({
+  match: dimension.match,
+  ...dimension.priority === undefined ? {} : { priority: dimension.priority },
+  ...dbCreditRateToApi(dimension)
+}), apiCreditDimensionRulesToDb = (credit) => ({
+  ...credit.dimensions === undefined ? {} : {
+    dimensions: mapRecordValues({
+      record: credit.dimensions,
+      mapValue: apiCreditDimensionToDb
+    })
+  },
+  ...credit.multipliers === undefined ? {} : { multipliers: credit.multipliers }
+}), dbCreditDimensionRulesToApi = (credit) => ({
+  ...credit.dimensions === undefined ? {} : {
+    dimensions: mapRecordValues({
+      record: credit.dimensions,
+      mapValue: dbCreditDimensionToApi
+    })
+  },
+  ...credit.multipliers === undefined ? {} : { multipliers: credit.multipliers }
+}), apiCreditSchemaItemToDb = (credit) => ({
+  metered_feature_id: credit.metered_feature_id,
+  ...credit.billing_units === undefined ? {} : { feature_amount: credit.billing_units },
+  ...apiCreditDimensionRulesToDb(credit),
+  ...apiCreditRateToDb(credit)
+}), apiFeatureOverrideToDb = (override) => ({
   ...override.credit_schema ? { schema: override.credit_schema.map(apiCreditSchemaItemToDb) } : {}
 }), dbFeatureOverrideToApi = (override) => ({
   ...override.schema ? { credit_schema: override.schema.map(dbCreditSchemaItemToApi) } : {}
-}), dbCreditSchemaItemToApi = (credit) => {
-  const base3 = {
-    metered_feature_id: credit.metered_feature_id,
-    ...credit.feature_amount === undefined ? {} : { billing_units: credit.feature_amount }
-  };
-  if (credit.tier_behavior === "graduated") {
-    return {
-      ...base3,
-      tier_behavior: "graduated",
-      tiers: credit.tiers.map((tier) => ({
-        to: tier.to,
-        credit_cost: tier.credit_amount
-      }))
-    };
-  }
-  return { ...base3, credit_cost: credit.credit_amount };
-}, dbToApiFeatureV1 = ({
+}), dbCreditSchemaItemToApi = (credit) => ({
+  metered_feature_id: credit.metered_feature_id,
+  ...credit.feature_amount === undefined ? {} : { billing_units: credit.feature_amount },
+  ...dbCreditDimensionRulesToApi(credit),
+  ...dbCreditRateToApi(credit)
+}), dbToApiFeatureV1 = ({
   ctx,
   dbFeature,
   targetVersion
@@ -83398,12 +83633,20 @@ var init_apiFeatureToDbFeature = __esm(() => {
   init_featureEnums();
   init_genEnums();
   init_isAiCreditSystem();
-  init_creditRateCard();
   init_versionUtils();
   init_utils9();
   init_buildAiCreditSystemConfig();
   init_isAnyCreditSystem();
 });
+
+// ../../shared/utils/featureUtils/creditDimensions/creditDimensionRulesEqual.ts
+var init_creditDimensionRulesEqual = () => {};
+
+// ../../shared/utils/featureUtils/creditDimensions/creditMultipliersForMatch.ts
+var init_creditMultipliersForMatch = __esm(() => {
+  init_usageLimit();
+  init_decimal();
+});
 // ../../shared/utils/featureUtils/index.ts
 var featureUtils;
 var init_featureUtils2 = __esm(() => {
@@ -83416,6 +83659,9 @@ var init_featureUtils2 = __esm(() => {
   init_isAnyCreditSystem();
   init_apiFeatureToDbFeature();
   init_convertFeatureUtils();
+  init_creditDimensionRulesEqual();
+  init_creditMultipliersForMatch();
+  init_creditTierRules();
   init_creditSystemUtils();
   init_findFeatureUtils();
   featureUtils = {
@@ -83605,6 +83851,10 @@ var init_customerEntitlementFundsFeature = __esm(() => {
   init_creditSystemUtils();
   init_entitlementToCreditSystem();
 });
+// ../../shared/utils/cusEntUtils/classifyCusEnt/isCusEntDisplayExpired.ts
+var init_isCusEntDisplayExpired = __esm(() => {
+  init_cusProductEnums();
+});
 // ../../shared/utils/cusEntUtils/convertCusEntUtils/cusEntsToMainPlanAllowance.ts
 var init_cusEntsToMainPlanAllowance = __esm(() => {
   init_shared();
@@ -83650,6 +83900,8 @@ var init_convertCusProduct = __esm(() => {
 // ../../shared/utils/cusEntUtils/convertCusEntUtils/customerEntitlementToOptions.ts
 var init_customerEntitlementToOptions = __esm(() => {
   init_convertProductUtils();
+  init_findPrepaidQuantityTargetPrice();
+  init_cusEntToCusPrice();
 });
 
 // ../../shared/utils/cusEntUtils/convertCusEntUtils/cusEntToBillingObjects.ts
@@ -83753,6 +84005,16 @@ var init_cusEntToOptions = __esm(() => {
   init_convertProductUtils();
 });
 
+// ../../shared/utils/cusEntUtils/usageAttribution/buildUsageAttributionKey.ts
+var init_buildUsageAttributionKey = __esm(() => {
+  init_creditConfig();
+});
+
+// ../../shared/utils/cusEntUtils/usageAttribution/parseUsageAttributionKey.ts
+var init_parseUsageAttributionKey = __esm(() => {
+  init_creditConfig();
+});
+
 // ../../shared/utils/cusEntUtils/index.ts
 var init_cusEntUtils2 = __esm(() => {
   init_balanceUtils();
@@ -83779,6 +84041,7 @@ var init_cusEntUtils2 = __esm(() => {
   init_cusEntsHaveUnlimited();
   init_cusEntsHaveUsageAllowed();
   init_customerEntitlementFundsFeature();
+  init_isCusEntDisplayExpired();
   init_classifyCusEntUtils();
   init_convertCusEntUtils();
   init_cusEntsToMainPlanAllowance();
@@ -83803,6 +84066,8 @@ var init_cusEntUtils2 = __esm(() => {
   init_cusEntToInvoiceUsage();
   init_cusEntToOptions();
   init_sortCusEntsForDeduction();
+  init_buildUsageAttributionKey();
+  init_parseUsageAttributionKey();
 });
 // ../../shared/utils/cusPriceUtils/convertCustomerPrice/customerPriceToCustomerEntitlement.ts
 var init_customerPriceToCustomerEntitlement = __esm(() => {
@@ -84170,6 +84435,7 @@ var creditQuantityFormatter;
 var init_invoiceCreditCustomerEntitlementToLineItems = __esm(() => {
   init_decimal();
   init_cusEntToInvoiceOverage();
+  init_parseUsageAttributionKey();
   init_findFeatureUtils();
   init_convertAmountUtils();
   init_buildLineItem();
@@ -84325,6 +84591,7 @@ var init_priceUtils2 = __esm(() => {
   init_priceToStripeNickname();
   init_priceToStripeTiersMode();
   init_convertPriceUtils();
+  init_findPrepaidQuantityTargetPrice();
   init_findPriceSuccessor();
   init_formatPriceUtils();
   init_getPriceForOverage();
@@ -84487,6 +84754,7 @@ var init_cusUtils = __esm(() => {
 // ../../shared/utils/featureUtils/diffFeature/diffFeatureV1.ts
 var init_diffFeatureV1 = __esm(() => {
   init_creditRateCard();
+  init_creditDimensionRulesEqual();
 });
 
 // ../../shared/utils/intervalUtils/addBillingInterval.ts
@@ -85010,6 +85278,17 @@ var init_apiBalanceToAllowed = __esm(() => {
   init_decimal();
 });
 
+// ../../shared/api/customers/cusFeatures/utils/convert/apiBalanceV1ToIncludedGrant.ts
+var init_apiBalanceV1ToIncludedGrant = __esm(() => {
+  init_utils9();
+});
+
+// ../../shared/api/customers/cusFeatures/utils/convert/apiBalanceV1ToRecurringGrant.ts
+var init_apiBalanceV1ToRecurringGrant = __esm(() => {
+  init_resetInterval();
+  init_utils9();
+});
+
 // ../../shared/api/customers/cusFeatures/utils/getApiBalance.ts
 var init_getApiBalance = __esm(() => {
   init_shared();
@@ -85042,6 +85321,8 @@ var init_cusFeatures = __esm(() => {
   init_check();
   init_apiBalanceToAllowed();
   init_apiBalanceV1ToAvailableOverage();
+  init_apiBalanceV1ToIncludedGrant();
+  init_apiBalanceV1ToRecurringGrant();
   init_getApiBalance();
   init_getApiBalances();
 });
@@ -89059,10 +89340,40 @@ var init_models = __esm(() => {
   init_platformModels();
 });
 
+// ../../shared/api/webhooks/balances/usageLimitWebhookBlock.ts
+var UsageLimitWebhookBlockSchema;
+var init_usageLimitWebhookBlock = __esm(() => {
+  init_v4();
+  init_usageLimit();
+  UsageLimitWebhookBlockSchema = exports_external.object({
+    limit: exports_external.number().meta({ description: "Maximum units allowed per interval." }),
+    interval: exports_external.enum(USAGE_LIMIT_INTERVALS).meta({
+      description: "Interval of the cap."
+    }),
+    anchor: UsageLimitAnchorSchema.meta({
+      description: "Window alignment the cap was configured with."
+    }),
+    usage: exports_external.number().meta({
+      description: "Units consumed in the current window, after this event."
+    }),
+    remaining: exports_external.number().meta({
+      description: "Units left in the current window, never below zero."
+    }),
+    window_start_at: exports_external.number().meta({
+      description: "Start of the current window, in milliseconds since epoch."
+    }),
+    window_end_at: exports_external.number().meta({
+      description: "End of the current window, in milliseconds since epoch."
+    })
+  });
+});
+
 // ../../shared/api/webhooks/balances/balancesLimitReached.ts
 var LimitType, BALANCES_LIMIT_REACHED_EXAMPLE, BalancesLimitReachedSchema;
 var init_balancesLimitReached = __esm(() => {
   init_v4();
+  init_usageLimit();
+  init_usageLimitWebhookBlock();
   LimitType = exports_external.enum([
     "included",
     "max_purchase",
@@ -89087,6 +89398,12 @@ var init_balancesLimitReached = __esm(() => {
     }),
     limit_type: LimitType.meta({
       description: "Which limit was hit: included allowance, max purchase cap, spend limit, or a usage-limit billing control."
+    }),
+    filter: UsageLimitFilterSchema.optional().meta({
+      description: "The filter of the usage limit that blocked, when a filtered cap was hit."
+    }),
+    usage_limit: UsageLimitWebhookBlockSchema.optional().meta({
+      description: "The usage limit that blocked, with its live window. Present only when limit_type is usage_limit."
     })
   }).meta({
     examples: [BALANCES_LIMIT_REACHED_EXAMPLE]
@@ -89094,11 +89411,14 @@ var init_balancesLimitReached = __esm(() => {
 });
 
 // ../../shared/api/webhooks/balances/balancesUsageAlertTriggered.ts
-var BalancesUsageAlertTriggeredAlertSchema, BALANCES_USAGE_ALERT_TRIGGERED_EXAMPLE, BalancesUsageAlertTriggeredSchema;
+var BalanceBasisSchema, AlertFieldsSchema, SubjectFieldsSchema, BalancesUsageAlertBalanceBlockSchema, BalancesUsageAlertOnBalanceSchema, BalancesUsageAlertOnUsageLimitSchema, BALANCES_USAGE_ALERT_TRIGGERED_EXAMPLE, BALANCES_USAGE_ALERT_ON_USAGE_LIMIT_EXAMPLE, BalancesUsageAlertTriggeredSchema;
 var init_balancesUsageAlertTriggered = __esm(() => {
   init_v4();
-  init_usageAlert2();
-  BalancesUsageAlertTriggeredAlertSchema = exports_external.object({
+  init_usageAlert();
+  init_usageLimit();
+  init_usageLimitWebhookBlock();
+  BalanceBasisSchema = exports_external.enum(BALANCE_BASES);
+  AlertFieldsSchema = exports_external.object({
     name: exports_external.string().optional().meta({
       description: "User-defined label for the alert, if provided."
     }),
@@ -89109,17 +89429,7 @@ var init_balancesUsageAlertTriggered = __esm(() => {
       description: "Whether the threshold is an absolute usage count or a percentage."
     })
   });
-  BALANCES_USAGE_ALERT_TRIGGERED_EXAMPLE = {
-    customer_id: "org_123",
-    feature_id: "api_calls",
-    entity_id: "workspace_abc",
-    usage_alert: {
-      name: "80% usage warning",
-      threshold: 80,
-      threshold_type: "usage_percentage_threshold"
-    }
-  };
-  BalancesUsageAlertTriggeredSchema = exports_external.object({
+  SubjectFieldsSchema = exports_external.object({
     customer_id: exports_external.string().meta({
       description: "The ID of the customer whose usage alert was triggered."
     }),
@@ -89128,12 +89438,85 @@ var init_balancesUsageAlertTriggered = __esm(() => {
     }),
     entity_id: exports_external.string().optional().meta({
       description: "The entity ID the alert applies to, if the usage was entity-scoped."
+    })
+  });
+  BalancesUsageAlertBalanceBlockSchema = exports_external.object({
+    usage: exports_external.number().meta({
+      description: "Units consumed on the feature, after this event."
+    }),
+    granted: exports_external.number().meta({
+      description: "Every grant on the feature: included, prepaid and rollover."
+    }),
+    included: exports_external.number().meta({
+      description: "Grants from plan allowances only."
     }),
-    usage_alert: BalancesUsageAlertTriggeredAlertSchema.meta({
-      description: "Details of the usage alert that was triggered."
+    remaining: exports_external.number().meta({
+      description: "The alert's denominator minus usage. Clamped at zero for included and recurring; balance can go negative on overage."
+    })
+  });
+  BalancesUsageAlertOnBalanceSchema = SubjectFieldsSchema.extend({
+    usage_alert: AlertFieldsSchema.extend({
+      basis: BalanceBasisSchema.meta({
+        description: "What 100% meant for this alert."
+      })
+    }).meta({ description: "Details of the usage alert that was triggered." }),
+    balance: BalancesUsageAlertBalanceBlockSchema.meta({
+      description: "The balance the alert measured."
+    })
+  });
+  BalancesUsageAlertOnUsageLimitSchema = SubjectFieldsSchema.extend({
+    usage_alert: AlertFieldsSchema.extend({
+      basis: exports_external.literal("usage_limit").meta({
+        description: "What 100% meant for this alert."
+      }),
+      filter: UsageLimitFilterSchema.optional().meta({
+        description: "The usage limit filter this alert points at, when the alert targets a filtered cap."
+      })
+    }).meta({ description: "Details of the usage alert that was triggered." }),
+    usage_limit: UsageLimitWebhookBlockSchema.meta({
+      description: "The usage limit the alert measured."
     })
-  }).meta({
-    examples: [BALANCES_USAGE_ALERT_TRIGGERED_EXAMPLE]
+  });
+  BALANCES_USAGE_ALERT_TRIGGERED_EXAMPLE = {
+    customer_id: "org_123",
+    feature_id: "api_calls",
+    entity_id: "workspace_abc",
+    usage_alert: {
+      name: "80% usage warning",
+      threshold: 80,
+      threshold_type: "usage_percentage",
+      basis: "balance"
+    },
+    balance: { usage: 1600, granted: 2000, included: 2000, remaining: 400 }
+  };
+  BALANCES_USAGE_ALERT_ON_USAGE_LIMIT_EXAMPLE = {
+    customer_id: "org_123",
+    feature_id: "api_calls",
+    usage_alert: {
+      name: "Daily cap warning",
+      threshold: 80,
+      threshold_type: "usage_percentage",
+      basis: "usage_limit",
+      filter: { properties: { api_key_id: "key_abc" } }
+    },
+    usage_limit: {
+      limit: 1000,
+      interval: "day",
+      anchor: "utc",
+      usage: 800,
+      remaining: 200,
+      window_start_at: 1735689600000,
+      window_end_at: 1735776000000
+    }
+  };
+  BalancesUsageAlertTriggeredSchema = exports_external.union([
+    BalancesUsageAlertOnBalanceSchema,
+    BalancesUsageAlertOnUsageLimitSchema
+  ]).meta({
+    examples: [
+      BALANCES_USAGE_ALERT_TRIGGERED_EXAMPLE,
+      BALANCES_USAGE_ALERT_ON_USAGE_LIMIT_EXAMPLE
+    ]
   });
 });
 
@@ -89503,6 +89886,7 @@ var init_webhookRegistry = __esm(() => {
 var init_webhooks = __esm(() => {
   init_balancesLimitReached();
   init_balancesUsageAlertTriggered();
+  init_usageLimitWebhookBlock();
   init_billingAutoTopupFailed();
   init_billingAutoTopupSucceeded();
   init_billingUpdated();
@@ -94611,6 +94995,7 @@ var init_lineItem2 = __esm(() => {
 var InsertPlanLicenseSpecSchema, CustomerLicenseTransitionSchema, CustomerLicenseUpdateSchema;
 var init_customerLicensePlan = __esm(() => {
   init_v4();
+  init_carryOverUsages();
   init_fullCustomerLicense();
   init_entModels();
   init_priceModels();
@@ -94631,7 +95016,9 @@ var init_customerLicensePlan = __esm(() => {
       granted: exports_external.number(),
       remaining: exports_external.number(),
       paidQuantity: exports_external.number()
-    })
+    }),
+    carryOverUsages: CarryOverUsagesSchema,
+    billingCycleAnchorMs: exports_external.number().optional()
   });
   CustomerLicenseUpdateSchema = exports_external.object({
     customerLicenseId: exports_external.string().optional(),
@@ -96109,6 +96496,11 @@ var init_authAccessControl = __esm(() => {
   });
 });
 
+// ../../shared/utils/billingControlUtils/index.ts
+var init_billingControlUtils = __esm(() => {
+  init_filterUnresolvableUsageLimitAlerts();
+});
+
 // ../../shared/utils/checkoutUtils/checkoutPaths.ts
 var ATTACH_CHECKOUT_PATH = "c", UPDATE_SUBSCRIPTION_CHECKOUT_PATH = "u", CHECKOUT_ACTION_PATHS;
 var init_checkoutPaths = __esm(() => {
@@ -96238,6 +96630,7 @@ var init_fullSubjectToSpendLimit = __esm(() => {
 });
 // ../../shared/utils/fullSubjectUtils/mergeCustomerBillingControlsForCheck.ts
 var init_mergeCustomerBillingControlsForCheck = __esm(() => {
+  init_usageLimitIdentity();
   init_usageLimit();
   init_getCurrentUsageWindowUsage();
   init_fullSubjectToUsageWindowLimits();
@@ -96246,6 +96639,7 @@ var init_mergeCustomerBillingControlsForCheck = __esm(() => {
 
 // ../../shared/utils/fullSubjectUtils/mergePlanBillingControlsForResponse.ts
 var init_mergePlanBillingControlsForResponse = __esm(() => {
+  init_usageLimitIdentity();
   init_buildNormalizeSpendLimitForCompare();
   init_mergeCustomerBillingControlsForCheck();
   init_planBillingControlUtils();
@@ -96380,8 +96774,8 @@ var init_shared = __esm(() => {
   init_billingResponse();
   init_cancelAction();
   init_customizePlanV1();
-  init_subscriptionParams();
   init_customLineItem();
+  init_subscriptionParams();
   init_createScheduleParamsV0();
   init_createScheduleResponse();
   init_openBillingPortalParamsV1();
@@ -96423,6 +96817,7 @@ var init_shared = __esm(() => {
   init_autoTopupLimitTable();
   init_customerBillingControls();
   init_purchaseLimitInterval();
+  init_usageLimit();
   init_cusModels();
   init_chatThreadContextsTable();
   init_cmaMemoryTable();
@@ -96565,6 +96960,7 @@ var init_shared = __esm(() => {
   init_autumnOAuthScopes();
   init_oauthScopeUtils();
   init_authAccessControl();
+  init_billingControlUtils();
   init_billingUtils();
   init_checkoutUtils();
   init_common2();
@@ -96719,29 +97115,47 @@ function createTransformer(config3) {
 }
 
 // src/lib/transforms/apiToSdk/feature.ts
-function mapCreditSchema(api2) {
-  return (api2.credit_schema ?? []).map((creditSchemaItem) => {
-    const base3 = {
-      meteredFeatureId: creditSchemaItem.metered_feature_id,
-      ...creditSchemaItem.billing_units !== undefined && {
-        billingUnits: creditSchemaItem.billing_units
-      }
-    };
-    if (isGraduatedCreditSchemaItem(creditSchemaItem)) {
-      return {
-        ...base3,
-        tierBehavior: "graduated",
-        tiers: creditSchemaItem.tiers.map((tier) => ({
-          to: tier.to,
-          creditCost: tier.credit_cost
-        }))
-      };
-    }
+function mapCreditRate(rate) {
+  if ("tier_behavior" in rate) {
     return {
-      ...base3,
-      creditCost: creditSchemaItem.credit_cost
+      tierBehavior: "graduated",
+      tiers: rate.tiers.map((tier) => ({
+        to: tier.to,
+        creditCost: tier.credit_cost
+      }))
     };
-  });
+  }
+  return { creditCost: rate.credit_cost };
+}
+function mapCreditDimension(dimension) {
+  return {
+    match: dimension.match,
+    ...dimension.priority !== undefined && { priority: dimension.priority },
+    ...mapCreditRate(dimension)
+  };
+}
+function mapCreditDimensionRules(creditSchemaItem) {
+  return {
+    ...creditSchemaItem.dimensions !== undefined && {
+      dimensions: mapRecordValues({
+        record: creditSchemaItem.dimensions,
+        mapValue: mapCreditDimension
+      })
+    },
+    ...creditSchemaItem.multipliers !== undefined && {
+      multipliers: creditSchemaItem.multipliers
+    }
+  };
+}
+function mapCreditSchema(api2) {
+  return (api2.credit_schema ?? []).map((creditSchemaItem) => ({
+    meteredFeatureId: creditSchemaItem.metered_feature_id,
+    ...creditSchemaItem.billing_units !== undefined && {
+      billingUnits: creditSchemaItem.billing_units
+    },
+    ...mapCreditDimensionRules(creditSchemaItem),
+    ...mapCreditRate(creditSchemaItem)
+  }));
 }
 function mapModelMarkups(api2) {
   if (!api2.model_markups)
@@ -98492,7 +98906,7 @@ var init_pull = __esm(() => {
 });
 
 // src/lib/version.ts
-var APP_VERSION = "1.1.23";
+var APP_VERSION = "1.1.24";
 
 // ../../node_modules/.bun/@tanstack+query-core@5.101.1/node_modules/@tanstack/query-core/build/modern/subscribable.js
 var Subscribable = class {
@@ -117599,6 +118013,44 @@ var init_prompts = __esm(() => {
 });
 
 // src/lib/transforms/sdkToApi/feature.ts
+function creditRateToApi(rate) {
+  if (rate.tierBehavior === "graduated") {
+    return {
+      tier_behavior: "graduated",
+      tiers: rate.tiers.map((tier) => ({
+        to: tier.to,
+        credit_cost: tier.creditCost
+      }))
+    };
+  }
+  return { credit_cost: rate.creditCost };
+}
+function creditDimensionToApi(dimension) {
+  return {
+    match: dimension.match,
+    ...dimension.priority !== undefined && { priority: dimension.priority },
+    ...creditRateToApi(dimension)
+  };
+}
+function creditMultiplierToApi(multiplier) {
+  return { ...multiplier, match: multiplier.match };
+}
+function creditDimensionRulesToApi(creditSchemaItem) {
+  return {
+    ...creditSchemaItem.dimensions !== undefined && {
+      dimensions: mapRecordValues({
+        record: creditSchemaItem.dimensions,
+        mapValue: creditDimensionToApi
+      })
+    },
+    ...creditSchemaItem.multipliers !== undefined && {
+      multipliers: mapRecordValues({
+        record: creditSchemaItem.multipliers,
+        mapValue: creditMultiplierToApi
+      })
+    }
+  };
+}
 function transformFeatureToApi(feature) {
   const base3 = {
     id: feature.id,
@@ -117615,28 +118067,14 @@ function transformFeatureToApi(feature) {
     base3.consumable = feature.consumable;
   }
   if (feature.type === "credit_system" && feature.creditSchema) {
-    base3.credit_schema = feature.creditSchema.map((creditSchemaItem) => {
-      const baseItem = {
-        metered_feature_id: creditSchemaItem.meteredFeatureId,
-        ...creditSchemaItem.billingUnits !== undefined && {
-          billing_units: creditSchemaItem.billingUnits
-        }
-      };
-      if (creditSchemaItem.tierBehavior === "graduated") {
-        return {
-          ...baseItem,
-          tier_behavior: "graduated",
-          tiers: creditSchemaItem.tiers.map((tier) => ({
-            to: tier.to,
-            credit_cost: tier.creditCost
-          }))
-        };
-      }
-      return {
-        ...baseItem,
-        credit_cost: creditSchemaItem.creditCost
-      };
-    });
+    base3.credit_schema = feature.creditSchema.map((creditSchemaItem) => ({
+      metered_feature_id: creditSchemaItem.meteredFeatureId,
+      ...creditSchemaItem.billingUnits !== undefined && {
+        billing_units: creditSchemaItem.billingUnits
+      },
+      ...creditDimensionRulesToApi(creditSchemaItem),
+      ...creditRateToApi(creditSchemaItem)
+    }));
   }
   if (feature.type === "ai_credit_system") {
     if (feature.modelMarkups) {
@@ -117658,6 +118096,9 @@ function transformFeatureToApi(feature) {
   }
   return base3;
 }
+var init_feature3 = __esm(() => {
+  init_shared();
+});
 
 // src/lib/transforms/sdkToApi/plan.ts
 function transformPlanItem(planItem) {
@@ -117849,7 +118290,9 @@ var transformRewardToApi = (reward) => {
 });
 
 // src/lib/transforms/sdkToApi/index.ts
-var init_sdkToApi = () => {};
+var init_sdkToApi = __esm(() => {
+  init_feature3();
+});
 
 // src/commands/push/variantPropagation.ts
 var isSelectableVariantPreview = (variant) => Boolean(variant.plan_id && variant.name && variant.versionable !== undefined), getDirectVariantUpdatePreviews = ({
@@ -139497,6 +139940,12 @@ function normalizeFeatureForCompare(f) {
         meteredFeatureId: creditSchemaItem.meteredFeatureId,
         ...creditSchemaItem.billingUnits !== undefined && creditSchemaItem.billingUnits !== 1 && {
           billingUnits: creditSchemaItem.billingUnits
+        },
+        ...creditSchemaItem.dimensions !== undefined && {
+          dimensions: creditSchemaItem.dimensions
+        },
+        ...creditSchemaItem.multipliers !== undefined && {
+          multipliers: creditSchemaItem.multipliers
         }
       };
       return creditSchemaItem.tierBehavior === "graduated" ? {