@geekmidas/events 1.1.6 → 10.0.0-alpha.0

package/dist/sns/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["connection: SNSConnection","_options: SNSPublisherOptions","connectionString: string","messages: TMessage[]","message: TMessage","PublishCommand","connection: SNSConnection","options: SNSSubscriberOptions","SQSClient","connectionString: string","messages: TMessage['type'][]","listener: (payload: TMessage) => Promise<void>","SQSConnection","SQSSubscriber","UnsubscribeCommand","DeleteQueueCommand","CreateQueueCommand","GetQueueAttributesCommand","SetQueueAttributesCommand","SubscribeCommand"],"sources":["../../src/sns/SNSPublisher.ts","../../src/sns/SNSSubscriber.ts"],"sourcesContent":["import { PublishCommand } from '@aws-sdk/client-sns';\nimport type { EventPublisher, PublishableMessage } from '../types';\nimport type { SNSConnection } from './SNSConnection';\n\nexport type SNSPublisherOptions = {};\n\nexport class SNSPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\tconstructor(\n\t\tprivate connection: SNSConnection,\n\t\t_options: SNSPublisherOptions = {},\n\t) {}\n\n\t/**\n\t * Create an SNSPublisher from a connection string\n\t * Format: sns://?topicArn=arn:aws:sns:region:account:topic&region=us-east-1&endpoint=http://localhost:4566\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SNSPublisher<TMessage>> {\n\t\tconst { SNSConnection } = await import('./SNSConnection');\n\t\tconst connection =\n\t\t\tawait SNSConnection.fromConnectionString(connectionString);\n\n\t\treturn new SNSPublisher<TMessage>(connection);\n\t}\n\n\tasync publish(messages: TMessage[]): Promise<void> {\n\t\tif (messages.length === 0) return;\n\n\t\tif (!this.connection.isConnected()) {\n\t\t\tawait this.connection.connect();\n\t\t}\n\n\t\t// Publish all messages\n\t\tawait Promise.all(messages.map((message) => this.publishMessage(message)));\n\t}\n\n\tprivate async publishMessage(message: TMessage): Promise<void> {\n\t\tconst command = new PublishCommand({\n\t\t\tTopicArn: this.connection.topicArn,\n\t\t\tMessage: JSON.stringify({\n\t\t\t\ttype: message.type,\n\t\t\t\tpayload: message.payload,\n\t\t\t}),\n\t\t\tMessageAttributes: {\n\t\t\t\ttype: {\n\t\t\t\t\tDataType: 'String',\n\t\t\t\t\tStringValue: message.type,\n\t\t\t\t},\n\t\t\t},\n\t\t});\n\n\t\tawait this.connection.snsClient.send(command);\n\t}\n\n\tasync close(): Promise<void> {\n\t\t// Publisher doesn't own the connection\n\t\t// Connection should be closed by whoever created it\n\t}\n}\n","import { SubscribeCommand, UnsubscribeCommand } from '@aws-sdk/client-sns';\nimport {\n\tCreateQueueCommand,\n\tDeleteQueueCommand,\n\tGetQueueAttributesCommand,\n\tSetQueueAttributesCommand,\n\tSQSClient,\n} from '@aws-sdk/client-sqs';\nimport { SQSConnection } from '../sqs/SQSConnection';\nimport { SQSSubscriber } from '../sqs/SQSSubscriber';\nimport type { EventSubscriber, PublishableMessage } from '../types';\nimport type { SNSConnection } from './SNSConnection';\n\nexport interface SNSSubscriberOptions {\n\tqueueName?: string; // Optional queue name (defaults to auto-generated)\n\tcreateQueue?: boolean; // Auto-create SQS queue (default: true)\n\tdeleteQueueOnClose?: boolean; // Delete queue when subscriber closes (default: false for named queues, true for auto-generated)\n\twaitTimeSeconds?: number; // SQS long polling (default: 20)\n\tmaxMessages?: number; // Max messages per poll (default: 10)\n}\n\n/**\n * SNS Subscriber - receives push-based messages from SNS via SQS queue\n *\n * Architecture:\n * SNS Topic → (push) → SQS Queue → Subscriber\n *\n * This subscriber automatically:\n * 1. Creates an SQS queue (or uses existing one)\n * 2. Subscribes the queue to the SNS topic\n * 3. Receives messages pushed from SNS to the queue\n * 4. Filters messages by topic ARN and message type\n * 5. Processes and acknowledges messages\n *\n * Note: While SQS long-polling is used internally to receive messages,\n * this is an implementation detail of the SNS push delivery mechanism.\n * Messages are pushed from SNS to SQS, and we receive those pushed messages.\n */\nexport class SNSSubscriber<TMessage extends PublishableMessage<string, any>>\n\timplements EventSubscriber<TMessage>\n{\n\tprivate sqsClient: SQSClient;\n\tprivate queueUrl?: string;\n\tprivate queueArn?: string;\n\tprivate subscriptionArn?: string;\n\tprivate sqsSubscriber?: SQSSubscriber<TMessage>;\n\tprivate options: Required<SNSSubscriberOptions>;\n\n\tconstructor(\n\t\tprivate connection: SNSConnection,\n\t\toptions: SNSSubscriberOptions = {},\n\t) {\n\t\tthis.options = {\n\t\t\tqueueName:\n\t\t\t\toptions.queueName ||\n\t\t\t\t`sns-sub-${Date.now()}-${Math.random().toString(36).substring(7)}`,\n\t\t\tcreateQueue: options.createQueue ?? true,\n\t\t\tdeleteQueueOnClose: options.deleteQueueOnClose ?? !options.queueName, // Delete auto-generated queues\n\t\t\twaitTimeSeconds: options.waitTimeSeconds ?? 20,\n\t\t\tmaxMessages: options.maxMessages ?? 10,\n\t\t};\n\n\t\t// Create SQS client with same config as SNS\n\t\tthis.sqsClient = new SQSClient({\n\t\t\tregion: (this.connection as any).config.region,\n\t\t\tendpoint: (this.connection as any).config.endpoint,\n\t\t\tcredentials: (this.connection as any).config.credentials,\n\t\t});\n\t}\n\n\t/**\n\t * Create an SNSSubscriber from a connection string\n\t * Format: sns://?topicArn=...&queueName=myqueue&region=us-east-1\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SNSSubscriber<TMessage>> {\n\t\tconst url = new URL(connectionString);\n\t\tconst params = url.searchParams;\n\n\t\tconst { SNSConnection } = await import('./SNSConnection');\n\t\tconst connection =\n\t\t\tawait SNSConnection.fromConnectionString(connectionString);\n\n\t\tconst options: SNSSubscriberOptions = {\n\t\t\tqueueName: params.get('queueName') || undefined,\n\t\t\tcreateQueue: params.get('createQueue') !== 'false',\n\t\t\tdeleteQueueOnClose: params.get('deleteQueueOnClose') === 'true',\n\t\t\twaitTimeSeconds: params.get('waitTimeSeconds')\n\t\t\t\t? Number.parseInt(params.get('waitTimeSeconds')!, 10)\n\t\t\t\t: undefined,\n\t\t};\n\n\t\treturn new SNSSubscriber<TMessage>(connection, options);\n\t}\n\n\tasync subscribe(\n\t\tmessages: TMessage['type'][],\n\t\tlistener: (payload: TMessage) => Promise<void>,\n\t): Promise<void> {\n\t\t// Setup SQS queue and SNS subscription\n\t\tawait this.setupQueue();\n\t\tawait this.subscribeToTopic();\n\n\t\t// Create SQS connection for the subscriber\n\t\tconst sqsConnection = new SQSConnection({\n\t\t\tqueueUrl: this.queueUrl!,\n\t\t\tregion: (this.connection as any).config.region,\n\t\t\tendpoint: (this.connection as any).config.endpoint,\n\t\t\tcredentials: (this.connection as any).config.credentials,\n\t\t});\n\t\tawait sqsConnection.connect();\n\n\t\t// Use SQSSubscriber to receive messages, with topic filtering\n\t\tthis.sqsSubscriber = new SQSSubscriber<TMessage>(sqsConnection, {\n\t\t\twaitTimeSeconds: this.options.waitTimeSeconds,\n\t\t\tmaxMessages: this.options.maxMessages,\n\t\t\texpectedTopicArn: this.connection.topicArn,\n\t\t});\n\n\t\tawait this.sqsSubscriber.subscribe(messages, listener);\n\t}\n\n\t/**\n\t * Stop receiving messages and clean up resources\n\t */\n\tasync stop(): Promise<void> {\n\t\t// Stop SQS subscriber\n\t\tif (this.sqsSubscriber) {\n\t\t\tthis.sqsSubscriber.stop();\n\t\t}\n\n\t\t// Unsubscribe from topic\n\t\tif (this.subscriptionArn) {\n\t\t\ttry {\n\t\t\t\tconst command = new UnsubscribeCommand({\n\t\t\t\t\tSubscriptionArn: this.subscriptionArn,\n\t\t\t\t});\n\t\t\t\tawait this.connection.snsClient.send(command);\n\t\t\t} catch (_error) {}\n\t\t}\n\n\t\t// Delete queue if configured\n\t\tif (this.queueUrl && this.options.deleteQueueOnClose) {\n\t\t\ttry {\n\t\t\t\tconst command = new DeleteQueueCommand({\n\t\t\t\t\tQueueUrl: this.queueUrl,\n\t\t\t\t});\n\t\t\t\tawait this.sqsClient.send(command);\n\t\t\t} catch (_error) {}\n\t\t}\n\n\t\tthis.sqsClient.destroy();\n\t}\n\n\tprivate async setupQueue(): Promise<void> {\n\t\tif (this.options.createQueue) {\n\t\t\t// Create queue\n\t\t\tconst createCommand = new CreateQueueCommand({\n\t\t\t\tQueueName: this.options.queueName,\n\t\t\t});\n\t\t\tconst response = await this.sqsClient.send(createCommand);\n\t\t\tthis.queueUrl = response.QueueUrl!;\n\t\t} else {\n\t\t\tthrow new Error('Queue must exist or createQueue option must be true');\n\t\t}\n\n\t\t// Get queue ARN\n\t\tconst attrsCommand = new GetQueueAttributesCommand({\n\t\t\tQueueUrl: this.queueUrl,\n\t\t\tAttributeNames: ['QueueArn'],\n\t\t});\n\t\tconst attrsResponse = await this.sqsClient.send(attrsCommand);\n\t\tthis.queueArn = attrsResponse.Attributes?.QueueArn!;\n\n\t\t// Set queue policy to allow SNS\n\t\tawait this.setQueuePolicy();\n\t}\n\n\tprivate async setQueuePolicy(): Promise<void> {\n\t\tconst policy = {\n\t\t\tVersion: '2012-10-17',\n\t\t\tStatement: [\n\t\t\t\t{\n\t\t\t\t\tEffect: 'Allow',\n\t\t\t\t\tPrincipal: '*',\n\t\t\t\t\tAction: 'SQS:SendMessage',\n\t\t\t\t\tResource: this.queueArn,\n\t\t\t\t\tCondition: {\n\t\t\t\t\t\tArnEquals: {\n\t\t\t\t\t\t\t'aws:SourceArn': this.connection.topicArn,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t],\n\t\t};\n\n\t\tconst command = new SetQueueAttributesCommand({\n\t\t\tQueueUrl: this.queueUrl,\n\t\t\tAttributes: {\n\t\t\t\tPolicy: JSON.stringify(policy),\n\t\t\t},\n\t\t});\n\n\t\tawait this.sqsClient.send(command);\n\t}\n\n\tprivate async subscribeToTopic(): Promise<void> {\n\t\tconst command = new SubscribeCommand({\n\t\t\tTopicArn: this.connection.topicArn,\n\t\t\tProtocol: 'sqs',\n\t\t\tEndpoint: this.queueArn,\n\t\t});\n\n\t\tconst response = await this.connection.snsClient.send(command);\n\t\tthis.subscriptionArn = response.SubscriptionArn!;\n\t}\n}\n"],"mappings":";;;;;;;;;;;AAMA,IAAa,eAAb,MAAa,aAEb;CACC,YACSA,YACRC,WAAgC,CAAE,GACjC;EAFO;CAEL;;;;;CAMJ,aAAa,qBAEXC,kBAA2D;EAC5D,MAAM,EAAE,gCAAe,GAAG,2CAAM;EAChC,MAAM,aACL,MAAM,gBAAc,qBAAqB,iBAAiB;AAE3D,SAAO,IAAI,aAAuB;CAClC;CAED,MAAM,QAAQC,UAAqC;AAClD,MAAI,SAAS,WAAW,EAAG;AAE3B,OAAK,KAAK,WAAW,aAAa,CACjC,OAAM,KAAK,WAAW,SAAS;AAIhC,QAAM,QAAQ,IAAI,SAAS,IAAI,CAAC,YAAY,KAAK,eAAe,QAAQ,CAAC,CAAC;CAC1E;CAED,MAAc,eAAeC,SAAkC;EAC9D,MAAM,UAAU,IAAIC,oCAAe;GAClC,UAAU,KAAK,WAAW;GAC1B,SAAS,KAAK,UAAU;IACvB,MAAM,QAAQ;IACd,SAAS,QAAQ;GACjB,EAAC;GACF,mBAAmB,EAClB,MAAM;IACL,UAAU;IACV,aAAa,QAAQ;GACrB,EACD;EACD;AAED,QAAM,KAAK,WAAW,UAAU,KAAK,QAAQ;CAC7C;CAED,MAAM,QAAuB,CAG5B;AACD;;;;;;;;;;;;;;;;;;;;;ACvBD,IAAa,gBAAb,MAAa,cAEb;CACC,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CACR,AAAQ;CAER,YACSC,YACRC,UAAgC,CAAE,GACjC;EAFO;AAGR,OAAK,UAAU;GACd,WACC,QAAQ,cACP,UAAU,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,UAAU,EAAE,CAAC;GAClE,aAAa,QAAQ,eAAe;GACpC,oBAAoB,QAAQ,uBAAuB,QAAQ;GAC3D,iBAAiB,QAAQ,mBAAmB;GAC5C,aAAa,QAAQ,eAAe;EACpC;AAGD,OAAK,YAAY,IAAIC,+BAAU;GAC9B,QAAS,KAAK,WAAmB,OAAO;GACxC,UAAW,KAAK,WAAmB,OAAO;GAC1C,aAAc,KAAK,WAAmB,OAAO;EAC7C;CACD;;;;;CAMD,aAAa,qBAEXC,kBAA4D;EAC7D,MAAM,MAAM,IAAI,IAAI;EACpB,MAAM,SAAS,IAAI;EAEnB,MAAM,EAAE,gCAAe,GAAG,2CAAM;EAChC,MAAM,aACL,MAAM,gBAAc,qBAAqB,iBAAiB;EAE3D,MAAMF,UAAgC;GACrC,WAAW,OAAO,IAAI,YAAY;GAClC,aAAa,OAAO,IAAI,cAAc,KAAK;GAC3C,oBAAoB,OAAO,IAAI,qBAAqB,KAAK;GACzD,iBAAiB,OAAO,IAAI,kBAAkB,GAC3C,OAAO,SAAS,OAAO,IAAI,kBAAkB,EAAG,GAAG;EAEtD;AAED,SAAO,IAAI,cAAwB,YAAY;CAC/C;CAED,MAAM,UACLG,UACAC,UACgB;AAEhB,QAAM,KAAK,YAAY;AACvB,QAAM,KAAK,kBAAkB;EAG7B,MAAM,gBAAgB,IAAIC,oCAAc;GACvC,UAAU,KAAK;GACf,QAAS,KAAK,WAAmB,OAAO;GACxC,UAAW,KAAK,WAAmB,OAAO;GAC1C,aAAc,KAAK,WAAmB,OAAO;EAC7C;AACD,QAAM,cAAc,SAAS;AAG7B,OAAK,gBAAgB,IAAIC,oCAAwB,eAAe;GAC/D,iBAAiB,KAAK,QAAQ;GAC9B,aAAa,KAAK,QAAQ;GAC1B,kBAAkB,KAAK,WAAW;EAClC;AAED,QAAM,KAAK,cAAc,UAAU,UAAU,SAAS;CACtD;;;;CAKD,MAAM,OAAsB;AAE3B,MAAI,KAAK,cACR,MAAK,cAAc,MAAM;AAI1B,MAAI,KAAK,gBACR,KAAI;GACH,MAAM,UAAU,IAAIC,wCAAmB,EACtC,iBAAiB,KAAK,gBACtB;AACD,SAAM,KAAK,WAAW,UAAU,KAAK,QAAQ;EAC7C,SAAQ,QAAQ,CAAE;AAIpB,MAAI,KAAK,YAAY,KAAK,QAAQ,mBACjC,KAAI;GACH,MAAM,UAAU,IAAIC,wCAAmB,EACtC,UAAU,KAAK,SACf;AACD,SAAM,KAAK,UAAU,KAAK,QAAQ;EAClC,SAAQ,QAAQ,CAAE;AAGpB,OAAK,UAAU,SAAS;CACxB;CAED,MAAc,aAA4B;AACzC,MAAI,KAAK,QAAQ,aAAa;GAE7B,MAAM,gBAAgB,IAAIC,wCAAmB,EAC5C,WAAW,KAAK,QAAQ,UACxB;GACD,MAAM,WAAW,MAAM,KAAK,UAAU,KAAK,cAAc;AACzD,QAAK,WAAW,SAAS;EACzB,MACA,OAAM,IAAI,MAAM;EAIjB,MAAM,eAAe,IAAIC,+CAA0B;GAClD,UAAU,KAAK;GACf,gBAAgB,CAAC,UAAW;EAC5B;EACD,MAAM,gBAAgB,MAAM,KAAK,UAAU,KAAK,aAAa;AAC7D,OAAK,WAAW,cAAc,YAAY;AAG1C,QAAM,KAAK,gBAAgB;CAC3B;CAED,MAAc,iBAAgC;EAC7C,MAAM,SAAS;GACd,SAAS;GACT,WAAW,CACV;IACC,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,UAAU,KAAK;IACf,WAAW,EACV,WAAW,EACV,iBAAiB,KAAK,WAAW,SACjC,EACD;GACD,CACD;EACD;EAED,MAAM,UAAU,IAAIC,+CAA0B;GAC7C,UAAU,KAAK;GACf,YAAY,EACX,QAAQ,KAAK,UAAU,OAAO,CAC9B;EACD;AAED,QAAM,KAAK,UAAU,KAAK,QAAQ;CAClC;CAED,MAAc,mBAAkC;EAC/C,MAAM,UAAU,IAAIC,sCAAiB;GACpC,UAAU,KAAK,WAAW;GAC1B,UAAU;GACV,UAAU,KAAK;EACf;EAED,MAAM,WAAW,MAAM,KAAK,WAAW,UAAU,KAAK,QAAQ;AAC9D,OAAK,kBAAkB,SAAS;CAChC;AACD"}

package/dist/sns/index.d.cts

@@ -1,5 +1,109 @@
-import "../types-Dj23od3e.cjs";
-import { SNSConnection, SNSConnectionConfig } from "../SNSConnection-Dol9FuxA.cjs";
-import { SNSPublisher, SNSPublisherOptions } from "../SNSPublisher-DQunY4NM.cjs";
-import { SNSSubscriber, SNSSubscriberOptions } from "../SNSSubscriber-ZGJjhXFQ.cjs";
-export { SNSConnection, SNSConnectionConfig, SNSPublisher, SNSPublisherOptions, SNSSubscriber, SNSSubscriberOptions };
+import { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, PublishableMessage } from "../types-BmixGrOD.cjs";
+import { SnsAddress, snsUrl_d_exports } from "../snsUrl-ASdc0D1v.cjs";
+import { SNSClient } from "@aws-sdk/client-sns";
+
+//#region src/sns/SNSConnection.d.ts
+interface SNSConnectionConfig {
+  topicArn: string;
+  region?: string;
+  endpoint?: string;
+  credentials?: {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+  };
+}
+declare class SNSConnection implements EventConnection {
+  readonly type = EventPublisherType.SNS;
+  private client;
+  private connected;
+  private config;
+  constructor(config: SNSConnectionConfig);
+  /**
+   * Create an SNSConnection from a connection string
+   * Format: sns://?topicArn=arn:aws:sns:region:account:topic&region=us-east-1&endpoint=http://localhost:4566
+   */
+  static fromConnectionString(connectionString: string): Promise<SNSConnection>;
+  connect(): Promise<void>;
+  close(): Promise<void>;
+  isConnected(): boolean;
+  /**
+   * Get the underlying SNS client
+   */
+  get snsClient(): SNSClient;
+  /**
+   * Get the topic ARN for this connection
+   */
+  get topicArn(): string;
+}
+//# sourceMappingURL=SNSConnection.d.ts.map
+//#endregion
+//#region src/sns/SNSPublisher.d.ts
+type SNSPublisherOptions = {};
+declare class SNSPublisher<TMessage extends PublishableMessage<string, any>> implements EventPublisher<TMessage> {
+  private connection;
+  constructor(connection: SNSConnection, _options?: SNSPublisherOptions);
+  /**
+   * Create an SNSPublisher from a connection string
+   * Format: sns://?topicArn=arn:aws:sns:region:account:topic&region=us-east-1&endpoint=http://localhost:4566
+   */
+  static fromConnectionString<TMessage extends PublishableMessage<string, any>>(connectionString: string): Promise<SNSPublisher<TMessage>>;
+  publish(messages: TMessage[]): Promise<void>;
+  private publishMessage;
+  close(): Promise<void>;
+}
+//# sourceMappingURL=SNSPublisher.d.ts.map
+//#endregion
+//#region src/sns/SNSSubscriber.d.ts
+interface SNSSubscriberOptions {
+  queueName?: string;
+  createQueue?: boolean;
+  deleteQueueOnClose?: boolean;
+  waitTimeSeconds?: number;
+  maxMessages?: number;
+}
+/**
+ * SNS Subscriber - receives push-based messages from SNS via SQS queue
+ *
+ * Architecture:
+ * SNS Topic → (push) → SQS Queue → Subscriber
+ *
+ * This subscriber automatically:
+ * 1. Creates an SQS queue (or uses existing one)
+ * 2. Subscribes the queue to the SNS topic
+ * 3. Receives messages pushed from SNS to the queue
+ * 4. Filters messages by topic ARN and message type
+ * 5. Processes and acknowledges messages
+ *
+ * Note: While SQS long-polling is used internally to receive messages,
+ * this is an implementation detail of the SNS push delivery mechanism.
+ * Messages are pushed from SNS to SQS, and we receive those pushed messages.
+ */
+declare class SNSSubscriber<TMessage extends PublishableMessage<string, any>> implements EventSubscriber<TMessage> {
+  private connection;
+  private sqsClient;
+  private queueUrl?;
+  private queueArn?;
+  private subscriptionArn?;
+  private sqsSubscriber?;
+  private options;
+  constructor(connection: SNSConnection, options?: SNSSubscriberOptions);
+  /**
+   * Create an SNSSubscriber from a connection string
+   * Format: sns://?topicArn=...&queueName=myqueue&region=us-east-1
+   */
+  static fromConnectionString<TMessage extends PublishableMessage<string, any>>(connectionString: string): Promise<SNSSubscriber<TMessage>>;
+  subscribe(messages: TMessage['type'][], listener: (payload: TMessage) => Promise<void>): Promise<void>;
+  /**
+   * Stop receiving messages and clean up resources
+   */
+  stop(): Promise<void>;
+  private setupQueue;
+  private setQueuePolicy;
+  private subscribeToTopic;
+}
+//# sourceMappingURL=SNSSubscriber.d.ts.map
+
+//#endregion
+export { SNSConnection, SNSConnectionConfig, SNSPublisher, SNSPublisherOptions, SNSSubscriber, SNSSubscriberOptions, SnsAddress, snsUrl_d_exports as snsUrl };
+//# sourceMappingURL=index.d.cts.map

package/dist/sns/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/sns/SNSConnection.ts","../../src/sns/SNSPublisher.ts","../../src/sns/SNSSubscriber.ts"],"sourcesContent":[],"mappings":";;;;;UAKiB,mBAAA;;EAAA,MAAA,CAAA,EAAA,MAAA;EAWJ,QAAA,CAAA,EAAA,MAAc;EAAA,WAAA,CAAA,EAAA;IACb,WAAA,EAAA,MAAA;IAKO,eAAA,EAAA,MAAA;IAkBT,YAAA,CAAA,EAAA,MAAA;EAAa,CAAA;;AAmCT,cA3DH,aAAA,YAAyB,eA2DtB,CAAA;EAAO,SAYL,IAAA,GAtEJ,kBAAA,CAAA,GAAA;EAsEa,QAvEW,MAAA;EAAe,QAAA,SAAA;;sBAMhC;;AClBrB;AAEA;;EAAyB,OAAkB,oBAAA,CAAA,gBAAA,EAAA,MAAA,CAAA,EDkCvC,OClCuC,CDkC/B,aClC+B,CAAA;EAAkB,OAClC,CAAA,CAAA,ED+DT,OC/DS,CAAA,IAAA,CAAA;EAAQ,KAGb,CAAA,CAAA,EDiEN,OCjEM,CAAA,IAAA,CAAA;EAAa,WACvB,CAAA,CAAA,EAAA,OAAA;EAAwB;;;EASc,IAApB,SAAA,CAAA,CAAA,EDmEZ,SCnEY;EAAO;;;EAqCd,IAlDX,QAAA,CAAA,CAAA,EAAA,MAAA;AAAc;;;;KAHd,mBAAA;cAEC,8BAA8B,4CAC/B,eAAe;;EDFV,WAAA,CAAA,UAAmB,ECKd,aDLc,EAAA,QAAA,CAAA,ECMxB,mBDNwB;EAWvB;;;;EAM2B,OAkB5B,oBAAA,CAAA,iBCrBO,kBDqBP,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,gBAAA,EAAA,MAAA,CAAA,ECpBkB,ODoBlB,CCpB0B,YDoB1B,CCpBuC,QDoBvC,CAAA,CAAA;EAAa,OAArB,CAAA,QAAA,ECZqB,QDYrB,EAAA,CAAA,ECZkC,ODYlC,CAAA,IAAA,CAAA;EAAO,QA8BO,cAAA;EAAO,KAKT,CAAA,CAAA,EClBA,ODkBA,CAAA,IAAA,CAAA;;;;;UE9DC,oBAAA;;;EFRA,kBAAA,CAAA,EAAA,OAAmB;EAWvB,eAAA,CAAc,EAAA,MAAA;EAAA,WAAA,CAAA,EAAA,MAAA;;;;;;;;;AAA0B;;;;ACZrD;AAEA;;;;;AAKY,cC2BC,aD3BD,CAAA,iBC2BgC,kBD3BhC,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,YC4BA,eD5BA,CC4BgB,QD5BhB,CAAA,CAAA;EAAwB,QAQjB,UAAA;EAAkB,QACc,SAAA;EAAQ,QAArB,QAAA;EAAY,QAApB,QAAA;EAAO,QAQZ,eAAA;EAAQ,QAAK,aAAA;EAAO,QA6B7B,OAAA;EAAO,WAlDX,CAAA,UAAA,EC0CU,aD1CV,EAAA,OAAA,CAAA,EC2CD,oBD3CC;EAAc;;;;ECMT,OAAA,oBAAoB,CAAA,iBA8DlB,kBA9DkB,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,gBAAA,EAAA,MAAA,CAAA,EA+DP,OA/DO,CA+DC,aA/DD,CA+De,QA/Df,CAAA,CAAA;EAyBxB,SAAA,CAAA,QAAa,EA2Dd,QA3Dc,CAAA,MAAA,CAAA,EAAA,EAAA,QAAA,EAAA,CAAA,OAAA,EA4DJ,QA5DI,EAAA,GA4DS,OA5DT,CAAA,IAAA,CAAA,CAAA,EA6DtB,OA7DsB,CAAA,IAAA,CAAA;EAAA;;;EACU,IAUd,CAAA,CAAA,EA6EP,OA7EO,CAAA,IAAA,CAAA;EAAa,QACxB,UAAA;EAAyB,QAyBjB,cAAA;EAAkB,QACe,gBAAA"}

package/dist/sns/index.d.mts

@@ -1,5 +1,109 @@
-import "../types-Dh9Jyinx.mjs";
-import { SNSConnection, SNSConnectionConfig } from "../SNSConnection-CG4iEwA8.mjs";
-import { SNSPublisher, SNSPublisherOptions } from "../SNSPublisher-D50dPCEh.mjs";
-import { SNSSubscriber, SNSSubscriberOptions } from "../SNSSubscriber-CUgHK4W2.mjs";
-export { SNSConnection, SNSConnectionConfig, SNSPublisher, SNSPublisherOptions, SNSSubscriber, SNSSubscriberOptions };
+import { EventConnection, EventPublisher, EventPublisherType, EventSubscriber, PublishableMessage } from "../types-DycjsYms.mjs";
+import { SnsAddress, snsUrl_d_exports } from "../snsUrl-FRbRcwF0.mjs";
+import { SNSClient } from "@aws-sdk/client-sns";
+
+//#region src/sns/SNSConnection.d.ts
+interface SNSConnectionConfig {
+  topicArn: string;
+  region?: string;
+  endpoint?: string;
+  credentials?: {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+  };
+}
+declare class SNSConnection implements EventConnection {
+  readonly type = EventPublisherType.SNS;
+  private client;
+  private connected;
+  private config;
+  constructor(config: SNSConnectionConfig);
+  /**
+   * Create an SNSConnection from a connection string
+   * Format: sns://?topicArn=arn:aws:sns:region:account:topic&region=us-east-1&endpoint=http://localhost:4566
+   */
+  static fromConnectionString(connectionString: string): Promise<SNSConnection>;
+  connect(): Promise<void>;
+  close(): Promise<void>;
+  isConnected(): boolean;
+  /**
+   * Get the underlying SNS client
+   */
+  get snsClient(): SNSClient;
+  /**
+   * Get the topic ARN for this connection
+   */
+  get topicArn(): string;
+}
+//# sourceMappingURL=SNSConnection.d.ts.map
+//#endregion
+//#region src/sns/SNSPublisher.d.ts
+type SNSPublisherOptions = {};
+declare class SNSPublisher<TMessage extends PublishableMessage<string, any>> implements EventPublisher<TMessage> {
+  private connection;
+  constructor(connection: SNSConnection, _options?: SNSPublisherOptions);
+  /**
+   * Create an SNSPublisher from a connection string
+   * Format: sns://?topicArn=arn:aws:sns:region:account:topic&region=us-east-1&endpoint=http://localhost:4566
+   */
+  static fromConnectionString<TMessage extends PublishableMessage<string, any>>(connectionString: string): Promise<SNSPublisher<TMessage>>;
+  publish(messages: TMessage[]): Promise<void>;
+  private publishMessage;
+  close(): Promise<void>;
+}
+//# sourceMappingURL=SNSPublisher.d.ts.map
+//#endregion
+//#region src/sns/SNSSubscriber.d.ts
+interface SNSSubscriberOptions {
+  queueName?: string;
+  createQueue?: boolean;
+  deleteQueueOnClose?: boolean;
+  waitTimeSeconds?: number;
+  maxMessages?: number;
+}
+/**
+ * SNS Subscriber - receives push-based messages from SNS via SQS queue
+ *
+ * Architecture:
+ * SNS Topic → (push) → SQS Queue → Subscriber
+ *
+ * This subscriber automatically:
+ * 1. Creates an SQS queue (or uses existing one)
+ * 2. Subscribes the queue to the SNS topic
+ * 3. Receives messages pushed from SNS to the queue
+ * 4. Filters messages by topic ARN and message type
+ * 5. Processes and acknowledges messages
+ *
+ * Note: While SQS long-polling is used internally to receive messages,
+ * this is an implementation detail of the SNS push delivery mechanism.
+ * Messages are pushed from SNS to SQS, and we receive those pushed messages.
+ */
+declare class SNSSubscriber<TMessage extends PublishableMessage<string, any>> implements EventSubscriber<TMessage> {
+  private connection;
+  private sqsClient;
+  private queueUrl?;
+  private queueArn?;
+  private subscriptionArn?;
+  private sqsSubscriber?;
+  private options;
+  constructor(connection: SNSConnection, options?: SNSSubscriberOptions);
+  /**
+   * Create an SNSSubscriber from a connection string
+   * Format: sns://?topicArn=...&queueName=myqueue&region=us-east-1
+   */
+  static fromConnectionString<TMessage extends PublishableMessage<string, any>>(connectionString: string): Promise<SNSSubscriber<TMessage>>;
+  subscribe(messages: TMessage['type'][], listener: (payload: TMessage) => Promise<void>): Promise<void>;
+  /**
+   * Stop receiving messages and clean up resources
+   */
+  stop(): Promise<void>;
+  private setupQueue;
+  private setQueuePolicy;
+  private subscribeToTopic;
+}
+//# sourceMappingURL=SNSSubscriber.d.ts.map
+
+//#endregion
+export { SNSConnection, SNSConnectionConfig, SNSPublisher, SNSPublisherOptions, SNSSubscriber, SNSSubscriberOptions, SnsAddress, snsUrl_d_exports as snsUrl };
+//# sourceMappingURL=index.d.mts.map

package/dist/sns/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/sns/SNSConnection.ts","../../src/sns/SNSPublisher.ts","../../src/sns/SNSSubscriber.ts"],"sourcesContent":[],"mappings":";;;;;UAKiB,mBAAA;;EAAA,MAAA,CAAA,EAAA,MAAA;EAWJ,QAAA,CAAA,EAAA,MAAc;EAAA,WAAA,CAAA,EAAA;IACb,WAAA,EAAA,MAAA;IAKO,eAAA,EAAA,MAAA;IAkBT,YAAA,CAAA,EAAA,MAAA;EAAa,CAAA;;AAmCT,cA3DH,aAAA,YAAyB,eA2DtB,CAAA;EAAO,SAYL,IAAA,GAtEJ,kBAAA,CAAA,GAAA;EAsEa,QAvEW,MAAA;EAAe,QAAA,SAAA;;sBAMhC;;AClBrB;AAEA;;EAAyB,OAAkB,oBAAA,CAAA,gBAAA,EAAA,MAAA,CAAA,EDkCvC,OClCuC,CDkC/B,aClC+B,CAAA;EAAkB,OAClC,CAAA,CAAA,ED+DT,OC/DS,CAAA,IAAA,CAAA;EAAQ,KAGb,CAAA,CAAA,EDiEN,OCjEM,CAAA,IAAA,CAAA;EAAa,WACvB,CAAA,CAAA,EAAA,OAAA;EAAwB;;;EASc,IAApB,SAAA,CAAA,CAAA,EDmEZ,SCnEY;EAAO;;;EAqCd,IAlDX,QAAA,CAAA,CAAA,EAAA,MAAA;AAAc;;;;KAHd,mBAAA;cAEC,8BAA8B,4CAC/B,eAAe;;EDFV,WAAA,CAAA,UAAmB,ECKd,aDLc,EAAA,QAAA,CAAA,ECMxB,mBDNwB;EAWvB;;;;EAM2B,OAkB5B,oBAAA,CAAA,iBCrBO,kBDqBP,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,gBAAA,EAAA,MAAA,CAAA,ECpBkB,ODoBlB,CCpB0B,YDoB1B,CCpBuC,QDoBvC,CAAA,CAAA;EAAa,OAArB,CAAA,QAAA,ECZqB,QDYrB,EAAA,CAAA,ECZkC,ODYlC,CAAA,IAAA,CAAA;EAAO,QA8BO,cAAA;EAAO,KAKT,CAAA,CAAA,EClBA,ODkBA,CAAA,IAAA,CAAA;;;;;UE9DC,oBAAA;;;EFRA,kBAAA,CAAA,EAAA,OAAmB;EAWvB,eAAA,CAAc,EAAA,MAAA;EAAA,WAAA,CAAA,EAAA,MAAA;;;;;;;;;AAA0B;;;;ACZrD;AAEA;;;;;AAKY,cC2BC,aD3BD,CAAA,iBC2BgC,kBD3BhC,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,YC4BA,eD5BA,CC4BgB,QD5BhB,CAAA,CAAA;EAAwB,QAQjB,UAAA;EAAkB,QACc,SAAA;EAAQ,QAArB,QAAA;EAAY,QAApB,QAAA;EAAO,QAQZ,eAAA;EAAQ,QAAK,aAAA;EAAO,QA6B7B,OAAA;EAAO,WAlDX,CAAA,UAAA,EC0CU,aD1CV,EAAA,OAAA,CAAA,EC2CD,oBD3CC;EAAc;;;;ECMT,OAAA,oBAAoB,CAAA,iBA8DlB,kBA9DkB,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA,CAAA,gBAAA,EAAA,MAAA,CAAA,EA+DP,OA/DO,CA+DC,aA/DD,CA+De,QA/Df,CAAA,CAAA;EAyBxB,SAAA,CAAA,QAAa,EA2Dd,QA3Dc,CAAA,MAAA,CAAA,EAAA,EAAA,QAAA,EAAA,CAAA,OAAA,EA4DJ,QA5DI,EAAA,GA4DS,OA5DT,CAAA,IAAA,CAAA,CAAA,EA6DtB,OA7DsB,CAAA,IAAA,CAAA;EAAA;;;EACU,IAUd,CAAA,CAAA,EA6EP,OA7EO,CAAA,IAAA,CAAA;EAAa,QACxB,UAAA;EAAyB,QAyBjB,cAAA;EAAkB,QACe,gBAAA"}

package/dist/sns/index.mjs

@@ -1,8 +1,180 @@
-import "../types-BrdcSEnd.mjs";
-import { SNSConnection } from "../SNSConnection-CpMKzgx2.mjs";
-import { SNSPublisher } from "../SNSPublisher-Drr4kHn6.mjs";
-import "../SQSConnection-BqZZnAZI.mjs";
-import "../SQSSubscriber-CVGhZ8Nr.mjs";
-import { SNSSubscriber } from "../SNSSubscriber-DIXqA-VV.mjs";
+import "../types-CYDt-2RQ.mjs";
+import { snsUrl_exports } from "../snsUrl-CifYhPAa.mjs";
+import { SNSConnection } from "../SNSConnection-v9jjF99w.mjs";
+import "../sqsUrl-CbAsBFHI.mjs";
+import { SQSConnection } from "../SQSConnection-4tBMkVZE.mjs";
+import { SQSSubscriber } from "../SQSSubscriber-BMWZ3s5q.mjs";
+import { PublishCommand, SubscribeCommand, UnsubscribeCommand } from "@aws-sdk/client-sns";
+import { CreateQueueCommand, DeleteQueueCommand, GetQueueAttributesCommand, SQSClient, SetQueueAttributesCommand } from "@aws-sdk/client-sqs";
 
-export { SNSConnection, SNSPublisher, SNSSubscriber };
+//#region src/sns/SNSPublisher.ts
+var SNSPublisher = class SNSPublisher {
+	constructor(connection, _options = {}) {
+		this.connection = connection;
+	}
+	/**
+	* Create an SNSPublisher from a connection string
+	* Format: sns://?topicArn=arn:aws:sns:region:account:topic&region=us-east-1&endpoint=http://localhost:4566
+	*/
+	static async fromConnectionString(connectionString) {
+		const { SNSConnection: SNSConnection$1 } = await import("../SNSConnection-BVo84FeW.mjs");
+		const connection = await SNSConnection$1.fromConnectionString(connectionString);
+		return new SNSPublisher(connection);
+	}
+	async publish(messages) {
+		if (messages.length === 0) return;
+		if (!this.connection.isConnected()) await this.connection.connect();
+		await Promise.all(messages.map((message) => this.publishMessage(message)));
+	}
+	async publishMessage(message) {
+		const command = new PublishCommand({
+			TopicArn: this.connection.topicArn,
+			Message: JSON.stringify({
+				type: message.type,
+				payload: message.payload
+			}),
+			MessageAttributes: { type: {
+				DataType: "String",
+				StringValue: message.type
+			} }
+		});
+		await this.connection.snsClient.send(command);
+	}
+	async close() {}
+};
+
+//#endregion
+//#region src/sns/SNSSubscriber.ts
+/**
+* SNS Subscriber - receives push-based messages from SNS via SQS queue
+*
+* Architecture:
+* SNS Topic → (push) → SQS Queue → Subscriber
+*
+* This subscriber automatically:
+* 1. Creates an SQS queue (or uses existing one)
+* 2. Subscribes the queue to the SNS topic
+* 3. Receives messages pushed from SNS to the queue
+* 4. Filters messages by topic ARN and message type
+* 5. Processes and acknowledges messages
+*
+* Note: While SQS long-polling is used internally to receive messages,
+* this is an implementation detail of the SNS push delivery mechanism.
+* Messages are pushed from SNS to SQS, and we receive those pushed messages.
+*/
+var SNSSubscriber = class SNSSubscriber {
+	sqsClient;
+	queueUrl;
+	queueArn;
+	subscriptionArn;
+	sqsSubscriber;
+	options;
+	constructor(connection, options = {}) {
+		this.connection = connection;
+		this.options = {
+			queueName: options.queueName || `sns-sub-${Date.now()}-${Math.random().toString(36).substring(7)}`,
+			createQueue: options.createQueue ?? true,
+			deleteQueueOnClose: options.deleteQueueOnClose ?? !options.queueName,
+			waitTimeSeconds: options.waitTimeSeconds ?? 20,
+			maxMessages: options.maxMessages ?? 10
+		};
+		this.sqsClient = new SQSClient({
+			region: this.connection.config.region,
+			endpoint: this.connection.config.endpoint,
+			credentials: this.connection.config.credentials
+		});
+	}
+	/**
+	* Create an SNSSubscriber from a connection string
+	* Format: sns://?topicArn=...&queueName=myqueue&region=us-east-1
+	*/
+	static async fromConnectionString(connectionString) {
+		const url = new URL(connectionString);
+		const params = url.searchParams;
+		const { SNSConnection: SNSConnection$1 } = await import("../SNSConnection-BVo84FeW.mjs");
+		const connection = await SNSConnection$1.fromConnectionString(connectionString);
+		const options = {
+			queueName: params.get("queueName") || void 0,
+			createQueue: params.get("createQueue") !== "false",
+			deleteQueueOnClose: params.get("deleteQueueOnClose") === "true",
+			waitTimeSeconds: params.get("waitTimeSeconds") ? Number.parseInt(params.get("waitTimeSeconds"), 10) : void 0
+		};
+		return new SNSSubscriber(connection, options);
+	}
+	async subscribe(messages, listener) {
+		await this.setupQueue();
+		await this.subscribeToTopic();
+		const sqsConnection = new SQSConnection({
+			queueUrl: this.queueUrl,
+			region: this.connection.config.region,
+			endpoint: this.connection.config.endpoint,
+			credentials: this.connection.config.credentials
+		});
+		await sqsConnection.connect();
+		this.sqsSubscriber = new SQSSubscriber(sqsConnection, {
+			waitTimeSeconds: this.options.waitTimeSeconds,
+			maxMessages: this.options.maxMessages,
+			expectedTopicArn: this.connection.topicArn
+		});
+		await this.sqsSubscriber.subscribe(messages, listener);
+	}
+	/**
+	* Stop receiving messages and clean up resources
+	*/
+	async stop() {
+		if (this.sqsSubscriber) this.sqsSubscriber.stop();
+		if (this.subscriptionArn) try {
+			const command = new UnsubscribeCommand({ SubscriptionArn: this.subscriptionArn });
+			await this.connection.snsClient.send(command);
+		} catch (_error) {}
+		if (this.queueUrl && this.options.deleteQueueOnClose) try {
+			const command = new DeleteQueueCommand({ QueueUrl: this.queueUrl });
+			await this.sqsClient.send(command);
+		} catch (_error) {}
+		this.sqsClient.destroy();
+	}
+	async setupQueue() {
+		if (this.options.createQueue) {
+			const createCommand = new CreateQueueCommand({ QueueName: this.options.queueName });
+			const response = await this.sqsClient.send(createCommand);
+			this.queueUrl = response.QueueUrl;
+		} else throw new Error("Queue must exist or createQueue option must be true");
+		const attrsCommand = new GetQueueAttributesCommand({
+			QueueUrl: this.queueUrl,
+			AttributeNames: ["QueueArn"]
+		});
+		const attrsResponse = await this.sqsClient.send(attrsCommand);
+		this.queueArn = attrsResponse.Attributes?.QueueArn;
+		await this.setQueuePolicy();
+	}
+	async setQueuePolicy() {
+		const policy = {
+			Version: "2012-10-17",
+			Statement: [{
+				Effect: "Allow",
+				Principal: "*",
+				Action: "SQS:SendMessage",
+				Resource: this.queueArn,
+				Condition: { ArnEquals: { "aws:SourceArn": this.connection.topicArn } }
+			}]
+		};
+		const command = new SetQueueAttributesCommand({
+			QueueUrl: this.queueUrl,
+			Attributes: { Policy: JSON.stringify(policy) }
+		});
+		await this.sqsClient.send(command);
+	}
+	async subscribeToTopic() {
+		const command = new SubscribeCommand({
+			TopicArn: this.connection.topicArn,
+			Protocol: "sqs",
+			Endpoint: this.queueArn
+		});
+		const response = await this.connection.snsClient.send(command);
+		this.subscriptionArn = response.SubscriptionArn;
+	}
+};
+
+//#endregion
+export { SNSConnection, SNSPublisher, SNSSubscriber, snsUrl_exports as snsUrl };
+//# sourceMappingURL=index.mjs.map

package/dist/sns/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["connection: SNSConnection","_options: SNSPublisherOptions","connectionString: string","messages: TMessage[]","message: TMessage","connection: SNSConnection","options: SNSSubscriberOptions","connectionString: string","messages: TMessage['type'][]","listener: (payload: TMessage) => Promise<void>"],"sources":["../../src/sns/SNSPublisher.ts","../../src/sns/SNSSubscriber.ts"],"sourcesContent":["import { PublishCommand } from '@aws-sdk/client-sns';\nimport type { EventPublisher, PublishableMessage } from '../types';\nimport type { SNSConnection } from './SNSConnection';\n\nexport type SNSPublisherOptions = {};\n\nexport class SNSPublisher<TMessage extends PublishableMessage<string, any>>\n\timplements EventPublisher<TMessage>\n{\n\tconstructor(\n\t\tprivate connection: SNSConnection,\n\t\t_options: SNSPublisherOptions = {},\n\t) {}\n\n\t/**\n\t * Create an SNSPublisher from a connection string\n\t * Format: sns://?topicArn=arn:aws:sns:region:account:topic&region=us-east-1&endpoint=http://localhost:4566\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SNSPublisher<TMessage>> {\n\t\tconst { SNSConnection } = await import('./SNSConnection');\n\t\tconst connection =\n\t\t\tawait SNSConnection.fromConnectionString(connectionString);\n\n\t\treturn new SNSPublisher<TMessage>(connection);\n\t}\n\n\tasync publish(messages: TMessage[]): Promise<void> {\n\t\tif (messages.length === 0) return;\n\n\t\tif (!this.connection.isConnected()) {\n\t\t\tawait this.connection.connect();\n\t\t}\n\n\t\t// Publish all messages\n\t\tawait Promise.all(messages.map((message) => this.publishMessage(message)));\n\t}\n\n\tprivate async publishMessage(message: TMessage): Promise<void> {\n\t\tconst command = new PublishCommand({\n\t\t\tTopicArn: this.connection.topicArn,\n\t\t\tMessage: JSON.stringify({\n\t\t\t\ttype: message.type,\n\t\t\t\tpayload: message.payload,\n\t\t\t}),\n\t\t\tMessageAttributes: {\n\t\t\t\ttype: {\n\t\t\t\t\tDataType: 'String',\n\t\t\t\t\tStringValue: message.type,\n\t\t\t\t},\n\t\t\t},\n\t\t});\n\n\t\tawait this.connection.snsClient.send(command);\n\t}\n\n\tasync close(): Promise<void> {\n\t\t// Publisher doesn't own the connection\n\t\t// Connection should be closed by whoever created it\n\t}\n}\n","import { SubscribeCommand, UnsubscribeCommand } from '@aws-sdk/client-sns';\nimport {\n\tCreateQueueCommand,\n\tDeleteQueueCommand,\n\tGetQueueAttributesCommand,\n\tSetQueueAttributesCommand,\n\tSQSClient,\n} from '@aws-sdk/client-sqs';\nimport { SQSConnection } from '../sqs/SQSConnection';\nimport { SQSSubscriber } from '../sqs/SQSSubscriber';\nimport type { EventSubscriber, PublishableMessage } from '../types';\nimport type { SNSConnection } from './SNSConnection';\n\nexport interface SNSSubscriberOptions {\n\tqueueName?: string; // Optional queue name (defaults to auto-generated)\n\tcreateQueue?: boolean; // Auto-create SQS queue (default: true)\n\tdeleteQueueOnClose?: boolean; // Delete queue when subscriber closes (default: false for named queues, true for auto-generated)\n\twaitTimeSeconds?: number; // SQS long polling (default: 20)\n\tmaxMessages?: number; // Max messages per poll (default: 10)\n}\n\n/**\n * SNS Subscriber - receives push-based messages from SNS via SQS queue\n *\n * Architecture:\n * SNS Topic → (push) → SQS Queue → Subscriber\n *\n * This subscriber automatically:\n * 1. Creates an SQS queue (or uses existing one)\n * 2. Subscribes the queue to the SNS topic\n * 3. Receives messages pushed from SNS to the queue\n * 4. Filters messages by topic ARN and message type\n * 5. Processes and acknowledges messages\n *\n * Note: While SQS long-polling is used internally to receive messages,\n * this is an implementation detail of the SNS push delivery mechanism.\n * Messages are pushed from SNS to SQS, and we receive those pushed messages.\n */\nexport class SNSSubscriber<TMessage extends PublishableMessage<string, any>>\n\timplements EventSubscriber<TMessage>\n{\n\tprivate sqsClient: SQSClient;\n\tprivate queueUrl?: string;\n\tprivate queueArn?: string;\n\tprivate subscriptionArn?: string;\n\tprivate sqsSubscriber?: SQSSubscriber<TMessage>;\n\tprivate options: Required<SNSSubscriberOptions>;\n\n\tconstructor(\n\t\tprivate connection: SNSConnection,\n\t\toptions: SNSSubscriberOptions = {},\n\t) {\n\t\tthis.options = {\n\t\t\tqueueName:\n\t\t\t\toptions.queueName ||\n\t\t\t\t`sns-sub-${Date.now()}-${Math.random().toString(36).substring(7)}`,\n\t\t\tcreateQueue: options.createQueue ?? true,\n\t\t\tdeleteQueueOnClose: options.deleteQueueOnClose ?? !options.queueName, // Delete auto-generated queues\n\t\t\twaitTimeSeconds: options.waitTimeSeconds ?? 20,\n\t\t\tmaxMessages: options.maxMessages ?? 10,\n\t\t};\n\n\t\t// Create SQS client with same config as SNS\n\t\tthis.sqsClient = new SQSClient({\n\t\t\tregion: (this.connection as any).config.region,\n\t\t\tendpoint: (this.connection as any).config.endpoint,\n\t\t\tcredentials: (this.connection as any).config.credentials,\n\t\t});\n\t}\n\n\t/**\n\t * Create an SNSSubscriber from a connection string\n\t * Format: sns://?topicArn=...&queueName=myqueue&region=us-east-1\n\t */\n\tstatic async fromConnectionString<\n\t\tTMessage extends PublishableMessage<string, any>,\n\t>(connectionString: string): Promise<SNSSubscriber<TMessage>> {\n\t\tconst url = new URL(connectionString);\n\t\tconst params = url.searchParams;\n\n\t\tconst { SNSConnection } = await import('./SNSConnection');\n\t\tconst connection =\n\t\t\tawait SNSConnection.fromConnectionString(connectionString);\n\n\t\tconst options: SNSSubscriberOptions = {\n\t\t\tqueueName: params.get('queueName') || undefined,\n\t\t\tcreateQueue: params.get('createQueue') !== 'false',\n\t\t\tdeleteQueueOnClose: params.get('deleteQueueOnClose') === 'true',\n\t\t\twaitTimeSeconds: params.get('waitTimeSeconds')\n\t\t\t\t? Number.parseInt(params.get('waitTimeSeconds')!, 10)\n\t\t\t\t: undefined,\n\t\t};\n\n\t\treturn new SNSSubscriber<TMessage>(connection, options);\n\t}\n\n\tasync subscribe(\n\t\tmessages: TMessage['type'][],\n\t\tlistener: (payload: TMessage) => Promise<void>,\n\t): Promise<void> {\n\t\t// Setup SQS queue and SNS subscription\n\t\tawait this.setupQueue();\n\t\tawait this.subscribeToTopic();\n\n\t\t// Create SQS connection for the subscriber\n\t\tconst sqsConnection = new SQSConnection({\n\t\t\tqueueUrl: this.queueUrl!,\n\t\t\tregion: (this.connection as any).config.region,\n\t\t\tendpoint: (this.connection as any).config.endpoint,\n\t\t\tcredentials: (this.connection as any).config.credentials,\n\t\t});\n\t\tawait sqsConnection.connect();\n\n\t\t// Use SQSSubscriber to receive messages, with topic filtering\n\t\tthis.sqsSubscriber = new SQSSubscriber<TMessage>(sqsConnection, {\n\t\t\twaitTimeSeconds: this.options.waitTimeSeconds,\n\t\t\tmaxMessages: this.options.maxMessages,\n\t\t\texpectedTopicArn: this.connection.topicArn,\n\t\t});\n\n\t\tawait this.sqsSubscriber.subscribe(messages, listener);\n\t}\n\n\t/**\n\t * Stop receiving messages and clean up resources\n\t */\n\tasync stop(): Promise<void> {\n\t\t// Stop SQS subscriber\n\t\tif (this.sqsSubscriber) {\n\t\t\tthis.sqsSubscriber.stop();\n\t\t}\n\n\t\t// Unsubscribe from topic\n\t\tif (this.subscriptionArn) {\n\t\t\ttry {\n\t\t\t\tconst command = new UnsubscribeCommand({\n\t\t\t\t\tSubscriptionArn: this.subscriptionArn,\n\t\t\t\t});\n\t\t\t\tawait this.connection.snsClient.send(command);\n\t\t\t} catch (_error) {}\n\t\t}\n\n\t\t// Delete queue if configured\n\t\tif (this.queueUrl && this.options.deleteQueueOnClose) {\n\t\t\ttry {\n\t\t\t\tconst command = new DeleteQueueCommand({\n\t\t\t\t\tQueueUrl: this.queueUrl,\n\t\t\t\t});\n\t\t\t\tawait this.sqsClient.send(command);\n\t\t\t} catch (_error) {}\n\t\t}\n\n\t\tthis.sqsClient.destroy();\n\t}\n\n\tprivate async setupQueue(): Promise<void> {\n\t\tif (this.options.createQueue) {\n\t\t\t// Create queue\n\t\t\tconst createCommand = new CreateQueueCommand({\n\t\t\t\tQueueName: this.options.queueName,\n\t\t\t});\n\t\t\tconst response = await this.sqsClient.send(createCommand);\n\t\t\tthis.queueUrl = response.QueueUrl!;\n\t\t} else {\n\t\t\tthrow new Error('Queue must exist or createQueue option must be true');\n\t\t}\n\n\t\t// Get queue ARN\n\t\tconst attrsCommand = new GetQueueAttributesCommand({\n\t\t\tQueueUrl: this.queueUrl,\n\t\t\tAttributeNames: ['QueueArn'],\n\t\t});\n\t\tconst attrsResponse = await this.sqsClient.send(attrsCommand);\n\t\tthis.queueArn = attrsResponse.Attributes?.QueueArn!;\n\n\t\t// Set queue policy to allow SNS\n\t\tawait this.setQueuePolicy();\n\t}\n\n\tprivate async setQueuePolicy(): Promise<void> {\n\t\tconst policy = {\n\t\t\tVersion: '2012-10-17',\n\t\t\tStatement: [\n\t\t\t\t{\n\t\t\t\t\tEffect: 'Allow',\n\t\t\t\t\tPrincipal: '*',\n\t\t\t\t\tAction: 'SQS:SendMessage',\n\t\t\t\t\tResource: this.queueArn,\n\t\t\t\t\tCondition: {\n\t\t\t\t\t\tArnEquals: {\n\t\t\t\t\t\t\t'aws:SourceArn': this.connection.topicArn,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t],\n\t\t};\n\n\t\tconst command = new SetQueueAttributesCommand({\n\t\t\tQueueUrl: this.queueUrl,\n\t\t\tAttributes: {\n\t\t\t\tPolicy: JSON.stringify(policy),\n\t\t\t},\n\t\t});\n\n\t\tawait this.sqsClient.send(command);\n\t}\n\n\tprivate async subscribeToTopic(): Promise<void> {\n\t\tconst command = new SubscribeCommand({\n\t\t\tTopicArn: this.connection.topicArn,\n\t\t\tProtocol: 'sqs',\n\t\t\tEndpoint: this.queueArn,\n\t\t});\n\n\t\tconst response = await this.connection.snsClient.send(command);\n\t\tthis.subscriptionArn = response.SubscriptionArn!;\n\t}\n}\n"],"mappings":"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"}

package/dist/sns/snsUrl.cjs

@@ -0,0 +1,7 @@
+const require_snsUrl = require('../snsUrl-f2gU3CzK.cjs');
+
+exports.MalformedTopicUrl = require_snsUrl.MalformedTopicUrl;
+exports.MissingTopicArn = require_snsUrl.MissingTopicArn;
+exports.UnexpectedTopicScheme = require_snsUrl.UnexpectedTopicScheme;
+exports.build = require_snsUrl.build;
+exports.parse = require_snsUrl.parse;

package/dist/sns/snsUrl.d.cts

@@ -0,0 +1,2 @@
+import { MalformedTopicUrl, MissingTopicArn, SnsAddress, UnexpectedTopicScheme, build, parse } from "../snsUrl-ASdc0D1v.cjs";
+export { MalformedTopicUrl, MissingTopicArn, SnsAddress, UnexpectedTopicScheme, build, parse };

package/dist/sns/snsUrl.d.mts

@@ -0,0 +1,2 @@
+import { MalformedTopicUrl, MissingTopicArn, SnsAddress, UnexpectedTopicScheme, build, parse } from "../snsUrl-FRbRcwF0.mjs";
+export { MalformedTopicUrl, MissingTopicArn, SnsAddress, UnexpectedTopicScheme, build, parse };

package/dist/sns/snsUrl.mjs

@@ -0,0 +1,3 @@
+import { MalformedTopicUrl, MissingTopicArn, UnexpectedTopicScheme, build, parse } from "../snsUrl-CifYhPAa.mjs";
+
+export { MalformedTopicUrl, MissingTopicArn, UnexpectedTopicScheme, build, parse };

package/dist/snsUrl-ASdc0D1v.d.cts

@@ -0,0 +1,61 @@
+import { __export } from "./chunk-CWFgIw0j.cjs";
+
+//#region src/sns/snsUrl.d.ts
+declare namespace snsUrl_d_exports {
+  export { MalformedTopicUrl, MissingTopicArn, SnsAddress, UnexpectedTopicScheme, build, parse };
+}
+/**
+ * The `sns://` connection-string codec — how a topic is addressed as one string.
+ *
+ * The twin of `sqsUrl`, and separate from it for the same reason `gs://` would
+ * be separate from `s3://`: a topic ARN and a queue URL are different
+ * vocabularies, and a shared codec would have to contain both. What they share
+ * is only the rule that a construct provides one string.
+ *
+ * Both directions live here so they cannot drift: `parse(build(x))` is `x`.
+ */
+/** What an SNS connection string addresses. */
+interface SnsAddress {
+  topicArn: string;
+  /** Read off the topic, never inherited: a topic may live in another region. */
+  region?: string;
+  /** Set for SNS-compatible backends such as LocalStack. */
+  endpoint?: string;
+  /**
+   * The queue a subscriber drains.
+   *
+   * Present only on the subscriber's string: fan-out delivers to a queue per
+   * subscriber, so the publisher's string names the topic and nothing else.
+   */
+  queueName?: string;
+}
+/**
+ * Compose an address into a connection string.
+ *
+ * Credentials never appear, for the same reason they never appear in an
+ * `s3://` URL: the SDK resolves them from its own chain.
+ */
+declare function build(address: SnsAddress): string;
+/** Parse a connection string back into an address. */
+declare function parse(connectionString: string): SnsAddress;
+/** The string is not a URL at all. */
+declare class MalformedTopicUrl extends Error {
+  readonly url: string;
+  constructor(url: string);
+}
+/** The string is a URL, but not an `sns://` one. */
+declare class UnexpectedTopicScheme extends Error {
+  readonly url: string;
+  readonly expected: string;
+  readonly actual: string;
+  constructor(url: string, expected: string, actual: string);
+}
+/** An `sns://` string with no topic names nothing. */
+declare class MissingTopicArn extends Error {
+  readonly url: string;
+  constructor(url: string);
+}
+//# sourceMappingURL=snsUrl.d.ts.map
+//#endregion
+export { MalformedTopicUrl, MissingTopicArn, SnsAddress, UnexpectedTopicScheme, build, parse, snsUrl_d_exports };
+//# sourceMappingURL=snsUrl-ASdc0D1v.d.cts.map

package/dist/snsUrl-ASdc0D1v.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snsUrl-ASdc0D1v.d.cts","names":[],"sources":["../src/sns/snsUrl.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;;;;;;UAYiB,UAAA;EAAA,QAAA,EAAA,MAAU;EAuBX;EAcA,MAAA,CAAA,EAAK,MAAA;EA4BR;EAQA,QAAA,CAAA,EAAA,MAAA;EAcA;;;;;;;;;;;;;;iBAhEG,KAAA,UAAe;;iBAcf,KAAA,4BAAiC;;cA4BpC,iBAAA,SAA0B,KAAK;;;;;cAQ/B,qBAAA,SAA8B,KAAK;;;;;;;cAcnC,eAAA,SAAwB,KAAK"}

package/dist/snsUrl-CifYhPAa.mjs

@@ -0,0 +1,79 @@
+import { __export } from "./chunk-B9dir_RE.mjs";
+
+//#region src/sns/snsUrl.ts
+var snsUrl_exports = {};
+__export(snsUrl_exports, {
+	MalformedTopicUrl: () => MalformedTopicUrl,
+	MissingTopicArn: () => MissingTopicArn,
+	UnexpectedTopicScheme: () => UnexpectedTopicScheme,
+	build: () => build,
+	parse: () => parse
+});
+const SCHEME = "sns:";
+/**
+* Compose an address into a connection string.
+*
+* Credentials never appear, for the same reason they never appear in an
+* `s3://` URL: the SDK resolves them from its own chain.
+*/
+function build(address) {
+	const { topicArn, region, endpoint, queueName } = address;
+	if (!topicArn) throw new MissingTopicArn("");
+	const url = new URL(`${SCHEME}//`);
+	url.searchParams.set("topicArn", topicArn);
+	if (region) url.searchParams.set("region", region);
+	if (endpoint) url.searchParams.set("endpoint", endpoint);
+	if (queueName) url.searchParams.set("queueName", queueName);
+	return url.toString();
+}
+/** Parse a connection string back into an address. */
+function parse(connectionString) {
+	let parsed;
+	try {
+		parsed = new URL(connectionString);
+	} catch {
+		throw new MalformedTopicUrl(connectionString);
+	}
+	if (parsed.protocol !== SCHEME) throw new UnexpectedTopicScheme(connectionString, SCHEME, parsed.protocol);
+	const topicArn = parsed.searchParams.get("topicArn");
+	if (!topicArn) throw new MissingTopicArn(connectionString);
+	const region = parsed.searchParams.get("region") ?? void 0;
+	const endpoint = parsed.searchParams.get("endpoint") ?? void 0;
+	const queueName = parsed.searchParams.get("queueName") ?? void 0;
+	return {
+		topicArn,
+		...region ? { region } : {},
+		...endpoint ? { endpoint } : {},
+		...queueName ? { queueName } : {}
+	};
+}
+/** The string is not a URL at all. */
+var MalformedTopicUrl = class extends Error {
+	constructor(url) {
+		super(`'${url}' is not a valid connection string.`);
+		this.url = url;
+		this.name = "MalformedTopicUrl";
+	}
+};
+/** The string is a URL, but not an `sns://` one. */
+var UnexpectedTopicScheme = class extends Error {
+	constructor(url, expected, actual) {
+		super(`Expected a '${expected}//' connection string and got '${actual}//' in '${url}'.`);
+		this.url = url;
+		this.expected = expected;
+		this.actual = actual;
+		this.name = "UnexpectedTopicScheme";
+	}
+};
+/** An `sns://` string with no topic names nothing. */
+var MissingTopicArn = class extends Error {
+	constructor(url) {
+		super(url ? `'${url}' names no topic: an sns:// connection string needs ?topicArn=.` : "An sns:// connection string needs a topicArn.");
+		this.url = url;
+		this.name = "MissingTopicArn";
+	}
+};
+
+//#endregion
+export { MalformedTopicUrl, MissingTopicArn, UnexpectedTopicScheme, build, parse, snsUrl_exports };
+//# sourceMappingURL=snsUrl-CifYhPAa.mjs.map