@crvouga/mockingbird-service-easypost 3.0.0 → 3.1.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog — @crvouga/mockingbird-service-easypost
 
+## 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
@@ -14,10 +24,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-easypost discovery
 
 This is the installed-package index for coding agents and tooling. All relative links resolve
-inside `node_modules/@crvouga/mockingbird-service-easypost/`; no repository checkout is needed to discover the mock's
+inside `node_modules/@crvouga/mockingbird-service-easypost/`; 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-easypost
 
-> 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 **EasyPost** trackers API for test suites: `POST /v2/trackers` (create or
+Stateful emulator of the **EasyPost** trackers API for test suites: `POST /v2/trackers` (create or
 re-use a tracker for a tracking code), `GET /v2/trackers/{id}` and `GET /v2/trackers`. EasyPost's
 documented test tracking codes answer their fixed statuses, and any other code moves through
 admin transitions, so the genomics admin's shipping-leg states can be driven deterministically.
@@ -24,7 +24,7 @@ any Fetch server.
 ## Usage
 
 The app hardcodes `https://api.easypost.com/v2/trackers` (seam **G-Y1**: add a base-URL env to
-`easypost-client.ts`). Point that base URL at the mock; `EASYPOST_API_KEY` can be any value
+`easypost-client.ts`). Point that base URL at the emulator; `EASYPOST_API_KEY` can be any value
 (`--api-key` restricts it).
 
 ```bash
@@ -103,14 +103,14 @@ records `unknown` and warns), `slow` (5 s).
 
 | Export | Kind | Description |
 | --- | --- | --- |
-| `EasyPostAPI` | class | The in-process mock: `fetch(request)`, `reset()`, `transition(idOrCode, {status, …}, carrier?)`, `trackers()`. Options: `sqlite`, `now`, `namespace`, `settings`. |
-| `createRuntime` | function | The mock with the full service contract (health, admin, namespaces, credentials, presets). Options: `settings`, `clock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
+| `EasyPostAPI` | class | The in-process emulator: `fetch(request)`, `reset()`, `transition(idOrCode, {status, …}, carrier?)`, `trackers()`. Options: `sqlite`, `now`, `namespace`, `settings`. |
+| `createRuntime` | function | The emulator with the full service contract (health, admin, namespaces, credentials, presets). Options: `settings`, `clock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
 | `EASYPOST_PRESETS` | object | Every named fault preset. |
 | `EASYPOST_NAMESPACE` | string | The service name, `"easypost"`. |
 | `TEST_TRACKING_CODES` | object | EasyPost's test codes and the status / detail each answers. |
 | `TRACKER_STATUSES` | array | Every Tracker `status`. |
 | `apiKeyCredential` | function | The API key from `Basic base64(key:)` (how credentials map to namespaces). |
-| `detectCarrier` | function | The carrier the mock assigns a code with no carrier given. |
+| `detectCarrier` | function | The carrier the emulator assigns a code with no carrier given. |
 | `easyPostError` | function | Build an EasyPost error response `{error: {code, message, errors}}`. |
 | `isTrackerStatus` | function | Whether a value is a Tracker status. |
 | `document`, `operationIds`, `supportedOperationIds` | values | The vendored OpenAPI contract and its operation ids. |

package/SUPPORT.md

@@ -3,10 +3,10 @@
 Generated from `openapi.yaml`; do not edit by hand.
 
 - operations in spec: **3**
-- supported by the mock: **3**
+- supported by the emulator: **3**
 - parity enabled: **3**
 
-| operationId | route | mock | parity | notes |
+| operationId | route | emulator | parity | notes |
 | --- | --- | --- | --- | --- |
 | `ListTrackers` | `GET /v2/trackers` | ✅ supported | ✅ |  |
 | `CreateTracker` | `POST /v2/trackers` | ✅ supported | ✅ |  |