@crvouga/mockingbird-service-stripe 3.0.0 → 3.2.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog — @crvouga/mockingbird-service-stripe
 
+## 3.2.0 (2026-10-09)
+
+### Features
+
+- match Emulate provider coverage ([16b65ce](https://github.com/crvouga/mockingbird/commit/16b65ce791fa216f28ec1521df636f57771d9c5e))
+
+### Dependencies
+
+- `@crvouga/mockingbird-service-sqlite`
+
+## 3.1.0 (2026-10-08)
+
+### Features
+
+- redesign emulator experience ([d6038c2](https://github.com/crvouga/mockingbird/commit/d6038c27eebbaa1751f02bc9305002a5b1304779))
+
 ## 3.0.0 (2026-10-07)
 
 ### ⚠️ Breaking changes
@@ -15,10 +31,6 @@
 - format the emulates records query ([8698872](https://github.com/crvouga/mockingbird/commit/8698872509d06002be5a8fcdc85d79f8462320c3))
 - align rename fixtures and formatting ([69e0bee](https://github.com/crvouga/mockingbird/commit/69e0beefe44c9541e46740d3c177bde832340f90))
 
-### Dependencies
-
-- `@crvouga/mockingbird-service-sqlite`
-
 ## 2.3.2 (2026-10-05)
 
 ### Fixes and improvements

package/DISCOVERY.md

@@ -1,7 +1,7 @@
 # @crvouga/mockingbird-service-stripe discovery
 
 This is the installed-package index for coding agents and tooling. All relative links resolve
-inside `node_modules/@crvouga/mockingbird-service-stripe/`; no repository checkout is needed to discover the mock's
+inside `node_modules/@crvouga/mockingbird-service-stripe/`; no repository checkout is needed to discover the emulator's
 supported surface or documented behavior.
 
 ## Capability and behavior sources
@@ -48,7 +48,7 @@ designed for assertions and diagnosis by consuming test suites.
 ## Report a mismatch or missing capability
 
 Follow the [agent reporting contract](https://github.com/crvouga/mockingbird/blob/main/docs/REPORTING_ISSUES.md). Include package version,
-operation/command, a minimal redacted request, actual mock result, expected oracle result or vendor
+operation/command, a minimal redacted request, actual emulator result, expected oracle result or vendor
 documentation, and whether the mismatch appears in the matrix. Never include keys, tokens,
 customer data, prompts, PHI, card data, or unredacted recordings.
 

package/README.md

@@ -1,8 +1,8 @@
 # @crvouga/mockingbird-service-stripe
 
-> Familiar calls. Faithful echoes. Part of [Mockingbird](https://github.com/crvouga/mockingbird).
+> Local emulators. Real API contracts. Part of [Mockingbird](https://github.com/crvouga/mockingbird).
 
-Stateful, in-process mock of the [Stripe API](https://docs.stripe.com/api) for test suites: accounts
+Stateful, in-process emulator of the [Stripe API](https://docs.stripe.com/api) for test suites: accounts
 chosen by API key, customers and balances, payment methods, payment and setup intents, charges,
 refunds, disputes, checkout (with a hosted page and a Stripe.js stand-in), the customer portal
 (configurations, sessions and the hosted portal page), invoices, subscriptions that renew, pause,
@@ -81,8 +81,8 @@ stripe-node accepts `host`, `port` and `protocol`; route every `new Stripe(...)`
 factory reading `STRIPE_API_HOST` / `STRIPE_API_PORT` / `STRIPE_API_PROTOCOL` (the catalog's G-S1),
 and give raw `fetch('https://api.stripe.com…')` call sites the same base URL. Keys must look like
 test keys (`sk_test_…`, `rk_test_…`; `pk_test_…` for the Stripe.js stand-in). Point the browser at
-the mock's `GET /v3` instead of `https://js.stripe.com/v3` (G-S3); `session.url` already points at
-the mock's hosted page.
+the emulator's `GET /v3` instead of `https://js.stripe.com/v3` (G-S3); `session.url` already points at
+the emulator's hosted page.
 
 ### Accounts and namespaces
 
@@ -118,7 +118,7 @@ invoice (or `latest_invoice.payments` on a subscription), `GET /v1/invoice_payme
 `GET /v1/invoice_payments/{id}`. One default payment per invoice that has a PaymentIntent, derived from
 the invoice; a $0 invoice has none, and payment records are not modelled. `charge.refunds` appears only with `expand[]=refunds` at
 every one of these versions. `GET /v1/invoices/upcoming` answers at the older versions and returns
-Stripe's "deprecated" 404 at basil and later. Expansion is generic (any path through ids the mock
+Stripe's "deprecated" 404 at basil and later. Expansion is generic (any path through ids the emulator
 holds, ancestors included); Stripe's own rules are enforced: a non-expandable first segment is
 `This property cannot be expanded (metadata).` and more than four levels is
 `property_expansion_max_depth` (verified against test mode at all three versions).
@@ -160,8 +160,8 @@ Events emitted: `customer.*`, `payment_method.attached|detached|updated`,
 
 ### Lifecycles and the clock
 
-`POST /__admin/clock {"advance": "32d"}` (or `set`) moves the mock clock and immediately runs every
-clock-driven lifecycle, so their webhooks fire at once; the served mock also ticks every second.
+`POST /__admin/clock {"advance": "32d"}` (or `set`) moves the emulator clock and immediately runs every
+clock-driven lifecycle, so their webhooks fire at once; the served emulator also ticks every second.
 
 - **Renewals**: past `current_period_end` a subscription cycles — a `subscription_cycle` invoice is
   finalized and charged off-session to the default payment method, then `invoice.paid` +
@@ -268,7 +268,7 @@ payment methods; anything else is Stripe's 401.
 
 ### Customer portal
 
-`POST /v1/billing_portal/sessions` returns a `url` on the mock (`/p/session/:id`, in place of
+`POST /v1/billing_portal/sessions` returns a `url` on the emulator (`/p/session/:id`, in place of
 billing.stripe.com) where the customer manages their billing, as the session's configuration allows:
 
 - **Configurations**: `POST|GET /v1/billing_portal/configurations[/:id]`
@@ -363,7 +363,7 @@ recorded prices (listed in `synthesizedLookupKeys`). Pass your own with `createR
 
 | Export | Description |
 | --- | --- |
-| `createRuntime` | `(options?) => StripeRuntime` — the mock with the full contract. Options: `accounts`, `webhooks {endpoints, retryDelaysMs, fetch}`, `corpus`, `publicUrl`, `webhookApiVersion`, `lifecycle`, `tickMs`, `sqlite`, `clock`, `seed`, `adminKey`, `onLog`, `onWebhook`. The runtime adds `webhooks`, `accounts`, `tick()`, `stop()`. |
+| `createRuntime` | `(options?) => StripeRuntime` — the emulator with the full contract. Options: `accounts`, `webhooks {endpoints, retryDelaysMs, fetch}`, `corpus`, `publicUrl`, `webhookApiVersion`, `lifecycle`, `tickMs`, `sqlite`, `clock`, `seed`, `adminKey`, `onLog`, `onWebhook`. The runtime adds `webhooks`, `accounts`, `tick()`, `stop()`. |
 | `StripeAPI` | Class; `new StripeAPI(options?)` implements `fetch(request)`. Members: `reset()`, `tick(force?)`, `webhookEvents(account?)`, `webhookDeliveryAttempts(account?)`, `apiWebhookEndpoints()`, `accountIds()`, `scopeFor(account)`, `importStateFrom(source)`, `accounts`, `app`, `sqlite`. |
 | `STRIPE_PRESETS` | The named fault presets above. |
 | `AccountDirectory` | Keys → accounts (`configure`, `accountFor`, `config`, `list`, `resolve`). |
@@ -380,7 +380,7 @@ recorded prices (listed in `synthesizedLookupKeys`). Pass your own with `createR
 | `STRIPE_NAMESPACE` | `"stripe"` — SQLite namespace of every record. |
 | `document` | The vendored OpenAPI document (Mockingbird subset). |
 | `operationIds` | Every `operationId` in `document`. |
-| `supportedOperationIds` | The ones the mock implements. |
+| `supportedOperationIds` | The ones the emulator implements. |
 | `QA_SURFACE_OPS` | Operations the parity walks cover (supported, minus the browser pages). |
 | `QA_METADATA` | Pinned metadata values the parity walks send. |
 | `QA_AMOUNTS` | Pinned amounts in cents. |
@@ -415,7 +415,7 @@ plus `port`, `host`; resolves `{url, port, runtime, close}`), `serveTarget` (the
   `tiers` and `custom_unit_amount`, and subscription-mode sessions in a non-default currency, are
   refused with a 400; subscriptions and invoices always bill in the price's own currency.
 - **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.
+- **Live keys** (`sk_live_…`) are refused with Stripe's 401: the emulator is test mode only.
 - Operations marked unsupported in SUPPORT.md (charge create/update, checkout session update,
   dispute evidence).
 - Rate-limit, 5xx and permission bodies come from presets, worded as Stripe words them but not

package/SUPPORT.md

@@ -2,17 +2,18 @@
 
 Generated from `openapi.yaml`; do not edit by hand.
 
-- operations in spec: **125**
-- supported by the mock: **121**
+- operations in spec: **126**
+- supported by the emulator: **122**
 - parity enabled: **114**
 
-| operationId | route | mock | parity | notes |
+| operationId | route | emulator | parity | notes |
 | --- | --- | --- | --- | --- |
+| `PostCustomerSessions` | `POST /v1/customer_sessions` | ✅ supported | ❌ disabled | Covered by the pinned package oracle; no independent live evidence yet. |
 | `PostThreeDSecureAuthenticate` | `POST /c/3ds/{intent}/authenticate` | ✅ supported | ❌ disabled | the 3-D Secure challenge the Stripe.js stand-in completes has no public API |
-| `GetCheckoutPage` | `GET /c/pay/{session}` | ✅ supported | ❌ disabled | the hosted Checkout page is HTML served by the mock in place of checkout.stripe.com |
-| `PostCheckoutPage` | `POST /c/pay/{session}` | ✅ supported | ❌ disabled | the hosted Checkout page form post is served by the mock in place of checkout.stripe.com |
-| `GetPortalPage` | `GET /p/session/{session}` | ✅ supported | ❌ disabled | the customer portal is HTML served by the mock in place of billing.stripe.com |
-| `PostPortalPage` | `POST /p/session/{session}` | ✅ supported | ❌ disabled | the customer portal form post is served by the mock in place of billing.stripe.com |
+| `GetCheckoutPage` | `GET /c/pay/{session}` | ✅ supported | ❌ disabled | the hosted Checkout page is HTML served by the emulator in place of checkout.stripe.com |
+| `PostCheckoutPage` | `POST /c/pay/{session}` | ✅ supported | ❌ disabled | the hosted Checkout page form post is served by the emulator in place of checkout.stripe.com |
+| `GetPortalPage` | `GET /p/session/{session}` | ✅ supported | ❌ disabled | the customer portal is HTML served by the emulator in place of billing.stripe.com |
+| `PostPortalPage` | `POST /p/session/{session}` | ✅ supported | ❌ disabled | the customer portal form post is served by the emulator in place of billing.stripe.com |
 | `GetAccount` | `GET /v1/account` | ✅ supported | ✅ |  |
 | `GetBalance` | `GET /v1/balance` | ✅ supported | ✅ |  |
 | `GetBalanceTransactions` | `GET /v1/balance_transactions` | ✅ supported | ✅ |  |
@@ -47,7 +48,7 @@ Generated from `openapi.yaml`; do not edit by hand.
 | `GetCustomersSearch` | `GET /v1/customers/search` | ✅ supported | ✅ |  |
 | `GetDisputes` | `GET /v1/disputes` | ✅ supported | ✅ |  |
 | `GetDisputesDispute` | `GET /v1/disputes/{dispute}` | ✅ supported | ✅ |  |
-| `PostDisputesDispute` | `POST /v1/disputes/{dispute}` | ❌ unsupported | — | the mock never creates or mutates disputes |
+| `PostDisputesDispute` | `POST /v1/disputes/{dispute}` | ❌ unsupported | — | the emulator never creates or mutates disputes |
 | `GetEvents` | `GET /v1/events` | ✅ supported | ✅ |  |
 | `GetEventsId` | `GET /v1/events/{id}` | ✅ supported | ✅ |  |
 | `GetInvoicePayments` | `GET /v1/invoice_payments` | ✅ supported | ✅ |  |
@@ -132,4 +133,4 @@ Generated from `openapi.yaml`; do not edit by hand.
 | `GetWebhookEndpointsWebhookEndpoint` | `GET /v1/webhook_endpoints/{webhook_endpoint}` | ✅ supported | ✅ |  |
 | `PostWebhookEndpointsWebhookEndpoint` | `POST /v1/webhook_endpoints/{webhook_endpoint}` | ✅ supported | ⚠️ unsafe (opt-in) |  |
 | `DeleteWebhookEndpointsWebhookEndpoint` | `DELETE /v1/webhook_endpoints/{webhook_endpoint}` | ✅ supported | ⚠️ unsafe (opt-in) |  |
-| `GetStripeJs` | `GET /v3` | ✅ supported | ❌ disabled | the Stripe.js stand-in is JavaScript served by the mock in place of js.stripe.com/v3 |
+| `GetStripeJs` | `GET /v3` | ✅ supported | ❌ disabled | the Stripe.js stand-in is JavaScript served by the emulator in place of js.stripe.com/v3 |