@crvouga/mockingbird-service-intercom 3.0.0 → 3.2.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog — @crvouga/mockingbird-service-intercom
 
+## 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-intercom discovery
 
 This is the installed-package index for coding agents and tooling. All relative links resolve
-inside `node_modules/@crvouga/mockingbird-service-intercom/`; no repository checkout is needed to discover the mock's
+inside `node_modules/@crvouga/mockingbird-service-intercom/`; 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-intercom
 
-> 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 **Intercom REST API (version 2.11)** for test suites. It serves the calls
+Stateful emulator of the **Intercom REST API (version 2.11)** for test suites. It serves the calls
 our backend makes:
 
 - **contacts:** search, create (409 on duplicates, the way Intercom does), update and get;
@@ -125,7 +125,7 @@ A query is either a filter `{field, operator, value}` or a compound
 
 ### Webhooks
 
-The mock sends webhooks for these events:
+The emulator sends webhooks for these events:
 
 | Event | Topic |
 | --- | --- |
@@ -156,7 +156,7 @@ Each delivery is a JSON body posted with `X-Hub-Signature: sha1=<hex HMAC-SHA1(s
 - **Only the new part.** `item.conversation_parts` holds just the part that caused the event,
   as in Intercom's own payloads.
 - **Wall-clock timestamps.** The part's timestamps and the envelope's `created_at` use real
-  time, never the mock clock, because the EMR rejects parts more than 5 minutes old against its
+  time, never the emulator clock, because the EMR rejects parts more than 5 minutes old against its
   own clock.
 - **Stable id.** The notification `id` stays the same on retries and on `webhook_duplicate`, so
   the backend's `delivery_id ?? id` dedupe and the EMR's processed-marker dedupe both hold.
@@ -169,7 +169,7 @@ Each delivery is a JSON body posted with `X-Hub-Signature: sha1=<hex HMAC-SHA1(s
 | Route | Effect |
 | --- | --- |
 | `POST /__admin/conversations/:id/admin-reply` | `{adminId? \| admin_id? (default: first admin), body, messageType?: "comment" \| "note"}` appends an admin part ("the care team replied") and fires the webhook. |
-| `GET /__admin/outbox?since=&to=&limit=`, `GET /__admin/outbox/:id` | What the client sent through `POST /conversations` and `/reply`, oldest first: `{id, operation, conversationId, contactId, partId, partType ("source" for the opening message), authorType, authorId, hasBody, bodyLength, attachmentCount, at, createdAt}`. **Metadata only**: the body is never stored. `to=` matches the conversation or contact id; `since=` takes epoch ms or ISO-8601 on the mock clock. The admin plane's own replies are not listed. |
+| `GET /__admin/outbox?since=&to=&limit=`, `GET /__admin/outbox/:id` | What the client sent through `POST /conversations` and `/reply`, oldest first: `{id, operation, conversationId, contactId, partId, partType ("source" for the opening message), authorType, authorId, hasBody, bodyLength, attachmentCount, at, createdAt}`. **Metadata only**: the body is never stored. `to=` matches the conversation or contact id; `since=` takes epoch ms or ISO-8601 on the emulator clock. The admin plane's own replies are not listed. |
 | `POST /__admin/conversations/:id/close`, `…/open` | `{adminId?}` closes or reopens as an admin and fires the webhook. |
 | `POST /__admin/conversations` | `{contactId \| externalId, adminId?, body}` creates an admin-initiated conversation. The EMR then looks the member up by `contacts[0].external_id`. |
 | `GET /__admin/conversations`, `GET /__admin/contacts` | The namespace's records. |
@@ -209,19 +209,19 @@ never records message bodies or contact details.
 - Tags, notes, companies, segments, tickets, articles, data-attribute management, teams and
   SLAs. These appear only as empty lists where a payload has them.
 - Rate-limit headers on normal responses. Only `rate_limited` sends them.
-- Intercom's exact wording for the idempotency conflict, which is unverified: the mock answers
+- Intercom's exact wording for the idempotency conflict, which is unverified: the emulator answers
   409 `conflict`.
 
 ## API
 
 | Export | Kind | Description |
 | --- | --- | --- |
-| `IntercomAPI` | class | The in-process mock: `fetch(request)`, `reset()`, `appendPart(…)`, `manage(…)`, `startAdminConversation(…)`, `conversations()`, `contacts()`, `conversationBody(…)`, `contactBody(…)`, `error(…)`, `state`. Options: `sqlite`, `now`, `wallClock`, `namespace`, `admins`, `settings`, `onWebhook`. |
+| `IntercomAPI` | class | The in-process emulator: `fetch(request)`, `reset()`, `appendPart(…)`, `manage(…)`, `startAdminConversation(…)`, `conversations()`, `contacts()`, `conversationBody(…)`, `contactBody(…)`, `error(…)`, `state`. Options: `sqlite`, `now`, `wallClock`, `namespace`, `admins`, `settings`, `onWebhook`. |
 | `IntercomError` | class | A vendor error (status, code, message) raised by the admin-facing methods. |
-| `createRuntime` | function | The mock with the full service contract (health, admin, namespaces, credentials, presets, webhooks). Options: `webhooks: {urls, secret?, events?, retryDelaysMs?, fetch?}` (a `urls` entry may be `{url, events}` to override `events` for that URL), `admins`, `settings`, `clock`, `wallClock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
+| `createRuntime` | function | The emulator with the full service contract (health, admin, namespaces, credentials, presets, webhooks). Options: `webhooks: {urls, secret?, events?, retryDelaysMs?, fetch?}` (a `urls` entry may be `{url, events}` to override `events` for that URL), `admins`, `settings`, `clock`, `wallClock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
 | `INTERCOM_PRESETS` | object | Every named fault preset. |
 | `INTERCOM_NAMESPACE` | string | The service name, `"intercom"`. |
-| `INTERCOM_TOPICS` | array | Every webhook topic the mock can send, including the opt-in member topics. |
+| `INTERCOM_TOPICS` | array | Every webhook topic the emulator can send, including the opt-in member topics. |
 | `HUB_SIGNATURE_HEADER`, `signHub` | values | `X-Hub-Signature` and the `sha1=<hex>` signer, for your own receivers. |
 | `DEFAULT_ADMINS`, `DEFAULT_SETTINGS` | values | The seeded admins and default settings. |
 | `toHtml`, `toPlaintext`, `encodeCursor`, `decodeCursor` | functions | Body rendering and the search cursor format. |

package/SUPPORT.md

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