@kensio/yulin 0.43.0 → 0.44.0

package/dist/service/sqs/queue/sim-sqs-queue-name.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The name of one simulated queue.
+ *
+ * The name is the whole identity of a queue: it is the resource part of the
+ * ARN with no type separator in front of it, and the last segment of the queue
+ * URL. Validating it in one place is what keeps a name that works here one
+ * that would work on real AWS.
+ */
+export declare class SimSqsQueueName {
+    readonly value: string;
+    private constructor();
+    /**
+     * Read the queue name a request has to carry.
+     */
+    static required(name: string | undefined): SimSqsQueueName;
+    /**
+     * Read a queue name from request input, refusing one real SQS would refuse.
+     */
+    static of(value: string): SimSqsQueueName;
+}
+//# sourceMappingURL=sim-sqs-queue-name.d.ts.map

package/dist/service/sqs/queue/sim-sqs-queue-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-queue-name.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-queue-name.ts"],"names":[],"mappings":"AAeA;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAE9B,OAAO,eAEN;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe,CAMzD;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAiBxC;CACF"}

package/dist/service/sqs/queue/sim-sqs-queue-name.js

@@ -0,0 +1,47 @@
+import { SimSqsInvalidParameterValue, SimSqsUnsupportedOperation, SimSqsValidationException, } from "../error/sim-sqs.error.js";
+/**
+ * Real SQS allows alphanumeric characters, hyphens and underscores, up to 80
+ * characters. A FIFO queue name additionally ends in `.fifo`, which is the only
+ * way a period gets into a name.
+ */
+const queueNamePattern = /^[\w-]{1,80}$/;
+const fifoSuffix = ".fifo";
+/**
+ * The name of one simulated queue.
+ *
+ * The name is the whole identity of a queue: it is the resource part of the
+ * ARN with no type separator in front of it, and the last segment of the queue
+ * URL. Validating it in one place is what keeps a name that works here one
+ * that would work on real AWS.
+ */
+export class SimSqsQueueName {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    /**
+     * Read the queue name a request has to carry.
+     */
+    static required(name) {
+        if (name === undefined || name === "") {
+            throw new SimSqsValidationException("A QueueName is required");
+        }
+        return this.of(name);
+    }
+    /**
+     * Read a queue name from request input, refusing one real SQS would refuse.
+     */
+    static of(value) {
+        if (value.endsWith(fifoSuffix)) {
+            throw new SimSqsUnsupportedOperation(`Queue name '${value}' names a FIFO queue, which simulated SQS does ` +
+                `not support. Only standard queues are simulated.`);
+        }
+        if (!queueNamePattern.test(value)) {
+            throw new SimSqsInvalidParameterValue(`Value '${value}' for parameter QueueName is invalid. Reason: Can ` +
+                `only include alphanumeric characters, hyphens, or underscores. 1 ` +
+                `to 80 in length.`);
+        }
+        return new this(value);
+    }
+}
+//# sourceMappingURL=sim-sqs-queue-name.js.map

package/dist/service/sqs/queue/sim-sqs-queue-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-queue-name.js","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-queue-name.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAEzC,MAAM,UAAU,GAAG,OAAO,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IACV,KAAK,CAAS;IAE9B,YAAoB,KAAa;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAwB;QACtC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,yBAAyB,CAAC,yBAAyB,CAAC,CAAC;QACjE,CAAC;QAED,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAa;QACrB,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,0BAA0B,CAClC,eAAe,KAAK,iDAAiD;gBACnE,kDAAkD,CACrD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,2BAA2B,CACnC,UAAU,KAAK,oDAAoD;gBACjE,mEAAmE;gBACnE,kBAAkB,CACrB,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/service/sqs/queue/sim-sqs-queue-report.d.ts

@@ -0,0 +1,22 @@
+import type { SimSqsMessageCounts } from "../message/sim-sqs-message-store.js";
+import type { SimSqsQueueAttributes } from "./sim-sqs-queue-attributes.js";
+/**
+ * What one queue is at an instant, as the attributes are read off it.
+ */
+export interface SimSqsQueueReport {
+    readonly settings: SimSqsQueueAttributes;
+    readonly counts: SimSqsMessageCounts;
+    readonly createdAt: Date;
+    readonly lastModifiedAt: Date;
+    readonly queueArn: string;
+}
+/**
+ * The attributes SQS reports about a queue.
+ *
+ * This is the settable attributes together with the ones the queue itself
+ * decides: how many messages are in each state, when it was created and last
+ * changed, and its ARN. No request can set those, so they are built here rather
+ * than held with the settings.
+ */
+export declare function simSqsReportedQueueAttributes(report: SimSqsQueueReport): ReadonlyMap<string, string>;
+//# sourceMappingURL=sim-sqs-queue-report.d.ts.map

package/dist/service/sqs/queue/sim-sqs-queue-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-queue-report.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-queue-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAY3E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,iBAAiB,GACxB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAY7B"}

package/dist/service/sqs/queue/sim-sqs-queue-report.js

@@ -0,0 +1,29 @@
+const millisecondsPerSecond = 1000;
+/**
+ * Real SQS reports the two queue timestamps in whole seconds since the epoch,
+ * unlike the message timestamps, which are in milliseconds.
+ */
+function epochSeconds(instant) {
+    return String(Math.floor(instant.getTime() / millisecondsPerSecond));
+}
+/**
+ * The attributes SQS reports about a queue.
+ *
+ * This is the settable attributes together with the ones the queue itself
+ * decides: how many messages are in each state, when it was created and last
+ * changed, and its ARN. No request can set those, so they are built here rather
+ * than held with the settings.
+ */
+export function simSqsReportedQueueAttributes(report) {
+    const { settings, counts, createdAt, lastModifiedAt, queueArn } = report;
+    return new Map([
+        ...settings.reported(),
+        ["ApproximateNumberOfMessages", String(counts.visible)],
+        ["ApproximateNumberOfMessagesDelayed", String(counts.delayed)],
+        ["ApproximateNumberOfMessagesNotVisible", String(counts.inFlight)],
+        ["CreatedTimestamp", epochSeconds(createdAt)],
+        ["LastModifiedTimestamp", epochSeconds(lastModifiedAt)],
+        ["QueueArn", queueArn],
+    ]);
+}
+//# sourceMappingURL=sim-sqs-queue-report.js.map

package/dist/service/sqs/queue/sim-sqs-queue-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-queue-report.js","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-queue-report.ts"],"names":[],"mappings":"AAGA,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAEnC;;;GAGG;AACH,SAAS,YAAY,CAAC,OAAa;IACjC,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,qBAAqB,CAAC,CAAC,CAAC;AACvE,CAAC;AAaD;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAC3C,MAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;IAEzE,OAAO,IAAI,GAAG,CAAiB;QAC7B,GAAG,QAAQ,CAAC,QAAQ,EAAE;QACtB,CAAC,6BAA6B,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvD,CAAC,oCAAoC,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC9D,CAAC,uCAAuC,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClE,CAAC,kBAAkB,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC,uBAAuB,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC;QACvD,CAAC,UAAU,EAAE,QAAQ,CAAC;KACvB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,60 @@
+import type { SimSqsQueue } from "./sim-sqs-queue.js";
+/**
+ * The queues of one simulated SQS scope.
+ *
+ * Queues are keyed by name, which is the whole of their identity: the name is
+ * the resource part of the ARN and the last segment of the URL, and it is unique
+ * within one account and region.
+ */
+export declare class SimSqsQueueStore {
+    private readonly queues;
+    private readonly deletedNames;
+    /**
+     * Every queue in this scope, in creation order.
+     */
+    get all(): readonly SimSqsQueue[];
+    /**
+     * The queues whose names start with a prefix, in creation order.
+     *
+     * No prefix means every queue, as an SQS listing with no prefix lists them all.
+     */
+    withNamePrefix(prefix: string | undefined): readonly SimSqsQueue[];
+    /**
+     * Store a newly created queue.
+     */
+    add(queue: SimSqsQueue): void;
+    /**
+     * Find a queue by name.
+     */
+    find(name: string): SimSqsQueue | undefined;
+    /**
+     * Find a queue by its ARN.
+     *
+     * Whole ARNs are compared rather than the name being read out of one, which
+     * keeps the Account and Region in the comparison: an ARN naming another scope
+     * finds no queue here, as it names no queue this simulated SQS holds.
+     */
+    findByArn(arn: string): SimSqsQueue | undefined;
+    /**
+     * Bring every queue in this scope up to date at an instant.
+     *
+     * A message moves to its dead-letter queue when the source queue notices its
+     * visibility has lapsed, and nothing schedules that. A test that only reads
+     * the dead-letter queue would otherwise find it empty, so every queue is
+     * brought up to date before any one of them is answered from.
+     */
+    applyLifecycle(instant: Date): void;
+    /**
+     * Resolve a queue by name, or refuse.
+     */
+    require(name: string): SimSqsQueue;
+    /**
+     * Forget a deleted queue, holding its name as real SQS holds it.
+     */
+    remove(queue: SimSqsQueue, deletedAt: Date): void;
+    /**
+     * Refuse a name a recent deletion is still holding.
+     */
+    assertNameAvailable(name: string, instant: Date): void;
+}
+//# sourceMappingURL=sim-sqs-queue-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-queue-store.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-queue-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAE9D;;OAEG;IACH,IAAI,GAAG,IAAI,SAAS,WAAW,EAAE,CAEhC;IAED;;;;OAIG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,WAAW,EAAE,CAIjE;IAED;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAE5B;IAED;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE1C;IAED;;;;;;OAMG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE9C;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAIlC;IAED;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAWjC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,CAGhD;IAED;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,IAAI,CAErD;CACF"}

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

@@ -0,0 +1,87 @@
+import { SimSqsQueueDoesNotExist } from "../error/sim-sqs.error.js";
+import { SimSqsDeletedQueueNames } from "./sim-sqs-deleted-queue-names.js";
+/**
+ * The queues of one simulated SQS scope.
+ *
+ * Queues are keyed by name, which is the whole of their identity: the name is
+ * the resource part of the ARN and the last segment of the URL, and it is unique
+ * within one account and region.
+ */
+export class SimSqsQueueStore {
+    queues = new Map();
+    deletedNames = new SimSqsDeletedQueueNames();
+    /**
+     * Every queue in this scope, in creation order.
+     */
+    get all() {
+        return this.queues.values().toArray();
+    }
+    /**
+     * The queues whose names start with a prefix, in creation order.
+     *
+     * No prefix means every queue, as an SQS listing with no prefix lists them all.
+     */
+    withNamePrefix(prefix) {
+        return this.all.filter((queue) => queue.name.value.startsWith(prefix ?? ""));
+    }
+    /**
+     * Store a newly created queue.
+     */
+    add(queue) {
+        this.queues.set(queue.name.value, queue);
+    }
+    /**
+     * Find a queue by name.
+     */
+    find(name) {
+        return this.queues.get(name);
+    }
+    /**
+     * Find a queue by its ARN.
+     *
+     * Whole ARNs are compared rather than the name being read out of one, which
+     * keeps the Account and Region in the comparison: an ARN naming another scope
+     * finds no queue here, as it names no queue this simulated SQS holds.
+     */
+    findByArn(arn) {
+        return this.all.find((queue) => queue.arn.value === arn);
+    }
+    /**
+     * Bring every queue in this scope up to date at an instant.
+     *
+     * A message moves to its dead-letter queue when the source queue notices its
+     * visibility has lapsed, and nothing schedules that. A test that only reads
+     * the dead-letter queue would otherwise find it empty, so every queue is
+     * brought up to date before any one of them is answered from.
+     */
+    applyLifecycle(instant) {
+        for (const queue of this.all) {
+            queue.applyLifecycle(instant);
+        }
+    }
+    /**
+     * Resolve a queue by name, or refuse.
+     */
+    require(name) {
+        const found = this.find(name);
+        if (found === undefined) {
+            throw new SimSqsQueueDoesNotExist(`The specified queue does not exist: no queue named '${name}' in ` +
+                `this Account and Region`);
+        }
+        return found;
+    }
+    /**
+     * Forget a deleted queue, holding its name as real SQS holds it.
+     */
+    remove(queue, deletedAt) {
+        this.queues.delete(queue.name.value);
+        this.deletedNames.record(queue.name.value, deletedAt);
+    }
+    /**
+     * Refuse a name a recent deletion is still holding.
+     */
+    assertNameAvailable(name, instant) {
+        this.deletedNames.assertAvailable(name, instant);
+    }
+}
+//# sourceMappingURL=sim-sqs-queue-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-queue-store.js","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-queue-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAG3E;;;;;;GAMG;AACH,MAAM,OAAO,gBAAgB;IACV,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IACxC,YAAY,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAE9D;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IACxC,CAAC;IAED;;;;OAIG;IACH,cAAc,CAAC,MAA0B;QACvC,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC,CAC1C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAkB;QACpB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAY;QACf,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,GAAW;QACnB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,OAAa;QAC1B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,KAAK,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAE9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,uBAAuB,CAC/B,uDAAuD,IAAI,OAAO;gBAChE,yBAAyB,CAC5B,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAkB,EAAE,SAAe;QACxC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,IAAY,EAAE,OAAa;QAC7C,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/service/sqs/queue/sim-sqs-queue-url.d.ts

@@ -0,0 +1,24 @@
+import type { SimAwsAccountId } from "../../aws/sim-aws-account.js";
+import type { AwsRegionName } from "../../aws/sim-aws-region.js";
+/**
+ * The three facts a queue URL carries.
+ */
+export interface SimSqsQueueUrlParts {
+    readonly regionName: AwsRegionName;
+    readonly accountId: SimAwsAccountId;
+    readonly name: string;
+}
+/**
+ * Reads a queue URL.
+ *
+ * The region and account matter as much as the name. A queue URL naming
+ * another account or region does not reach a local queue that happens to share
+ * a name, so the parts are kept rather than the name alone.
+ */
+export declare const SimSqsQueueUrl: {
+    /**
+     * Read the parts of a queue URL, or undefined for a value that is not one.
+     */
+    parse(value: string): SimSqsQueueUrlParts | undefined;
+};
+//# sourceMappingURL=sim-sqs-queue-url.d.ts.map

package/dist/service/sqs/queue/sim-sqs-queue-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-queue-url.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-queue-url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAUjE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;IACH,KAAK,QAAQ,MAAM,GAAG,mBAAmB,GAAG,SAAS;CAqBtD,CAAC"}

package/dist/service/sqs/queue/sim-sqs-queue-url.js

@@ -0,0 +1,36 @@
+/**
+ * A queue URL is the only way an SDK request names a queue, and it carries the
+ * region and account as well as the name. Real SQS accepts it with or without a
+ * trailing slash; its own documented examples show both.
+ */
+const queueUrlPattern = /^https:\/\/sqs\.(?<region>[a-z\d-]+)\.amazonaws\.com\/(?<accountId>\d{12})\/(?<name>[^/]+)\/?$/;
+/**
+ * Reads a queue URL.
+ *
+ * The region and account matter as much as the name. A queue URL naming
+ * another account or region does not reach a local queue that happens to share
+ * a name, so the parts are kept rather than the name alone.
+ */
+export const SimSqsQueueUrl = {
+    /**
+     * Read the parts of a queue URL, or undefined for a value that is not one.
+     */
+    parse(value) {
+        const groups = queueUrlPattern.exec(value)?.groups;
+        if (groups === undefined) {
+            return undefined;
+        }
+        const { region, accountId, name } = groups;
+        /* v8 ignore next 3 -- unreachable: a match always fills every named group,
+           but the index signature the regex groups come back as cannot say so. */
+        if (region === undefined || accountId === undefined || name === undefined) {
+            return undefined;
+        }
+        return {
+            regionName: region,
+            accountId: accountId,
+            name,
+        };
+    },
+};
+//# sourceMappingURL=sim-sqs-queue-url.js.map

package/dist/service/sqs/queue/sim-sqs-queue-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-queue-url.js","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-queue-url.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,eAAe,GACnB,gGAAgG,CAAC;AAWnG;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;;OAEG;IACH,KAAK,CAAC,KAAa;QACjB,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAEnD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;QAE3C;kFAC0E;QAC1E,IAAI,MAAM,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1E,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO;YACL,UAAU,EAAE,MAAuB;YACnC,SAAS,EAAE,SAA4B;YACvC,IAAI;SACL,CAAC;IACJ,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,130 @@
+import type { SimAwsAccountRegionScope } from "../../aws/sim-aws-account-region-scope.js";
+import type { SimSqsMessage } from "../message/sim-sqs-message.js";
+import type { SimSqsDeadLetterTargets } from "./sim-sqs-dead-letter-targets.js";
+import type { SimSqsQueueActivity } from "./sim-sqs-queue-activity.js";
+import { SimSqsQueueArn } from "./sim-sqs-queue-arn.js";
+import type { SimSqsQueueName } from "./sim-sqs-queue-name.js";
+import type { SimSqsQueueAttributeInput, SimSqsQueueAttributes } from "./sim-sqs-queue-attributes.js";
+interface SimSqsQueueProperties {
+    readonly name: SimSqsQueueName;
+    readonly accountRegionScope: SimAwsAccountRegionScope;
+    readonly attributes: SimSqsQueueAttributes;
+    readonly createdAt: Date;
+    readonly deadLetterTargets: SimSqsDeadLetterTargets;
+    readonly activity: SimSqsQueueActivity;
+}
+/**
+ * One simulated standard queue.
+ *
+ * The queue owns its messages rather than a service-wide message table owning
+ * them, because everything a message does depends on the queue's attributes: how
+ * long it stays hidden once received, how long it is kept, and how big it is
+ * allowed to be. Retention and redrive are both applied whenever the messages
+ * are looked at, so moving simulated time forward loses the messages AWS would
+ * have dropped and moves the ones it would have given up on.
+ */
+export declare class SimSqsQueue {
+    readonly name: SimSqsQueueName;
+    readonly arn: SimSqsQueueArn;
+    readonly createdAt: Date;
+    private readonly messages;
+    private readonly deadLetterTargets;
+    private readonly activity;
+    private settings;
+    private lastModifiedAt;
+    constructor(properties: SimSqsQueueProperties);
+    /**
+     * The URL requests name this queue by.
+     */
+    get url(): string;
+    /**
+     * This queue's URL, for a request that asked to create it again.
+     *
+     * Real SQS answers a repeated CreateQueue with the URL of the queue already
+     * there when the attributes match, and refuses it when they differ. Only the
+     * attributes the request named are compared.
+     */
+    urlWhenAttributesMatch(requested: SimSqsQueueAttributeInput): string;
+    /**
+     * The attribute values this queue behaves by.
+     */
+    get attributes(): SimSqsQueueAttributes;
+    /**
+     * Apply the attribute values a request asks for, as SetQueueAttributes does.
+     *
+     * A redrive policy is only accepted once its dead-letter queue is there to
+     * accept messages, as real SQS only accepts one then. A policy naming a queue
+     * that does not exist would look like a working dead-letter queue and lose
+     * the messages it was supposed to keep, so it fails here instead of later.
+     */
+    applyAttributes(requested: SimSqsQueueAttributeInput, modifiedAt: Date): void;
+    /**
+     * Take a newly sent message.
+     *
+     * Anything watching the queue is told, which is how a Lambda event source
+     * mapping learns there is something to poll for. A message moved here from
+     * another queue arrives the same way, so a dead-letter queue with a mapping on
+     * it is polled too.
+     */
+    add(message: SimSqsMessage): void;
+    /**
+     * The messages that can be received at an instant, oldest first.
+     */
+    receivable(instant: Date, limit: number): readonly SimSqsMessage[];
+    /**
+     * When the earliest message this queue cannot hand out yet becomes
+     * receivable, or nothing when it holds no such message.
+     *
+     * This is not something SQS reports. It is how a consumer that cannot poll
+     * continuously, such as a Lambda event source mapping, knows when to look
+     * again at a queue whose messages are all in flight or delayed.
+     */
+    nextAvailability(instant: Date): Date | undefined;
+    /**
+     * Bring this queue up to date at an instant.
+     *
+     * Nothing is scheduled to age a message out or to give up on one. Both happen
+     * on the simulation's clock: what the retention period has outlived is
+     * dropped, and what has run out of receives moves to the dead-letter queue.
+     * Running it twice at one instant does nothing the second time.
+     */
+    applyLifecycle(instant: Date): void;
+    /**
+     * Record that a message was handed out under a receipt handle.
+     *
+     * A message handed out is hidden until its visibility timeout lapses, and
+     * watchers are told when that is. Without it, a message another consumer
+     * received would come back to the queue with nothing watching for it.
+     */
+    recordHandle(receiptHandle: string, message: SimSqsMessage): void;
+    /**
+     * Hide a message for a visibility timeout starting now, as
+     * ChangeMessageVisibility does, telling watchers when it comes back.
+     */
+    hideMessage(message: SimSqsMessage, instant: Date, visibilityTimeoutSeconds: number): void;
+    /**
+     * The message a receipt handle names, or undefined for a handle this queue
+     * never issued.
+     */
+    messageForHandle(receiptHandle: string, instant: Date): SimSqsMessage | undefined;
+    /**
+     * Forget a deleted message.
+     */
+    removeMessage(message: SimSqsMessage): void;
+    /**
+     * Forget every message on this queue, as PurgeQueue does.
+     */
+    purge(purgedAt: Date): void;
+    /**
+     * The attributes SQS reports about this queue, including the counts and
+     * timestamps no request can set.
+     */
+    reportedAttributes(instant: Date): ReadonlyMap<string, string>;
+    /**
+     * Tell this queue's watchers when a message can next be received.
+     */
+    private announceAvailability;
+    private dropExpired;
+}
+export {};
+//# sourceMappingURL=sim-sqs-queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sqs-queue.d.ts","sourceRoot":"","sources":["../../../../src/service/sqs/queue/sim-sqs-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAE1F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EACtB,MAAM,+BAA+B,CAAC;AAGvC,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;IACtD,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;CACxC;AAED;;;;;;;;;GASG;AACH,qBAAa,WAAW;IACtB,SAAgB,IAAI,EAAE,eAAe,CAAC;IACtC,SAAgB,GAAG,EAAE,cAAc,CAAC;IACpC,SAAgB,SAAS,EAAE,IAAI,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0B;IAC5D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,cAAc,CAAO;IAE7B,YAAY,UAAU,EAAE,qBAAqB,EAW5C;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;;;;;OAMG;IACH,sBAAsB,CAAC,SAAS,EAAE,yBAAyB,GAAG,MAAM,CASnE;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,qBAAqB,CAEtC;IAED;;;;;;;OAOG;IACH,eAAe,CACb,SAAS,EAAE,yBAAyB,EACpC,UAAU,EAAE,IAAI,GACf,IAAI,CAON;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAGhC;IAED;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE,CAIjE;IAED;;;;;;;OAOG;IACH,gBAAgB,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAIhD;IAED;;;;;;;OAOG;IACH,cAAc,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,CAQlC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAGhE;IAED;;;OAGG;IACH,WAAW,CACT,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,IAAI,EACb,wBAAwB,EAAE,MAAM,GAC/B,IAAI,CAGN;IAED;;;OAGG;IACH,gBAAgB,CACd,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,IAAI,GACZ,aAAa,GAAG,SAAS,CAI3B;IAED;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAE1C;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,CAG1B;IAED;;;OAGG;IACH,kBAAkB,CAAC,OAAO,EAAE,IAAI,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAU7D;IAED;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,WAAW;CAGpB"}