@crvouga/mockingbird-service-flex 4.0.0 → 4.0.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog — @crvouga/mockingbird-service-flex
 
+## 4.0.1 (2026-10-29)
+
+### Fixes and improvements
+
+- send checkout.session.refunded on a refund, as Flex does ([607eb28](https://github.com/crvouga/mockingbird/commit/607eb289587b2096fa5d9de447ccbeb03ea72563))
+
 ## 4.0.0 (2026-10-29)
 
 ### ⚠️ Breaking changes

package/README.md

@@ -156,10 +156,15 @@ finds the payment through the payment intent.
 | `checkout.session.async_payment_succeeded` | settling a session whose intent was `processing` |
 | `checkout.session.async_payment_failed` | a decline (page, admin, off-session) |
 | `checkout.session.expired` | `…/expire`, or `expires_at` passing on the emulator clock (default 24 h) |
-| `refund.created` (twice), `charge.refunded`, `refund.updated`, `charge.refund.updated` | each refund, through the API or the dashboard (`POST /__admin/sessions/:id/refund`), in the order production delivers a dashboard refund. `checkout.session.refunded` is in Flex's event list but has never been seen on a refund, so it is only sent through `POST /__admin/events` |
+| `checkout.session.refunded` (the session, with every refund in `refunds`), then `refund.created` (twice), `charge.refunded`, `refund.updated`, `charge.refund.updated` | each refund, through the API or the dashboard (`POST /__admin/sessions/:id/refund`). The refund and charge events follow the order production delivers a dashboard refund; each refund's `items` name its payment intent |
 | `product.updated` | `PATCH /v1/products/{id}` and `PUT /__admin/products/:id` |
 | `checkout_session.completed`, `checkout_session.expired` | the aliases, with `PUT /__admin/settings {"eventNaming": "underscored"}` |
 
+An endpoint receives only the event types it subscribes to, as in Flex's dashboard: pass
+`webhooks: {events: [...]}` (default: every type) or `PUT /__admin/webhook-endpoints`. Subscribe
+to what your production endpoint subscribes to, so a test cannot pass on an event production
+never receives.
+
 `POST /__admin/events {type, session | product}` emits any type on demand. Non-2xx answers are
 retried (immediately, 5 s, 5 min, 30 min, 2 h); `GET /__admin/webhooks`, `…/events`,
 `POST /__admin/webhooks/flush`, `…/:id/replay`, `PUT /__admin/webhook-endpoints` as usual.
@@ -227,7 +232,7 @@ so product names are synthesised.
 | Export | Kind | Description |
 | --- | --- | --- |
 | `FlexAPI` | class | The in-process emulator: `fetch(request)`, `reset()`, `settle(id)`, `decline(id)`, `expire(id)`, `requireAction(id, type)`, `setPaymentIntent(id, patch)`, `applyRefund(id, amount)`, `dashboardRefund(id, amount?)`, `putProduct(product)`, `emitFor(type, target)`, `tick()`, `sessions()`, `subscriptions()`, `present(session, view)`. Options: `sqlite`, `now`, `namespace`, `publicNamespace`, `products`, `settings`, `onEvent`. |
-| `createRuntime` | function | The emulator with the full service contract. Options: `webhooks: {url, secret, retryDelaysMs?, fetch?}`, `products`, `settings`, `tickMs`, `clock`, `seed`, `adminKey`, `onLog`. |
+| `createRuntime` | function | The emulator with the full service contract. Options: `webhooks: {url, secret, events?, retryDelaysMs?, fetch?}`, `products`, `settings`, `tickMs`, `clock`, `seed`, `adminKey`, `onLog`. |
 | `FLEX_PRESETS` | object | Every named fault preset. |
 | `FLEX_NAMESPACE` | string | The service name, `"flex"`. |
 | `FLEX_EVENT_TYPES` | array | Every webhook event type, aliases included. |

package/dist/{chunk-3FSLZROR.js → chunk-AGWRBLUO.js}

@@ -4097,7 +4097,7 @@ var stateAdminRoutes = (routes) => {
 };
 
 // ../core/dist/version.js
-var PACKAGE_VERSION = true ? "4.0.0" : UNRELEASED_VERSION;
+var PACKAGE_VERSION = true ? "4.0.1" : UNRELEASED_VERSION;
 
 // ../core/dist/signing.js
 var encoder = new TextEncoder();
@@ -7859,10 +7859,12 @@ var FlexAPI = class {
     const { expiresAtMs: _expires, url, ...rest } = session;
     const customer = session.customer ? view.expandCustomer ? this.state.customers.get(session.customer) ?? session.customer : session.customer : null;
     const intent = session.payment_intent ? view.expandPaymentIntent ? this.state.paymentIntents.get(session.payment_intent) ?? session.payment_intent : session.payment_intent : null;
+    const refunds = this.state.refunds.list().map((row) => row.value).filter((refund) => refund.checkout_session === session.checkout_session_id).map((refund) => this.presentRefund(refund, session.test_mode));
     const out = {
       ...rest,
       customer,
       payment_intent: intent,
+      refunds,
       redirect_url: url,
       url
     };
@@ -7933,9 +7935,11 @@ var FlexAPI = class {
     return this.sessionResponse(context, id);
   }
   /**
-   * Refund part or all of a paid session, emitting the refund events in the order Flex sends
-   * them for a dashboard refund: `refund.created` twice, `charge.refunded`, then
-   * `refund.updated` and `charge.refund.updated`.
+   * Refund part or all of a paid session, emitting the refund events Flex sends:
+   * `checkout.session.refunded` (seen in test mode, carrying the session and its refunds),
+   * then, in the order production delivers a dashboard refund, `refund.created` twice,
+   * `charge.refunded`, `refund.updated` and `charge.refund.updated`. An endpoint receives only
+   * the types it subscribes to.
    */
   applyRefund(id, amount) {
     const session = this.state.sessions.get(id);
@@ -7953,6 +7957,7 @@ var FlexAPI = class {
     this.state.refunds.insert(refund.refund_id, refund);
     const refundObject = this.presentRefund(refund, session.test_mode);
     const chargeObject = this.presentCharge(next, refund.refund_id);
+    this.emitSession("checkout.session.refunded", id);
     this.emit("refund.created", refundObject, session.test_mode);
     this.emit("refund.created", refundObject, session.test_mode);
     this.emit("charge.refunded", chargeObject, session.test_mode);
@@ -7976,12 +7981,22 @@ var FlexAPI = class {
     return { session: this.applyRefund(id, value) };
   }
   presentRefund(refund, testMode) {
+    const intent = refund.payment_intent ? this.state.paymentIntents.get(refund.payment_intent) : void 0;
     return {
       refund_id: refund.refund_id,
       amount: refund.amount,
       status: refund.status,
       payment_intent_id: refund.payment_intent,
-      items: [],
+      items: [
+        {
+          payment_intent: refund.payment_intent,
+          amount_refunded: refund.amount,
+          payment_method_id: intent?.payment_method ?? null,
+          reference_id: null,
+          reference_type: null,
+          reference_status: null
+        }
+      ],
       metadata: null,
       reason: null,
       reference_id: null,
@@ -8441,4 +8456,4 @@ export {
   FlexAPI,
   isNextActionType
 };
-//# sourceMappingURL=chunk-3FSLZROR.js.map
+//# sourceMappingURL=chunk-AGWRBLUO.js.map