atmn 2.0.0 → 2.0.1

package/dist/bin.js

@@ -1081,6 +1081,27 @@ var API_ROUTES = [
       }
     ]
   },
+  {
+    group: "billing",
+    method: "advance_test_clock",
+    path: "/v1/billing.advance_test_clock",
+    description: "Advance a customer's Stripe test clock to a future time in milliseconds. Only Stripe test-mode customers with a test clock are supported. Advancement is asynchronous; Stripe enforces clock status and advancement limits.",
+    body: "object",
+    fields: [
+      {
+        name: "customer_id",
+        type: "string",
+        required: true,
+        description: "The ID of the customer whose Stripe test clock to advance."
+      },
+      {
+        name: "frozen_time",
+        type: "number",
+        required: true,
+        description: "Target time as a Unix timestamp in milliseconds. Rounded down to whole seconds; must be later than the current clock time."
+      }
+    ]
+  },
   {
     group: "billing",
     method: "create_schedule",
@@ -1678,6 +1699,12 @@ var API_ROUTES = [
         required: false,
         description: "List of discounts to apply. Each discount can be an Autumn reward ID, Stripe coupon ID, or Stripe promotion code."
       },
+      {
+        name: "custom_line_items",
+        type: "json",
+        required: false,
+        description: "Custom line items that replace the auto-generated proration invoice, or bill a standalone invoice when nothing else changes. Only valid on an existing recurring subscription."
+      },
       {
         name: "cancel_action",
         type: "string",
@@ -1725,12 +1752,6 @@ var API_ROUTES = [
         type: "json",
         required: false,
         description: "Total seat quantities (inclusive of the license's included count) per license plan offered by this plan. Licenses not listed keep their current paid quantity."
-      },
-      {
-        name: "custom_line_items",
-        type: "json",
-        required: false,
-        description: "Custom line items that replace the auto-generated proration invoice, or bill a standalone invoice when nothing else changes. Only valid on an existing recurring subscription."
       }
     ]
   },
@@ -1813,6 +1834,12 @@ var API_ROUTES = [
         required: false,
         description: "List of discounts to apply. Each discount can be an Autumn reward ID, Stripe coupon ID, or Stripe promotion code."
       },
+      {
+        name: "custom_line_items",
+        type: "json",
+        required: false,
+        description: "Custom line items that replace the auto-generated proration invoice, or bill a standalone invoice when nothing else changes. Only valid on an existing recurring subscription."
+      },
       {
         name: "cancel_action",
         type: "string",
@@ -1860,12 +1887,6 @@ var API_ROUTES = [
         type: "json",
         required: false,
         description: "Total seat quantities (inclusive of the license's included count) per license plan offered by this plan. Licenses not listed keep their current paid quantity."
-      },
-      {
-        name: "custom_line_items",
-        type: "json",
-        required: false,
-        description: "Custom line items that replace the auto-generated proration invoice, or bill a standalone invoice when nothing else changes. Only valid on an existing recurring subscription."
       }
     ]
   },
@@ -2746,6 +2767,74 @@ var API_ROUTES = [
       }
     ]
   },
+  {
+    group: "invoices",
+    method: "create",
+    path: "/v1/invoices.create",
+    description: "Creates a standalone send-invoice Stripe invoice from catalog pricing and custom charges. Quantities are billable units, exclusive of any included usage; Autumn applies billing units and tiers. Nothing about the customer's plans, balances or subscriptions changes. Pass preview: true to get the calculated lines and totals without creating an invoice.",
+    body: "object",
+    fields: [
+      {
+        name: "customer_id",
+        type: "string",
+        required: true,
+        description: "The customer to invoice."
+      },
+      {
+        name: "plans",
+        type: "json",
+        required: false
+      },
+      {
+        name: "custom_line_items",
+        type: "json",
+        required: false,
+        description: "Charges that are not tied to any plan or feature."
+      },
+      {
+        name: "discounts",
+        type: "json",
+        required: false,
+        description: "Discounts applied to the whole invoice."
+      },
+      {
+        name: "invoice_template_id",
+        type: "string",
+        required: false,
+        description: "ID of an invoice template whose footer, memo and default payment terms are applied."
+      },
+      {
+        name: "net_terms_days",
+        type: "number",
+        required: false,
+        description: "Days until the invoice is due. Defaults to the template's terms, then the org default."
+      },
+      {
+        name: "tax_rate_id",
+        type: "string",
+        required: false,
+        description: "Stripe tax rate ID (txr_...) applied to every line."
+      },
+      {
+        name: "period_start",
+        type: "number",
+        required: false,
+        description: "Start of the period being invoiced, in milliseconds. Prorated lines are charged for period_start → period_end against one price interval starting at period_start."
+      },
+      {
+        name: "period_end",
+        type: "number",
+        required: false,
+        description: "End of the period being invoiced, in milliseconds."
+      },
+      {
+        name: "preview",
+        type: "boolean",
+        required: false,
+        description: "If true, returns the calculated lines and totals without creating an invoice."
+      }
+    ]
+  },
   {
     group: "invoices",
     method: "insert",
@@ -2821,6 +2910,54 @@ var API_ROUTES = [
       }
     ]
   },
+  {
+    group: "invoices",
+    method: "reissue",
+    path: "/v1/invoices.reissue",
+    description: "Voids an open send-invoice Stripe invoice and issues a replacement with the same line items. An invoice template can supply the replacement's footer (e.g. bank details) and memo. The replacement keeps the original due date unless net_terms_days is passed, which is required once the original is past due. Pass update_customer_email to change the customer's billing email first so the replacement is sent there. The replacement stays linked to the same subscription and fulfils the same pending plan when paid.",
+    body: "object",
+    fields: [
+      {
+        name: "invoice_id",
+        type: "string",
+        required: true,
+        description: "The Autumn invoice ID to void and replace."
+      },
+      {
+        name: "invoice_template_id",
+        type: "string",
+        required: false,
+        description: "ID of an invoice template (configured in billing settings) whose footer and memo are applied to the replacement invoice."
+      },
+      {
+        name: "net_terms_days",
+        type: "number",
+        required: false,
+        description: "Number of days the customer has to pay the replacement invoice. Defaults to the original invoice's due date; required when that date has already passed."
+      },
+      {
+        name: "update_customer_email",
+        type: "string",
+        required: false,
+        description: "Updates the customer's billing email before the replacement is issued, so Stripe sends the new invoice to this address."
+      }
+    ]
+  },
+  {
+    group: "invoices",
+    method: "void",
+    path: "/v1/invoices.void",
+    description: "Voids an open or uncollectible Stripe invoice. Any plan still waiting on the invoice to be paid expires. Voiding an unpaid subscription invoice lets Stripe re-derive the subscription status from its remaining invoices, which can move a past-due subscription back to active. Already-void invoices are returned unchanged.",
+    body: "object",
+    fields: [
+      {
+        name: "invoice_id",
+        type: "string",
+        required: true,
+        description: "The Autumn invoice ID to void."
+      }
+    ]
+  },
   {
     group: "licenses",
     method: "attach",
@@ -3944,6 +4081,14 @@ var LINT_RULES = {
       }
     ]
   },
+  "plans.items.expiry": {
+    required: ["duration", "length"],
+    fields: {
+      duration: {
+        enum: ["day", "week", "month", "year"]
+      }
+    }
+  },
   "plans.items.featureOverride.creditSchema": {
     variants: {
       on: "tierBehavior",
@@ -4206,6 +4351,14 @@ var LINT_RULES = {
       }
     }
   },
+  "plans.licenses.customize.addItems.expiry": {
+    required: ["duration", "length"],
+    fields: {
+      duration: {
+        enum: ["day", "week", "month", "year"]
+      }
+    }
+  },
   "plans.licenses.customize.addItems.featureOverride.creditSchema": {
     variants: {
       on: "tierBehavior",
@@ -4592,6 +4745,14 @@ var LINT_RULES = {
       }
     }
   },
+  "plans.variants.customize.addItems.expiry": {
+    required: ["duration", "length"],
+    fields: {
+      duration: {
+        enum: ["day", "week", "month", "year"]
+      }
+    }
+  },
   "plans.variants.customize.addItems.featureOverride.creditSchema": {
     variants: {
       on: "tierBehavior",
@@ -4929,6 +5090,14 @@ var LINT_RULES = {
       }
     }
   },
+  "plans.variants.customize.items.expiry": {
+    required: ["duration", "length"],
+    fields: {
+      duration: {
+        enum: ["day", "week", "month", "year"]
+      }
+    }
+  },
   "plans.variants.customize.items.featureOverride.creditSchema": {
     variants: {
       on: "tierBehavior",
@@ -5217,6 +5386,14 @@ var LINT_RULES = {
       }
     }
   },
+  "plans.variants.customize.upsertLicenses.customize.addItems.expiry": {
+    required: ["duration", "length"],
+    fields: {
+      duration: {
+        enum: ["day", "week", "month", "year"]
+      }
+    }
+  },
   "plans.variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema": {
     variants: {
       on: "tierBehavior",
@@ -6610,7 +6787,7 @@ var createClient = (options) => ({
 });
 
 // src/version.ts
-var version = "2.0.0";
+var version = "2.0.1";
 
 // src/http/autumnFetch.ts
 var runtime = typeof Bun !== "undefined" ? `bun ${Bun.version}` : `node ${process.versions.node}`;
@@ -7668,6 +7845,8 @@ var COLLECTIONS = {
       "billingControls.usageLimits.interval",
       "billingControls.usageLimits.limit",
       "freeTrial.durationLength",
+      "items.expiry.duration",
+      "items.expiry.length",
       "items.featureId",
       "items.featureOverride.creditSchema.creditCost",
       "items.featureOverride.creditSchema.dimensions.*.creditCost",
@@ -7694,6 +7873,8 @@ var COLLECTIONS = {
       "items.reset.interval",
       "items.rollover.expiryDurationType",
       "items.thresholdBilling.threshold",
+      "licenses.customize.addItems.expiry.duration",
+      "licenses.customize.addItems.expiry.length",
       "licenses.customize.addItems.featureId",
       "licenses.customize.addItems.featureOverride.creditSchema.creditCost",
       "licenses.customize.addItems.featureOverride.creditSchema.dimensions.*.creditCost",
@@ -7735,6 +7916,8 @@ var COLLECTIONS = {
       "processors.revenuecat.products.featureQuantities.featureId",
       "processors.revenuecat.products.productId",
       "processors.stripe.productId",
+      "variants.customize.addItems.expiry.duration",
+      "variants.customize.addItems.expiry.length",
       "variants.customize.addItems.featureId",
       "variants.customize.addItems.featureOverride.creditSchema.creditCost",
       "variants.customize.addItems.featureOverride.creditSchema.dimensions.*.creditCost",
@@ -7774,6 +7957,8 @@ var COLLECTIONS = {
       "variants.customize.billingControls.usageLimits.interval",
       "variants.customize.billingControls.usageLimits.limit",
       "variants.customize.freeTrial.durationLength",
+      "variants.customize.items.expiry.duration",
+      "variants.customize.items.expiry.length",
       "variants.customize.items.featureId",
       "variants.customize.items.featureOverride.creditSchema.creditCost",
       "variants.customize.items.featureOverride.creditSchema.dimensions.*.creditCost",
@@ -7804,6 +7989,8 @@ var COLLECTIONS = {
       "variants.customize.price.amount",
       "variants.customize.price.interval",
       "variants.customize.removeLicenses.licensePlanId",
+      "variants.customize.upsertLicenses.customize.addItems.expiry.duration",
+      "variants.customize.upsertLicenses.customize.addItems.expiry.length",
       "variants.customize.upsertLicenses.customize.addItems.featureId",
       "variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.creditCost",
       "variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema.dimensions.*.creditCost",
@@ -7897,6 +8084,9 @@ var COLLECTIONS = {
       "internalId",
       "items",
       "items.entityFeatureId",
+      "items.expiry",
+      "items.expiry.duration",
+      "items.expiry.length",
       "items.featureId",
       "items.featureOverride",
       "items.featureOverride.creditSchema",
@@ -7970,6 +8160,9 @@ var COLLECTIONS = {
       "licenses.customize",
       "licenses.customize.addItems",
       "licenses.customize.addItems.entityFeatureId",
+      "licenses.customize.addItems.expiry",
+      "licenses.customize.addItems.expiry.duration",
+      "licenses.customize.addItems.expiry.length",
       "licenses.customize.addItems.featureId",
       "licenses.customize.addItems.featureOverride",
       "licenses.customize.addItems.featureOverride.creditSchema",
@@ -8083,6 +8276,9 @@ var COLLECTIONS = {
       "variants.customize",
       "variants.customize.addItems",
       "variants.customize.addItems.entityFeatureId",
+      "variants.customize.addItems.expiry",
+      "variants.customize.addItems.expiry.duration",
+      "variants.customize.addItems.expiry.length",
       "variants.customize.addItems.featureId",
       "variants.customize.addItems.featureOverride",
       "variants.customize.addItems.featureOverride.creditSchema",
@@ -8194,6 +8390,9 @@ var COLLECTIONS = {
       "variants.customize.freeTrial.onEnd",
       "variants.customize.items",
       "variants.customize.items.entityFeatureId",
+      "variants.customize.items.expiry",
+      "variants.customize.items.expiry.duration",
+      "variants.customize.items.expiry.length",
       "variants.customize.items.featureId",
       "variants.customize.items.featureOverride",
       "variants.customize.items.featureOverride.creditSchema",
@@ -8279,6 +8478,9 @@ var COLLECTIONS = {
       "variants.customize.upsertLicenses.customize",
       "variants.customize.upsertLicenses.customize.addItems",
       "variants.customize.upsertLicenses.customize.addItems.entityFeatureId",
+      "variants.customize.upsertLicenses.customize.addItems.expiry",
+      "variants.customize.upsertLicenses.customize.addItems.expiry.duration",
+      "variants.customize.upsertLicenses.customize.addItems.expiry.length",
       "variants.customize.upsertLicenses.customize.addItems.featureId",
       "variants.customize.upsertLicenses.customize.addItems.featureOverride",
       "variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema",
@@ -8786,16 +8988,16 @@ import { dirname as dirname4, join as join7 } from "node:path";
 import chalk3 from "chalk";
 
 // src/generated/skills.ts
-var SKILLS_VERSION = "2.0.0";
+var SKILLS_VERSION = "2.0.1";
 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.0",
+    version: "2.0.1",
     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.0
+version: 2.0.1
 ---
 
 # Setup
@@ -8953,11 +9155,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.0",
+    version: "2.0.1",
     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.0
+version: 2.0.1
 ---
 
 # Catalog
@@ -12839,11 +13041,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.0",
+    version: "2.0.1",
     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.0
+version: 2.0.1
 ---
 
 # Integrate
@@ -13655,7 +13857,7 @@ pnpm dlx atmn init
 \`\`\`
 </CodeGroup>
 
-This will prompt you to login or create an account, and create an \`autumn.config.ts\` file. Paste in the code below, or view our [config schema](/cli/config) to build your own.
+This asks how you want to connect (sign in, or create a sandbox with no account), then creates an \`autumn/\` folder with an \`autumn.config.ts\` inside. Replace the contents of that file with the code below, or view our [config reference](/cli/config) to build your own.
 
 \`\`\`typescript autumn.config.ts [expandable]
 import { atmn, feature, plan } from "atmn";
@@ -13735,8 +13937,8 @@ pnpm dlx atmn push --yes
 \`\`\`
 </CodeGroup>
 
-  If you already have products created in the dashboard, run \`atmn pull\` to
-  pull them into your local config.
+  If you already have plans created in the dashboard, \`atmn init\` pulls them
+  into your config for you. Run \`atmn pull\` at any time to do it again.
 
 </Step>
 
@@ -16399,7 +16601,21 @@ Auto top-ups are customer-level only because they create invoices and charge a p
 
 ## Plan-Level Defaults
 
-Every billing control can also be defined on a **plan** (in the dashboard under plan settings → billing controls, or via the \`billingControls\` field when creating or updating a plan). Plan-level controls act as defaults for every customer on that plan — set a daily usage limit once on your free tier instead of on each customer.
+Every billing control can also be defined on a **plan** (in the dashboard under plan settings → billing controls, via the \`billingControls\` field when creating or updating a plan, or in the [CLI config](/cli/config#plans) with the same field). Plan-level controls act as defaults for every customer on that plan — set a daily usage limit once on your free tier instead of on each customer.
+
+\`\`\`ts autumn.config.ts
+export const free = plan({
+  planId: "free",
+  versionSlug: "v1",
+  active: true,
+  name: "Free",
+  autoEnable: true,
+  items: [{ featureId: "emails", included: 200, reset: { interval: "month" } }],
+  billingControls: {
+    usageLimits: [{ featureId: "emails", limit: 200, interval: "day" }],
+  },
+});
+\`\`\`
 
 Resolution when a customer is on one or more plans:
 
@@ -17438,11 +17654,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.0",
+    version: "2.0.1",
     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.0
+version: 2.0.1
 ---
 
 # Concepts

package/dist/index.js

@@ -407,6 +407,14 @@ var LINT_RULES = {
       }
     ]
   },
+  "plans.items.expiry": {
+    required: ["duration", "length"],
+    fields: {
+      duration: {
+        enum: ["day", "week", "month", "year"]
+      }
+    }
+  },
   "plans.items.featureOverride.creditSchema": {
     variants: {
       on: "tierBehavior",
@@ -669,6 +677,14 @@ var LINT_RULES = {
       }
     }
   },
+  "plans.licenses.customize.addItems.expiry": {
+    required: ["duration", "length"],
+    fields: {
+      duration: {
+        enum: ["day", "week", "month", "year"]
+      }
+    }
+  },
   "plans.licenses.customize.addItems.featureOverride.creditSchema": {
     variants: {
       on: "tierBehavior",
@@ -1055,6 +1071,14 @@ var LINT_RULES = {
       }
     }
   },
+  "plans.variants.customize.addItems.expiry": {
+    required: ["duration", "length"],
+    fields: {
+      duration: {
+        enum: ["day", "week", "month", "year"]
+      }
+    }
+  },
   "plans.variants.customize.addItems.featureOverride.creditSchema": {
     variants: {
       on: "tierBehavior",
@@ -1392,6 +1416,14 @@ var LINT_RULES = {
       }
     }
   },
+  "plans.variants.customize.items.expiry": {
+    required: ["duration", "length"],
+    fields: {
+      duration: {
+        enum: ["day", "week", "month", "year"]
+      }
+    }
+  },
   "plans.variants.customize.items.featureOverride.creditSchema": {
     variants: {
       on: "tierBehavior",
@@ -1680,6 +1712,14 @@ var LINT_RULES = {
       }
     }
   },
+  "plans.variants.customize.upsertLicenses.customize.addItems.expiry": {
+    required: ["duration", "length"],
+    fields: {
+      duration: {
+        enum: ["day", "week", "month", "year"]
+      }
+    }
+  },
   "plans.variants.customize.upsertLicenses.customize.addItems.featureOverride.creditSchema": {
     variants: {
       on: "tierBehavior",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atmn",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "license": "MIT",
   "description": "The CLI for Autumn — define your pricing in code, sync it to Autumn, and keep everything in version control.",
   "bin": {
@@ -48,5 +48,6 @@
     "jiti": "2.7.0",
     "open": "10.2.0",
     "yaml": "2.9.0"
-  }
+  },
+  "gitHead": "5a548945bb2a7bec37404428767108467915449d"
 }