@kensio/yulin 1.9.0 → 1.10.1

package/dist/service/sns/delivery/sim-sns-delivery-failures.d.ts

@@ -0,0 +1,60 @@
+/**
+ * What a delivery that failed was trying to do.
+ */
+export interface SimSnsDeliveryFailureProperties {
+    readonly topicArn: string;
+    readonly subscriptionArn: string;
+    readonly endpointArn: string;
+    readonly messageId: string;
+    readonly error: unknown;
+}
+/**
+ * One message an endpoint did not take.
+ */
+export declare class SimSnsDeliveryFailure {
+    readonly topicArn: string;
+    readonly subscriptionArn: string;
+    readonly endpointArn: string;
+    readonly messageId: string;
+    readonly error: unknown;
+    constructor(properties: SimSnsDeliveryFailureProperties);
+    /**
+     * Whether the endpoint refused the message rather than failing on it.
+     */
+    get wasRefused(): boolean;
+    /**
+     * What went wrong, in one line.
+     */
+    get reason(): string;
+}
+/**
+ * What became of the messages a simulated SNS scope could not deliver.
+ *
+ * Real SNS tells the publisher nothing about a failed delivery: the publish is
+ * answered with a message id before anything is delivered, and a delivery that
+ * fails after that is the subscription's problem. Neither does this. Swallowing
+ * the failure entirely would leave a queue mysteriously empty, so every failure
+ * is kept for inspection and anything other than a refusal is warned about
+ * once.
+ */
+export declare class SimSnsDeliveryFailures {
+    private readonly failures;
+    private readonly warned;
+    /**
+     * Every message this scope could not deliver, oldest first.
+     */
+    get all(): readonly SimSnsDeliveryFailure[];
+    /**
+     * Record a failed delivery, from what the fan-out knows about it.
+     */
+    record(properties: SimSnsDeliveryFailureProperties): void;
+    /**
+     * Warn about an endpoint that failed, once per endpoint and cause.
+     *
+     * Warnings go to the console because that is where a test runner surfaces
+     * them next to the failing expectation they explain; the simulator has no
+     * logger of its own to route them through.
+     */
+    private warn;
+}
+//# sourceMappingURL=sim-sns-delivery-failures.d.ts.map

package/dist/service/sns/delivery/sim-sns-delivery-failures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-delivery-failures.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-delivery-failures.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,eAAe,EAAE,MAAM,CAAC;IACxC,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,KAAK,EAAE,OAAO,CAAC;IAE/B,YAAY,UAAU,EAAE,+BAA+B,EAMtD;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAInB;CACF;AAED;;;;;;;;;GASG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAE5C;;OAEG;IACH,IAAI,GAAG,IAAI,SAAS,qBAAqB,EAAE,CAE1C;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,EAAE,+BAA+B,GAAG,IAAI,CAaxD;IAED;;;;;;OAMG;IACH,OAAO,CAAC,IAAI;CAeb"}

package/dist/service/sns/delivery/sim-sns-delivery-failures.js

@@ -0,0 +1,84 @@
+import { SimSnsDeliveryNotPermitted } from "../error/sim-sns-delivery.error.js";
+/**
+ * One message an endpoint did not take.
+ */
+export class SimSnsDeliveryFailure {
+    topicArn;
+    subscriptionArn;
+    endpointArn;
+    messageId;
+    error;
+    constructor(properties) {
+        this.topicArn = properties.topicArn;
+        this.subscriptionArn = properties.subscriptionArn;
+        this.endpointArn = properties.endpointArn;
+        this.messageId = properties.messageId;
+        this.error = properties.error;
+    }
+    /**
+     * Whether the endpoint refused the message rather than failing on it.
+     */
+    get wasRefused() {
+        return this.error instanceof SimSnsDeliveryNotPermitted;
+    }
+    /**
+     * What went wrong, in one line.
+     */
+    get reason() {
+        return this.error instanceof Error
+            ? this.error.message
+            : String(this.error);
+    }
+}
+/**
+ * What became of the messages a simulated SNS scope could not deliver.
+ *
+ * Real SNS tells the publisher nothing about a failed delivery: the publish is
+ * answered with a message id before anything is delivered, and a delivery that
+ * fails after that is the subscription's problem. Neither does this. Swallowing
+ * the failure entirely would leave a queue mysteriously empty, so every failure
+ * is kept for inspection and anything other than a refusal is warned about
+ * once.
+ */
+export class SimSnsDeliveryFailures {
+    failures = [];
+    warned = new Set();
+    /**
+     * Every message this scope could not deliver, oldest first.
+     */
+    get all() {
+        return this.failures;
+    }
+    /**
+     * Record a failed delivery, from what the fan-out knows about it.
+     */
+    record(properties) {
+        const failure = new SimSnsDeliveryFailure(properties);
+        this.failures.push(failure);
+        if (failure.wasRefused) {
+            // A refusal is a modelled outcome rather than a fault: the queue policy
+            // says no, which is what a test taking a permission away is checking
+            // for. It is recorded, not warned about.
+            return;
+        }
+        this.warn(failure);
+    }
+    /**
+     * Warn about an endpoint that failed, once per endpoint and cause.
+     *
+     * Warnings go to the console because that is where a test runner surfaces
+     * them next to the failing expectation they explain; the simulator has no
+     * logger of its own to route them through.
+     */
+    warn(failure) {
+        const key = `${failure.endpointArn}:${failure.reason}`;
+        if (this.warned.has(key)) {
+            return;
+        }
+        this.warned.add(key);
+        // eslint-disable-next-line no-console
+        console.warn(`Simulated SNS topic ${failure.topicArn} could not deliver to ` +
+            `${failure.endpointArn}: ${failure.reason}`);
+    }
+}
+//# sourceMappingURL=sim-sns-delivery-failures.js.map

package/dist/service/sns/delivery/sim-sns-delivery-failures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-delivery-failures.js","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-delivery-failures.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAahF;;GAEG;AACH,MAAM,OAAO,qBAAqB;IAChB,QAAQ,CAAS;IACjB,eAAe,CAAS;IACxB,WAAW,CAAS;IACpB,SAAS,CAAS;IAClB,KAAK,CAAU;IAE/B,YAAY,UAA2C;QACrD,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,eAAe,CAAC;QAClD,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,KAAK,YAAY,0BAA0B,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,YAAY,KAAK;YAChC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;YACpB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,OAAO,sBAAsB;IAChB,QAAQ,GAA4B,EAAE,CAAC;IACvC,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAE5C;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAA2C;QAChD,MAAM,OAAO,GAAG,IAAI,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAEtD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAE5B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACvB,wEAAwE;YACxE,qEAAqE;YACrE,yCAAyC;YACzC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED;;;;;;OAMG;IACK,IAAI,CAAC,OAA8B;QACzC,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAEvD,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAErB,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,uBAAuB,OAAO,CAAC,QAAQ,wBAAwB;YAC7D,GAAG,OAAO,CAAC,WAAW,KAAK,OAAO,CAAC,MAAM,EAAE,CAC9C,CAAC;IACJ,CAAC;CACF"}

package/dist/service/sns/delivery/sim-sns-delivery-request.d.ts

@@ -0,0 +1,28 @@
+import type { SimAwsAccountRegionScope } from "../../aws/sim-aws-account-region-scope.js";
+import type { SimSnsPublishedMessage } from "../message/sim-sns-published-message.js";
+import type { SimSnsMessageSigner } from "../signature/sim-sns-message-signer.js";
+import type { SimSnsSubscription } from "../subscription/sim-sns-subscription.js";
+import type { SimSnsDeliveryRequest } from "./sim-sns-delivery.js";
+interface SimSnsDeliveryRequestsProperties {
+    readonly signer: SimSnsMessageSigner;
+    readonly accountRegionScope: SimAwsAccountRegionScope;
+}
+/**
+ * Builds what each subscription of one simulated SNS scope is sent.
+ *
+ * The notification is built here rather than at the endpoint, because it is
+ * signed with the scope's own key: the signature belongs to the message rather
+ * than to the destination. Which document the endpoint makes of it is the
+ * endpoint's own business.
+ */
+export declare class SimSnsDeliveryRequests {
+    private readonly signer;
+    private readonly scope;
+    constructor(properties: SimSnsDeliveryRequestsProperties);
+    /**
+     * What one subscription is being sent for one published message.
+     */
+    for(subscription: SimSnsSubscription, message: SimSnsPublishedMessage): SimSnsDeliveryRequest;
+}
+export {};
+//# sourceMappingURL=sim-sns-delivery-request.d.ts.map

package/dist/service/sns/delivery/sim-sns-delivery-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-delivery-request.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-delivery-request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAGnE,UAAU,gCAAgC;IACxC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;CACvD;AAED;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IAEjD,YAAY,UAAU,EAAE,gCAAgC,EAGvD;IAED;;OAEG;IACH,GAAG,CACD,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,sBAAsB,GAC9B,qBAAqB,CAYvB;CACF"}

package/dist/service/sns/delivery/sim-sns-delivery-request.js

@@ -0,0 +1,34 @@
+import { SimSnsNotification } from "./sim-sns-notification.js";
+/**
+ * Builds what each subscription of one simulated SNS scope is sent.
+ *
+ * The notification is built here rather than at the endpoint, because it is
+ * signed with the scope's own key: the signature belongs to the message rather
+ * than to the destination. Which document the endpoint makes of it is the
+ * endpoint's own business.
+ */
+export class SimSnsDeliveryRequests {
+    signer;
+    scope;
+    constructor(properties) {
+        this.signer = properties.signer;
+        this.scope = properties.accountRegionScope;
+    }
+    /**
+     * What one subscription is being sent for one published message.
+     */
+    for(subscription, message) {
+        return {
+            subscription,
+            message,
+            topicOwnerAccountId: this.scope.accountId,
+            notification: new SimSnsNotification({
+                message,
+                subscription,
+                regionName: this.scope.regionName,
+                signer: this.signer,
+            }),
+        };
+    }
+}
+//# sourceMappingURL=sim-sns-delivery-request.js.map

package/dist/service/sns/delivery/sim-sns-delivery-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-delivery-request.js","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-delivery-request.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAO/D;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAsB;IAChB,MAAM,CAAsB;IAC5B,KAAK,CAA2B;IAEjD,YAAY,UAA4C;QACtD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,kBAAkB,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,GAAG,CACD,YAAgC,EAChC,OAA+B;QAE/B,OAAO;YACL,YAAY;YACZ,OAAO;YACP,mBAAmB,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS;YACzC,YAAY,EAAE,IAAI,kBAAkB,CAAC;gBACnC,OAAO;gBACP,YAAY;gBACZ,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;gBACjC,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC;SACH,CAAC;IACJ,CAAC;CACF"}

package/dist/service/sns/delivery/sim-sns-delivery.d.ts

@@ -0,0 +1,55 @@
+import type { SimSnsPublishedMessage } from "../message/sim-sns-published-message.js";
+import type { SimSnsSubscription } from "../subscription/sim-sns-subscription.js";
+import type { SimSnsNotification } from "./sim-sns-notification.js";
+/**
+ * The service principal simulated SNS reaches another service as.
+ *
+ * This is the principal a destination's resource policy has to admit, which is
+ * why a queue subscribed to a topic needs `sns.amazonaws.com` in its policy and
+ * a function needs it in an `AddPermission` grant.
+ */
+export declare const simSnsServicePrincipal = "sns.amazonaws.com";
+/**
+ * One message on its way from a topic to a subscription's endpoint.
+ *
+ * The notification comes along signed, because the signature is over the
+ * message rather than over the destination. What each protocol makes of it is
+ * the endpoint's own business: a queue receives it as an envelope, and a Lambda
+ * function receives it inside an event record.
+ */
+export interface SimSnsDeliveryRequest {
+    readonly subscription: SimSnsSubscription;
+    readonly message: SimSnsPublishedMessage;
+    readonly topicOwnerAccountId: string;
+    readonly notification: SimSnsNotification;
+}
+/**
+ * Somewhere a simulated topic can deliver a published message.
+ *
+ * There is one implementation per protocol, because what a destination is asked
+ * and what it is handed differ by protocol: a second protocol adds a second
+ * implementation rather than a branch in an existing one.
+ * `SimSnsProtocolDeliveryEndpoints` is what picks between them.
+ */
+export interface SimSnsDeliveryEndpoints {
+    /**
+     * Deliver one message, refusing if the endpoint does not admit SNS.
+     */
+    deliver(request: SimSnsDeliveryRequest): Promise<void>;
+}
+/**
+ * What a destination's policy is asked about, as IAM condition values.
+ *
+ * A destination is admitting one topic rather than SNS at large, so every
+ * endpoint supplies these two: the topic as `aws:SourceArn`, and the Account
+ * owning it as `aws:SourceAccount`.
+ */
+export interface SimSnsDeliverySource {
+    readonly sourceArn: string;
+    readonly sourceAccount: string;
+}
+/**
+ * Which topic a delivery is being made for, and whose it is.
+ */
+export declare function simSnsDeliverySource(request: SimSnsDeliveryRequest): SimSnsDeliverySource;
+//# sourceMappingURL=sim-sns-delivery.d.ts.map

package/dist/service/sns/delivery/sim-sns-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-delivery.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,sBAAsB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;CAC3C;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,oBAAoB,CAKtB"}

package/dist/service/sns/delivery/sim-sns-delivery.js

@@ -0,0 +1,18 @@
+/**
+ * The service principal simulated SNS reaches another service as.
+ *
+ * This is the principal a destination's resource policy has to admit, which is
+ * why a queue subscribed to a topic needs `sns.amazonaws.com` in its policy and
+ * a function needs it in an `AddPermission` grant.
+ */
+export const simSnsServicePrincipal = "sns.amazonaws.com";
+/**
+ * Which topic a delivery is being made for, and whose it is.
+ */
+export function simSnsDeliverySource(request) {
+    return {
+        sourceArn: request.subscription.topicArn,
+        sourceAccount: request.topicOwnerAccountId,
+    };
+}
+//# sourceMappingURL=sim-sns-delivery.js.map

package/dist/service/sns/delivery/sim-sns-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-delivery.js","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-delivery.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AA4C1D;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA8B;IAE9B,OAAO;QACL,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,QAAQ;QACxC,aAAa,EAAE,OAAO,CAAC,mBAAmB;KAC3C,CAAC;AACJ,CAAC"}

package/dist/service/sns/delivery/sim-sns-envelope.d.ts

@@ -0,0 +1,26 @@
+import type { SimSnsNotification } from "./sim-sns-notification.js";
+interface SimSnsEnvelopeProperties {
+    readonly notification: SimSnsNotification;
+}
+/**
+ * The document a subscription receives when it is not asking for raw delivery.
+ *
+ * Real SNS wraps the published message in this, which is why a consumer written
+ * for it reads `JSON.parse(body).Message` rather than `body`. Everything real
+ * SNS puts in it is here, including a signature a verifier can actually check.
+ *
+ * The two URLs are spelled in upper case, which is how real SNS spells them in
+ * an envelope. A Lambda event spells the same two fields `SigningCertUrl` and
+ * `UnsubscribeUrl`.
+ */
+export declare class SimSnsEnvelope {
+    private readonly notification;
+    constructor(properties: SimSnsEnvelopeProperties);
+    /**
+     * The envelope as the JSON body a queue receives.
+     */
+    get body(): string;
+    private document;
+}
+export {};
+//# sourceMappingURL=sim-sns-envelope.d.ts.map

package/dist/service/sns/delivery/sim-sns-envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-envelope.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-envelope.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,UAAU,wBAAwB;IAChC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;CAC3C;AAED;;;;;;;;;;GAUG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,YAAY,UAAU,EAAE,wBAAwB,EAE/C;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,OAAO,CAAC,QAAQ;CAiBjB"}

package/dist/service/sns/delivery/sim-sns-envelope.js

@@ -0,0 +1,41 @@
+import { jsonStringify } from "../../../util/type-guard/json.js";
+/**
+ * The document a subscription receives when it is not asking for raw delivery.
+ *
+ * Real SNS wraps the published message in this, which is why a consumer written
+ * for it reads `JSON.parse(body).Message` rather than `body`. Everything real
+ * SNS puts in it is here, including a signature a verifier can actually check.
+ *
+ * The two URLs are spelled in upper case, which is how real SNS spells them in
+ * an envelope. A Lambda event spells the same two fields `SigningCertUrl` and
+ * `UnsubscribeUrl`.
+ */
+export class SimSnsEnvelope {
+    notification;
+    constructor(properties) {
+        this.notification = properties.notification;
+    }
+    /**
+     * The envelope as the JSON body a queue receives.
+     */
+    get body() {
+        return jsonStringify(this.document());
+    }
+    document() {
+        const fields = this.notification.fields();
+        return {
+            Type: fields.type,
+            MessageId: fields.messageId,
+            TopicArn: fields.topicArn,
+            ...(fields.subject !== undefined && { Subject: fields.subject }),
+            Message: fields.message,
+            Timestamp: fields.timestamp,
+            ...fields.signature,
+            UnsubscribeURL: fields.unsubscribeUrl,
+            ...(fields.hasMessageAttributes && {
+                MessageAttributes: fields.messageAttributes,
+            }),
+        };
+    }
+}
+//# sourceMappingURL=sim-sns-envelope.js.map

package/dist/service/sns/delivery/sim-sns-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-envelope.js","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-envelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAOjE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,cAAc;IACR,YAAY,CAAqB;IAElD,YAAY,UAAoC;QAC9C,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC;IAEO,QAAQ;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QAE1C,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YAChE,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,GAAG,MAAM,CAAC,SAAS;YACnB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,GAAG,CAAC,MAAM,CAAC,oBAAoB,IAAI;gBACjC,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;aAC5C,CAAC;SACH,CAAC;IACJ,CAAC;CACF"}

package/dist/service/sns/delivery/sim-sns-fan-out.d.ts

@@ -0,0 +1,53 @@
+import type { BackgroundScheduler } from "../../../util/background/background.js";
+import type { SimSnsPublishedMessage } from "../message/sim-sns-published-message.js";
+import type { SimSnsSubscriptionStore } from "../subscription/sim-sns-subscription-store.js";
+import type { SimSnsTopic } from "../topic/sim-sns-topic.js";
+import type { SimSnsDeliveryEndpoints } from "./sim-sns-delivery.js";
+import type { SimSnsDeliveryRequests } from "./sim-sns-delivery-request.js";
+import type { SimSnsDeliveryFailure } from "./sim-sns-delivery-failures.js";
+interface SimSnsFanOutProperties {
+    readonly subscriptions: SimSnsSubscriptionStore;
+    readonly endpoints: SimSnsDeliveryEndpoints;
+    readonly requests: SimSnsDeliveryRequests;
+    readonly background: BackgroundScheduler;
+}
+/**
+ * Hands a published message to every subscription of its topic.
+ *
+ * Delivery happens on the background scheduler, as real SNS delivers after the
+ * publish has been answered: a publish gets a message id whether or not
+ * anything downstream takes the message.
+ * `simAws.backgroundTasksComplete()` is what waits for it.
+ */
+export declare class SimSnsFanOut {
+    private readonly subscriptions;
+    private readonly endpoints;
+    private readonly requests;
+    private readonly background;
+    private readonly failures;
+    constructor(properties: SimSnsFanOutProperties);
+    /**
+     * Every message this scope could not deliver.
+     */
+    get deliveryFailures(): readonly SimSnsDeliveryFailure[];
+    /**
+     * Schedule one message for every subscription of a topic that wants it.
+     *
+     * Each subscription gets its own copy, which is what a topic is for: two
+     * queues subscribed to one topic both receive what was published once. A
+     * subscription whose filter policy does not match the message is left out,
+     * and asking each one separately is what keeps one subscriber's policy from
+     * having anything to do with what another receives.
+     */
+    publish(topic: SimSnsTopic, message: SimSnsPublishedMessage): void;
+    /**
+     * Deliver one message to one subscription, keeping whatever went wrong.
+     *
+     * A failure is recorded rather than thrown, because a background task left
+     * rejected would fail an unrelated `backgroundTasksComplete()`, and real SNS
+     * never reports a delivery failure to the caller who published.
+     */
+    private deliver;
+}
+export {};
+//# sourceMappingURL=sim-sns-fan-out.d.ts.map

package/dist/service/sns/delivery/sim-sns-fan-out.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-fan-out.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-fan-out.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,+CAA+C,CAAC;AAC7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAG5E,UAAU,sBAAsB;IAC9B,QAAQ,CAAC,aAAa,EAAE,uBAAuB,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsB;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgC;IAEzD,YAAY,UAAU,EAAE,sBAAsB,EAK7C;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,SAAS,qBAAqB,EAAE,CAEvD;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAUjE;IAED;;;;;;OAMG;YACW,OAAO;CAiBtB"}

package/dist/service/sns/delivery/sim-sns-fan-out.js

@@ -0,0 +1,69 @@
+import { SimSnsDeliveryFailures } from "./sim-sns-delivery-failures.js";
+/**
+ * Hands a published message to every subscription of its topic.
+ *
+ * Delivery happens on the background scheduler, as real SNS delivers after the
+ * publish has been answered: a publish gets a message id whether or not
+ * anything downstream takes the message.
+ * `simAws.backgroundTasksComplete()` is what waits for it.
+ */
+export class SimSnsFanOut {
+    subscriptions;
+    endpoints;
+    requests;
+    background;
+    failures = new SimSnsDeliveryFailures();
+    constructor(properties) {
+        this.subscriptions = properties.subscriptions;
+        this.endpoints = properties.endpoints;
+        this.requests = properties.requests;
+        this.background = properties.background;
+    }
+    /**
+     * Every message this scope could not deliver.
+     */
+    get deliveryFailures() {
+        return this.failures.all;
+    }
+    /**
+     * Schedule one message for every subscription of a topic that wants it.
+     *
+     * Each subscription gets its own copy, which is what a topic is for: two
+     * queues subscribed to one topic both receive what was published once. A
+     * subscription whose filter policy does not match the message is left out,
+     * and asking each one separately is what keeps one subscriber's policy from
+     * having anything to do with what another receives.
+     */
+    publish(topic, message) {
+        const subscribed = this.subscriptions
+            .forTopic(topic.name.value)
+            .filter((subscription) => subscription.accepts(message));
+        for (const subscription of subscribed) {
+            this.background.schedule(async () => {
+                await this.deliver(topic, subscription, message);
+            });
+        }
+    }
+    /**
+     * Deliver one message to one subscription, keeping whatever went wrong.
+     *
+     * A failure is recorded rather than thrown, because a background task left
+     * rejected would fail an unrelated `backgroundTasksComplete()`, and real SNS
+     * never reports a delivery failure to the caller who published.
+     */
+    async deliver(topic, subscription, message) {
+        try {
+            await this.endpoints.deliver(this.requests.for(subscription, message));
+        }
+        catch (error) {
+            this.failures.record({
+                topicArn: topic.arn.value,
+                subscriptionArn: subscription.arn.value,
+                endpointArn: subscription.endpoint.value,
+                messageId: message.messageId,
+                error,
+            });
+        }
+    }
+}
+//# sourceMappingURL=sim-sns-fan-out.js.map

package/dist/service/sns/delivery/sim-sns-fan-out.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-fan-out.js","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-fan-out.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AASxE;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACN,aAAa,CAA0B;IACvC,SAAS,CAA0B;IACnC,QAAQ,CAAyB;IACjC,UAAU,CAAsB;IAChC,QAAQ,GAAG,IAAI,sBAAsB,EAAE,CAAC;IAEzD,YAAY,UAAkC;QAC5C,IAAI,CAAC,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,UAAU,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,KAAkB,EAAE,OAA+B;QACzD,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa;aAClC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;aAC1B,MAAM,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QAE3D,KAAK,MAAM,YAAY,IAAI,UAAU,EAAE,CAAC;YACtC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;gBAClC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,OAAO,CACnB,KAAkB,EAClB,YAAgC,EAChC,OAA+B;QAE/B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACnB,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK;gBACzB,eAAe,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK;gBACvC,WAAW,EAAE,YAAY,CAAC,QAAQ,CAAC,KAAK;gBACxC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,KAAK;aACN,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/service/sns/delivery/sim-sns-no-delivery-endpoints.d.ts

@@ -0,0 +1,17 @@
+import type { SimSnsDeliveryEndpoints, SimSnsDeliveryRequest } from "./sim-sns-delivery.js";
+/**
+ * The endpoints a simulated SNS built on its own can reach, which is none.
+ *
+ * A standalone SimSns has no other simulated services to reach, and owns its
+ * own background scheduler, so nothing could wait for a delivery it made even
+ * if it could make one. Subscriptions still work, since holding them takes
+ * nothing but SNS: it is delivery that is refused, and the refusal is recorded
+ * as a delivery failure like any other.
+ */
+export declare class SimSnsNoDeliveryEndpoints implements SimSnsDeliveryEndpoints {
+    /**
+     * Refuse every delivery, explaining how to get one.
+     */
+    deliver(request: SimSnsDeliveryRequest): never;
+}
+//# sourceMappingURL=sim-sns-no-delivery-endpoints.d.ts.map

package/dist/service/sns/delivery/sim-sns-no-delivery-endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-no-delivery-endpoints.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-no-delivery-endpoints.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;GAQG;AACH,qBAAa,yBAA0B,YAAW,uBAAuB;IACvE;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,KAAK,CAQ7C;CACF"}

package/dist/service/sns/delivery/sim-sns-no-delivery-endpoints.js

@@ -0,0 +1,23 @@
+import { SimSnsUnsimulatedInputException } from "../error/sim-sns.error.js";
+/**
+ * The endpoints a simulated SNS built on its own can reach, which is none.
+ *
+ * A standalone SimSns has no other simulated services to reach, and owns its
+ * own background scheduler, so nothing could wait for a delivery it made even
+ * if it could make one. Subscriptions still work, since holding them takes
+ * nothing but SNS: it is delivery that is refused, and the refusal is recorded
+ * as a delivery failure like any other.
+ */
+export class SimSnsNoDeliveryEndpoints {
+    /**
+     * Refuse every delivery, explaining how to get one.
+     */
+    deliver(request) {
+        throw new SimSnsUnsimulatedInputException(`Cannot deliver to ${request.subscription.endpoint.value}: this SimSns ` +
+            "was constructed on its own, so it has no other simulated services to " +
+            "deliver to and no shared background scheduler to deliver on. Reach " +
+            "simulated SNS through SimAws to deliver a published message to a " +
+            "queue or a function.");
+    }
+}
+//# sourceMappingURL=sim-sns-no-delivery-endpoints.js.map

package/dist/service/sns/delivery/sim-sns-no-delivery-endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-no-delivery-endpoints.js","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-no-delivery-endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,2BAA2B,CAAC;AAM5E;;;;;;;;GAQG;AACH,MAAM,OAAO,yBAAyB;IACpC;;OAEG;IACH,OAAO,CAAC,OAA8B;QACpC,MAAM,IAAI,+BAA+B,CACvC,qBAAqB,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,gBAAgB;YACtE,uEAAuE;YACvE,qEAAqE;YACrE,mEAAmE;YACnE,sBAAsB,CACzB,CAAC;IACJ,CAAC;CACF"}

package/dist/service/sns/delivery/sim-sns-notification.d.ts

@@ -0,0 +1,57 @@
+import type { SimSnsEnvelopeMessageAttribute } from "../message/sim-sns-message-attributes.js";
+import type { SimSnsPublishedMessage } from "../message/sim-sns-published-message.js";
+import type { SimSnsMessageSigner, SimSnsSignatureFields } from "../signature/sim-sns-message-signer.js";
+import type { SimSnsSubscription } from "../subscription/sim-sns-subscription.js";
+/**
+ * One published message as every destination's document carries it.
+ *
+ * A queue and a Lambda function are handed the same values with the same
+ * signature over them. What differs is how each protocol spells two of the
+ * URLs, and whether an absent subject and an empty attribute set are left out,
+ * so those belong to the documents rather than here.
+ *
+ * The names here are the simulator's own rather than either document's, so that
+ * neither spelling looks like the right one.
+ */
+export interface SimSnsNotificationFields {
+    readonly type: string;
+    readonly messageId: string;
+    readonly topicArn: string;
+    readonly subject: string | undefined;
+    readonly message: string;
+    readonly timestamp: string;
+    readonly signature: SimSnsSignatureFields;
+    readonly unsubscribeUrl: string;
+    readonly messageAttributes: Record<string, SimSnsEnvelopeMessageAttribute>;
+    readonly hasMessageAttributes: boolean;
+}
+interface SimSnsNotificationProperties {
+    readonly message: SimSnsPublishedMessage;
+    readonly subscription: SimSnsSubscription;
+    readonly regionName: string;
+    readonly signer: SimSnsMessageSigner;
+}
+/**
+ * What one subscription is being told, signed once for whichever document
+ * carries it.
+ *
+ * The fields are kept once they have been built rather than built again per
+ * document, so a message that reaches two documents is signed once. Signing is
+ * the expensive part of a delivery, and a second signature over the same string
+ * would be the same signature anyway.
+ */
+export declare class SimSnsNotification {
+    private readonly message;
+    private readonly subscription;
+    private readonly regionName;
+    private readonly signer;
+    private held;
+    constructor(properties: SimSnsNotificationProperties);
+    /**
+     * The values a delivered document is built out of.
+     */
+    fields(): SimSnsNotificationFields;
+    private build;
+}
+export {};
+//# sourceMappingURL=sim-sns-notification.d.ts.map

package/dist/service/sns/delivery/sim-sns-notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-notification.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/delivery/sim-sns-notification.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,0CAA0C,CAAC;AAC/F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEtF,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AASlF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAC;IAC3E,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;CACxC;AAED,UAAU,4BAA4B;IACpC,QAAQ,CAAC,OAAO,EAAE,sBAAsB,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAAC;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAE7C,OAAO,CAAC,IAAI,CAAuC;IAEnD,YAAY,UAAU,EAAE,4BAA4B,EAKnD;IAED;;OAEG;IACH,MAAM,IAAI,wBAAwB,CAIjC;IAED,OAAO,CAAC,KAAK;CAiCd"}