@kensio/yulin 1.9.0 → 1.10.0

package/dist/service/sns/subscription/sim-sns-subscription-attributes.js

@@ -0,0 +1,67 @@
+import { simSnsDefaultFilterPolicyScope, } from "../filter/sim-sns-filter-policy-scope.js";
+import { simSnsChangedSubscriptionAttributes, } from "./sim-sns-subscription-attribute-changes.js";
+import { simSnsFilterPolicyAttributeName, simSnsFilterPolicyScopeAttributeName, simSnsRawMessageDeliveryAttributeName, } from "./sim-sns-subscription-attribute-names.js";
+/**
+ * The attributes of one simulated subscription that a request can set.
+ *
+ * Applying a request makes a new set rather than changing this one, so a
+ * request naming an attribute this simulation will not take leaves the
+ * subscription as it was.
+ */
+export class SimSnsSubscriptionAttributes {
+    rawMessageDelivery;
+    filterPolicy;
+    filterPolicyScope;
+    constructor(values) {
+        this.rawMessageDelivery = values.rawMessageDelivery;
+        this.filterPolicy = values.filterPolicy;
+        this.filterPolicyScope = values.filterPolicyScope;
+    }
+    /**
+     * The attributes a subscription has before anything sets one.
+     *
+     * Real SNS reports `RawMessageDelivery` as false for a subscription created
+     * without it, rather than leaving the attribute out, which is why it is held
+     * rather than being absent until set. A subscription holds no filter policy
+     * until one is set, and receives everything its topic publishes.
+     */
+    static defaults() {
+        return new this({
+            rawMessageDelivery: false,
+            filterPolicy: undefined,
+            filterPolicyScope: simSnsDefaultFilterPolicyScope,
+        });
+    }
+    /**
+     * These attributes with a request's changes applied.
+     */
+    with(requested) {
+        return new SimSnsSubscriptionAttributes(simSnsChangedSubscriptionAttributes(this, requested));
+    }
+    /**
+     * Whether this subscription's filter policy admits a published message.
+     *
+     * A subscription with no policy takes everything its topic publishes, which
+     * is what a subscription without one does on real SNS.
+     */
+    accepts(message) {
+        return this.filterPolicy?.matches(message) ?? true;
+    }
+    /**
+     * Add these attributes to what SNS reports about the subscription.
+     *
+     * The two filter policy attributes are reported only when there is a policy,
+     * as real SNS reports them. A subscription that filters nothing has no scope
+     * to report either, since the scope only says how a policy is read.
+     */
+    reportInto(reported) {
+        reported.set(simSnsRawMessageDeliveryAttributeName, String(this.rawMessageDelivery));
+        if (this.filterPolicy === undefined) {
+            return;
+        }
+        reported.set(simSnsFilterPolicyAttributeName, this.filterPolicy.value);
+        reported.set(simSnsFilterPolicyScopeAttributeName, this.filterPolicyScope.value);
+    }
+}
+export {} from "./sim-sns-requested-subscription-attributes.js";
+//# sourceMappingURL=sim-sns-subscription-attributes.js.map

package/dist/service/sns/subscription/sim-sns-subscription-attributes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-attributes.js","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-attributes.ts"],"names":[],"mappings":"AACA,OAAO,EACL,8BAA8B,GAE/B,MAAM,0CAA0C,CAAC;AAGlD,OAAO,EACL,mCAAmC,GAEpC,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,+BAA+B,EAC/B,oCAAoC,EACpC,qCAAqC,GACtC,MAAM,2CAA2C,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,OAAO,4BAA4B;IACvB,kBAAkB,CAAU;IAC5B,YAAY,CAAiC;IAC7C,iBAAiB,CAA0B;IAE3D,YAAoB,MAAyC;QAC3D,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;QACpD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,iBAAiB,CAAC;IACpD,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ;QACb,OAAO,IAAI,IAAI,CAAC;YACd,kBAAkB,EAAE,KAAK;YACzB,YAAY,EAAE,SAAS;YACvB,iBAAiB,EAAE,8BAA8B;SAClD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,CACF,SAA2C;QAE3C,OAAO,IAAI,4BAA4B,CACrC,mCAAmC,CAAC,IAAI,EAAE,SAAS,CAAC,CACrD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAA+B;QACrC,OAAO,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;IACrD,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,QAA6B;QACtC,QAAQ,CAAC,GAAG,CACV,qCAAqC,EACrC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAChC,CAAC;QAEF,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,+BAA+B,EAAE,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACvE,QAAQ,CAAC,GAAG,CACV,oCAAoC,EACpC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAC7B,CAAC;IACJ,CAAC;CACF;AAED,OAAO,EAAyC,MAAM,gDAAgD,CAAC"}

package/dist/service/sns/subscription/sim-sns-subscription-endpoint.d.ts

@@ -0,0 +1,26 @@
+import type { SimAwsAccountId } from "../../aws/sim-aws-account-id.js";
+import type { AwsRegionName } from "../../aws/sim-aws-region.js";
+import { type SimSnsSubscriptionProtocol } from "./sim-sns-subscription-protocol.js";
+/**
+ * Where a subscription delivers, whichever kind of endpoint its protocol
+ * implies.
+ *
+ * Every protocol simulated names its endpoint by an ARN, and every delivery
+ * needs the same three things from it: the ARN itself, and the Account and
+ * Region to resolve the endpoint in. What kind of resource it is belongs to the
+ * protocol's own endpoint type.
+ */
+export interface SimSnsSubscriptionEndpoint {
+    readonly value: string;
+    readonly regionName: AwsRegionName;
+    readonly accountId: SimAwsAccountId;
+}
+/**
+ * Read the endpoint a Subscribe request names, for the protocol it named.
+ *
+ * The protocol decides what the endpoint has to be, so an SQS queue ARN over
+ * the `lambda` protocol is refused here rather than at delivery time. Real SNS
+ * validates the endpoint against the protocol at `Subscribe` time too.
+ */
+export declare function requireSimSnsSubscriptionEndpoint(protocol: SimSnsSubscriptionProtocol, endpoint: string | undefined): SimSnsSubscriptionEndpoint;
+//# sourceMappingURL=sim-sns-subscription-endpoint.d.ts.map

package/dist/service/sns/subscription/sim-sns-subscription-endpoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-endpoint.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-endpoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,0BAA0B,EACpC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,0BAA0B,CAS5B"}

package/dist/service/sns/subscription/sim-sns-subscription-endpoint.js

@@ -0,0 +1,21 @@
+import { SimSnsFunctionEndpointArn } from "./sim-sns-function-endpoint-arn.js";
+import { SimSnsQueueEndpointArn } from "./sim-sns-queue-endpoint-arn.js";
+import { simSnsLambdaProtocol, simSnsSqsProtocol, } from "./sim-sns-subscription-protocol.js";
+/**
+ * Read the endpoint a Subscribe request names, for the protocol it named.
+ *
+ * The protocol decides what the endpoint has to be, so an SQS queue ARN over
+ * the `lambda` protocol is refused here rather than at delivery time. Real SNS
+ * validates the endpoint against the protocol at `Subscribe` time too.
+ */
+export function requireSimSnsSubscriptionEndpoint(protocol, endpoint) {
+    switch (protocol) {
+        case simSnsSqsProtocol: {
+            return SimSnsQueueEndpointArn.parse(endpoint ?? "");
+        }
+        case simSnsLambdaProtocol: {
+            return SimSnsFunctionEndpointArn.parse(endpoint ?? "");
+        }
+    }
+}
+//# sourceMappingURL=sim-sns-subscription-endpoint.js.map

package/dist/service/sns/subscription/sim-sns-subscription-endpoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-endpoint.js","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-endpoint.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EACL,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,oCAAoC,CAAC;AAiB5C;;;;;;GAMG;AACH,MAAM,UAAU,iCAAiC,CAC/C,QAAoC,EACpC,QAA4B;IAE5B,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,iBAAiB,EAAE,CAAC;YACvB,OAAO,sBAAsB,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,oBAAoB,EAAE,CAAC;YAC1B,OAAO,yBAAyB,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/service/sns/subscription/sim-sns-subscription-protocol.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Delivery to an SQS queue.
+ *
+ * A queue is what SNS is most often put in front of, and it is a protocol with
+ * no confirmation step: real SNS confirms an `sqs` subscription itself, so
+ * `Subscribe` answers with a subscription ARN rather than `pending
+ * confirmation`.
+ */
+export declare const simSnsSqsProtocol = "sqs";
+/**
+ * Delivery by invoking a Lambda function.
+ *
+ * Real SNS confirms this one itself too, so a `lambda` subscription is
+ * confirmed as soon as it exists. The function is invoked asynchronously with
+ * an event carrying the published message.
+ */
+export declare const simSnsLambdaProtocol = "lambda";
+/**
+ * A protocol a simulated subscription can be created with.
+ */
+export type SimSnsSubscriptionProtocol = typeof simSnsSqsProtocol | typeof simSnsLambdaProtocol;
+/**
+ * Read the protocol a Subscribe request names, refusing one that delivers
+ * nowhere.
+ *
+ * Real SNS refuses a protocol it does not have with
+ * `InvalidParameterException`, and that is what a misspelling gets here. A
+ * protocol real SNS does have and this simulation does not is refused with the
+ * reason it is missing, so the message points at the simulator rather than at
+ * the request.
+ */
+export declare function requireSimSnsProtocol(value: string | undefined): SimSnsSubscriptionProtocol;
+//# sourceMappingURL=sim-sns-subscription-protocol.d.ts.map

package/dist/service/sns/subscription/sim-sns-subscription-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-protocol.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-protocol.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,0BAA0B,GACpC,OAAO,iBAAiB,GAAG,OAAO,oBAAoB,CAAC;AAuBzD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,0BAA0B,CAoB5B"}

package/dist/service/sns/subscription/sim-sns-subscription-protocol.js

@@ -0,0 +1,63 @@
+import { SimSnsInvalidParameterException, SimSnsUnsimulatedInputException, } from "../error/sim-sns.error.js";
+/**
+ * Delivery to an SQS queue.
+ *
+ * A queue is what SNS is most often put in front of, and it is a protocol with
+ * no confirmation step: real SNS confirms an `sqs` subscription itself, so
+ * `Subscribe` answers with a subscription ARN rather than `pending
+ * confirmation`.
+ */
+export const simSnsSqsProtocol = "sqs";
+/**
+ * Delivery by invoking a Lambda function.
+ *
+ * Real SNS confirms this one itself too, so a `lambda` subscription is
+ * confirmed as soon as it exists. The function is invoked asynchronously with
+ * an event carrying the published message.
+ */
+export const simSnsLambdaProtocol = "lambda";
+/**
+ * The protocols real SNS has that this simulation does not deliver over.
+ *
+ * Each is refused by name with the reason, rather than accepted and never
+ * delivered to. A subscription that exists and receives nothing is worse than
+ * no subscription at all: the test that made it would be asserting against
+ * silence.
+ */
+const unsimulatedProtocols = new Map([
+    ["http", "Delivery over HTTP would leave the simulation."],
+    ["https", "Delivery over HTTPS would leave the simulation."],
+    ["email", "Sending email is not simulated."],
+    ["email-json", "Sending email is not simulated."],
+    ["sms", "Sending SMS is not simulated."],
+    [
+        "application",
+        "Mobile application endpoints and push notifications are not simulated.",
+    ],
+    ["firehose", "Amazon Data Firehose is not simulated."],
+]);
+/**
+ * Read the protocol a Subscribe request names, refusing one that delivers
+ * nowhere.
+ *
+ * Real SNS refuses a protocol it does not have with
+ * `InvalidParameterException`, and that is what a misspelling gets here. A
+ * protocol real SNS does have and this simulation does not is refused with the
+ * reason it is missing, so the message points at the simulator rather than at
+ * the request.
+ */
+export function requireSimSnsProtocol(value) {
+    if (value === simSnsSqsProtocol || value === simSnsLambdaProtocol) {
+        return value;
+    }
+    const named = value ?? "(none)";
+    const reason = unsimulatedProtocols.get(named);
+    if (reason !== undefined) {
+        throw new SimSnsUnsimulatedInputException(`The ${named} subscription protocol is not simulated. ${reason} ` +
+            `Subscribe with the ${simSnsSqsProtocol} or ` +
+            `${simSnsLambdaProtocol} protocol instead.`);
+    }
+    throw new SimSnsInvalidParameterException(`Invalid parameter: Protocol Reason: ${named} is not a subscription ` +
+        `protocol`);
+}
+//# sourceMappingURL=sim-sns-subscription-protocol.js.map

package/dist/service/sns/subscription/sim-sns-subscription-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-protocol.js","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAQ7C;;;;;;;GAOG;AACH,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAiB;IACnD,CAAC,MAAM,EAAE,gDAAgD,CAAC;IAC1D,CAAC,OAAO,EAAE,iDAAiD,CAAC;IAC5D,CAAC,OAAO,EAAE,iCAAiC,CAAC;IAC5C,CAAC,YAAY,EAAE,iCAAiC,CAAC;IACjD,CAAC,KAAK,EAAE,+BAA+B,CAAC;IACxC;QACE,aAAa;QACb,wEAAwE;KACzE;IACD,CAAC,UAAU,EAAE,wCAAwC,CAAC;CACvD,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAyB;IAEzB,IAAI,KAAK,KAAK,iBAAiB,IAAI,KAAK,KAAK,oBAAoB,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,IAAI,QAAQ,CAAC;IAChC,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAE/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,+BAA+B,CACvC,OAAO,KAAK,4CAA4C,MAAM,GAAG;YAC/D,sBAAsB,iBAAiB,MAAM;YAC7C,GAAG,oBAAoB,oBAAoB,CAC9C,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,+BAA+B,CACvC,uCAAuC,KAAK,yBAAyB;QACnE,UAAU,CACb,CAAC;AACJ,CAAC"}

package/dist/service/sns/subscription/sim-sns-subscription-store.d.ts

@@ -0,0 +1,71 @@
+import type { SimSnsSubscription } from "./sim-sns-subscription.js";
+/**
+ * The subscription counts one topic reports.
+ *
+ * Real SNS reports all three on every topic, so they are answered together
+ * rather than one call at a time.
+ */
+export interface SimSnsSubscriptionCounts {
+    readonly confirmed: number;
+    readonly pending: number;
+    readonly deleted: number;
+}
+/**
+ * The subscriptions of one simulated SNS scope.
+ *
+ * They are held here rather than on the topic because a subscription outlives
+ * the lookup that finds it by ARN: `Unsubscribe` carries a subscription ARN and
+ * nothing else, so the subscription has to be reachable without knowing which
+ * topic it belongs to first.
+ */
+export declare class SimSnsSubscriptionStore {
+    private readonly subscriptions;
+    /**
+     * How many subscriptions each topic has had deleted, by topic name.
+     *
+     * Real SNS reports a running count as `SubscriptionsDeleted` rather than
+     * forgetting a subscription entirely, so the count is kept after the
+     * subscription itself is gone.
+     */
+    private readonly deletedCounts;
+    /**
+     * Every subscription in this scope, in creation order.
+     */
+    get all(): readonly SimSnsSubscription[];
+    /**
+     * Store a newly created subscription.
+     */
+    add(subscription: SimSnsSubscription): void;
+    /**
+     * Find a subscription by ARN.
+     */
+    find(arn: string): SimSnsSubscription | undefined;
+    /**
+     * Resolve a subscription by ARN, or refuse.
+     */
+    require(arn: string): SimSnsSubscription;
+    /**
+     * The subscriptions of one topic, in creation order.
+     */
+    forTopic(topicName: string): readonly SimSnsSubscription[];
+    /**
+     * The counts a topic reports about its subscriptions.
+     *
+     * Nothing is ever pending, because the only protocol simulated is the one
+     * real SNS confirms itself.
+     */
+    countsForTopic(topicName: string): SimSnsSubscriptionCounts;
+    /**
+     * Forget one unsubscribed subscription.
+     */
+    remove(subscription: SimSnsSubscription): void;
+    /**
+     * Forget every subscription of a deleted topic.
+     *
+     * Real SNS deletes a topic's subscriptions along with it, so a topic
+     * recreated under the same name starts with none. The deleted count goes with
+     * them for the same reason: it belonged to the topic that is gone.
+     */
+    removeForTopic(topicName: string): void;
+}
+//# sourceMappingURL=sim-sns-subscription-store.d.ts.map

package/dist/service/sns/subscription/sim-sns-subscription-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-store.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IAEvE;;;;;;OAMG;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAE3D;;OAEG;IACH,IAAI,GAAG,IAAI,SAAS,kBAAkB,EAAE,CAEvC;IAED;;OAEG;IACH,GAAG,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAE1C;IAED;;OAEG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAUvC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,kBAAkB,EAAE,CAIzD;IAED;;;;;OAKG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,wBAAwB,CAM1D;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI,CAM7C;IAED;;;;;;OAMG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAMtC;CACF"}

package/dist/service/sns/subscription/sim-sns-subscription-store.js

@@ -0,0 +1,88 @@
+import { SimSnsNotFoundException } from "../error/sim-sns.error.js";
+/**
+ * The subscriptions of one simulated SNS scope.
+ *
+ * They are held here rather than on the topic because a subscription outlives
+ * the lookup that finds it by ARN: `Unsubscribe` carries a subscription ARN and
+ * nothing else, so the subscription has to be reachable without knowing which
+ * topic it belongs to first.
+ */
+export class SimSnsSubscriptionStore {
+    subscriptions = new Map();
+    /**
+     * How many subscriptions each topic has had deleted, by topic name.
+     *
+     * Real SNS reports a running count as `SubscriptionsDeleted` rather than
+     * forgetting a subscription entirely, so the count is kept after the
+     * subscription itself is gone.
+     */
+    deletedCounts = new Map();
+    /**
+     * Every subscription in this scope, in creation order.
+     */
+    get all() {
+        return this.subscriptions.values().toArray();
+    }
+    /**
+     * Store a newly created subscription.
+     */
+    add(subscription) {
+        this.subscriptions.set(subscription.arn.value, subscription);
+    }
+    /**
+     * Find a subscription by ARN.
+     */
+    find(arn) {
+        return this.subscriptions.get(arn);
+    }
+    /**
+     * Resolve a subscription by ARN, or refuse.
+     */
+    require(arn) {
+        const found = this.find(arn);
+        if (found === undefined) {
+            throw new SimSnsNotFoundException(`Subscription does not exist: no subscription with the ARN ${arn}`);
+        }
+        return found;
+    }
+    /**
+     * The subscriptions of one topic, in creation order.
+     */
+    forTopic(topicName) {
+        return this.all.filter((subscription) => subscription.topicName === topicName);
+    }
+    /**
+     * The counts a topic reports about its subscriptions.
+     *
+     * Nothing is ever pending, because the only protocol simulated is the one
+     * real SNS confirms itself.
+     */
+    countsForTopic(topicName) {
+        return {
+            confirmed: this.forTopic(topicName).length,
+            pending: 0,
+            deleted: this.deletedCounts.get(topicName) ?? 0,
+        };
+    }
+    /**
+     * Forget one unsubscribed subscription.
+     */
+    remove(subscription) {
+        this.subscriptions.delete(subscription.arn.value);
+        this.deletedCounts.set(subscription.topicName, (this.deletedCounts.get(subscription.topicName) ?? 0) + 1);
+    }
+    /**
+     * Forget every subscription of a deleted topic.
+     *
+     * Real SNS deletes a topic's subscriptions along with it, so a topic
+     * recreated under the same name starts with none. The deleted count goes with
+     * them for the same reason: it belonged to the topic that is gone.
+     */
+    removeForTopic(topicName) {
+        for (const subscription of this.forTopic(topicName)) {
+            this.subscriptions.delete(subscription.arn.value);
+        }
+        this.deletedCounts.delete(topicName);
+    }
+}
+//# sourceMappingURL=sim-sns-subscription-store.js.map

package/dist/service/sns/subscription/sim-sns-subscription-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-store.js","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAepE;;;;;;;GAOG;AACH,MAAM,OAAO,uBAAuB;IACjB,aAAa,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEvE;;;;;;OAMG;IACc,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE3D;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,YAAgC;QAClC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,GAAW;QACd,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,GAAW;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,uBAAuB,CAC/B,6DAA6D,GAAG,EAAE,CACnE,CAAC;QACJ,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,SAAiB;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CACpB,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,SAAS,KAAK,SAAS,CACvD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,SAAiB;QAC9B,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM;YAC1C,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;SAChD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAgC;QACrC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa,CAAC,GAAG,CACpB,YAAY,CAAC,SAAS,EACtB,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAC1D,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,SAAiB;QAC9B,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACpD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;CACF"}

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

@@ -0,0 +1,72 @@
+import type { SimSnsPublishedMessage } from "../message/sim-sns-published-message.js";
+import { SimSnsSubscriptionArn } from "./sim-sns-subscription-arn.js";
+import type { SimSnsSubscriptionAttributeInput, SimSnsSubscriptionAttributes } from "./sim-sns-subscription-attributes.js";
+import { type SimSnsSubscriptionEndpoint } from "./sim-sns-subscription-endpoint.js";
+import type { SimSnsSubscriptionProtocol } from "./sim-sns-subscription-protocol.js";
+interface SimSnsSubscriptionInput {
+    readonly topicArn: string;
+    readonly topicName: string;
+    readonly protocol: SimSnsSubscriptionProtocol;
+    readonly endpoint: string | undefined;
+    readonly owner: string;
+    readonly attributes: SimSnsSubscriptionAttributes;
+}
+/**
+ * One simulated subscription to a topic.
+ *
+ * The endpoint is held as the ARN its protocol implies rather than as a string,
+ * because a delivery has to reach the Account and Region that ARN names rather
+ * than the topic's, and because what the ARN has to name is a question the
+ * protocol answers: a queue for `sqs`, a function for `lambda`.
+ */
+export declare class SimSnsSubscription {
+    readonly arn: SimSnsSubscriptionArn;
+    readonly topicArn: string;
+    readonly topicName: string;
+    readonly protocol: SimSnsSubscriptionProtocol;
+    readonly endpoint: SimSnsSubscriptionEndpoint;
+    readonly owner: string;
+    private held;
+    private constructor();
+    /**
+     * Create a subscription, refusing an endpoint the protocol cannot reach.
+     *
+     * Nothing checks that the endpoint exists, because real SNS does not either:
+     * a subscription to a queue or a function that is not there is created, and
+     * fails when something is delivered to it. That is the moment the endpoint's
+     * own policy is consulted too, so both failures surface in the same place,
+     * and a permission taken away after subscribing stops delivery.
+     */
+    static of(input: SimSnsSubscriptionInput): SimSnsSubscription;
+    /**
+     * Whether another subscription would be a repeat of this one.
+     *
+     * Real SNS matches a repeated Subscribe on the topic, the protocol and the
+     * endpoint. Both subscriptions belong to a topic already by the time this is
+     * asked, so it is the other two that are compared here.
+     */
+    repeats(other: SimSnsSubscription): boolean;
+    /**
+     * The attributes this subscription currently holds.
+     */
+    get attributes(): SimSnsSubscriptionAttributes;
+    /**
+     * Apply the attributes a request names, refusing any this simulation will not
+     * take.
+     */
+    applyAttributes(requested: SimSnsSubscriptionAttributeInput): void;
+    /**
+     * Whether this subscription wants a published message.
+     *
+     * The subscription's filter policy is what decides, so this is asked once per
+     * subscription rather than once per publish: one subscriber filtering a
+     * message out has nothing to do with what another receives.
+     */
+    accepts(message: SimSnsPublishedMessage): boolean;
+    /**
+     * This subscription as GetSubscriptionAttributes reports it.
+     */
+    reportedAttributes(): Record<string, string>;
+}
+export {};
+//# sourceMappingURL=sim-sns-subscription.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EACV,gCAAgC,EAChC,4BAA4B,EAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAEL,KAAK,0BAA0B,EAChC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAmCrF,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,0BAA0B,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,qBAAa,kBAAkB;IAC7B,SAAgB,GAAG,EAAE,qBAAqB,CAAC;IAC3C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,QAAQ,EAAE,0BAA0B,CAAC;IACrD,SAAgB,QAAQ,EAAE,0BAA0B,CAAC;IACrD,SAAgB,KAAK,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,IAAI,CAA+B;IAE3C,OAAO,eAQN;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAe5D;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAK1C;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,4BAA4B,CAE7C;IAED;;;OAGG;IACH,eAAe,CAAC,SAAS,EAAE,gCAAgC,GAAG,IAAI,CAEjE;IAED;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAEhD;IAED;;OAEG;IACH,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa3C;CACF"}

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

@@ -0,0 +1,116 @@
+import { SimSnsSubscriptionArn } from "./sim-sns-subscription-arn.js";
+import { requireSimSnsSubscriptionEndpoint, } from "./sim-sns-subscription-endpoint.js";
+const subscriptionArnAttributeName = "SubscriptionArn";
+const topicArnAttributeName = "TopicArn";
+const protocolAttributeName = "Protocol";
+const endpointAttributeName = "Endpoint";
+const ownerAttributeName = "Owner";
+/**
+ * The two attributes describing a confirmation that never had to happen.
+ *
+ * Real SNS confirms an `sqs` or a `lambda` subscription itself, so one created
+ * through the API is confirmed as soon as it exists and the confirmation counts
+ * as authenticated. Both are reported as constants because there is no protocol
+ * here that leaves a subscription pending.
+ */
+const confirmationAttributes = [
+    ["ConfirmationWasAuthenticated", "true"],
+    ["PendingConfirmation", "false"],
+];
+/**
+ * One simulated subscription to a topic.
+ *
+ * The endpoint is held as the ARN its protocol implies rather than as a string,
+ * because a delivery has to reach the Account and Region that ARN names rather
+ * than the topic's, and because what the ARN has to name is a question the
+ * protocol answers: a queue for `sqs`, a function for `lambda`.
+ */
+export class SimSnsSubscription {
+    arn;
+    topicArn;
+    topicName;
+    protocol;
+    endpoint;
+    owner;
+    held;
+    constructor(properties) {
+        this.arn = properties.arn;
+        this.topicArn = properties.topicArn;
+        this.topicName = properties.topicName;
+        this.protocol = properties.protocol;
+        this.endpoint = properties.endpoint;
+        this.owner = properties.owner;
+        this.held = properties.attributes;
+    }
+    /**
+     * Create a subscription, refusing an endpoint the protocol cannot reach.
+     *
+     * Nothing checks that the endpoint exists, because real SNS does not either:
+     * a subscription to a queue or a function that is not there is created, and
+     * fails when something is delivered to it. That is the moment the endpoint's
+     * own policy is consulted too, so both failures surface in the same place,
+     * and a permission taken away after subscribing stops delivery.
+     */
+    static of(input) {
+        const arn = SimSnsSubscriptionArn.forTopic(input.topicArn);
+        return new this({
+            arn,
+            topicArn: input.topicArn,
+            topicName: input.topicName,
+            protocol: input.protocol,
+            endpoint: requireSimSnsSubscriptionEndpoint(input.protocol, input.endpoint),
+            owner: input.owner,
+            attributes: input.attributes,
+        });
+    }
+    /**
+     * Whether another subscription would be a repeat of this one.
+     *
+     * Real SNS matches a repeated Subscribe on the topic, the protocol and the
+     * endpoint. Both subscriptions belong to a topic already by the time this is
+     * asked, so it is the other two that are compared here.
+     */
+    repeats(other) {
+        return (this.protocol === other.protocol &&
+            this.endpoint.value === other.endpoint.value);
+    }
+    /**
+     * The attributes this subscription currently holds.
+     */
+    get attributes() {
+        return this.held;
+    }
+    /**
+     * Apply the attributes a request names, refusing any this simulation will not
+     * take.
+     */
+    applyAttributes(requested) {
+        this.held = this.held.with(requested);
+    }
+    /**
+     * Whether this subscription wants a published message.
+     *
+     * The subscription's filter policy is what decides, so this is asked once per
+     * subscription rather than once per publish: one subscriber filtering a
+     * message out has nothing to do with what another receives.
+     */
+    accepts(message) {
+        return this.held.accepts(message);
+    }
+    /**
+     * This subscription as GetSubscriptionAttributes reports it.
+     */
+    reportedAttributes() {
+        const reported = new Map([
+            [subscriptionArnAttributeName, this.arn.value],
+            [topicArnAttributeName, this.topicArn],
+            [protocolAttributeName, this.protocol],
+            [endpointAttributeName, this.endpoint.value],
+            [ownerAttributeName, this.owner],
+            ...confirmationAttributes,
+        ]);
+        this.held.reportInto(reported);
+        return Object.fromEntries(reported);
+    }
+}
+//# sourceMappingURL=sim-sns-subscription.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription.js","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAKtE,OAAO,EACL,iCAAiC,GAElC,MAAM,oCAAoC,CAAC;AAG5C,MAAM,4BAA4B,GAAG,iBAAiB,CAAC;AAEvD,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEzC,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEzC,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEzC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,sBAAsB,GAA2C;IACrE,CAAC,8BAA8B,EAAE,MAAM,CAAC;IACxC,CAAC,qBAAqB,EAAE,OAAO,CAAC;CACjC,CAAC;AAqBF;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAkB;IACb,GAAG,CAAwB;IAC3B,QAAQ,CAAS;IACjB,SAAS,CAAS;IAClB,QAAQ,CAA6B;IACrC,QAAQ,CAA6B;IACrC,KAAK,CAAS;IAEtB,IAAI,CAA+B;IAE3C,YAAoB,UAAwC;QAC1D,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,UAAU,CAAC;IACpC,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,CAAC,KAA8B;QACtC,MAAM,GAAG,GAAG,qBAAqB,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAE3D,OAAO,IAAI,IAAI,CAAC;YACd,GAAG;YACH,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,iCAAiC,CACzC,KAAK,CAAC,QAAQ,EACd,KAAK,CAAC,QAAQ,CACf;YACD,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,UAAU,EAAE,KAAK,CAAC,UAAU;SAC7B,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAyB;QAC/B,OAAO,CACL,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ;YAChC,IAAI,CAAC,QAAQ,CAAC,KAAK,KAAK,KAAK,CAAC,QAAQ,CAAC,KAAK,CAC7C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,SAA2C;QACzD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,OAA+B;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAiB;YACvC,CAAC,4BAA4B,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAC9C,CAAC,qBAAqB,EAAE,IAAI,CAAC,QAAQ,CAAC;YACtC,CAAC,qBAAqB,EAAE,IAAI,CAAC,QAAQ,CAAC;YACtC,CAAC,qBAAqB,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC5C,CAAC,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC;YAChC,GAAG,sBAAsB;SAC1B,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAE/B,OAAO,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/service/sns/topic/sim-sns-topic-arn.d.ts

@@ -0,0 +1,52 @@
+import type { SimAwsAccountRegionScope } from "../../aws/sim-aws-account-region-scope.js";
+import type { SimSnsTopicName } from "./sim-sns-topic-name.js";
+/**
+ * The part of a topic ARN that comes before the topic's own name.
+ *
+ * A topic ARN has no resource type separator, so the name follows the account
+ * id directly. That is why `parseSimArn` cannot read one, and why an IAM policy
+ * resource for a topic is `arn:aws:sns:region:account:name` rather than
+ * anything with a `topic/` in it.
+ */
+export declare function snsTopicArnPrefix(accountRegionScope: SimAwsAccountRegionScope): string;
+/**
+ * Where one topic is, in the three facts its ARN carries.
+ *
+ * The strings are unbranded because the callers that have only read an ARN,
+ * rather than been handed a scope, have nothing but strings to offer.
+ */
+export interface SimSnsTopicLocation {
+    readonly regionName: string;
+    readonly accountId: string;
+    readonly name: string;
+}
+/**
+ * Read a topic ARN into the Region, Account and name it carries.
+ *
+ * All three matter. An ARN naming another Account or Region reaches nothing in
+ * a simulated SNS scope rather than having its name read out and looked up
+ * locally, and treating a foreign one as local would let a test pass while the
+ * real call crossed a boundary it has no permission for.
+ *
+ * Nothing is returned for a string that is not a topic ARN, including a
+ * subscription ARN, which carries the subscription id as a seventh part.
+ */
+export declare function parseSnsTopicArn(value: string): SimSnsTopicLocation | undefined;
+interface SimSnsTopicArnProperties {
+    readonly name: SimSnsTopicName;
+    readonly accountRegionScope: SimAwsAccountRegionScope;
+}
+/**
+ * The ARN of one simulated topic.
+ *
+ * SNS requests name a topic by ARN rather than by a URL of its own, so this is
+ * the only identifier a caller passes around, and it is what IAM authorizes
+ * against.
+ */
+export declare class SimSnsTopicArn {
+    readonly name: string;
+    readonly value: string;
+    constructor(properties: SimSnsTopicArnProperties);
+}
+export {};
+//# sourceMappingURL=sim-sns-topic-arn.d.ts.map