@kensio/yulin 1.15.1 → 1.16.0

package/dist/service/sqs/message/sim-sqs-message-body.d.ts

@@ -1,10 +1,15 @@
 /**
- * One message body, with the digest a sender checks it by.
+ * The digest SQS reports for a message body.
  *
- * The digest is a real MD5 of the body, as real SQS reports, because that is the
- * whole point of it: a sender comparing `MD5OfMessageBody` against its own
- * digest either finds the body it sent or finds a bug, and a made-up value would
- * tell it nothing.
+ * It is a real MD5 of the body, as real SQS reports, because that is the whole
+ * point of it: a sender comparing `MD5OfMessageBody` against its own digest
+ * either finds the body it sent or finds a bug, and a made-up value would tell
+ * it nothing. An SQS event record carries the same digest of the same body,
+ * which is why this is here rather than inside the message body itself.
+ */
+export declare function simSqsBodyDigest(value: string): string;
+/**
+ * One message body, with the digest a sender checks it by.
  */
 export declare class SimSqsMessageBody {
     readonly value: string;

package/dist/service/sqs/message/sim-sqs-message-body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-sqs-message-body.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-body.ts"],"names":[],"mappings":"AAkCA;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,eAGN;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,iBAAiB,CAgChE;CACF"}
+{"version":3,"file":"sim-sqs-message-body.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-body.ts"],"names":[],"mappings":"AAkCA;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO,eAGN;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,iBAAiB,CAgChE;CACF"}

package/dist/service/sqs/message/sim-sqs-message-body.js

@@ -24,19 +24,26 @@ function isAllowedInBody(codePoint) {
         (codePoint >= firstSupplementary && codePoint <= lastSupplementary));
 }
 /**
- * One message body, with the digest a sender checks it by.
+ * The digest SQS reports for a message body.
  *
- * The digest is a real MD5 of the body, as real SQS reports, because that is the
- * whole point of it: a sender comparing `MD5OfMessageBody` against its own
- * digest either finds the body it sent or finds a bug, and a made-up value would
- * tell it nothing.
+ * It is a real MD5 of the body, as real SQS reports, because that is the whole
+ * point of it: a sender comparing `MD5OfMessageBody` against its own digest
+ * either finds the body it sent or finds a bug, and a made-up value would tell
+ * it nothing. An SQS event record carries the same digest of the same body,
+ * which is why this is here rather than inside the message body itself.
+ */
+export function simSqsBodyDigest(value) {
+    return createHash("md5").update(value, "utf8").digest("hex");
+}
+/**
+ * One message body, with the digest a sender checks it by.
  */
 export class SimSqsMessageBody {
     value;
     digest;
     constructor(value) {
         this.value = value;
-        this.digest = createHash("md5").update(value, "utf8").digest("hex");
+        this.digest = simSqsBodyDigest(value);
     }
     /**
      * Read a message body, refusing one real SQS would refuse.

package/dist/service/sqs/message/sim-sqs-message-body.js.map

@@ -1 +1 @@
-{"version":3,"file":"sim-sqs-message-body.js","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-body.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,KAAK,GAAG,IAAI,CAAC;AACnB,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACjC,MAAM,eAAe,GAAG,OAAO,CAAC;AAChC,MAAM,cAAc,GAAG,OAAO,CAAC;AAC/B,MAAM,kBAAkB,GAAG,SAAS,CAAC;AACrC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAErC;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,SAAiB;IACxC,IAAI,wBAAwB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,CAAC,SAAS,IAAI,KAAK,IAAI,SAAS,IAAI,gBAAgB,CAAC;QACrD,CAAC,SAAS,IAAI,eAAe,IAAI,SAAS,IAAI,cAAc,CAAC;QAC7D,CAAC,SAAS,IAAI,kBAAkB,IAAI,SAAS,IAAI,iBAAiB,CAAC,CACpE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,iBAAiB;IACZ,KAAK,CAAS;IACd,MAAM,CAAS;IAE/B,YAAoB,KAAa;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAa,EAAE,YAAoB;QAC3C,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,2BAA2B,CACnC,oDAAoD,CACrD,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAEpD,IAAI,UAAU,GAAG,YAAY,EAAE,CAAC;YAC9B,MAAM,IAAI,2BAA2B,CACnC,sEAAsE;gBACpE,QAAQ,MAAM,CAAC,YAAY,CAAC,0BAA0B;gBACtD,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CACjC,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,kDAAkD;QAClD,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAE3C,aAAa,CAAC,SAAS,EAAE,wCAAwC,CAAC,CAAC;YAEnE,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,4BAA4B,CACpC,yDAAyD,CAC1D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"sim-sqs-message-body.js","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-body.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EACL,4BAA4B,EAC5B,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,KAAK,GAAG,IAAI,CAAC;AACnB,MAAM,gBAAgB,GAAG,OAAO,CAAC;AACjC,MAAM,eAAe,GAAG,OAAO,CAAC;AAChC,MAAM,cAAc,GAAG,OAAO,CAAC;AAC/B,MAAM,kBAAkB,GAAG,SAAS,CAAC;AACrC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAErC;;;;;;GAMG;AACH,SAAS,eAAe,CAAC,SAAiB;IACxC,IAAI,wBAAwB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,CAAC,SAAS,IAAI,KAAK,IAAI,SAAS,IAAI,gBAAgB,CAAC;QACrD,CAAC,SAAS,IAAI,eAAe,IAAI,SAAS,IAAI,cAAc,CAAC;QAC7D,CAAC,SAAS,IAAI,kBAAkB,IAAI,SAAS,IAAI,iBAAiB,CAAC,CACpE,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACZ,KAAK,CAAS;IACd,MAAM,CAAS;IAE/B,YAAoB,KAAa;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAa,EAAE,YAAoB;QAC3C,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,2BAA2B,CACnC,oDAAoD,CACrD,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAEpD,IAAI,UAAU,GAAG,YAAY,EAAE,CAAC;YAC9B,MAAM,IAAI,2BAA2B,CACnC,sEAAsE;gBACpE,QAAQ,MAAM,CAAC,YAAY,CAAC,0BAA0B;gBACtD,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CACjC,CAAC;QACJ,CAAC;QAED,0EAA0E;QAC1E,kDAAkD;QAClD,KAAK,MAAM,SAAS,IAAI,KAAK,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAE3C,aAAa,CAAC,SAAS,EAAE,wCAAwC,CAAC,CAAC;YAEnE,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,4BAA4B,CACpC,yDAAyD,CAC1D,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/util/factory/sim-records-event.factory.d.ts

@@ -0,0 +1,60 @@
+import type { DeepPartialObject, ItemFactory } from "@kensio/part-factory";
+/**
+ * An event delivered as a list of records, which is the shape AWS uses
+ * wherever a source can batch: SQS, DynamoDB streams, S3 notifications.
+ */
+export interface SimRecordsEvent<Record_ extends object> {
+    readonly Records: readonly Record_[];
+}
+/**
+ * What a test says about the records it wants the event to carry.
+ *
+ * This is `DeepPartialObject<SimRecordsEvent<Record_>>` written out. It is
+ * written out because that type only resolves to a list of partial records
+ * once the record type is a real one, which it is at every call, and is not
+ * while the record type is still this class's parameter.
+ */
+interface SimRecordsEventOverrides<Record_ extends object> {
+    readonly Records?: readonly DeepPartialObject<Record_>[] | undefined;
+}
+/**
+ * Makes an event carrying a list of records, from the factory for one record.
+ *
+ * A test says what it cares about in each record and nothing else:
+ *
+ * ```typescript
+ * lambdaSqsEventFactory.make({
+ *   Records: [{ body: "first" }, { body: "second" }],
+ * });
+ * ```
+ *
+ * That is the reason this is a factory of its own rather than a
+ * `DynamicFactory` whose defaults hold one record. Overrides are merged onto
+ * defaults, and merging replaces an array whole rather than element by element,
+ * so a partial record passed that way would reach the test as the only thing
+ * in that record — typed as a complete one, and missing every field the
+ * handler under test reads. Here each partial record is passed through the
+ * record factory instead, so the records are as complete as a delivered event's
+ * are, however many of them a test asks for.
+ *
+ * Asking for no records at all gives an event with none, which is an event no
+ * real source delivers and a handler is still entitled to be tested against.
+ *
+ * One of these is an `ItemFactory` for the event it makes, so it composes with
+ * `VariantFactory` like any other factory. Each service says so where it
+ * exports its own, by typing the export, rather than this class declaring it:
+ * `implements` would have to be checked while the record type is still a
+ * parameter, and the partial of an unresolved type parameter is not yet the
+ * partial object a record's is.
+ */
+export declare class SimRecordsEventFactory<Record_ extends object> {
+    private readonly recordFactory;
+    constructor(recordFactory: ItemFactory<Record_>);
+    /**
+     * Make the event, completing each record a test asked for and defaulting to
+     * a single record when it asked for none in particular.
+     */
+    make(overrides?: SimRecordsEventOverrides<Record_>): SimRecordsEvent<Record_>;
+}
+export {};
+//# sourceMappingURL=sim-records-event.factory.d.ts.map

package/dist/util/factory/sim-records-event.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-records-event.factory.d.ts","sourceRoot":"","sources":["../../../src/util/factory/sim-records-event.factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE3E;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,OAAO,SAAS,MAAM;IACrD,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,UAAU,wBAAwB,CAAC,OAAO,SAAS,MAAM;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,iBAAiB,CAAC,OAAO,CAAC,EAAE,GAAG,SAAS,CAAC;CACtE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,sBAAsB,CAAC,OAAO,SAAS,MAAM;IACxD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IAErD,YAAY,aAAa,EAAE,WAAW,CAAC,OAAO,CAAC,EAE9C;IAED;;;OAGG;IACH,IAAI,CACF,SAAS,GAAE,wBAAwB,CAAC,OAAO,CAAM,GAChD,eAAe,CAAC,OAAO,CAAC,CAM1B;CACF"}

package/dist/util/factory/sim-records-event.factory.js

@@ -0,0 +1,47 @@
+/**
+ * Makes an event carrying a list of records, from the factory for one record.
+ *
+ * A test says what it cares about in each record and nothing else:
+ *
+ * ```typescript
+ * lambdaSqsEventFactory.make({
+ *   Records: [{ body: "first" }, { body: "second" }],
+ * });
+ * ```
+ *
+ * That is the reason this is a factory of its own rather than a
+ * `DynamicFactory` whose defaults hold one record. Overrides are merged onto
+ * defaults, and merging replaces an array whole rather than element by element,
+ * so a partial record passed that way would reach the test as the only thing
+ * in that record — typed as a complete one, and missing every field the
+ * handler under test reads. Here each partial record is passed through the
+ * record factory instead, so the records are as complete as a delivered event's
+ * are, however many of them a test asks for.
+ *
+ * Asking for no records at all gives an event with none, which is an event no
+ * real source delivers and a handler is still entitled to be tested against.
+ *
+ * One of these is an `ItemFactory` for the event it makes, so it composes with
+ * `VariantFactory` like any other factory. Each service says so where it
+ * exports its own, by typing the export, rather than this class declaring it:
+ * `implements` would have to be checked while the record type is still a
+ * parameter, and the partial of an unresolved type parameter is not yet the
+ * partial object a record's is.
+ */
+export class SimRecordsEventFactory {
+    recordFactory;
+    constructor(recordFactory) {
+        this.recordFactory = recordFactory;
+    }
+    /**
+     * Make the event, completing each record a test asked for and defaulting to
+     * a single record when it asked for none in particular.
+     */
+    make(overrides = {}) {
+        const records = overrides.Records ?? [{}];
+        return {
+            Records: records.map((record) => this.recordFactory.make(record)),
+        };
+    }
+}
+//# sourceMappingURL=sim-records-event.factory.js.map

package/dist/util/factory/sim-records-event.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-records-event.factory.js","sourceRoot":"","sources":["../../../src/util/factory/sim-records-event.factory.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,sBAAsB;IAChB,aAAa,CAAuB;IAErD,YAAY,aAAmC;QAC7C,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,SAAS,GAAsC,EAAE;QAEjD,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC,CAAC;QAE1C,OAAO;YACL,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SAClE,CAAC;IACJ,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kensio/yulin",
-  "version": "1.15.1",
+  "version": "1.16.0",
   "description": "AWS system behaviour simulation for isolated unit testing",
   "repository": "https://github.com/KensioSoftware/yulin",
   "homepage": "https://yulinsim.dev/",
@@ -62,6 +62,10 @@
       "import": "./dist/service/cloudfront/globals.js",
       "types": "./dist/service/cloudfront/globals.d.ts"
     },
+    "./cloudwatch": {
+      "import": "./dist/service/cloudwatch/index.js",
+      "types": "./dist/service/cloudwatch/index.d.ts"
+    },
     "./cognito": {
       "import": "./dist/service/cognito/index.js",
       "types": "./dist/service/cognito/index.d.ts"
@@ -136,6 +140,10 @@
       "import": "./dist/service/secretsmanager/index.js",
       "types": "./dist/service/secretsmanager/index.d.ts"
     },
+    "./ses": {
+      "import": "./dist/service/ses/index.js",
+      "types": "./dist/service/ses/index.d.ts"
+    },
     "./sns": {
       "import": "./dist/service/sns/index.js",
       "types": "./dist/service/sns/index.d.ts"
@@ -174,6 +182,7 @@
     "@aws-sdk/client-cloudformation": "^3.1101.0",
     "@aws-sdk/client-cloudfront": "^3.1101.0",
     "@aws-sdk/client-cloudfront-keyvaluestore": "^3.1108.0",
+    "@aws-sdk/client-cloudwatch": "^3.1111.0",
     "@aws-sdk/client-cloudwatch-logs": "^3.1101.0",
     "@aws-sdk/client-cognito-identity-provider": "^3.1101.0",
     "@aws-sdk/client-dynamodb": "^3.1101.0",
@@ -189,6 +198,7 @@
     "@aws-sdk/client-s3": "^3.1101.0",
     "@aws-sdk/client-scheduler": "^3.1109.0",
     "@aws-sdk/client-secrets-manager": "^3.1101.0",
+    "@aws-sdk/client-sesv2": "^3.1111.0",
     "@aws-sdk/client-sns": "^3.1104.0",
     "@aws-sdk/client-sqs": "^3.1101.0",
     "@aws-sdk/client-ssm": "^3.1101.0",
@@ -217,7 +227,7 @@
     "eslint-plugin-no-secrets": "^2.3.3",
     "eslint-plugin-security": "^4.0.1",
     "eslint-plugin-unicorn": "^72.0.0",
-    "execa": "^9.6.1",
+    "execa": "^10.0.0",
     "fta-cli": "^3.0.0",
     "oxfmt": "^0.62.0",
     "oxlint": "^1.77.0",