@saga-bus/transport-sqs 0.1.2

package/README.md

@@ -0,0 +1,86 @@
+# @saga-bus/transport-sqs
+
+AWS SQS FIFO transport for saga-bus.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/transport-sqs @aws-sdk/client-sqs
+```
+
+## Usage
+
+```typescript
+import { SQSClient } from "@aws-sdk/client-sqs";
+import { SqsTransport } from "@saga-bus/transport-sqs";
+import { createBus } from "@saga-bus/core";
+
+const sqsClient = new SQSClient({ region: "us-east-1" });
+
+const transport = new SqsTransport({
+  client: sqsClient,
+  queueUrl: "https://sqs.us-east-1.amazonaws.com/123456789/my-queue.fifo",
+});
+
+const bus = createBus({
+  transport,
+  sagas: [...],
+});
+
+await bus.start();
+```
+
+## Features
+
+- FIFO queue support for ordered message processing
+- Message deduplication via MessageDeduplicationId
+- Message grouping via MessageGroupId (uses correlation ID)
+- Long polling for efficient message retrieval
+- Configurable visibility timeout
+- Concurrent poll loops
+
+## FIFO Queue Requirements
+
+This transport requires a FIFO queue (queue URL must end with `.fifo`):
+
+```bash
+aws sqs create-queue \
+  --queue-name my-queue.fifo \
+  --attributes FifoQueue=true,ContentBasedDeduplication=false
+```
+
+## Message Attributes
+
+Messages are published with:
+
+| Attribute | Value |
+|-----------|-------|
+| `MessageGroupId` | Correlation ID or message ID |
+| `MessageDeduplicationId` | Message ID |
+| `MessageAttributes.type` | Message type |
+| `MessageAttributes.correlationId` | Correlation ID |
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `client` | `SQSClient` | required | AWS SQS client |
+| `queueUrl` | `string` | required | FIFO queue URL |
+| `maxMessages` | `number` | `10` | Messages per poll |
+| `waitTimeSeconds` | `number` | `20` | Long poll wait time |
+| `visibilityTimeout` | `number` | `30` | Visibility timeout (seconds) |
+| `concurrency` | `number` | `1` | Concurrent poll loops |
+
+## Error Handling
+
+Failed messages remain in the queue after visibility timeout expires. Configure a dead-letter queue (DLQ) for messages that repeatedly fail:
+
+```bash
+aws sqs set-queue-attributes \
+  --queue-url https://sqs.../my-queue.fifo \
+  --attributes RedrivePolicy='{"deadLetterTargetArn":"arn:aws:sqs:...:dlq.fifo","maxReceiveCount":"3"}'
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,179 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SqsTransport: () => SqsTransport
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/SqsTransport.ts
+var import_node_crypto = require("crypto");
+var import_client_sqs = require("@aws-sdk/client-sqs");
+var SqsTransport = class {
+  client;
+  queueUrl;
+  maxMessages;
+  waitTimeSeconds;
+  visibilityTimeout;
+  concurrency;
+  handlers = /* @__PURE__ */ new Map();
+  subscriptions = [];
+  isRunning = false;
+  pollLoops = [];
+  constructor(options) {
+    this.client = options.client;
+    this.queueUrl = options.queueUrl;
+    this.maxMessages = options.maxMessages ?? 10;
+    this.waitTimeSeconds = options.waitTimeSeconds ?? 20;
+    this.visibilityTimeout = options.visibilityTimeout ?? 30;
+    this.concurrency = options.concurrency ?? 1;
+    if (!this.queueUrl.endsWith(".fifo")) {
+      throw new Error(
+        "SqsTransport requires a FIFO queue (URL must end with .fifo)"
+      );
+    }
+  }
+  async start() {
+    if (this.isRunning) {
+      return;
+    }
+    this.isRunning = true;
+    for (let i = 0; i < this.concurrency; i++) {
+      this.pollLoops.push(this.pollLoop());
+    }
+  }
+  async stop() {
+    this.isRunning = false;
+    await Promise.all(this.pollLoops);
+    this.pollLoops = [];
+  }
+  async subscribe(options, handler) {
+    const { endpoint } = options;
+    this.handlers.set(
+      endpoint,
+      handler
+    );
+    this.subscriptions.push({
+      endpoint,
+      concurrency: options.concurrency ?? 1
+    });
+  }
+  async publish(message, options) {
+    const { endpoint, key, headers = {}, delayMs } = options;
+    const envelope = {
+      id: (0, import_node_crypto.randomUUID)(),
+      type: message.type,
+      payload: message,
+      headers: { ...headers, "x-endpoint": endpoint },
+      timestamp: /* @__PURE__ */ new Date(),
+      partitionKey: key
+    };
+    const messageGroupId = key ?? envelope.id;
+    const delaySeconds = delayMs ? Math.min(Math.floor(delayMs / 1e3), 900) : void 0;
+    await this.client.send(
+      new import_client_sqs.SendMessageCommand({
+        QueueUrl: this.queueUrl,
+        MessageBody: JSON.stringify(envelope),
+        MessageGroupId: messageGroupId,
+        MessageDeduplicationId: envelope.id,
+        DelaySeconds: delaySeconds
+      })
+    );
+  }
+  async pollLoop() {
+    while (this.isRunning) {
+      try {
+        await this.pollMessages();
+      } catch (error) {
+        console.error("[SQS] Poll error:", error);
+        await this.delay(1e3);
+      }
+    }
+  }
+  async pollMessages() {
+    const response = await this.client.send(
+      new import_client_sqs.ReceiveMessageCommand({
+        QueueUrl: this.queueUrl,
+        MaxNumberOfMessages: this.maxMessages,
+        WaitTimeSeconds: this.waitTimeSeconds,
+        VisibilityTimeout: this.visibilityTimeout,
+        AttributeNames: ["All"],
+        MessageAttributeNames: ["All"]
+      })
+    );
+    if (!response.Messages || response.Messages.length === 0) {
+      return;
+    }
+    await Promise.all(
+      response.Messages.map((msg) => this.processMessage(msg))
+    );
+  }
+  async processMessage(sqsMessage) {
+    if (!sqsMessage.Body || !sqsMessage.ReceiptHandle) {
+      return;
+    }
+    try {
+      const parsed = JSON.parse(sqsMessage.Body);
+      const envelope = {
+        ...parsed,
+        timestamp: new Date(parsed.timestamp)
+      };
+      const endpoint = envelope.headers["x-endpoint"];
+      const handler = endpoint ? this.handlers.get(endpoint) : void 0;
+      const actualHandler = handler ?? this.handlers.values().next().value;
+      if (actualHandler) {
+        await actualHandler(envelope);
+      }
+      await this.client.send(
+        new import_client_sqs.DeleteMessageCommand({
+          QueueUrl: this.queueUrl,
+          ReceiptHandle: sqsMessage.ReceiptHandle
+        })
+      );
+    } catch (error) {
+      console.error("[SQS] Message processing error:", error);
+      throw error;
+    }
+  }
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  /**
+   * Check if the transport is running.
+   */
+  isStarted() {
+    return this.isRunning;
+  }
+  /**
+   * Get transport statistics.
+   */
+  getStats() {
+    return {
+      subscriptionCount: this.subscriptions.length,
+      isRunning: this.isRunning
+    };
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SqsTransport
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/SqsTransport.ts"],"sourcesContent":["export { SqsTransport } from \"./SqsTransport.js\";\nexport type { SqsTransportOptions } from \"./types.js\";\n","import { randomUUID } from \"node:crypto\";\nimport {\n  SendMessageCommand,\n  ReceiveMessageCommand,\n  DeleteMessageCommand,\n  type SQSClient,\n  type Message as SqsMessage,\n} from \"@aws-sdk/client-sqs\";\nimport type {\n  Transport,\n  TransportSubscribeOptions,\n  TransportPublishOptions,\n  BaseMessage,\n  MessageEnvelope,\n} from \"@saga-bus/core\";\nimport type { SqsTransportOptions, SqsSubscription } from \"./types.js\";\n\n/**\n * AWS SQS FIFO transport for saga-bus.\n *\n * Uses FIFO queues to guarantee message ordering within message groups.\n * The partition key or correlation ID is used as the message group ID.\n *\n * @example\n * ```typescript\n * import { SQSClient } from \"@aws-sdk/client-sqs\";\n *\n * const client = new SQSClient({ region: \"us-east-1\" });\n * const transport = new SqsTransport({\n *   client,\n *   queueUrl: \"https://sqs.us-east-1.amazonaws.com/123456789/my-queue.fifo\",\n * });\n *\n * await transport.start();\n *\n * await transport.subscribe(\n *   { endpoint: \"OrderSubmitted\", concurrency: 5 },\n *   async (envelope) => { ... }\n * );\n *\n * await transport.publish(\n *   { type: \"OrderSubmitted\", orderId: \"123\" },\n *   { endpoint: \"OrderSubmitted\", key: \"order-123\" }\n * );\n * ```\n */\nexport class SqsTransport implements Transport {\n  private readonly client: SQSClient;\n  private readonly queueUrl: string;\n  private readonly maxMessages: number;\n  private readonly waitTimeSeconds: number;\n  private readonly visibilityTimeout: number;\n  private readonly concurrency: number;\n\n  private readonly handlers = new Map<\n    string,\n    (envelope: MessageEnvelope) => Promise<void>\n  >();\n  private readonly subscriptions: SqsSubscription[] = [];\n  private isRunning = false;\n  private pollLoops: Promise<void>[] = [];\n\n  constructor(options: SqsTransportOptions) {\n    this.client = options.client;\n    this.queueUrl = options.queueUrl;\n    this.maxMessages = options.maxMessages ?? 10;\n    this.waitTimeSeconds = options.waitTimeSeconds ?? 20;\n    this.visibilityTimeout = options.visibilityTimeout ?? 30;\n    this.concurrency = options.concurrency ?? 1;\n\n    if (!this.queueUrl.endsWith(\".fifo\")) {\n      throw new Error(\n        \"SqsTransport requires a FIFO queue (URL must end with .fifo)\"\n      );\n    }\n  }\n\n  async start(): Promise<void> {\n    if (this.isRunning) {\n      return;\n    }\n\n    this.isRunning = true;\n\n    // Start concurrent poll loops\n    for (let i = 0; i < this.concurrency; i++) {\n      this.pollLoops.push(this.pollLoop());\n    }\n  }\n\n  async stop(): Promise<void> {\n    this.isRunning = false;\n    await Promise.all(this.pollLoops);\n    this.pollLoops = [];\n  }\n\n  async subscribe<TMessage extends BaseMessage>(\n    options: TransportSubscribeOptions,\n    handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>\n  ): Promise<void> {\n    const { endpoint } = options;\n\n    // Store handler (SQS uses single queue, filter by endpoint in handler)\n    this.handlers.set(\n      endpoint,\n      handler as (envelope: MessageEnvelope) => Promise<void>\n    );\n\n    this.subscriptions.push({\n      endpoint,\n      concurrency: options.concurrency ?? 1,\n    });\n  }\n\n  async publish<TMessage extends BaseMessage>(\n    message: TMessage,\n    options: TransportPublishOptions\n  ): Promise<void> {\n    const { endpoint, key, headers = {}, delayMs } = options;\n\n    // Create envelope\n    const envelope: MessageEnvelope<TMessage> = {\n      id: randomUUID(),\n      type: message.type,\n      payload: message,\n      headers: { ...headers, \"x-endpoint\": endpoint },\n      timestamp: new Date(),\n      partitionKey: key,\n    };\n\n    // Message group ID for FIFO ordering\n    const messageGroupId = key ?? envelope.id;\n\n    // Calculate delay in seconds (SQS supports 0-900 seconds)\n    const delaySeconds = delayMs ? Math.min(Math.floor(delayMs / 1000), 900) : undefined;\n\n    await this.client.send(\n      new SendMessageCommand({\n        QueueUrl: this.queueUrl,\n        MessageBody: JSON.stringify(envelope),\n        MessageGroupId: messageGroupId,\n        MessageDeduplicationId: envelope.id,\n        DelaySeconds: delaySeconds,\n      })\n    );\n  }\n\n  private async pollLoop(): Promise<void> {\n    while (this.isRunning) {\n      try {\n        await this.pollMessages();\n      } catch (error) {\n        // Log error but continue polling\n        console.error(\"[SQS] Poll error:\", error);\n        await this.delay(1000);\n      }\n    }\n  }\n\n  private async pollMessages(): Promise<void> {\n    const response = await this.client.send(\n      new ReceiveMessageCommand({\n        QueueUrl: this.queueUrl,\n        MaxNumberOfMessages: this.maxMessages,\n        WaitTimeSeconds: this.waitTimeSeconds,\n        VisibilityTimeout: this.visibilityTimeout,\n        AttributeNames: [\"All\"],\n        MessageAttributeNames: [\"All\"],\n      })\n    );\n\n    if (!response.Messages || response.Messages.length === 0) {\n      return;\n    }\n\n    await Promise.all(\n      response.Messages.map((msg) => this.processMessage(msg))\n    );\n  }\n\n  private async processMessage(sqsMessage: SqsMessage): Promise<void> {\n    if (!sqsMessage.Body || !sqsMessage.ReceiptHandle) {\n      return;\n    }\n\n    try {\n      // Parse envelope\n      const parsed = JSON.parse(sqsMessage.Body) as MessageEnvelope;\n\n      // Reconstruct Date objects\n      const envelope: MessageEnvelope = {\n        ...parsed,\n        timestamp: new Date(parsed.timestamp),\n      };\n\n      // Get endpoint from headers\n      const endpoint = envelope.headers[\"x-endpoint\"];\n\n      // Find handler for this endpoint\n      const handler = endpoint ? this.handlers.get(endpoint) : undefined;\n\n      // If no specific handler, try to find any handler (for simple cases)\n      const actualHandler = handler ?? this.handlers.values().next().value;\n\n      if (actualHandler) {\n        await actualHandler(envelope);\n      }\n\n      // Delete message on successful processing\n      await this.client.send(\n        new DeleteMessageCommand({\n          QueueUrl: this.queueUrl,\n          ReceiptHandle: sqsMessage.ReceiptHandle,\n        })\n      );\n    } catch (error) {\n      // Message will return to queue after visibility timeout\n      console.error(\"[SQS] Message processing error:\", error);\n      throw error;\n    }\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  /**\n   * Check if the transport is running.\n   */\n  isStarted(): boolean {\n    return this.isRunning;\n  }\n\n  /**\n   * Get transport statistics.\n   */\n  getStats(): { subscriptionCount: number; isRunning: boolean } {\n    return {\n      subscriptionCount: this.subscriptions.length,\n      isRunning: this.isRunning,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,101 @@
+import { Transport, BaseMessage, TransportSubscribeOptions, MessageEnvelope, TransportPublishOptions } from '@saga-bus/core';
+import { SQSClient } from '@aws-sdk/client-sqs';
+
+/**
+ * SQS transport configuration options.
+ */
+interface SqsTransportOptions {
+    /**
+     * AWS SQS client instance.
+     */
+    client: SQSClient;
+    /**
+     * SQS FIFO queue URL.
+     * Must end with `.fifo`.
+     */
+    queueUrl: string;
+    /**
+     * Maximum number of messages to receive per poll.
+     * @default 10
+     */
+    maxMessages?: number;
+    /**
+     * Long polling wait time in seconds.
+     * @default 20
+     */
+    waitTimeSeconds?: number;
+    /**
+     * Visibility timeout in seconds.
+     * @default 30
+     */
+    visibilityTimeout?: number;
+    /**
+     * Number of concurrent poll loops.
+     * @default 1
+     */
+    concurrency?: number;
+}
+
+/**
+ * AWS SQS FIFO transport for saga-bus.
+ *
+ * Uses FIFO queues to guarantee message ordering within message groups.
+ * The partition key or correlation ID is used as the message group ID.
+ *
+ * @example
+ * ```typescript
+ * import { SQSClient } from "@aws-sdk/client-sqs";
+ *
+ * const client = new SQSClient({ region: "us-east-1" });
+ * const transport = new SqsTransport({
+ *   client,
+ *   queueUrl: "https://sqs.us-east-1.amazonaws.com/123456789/my-queue.fifo",
+ * });
+ *
+ * await transport.start();
+ *
+ * await transport.subscribe(
+ *   { endpoint: "OrderSubmitted", concurrency: 5 },
+ *   async (envelope) => { ... }
+ * );
+ *
+ * await transport.publish(
+ *   { type: "OrderSubmitted", orderId: "123" },
+ *   { endpoint: "OrderSubmitted", key: "order-123" }
+ * );
+ * ```
+ */
+declare class SqsTransport implements Transport {
+    private readonly client;
+    private readonly queueUrl;
+    private readonly maxMessages;
+    private readonly waitTimeSeconds;
+    private readonly visibilityTimeout;
+    private readonly concurrency;
+    private readonly handlers;
+    private readonly subscriptions;
+    private isRunning;
+    private pollLoops;
+    constructor(options: SqsTransportOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    subscribe<TMessage extends BaseMessage>(options: TransportSubscribeOptions, handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>): Promise<void>;
+    publish<TMessage extends BaseMessage>(message: TMessage, options: TransportPublishOptions): Promise<void>;
+    private pollLoop;
+    private pollMessages;
+    private processMessage;
+    private delay;
+    /**
+     * Check if the transport is running.
+     */
+    isStarted(): boolean;
+    /**
+     * Get transport statistics.
+     */
+    getStats(): {
+        subscriptionCount: number;
+        isRunning: boolean;
+    };
+}
+
+export { SqsTransport, type SqsTransportOptions };

package/dist/index.d.ts

@@ -0,0 +1,101 @@
+import { Transport, BaseMessage, TransportSubscribeOptions, MessageEnvelope, TransportPublishOptions } from '@saga-bus/core';
+import { SQSClient } from '@aws-sdk/client-sqs';
+
+/**
+ * SQS transport configuration options.
+ */
+interface SqsTransportOptions {
+    /**
+     * AWS SQS client instance.
+     */
+    client: SQSClient;
+    /**
+     * SQS FIFO queue URL.
+     * Must end with `.fifo`.
+     */
+    queueUrl: string;
+    /**
+     * Maximum number of messages to receive per poll.
+     * @default 10
+     */
+    maxMessages?: number;
+    /**
+     * Long polling wait time in seconds.
+     * @default 20
+     */
+    waitTimeSeconds?: number;
+    /**
+     * Visibility timeout in seconds.
+     * @default 30
+     */
+    visibilityTimeout?: number;
+    /**
+     * Number of concurrent poll loops.
+     * @default 1
+     */
+    concurrency?: number;
+}
+
+/**
+ * AWS SQS FIFO transport for saga-bus.
+ *
+ * Uses FIFO queues to guarantee message ordering within message groups.
+ * The partition key or correlation ID is used as the message group ID.
+ *
+ * @example
+ * ```typescript
+ * import { SQSClient } from "@aws-sdk/client-sqs";
+ *
+ * const client = new SQSClient({ region: "us-east-1" });
+ * const transport = new SqsTransport({
+ *   client,
+ *   queueUrl: "https://sqs.us-east-1.amazonaws.com/123456789/my-queue.fifo",
+ * });
+ *
+ * await transport.start();
+ *
+ * await transport.subscribe(
+ *   { endpoint: "OrderSubmitted", concurrency: 5 },
+ *   async (envelope) => { ... }
+ * );
+ *
+ * await transport.publish(
+ *   { type: "OrderSubmitted", orderId: "123" },
+ *   { endpoint: "OrderSubmitted", key: "order-123" }
+ * );
+ * ```
+ */
+declare class SqsTransport implements Transport {
+    private readonly client;
+    private readonly queueUrl;
+    private readonly maxMessages;
+    private readonly waitTimeSeconds;
+    private readonly visibilityTimeout;
+    private readonly concurrency;
+    private readonly handlers;
+    private readonly subscriptions;
+    private isRunning;
+    private pollLoops;
+    constructor(options: SqsTransportOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    subscribe<TMessage extends BaseMessage>(options: TransportSubscribeOptions, handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>): Promise<void>;
+    publish<TMessage extends BaseMessage>(message: TMessage, options: TransportPublishOptions): Promise<void>;
+    private pollLoop;
+    private pollMessages;
+    private processMessage;
+    private delay;
+    /**
+     * Check if the transport is running.
+     */
+    isStarted(): boolean;
+    /**
+     * Get transport statistics.
+     */
+    getStats(): {
+        subscriptionCount: number;
+        isRunning: boolean;
+    };
+}
+
+export { SqsTransport, type SqsTransportOptions };

package/dist/index.js

@@ -0,0 +1,156 @@
+// src/SqsTransport.ts
+import { randomUUID } from "crypto";
+import {
+  SendMessageCommand,
+  ReceiveMessageCommand,
+  DeleteMessageCommand
+} from "@aws-sdk/client-sqs";
+var SqsTransport = class {
+  client;
+  queueUrl;
+  maxMessages;
+  waitTimeSeconds;
+  visibilityTimeout;
+  concurrency;
+  handlers = /* @__PURE__ */ new Map();
+  subscriptions = [];
+  isRunning = false;
+  pollLoops = [];
+  constructor(options) {
+    this.client = options.client;
+    this.queueUrl = options.queueUrl;
+    this.maxMessages = options.maxMessages ?? 10;
+    this.waitTimeSeconds = options.waitTimeSeconds ?? 20;
+    this.visibilityTimeout = options.visibilityTimeout ?? 30;
+    this.concurrency = options.concurrency ?? 1;
+    if (!this.queueUrl.endsWith(".fifo")) {
+      throw new Error(
+        "SqsTransport requires a FIFO queue (URL must end with .fifo)"
+      );
+    }
+  }
+  async start() {
+    if (this.isRunning) {
+      return;
+    }
+    this.isRunning = true;
+    for (let i = 0; i < this.concurrency; i++) {
+      this.pollLoops.push(this.pollLoop());
+    }
+  }
+  async stop() {
+    this.isRunning = false;
+    await Promise.all(this.pollLoops);
+    this.pollLoops = [];
+  }
+  async subscribe(options, handler) {
+    const { endpoint } = options;
+    this.handlers.set(
+      endpoint,
+      handler
+    );
+    this.subscriptions.push({
+      endpoint,
+      concurrency: options.concurrency ?? 1
+    });
+  }
+  async publish(message, options) {
+    const { endpoint, key, headers = {}, delayMs } = options;
+    const envelope = {
+      id: randomUUID(),
+      type: message.type,
+      payload: message,
+      headers: { ...headers, "x-endpoint": endpoint },
+      timestamp: /* @__PURE__ */ new Date(),
+      partitionKey: key
+    };
+    const messageGroupId = key ?? envelope.id;
+    const delaySeconds = delayMs ? Math.min(Math.floor(delayMs / 1e3), 900) : void 0;
+    await this.client.send(
+      new SendMessageCommand({
+        QueueUrl: this.queueUrl,
+        MessageBody: JSON.stringify(envelope),
+        MessageGroupId: messageGroupId,
+        MessageDeduplicationId: envelope.id,
+        DelaySeconds: delaySeconds
+      })
+    );
+  }
+  async pollLoop() {
+    while (this.isRunning) {
+      try {
+        await this.pollMessages();
+      } catch (error) {
+        console.error("[SQS] Poll error:", error);
+        await this.delay(1e3);
+      }
+    }
+  }
+  async pollMessages() {
+    const response = await this.client.send(
+      new ReceiveMessageCommand({
+        QueueUrl: this.queueUrl,
+        MaxNumberOfMessages: this.maxMessages,
+        WaitTimeSeconds: this.waitTimeSeconds,
+        VisibilityTimeout: this.visibilityTimeout,
+        AttributeNames: ["All"],
+        MessageAttributeNames: ["All"]
+      })
+    );
+    if (!response.Messages || response.Messages.length === 0) {
+      return;
+    }
+    await Promise.all(
+      response.Messages.map((msg) => this.processMessage(msg))
+    );
+  }
+  async processMessage(sqsMessage) {
+    if (!sqsMessage.Body || !sqsMessage.ReceiptHandle) {
+      return;
+    }
+    try {
+      const parsed = JSON.parse(sqsMessage.Body);
+      const envelope = {
+        ...parsed,
+        timestamp: new Date(parsed.timestamp)
+      };
+      const endpoint = envelope.headers["x-endpoint"];
+      const handler = endpoint ? this.handlers.get(endpoint) : void 0;
+      const actualHandler = handler ?? this.handlers.values().next().value;
+      if (actualHandler) {
+        await actualHandler(envelope);
+      }
+      await this.client.send(
+        new DeleteMessageCommand({
+          QueueUrl: this.queueUrl,
+          ReceiptHandle: sqsMessage.ReceiptHandle
+        })
+      );
+    } catch (error) {
+      console.error("[SQS] Message processing error:", error);
+      throw error;
+    }
+  }
+  delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  /**
+   * Check if the transport is running.
+   */
+  isStarted() {
+    return this.isRunning;
+  }
+  /**
+   * Get transport statistics.
+   */
+  getStats() {
+    return {
+      subscriptionCount: this.subscriptions.length,
+      isRunning: this.isRunning
+    };
+  }
+};
+export {
+  SqsTransport
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/SqsTransport.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport {\n  SendMessageCommand,\n  ReceiveMessageCommand,\n  DeleteMessageCommand,\n  type SQSClient,\n  type Message as SqsMessage,\n} from \"@aws-sdk/client-sqs\";\nimport type {\n  Transport,\n  TransportSubscribeOptions,\n  TransportPublishOptions,\n  BaseMessage,\n  MessageEnvelope,\n} from \"@saga-bus/core\";\nimport type { SqsTransportOptions, SqsSubscription } from \"./types.js\";\n\n/**\n * AWS SQS FIFO transport for saga-bus.\n *\n * Uses FIFO queues to guarantee message ordering within message groups.\n * The partition key or correlation ID is used as the message group ID.\n *\n * @example\n * ```typescript\n * import { SQSClient } from \"@aws-sdk/client-sqs\";\n *\n * const client = new SQSClient({ region: \"us-east-1\" });\n * const transport = new SqsTransport({\n *   client,\n *   queueUrl: \"https://sqs.us-east-1.amazonaws.com/123456789/my-queue.fifo\",\n * });\n *\n * await transport.start();\n *\n * await transport.subscribe(\n *   { endpoint: \"OrderSubmitted\", concurrency: 5 },\n *   async (envelope) => { ... }\n * );\n *\n * await transport.publish(\n *   { type: \"OrderSubmitted\", orderId: \"123\" },\n *   { endpoint: \"OrderSubmitted\", key: \"order-123\" }\n * );\n * ```\n */\nexport class SqsTransport implements Transport {\n  private readonly client: SQSClient;\n  private readonly queueUrl: string;\n  private readonly maxMessages: number;\n  private readonly waitTimeSeconds: number;\n  private readonly visibilityTimeout: number;\n  private readonly concurrency: number;\n\n  private readonly handlers = new Map<\n    string,\n    (envelope: MessageEnvelope) => Promise<void>\n  >();\n  private readonly subscriptions: SqsSubscription[] = [];\n  private isRunning = false;\n  private pollLoops: Promise<void>[] = [];\n\n  constructor(options: SqsTransportOptions) {\n    this.client = options.client;\n    this.queueUrl = options.queueUrl;\n    this.maxMessages = options.maxMessages ?? 10;\n    this.waitTimeSeconds = options.waitTimeSeconds ?? 20;\n    this.visibilityTimeout = options.visibilityTimeout ?? 30;\n    this.concurrency = options.concurrency ?? 1;\n\n    if (!this.queueUrl.endsWith(\".fifo\")) {\n      throw new Error(\n        \"SqsTransport requires a FIFO queue (URL must end with .fifo)\"\n      );\n    }\n  }\n\n  async start(): Promise<void> {\n    if (this.isRunning) {\n      return;\n    }\n\n    this.isRunning = true;\n\n    // Start concurrent poll loops\n    for (let i = 0; i < this.concurrency; i++) {\n      this.pollLoops.push(this.pollLoop());\n    }\n  }\n\n  async stop(): Promise<void> {\n    this.isRunning = false;\n    await Promise.all(this.pollLoops);\n    this.pollLoops = [];\n  }\n\n  async subscribe<TMessage extends BaseMessage>(\n    options: TransportSubscribeOptions,\n    handler: (envelope: MessageEnvelope<TMessage>) => Promise<void>\n  ): Promise<void> {\n    const { endpoint } = options;\n\n    // Store handler (SQS uses single queue, filter by endpoint in handler)\n    this.handlers.set(\n      endpoint,\n      handler as (envelope: MessageEnvelope) => Promise<void>\n    );\n\n    this.subscriptions.push({\n      endpoint,\n      concurrency: options.concurrency ?? 1,\n    });\n  }\n\n  async publish<TMessage extends BaseMessage>(\n    message: TMessage,\n    options: TransportPublishOptions\n  ): Promise<void> {\n    const { endpoint, key, headers = {}, delayMs } = options;\n\n    // Create envelope\n    const envelope: MessageEnvelope<TMessage> = {\n      id: randomUUID(),\n      type: message.type,\n      payload: message,\n      headers: { ...headers, \"x-endpoint\": endpoint },\n      timestamp: new Date(),\n      partitionKey: key,\n    };\n\n    // Message group ID for FIFO ordering\n    const messageGroupId = key ?? envelope.id;\n\n    // Calculate delay in seconds (SQS supports 0-900 seconds)\n    const delaySeconds = delayMs ? Math.min(Math.floor(delayMs / 1000), 900) : undefined;\n\n    await this.client.send(\n      new SendMessageCommand({\n        QueueUrl: this.queueUrl,\n        MessageBody: JSON.stringify(envelope),\n        MessageGroupId: messageGroupId,\n        MessageDeduplicationId: envelope.id,\n        DelaySeconds: delaySeconds,\n      })\n    );\n  }\n\n  private async pollLoop(): Promise<void> {\n    while (this.isRunning) {\n      try {\n        await this.pollMessages();\n      } catch (error) {\n        // Log error but continue polling\n        console.error(\"[SQS] Poll error:\", error);\n        await this.delay(1000);\n      }\n    }\n  }\n\n  private async pollMessages(): Promise<void> {\n    const response = await this.client.send(\n      new ReceiveMessageCommand({\n        QueueUrl: this.queueUrl,\n        MaxNumberOfMessages: this.maxMessages,\n        WaitTimeSeconds: this.waitTimeSeconds,\n        VisibilityTimeout: this.visibilityTimeout,\n        AttributeNames: [\"All\"],\n        MessageAttributeNames: [\"All\"],\n      })\n    );\n\n    if (!response.Messages || response.Messages.length === 0) {\n      return;\n    }\n\n    await Promise.all(\n      response.Messages.map((msg) => this.processMessage(msg))\n    );\n  }\n\n  private async processMessage(sqsMessage: SqsMessage): Promise<void> {\n    if (!sqsMessage.Body || !sqsMessage.ReceiptHandle) {\n      return;\n    }\n\n    try {\n      // Parse envelope\n      const parsed = JSON.parse(sqsMessage.Body) as MessageEnvelope;\n\n      // Reconstruct Date objects\n      const envelope: MessageEnvelope = {\n        ...parsed,\n        timestamp: new Date(parsed.timestamp),\n      };\n\n      // Get endpoint from headers\n      const endpoint = envelope.headers[\"x-endpoint\"];\n\n      // Find handler for this endpoint\n      const handler = endpoint ? this.handlers.get(endpoint) : undefined;\n\n      // If no specific handler, try to find any handler (for simple cases)\n      const actualHandler = handler ?? this.handlers.values().next().value;\n\n      if (actualHandler) {\n        await actualHandler(envelope);\n      }\n\n      // Delete message on successful processing\n      await this.client.send(\n        new DeleteMessageCommand({\n          QueueUrl: this.queueUrl,\n          ReceiptHandle: sqsMessage.ReceiptHandle,\n        })\n      );\n    } catch (error) {\n      // Message will return to queue after visibility timeout\n      console.error(\"[SQS] Message processing error:\", error);\n      throw error;\n    }\n  }\n\n  private delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n\n  /**\n   * Check if the transport is running.\n   */\n  isStarted(): boolean {\n    return this.isRunning;\n  }\n\n  /**\n   * Get transport statistics.\n   */\n  getStats(): { subscriptionCount: number; isRunning: boolean } {\n    return {\n      subscriptionCount: this.subscriptions.length,\n      isRunning: this.isRunning,\n    };\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@saga-bus/transport-sqs",
+  "version": "0.1.2",
+  "description": "AWS SQS transport for saga-bus",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/d-e-a-n-f/saga-bus.git",
+    "directory": "packages/transport-sqs"
+  },
+  "keywords": [
+    "saga",
+    "message-bus",
+    "transport",
+    "sqs",
+    "aws",
+    "fifo"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@saga-bus/core": "workspace:*",
+    "@aws-sdk/client-sqs": "^3.600.0"
+  },
+  "devDependencies": {
+    "@repo/eslint-config": "workspace:*",
+    "@repo/typescript-config": "workspace:*",
+    "@testcontainers/localstack": "^10.0.0",
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.0.0"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-sqs": ">=3.0.0"
+  }
+}