@crvouga/mockingbird-service-stripe 1.4.0 → 1.4.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog — @crvouga/mockingbird-service-stripe
 
+## 1.4.1 (2026-09-29)
+
+### Fixes and improvements
+
+- report a missing invoice item under param id ([c2a5ede](https://github.com/crvouga/mockingbird/commit/c2a5ede5056a6f64d6df128b3f118759d452bc10))
+- validate search limit before an empty page ([cc755f7](https://github.com/crvouga/mockingbird/commit/cc755f7672b4e652bd40c3b087c1fb504b636d85))
+- refuse both price amounts before reading any other parameter ([e6a6735](https://github.com/crvouga/mockingbird/commit/e6a6735ae8bef0e7f9b40152a6e02056497739dd))
+- leave the portal configuration list out of live parity walks ([f378c9d](https://github.com/crvouga/mockingbird/commit/f378c9d76e36f9fdc86343a4c3eeebf5694eb1a0))
+- pick stripe listen's all-events flag from the installed CLI ([89ad2f4](https://github.com/crvouga/mockingbird/commit/89ad2f414745881f1c1f64445c12b8c70f80072d))
+- pass --events to stripe listen so CLI 1.52 starts ([eeb20b2](https://github.com/crvouga/mockingbird/commit/eeb20b2cce57729d817b00d5f8bd9d0681db0ecb))
+- report the stripe listen output when it exits before ready ([0155f0a](https://github.com/crvouga/mockingbird/commit/0155f0acfb8aed6f1677a29339dbeb4ef0bdaaad))
+- reset the billing cycle anchor on a change to a different billing interval ([314910a](https://github.com/crvouga/mockingbird/commit/314910af7ff36ebd900445e97529740639ada4d2))
+
 ## 1.4.0 (2026-09-29)
 
 ### Features

package/README.md

@@ -199,8 +199,12 @@ now and returns `incomplete` on a decline; `error_if_incomplete` fails the call
 customer, and paying it through Stripe.js activates the subscription. `trial_end`,
 `backdate_start_date` + `billing_cycle_anchor` + `proration_behavior=none` (a $0 first invoice),
 item updates with `always_invoice` (billed now) or `create_prorations` (next invoice), and
-discounts with stable `di_` ids (`discounts=""` clears) are modelled. Items must be active recurring
-prices sharing one currency and interval. `DELETE /v1/subscriptions/:id` takes
+discounts with stable `di_` ids (`discounts=""` clears) are modelled. An item update to a price with
+a different billing period (say monthly → yearly, through the API or the portal's **Update plan**)
+resets `billing_cycle_anchor` to now, starts a new period and invoices it at once (less a
+proration credit for the unused time unless `proration_behavior=none`); a trialing subscription
+keeps its trial end instead. Items must be active recurring prices sharing one currency and
+interval. `DELETE /v1/subscriptions/:id` takes
 `cancellation_details[comment|feedback]`, `prorate` (a credit for the unused time as a pending
 proration) and `invoice_now` (a final invoice; a net credit lands on the customer balance), in the
 query string (as stripe-node sends them) or the body. A $0 invoice is `paid` on
@@ -381,10 +385,13 @@ plus `port`, `host`; resolves `{url, port, runtime, close}`), `serveTarget` (the
   PaymentSheet cannot be redirected (member-app native keeps its fake provider).
 - **Connect** (`Stripe-Account`, application fees, transfers), tax, shipping, Radar, mandates,
   meters, quotes, credit notes, payouts, and non-card payment methods (bank debits, wallets).
+- **Billing cycle anchor resets** other than a price change to a different billing period through
+  `POST /v1/subscriptions/:id`: an explicit `billing_cycle_anchor=now|unchanged` on update is ignored,
+  and the `/v1/subscription_items` endpoints change prices without resetting the period.
 - **Proration arithmetic** is day-fraction approximate (Stripe prorates to the second);
   `auto_advance` drafts are not finalized an hour later.
 - **Customer portal extras**: the login page (`login_page.url` is not served), `schedule_at_period_end`
-  downgrades, `billing_cycle_anchor` resets on plan changes, multi-item subscription updates, locales,
+  downgrades, multi-item subscription updates, locales,
   and payment method configurations. Portal sessions do not expire.
 - **Webhook endpoint `api_version`**: payloads render at the account's version, not per endpoint.
 - **Live keys** (`sk_live_…`) are refused with Stripe's 401: the mock is test mode only.

package/dist/{chunk-P77GCNSW.js → chunk-4YHVIH3S.js}

@@ -1559,7 +1559,7 @@ var restoreNamespace = (sqlite, namespace, snapshot) => {
 };
 
 // ../core/dist/version.js
-var PACKAGE_VERSION = true ? "1.4.0" : UNRELEASED_VERSION;
+var PACKAGE_VERSION = true ? "1.4.1" : UNRELEASED_VERSION;
 
 // ../core/dist/signing.js
 var encoder = new TextEncoder();
@@ -5488,6 +5488,57 @@ var billProration = (scope, subscription, amount, behavior, options) => {
   });
   return void 0;
 };
+var sameBillingPeriod = (a, b) => a.interval === b.interval && a.interval_count === b.interval_count;
+var invoiceBillingCycleReset = (scope, subscription, previous, prorate) => {
+  const period = { start: subscription.current_period_start, end: subscription.current_period_end };
+  const left = Math.max(0, previous.period.end - period.start) / (previous.period.end - previous.period.start || 1);
+  const credits = prorate ? previous.items.map((item) => {
+    const price = requirePrice(scope, item.price);
+    return {
+      ...lineFromPrice(
+        scope,
+        price,
+        item.quantity ?? 1,
+        { start: period.start, end: previous.period.end },
+        {
+          subscription: subscription.id,
+          subscriptionItem: item.id,
+          amount: -Math.round(priceAmount(price, item.quantity ?? 1) * left),
+          description: "Unused time on the previous price (prorated)"
+        }
+      ),
+      proration: true
+    };
+  }) : [];
+  const draft = createDraftInvoice(scope, {
+    customer: subscription.customer,
+    subscription: subscription.id,
+    lines: [
+      ...credits.filter((line) => line.amount !== 0),
+      ...cycleLines(scope, subscription, period)
+    ],
+    billingReason: "subscription_update",
+    discountIds: liveDiscounts(scope, subscription.discount_ids, period.start),
+    period,
+    collectionMethod: subscription.collection_method,
+    daysUntilDue: subscription.days_until_due,
+    subscriptionMetadata: subscription.metadata
+  });
+  claimInvoiceItems(scope, draft);
+  const finalized = finalizeInvoice(scope, draft);
+  creditNegativeInvoice(scope, finalized);
+  const collected = collectCycleInvoice(scope, subscription, finalized);
+  const latest = scope.account.subscriptions.get(subscription.id) ?? subscription;
+  const charged = finalized.status === "open" && !subscription.pause_collection && finalized.collection_method === "charge_automatically";
+  const next = {
+    ...latest,
+    status: charged ? collected.failed ? "past_due" : "active" : latest.status,
+    latest_invoice: collected.invoice.id
+  };
+  saveSubscription(scope, latest, next);
+  if (charged && collected.failed && collected.invoice.attempt_count > 0 && collected.invoice.next_payment_attempt === null)
+    applyFailedPaymentOutcome(scope, next);
+};
 var resumeSubscription = (scope, current, options) => {
   const now = customerNow(scope, current.customer);
   const recurring = recurringOf(scope, current);
@@ -6755,6 +6806,11 @@ var updateSubscription = (scope, current, params) => {
   const previousItems = { items: renderSubscription(current, scope.account).items };
   const proration = stringOf(params, "proration_behavior") ?? "create_prorations";
   const itemRequests = requestedItems(params);
+  const previousBilling = {
+    items: subscriptionItems(scope, current),
+    recurring: recurringOf(scope, current),
+    period: { start: current.current_period_start, end: current.current_period_end }
+  };
   const changed = itemRequests.length === 0 ? { itemIds: current.item_ids, prorationAmount: 0 } : changeItems(scope, current, itemRequests, proration);
   const itemIds = changed.itemIds;
   const prorationAmount = current.status === "trialing" ? 0 : changed.prorationAmount;
@@ -6815,12 +6871,23 @@ var updateSubscription = (scope, current, params) => {
       current_period_end: trialEndAt,
       ...next.status === "active" ? { status: "trialing" } : {}
     };
+  const nextRecurring = recurringOf(scope, next);
+  const resetsAnchor = itemRequests.length > 0 && trialEndAt === void 0 && (current.status === "active" || current.status === "past_due") && !sameBillingPeriod(previousBilling.recurring, nextRecurring);
+  if (resetsAnchor)
+    next = {
+      ...next,
+      billing_cycle_anchor: now,
+      current_period_start: now,
+      current_period_end: addInterval(now, nextRecurring.interval, nextRecurring.interval_count)
+    };
   saveSubscription(scope, current, next, previousItems);
-  billProration(scope, next, prorationAmount, proration, {
-    period: { start: now, end: current.current_period_end },
-    description: proration === "always_invoice" ? "Remaining time on the new price (prorated)" : "Proration for subscription change",
-    failOnDecline: stringOf(params, "payment_behavior") === "error_if_incomplete"
-  });
+  if (resetsAnchor) invoiceBillingCycleReset(scope, next, previousBilling, proration !== "none");
+  else
+    billProration(scope, next, prorationAmount, proration, {
+      period: { start: now, end: current.current_period_end },
+      description: proration === "always_invoice" ? "Remaining time on the new price (prorated)" : "Proration for subscription change",
+      failOnDecline: stringOf(params, "payment_behavior") === "error_if_incomplete"
+    });
   if (endTrialNow) {
     const trialing = scope.account.subscriptions.get(current.id) ?? next;
     const ended = { ...trialing, trial_end: now, current_period_end: now };
@@ -7551,8 +7618,16 @@ var portalChange = (scope, session, config, form) => {
     throw invalidRequest("Choose a different plan or quantity.");
   return { subscription, itemId: item.id, price, quantity };
 };
+var resetsBillingPeriod = (scope, change) => {
+  const { subscription } = change;
+  if (subscription.status === "trialing") return false;
+  const price = scope.account.prices.get(change.price)?.recurring;
+  return price != null && !sameBillingPeriod(recurringOf(scope, subscription), price);
+};
 var previewProration = (scope, config, change) => {
-  if (config.features.subscription_update.proration_behavior === "none") return 0;
+  const prorate = config.features.subscription_update.proration_behavior !== "none";
+  const resets = resetsBillingPeriod(scope, change);
+  if (!prorate && !resets) return 0;
   const { subscription } = change;
   if (subscription.status === "trialing") return 0;
   const item = scope.account.subscriptionItems.get(change.itemId);
@@ -7560,9 +7635,10 @@ var previewProration = (scope, config, change) => {
   const now = customerNow(scope, subscription.customer);
   const span = Math.max(1, subscription.current_period_end - subscription.current_period_start);
   const left = Math.max(0, subscription.current_period_end - now) / span;
-  return Math.round(
-    (amount(change.price, change.quantity) - amount(item?.price ?? change.price, item?.quantity ?? 1)) * left
-  );
+  const next = amount(change.price, change.quantity);
+  const previous = amount(item?.price ?? change.price, item?.quantity ?? 1);
+  if (resets) return next - (prorate ? Math.round(previous * left) : 0);
+  return Math.round((next - previous) * left);
 };
 var runPortalAction = (scope, session, form, card2) => {
   const config = requireConfiguration(scope, session.configuration);
@@ -8442,7 +8518,6 @@ var searchRecords = (records, params, options) => {
   const { query } = params;
   if (params.expand === "") throw parameterInvalidEmpty("expand");
   if (query === "") throw parameterInvalidEmpty("query");
-  if (params.page === "") throw parameterInvalidEmpty("page");
   if (params.limit !== void 0) {
     const limit2 = Number(params.limit);
     if (limit2 < 1 || limit2 > 100)
@@ -8453,7 +8528,7 @@ var searchRecords = (records, params, options) => {
         param: "limit"
       });
   }
-  if (query === "") throw parameterInvalidEmpty("query");
+  if (params.page === "") throw parameterInvalidEmpty("page");
   if (typeof query !== "string" || query.trim() === "")
     throw invalidRequest("Missing required param: query.", "query", "parameter_missing");
   const groups = query.split(/\s+OR\s+/).map(parseSearchQuery);
@@ -8821,7 +8896,18 @@ var priceHandlers = (services) => {
   return {
     PostPrices: async (context) => {
       const scope = requestScope(services, context);
-      const params = bodyParams(context);
+      const params = bodyParams(context, {
+        order: ["unit_amount", "unit_amount_decimal"],
+        validate: {
+          unit_amount_decimal: (given) => {
+            if (given.unit_amount !== void 0 && given.unit_amount_decimal !== void 0)
+              throw invalidRequest(
+                "You may only specify one of these parameters: unit_amount, unit_amount_decimal.",
+                "unit_amount"
+              );
+          }
+        }
+      });
       const hasProduct = params.product !== void 0;
       const hasProductData = params.product_data !== void 0;
       if (hasProduct && hasProductData)
@@ -8840,11 +8926,6 @@ var priceHandlers = (services) => {
       const currency = normalizeCurrency(params.currency);
       const hasAmount = params.unit_amount !== void 0;
       const hasDecimal = params.unit_amount_decimal !== void 0;
-      if (hasAmount && hasDecimal)
-        throw invalidRequest(
-          "You may only specify one of these parameters: unit_amount, unit_amount_decimal.",
-          "unit_amount"
-        );
       if (!hasAmount && !hasDecimal)
         throw invalidRequest(
           "Prices require an `unit_amount` or `unit_amount_decimal` parameter to be set."
@@ -9589,7 +9670,7 @@ var confirmUpdatePage = (context, change) => {
   const due = previewProration(scope, config, change);
   const currency = after?.currency ?? change.subscription.currency;
   const behavior = config.features.subscription_update.proration_behavior;
-  const dueLine = behavior === "always_invoice" ? due < 0 ? `<div class="row total"><span>Credit to your balance</span><span data-testid="stripe-mock-portal-amount-due">\u2212${formatMoney(-due, currency)}</span></div>` : `<div class="row total"><span>Amount due today</span><span data-testid="stripe-mock-portal-amount-due">${formatMoney(due, currency)}</span></div>` : `<div class="row total"><span>Adjustment on your next invoice</span><span data-testid="stripe-mock-portal-amount-due">${due < 0 ? "\u2212" : ""}${formatMoney(Math.abs(due), currency)}</span></div>`;
+  const dueLine = behavior === "always_invoice" || resetsBillingPeriod(scope, change) ? due < 0 ? `<div class="row total"><span>Credit to your balance</span><span data-testid="stripe-mock-portal-amount-due">\u2212${formatMoney(-due, currency)}</span></div>` : `<div class="row total"><span>Amount due today</span><span data-testid="stripe-mock-portal-amount-due">${formatMoney(due, currency)}</span></div>` : `<div class="row total"><span>Adjustment on your next invoice</span><span data-testid="stripe-mock-portal-amount-due">${due < 0 ? "\u2212" : ""}${formatMoney(Math.abs(due), currency)}</span></div>`;
   return `<h1>Confirm your new plan</h1>
 <div class="summary" data-testid="stripe-mock-portal-update-summary">
 <div class="row"><span>Current plan</span><span>${escapeHtml2(productName(context, before))} \xB7 ${escapeHtml2(priceLabel(before, current?.quantity ?? 1))}</span></div>
@@ -11343,7 +11424,7 @@ var requireItem = (scope, id) => {
       status: 404,
       code: "resource_missing",
       message: `No such Invoice Item: '${id}'(livemode=false)`,
-      param: "invoiceitem"
+      param: "id"
     });
   return item;
 };
@@ -17321,4 +17402,4 @@ export {
   createRuntime2 as createRuntime,
   StripeAPI
 };
-//# sourceMappingURL=chunk-P77GCNSW.js.map
+//# sourceMappingURL=chunk-4YHVIH3S.js.map