@pubber-subber/aws-sqs 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sami Mishal
+
+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,127 @@
+# @pubber-subber/aws-sqs
+
+AWS SQS **subscribe-only** adapter for [`@pubber-subber/core`](https://www.npmjs.com/package/@pubber-subber/core). Backed by [`@aws-sdk/client-sqs`](https://www.npmjs.com/package/@aws-sdk/client-sqs).
+
+Long-polls a queue, delivers messages to your handler, auto-acks on success and nacks on failure. Unwraps SNS notification envelopes transparently for SNS → SQS pipelines.
+
+## Install
+
+```sh
+pnpm add @pubber-subber/core @pubber-subber/aws-sqs @aws-sdk/client-sqs
+```
+
+`@aws-sdk/client-sqs` is a **peer dependency**. AWS auth follows the SDK's default credential chain.
+
+## Quick start
+
+```ts
+import { PubSub } from '@pubber-subber/core';
+import { awsSqs } from '@pubber-subber/aws-sqs';
+
+const pubsub = new PubSub({
+  adapter: awsSqs({
+    region: 'us-east-1',
+    queueUrl: 'https://sqs.us-east-1.amazonaws.com/000000000000/orders',
+  }),
+});
+
+await pubsub.subscribe('orders', (msg) => {
+  console.log(msg.payload);          // SNS envelope auto-unwrapped if present
+  // call msg.ack() / msg.nack() manually if you need fine control
+});
+```
+
+## Pair with SNS for full-duplex
+
+```ts
+import { PubSub, compose } from '@pubber-subber/core';
+import { awsSns } from '@pubber-subber/aws-sns';
+import { awsSqs } from '@pubber-subber/aws-sqs';
+
+const pubsub = new PubSub({
+  adapter: compose({
+    publisher: awsSns({ region: 'us-east-1' }),
+    subscriber: awsSqs({ region: 'us-east-1', queueUrl: '...' }),
+  }),
+});
+```
+
+(The SNS → SQS subscription must already be wired — typically via Terraform/CDK.)
+
+## Options
+
+```ts
+awsSqs({
+  region?: string;
+  queueUrl?: string;            // default for subscribes
+  client?: SQSClient;
+  options?: SQSClientConfig;
+  codec?: Codec;
+})
+```
+
+| Option | Notes |
+| --- | --- |
+| `region` | AWS region. |
+| `queueUrl` | Default queue URL — used when `meta.queueUrl` isn't passed on subscribe. |
+| `client` | Pre-constructed `SQSClient`. |
+| `options` | Full `SQSClientConfig` (endpoint override for LocalStack, retry strategy, etc.). |
+| `codec` | Payload encoder/decoder. Default `jsonCodec()`. |
+
+## Subscribe meta
+
+```ts
+await pubsub.subscribe('orders', handler, {
+  queueUrl: 'https://...',
+  waitTimeSeconds: 20,
+  maxMessages: 10,
+  handlerConcurrency: 5,
+});
+```
+
+| Field | Default | Notes |
+| --- | --- | --- |
+| `queueUrl` | `opts.queueUrl` | One of the two **must** be set, otherwise `SubscriptionError` is thrown. |
+| `waitTimeSeconds` | 20 | SQS long-poll wait. 0–20. Higher → fewer empty receives, lower API cost. |
+| `maxMessages` | 10 | Per `ReceiveMessage` batch. 1–10. |
+| `visibilityTimeout` | (queue default) | Override per subscription. |
+| `handlerConcurrency` | 5 | Maximum in-flight handler invocations. Increase for I/O-bound handlers. |
+
+## Capabilities
+
+```ts
+{ publish: false, subscribe: true, patternSubscribe: false, ack: true }
+```
+
+Calling `publish()` throws `NotSupportedError` with a pointer to `@pubber-subber/aws-sns` + `compose()`.
+
+## Ack semantics
+
+- Handler resolves → `DeleteMessage` (ack).
+- Handler throws → `ChangeMessageVisibility(VisibilityTimeout=0)` so the message is immediately retried (nack).
+- For manual control, call `msg.ack()` or `msg.nack()` inside your handler. The adapter tracks whether either was called and skips the auto-resolve to avoid double-ack.
+
+## SNS → SQS envelope unwrapping
+
+If a message's Body is an SNS notification envelope:
+
+```json
+{ "Type": "Notification", "MessageId": "...", "Message": "<inner>", "MessageAttributes": {...} }
+```
+
+the adapter:
+
+- decodes the inner `Message` through the codec (so the JSON SNS publishes is unwrapped to your original payload),
+- exposes the SNS attributes on `AdapterMessage.meta.snsAttributes`.
+
+Your handler sees the original payload, not the envelope.
+
+## Notes
+
+- The receive loop runs in the background; `unsubscribe()` halts it and drains any in-flight handler invocations before resolving.
+- For FIFO queues, set `meta.maxMessages = 1` and `meta.handlerConcurrency = 1` to preserve ordering.
+- LocalStack: pass `options: { endpoint: 'http://localhost:4566' }`.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,183 @@
+'use strict';
+
+var clientSqs = require('@aws-sdk/client-sqs');
+var core = require('@pubber-subber/core');
+
+// src/index.ts
+function awsSqs(opts = {}) {
+  const codec = opts.codec ?? core.jsonCodec();
+  let client = null;
+  let idCounter = 0;
+  const ensure = () => {
+    if (client) return client;
+    if (opts.client) {
+      client = opts.client;
+    } else {
+      client = new clientSqs.SQSClient({ region: opts.region, ...opts.options });
+    }
+    return client;
+  };
+  return {
+    name: "aws-sqs",
+    capabilities: { publish: false, subscribe: true, patternSubscribe: false, ack: true },
+    async connect() {
+      ensure();
+    },
+    async disconnect() {
+      if (client) client.destroy();
+      client = null;
+    },
+    async publish() {
+      throw new core.NotSupportedError(
+        "aws-sqs is subscribe-only. Use @pubber-subber/aws-sns (or another publish-capable adapter) and compose them: `compose({ publisher: awsSns(), subscriber: awsSqs() })`."
+      );
+    },
+    async subscribe(topic, handler, meta) {
+      const c = ensure();
+      const queueUrl = meta?.queueUrl ?? opts.queueUrl;
+      if (!queueUrl) {
+        throw new core.SubscriptionError(
+          "queueUrl is required (pass it in awsSqs({ queueUrl }) or meta.queueUrl)."
+        );
+      }
+      const waitTimeSeconds = meta?.waitTimeSeconds ?? 20;
+      const maxMessages = meta?.maxMessages ?? 10;
+      const concurrency = meta?.handlerConcurrency ?? 5;
+      const visibilityTimeout = meta?.visibilityTimeout;
+      let stopped = false;
+      const semaphore = new Semaphore(concurrency);
+      const inflight = /* @__PURE__ */ new Set();
+      const loop = async () => {
+        while (!stopped) {
+          try {
+            const resp = await c.send(
+              new clientSqs.ReceiveMessageCommand({
+                QueueUrl: queueUrl,
+                MaxNumberOfMessages: maxMessages,
+                WaitTimeSeconds: waitTimeSeconds,
+                VisibilityTimeout: visibilityTimeout,
+                MessageAttributeNames: ["All"],
+                MessageSystemAttributeNames: ["All"]
+              })
+            );
+            for (const m of resp.Messages ?? []) {
+              if (stopped) break;
+              await semaphore.acquire();
+              const task = processMessage(c, queueUrl, topic, m, handler, codec).finally(() => {
+                semaphore.release();
+                inflight.delete(task);
+              });
+              inflight.add(task);
+            }
+          } catch (err) {
+            if (stopped) break;
+            await sleep(1e3);
+          }
+        }
+      };
+      void loop();
+      idCounter += 1;
+      const id = `sqs-${idCounter}`;
+      return {
+        id,
+        topic,
+        unsubscribe: async () => {
+          stopped = true;
+          await Promise.allSettled([...inflight]);
+        }
+      };
+    }
+  };
+}
+async function processMessage(client, queueUrl, topic, message, handler, codec) {
+  const body = message.Body;
+  let payload = body;
+  let snsAttributes;
+  if (typeof body === "string") {
+    try {
+      const parsed = JSON.parse(body);
+      if (parsed && typeof parsed === "object" && parsed.Type === "Notification" && typeof parsed.Message === "string") {
+        snsAttributes = parsed.MessageAttributes;
+        try {
+          payload = codec.decode(parsed.Message);
+        } catch {
+          payload = parsed.Message;
+        }
+      } else {
+        payload = codec.decode(body);
+      }
+    } catch {
+      payload = body;
+    }
+  }
+  const receiptHandle = message.ReceiptHandle ?? "";
+  let resolved = false;
+  const doAck = async () => {
+    if (resolved) return;
+    resolved = true;
+    await client.send(
+      new clientSqs.DeleteMessageCommand({
+        QueueUrl: queueUrl,
+        ReceiptHandle: receiptHandle
+      })
+    );
+  };
+  const doNack = async () => {
+    if (resolved) return;
+    resolved = true;
+    await client.send(
+      new clientSqs.ChangeMessageVisibilityCommand({
+        QueueUrl: queueUrl,
+        ReceiptHandle: receiptHandle,
+        VisibilityTimeout: 0
+      })
+    );
+  };
+  const adapterMsg = {
+    topic,
+    payload,
+    raw: message,
+    meta: {
+      messageId: message.MessageId,
+      receiptHandle: message.ReceiptHandle,
+      attributes: message.MessageAttributes,
+      systemAttributes: message.Attributes,
+      snsAttributes
+    },
+    ack: doAck,
+    nack: doNack
+  };
+  try {
+    await handler(adapterMsg);
+    await doAck();
+  } catch {
+    await doNack().catch(() => void 0);
+  }
+}
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+var Semaphore = class {
+  #permits;
+  #waiters = [];
+  constructor(permits) {
+    this.#permits = permits;
+  }
+  async acquire() {
+    if (this.#permits > 0) {
+      this.#permits -= 1;
+      return;
+    }
+    await new Promise((resolve) => this.#waiters.push(resolve));
+    this.#permits -= 1;
+  }
+  release() {
+    this.#permits += 1;
+    const next = this.#waiters.shift();
+    if (next) next();
+  }
+};
+
+exports.awsSqs = awsSqs;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["jsonCodec","SQSClient","NotSupportedError","SubscriptionError","ReceiveMessageCommand","DeleteMessageCommand","ChangeMessageVisibilityCommand"],"mappings":"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","file":"index.cjs","sourcesContent":["import {\n  ChangeMessageVisibilityCommand,\n  DeleteMessageCommand,\n  ReceiveMessageCommand,\n  SQSClient,\n  type SQSClientConfig,\n  type Message as SqsMessage,\n} from '@aws-sdk/client-sqs';\nimport {\n  type AdapterMessage,\n  type Codec,\n  NotSupportedError,\n  type PubSubAdapter,\n  SubscriptionError,\n  jsonCodec,\n} from '@pubber-subber/core';\n\nexport interface AwsSqsAdapterOptions {\n  region?: string;\n  /** Default queue URL, used when no `meta.queueUrl` is provided on subscribe. */\n  queueUrl?: string;\n  client?: SQSClient;\n  options?: SQSClientConfig;\n  codec?: Codec;\n}\n\nexport interface AwsSqsSubscribeMeta {\n  queueUrl?: string;\n  /** 0–20s. Default 20 (long polling). */\n  waitTimeSeconds?: number;\n  /** 1–10 per ReceiveMessage call. Default 10. */\n  maxMessages?: number;\n  /** Override the queue's default visibility timeout for received messages. */\n  visibilityTimeout?: number;\n  /** Max number of handler invocations in flight at once. Default 5. */\n  handlerConcurrency?: number;\n}\n\nexport function awsSqs(opts: AwsSqsAdapterOptions = {}): PubSubAdapter<never, AwsSqsSubscribeMeta> {\n  const codec = opts.codec ?? jsonCodec();\n  let client: SQSClient | null = null;\n  let idCounter = 0;\n\n  const ensure = (): SQSClient => {\n    if (client) return client;\n    if (opts.client) {\n      client = opts.client;\n    } else {\n      client = new SQSClient({ region: opts.region, ...opts.options });\n    }\n    return client;\n  };\n\n  return {\n    name: 'aws-sqs',\n    capabilities: { publish: false, subscribe: true, patternSubscribe: false, ack: true },\n\n    async connect() {\n      ensure();\n    },\n\n    async disconnect() {\n      if (client) client.destroy();\n      client = null;\n    },\n\n    async publish() {\n      throw new NotSupportedError(\n        'aws-sqs is subscribe-only. Use @pubber-subber/aws-sns (or another publish-capable adapter) ' +\n          'and compose them: `compose({ publisher: awsSns(), subscriber: awsSqs() })`.',\n      );\n    },\n\n    async subscribe(topic, handler, meta) {\n      const c = ensure();\n      const queueUrl = meta?.queueUrl ?? opts.queueUrl;\n      if (!queueUrl) {\n        throw new SubscriptionError(\n          'queueUrl is required (pass it in awsSqs({ queueUrl }) or meta.queueUrl).',\n        );\n      }\n      const waitTimeSeconds = meta?.waitTimeSeconds ?? 20;\n      const maxMessages = meta?.maxMessages ?? 10;\n      const concurrency = meta?.handlerConcurrency ?? 5;\n      const visibilityTimeout = meta?.visibilityTimeout;\n\n      let stopped = false;\n      const semaphore = new Semaphore(concurrency);\n      const inflight = new Set<Promise<unknown>>();\n\n      const loop = async (): Promise<void> => {\n        while (!stopped) {\n          try {\n            const resp = await c.send(\n              new ReceiveMessageCommand({\n                QueueUrl: queueUrl,\n                MaxNumberOfMessages: maxMessages,\n                WaitTimeSeconds: waitTimeSeconds,\n                VisibilityTimeout: visibilityTimeout,\n                MessageAttributeNames: ['All'],\n                MessageSystemAttributeNames: ['All'] as never,\n              }),\n            );\n            for (const m of resp.Messages ?? []) {\n              if (stopped) break;\n              await semaphore.acquire();\n              const task = processMessage(c, queueUrl, topic, m, handler, codec).finally(() => {\n                semaphore.release();\n                inflight.delete(task);\n              });\n              inflight.add(task);\n            }\n          } catch (err) {\n            if (stopped) break;\n            // Backoff briefly on receive errors so we don't hot-loop on a permission issue.\n            await sleep(1000);\n          }\n        }\n      };\n\n      void loop();\n\n      idCounter += 1;\n      const id = `sqs-${idCounter}`;\n      return {\n        id,\n        topic,\n        unsubscribe: async () => {\n          stopped = true;\n          await Promise.allSettled([...inflight]);\n        },\n      };\n    },\n  };\n}\n\nasync function processMessage(\n  client: SQSClient,\n  queueUrl: string,\n  topic: string,\n  message: SqsMessage,\n  handler: (msg: AdapterMessage) => void | Promise<void>,\n  codec: Codec,\n): Promise<void> {\n  const body = message.Body;\n  let payload: unknown = body;\n  let snsAttributes: Record<string, unknown> | undefined;\n\n  if (typeof body === 'string') {\n    try {\n      const parsed = JSON.parse(body);\n      if (\n        parsed &&\n        typeof parsed === 'object' &&\n        parsed.Type === 'Notification' &&\n        typeof parsed.Message === 'string'\n      ) {\n        // SNS→SQS envelope. Unwrap.\n        snsAttributes = parsed.MessageAttributes;\n        try {\n          payload = codec.decode(parsed.Message);\n        } catch {\n          payload = parsed.Message;\n        }\n      } else {\n        payload = codec.decode(body);\n      }\n    } catch {\n      payload = body;\n    }\n  }\n\n  const receiptHandle = message.ReceiptHandle ?? '';\n  let resolved = false;\n  const doAck = async (): Promise<void> => {\n    if (resolved) return;\n    resolved = true;\n    await client.send(\n      new DeleteMessageCommand({\n        QueueUrl: queueUrl,\n        ReceiptHandle: receiptHandle,\n      }),\n    );\n  };\n  const doNack = async (): Promise<void> => {\n    if (resolved) return;\n    resolved = true;\n    await client.send(\n      new ChangeMessageVisibilityCommand({\n        QueueUrl: queueUrl,\n        ReceiptHandle: receiptHandle,\n        VisibilityTimeout: 0,\n      }),\n    );\n  };\n\n  const adapterMsg: AdapterMessage = {\n    topic,\n    payload,\n    raw: message,\n    meta: {\n      messageId: message.MessageId,\n      receiptHandle: message.ReceiptHandle,\n      attributes: message.MessageAttributes,\n      systemAttributes: message.Attributes,\n      snsAttributes,\n    },\n    ack: doAck,\n    nack: doNack,\n  };\n\n  try {\n    await handler(adapterMsg);\n    await doAck();\n  } catch {\n    await doNack().catch(() => undefined);\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((r) => setTimeout(r, ms));\n}\n\nclass Semaphore {\n  #permits: number;\n  #waiters: Array<() => void> = [];\n\n  constructor(permits: number) {\n    this.#permits = permits;\n  }\n\n  async acquire(): Promise<void> {\n    if (this.#permits > 0) {\n      this.#permits -= 1;\n      return;\n    }\n    await new Promise<void>((resolve) => this.#waiters.push(resolve));\n    this.#permits -= 1;\n  }\n\n  release(): void {\n    this.#permits += 1;\n    const next = this.#waiters.shift();\n    if (next) next();\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,25 @@
+import { SQSClient, SQSClientConfig } from '@aws-sdk/client-sqs';
+import { Codec, PubSubAdapter } from '@pubber-subber/core';
+
+interface AwsSqsAdapterOptions {
+    region?: string;
+    /** Default queue URL, used when no `meta.queueUrl` is provided on subscribe. */
+    queueUrl?: string;
+    client?: SQSClient;
+    options?: SQSClientConfig;
+    codec?: Codec;
+}
+interface AwsSqsSubscribeMeta {
+    queueUrl?: string;
+    /** 0–20s. Default 20 (long polling). */
+    waitTimeSeconds?: number;
+    /** 1–10 per ReceiveMessage call. Default 10. */
+    maxMessages?: number;
+    /** Override the queue's default visibility timeout for received messages. */
+    visibilityTimeout?: number;
+    /** Max number of handler invocations in flight at once. Default 5. */
+    handlerConcurrency?: number;
+}
+declare function awsSqs(opts?: AwsSqsAdapterOptions): PubSubAdapter<never, AwsSqsSubscribeMeta>;
+
+export { type AwsSqsAdapterOptions, type AwsSqsSubscribeMeta, awsSqs };

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { SQSClient, SQSClientConfig } from '@aws-sdk/client-sqs';
+import { Codec, PubSubAdapter } from '@pubber-subber/core';
+
+interface AwsSqsAdapterOptions {
+    region?: string;
+    /** Default queue URL, used when no `meta.queueUrl` is provided on subscribe. */
+    queueUrl?: string;
+    client?: SQSClient;
+    options?: SQSClientConfig;
+    codec?: Codec;
+}
+interface AwsSqsSubscribeMeta {
+    queueUrl?: string;
+    /** 0–20s. Default 20 (long polling). */
+    waitTimeSeconds?: number;
+    /** 1–10 per ReceiveMessage call. Default 10. */
+    maxMessages?: number;
+    /** Override the queue's default visibility timeout for received messages. */
+    visibilityTimeout?: number;
+    /** Max number of handler invocations in flight at once. Default 5. */
+    handlerConcurrency?: number;
+}
+declare function awsSqs(opts?: AwsSqsAdapterOptions): PubSubAdapter<never, AwsSqsSubscribeMeta>;
+
+export { type AwsSqsAdapterOptions, type AwsSqsSubscribeMeta, awsSqs };

package/dist/index.js

@@ -0,0 +1,181 @@
+import { SQSClient, ReceiveMessageCommand, ChangeMessageVisibilityCommand, DeleteMessageCommand } from '@aws-sdk/client-sqs';
+import { jsonCodec, SubscriptionError, NotSupportedError } from '@pubber-subber/core';
+
+// src/index.ts
+function awsSqs(opts = {}) {
+  const codec = opts.codec ?? jsonCodec();
+  let client = null;
+  let idCounter = 0;
+  const ensure = () => {
+    if (client) return client;
+    if (opts.client) {
+      client = opts.client;
+    } else {
+      client = new SQSClient({ region: opts.region, ...opts.options });
+    }
+    return client;
+  };
+  return {
+    name: "aws-sqs",
+    capabilities: { publish: false, subscribe: true, patternSubscribe: false, ack: true },
+    async connect() {
+      ensure();
+    },
+    async disconnect() {
+      if (client) client.destroy();
+      client = null;
+    },
+    async publish() {
+      throw new NotSupportedError(
+        "aws-sqs is subscribe-only. Use @pubber-subber/aws-sns (or another publish-capable adapter) and compose them: `compose({ publisher: awsSns(), subscriber: awsSqs() })`."
+      );
+    },
+    async subscribe(topic, handler, meta) {
+      const c = ensure();
+      const queueUrl = meta?.queueUrl ?? opts.queueUrl;
+      if (!queueUrl) {
+        throw new SubscriptionError(
+          "queueUrl is required (pass it in awsSqs({ queueUrl }) or meta.queueUrl)."
+        );
+      }
+      const waitTimeSeconds = meta?.waitTimeSeconds ?? 20;
+      const maxMessages = meta?.maxMessages ?? 10;
+      const concurrency = meta?.handlerConcurrency ?? 5;
+      const visibilityTimeout = meta?.visibilityTimeout;
+      let stopped = false;
+      const semaphore = new Semaphore(concurrency);
+      const inflight = /* @__PURE__ */ new Set();
+      const loop = async () => {
+        while (!stopped) {
+          try {
+            const resp = await c.send(
+              new ReceiveMessageCommand({
+                QueueUrl: queueUrl,
+                MaxNumberOfMessages: maxMessages,
+                WaitTimeSeconds: waitTimeSeconds,
+                VisibilityTimeout: visibilityTimeout,
+                MessageAttributeNames: ["All"],
+                MessageSystemAttributeNames: ["All"]
+              })
+            );
+            for (const m of resp.Messages ?? []) {
+              if (stopped) break;
+              await semaphore.acquire();
+              const task = processMessage(c, queueUrl, topic, m, handler, codec).finally(() => {
+                semaphore.release();
+                inflight.delete(task);
+              });
+              inflight.add(task);
+            }
+          } catch (err) {
+            if (stopped) break;
+            await sleep(1e3);
+          }
+        }
+      };
+      void loop();
+      idCounter += 1;
+      const id = `sqs-${idCounter}`;
+      return {
+        id,
+        topic,
+        unsubscribe: async () => {
+          stopped = true;
+          await Promise.allSettled([...inflight]);
+        }
+      };
+    }
+  };
+}
+async function processMessage(client, queueUrl, topic, message, handler, codec) {
+  const body = message.Body;
+  let payload = body;
+  let snsAttributes;
+  if (typeof body === "string") {
+    try {
+      const parsed = JSON.parse(body);
+      if (parsed && typeof parsed === "object" && parsed.Type === "Notification" && typeof parsed.Message === "string") {
+        snsAttributes = parsed.MessageAttributes;
+        try {
+          payload = codec.decode(parsed.Message);
+        } catch {
+          payload = parsed.Message;
+        }
+      } else {
+        payload = codec.decode(body);
+      }
+    } catch {
+      payload = body;
+    }
+  }
+  const receiptHandle = message.ReceiptHandle ?? "";
+  let resolved = false;
+  const doAck = async () => {
+    if (resolved) return;
+    resolved = true;
+    await client.send(
+      new DeleteMessageCommand({
+        QueueUrl: queueUrl,
+        ReceiptHandle: receiptHandle
+      })
+    );
+  };
+  const doNack = async () => {
+    if (resolved) return;
+    resolved = true;
+    await client.send(
+      new ChangeMessageVisibilityCommand({
+        QueueUrl: queueUrl,
+        ReceiptHandle: receiptHandle,
+        VisibilityTimeout: 0
+      })
+    );
+  };
+  const adapterMsg = {
+    topic,
+    payload,
+    raw: message,
+    meta: {
+      messageId: message.MessageId,
+      receiptHandle: message.ReceiptHandle,
+      attributes: message.MessageAttributes,
+      systemAttributes: message.Attributes,
+      snsAttributes
+    },
+    ack: doAck,
+    nack: doNack
+  };
+  try {
+    await handler(adapterMsg);
+    await doAck();
+  } catch {
+    await doNack().catch(() => void 0);
+  }
+}
+function sleep(ms) {
+  return new Promise((r) => setTimeout(r, ms));
+}
+var Semaphore = class {
+  #permits;
+  #waiters = [];
+  constructor(permits) {
+    this.#permits = permits;
+  }
+  async acquire() {
+    if (this.#permits > 0) {
+      this.#permits -= 1;
+      return;
+    }
+    await new Promise((resolve) => this.#waiters.push(resolve));
+    this.#permits -= 1;
+  }
+  release() {
+    this.#permits += 1;
+    const next = this.#waiters.shift();
+    if (next) next();
+  }
+};
+
+export { awsSqs };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import {\n  ChangeMessageVisibilityCommand,\n  DeleteMessageCommand,\n  ReceiveMessageCommand,\n  SQSClient,\n  type SQSClientConfig,\n  type Message as SqsMessage,\n} from '@aws-sdk/client-sqs';\nimport {\n  type AdapterMessage,\n  type Codec,\n  NotSupportedError,\n  type PubSubAdapter,\n  SubscriptionError,\n  jsonCodec,\n} from '@pubber-subber/core';\n\nexport interface AwsSqsAdapterOptions {\n  region?: string;\n  /** Default queue URL, used when no `meta.queueUrl` is provided on subscribe. */\n  queueUrl?: string;\n  client?: SQSClient;\n  options?: SQSClientConfig;\n  codec?: Codec;\n}\n\nexport interface AwsSqsSubscribeMeta {\n  queueUrl?: string;\n  /** 0–20s. Default 20 (long polling). */\n  waitTimeSeconds?: number;\n  /** 1–10 per ReceiveMessage call. Default 10. */\n  maxMessages?: number;\n  /** Override the queue's default visibility timeout for received messages. */\n  visibilityTimeout?: number;\n  /** Max number of handler invocations in flight at once. Default 5. */\n  handlerConcurrency?: number;\n}\n\nexport function awsSqs(opts: AwsSqsAdapterOptions = {}): PubSubAdapter<never, AwsSqsSubscribeMeta> {\n  const codec = opts.codec ?? jsonCodec();\n  let client: SQSClient | null = null;\n  let idCounter = 0;\n\n  const ensure = (): SQSClient => {\n    if (client) return client;\n    if (opts.client) {\n      client = opts.client;\n    } else {\n      client = new SQSClient({ region: opts.region, ...opts.options });\n    }\n    return client;\n  };\n\n  return {\n    name: 'aws-sqs',\n    capabilities: { publish: false, subscribe: true, patternSubscribe: false, ack: true },\n\n    async connect() {\n      ensure();\n    },\n\n    async disconnect() {\n      if (client) client.destroy();\n      client = null;\n    },\n\n    async publish() {\n      throw new NotSupportedError(\n        'aws-sqs is subscribe-only. Use @pubber-subber/aws-sns (or another publish-capable adapter) ' +\n          'and compose them: `compose({ publisher: awsSns(), subscriber: awsSqs() })`.',\n      );\n    },\n\n    async subscribe(topic, handler, meta) {\n      const c = ensure();\n      const queueUrl = meta?.queueUrl ?? opts.queueUrl;\n      if (!queueUrl) {\n        throw new SubscriptionError(\n          'queueUrl is required (pass it in awsSqs({ queueUrl }) or meta.queueUrl).',\n        );\n      }\n      const waitTimeSeconds = meta?.waitTimeSeconds ?? 20;\n      const maxMessages = meta?.maxMessages ?? 10;\n      const concurrency = meta?.handlerConcurrency ?? 5;\n      const visibilityTimeout = meta?.visibilityTimeout;\n\n      let stopped = false;\n      const semaphore = new Semaphore(concurrency);\n      const inflight = new Set<Promise<unknown>>();\n\n      const loop = async (): Promise<void> => {\n        while (!stopped) {\n          try {\n            const resp = await c.send(\n              new ReceiveMessageCommand({\n                QueueUrl: queueUrl,\n                MaxNumberOfMessages: maxMessages,\n                WaitTimeSeconds: waitTimeSeconds,\n                VisibilityTimeout: visibilityTimeout,\n                MessageAttributeNames: ['All'],\n                MessageSystemAttributeNames: ['All'] as never,\n              }),\n            );\n            for (const m of resp.Messages ?? []) {\n              if (stopped) break;\n              await semaphore.acquire();\n              const task = processMessage(c, queueUrl, topic, m, handler, codec).finally(() => {\n                semaphore.release();\n                inflight.delete(task);\n              });\n              inflight.add(task);\n            }\n          } catch (err) {\n            if (stopped) break;\n            // Backoff briefly on receive errors so we don't hot-loop on a permission issue.\n            await sleep(1000);\n          }\n        }\n      };\n\n      void loop();\n\n      idCounter += 1;\n      const id = `sqs-${idCounter}`;\n      return {\n        id,\n        topic,\n        unsubscribe: async () => {\n          stopped = true;\n          await Promise.allSettled([...inflight]);\n        },\n      };\n    },\n  };\n}\n\nasync function processMessage(\n  client: SQSClient,\n  queueUrl: string,\n  topic: string,\n  message: SqsMessage,\n  handler: (msg: AdapterMessage) => void | Promise<void>,\n  codec: Codec,\n): Promise<void> {\n  const body = message.Body;\n  let payload: unknown = body;\n  let snsAttributes: Record<string, unknown> | undefined;\n\n  if (typeof body === 'string') {\n    try {\n      const parsed = JSON.parse(body);\n      if (\n        parsed &&\n        typeof parsed === 'object' &&\n        parsed.Type === 'Notification' &&\n        typeof parsed.Message === 'string'\n      ) {\n        // SNS→SQS envelope. Unwrap.\n        snsAttributes = parsed.MessageAttributes;\n        try {\n          payload = codec.decode(parsed.Message);\n        } catch {\n          payload = parsed.Message;\n        }\n      } else {\n        payload = codec.decode(body);\n      }\n    } catch {\n      payload = body;\n    }\n  }\n\n  const receiptHandle = message.ReceiptHandle ?? '';\n  let resolved = false;\n  const doAck = async (): Promise<void> => {\n    if (resolved) return;\n    resolved = true;\n    await client.send(\n      new DeleteMessageCommand({\n        QueueUrl: queueUrl,\n        ReceiptHandle: receiptHandle,\n      }),\n    );\n  };\n  const doNack = async (): Promise<void> => {\n    if (resolved) return;\n    resolved = true;\n    await client.send(\n      new ChangeMessageVisibilityCommand({\n        QueueUrl: queueUrl,\n        ReceiptHandle: receiptHandle,\n        VisibilityTimeout: 0,\n      }),\n    );\n  };\n\n  const adapterMsg: AdapterMessage = {\n    topic,\n    payload,\n    raw: message,\n    meta: {\n      messageId: message.MessageId,\n      receiptHandle: message.ReceiptHandle,\n      attributes: message.MessageAttributes,\n      systemAttributes: message.Attributes,\n      snsAttributes,\n    },\n    ack: doAck,\n    nack: doNack,\n  };\n\n  try {\n    await handler(adapterMsg);\n    await doAck();\n  } catch {\n    await doNack().catch(() => undefined);\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((r) => setTimeout(r, ms));\n}\n\nclass Semaphore {\n  #permits: number;\n  #waiters: Array<() => void> = [];\n\n  constructor(permits: number) {\n    this.#permits = permits;\n  }\n\n  async acquire(): Promise<void> {\n    if (this.#permits > 0) {\n      this.#permits -= 1;\n      return;\n    }\n    await new Promise<void>((resolve) => this.#waiters.push(resolve));\n    this.#permits -= 1;\n  }\n\n  release(): void {\n    this.#permits += 1;\n    const next = this.#waiters.shift();\n    if (next) next();\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@pubber-subber/aws-sqs",
+  "version": "0.0.1",
+  "description": "AWS SQS subscribe-only adapter for @pubber-subber. Pair with @pubber-subber/aws-sns via compose() for SNS→SQS fan-out.",
+  "keywords": [
+    "pubsub",
+    "pub-sub",
+    "messaging",
+    "events",
+    "adapter",
+    "aws",
+    "sqs",
+    "amazon",
+    "typescript"
+  ],
+  "homepage": "https://github.com/samishal1998/pubber-subber/tree/main/packages/aws-sqs#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/samishal1998/pubber-subber.git",
+    "directory": "packages/aws-sqs"
+  },
+  "bugs": {
+    "url": "https://github.com/samishal1998/pubber-subber/issues"
+  },
+  "author": "Sami Mishal",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist", "src", "README.md", "LICENSE"],
+  "scripts": {
+    "prebuild": "node ../../scripts/swap-package-json.mjs build",
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:integration": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "node ../../scripts/swap-package-json.mjs publish",
+    "postpublish": "node ../../scripts/swap-package-json.mjs build"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-sqs": "^3.0.0",
+    "@pubber-subber/core": "^0.0.1"
+  },
+  "devDependencies": {
+    "@pubber-subber/core": "workspace:*",
+    "@aws-sdk/client-sqs": "^3.700.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,246 @@
+import {
+  ChangeMessageVisibilityCommand,
+  DeleteMessageCommand,
+  ReceiveMessageCommand,
+  SQSClient,
+  type SQSClientConfig,
+  type Message as SqsMessage,
+} from '@aws-sdk/client-sqs';
+import {
+  type AdapterMessage,
+  type Codec,
+  NotSupportedError,
+  type PubSubAdapter,
+  SubscriptionError,
+  jsonCodec,
+} from '@pubber-subber/core';
+
+export interface AwsSqsAdapterOptions {
+  region?: string;
+  /** Default queue URL, used when no `meta.queueUrl` is provided on subscribe. */
+  queueUrl?: string;
+  client?: SQSClient;
+  options?: SQSClientConfig;
+  codec?: Codec;
+}
+
+export interface AwsSqsSubscribeMeta {
+  queueUrl?: string;
+  /** 0–20s. Default 20 (long polling). */
+  waitTimeSeconds?: number;
+  /** 1–10 per ReceiveMessage call. Default 10. */
+  maxMessages?: number;
+  /** Override the queue's default visibility timeout for received messages. */
+  visibilityTimeout?: number;
+  /** Max number of handler invocations in flight at once. Default 5. */
+  handlerConcurrency?: number;
+}
+
+export function awsSqs(opts: AwsSqsAdapterOptions = {}): PubSubAdapter<never, AwsSqsSubscribeMeta> {
+  const codec = opts.codec ?? jsonCodec();
+  let client: SQSClient | null = null;
+  let idCounter = 0;
+
+  const ensure = (): SQSClient => {
+    if (client) return client;
+    if (opts.client) {
+      client = opts.client;
+    } else {
+      client = new SQSClient({ region: opts.region, ...opts.options });
+    }
+    return client;
+  };
+
+  return {
+    name: 'aws-sqs',
+    capabilities: { publish: false, subscribe: true, patternSubscribe: false, ack: true },
+
+    async connect() {
+      ensure();
+    },
+
+    async disconnect() {
+      if (client) client.destroy();
+      client = null;
+    },
+
+    async publish() {
+      throw new NotSupportedError(
+        'aws-sqs is subscribe-only. Use @pubber-subber/aws-sns (or another publish-capable adapter) ' +
+          'and compose them: `compose({ publisher: awsSns(), subscriber: awsSqs() })`.',
+      );
+    },
+
+    async subscribe(topic, handler, meta) {
+      const c = ensure();
+      const queueUrl = meta?.queueUrl ?? opts.queueUrl;
+      if (!queueUrl) {
+        throw new SubscriptionError(
+          'queueUrl is required (pass it in awsSqs({ queueUrl }) or meta.queueUrl).',
+        );
+      }
+      const waitTimeSeconds = meta?.waitTimeSeconds ?? 20;
+      const maxMessages = meta?.maxMessages ?? 10;
+      const concurrency = meta?.handlerConcurrency ?? 5;
+      const visibilityTimeout = meta?.visibilityTimeout;
+
+      let stopped = false;
+      const semaphore = new Semaphore(concurrency);
+      const inflight = new Set<Promise<unknown>>();
+
+      const loop = async (): Promise<void> => {
+        while (!stopped) {
+          try {
+            const resp = await c.send(
+              new ReceiveMessageCommand({
+                QueueUrl: queueUrl,
+                MaxNumberOfMessages: maxMessages,
+                WaitTimeSeconds: waitTimeSeconds,
+                VisibilityTimeout: visibilityTimeout,
+                MessageAttributeNames: ['All'],
+                MessageSystemAttributeNames: ['All'] as never,
+              }),
+            );
+            for (const m of resp.Messages ?? []) {
+              if (stopped) break;
+              await semaphore.acquire();
+              const task = processMessage(c, queueUrl, topic, m, handler, codec).finally(() => {
+                semaphore.release();
+                inflight.delete(task);
+              });
+              inflight.add(task);
+            }
+          } catch (err) {
+            if (stopped) break;
+            // Backoff briefly on receive errors so we don't hot-loop on a permission issue.
+            await sleep(1000);
+          }
+        }
+      };
+
+      void loop();
+
+      idCounter += 1;
+      const id = `sqs-${idCounter}`;
+      return {
+        id,
+        topic,
+        unsubscribe: async () => {
+          stopped = true;
+          await Promise.allSettled([...inflight]);
+        },
+      };
+    },
+  };
+}
+
+async function processMessage(
+  client: SQSClient,
+  queueUrl: string,
+  topic: string,
+  message: SqsMessage,
+  handler: (msg: AdapterMessage) => void | Promise<void>,
+  codec: Codec,
+): Promise<void> {
+  const body = message.Body;
+  let payload: unknown = body;
+  let snsAttributes: Record<string, unknown> | undefined;
+
+  if (typeof body === 'string') {
+    try {
+      const parsed = JSON.parse(body);
+      if (
+        parsed &&
+        typeof parsed === 'object' &&
+        parsed.Type === 'Notification' &&
+        typeof parsed.Message === 'string'
+      ) {
+        // SNS→SQS envelope. Unwrap.
+        snsAttributes = parsed.MessageAttributes;
+        try {
+          payload = codec.decode(parsed.Message);
+        } catch {
+          payload = parsed.Message;
+        }
+      } else {
+        payload = codec.decode(body);
+      }
+    } catch {
+      payload = body;
+    }
+  }
+
+  const receiptHandle = message.ReceiptHandle ?? '';
+  let resolved = false;
+  const doAck = async (): Promise<void> => {
+    if (resolved) return;
+    resolved = true;
+    await client.send(
+      new DeleteMessageCommand({
+        QueueUrl: queueUrl,
+        ReceiptHandle: receiptHandle,
+      }),
+    );
+  };
+  const doNack = async (): Promise<void> => {
+    if (resolved) return;
+    resolved = true;
+    await client.send(
+      new ChangeMessageVisibilityCommand({
+        QueueUrl: queueUrl,
+        ReceiptHandle: receiptHandle,
+        VisibilityTimeout: 0,
+      }),
+    );
+  };
+
+  const adapterMsg: AdapterMessage = {
+    topic,
+    payload,
+    raw: message,
+    meta: {
+      messageId: message.MessageId,
+      receiptHandle: message.ReceiptHandle,
+      attributes: message.MessageAttributes,
+      systemAttributes: message.Attributes,
+      snsAttributes,
+    },
+    ack: doAck,
+    nack: doNack,
+  };
+
+  try {
+    await handler(adapterMsg);
+    await doAck();
+  } catch {
+    await doNack().catch(() => undefined);
+  }
+}
+
+function sleep(ms: number): Promise<void> {
+  return new Promise((r) => setTimeout(r, ms));
+}
+
+class Semaphore {
+  #permits: number;
+  #waiters: Array<() => void> = [];
+
+  constructor(permits: number) {
+    this.#permits = permits;
+  }
+
+  async acquire(): Promise<void> {
+    if (this.#permits > 0) {
+      this.#permits -= 1;
+      return;
+    }
+    await new Promise<void>((resolve) => this.#waiters.push(resolve));
+    this.#permits -= 1;
+  }
+
+  release(): void {
+    this.#permits += 1;
+    const next = this.#waiters.shift();
+    if (next) next();
+  }
+}