@message-queue-toolkit/sns 24.5.0 → 24.6.1

package/README.md

@@ -1,6 +1,8 @@
 # @message-queue-toolkit/sns
 
-AWS SNS (Simple Notification Service) implementation for the message-queue-toolkit. Provides a robust, type-safe abstraction for publishing messages to SNS topics and consuming them via SQS queue subscriptions, with support for both standard and FIFO topics.
+AWS SNS (Simple Notification Service) implementation for the message-queue-toolkit. Provides a robust, type-safe 
+abstraction for publishing messages to SNS topics and consuming them via SQS queue subscriptions, with support for both 
+standard and FIFO topics.
 
 ## Table of Contents
 

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export type { SNSSQSConsumerDependencies, SNSSQSConsumerOptions, SNSSQSCreationC
 export { AbstractSnsSqsConsumer } from './sns/AbstractSnsSqsConsumer.ts';
 export * from './sns/CommonSnsPublisherFactory.ts';
 export { FakeConsumer } from './sns/fakes/FakeConsumer.ts';
+export { TestSnsPublisher, type TestSnsPublishOptions } from './sns/fakes/TestSnsPublisher.ts';
 export * from './sns/SnsPublisherManager.ts';
 export type { CommonMessage } from './types/MessageTypes.ts';
 export { generateFilterAttributes, generateTopicSubscriptionPolicy, } from './utils/snsAttributeUtils.ts';

package/dist/index.js

@@ -4,6 +4,7 @@ export { AbstractSnsService, SNS_MESSAGE_MAX_SIZE } from "./sns/AbstractSnsServi
 export { AbstractSnsSqsConsumer } from "./sns/AbstractSnsSqsConsumer.js";
 export * from "./sns/CommonSnsPublisherFactory.js";
 export { FakeConsumer } from "./sns/fakes/FakeConsumer.js";
+export { TestSnsPublisher } from "./sns/fakes/TestSnsPublisher.js";
 export * from "./sns/SnsPublisherManager.js";
 export { generateFilterAttributes, generateTopicSubscriptionPolicy, } from "./utils/snsAttributeUtils.js";
 export { initSns, initSnsSqs, } from "./utils/snsInitter.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAA;AAE/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAQpE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAQtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AACxE,cAAc,oCAAoC,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,cAAc,8BAA8B,CAAA;AAE5C,OAAO,EACL,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAGL,OAAO,EACP,UAAU,GACX,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EACL,WAAW,EACX,4BAA4B,EAC5B,kBAAkB,EAClB,WAAW,EACX,+BAA+B,EAC/B,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAA;AAE/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAA;AAQpE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAQtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAA;AACxE,cAAc,oCAAoC,CAAA;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAA8B,MAAM,iCAAiC,CAAA;AAC9F,cAAc,8BAA8B,CAAA;AAE5C,OAAO,EACL,wBAAwB,EACxB,+BAA+B,GAChC,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAGL,OAAO,EACP,UAAU,GACX,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EACL,WAAW,EACX,4BAA4B,EAC5B,kBAAkB,EAClB,WAAW,EACX,+BAA+B,EAC/B,yBAAyB,EACzB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/sns/AbstractSnsService.d.ts

@@ -3,6 +3,8 @@ import type { STSClient } from '@aws-sdk/client-sts';
 import type { BaseQueueLocatorType, QueueDependencies, QueueOptions } from '@message-queue-toolkit/core';
 import { AbstractQueueService } from '@message-queue-toolkit/core';
 import type { SNS_MESSAGE_BODY_TYPE } from '../types/MessageTypes.ts';
+export declare const SNS_MESSAGE_HARD_LIMIT: number;
+export declare const SNS_MESSAGE_ATTRIBUTE_BUFFER: number;
 export declare const SNS_MESSAGE_MAX_SIZE: number;
 export type SNSDependencies = QueueDependencies & {
     snsClient: SNSClient;

package/dist/sns/AbstractSnsService.js

@@ -1,7 +1,9 @@
 import { AbstractQueueService } from '@message-queue-toolkit/core';
 import { deleteSns, initSns } from "../utils/snsInitter.js";
 // https://docs.aws.amazon.com/general/latest/gr/sns.html
-export const SNS_MESSAGE_MAX_SIZE = 256 * 1024; // 256KB
+export const SNS_MESSAGE_HARD_LIMIT = 256 * 1024; // 256KB - AWS SNS total message size limit (body + attributes)
+export const SNS_MESSAGE_ATTRIBUTE_BUFFER = 30 * 1024; // 30KB - reserved space for message attributes and overhead
+export const SNS_MESSAGE_MAX_SIZE = SNS_MESSAGE_HARD_LIMIT - SNS_MESSAGE_ATTRIBUTE_BUFFER; // 226KB - maximum allowed message body size
 export class AbstractSnsService extends AbstractQueueService {
     snsClient;
     stsClient;

package/dist/sns/AbstractSnsService.js.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractSnsService.js","sourceRoot":"","sources":["../../lib/sns/AbstractSnsService.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAElE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAE3D,yDAAyD;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,GAAG,IAAI,CAAA,CAAC,QAAQ;AAyCvD,MAAM,OAAgB,kBAKpB,SAAQ,oBAOT;IACoB,SAAS,CAAW;IACpB,SAAS,CAAW;IACvC,mBAAmB;IACT,QAAQ,CAAQ;IAE1B,YAAY,YAA8B,EAAE,OAAuB;QACjE,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAE5B,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS,CAAA;QACvC,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS,CAAA;IACzC,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/C,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;QAC3F,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,OAAO,CAC9B,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,cAAc,EACnB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACxB,CAAA;QACD,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAA;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;IACvB,CAAC;IAEe,KAAK;QACnB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;QACtB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;CACF"}
+{"version":3,"file":"AbstractSnsService.js","sourceRoot":"","sources":["../../lib/sns/AbstractSnsService.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAElE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAE3D,yDAAyD;AACzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,GAAG,IAAI,CAAA,CAAC,+DAA+D;AAChH,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,GAAG,IAAI,CAAA,CAAC,4DAA4D;AAClH,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,GAAG,4BAA4B,CAAA,CAAC,4CAA4C;AAyCtI,MAAM,OAAgB,kBAKpB,SAAQ,oBAOT;IACoB,SAAS,CAAW;IACpB,SAAS,CAAW;IACvC,mBAAmB;IACT,QAAQ,CAAQ;IAE1B,YAAY,YAA8B,EAAE,OAAuB;QACjE,KAAK,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QAE5B,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS,CAAA;QACvC,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,SAAS,CAAA;IACzC,CAAC;IAEM,KAAK,CAAC,IAAI;QACf,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YAC/C,MAAM,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;QAC3F,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,OAAO,CAC9B,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,cAAc,EACnB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACxB,CAAA;QACD,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAA;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAA;IACvB,CAAC;IAEe,KAAK;QACnB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;QACtB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC;CACF"}

package/dist/sns/fakes/TestSnsPublisher.d.ts

@@ -0,0 +1,105 @@
+import type { SNSClient } from '@aws-sdk/client-sns';
+import type { STSClient } from '@aws-sdk/client-sts';
+import type { AbstractSnsPublisher } from '../AbstractSnsPublisher.ts';
+import type { AbstractSnsSqsConsumer } from '../AbstractSnsSqsConsumer.ts';
+/**
+ * Options for publishing messages with TestSnsPublisher.
+ * Supports multiple mutually exclusive ways to specify the target topic.
+ */
+export type TestSnsPublishOptions = {
+    topicArn: string;
+    topicName?: never;
+    consumer?: never;
+    publisher?: never;
+    MessageGroupId?: string;
+    MessageDeduplicationId?: string;
+} | {
+    topicName: string;
+    topicArn?: never;
+    consumer?: never;
+    publisher?: never;
+    MessageGroupId?: string;
+    MessageDeduplicationId?: string;
+} | {
+    consumer: AbstractSnsSqsConsumer<any, any, any>;
+    topicArn?: never;
+    topicName?: never;
+    publisher?: never;
+    MessageGroupId?: string;
+    MessageDeduplicationId?: string;
+} | {
+    publisher: AbstractSnsPublisher<any>;
+    topicArn?: never;
+    topicName?: never;
+    consumer?: never;
+    MessageGroupId?: string;
+    MessageDeduplicationId?: string;
+};
+/**
+ * TestSnsPublisher - A testing utility for publishing arbitrary messages to SNS topics without validation.
+ *
+ * This publisher bypasses all message validation, schema checking, deduplication, and payload offloading
+ * to enable testing edge cases, invalid messages, and integration scenarios.
+ *
+ * **IMPORTANT: This is a testing utility only. Do not use in production code.**
+ *
+ * Features:
+ * - Publish any JSON-serializable payload to any SNS topic
+ * - No Zod schema validation
+ * - No message deduplication
+ * - No payload offloading
+ * - Accept topicArn string or consumer/publisher instance per publish call
+ * - Automatically resolve topicArn from consumer/publisher
+ * - Support FIFO topic options (MessageGroupId, MessageDeduplicationId)
+ *
+ * @example
+ * ```typescript
+ * // Create a single publisher for all topics
+ * const publisher = new TestSnsPublisher(snsClient, stsClient)
+ *
+ * // Publish to different topics
+ * await publisher.publish({ any: 'data' }, { topicArn: 'arn:aws:sns:...' })
+ * await publisher.publish({ test: 'message' }, { topicName: 'my-topic' })
+ * await publisher.publish({ test: 'message' }, { consumer: myConsumer })
+ * await publisher.publish({ other: 'data' }, { publisher: myPublisher })
+ *
+ * // FIFO topic with options
+ * await publisher.publish(
+ *   { test: 'message' },
+ *   {
+ *     topicArn: 'arn:aws:sns:.../my-topic.fifo',
+ *     MessageGroupId: 'group1',
+ *     MessageDeduplicationId: 'unique-id'
+ *   }
+ * )
+ * ```
+ */
+export declare class TestSnsPublisher {
+    private readonly snsClient;
+    private readonly stsClient;
+    /**
+     * Creates a new TestSnsPublisher instance.
+     *
+     * @param snsClient - AWS SNS client instance
+     * @param stsClient - AWS STS client instance (needed for topic name to ARN resolution)
+     */
+    constructor(snsClient: SNSClient, stsClient: STSClient);
+    /**
+     * Publishes a message to an SNS topic without any validation.
+     *
+     * @param payload - Any JSON-serializable object to publish
+     * @param options - Topic and message options
+     * @param options.topicArn - Direct topic ARN (mutually exclusive with topicName/consumer/publisher)
+     * @param options.topicName - Topic name to resolve to ARN (mutually exclusive with topicArn/consumer/publisher)
+     * @param options.consumer - Consumer instance to extract topic ARN from (mutually exclusive with topicArn/topicName/publisher)
+     * @param options.publisher - Publisher instance to extract topic ARN from (mutually exclusive with topicArn/topicName/consumer)
+     * @param options.MessageGroupId - Required for FIFO topics (topic name ends with .fifo)
+     * @param options.MessageDeduplicationId - Optional deduplication ID for FIFO topics
+     *
+     * @returns Promise that resolves when message is published
+     * @throws {Error} If none of topicArn/topicName/consumer/publisher is provided
+     * @throws {Error} If consumer/publisher has not been initialized (no topicArn available)
+     * @throws {Error} If SNS publish fails
+     */
+    publish(payload: unknown, options: TestSnsPublishOptions): Promise<void>;
+}

package/dist/sns/fakes/TestSnsPublisher.js

@@ -0,0 +1,108 @@
+import { PublishCommand } from '@aws-sdk/client-sns';
+import { buildTopicArn } from "../../utils/stsUtils.js";
+/**
+ * TestSnsPublisher - A testing utility for publishing arbitrary messages to SNS topics without validation.
+ *
+ * This publisher bypasses all message validation, schema checking, deduplication, and payload offloading
+ * to enable testing edge cases, invalid messages, and integration scenarios.
+ *
+ * **IMPORTANT: This is a testing utility only. Do not use in production code.**
+ *
+ * Features:
+ * - Publish any JSON-serializable payload to any SNS topic
+ * - No Zod schema validation
+ * - No message deduplication
+ * - No payload offloading
+ * - Accept topicArn string or consumer/publisher instance per publish call
+ * - Automatically resolve topicArn from consumer/publisher
+ * - Support FIFO topic options (MessageGroupId, MessageDeduplicationId)
+ *
+ * @example
+ * ```typescript
+ * // Create a single publisher for all topics
+ * const publisher = new TestSnsPublisher(snsClient, stsClient)
+ *
+ * // Publish to different topics
+ * await publisher.publish({ any: 'data' }, { topicArn: 'arn:aws:sns:...' })
+ * await publisher.publish({ test: 'message' }, { topicName: 'my-topic' })
+ * await publisher.publish({ test: 'message' }, { consumer: myConsumer })
+ * await publisher.publish({ other: 'data' }, { publisher: myPublisher })
+ *
+ * // FIFO topic with options
+ * await publisher.publish(
+ *   { test: 'message' },
+ *   {
+ *     topicArn: 'arn:aws:sns:.../my-topic.fifo',
+ *     MessageGroupId: 'group1',
+ *     MessageDeduplicationId: 'unique-id'
+ *   }
+ * )
+ * ```
+ */
+export class TestSnsPublisher {
+    snsClient;
+    stsClient;
+    /**
+     * Creates a new TestSnsPublisher instance.
+     *
+     * @param snsClient - AWS SNS client instance
+     * @param stsClient - AWS STS client instance (needed for topic name to ARN resolution)
+     */
+    constructor(snsClient, stsClient) {
+        this.snsClient = snsClient;
+        this.stsClient = stsClient;
+    }
+    /**
+     * Publishes a message to an SNS topic without any validation.
+     *
+     * @param payload - Any JSON-serializable object to publish
+     * @param options - Topic and message options
+     * @param options.topicArn - Direct topic ARN (mutually exclusive with topicName/consumer/publisher)
+     * @param options.topicName - Topic name to resolve to ARN (mutually exclusive with topicArn/consumer/publisher)
+     * @param options.consumer - Consumer instance to extract topic ARN from (mutually exclusive with topicArn/topicName/publisher)
+     * @param options.publisher - Publisher instance to extract topic ARN from (mutually exclusive with topicArn/topicName/consumer)
+     * @param options.MessageGroupId - Required for FIFO topics (topic name ends with .fifo)
+     * @param options.MessageDeduplicationId - Optional deduplication ID for FIFO topics
+     *
+     * @returns Promise that resolves when message is published
+     * @throws {Error} If none of topicArn/topicName/consumer/publisher is provided
+     * @throws {Error} If consumer/publisher has not been initialized (no topicArn available)
+     * @throws {Error} If SNS publish fails
+     */
+    async publish(payload, options) {
+        let topicArn;
+        if (options.topicArn) {
+            topicArn = options.topicArn;
+        }
+        else if (options.topicName) {
+            topicArn = await buildTopicArn(this.stsClient, options.topicName);
+        }
+        else if (options.consumer) {
+            // @ts-expect-error - Accessing protected property for testing purposes
+            const consumerTopicArn = options.consumer.topicArn;
+            if (!consumerTopicArn) {
+                throw new Error('Consumer has not been initialized. Call consumer.init() before passing it to TestSnsPublisher.publish().');
+            }
+            topicArn = consumerTopicArn;
+        }
+        else if (options.publisher) {
+            // @ts-expect-error - Accessing protected property for testing purposes
+            const publisherTopicArn = options.publisher.topicArn;
+            if (!publisherTopicArn) {
+                throw new Error('Publisher has not been initialized. Call publisher.init() or publisher.publish() before passing it to TestSnsPublisher.publish().');
+            }
+            topicArn = publisherTopicArn;
+        }
+        else {
+            throw new Error('Either topicArn, topicName, consumer, or publisher must be provided in options');
+        }
+        const command = new PublishCommand({
+            TopicArn: topicArn,
+            Message: JSON.stringify(payload),
+            MessageGroupId: options.MessageGroupId,
+            MessageDeduplicationId: options.MessageDeduplicationId,
+        });
+        await this.snsClient.send(command);
+    }
+}
+//# sourceMappingURL=TestSnsPublisher.js.map

package/dist/sns/fakes/TestSnsPublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestSnsPublisher.js","sourceRoot":"","sources":["../../../lib/sns/fakes/TestSnsPublisher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGpD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAkDvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,OAAO,gBAAgB;IACV,SAAS,CAAW;IACpB,SAAS,CAAW;IAErC;;;;;OAKG;IACH,YAAY,SAAoB,EAAE,SAAoB;QACpD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;IAC5B,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,OAAO,CAAC,OAAgB,EAAE,OAA8B;QAC5D,IAAI,QAAgB,CAAA;QAEpB,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;QAC7B,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAC7B,QAAQ,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QACnE,CAAC;aAAM,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC5B,uEAAuE;YACvE,MAAM,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,QAA8B,CAAA;YACxE,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,0GAA0G,CAC3G,CAAA;YACH,CAAC;YACD,QAAQ,GAAG,gBAAgB,CAAA;QAC7B,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAC7B,uEAAuE;YACvE,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,QAA8B,CAAA;YAC1E,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,mIAAmI,CACpI,CAAA;YACH,CAAC;YACD,QAAQ,GAAG,iBAAiB,CAAA;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAA;QACH,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC;YACjC,QAAQ,EAAE,QAAQ;YAClB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAChC,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;SACvD,CAAC,CAAA;QAEF,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;CACF"}

package/dist/utils/snsSubscriber.js

@@ -54,9 +54,9 @@ export async function subscribeToTopic(sqsClient, snsClient, stsClient, queueCon
         const errMessage = `Error while creating subscription for queue "${queueConfiguration.QueueName}", topic "${isCreateTopicCommand(topicConfiguration)
             ? topicConfiguration.Name
             : topicConfiguration.topicName}": ${err.message}`;
-        logger.error(errMessage);
         if (subscriptionConfiguration.updateAttributesIfExists &&
             err.message.indexOf('Subscription already exists with different attributes') !== -1) {
+            logger.warn(`${errMessage}. Trying to update subscription`);
             const result = await tryToUpdateSubscription(snsClient, topicArn, queueArn, subscriptionConfiguration);
             if (result) {
                 return {
@@ -68,6 +68,9 @@ export async function subscribeToTopic(sqsClient, snsClient, stsClient, queueCon
             }
             logger.error('Failed to update subscription');
         }
+        else {
+            logger.error(errMessage);
+        }
         throw new InternalError({
             errorCode: 'sns_subscription_creation_failed',
             message: errMessage,

package/dist/utils/snsSubscriber.js.map

@@ -1 +1 @@
-{"version":3,"file":"snsSubscriber.js","sourceRoot":"","sources":["../../lib/utils/snsSubscriber.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"snsSubscriber.js","sourceRoot":"","sources":["../../lib/utils/snsSubscriber.ts"],"names":[],"mappings":"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"}

package/dist/utils/snsUtils.d.ts

@@ -15,8 +15,8 @@ export declare function findSubscriptionByTopicAndQueue(snsClient: SNSClient, to
  * Calculates the size of an outgoing SNS message.
  *
  * SNS imposes a 256 KB limit on the total size of a message, which includes both the message body and any metadata (attributes).
- * This function currently computes the size based solely on the message body, as no attributes are included at this time.
- * For future updates, if message attributes are added, their sizes should also be considered.
+ * This function computes the size based solely on the message body. The reserved buffer for message attributes and overhead
+ * is accounted for in SNS_MESSAGE_ATTRIBUTE_BUFFER, which is subtracted from SNS_MESSAGE_HARD_LIMIT to derive SNS_MESSAGE_MAX_SIZE.
  *
  * Reference: https://docs.aws.amazon.com/sns/latest/dg/sns-message-attributes.html
  *

package/dist/utils/snsUtils.js

@@ -143,8 +143,8 @@ export async function findSubscriptionByTopicAndQueue(snsClient, topicArn, queue
  * Calculates the size of an outgoing SNS message.
  *
  * SNS imposes a 256 KB limit on the total size of a message, which includes both the message body and any metadata (attributes).
- * This function currently computes the size based solely on the message body, as no attributes are included at this time.
- * For future updates, if message attributes are added, their sizes should also be considered.
+ * This function computes the size based solely on the message body. The reserved buffer for message attributes and overhead
+ * is accounted for in SNS_MESSAGE_ATTRIBUTE_BUFFER, which is subtracted from SNS_MESSAGE_HARD_LIMIT to derive SNS_MESSAGE_MAX_SIZE.
  *
  * Reference: https://docs.aws.amazon.com/sns/latest/dg/sns-message-attributes.html
  *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@message-queue-toolkit/sns",
-    "version": "24.5.0",
+    "version": "24.6.1",
     "private": false,
     "license": "MIT",
     "description": "SNS adapter for message-queue-toolkit",
@@ -23,7 +23,7 @@
         "test:coverage": "npm run test -- --coverage",
         "lint": "biome check . && tsc",
         "lint:fix": "biome check --write .",
-        "docker:start": "docker compose up -d localstack redis",
+        "docker:start": "docker compose up -d redis && if [ \"$QUEUE_BACKEND\" = \"localstack\" ]; then docker compose up -d --quiet-pull --wait localstack; fi",
         "docker:stop": "docker compose down",
         "prepublishOnly": "npm run lint && npm run build"
     },
@@ -53,8 +53,9 @@
         "@message-queue-toolkit/sqs": "*",
         "@types/node": "^25.0.2",
         "@vitest/coverage-v8": "^4.0.15",
-        "awilix": "^12.0.5",
+        "awilix": "^13.0.3",
         "awilix-manager": "^6.1.0",
+        "fauxqs": "^2.0.0",
         "ioredis": "^5.7.0",
         "rimraf": "^6.0.1",
         "typescript": "^5.9.3",