@kensio/yulin 1.21.0 → 1.21.2

package/dist/service/scheduler/target/sim-scheduler-retry-policy.d.ts

@@ -0,0 +1,20 @@
+export declare const defaultSchedulerMaximumEventAgeInSeconds = 86400;
+export declare const defaultSchedulerMaximumRetryAttempts = 185;
+export interface SimSchedulerRetryPolicyInput {
+    readonly MaximumEventAgeInSeconds?: number | undefined;
+    readonly MaximumRetryAttempts?: number | undefined;
+}
+/**
+ * The retry limits one target declares and the effective values they produce.
+ */
+export declare class SimSchedulerRetryPolicy {
+    readonly declared: SimSchedulerRetryPolicyInput;
+    readonly maximumEventAgeInSeconds: number;
+    readonly maximumRetryAttempts: number;
+    private constructor();
+    /**
+     * Read a retry policy, refusing values outside Scheduler's limits.
+     */
+    static of(policy: SimSchedulerRetryPolicyInput): SimSchedulerRetryPolicy;
+    private static requireWholeNumber;
+}

package/dist/service/scheduler/target/sim-scheduler-retry-policy.js

@@ -0,0 +1,37 @@
+import { SimSchedulerValidationException } from "../error/sim-scheduler.error.js";
+export const defaultSchedulerMaximumEventAgeInSeconds = 86_400;
+export const defaultSchedulerMaximumRetryAttempts = 185;
+const minimumEventAgeInSeconds = 60;
+/**
+ * The retry limits one target declares and the effective values they produce.
+ */
+export class SimSchedulerRetryPolicy {
+    declared;
+    maximumEventAgeInSeconds;
+    maximumRetryAttempts;
+    constructor(policy) {
+        this.declared = { ...policy };
+        this.maximumEventAgeInSeconds =
+            policy.MaximumEventAgeInSeconds ??
+                defaultSchedulerMaximumEventAgeInSeconds;
+        this.maximumRetryAttempts =
+            policy.MaximumRetryAttempts ?? defaultSchedulerMaximumRetryAttempts;
+    }
+    /**
+     * Read a retry policy, refusing values outside Scheduler's limits.
+     */
+    static of(policy) {
+        this.requireWholeNumber("MaximumEventAgeInSeconds", policy.MaximumEventAgeInSeconds, minimumEventAgeInSeconds, defaultSchedulerMaximumEventAgeInSeconds);
+        this.requireWholeNumber("MaximumRetryAttempts", policy.MaximumRetryAttempts, 0, defaultSchedulerMaximumRetryAttempts);
+        return new this(policy);
+    }
+    static requireWholeNumber(name, value, minimum, maximum) {
+        if (value === undefined) {
+            return;
+        }
+        if (!Number.isSafeInteger(value) || value < minimum || value > maximum) {
+            throw new SimSchedulerValidationException(`Target RetryPolicy ${name} must be a whole number between ` +
+                `${minimum} and ${maximum}, and ${value} is not.`);
+        }
+    }
+}

package/dist/service/scheduler/target/sim-scheduler-target.d.ts

@@ -1,5 +1,7 @@
 import { SimEcsTargetTask } from "../../ecs/target/sim-ecs-target-task.js";
 import { SimSchedulerTargetArn } from "./sim-scheduler-target-arn.js";
+import { SimSchedulerDeadLetterConfig, type SimSchedulerDeadLetterConfigInput } from "./sim-scheduler-dead-letter-config.js";
+import { SimSchedulerRetryPolicy, type SimSchedulerRetryPolicyInput } from "./sim-scheduler-retry-policy.js";
 /**
  * What a target request says, of the parts a target reads.
  */
@@ -8,6 +10,8 @@ interface SimSchedulerRequestedTarget {
     readonly RoleArn?: string | undefined;
     readonly Input?: string | undefined;
     readonly EcsParameters?: unknown;
+    readonly DeadLetterConfig?: SimSchedulerDeadLetterConfigInput | undefined;
+    readonly RetryPolicy?: SimSchedulerRetryPolicyInput | undefined;
 }
 /**
  * What one schedule invokes, and who it invokes it as.
@@ -37,6 +41,8 @@ export declare class SimSchedulerTarget {
      * what the task overrides instead.
      */
     readonly task: SimEcsTargetTask | undefined;
+    readonly deadLetterConfig: SimSchedulerDeadLetterConfig | undefined;
+    readonly retryPolicy: SimSchedulerRetryPolicy | undefined;
     private constructor();
     /**
      * Read the target a request carries.

package/dist/service/scheduler/target/sim-scheduler-target.js

@@ -1,6 +1,8 @@
 import { SimEcsTargetTask } from "../../ecs/target/sim-ecs-target-task.js";
 import { SimSchedulerUnsimulatedInputException, SimSchedulerValidationException, } from "../error/sim-scheduler.error.js";
 import { SimSchedulerTargetArn } from "./sim-scheduler-target-arn.js";
+import { SimSchedulerDeadLetterConfig, } from "./sim-scheduler-dead-letter-config.js";
+import { SimSchedulerRetryPolicy, } from "./sim-scheduler-retry-policy.js";
 /**
  * The longest role ARN AWS takes, and the shape one has to be.
  */
@@ -39,11 +41,15 @@ export class SimSchedulerTarget {
      * what the task overrides instead.
      */
     task;
+    deadLetterConfig;
+    retryPolicy;
     constructor(properties) {
         this.arn = properties.arn;
         this.roleArn = properties.roleArn;
         this.input = properties.input;
         this.task = properties.task;
+        this.deadLetterConfig = properties.deadLetterConfig;
+        this.retryPolicy = properties.retryPolicy;
     }
     /**
      * Read the target a request carries.
@@ -58,6 +64,12 @@ export class SimSchedulerTarget {
             roleArn: this.roleArnIn(target.RoleArn),
             input: target.Input,
             task: this.taskIn(arn, target),
+            deadLetterConfig: target.DeadLetterConfig === undefined
+                ? undefined
+                : SimSchedulerDeadLetterConfig.of(target.DeadLetterConfig),
+            retryPolicy: target.RetryPolicy === undefined
+                ? undefined
+                : SimSchedulerRetryPolicy.of(target.RetryPolicy),
         });
     }
     /**

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";