@crvouga/mockingbird-service-aws-speech 3.5.0 → 3.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -184,6 +184,12 @@ declare class Collection<T> {
184
184
  }>;
185
185
  }
186
186
 
187
+ /**
188
+ * What names an id base: a non-negative safe integer (or its decimal string) or `"boot"`,
189
+ * which derives the base from the wall clock when the runtime is created.
190
+ */
191
+ type IdBase = number | string;
192
+
187
193
  /** Options every provider constructor accepts. */
188
194
  type APIOptions = {
189
195
  /** Sync SQLite client. Defaults to `@crvouga/mockingbird-service-sqlite`. */
@@ -279,6 +285,15 @@ type FaultRule = {
279
285
  requestHeaders?: Record<string, string>;
280
286
  /** Fault only requests carrying these query parameters. `"*"` matches any value. */
281
287
  query?: Record<string, string>;
288
+ /**
289
+ * Fault only requests whose JSON body carries these fields. Each key is a dotted path into
290
+ * the parsed body (`"patient_details.email"`; a number steps into an array, `"items.0.sku"`)
291
+ * and each value is what the field must equal: a string, number, boolean or `null`, compared
292
+ * strictly (`3` is not `"3"`). `"*"` matches any value that is present. A request whose body
293
+ * is missing, is not JSON, or is not a JSON object never matches. Not `body`, which is the
294
+ * response a rule injects.
295
+ */
296
+ requestBody?: Record<string, RequestBodyValue>;
282
297
  /**
283
298
  * Fault only this namespace. Omit (or `"*"`) to fault every namespace — which is what
284
299
  * an in-process caller usually wants, and what a parallel worker usually does not:
@@ -345,6 +360,8 @@ type FaultRule = {
345
360
  /** The preset this rule was expanded from, if any. */
346
361
  fromPreset?: string;
347
362
  };
363
+ /** What a field of the request body must equal in {@link FaultRule.requestBody}. */
364
+ type RequestBodyValue = string | number | boolean | null;
348
365
  /** A fault that fired for one request. */
349
366
  type FaultHit = {
350
367
  id: string;
@@ -382,6 +399,11 @@ type FaultCandidate = {
382
399
  /** Request headers and query, for rules that match on them. */
383
400
  headers?: Headers;
384
401
  query?: URLSearchParams;
402
+ /**
403
+ * The request body parsed as JSON, read only when a rule matches on `requestBody`. Resolve
404
+ * `undefined` for a body that is missing or not JSON. It must leave the request readable.
405
+ */
406
+ readJson?: () => Promise<unknown>;
385
407
  /** The namespace clock, for `from` / `until`. Rules with a window are skipped without it. */
386
408
  now?: number;
387
409
  /** How to spend a delay for this request. Default: the registry's own sleep. */
@@ -904,6 +926,12 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI & {
904
926
  mount(prefix: string): MountedAPI;
905
927
  readonly sqlite: SqliteClient$1;
906
928
  readonly clock: Clock;
929
+ /**
930
+ * Change the id base ({@link RuntimeOptions.idBase}) for ids generated from now on, and
931
+ * return the number it resolved to. Set it before the first request so a boot's ids stay
932
+ * one run.
933
+ */
934
+ setIdBase(base: IdBase): number;
907
935
  readonly faults: FaultRegistry;
908
936
  /** Baseline response time per namespace. */
909
937
  readonly latency: LatencyRegistry;
package/dist/index.js CHANGED
@@ -26,7 +26,7 @@ import {
26
26
  speechError,
27
27
  supportedOperationIds,
28
28
  unwrapSigned
29
- } from "./chunk-PFJYH66F.js";
29
+ } from "./chunk-KGBYMBBR.js";
30
30
  export {
31
31
  DEFAULT_SETTINGS,
32
32
  EventStreamError,
package/dist/server.d.ts CHANGED
@@ -133,6 +133,12 @@ interface SqliteClient$2 {
133
133
  transaction<T>(fn: () => T): T;
134
134
  }
135
135
 
136
+ /**
137
+ * What names an id base: a non-negative safe integer (or its decimal string) or `"boot"`,
138
+ * which derives the base from the wall clock when the runtime is created.
139
+ */
140
+ type IdBase$1 = number | string;
141
+
136
142
  /**
137
143
  * The single source of time for a service.
138
144
  *
@@ -215,6 +221,15 @@ type FaultRule$1 = {
215
221
  requestHeaders?: Record<string, string>;
216
222
  /** Fault only requests carrying these query parameters. `"*"` matches any value. */
217
223
  query?: Record<string, string>;
224
+ /**
225
+ * Fault only requests whose JSON body carries these fields. Each key is a dotted path into
226
+ * the parsed body (`"patient_details.email"`; a number steps into an array, `"items.0.sku"`)
227
+ * and each value is what the field must equal: a string, number, boolean or `null`, compared
228
+ * strictly (`3` is not `"3"`). `"*"` matches any value that is present. A request whose body
229
+ * is missing, is not JSON, or is not a JSON object never matches. Not `body`, which is the
230
+ * response a rule injects.
231
+ */
232
+ requestBody?: Record<string, RequestBodyValue$1>;
218
233
  /**
219
234
  * Fault only this namespace. Omit (or `"*"`) to fault every namespace — which is what
220
235
  * an in-process caller usually wants, and what a parallel worker usually does not:
@@ -281,6 +296,8 @@ type FaultRule$1 = {
281
296
  /** The preset this rule was expanded from, if any. */
282
297
  fromPreset?: string;
283
298
  };
299
+ /** What a field of the request body must equal in {@link FaultRule.requestBody}. */
300
+ type RequestBodyValue$1 = string | number | boolean | null;
284
301
  /** A fault that fired for one request. */
285
302
  type FaultHit$1 = {
286
303
  id: string;
@@ -305,6 +322,11 @@ type FaultCandidate$1 = {
305
322
  /** Request headers and query, for rules that match on them. */
306
323
  headers?: Headers;
307
324
  query?: URLSearchParams;
325
+ /**
326
+ * The request body parsed as JSON, read only when a rule matches on `requestBody`. Resolve
327
+ * `undefined` for a body that is missing or not JSON. It must leave the request readable.
328
+ */
329
+ readJson?: () => Promise<unknown>;
308
330
  /** The namespace clock, for `from` / `until`. Rules with a window are skipped without it. */
309
331
  now?: number;
310
332
  /** How to spend a delay for this request. Default: the registry's own sleep. */
@@ -827,6 +849,12 @@ type ServiceRuntime$1<T extends ServiceInstance$1> = FetchAPI$2 & {
827
849
  mount(prefix: string): MountedAPI$1;
828
850
  readonly sqlite: SqliteClient$2;
829
851
  readonly clock: Clock$1;
852
+ /**
853
+ * Change the id base ({@link RuntimeOptions.idBase}) for ids generated from now on, and
854
+ * return the number it resolved to. Set it before the first request so a boot's ids stay
855
+ * one run.
856
+ */
857
+ setIdBase(base: IdBase$1): number;
830
858
  readonly faults: FaultRegistry$1;
831
859
  /** Baseline response time per namespace. */
832
860
  readonly latency: LatencyRegistry$1;
@@ -932,6 +960,12 @@ type CommonServeOptions = {
932
960
  /** Synthetic provider fixture objects supplied by a fleet entry. */
933
961
  fixtures?: Record<string, unknown>;
934
962
  baseUrl?: string;
963
+ /**
964
+ * Boot settings from `--settings`, `MOCKINGBIRD_SETTINGS` or a fleet entry's `settings`,
965
+ * already checked by the target's {@link ServeTarget.parseSettings}. Pass them to the
966
+ * service's own `settings` option so they become every namespace's defaults.
967
+ */
968
+ settings?: Record<string, unknown>;
935
969
  };
936
970
  /**
937
971
  * What a service contributes to `serve`: how to build its runtime from CLI flags,
@@ -944,6 +978,13 @@ type ServeTarget = {
944
978
  defaultPort: number;
945
979
  /** Serve flags beyond the common ones. */
946
980
  options?: Record<string, CliOption>;
981
+ /**
982
+ * Check the boot settings a caller supplied (`--settings`, `MOCKINGBIRD_SETTINGS`, a fleet
983
+ * entry's `settings`) against the service's settings schema, returning them normalized
984
+ * or throwing a message naming the bad field. A target without one takes no boot settings,
985
+ * and supplying some is refused before a port is bound.
986
+ */
987
+ parseSettings?(settings: Record<string, unknown>): Record<string, unknown>;
947
988
  create(values: CliValues, common: CommonServeOptions): Promise<ServiceRuntime$1<ServiceInstance$1>> | ServiceRuntime$1<ServiceInstance$1>;
948
989
  /** Startup lines after the listen address, e.g. the loaded corpus version. */
949
990
  banner?(runtime: ServiceRuntime$1<ServiceInstance$1>): string[];
@@ -1154,6 +1195,12 @@ declare class Collection<T> {
1154
1195
  }>;
1155
1196
  }
1156
1197
 
1198
+ /**
1199
+ * What names an id base: a non-negative safe integer (or its decimal string) or `"boot"`,
1200
+ * which derives the base from the wall clock when the runtime is created.
1201
+ */
1202
+ type IdBase = number | string;
1203
+
1157
1204
  /** Options every provider constructor accepts. */
1158
1205
  type APIOptions = {
1159
1206
  /** Sync SQLite client. Defaults to `@crvouga/mockingbird-service-sqlite`. */
@@ -1249,6 +1296,15 @@ type FaultRule = {
1249
1296
  requestHeaders?: Record<string, string>;
1250
1297
  /** Fault only requests carrying these query parameters. `"*"` matches any value. */
1251
1298
  query?: Record<string, string>;
1299
+ /**
1300
+ * Fault only requests whose JSON body carries these fields. Each key is a dotted path into
1301
+ * the parsed body (`"patient_details.email"`; a number steps into an array, `"items.0.sku"`)
1302
+ * and each value is what the field must equal: a string, number, boolean or `null`, compared
1303
+ * strictly (`3` is not `"3"`). `"*"` matches any value that is present. A request whose body
1304
+ * is missing, is not JSON, or is not a JSON object never matches. Not `body`, which is the
1305
+ * response a rule injects.
1306
+ */
1307
+ requestBody?: Record<string, RequestBodyValue>;
1252
1308
  /**
1253
1309
  * Fault only this namespace. Omit (or `"*"`) to fault every namespace — which is what
1254
1310
  * an in-process caller usually wants, and what a parallel worker usually does not:
@@ -1315,6 +1371,8 @@ type FaultRule = {
1315
1371
  /** The preset this rule was expanded from, if any. */
1316
1372
  fromPreset?: string;
1317
1373
  };
1374
+ /** What a field of the request body must equal in {@link FaultRule.requestBody}. */
1375
+ type RequestBodyValue = string | number | boolean | null;
1318
1376
  /** A fault that fired for one request. */
1319
1377
  type FaultHit = {
1320
1378
  id: string;
@@ -1339,6 +1397,11 @@ type FaultCandidate = {
1339
1397
  /** Request headers and query, for rules that match on them. */
1340
1398
  headers?: Headers;
1341
1399
  query?: URLSearchParams;
1400
+ /**
1401
+ * The request body parsed as JSON, read only when a rule matches on `requestBody`. Resolve
1402
+ * `undefined` for a body that is missing or not JSON. It must leave the request readable.
1403
+ */
1404
+ readJson?: () => Promise<unknown>;
1342
1405
  /** The namespace clock, for `from` / `until`. Rules with a window are skipped without it. */
1343
1406
  now?: number;
1344
1407
  /** How to spend a delay for this request. Default: the registry's own sleep. */
@@ -1861,6 +1924,12 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI & {
1861
1924
  mount(prefix: string): MountedAPI;
1862
1925
  readonly sqlite: SqliteClient$1;
1863
1926
  readonly clock: Clock;
1927
+ /**
1928
+ * Change the id base ({@link RuntimeOptions.idBase}) for ids generated from now on, and
1929
+ * return the number it resolved to. Set it before the first request so a boot's ids stay
1930
+ * one run.
1931
+ */
1932
+ setIdBase(base: IdBase): number;
1864
1933
  readonly faults: FaultRegistry;
1865
1934
  /** Baseline response time per namespace. */
1866
1935
  readonly latency: LatencyRegistry;
package/dist/server.js CHANGED
@@ -3,8 +3,8 @@ import {
3
3
  createServer,
4
4
  listenH2c,
5
5
  serveTarget
6
- } from "./chunk-M7JQW4G3.js";
7
- import "./chunk-PFJYH66F.js";
6
+ } from "./chunk-ML4QWID2.js";
7
+ import "./chunk-KGBYMBBR.js";
8
8
  export {
9
9
  DEFAULT_PORT,
10
10
  createServer,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@crvouga/mockingbird-service-aws-speech",
3
- "version": "3.5.0",
3
+ "version": "3.7.0",
4
4
  "description": "Stateful emulator of AWS Polly (SynthesizeSpeech, StartSpeechSynthesisStream) and Transcribe (streaming over h2c, batch jobs), with exact event-stream framing and scripted transcripts.",
5
5
  "license": "MIT",
6
6
  "type": "module",