@crvouga/mockingbird-service-aws-speech 2.3.0 → 3.1.0

package/CHANGELOG.md

@@ -1,6 +1,30 @@
 # Changelog — @crvouga/mockingbird-service-aws-speech
 
-## 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-aws-speech discovery
 
 This is the installed-package index for coding agents and tooling. All relative links resolve
-inside `node_modules/@crvouga/mockingbird-service-aws-speech/`; no repository checkout is needed to discover the mock's
+inside `node_modules/@crvouga/mockingbird-service-aws-speech/`; 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-aws-speech
 
-> 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 **Amazon Polly** and **Amazon Transcribe** for test suites: Polly
+Stateful emulator of **Amazon Polly** and **Amazon Transcribe** for test suites: Polly
 `SynthesizeSpeech` and `StartSpeechSynthesisStream` (HTTP/2 duplex event stream), Transcribe
 Streaming `StartStreamTranscription` (HTTP/2 duplex) and Transcribe batch
 `StartTranscriptionJob` / `GetTranscriptionJob`. Chat voice turns run end to end with no audio
@@ -62,7 +62,7 @@ another service's CLI, and `createRuntime` behind a plain Fetch server, speak HT
 | `POST /v1/speech` | Polly `SynthesizeSpeech`. `OutputFormat: pcm` → raw PCM s16le mono 440 Hz tone (`audio/pcm`, even byte count, `SampleRate` 8000/16000, default 16000); `mp3` → valid MPEG-2 Layer III frames (`audio/mpeg`, 8000/16000/22050/24000). 60 ms of audio per character, byte-identical on every run; `x-amzn-RequestCharacters`. Errors: `ValidationException` (unknown voice or engine), `InvalidSampleRateException`, `TextLengthExceededException` (> 3000 characters). |
 | `POST /v1/synthesisStream` | Polly `StartSpeechSynthesisStream` (HTTP/2 duplex, parameters in `x-amzn-Engine` / `x-amzn-VoiceId` / `x-amzn-OutputFormat` / `x-amzn-SampleRate`; generative engine only). Each `TextEvent` answers `AudioEvent`s (24 kHz MP3 frames mpg123 decodes); `CloseStreamEvent` (or the end of input) answers `StreamClosedEvent {RequestCharacters}`. |
 | `POST /stream-transcription` | Transcribe `StartStreamTranscription` (HTTP/2 duplex). Validates the `x-amzn-transcribe-*` parameters (400 `BadRequestException`), echoes them in the response headers with `x-amzn-transcribe-session-id`. Sends one scripted partial (`IsPartial: true`) per `AudioEvent` received, the rest when the audio ends, then the final result, then closes. Audio bytes are counted, never kept. |
-| `POST /` | Transcribe batch (AWS JSON 1.1, `X-Amz-Target`). `StartTranscriptionJob` → `IN_PROGRESS` (`ConflictException` for a repeated name); `GetTranscriptionJob` → `COMPLETED` once `jobDurationMs` (2 s) have passed on the mock clock, with `Transcript.TranscriptFileUri` = `https://s3.<region>.amazonaws.com/<OutputBucketName>/<OutputKey>`; `BadRequestException` for an unknown job. |
+| `POST /` | Transcribe batch (AWS JSON 1.1, `X-Amz-Target`). `StartTranscriptionJob` → `IN_PROGRESS` (`ConflictException` for a repeated name); `GetTranscriptionJob` → `COMPLETED` once `jobDurationMs` (2 s) have passed on the emulator clock, with `Transcript.TranscriptFileUri` = `https://s3.<region>.amazonaws.com/<OutputBucketName>/<OutputKey>`; `BadRequestException` for an unknown job. |
 
 ### Transcripts (`PUT /__admin/transcripts`)
 
@@ -77,7 +77,7 @@ job), or `{any: true}`; an exact match wins over `any`. Unscripted sessions and
 | Route | Effect |
 | --- | --- |
 | `PUT` / `POST` / `GET` / `DELETE /__admin/transcripts` | Replace, add, list (with `stats`), remove (`?id=`). |
-| `GET /__admin/jobs` | Batch jobs (advanced on the mock clock). |
+| `GET /__admin/jobs` | Batch jobs (advanced on the emulator clock). |
 | `POST /__admin/jobs/:name/complete` | Complete now, optionally with `{transcript}`. |
 | `POST /__admin/jobs/:name/fail` | Fail with `{reason}` (`FailureReason`). |
 | `GET /__admin/jobs/:name/transcript` | The transcript JSON Transcribe would write to S3. |
@@ -118,11 +118,11 @@ records voice, engine, format, character counts and script ids — never text.
 
 | Export | Kind | Description |
 | --- | --- | --- |
-| `SpeechAPI` | class | The in-process mock: `fetch`, `reset`, `jobs()`, `complete(name, transcript?)`, `fail(name, reason)`, `transcriptDocument(job)`, `speechLog()`, `stats()`. Options: `sqlite`, `now`, `namespace`, `settings`, `transcripts`, `transcriptStore`. |
-| `createRuntime` | function | The mock with the full service contract. Options: `settings`, `transcripts`, `transcriptStore`, `clock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
+| `SpeechAPI` | class | The in-process emulator: `fetch`, `reset`, `jobs()`, `complete(name, transcript?)`, `fail(name, reason)`, `transcriptDocument(job)`, `speechLog()`, `stats()`. Options: `sqlite`, `now`, `namespace`, `settings`, `transcripts`, `transcriptStore`. |
+| `createRuntime` | function | The emulator with the full service contract. Options: `settings`, `transcripts`, `transcriptStore`, `clock`, `seed`, `adminKey`, `onLog`, `sqlite`. |
 | `SPEECH_PRESETS` | object | Every named fault preset. |
 | `SPEECH_NAMESPACE` | string | The service name, `"aws-speech"`. |
-| `POLLY_VOICES` | array | Every Polly voice id the mock accepts. |
+| `POLLY_VOICES` | array | Every Polly voice id the emulator accepts. |
 | `speechError` | function | A restJson1 error response (`x-amzn-ErrorType` + `{message}`). |
 | `accessKeyCredential` | function | The SigV4 access key id of a request (how credentials map to namespaces). |
 | `pcmTone`, `mp3Audio`, `mp3Frame`, `durationFor`, `MS_PER_CHARACTER`, `MP3_SAMPLE_RATES`, `MP3_SAMPLES_PER_FRAME` | audio | The deterministic synthetic audio. |

package/SUPPORT.md

@@ -3,10 +3,10 @@
 Generated from `openapi.yaml`; do not edit by hand.
 
 - operations in spec: **4**
-- supported by the mock: **4**
+- supported by the emulator: **4**
 - parity enabled: **2**
 
-| operationId | route | mock | parity | notes |
+| operationId | route | emulator | parity | notes |
 | --- | --- | --- | --- | --- |
 | `SynthesizeSpeech` | `POST /v1/speech` | ✅ supported | ✅ |  |
 | `StartSpeechSynthesisStream` | `POST /v1/synthesisStream` | ✅ supported | ❌ disabled | A duplex HTTP/2 session driven by the SDK's event stream; random bodies cannot drive it. |

package/dist/{chunk-EXH4VDZI.js → chunk-KX3DZ6N5.js}

@@ -1,6 +1,6 @@
 import {
   createRuntime
-} from "./chunk-UUVGFG5L.js";
+} from "./chunk-NQQSHZ6K.js";
 
 // src/h2c.ts
 import {
@@ -304,4 +304,4 @@ export {
   createServer,
   serveTarget
 };
-//# sourceMappingURL=chunk-EXH4VDZI.js.map
+//# sourceMappingURL=chunk-KX3DZ6N5.js.map