atmn 2.0.181 → 2.0.183

package/dist/bin.js

@@ -4987,9 +4987,6 @@ var LINT_RULES = {
   "plans.billingControls.usageAlerts": {
     required: ["threshold", "thresholdType"],
     fields: {
-      threshold: {
-        minimum: 0
-      },
       thresholdType: {
         enum: [
           "usage",
@@ -5982,9 +5979,6 @@ var LINT_RULES = {
   "plans.variants.customize.billingControls.usageAlerts": {
     required: ["threshold", "thresholdType"],
     fields: {
-      threshold: {
-        minimum: 0
-      },
       thresholdType: {
         enum: [
           "usage",
@@ -7964,7 +7958,7 @@ var createClient = (options) => ({
 });
 
 // src/version.ts
-var version = "2.0.181";
+var version = "2.0.183";
 
 // src/http/autumnFetch.ts
 var runtime = typeof Bun !== "undefined" ? `bun ${Bun.version}` : `node ${process.versions.node}`;
@@ -10235,16 +10229,16 @@ import { dirname as dirname4, join as join7 } from "node:path";
 import chalk3 from "chalk";
 
 // src/generated/skills.ts
-var SKILLS_VERSION = "2.0.181";
+var SKILLS_VERSION = "2.0.182";
 var SKILLS = [
   {
     name: "autumn-setup",
     description: "First-time Autumn setup — install the atmn CLI, connect to an org (sign in, or keyless with no account), turn the user's pricing into autumn.config.ts, and push it to a sandbox org. Use when the user is new to Autumn, pastes an Autumn setup prompt, or asks to set up Autumn, add billing, monetization, subscriptions, usage-based billing, pricing, or plans. If Autumn is already set up, use autumn-catalog instead.",
-    version: "2.0.181",
+    version: "2.0.182",
     markdown: `---
 name: autumn-setup
 description: First-time Autumn setup — install the atmn CLI, connect to an org (sign in, or keyless with no account), turn the user's pricing into autumn.config.ts, and push it to a sandbox org. Use when the user is new to Autumn, pastes an Autumn setup prompt, or asks to set up Autumn, add billing, monetization, subscriptions, usage-based billing, pricing, or plans. If Autumn is already set up, use autumn-catalog instead.
-version: 2.0.181
+version: 2.0.182
 ---
 
 # Setup
@@ -10402,11 +10396,11 @@ Then stop. Don't keep building, don't tour the dashboard, don't deploy anything.
   {
     name: "autumn-catalog",
     description: "Modeling a user's pricing into an Autumn catalog — deciding the structure (plans, variants, add-ons, licenses, credit systems, pooled balances) before writing config, then filling in the numbers. Use when the user describes their pricing or asks to model, change, or push a catalog.",
-    version: "2.0.181",
+    version: "2.0.182",
     markdown: `---
 name: autumn-catalog
 description: Modeling a user's pricing into an Autumn catalog — deciding the structure (plans, variants, add-ons, licenses, credit systems, pooled balances) before writing config, then filling in the numbers. Use when the user describes their pricing or asks to model, change, or push a catalog.
-version: 2.0.181
+version: 2.0.182
 ---
 
 # Catalog
@@ -14250,11 +14244,11 @@ Pitch: "Pro $20/mo or $200/yr — 1,000 messages per month either way."
   {
     name: "autumn-integrate",
     description: "Integrating Autumn into an app's backend — creating customers, billing flows (attach, checkout, upgrade, cancel), gating features with check, recording usage with track, and exposing billing data to the frontend. Use when the user asks to integrate Autumn, add billing/payments to their app, gate features, meter usage, or build checkout/upgrade flows. Requires a pushed catalog; use autumn-catalog first if plans don't exist yet.",
-    version: "2.0.181",
+    version: "2.0.182",
     markdown: `---
 name: autumn-integrate
 description: Integrating Autumn into an app's backend — creating customers, billing flows (attach, checkout, upgrade, cancel), gating features with check, recording usage with track, and exposing billing data to the frontend. Use when the user asks to integrate Autumn, add billing/payments to their app, gate features, meter usage, or build checkout/upgrade flows. Requires a pushed catalog; use autumn-catalog first if plans don't exist yet.
-version: 2.0.181
+version: 2.0.182
 ---
 
 # Integrate
@@ -18957,11 +18951,11 @@ Monitor your logs for this message. If you see it, check [status.useautumn.com](
   {
     name: "autumn-concepts",
     description: "Understanding Autumn's billing objects before acting on them — what a plan version is and what active means, when a trial starts or ends billing, how entity- and seat-scoped subscriptions differ from the customer's own, what a customize diff actually changes, and how caps, overage, and top-ups behave. Load before versioning, editing, or drafting a plan, or when a customer's state does not match the plain reading of their plan.",
-    version: "2.0.181",
+    version: "2.0.182",
     markdown: `---
 name: autumn-concepts
 description: Understanding Autumn's billing objects before acting on them — what a plan version is and what active means, when a trial starts or ends billing, how entity- and seat-scoped subscriptions differ from the customer's own, what a customize diff actually changes, and how caps, overage, and top-ups behave. Load before versioning, editing, or drafting a plan, or when a customer's state does not match the plain reading of their plan.
-version: 2.0.181
+version: 2.0.182
 ---
 
 # Concepts
@@ -19199,6 +19193,14 @@ Metered volume variant:
 
 </trial-behavior>
 
+<past-due-behavior>
+
+- \`config.ignore_past_due\` is a plan setting (dashboard: plan settings → "Ignore past due"). When true, customers on the plan keep working while a payment is past due: balances still reset, usage is not blocked, and Stripe does not cancel the subscription.
+- Customers have the same flag on their own \`config\`. When set (true or false), the customer's value wins over every plan they hold; when unset, each plan's value decides.
+- Setting it on the plan covers current and future customers on that plan; setting it per customer covers only that customer.
+
+</past-due-behavior>
+
 <replacement-behavior>
 
 - By default, attaching a plan replaces the customer's current plan in the same group.
@@ -19238,7 +19240,7 @@ Metered volume variant:
       },
       {
         path: "references/trials.md",
-        contents: "### Trials\n\n- A trial gives a customer temporary, free access to a plan. It can be passed in during the billing call, or it can come with the plan configuration itself (which can be overriden).\n- Set a trial with `free_trial` on attach: `{ duration_length, duration_type (day|month|year), card_required, on_end }`. Always pass `duration_type`. \n- Default to card not required (if there is no paid plan), and on_end: revert (if there is a paid plan).\n\nIf the customer the customer is NOT on a paid plan (free plan or no plan at all). 2 options:\n\n- No-card trial (default to this): attach with `free_trial` and set `card_required` false. The subscription starts with no card and ends at trial end if none is added. While on it, the customer cannot upgrade or attach another plan until they add a card via the Stripe billing portal.\n- No-card trials cannot be combined with `invoice_mode` (attach rejects it). If an invoice is needed, use `card_required: true`.\n- Card-required trial: attach with `free_trial` and `card_required: true` and `long_lived_checkout` If the customer has no payment method, the attach returns a checkout URL to collect a card; they are charged when the trial ends. This should be done with a long-lived checkout URL param.\n\nThe customer already has an active (Stripe) subscription — common in sales-led trials.\n\n- On end: revert (default to this): attach the new plan with `on_end: \"revert\"` . This grants the plan in Autumn without touching the Stripe subscription; at trial end Autumn moves the customer back to their original plan, preserving the existing billing cycle.\n- To end a revert trial early, cancel it with `updateSubscription` and `cancel_action: \"cancel_immediately\"`; Autumn restores the previous plan. Do not remove `free_trial` (that converts the trial to paid) or re-attach the old plan.\n- On end: bill -- attaching a plan with a trial (or updating the subscription to add one) resets the Stripe billing anchor/cycle. This can be undesired so warn the user if they request this.\n- Card required param is ignored if there is already an active sub.\n\n\nUpdating or ending a trial\n- Call update_subscription on the trialing plan with the new trial nested under `customize`: `{ customer_id, subscription_id, customize: { free_trial: { duration_length, duration_type, card_required, on_end } } }`. Never put `free_trial` at the top level of an update: the update endpoint rejects a request whose only change is a top-level `free_trial` (\"At least one update parameter must be provided\"), while `customize.free_trial` is accepted. The duration is counted from now, not from the original start. A 14-day extension on day 10 of a 14-day trial gives 14 more days, not 4.\n- For a bill-on-end trial, pass `customize: { free_trial: null }` to end the trial immediately and start paid billing. Never do this for a revert trial: it activates the trial plan at full price instead of restoring the old plan. Cancel a revert trial instead (see above)."
+        contents: '### Trials\n\n- A trial gives a customer temporary, free access to a plan. It can be passed in during the billing call, or it can come with the plan configuration itself (which can be overriden).\n- Set a trial with `free_trial` on attach: `{ duration_length, duration_type (day|month|year), card_required, on_end }`. Always pass `duration_type` and `on_end`; never omit `on_end`, because it silently defaults to `"bill"`.\n- Default to card not required (if there is no paid plan), and on_end: revert (if there is a paid plan).\n- `on_end` must match what you tell the user happens when the trial ends. If you say the customer goes back to their current or previous plan (e.g. "if no card is added, they go back to Hobby"), pass `on_end: "revert"`. Pass `on_end: "bill"` only when the customer should be charged and keep the plan at trial end, and say that.\n\nIf the customer the customer is NOT on a paid plan (free plan or no plan at all). 2 options:\n\n- No-card trial (default to this): attach with `free_trial` and set `card_required` false. The subscription starts with no card and ends at trial end if none is added. While on it, the customer cannot upgrade or attach another plan until they add a card via the Stripe billing portal.\n- No-card trials cannot be combined with `invoice_mode` (attach rejects it). If an invoice is needed, use `card_required: true`.\n- Card-required trial: attach with `free_trial` and `card_required: true` and `long_lived_checkout` If the customer has no payment method, the attach returns a checkout URL to collect a card; they are charged when the trial ends. This should be done with a long-lived checkout URL param.\n\nThe customer already has an active (Stripe) subscription — common in sales-led trials.\n\n- On end: revert (default to this): attach the new plan with `on_end: "revert"` . This grants the plan in Autumn without touching the Stripe subscription; at trial end Autumn moves the customer back to their original plan, preserving the existing billing cycle.\n- To end a revert trial early, cancel it with `updateSubscription` and `cancel_action: "cancel_immediately"`; Autumn restores the previous plan. Do not remove `free_trial` (that converts the trial to paid) or re-attach the old plan.\n- On end: bill -- attaching a plan with a trial (or updating the subscription to add one) resets the Stripe billing anchor/cycle. This can be undesired so warn the user if they request this.\n- Card required param is ignored if there is already an active sub.\n\n\nUpdating or ending a trial\n- Call update_subscription on the trialing plan with the new trial nested under `customize`: `{ customer_id, subscription_id, customize: { free_trial: { duration_length, duration_type, card_required, on_end } } }`. Never put `free_trial` at the top level of an update: the update endpoint rejects a request whose only change is a top-level `free_trial` ("At least one update parameter must be provided"), while `customize.free_trial` is accepted. The duration is counted from now, not from the original start. A 14-day extension on day 10 of a 14-day trial gives 14 more days, not 4.\n- For a bill-on-end trial, pass `customize: { free_trial: null }` to end the trial immediately and start paid billing. Never do this for a revert trial: it activates the trial plan at full price instead of restoring the old plan. Cancel a revert trial instead (see above).'
       },
       {
         path: "references/customer-entity.md",
@@ -19310,6 +19312,7 @@ Metered volume variant:
 <additional>
 
 - Billing controls can change usage behavior after balances are provisioned; see the Billing Controls section in this Concepts resource.
+- \`config.ignore_past_due\` on a customer overrides the same setting on each of their plans; leave it unset to follow the plans. See the past-due section of the Plan concept.
 - Use \`expand\` to pull related details when needed, such as attached plans, features, entities, invoices, payment method, or billing-control runtime state.
 
 </additional>

package/dist/index.js

@@ -349,9 +349,6 @@ var LINT_RULES = {
   "plans.billingControls.usageAlerts": {
     required: ["threshold", "thresholdType"],
     fields: {
-      threshold: {
-        minimum: 0
-      },
       thresholdType: {
         enum: [
           "usage",
@@ -1344,9 +1341,6 @@ var LINT_RULES = {
   "plans.variants.customize.billingControls.usageAlerts": {
     required: ["threshold", "thresholdType"],
     fields: {
-      threshold: {
-        minimum: 0
-      },
       thresholdType: {
         enum: [
           "usage",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atmn",
-  "version": "2.0.181",
+  "version": "2.0.183",
   "license": "MIT",
   "description": "The CLI for Autumn — define your pricing in code, sync it to Autumn, and keep everything in version control.",
   "bin": {
@@ -49,5 +49,5 @@
     "open": "10.2.0",
     "yaml": "2.9.0"
   },
-  "gitHead": "cbe8e91d98816e2e661b3ae99dec513dc529052d"
+  "gitHead": "8917d24cad0980d2da351a5348a0a367f8bf40d4"
 }