@kensio/yulin 1.9.0 → 1.10.1

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

@@ -0,0 +1,43 @@
+/**
+ * Where one subscription is, in the facts its ARN carries.
+ *
+ * The topic ARN is rebuilt from the first six parts rather than held
+ * separately, because a subscription ARN is the only thing an Unsubscribe
+ * request carries and the topic it belongs to has to be found from it.
+ */
+export interface SimSnsSubscriptionLocation {
+    readonly regionName: string;
+    readonly accountId: string;
+    readonly topicName: string;
+    readonly topicArn: string;
+    readonly subscriptionId: string;
+}
+/**
+ * Read a subscription ARN into the topic and subscription id it carries.
+ *
+ * Nothing is returned for a string that is not a subscription ARN, including a
+ * topic ARN, which is the same ARN without the subscription id on the end.
+ */
+export declare function parseSnsSubscriptionArn(value: string): SimSnsSubscriptionLocation | undefined;
+/**
+ * The ARN of one simulated subscription.
+ *
+ * Real SNS gives a subscription an ARN of the topic's with an opaque id on the
+ * end, and that ARN is the only handle a caller has on the subscription:
+ * `Unsubscribe`, `GetSubscriptionAttributes` and `SetSubscriptionAttributes`
+ * all name one by it.
+ */
+export declare class SimSnsSubscriptionArn {
+    readonly value: string;
+    readonly topicArn: string;
+    readonly subscriptionId: string;
+    private constructor();
+    /**
+     * Mint an ARN for a new subscription to a topic.
+     *
+     * Real SNS's subscription ids are opaque, and a UUID is opaque in the same
+     * way while being unique without anything having to keep count.
+     */
+    static forTopic(topicArn: string): SimSnsSubscriptionArn;
+}
+//# sourceMappingURL=sim-sns-subscription-arn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-arn.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-arn.ts"],"names":[],"mappings":"AAWA;;;;;;GAMG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,GACZ,0BAA0B,GAAG,SAAS,CAkCxC;AAED;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAChC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,cAAc,EAAE,MAAM,CAAC;IAEvC,OAAO,eAIN;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAEvD;CACF"}

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

@@ -0,0 +1,70 @@
+import { randomUUID } from "node:crypto";
+/**
+ * The number of colon separated parts in a subscription ARN.
+ *
+ * A subscription ARN is the topic's with the subscription id added on the end,
+ * so it has one more part than a topic ARN. Counting the parts is what tells
+ * the two apart, since neither has a resource type separator.
+ */
+const subscriptionArnParts = 7;
+/**
+ * Read a subscription ARN into the topic and subscription id it carries.
+ *
+ * Nothing is returned for a string that is not a subscription ARN, including a
+ * topic ARN, which is the same ARN without the subscription id on the end.
+ */
+export function parseSnsSubscriptionArn(value) {
+    const parts = value.split(":");
+    if (parts.length !== subscriptionArnParts) {
+        return undefined;
+    }
+    const [prefix, partition, service, regionName, accountId, topicName, id] = parts;
+    if (prefix !== "arn" || partition !== "aws" || service !== "sns") {
+        return undefined;
+    }
+    if (regionName === undefined ||
+        regionName === "" ||
+        accountId === undefined ||
+        accountId === "" ||
+        topicName === undefined ||
+        topicName === "" ||
+        id === undefined ||
+        id === "") {
+        return undefined;
+    }
+    return {
+        regionName,
+        accountId,
+        topicName,
+        topicArn: `arn:aws:sns:${regionName}:${accountId}:${topicName}`,
+        subscriptionId: id,
+    };
+}
+/**
+ * The ARN of one simulated subscription.
+ *
+ * Real SNS gives a subscription an ARN of the topic's with an opaque id on the
+ * end, and that ARN is the only handle a caller has on the subscription:
+ * `Unsubscribe`, `GetSubscriptionAttributes` and `SetSubscriptionAttributes`
+ * all name one by it.
+ */
+export class SimSnsSubscriptionArn {
+    value;
+    topicArn;
+    subscriptionId;
+    constructor(topicArn, subscriptionId) {
+        this.topicArn = topicArn;
+        this.subscriptionId = subscriptionId;
+        this.value = `${topicArn}:${subscriptionId}`;
+    }
+    /**
+     * Mint an ARN for a new subscription to a topic.
+     *
+     * Real SNS's subscription ids are opaque, and a UUID is opaque in the same
+     * way while being unique without anything having to keep count.
+     */
+    static forTopic(topicArn) {
+        return new this(topicArn, randomUUID());
+    }
+}
+//# sourceMappingURL=sim-sns-subscription-arn.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-arn.js","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-arn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAiB/B;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAAa;IAEb,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE/B,IAAI,KAAK,CAAC,MAAM,KAAK,oBAAoB,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC,GACtE,KAAK,CAAC;IAER,IAAI,MAAM,KAAK,KAAK,IAAI,SAAS,KAAK,KAAK,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACjE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IACE,UAAU,KAAK,SAAS;QACxB,UAAU,KAAK,EAAE;QACjB,SAAS,KAAK,SAAS;QACvB,SAAS,KAAK,EAAE;QAChB,SAAS,KAAK,SAAS;QACvB,SAAS,KAAK,EAAE;QAChB,EAAE,KAAK,SAAS;QAChB,EAAE,KAAK,EAAE,EACT,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,UAAU;QACV,SAAS;QACT,SAAS;QACT,QAAQ,EAAE,eAAe,UAAU,IAAI,SAAS,IAAI,SAAS,EAAE;QAC/D,cAAc,EAAE,EAAE;KACnB,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IAChB,KAAK,CAAS;IACd,QAAQ,CAAS;IACjB,cAAc,CAAS;IAEvC,YAAoB,QAAgB,EAAE,cAAsB;QAC1D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,GAAG,QAAQ,IAAI,cAAc,EAAE,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,CAAC,QAAgB;QAC9B,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF"}

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

@@ -0,0 +1,20 @@
+import { SimSnsFilterPolicy } from "../filter/sim-sns-filter-policy.js";
+import { type SimSnsFilterPolicyScope } from "../filter/sim-sns-filter-policy-scope.js";
+import { type SimSnsSubscriptionAttributeInput } from "./sim-sns-requested-subscription-attributes.js";
+/**
+ * What one subscription's settable attributes are set to.
+ */
+export interface SimSnsSubscriptionAttributeValues {
+    readonly rawMessageDelivery: boolean;
+    readonly filterPolicy: SimSnsFilterPolicy | undefined;
+    readonly filterPolicyScope: SimSnsFilterPolicyScope;
+}
+/**
+ * Read a request as the attributes it leaves the subscription with.
+ *
+ * Every attribute the request left out keeps the value it had, and every name
+ * is checked before any value is read, so a request naming one attribute this
+ * simulation will not take changes none of them.
+ */
+export declare function simSnsChangedSubscriptionAttributes(held: SimSnsSubscriptionAttributeValues, requested: SimSnsSubscriptionAttributeInput): SimSnsSubscriptionAttributeValues;
+//# sourceMappingURL=sim-sns-subscription-attribute-changes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-attribute-changes.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-attribute-changes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAEL,KAAK,gCAAgC,EACtC,MAAM,gDAAgD,CAAC;AAOxD;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;CACrD;AA8CD;;;;;;GAMG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,iCAAiC,EACvC,SAAS,EAAE,gCAAgC,GAC1C,iCAAiC,CAWnC"}

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

@@ -0,0 +1,52 @@
+import { SimSnsFilterPolicy } from "../filter/sim-sns-filter-policy.js";
+import { simSnsFilterPolicyScopeOf, } from "../filter/sim-sns-filter-policy-scope.js";
+import { SimSnsRequestedSubscriptionAttributes, } from "./sim-sns-requested-subscription-attributes.js";
+import { simSnsFilterPolicyAttributeName, simSnsFilterPolicyScopeAttributeName, simSnsRawMessageDeliveryAttributeName, } from "./sim-sns-subscription-attribute-names.js";
+/**
+ * The scope the subscription ends up with.
+ *
+ * An empty value is how an attribute is cleared, which puts the subscription
+ * back on the default scope.
+ */
+function changedScope(held, named) {
+    const value = named.value(simSnsFilterPolicyScopeAttributeName);
+    if (value === undefined) {
+        return held.filterPolicyScope;
+    }
+    return simSnsFilterPolicyScopeOf(value);
+}
+/**
+ * The policy the subscription ends up with.
+ *
+ * An empty value takes the policy off the subscription, which puts it back to
+ * receiving everything its topic publishes. A policy already held is read again
+ * when the scope changes, since the scope decides what a policy may say.
+ */
+function changedPolicy(held, named, scope) {
+    const value = named.value(simSnsFilterPolicyAttributeName);
+    if (value === undefined) {
+        return held.filterPolicy?.forScope(scope);
+    }
+    if (value === "") {
+        return undefined;
+    }
+    return SimSnsFilterPolicy.parse(value, scope);
+}
+/**
+ * Read a request as the attributes it leaves the subscription with.
+ *
+ * Every attribute the request left out keeps the value it had, and every name
+ * is checked before any value is read, so a request naming one attribute this
+ * simulation will not take changes none of them.
+ */
+export function simSnsChangedSubscriptionAttributes(held, requested) {
+    const named = new SimSnsRequestedSubscriptionAttributes(requested);
+    const scope = changedScope(held, named);
+    return {
+        rawMessageDelivery: named.booleanValue(simSnsRawMessageDeliveryAttributeName) ??
+            held.rawMessageDelivery,
+        filterPolicy: changedPolicy(held, named, scope),
+        filterPolicyScope: scope,
+    };
+}
+//# sourceMappingURL=sim-sns-subscription-attribute-changes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-attribute-changes.js","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-attribute-changes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAEL,yBAAyB,GAC1B,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,qCAAqC,GAEtC,MAAM,gDAAgD,CAAC;AACxD,OAAO,EACL,+BAA+B,EAC/B,oCAAoC,EACpC,qCAAqC,GACtC,MAAM,2CAA2C,CAAC;AAWnD;;;;;GAKG;AACH,SAAS,YAAY,CACnB,IAAuC,EACvC,KAA4C;IAE5C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAEhE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED,OAAO,yBAAyB,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,SAAS,aAAa,CACpB,IAAuC,EACvC,KAA4C,EAC5C,KAA8B;IAE9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;IAE3D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mCAAmC,CACjD,IAAuC,EACvC,SAA2C;IAE3C,MAAM,KAAK,GAAG,IAAI,qCAAqC,CAAC,SAAS,CAAC,CAAC;IACnE,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAExC,OAAO;QACL,kBAAkB,EAChB,KAAK,CAAC,YAAY,CAAC,qCAAqC,CAAC;YACzD,IAAI,CAAC,kBAAkB;QACzB,YAAY,EAAE,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC;QAC/C,iBAAiB,EAAE,KAAK;KACzB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Whether the subscription receives the published message on its own rather
+ * than wrapped in the SNS envelope.
+ *
+ * This is the subscription attribute a consumer breaks on: code written for the
+ * envelope reads `JSON.parse(body).Message`, and code written for raw delivery
+ * reads `body`.
+ */
+export declare const simSnsRawMessageDeliveryAttributeName = "RawMessageDelivery";
+/**
+ * The JSON document saying which messages the subscription wants.
+ */
+export declare const simSnsFilterPolicyAttributeName = "FilterPolicy";
+/**
+ * What part of a published message the filter policy is matched against.
+ */
+export declare const simSnsFilterPolicyScopeAttributeName = "FilterPolicyScope";
+/**
+ * Refuse a subscription attribute this simulation cannot set.
+ *
+ * An attribute real SNS has and this simulation does not is refused with the
+ * reason. An attribute real SNS does not have at all is refused the way real
+ * SNS refuses it.
+ */
+export declare function assertSimSnsSettableSubscriptionAttribute(name: string): void;
+//# sourceMappingURL=sim-sns-subscription-attribute-names.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-attribute-names.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-attribute-names.ts"],"names":[],"mappings":"AAKA;;;;;;;GAOG;AACH,eAAO,MAAM,qCAAqC,uBAAuB,CAAC;AAE1E;;GAEG;AACH,eAAO,MAAM,+BAA+B,iBAAiB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,oCAAoC,sBAAsB,CAAC;AA+BxE;;;;;;GAMG;AACH,wBAAgB,yCAAyC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAiB5E"}

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

@@ -0,0 +1,64 @@
+import { SimSnsInvalidParameterException, SimSnsUnsimulatedInputException, } from "../error/sim-sns.error.js";
+/**
+ * Whether the subscription receives the published message on its own rather
+ * than wrapped in the SNS envelope.
+ *
+ * This is the subscription attribute a consumer breaks on: code written for the
+ * envelope reads `JSON.parse(body).Message`, and code written for raw delivery
+ * reads `body`.
+ */
+export const simSnsRawMessageDeliveryAttributeName = "RawMessageDelivery";
+/**
+ * The JSON document saying which messages the subscription wants.
+ */
+export const simSnsFilterPolicyAttributeName = "FilterPolicy";
+/**
+ * What part of a published message the filter policy is matched against.
+ */
+export const simSnsFilterPolicyScopeAttributeName = "FilterPolicyScope";
+const settableAttributeNames = new Set([
+    simSnsRawMessageDeliveryAttributeName,
+    simSnsFilterPolicyAttributeName,
+    simSnsFilterPolicyScopeAttributeName,
+]);
+/**
+ * The other attributes real SNS lets a request set on a subscription.
+ *
+ * Each is refused by name with the reason rather than taken and ignored. A
+ * subscription that appeared to accept a `RedrivePolicy` would drop a failed
+ * delivery while a test believed it was keeping it, which is exactly the kind
+ * of pass that means nothing.
+ */
+const unsimulatedAttributeNames = new Map([
+    ["DeliveryPolicy", "Delivery retry policies are not simulated."],
+    [
+        "RedrivePolicy",
+        "Subscription dead-letter queues are not simulated, so a message that " +
+            "could not be delivered goes nowhere.",
+    ],
+    [
+        "SubscriptionRoleArn",
+        "Amazon Data Firehose delivery is not simulated, and that is the only " +
+            "protocol this attribute applies to.",
+    ],
+    ["ReplayPolicy", "Message archiving and replay are not simulated."],
+]);
+/**
+ * Refuse a subscription attribute this simulation cannot set.
+ *
+ * An attribute real SNS has and this simulation does not is refused with the
+ * reason. An attribute real SNS does not have at all is refused the way real
+ * SNS refuses it.
+ */
+export function assertSimSnsSettableSubscriptionAttribute(name) {
+    if (settableAttributeNames.has(name)) {
+        return;
+    }
+    const reason = unsimulatedAttributeNames.get(name);
+    if (reason !== undefined) {
+        throw new SimSnsUnsimulatedInputException(`The subscription attribute ${name} is not simulated. ${reason}`);
+    }
+    throw new SimSnsInvalidParameterException(`Invalid parameter: AttributeName: ${name} is not a subscription ` +
+        `attribute that can be set`);
+}
+//# sourceMappingURL=sim-sns-subscription-attribute-names.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-attribute-names.js","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-attribute-names.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,2BAA2B,CAAC;AAEnC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAG,oBAAoB,CAAC;AAE1E;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,cAAc,CAAC;AAE9D;;GAEG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,mBAAmB,CAAC;AAExE,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,qCAAqC;IACrC,+BAA+B;IAC/B,oCAAoC;CACrC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAiB;IACxD,CAAC,gBAAgB,EAAE,4CAA4C,CAAC;IAChE;QACE,eAAe;QACf,uEAAuE;YACrE,sCAAsC;KACzC;IACD;QACE,qBAAqB;QACrB,uEAAuE;YACrE,qCAAqC;KACxC;IACD,CAAC,cAAc,EAAE,iDAAiD,CAAC;CACpE,CAAC,CAAC;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,yCAAyC,CAAC,IAAY;IACpE,IAAI,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,yBAAyB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEnD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,+BAA+B,CACvC,8BAA8B,IAAI,sBAAsB,MAAM,EAAE,CACjE,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,+BAA+B,CACvC,qCAAqC,IAAI,yBAAyB;QAChE,2BAA2B,CAC9B,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,47 @@
+import type { SimSnsFilterPolicy } from "../filter/sim-sns-filter-policy.js";
+import { type SimSnsFilterPolicyScope } from "../filter/sim-sns-filter-policy-scope.js";
+import type { SimSnsPublishedMessage } from "../message/sim-sns-published-message.js";
+import type { SimSnsSubscriptionAttributeInput } from "./sim-sns-requested-subscription-attributes.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 declare class SimSnsSubscriptionAttributes {
+    readonly rawMessageDelivery: boolean;
+    readonly filterPolicy: SimSnsFilterPolicy | undefined;
+    readonly filterPolicyScope: SimSnsFilterPolicyScope;
+    private constructor();
+    /**
+     * 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(): SimSnsSubscriptionAttributes;
+    /**
+     * These attributes with a request's changes applied.
+     */
+    with(requested: SimSnsSubscriptionAttributeInput): SimSnsSubscriptionAttributes;
+    /**
+     * 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: SimSnsPublishedMessage): boolean;
+    /**
+     * 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: Map<string, string>): void;
+}
+export { type SimSnsSubscriptionAttributeInput } from "./sim-sns-requested-subscription-attributes.js";
+//# sourceMappingURL=sim-sns-subscription-attributes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-sns-subscription-attributes.d.ts","sourceRoot":"","sources":["../../../../src/service/sns/subscription/sim-sns-subscription-attributes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,0CAA0C,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,gDAAgD,CAAC;AAWvG;;;;;;GAMG;AACH,qBAAa,4BAA4B;IACvC,SAAgB,kBAAkB,EAAE,OAAO,CAAC;IAC5C,SAAgB,YAAY,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC7D,SAAgB,iBAAiB,EAAE,uBAAuB,CAAC;IAE3D,OAAO,eAIN;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,IAAI,4BAA4B,CAM9C;IAED;;OAEG;IACH,IAAI,CACF,SAAS,EAAE,gCAAgC,GAC1C,4BAA4B,CAI9B;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAEhD;IAED;;;;;;OAMG;IACH,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAe9C;CACF;AAED,OAAO,EAAE,KAAK,gCAAgC,EAAE,MAAM,gDAAgD,CAAC"}

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