@kensio/yulin 0.43.0 → 0.44.0

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

@@ -0,0 +1,93 @@
+import { createHash } from "node:crypto";
+import { SimSqsMessageAttribute } from "./sim-sqs-message-attribute.js";
+const everyAttributeSelectors = new Set(["All", ".*"]);
+const prefixSelectorSuffix = ".*";
+/**
+ * The message attributes of one message.
+ *
+ * Attributes are digested and reported as a set rather than one at a time,
+ * because both are properties of the set: the digest covers the attributes in
+ * name order, and a receive request selects a subset of them.
+ */
+export class SimSqsMessageAttributes {
+    attributes;
+    constructor(attributes) {
+        this.attributes = attributes;
+    }
+    /**
+     * Read the message attributes of a request, refusing any real SQS would
+     * refuse.
+     */
+    static of(input) {
+        const attributes = Object.entries(input ?? {})
+            .filter((entry) => entry[1] !== undefined)
+            .map(([name, value]) => SimSqsMessageAttribute.of(name, value));
+        return new this(attributes);
+    }
+    /**
+     * Whether there are no attributes here, in which case SQS reports neither the
+     * attributes nor their digest.
+     */
+    get isEmpty() {
+        return this.attributes.length === 0;
+    }
+    /**
+     * The MD5 digest of these attributes, as SQS reports it.
+     *
+     * The names are ordered by their code units rather than by a locale, because
+     * the order decides the digest. A locale-aware comparison sorts mixed-case
+     * names differently from AWS, and differently on different machines.
+     */
+    digest() {
+        const digested = Buffer.concat(this.attributes
+            .toSorted(byName)
+            .map((attribute) => attribute.digestBytes()));
+        return createHash("md5").update(digested).digest("hex");
+    }
+    /**
+     * These attributes as SQS reports them in a response.
+     */
+    reported() {
+        return Object.fromEntries(this.attributes.map((attribute) => [
+            attribute.name,
+            attribute.reported(),
+        ]));
+    }
+    /**
+     * The attributes a receive request asked for.
+     *
+     * Real SQS returns no message attributes unless they are named, so a consumer
+     * that forgot to ask for them gets none here too. `All` and `.*` select every
+     * attribute, a bare name selects that one, and a name ending in `.*` selects
+     * every attribute with that prefix.
+     */
+    selected(names) {
+        if (names === undefined || names.length === 0) {
+            return new SimSqsMessageAttributes([]);
+        }
+        if (names.some((name) => everyAttributeSelectors.has(name))) {
+            return this;
+        }
+        return new SimSqsMessageAttributes(this.attributes.filter((attribute) => names.some((name) => selects(name, attribute.name))));
+    }
+}
+/**
+ * Order two attributes by name, comparing code units rather than by locale.
+ */
+function byName(one, other) {
+    // Attribute names within one message are unique, so there is no equal case.
+    if (one.name < other.name) {
+        return -1;
+    }
+    return 1;
+}
+/**
+ * Whether one requested attribute name selects an attribute.
+ */
+function selects(requested, attributeName) {
+    if (requested.endsWith(prefixSelectorSuffix)) {
+        return attributeName.startsWith(requested.slice(0, -prefixSelectorSuffix.length));
+    }
+    return requested === attributeName;
+}
+//# sourceMappingURL=sim-sqs-message-attributes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-message-attributes.js","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-attributes.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,18 @@
+/**
+ * One message body, with the digest a sender checks it by.
+ *
+ * The digest is a real MD5 of the body, as real SQS reports, because that is the
+ * whole point of it: a sender comparing `MD5OfMessageBody` against its own
+ * digest either finds the body it sent or finds a bug, and a made-up value would
+ * tell it nothing.
+ */
+export declare class SimSqsMessageBody {
+    readonly value: string;
+    readonly digest: string;
+    private constructor();
+    /**
+     * Read a message body, refusing one real SQS would refuse.
+     */
+    static of(value: string, maximumBytes: number): SimSqsMessageBody;
+}
+//# sourceMappingURL=sim-sqs-message-body.d.ts.map

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

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

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

@@ -0,0 +1,66 @@
+import { createHash } from "node:crypto";
+import { assertDefined } from "../../../util/type-guard/defined.js";
+import { SimSqsInvalidMessageContents, SimSqsInvalidParameterValue, } from "../error/sim-sqs.error.js";
+const allowedControlCharacters = new Set([0x9, 0xa, 0xd]);
+const space = 0x20;
+const beforeSurrogates = 0xd7_ff;
+const afterSurrogates = 0xe0_00;
+const lastAllowedBmp = 0xff_fd;
+const firstSupplementary = 0x1_00_00;
+const lastSupplementary = 0x10_ff_ff;
+/**
+ * Whether a code point is one real SQS allows in a message body.
+ *
+ * The allowed set is tab, newline, carriage return, and the Unicode ranges
+ * either side of the surrogate block. Anything else, a control character or a
+ * lone surrogate, is refused rather than sent.
+ */
+function isAllowedInBody(codePoint) {
+    if (allowedControlCharacters.has(codePoint)) {
+        return true;
+    }
+    return ((codePoint >= space && codePoint <= beforeSurrogates) ||
+        (codePoint >= afterSurrogates && codePoint <= lastAllowedBmp) ||
+        (codePoint >= firstSupplementary && codePoint <= lastSupplementary));
+}
+/**
+ * One message body, with the digest a sender checks it by.
+ *
+ * The digest is a real MD5 of the body, as real SQS reports, because that is the
+ * whole point of it: a sender comparing `MD5OfMessageBody` against its own
+ * digest either finds the body it sent or finds a bug, and a made-up value would
+ * tell it nothing.
+ */
+export class SimSqsMessageBody {
+    value;
+    digest;
+    constructor(value) {
+        this.value = value;
+        this.digest = createHash("md5").update(value, "utf8").digest("hex");
+    }
+    /**
+     * Read a message body, refusing one real SQS would refuse.
+     */
+    static of(value, maximumBytes) {
+        if (value === "") {
+            throw new SimSqsInvalidParameterValue("The request must contain the parameter MessageBody");
+        }
+        const byteLength = Buffer.byteLength(value, "utf8");
+        if (byteLength > maximumBytes) {
+            throw new SimSqsInvalidParameterValue(`One or more parameters are invalid. Reason: Message must be shorter ` +
+                `than ${String(maximumBytes)} bytes, and this one is ` +
+                `${String(byteLength)} bytes.`);
+        }
+        // Iterating a string yields whole code points, so a surrogate pair is one
+        // character here rather than two unpaired halves.
+        for (const character of value) {
+            const codePoint = character.codePointAt(0);
+            assertDefined(codePoint, "Every character has a first code point");
+            if (!isAllowedInBody(codePoint)) {
+                throw new SimSqsInvalidMessageContents("The message contains characters outside the allowed set");
+            }
+        }
+        return new this(value);
+    }
+}
+//# sourceMappingURL=sim-sqs-message-body.js.map

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

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

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

@@ -0,0 +1,74 @@
+import type { SimSqsMessage } from "./sim-sqs-message.js";
+/**
+ * How many messages a queue holds in each of the states SQS counts separately.
+ */
+export interface SimSqsMessageCounts {
+    readonly visible: number;
+    readonly inFlight: number;
+    readonly delayed: number;
+}
+/**
+ * The messages of one simulated queue, and the receipt handles it has issued.
+ *
+ * Handles are kept here rather than on the messages because a handle outlives
+ * the message it names: a consumer deleting an already deleted message is
+ * accepted by real SQS, and a handle the queue never issued is not. Only a store
+ * of what has been issued can tell those two apart.
+ */
+export declare class SimSqsMessageStore {
+    private messages;
+    private readonly handles;
+    /**
+     * Take a newly sent message.
+     */
+    add(message: SimSqsMessage): void;
+    /**
+     * Forget the messages whose retention period has run out.
+     *
+     * Real SQS drops a message once it has been on the queue longer than the
+     * retention period, so advancing simulated time past it loses the message here
+     * too rather than keeping it forever.
+     */
+    dropExpired(instant: Date, retentionSeconds: number): void;
+    /**
+     * The messages that can be received at an instant, oldest first.
+     */
+    receivable(instant: Date, limit: number): readonly SimSqsMessage[];
+    /**
+     * When the earliest message that cannot be received yet becomes receivable,
+     * or nothing when every message here is receivable already.
+     */
+    nextAvailability(instant: Date): Date | undefined;
+    /**
+     * The messages that have used up their receives and are receivable again.
+     *
+     * These are the ones a redrive policy moves to the dead-letter queue. Being
+     * visible again is the trigger: a message is only out of attempts once the
+     * visibility timeout of its last receive has lapsed, and until then the
+     * consumer holding it may still delete it.
+     */
+    exhausted(instant: Date, maxReceiveCount: number): readonly SimSqsMessage[];
+    /**
+     * Record that a message was handed out under a receipt handle.
+     */
+    recordHandle(receiptHandle: string, message: SimSqsMessage): void;
+    /**
+     * The message a receipt handle names, or undefined for a handle this queue
+     * never issued.
+     */
+    forHandle(receiptHandle: string): SimSqsMessage | undefined;
+    /**
+     * Forget a deleted message.
+     */
+    remove(message: SimSqsMessage): void;
+    /**
+     * Forget every message, as PurgeQueue does.
+     */
+    purge(): void;
+    /**
+     * How many messages are in each state at an instant.
+     */
+    countsAt(instant: Date): SimSqsMessageCounts;
+    private countWhere;
+}
+//# sourceMappingURL=sim-sqs-message-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-message-store.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAE5D;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEhC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAIzD;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAIjE;IAED;;;OAGG;IACH,gBAAgB,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAUhD;IAED;;;;;;;OAOG;IACH,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAK1E;IAED;;OAEG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAEhE;IAED;;;OAGG;IACH,SAAS,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE1D;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAEnC;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAEZ;IAED;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,mBAAmB,CAM3C;IAED,OAAO,CAAC,UAAU;CAGnB"}

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

@@ -0,0 +1,99 @@
+/**
+ * The messages of one simulated queue, and the receipt handles it has issued.
+ *
+ * Handles are kept here rather than on the messages because a handle outlives
+ * the message it names: a consumer deleting an already deleted message is
+ * accepted by real SQS, and a handle the queue never issued is not. Only a store
+ * of what has been issued can tell those two apart.
+ */
+export class SimSqsMessageStore {
+    messages = [];
+    handles = new Map();
+    /**
+     * Take a newly sent message.
+     */
+    add(message) {
+        this.messages = [...this.messages, message];
+    }
+    /**
+     * Forget the messages whose retention period has run out.
+     *
+     * Real SQS drops a message once it has been on the queue longer than the
+     * retention period, so advancing simulated time past it loses the message here
+     * too rather than keeping it forever.
+     */
+    dropExpired(instant, retentionSeconds) {
+        this.messages = this.messages.filter((message) => !message.hasExpiredBy(instant, retentionSeconds));
+    }
+    /**
+     * The messages that can be received at an instant, oldest first.
+     */
+    receivable(instant, limit) {
+        return this.messages
+            .filter((message) => message.isVisibleAt(instant))
+            .slice(0, limit);
+    }
+    /**
+     * When the earliest message that cannot be received yet becomes receivable,
+     * or nothing when every message here is receivable already.
+     */
+    nextAvailability(instant) {
+        const pending = this.messages
+            .filter((message) => !message.isVisibleAt(instant))
+            .map((message) => message.availableFrom.getTime());
+        if (pending.length === 0) {
+            return undefined;
+        }
+        return new Date(Math.min(...pending));
+    }
+    /**
+     * The messages that have used up their receives and are receivable again.
+     *
+     * These are the ones a redrive policy moves to the dead-letter queue. Being
+     * visible again is the trigger: a message is only out of attempts once the
+     * visibility timeout of its last receive has lapsed, and until then the
+     * consumer holding it may still delete it.
+     */
+    exhausted(instant, maxReceiveCount) {
+        return this.messages.filter((message) => message.isVisibleAt(instant) && message.receiveCount >= maxReceiveCount);
+    }
+    /**
+     * Record that a message was handed out under a receipt handle.
+     */
+    recordHandle(receiptHandle, message) {
+        this.handles.set(receiptHandle, message);
+    }
+    /**
+     * The message a receipt handle names, or undefined for a handle this queue
+     * never issued.
+     */
+    forHandle(receiptHandle) {
+        return this.handles.get(receiptHandle);
+    }
+    /**
+     * Forget a deleted message.
+     */
+    remove(message) {
+        this.messages = this.messages.filter((held) => held !== message);
+    }
+    /**
+     * Forget every message, as PurgeQueue does.
+     */
+    purge() {
+        this.messages = [];
+    }
+    /**
+     * How many messages are in each state at an instant.
+     */
+    countsAt(instant) {
+        return {
+            visible: this.countWhere((message) => message.isVisibleAt(instant)),
+            inFlight: this.countWhere((message) => message.isInFlightAt(instant)),
+            delayed: this.countWhere((message) => message.isDelayedAt(instant)),
+        };
+    }
+    countWhere(matches) {
+        return this.messages.filter((message) => matches(message)).length;
+    }
+}
+//# sourceMappingURL=sim-sqs-message-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-message-store.js","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-store.ts"],"names":[],"mappings":"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"}

package/dist/service/sqs/message/sim-sqs-message-system-attributes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The message system attributes one receive request asked for.
+ *
+ * Real SQS returns none of them unless they are named, so a consumer relying on
+ * `ApproximateReceiveCount` has to ask for it. Reporting them unasked would let
+ * a test read a value that would be missing on AWS.
+ */
+export declare class SimSqsRequestedSystemAttributes {
+    private readonly names;
+    private constructor();
+    /**
+     * Read the attribute names a receive request asked for, refusing a name real
+     * SQS has no such attribute for.
+     *
+     * `MessageSystemAttributeNames` and the deprecated `AttributeNames` mean the
+     * same thing, so both are gathered here.
+     */
+    static of(...requested: readonly (readonly string[] | undefined)[]): SimSqsRequestedSystemAttributes;
+    /**
+     * Pick the requested attributes out of the ones a message has.
+     *
+     * Undefined means the response carries no `Attributes` at all, which is what
+     * real SQS sends when nothing was asked for.
+     */
+    from(available: ReadonlyMap<string, string>): Record<string, string> | undefined;
+    private selects;
+}
+//# sourceMappingURL=sim-sqs-message-system-attributes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-message-system-attributes.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-system-attributes.ts"],"names":[],"mappings":"AAyBA;;;;;;GAMG;AACH,qBAAa,+BAA+B;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAE1C,OAAO,eAEN;IAED;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CACP,GAAG,SAAS,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,GACvD,+BAA+B,CAajC;IAED;;;;;OAKG;IACH,IAAI,CACF,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAepC;IAED,OAAO,CAAC,OAAO;CAGhB"}

package/dist/service/sqs/message/sim-sqs-message-system-attributes.js

@@ -0,0 +1,75 @@
+import { SimSqsInvalidAttributeName } from "../error/sim-sqs.error.js";
+const everySelector = "All";
+/**
+ * The message system attribute names real SQS accepts on a receive request.
+ *
+ * The FIFO ones and the tracing one are here because asking for them is valid:
+ * real SQS leaves an attribute out when the message has no value for it, so a
+ * request naming `MessageGroupId` on a standard queue gets silence rather than a
+ * failure. A name that is not an SQS attribute at all is refused.
+ */
+const knownNames = new Set([
+    "ApproximateFirstReceiveTimestamp",
+    "ApproximateReceiveCount",
+    "AWSTraceHeader",
+    "DeadLetterQueueSourceArn",
+    "MessageDeduplicationId",
+    "MessageGroupId",
+    "SenderId",
+    "SentTimestamp",
+    "SequenceNumber",
+    "SqsManagedSseEnabled",
+]);
+/**
+ * The message system attributes one receive request asked for.
+ *
+ * Real SQS returns none of them unless they are named, so a consumer relying on
+ * `ApproximateReceiveCount` has to ask for it. Reporting them unasked would let
+ * a test read a value that would be missing on AWS.
+ */
+export class SimSqsRequestedSystemAttributes {
+    names;
+    constructor(names) {
+        this.names = names;
+    }
+    /**
+     * Read the attribute names a receive request asked for, refusing a name real
+     * SQS has no such attribute for.
+     *
+     * `MessageSystemAttributeNames` and the deprecated `AttributeNames` mean the
+     * same thing, so both are gathered here.
+     */
+    static of(...requested) {
+        const names = requested.flatMap((group) => group ?? []);
+        for (const name of names) {
+            if (name !== everySelector && !knownNames.has(name)) {
+                throw new SimSqsInvalidAttributeName(`Unknown Attribute ${name}: it is not an SQS message system ` +
+                    `attribute name`);
+            }
+        }
+        return new this(names);
+    }
+    /**
+     * Pick the requested attributes out of the ones a message has.
+     *
+     * Undefined means the response carries no `Attributes` at all, which is what
+     * real SQS sends when nothing was asked for.
+     */
+    from(available) {
+        if (this.names.length === 0) {
+            return undefined;
+        }
+        const selected = available
+            .entries()
+            .filter(([name]) => this.selects(name))
+            .toArray();
+        if (selected.length === 0) {
+            return undefined;
+        }
+        return Object.fromEntries(selected);
+    }
+    selects(name) {
+        return this.names.includes(everySelector) || this.names.includes(name);
+    }
+}
+//# sourceMappingURL=sim-sqs-message-system-attributes.js.map

package/dist/service/sqs/message/sim-sqs-message-system-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-message-system-attributes.js","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-system-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAEvE,MAAM,aAAa,GAAG,KAAK,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS;IACjC,kCAAkC;IAClC,yBAAyB;IACzB,gBAAgB;IAChB,0BAA0B;IAC1B,wBAAwB;IACxB,gBAAgB;IAChB,UAAU;IACV,eAAe;IACf,gBAAgB;IAChB,sBAAsB;CACvB,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,OAAO,+BAA+B;IACzB,KAAK,CAAoB;IAE1C,YAAoB,KAAwB;QAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CACP,GAAG,SAAqD;QAExD,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAExD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,KAAK,aAAa,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,0BAA0B,CAClC,qBAAqB,IAAI,oCAAoC;oBAC3D,gBAAgB,CACnB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,IAAI,CACF,SAAsC;QAEtC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,QAAQ,GAAG,SAAS;aACvB,OAAO,EAAE;aACT,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;aACtC,OAAO,EAAE,CAAC;QAEb,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAEO,OAAO,CAAC,IAAY;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzE,CAAC;CACF"}

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

@@ -0,0 +1,56 @@
+/**
+ * Whether one message can be received, and when it next can be.
+ *
+ * This is held as the instant the message becomes receivable rather than as a
+ * timer. That is what makes a visibility timeout something a test can advance the
+ * simulation clock past: nothing has to fire for a message to come back, it
+ * simply becomes visible again once simulated time reaches the instant it was
+ * hidden until.
+ *
+ * A delay works the same way. A message sent with a delay is invisible from the
+ * moment it arrives, and the only difference from an in-flight message is that it
+ * has never been received.
+ */
+export declare class SimSqsMessageVisibility {
+    private visibleFrom;
+    private receives;
+    private firstReceivedAt;
+    constructor(visibleFrom: Date);
+    /**
+     * How many times the message has been handed out and not deleted.
+     */
+    get receiveCount(): number;
+    /**
+     * The instant from which the message can be received.
+     */
+    get availableFrom(): Date;
+    /**
+     * When the message was first handed out.
+     *
+     * Only a message being handed out reports its attributes, and handing one out
+     * is what sets the first receive, so there is always one to report by then.
+     */
+    get firstReceived(): Date;
+    /**
+     * Whether the message can be received at an instant.
+     */
+    isVisibleAt(instant: Date): boolean;
+    /**
+     * Whether the message is still waiting out the delay it was sent with.
+     */
+    isDelayedAt(instant: Date): boolean;
+    /**
+     * Whether the message is hidden by a visibility timeout, which SQS counts as
+     * in flight.
+     */
+    isInFlightAt(instant: Date): boolean;
+    /**
+     * Record a receive, and hide the message for its visibility timeout.
+     */
+    receiveAt(instant: Date, visibilityTimeoutSeconds: number): void;
+    /**
+     * Hide the message for a visibility timeout starting at an instant.
+     */
+    hideFor(instant: Date, visibilityTimeoutSeconds: number): void;
+}
+//# sourceMappingURL=sim-sqs-message-visibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-message-visibility.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-visibility.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,WAAW,CAAO;IAC1B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,eAAe,CAAmB;IAE1C,YAAY,WAAW,EAAE,IAAI,EAE5B;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,IAAI,CAExB;IAED;;;;;OAKG;IACH,IAAI,aAAa,IAAI,IAAI,CAOxB;IAED;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAElC;IAED;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAElC;IAED;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,IAAI,GAAG,OAAO,CAEnC;IAED;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAI/D;IAED;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAI7D;CACF"}

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

@@ -0,0 +1,79 @@
+import { assertDefined } from "../../../util/type-guard/defined.js";
+const millisecondsPerSecond = 1000;
+/**
+ * Whether one message can be received, and when it next can be.
+ *
+ * This is held as the instant the message becomes receivable rather than as a
+ * timer. That is what makes a visibility timeout something a test can advance the
+ * simulation clock past: nothing has to fire for a message to come back, it
+ * simply becomes visible again once simulated time reaches the instant it was
+ * hidden until.
+ *
+ * A delay works the same way. A message sent with a delay is invisible from the
+ * moment it arrives, and the only difference from an in-flight message is that it
+ * has never been received.
+ */
+export class SimSqsMessageVisibility {
+    visibleFrom;
+    receives = 0;
+    firstReceivedAt;
+    constructor(visibleFrom) {
+        this.visibleFrom = visibleFrom;
+    }
+    /**
+     * How many times the message has been handed out and not deleted.
+     */
+    get receiveCount() {
+        return this.receives;
+    }
+    /**
+     * The instant from which the message can be received.
+     */
+    get availableFrom() {
+        return this.visibleFrom;
+    }
+    /**
+     * When the message was first handed out.
+     *
+     * Only a message being handed out reports its attributes, and handing one out
+     * is what sets the first receive, so there is always one to report by then.
+     */
+    get firstReceived() {
+        assertDefined(this.firstReceivedAt, "A message reports its first receive once it has been received");
+        return this.firstReceivedAt;
+    }
+    /**
+     * Whether the message can be received at an instant.
+     */
+    isVisibleAt(instant) {
+        return this.visibleFrom.getTime() <= instant.getTime();
+    }
+    /**
+     * Whether the message is still waiting out the delay it was sent with.
+     */
+    isDelayedAt(instant) {
+        return this.receives === 0 && !this.isVisibleAt(instant);
+    }
+    /**
+     * Whether the message is hidden by a visibility timeout, which SQS counts as
+     * in flight.
+     */
+    isInFlightAt(instant) {
+        return this.receives > 0 && !this.isVisibleAt(instant);
+    }
+    /**
+     * Record a receive, and hide the message for its visibility timeout.
+     */
+    receiveAt(instant, visibilityTimeoutSeconds) {
+        this.receives += 1;
+        this.firstReceivedAt ??= instant;
+        this.hideFor(instant, visibilityTimeoutSeconds);
+    }
+    /**
+     * Hide the message for a visibility timeout starting at an instant.
+     */
+    hideFor(instant, visibilityTimeoutSeconds) {
+        this.visibleFrom = new Date(instant.getTime() + visibilityTimeoutSeconds * millisecondsPerSecond);
+    }
+}
+//# sourceMappingURL=sim-sqs-message-visibility.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-message-visibility.js","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,uBAAuB;IAC1B,WAAW,CAAO;IAClB,QAAQ,GAAG,CAAC,CAAC;IACb,eAAe,CAAmB;IAE1C,YAAY,WAAiB;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,IAAI,aAAa;QACf,aAAa,CACX,IAAI,CAAC,eAAe,EACpB,+DAA+D,CAChE,CAAC;QAEF,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAa;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAa;QACvB,OAAO,IAAI,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,OAAa;QACxB,OAAO,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,OAAa,EAAE,wBAAgC;QACvD,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnB,IAAI,CAAC,eAAe,KAAK,OAAO,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,wBAAwB,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,OAAa,EAAE,wBAAgC;QACrD,IAAI,CAAC,WAAW,GAAG,IAAI,IAAI,CACzB,OAAO,CAAC,OAAO,EAAE,GAAG,wBAAwB,GAAG,qBAAqB,CACrE,CAAC;IACJ,CAAC;CACF"}