@kensio/yulin 1.9.0 → 1.10.1

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-topic-arn.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/topic/sim-sns-topic-arn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAC1F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAe/D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,kBAAkB,EAAE,wBAAwB,GAC3C,MAAM,CAIR;AAED;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GACZ,mBAAmB,GAAG,SAAS,CA6BjC;AAED,UAAU,wBAAwB;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,kBAAkB,EAAE,wBAAwB,CAAC;CACvD;AAED;;;;;;GAMG;AACH,qBAAa,cAAc;IACzB,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,KAAK,EAAE,MAAM,CAAC;IAE9B,YAAY,UAAU,EAAE,wBAAwB,EAK/C;CACF"}

package/dist/service/sns/topic/sim-sns-topic-arn.js

@@ -0,0 +1,71 @@
+/**
+ * The number of colon separated parts in a topic ARN.
+ *
+ * A topic ARN has no resource type separator, so the name is the sixth and last
+ * part. A subscription ARN has a seventh, which is what keeps one from being
+ * read as a topic ARN with an odd name.
+ */
+const topicArnParts = 6;
+const topicArnPartition = "aws";
+const topicArnService = "sns";
+/**
+ * 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 function snsTopicArnPrefix(accountRegionScope) {
+    const { regionName, accountId } = accountRegionScope;
+    return `arn:aws:sns:${regionName}:${accountId}:`;
+}
+/**
+ * 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 function parseSnsTopicArn(value) {
+    const parts = value.split(":");
+    if (parts.length !== topicArnParts) {
+        return undefined;
+    }
+    const [prefix, partition, service, regionName, accountId, name] = parts;
+    if (prefix !== "arn" ||
+        partition !== topicArnPartition ||
+        service !== topicArnService) {
+        return undefined;
+    }
+    if (regionName === undefined ||
+        regionName === "" ||
+        accountId === undefined ||
+        accountId === "" ||
+        name === undefined ||
+        name === "") {
+        return undefined;
+    }
+    return { regionName, accountId, name };
+}
+/**
+ * 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 class SimSnsTopicArn {
+    name;
+    value;
+    constructor(properties) {
+        const { name, accountRegionScope } = properties;
+        this.name = name.value;
+        this.value = snsTopicArnPrefix(accountRegionScope) + name.value;
+    }
+}
+//# sourceMappingURL=sim-sns-topic-arn.js.map

package/dist/service/sns/topic/sim-sns-topic-arn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-topic-arn.js","sourceRoot":"","sources":["../../../../src/service/sns/topic/sim-sns-topic-arn.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAEhC,MAAM,eAAe,GAAG,KAAK,CAAC;AAE9B;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,kBAA4C;IAE5C,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,kBAAkB,CAAC;IAErD,OAAO,eAAe,UAAU,IAAI,SAAS,GAAG,CAAC;AACnD,CAAC;AAcD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa;IAEb,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE/B,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACnC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAExE,IACE,MAAM,KAAK,KAAK;QAChB,SAAS,KAAK,iBAAiB;QAC/B,OAAO,KAAK,eAAe,EAC3B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IACE,UAAU,KAAK,SAAS;QACxB,UAAU,KAAK,EAAE;QACjB,SAAS,KAAK,SAAS;QACvB,SAAS,KAAK,EAAE;QAChB,IAAI,KAAK,SAAS;QAClB,IAAI,KAAK,EAAE,EACX,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAOD;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACT,IAAI,CAAS;IACb,KAAK,CAAS;IAE9B,YAAY,UAAoC;QAC9C,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,GAAG,UAAU,CAAC;QAEhD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;IAClE,CAAC;CACF"}

package/dist/service/sns/topic/sim-sns-topic-attribute-names.d.ts

@@ -0,0 +1,19 @@
+/**
+ * The topic's display name, which is the only settable attribute with no
+ * behaviour behind it.
+ */
+export declare const simSnsDisplayNameAttributeName = "DisplayName";
+/**
+ * The topic's resource policy, held as an attribute exactly as SNS holds it.
+ */
+export declare const simSnsPolicyAttributeName = "Policy";
+/**
+ * Refuse a topic attribute this simulation cannot set.
+ *
+ * An attribute real SNS has and this simulation does not is refused with the
+ * reason, so a caller finds out what is missing rather than finding a topic
+ * that quietly behaves differently here than on AWS. An attribute real SNS does
+ * not have at all is refused the way real SNS refuses it.
+ */
+export declare function assertSimSnsSettableAttribute(name: string): void;
+//# sourceMappingURL=sim-sns-topic-attribute-names.d.ts.map

package/dist/service/sns/topic/sim-sns-topic-attribute-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-topic-attribute-names.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/topic/sim-sns-topic-attribute-names.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,8BAA8B,gBAAgB,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,yBAAyB,WAAW,CAAC;AA2DlD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAiBhE"}

package/dist/service/sns/topic/sim-sns-topic-attribute-names.js

@@ -0,0 +1,79 @@
+import { SimSnsInvalidParameterException, SimSnsUnsimulatedInputException, } from "../error/sim-sns.error.js";
+/**
+ * The topic's display name, which is the only settable attribute with no
+ * behaviour behind it.
+ */
+export const simSnsDisplayNameAttributeName = "DisplayName";
+/**
+ * The topic's resource policy, held as an attribute exactly as SNS holds it.
+ */
+export const simSnsPolicyAttributeName = "Policy";
+const settableAttributeNames = new Set([
+    simSnsDisplayNameAttributeName,
+    simSnsPolicyAttributeName,
+]);
+/**
+ * The delivery status logging attributes, one set per protocol.
+ *
+ * They are matched as a pattern rather than listed, because there are fifteen
+ * of them and they are all refused for the same reason: delivery status goes to
+ * CloudWatch Logs on real AWS, and nothing here writes to CloudWatch Logs.
+ */
+const deliveryStatusLoggingPattern = /^(?:HTTP|SQS|Lambda|Application|Firehose)(?:Success|Failure)Feedback(?:RoleArn|SampleRate)$/;
+/**
+ * The other attributes real SNS has that this simulation gives no behaviour to.
+ *
+ * Each is refused by name rather than being taken and ignored. A topic that
+ * appeared to accept `KmsMasterKeyId` would look encrypted to the request that
+ * set it and be plain to everything else, and a topic that appeared to accept
+ * `FifoTopic` would be a standard topic a test believed was ordered.
+ */
+const unsimulatedAttributeNames = new Map([
+    ["FifoTopic", "FIFO topics are not simulated. Only standard topics are."],
+    [
+        "FifoThroughputScope",
+        "FIFO topics are not simulated. Only standard topics are.",
+    ],
+    [
+        "ContentBasedDeduplication",
+        "Message deduplication applies to FIFO topics, which are not simulated.",
+    ],
+    ["KmsMasterKeyId", "Server-side encryption is not simulated."],
+    [
+        "SignatureVersion",
+        "Choosing the message signature algorithm is not simulated.",
+    ],
+    ["TracingConfig", "X-Ray tracing is not simulated."],
+    ["ArchivePolicy", "Message archiving and replay are not simulated."],
+    ["DeliveryPolicy", "Delivery retry policies are not simulated."],
+]);
+/**
+ * The reason an attribute real SNS has is refused here, if it is one of them.
+ */
+function unsimulatedReason(name) {
+    if (deliveryStatusLoggingPattern.test(name)) {
+        return ("Delivery status logging writes to CloudWatch Logs, which is not " +
+            "simulated.");
+    }
+    return unsimulatedAttributeNames.get(name);
+}
+/**
+ * Refuse a topic attribute this simulation cannot set.
+ *
+ * An attribute real SNS has and this simulation does not is refused with the
+ * reason, so a caller finds out what is missing rather than finding a topic
+ * that quietly behaves differently here than on AWS. An attribute real SNS does
+ * not have at all is refused the way real SNS refuses it.
+ */
+export function assertSimSnsSettableAttribute(name) {
+    if (settableAttributeNames.has(name)) {
+        return;
+    }
+    const reason = unsimulatedReason(name);
+    if (reason !== undefined) {
+        throw new SimSnsUnsimulatedInputException(`The topic attribute ${name} is not simulated. ${reason}`);
+    }
+    throw new SimSnsInvalidParameterException(`Invalid parameter: AttributeName: ${name} is not a topic attribute that ` +
+        `can be set`);
+}
+//# sourceMappingURL=sim-sns-topic-attribute-names.js.map

package/dist/service/sns/topic/sim-sns-topic-attribute-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-topic-attribute-names.js","sourceRoot":"","sources":["../../../../src/service/sns/topic/sim-sns-topic-attribute-names.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,aAAa,CAAC;AAE5D;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,QAAQ,CAAC;AAElD,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,8BAA8B;IAC9B,yBAAyB;CAC1B,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,4BAA4B,GAChC,6FAA6F,CAAC;AAEhG;;;;;;;GAOG;AACH,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAiB;IACxD,CAAC,WAAW,EAAE,0DAA0D,CAAC;IACzE;QACE,qBAAqB;QACrB,0DAA0D;KAC3D;IACD;QACE,2BAA2B;QAC3B,wEAAwE;KACzE;IACD,CAAC,gBAAgB,EAAE,0CAA0C,CAAC;IAC9D;QACE,kBAAkB;QAClB,4DAA4D;KAC7D;IACD,CAAC,eAAe,EAAE,iCAAiC,CAAC;IACpD,CAAC,eAAe,EAAE,iDAAiD,CAAC;IACpE,CAAC,gBAAgB,EAAE,4CAA4C,CAAC;CACjE,CAAC,CAAC;AAEH;;GAEG;AACH,SAAS,iBAAiB,CAAC,IAAY;IACrC,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,OAAO,CACL,kEAAkE;YAClE,YAAY,CACb,CAAC;IACJ,CAAC;IAED,OAAO,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,6BAA6B,CAAC,IAAY;IACxD,IAAI,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAEvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,+BAA+B,CACvC,uBAAuB,IAAI,sBAAsB,MAAM,EAAE,CAC1D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,+BAA+B,CACvC,qCAAqC,IAAI,iCAAiC;QACxE,YAAY,CACf,CAAC;AACJ,CAAC"}