@crvouga/mockingbird-service-pharmetika 2.3.0 → 3.1.0

package/CHANGELOG.md

@@ -1,6 +1,30 @@
 # Changelog — @crvouga/mockingbird-service-pharmetika
 
-## 2.3.0 (2026-10-05)
+## 3.1.0 (2026-10-08)
+
+### Features
+
+- redesign emulator experience ([d6038c2](https://github.com/crvouga/mockingbird/commit/d6038c27eebbaa1751f02bc9305002a5b1304779))
+
+### Dependencies
+
+- `@crvouga/mockingbird-service-sqlite`
+
+## 3.0.0 (2026-10-07)
+
+### ⚠️ Breaking changes
+
+- point the repo at crvouga/mockingbird ([1bf35a4](https://github.com/crvouga/mockingbird/commit/1bf35a422b84a85b50b09b72bd7cc7093082a86e))
+- point the repo at crvouga/emulates ([cdb5e53](https://github.com/crvouga/mockingbird/commit/cdb5e536ed8c1f52345e3984f089001c25fdb08a))
+- rename Emulators to Emulates ([2e10d9c](https://github.com/crvouga/mockingbird/commit/2e10d9cff84c54ac37768fc9a19d1aefd3943744))
+- rebrand Mockingbird to Emulators ([1adca65](https://github.com/crvouga/mockingbird/commit/1adca65ce28242f11cff98eac05d2be88f680cbe))
+
+### Fixes and improvements
+
+- 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))
+
+## 2.3.0 (2026-10-04)
 
 ### Features
 
@@ -17,10 +41,6 @@
 - reconcile combined PR integration ([124d5be](https://github.com/crvouga/mockingbird/commit/124d5bed7576535ff481ce6da7d2369957799665))
 - preserve inferred form headers ([02bdd28](https://github.com/crvouga/mockingbird/commit/02bdd2806a9a934607ecd7ffd0cfbe4f6ba80c91))
 
-### Dependencies
-
-- `@crvouga/mockingbird-service-sqlite`
-
 ## 2.2.0 (2026-10-04)
 
 ### Features

package/DISCOVERY.md

@@ -1,7 +1,7 @@
 # @crvouga/mockingbird-service-pharmetika discovery
 
 This is the installed-package index for coding agents and tooling. All relative links resolve
-inside `node_modules/@crvouga/mockingbird-service-pharmetika/`; no repository checkout is needed to discover the mock's
+inside `node_modules/@crvouga/mockingbird-service-pharmetika/`; 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,19 +1,19 @@
 # @crvouga/mockingbird-service-pharmetika
 
-> 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 **Pharmetika** compounding-pharmacy provider portal for test suites:
+Stateful emulator of the **Pharmetika** compounding-pharmacy provider portal for test suites:
 clinic and patient lookup, patient create, medication-order validate / EPCS prepare / submit /
 lookup, the v7 cancel, the medication-template catalog, and the status webhooks the pharmacy
 posts back. Orders move only when a test says so (an admin transition or an auto-advance path on
-the mock clock).
+the emulator clock).
 
 - Operation coverage: [SUPPORT.md](https://github.com/crvouga/mockingbird/blob/main/packages/service/pharmetika/SUPPORT.md)
 - The vendor publishes no spec: the contract (`openapi.yaml`) is hand-authored from the wire
   shapes our consumer reads and writes (`pharmetika-fulfillment.adapter.ts`,
   `pharmetika-live.client.ts`, and the bodies recorded in the adapter's spec).
 - **The success rule.** Every body carries Pharmetika's `success` flag. Only `true` or `1` is
-  success: the mock answers business failures (unknown patient, controlled substance on submit,
+  success: the emulator answers business failures (unknown patient, controlled substance on submit,
   a reused order id, …) as **HTTP 200 with `success: 0`** and `messages: [{message, type}]`, the
   case our adapter guards against.
 
@@ -29,7 +29,7 @@ any Fetch server.
 
 ## Usage
 
-Point `PHARMETIKA_API_URL` at the mock and give the app any `PHARMETIKA_API_TOKEN` (or pin one
+Point `PHARMETIKA_API_URL` at the emulator and give the app any `PHARMETIKA_API_TOKEN` (or pin one
 with `--api-token`). Set `PHARMETIKA_WEBHOOK_SECRET` in the app and pass the same value as
 `--webhook-secret`. `PHARMETIKA_PRACTITIONER_IDENTIFIER` can be any string;
 `PHARMETIKA_CLINIC_NAME=Acme` picks the seeded clinic.
@@ -122,7 +122,7 @@ submitted/processing to shipped in our receiver.
 | `GET /__admin/patients`, `POST /__admin/patients` | Read or seed the roster: `{patient_id?, clinic_identifier?, demographics: {first_name, last_name, DOB, …}}`. |
 | `PUT /__admin/templates` | Replace the medication templates (`{templates: [...]}`). |
 | `GET`/`PUT /__admin/settings` | `{tokens?, basic?, anonymousCatalog?, webhookVariant?, autoAdvance?: {afterMs, path} \| null}` for the calling namespace. |
-| `POST /__admin/tick` | Apply due auto-advance steps (the served mock ticks every 100 ms). Orders awaiting prescriber approval never auto-advance. |
+| `POST /__admin/tick` | Apply due auto-advance steps (the served emulator ticks every 100 ms). Orders awaiting prescriber approval never auto-advance. |
 
 Fault presets (`POST /__admin/faults {"preset": "<name>", "count"?: n}`; `GET /__admin/faults/presets`):
 
@@ -162,8 +162,8 @@ username works the same way for the catalog client).
 
 | Export | Kind | Description |
 | --- | --- | --- |
-| `PharmetikaAPI` | class | The in-process mock: `fetch(request)`, `reset()`, `transition(uuid, {to, tracking_id?})`, `tick()`, `orders()`, `webhookBody(order)`. Options: `sqlite`, `now`, `namespace`, `templates`, `clinics`, `patients`, `settings`, `onWebhook`. |
-| `createRuntime` | function | The mock with the full service contract (health, admin, namespaces, credentials, presets, webhooks). Options: `webhooks: {url, secret, retryDelaysMs?, fetch?}`, `settings`, `templates`, `clinics`, `patients`, `tickMs`, `clock`, `seed`, `adminKey`, `onLog`. |
+| `PharmetikaAPI` | class | The in-process emulator: `fetch(request)`, `reset()`, `transition(uuid, {to, tracking_id?})`, `tick()`, `orders()`, `webhookBody(order)`. Options: `sqlite`, `now`, `namespace`, `templates`, `clinics`, `patients`, `settings`, `onWebhook`. |
+| `createRuntime` | function | The emulator with the full service contract (health, admin, namespaces, credentials, presets, webhooks). Options: `webhooks: {url, secret, retryDelaysMs?, fetch?}`, `settings`, `templates`, `clinics`, `patients`, `tickMs`, `clock`, `seed`, `adminKey`, `onLog`. |
 | `PHARMETIKA_PRESETS` | object | Every named fault preset. |
 | `PHARMETIKA_NAMESPACE` | string | The service name, `"pharmetika"`. |
 | `TOKEN_HEADER` | string | `"x-pmk-authentication-token"`. |

package/SUPPORT.md

@@ -3,10 +3,10 @@
 Generated from `openapi.yaml`; do not edit by hand.
 
 - operations in spec: **9**
-- supported by the mock: **9**
+- supported by the emulator: **9**
 - parity enabled: **9**
 
-| operationId | route | mock | parity | notes |
+| operationId | route | emulator | parity | notes |
 | --- | --- | --- | --- | --- |
 | `ListClinics` | `GET /api/v5/provider_portal/clinic/clinic_list` | ✅ supported | ✅ |  |
 | `ListPatients` | `GET /api/v5/provider_portal/provider/patient_list` | ✅ supported | ✅ |  |