@kensio/yulin 1.19.2 → 1.19.4

package/README.md

@@ -53,6 +53,7 @@ npm i -D @kensio/yulin
 - [AWS SDK interception](./docs/sdk "Simulated AWS SDK docs")
 - [Serving on localhost](./docs/serve "Serving simulated AWS on localhost docs")
 - [Simulated time](./docs/time "Simulated time docs")
+- [Terraform](./docs/terraform "Deploying Terraform into simulated AWS docs")
 
 ## Usage
 
@@ -386,3 +387,14 @@ brew install aws-sam-cli
 
 `pnpm test:iso` runs without it. `pnpm test:local` and `pnpm check` skip the comparison with a
 warning where the CLI is absent, and a CI run that cannot find it fails.
+
+The Terraform import tests plan real configurations under `test/terraform`, and need Terraform on
+the `PATH`. Initialise them once:
+
+```bash
+pnpm tf:init
+```
+
+That downloads the AWS provider, which is one binary of about 650MB, and takes a few minutes the
+first time. `pnpm test:iso` runs without it, and every mechanism of the import has a committed
+fixture covered there.

package/dist/serve/http/local-server/sim-aws-local-server.d.ts

@@ -1,8 +1,22 @@
 import { SimAws } from "../../../service/aws/sim-aws.js";
+import type { SimMessageLoggingOption } from "../../message/sim-message-logging.js";
+import type { SimMessageConsole } from "../../message/sim-message-log-console.js";
 import { type SimCloseOnSignalOptions } from "../../../util/process/close-on-signal.js";
 interface SimAwsLocalServerProperties {
     readonly simAws?: SimAws;
     readonly liveReload?: boolean;
+    /**
+     * Which messages this server prints to the console while it serves.
+     *
+     * Every kind unless this narrows it. See `SimMessageLoggingProperties`.
+     */
+    readonly messageLogging?: SimMessageLoggingOption | undefined;
+    /**
+     * Where the message lines go. The process console unless something else is
+     * named, which is how a test reads what was printed.
+     * @internal
+     */
+    readonly messageConsole?: SimMessageConsole | undefined;
 }
 /**
  * Local HTTP server for a simulated AWS environment.
@@ -15,6 +29,7 @@ export declare class SimAwsLocalServer {
     private readonly portBinder;
     private readonly dnsServer;
     private readonly liveReload;
+    private readonly messageLogging;
     constructor(properties?: SimAwsLocalServerProperties);
     /**
      * Start serving simulated AWS services on localhost.
@@ -119,6 +134,24 @@ interface ServeSimAwsProperties {
     readonly simAws?: SimAws;
     readonly port?: number;
     readonly liveReload?: boolean;
+    /**
+     * Which messages this server prints to the console while it serves.
+     *
+     * A simulated Cognito confirmation code, a simulated SNS text message and a
+     * message a simulated SES accepted are printed as they are recorded, which
+     * is what makes a code readable in the terminal the dev server is running
+     * in. All three unless this narrows it: `{ sns: false }` keeps the pool
+     * messages and the email and drops the text messages, and `false` prints
+     * none of them. `emailTextLimit` sets how much of an email's text is
+     * printed.
+     */
+    readonly messageLogging?: SimMessageLoggingOption | undefined;
+    /**
+     * Where the message lines go. The process console unless something else is
+     * named.
+     * @internal
+     */
+    readonly messageConsole?: SimMessageConsole | undefined;
 }
 /**
  * Serve a simulated AWS environment on localhost.

package/dist/serve/http/local-server/sim-aws-local-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-aws-local-server.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAUzD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,0CAA0C,CAAC;AAElD,UAAU,2BAA2B;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,YAAY,UAAU,GAAE,2BAAgC,EAkBvD;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,IAAI,GAAE,MAAsC,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxE;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;OAMG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAQ3B;IAED;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,IAAI,CAI/D;IAED;;;;;;OAMG;IACH,MAAM,IAAI,IAAI,CAEb;IAED;;;;;;OAMG;IACH,WAAW,IAAI,IAAI,CAElB;IAED;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,CAGjC;CACF;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,GAAE,qBAA0B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAQ5B"}
+{"version":3,"file":"sim-aws-local-server.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAWzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAClF,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,0CAA0C,CAAC;AAElD,UAAU,2BAA2B;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAE9D;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACzD;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IAExD,YAAY,UAAU,GAAE,2BAAgC,EAuBvD;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,IAAI,GAAE,MAAsC,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxE;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;OAMG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAU3B;IAED;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,IAAI,CAI/D;IAED;;;;;;OAMG;IACH,MAAM,IAAI,IAAI,CAEb;IAED;;;;;;OAMG;IACH,WAAW,IAAI,IAAI,CAElB;IAED;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,CAGjC;CACF;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAE9D;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACzD;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,GAAE,qBAA0B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAa5B"}

package/dist/serve/http/local-server/sim-aws-local-server.js

@@ -9,6 +9,7 @@ import { SimAwsLocalLocation } from "./sim-aws-local-location.js";
 import { SimAwsLocalRequestHandler } from "./sim-aws-local-request-handler.js";
 import { SimAwsDnsServer } from "../../dns/sim-aws-dns-server.js";
 import { SimLocalLiveReload } from "../live-reload/sim-local-live-reload.js";
+import { SimLocalMessageLogging } from "../../message/sim-local-message-logging.js";
 import { closeOnSignal, } from "../../../util/process/close-on-signal.js";
 /**
  * Local HTTP server for a simulated AWS environment.
@@ -21,10 +22,16 @@ export class SimAwsLocalServer {
     portBinder;
     dnsServer;
     liveReload;
+    messageLogging;
     constructor(properties = {}) {
         const { simAws = new SimAws(), liveReload = false } = properties;
         this.simAws = simAws;
         this.liveReload = new SimLocalLiveReload({ enabled: liveReload });
+        this.messageLogging = new SimLocalMessageLogging({
+            simAws,
+            option: properties.messageLogging,
+            target: properties.messageConsole,
+        });
         const channel = this.liveReload.channel();
         this.requestHandler = new SimAwsLocalRequestHandler({
             simAwsHttp: new SimAwsHttp({ simAws }),
@@ -61,6 +68,7 @@ export class SimAwsLocalServer {
         await this.portBinder.bind(port);
         await this.dnsServer.listen(Number(this.port));
         this.liveReload.serving(this.port);
+        this.messageLogging.serving();
         return this;
     }
     /**
@@ -114,6 +122,7 @@ export class SimAwsLocalServer {
     async close() {
         this.server.close();
         this.dnsServer.close();
+        this.messageLogging.stopping();
         await this.simAws.close();
         await this.liveReload.stopping();
         this.server.closeAllConnections();
@@ -172,7 +181,12 @@ export class SimAwsLocalServer {
  */
 export async function serveSimAws(properties = {}) {
     const { simAws = new SimAws(), port = simAwsLocalConfig.defaultPort, liveReload = false, } = properties;
-    const server = new SimAwsLocalServer({ simAws, liveReload });
+    const server = new SimAwsLocalServer({
+        simAws,
+        liveReload,
+        messageLogging: properties.messageLogging,
+        messageConsole: properties.messageConsole,
+    });
     return server.listen(port);
 }
 //# sourceMappingURL=sim-aws-local-server.js.map

package/dist/serve/http/local-server/sim-aws-local-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-aws-local-server.js","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local-server.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAAe,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EACL,aAAa,GAEd,MAAM,0CAA0C,CAAC;AAOlD;;;GAGG;AACH,MAAM,OAAO,iBAAiB;IACX,MAAM,CAAS;IACf,cAAc,CAA4B;IAC1C,MAAM,CAAS;IACf,UAAU,CAAuB;IACjC,SAAS,CAAkB;IAC3B,UAAU,CAAqB;IAEhD,YAAY,UAAU,GAAgC,EAAE;QACtD,MAAM,EAAE,MAAM,GAAG,IAAI,MAAM,EAAE,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,UAAU,CAAC;QACjE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,IAAI,kBAAkB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,CAAC,cAAc,GAAG,IAAI,yBAAyB,CAAC;YAClD,UAAU,EAAE,IAAI,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;YACtC,QAAQ,EAAE,IAAI,mBAAmB,CAAC;gBAChC,MAAM;gBACN,IAAI,EAAE,GAAW,EAAE,CAAC,IAAI,CAAC,IAAI;aAC9B,CAAC;YACF,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;SACtD,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,IAAI,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;YACpD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,IAAI,oBAAoB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,MAAM,CAAC,IAAI,GAAW,iBAAiB,CAAC,WAAW;QACvD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE/C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,QAAQ;QACV,OAAO,iBAAiB,CAAC,QAAQ,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;OAMG;IACH,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QAEvB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAEjC,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,aAAa,CAAC,OAAO,GAA4B,EAAE;QACjD,OAAO,aAAa,CAAC,KAAK,IAAI,EAAE;YAC9B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,MAAM;QACJ,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;OAMG;IACH,WAAW;QACT,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,KAAmB;QAC1B,MAAM,cAAc,GAAG,IAAI,cAAc,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACtE,OAAO,cAAc,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;CACF;AAQD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAU,GAA0B,EAAE;IAEtC,MAAM,EACJ,MAAM,GAAG,IAAI,MAAM,EAAE,EACrB,IAAI,GAAG,iBAAiB,CAAC,WAAW,EACpC,UAAU,GAAG,KAAK,GACnB,GAAG,UAAU,CAAC;IACf,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IAC7D,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"sim-aws-local-server.js","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local-server.ts"],"names":[],"mappings":"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"}

package/dist/serve/index.d.ts

@@ -5,6 +5,7 @@ export { serveSimAws, SimAwsLocalServer, } from "./http/local-server/sim-aws-loc
 export { SimAwsLocalPortInUse } from "./http/local-server/sim-aws-local-port.error.js";
 export type { SimCloseOnSignalOptions } from "../util/process/close-on-signal.js";
 export { SimLiveReload } from "./http/live-reload/sim-live-reload.js";
+export type { SimMessageLoggingOption, SimMessageLoggingProperties, } from "./message/sim-message-logging.js";
 export { simLiveReloadConfig, simLiveReloadHeaderName, } from "./http/live-reload/sim-live-reload.config.js";
 export { type SimAwsServiceController, SimAwsServiceRequest, type SimAwsServiceTarget, } from "./controller/sim-service-controller.js";
 export { simAwsAuthHeaderName, simAwsErrorDetailHeaderName, simAwsErrorHeaderName, } from "./http/response/sim-aws-response-hints.js";

package/dist/serve/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACvF,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,EAC3B,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,YAAY,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACvF,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,YAAY,EACV,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,2CAA2C,CAAC;AACnD,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,2BAA2B,EAC3B,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,yCAAyC,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uCAAuC,CAAC;AACjF,YAAY,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/serve/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAEL,oBAAoB,GAErB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,2CAA2C,CAAC;AAUnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAEvF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAKtE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAEL,oBAAoB,GAErB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,2CAA2C,CAAC;AAUnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,EAAE,0BAA0B,EAAE,MAAM,+CAA+C,CAAC"}

package/dist/serve/message/sim-email-log-block.d.ts

@@ -0,0 +1,35 @@
+import type { SimSesLoggedEmail } from "../../service/aws/message/sim-aws-logged-message.js";
+/**
+ * How much of an email's text body is printed before it is cut off.
+ *
+ * A message written for a person to read fits well inside this. The limit is
+ * there for the ones written for a machine, where a signed link or an encoded
+ * payload runs on until it has pushed everything else off the screen.
+ */
+export declare const defaultEmailTextLimit = 2000;
+interface SimEmailLogBlockProperties {
+    readonly emailTextLimit?: number | undefined;
+}
+/**
+ * The console block for one email a simulated SES accepted.
+ *
+ * Printing the whole message is the obvious answer and the wrong one. An HTML
+ * part runs to kilobytes of markup and buries the sender, the recipients and
+ * the subject, which are what says which send this was. So the summary comes
+ * first, the text part follows it in full, and the HTML part is reported by
+ * its size.
+ */
+export declare class SimEmailLogBlock {
+    #private;
+    constructor(properties?: SimEmailLogBlockProperties);
+    /**
+     * The lines this email prints as.
+     */
+    lines(email: SimSesLoggedEmail): readonly string[];
+    /**
+     * The text part, cut off at the limit with the cut marked.
+     */
+    private text;
+}
+export {};
+//# sourceMappingURL=sim-email-log-block.d.ts.map

package/dist/serve/message/sim-email-log-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-email-log-block.d.ts","sourceRoot":"","sources":["../../../src/serve/message/sim-email-log-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qDAAqD,CAAC;AAI7F;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAS1C,UAAU,0BAA0B;IAClC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;;IAG3B,YAAY,UAAU,GAAE,0BAA+B,EAEtD;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,MAAM,EAAE,CAQjD;IAED;;OAEG;IACH,OAAO,CAAC,IAAI;CAmBb"}

package/dist/serve/message/sim-email-log-block.js

@@ -0,0 +1,111 @@
+import { bodyIndent, indented } from "./sim-message-indent.js";
+/**
+ * How much of an email's text body is printed before it is cut off.
+ *
+ * A message written for a person to read fits well inside this. The limit is
+ * there for the ones written for a machine, where a signed link or an encoded
+ * payload runs on until it has pushed everything else off the screen.
+ */
+export const defaultEmailTextLimit = 2000;
+/**
+ * How far the body parts are indented, one step under the labels above them.
+ */
+const partIndent = `${bodyIndent}${bodyIndent}`;
+const bytesInAKilobyte = 1000;
+/**
+ * The console block for one email a simulated SES accepted.
+ *
+ * Printing the whole message is the obvious answer and the wrong one. An HTML
+ * part runs to kilobytes of markup and buries the sender, the recipients and
+ * the subject, which are what says which send this was. So the summary comes
+ * first, the text part follows it in full, and the HTML part is reported by
+ * its size.
+ */
+export class SimEmailLogBlock {
+    #textLimit;
+    constructor(properties = {}) {
+        this.#textLimit = properties.emailTextLimit ?? defaultEmailTextLimit;
+    }
+    /**
+     * The lines this email prints as.
+     */
+    lines(email) {
+        return [
+            `sim SES: ${email.fromEmailAddress} ${addressed(email.destination)}`,
+            `${bodyIndent}Subject: ${email.subject}`,
+            ...template(email),
+            ...this.text(email),
+            ...html(email),
+        ];
+    }
+    /**
+     * The text part, cut off at the limit with the cut marked.
+     */
+    text(email) {
+        if (email.text === undefined) {
+            return [];
+        }
+        const overrun = email.text.length - this.#textLimit;
+        const printed = overrun > 0 ? email.text.slice(0, this.#textLimit) : email.text;
+        const cut = overrun > 0
+            ? [`${partIndent}... ${overrun} more characters, not printed`]
+            : [];
+        return [
+            `${bodyIndent}Text body:`,
+            ...indented(printed, partIndent),
+            ...cut,
+        ];
+    }
+}
+/**
+ * Who the message went to, across the three lists, with each list named.
+ *
+ * A bcc that arrived as a bcc is part of what a reader is checking, and the
+ * three lists read the same way once they are run together.
+ */
+function addressed(destination) {
+    const lists = [
+        ["to", destination.toAddresses],
+        ["cc", destination.ccAddresses],
+        ["bcc", destination.bccAddresses],
+    ];
+    return lists
+        .filter(([, addresses]) => addresses.length > 0)
+        .map(([label, addresses]) => `${label} ${addresses.join(", ")}`)
+        .join(", ");
+}
+/**
+ * The template the message was rendered from, where a stored one was.
+ *
+ * The data goes with the name because it is what tells two sends of the same
+ * template apart, and it is usually the thing being checked.
+ */
+function template(email) {
+    if (email.templateName === undefined) {
+        return [];
+    }
+    const data = email.templateData === undefined
+        ? ""
+        : ` ${JSON.stringify(email.templateData)}`;
+    return [`${bodyIndent}Template: ${email.templateName}${data}`];
+}
+/**
+ * The HTML part, measured and left unprinted.
+ */
+function html(email) {
+    if (email.html === undefined) {
+        return [];
+    }
+    return [`${bodyIndent}HTML body: ${sized(email.html)}, not printed`];
+}
+/**
+ * How big a body is, in the units a reader thinks in.
+ */
+function sized(body) {
+    const bytes = Buffer.byteLength(body, "utf8");
+    if (bytes < bytesInAKilobyte) {
+        return `${bytes} bytes`;
+    }
+    return `${(bytes / bytesInAKilobyte).toFixed(1)} kB`;
+}
+//# sourceMappingURL=sim-email-log-block.js.map

package/dist/serve/message/sim-email-log-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-email-log-block.js","sourceRoot":"","sources":["../../../src/serve/message/sim-email-log-block.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C;;GAEG;AACH,MAAM,UAAU,GAAG,GAAG,UAAU,GAAG,UAAU,EAAE,CAAC;AAEhD,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAM9B;;;;;;;;GAQG;AACH,MAAM,OAAO,gBAAgB;IAClB,UAAU,CAAS;IAE5B,YAAY,UAAU,GAA+B,EAAE;QACrD,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,cAAc,IAAI,qBAAqB,CAAC;IACvE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAwB;QAC5B,OAAO;YACL,YAAY,KAAK,CAAC,gBAAgB,IAAI,SAAS,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE;YACpE,GAAG,UAAU,YAAY,KAAK,CAAC,OAAO,EAAE;YACxC,GAAG,QAAQ,CAAC,KAAK,CAAC;YAClB,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACnB,GAAG,IAAI,CAAC,KAAK,CAAC;SACf,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,IAAI,CAAC,KAAwB;QACnC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC;QACpD,MAAM,OAAO,GACX,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QAClE,MAAM,GAAG,GACP,OAAO,GAAG,CAAC;YACT,CAAC,CAAC,CAAC,GAAG,UAAU,OAAO,OAAO,+BAA+B,CAAC;YAC9D,CAAC,CAAC,EAAE,CAAC;QAET,OAAO;YACL,GAAG,UAAU,YAAY;YACzB,GAAG,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;YAChC,GAAG,GAAG;SACP,CAAC;IACJ,CAAC;CACF;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,WAAuC;IACxD,MAAM,KAAK,GAA2C;QACpD,CAAC,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC;QAC/B,CAAC,IAAI,EAAE,WAAW,CAAC,WAAW,CAAC;QAC/B,CAAC,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC;KAClC,CAAC;IAEF,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;SAC/C,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;SAC/D,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,KAAwB;IACxC,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GACR,KAAK,CAAC,YAAY,KAAK,SAAS;QAC9B,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;IAE/C,OAAO,CAAC,GAAG,UAAU,aAAa,KAAK,CAAC,YAAY,GAAG,IAAI,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,SAAS,IAAI,CAAC,KAAwB;IACpC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,CAAC,GAAG,UAAU,cAAc,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,SAAS,KAAK,CAAC,IAAY;IACzB,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAE9C,IAAI,KAAK,GAAG,gBAAgB,EAAE,CAAC;QAC7B,OAAO,GAAG,KAAK,QAAQ,CAAC;IAC1B,CAAC;IAED,OAAO,GAAG,CAAC,KAAK,GAAG,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC"}

package/dist/serve/message/sim-local-message-logging.d.ts

@@ -0,0 +1,39 @@
+import type { SimAws } from "../../service/aws/sim-aws.js";
+import { type SimMessageConsole } from "./sim-message-log-console.js";
+import { type SimMessageLoggingOption } from "./sim-message-logging.js";
+interface SimLocalMessageLoggingProperties {
+    readonly simAws: SimAws;
+    readonly option?: SimMessageLoggingOption | undefined;
+    /**
+     * Where the lines go. The process console unless a test wants to read them.
+     */
+    readonly target?: SimMessageConsole | undefined;
+}
+/**
+ * Message logging as the local server has to hold it: which kinds are printed,
+ * and wired into the server's own lifecycle.
+ *
+ * Keeping it here leaves `SimAwsLocalServer` with sockets and ports, the same
+ * split live reload gets. The listener goes on when the server starts serving
+ * and comes off when it closes, so a message recorded before or after reaches
+ * no console.
+ */
+export declare class SimLocalMessageLogging {
+    #private;
+    private readonly simAws;
+    private readonly logging;
+    private readonly output;
+    constructor(properties: SimLocalMessageLoggingProperties);
+    /**
+     * Start printing the messages this environment records.
+     *
+     * A server asked for no kinds at all listens to nothing.
+     */
+    serving(): void;
+    /**
+     * Stop printing.
+     */
+    stopping(): void;
+}
+export {};
+//# sourceMappingURL=sim-local-message-logging.d.ts.map

package/dist/serve/message/sim-local-message-logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-local-message-logging.d.ts","sourceRoot":"","sources":["../../../src/serve/message/sim-local-message-logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAC;AAElC,UAAU,gCAAgC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACjD;AAED;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAI9C,YAAY,UAAU,EAAE,gCAAgC,EAOvD;IAED;;;;OAIG;IACH,OAAO,IAAI,IAAI,CAUd;IAED;;OAEG;IACH,QAAQ,IAAI,IAAI,CAGf;CACF"}

package/dist/serve/message/sim-local-message-logging.js

@@ -0,0 +1,48 @@
+import { SimMessageLogConsole, } from "./sim-message-log-console.js";
+import { SimMessageLogging, } from "./sim-message-logging.js";
+/**
+ * Message logging as the local server has to hold it: which kinds are printed,
+ * and wired into the server's own lifecycle.
+ *
+ * Keeping it here leaves `SimAwsLocalServer` with sockets and ports, the same
+ * split live reload gets. The listener goes on when the server starts serving
+ * and comes off when it closes, so a message recorded before or after reaches
+ * no console.
+ */
+export class SimLocalMessageLogging {
+    simAws;
+    logging;
+    output;
+    #unlisten;
+    constructor(properties) {
+        this.simAws = properties.simAws;
+        this.logging = new SimMessageLogging(properties.option);
+        this.output = new SimMessageLogConsole({
+            target: properties.target,
+            emailTextLimit: this.logging.emailTextLimit,
+        });
+    }
+    /**
+     * Start printing the messages this environment records.
+     *
+     * A server asked for no kinds at all listens to nothing.
+     */
+    serving() {
+        if (!this.logging.any) {
+            return;
+        }
+        this.#unlisten = this.simAws.serviceFactory.messageLog.listen((message) => {
+            if (this.logging.prints(message.kind)) {
+                this.output.print(message);
+            }
+        });
+    }
+    /**
+     * Stop printing.
+     */
+    stopping() {
+        this.#unlisten?.();
+        this.#unlisten = undefined;
+    }
+}
+//# sourceMappingURL=sim-local-message-logging.js.map

package/dist/serve/message/sim-local-message-logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-local-message-logging.js","sourceRoot":"","sources":["../../../src/serve/message/sim-local-message-logging.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,oBAAoB,GAErB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,iBAAiB,GAElB,MAAM,0BAA0B,CAAC;AAYlC;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAsB;IAChB,MAAM,CAAS;IACf,OAAO,CAAoB;IAC3B,MAAM,CAAuB;IAE9C,SAAS,CAAoC;IAE7C,YAAY,UAA4C;QACtD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,IAAI,iBAAiB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,GAAG,IAAI,oBAAoB,CAAC;YACrC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc;SAC5C,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACtB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;YACxE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/dist/serve/message/sim-message-indent.d.ts

@@ -0,0 +1,10 @@
+/**
+ * How far a message body is indented under the line that introduces it.
+ */
+export declare const bodyIndent = "  ";
+/**
+ * A body indented under the line introducing it, line by line, so a message
+ * running to several lines stays one readable block.
+ */
+export declare function indented(body: string, indent?: string): readonly string[];
+//# sourceMappingURL=sim-message-indent.d.ts.map

package/dist/serve/message/sim-message-indent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-message-indent.d.ts","sourceRoot":"","sources":["../../../src/serve/message/sim-message-indent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,UAAU,OAAO,CAAC;AAE/B;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAmB,GAC1B,SAAS,MAAM,EAAE,CAEnB"}

package/dist/serve/message/sim-message-indent.js

@@ -0,0 +1,12 @@
+/**
+ * How far a message body is indented under the line that introduces it.
+ */
+export const bodyIndent = "  ";
+/**
+ * A body indented under the line introducing it, line by line, so a message
+ * running to several lines stays one readable block.
+ */
+export function indented(body, indent = bodyIndent) {
+    return body.split("\n").map((line) => `${indent}${line}`);
+}
+//# sourceMappingURL=sim-message-indent.js.map

package/dist/serve/message/sim-message-indent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-message-indent.js","sourceRoot":"","sources":["../../../src/serve/message/sim-message-indent.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,MAAM,GAAW,UAAU;IAE3B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/serve/message/sim-message-log-console.d.ts

@@ -0,0 +1,59 @@
+import type { SimAwsLoggedMessage } from "../../service/aws/message/sim-aws-logged-message.js";
+/**
+ * The console a message is printed to, as much of it as printing needs.
+ */
+export interface SimMessageConsole {
+    log: (line: string) => void;
+}
+interface SimMessageLogConsoleProperties {
+    /**
+     * Where the lines go. The process console unless a test wants to read them.
+     */
+    readonly target?: SimMessageConsole | undefined;
+    /**
+     * How much of an email's text body is printed. See `SimEmailLogBlock`.
+     */
+    readonly emailTextLimit?: number | undefined;
+}
+/**
+ * Prints the messages a served environment would have sent.
+ *
+ * One block per message: a first line saying which service sent it and where
+ * it went, then the body indented under it. The body is what a reader is
+ * after, since the confirmation code is in it, and the first line is what
+ * tells two sign-ups apart.
+ *
+ * It goes to the console because the simulator has no logger of its own, the
+ * same as every warning it raises.
+ */
+export declare class SimMessageLogConsole {
+    private readonly console;
+    private readonly email;
+    constructor(properties?: SimMessageLogConsoleProperties);
+    /**
+     * Print one message.
+     */
+    print(message: SimAwsLoggedMessage): void;
+    /**
+     * The lines one message prints as.
+     */
+    private block;
+    /**
+     * A pool message, with its subject where the medium has one.
+     *
+     * The occasion is on the first line because a pool sends the same wording on
+     * more than one of them, and a code that arrived from a resend looks exactly
+     * like the one from the sign-up otherwise.
+     */
+    private cognitoBlock;
+    /**
+     * One text message, marked where the opt-out list stopped it.
+     *
+     * A suppressed message is printed like any other. The publish succeeded and
+     * nothing arrived, and a reader waiting for a code that will never come
+     * needs to be told which of the two happened.
+     */
+    private smsBlock;
+}
+export {};
+//# sourceMappingURL=sim-message-log-console.d.ts.map

package/dist/serve/message/sim-message-log-console.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-message-log-console.d.ts","sourceRoot":"","sources":["../../../src/serve/message/sim-message-log-console.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,qDAAqD,CAAC;AAI7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,UAAU,8BAA8B;IACtC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IAEzC,YAAY,UAAU,GAAE,8BAAmC,EAK1D;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAExC;IAED;;OAEG;IACH,OAAO,CAAC,KAAK;IAcb;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAapB;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ;CAUjB"}

package/dist/serve/message/sim-message-log-console.js

@@ -0,0 +1,79 @@
+import { SimEmailLogBlock } from "./sim-email-log-block.js";
+import { bodyIndent, indented } from "./sim-message-indent.js";
+/**
+ * Prints the messages a served environment would have sent.
+ *
+ * One block per message: a first line saying which service sent it and where
+ * it went, then the body indented under it. The body is what a reader is
+ * after, since the confirmation code is in it, and the first line is what
+ * tells two sign-ups apart.
+ *
+ * It goes to the console because the simulator has no logger of its own, the
+ * same as every warning it raises.
+ */
+export class SimMessageLogConsole {
+    console;
+    email;
+    constructor(properties = {}) {
+        this.console = properties.target ?? console;
+        this.email = new SimEmailLogBlock({
+            emailTextLimit: properties.emailTextLimit,
+        });
+    }
+    /**
+     * Print one message.
+     */
+    print(message) {
+        this.console.log(this.block(message).join("\n"));
+    }
+    /**
+     * The lines one message prints as.
+     */
+    block(message) {
+        switch (message.kind) {
+            case "cognito": {
+                return this.cognitoBlock(message);
+            }
+            case "sns": {
+                return this.smsBlock(message);
+            }
+            case "ses": {
+                return this.email.lines(message);
+            }
+        }
+    }
+    /**
+     * A pool message, with its subject where the medium has one.
+     *
+     * The occasion is on the first line because a pool sends the same wording on
+     * more than one of them, and a code that arrived from a resend looks exactly
+     * like the one from the sign-up otherwise.
+     */
+    cognitoBlock(message) {
+        const medium = message.medium === "EMAIL" ? "email" : "SMS";
+        const lines = [
+            `sim Cognito ${message.userPoolId}: ${medium} to ${message.recipient} (${message.occasion})`,
+        ];
+        if (message.subject !== undefined) {
+            lines.push(`${bodyIndent}Subject: ${message.subject}`);
+        }
+        return [...lines, ...indented(message.body)];
+    }
+    /**
+     * One text message, marked where the opt-out list stopped it.
+     *
+     * A suppressed message is printed like any other. The publish succeeded and
+     * nothing arrived, and a reader waiting for a code that will never come
+     * needs to be told which of the two happened.
+     */
+    smsBlock(message) {
+        const suppression = message.suppressed
+            ? " (suppressed, number opted out)"
+            : "";
+        return [
+            `sim SNS: SMS to ${message.phoneNumber}${suppression}`,
+            ...indented(message.message),
+        ];
+    }
+}
+//# sourceMappingURL=sim-message-log-console.js.map

package/dist/serve/message/sim-message-log-console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-message-log-console.js","sourceRoot":"","sources":["../../../src/serve/message/sim-message-log-console.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAqB/D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,oBAAoB;IACd,OAAO,CAAoB;IAC3B,KAAK,CAAmB;IAEzC,YAAY,UAAU,GAAmC,EAAE;QACzD,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,MAAM,IAAI,OAAO,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,IAAI,gBAAgB,CAAC;YAChC,cAAc,EAAE,UAAU,CAAC,cAAc;SAC1C,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAA4B;QAChC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,OAA4B;QACxC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;YACrB,KAAK,SAAS,EAAE,CAAC;gBACf,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;YACpC,CAAC;YACD,KAAK,KAAK,EAAE,CAAC;gBACX,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAChC,CAAC;YACD,KAAK,KAAK,EAAE,CAAC;gBACX,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,YAAY,CAAC,OAAgC;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5D,MAAM,KAAK,GAAG;YACZ,eAAe,OAAO,CAAC,UAAU,KAAK,MAAM,OAAO,OAAO,CAAC,SAAS,KAAK,OAAO,CAAC,QAAQ,GAAG;SAC7F,CAAC;QAEF,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,GAAG,UAAU,YAAY,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,OAAO,CAAC,GAAG,KAAK,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;;OAMG;IACK,QAAQ,CAAC,OAAwB;QACvC,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU;YACpC,CAAC,CAAC,iCAAiC;YACnC,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,mBAAmB,OAAO,CAAC,WAAW,GAAG,WAAW,EAAE;YACtD,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;SAC7B,CAAC;IACJ,CAAC;CACF"}