@crvouga/mockingbird-service-google-calendar 3.0.0 → 3.2.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog — @crvouga/mockingbird-service-google-calendar
 
+## 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-google-calendar discovery
 
 This is the installed-package index for coding agents and tooling. All relative links resolve
-inside `node_modules/@crvouga/mockingbird-service-google-calendar/`; no repository checkout is needed to discover the mock's
+inside `node_modules/@crvouga/mockingbird-service-google-calendar/`; 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-google-calendar
 
-> 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 **Google Calendar v3** and **Google OAuth 2.0** for test suites, covering what
+Stateful emulator of **Google Calendar v3** and **Google OAuth 2.0** for test suites, covering what
 our EMR backend calls: `calendarList.list`, `calendars.insert`, `events.list` (time windows,
 `q`, `orderBy`, paging, incremental sync with 410 `fullSyncRequired`), `events.get/insert/
 update/delete`, `events.watch` with real push notifications to the channel's address, and
@@ -28,9 +28,9 @@ ESM only. Node >= 22 or Bun >= 1.2. No native dependencies. Serve it with
 ## Usage
 
 Seams (the app hardcodes Google today): give the calendar client a `rootUrl`
-(`google.calendar({version: "v3", auth, rootUrl: "<mock>/"})`), give `OAuth2Client`
-`endpoints: {oauth2TokenUrl: "<mock>/token", oauth2RevokeUrl: "<mock>/revoke"}`, and point the
-userinfo fetch at `<mock>/oauth2/v3/userinfo`. `GOOGLE_WEBHOOK_URL` can stay as it is: the mock
+(`google.calendar({version: "v3", auth, rootUrl: "<emulator>/"})`), give `OAuth2Client`
+`endpoints: {oauth2TokenUrl: "<emulator>/token", oauth2RevokeUrl: "<emulator>/revoke"}`, and point the
+userinfo fetch at `<emulator>/oauth2/v3/userinfo`. `GOOGLE_WEBHOOK_URL` can stay as it is: the emulator
 posts pushes to whatever `address` the app registers (http is allowed unless
 `--require-https-webhooks`).
 
@@ -50,7 +50,7 @@ const oauth = new OAuth2Client({
   redirectUri: "postmessage",
   endpoints: { oauth2TokenUrl: `${google.url}/token`, oauth2RevokeUrl: `${google.url}/revoke` },
 })
-// Authorization code "4/mock-<name>" signs in <name>@example.com ("4/mock-<email>" for others).
+// Authorization code "4/emulator-<name>" signs in <name>@example.com ("4/emulator-<email>" for others).
 const { tokens } = await oauth.getToken("4/mock-dr.house")
 const client = new auth.OAuth2()
 client.setCredentials({ access_token: tokens.access_token ?? null })
@@ -102,7 +102,7 @@ Every change to a calendar's events (through the API or the admin plane) posts t
 channel on that calendar: an empty body with `X-Goog-Channel-ID`, `X-Goog-Channel-Token` (when
 set), `X-Goog-Channel-Expiration` (RFC 1123), `X-Goog-Message-Number` (1 for `sync`, then +1),
 `X-Goog-Resource-ID`, `X-Goog-Resource-URI` and `X-Goog-Resource-State` (`sync`, then
-`exists`). Stopped or expired (mock clock) channels get nothing. Non-2xx answers are retried
+`exists`). Stopped or expired (emulator clock) channels get nothing. Non-2xx answers are retried
 (immediately, 1 s, 10 s, 1 min, 10 min). `GET /__admin/webhooks` lists deliveries, and
 `/__admin/webhooks/events`, `…/replay`, `…/flush` work as usual.
 
@@ -150,14 +150,14 @@ generated calendar module over googleapis-common 7 / gaxios 6; the full `googlea
 
 | Export | Kind | Description |
 | --- | --- | --- |
-| `GoogleCalendarAPI` | class | The in-process mock: `fetch(request)`, `reset()`, `user(email)`, `ensurePrimary(email)`, `resolveCalendar(email, id)`, `createEvent`, `updateEvent`, `deleteEvent`, `findEvent`, `notify(calendarId)`, `channels()`, `events(email?)`, `invalidateSyncTokens()`. Options: `sqlite`, `now`, `namespace`, `settings`, `onPush`, `onChannels`. |
-| `createRuntime` | function | The mock with the full service contract and push delivery. Options: `settings`, `push: {retryDelaysMs?, fetch?}`, `clock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
+| `GoogleCalendarAPI` | class | The in-process emulator: `fetch(request)`, `reset()`, `user(email)`, `ensurePrimary(email)`, `resolveCalendar(email, id)`, `createEvent`, `updateEvent`, `deleteEvent`, `findEvent`, `notify(calendarId)`, `channels()`, `events(email?)`, `invalidateSyncTokens()`. Options: `sqlite`, `now`, `namespace`, `settings`, `onPush`, `onChannels`. |
+| `createRuntime` | function | The emulator with the full service contract and push delivery. Options: `settings`, `push: {retryDelaysMs?, fetch?}`, `clock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
 | `GOOGLE_CALENDAR_PRESETS` | object | Every named fault preset. |
 | `GOOGLE_CALENDAR_NAMESPACE` | string | The service name, `"google-calendar"`. |
 | `DEFAULT_SCOPE` | string | The scope the token endpoint reports. |
 | `pushHeaders` | function | The `X-Goog-*` headers of a push notification. |
-| `issueAccessToken` | function | Mint an access token the mock accepts for an email. |
-| `parseToken` | function | Decode a mock access or refresh token. |
+| `issueAccessToken` | function | Mint an access token the emulator accepts for an email. |
+| `parseToken` | function | Decode an emulator access or refresh token. |
 | `accessTokenCredential` | function | The account an access token belongs to (how credentials map to namespaces). |
 | `emailFromCode` | function | The account a `4/mock-…` authorization code signs in. |
 | `googleError` | function | Build Google's error envelope. |

package/SUPPORT.md

@@ -3,10 +3,10 @@
 Generated from `openapi.yaml`; do not edit by hand.
 
 - operations in spec: **12**
-- supported by the mock: **12**
+- supported by the emulator: **12**
 - parity enabled: **12**
 
-| operationId | route | mock | parity | notes |
+| operationId | route | emulator | parity | notes |
 | --- | --- | --- | --- | --- |
 | `OAuthToken` | `POST /token` | ✅ supported | ✅ |  |
 | `OAuthRevoke` | `POST /revoke` | ✅ supported | ✅ |  |