@kensio/yulin 1.21.1 → 1.21.2

package/dist/service/ses/command/configuration-set/sim-ses-configuration-set-commands.js

@@ -82,15 +82,13 @@ export class SimSesConfigurationSetCommands {
 /**
  * What GetConfigurationSet answers with.
  *
- * Every group is reported, including the ones the set never declared, because
- * real SES answers with the defaults it applied rather than leaving them out.
+ * Sending, delivery and reputation options report their applied defaults.
+ * Suppression options stay absent unless the set declared an override.
  */
 function reported(configurationSet) {
     return {
         ConfigurationSetName: configurationSet.configurationSetName,
-        SuppressionOptions: {
-            SuppressedReasons: configurationSet.suppressedReasons,
-        },
+        ...reportedSuppressionOptions(configurationSet),
         SendingOptions: { SendingEnabled: configurationSet.sendingEnabled },
         DeliveryOptions: {
             TlsPolicy: configurationSet.deliveryOptions.tlsPolicy,
@@ -102,3 +100,13 @@ function reported(configurationSet) {
         },
     };
 }
+function reportedSuppressionOptions(configurationSet) {
+    if (configurationSet.suppressedReasons === undefined) {
+        return {};
+    }
+    return {
+        SuppressionOptions: {
+            SuppressedReasons: configurationSet.suppressedReasons,
+        },
+    };
+}

package/dist/service/ses/command/configuration-set/sim-ses-configuration-set-options.d.ts

@@ -5,6 +5,6 @@ import type { SimCreateConfigurationSetCommandInput } from "./configuration-set.
  * refuses.
  *
  * A set declaring none of these gets the defaults real SES applies: sending
- * on, no suppression reasons, optional TLS and no reputation metrics.
+ * on, account-level suppression, optional TLS and no reputation metrics.
  */
 export declare function readSimSesConfigurationSetOptions(input: SimCreateConfigurationSetCommandInput): SimSesConfigurationSetOptions;

package/dist/service/ses/command/configuration-set/sim-ses-configuration-set-options.js

@@ -11,11 +11,11 @@ const tlsPolicies = new Set(["REQUIRE", "OPTIONAL"]);
  * refuses.
  *
  * A set declaring none of these gets the defaults real SES applies: sending
- * on, no suppression reasons, optional TLS and no reputation metrics.
+ * on, account-level suppression, optional TLS and no reputation metrics.
  */
 export function readSimSesConfigurationSetOptions(input) {
     return {
-        suppressedReasons: readSuppressedReasons(input.SuppressionOptions?.SuppressedReasons),
+        suppressedReasons: readSuppressedReasons(input.SuppressionOptions),
         sendingEnabled: input.SendingOptions?.SendingEnabled ?? true,
         deliveryOptions: readDeliveryOptions(input.DeliveryOptions),
         reputationOptions: {
@@ -26,15 +26,15 @@ export function readSimSesConfigurationSetOptions(input) {
 /**
  * The suppression reasons a set names, refusing one SES has no meaning for.
  *
- * An absent `SuppressionOptions` leaves this empty. Real SES falls back to the
- * account-level setting there, and this simulation has no account suppression
- * list to fall back to.
+ * An absent `SuppressionOptions` returns undefined, which preserves the
+ * account-level fallback. A present group with no reasons returns an empty
+ * override and disables suppression for messages sent through the set.
  */
-function readSuppressedReasons(reasons) {
-    if (reasons === undefined) {
-        return [];
+function readSuppressedReasons(options) {
+    if (options === undefined) {
+        return undefined;
     }
-    return reasons.map((reason) => {
+    return (options.SuppressedReasons ?? []).map((reason) => {
         if (!isSuppressedReason(reason)) {
             throw new SimSesBadRequestException(`1 validation error detected: Value '${reason}' at ` +
                 `'suppressionOptions.suppressedReasons' failed to satisfy ` +

package/dist/service/ses/command/send/send.command.d.ts

@@ -11,11 +11,20 @@ export interface SimSesBody {
     readonly Text?: SimSesContent | undefined;
     readonly Html?: SimSesContent | undefined;
 }
+export interface SimSesAttachment {
+    readonly RawContent?: Uint8Array | undefined;
+    readonly ContentDisposition?: "ATTACHMENT" | "INLINE" | undefined;
+    readonly FileName?: string | undefined;
+    readonly ContentDescription?: string | undefined;
+    readonly ContentId?: string | undefined;
+    readonly ContentTransferEncoding?: "BASE64" | "QUOTED_PRINTABLE" | "SEVEN_BIT" | undefined;
+    readonly ContentType?: string | undefined;
+}
 export interface SimSesMessage {
     readonly Subject?: SimSesContent | undefined;
     readonly Body?: SimSesBody | undefined;
     readonly Headers?: readonly unknown[] | undefined;
-    readonly Attachments?: readonly unknown[] | undefined;
+    readonly Attachments?: readonly SimSesAttachment[] | undefined;
 }
 export interface SimSesRawMessage {
     readonly Data?: Uint8Array | string | undefined;

package/dist/service/ses/command/send/sim-ses-read-content.d.ts

@@ -1,4 +1,4 @@
-import type { SimSesSentEmailBody } from "../../email/sim-ses-sent-email.js";
+import type { SimSesSentEmailAttachment, SimSesSentEmailBody } from "../../email/sim-ses-sent-email.js";
 /**
  * What a message says, read out of the content of a send.
  *
@@ -11,6 +11,7 @@ import type { SimSesSentEmailBody } from "../../email/sim-ses-sent-email.js";
 export interface SimSesReadContent {
     readonly subject: string;
     readonly body: SimSesSentEmailBody;
+    readonly attachments: readonly SimSesSentEmailAttachment[];
     /** The template this was rendered from, if it was rendered from a stored one. */
     readonly templateName: string | undefined;
     /** The data the placeholders were filled from, parsed out of the JSON. */

package/dist/service/ses/command/send/sim-ses-send-email.js

@@ -65,6 +65,7 @@ export class SimSesSendEmail {
             replyToAddresses: [...(input.ReplyToAddresses ?? [])],
             subject: content.subject,
             body: content.body,
+            attachments: content.attachments,
             templateName: content.templateName,
             templateData: content.templateData,
             configurationSetName,

package/dist/service/ses/command/send/sim-ses-service-send.js

@@ -62,6 +62,7 @@ export class SimSesServiceSend {
             replyToAddresses: [...request.replyToAddresses],
             subject: request.subject,
             body: { text: request.body, html: undefined },
+            attachments: [],
             templateName: undefined,
             templateData: undefined,
             configurationSetName,

package/dist/service/ses/command/send/sim-ses-simple-content.js

@@ -1,4 +1,4 @@
-import { SimSesBadRequestException, SimSesUnsupportedOperationException, } from "../../error/sim-ses.error.js";
+import { SimSesBadRequestException } from "../../error/sim-ses.error.js";
 /**
  * Read a message a send wrote out in full, refusing what real SES refuses and
  * what this simulation does not model.
@@ -8,10 +8,6 @@ import { SimSesBadRequestException, SimSesUnsupportedOperationException, } from
  * not have accepted.
  */
 export function readSimSesSimpleMessage(message) {
-    if (message.Attachments !== undefined) {
-        throw new SimSesUnsupportedOperationException("Attachments are not simulated, so SendEmail refuses them rather than " +
-            "recording a message without them");
-    }
     const subject = message.Subject?.Data;
     if (subject === undefined) {
         throw new SimSesBadRequestException("1 validation error detected: Value at 'content.simple.subject' " +
@@ -26,7 +22,32 @@ export function readSimSesSimpleMessage(message) {
     return {
         subject,
         body: { text, html },
+        attachments: (message.Attachments ?? []).map((attachment, index) => readAttachment(attachment, index)),
         templateName: undefined,
         templateData: undefined,
     };
 }
+/** Read and validate one attachment from a simple message. */
+function readAttachment(attachment, index) {
+    if (attachment.RawContent === undefined) {
+        throw missingAttachmentMember(index, "rawContent");
+    }
+    if (attachment.FileName === undefined) {
+        throw missingAttachmentMember(index, "fileName");
+    }
+    return {
+        rawContent: Uint8Array.from(attachment.RawContent),
+        fileName: attachment.FileName,
+        contentType: attachment.ContentType,
+        contentDisposition: attachment.ContentDisposition,
+        contentDescription: attachment.ContentDescription,
+        contentId: attachment.ContentId,
+        contentTransferEncoding: attachment.ContentTransferEncoding,
+    };
+}
+/** Build the SES validation error for a missing attachment member. */
+function missingAttachmentMember(index, member) {
+    return new SimSesBadRequestException("1 validation error detected: Value at " +
+        `'content.simple.attachments.${String(index)}.${member}' failed to ` +
+        "satisfy constraint: Member must not be null");
+}

package/dist/service/ses/command/send/sim-ses-template-send.js

@@ -35,6 +35,7 @@ export class SimSesTemplateSendReader {
                 text: renderOptional(content.text, data),
                 html: renderOptional(content.html, data),
             },
+            attachments: [],
             templateName: template.TemplateName,
             templateData: data,
         };

package/dist/service/ses/command/suppression/suppression.command.d.ts

@@ -2,8 +2,9 @@ import type { SimResponseMetadata } from "../../../aws/metadata/response-metadat
 /**
  * What a suppression list entry says, in the shape the SES v2 API reports it.
  *
- * `Attributes` is left out. It describes the bounce or complaint SES put the
- * address on the list for, and nothing bounces here.
+ * `Attributes` is left out. Real SES uses it for details of the feedback event
+ * that put the address on the list. Explicit simulator feedback records the
+ * reason and time only.
  */
 export interface SimSesSuppressedDestinationDetail {
     readonly EmailAddress: string;

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

@@ -32,7 +32,7 @@ export interface SimSesConfigurationSetReputationOptions {
  * Everything a configuration set holds apart from its name.
  */
 export interface SimSesConfigurationSetOptions {
-    readonly suppressedReasons: readonly SimSesSuppressedReason[];
+    readonly suppressedReasons: readonly SimSesSuppressedReason[] | undefined;
     readonly sendingEnabled: boolean;
     readonly deliveryOptions: SimSesConfigurationSetDeliveryOptions;
     readonly reputationOptions: SimSesConfigurationSetReputationOptions;
@@ -48,11 +48,9 @@ interface SimSesConfigurationSetProperties {
  * A configuration set is a named group of settings a send can be made under,
  * covering suppression, whether sending is on, how the message is handed on
  * and whether reputation metrics are published. None of it changes what a
- * message says, which is why this is state to read back rather than behaviour
- * to reproduce.
- *
- * Sending is the exception, and it is left to the work that attaches a set to
- * a send. Here the switch is recorded and acted on by nothing.
+ * message says. The sending switch controls acceptance, and the suppression
+ * reasons control feedback. Delivery and reputation options remain state for
+ * a test to read back.
  */
 export declare class SimSesConfigurationSet {
     readonly configurationSetName: string;
@@ -60,11 +58,12 @@ export declare class SimSesConfigurationSet {
     /**
      * The reasons that would put a recipient on the account suppression list.
      *
-     * Empty where the set declares no `SuppressionOptions`. Real SES falls back
-     * to the account setting there, and this simulation has no account
-     * suppression list to fall back to.
+     * Undefined where the set declares no `SuppressionOptions`, which makes a
+     * send fall back to the account setting. An empty list is an explicit
+     * override that disables suppression for feedback recorded for a message
+     * sent through this set.
      */
-    readonly suppressedReasons: readonly SimSesSuppressedReason[];
+    readonly suppressedReasons: readonly SimSesSuppressedReason[] | undefined;
     /** Whether SES would accept a send made through this set. */
     readonly sendingEnabled: boolean;
     readonly deliveryOptions: SimSesConfigurationSetDeliveryOptions;

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

@@ -10,11 +10,9 @@ export const simSesSuppressedReasons = [
  * A configuration set is a named group of settings a send can be made under,
  * covering suppression, whether sending is on, how the message is handed on
  * and whether reputation metrics are published. None of it changes what a
- * message says, which is why this is state to read back rather than behaviour
- * to reproduce.
- *
- * Sending is the exception, and it is left to the work that attaches a set to
- * a send. Here the switch is recorded and acted on by nothing.
+ * message says. The sending switch controls acceptance, and the suppression
+ * reasons control feedback. Delivery and reputation options remain state for
+ * a test to read back.
  */
 export class SimSesConfigurationSet {
     configurationSetName;
@@ -22,9 +20,10 @@ export class SimSesConfigurationSet {
     /**
      * The reasons that would put a recipient on the account suppression list.
      *
-     * Empty where the set declares no `SuppressionOptions`. Real SES falls back
-     * to the account setting there, and this simulation has no account
-     * suppression list to fall back to.
+     * Undefined where the set declares no `SuppressionOptions`, which makes a
+     * send fall back to the account setting. An empty list is an explicit
+     * override that disables suppression for feedback recorded for a message
+     * sent through this set.
      */
     suppressedReasons;
     /** Whether SES would accept a send made through this set. */

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.

package/docs/services/ses/README.md

@@ -14,7 +14,7 @@ SES specific types are imported from the `@kensio/yulin/ses` subpath.
 ## Asserting on a message that was sent
 
 `sentEmails()` hands over the record. Each message carries who it was from, the three recipient
-lists, the subject, the body and the message id SES answered with.
+lists, the subject, the body, its attachments and the message id SES answered with.
 
 ```typescript sim-ses-send-and-assert
 /**
@@ -59,6 +59,60 @@ read. The three recipient lists stay apart, leaving a test free to assert that a
 `body` keeps `text` and `html` apart too. A message sent with only an HTML body reports `undefined`
 for its text, and never the markup.
 
+### Asserting on an attachment
+
+A simple message may carry structured attachments. The record keeps them in request order.
+`rawContent` contains a copy of the bytes from the request, and the other fields contain the supplied
+SES attachment metadata.
+
+```typescript sim-ses-attachments
+/**
+ * Sending a generated CSV and reading it from the simulated SES record.
+ */
+
+import { SendEmailCommand } from "@aws-sdk/client-sesv2";
+
+import { SimAws } from "@kensio/yulin";
+
+const simAws = new SimAws();
+const ses = simAws.sesV2();
+
+ses.verifyIdentity("hello@example.com");
+ses.verifyIdentity("someone@example.org");
+
+const csv = new TextEncoder().encode("word,meaning\n你好,hello\n");
+
+await ses.sendEmail(
+  new SendEmailCommand({
+    FromEmailAddress: "hello@example.com",
+    Destination: { ToAddresses: ["someone@example.org"] },
+    Content: {
+      Simple: {
+        Subject: { Data: "Your vocabulary backup" },
+        Body: { Text: { Data: "Your backup is attached." } },
+        Attachments: [
+          {
+            RawContent: csv,
+            FileName: "vocabulary.csv",
+            ContentType: "text/csv; charset=utf-8",
+            ContentDisposition: "ATTACHMENT",
+          },
+        ],
+      },
+    },
+  }),
+);
+
+const [email] = ses.sentEmails();
+const [attachment] = email?.attachments ?? [];
+
+// vocabulary.csv "word,meaning\n你好,hello\n"
+console.log(
+  attachment?.fileName,
+  new TextDecoder().decode(attachment?.rawContent),
+);
+```
+
 ## Verifying identities
 
 Real SES verifies an email address by emailing it a link and a domain by looking for DNS records.
@@ -303,8 +357,9 @@ sending switch, the delivery options and the reputation switch are all declared
 SES holds a set as state. A test can then assert what a stack declared, with no AWS account to read
 it back from.
 
-A set is attached to an identity, or named on a send. `SendingEnabled` is the one option a send acts
-on. The rest are held for a test to read back.
+A set is attached to an identity, or named on a send. `SendingEnabled` acts during acceptance.
+Suppression options decide whether explicit bounce or complaint feedback adds the recipient to the
+account suppression list. The rest are held for a test to read back.
 
 ```typescript sim-ses-configuration-sets
 /**
@@ -350,8 +405,13 @@ console.log(ses.allConfigurationSets().map((set) => set.configurationSetName));
 ```
 
 A set declaring only its name gets the defaults real SES applies. Sending is on, TLS is optional,
-reputation metrics are off and no reason is suppressed. `GetConfigurationSet` reports those defaults
-back rather than leaving the groups out of the answer.
+reputation metrics are off and suppression falls back to the account reasons.
+`GetConfigurationSet` reports the sending, delivery and reputation defaults. It leaves suppression
+options absent where the set has no override.
+
+An explicit empty override is different. `SuppressionOptions: { SuppressedReasons: [] }` disables
+suppression for feedback on messages sent through that set. Simulated SES retains the empty list so
+it does not fall back to the account reasons.
 
 `findConfigurationSet` reaches one set by name and `allConfigurationSets` hands over every set in
 the scope, oldest first.
@@ -436,9 +496,9 @@ set at a time.
 domain and the events that report a click. The Virtual Deliverability Manager reports on engagement,
 which this simulation never measures.
 
-A set's suppression reasons are held and read back, and that is all they do. On real SES they decide
-what a bounce or a complaint would add to the account suppression list. Both are absent here. The
-list itself is a separate thing, filled by hand.
+A set's suppression reasons override the account reasons when `recordFeedback` records a hard bounce
+or complaint for a message sent through it. A set with no suppression options falls back to the
+account reasons. The feedback entry goes onto the account suppression list.
 
 `TlsPolicy` accepts `REQUIRE` and `OPTIONAL` and refuses anything else, and a `SuppressedReasons`
 entry that is neither `BOUNCE` nor `COMPLAINT` is refused too. `MaxDeliverySeconds` takes whole
@@ -644,9 +704,9 @@ review is beyond what a test can assert on anyway.
 ## The suppression list
 
 Real SES holds an account-level suppression list and fills it from hard bounces and complaints.
-Nothing bounces here, so every address on this one was put there by a caller. That is what makes it
-worth having in a test. The support tool that lists suppressed addresses, the form that removes one
-and the script that seeds the list all have somewhere to run.
+Tests supply that feedback explicitly with `recordFeedback`. Suppression commands manage the same
+list. The support tool that lists suppressed addresses, the form that removes one and the script
+that seeds the list all have somewhere to run.
 
 `PutSuppressedDestination`, `GetSuppressedDestination`, `ListSuppressedDestinations` and
 `DeleteSuppressedDestination` manage it.
@@ -705,6 +765,70 @@ carries the answer. `suppressedRecipients` names who was held back and why,
 and `isFullySuppressed` is the narrower question of whether the message reached nobody. A message to
 two recipients with one of them suppressed went to the other.
 
+### Recording a hard bounce or complaint
+
+`recordFeedback` takes the message id of an accepted message, one of its recipient addresses and a
+`BOUNCE` or `COMPLAINT` reason. Active feedback adds or updates the account suppression entry at the
+current simulated time. The existing suppression commands and `suppressedDestinations()` read the
+result.
+
+```typescript sim-ses-feedback-suppression
+/**
+ * Recording a hard bounce and observing the next send being suppressed.
+ */
+
+import { SendEmailCommand } from "@aws-sdk/client-sesv2";
+
+import { SimAws, SimFixedClock } from "@kensio/yulin";
+
+const simAws = new SimAws({
+  clock: new SimFixedClock(new Date("2026-08-31T09:00:00.000Z")),
+});
+const ses = simAws.sesV2();
+
+ses.verifyIdentity("hello@example.com");
+ses.verifyIdentity("someone@example.org");
+
+const message = new SendEmailCommand({
+  FromEmailAddress: "hello@example.com",
+  Destination: { ToAddresses: ["someone@example.org"] },
+  Content: {
+    Simple: {
+      Subject: { Data: "Welcome" },
+      Body: { Text: { Data: "Hi there" } },
+    },
+  },
+});
+
+const accepted = await ses.sendEmail(message);
+
+ses.recordFeedback({
+  messageId: accepted.MessageId!,
+  emailAddress: "someone@example.org",
+  reason: "BOUNCE",
+});
+
+await ses.sendEmail(message);
+
+const suppressed = ses.suppressedDestinations()[0];
+const later = ses.sentEmails()[1];
+
+// "BOUNCE" "2026-08-31T09:00:00.000Z" true
+console.log(
+  suppressed?.reason,
+  suppressed?.lastUpdateTime.toISOString(),
+  later?.isFullySuppressed,
+);
+```
+
+The operation refuses a message id this SES scope did not issue and an address that was not a
+recipient of that message. Recipient matching ignores case and a display name, while the suppression
+entry keeps the address spelling from the accepted message.
+
+Without a configuration-set override, the account's `SuppressedReasons` decide whether feedback is
+active. A configuration set with suppression options replaces those reasons for messages sent
+through it. An empty override leaves the suppression list unchanged.
+
 `ListSuppressedDestinations` pages with `PageSize` and `NextToken`, and narrows with `Reasons`,
 `StartDate` and `EndDate`. Removing an address that was never on the list succeeds, so a form that
 removes one twice has no failure to handle.
@@ -938,29 +1062,29 @@ time forward past the window sees the count fall the way an account's would.
 
 ## Simulated commands
 
-| Command                           | Notes                                                                                                     |
-| --------------------------------- | --------------------------------------------------------------------------------------------------------- |
-| `SendEmail`                       | `Content.Simple` and `Content.Template`. Recorded rather than delivered.                                  |
-| `CreateEmailIdentity`             | Starts unverified. `Tags`, `DkimSigningAttributes` and `ConfigurationSetName` are held and reported back. |
-| `GetEmailIdentity`                | Reports the DKIM, MAIL FROM, feedback, configuration set and tag settings the identity holds.             |
-| `ListEmailIdentities`             | Paged with `PageSize` and `NextToken`.                                                                    |
-| `DeleteEmailIdentity`             |                                                                                                           |
-| `CreateEmailTemplate`             | Substitution only. `Tags` are refused.                                                                    |
-| `GetEmailTemplate`                | Reports the wording with its placeholders unrendered.                                                     |
-| `UpdateEmailTemplate`             | Replaces the wording outright, keeping the creation time.                                                 |
-| `ListEmailTemplates`              | Names and creation times only, paged.                                                                     |
-| `DeleteEmailTemplate`             |                                                                                                           |
-| `CreateConfigurationSet`          | `TrackingOptions`, `VdmOptions` and `Tags` are refused.                                                   |
-| `GetConfigurationSet`             | Reports the defaults it applied as well as what was declared.                                             |
-| `ListConfigurationSets`           | Names only, paged with `PageSize` and `NextToken`.                                                        |
-| `DeleteConfigurationSet`          |                                                                                                           |
-| `GetAccount`                      | Reports `SuppressionAttributes` alongside the quota.                                                      |
-| `PutAccountDetails`               | `MailType` and `WebsiteURL` are required, as on real SES.                                                 |
-| `PutAccountSuppressionAttributes` | No reasons at all turns the suppression list off.                                                         |
-| `PutSuppressedDestination`        | Accepted in the sandbox, which real SES refuses.                                                          |
-| `GetSuppressedDestination`        |                                                                                                           |
-| `ListSuppressedDestinations`      | Paged, and narrowed by `Reasons`, `StartDate` and `EndDate`.                                              |
-| `DeleteSuppressedDestination`     | Removing an address that is not on the list succeeds.                                                     |
+| Command                           | Notes                                                                                                       |
+| --------------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| `SendEmail`                       | `Content.Simple`, including structured attachments, and `Content.Template`. Recorded rather than delivered. |
+| `CreateEmailIdentity`             | Starts unverified. `Tags`, `DkimSigningAttributes` and `ConfigurationSetName` are held and reported back.   |
+| `GetEmailIdentity`                | Reports the DKIM, MAIL FROM, feedback, configuration set and tag settings the identity holds.               |
+| `ListEmailIdentities`             | Paged with `PageSize` and `NextToken`.                                                                      |
+| `DeleteEmailIdentity`             |                                                                                                             |
+| `CreateEmailTemplate`             | Substitution only. `Tags` are refused.                                                                      |
+| `GetEmailTemplate`                | Reports the wording with its placeholders unrendered.                                                       |
+| `UpdateEmailTemplate`             | Replaces the wording outright, keeping the creation time.                                                   |
+| `ListEmailTemplates`              | Names and creation times only, paged.                                                                       |
+| `DeleteEmailTemplate`             |                                                                                                             |
+| `CreateConfigurationSet`          | `TrackingOptions`, `VdmOptions` and `Tags` are refused.                                                     |
+| `GetConfigurationSet`             | Reports applied defaults and preserves whether suppression options were absent.                             |
+| `ListConfigurationSets`           | Names only, paged with `PageSize` and `NextToken`.                                                          |
+| `DeleteConfigurationSet`          |                                                                                                             |
+| `GetAccount`                      | Reports `SuppressionAttributes` alongside the quota.                                                        |
+| `PutAccountDetails`               | `MailType` and `WebsiteURL` are required, as on real SES.                                                   |
+| `PutAccountSuppressionAttributes` | No reasons at all turns the suppression list off.                                                           |
+| `PutSuppressedDestination`        | Accepted in the sandbox, which real SES refuses.                                                            |
+| `GetSuppressedDestination`        |                                                                                                             |
+| `ListSuppressedDestinations`      | Paged, and narrowed by `Reasons`, `StartDate` and `EndDate`.                                                |
+| `DeleteSuppressedDestination`     | Removing an address that is not on the list succeeds.                                                       |
 
 Anything else refuses on send with `SimSdkUnsupportedCommandError`.
 
@@ -978,19 +1102,18 @@ Anything else refuses on send with `SimSdkUnsupportedCommandError`.
   the template. Template data holding an object where the template wants a value is refused too,
   where real Handlebars would render `[object Object]`.
 - **`SendBulkEmail` is absent**, along with its per-recipient replacement data.
-- **Nothing is delivered, and nothing bounces.** There are no bounce or complaint events and no
-  event destinations.
+- **Nothing is delivered.** A test supplies a hard bounce or complaint through `recordFeedback`.
+  Feedback is never generated automatically, and there are no event destinations.
 - **A configuration set acts on one send.** `SendingEnabled` refuses a send made through the set.
-  The suppression reasons, delivery options and reputation switch are held and read back, and
-  nothing acts on those.
+  Suppression reasons act on explicit feedback. Delivery options and the reputation switch are held
+  and read back.
 - **A set name nothing created is still accepted.** Real SES refuses one on an identity and on a
   send. Both stand here and the name is recorded, because a test failing over a set missing from a
   local setup fails for a reason unrelated to what it asserts.
 - **A configuration set holds what it was created with.** The `Put` commands that change one group
   of options are absent. A set cannot be changed once it exists.
-- **The suppression list fills only by hand.** Every address on it was put there by a caller,
-  because no message here ever bounces. A configuration set's `SuppressedReasons` name what a bounce
-  or a complaint would suppress for, and both are absent.
+- **Feedback is explicit.** Hard bounces and complaints update the suppression list only when a test
+  calls `recordFeedback`. Soft bounces are absent.
 - **Tenant-level suppression lists are left out.** A suppression command carrying `TenantName` is
   refused rather than answered from the account-level list.
 - **`PutSuppressedDestination` works in the sandbox.** Real SES refuses it until an account has

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kensio/yulin",
-  "version": "1.21.1",
+  "version": "1.21.2",
   "description": "AWS system behaviour simulation for isolated unit testing",
   "repository": "https://github.com/KensioSoftware/yulin",
   "homepage": "https://yulinsim.dev/",