@kensio/yulin 1.21.1 → 1.21.3

package/dist/service/ses/email/sim-ses-sent-email-store.d.ts

@@ -26,6 +26,14 @@ export declare class SimSesSentEmailStore {
      * Every message this scope has accepted, oldest first.
      */
     get all(): readonly SimSesSentEmail[];
+    /**
+     * Find an accepted message by the id SES returned for it.
+     */
+    find(messageId: string): SimSesSentEmail | undefined;
+    /**
+     * Get an accepted message by id, refusing an id this scope never issued.
+     */
+    require(messageId: string): SimSesSentEmail;
     /**
      * Keep a message SES has accepted.
      *

package/dist/service/ses/email/sim-ses-sent-email-store.js

@@ -1,4 +1,5 @@
 import { SimAwsMessageLog } from "../../aws/message/sim-aws-message-log.js";
+import { SimSesFeedbackError } from "../error/sim-ses.error.js";
 const hoursInADay = 24;
 const millisecondsInAnHour = 60 * 60 * 1000;
 /**
@@ -25,6 +26,22 @@ export class SimSesSentEmailStore {
     get all() {
         return [...this.#sent];
     }
+    /**
+     * Find an accepted message by the id SES returned for it.
+     */
+    find(messageId) {
+        return this.#sent.find((email) => email.messageId === messageId);
+    }
+    /**
+     * Get an accepted message by id, refusing an id this scope never issued.
+     */
+    require(messageId) {
+        const email = this.find(messageId);
+        if (email === undefined) {
+            throw new SimSesFeedbackError(`No accepted sim SES message has id ${messageId}.`);
+        }
+        return email;
+    }
     /**
      * Keep a message SES has accepted.
      *

package/dist/service/ses/email/sim-ses-sent-email.d.ts

@@ -19,6 +19,21 @@ export interface SimSesSentEmailBody {
     readonly text: string | undefined;
     readonly html: string | undefined;
 }
+/**
+ * One structured attachment on a simple message.
+ *
+ * The bytes and metadata use the values from the SendEmail request. SES would
+ * use them to assemble MIME content after accepting the request.
+ */
+export interface SimSesSentEmailAttachment {
+    readonly rawContent: Uint8Array;
+    readonly fileName: string;
+    readonly contentType: string | undefined;
+    readonly contentDisposition: "ATTACHMENT" | "INLINE" | undefined;
+    readonly contentDescription: string | undefined;
+    readonly contentId: string | undefined;
+    readonly contentTransferEncoding: "BASE64" | "QUOTED_PRINTABLE" | "SEVEN_BIT" | undefined;
+}
 /**
  * A recipient the account's suppression list held back.
  *
@@ -37,6 +52,7 @@ interface SimSesSentEmailProperties {
     readonly replyToAddresses: readonly string[];
     readonly subject: string;
     readonly body: SimSesSentEmailBody;
+    readonly attachments: readonly SimSesSentEmailAttachment[];
     readonly templateName: string | undefined;
     readonly templateData: Readonly<Record<string, unknown>> | undefined;
     readonly configurationSetName: string | undefined;
@@ -64,6 +80,8 @@ export declare class SimSesSentEmail {
     readonly replyToAddresses: readonly string[];
     readonly subject: string;
     readonly body: SimSesSentEmailBody;
+    /** Structured attachments in request order. */
+    readonly attachments: readonly SimSesSentEmailAttachment[];
     /**
      * The template this message was rendered from, if it was rendered from a
      * stored one. A message written out in full has none, and so does one

package/dist/service/ses/email/sim-ses-sent-email.js

@@ -19,6 +19,8 @@ export class SimSesSentEmail {
     replyToAddresses;
     subject;
     body;
+    /** Structured attachments in request order. */
+    attachments;
     /**
      * The template this message was rendered from, if it was rendered from a
      * stored one. A message written out in full has none, and so does one
@@ -51,6 +53,7 @@ export class SimSesSentEmail {
         this.replyToAddresses = properties.replyToAddresses;
         this.subject = properties.subject;
         this.body = properties.body;
+        this.attachments = properties.attachments;
         this.templateName = properties.templateName;
         this.templateData = properties.templateData;
         this.configurationSetName = properties.configurationSetName;

package/dist/service/ses/error/sim-ses.error.d.ts

@@ -79,3 +79,13 @@ export declare class SimSesSendingPausedException extends SimSesError {
     readonly name = "SendingPausedException";
     constructor(message: string);
 }
+/**
+ * A feedback event that cannot belong to the recorded message it names.
+ *
+ * This is a simulator diagnostic rather than an AWS error. A test supplies
+ * feedback through `recordFeedback`, and the error is raised at that call so
+ * an unrelated message or recipient cannot alter the suppression list.
+ */
+export declare class SimSesFeedbackError extends SimSesError {
+    readonly name = "SimSesFeedbackError";
+}

package/dist/service/ses/error/sim-ses.error.js

@@ -88,3 +88,13 @@ export class SimSesSendingPausedException extends SimSesError {
         super(message, { httpStatusCode: 400 });
     }
 }
+/**
+ * A feedback event that cannot belong to the recorded message it names.
+ *
+ * This is a simulator diagnostic rather than an AWS error. A test supplies
+ * feedback through `recordFeedback`, and the error is raised at that call so
+ * an unrelated message or recipient cannot alter the suppression list.
+ */
+export class SimSesFeedbackError extends SimSesError {
+    name = "SimSesFeedbackError";
+}

package/dist/service/ses/feedback/sim-ses-feedback-recorder.d.ts

@@ -0,0 +1,34 @@
+import type { SimClock } from "../../../util/clock/sim-clock.js";
+import type { SimSesAccount } from "../account/sim-ses-account.js";
+import type { SimSesConfigurationSetStore } from "../configuration-set/sim-ses-configuration-set-store.js";
+import type { SimSesSentEmailStore } from "../email/sim-ses-sent-email-store.js";
+import type { SimSesSuppressionList } from "../suppression/sim-ses-suppression-list.js";
+import { type SimSesSuppressionReason } from "../suppression/sim-ses-suppression-reason.js";
+import type { SimSesSuppressedDestination } from "../suppression/sim-ses-suppressed-destination.js";
+/** A hard bounce or complaint reported for one accepted message recipient. */
+export interface SimSesFeedback {
+    readonly messageId: string;
+    readonly emailAddress: string;
+    readonly reason: SimSesSuppressionReason;
+}
+interface SimSesFeedbackRecorderProperties {
+    readonly sent: SimSesSentEmailStore;
+    readonly configurationSets: SimSesConfigurationSetStore;
+    readonly account: SimSesAccount;
+    readonly suppression: SimSesSuppressionList;
+    readonly clock: SimClock;
+}
+/** Applies explicit delivery feedback to the account suppression list. */
+export declare class SimSesFeedbackRecorder {
+    #private;
+    constructor(properties: SimSesFeedbackRecorderProperties);
+    /**
+     * Record a hard bounce or complaint for one recipient of an accepted
+     * message.
+     *
+     * The returned entry is undefined when suppression for the feedback reason
+     * was inactive for this send.
+     */
+    record(feedback: SimSesFeedback): SimSesSuppressedDestination | undefined;
+}
+export {};

package/dist/service/ses/feedback/sim-ses-feedback-recorder.js

@@ -0,0 +1,55 @@
+import { simSesBareAddress } from "../email/sim-ses-address.js";
+import { SimSesFeedbackError } from "../error/sim-ses.error.js";
+import { requiredSimSesSuppressionAddress } from "../suppression/sim-ses-suppression-address.js";
+import { requiredSimSesSuppressionReason, } from "../suppression/sim-ses-suppression-reason.js";
+/** Applies explicit delivery feedback to the account suppression list. */
+export class SimSesFeedbackRecorder {
+    #sent;
+    #configurationSets;
+    #account;
+    #suppression;
+    #clock;
+    constructor(properties) {
+        this.#sent = properties.sent;
+        this.#configurationSets = properties.configurationSets;
+        this.#account = properties.account;
+        this.#suppression = properties.suppression;
+        this.#clock = properties.clock;
+    }
+    /**
+     * Record a hard bounce or complaint for one recipient of an accepted
+     * message.
+     *
+     * The returned entry is undefined when suppression for the feedback reason
+     * was inactive for this send.
+     */
+    record(feedback) {
+        const email = this.#sent.require(feedback.messageId);
+        const emailAddress = requiredSimSesSuppressionAddress(feedback.emailAddress);
+        const reason = requiredSimSesSuppressionReason(feedback.reason);
+        const recipient = this.#recipient(email, emailAddress);
+        if (!this.#isActive(email, reason)) {
+            return undefined;
+        }
+        return this.#suppression.put(recipient, reason, this.#clock.now());
+    }
+    #recipient(email, emailAddress) {
+        const wanted = emailAddress.toLowerCase();
+        const recipient = email.recipients
+            .map((address) => simSesBareAddress(address))
+            .find((address) => address.toLowerCase() === wanted);
+        if (recipient === undefined) {
+            throw new SimSesFeedbackError(`${emailAddress} is not a recipient of sim SES message ${email.messageId}.`);
+        }
+        return recipient;
+    }
+    #isActive(email, reason) {
+        if (email.configurationSetName !== undefined) {
+            const configurationSet = this.#configurationSets.find(email.configurationSetName);
+            if (configurationSet?.suppressedReasons !== undefined) {
+                return configurationSet.suppressedReasons.includes(reason);
+            }
+        }
+        return this.#account.isSuppressedFor(reason);
+    }
+}

package/dist/service/ses/index.d.ts

@@ -9,11 +9,12 @@ export { requiredSimSesIdentityName, simSesIdentityDomain, simSesIdentityKey, ty
 export { simSesArnPrefix, simSesConfigurationSetArn, simSesIdentityArn, } from "./sim-ses-arn.js";
 export { SimSesConfigurationSet, type SimSesConfigurationSetDeliveryOptions, type SimSesConfigurationSetOptions, type SimSesConfigurationSetReputationOptions, type SimSesSuppressedReason, } from "./configuration-set/sim-ses-configuration-set.js";
 export { SimSesConfigurationSetStore } from "./configuration-set/sim-ses-configuration-set-store.js";
-export { SimSesSentEmail, type SimSesSentEmailBody, type SimSesSentEmailDestination, type SimSesSuppressedRecipient, } from "./email/sim-ses-sent-email.js";
+export { SimSesSentEmail, type SimSesSentEmailAttachment, type SimSesSentEmailBody, type SimSesSentEmailDestination, type SimSesSuppressedRecipient, } from "./email/sim-ses-sent-email.js";
 export { SimSesSentEmailStore } from "./email/sim-ses-sent-email-store.js";
+export { type SimSesFeedback, SimSesFeedbackRecorder, } from "./feedback/sim-ses-feedback-recorder.js";
 export { requiredSimSesFromAddress, simSesBareAddress, } from "./email/sim-ses-address.js";
 export { SimSesSuppressedDestination } from "./suppression/sim-ses-suppressed-destination.js";
 export { SimSesSuppressionList } from "./suppression/sim-ses-suppression-list.js";
 export { requiredSimSesSuppressionReason, type SimSesSuppressionReason, } from "./suppression/sim-ses-suppression-reason.js";
 export { SimSesAccount, type SimSesAccountContactDetails, type SimSesSendQuota, } from "./account/sim-ses-account.js";
-export { SimSesAlreadyExistsException, SimSesBadRequestException, SimSesError, type SimSesErrorMetadata, SimSesMessageRejected, SimSesNotFoundException, SimSesSendingPausedException, SimSesUnsupportedOperationException, } from "./error/sim-ses.error.js";
+export { SimSesAlreadyExistsException, SimSesBadRequestException, SimSesError, SimSesFeedbackError, type SimSesErrorMetadata, SimSesMessageRejected, SimSesNotFoundException, SimSesSendingPausedException, SimSesUnsupportedOperationException, } from "./error/sim-ses.error.js";

package/dist/service/ses/index.js

@@ -8,9 +8,10 @@ export { SimSesConfigurationSet, } from "./configuration-set/sim-ses-configurati
 export { SimSesConfigurationSetStore } from "./configuration-set/sim-ses-configuration-set-store.js";
 export { SimSesSentEmail, } from "./email/sim-ses-sent-email.js";
 export { SimSesSentEmailStore } from "./email/sim-ses-sent-email-store.js";
+export { SimSesFeedbackRecorder, } from "./feedback/sim-ses-feedback-recorder.js";
 export { requiredSimSesFromAddress, simSesBareAddress, } from "./email/sim-ses-address.js";
 export { SimSesSuppressedDestination } from "./suppression/sim-ses-suppressed-destination.js";
 export { SimSesSuppressionList } from "./suppression/sim-ses-suppression-list.js";
 export { requiredSimSesSuppressionReason, } from "./suppression/sim-ses-suppression-reason.js";
 export { SimSesAccount, } from "./account/sim-ses-account.js";
-export { SimSesAlreadyExistsException, SimSesBadRequestException, SimSesError, SimSesMessageRejected, SimSesNotFoundException, SimSesSendingPausedException, SimSesUnsupportedOperationException, } from "./error/sim-ses.error.js";
+export { SimSesAlreadyExistsException, SimSesBadRequestException, SimSesError, SimSesFeedbackError, SimSesMessageRejected, SimSesNotFoundException, SimSesSendingPausedException, SimSesUnsupportedOperationException, } from "./error/sim-ses.error.js";

package/dist/service/ses/sim-ses-commands.d.ts

@@ -11,6 +11,7 @@ import { SimSesServiceSend } from "./command/send/sim-ses-service-send.js";
 import { SimSesSuppressionCommands } from "./command/suppression/sim-ses-suppression-commands.js";
 import { SimSesSuppressionList } from "./suppression/sim-ses-suppression-list.js";
 import { SimSesSentEmailStore } from "./email/sim-ses-sent-email-store.js";
+import { SimSesFeedbackRecorder } from "./feedback/sim-ses-feedback-recorder.js";
 import { SimSesConfigurationSetStore } from "./configuration-set/sim-ses-configuration-set-store.js";
 import { SimSesIdentityStore } from "./identity/sim-ses-identity-store.js";
 import { SimSesTemplateCommands } from "./command/template/sim-ses-template-commands.js";
@@ -43,6 +44,7 @@ export declare class SimSesCommands {
     readonly templateCommands: SimSesTemplateCommands;
     readonly configurationSetCommands: SimSesConfigurationSetCommands;
     readonly sendEmail: SimSesSendEmail;
+    readonly feedback: SimSesFeedbackRecorder;
     /**
      * The way another simulated service reaches this SES, which is the send
      * without the IAM authorization a caller's request goes through.

package/dist/service/ses/sim-ses-commands.js

@@ -16,6 +16,7 @@ import { SimSesVerifiedIdentityCheck } from "./command/send/sim-ses-verified-ide
 import { SimSesSuppressionCommands } from "./command/suppression/sim-ses-suppression-commands.js";
 import { SimSesSuppressionList } from "./suppression/sim-ses-suppression-list.js";
 import { SimSesSentEmailStore } from "./email/sim-ses-sent-email-store.js";
+import { SimSesFeedbackRecorder } from "./feedback/sim-ses-feedback-recorder.js";
 import { SimSesConfigurationSetStore } from "./configuration-set/sim-ses-configuration-set-store.js";
 import { SimSesIdentityStore } from "./identity/sim-ses-identity-store.js";
 import { SimSesTemplateCommands } from "./command/template/sim-ses-template-commands.js";
@@ -39,6 +40,7 @@ export class SimSesCommands {
     templateCommands;
     configurationSetCommands;
     sendEmail;
+    feedback;
     /**
      * The way another simulated service reaches this SES, which is the send
      * without the IAM authorization a caller's request goes through.
@@ -103,6 +105,13 @@ export class SimSesCommands {
             authorizer,
             clock: background,
         });
+        this.feedback = new SimSesFeedbackRecorder({
+            sent,
+            configurationSets,
+            account,
+            suppression,
+            clock: background,
+        });
         this.serviceSend = new SimSesServiceSend({
             sent,
             identityCheck,

package/dist/service/ses/sim-ses-configuration-sets.d.ts

@@ -10,10 +10,10 @@ import { SimSesSuppression } from "./sim-ses-suppression.js";
  * separate classes because one class holding every SES operation grows by a
  * method with each one added.
  *
- * A configuration set here is state and no behaviour. Its suppression reasons,
- * sending switch, delivery options and reputation switch are all held and read
- * back, and nothing acts on any of them. A send naming a set keeps the name on
- * its record and goes no further.
+ * A configuration set holds suppression reasons, the sending switch, delivery
+ * options and the reputation switch. The sending switch acts on acceptance.
+ * Suppression reasons act when feedback is recorded for an accepted message.
+ * The remaining options are held for a test to read back.
  */
 export declare abstract class SimSesConfigurationSets extends SimSesSuppression {
     /**

package/dist/service/ses/sim-ses-configuration-sets.js

@@ -7,10 +7,10 @@ import { SimSesSuppression } from "./sim-ses-suppression.js";
  * separate classes because one class holding every SES operation grows by a
  * method with each one added.
  *
- * A configuration set here is state and no behaviour. Its suppression reasons,
- * sending switch, delivery options and reputation switch are all held and read
- * back, and nothing acts on any of them. A send naming a set keeps the name on
- * its record and goes no further.
+ * A configuration set holds suppression reasons, the sending switch, delivery
+ * options and the reputation switch. The sending switch acts on acceptance.
+ * Suppression reasons act when feedback is recorded for an accepted message.
+ * The remaining options are held for a test to read back.
  */
 export class SimSesConfigurationSets extends SimSesSuppression {
     /**

package/dist/service/ses/sim-ses-suppression.d.ts

@@ -13,8 +13,9 @@ interface SimSesSuppressionProperties {
  * SES operation grows by a method with each one added, and the suppression
  * commands are the part of the API a reader can take in on their own.
  *
- * Real SES fills this list from hard bounces and complaints. Nothing bounces
- * here, so every address on it was put there by a caller.
+ * Real SES fills this list from hard bounces and complaints. A test supplies
+ * that feedback explicitly, and callers may also manage entries through the
+ * suppression commands.
  */
 export declare abstract class SimSesSuppression {
     protected readonly commands: SimSesCommands;

package/dist/service/ses/sim-ses-suppression.js

@@ -6,8 +6,9 @@
  * SES operation grows by a method with each one added, and the suppression
  * commands are the part of the API a reader can take in on their own.
  *
- * Real SES fills this list from hard bounces and complaints. Nothing bounces
- * here, so every address on it was put there by a caller.
+ * Real SES fills this list from hard bounces and complaints. A test supplies
+ * that feedback explicitly, and callers may also manage entries through the
+ * suppression commands.
  */
 export class SimSesSuppression {
     commands;

package/dist/service/ses/sim-ses-v2.d.ts

@@ -3,6 +3,8 @@ import type * as simSesCommands from "./command/sim-ses-command.types.js";
 import type { SimSesRequestOptions } from "./command/sim-ses-request-options.js";
 import type * as simSesServiceSend from "./command/send/sim-ses-service-send.js";
 import type { SimSesSentEmail } from "./email/sim-ses-sent-email.js";
+import type { SimSesFeedback } from "./feedback/sim-ses-feedback-recorder.js";
+import type { SimSesSuppressedDestination } from "./suppression/sim-ses-suppressed-destination.js";
 import type { SimSesIdentity } from "./identity/sim-ses-identity.js";
 import type { SimSesTemplate } from "./template/sim-ses-template.js";
 import { SimSesCfnResourceFactory } from "./cfn/sim-ses-cfn-resource-factory.js";
@@ -39,6 +41,17 @@ export declare class SimSesV2 extends SimSesConfigurationSets {
      * account keeps no such record, which is exactly why a test needs one.
      */
     sentEmails(): readonly SimSesSentEmail[];
+    /**
+     * Record a hard bounce or complaint for one recipient of an accepted
+     * message.
+     *
+     * Real feedback happens after SES hands a message to a mail system. A test
+     * process cannot observe that exchange, so this simulator-side operation
+     * supplies the feedback explicitly. Active feedback adds or updates the
+     * account suppression entry at the current simulated time. Inactive
+     * feedback returns undefined and leaves the list unchanged.
+     */
+    recordFeedback(feedback: SimSesFeedback): SimSesSuppressedDestination | undefined;
     /**
      * Find an identity by the address or domain it names.
      *

package/dist/service/ses/sim-ses-v2.js

@@ -38,6 +38,19 @@ export class SimSesV2 extends SimSesConfigurationSets {
     sentEmails() {
         return this.commands.sent.all;
     }
+    /**
+     * Record a hard bounce or complaint for one recipient of an accepted
+     * message.
+     *
+     * Real feedback happens after SES hands a message to a mail system. A test
+     * process cannot observe that exchange, so this simulator-side operation
+     * supplies the feedback explicitly. Active feedback adds or updates the
+     * account suppression entry at the current simulated time. Inactive
+     * feedback returns undefined and leaves the list unchanged.
+     */
+    recordFeedback(feedback) {
+        return this.commands.feedback.record(feedback);
+    }
     /**
      * Find an identity by the address or domain it names.
      *

package/dist/service/ses/suppression/sim-ses-suppressed-destination.d.ts

@@ -7,10 +7,9 @@ interface SimSesSuppressedDestinationProperties {
 /**
  * One address on an account's suppression list.
  *
- * Real SES also reports a `MessageId` and a `FeedbackId` on the address it put
- * there itself, describing the bounce or complaint that did it. Nothing
- * bounces here, so every address on this list was put there by hand and there
- * is no feedback event to point at.
+ * Real SES also reports a `MessageId` and a `FeedbackId` on an address added by
+ * delivery feedback. This simulation records the reason and time only. It
+ * does not publish or retain a feedback event.
  */
 export declare class SimSesSuppressedDestination {
     /** The address as it was given, case and all. */

package/dist/service/ses/suppression/sim-ses-suppressed-destination.js

@@ -1,10 +1,9 @@
 /**
  * One address on an account's suppression list.
  *
- * Real SES also reports a `MessageId` and a `FeedbackId` on the address it put
- * there itself, describing the bounce or complaint that did it. Nothing
- * bounces here, so every address on this list was put there by hand and there
- * is no feedback event to point at.
+ * Real SES also reports a `MessageId` and a `FeedbackId` on an address added by
+ * delivery feedback. This simulation records the reason and time only. It
+ * does not publish or retain a feedback event.
  */
 export class SimSesSuppressedDestination {
     /** The address as it was given, case and all. */

package/dist/service/ses/suppression/sim-ses-suppression-list.d.ts

@@ -3,10 +3,10 @@ import type { SimSesSuppressionReason } from "./sim-ses-suppression-reason.js";
 /**
  * The account-level suppression list of one simulated SES scope.
  *
- * Real SES fills this from hard bounces and complaints. Nothing bounces here,
- * so every address on it was put there by a caller, which is the point: an
- * application's own support tooling and operations scripts have somewhere to
- * run.
+ * Real SES fills this from hard bounces and complaints. A test supplies those
+ * events through the simulator's feedback operation. The ordinary suppression
+ * commands also manage the same entries, giving application support tooling
+ * and operations scripts somewhere to run.
  *
  * The list is region scoped, as identities and sends are. An address
  * suppressed in one region says nothing about another.

package/dist/service/ses/suppression/sim-ses-suppression-list.js

@@ -3,10 +3,10 @@ import { SimSesSuppressedDestination } from "./sim-ses-suppressed-destination.js
 /**
  * The account-level suppression list of one simulated SES scope.
  *
- * Real SES fills this from hard bounces and complaints. Nothing bounces here,
- * so every address on it was put there by a caller, which is the point: an
- * application's own support tooling and operations scripts have somewhere to
- * run.
+ * Real SES fills this from hard bounces and complaints. A test supplies those
+ * events through the simulator's feedback operation. The ordinary suppression
+ * commands also manage the same entries, giving application support tooling
+ * and operations scripts somewhere to run.
  *
  * The list is region scoped, as identities and sends are. An address
  * suppressed in one region says nothing about another.