atmn 2.0.41 → 2.0.43

package/src/generated/apiRoutes.ts

@@ -955,7 +955,7 @@ export const API_ROUTES: readonly ApiRoute[] = [
 				type: "string",
 				required: false,
 				description:
-					"How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.",
+					"How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges, 'bill_difference' charges/credits the full-period price difference now without changing the billing cycle.",
 			},
 			{
 				name: "redirect_mode",
@@ -1190,7 +1190,7 @@ export const API_ROUTES: readonly ApiRoute[] = [
 				type: "string",
 				required: false,
 				description:
-					"Whether to prorate the immediate phase. 'none' skips proration charges and credits.",
+					"Whether to prorate the immediate phase. 'none' skips proration charges and credits, 'bill_difference' charges/credits the full-period price difference.",
 			},
 			{
 				name: "no_billing_changes",
@@ -1300,7 +1300,7 @@ export const API_ROUTES: readonly ApiRoute[] = [
 				type: "string",
 				required: false,
 				description:
-					"How to handle billing. 'prorate_immediately' charges/credits prorated amounts now, 'none' does not charge/credit anything.",
+					"How to handle billing. 'prorate_immediately' charges/credits prorated amounts now, 'none' does not charge/credit anything, 'bill_difference' charges/credits the full-period price difference now without changing the billing cycle.",
 			},
 			{
 				name: "billing_cycle_anchor",
@@ -1420,7 +1420,7 @@ export const API_ROUTES: readonly ApiRoute[] = [
 				type: "string",
 				required: false,
 				description:
-					"How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.",
+					"How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges, 'bill_difference' charges/credits the full-period price difference now without changing the billing cycle.",
 			},
 			{
 				name: "redirect_mode",
@@ -1648,7 +1648,7 @@ export const API_ROUTES: readonly ApiRoute[] = [
 				type: "string",
 				required: false,
 				description:
-					"How to handle billing. 'prorate_immediately' charges/credits prorated amounts now, 'none' does not charge/credit anything.",
+					"How to handle billing. 'prorate_immediately' charges/credits prorated amounts now, 'none' does not charge/credit anything, 'bill_difference' charges/credits the full-period price difference now without changing the billing cycle.",
 			},
 			{
 				name: "billing_cycle_anchor",
@@ -1769,7 +1769,7 @@ export const API_ROUTES: readonly ApiRoute[] = [
 				type: "string",
 				required: false,
 				description:
-					"How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.",
+					"How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges, 'bill_difference' charges/credits the full-period price difference now without changing the billing cycle.",
 			},
 			{
 				name: "redirect_mode",
@@ -1929,7 +1929,7 @@ export const API_ROUTES: readonly ApiRoute[] = [
 				type: "string",
 				required: false,
 				description:
-					"How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.",
+					"How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges, 'bill_difference' charges/credits the full-period price difference now without changing the billing cycle.",
 			},
 			{
 				name: "redirect_mode",
@@ -2198,7 +2198,7 @@ export const API_ROUTES: readonly ApiRoute[] = [
 				type: "string",
 				required: false,
 				description:
-					"How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges.",
+					"How to handle proration when updating an existing subscription. 'prorate_immediately' charges/credits prorated amounts now, 'none' skips creating any charges, 'bill_difference' charges/credits the full-period price difference now without changing the billing cycle.",
 			},
 			{
 				name: "subscription_id",
@@ -2332,6 +2332,37 @@ export const API_ROUTES: readonly ApiRoute[] = [
 			},
 		],
 	},
+	{
+		group: "billing",
+		method: "verify",
+		path: "/v1/billing.verify",
+		description:
+			"Checks a customer's Stripe subscriptions against Autumn's record of their plans and reports any drift. Read-only: it never changes Autumn or Stripe.",
+		body: "object",
+		fields: [
+			{
+				name: "customer_id",
+				type: "string",
+				required: true,
+				description:
+					"Autumn customer whose Stripe subscriptions should be checked against Autumn's customer_products.",
+			},
+			{
+				name: "subscription_ids",
+				type: "json",
+				required: false,
+				description:
+					"Optional whitelist of Stripe subscription IDs to verify. Defaults to every subscription linked to the customer's plans, plus any other active Stripe subscription on the customer, which is reported as not linked to Autumn.",
+			},
+			{
+				name: "strict",
+				type: "boolean",
+				required: false,
+				description:
+					"When true, report missing usage-based items and unexpected metered Stripe items. Defaults to false.",
+			},
+		],
+	},
 	{
 		group: "billing",
 		method: "import",
@@ -2873,7 +2904,7 @@ export const API_ROUTES: readonly ApiRoute[] = [
 		method: "batch_track",
 		path: "/v1/balances.batch_track",
 		description:
-			"Enqueue up to 1000 usage events for asynchronous processing. Items are validated synchronously up front; validated items are then enqueued via SQS for background deduction by workers. The response returns 202 immediately and does not include balance information. On partial enqueue failure (some items fail to enqueue, others succeed), the endpoint still returns 202 and logs the failures server-side; clients should NOT retry, because retrying re-enqueues the already-succeeded items. A 503 is returned only when zero items were successfully enqueued (queue entirely unavailable) — that case is safe to retry.",
+			"Enqueue up to 1000 usage events for asynchronous processing. Items are validated synchronously up front; validated items are then enqueued via SQS for background deduction by workers. The response returns 200 (or 202) immediately and does not include balance information. On partial enqueue failure (some items fail to enqueue, others succeed), the endpoint still returns 200 (or 202) and logs the failures server-side; clients should NOT retry, because retrying re-enqueues the already-succeeded items. A 503 is returned only when zero items were successfully enqueued (queue entirely unavailable) — that case is safe to retry.",
 		body: "array",
 		fields: [],
 	},
@@ -4140,9 +4171,9 @@ export const API_ROUTES: readonly ApiRoute[] = [
 			{
 				name: "events",
 				type: "json",
-				required: true,
+				required: false,
 				description:
-					"The events sent to this webhook. At least one. `vercel.*` events can't be mixed with other events.",
+					"The events sent to this webhook. Leave it out to send every event. `vercel.*` events can't be mixed with other events.",
 			},
 			{
 				name: "description",
@@ -4211,7 +4242,7 @@ export const API_ROUTES: readonly ApiRoute[] = [
 				type: "json",
 				required: false,
 				description:
-					"The events sent to this webhook. At least one. `vercel.*` events can't be mixed with other events.",
+					"The events sent to this webhook. Pass `[]` to send every event; omit it to keep the current list. `vercel.*` events can't be mixed with other events.",
 			},
 			{
 				name: "description",

package/src/generated/client.ts

@@ -97,8 +97,8 @@ webhooks: Array<{
 id: string;
 /** The https URL Autumn sends events to. Localhost and private-network addresses are rejected; tunnels such as ngrok work. */
 url: string;
-/** The events sent to this webhook. At least one. `vercel.*` events can't be mixed with other events. */
-events: Array<"customer.products.updated" | "customer.threshold_reached" | "balances.usage_alert_triggered" | "balances.limit_reached" | "billing.auto_topup_failed" | "billing.auto_topup_succeeded" | "billing.updated" | "invoice.finalized" | "vercel.resources.deleted" | "vercel.resources.provisioned" | "vercel.resources.rotate_secrets" | "vercel.webhooks.event">;
+/** The events sent to this webhook. Leave it out to send every event. `vercel.*` events can't be mixed with other events. Defaults to []. */
+events?: Array<"customer.products.updated" | "customer.threshold_reached" | "balances.usage_alert_triggered" | "balances.limit_reached" | "billing.auto_topup_failed" | "billing.auto_topup_succeeded" | "billing.updated" | "invoice.finalized" | "vercel.resources.deleted" | "vercel.resources.provisioned" | "vercel.resources.rotate_secrets" | "vercel.webhooks.event">;
 /** A note for your own reference. */
 description?: string;
 /** When true, no events are sent to the webhook. */
@@ -52515,7 +52515,7 @@ id: string;
 url: string;
 /** A note for your own reference. */
 description: string | null;
-/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty only for a webhook made in the dashboard that receives every event. */
+/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty means the webhook receives every event. */
 events: Array<string>;
 /** When true, no events are sent to the webhook. */
 disabled: boolean;
@@ -52537,7 +52537,7 @@ id: string;
 url: string;
 /** A note for your own reference. */
 description: string | null;
-/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty only for a webhook made in the dashboard that receives every event. */
+/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty means the webhook receives every event. */
 events: Array<string>;
 /** When true, no events are sent to the webhook. */
 disabled: boolean;
@@ -52556,7 +52556,7 @@ id: string;
 url: string;
 /** A note for your own reference. */
 description: string | null;
-/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty only for a webhook made in the dashboard that receives every event. */
+/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty means the webhook receives every event. */
 events: Array<string>;
 /** When true, no events are sent to the webhook. */
 disabled: boolean;
@@ -52572,7 +52572,7 @@ id: string;
 url: string;
 /** A note for your own reference. */
 description: string | null;
-/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty only for a webhook made in the dashboard that receives every event. */
+/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty means the webhook receives every event. */
 events: Array<string>;
 /** When true, no events are sent to the webhook. */
 disabled: boolean;
@@ -52591,7 +52591,7 @@ id: string;
 url: string;
 /** A note for your own reference. */
 description: string | null;
-/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty only for a webhook made in the dashboard that receives every event. */
+/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty means the webhook receives every event. */
 events: Array<string>;
 /** When true, no events are sent to the webhook. */
 disabled: boolean;
@@ -52607,7 +52607,7 @@ id: string;
 url: string;
 /** A note for your own reference. */
 description: string | null;
-/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty only for a webhook made in the dashboard that receives every event. */
+/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty means the webhook receives every event. */
 events: Array<string>;
 /** When true, no events are sent to the webhook. */
 disabled: boolean;
@@ -52626,7 +52626,7 @@ id: string;
 url: string;
 /** A note for your own reference. */
 description: string | null;
-/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty only for a webhook made in the dashboard that receives every event. */
+/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty means the webhook receives every event. */
 events: Array<string>;
 /** When true, no events are sent to the webhook. */
 disabled: boolean;
@@ -52651,7 +52651,7 @@ id: string;
 url: string;
 /** A note for your own reference. */
 description: string | null;
-/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty only for a webhook made in the dashboard that receives every event. */
+/** The events sent to this webhook, as `WebhookEventType` names; a type newer than your client is returned as-is. Empty means the webhook receives every event. */
 events: Array<string>;
 /** When true, no events are sent to the webhook. */
 disabled: boolean;

package/src/generated/emit.ts

@@ -1216,11 +1216,11 @@ export const SYNCED_LISTS: Readonly<Record<string, SyncedListSpec>> = {
 		builder: "webhook",
 		idField: "id",
 		responseIdField: "id",
-		keys: ["id", "url", "events", "description", "disabled"],
-		required: ["events", "id", "url"],
-		paths: ["description", "disabled", "events", "id", "url"],
+		keys: ["id", "env", "url", "events", "description", "disabled"],
+		required: ["env", "id", "url"],
+		paths: ["description", "disabled", "env", "events", "id", "url"],
 		pull: true,
-		envKeyed: ["url"],
+		envField: "env",
 	},
 };
 

package/src/generated/emitRuntime.ts

@@ -94,11 +94,11 @@ export const branchSpecs = ({
 	spec.branches?.map((branch) => branchSpecOf({ spec, branch })) ?? [spec];
 
 /** A list keyed by id outside the catalog: emitted like a collection item,
- * with fields a config states once per environment. */
+ * one entry per environment. */
 export type SyncedListSpec = CollectionSpec & {
 	readonly wireKey: string;
-	/** Fixture fields holding `{ live?, sandbox?, [sandboxSlug]? }` maps. */
-	readonly envKeyed: readonly string[];
+	/** The fixture field naming the entry's environment. */
+	readonly envField: string;
 };
 
 export type SingletonSpec = {

package/src/generated/lintRules.ts

@@ -2206,30 +2206,41 @@ export const LINT_RULES: LintRules = {
 	webhooks: {
 		label: "webhook",
 		idField: "id",
-		required: ["events", "id", "url"],
+		required: ["env", "id", "url"],
 		fields: {
 			id: {
 				minLength: 1,
 				maxLength: 256,
 				pattern: "^[a-zA-Z0-9_-]+$",
 			},
-			events: {
-				minItems: 1,
+			env: {
+				pattern: "^[a-z0-9_-]+$",
+			},
+			url: {
+				pattern: "^[Hh][Tt][Tt][Pp][Ss]:\\/\\/",
 			},
 		},
 		rules: [
+			{
+				kind: "notMap",
+				field: "url",
+				because:
+					'Each webhook() is one endpoint in one env: split into one webhook() per env, e.g. webhook({ id, env: "live", url }).',
+			},
 			{
 				kind: "unique",
 				field: "id",
+				alongside: "env",
 				because:
-					"Two webhooks claiming one id race to define the same endpoint.",
+					"Two webhooks claiming one id in one env race to define the same endpoint.",
 			},
 			{
 				kind: "unique",
 				field: "id",
+				alongside: "env",
 				asEnvName: true,
 				because:
-					"Each webhook's signing secret is saved as AUTUMN_WEBHOOK_<ID>_SECRET, so these two would overwrite each other's secret. Rename one.",
+					"Each webhook's signing secret is saved under its id in an env var name, so these two would overwrite each other's secret. Rename one.",
 			},
 			{
 				kind: "rejects",
@@ -2245,13 +2256,6 @@ export const LINT_RULES: LintRules = {
 				because:
 					"vercel.* events can't be mixed with other events in one webhook: they're delivered from a separate app. Make one webhook for each.",
 			},
-			{
-				kind: "nonEmpty",
-				field: "url",
-				warning: true,
-				because:
-					"With no environment key the webhook is registered nowhere. Add `live`, `sandbox` or a sandbox's slug.",
-			},
 			{
 				kind: "knownValues",
 				field: "events",
@@ -2274,12 +2278,4 @@ export const LINT_RULES: LintRules = {
 			},
 		],
 	},
-	"webhooks.url": {
-		keys: {
-			pattern: "^[a-z0-9_-]+$",
-		},
-		values: {
-			pattern: "^[Hh][Tt][Tt][Pp][Ss]:\\/\\/",
-		},
-	},
 };

package/src/generated/lintRuntime.ts

@@ -131,6 +131,12 @@ export type LintRule =
 			readonly warning?: true;
 			readonly because: string;
 	  }
+	| {
+			/** A stated `field` must be a plain value, never an object map. */
+			readonly kind: "notMap";
+			readonly field: string;
+			readonly because: string;
+	  }
 	| {
 			/** List `field` holds names starting with `prefix` only, or none of them. */
 			readonly kind: "uniformPrefix";
@@ -538,6 +544,10 @@ const entryRuleFailures = ({
 				)
 				.map((item) => `\`${item}\` ${rule.because}`);
 		}
+		case "notMap": {
+			const value = entry[rule.field];
+			return isEntry(value) ? [`${rule.field} is a map. ${rule.because}`] : [];
+		}
 		case "uniformPrefix": {
 			const value = entry[rule.field];
 			if (!Array.isArray(value)) return [];