@workflow-stack/sqs 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rahul Radhakrishnan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,378 @@
+# @workflow-stack/sqs
+
+AWS SQS plugin for @workflow-stack/core - SQS message publishing orchestration using AWS SDK v3.
+
+## Installation
+
+```bash
+npm install @workflow-stack/core @workflow-stack/sqs
+```
+
+## Quick Start
+
+```javascript
+import { runOrchestration, registerPlugin } from '@workflow-stack/core';
+import { sqsPlugin } from '@workflow-stack/sqs';
+
+// Register the SQS plugin
+registerPlugin(sqsPlugin);
+
+const services = [
+  {
+    id: 'sendMessage',
+    service: {
+      type: 'sqs',
+      queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+      region: 'us-east-1',
+      message: {
+        body: { userId: '{request.body.userId}', event: 'signup' }
+      }
+    }
+  }
+];
+
+const result = await runOrchestration(services, {
+  request: { body: { userId: '123' } }
+});
+```
+
+## SQS Service Configuration
+
+```typescript
+interface SqsServiceConfig {
+  type: 'sqs';
+  queueUrl: string;
+  region: string;
+  credentials?: SqsAccessKeyCredentials | SqsAssumeRoleCredentials;
+  message: {
+    body: any;
+    messageGroupId?: string;
+    messageDeduplicationId?: string;
+    delaySeconds?: number;
+    messageAttributes?: Record<string, SqsMessageAttribute>;
+  };
+  retry?: {
+    maxAttempts?: number;
+    retryMode?: 'standard' | 'adaptive';
+  };
+  async?: boolean;
+  fallback?: {
+    status?: number | null;
+    data: any;
+  };
+  errorStrategy?: 'silent' | 'throw';
+}
+```
+
+## Authentication
+
+### Using Access Key Credentials
+
+```javascript
+{
+  id: 'sendMessage',
+  service: {
+    type: 'sqs',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+    region: 'us-east-1',
+    credentials: {
+      type: 'accessKey',
+      accessKeyId: '{env.AWS_ACCESS_KEY_ID}',
+      secretAccessKey: '{env.AWS_SECRET_ACCESS_KEY}',
+      sessionToken: '{env.AWS_SESSION_TOKEN}' // optional
+    },
+    message: {
+      body: 'Hello World'
+    }
+  }
+}
+```
+
+### Using Assume Role
+
+```javascript
+{
+  id: 'sendMessage',
+  service: {
+    type: 'sqs',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+    region: 'us-east-1',
+    credentials: {
+      type: 'assumeRole',
+      roleArn: 'arn:aws:iam::123456789012:role/SQSPublisherRole',
+      roleSessionName: 'flow-stack-session', // optional
+      externalId: 'external-id', // optional
+      durationSeconds: 3600 // optional
+    },
+    message: {
+      body: 'Hello World'
+    }
+  }
+}
+```
+
+### Using Default Credential Chain
+
+If no credentials are specified, the AWS SDK default credential chain is used (environment variables, shared credentials file, EC2 instance profile, etc.).
+
+```javascript
+{
+  id: 'sendMessage',
+  service: {
+    type: 'sqs',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+    region: 'us-east-1',
+    message: {
+      body: 'Hello World'
+    }
+  }
+}
+```
+
+## Examples
+
+### Basic Message
+
+```javascript
+{
+  id: 'notify',
+  service: {
+    type: 'sqs',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/notifications',
+    region: 'us-east-1',
+    message: {
+      body: {
+        userId: '{request.body.userId}',
+        action: 'user_created',
+        timestamp: '{request.body.timestamp}'
+      }
+    }
+  }
+}
+```
+
+### FIFO Queue
+
+```javascript
+{
+  id: 'orderEvent',
+  service: {
+    type: 'sqs',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/orders.fifo',
+    region: 'us-east-1',
+    message: {
+      body: { orderId: '{request.body.orderId}', status: 'placed' },
+      messageGroupId: '{request.body.orderId}',
+      messageDeduplicationId: '{request.body.eventId}'
+    }
+  }
+}
+```
+
+### Delayed Message
+
+```javascript
+{
+  id: 'scheduledTask',
+  service: {
+    type: 'sqs',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/tasks',
+    region: 'us-east-1',
+    message: {
+      body: { task: 'send_reminder', userId: '123' },
+      delaySeconds: 300 // 5 minutes delay
+    }
+  }
+}
+```
+
+### Message with Attributes
+
+```javascript
+{
+  id: 'eventWithMetadata',
+  service: {
+    type: 'sqs',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/events',
+    region: 'us-east-1',
+    message: {
+      body: { event: 'user_signup' },
+      messageAttributes: {
+        correlationId: {
+          DataType: 'String',
+          StringValue: '{request.headers.x-correlation-id}'
+        },
+        priority: {
+          DataType: 'Number',
+          StringValue: '1'
+        }
+      }
+    }
+  }
+}
+```
+
+### With Retry Configuration
+
+```javascript
+{
+  id: 'reliableMessage',
+  service: {
+    type: 'sqs',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/critical',
+    region: 'us-east-1',
+    message: {
+      body: { event: 'payment_processed' }
+    },
+    retry: {
+      maxAttempts: 5,
+      retryMode: 'adaptive'
+    }
+  }
+}
+```
+
+### Async (Fire-and-Forget) Mode
+
+```javascript
+{
+  id: 'asyncNotification',
+  service: {
+    type: 'sqs',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/notifications',
+    region: 'us-east-1',
+    message: {
+      body: { event: 'page_viewed' }
+    },
+    async: true // Returns immediately without waiting for SQS response
+  }
+}
+```
+
+### With Fallback
+
+```javascript
+{
+  id: 'messageWithFallback',
+  service: {
+    type: 'sqs',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+    region: 'us-east-1',
+    message: {
+      body: { event: 'user_action' }
+    },
+    fallback: {
+      status: 200,
+      data: { queued: false, reason: 'SQS unavailable' }
+    }
+  }
+}
+```
+
+### Using Dependencies
+
+```javascript
+const services = [
+  {
+    id: 'createOrder',
+    service: {
+      type: 'rest',
+      url: 'https://api.example.com/orders',
+      method: 'POST',
+      body: { items: '{request.body.items}' }
+    }
+  },
+  {
+    id: 'notifyWarehouse',
+    dependsOn: ['createOrder'],
+    service: {
+      type: 'sqs',
+      queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/warehouse',
+      region: 'us-east-1',
+      message: {
+        body: {
+          orderId: '{createOrder.body.id}',
+          action: 'prepare_shipment'
+        }
+      }
+    }
+  }
+];
+```
+
+## Sync vs Async Mode
+
+| Mode | `async` | Behavior | Response |
+|------|---------|----------|----------|
+| Sync (default) | `false` or omitted | Waits for SQS response | `{ status: 200, body: { messageId, sequenceNumber? } }` |
+| Async | `true` | Returns immediately | `{ status: 202, body: { message: 'Message queued for delivery', async: true } }` |
+
+## Response Structure
+
+### Successful Response (Sync)
+
+```typescript
+{
+  status: 200,
+  body: {
+    messageId: 'abc123-def456-...',
+    sequenceNumber: '12345...' // Only for FIFO queues
+  },
+  metadata: {
+    executionStatus: 'executed',
+    serviceType: 'sqs'
+  }
+}
+```
+
+### Successful Response (Async)
+
+```typescript
+{
+  status: 202,
+  body: {
+    message: 'Message queued for delivery',
+    async: true
+  },
+  metadata: {
+    executionStatus: 'executed',
+    serviceType: 'sqs'
+  }
+}
+```
+
+### Error Response
+
+```typescript
+{
+  status: null,
+  body: null,
+  error: {
+    message: 'Access Denied',
+    code: 'AccessDeniedException'
+  },
+  metadata: {
+    executionStatus: 'failed',
+    serviceType: 'sqs'
+  }
+}
+```
+
+## TypeScript Support
+
+```typescript
+import type {
+  SqsServiceConfig,
+  SqsCredentials,
+  SqsAccessKeyCredentials,
+  SqsAssumeRoleCredentials,
+  SqsRetryConfig,
+  SqsMessageAttribute
+} from '@workflow-stack/sqs';
+
+import { sqsPlugin, executeSqsService } from '@workflow-stack/sqs';
+```
+
+## License
+
+MIT

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export { sqsPlugin } from './plugin.js';
+export { executeSqsService } from './sqs-executor.js';
+export type { SqsServiceConfig, SqsCredentials, SqsAccessKeyCredentials, SqsAssumeRoleCredentials, SqsRetryConfig, SqsMessageAttribute, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,3 @@
+export { sqsPlugin } from './plugin.js';
+export { executeSqsService } from './sqs-executor.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/plugin.d.ts

@@ -0,0 +1,4 @@
+import type { FlowStackPlugin } from '@workflow-stack/core';
+import type { SqsServiceConfig } from './types.js';
+export declare const sqsPlugin: FlowStackPlugin<SqsServiceConfig>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/src/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAOnD,eAAO,MAAM,SAAS,EAAE,eAAe,CAAC,gBAAgB,CAMvD,CAAC"}

package/dist/src/plugin.js

@@ -0,0 +1,9 @@
+import { executeSqsService } from './sqs-executor.js';
+export const sqsPlugin = {
+    type: 'sqs',
+    name: '@workflow-stack/sqs',
+    version: '1.0.0',
+    execute: executeSqsService,
+    interpolate: true,
+};
+//# sourceMappingURL=plugin.js.map

package/dist/src/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAMtD,MAAM,CAAC,MAAM,SAAS,GAAsC;IAC1D,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,iBAAiB;IAC1B,WAAW,EAAE,IAAI;CAClB,CAAC"}

package/dist/src/sqs-executor.d.ts

@@ -0,0 +1,4 @@
+import type { ServiceResult, OrchestrationContext } from '@workflow-stack/core';
+import type { SqsServiceConfig } from './types.js';
+export declare function executeSqsService(config: SqsServiceConfig, context: OrchestrationContext, serviceId: string): Promise<ServiceResult>;
+//# sourceMappingURL=sqs-executor.d.ts.map

package/dist/src/sqs-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqs-executor.d.ts","sourceRoot":"","sources":["../../src/sqs-executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,KAAK,EAAE,gBAAgB,EAA4B,MAAM,YAAY,CAAC;AAsE7E,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,oBAAoB,EAC7B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAoFxB"}

package/dist/src/sqs-executor.js

@@ -0,0 +1,123 @@
+import { SQSClient, SendMessageCommand } from '@aws-sdk/client-sqs';
+import { fromTemporaryCredentials } from '@aws-sdk/credential-providers';
+import { emitServiceStart, emitServiceComplete, emitServiceError } from '@workflow-stack/core';
+function createSqsClient(config) {
+    const clientConfig = {
+        region: config.region,
+    };
+    if (config.retry) {
+        clientConfig.maxAttempts = config.retry.maxAttempts;
+        clientConfig.retryMode = config.retry.retryMode;
+    }
+    if (config.credentials) {
+        if (config.credentials.type === 'accessKey') {
+            clientConfig.credentials = {
+                accessKeyId: config.credentials.accessKeyId,
+                secretAccessKey: config.credentials.secretAccessKey,
+                sessionToken: config.credentials.sessionToken,
+            };
+        }
+        else if (config.credentials.type === 'assumeRole') {
+            const roleConfig = config.credentials;
+            clientConfig.credentials = fromTemporaryCredentials({
+                params: {
+                    RoleArn: roleConfig.roleArn,
+                    RoleSessionName: roleConfig.roleSessionName || 'flow-stack-sqs-session',
+                    ExternalId: roleConfig.externalId,
+                    DurationSeconds: roleConfig.durationSeconds,
+                },
+            });
+        }
+    }
+    return new SQSClient(clientConfig);
+}
+async function sendMessage(client, config) {
+    const messageBody = typeof config.message.body === 'string'
+        ? config.message.body
+        : JSON.stringify(config.message.body);
+    const command = new SendMessageCommand({
+        QueueUrl: config.queueUrl,
+        MessageBody: messageBody,
+        MessageGroupId: config.message.messageGroupId,
+        MessageDeduplicationId: config.message.messageDeduplicationId,
+        DelaySeconds: config.message.delaySeconds,
+        MessageAttributes: config.message.messageAttributes,
+    });
+    const response = await client.send(command);
+    return {
+        messageId: response.MessageId,
+        sequenceNumber: response.SequenceNumber,
+    };
+}
+export async function executeSqsService(config, context, serviceId) {
+    const startTime = Date.now();
+    emitServiceStart(serviceId, 'sqs', config, context);
+    const client = createSqsClient(config);
+    try {
+        const isAsync = config.async === true;
+        if (isAsync) {
+            sendMessage(client, config).catch((error) => {
+                const processingTime = Date.now() - startTime;
+                emitServiceError(serviceId, 'sqs', config, context, processingTime, error);
+            });
+            const processingTime = Date.now() - startTime;
+            emitServiceComplete(serviceId, 'sqs', config, context, processingTime, 202);
+            return {
+                status: 202,
+                body: {
+                    message: 'Message queued for delivery',
+                    async: true,
+                },
+                metadata: {
+                    executionStatus: 'executed',
+                    serviceType: 'sqs',
+                },
+            };
+        }
+        const result = await sendMessage(client, config);
+        const processingTime = Date.now() - startTime;
+        emitServiceComplete(serviceId, 'sqs', config, context, processingTime, 200);
+        return {
+            status: 200,
+            body: {
+                messageId: result.messageId,
+                sequenceNumber: result.sequenceNumber,
+            },
+            metadata: {
+                executionStatus: 'executed',
+                serviceType: 'sqs',
+            },
+        };
+    }
+    catch (error) {
+        const processingTime = Date.now() - startTime;
+        emitServiceError(serviceId, 'sqs', config, context, processingTime, error);
+        if (config.fallback) {
+            return {
+                status: config.fallback.status || null,
+                body: config.fallback.data,
+                metadata: {
+                    executionStatus: 'failed',
+                    fallbackUsed: true,
+                    serviceType: 'sqs',
+                },
+            };
+        }
+        return {
+            status: null,
+            body: null,
+            error: {
+                message: error.message,
+                code: error.code || error.name,
+            },
+            metadata: {
+                executionStatus: 'failed',
+                serviceType: 'sqs',
+            },
+        };
+    }
+    finally {
+        client.destroy();
+    }
+}
+//# sourceMappingURL=sqs-executor.js.map

package/dist/src/sqs-executor.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,40 @@
+import type { BaseServiceConfig } from '@workflow-stack/core';
+export interface SqsAccessKeyCredentials {
+    type: 'accessKey';
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken?: string;
+}
+export interface SqsAssumeRoleCredentials {
+    type: 'assumeRole';
+    roleArn: string;
+    roleSessionName?: string;
+    externalId?: string;
+    durationSeconds?: number;
+}
+export type SqsCredentials = SqsAccessKeyCredentials | SqsAssumeRoleCredentials;
+export interface SqsRetryConfig {
+    maxAttempts?: number;
+    retryMode?: 'standard' | 'adaptive';
+}
+export interface SqsMessageAttribute {
+    DataType: 'String' | 'Number' | 'Binary';
+    StringValue?: string;
+    BinaryValue?: Uint8Array;
+}
+export interface SqsServiceConfig extends BaseServiceConfig {
+    type: 'sqs';
+    queueUrl: string;
+    region: string;
+    credentials?: SqsCredentials;
+    message: {
+        body: any;
+        messageGroupId?: string;
+        messageDeduplicationId?: string;
+        delaySeconds?: number;
+        messageAttributes?: Record<string, SqsMessageAttribute>;
+    };
+    retry?: SqsRetryConfig;
+    async?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAK9D,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,MAAM,MAAM,cAAc,GAAG,uBAAuB,GAAG,wBAAwB,CAAC;AAKhF,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CACrC;AAKD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAKD,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IACzD,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,OAAO,EAAE;QACP,IAAI,EAAE,GAAG,CAAC;QACV,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,sBAAsB,CAAC,EAAE,MAAM,CAAC;QAChC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;KACzD,CAAC;IACF,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/src/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":""}

package/dist/tests/sqs-executor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sqs-executor.test.d.ts.map

package/dist/tests/sqs-executor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqs-executor.test.d.ts","sourceRoot":"","sources":["../../tests/sqs-executor.test.ts"],"names":[],"mappings":""}

package/dist/tests/sqs-executor.test.js

@@ -0,0 +1,205 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+import { sqsPlugin } from '../src/plugin.js';
+describe('SQS Plugin', () => {
+    describe('Plugin definition', () => {
+        it('should have correct type identifier', () => {
+            assert.strictEqual(sqsPlugin.type, 'sqs');
+        });
+        it('should have correct name', () => {
+            assert.strictEqual(sqsPlugin.name, '@workflow-stack/sqs');
+        });
+        it('should have interpolation enabled', () => {
+            assert.strictEqual(sqsPlugin.interpolate, true);
+        });
+        it('should have an execute function', () => {
+            assert.strictEqual(typeof sqsPlugin.execute, 'function');
+        });
+    });
+});
+describe('SQS Types', () => {
+    describe('SqsServiceConfig', () => {
+        it('should accept valid access key credentials config', () => {
+            const config = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                credentials: {
+                    type: 'accessKey',
+                    accessKeyId: 'AKIAIOSFODNN7EXAMPLE',
+                    secretAccessKey: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
+                },
+                message: {
+                    body: 'Test message',
+                },
+            };
+            assert.strictEqual(config.type, 'sqs');
+            assert.strictEqual(config.credentials?.type, 'accessKey');
+        });
+        it('should accept valid assume role credentials config', () => {
+            const config = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                credentials: {
+                    type: 'assumeRole',
+                    roleArn: 'arn:aws:iam::123456789012:role/MyRole',
+                    roleSessionName: 'my-session',
+                    externalId: 'external-123',
+                    durationSeconds: 3600,
+                },
+                message: {
+                    body: 'Test message',
+                },
+            };
+            assert.strictEqual(config.type, 'sqs');
+            assert.strictEqual(config.credentials?.type, 'assumeRole');
+        });
+        it('should accept config without explicit credentials (uses default chain)', () => {
+            const config = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                message: {
+                    body: 'Test message',
+                },
+            };
+            assert.strictEqual(config.type, 'sqs');
+            assert.strictEqual(config.credentials, undefined);
+        });
+        it('should accept retry configuration', () => {
+            const config = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                message: {
+                    body: 'Test message',
+                },
+                retry: {
+                    maxAttempts: 5,
+                    retryMode: 'adaptive',
+                },
+            };
+            assert.strictEqual(config.retry?.maxAttempts, 5);
+            assert.strictEqual(config.retry?.retryMode, 'adaptive');
+        });
+        it('should accept async mode configuration', () => {
+            const configAsync = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                message: {
+                    body: 'Test message',
+                },
+                async: true,
+            };
+            const configSync = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                message: {
+                    body: 'Test message',
+                },
+                async: false,
+            };
+            assert.strictEqual(configAsync.async, true);
+            assert.strictEqual(configSync.async, false);
+        });
+        it('should accept FIFO queue configuration', () => {
+            const config = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue.fifo',
+                region: 'us-east-1',
+                message: {
+                    body: 'FIFO message',
+                    messageGroupId: 'group-1',
+                    messageDeduplicationId: 'dedup-1',
+                },
+            };
+            assert.strictEqual(config.message.messageGroupId, 'group-1');
+            assert.strictEqual(config.message.messageDeduplicationId, 'dedup-1');
+        });
+        it('should accept message with delay seconds', () => {
+            const config = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                message: {
+                    body: 'Delayed message',
+                    delaySeconds: 60,
+                },
+            };
+            assert.strictEqual(config.message.delaySeconds, 60);
+        });
+        it('should accept message with attributes', () => {
+            const config = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                message: {
+                    body: 'Message with attributes',
+                    messageAttributes: {
+                        correlationId: {
+                            DataType: 'String',
+                            StringValue: 'corr-123',
+                        },
+                        priority: {
+                            DataType: 'Number',
+                            StringValue: '1',
+                        },
+                    },
+                },
+            };
+            assert.strictEqual(config.message.messageAttributes?.correlationId?.DataType, 'String');
+        });
+        it('should accept fallback configuration', () => {
+            const config = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                message: {
+                    body: 'Test message',
+                },
+                fallback: {
+                    status: 200,
+                    data: { fallback: true, queued: false },
+                },
+            };
+            assert.strictEqual(config.fallback?.status, 200);
+            assert.deepStrictEqual(config.fallback?.data, { fallback: true, queued: false });
+        });
+        it('should accept JSON object as message body', () => {
+            const config = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                message: {
+                    body: { userId: 1, action: 'create', timestamp: new Date().toISOString() },
+                },
+            };
+            assert.strictEqual(typeof config.message.body, 'object');
+            assert.strictEqual(config.message.body.userId, 1);
+        });
+        it('should accept access key credentials with session token', () => {
+            const config = {
+                type: 'sqs',
+                queueUrl: 'https://sqs.us-east-1.amazonaws.com/123456789/my-queue',
+                region: 'us-east-1',
+                credentials: {
+                    type: 'accessKey',
+                    accessKeyId: 'AKIAIOSFODNN7EXAMPLE',
+                    secretAccessKey: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
+                    sessionToken: 'AQoDYXdzEJr...',
+                },
+                message: {
+                    body: 'Test message',
+                },
+            };
+            assert.strictEqual(config.credentials?.type, 'accessKey');
+            if (config.credentials?.type === 'accessKey') {
+                assert.strictEqual(config.credentials.sessionToken, 'AQoDYXdzEJr...');
+            }
+        });
+    });
+});
+//# sourceMappingURL=sqs-executor.test.js.map

package/dist/tests/sqs-executor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqs-executor.test.js","sourceRoot":"","sources":["../../tests/sqs-executor.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@workflow-stack/sqs",
+  "version": "0.2.0",
+  "description": "SQS plugin for @workflow-stack/core - AWS SQS message publishing orchestration",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "type": "module",
+  "private": false,
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "src/**",
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "borp --coverage tests/*.test.ts --coverage-exclude '**/node_modules/**' --coverage-exclude '**/tests/**'",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "flow-stack",
+    "plugin",
+    "sqs",
+    "aws",
+    "queue",
+    "message",
+    "orchestrator",
+    "workflow"
+  ],
+  "author": "Rahul Radhakrishnan",
+  "license": "MIT",
+  "peerDependencies": {
+    "@workflow-stack/core": "^0.1.0"
+  },
+  "dependencies": {
+    "@aws-sdk/client-sqs": "^3.700.0",
+    "@aws-sdk/client-sts": "^3.700.0",
+    "@aws-sdk/credential-providers": "^3.700.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "borp": "^0.21.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rahulrkr08/flow-stack.git",
+    "directory": "packages/sqs"
+  },
+  "bugs": {
+    "url": "https://github.com/rahulrkr08/flow-stack/issues"
+  },
+  "homepage": "https://github.com/rahulrkr08/flow-stack/tree/main/packages/sqs#readme",
+  "gitHead": "099ec70ce5b0473dc6a211a875d45372262a773e"
+}

package/src/index.ts

@@ -0,0 +1,15 @@
+// SQS plugin
+export { sqsPlugin } from './plugin.js';
+
+// SQS executor (for advanced use cases)
+export { executeSqsService } from './sqs-executor.js';
+
+// Type definitions
+export type {
+  SqsServiceConfig,
+  SqsCredentials,
+  SqsAccessKeyCredentials,
+  SqsAssumeRoleCredentials,
+  SqsRetryConfig,
+  SqsMessageAttribute,
+} from './types.js';

package/src/plugin.ts

@@ -0,0 +1,15 @@
+import type { FlowStackPlugin } from '@workflow-stack/core';
+import type { SqsServiceConfig } from './types.js';
+import { executeSqsService } from './sqs-executor.js';
+
+/**
+ * SQS plugin for flow-stack
+ * Provides AWS SQS message publishing using AWS SDK v3
+ */
+export const sqsPlugin: FlowStackPlugin<SqsServiceConfig> = {
+  type: 'sqs',
+  name: '@workflow-stack/sqs',
+  version: '1.0.0',
+  execute: executeSqsService,
+  interpolate: true,
+};

package/src/sqs-executor.ts

@@ -0,0 +1,163 @@
+import { SQSClient, SendMessageCommand } from '@aws-sdk/client-sqs';
+import { fromTemporaryCredentials } from '@aws-sdk/credential-providers';
+import type { ServiceResult, OrchestrationContext } from '@workflow-stack/core';
+import { emitServiceStart, emitServiceComplete, emitServiceError } from '@workflow-stack/core';
+import type { SqsServiceConfig, SqsAssumeRoleCredentials } from './types.js';
+
+/**
+ * Creates an SQS client based on the provided configuration
+ */
+function createSqsClient(config: SqsServiceConfig): SQSClient {
+  const clientConfig: any = {
+    region: config.region,
+  };
+
+  if (config.retry) {
+    clientConfig.maxAttempts = config.retry.maxAttempts;
+    clientConfig.retryMode = config.retry.retryMode;
+  }
+
+  if (config.credentials) {
+    if (config.credentials.type === 'accessKey') {
+      clientConfig.credentials = {
+        accessKeyId: config.credentials.accessKeyId,
+        secretAccessKey: config.credentials.secretAccessKey,
+        sessionToken: config.credentials.sessionToken,
+      };
+    } else if (config.credentials.type === 'assumeRole') {
+      const roleConfig = config.credentials as SqsAssumeRoleCredentials;
+      clientConfig.credentials = fromTemporaryCredentials({
+        params: {
+          RoleArn: roleConfig.roleArn,
+          RoleSessionName: roleConfig.roleSessionName || 'flow-stack-sqs-session',
+          ExternalId: roleConfig.externalId,
+          DurationSeconds: roleConfig.durationSeconds,
+        },
+      });
+    }
+  }
+
+  return new SQSClient(clientConfig);
+}
+
+/**
+ * Executes SQS message publishing
+ */
+async function sendMessage(
+  client: SQSClient,
+  config: SqsServiceConfig
+): Promise<{ messageId: string; sequenceNumber?: string }> {
+  const messageBody =
+    typeof config.message.body === 'string'
+      ? config.message.body
+      : JSON.stringify(config.message.body);
+
+  const command = new SendMessageCommand({
+    QueueUrl: config.queueUrl,
+    MessageBody: messageBody,
+    MessageGroupId: config.message.messageGroupId,
+    MessageDeduplicationId: config.message.messageDeduplicationId,
+    DelaySeconds: config.message.delaySeconds,
+    MessageAttributes: config.message.messageAttributes,
+  });
+
+  const response = await client.send(command);
+
+  return {
+    messageId: response.MessageId!,
+    sequenceNumber: response.SequenceNumber,
+  };
+}
+
+/**
+ * Executes a single SQS publish service call
+ */
+export async function executeSqsService(
+  config: SqsServiceConfig,
+  context: OrchestrationContext,
+  serviceId: string
+): Promise<ServiceResult> {
+  const startTime = Date.now();
+
+  emitServiceStart(serviceId, 'sqs', config, context);
+
+  const client = createSqsClient(config);
+
+  try {
+    const isAsync = config.async === true;
+
+    if (isAsync) {
+      // Fire and forget - don't wait for response
+      sendMessage(client, config).catch((error) => {
+        // Log error but don't fail the service
+        const processingTime = Date.now() - startTime;
+        emitServiceError(serviceId, 'sqs', config, context, processingTime, error);
+      });
+
+      const processingTime = Date.now() - startTime;
+      emitServiceComplete(serviceId, 'sqs', config, context, processingTime, 202);
+
+      return {
+        status: 202,
+        body: {
+          message: 'Message queued for delivery',
+          async: true,
+        },
+        metadata: {
+          executionStatus: 'executed',
+          serviceType: 'sqs',
+        },
+      };
+    }
+
+    // Sync mode - wait for response
+    const result = await sendMessage(client, config);
+
+    const processingTime = Date.now() - startTime;
+    emitServiceComplete(serviceId, 'sqs', config, context, processingTime, 200);
+
+    return {
+      status: 200,
+      body: {
+        messageId: result.messageId,
+        sequenceNumber: result.sequenceNumber,
+      },
+      metadata: {
+        executionStatus: 'executed',
+        serviceType: 'sqs',
+      },
+    };
+  } catch (error: any) {
+    const processingTime = Date.now() - startTime;
+    emitServiceError(serviceId, 'sqs', config, context, processingTime, error);
+
+    // If fallback is configured, return it
+    if (config.fallback) {
+      return {
+        status: config.fallback.status || null,
+        body: config.fallback.data,
+        metadata: {
+          executionStatus: 'failed',
+          fallbackUsed: true,
+          serviceType: 'sqs',
+        },
+      };
+    }
+
+    // Otherwise, return error
+    return {
+      status: null,
+      body: null,
+      error: {
+        message: error.message,
+        code: error.code || error.name,
+      },
+      metadata: {
+        executionStatus: 'failed',
+        serviceType: 'sqs',
+      },
+    };
+  } finally {
+    client.destroy();
+  }
+}

package/src/types.ts

@@ -0,0 +1,63 @@
+import type { BaseServiceConfig } from '@workflow-stack/core';
+
+/**
+ * AWS credentials configuration using access key and secret
+ */
+export interface SqsAccessKeyCredentials {
+  type: 'accessKey';
+  accessKeyId: string;
+  secretAccessKey: string;
+  sessionToken?: string;
+}
+
+/**
+ * AWS credentials configuration using assume role
+ */
+export interface SqsAssumeRoleCredentials {
+  type: 'assumeRole';
+  roleArn: string;
+  roleSessionName?: string;
+  externalId?: string;
+  durationSeconds?: number;
+}
+
+/**
+ * AWS credentials - either access key or assume role
+ */
+export type SqsCredentials = SqsAccessKeyCredentials | SqsAssumeRoleCredentials;
+
+/**
+ * Retry configuration for SQS operations
+ */
+export interface SqsRetryConfig {
+  maxAttempts?: number;
+  retryMode?: 'standard' | 'adaptive';
+}
+
+/**
+ * SQS message attributes
+ */
+export interface SqsMessageAttribute {
+  DataType: 'String' | 'Number' | 'Binary';
+  StringValue?: string;
+  BinaryValue?: Uint8Array;
+}
+
+/**
+ * SQS service configuration
+ */
+export interface SqsServiceConfig extends BaseServiceConfig {
+  type: 'sqs';
+  queueUrl: string;
+  region: string;
+  credentials?: SqsCredentials;
+  message: {
+    body: any;
+    messageGroupId?: string;
+    messageDeduplicationId?: string;
+    delaySeconds?: number;
+    messageAttributes?: Record<string, SqsMessageAttribute>;
+  };
+  retry?: SqsRetryConfig;
+  async?: boolean;
+}