@kensio/yulin 0.42.0 → 0.44.0

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

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

@@ -0,0 +1,41 @@
+import type { BackgroundScheduler } from "../../../util/background/background.js";
+import type { SimSqsQueue } from "../queue/sim-sqs-queue.js";
+import { SimSqsMessage } from "./sim-sqs-message.js";
+import type { SimSqsMessageAttributes } from "./sim-sqs-message-attributes.js";
+/**
+ * One message as a sender describes it, with the request's own wrapping removed.
+ */
+export interface SimSqsMessageWrite {
+    readonly body: string | undefined;
+    readonly attributes: SimSqsMessageAttributes;
+    readonly delaySeconds: number | undefined;
+}
+interface SimSqsMessageWriterProperties {
+    readonly clock: BackgroundScheduler;
+}
+/**
+ * Puts a message on a queue.
+ *
+ * SendMessage and each entry of SendMessageBatch end up here, so the two cannot
+ * drift apart on what a delay means, on how large a body may be, or on what a
+ * message id looks like. The queue's own attributes decide all three, which is
+ * why the queue comes in with the write rather than being consulted by the
+ * caller.
+ */
+export declare class SimSqsMessageWriter {
+    private readonly clock;
+    constructor(properties: SimSqsMessageWriterProperties);
+    /**
+     * Write one message to a queue, and hand back what was written.
+     */
+    write(queue: SimSqsQueue, requested: SimSqsMessageWrite): SimSqsMessage;
+    /**
+     * The delay a message waits out before it can be received.
+     *
+     * A message with no delay of its own takes the queue's, which is what makes
+     * `DelaySeconds` on the queue a delay every message inherits.
+     */
+    private delayFor;
+}
+export {};
+//# sourceMappingURL=sim-sqs-message-writer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-message-writer.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-writer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAElF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAO/E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,UAAU,6BAA6B;IACrC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAE5C,YAAY,UAAU,EAAE,6BAA6B,EAEpD;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,GAAG,aAAa,CAmBtE;IAED;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;CAkBjB"}

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

@@ -0,0 +1,56 @@
+import { randomUUID } from "node:crypto";
+import { SimSqsInvalidParameterValue } from "../error/sim-sqs.error.js";
+import { SimSqsMessage } from "./sim-sqs-message.js";
+import { SimSqsMessageBody } from "./sim-sqs-message-body.js";
+const maximumDelaySeconds = 900;
+const millisecondsPerSecond = 1000;
+/**
+ * Puts a message on a queue.
+ *
+ * SendMessage and each entry of SendMessageBatch end up here, so the two cannot
+ * drift apart on what a delay means, on how large a body may be, or on what a
+ * message id looks like. The queue's own attributes decide all three, which is
+ * why the queue comes in with the write rather than being consulted by the
+ * caller.
+ */
+export class SimSqsMessageWriter {
+    clock;
+    constructor(properties) {
+        this.clock = properties.clock;
+    }
+    /**
+     * Write one message to a queue, and hand back what was written.
+     */
+    write(queue, requested) {
+        const sentAt = this.clock.now();
+        const delaySeconds = this.delayFor(queue, requested.delaySeconds);
+        const message = new SimSqsMessage({
+            messageId: randomUUID(),
+            body: SimSqsMessageBody.of(requested.body ?? "", queue.attributes.maximumMessageSizeBytes),
+            attributes: requested.attributes,
+            sentAt,
+            visibleFrom: new Date(sentAt.getTime() + delaySeconds * millisecondsPerSecond),
+        });
+        queue.add(message);
+        return message;
+    }
+    /**
+     * The delay a message waits out before it can be received.
+     *
+     * A message with no delay of its own takes the queue's, which is what makes
+     * `DelaySeconds` on the queue a delay every message inherits.
+     */
+    delayFor(queue, requested) {
+        if (requested === undefined) {
+            return queue.attributes.delaySeconds;
+        }
+        if (!Number.isSafeInteger(requested) ||
+            requested < 0 ||
+            requested > maximumDelaySeconds) {
+            throw new SimSqsInvalidParameterValue(`Value ${String(requested)} for parameter DelaySeconds is invalid. ` +
+                `Reason: Must be an integer from 0 to ${String(maximumDelaySeconds)}.`);
+        }
+        return requested;
+    }
+}
+//# sourceMappingURL=sim-sqs-message-writer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-message-writer.js","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message-writer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAExE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAenC;;;;;;;;GAQG;AACH,MAAM,OAAO,mBAAmB;IACb,KAAK,CAAsB;IAE5C,YAAY,UAAyC;QACnD,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAkB,EAAE,SAA6B;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC;YAChC,SAAS,EAAE,UAAU,EAAE;YACvB,IAAI,EAAE,iBAAiB,CAAC,EAAE,CACxB,SAAS,CAAC,IAAI,IAAI,EAAE,EACpB,KAAK,CAAC,UAAU,CAAC,uBAAuB,CACzC;YACD,UAAU,EAAE,SAAS,CAAC,UAAU;YAChC,MAAM;YACN,WAAW,EAAE,IAAI,IAAI,CACnB,MAAM,CAAC,OAAO,EAAE,GAAG,YAAY,GAAG,qBAAqB,CACxD;SACF,CAAC,CAAC;QAEH,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEnB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;OAKG;IACK,QAAQ,CAAC,KAAkB,EAAE,SAA6B;QAChE,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC;QACvC,CAAC;QAED,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;YAChC,SAAS,GAAG,CAAC;YACb,SAAS,GAAG,mBAAmB,EAC/B,CAAC;YACD,MAAM,IAAI,2BAA2B,CACnC,SAAS,MAAM,CAAC,SAAS,CAAC,0CAA0C;gBAClE,wCAAwC,MAAM,CAAC,mBAAmB,CAAC,GAAG,CACzE,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

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

@@ -0,0 +1,96 @@
+import type { SimSqsMessageAttributes } from "./sim-sqs-message-attributes.js";
+import type { SimSqsMessageBody } from "./sim-sqs-message-body.js";
+interface SimSqsMessageProperties {
+    readonly messageId: string;
+    readonly body: SimSqsMessageBody;
+    readonly attributes: SimSqsMessageAttributes;
+    readonly sentAt: Date;
+    readonly visibleFrom: Date;
+    readonly deadLetterSourceArn?: string | undefined;
+}
+/**
+ * One message on a simulated queue.
+ *
+ * What the message is stays here; whether it can be received belongs to its
+ * visibility, which is the part that changes as it is handed out and given back.
+ */
+export declare class SimSqsMessage {
+    readonly messageId: string;
+    readonly body: SimSqsMessageBody;
+    readonly attributes: SimSqsMessageAttributes;
+    readonly sentAt: Date;
+    private readonly visibility;
+    private readonly deadLetterSourceArn;
+    private receiptHandle;
+    constructor(properties: SimSqsMessageProperties);
+    /**
+     * How many times this message has been handed out without being deleted.
+     */
+    get receiveCount(): number;
+    /**
+     * The instant from which this message can be received.
+     *
+     * A message sent with a delay is not receivable when it arrives, so anything
+     * waiting for it has to wait for this rather than for the send.
+     */
+    get availableFrom(): Date;
+    /**
+     * Whether this message can be received at an instant.
+     */
+    isVisibleAt(instant: Date): boolean;
+    /**
+     * Whether this message is still waiting out the delay it was sent with.
+     */
+    isDelayedAt(instant: Date): boolean;
+    /**
+     * Whether this message is hidden by a visibility timeout, which SQS counts as
+     * in flight.
+     */
+    isInFlightAt(instant: Date): boolean;
+    /**
+     * Whether the queue's retention period has run out for this message.
+     *
+     * Retention runs from when the message was sent, however many times it has been
+     * received since.
+     */
+    hasExpiredBy(instant: Date, retentionSeconds: number): boolean;
+    /**
+     * Hand this message out, hiding it for its visibility timeout.
+     */
+    receiveAt(instant: Date, visibilityTimeoutSeconds: number, receiptHandle: string): void;
+    /**
+     * Hide this message for a visibility timeout starting now.
+     */
+    hideFor(instant: Date, visibilityTimeoutSeconds: number): void;
+    /**
+     * Whether a receipt handle is the one this message was last received with.
+     *
+     * An older handle is not. Real SQS accepts a request carrying one and does
+     * nothing, because the receive it belongs to has been superseded.
+     */
+    holdsReceiptHandle(receiptHandle: string): boolean;
+    /**
+     * This message as it arrives on a dead-letter queue.
+     *
+     * What the message is carries over unchanged: the id, the body, the message
+     * attributes and the sent timestamp. Real SQS leaves the enqueue timestamp
+     * alone when it moves a message off a standard queue, so the dead-letter
+     * queue's retention period still runs from when the message was first sent
+     * rather than restarting.
+     *
+     * What does not carry over is the receive count, because a receive count
+     * counts receives from one queue and this message has not been received from
+     * this one. It is receivable straight away: the move is not a send, so the
+     * dead-letter queue's delay does not apply to it.
+     */
+    onDeadLetterQueue(instant: Date, sourceQueueArn: string): SimSqsMessage;
+    /**
+     * The message system attributes SQS knows about this message.
+     *
+     * Only the attributes a receive request names are reported, so this is what is
+     * available rather than what is returned.
+     */
+    systemAttributeValues(): ReadonlyMap<string, string>;
+}
+export {};
+//# sourceMappingURL=sim-sqs-message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-message.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAKnE,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnD;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,IAAI,EAAE,iBAAiB,CAAC;IACxC,SAAgB,UAAU,EAAE,uBAAuB,CAAC;IACpD,SAAgB,MAAM,EAAE,IAAI,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA0B;IACrD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqB;IACzD,OAAO,CAAC,aAAa,CAAqB;IAE1C,YAAY,UAAU,EAAE,uBAAuB,EAO9C;IAED;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;OAKG;IACH,IAAI,aAAa,IAAI,IAAI,CAExB;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;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAK7D;IAED;;OAEG;IACH,SAAS,CACP,OAAO,EAAE,IAAI,EACb,wBAAwB,EAAE,MAAM,EAChC,aAAa,EAAE,MAAM,GACpB,IAAI,CAGN;IAED;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAE7D;IAED;;;;;OAKG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAEjD;IAED;;;;;;;;;;;;;OAaG;IACH,iBAAiB,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,aAAa,CAStE;IAED;;;;;OAKG;IACH,qBAAqB,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAenD;CACF"}

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

@@ -0,0 +1,136 @@
+import { SimSqsMessageVisibility } from "./sim-sqs-message-visibility.js";
+const millisecondsPerSecond = 1000;
+/**
+ * One message on a simulated queue.
+ *
+ * What the message is stays here; whether it can be received belongs to its
+ * visibility, which is the part that changes as it is handed out and given back.
+ */
+export class SimSqsMessage {
+    messageId;
+    body;
+    attributes;
+    sentAt;
+    visibility;
+    deadLetterSourceArn;
+    receiptHandle;
+    constructor(properties) {
+        this.messageId = properties.messageId;
+        this.body = properties.body;
+        this.attributes = properties.attributes;
+        this.sentAt = properties.sentAt;
+        this.visibility = new SimSqsMessageVisibility(properties.visibleFrom);
+        this.deadLetterSourceArn = properties.deadLetterSourceArn;
+    }
+    /**
+     * How many times this message has been handed out without being deleted.
+     */
+    get receiveCount() {
+        return this.visibility.receiveCount;
+    }
+    /**
+     * The instant from which this message can be received.
+     *
+     * A message sent with a delay is not receivable when it arrives, so anything
+     * waiting for it has to wait for this rather than for the send.
+     */
+    get availableFrom() {
+        return this.visibility.availableFrom;
+    }
+    /**
+     * Whether this message can be received at an instant.
+     */
+    isVisibleAt(instant) {
+        return this.visibility.isVisibleAt(instant);
+    }
+    /**
+     * Whether this message is still waiting out the delay it was sent with.
+     */
+    isDelayedAt(instant) {
+        return this.visibility.isDelayedAt(instant);
+    }
+    /**
+     * Whether this message is hidden by a visibility timeout, which SQS counts as
+     * in flight.
+     */
+    isInFlightAt(instant) {
+        return this.visibility.isInFlightAt(instant);
+    }
+    /**
+     * Whether the queue's retention period has run out for this message.
+     *
+     * Retention runs from when the message was sent, however many times it has been
+     * received since.
+     */
+    hasExpiredBy(instant, retentionSeconds) {
+        return (this.sentAt.getTime() + retentionSeconds * millisecondsPerSecond <=
+            instant.getTime());
+    }
+    /**
+     * Hand this message out, hiding it for its visibility timeout.
+     */
+    receiveAt(instant, visibilityTimeoutSeconds, receiptHandle) {
+        this.receiptHandle = receiptHandle;
+        this.visibility.receiveAt(instant, visibilityTimeoutSeconds);
+    }
+    /**
+     * Hide this message for a visibility timeout starting now.
+     */
+    hideFor(instant, visibilityTimeoutSeconds) {
+        this.visibility.hideFor(instant, visibilityTimeoutSeconds);
+    }
+    /**
+     * Whether a receipt handle is the one this message was last received with.
+     *
+     * An older handle is not. Real SQS accepts a request carrying one and does
+     * nothing, because the receive it belongs to has been superseded.
+     */
+    holdsReceiptHandle(receiptHandle) {
+        return this.receiptHandle === receiptHandle;
+    }
+    /**
+     * This message as it arrives on a dead-letter queue.
+     *
+     * What the message is carries over unchanged: the id, the body, the message
+     * attributes and the sent timestamp. Real SQS leaves the enqueue timestamp
+     * alone when it moves a message off a standard queue, so the dead-letter
+     * queue's retention period still runs from when the message was first sent
+     * rather than restarting.
+     *
+     * What does not carry over is the receive count, because a receive count
+     * counts receives from one queue and this message has not been received from
+     * this one. It is receivable straight away: the move is not a send, so the
+     * dead-letter queue's delay does not apply to it.
+     */
+    onDeadLetterQueue(instant, sourceQueueArn) {
+        return new SimSqsMessage({
+            messageId: this.messageId,
+            body: this.body,
+            attributes: this.attributes,
+            sentAt: this.sentAt,
+            visibleFrom: instant,
+            deadLetterSourceArn: sourceQueueArn,
+        });
+    }
+    /**
+     * The message system attributes SQS knows about this message.
+     *
+     * Only the attributes a receive request names are reported, so this is what is
+     * available rather than what is returned.
+     */
+    systemAttributeValues() {
+        const values = new Map([
+            ["SentTimestamp", String(this.sentAt.getTime())],
+            ["ApproximateReceiveCount", String(this.visibility.receiveCount)],
+            [
+                "ApproximateFirstReceiveTimestamp",
+                String(this.visibility.firstReceived.getTime()),
+            ],
+        ]);
+        if (this.deadLetterSourceArn !== undefined) {
+            values.set("DeadLetterQueueSourceArn", this.deadLetterSourceArn);
+        }
+        return values;
+    }
+}
+//# sourceMappingURL=sim-sqs-message.js.map

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

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

package/dist/service/sqs/message/sim-sqs-receipt-handle.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Issue a receipt handle for one receive of one message.
+ *
+ * Real receipt handles are long opaque strings, and a fresh one is issued every
+ * time a message is handed out. Generating something equally opaque here means
+ * nothing can quietly depend on a handle's shape, or on it being the message id,
+ * the way a consumer written against a simpler fake might.
+ */
+export declare function makeSimSqsReceiptHandle(): string;
+//# sourceMappingURL=sim-sqs-receipt-handle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-receipt-handle.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-receipt-handle.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}

package/dist/service/sqs/message/sim-sqs-receipt-handle.js

@@ -0,0 +1,14 @@
+import { randomBytes } from "node:crypto";
+const handleBytes = 72;
+/**
+ * Issue a receipt handle for one receive of one message.
+ *
+ * Real receipt handles are long opaque strings, and a fresh one is issued every
+ * time a message is handed out. Generating something equally opaque here means
+ * nothing can quietly depend on a handle's shape, or on it being the message id,
+ * the way a consumer written against a simpler fake might.
+ */
+export function makeSimSqsReceiptHandle() {
+    return randomBytes(handleBytes).toString("base64");
+}
+//# sourceMappingURL=sim-sqs-receipt-handle.js.map

package/dist/service/sqs/message/sim-sqs-receipt-handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-receipt-handle.js","sourceRoot":"","sources":["../../../../src/service/sqs/message/sim-sqs-receipt-handle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACrD,CAAC"}

package/dist/service/sqs/queue/sim-sqs-dead-letter-targets.d.ts

@@ -0,0 +1,51 @@
+import type { SimSqsMessageStore } from "../message/sim-sqs-message-store.js";
+import type { SimSqsQueueAttributeInput } from "./sim-sqs-queue-attributes.js";
+import type { SimSqsQueueStore } from "./sim-sqs-queue-store.js";
+import { type SimSqsRedrivePolicy } from "./sim-sqs-redrive-policy.js";
+interface SimSqsDeadLetterTargetsProperties {
+    readonly queues: SimSqsQueueStore;
+}
+/**
+ * One queue's messages at an instant, as the thing a move works on.
+ */
+export interface SimSqsDeadLetterMove {
+    readonly policy: SimSqsRedrivePolicy | undefined;
+    readonly messages: SimSqsMessageStore;
+    readonly sourceQueueArn: string;
+    readonly instant: Date;
+}
+/**
+ * How a queue reaches the dead-letter queue its redrive policy names.
+ *
+ * The target is resolved by whole ARN rather than by the name inside one, so an
+ * ARN naming another Account or Region finds nothing. Real SQS requires a
+ * dead-letter queue to be in the same Account and Region as its source queue,
+ * and it has to exist before a policy can name it: a policy pointing at nothing
+ * would look like a working dead-letter queue and lose messages instead.
+ */
+export declare class SimSqsDeadLetterTargets {
+    private readonly queues;
+    constructor(properties: SimSqsDeadLetterTargetsProperties);
+    /**
+     * Refuse a request whose redrive policy names a queue that is not there.
+     *
+     * A request setting no redrive policy names no dead-letter queue, so there is
+     * nothing to check.
+     */
+    assertRequestedTarget(requested: SimSqsQueueAttributeInput): void;
+    /**
+     * Move the messages a queue has given up on to its dead-letter queue.
+     *
+     * A queue with no redrive policy gives up on nothing. A dead-letter queue
+     * deleted since the policy was set leaves the messages where they are rather
+     * than losing them, which is the safer of the two ways to be wrong about a
+     * queue that is no longer there.
+     */
+    move(request: SimSqsDeadLetterMove): void;
+    /**
+     * The dead-letter queue a policy names, or undefined once it has been deleted.
+     */
+    private find;
+}
+export {};
+//# sourceMappingURL=sim-sqs-dead-letter-targets.d.ts.map

package/dist/service/sqs/queue/sim-sqs-dead-letter-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-dead-letter-targets.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-dead-letter-targets.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,6BAA6B,CAAC;AAErC,UAAU,iCAAiC;IACzC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAE1C,YAAY,UAAU,EAAE,iCAAiC,EAExD;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,SAAS,EAAE,yBAAyB,GAAG,IAAI,CAahE;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAiBxC;IAED;;OAEG;IACH,OAAO,CAAC,IAAI;CAGb"}

package/dist/service/sqs/queue/sim-sqs-dead-letter-targets.js

@@ -0,0 +1,62 @@
+import { SimSqsInvalidParameterValue } from "../error/sim-sqs.error.js";
+import { simSqsRedrivePolicyIn, } from "./sim-sqs-redrive-policy.js";
+/**
+ * How a queue reaches the dead-letter queue its redrive policy names.
+ *
+ * The target is resolved by whole ARN rather than by the name inside one, so an
+ * ARN naming another Account or Region finds nothing. Real SQS requires a
+ * dead-letter queue to be in the same Account and Region as its source queue,
+ * and it has to exist before a policy can name it: a policy pointing at nothing
+ * would look like a working dead-letter queue and lose messages instead.
+ */
+export class SimSqsDeadLetterTargets {
+    queues;
+    constructor(properties) {
+        this.queues = properties.queues;
+    }
+    /**
+     * Refuse a request whose redrive policy names a queue that is not there.
+     *
+     * A request setting no redrive policy names no dead-letter queue, so there is
+     * nothing to check.
+     */
+    assertRequestedTarget(requested) {
+        const policy = simSqsRedrivePolicyIn(requested);
+        if (policy === undefined || this.find(policy) !== undefined) {
+            return;
+        }
+        throw new SimSqsInvalidParameterValue(`Value ${policy.value} for parameter RedrivePolicy is invalid. Reason: ` +
+            `Dead letter target ${policy.deadLetterTargetArn} does not exist. A ` +
+            `dead-letter queue has to be an existing queue in the same Account ` +
+            `and Region as the queue redriving to it.`);
+    }
+    /**
+     * Move the messages a queue has given up on to its dead-letter queue.
+     *
+     * A queue with no redrive policy gives up on nothing. A dead-letter queue
+     * deleted since the policy was set leaves the messages where they are rather
+     * than losing them, which is the safer of the two ways to be wrong about a
+     * queue that is no longer there.
+     */
+    move(request) {
+        const { policy, messages, sourceQueueArn, instant } = request;
+        if (policy === undefined) {
+            return;
+        }
+        const target = this.find(policy);
+        if (target === undefined) {
+            return;
+        }
+        for (const message of messages.exhausted(instant, policy.maxReceiveCount)) {
+            messages.remove(message);
+            target.add(message.onDeadLetterQueue(instant, sourceQueueArn));
+        }
+    }
+    /**
+     * The dead-letter queue a policy names, or undefined once it has been deleted.
+     */
+    find(policy) {
+        return this.queues.findByArn(policy.deadLetterTargetArn);
+    }
+}
+//# sourceMappingURL=sim-sqs-dead-letter-targets.js.map

package/dist/service/sqs/queue/sim-sqs-dead-letter-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-dead-letter-targets.js","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-dead-letter-targets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAKxE,OAAO,EAEL,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AAgBrC;;;;;;;;GAQG;AACH,MAAM,OAAO,uBAAuB;IACjB,MAAM,CAAmB;IAE1C,YAAY,UAA6C;QACvD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IAClC,CAAC;IAED;;;;;OAKG;IACH,qBAAqB,CAAC,SAAoC;QACxD,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;QAEhD,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,SAAS,EAAE,CAAC;YAC5D,OAAO;QACT,CAAC;QAED,MAAM,IAAI,2BAA2B,CACnC,SAAS,MAAM,CAAC,KAAK,mDAAmD;YACtE,sBAAsB,MAAM,CAAC,mBAAmB,qBAAqB;YACrE,oEAAoE;YACpE,0CAA0C,CAC7C,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAA6B;QAChC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAE9D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC;YAC1E,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED;;OAEG;IACK,IAAI,CAAC,MAA2B;QACtC,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC3D,CAAC;CACF"}