atmn 1.1.13 → 1.1.15

package/dist/cli.js

@@ -48187,7 +48187,7 @@ var init_pull = __esm(() => {
 });
 
 // src/lib/version.ts
-var APP_VERSION = "1.1.13";
+var APP_VERSION = "1.1.15";
 
 // ../../node_modules/@tanstack/query-core/build/modern/subscribable.js
 var Subscribable = class {
@@ -103885,6 +103885,7 @@ var init_usageWindowTable = __esm(() => {
     internal_entity_id: exports_external.string().nullable(),
     feature_id: exports_external.string(),
     internal_feature_id: exports_external.string(),
+    filter_key: exports_external.string().nullable().default(null),
     anchor_customer_entitlement_id: exports_external.string().nullable(),
     window_start_at: exports_external.number(),
     window_end_at: exports_external.number(),
@@ -103897,6 +103898,7 @@ var init_usageWindowTable = __esm(() => {
     internal_entity_id: text("internal_entity_id"),
     feature_id: text("feature_id").notNull(),
     internal_feature_id: text("internal_feature_id").notNull(),
+    filter_key: text("filter_key"),
     anchor_customer_entitlement_id: text("anchor_customer_entitlement_id"),
     window_start_at: numeric({ mode: "number" }).notNull(),
     window_end_at: numeric({ mode: "number" }).notNull(),
@@ -103925,7 +103927,7 @@ var init_usageWindowTable = __esm(() => {
     }).onUpdate("cascade").onDelete("set null"),
     index("idx_usage_windows_internal_customer_id").on(table3.internal_customer_id),
     index("idx_uw_internal_feature_id").on(table3.internal_feature_id).concurrently(),
-    uniqueIndex("idx_usage_windows_customer_feature_scope").on(table3.internal_customer_id, table3.internal_feature_id, sql`COALESCE(${table3.internal_entity_id}, '')`)
+    uniqueIndex("idx_usage_windows_customer_feature_scope").on(table3.internal_customer_id, table3.internal_feature_id, sql`COALESCE(${table3.internal_entity_id}, '')`, sql`COALESCE(${table3.filter_key}, '')`).concurrently()
   ]).enableRLS();
 });
 
@@ -104502,10 +104504,12 @@ var init_harnessSessionsTable = __esm(() => {
     thread_key: text("thread_key").notNull(),
     session_id: text("session_id").notNull(),
     resume_state: jsonb("resume_state"),
+    title: text("title"),
     braintrust_parent: text("braintrust_parent"),
     updated_at: numeric({ mode: "number" }).notNull().default(sqlNow)
   }, (table3) => [
-    primaryKey({ columns: [table3.org_id, table3.env, table3.thread_key] })
+    primaryKey({ columns: [table3.org_id, table3.env, table3.thread_key] }),
+    index("idx_harness_sessions_session_id").on(table3.session_id).concurrently()
   ]);
 });
 
@@ -104631,6 +104635,7 @@ var init_migrationItemRunTable = __esm(() => {
     updated_at: numeric({ mode: "number" })
   }, (table3) => [
     uniqueIndex("migration_item_runs_live_unique").on(table3.migration_internal_id, table3.item_kind, table3.item_id).where(sql`${table3.dry_run} = false`),
+    index("migration_item_runs_live_c_idx").on(table3.migration_internal_id, table3.item_kind, sql`${table3.item_id} COLLATE "C"`).where(sql`${table3.dry_run} = false`).concurrently(),
     uniqueIndex("migration_item_runs_dry_run_unique").on(table3.migration_internal_id, table3.migration_run_id, table3.item_kind, table3.item_id).where(sql`${table3.dry_run} = true`),
     index("migration_item_runs_customer_recent_idx").on(table3.item_id, sql`${table3.updated_at} DESC`).where(sql`${table3.item_kind} = 'customer'`)
   ]);
@@ -105477,9 +105482,12 @@ var init_spendLimit = __esm(() => {
     }),
     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.feature_id !== undefined, {
-    message: "feature_id is required when overage_limit is provided",
+  }).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"]
   });
 });
@@ -105540,7 +105548,11 @@ var init_resetInterval = __esm(() => {
 });
 
 // ../../shared/models/cusModels/billingControls/usageLimit.ts
-var USAGE_LIMIT_INTERVALS, DbUsageLimitSchema, USAGE_LIMIT_INTERVAL_DAYS;
+var USAGE_LIMIT_INTERVALS, USAGE_LIMIT_FILTER_MAX_KEYS = 4, USAGE_LIMIT_FILTER_MAX_KEY_LENGTH = 64, USAGE_LIMIT_FILTER_MAX_VALUE_LENGTH = 128, UsageLimitFilterValueSchema, UsageLimitFilterSchema, DbUsageLimitSchema, usageLimitFilterKey = (filter2) => {
+  if (!filter2?.properties)
+    return "";
+  return Object.entries(filter2.properties).map(([key, value]) => [key, String(value)]).sort(([left], [right]) => left.localeCompare(right)).map(([key, value]) => `${key}=${value}`).join("&");
+}, USAGE_LIMIT_INTERVAL_DAYS;
 var init_usageLimit = __esm(() => {
   init_v4();
   init_resetInterval();
@@ -105550,6 +105562,25 @@ var init_usageLimit = __esm(() => {
     "month" /* Month */,
     "year" /* Year */
   ];
+  UsageLimitFilterValueSchema = exports_external.union([
+    exports_external.string().min(1).max(USAGE_LIMIT_FILTER_MAX_VALUE_LENGTH),
+    exports_external.number(),
+    exports_external.boolean()
+  ]).transform(String);
+  UsageLimitFilterSchema = exports_external.object({
+    properties: exports_external.record(exports_external.string().min(1).max(USAGE_LIMIT_FILTER_MAX_KEY_LENGTH), UsageLimitFilterValueSchema).meta({
+      description: "Event property equality conditions. A usage event counts toward this cap only when every listed property matches (AND)."
+    }).check((ctx) => {
+      const keyCount = Object.keys(ctx.value).length;
+      if (keyCount < 1 || keyCount > USAGE_LIMIT_FILTER_MAX_KEYS) {
+        ctx.issues.push({
+          code: "custom",
+          message: `filter.properties must have between 1 and ${USAGE_LIMIT_FILTER_MAX_KEYS} keys`,
+          input: ctx.value
+        });
+      }
+    })
+  });
   DbUsageLimitSchema = exports_external.object({
     feature_id: exports_external.string().meta({
       description: "The feature this usage limit applies to."
@@ -105562,6 +105593,9 @@ var init_usageLimit = __esm(() => {
     }),
     interval: exports_external.enum(USAGE_LIMIT_INTERVALS).meta({
       description: "Interval for the cap, aligned to the customer's billing cycle."
+    }),
+    filter: UsageLimitFilterSchema.optional().meta({
+      description: "When set, only usage from events whose properties match counts toward this cap. Omit to count all usage of the feature."
     })
   });
   USAGE_LIMIT_INTERVAL_DAYS = {
@@ -105619,6 +105653,7 @@ var init_customerBillingControls = __esm(() => {
   init_spendLimit();
   init_usageAlert();
   init_usageLimit();
+  init_usageLimit();
   AutoTopupPurchaseLimitSchema = exports_external.object({
     interval: PurchaseLimitIntervalEnum.meta({
       description: "The time interval for the purchase limit window."
@@ -105668,7 +105703,7 @@ var init_customerBillingControls = __esm(() => {
     })
   });
   AutoTopupResponseSchema = AutoTopupSchema.extend({
-    purchase_limit: exports_external.union([AutoTopupPurchaseLimitSchema, ExpandedPurchaseLimitSchema]).optional().meta({
+    purchase_limit: exports_external.union([ExpandedPurchaseLimitSchema, AutoTopupPurchaseLimitSchema]).optional().meta({
       description: "Optional rate limit to cap how often auto top-ups occur. Expand billing_controls.auto_topups.purchase_limit for a count of top ups and the next_reset_at."
     })
   });
@@ -105714,18 +105749,19 @@ var init_customerBillingControls = __esm(() => {
       }
       spendLimitFeatureIds.add(spendLimit.feature_id);
     }
-    const usageLimitFeatureIds = new Set;
+    const usageLimitIdentities = new Set;
     for (const [index3, usageLimit] of (billingControls.usage_limits ?? []).entries()) {
-      if (usageLimitFeatureIds.has(usageLimit.feature_id)) {
+      const identity4 = `${usageLimit.feature_id}|${usageLimitFilterKey(usageLimit.filter)}`;
+      if (usageLimitIdentities.has(identity4)) {
         ctx.issues.push({
           code: "custom",
-          message: "Only one usage limit entry is allowed per feature_id",
+          message: "Only one usage limit entry is allowed per feature_id and filter",
           input: usageLimit.feature_id,
           path: ["usage_limits", index3, "feature_id"]
         });
         return;
       }
-      usageLimitFeatureIds.add(usageLimit.feature_id);
+      usageLimitIdentities.add(identity4);
     }
     const overageAllowedFeatureIds = new Set;
     for (const [index3, overageAllowed] of (billingControls.overage_allowed ?? []).entries()) {
@@ -106893,8 +106929,13 @@ var init_billingBehavior = __esm(() => {
 var PaymentFailureCodeEnum, BillingResponseRequiredActionSchema, BillingResponseSchema;
 var init_billingResponse = __esm(() => {
   init_v4();
-  PaymentFailureCodeEnum = exports_external.enum(["3ds_required", "payment_method_required", "payment_failed"]).meta({
-    description: "The type of payment failure. '3ds_required' means 3D Secure authentication is needed, 'payment_method_required' means the customer needs to add a payment method, 'payment_failed' means the payment was declined."
+  PaymentFailureCodeEnum = exports_external.enum([
+    "3ds_required",
+    "payment_method_required",
+    "payment_failed",
+    "payment_processing"
+  ]).meta({
+    description: "The type of payment action. '3ds_required' means 3D Secure authentication is needed, 'payment_method_required' means the customer needs to add a payment method, 'payment_failed' means the payment was declined, 'payment_processing' means payment is still settling."
   });
   BillingResponseRequiredActionSchema = exports_external.object({
     code: PaymentFailureCodeEnum.meta({
@@ -107297,11 +107338,53 @@ var init_previewUpdateSubscriptionResponse = __esm(() => {
   });
 });
 
+// ../../shared/api/billingControls/billingControlSource.ts
+var BillingControlSourceSchema;
+var init_billingControlSource = __esm(() => {
+  init_v4();
+  BillingControlSourceSchema = exports_external.enum(["customer", "plan"]).meta({
+    description: "Response-only: whether the entry is a customer-level override or inherited from an attached plan's defaults."
+  });
+});
+
+// ../../shared/api/billingControls/autoTopup.ts
+var ApiAutoTopupSchema;
+var init_autoTopup = __esm(() => {
+  init_customerBillingControls();
+  init_billingControlSource();
+  ApiAutoTopupSchema = AutoTopupResponseSchema.extend({
+    source: BillingControlSourceSchema.optional()
+  });
+});
+
+// ../../shared/api/billingControls/overageAllowed.ts
+var ApiOverageAllowedSchema;
+var init_overageAllowed2 = __esm(() => {
+  init_overageAllowed();
+  init_billingControlSource();
+  ApiOverageAllowedSchema = DbOverageAllowedSchema.extend({
+    source: BillingControlSourceSchema.optional()
+  });
+});
+
 // ../../shared/api/billingControls/spendLimit.ts
 var ApiSpendLimitSchema;
 var init_spendLimit2 = __esm(() => {
   init_spendLimit();
-  ApiSpendLimitSchema = DbSpendLimitSchema;
+  init_billingControlSource();
+  ApiSpendLimitSchema = DbSpendLimitSchema.extend({
+    source: BillingControlSourceSchema.optional()
+  });
+});
+
+// ../../shared/api/billingControls/usageAlert.ts
+var ApiUsageAlertSchema;
+var init_usageAlert2 = __esm(() => {
+  init_usageAlert();
+  init_billingControlSource();
+  ApiUsageAlertSchema = DbUsageAlertSchema.extend({
+    source: BillingControlSourceSchema.optional()
+  });
 });
 
 // ../../shared/api/billingControls/usageLimit.ts
@@ -107309,10 +107392,12 @@ var ApiUsageLimitSchema;
 var init_usageLimit2 = __esm(() => {
   init_v4();
   init_usageLimit();
+  init_billingControlSource();
   ApiUsageLimitSchema = DbUsageLimitSchema.extend({
     usage: exports_external.number().min(0).optional().meta({
       description: "Current usage already consumed in the active interval. Response-only; not stored on billing controls."
-    })
+    }),
+    source: BillingControlSourceSchema.optional()
   });
 });
 
@@ -107320,11 +107405,13 @@ var init_usageLimit2 = __esm(() => {
 var CustomerBillingControlsResponseSchema;
 var init_customerBillingControls2 = __esm(() => {
   init_v4();
-  init_customerBillingControls();
+  init_autoTopup();
+  init_overageAllowed2();
   init_spendLimit2();
+  init_usageAlert2();
   init_usageLimit2();
   CustomerBillingControlsResponseSchema = exports_external.object({
-    auto_topups: exports_external.array(AutoTopupResponseSchema).optional().meta({
+    auto_topups: exports_external.array(ApiAutoTopupSchema).optional().meta({
       description: "List of auto top-up configurations per feature."
     }),
     spend_limits: exports_external.array(ApiSpendLimitSchema).optional().meta({
@@ -107333,34 +107420,22 @@ var init_customerBillingControls2 = __esm(() => {
     usage_limits: exports_external.array(ApiUsageLimitSchema).optional().meta({
       description: "List of hard usage caps per feature, with current interval usage."
     }),
-    usage_alerts: exports_external.array(DbUsageAlertSchema).optional().meta({
+    usage_alerts: exports_external.array(ApiUsageAlertSchema).optional().meta({
       description: "List of usage alert configurations per feature."
     }),
-    overage_allowed: exports_external.array(DbOverageAllowedSchema).optional().meta({
+    overage_allowed: exports_external.array(ApiOverageAllowedSchema).optional().meta({
       description: "List of overage allowed controls per feature. When enabled, usage can exceed balance."
     })
   });
 });
 
-// ../../shared/api/billingControls/overageAllowed.ts
-var ApiOverageAllowedSchema;
-var init_overageAllowed2 = __esm(() => {
-  init_overageAllowed();
-  ApiOverageAllowedSchema = DbOverageAllowedSchema;
-});
-
-// ../../shared/api/billingControls/usageAlert.ts
-var ApiUsageAlertSchema;
-var init_usageAlert2 = __esm(() => {
-  init_usageAlert();
-  ApiUsageAlertSchema = DbUsageAlertSchema;
-});
-
 // ../../shared/api/billingControls/entityBillingControls.ts
 var ApiEntityBillingControlsSchema, ApiEntityBillingControlsParamsBaseSchema, ApiEntityBillingControlsParamsSchema;
 var init_entityBillingControls2 = __esm(() => {
   init_v4();
+  init_overageAllowed();
   init_spendLimit();
+  init_usageAlert();
   init_usageLimit();
   init_overageAllowed2();
   init_spendLimit2();
@@ -107387,10 +107462,10 @@ var init_entityBillingControls2 = __esm(() => {
     usage_limits: exports_external.array(DbUsageLimitSchema).optional().meta({
       description: "List of hard usage caps per feature for this entity. An entity entry overrides the customer's for that feature."
     }),
-    usage_alerts: exports_external.array(ApiUsageAlertSchema).optional().meta({
+    usage_alerts: exports_external.array(DbUsageAlertSchema).optional().meta({
       description: "List of usage alert configurations per feature."
     }),
-    overage_allowed: exports_external.array(ApiOverageAllowedSchema).optional().meta({
+    overage_allowed: exports_external.array(DbOverageAllowedSchema).optional().meta({
       description: "List of overage allowed controls per feature. When enabled, usage can exceed balance."
     })
   });
@@ -107443,6 +107518,8 @@ var init_entityBillingControls2 = __esm(() => {
 
 // ../../shared/api/billingControls/index.ts
 var init_billingControls = __esm(() => {
+  init_autoTopup();
+  init_billingControlSource();
   init_customerBillingControls2();
   init_entityBillingControls2();
   init_overageAllowed2();
@@ -107552,7 +107629,6 @@ var init_ErrCode = __esm(() => {
     CreateEntitlementFailed: "create_entitlement_failed",
     DeleteEntitlementFailed: "delete_entitlement_failed",
     InsufficientBalance: "insufficient_balance",
-    SetUsageNotAllowedWithUsageLimit: "set_usage_not_allowed_with_usage_limit",
     CreateInvoiceFailed: "create_invoice_failed",
     InvalidEvent: "invalid_event",
     CreateEventFailed: "create_event_failed",
@@ -107562,6 +107638,7 @@ var init_ErrCode = __esm(() => {
     GetCusPriceFailed: "get_cus_price_failed",
     PayInvoiceFailed: "invoice_payment_failed",
     InvalidReward: "invalid_reward",
+    ProductNotInStripe: "product_not_in_stripe",
     DuplicateRewardId: "duplicate_reward_id",
     DuplicatePromoCode: "duplicate_promo_code",
     PromoCodeAlreadyExistsInStripe: "promo_code_already_exists_in_stripe",
@@ -107895,7 +107972,7 @@ var init_processorSchemas = __esm(() => {
 });
 
 // ../../shared/api/common/customerData.ts
-var CreateCustomerInternalOptionsSchema, CustomerDataSchema;
+var CreateCustomerInternalOptionsSchema, CustomerEmailSchema, CustomerDataSchema;
 var init_customerData = __esm(() => {
   init_v4();
   init_customerBillingControls();
@@ -107908,14 +107985,15 @@ var init_customerData = __esm(() => {
       description: "Whether to disable default products"
     })
   });
+  CustomerEmailSchema = exports_external.email({
+    pattern: exports_external.regexes.unicodeEmail,
+    message: "not a valid email address"
+  });
   CustomerDataSchema = exports_external.object({
     name: exports_external.string().nullish().meta({
       description: "Customer's name"
     }),
-    email: exports_external.email({
-      pattern: exports_external.regexes.unicodeEmail,
-      message: "not a valid email address"
-    }).nullish().meta({
+    email: CustomerEmailSchema.nullish().meta({
       description: "Customer's email address"
     }),
     fingerprint: exports_external.string().nullish().meta({
@@ -116665,6 +116743,50 @@ var init_V2_0_CustomerChange = __esm(() => {
   });
 });
 
+// ../../shared/api/customers/changes/V2.2_PlanInheritedBillingControls.ts
+var stripPlanInherited = (entries) => {
+  if (entries === undefined)
+    return;
+  const customerEntries = entries.filter((entry) => entry.source !== "plan").map(({ source: _source, ...rest2 }) => rest2);
+  if (customerEntries.length === 0 && entries.length > 0)
+    return;
+  return customerEntries;
+}, V2_2_PlanInheritedBillingControls;
+var init_V2_2_PlanInheritedBillingControls = __esm(() => {
+  init_ApiVersion();
+  init_VersionChange();
+  init_apiCustomerV5();
+  V2_2_PlanInheritedBillingControls = defineVersionChange({
+    name: "V2_2 Plan Inherited Billing Controls",
+    newVersion: "2.3.0" /* V2_3 */,
+    oldVersion: "2.2.0" /* V2_2 */,
+    description: [
+      "2.3.0 merges plan-default billing controls into the customer's billing_controls with a `source` tag; older versions receive customer-level entries only, without `source`"
+    ],
+    affectedResources: ["customer" /* Customer */],
+    newSchema: ApiCustomerV5Schema,
+    oldSchema: ApiCustomerV5Schema,
+    affectsResponse: true,
+    transformResponse: ({
+      input
+    }) => {
+      const billingControls = input.billing_controls;
+      if (!billingControls)
+        return input;
+      return {
+        ...input,
+        billing_controls: {
+          auto_topups: stripPlanInherited(billingControls.auto_topups),
+          spend_limits: stripPlanInherited(billingControls.spend_limits),
+          usage_limits: stripPlanInherited(billingControls.usage_limits),
+          usage_alerts: stripPlanInherited(billingControls.usage_alerts),
+          overage_allowed: stripPlanInherited(billingControls.overage_allowed)
+        }
+      };
+    }
+  });
+});
+
 // ../../shared/utils/productV3Utils/productItemUtils/productV3ItemUtils.ts
 function productV2ToBasePrice({
   product
@@ -118672,9 +118794,7 @@ var init_updateSubscriptionV1Params = __esm(() => {
     no_billing_changes: exports_external.boolean().optional().meta({
       description: "If true, the subscription is updated internally without applying billing changes in Stripe."
     }),
-    refund_last_payment: RefundLastPaymentSchema.optional().meta({
-      internal: true
-    }),
+    refund_last_payment: RefundLastPaymentSchema.optional(),
     recalculate_balances: exports_external.object({
       enabled: exports_external.boolean().meta({
         description: "If true, recalculates balances during the subscription update. Only applicable when updating feature quantities."
@@ -118916,6 +119036,7 @@ var init_versionChangeRegistry = __esm(() => {
   init_V1_2_FeatureParamsChange();
   init_V1_2_InvoiceChange();
   init_V2_0_CustomerChange();
+  init_V2_2_PlanInheritedBillingControls();
   init_V1_2_ProductChanges();
   init_V2_0_PlanChanges();
   init_V2_1_PlanChanges();
@@ -118932,7 +119053,9 @@ var init_versionChangeRegistry = __esm(() => {
   init_V2_0_AggregateEventsChange();
   init_ApiVersion();
   init_VersionChangeRegistryClass();
-  V2_3_CHANGES = [];
+  V2_3_CHANGES = [
+    V2_2_PlanInheritedBillingControls
+  ];
   V2_2_CHANGES = [
     V2_1_PlanChanges
   ];
@@ -119978,6 +120101,11 @@ var init_fullCustomerToOverageAllowed = __esm(() => {
   init_planBillingControlUtils();
 });
 
+// ../../shared/utils/cusUtils/fullCusUtils/fullCustomerToSkipOverageBilling.ts
+var init_fullCustomerToSkipOverageBilling = __esm(() => {
+  init_planBillingControlUtils();
+});
+
 // ../../shared/utils/cusUtils/fullCusUtils/fullCustomerToSpendLimit.ts
 var init_fullCustomerToSpendLimit = __esm(() => {
   init_cusEntUtils2();
@@ -119993,6 +120121,7 @@ var init_cusUtils = __esm(() => {
   init_enrichFullCustomer();
   init_fullCustomerToCustomerEntitlements();
   init_fullCustomerToOverageAllowed();
+  init_fullCustomerToSkipOverageBilling();
   init_fullCustomerToSpendLimit();
   init_fullCustomerToTags();
 });
@@ -120131,6 +120260,7 @@ var init_diffPlanV1 = __esm(() => {
 
 // ../../shared/utils/planV1Utils/diff/diffPlanV1PreviewFields.ts
 var init_diffPlanV1PreviewFields = __esm(() => {
+  init_customerBillingControls();
   init_diffPlanV1();
 });
 
@@ -120213,6 +120343,7 @@ var init_apiBalanceV1ToAvailableOverage = __esm(() => {
 });
 // ../../shared/api/customers/utils/apiSubjectToUsageLimitHeadroom.ts
 var init_apiSubjectToUsageLimitHeadroom = __esm(() => {
+  init_usageLimit();
   init_decimal();
 });
 
@@ -122467,6 +122598,9 @@ var init_updateBalanceParams = __esm(() => {
     }),
     next_reset_at: exports_external.number().optional().meta({
       description: "The next reset time for the balance. If there are multiple breakdowns, this will update the breakdown with the next reset time."
+    }),
+    expires_at: exports_external.number().optional().meta({
+      description: "Unix timestamp (milliseconds) when the balance expires. Targets a specific balance via balance_id / interval when the customer has multiple balances for the same feature."
     })
   });
   UpdateBalanceParamsV0Schema = ExtUpdateBalanceParamsV0Schema.extend({
@@ -123000,15 +123134,107 @@ var init_common3 = __esm(() => {
   init_transitionRules();
 });
 
+// ../../shared/api/billing/multiUpdate/multiUpdateParamsV0.ts
+var ExtMultiUpdateItemV0Schema, MultiUpdateItemV0Schema, multiUpdateParamsBase, updatesMeta, ExtMultiUpdateParamsV0Schema, MultiUpdateParamsV0Schema;
+var init_multiUpdateParamsV0 = __esm(() => {
+  init_v4();
+  init_billingBehavior();
+  init_cancelAction();
+  ExtMultiUpdateItemV0Schema = exports_external.object({
+    plan_id: exports_external.string().optional().meta({
+      description: "The ID of the plan to update. Optional if subscription_id is provided."
+    }),
+    subscription_id: exports_external.string().optional().meta({
+      description: "A unique ID to identify the subscription to update. Useful when a customer has multiple products with the same plan."
+    }),
+    entity_id: exports_external.string().optional().meta({
+      description: "The ID of the entity this update targets. Overrides the top-level entity_id for this update."
+    }),
+    cancel_action: CancelActionSchema.meta({
+      description: "Action to perform for cancellation. 'cancel_immediately' cancels now with prorated refund, 'cancel_end_of_cycle' cancels at period end, 'uncancel' reverses a pending cancellation."
+    }),
+    proration_behavior: BillingBehaviorSchema.optional().meta({
+      description: "How to handle proration for this update. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges."
+    })
+  });
+  MultiUpdateItemV0Schema = ExtMultiUpdateItemV0Schema.extend({
+    customer_product_id: exports_external.string().optional().meta({
+      internal: true
+    })
+  });
+  multiUpdateParamsBase = {
+    customer_id: exports_external.string().meta({
+      description: "The ID of the customer to update plans for."
+    }),
+    entity_id: exports_external.string().optional().meta({
+      description: "The ID of the entity to update plans for. Individual updates can override this with their own entity_id."
+    })
+  };
+  updatesMeta = {
+    description: "The list of plan updates to apply to the customer."
+  };
+  ExtMultiUpdateParamsV0Schema = exports_external.object({
+    ...multiUpdateParamsBase,
+    updates: exports_external.array(ExtMultiUpdateItemV0Schema).min(1, "At least one update must be provided").meta(updatesMeta)
+  });
+  MultiUpdateParamsV0Schema = exports_external.object({
+    ...multiUpdateParamsBase,
+    updates: exports_external.array(MultiUpdateItemV0Schema).min(1, "At least one update must be provided").meta(updatesMeta)
+  });
+});
+
+// ../../shared/api/billing/multiUpdate/multiUpdatePreviewResponseV0.ts
+var planIdsField, MultiUpdateSubscriptionPreviewV0Schema, ExtMultiUpdateSubscriptionPreviewV0Schema, multiUpdatePreviewBase, subscriptionsMeta, ExtMultiUpdatePreviewResponseV0Schema, MultiUpdatePreviewResponseV0Schema;
+var init_multiUpdatePreviewResponseV0 = __esm(() => {
+  init_v4();
+  init_billingPreviewResponse();
+  planIdsField = exports_external.array(exports_external.string()).meta({
+    description: "The IDs of the plans updated on this subscription."
+  });
+  MultiUpdateSubscriptionPreviewV0Schema = BillingPreviewResponseSchema.extend({
+    plan_ids: planIdsField
+  });
+  ExtMultiUpdateSubscriptionPreviewV0Schema = ExtBillingPreviewResponseSchema.extend({
+    plan_ids: planIdsField
+  });
+  multiUpdatePreviewBase = {
+    customer_id: exports_external.string().meta({
+      description: "The ID of the customer the preview applies to."
+    }),
+    currency: exports_external.string().meta({
+      description: "The three-letter ISO currency code (e.g., 'usd')."
+    }),
+    total: exports_external.number().meta({
+      description: "The combined amount due today across all subscriptions (sum of subscriptions[].total)."
+    })
+  };
+  subscriptionsMeta = {
+    description: "One preview per affected Stripe subscription. Updates to plans without a subscription (free plans) produce no entry."
+  };
+  ExtMultiUpdatePreviewResponseV0Schema = exports_external.object({
+    ...multiUpdatePreviewBase,
+    subscriptions: exports_external.array(ExtMultiUpdateSubscriptionPreviewV0Schema).meta(subscriptionsMeta)
+  });
+  MultiUpdatePreviewResponseV0Schema = exports_external.object({
+    object: exports_external.literal("multi_update_preview").meta({ internal: true }),
+    ...multiUpdatePreviewBase,
+    subscriptions: exports_external.array(MultiUpdateSubscriptionPreviewV0Schema).meta(subscriptionsMeta)
+  });
+});
+
 // ../../shared/api/billing/dfu/dfuFlashParams.ts
 var ProcessorTypeSchema, FlashCustomerDataSchema, FlashProcessorIdentitySchema, FlashLinkSchema, FlashStartingAfterSchema, FlashBalanceFilterSchema, FlashRolloverSchema, FlashBalanceSchema, FlashFeatureQuantitySchema, FlashPlanSchema, FlashPhaseSchema, FlashBillableSchema, FlashEntitySchema, DfuFlashParamsSchema, DfuFlashedPlanSchema, DfuFlashResultSchema;
 var init_dfuFlashParams = __esm(() => {
+  init_entitlementInterval();
   init_v4();
+  init_customerData();
   init_apiCustomerV5();
   ProcessorTypeSchema = exports_external.enum(["stripe", "revenuecat"]);
   FlashCustomerDataSchema = exports_external.object({
     name: exports_external.string().optional().meta({ description: "Display name for the customer." }),
-    email: exports_external.string().optional().meta({ description: "Email address for the customer." }),
+    email: CustomerEmailSchema.optional().meta({
+      description: "Email address for the customer."
+    }),
     fingerprint: exports_external.string().optional().meta({ description: "Anti-fraud fingerprint for the customer." })
   });
   FlashProcessorIdentitySchema = exports_external.object({
@@ -123032,11 +123258,11 @@ var init_dfuFlashParams = __esm(() => {
     duration_count: exports_external.number()
   }).meta({ internal: true });
   FlashBalanceFilterSchema = exports_external.object({
-    interval: exports_external.enum(["hour", "day", "week", "month", "year"]).nullable().optional().meta({
-      description: "Reset interval selecting which entitlement line to target when a feature has several (null = the non-resetting one-off line)."
+    interval: exports_external.enum(EntInterval).nullable().optional().meta({
+      description: "Reset interval selecting which entitlement line to target when a feature has several ('lifetime' or null = the non-resetting one-off line)."
     }),
-    billing_behavior: exports_external.enum(["included", "prepaid"]).optional().meta({
-      description: "Selects the included vs prepaid entitlement line when a feature has both."
+    billing_behavior: exports_external.enum(["included", "prepaid", "usage_based"]).optional().meta({
+      description: "Selects the included vs prepaid vs usage-based (pay-per-use) entitlement line when a feature has several."
     })
   });
   FlashRolloverSchema = exports_external.object({
@@ -123125,7 +123351,7 @@ var init_dfuFlashParams = __esm(() => {
       description: "Autumn customer to image into."
     }),
     customer_data: FlashCustomerDataSchema.optional().meta({
-      description: "Optional identity fields to upsert if the customer is new."
+      description: "Optional identity fields upserted onto the customer (applied to existing customers too)."
     }),
     processors: exports_external.array(FlashProcessorIdentitySchema).optional().meta({
       description: "The customer's processor identities (e.g. Stripe customer id, RevenueCat app_user_id). Omit for customers with no processor, e.g. those only ever on a free plan."
@@ -123482,6 +123708,8 @@ var init_billing = __esm(() => {
   init_common3();
   init_createScheduleParamsV0();
   init_createScheduleResponse();
+  init_multiUpdateParamsV0();
+  init_multiUpdatePreviewResponseV0();
   init_dfuFlashParams();
   init_openBillingPortalParamsV1();
   init_openBillingPortalResponse();
@@ -124170,6 +124398,83 @@ var init_balancesUsageAlertTriggered = __esm(() => {
   });
 });
 
+// ../../shared/api/webhooks/billing/billingAutoTopupFailed.ts
+var BillingAutoTopupFailureReasonSchema, BillingAutoTopupFailedErrorSchema, BILLING_AUTO_TOPUP_FAILED_EXAMPLE, BillingAutoTopupFailedSchema;
+var init_billingAutoTopupFailed = __esm(() => {
+  init_v4();
+  BillingAutoTopupFailureReasonSchema = exports_external.enum([
+    "charge_failed",
+    "purchase_limit_reached",
+    "attempt_limit_reached",
+    "failed_attempt_limit_reached",
+    "customer_unavailable",
+    "configuration_unavailable",
+    "missing_payment_method",
+    "missing_customer_product",
+    "invalid_amount",
+    "lock_contention",
+    "redis_unavailable",
+    "execution_error"
+  ]).meta({
+    description: "Machine-readable reason the automatic top-up did not grant balance."
+  });
+  BillingAutoTopupFailedErrorSchema = exports_external.object({
+    code: exports_external.string().nullish().meta({
+      description: "Machine-readable error code when one is available (for example, a Stripe or Autumn error code)."
+    }),
+    message: exports_external.string().nullish().meta({
+      description: "Sanitized error message with details about why the auto top-up failed."
+    }),
+    type: exports_external.string().nullish().meta({
+      description: "Provider error type when one is available."
+    }),
+    decline_code: exports_external.string().nullish().meta({
+      description: "Stripe decline code when the failure came from a card decline."
+    })
+  });
+  BILLING_AUTO_TOPUP_FAILED_EXAMPLE = {
+    customer_id: "cus_123",
+    feature_id: "messages",
+    reason: "charge_failed",
+    quantity: 100,
+    threshold: 20,
+    balance: 15,
+    invoice_mode: false,
+    error: {
+      code: "card_declined",
+      message: "Your card was declined.",
+      type: "card_error",
+      decline_code: "generic_decline"
+    }
+  };
+  BillingAutoTopupFailedSchema = exports_external.object({
+    customer_id: exports_external.string().meta({
+      description: "The ID of the customer whose auto top-up failed."
+    }),
+    feature_id: exports_external.string().meta({
+      description: "The feature ID that Autumn attempted to auto top-up."
+    }),
+    reason: BillingAutoTopupFailureReasonSchema,
+    quantity: exports_external.number().nullish().meta({
+      description: "The normalized amount of balance Autumn attempted to grant, when a matching auto top-up config was available."
+    }),
+    threshold: exports_external.number().nullish().meta({
+      description: "The configured balance threshold for the auto top-up, when available."
+    }),
+    balance: exports_external.number().nullish().meta({
+      description: "The customer's remaining balance for the feature at the time the failure was detected, when available."
+    }),
+    invoice_mode: exports_external.boolean().nullish().meta({
+      description: "Whether the auto top-up was configured to create a send_invoice invoice instead of auto-charging."
+    }),
+    error: BillingAutoTopupFailedErrorSchema.nullish().meta({
+      description: "Sanitized provider or Autumn error metadata, when the failure came from an exception or declined charge."
+    })
+  }).meta({
+    examples: [BILLING_AUTO_TOPUP_FAILED_EXAMPLE]
+  });
+});
+
 // ../../shared/api/webhooks/billing/billingAutoTopupSucceeded.ts
 var BillingAutoTopupSucceededInvoiceSchema, BILLING_AUTO_TOPUP_SUCCEEDED_EXAMPLE, BillingAutoTopupSucceededSchema;
 var init_billingAutoTopupSucceeded = __esm(() => {
@@ -124369,6 +124674,7 @@ var webhookRegistry;
 var init_webhookRegistry = __esm(() => {
   init_balancesLimitReached();
   init_balancesUsageAlertTriggered();
+  init_billingAutoTopupFailed();
   init_billingAutoTopupSucceeded();
   init_billingUpdated();
   init_vercelResourceDeleted();
@@ -124393,6 +124699,14 @@ var init_webhookRegistry = __esm(() => {
       group: "Balances",
       description: "Fired when a customer reaches the limit for a feature (included allowance, max purchase, or spend limit)."
     },
+    {
+      eventType: "billing.auto_topup_failed" /* BillingAutoTopupFailed */,
+      operationId: "billingAutoTopupFailed",
+      title: "Auto Top-Up Failed",
+      schema: BillingAutoTopupFailedSchema,
+      group: "Billing",
+      description: "Fired when an automatic top-up is blocked, declined, or fails before granting additional prepaid balance."
+    },
     {
       eventType: "billing.auto_topup_succeeded" /* BillingAutoTopupSucceeded */,
       operationId: "billingAutoTopupSucceeded",
@@ -124452,6 +124766,7 @@ var init_webhookRegistry = __esm(() => {
 var init_webhooks = __esm(() => {
   init_balancesLimitReached();
   init_balancesUsageAlertTriggered();
+  init_billingAutoTopupFailed();
   init_billingAutoTopupSucceeded();
   init_billingUpdated();
   init_vercel();
@@ -129445,6 +129760,8 @@ var init_usageWindowModels = __esm(() => {
     scope_type: UsageWindowScopeSchema,
     entity_id: exports_external.string().nullable(),
     internal_entity_id: exports_external.string().nullable(),
+    filter_key: exports_external.string().nullable(),
+    filter_properties: exports_external.record(exports_external.string(), exports_external.string()).nullable(),
     interval: exports_external.enum(EntInterval),
     window_start_at: exports_external.number(),
     window_end_at: exports_external.number(),
@@ -130911,6 +131228,13 @@ var init_fullSubjectToCustomerEntitlements = __esm(() => {
   init_utils11();
 });
 
+// ../../shared/utils/fullSubjectUtils/buildNormalizeSpendLimitForCompare.ts
+var init_buildNormalizeSpendLimitForCompare = __esm(() => {
+  init_resolveSpendLimitOverageLimit();
+  init_fullSubjectToCustomerEntitlements();
+  init_planBillingControlUtils();
+});
+
 // ../../shared/utils/fullSubjectUtils/classifyFullSubject.ts
 var init_classifyFullSubject = __esm(() => {
   init_classifyCusEntUtils();
@@ -130954,6 +131278,7 @@ var init_getUsageWindowDimension = __esm(() => {
 // ../../shared/utils/usageWindowUtils/convertUsageWindow/usageLimitToUsageWindowLimit.ts
 var init_usageLimitToUsageWindowLimit = __esm(() => {
   init_planItemIntervals();
+  init_usageLimit();
   init_findUsageWindowAnchor();
   init_getUsageWindowBounds();
   init_getUsageWindowDimension();
@@ -130962,11 +131287,13 @@ var init_usageLimitToUsageWindowLimit = __esm(() => {
 // ../../shared/utils/fullSubjectUtils/fullSubjectToUsageWindowLimits.ts
 var init_fullSubjectToUsageWindowLimits = __esm(() => {
   init_usageLimitToUsageWindowLimit();
+  init_usageLimit();
   init_planBillingControlUtils();
 });
 
 // ../../shared/utils/fullSubjectUtils/fullSubjectToApiUsageLimits.ts
 var init_fullSubjectToApiUsageLimits = __esm(() => {
+  init_usageLimit();
   init_getCurrentUsageWindowUsage();
   init_fullSubjectToUsageWindowLimits();
 });
@@ -130983,21 +131310,31 @@ var init_fullSubjectToSpendLimit = __esm(() => {
 });
 // ../../shared/utils/fullSubjectUtils/mergeCustomerBillingControlsForCheck.ts
 var init_mergeCustomerBillingControlsForCheck = __esm(() => {
+  init_usageLimit();
   init_getCurrentUsageWindowUsage();
   init_fullSubjectToUsageWindowLimits();
   init_planBillingControlUtils();
 });
+
+// ../../shared/utils/fullSubjectUtils/mergePlanBillingControlsForResponse.ts
+var init_mergePlanBillingControlsForResponse = __esm(() => {
+  init_buildNormalizeSpendLimitForCompare();
+  init_mergeCustomerBillingControlsForCheck();
+  init_planBillingControlUtils();
+});
 // ../../shared/utils/fullSubjectUtils/index.ts
 var init_fullSubjectUtils = __esm(() => {
+  init_buildNormalizeSpendLimitForCompare();
   init_classifyFullSubject();
   init_fullCustomerToFullSubject();
   init_fullSubjectToApiUsageLimits();
-  init_planBillingControlUtils();
   init_fullSubjectToCustomerEntitlements();
   init_fullSubjectToOverageAllowed();
   init_fullSubjectToSpendLimit();
   init_fullSubjectToUsageWindowLimits();
   init_mergeCustomerBillingControlsForCheck();
+  init_mergePlanBillingControlsForResponse();
+  init_planBillingControlUtils();
   init_aggregatedUtils();
 });
 // ../../shared/utils/invoices/invoiceLineItems/index.ts

package/dist/src/compose/models/planModels.d.ts

@@ -21,6 +21,7 @@ type SpendLimit = {
     enabled?: boolean;
     limit_type?: "absolute" | "usage_percentage";
     overage_limit?: number;
+    skip_overage_billing?: boolean;
 };
 type UsageLimit = {
     feature_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atmn",
-  "version": "1.1.13",
+  "version": "1.1.15",
   "license": "MIT",
   "bin": {
     "atmn": "dist/cli.js"