@crvouga/mockingbird-service-odx 3.0.0 → 3.2.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog — @crvouga/mockingbird-service-odx
 
+## 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
@@ -14,10 +30,6 @@
 - typecheck the brand gate before builds ([fc36095](https://github.com/crvouga/mockingbird/commit/fc3609514de70ffe3170a5d216fb8a49f9ce7cbb))
 - format the emulates records query ([8698872](https://github.com/crvouga/mockingbird/commit/8698872509d06002be5a8fcdc85d79f8462320c3))
 
-### Dependencies
-
-- `@crvouga/mockingbird-service-sqlite`
-
 ## 2.3.0 (2026-10-04)
 
 ### Features

package/DISCOVERY.md

@@ -1,7 +1,7 @@
 # @crvouga/mockingbird-service-odx discovery
 
 This is the installed-package index for coding agents and tooling. All relative links resolve
-inside `node_modules/@crvouga/mockingbird-service-odx/`; no repository checkout is needed to discover the mock's
+inside `node_modules/@crvouga/mockingbird-service-odx/`; 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,16 +1,16 @@
 # @crvouga/mockingbird-service-odx
 
-> 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 mock of the **Optimal DX (ODX)** partner API for test suites: partner labs and their
+Stateful emulator of the **Optimal DX (ODX)** partner API for test suites: partner labs and their
 biomarker elements, practice patients (create, update, delete, partner link, search), lab
 imports (HL7 v2 ORU and structured results), the Functional Health Report (JSON or PDF),
 webhook registrations, and the signed `PatientTest` webhooks ODX posts back.
 
 > **The vendor was retired 2026-07-22.** Our queue paths are gated only by the
 > `acme-pdf-enabled` flag (default `false`), so a local stack with no PostHog still calls ODX.
-> The cheaper fix is to turn that flag on through the PostHog mock
-> (`@crvouga/mockingbird-service-posthog`); use this mock when a suite must exercise the ODX
+> The cheaper fix is to turn that flag on through the PostHog emulator
+> (`@crvouga/mockingbird-service-posthog`); use this emulator when a suite must exercise the ODX
 > path itself (bio-age webhooks, the Healthie PDF upload, migrations).
 
 - Operation coverage: [SUPPORT.md](https://github.com/crvouga/mockingbird/blob/main/packages/service/odx/SUPPORT.md)
@@ -31,7 +31,7 @@ Fetch server.
 
 The real base URL is `https://odxinstanceresource.azure-api.net/<partner>`; the partner segment is
 your account's slug.
-Point `OPTIMAL_URL` at the mock (it is overridable; no path prefix is needed), keep any
+Point `OPTIMAL_URL` at the emulator (it is overridable; no path prefix is needed), keep any
 `OPTIMAL_API_KEY` and `OPTIMAL_PRACTICE_ID`. Pre-register the backend's webhook, or let
 `manageWebhooks` register it through `POST /v1/webhook` as it does in production:
 
@@ -56,7 +56,7 @@ const call = (path: string, body?: unknown) =>
 const patient = await (
   await call("/v1/practice/p1/patient", { firstName: "Ada", lastName: "Lovelace", gender: "Female", email: "ada@example.com" })
 ).json()
-// …the app posts HL7 to /v1/practice/p1/patient/{patientId}/test; the mock answers the parsed
+// …the app posts HL7 to /v1/practice/p1/patient/{patientId}/test; the emulator answers the parsed
 // PatientTest and posts a signed `Created` webhook to /odx/webhook.
 ```
 
@@ -133,8 +133,8 @@ Fault presets (`POST /__admin/faults {"preset": "<name>", "count"?: n}`): `wrong
 
 | Export | Kind | Description |
 | --- | --- | --- |
-| `OdxAPI` | class | The in-process mock: `fetch(request)`, `reset()`, `emit(testId, eventType, signature?)`, `patients()`, `tests()`. Options: `sqlite`, `now`, `namespace`, `settings`, `onWebhook`. |
-| `createRuntime` | function | The mock with the full service contract. Options: `webhook: {url, signingKey?}`, `settings`, `retryDelaysMs`, `fetch`, `clock`, `seed`, `adminKey`, `onLog`. |
+| `OdxAPI` | class | The in-process emulator: `fetch(request)`, `reset()`, `emit(testId, eventType, signature?)`, `patients()`, `tests()`. Options: `sqlite`, `now`, `namespace`, `settings`, `onWebhook`. |
+| `createRuntime` | function | The emulator with the full service contract. Options: `webhook: {url, signingKey?}`, `settings`, `retryDelaysMs`, `fetch`, `clock`, `seed`, `adminKey`, `onLog`. |
 | `ODX_PRESETS` | object | Every named fault preset. |
 | `ODX_NAMESPACE` | string | The service name, `"odx"`. |
 | `SIGNATURE_HEADER` | string | `"optimaldx-signature"`. |

package/SUPPORT.md

@@ -3,10 +3,10 @@
 Generated from `openapi.yaml`; do not edit by hand.
 
 - operations in spec: **15**
-- supported by the mock: **15**
+- supported by the emulator: **15**
 - parity enabled: **15**
 
-| operationId | route | mock | parity | notes |
+| operationId | route | emulator | parity | notes |
 | --- | --- | --- | --- | --- |
 | `ListPartnerLabs` | `GET /v1/partner/labs` | ✅ supported | ✅ |  |
 | `ListElements` | `GET /v1/elements/{labId}` | ✅ supported | ✅ |  |