@dudousxd/nestjs-durable-transport-sqs 0.3.0 → 0.3.1

package/dist/index.cjs

@@ -30,6 +30,8 @@ var import_client_sqs = require("@aws-sdk/client-sqs");
 var import_nestjs_durable_core = require("@dudousxd/nestjs-durable-core");
 var SQS_BATCH_MAX = 10;
 var RESULT_VISIBILITY_SEC = 30;
+var RESULT_RECEIVERS = 8;
+var TASK_BATCHES_IN_FLIGHT = 10;
 var SqsTransport = class {
   static {
     __name(this, "SqsTransport");
@@ -294,6 +296,47 @@ var SqsTransport = class {
       } : void 0
     }));
   }
+  /**
+  * {@link dispatch} for many tasks: ten per `SendMessageBatch`, a few batches at a time. Throws if
+  * any entry failed (the engine then dispatches the batch again one task at a time).
+  */
+  async dispatchMany(tasks) {
+    const byGroup = /* @__PURE__ */ new Map();
+    for (const task of tasks) {
+      const grouped = byGroup.get(task.group);
+      if (grouped) grouped.push(task);
+      else byGroup.set(task.group, [
+        task
+      ]);
+    }
+    for (const [group, grouped] of byGroup) {
+      const QueueUrl = await this.tasksUrl(group);
+      const batches = [];
+      for (let at = 0; at < grouped.length; at += SQS_BATCH_MAX) {
+        batches.push(grouped.slice(at, at + SQS_BATCH_MAX));
+      }
+      for (let at = 0; at < batches.length; at += TASK_BATCHES_IN_FLIGHT) {
+        await Promise.all(batches.slice(at, at + TASK_BATCHES_IN_FLIGHT).map(async (batch) => {
+          const out = await this.client.send(new import_client_sqs.SendMessageBatchCommand({
+            QueueUrl,
+            Entries: batch.map((task, i) => ({
+              Id: String(i),
+              MessageBody: JSON.stringify(task),
+              MessageAttributes: this.marker ? {
+                [this.marker]: {
+                  DataType: "String",
+                  StringValue: "1"
+                }
+              } : void 0
+            }))
+          }));
+          if (out.Failed && out.Failed.length > 0) {
+            throw new Error(`SQS refused ${out.Failed.length} task(s): ${out.Failed.map((f) => f.Message ?? f.Code).join("; ")}`);
+          }
+        }));
+      }
+    }
+  }
   // ── worker → engine ────────────────────────────────────────────────────────────────────────
   /** Register a step handler (worker side). Starts the group's task consumer on first call. */
   handle(name, fn) {
@@ -302,19 +345,23 @@ var SqsTransport = class {
     if (!this.taskLoop) this.taskLoop = this.pollTasks(this.group);
   }
   onResult(handler) {
-    if (!this.resultLoop) this.resultLoop = this.pollResults(handler);
+    if (this.resultLoop) return;
+    this.resultLoop = Promise.all(Array.from({
+      length: RESULT_RECEIVERS
+    }, () => this.pollResults(handler))).then(() => void 0);
   }
   onHeartbeat(_handler) {
   }
   // ── polling loops ──────────────────────────────────────────────────────────────────────────
   /**
-  * Receive a batch and hand each message to `each`, one at a time, never letting a failure escape:
-  * a throw is reported through `onError` and its message is left on the queue (SQS redelivers it
-  * after the visibility timeout; a redrive policy DLQs one that keeps failing). Every message of the
-  * batch is kept invisible until it is handled (see {@link holdVisible}), so the ones waiting behind a
-  * slow handler are never redelivered to another consumer meanwhile.
+  * Receive a batch and hand each message to `each` — one at a time, or all at once when
+  * `concurrent` — never letting a failure escape: a throw is reported through `onError` and its
+  * message is left on the queue (SQS redelivers it after the visibility timeout; a redrive policy
+  * DLQs one that keeps failing). Every message of the batch is kept invisible until it is handled
+  * (see {@link holdVisible}), so the ones waiting behind a slow handler are never redelivered to
+  * another consumer meanwhile.
   */
-  async pollLoop(queueUrl, visibilitySec, each) {
+  async pollLoop(queueUrl, visibilitySec, each, concurrent = false) {
     while (this.running) {
       let QueueUrl;
       try {
@@ -328,20 +375,27 @@ var SqsTransport = class {
       const messages = await this.receive(QueueUrl, visibilitySec);
       const pending = new Set(messages);
       const stopHolding = this.holdVisible(QueueUrl, pending, visibilitySec);
-      try {
-        for (const msg of messages) {
-          if (!this.running) break;
-          try {
-            if (this.shouldSkip(msg)) {
-              pending.delete(msg);
-              await this.release(QueueUrl, msg.ReceiptHandle);
-              continue;
-            }
-            await each(QueueUrl, msg);
-          } catch (err) {
-            this.onError(err);
-          } finally {
+      const handle = /* @__PURE__ */ __name(async (msg) => {
+        try {
+          if (this.shouldSkip(msg)) {
             pending.delete(msg);
+            await this.release(QueueUrl, msg.ReceiptHandle);
+            return;
+          }
+          await each(QueueUrl, msg);
+        } catch (err) {
+          this.onError(err);
+        } finally {
+          pending.delete(msg);
+        }
+      }, "handle");
+      try {
+        if (concurrent) {
+          if (this.running) await Promise.all(messages.map(handle));
+        } else {
+          for (const msg of messages) {
+            if (!this.running) break;
+            await handle(msg);
           }
         }
       } finally {
@@ -403,7 +457,7 @@ var SqsTransport = class {
     return this.pollLoop(() => this.resultsUrl(), RESULT_VISIBILITY_SEC, async (QueueUrl, msg) => {
       await handler(this.parse(msg));
       await this.del(QueueUrl, msg.ReceiptHandle);
-    });
+    }, true);
   }
   /** Wait 1s, or until `close()` aborts. The abort listener is removed when the timer fires, so
   *  sustained failures never accumulate listeners on the shared signal. */

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/sqs-transport.ts"],"sourcesContent":["export * from './sqs-transport';\n","import {\n  ChangeMessageVisibilityCommand,\n  CreateQueueCommand,\n  DeleteMessageCommand,\n  GetQueueUrlCommand,\n  ReceiveMessageCommand,\n  SQSClient,\n  type SQSClientConfig,\n  SendMessageBatchCommand,\n  SendMessageCommand,\n} from '@aws-sdk/client-sqs';\nimport {\n  type Heartbeat,\n  type RemoteTask,\n  type RunConsumerOptions,\n  type RunDispatch,\n  type RunQueueOptions,\n  type StepHandler,\n  type StepResult,\n  type Transport,\n  runStepHandler,\n} from '@dudousxd/nestjs-durable-core';\n\n/** SQS's limit on the entries of one `SendMessageBatch`. */\nconst SQS_BATCH_MAX = 10;\n\n/** A run-queue consumer started by {@link SqsTransport.onDispatchedRun}. */\ninterface RunConsumer {\n  stopped: boolean;\n  abort: AbortController;\n  /** Receipt handles of the messages whose runs are in flight. */\n  inflight: Set<string>;\n  slotFreed: (() => void) | undefined;\n  /** Resolved, once stopped, when the runs in flight settled. */\n  idle: (() => void)[];\n  loop: Promise<void>;\n}\n\n/** Resolve a group's tasks queue URL. Sync or async; resolved once per group and cached (a rejected\n *  resolution is not cached — the next call asks again). */\nexport type QueueUrlResolver = (group: string) => string | Promise<string>;\n\nexport interface SqsTransportOptions {\n  /**\n   * Reuse an existing SQS client (recommended — share the app's). When omitted, one is built\n   * from `clientConfig` and destroyed on `close()`.\n   */\n  client?: SQSClient;\n  /** Used only when `client` is omitted — e.g. `{ region, endpoint, credentials }` for ElasticMQ. */\n  clientConfig?: SQSClientConfig;\n\n  /** The worker group this instance serves. Required to register `handle()` consumers. */\n  group?: string;\n\n  /**\n   * Map a group → an **existing** tasks queue URL. This is the seam for reusing queues you already\n   * have (e.g. `extraction`, `ingestion`) instead of letting the transport mint its own. When\n   * omitted, the transport resolves `${prefix}-tasks-${group}` by name (and creates it if\n   * `autoCreate`). Return value is awaited and cached per group.\n   */\n  taskQueueUrl?: QueueUrlResolver;\n  /**\n   * The results queue URL (worker → engine). A literal URL or a resolver. When omitted, the\n   * transport resolves `${prefix}-results` by name (and creates it if `autoCreate`).\n   */\n  resultsQueueUrl?: string | (() => string | Promise<string>);\n\n  /**\n   * The run queue URL for an engine namespace (undefined for an engine that drives every\n   * namespace): where the engine queues runs for whichever instance takes them first. When omitted,\n   * the transport resolves `${prefix}-runs` (or `${prefix}-runs-<namespace>`) by name, creating it\n   * if `autoCreate`. A FIFO queue (`.fifo`) gets one message group per run.\n   */\n  runsQueueUrl?: (namespace: string | undefined) => string | Promise<string>;\n\n  /** Prefix for the fallback `${prefix}-tasks-*` / `${prefix}-results` names. Default `durable`. */\n  prefix?: string;\n  /**\n   * Create the fallback-named queues on first use if they don't exist (handy for ElasticMQ / dev).\n   * Ignored for queues you supply via `taskQueueUrl` / `resultsQueueUrl` — those must already exist.\n   */\n  autoCreate?: boolean;\n\n  /**\n   * When set, durable messages carry this SQS message attribute and pollers **skip** messages\n   * that lack it (releasing them for a co-resident legacy consumer). Enables sharing one physical\n   * queue with a non-durable consumer — but only if that consumer likewise ignores tagged messages.\n   * Leave unset for the clean case: a queue dedicated to durable traffic.\n   */\n  marker?: string;\n\n  /** SQS receive long-poll seconds (0–20). Default 20. */\n  waitTimeSeconds?: number;\n  /**\n   * Visibility timeout for a received task, in seconds. Default 60. Every message this instance has\n   * received — the one running and the ones of the same batch waiting behind it — is kept invisible by\n   * re-extending it (`ChangeMessageVisibility`) every third of this, so a step may run longer; only a\n   * crashed instance's messages reappear, after at most this long.\n   */\n  visibilityTimeoutSec?: number;\n  /**\n   * Where a transport failure is reported: a failing receive, a result handler that throws, a result\n   * send that fails, a message whose body isn't JSON. The message involved is NOT deleted: SQS\n   * redelivers it after its visibility timeout, and a queue redrive policy (`maxReceiveCount` → DLQ)\n   * moves one that keeps failing aside. Default `console.error`.\n   */\n  onError?: (err: unknown) => void;\n}\n\n/** A received message, as the poll loops use it. */\ninterface Received {\n  Body?: string | undefined;\n  ReceiptHandle?: string | undefined;\n  MessageId?: string | undefined;\n  MessageAttributes?: Record<string, unknown> | undefined;\n}\n\n/** The results queue's visibility timeout (seconds). */\nconst RESULT_VISIBILITY_SEC = 30;\n\n/**\n * An SQS-backed `Transport` — dispatch remote steps over Amazon SQS (or ElasticMQ). Unlike the\n * BullMQ transport, it does **not** mint its own queue names: pass `taskQueueUrl` / `resultsQueueUrl`\n * to ride the queues you already operate. The wire payload is the documented `RemoteTask` /\n * `StepResult` JSON, so non-Node workers on the same queues interoperate.\n *\n * Run one instance engine-side (calls `onResult`, dispatches tasks) and one per worker process\n * (calls `handle()` for its group). SQS is at-least-once: a task whose process crashes before the\n * result is sent reappears after the visibility timeout (durable retry); a duplicate `StepResult`\n * is harmless because the engine resolves a step's `pending` exactly once by `stepId`.\n */\nexport class SqsTransport implements Transport {\n  private readonly client: SQSClient;\n  private readonly ownsClient: boolean;\n  private readonly group?: string | undefined;\n  private readonly prefix: string;\n  private readonly autoCreate: boolean;\n  private readonly marker?: string | undefined;\n  private readonly waitTimeSeconds: number;\n  private readonly visibilityTimeoutSec: number;\n  private readonly taskQueueUrlResolver?: QueueUrlResolver | undefined;\n  private readonly resultsQueueUrlOption?: string | (() => string | Promise<string>) | undefined;\n  private readonly runsQueueUrlResolver?:\n    | ((namespace: string | undefined) => string | Promise<string>)\n    | undefined;\n  private readonly runConsumers = new Set<RunConsumer>();\n  private readonly onError: (err: unknown) => void;\n\n  private readonly handlers = new Map<string, StepHandler>();\n  private readonly urlCache = new Map<string, string>();\n  /** `taskQueueUrl` resolutions per group (the promise, so concurrent dispatches share one call). */\n  private readonly groupUrlCache = new Map<string, Promise<string>>();\n  private running = true;\n  private readonly abort = new AbortController();\n  private taskLoop?: Promise<void>;\n  private resultLoop?: Promise<void>;\n\n  constructor(options: SqsTransportOptions) {\n    this.client = options.client ?? new SQSClient(options.clientConfig ?? {});\n    this.ownsClient = !options.client;\n    this.group = options.group;\n    this.prefix = options.prefix ?? 'durable';\n    this.autoCreate = options.autoCreate ?? false;\n    this.marker = options.marker;\n    this.waitTimeSeconds = options.waitTimeSeconds ?? 20;\n    this.visibilityTimeoutSec = options.visibilityTimeoutSec ?? 60;\n    this.taskQueueUrlResolver = options.taskQueueUrl;\n    this.resultsQueueUrlOption = options.resultsQueueUrl;\n    this.runsQueueUrlResolver = options.runsQueueUrl;\n    this.onError = options.onError ?? ((err) => console.error('[SqsTransport]', err));\n  }\n\n  // ── queue resolution ───────────────────────────────────────────────────────────────────────\n\n  private async resolveByName(name: string): Promise<string> {\n    const cached = this.urlCache.get(name);\n    if (cached) return cached;\n    let url: string;\n    try {\n      const out = await this.client.send(new GetQueueUrlCommand({ QueueName: name }));\n      url = out.QueueUrl as string;\n    } catch (err) {\n      if (this.autoCreate) {\n        const created = await this.client.send(new CreateQueueCommand({ QueueName: name }));\n        url = created.QueueUrl as string;\n      } else {\n        throw err;\n      }\n    }\n    this.urlCache.set(name, url);\n    return url;\n  }\n\n  private async tasksUrl(group: string): Promise<string> {\n    const resolver = this.taskQueueUrlResolver;\n    if (!resolver) return this.resolveByName(`${this.prefix}-tasks-${group}`);\n    let url = this.groupUrlCache.get(group);\n    if (!url) {\n      url = Promise.resolve()\n        .then(() => resolver(group))\n        .catch((err) => {\n          this.groupUrlCache.delete(group);\n          throw err;\n        });\n      this.groupUrlCache.set(group, url);\n    }\n    return url;\n  }\n\n  private async resultsUrl(): Promise<string> {\n    const opt = this.resultsQueueUrlOption;\n    if (typeof opt === 'string') return opt;\n    if (typeof opt === 'function') return opt();\n    return this.resolveByName(`${this.prefix}-results`);\n  }\n\n  private async runsUrl(namespace: string | undefined): Promise<string> {\n    if (this.runsQueueUrlResolver) return this.runsQueueUrlResolver(namespace);\n    const name = namespace ? `${this.prefix}-runs-${namespace}` : `${this.prefix}-runs`;\n    return this.resolveByName(name.replace(/[^A-Za-z0-9_-]/g, '-'));\n  }\n\n  // ── run queue (engine ↔ engine) ─────────────────────────────────────────────────────────────\n\n  /**\n   * Queue `pending` runs for whichever engine instance receives them first, ten per\n   * `SendMessageBatch`. SQS is at-least-once and a standard queue does not deduplicate, so a run may\n   * be received twice; the engine skips a run that is no longer due. Throws if any entry failed.\n   */\n  async dispatchRuns(runs: readonly RunDispatch[], opts?: RunQueueOptions): Promise<void> {\n    if (runs.length === 0) return;\n    const QueueUrl = await this.runsUrl(opts?.namespace);\n    const fifo = QueueUrl.endsWith('.fifo');\n    for (let at = 0; at < runs.length; at += SQS_BATCH_MAX) {\n      const chunk = runs.slice(at, at + SQS_BATCH_MAX);\n      const out = await this.client.send(\n        new SendMessageBatchCommand({\n          QueueUrl,\n          Entries: chunk.map((run, i) => ({\n            Id: String(i),\n            MessageBody: JSON.stringify(run),\n            MessageAttributes: this.marker\n              ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n              : undefined,\n            // FIFO: one group per run (runs are independent; only one run's entries are ordered),\n            // and a fresh deduplication id, so a run queued again later is not dropped as a repeat.\n            ...(fifo\n              ? {\n                  MessageGroupId: run.runId.slice(0, 128),\n                  MessageDeduplicationId: globalThis.crypto.randomUUID(),\n                }\n              : {}),\n          })),\n        }),\n      );\n      if (out.Failed && out.Failed.length > 0) {\n        throw new Error(\n          `SQS refused ${out.Failed.length} run(s): ${out.Failed.map((f) => f.Message ?? f.Code).join('; ')}`,\n        );\n      }\n    }\n  }\n\n  /**\n   * Receive from the run queue, at most `opts.concurrency` runs in flight on this instance. A\n   * message is deleted once its handler settles, and its visibility is extended meanwhile, so it\n   * reappears only after the instance holding it went down. The returned stop takes no more\n   * messages and resolves once the runs in flight settled.\n   */\n  onDispatchedRun(\n    handler: (run: RunDispatch) => Promise<void>,\n    opts: RunConsumerOptions,\n  ): () => Promise<void> {\n    const consumer: RunConsumer = {\n      stopped: false,\n      abort: new AbortController(),\n      inflight: new Set(),\n      slotFreed: undefined,\n      idle: [],\n      loop: Promise.resolve(),\n    };\n    consumer.loop = this.consumeRuns(\n      consumer,\n      handler,\n      Math.max(1, Math.floor(opts.concurrency)),\n      opts.namespace,\n    ).catch((err) => {\n      this.onError(err);\n    });\n    this.runConsumers.add(consumer);\n    return () => this.stopRunConsumer(consumer);\n  }\n\n  /**\n   * Stop taking messages and wait for the runs in flight. A receive still long-polling is not\n   * aborted, since SQS would keep what it hands an aborted request invisible for the visibility\n   * timeout: whatever it returns is released for another instance. `close()` aborts it.\n   */\n  private async stopRunConsumer(consumer: RunConsumer, abort = false): Promise<void> {\n    consumer.stopped = true;\n    consumer.slotFreed?.();\n    if (abort) consumer.abort.abort();\n    if (consumer.inflight.size > 0) {\n      await new Promise<void>((resolve) => consumer.idle.push(resolve));\n    }\n    if (abort) await consumer.loop;\n    this.runConsumers.delete(consumer);\n  }\n\n  private async consumeRuns(\n    consumer: RunConsumer,\n    handler: (run: RunDispatch) => Promise<void>,\n    concurrency: number,\n    namespace: string | undefined,\n  ): Promise<void> {\n    let QueueUrl: string | undefined;\n    while (QueueUrl === undefined && this.running && !consumer.stopped) {\n      try {\n        QueueUrl = await this.runsUrl(namespace);\n      } catch (err) {\n        this.onError(err);\n        await new Promise((r) => setTimeout(r, 1000));\n      }\n    }\n    if (QueueUrl === undefined) return;\n    const url = QueueUrl;\n    const extend = setInterval(\n      () => void this.extendRunVisibility(url, consumer),\n      Math.max(1_000, Math.floor((this.visibilityTimeoutSec * 1000) / 3)),\n    );\n    extend.unref?.();\n    const settled = new Set<Promise<unknown>>();\n    try {\n      while (this.running && !consumer.stopped) {\n        const free = concurrency - consumer.inflight.size;\n        if (free <= 0) {\n          await new Promise<void>((resolve) => {\n            consumer.slotFreed = resolve;\n          });\n          consumer.slotFreed = undefined;\n          continue;\n        }\n        const messages = await this.receiveRuns(url, Math.min(SQS_BATCH_MAX, free), consumer);\n        if (consumer.stopped) {\n          await Promise.allSettled(messages.map((m) => this.release(url, m.ReceiptHandle)));\n          break;\n        }\n        for (const msg of messages) {\n          if (this.shouldSkip(msg)) {\n            await this.release(url, msg.ReceiptHandle);\n            continue;\n          }\n          const receipt = msg.ReceiptHandle;\n          if (!receipt) continue;\n          const run = JSON.parse(msg.Body ?? '{}') as Partial<RunDispatch>;\n          if (typeof run.runId !== 'string') {\n            await this.del(url, receipt).catch(() => undefined);\n            continue;\n          }\n          consumer.inflight.add(receipt);\n          const done = handler(run as RunDispatch)\n            .catch(() => undefined)\n            .then(() => this.del(url, receipt).catch(() => undefined))\n            .finally(() => {\n              consumer.inflight.delete(receipt);\n              settled.delete(done);\n              consumer.slotFreed?.();\n              if (consumer.stopped && consumer.inflight.size === 0) {\n                for (const resolve of consumer.idle.splice(0)) resolve();\n              }\n            });\n          settled.add(done);\n        }\n      }\n      await Promise.allSettled([...settled]);\n    } finally {\n      clearInterval(extend);\n    }\n  }\n\n  private async receiveRuns(QueueUrl: string, max: number, consumer: RunConsumer) {\n    try {\n      const out = await this.client.send(\n        new ReceiveMessageCommand({\n          QueueUrl,\n          MaxNumberOfMessages: max,\n          WaitTimeSeconds: this.waitTimeSeconds,\n          VisibilityTimeout: this.visibilityTimeoutSec,\n          MessageAttributeNames: this.marker ? ['All'] : undefined,\n        }),\n        { abortSignal: consumer.abort.signal },\n      );\n      return out.Messages ?? [];\n    } catch (err) {\n      if (!this.running || consumer.stopped) return [];\n      this.onError(err);\n      await new Promise((r) => setTimeout(r, 1000));\n      return [];\n    }\n  }\n\n  /** Keep the messages of the runs in flight invisible, so a long turn is not received again. */\n  private async extendRunVisibility(QueueUrl: string, consumer: RunConsumer): Promise<void> {\n    await Promise.allSettled(\n      [...consumer.inflight].map((ReceiptHandle) =>\n        this.client.send(\n          new ChangeMessageVisibilityCommand({\n            QueueUrl,\n            ReceiptHandle,\n            VisibilityTimeout: this.visibilityTimeoutSec,\n          }),\n        ),\n      ),\n    );\n  }\n\n  // ── engine → worker ────────────────────────────────────────────────────────────────────────\n\n  async dispatch(task: RemoteTask): Promise<void> {\n    const QueueUrl = await this.tasksUrl(task.group);\n    await this.client.send(\n      new SendMessageCommand({\n        QueueUrl,\n        MessageBody: JSON.stringify(task),\n        MessageAttributes: this.marker\n          ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n          : undefined,\n      }),\n    );\n  }\n\n  // ── worker → engine ────────────────────────────────────────────────────────────────────────\n\n  /** Register a step handler (worker side). Starts the group's task consumer on first call. */\n  handle(name: string, fn: StepHandler): void {\n    if (!this.group) throw new Error('SqsTransport needs a `group` to register handlers');\n    this.handlers.set(name, fn);\n    if (!this.taskLoop) this.taskLoop = this.pollTasks(this.group);\n  }\n\n  onResult(handler: (result: StepResult) => Promise<void>): void {\n    if (!this.resultLoop) this.resultLoop = this.pollResults(handler);\n  }\n\n  onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void {\n    // Not modelled over SQS; the queue's visibility-timeout redelivery is the liveness mechanism.\n  }\n\n  // ── polling loops ──────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Receive a batch and hand each message to `each`, one at a time, never letting a failure escape:\n   * a throw is reported through `onError` and its message is left on the queue (SQS redelivers it\n   * after the visibility timeout; a redrive policy DLQs one that keeps failing). Every message of the\n   * batch is kept invisible until it is handled (see {@link holdVisible}), so the ones waiting behind a\n   * slow handler are never redelivered to another consumer meanwhile.\n   */\n  private async pollLoop(\n    queueUrl: () => Promise<string>,\n    visibilitySec: number,\n    each: (QueueUrl: string, msg: Received) => Promise<void>,\n  ): Promise<void> {\n    while (this.running) {\n      let QueueUrl: string;\n      try {\n        QueueUrl = await queueUrl();\n      } catch (err) {\n        if (!this.running) return;\n        this.onError(err);\n        await this.backoff();\n        continue;\n      }\n      const messages = await this.receive(QueueUrl, visibilitySec);\n      const pending = new Set<Received>(messages);\n      const stopHolding = this.holdVisible(QueueUrl, pending, visibilitySec);\n      try {\n        for (const msg of messages) {\n          if (!this.running) break; // close(): what is left reappears after its visibility timeout\n          try {\n            if (this.shouldSkip(msg)) {\n              // Not ours (shared queue): release immediately so the legacy consumer can take it.\n              pending.delete(msg);\n              await this.release(QueueUrl, msg.ReceiptHandle);\n              continue;\n            }\n            await each(QueueUrl, msg);\n          } catch (err) {\n            this.onError(err);\n          } finally {\n            pending.delete(msg);\n          }\n        }\n      } finally {\n        stopHolding();\n      }\n    }\n  }\n\n  /**\n   * Keep `messages` invisible while they wait or run: every third of the visibility timeout, extend\n   * each one still in the set back to the full timeout. Returns the stop function.\n   */\n  private holdVisible(\n    QueueUrl: string,\n    messages: Set<Received>,\n    visibilitySec: number,\n  ): () => void {\n    if (messages.size === 0) return () => {};\n    const intervalMs = Math.max(200, Math.floor((visibilitySec * 1000) / 3));\n    let round: Promise<void> | undefined;\n    const timer = setInterval(() => {\n      if (round) return;\n      round = Promise.all(\n        [...messages].map((msg) =>\n          msg.ReceiptHandle\n            ? this.client\n                .send(\n                  new ChangeMessageVisibilityCommand({\n                    QueueUrl,\n                    ReceiptHandle: msg.ReceiptHandle,\n                    VisibilityTimeout: visibilitySec,\n                  }),\n                )\n                .then(() => undefined)\n                .catch((err) => {\n                  if (this.running) this.onError(err);\n                })\n            : undefined,\n        ),\n      ).then(() => {\n        round = undefined;\n      });\n    }, intervalMs);\n    timer.unref?.();\n    return () => clearInterval(timer);\n  }\n\n  private parse<T>(msg: Received): T {\n    try {\n      return JSON.parse(msg.Body ?? '') as T;\n    } catch {\n      throw new Error(\n        `[SqsTransport] message ${msg.MessageId ?? '?'} has a non-JSON body; leaving it for the queue's redrive policy`,\n      );\n    }\n  }\n\n  private pollTasks(group: string): Promise<void> {\n    return this.pollLoop(\n      () => this.tasksUrl(group),\n      this.visibilityTimeoutSec,\n      async (QueueUrl, msg) => {\n        const task = this.parse<RemoteTask>(msg);\n        const result = await runStepHandler(task, this.handlers.get(task.name));\n        await this.client.send(\n          new SendMessageCommand({\n            QueueUrl: await this.resultsUrl(),\n            MessageBody: JSON.stringify(result),\n            MessageAttributes: this.marker\n              ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n              : undefined,\n          }),\n        );\n        await this.del(QueueUrl, msg.ReceiptHandle);\n      },\n    );\n  }\n\n  private pollResults(handler: (result: StepResult) => Promise<void>): Promise<void> {\n    return this.pollLoop(\n      () => this.resultsUrl(),\n      RESULT_VISIBILITY_SEC,\n      async (QueueUrl, msg) => {\n        await handler(this.parse<StepResult>(msg));\n        await this.del(QueueUrl, msg.ReceiptHandle);\n      },\n    );\n  }\n\n  /** Wait 1s, or until `close()` aborts. The abort listener is removed when the timer fires, so\n   *  sustained failures never accumulate listeners on the shared signal. */\n  private backoff(): Promise<void> {\n    return new Promise((resolve) => {\n      const signal = this.abort.signal;\n      if (signal.aborted) return resolve();\n      const onAbort = () => {\n        clearTimeout(timer);\n        resolve();\n      };\n      const timer = setTimeout(() => {\n        signal.removeEventListener('abort', onAbort);\n        resolve();\n      }, 1000);\n      signal.addEventListener('abort', onAbort, { once: true });\n    });\n  }\n\n  /** One long-poll receive. Swallows the abort thrown on `close()`; logs and backs off otherwise. */\n  private async receive(QueueUrl: string, visibility: number): Promise<Received[]> {\n    try {\n      const out = await this.client.send(\n        new ReceiveMessageCommand({\n          QueueUrl,\n          MaxNumberOfMessages: 10,\n          WaitTimeSeconds: this.waitTimeSeconds,\n          VisibilityTimeout: visibility,\n          MessageAttributeNames: this.marker ? ['All'] : undefined,\n        }),\n        { abortSignal: this.abort.signal },\n      );\n      return out.Messages ?? [];\n    } catch (err) {\n      if (!this.running) return [];\n      this.onError(err);\n      await this.backoff();\n      return [];\n    }\n  }\n\n  private shouldSkip(msg: { MessageAttributes?: Record<string, unknown> | undefined }): boolean {\n    return !!this.marker && !msg.MessageAttributes?.[this.marker];\n  }\n\n  private async del(QueueUrl: string, ReceiptHandle?: string): Promise<void> {\n    if (!ReceiptHandle) return;\n    await this.client.send(new DeleteMessageCommand({ QueueUrl, ReceiptHandle }));\n  }\n\n  private async release(QueueUrl: string, ReceiptHandle?: string): Promise<void> {\n    if (!ReceiptHandle) return;\n    await this.client\n      .send(new ChangeMessageVisibilityCommand({ QueueUrl, ReceiptHandle, VisibilityTimeout: 0 }))\n      .catch(() => {});\n  }\n\n  /** Stop the pollers and (if we created it) destroy the SQS client so the process can exit. */\n  async close(): Promise<void> {\n    this.running = false;\n    this.abort.abort();\n    await Promise.allSettled([\n      this.taskLoop,\n      this.resultLoop,\n      ...[...this.runConsumers].map((c) => this.stopRunConsumer(c, true)),\n    ]);\n    if (this.ownsClient) this.client.destroy();\n  }\n}\n"],"mappings":"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","names":["SQS_BATCH_MAX","RESULT_VISIBILITY_SEC","SqsTransport","client","ownsClient","group","prefix","autoCreate","marker","waitTimeSeconds","visibilityTimeoutSec","taskQueueUrlResolver","resultsQueueUrlOption","runsQueueUrlResolver","runConsumers","Set","onError","handlers","Map","urlCache","groupUrlCache","running","abort","AbortController","taskLoop","resultLoop","options","SQSClient","clientConfig","taskQueueUrl","resultsQueueUrl","runsQueueUrl","err","console","error","resolveByName","name","cached","get","url","out","send","GetQueueUrlCommand","QueueName","QueueUrl","created","CreateQueueCommand","set","tasksUrl","resolver","Promise","resolve","then","catch","delete","resultsUrl","opt","runsUrl","namespace","replace","dispatchRuns","runs","opts","length","fifo","endsWith","at","chunk","slice","SendMessageBatchCommand","Entries","map","run","i","Id","String","MessageBody","JSON","stringify","MessageAttributes","DataType","StringValue","undefined","MessageGroupId","runId","MessageDeduplicationId","globalThis","crypto","randomUUID","Failed","Error","f","Message","Code","join","onDispatchedRun","handler","consumer","stopped","inflight","slotFreed","idle","loop","consumeRuns","Math","max","floor","concurrency","add","stopRunConsumer","size","push","r","setTimeout","extend","setInterval","extendRunVisibility","unref","settled","free","messages","receiveRuns","min","allSettled","m","release","ReceiptHandle","msg","shouldSkip","receipt","parse","Body","del","done","finally","splice","clearInterval","ReceiveMessageCommand","MaxNumberOfMessages","WaitTimeSeconds","VisibilityTimeout","MessageAttributeNames","abortSignal","signal","Messages","ChangeMessageVisibilityCommand","dispatch","task","SendMessageCommand","handle","fn","pollTasks","onResult","pollResults","onHeartbeat","_handler","pollLoop","queueUrl","visibilitySec","each","backoff","receive","pending","stopHolding","holdVisible","intervalMs","round","timer","all","MessageId","result","runStepHandler","aborted","onAbort","clearTimeout","removeEventListener","addEventListener","once","visibility","DeleteMessageCommand","close","c","destroy"]}
+{"version":3,"sources":["../src/index.ts","../src/sqs-transport.ts"],"sourcesContent":["export * from './sqs-transport';\n","import {\n  ChangeMessageVisibilityCommand,\n  CreateQueueCommand,\n  DeleteMessageCommand,\n  GetQueueUrlCommand,\n  ReceiveMessageCommand,\n  SQSClient,\n  type SQSClientConfig,\n  SendMessageBatchCommand,\n  SendMessageCommand,\n} from '@aws-sdk/client-sqs';\nimport {\n  type Heartbeat,\n  type RemoteTask,\n  type RunConsumerOptions,\n  type RunDispatch,\n  type RunQueueOptions,\n  type StepHandler,\n  type StepResult,\n  type Transport,\n  runStepHandler,\n} from '@dudousxd/nestjs-durable-core';\n\n/** SQS's limit on the entries of one `SendMessageBatch`. */\nconst SQS_BATCH_MAX = 10;\n\n/** A run-queue consumer started by {@link SqsTransport.onDispatchedRun}. */\ninterface RunConsumer {\n  stopped: boolean;\n  abort: AbortController;\n  /** Receipt handles of the messages whose runs are in flight. */\n  inflight: Set<string>;\n  slotFreed: (() => void) | undefined;\n  /** Resolved, once stopped, when the runs in flight settled. */\n  idle: (() => void)[];\n  loop: Promise<void>;\n}\n\n/** Resolve a group's tasks queue URL. Sync or async; resolved once per group and cached (a rejected\n *  resolution is not cached — the next call asks again). */\nexport type QueueUrlResolver = (group: string) => string | Promise<string>;\n\nexport interface SqsTransportOptions {\n  /**\n   * Reuse an existing SQS client (recommended — share the app's). When omitted, one is built\n   * from `clientConfig` and destroyed on `close()`.\n   */\n  client?: SQSClient;\n  /** Used only when `client` is omitted — e.g. `{ region, endpoint, credentials }` for ElasticMQ. */\n  clientConfig?: SQSClientConfig;\n\n  /** The worker group this instance serves. Required to register `handle()` consumers. */\n  group?: string;\n\n  /**\n   * Map a group → an **existing** tasks queue URL. This is the seam for reusing queues you already\n   * have (e.g. `extraction`, `ingestion`) instead of letting the transport mint its own. When\n   * omitted, the transport resolves `${prefix}-tasks-${group}` by name (and creates it if\n   * `autoCreate`). Return value is awaited and cached per group.\n   */\n  taskQueueUrl?: QueueUrlResolver;\n  /**\n   * The results queue URL (worker → engine). A literal URL or a resolver. When omitted, the\n   * transport resolves `${prefix}-results` by name (and creates it if `autoCreate`).\n   */\n  resultsQueueUrl?: string | (() => string | Promise<string>);\n\n  /**\n   * The run queue URL for an engine namespace (undefined for an engine that drives every\n   * namespace): where the engine queues runs for whichever instance takes them first. When omitted,\n   * the transport resolves `${prefix}-runs` (or `${prefix}-runs-<namespace>`) by name, creating it\n   * if `autoCreate`. A FIFO queue (`.fifo`) gets one message group per run.\n   */\n  runsQueueUrl?: (namespace: string | undefined) => string | Promise<string>;\n\n  /** Prefix for the fallback `${prefix}-tasks-*` / `${prefix}-results` names. Default `durable`. */\n  prefix?: string;\n  /**\n   * Create the fallback-named queues on first use if they don't exist (handy for ElasticMQ / dev).\n   * Ignored for queues you supply via `taskQueueUrl` / `resultsQueueUrl` — those must already exist.\n   */\n  autoCreate?: boolean;\n\n  /**\n   * When set, durable messages carry this SQS message attribute and pollers **skip** messages\n   * that lack it (releasing them for a co-resident legacy consumer). Enables sharing one physical\n   * queue with a non-durable consumer — but only if that consumer likewise ignores tagged messages.\n   * Leave unset for the clean case: a queue dedicated to durable traffic.\n   */\n  marker?: string;\n\n  /** SQS receive long-poll seconds (0–20). Default 20. */\n  waitTimeSeconds?: number;\n  /**\n   * Visibility timeout for a received task, in seconds. Default 60. Every message this instance has\n   * received — the one running and the ones of the same batch waiting behind it — is kept invisible by\n   * re-extending it (`ChangeMessageVisibility`) every third of this, so a step may run longer; only a\n   * crashed instance's messages reappear, after at most this long.\n   */\n  visibilityTimeoutSec?: number;\n  /**\n   * Where a transport failure is reported: a failing receive, a result handler that throws, a result\n   * send that fails, a message whose body isn't JSON. The message involved is NOT deleted: SQS\n   * redelivers it after its visibility timeout, and a queue redrive policy (`maxReceiveCount` → DLQ)\n   * moves one that keeps failing aside. Default `console.error`.\n   */\n  onError?: (err: unknown) => void;\n}\n\n/** A received message, as the poll loops use it. */\ninterface Received {\n  Body?: string | undefined;\n  ReceiptHandle?: string | undefined;\n  MessageId?: string | undefined;\n  MessageAttributes?: Record<string, unknown> | undefined;\n}\n\n/** The results queue's visibility timeout (seconds). */\nconst RESULT_VISIBILITY_SEC = 30;\n\n/**\n * How many receive loops consume the results queue on one instance. Each hands every message of a\n * receive to the engine at once, so up to this many times ten results are in flight here: the\n * engine writes one run's waiting results together, so a wide fan settles in few writes.\n */\nconst RESULT_RECEIVERS = 8;\n\n/** `SendMessageBatch` calls {@link SqsTransport.dispatchMany} has in flight at once. */\nconst TASK_BATCHES_IN_FLIGHT = 10;\n\n/**\n * An SQS-backed `Transport` — dispatch remote steps over Amazon SQS (or ElasticMQ). Unlike the\n * BullMQ transport, it does **not** mint its own queue names: pass `taskQueueUrl` / `resultsQueueUrl`\n * to ride the queues you already operate. The wire payload is the documented `RemoteTask` /\n * `StepResult` JSON, so non-Node workers on the same queues interoperate.\n *\n * Run one instance engine-side (calls `onResult`, dispatches tasks) and one per worker process\n * (calls `handle()` for its group). SQS is at-least-once: a task whose process crashes before the\n * result is sent reappears after the visibility timeout (durable retry); a duplicate `StepResult`\n * is harmless because the engine resolves a step's `pending` exactly once by `stepId`.\n */\nexport class SqsTransport implements Transport {\n  private readonly client: SQSClient;\n  private readonly ownsClient: boolean;\n  private readonly group?: string | undefined;\n  private readonly prefix: string;\n  private readonly autoCreate: boolean;\n  private readonly marker?: string | undefined;\n  private readonly waitTimeSeconds: number;\n  private readonly visibilityTimeoutSec: number;\n  private readonly taskQueueUrlResolver?: QueueUrlResolver | undefined;\n  private readonly resultsQueueUrlOption?: string | (() => string | Promise<string>) | undefined;\n  private readonly runsQueueUrlResolver?:\n    | ((namespace: string | undefined) => string | Promise<string>)\n    | undefined;\n  private readonly runConsumers = new Set<RunConsumer>();\n  private readonly onError: (err: unknown) => void;\n\n  private readonly handlers = new Map<string, StepHandler>();\n  private readonly urlCache = new Map<string, string>();\n  /** `taskQueueUrl` resolutions per group (the promise, so concurrent dispatches share one call). */\n  private readonly groupUrlCache = new Map<string, Promise<string>>();\n  private running = true;\n  private readonly abort = new AbortController();\n  private taskLoop?: Promise<void>;\n  private resultLoop?: Promise<void>;\n\n  constructor(options: SqsTransportOptions) {\n    this.client = options.client ?? new SQSClient(options.clientConfig ?? {});\n    this.ownsClient = !options.client;\n    this.group = options.group;\n    this.prefix = options.prefix ?? 'durable';\n    this.autoCreate = options.autoCreate ?? false;\n    this.marker = options.marker;\n    this.waitTimeSeconds = options.waitTimeSeconds ?? 20;\n    this.visibilityTimeoutSec = options.visibilityTimeoutSec ?? 60;\n    this.taskQueueUrlResolver = options.taskQueueUrl;\n    this.resultsQueueUrlOption = options.resultsQueueUrl;\n    this.runsQueueUrlResolver = options.runsQueueUrl;\n    this.onError = options.onError ?? ((err) => console.error('[SqsTransport]', err));\n  }\n\n  // ── queue resolution ───────────────────────────────────────────────────────────────────────\n\n  private async resolveByName(name: string): Promise<string> {\n    const cached = this.urlCache.get(name);\n    if (cached) return cached;\n    let url: string;\n    try {\n      const out = await this.client.send(new GetQueueUrlCommand({ QueueName: name }));\n      url = out.QueueUrl as string;\n    } catch (err) {\n      if (this.autoCreate) {\n        const created = await this.client.send(new CreateQueueCommand({ QueueName: name }));\n        url = created.QueueUrl as string;\n      } else {\n        throw err;\n      }\n    }\n    this.urlCache.set(name, url);\n    return url;\n  }\n\n  private async tasksUrl(group: string): Promise<string> {\n    const resolver = this.taskQueueUrlResolver;\n    if (!resolver) return this.resolveByName(`${this.prefix}-tasks-${group}`);\n    let url = this.groupUrlCache.get(group);\n    if (!url) {\n      url = Promise.resolve()\n        .then(() => resolver(group))\n        .catch((err) => {\n          this.groupUrlCache.delete(group);\n          throw err;\n        });\n      this.groupUrlCache.set(group, url);\n    }\n    return url;\n  }\n\n  private async resultsUrl(): Promise<string> {\n    const opt = this.resultsQueueUrlOption;\n    if (typeof opt === 'string') return opt;\n    if (typeof opt === 'function') return opt();\n    return this.resolveByName(`${this.prefix}-results`);\n  }\n\n  private async runsUrl(namespace: string | undefined): Promise<string> {\n    if (this.runsQueueUrlResolver) return this.runsQueueUrlResolver(namespace);\n    const name = namespace ? `${this.prefix}-runs-${namespace}` : `${this.prefix}-runs`;\n    return this.resolveByName(name.replace(/[^A-Za-z0-9_-]/g, '-'));\n  }\n\n  // ── run queue (engine ↔ engine) ─────────────────────────────────────────────────────────────\n\n  /**\n   * Queue `pending` runs for whichever engine instance receives them first, ten per\n   * `SendMessageBatch`. SQS is at-least-once and a standard queue does not deduplicate, so a run may\n   * be received twice; the engine skips a run that is no longer due. Throws if any entry failed.\n   */\n  async dispatchRuns(runs: readonly RunDispatch[], opts?: RunQueueOptions): Promise<void> {\n    if (runs.length === 0) return;\n    const QueueUrl = await this.runsUrl(opts?.namespace);\n    const fifo = QueueUrl.endsWith('.fifo');\n    for (let at = 0; at < runs.length; at += SQS_BATCH_MAX) {\n      const chunk = runs.slice(at, at + SQS_BATCH_MAX);\n      const out = await this.client.send(\n        new SendMessageBatchCommand({\n          QueueUrl,\n          Entries: chunk.map((run, i) => ({\n            Id: String(i),\n            MessageBody: JSON.stringify(run),\n            MessageAttributes: this.marker\n              ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n              : undefined,\n            // FIFO: one group per run (runs are independent; only one run's entries are ordered),\n            // and a fresh deduplication id, so a run queued again later is not dropped as a repeat.\n            ...(fifo\n              ? {\n                  MessageGroupId: run.runId.slice(0, 128),\n                  MessageDeduplicationId: globalThis.crypto.randomUUID(),\n                }\n              : {}),\n          })),\n        }),\n      );\n      if (out.Failed && out.Failed.length > 0) {\n        throw new Error(\n          `SQS refused ${out.Failed.length} run(s): ${out.Failed.map((f) => f.Message ?? f.Code).join('; ')}`,\n        );\n      }\n    }\n  }\n\n  /**\n   * Receive from the run queue, at most `opts.concurrency` runs in flight on this instance. A\n   * message is deleted once its handler settles, and its visibility is extended meanwhile, so it\n   * reappears only after the instance holding it went down. The returned stop takes no more\n   * messages and resolves once the runs in flight settled.\n   */\n  onDispatchedRun(\n    handler: (run: RunDispatch) => Promise<void>,\n    opts: RunConsumerOptions,\n  ): () => Promise<void> {\n    const consumer: RunConsumer = {\n      stopped: false,\n      abort: new AbortController(),\n      inflight: new Set(),\n      slotFreed: undefined,\n      idle: [],\n      loop: Promise.resolve(),\n    };\n    consumer.loop = this.consumeRuns(\n      consumer,\n      handler,\n      Math.max(1, Math.floor(opts.concurrency)),\n      opts.namespace,\n    ).catch((err) => {\n      this.onError(err);\n    });\n    this.runConsumers.add(consumer);\n    return () => this.stopRunConsumer(consumer);\n  }\n\n  /**\n   * Stop taking messages and wait for the runs in flight. A receive still long-polling is not\n   * aborted, since SQS would keep what it hands an aborted request invisible for the visibility\n   * timeout: whatever it returns is released for another instance. `close()` aborts it.\n   */\n  private async stopRunConsumer(consumer: RunConsumer, abort = false): Promise<void> {\n    consumer.stopped = true;\n    consumer.slotFreed?.();\n    if (abort) consumer.abort.abort();\n    if (consumer.inflight.size > 0) {\n      await new Promise<void>((resolve) => consumer.idle.push(resolve));\n    }\n    if (abort) await consumer.loop;\n    this.runConsumers.delete(consumer);\n  }\n\n  private async consumeRuns(\n    consumer: RunConsumer,\n    handler: (run: RunDispatch) => Promise<void>,\n    concurrency: number,\n    namespace: string | undefined,\n  ): Promise<void> {\n    let QueueUrl: string | undefined;\n    while (QueueUrl === undefined && this.running && !consumer.stopped) {\n      try {\n        QueueUrl = await this.runsUrl(namespace);\n      } catch (err) {\n        this.onError(err);\n        await new Promise((r) => setTimeout(r, 1000));\n      }\n    }\n    if (QueueUrl === undefined) return;\n    const url = QueueUrl;\n    const extend = setInterval(\n      () => void this.extendRunVisibility(url, consumer),\n      Math.max(1_000, Math.floor((this.visibilityTimeoutSec * 1000) / 3)),\n    );\n    extend.unref?.();\n    const settled = new Set<Promise<unknown>>();\n    try {\n      while (this.running && !consumer.stopped) {\n        const free = concurrency - consumer.inflight.size;\n        if (free <= 0) {\n          await new Promise<void>((resolve) => {\n            consumer.slotFreed = resolve;\n          });\n          consumer.slotFreed = undefined;\n          continue;\n        }\n        const messages = await this.receiveRuns(url, Math.min(SQS_BATCH_MAX, free), consumer);\n        if (consumer.stopped) {\n          await Promise.allSettled(messages.map((m) => this.release(url, m.ReceiptHandle)));\n          break;\n        }\n        for (const msg of messages) {\n          if (this.shouldSkip(msg)) {\n            await this.release(url, msg.ReceiptHandle);\n            continue;\n          }\n          const receipt = msg.ReceiptHandle;\n          if (!receipt) continue;\n          const run = JSON.parse(msg.Body ?? '{}') as Partial<RunDispatch>;\n          if (typeof run.runId !== 'string') {\n            await this.del(url, receipt).catch(() => undefined);\n            continue;\n          }\n          consumer.inflight.add(receipt);\n          const done = handler(run as RunDispatch)\n            .catch(() => undefined)\n            .then(() => this.del(url, receipt).catch(() => undefined))\n            .finally(() => {\n              consumer.inflight.delete(receipt);\n              settled.delete(done);\n              consumer.slotFreed?.();\n              if (consumer.stopped && consumer.inflight.size === 0) {\n                for (const resolve of consumer.idle.splice(0)) resolve();\n              }\n            });\n          settled.add(done);\n        }\n      }\n      await Promise.allSettled([...settled]);\n    } finally {\n      clearInterval(extend);\n    }\n  }\n\n  private async receiveRuns(QueueUrl: string, max: number, consumer: RunConsumer) {\n    try {\n      const out = await this.client.send(\n        new ReceiveMessageCommand({\n          QueueUrl,\n          MaxNumberOfMessages: max,\n          WaitTimeSeconds: this.waitTimeSeconds,\n          VisibilityTimeout: this.visibilityTimeoutSec,\n          MessageAttributeNames: this.marker ? ['All'] : undefined,\n        }),\n        { abortSignal: consumer.abort.signal },\n      );\n      return out.Messages ?? [];\n    } catch (err) {\n      if (!this.running || consumer.stopped) return [];\n      this.onError(err);\n      await new Promise((r) => setTimeout(r, 1000));\n      return [];\n    }\n  }\n\n  /** Keep the messages of the runs in flight invisible, so a long turn is not received again. */\n  private async extendRunVisibility(QueueUrl: string, consumer: RunConsumer): Promise<void> {\n    await Promise.allSettled(\n      [...consumer.inflight].map((ReceiptHandle) =>\n        this.client.send(\n          new ChangeMessageVisibilityCommand({\n            QueueUrl,\n            ReceiptHandle,\n            VisibilityTimeout: this.visibilityTimeoutSec,\n          }),\n        ),\n      ),\n    );\n  }\n\n  // ── engine → worker ────────────────────────────────────────────────────────────────────────\n\n  async dispatch(task: RemoteTask): Promise<void> {\n    const QueueUrl = await this.tasksUrl(task.group);\n    await this.client.send(\n      new SendMessageCommand({\n        QueueUrl,\n        MessageBody: JSON.stringify(task),\n        MessageAttributes: this.marker\n          ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n          : undefined,\n      }),\n    );\n  }\n\n  /**\n   * {@link dispatch} for many tasks: ten per `SendMessageBatch`, a few batches at a time. Throws if\n   * any entry failed (the engine then dispatches the batch again one task at a time).\n   */\n  async dispatchMany(tasks: RemoteTask[]): Promise<void> {\n    const byGroup = new Map<string, RemoteTask[]>();\n    for (const task of tasks) {\n      const grouped = byGroup.get(task.group);\n      if (grouped) grouped.push(task);\n      else byGroup.set(task.group, [task]);\n    }\n    for (const [group, grouped] of byGroup) {\n      const QueueUrl = await this.tasksUrl(group);\n      const batches: RemoteTask[][] = [];\n      for (let at = 0; at < grouped.length; at += SQS_BATCH_MAX) {\n        batches.push(grouped.slice(at, at + SQS_BATCH_MAX));\n      }\n      for (let at = 0; at < batches.length; at += TASK_BATCHES_IN_FLIGHT) {\n        await Promise.all(\n          batches.slice(at, at + TASK_BATCHES_IN_FLIGHT).map(async (batch) => {\n            const out = await this.client.send(\n              new SendMessageBatchCommand({\n                QueueUrl,\n                Entries: batch.map((task, i) => ({\n                  Id: String(i),\n                  MessageBody: JSON.stringify(task),\n                  MessageAttributes: this.marker\n                    ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n                    : undefined,\n                })),\n              }),\n            );\n            if (out.Failed && out.Failed.length > 0) {\n              throw new Error(\n                `SQS refused ${out.Failed.length} task(s): ${out.Failed.map((f) => f.Message ?? f.Code).join('; ')}`,\n              );\n            }\n          }),\n        );\n      }\n    }\n  }\n\n  // ── worker → engine ────────────────────────────────────────────────────────────────────────\n\n  /** Register a step handler (worker side). Starts the group's task consumer on first call. */\n  handle(name: string, fn: StepHandler): void {\n    if (!this.group) throw new Error('SqsTransport needs a `group` to register handlers');\n    this.handlers.set(name, fn);\n    if (!this.taskLoop) this.taskLoop = this.pollTasks(this.group);\n  }\n\n  onResult(handler: (result: StepResult) => Promise<void>): void {\n    if (this.resultLoop) return;\n    this.resultLoop = Promise.all(\n      Array.from({ length: RESULT_RECEIVERS }, () => this.pollResults(handler)),\n    ).then(() => undefined);\n  }\n\n  onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void {\n    // Not modelled over SQS; the queue's visibility-timeout redelivery is the liveness mechanism.\n  }\n\n  // ── polling loops ──────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Receive a batch and hand each message to `each` — one at a time, or all at once when\n   * `concurrent` — never letting a failure escape: a throw is reported through `onError` and its\n   * message is left on the queue (SQS redelivers it after the visibility timeout; a redrive policy\n   * DLQs one that keeps failing). Every message of the batch is kept invisible until it is handled\n   * (see {@link holdVisible}), so the ones waiting behind a slow handler are never redelivered to\n   * another consumer meanwhile.\n   */\n  private async pollLoop(\n    queueUrl: () => Promise<string>,\n    visibilitySec: number,\n    each: (QueueUrl: string, msg: Received) => Promise<void>,\n    concurrent = false,\n  ): Promise<void> {\n    while (this.running) {\n      let QueueUrl: string;\n      try {\n        QueueUrl = await queueUrl();\n      } catch (err) {\n        if (!this.running) return;\n        this.onError(err);\n        await this.backoff();\n        continue;\n      }\n      const messages = await this.receive(QueueUrl, visibilitySec);\n      const pending = new Set<Received>(messages);\n      const stopHolding = this.holdVisible(QueueUrl, pending, visibilitySec);\n      const handle = async (msg: Received): Promise<void> => {\n        try {\n          if (this.shouldSkip(msg)) {\n            // Not ours (shared queue): release immediately so the legacy consumer can take it.\n            pending.delete(msg);\n            await this.release(QueueUrl, msg.ReceiptHandle);\n            return;\n          }\n          await each(QueueUrl, msg);\n        } catch (err) {\n          this.onError(err);\n        } finally {\n          pending.delete(msg);\n        }\n      };\n      try {\n        if (concurrent) {\n          if (this.running) await Promise.all(messages.map(handle));\n        } else {\n          for (const msg of messages) {\n            if (!this.running) break; // close(): what is left reappears after its visibility timeout\n            await handle(msg);\n          }\n        }\n      } finally {\n        stopHolding();\n      }\n    }\n  }\n\n  /**\n   * Keep `messages` invisible while they wait or run: every third of the visibility timeout, extend\n   * each one still in the set back to the full timeout. Returns the stop function.\n   */\n  private holdVisible(\n    QueueUrl: string,\n    messages: Set<Received>,\n    visibilitySec: number,\n  ): () => void {\n    if (messages.size === 0) return () => {};\n    const intervalMs = Math.max(200, Math.floor((visibilitySec * 1000) / 3));\n    let round: Promise<void> | undefined;\n    const timer = setInterval(() => {\n      if (round) return;\n      round = Promise.all(\n        [...messages].map((msg) =>\n          msg.ReceiptHandle\n            ? this.client\n                .send(\n                  new ChangeMessageVisibilityCommand({\n                    QueueUrl,\n                    ReceiptHandle: msg.ReceiptHandle,\n                    VisibilityTimeout: visibilitySec,\n                  }),\n                )\n                .then(() => undefined)\n                .catch((err) => {\n                  if (this.running) this.onError(err);\n                })\n            : undefined,\n        ),\n      ).then(() => {\n        round = undefined;\n      });\n    }, intervalMs);\n    timer.unref?.();\n    return () => clearInterval(timer);\n  }\n\n  private parse<T>(msg: Received): T {\n    try {\n      return JSON.parse(msg.Body ?? '') as T;\n    } catch {\n      throw new Error(\n        `[SqsTransport] message ${msg.MessageId ?? '?'} has a non-JSON body; leaving it for the queue's redrive policy`,\n      );\n    }\n  }\n\n  private pollTasks(group: string): Promise<void> {\n    return this.pollLoop(\n      () => this.tasksUrl(group),\n      this.visibilityTimeoutSec,\n      async (QueueUrl, msg) => {\n        const task = this.parse<RemoteTask>(msg);\n        const result = await runStepHandler(task, this.handlers.get(task.name));\n        await this.client.send(\n          new SendMessageCommand({\n            QueueUrl: await this.resultsUrl(),\n            MessageBody: JSON.stringify(result),\n            MessageAttributes: this.marker\n              ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n              : undefined,\n          }),\n        );\n        await this.del(QueueUrl, msg.ReceiptHandle);\n      },\n    );\n  }\n\n  private pollResults(handler: (result: StepResult) => Promise<void>): Promise<void> {\n    return this.pollLoop(\n      () => this.resultsUrl(),\n      RESULT_VISIBILITY_SEC,\n      async (QueueUrl, msg) => {\n        await handler(this.parse<StepResult>(msg));\n        await this.del(QueueUrl, msg.ReceiptHandle);\n      },\n      true,\n    );\n  }\n\n  /** Wait 1s, or until `close()` aborts. The abort listener is removed when the timer fires, so\n   *  sustained failures never accumulate listeners on the shared signal. */\n  private backoff(): Promise<void> {\n    return new Promise((resolve) => {\n      const signal = this.abort.signal;\n      if (signal.aborted) return resolve();\n      const onAbort = () => {\n        clearTimeout(timer);\n        resolve();\n      };\n      const timer = setTimeout(() => {\n        signal.removeEventListener('abort', onAbort);\n        resolve();\n      }, 1000);\n      signal.addEventListener('abort', onAbort, { once: true });\n    });\n  }\n\n  /** One long-poll receive. Swallows the abort thrown on `close()`; logs and backs off otherwise. */\n  private async receive(QueueUrl: string, visibility: number): Promise<Received[]> {\n    try {\n      const out = await this.client.send(\n        new ReceiveMessageCommand({\n          QueueUrl,\n          MaxNumberOfMessages: 10,\n          WaitTimeSeconds: this.waitTimeSeconds,\n          VisibilityTimeout: visibility,\n          MessageAttributeNames: this.marker ? ['All'] : undefined,\n        }),\n        { abortSignal: this.abort.signal },\n      );\n      return out.Messages ?? [];\n    } catch (err) {\n      if (!this.running) return [];\n      this.onError(err);\n      await this.backoff();\n      return [];\n    }\n  }\n\n  private shouldSkip(msg: { MessageAttributes?: Record<string, unknown> | undefined }): boolean {\n    return !!this.marker && !msg.MessageAttributes?.[this.marker];\n  }\n\n  private async del(QueueUrl: string, ReceiptHandle?: string): Promise<void> {\n    if (!ReceiptHandle) return;\n    await this.client.send(new DeleteMessageCommand({ QueueUrl, ReceiptHandle }));\n  }\n\n  private async release(QueueUrl: string, ReceiptHandle?: string): Promise<void> {\n    if (!ReceiptHandle) return;\n    await this.client\n      .send(new ChangeMessageVisibilityCommand({ QueueUrl, ReceiptHandle, VisibilityTimeout: 0 }))\n      .catch(() => {});\n  }\n\n  /** Stop the pollers and (if we created it) destroy the SQS client so the process can exit. */\n  async close(): Promise<void> {\n    this.running = false;\n    this.abort.abort();\n    await Promise.allSettled([\n      this.taskLoop,\n      this.resultLoop,\n      ...[...this.runConsumers].map((c) => this.stopRunConsumer(c, true)),\n    ]);\n    if (this.ownsClient) this.client.destroy();\n  }\n}\n"],"mappings":"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","names":["SQS_BATCH_MAX","RESULT_VISIBILITY_SEC","RESULT_RECEIVERS","TASK_BATCHES_IN_FLIGHT","SqsTransport","client","ownsClient","group","prefix","autoCreate","marker","waitTimeSeconds","visibilityTimeoutSec","taskQueueUrlResolver","resultsQueueUrlOption","runsQueueUrlResolver","runConsumers","Set","onError","handlers","Map","urlCache","groupUrlCache","running","abort","AbortController","taskLoop","resultLoop","options","SQSClient","clientConfig","taskQueueUrl","resultsQueueUrl","runsQueueUrl","err","console","error","resolveByName","name","cached","get","url","out","send","GetQueueUrlCommand","QueueName","QueueUrl","created","CreateQueueCommand","set","tasksUrl","resolver","Promise","resolve","then","catch","delete","resultsUrl","opt","runsUrl","namespace","replace","dispatchRuns","runs","opts","length","fifo","endsWith","at","chunk","slice","SendMessageBatchCommand","Entries","map","run","i","Id","String","MessageBody","JSON","stringify","MessageAttributes","DataType","StringValue","undefined","MessageGroupId","runId","MessageDeduplicationId","globalThis","crypto","randomUUID","Failed","Error","f","Message","Code","join","onDispatchedRun","handler","consumer","stopped","inflight","slotFreed","idle","loop","consumeRuns","Math","max","floor","concurrency","add","stopRunConsumer","size","push","r","setTimeout","extend","setInterval","extendRunVisibility","unref","settled","free","messages","receiveRuns","min","allSettled","m","release","ReceiptHandle","msg","shouldSkip","receipt","parse","Body","del","done","finally","splice","clearInterval","ReceiveMessageCommand","MaxNumberOfMessages","WaitTimeSeconds","VisibilityTimeout","MessageAttributeNames","abortSignal","signal","Messages","ChangeMessageVisibilityCommand","dispatch","task","SendMessageCommand","dispatchMany","tasks","byGroup","grouped","batches","all","batch","handle","fn","pollTasks","onResult","Array","from","pollResults","onHeartbeat","_handler","pollLoop","queueUrl","visibilitySec","each","concurrent","backoff","receive","pending","stopHolding","holdVisible","intervalMs","round","timer","MessageId","result","runStepHandler","aborted","onAbort","clearTimeout","removeEventListener","addEventListener","once","visibility","DeleteMessageCommand","close","c","destroy"]}

package/dist/index.d.cts

@@ -126,16 +126,22 @@ declare class SqsTransport implements Transport {
     /** Keep the messages of the runs in flight invisible, so a long turn is not received again. */
     private extendRunVisibility;
     dispatch(task: RemoteTask): Promise<void>;
+    /**
+     * {@link dispatch} for many tasks: ten per `SendMessageBatch`, a few batches at a time. Throws if
+     * any entry failed (the engine then dispatches the batch again one task at a time).
+     */
+    dispatchMany(tasks: RemoteTask[]): Promise<void>;
     /** Register a step handler (worker side). Starts the group's task consumer on first call. */
     handle(name: string, fn: StepHandler): void;
     onResult(handler: (result: StepResult) => Promise<void>): void;
     onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void;
     /**
-     * Receive a batch and hand each message to `each`, one at a time, never letting a failure escape:
-     * a throw is reported through `onError` and its message is left on the queue (SQS redelivers it
-     * after the visibility timeout; a redrive policy DLQs one that keeps failing). Every message of the
-     * batch is kept invisible until it is handled (see {@link holdVisible}), so the ones waiting behind a
-     * slow handler are never redelivered to another consumer meanwhile.
+     * Receive a batch and hand each message to `each` — one at a time, or all at once when
+     * `concurrent` — never letting a failure escape: a throw is reported through `onError` and its
+     * message is left on the queue (SQS redelivers it after the visibility timeout; a redrive policy
+     * DLQs one that keeps failing). Every message of the batch is kept invisible until it is handled
+     * (see {@link holdVisible}), so the ones waiting behind a slow handler are never redelivered to
+     * another consumer meanwhile.
      */
     private pollLoop;
     /**

package/dist/index.d.ts

@@ -126,16 +126,22 @@ declare class SqsTransport implements Transport {
     /** Keep the messages of the runs in flight invisible, so a long turn is not received again. */
     private extendRunVisibility;
     dispatch(task: RemoteTask): Promise<void>;
+    /**
+     * {@link dispatch} for many tasks: ten per `SendMessageBatch`, a few batches at a time. Throws if
+     * any entry failed (the engine then dispatches the batch again one task at a time).
+     */
+    dispatchMany(tasks: RemoteTask[]): Promise<void>;
     /** Register a step handler (worker side). Starts the group's task consumer on first call. */
     handle(name: string, fn: StepHandler): void;
     onResult(handler: (result: StepResult) => Promise<void>): void;
     onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void;
     /**
-     * Receive a batch and hand each message to `each`, one at a time, never letting a failure escape:
-     * a throw is reported through `onError` and its message is left on the queue (SQS redelivers it
-     * after the visibility timeout; a redrive policy DLQs one that keeps failing). Every message of the
-     * batch is kept invisible until it is handled (see {@link holdVisible}), so the ones waiting behind a
-     * slow handler are never redelivered to another consumer meanwhile.
+     * Receive a batch and hand each message to `each` — one at a time, or all at once when
+     * `concurrent` — never letting a failure escape: a throw is reported through `onError` and its
+     * message is left on the queue (SQS redelivers it after the visibility timeout; a redrive policy
+     * DLQs one that keeps failing). Every message of the batch is kept invisible until it is handled
+     * (see {@link holdVisible}), so the ones waiting behind a slow handler are never redelivered to
+     * another consumer meanwhile.
      */
     private pollLoop;
     /**

package/dist/index.js

@@ -6,6 +6,8 @@ import { ChangeMessageVisibilityCommand, CreateQueueCommand, DeleteMessageComman
 import { runStepHandler } from "@dudousxd/nestjs-durable-core";
 var SQS_BATCH_MAX = 10;
 var RESULT_VISIBILITY_SEC = 30;
+var RESULT_RECEIVERS = 8;
+var TASK_BATCHES_IN_FLIGHT = 10;
 var SqsTransport = class {
   static {
     __name(this, "SqsTransport");
@@ -270,6 +272,47 @@ var SqsTransport = class {
       } : void 0
     }));
   }
+  /**
+  * {@link dispatch} for many tasks: ten per `SendMessageBatch`, a few batches at a time. Throws if
+  * any entry failed (the engine then dispatches the batch again one task at a time).
+  */
+  async dispatchMany(tasks) {
+    const byGroup = /* @__PURE__ */ new Map();
+    for (const task of tasks) {
+      const grouped = byGroup.get(task.group);
+      if (grouped) grouped.push(task);
+      else byGroup.set(task.group, [
+        task
+      ]);
+    }
+    for (const [group, grouped] of byGroup) {
+      const QueueUrl = await this.tasksUrl(group);
+      const batches = [];
+      for (let at = 0; at < grouped.length; at += SQS_BATCH_MAX) {
+        batches.push(grouped.slice(at, at + SQS_BATCH_MAX));
+      }
+      for (let at = 0; at < batches.length; at += TASK_BATCHES_IN_FLIGHT) {
+        await Promise.all(batches.slice(at, at + TASK_BATCHES_IN_FLIGHT).map(async (batch) => {
+          const out = await this.client.send(new SendMessageBatchCommand({
+            QueueUrl,
+            Entries: batch.map((task, i) => ({
+              Id: String(i),
+              MessageBody: JSON.stringify(task),
+              MessageAttributes: this.marker ? {
+                [this.marker]: {
+                  DataType: "String",
+                  StringValue: "1"
+                }
+              } : void 0
+            }))
+          }));
+          if (out.Failed && out.Failed.length > 0) {
+            throw new Error(`SQS refused ${out.Failed.length} task(s): ${out.Failed.map((f) => f.Message ?? f.Code).join("; ")}`);
+          }
+        }));
+      }
+    }
+  }
   // ── worker → engine ────────────────────────────────────────────────────────────────────────
   /** Register a step handler (worker side). Starts the group's task consumer on first call. */
   handle(name, fn) {
@@ -278,19 +321,23 @@ var SqsTransport = class {
     if (!this.taskLoop) this.taskLoop = this.pollTasks(this.group);
   }
   onResult(handler) {
-    if (!this.resultLoop) this.resultLoop = this.pollResults(handler);
+    if (this.resultLoop) return;
+    this.resultLoop = Promise.all(Array.from({
+      length: RESULT_RECEIVERS
+    }, () => this.pollResults(handler))).then(() => void 0);
   }
   onHeartbeat(_handler) {
   }
   // ── polling loops ──────────────────────────────────────────────────────────────────────────
   /**
-  * Receive a batch and hand each message to `each`, one at a time, never letting a failure escape:
-  * a throw is reported through `onError` and its message is left on the queue (SQS redelivers it
-  * after the visibility timeout; a redrive policy DLQs one that keeps failing). Every message of the
-  * batch is kept invisible until it is handled (see {@link holdVisible}), so the ones waiting behind a
-  * slow handler are never redelivered to another consumer meanwhile.
+  * Receive a batch and hand each message to `each` — one at a time, or all at once when
+  * `concurrent` — never letting a failure escape: a throw is reported through `onError` and its
+  * message is left on the queue (SQS redelivers it after the visibility timeout; a redrive policy
+  * DLQs one that keeps failing). Every message of the batch is kept invisible until it is handled
+  * (see {@link holdVisible}), so the ones waiting behind a slow handler are never redelivered to
+  * another consumer meanwhile.
   */
-  async pollLoop(queueUrl, visibilitySec, each) {
+  async pollLoop(queueUrl, visibilitySec, each, concurrent = false) {
     while (this.running) {
       let QueueUrl;
       try {
@@ -304,20 +351,27 @@ var SqsTransport = class {
       const messages = await this.receive(QueueUrl, visibilitySec);
       const pending = new Set(messages);
       const stopHolding = this.holdVisible(QueueUrl, pending, visibilitySec);
-      try {
-        for (const msg of messages) {
-          if (!this.running) break;
-          try {
-            if (this.shouldSkip(msg)) {
-              pending.delete(msg);
-              await this.release(QueueUrl, msg.ReceiptHandle);
-              continue;
-            }
-            await each(QueueUrl, msg);
-          } catch (err) {
-            this.onError(err);
-          } finally {
+      const handle = /* @__PURE__ */ __name(async (msg) => {
+        try {
+          if (this.shouldSkip(msg)) {
             pending.delete(msg);
+            await this.release(QueueUrl, msg.ReceiptHandle);
+            return;
+          }
+          await each(QueueUrl, msg);
+        } catch (err) {
+          this.onError(err);
+        } finally {
+          pending.delete(msg);
+        }
+      }, "handle");
+      try {
+        if (concurrent) {
+          if (this.running) await Promise.all(messages.map(handle));
+        } else {
+          for (const msg of messages) {
+            if (!this.running) break;
+            await handle(msg);
           }
         }
       } finally {
@@ -379,7 +433,7 @@ var SqsTransport = class {
     return this.pollLoop(() => this.resultsUrl(), RESULT_VISIBILITY_SEC, async (QueueUrl, msg) => {
       await handler(this.parse(msg));
       await this.del(QueueUrl, msg.ReceiptHandle);
-    });
+    }, true);
   }
   /** Wait 1s, or until `close()` aborts. The abort listener is removed when the timer fires, so
   *  sustained failures never accumulate listeners on the shared signal. */

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sqs-transport.ts"],"sourcesContent":["import {\n  ChangeMessageVisibilityCommand,\n  CreateQueueCommand,\n  DeleteMessageCommand,\n  GetQueueUrlCommand,\n  ReceiveMessageCommand,\n  SQSClient,\n  type SQSClientConfig,\n  SendMessageBatchCommand,\n  SendMessageCommand,\n} from '@aws-sdk/client-sqs';\nimport {\n  type Heartbeat,\n  type RemoteTask,\n  type RunConsumerOptions,\n  type RunDispatch,\n  type RunQueueOptions,\n  type StepHandler,\n  type StepResult,\n  type Transport,\n  runStepHandler,\n} from '@dudousxd/nestjs-durable-core';\n\n/** SQS's limit on the entries of one `SendMessageBatch`. */\nconst SQS_BATCH_MAX = 10;\n\n/** A run-queue consumer started by {@link SqsTransport.onDispatchedRun}. */\ninterface RunConsumer {\n  stopped: boolean;\n  abort: AbortController;\n  /** Receipt handles of the messages whose runs are in flight. */\n  inflight: Set<string>;\n  slotFreed: (() => void) | undefined;\n  /** Resolved, once stopped, when the runs in flight settled. */\n  idle: (() => void)[];\n  loop: Promise<void>;\n}\n\n/** Resolve a group's tasks queue URL. Sync or async; resolved once per group and cached (a rejected\n *  resolution is not cached — the next call asks again). */\nexport type QueueUrlResolver = (group: string) => string | Promise<string>;\n\nexport interface SqsTransportOptions {\n  /**\n   * Reuse an existing SQS client (recommended — share the app's). When omitted, one is built\n   * from `clientConfig` and destroyed on `close()`.\n   */\n  client?: SQSClient;\n  /** Used only when `client` is omitted — e.g. `{ region, endpoint, credentials }` for ElasticMQ. */\n  clientConfig?: SQSClientConfig;\n\n  /** The worker group this instance serves. Required to register `handle()` consumers. */\n  group?: string;\n\n  /**\n   * Map a group → an **existing** tasks queue URL. This is the seam for reusing queues you already\n   * have (e.g. `extraction`, `ingestion`) instead of letting the transport mint its own. When\n   * omitted, the transport resolves `${prefix}-tasks-${group}` by name (and creates it if\n   * `autoCreate`). Return value is awaited and cached per group.\n   */\n  taskQueueUrl?: QueueUrlResolver;\n  /**\n   * The results queue URL (worker → engine). A literal URL or a resolver. When omitted, the\n   * transport resolves `${prefix}-results` by name (and creates it if `autoCreate`).\n   */\n  resultsQueueUrl?: string | (() => string | Promise<string>);\n\n  /**\n   * The run queue URL for an engine namespace (undefined for an engine that drives every\n   * namespace): where the engine queues runs for whichever instance takes them first. When omitted,\n   * the transport resolves `${prefix}-runs` (or `${prefix}-runs-<namespace>`) by name, creating it\n   * if `autoCreate`. A FIFO queue (`.fifo`) gets one message group per run.\n   */\n  runsQueueUrl?: (namespace: string | undefined) => string | Promise<string>;\n\n  /** Prefix for the fallback `${prefix}-tasks-*` / `${prefix}-results` names. Default `durable`. */\n  prefix?: string;\n  /**\n   * Create the fallback-named queues on first use if they don't exist (handy for ElasticMQ / dev).\n   * Ignored for queues you supply via `taskQueueUrl` / `resultsQueueUrl` — those must already exist.\n   */\n  autoCreate?: boolean;\n\n  /**\n   * When set, durable messages carry this SQS message attribute and pollers **skip** messages\n   * that lack it (releasing them for a co-resident legacy consumer). Enables sharing one physical\n   * queue with a non-durable consumer — but only if that consumer likewise ignores tagged messages.\n   * Leave unset for the clean case: a queue dedicated to durable traffic.\n   */\n  marker?: string;\n\n  /** SQS receive long-poll seconds (0–20). Default 20. */\n  waitTimeSeconds?: number;\n  /**\n   * Visibility timeout for a received task, in seconds. Default 60. Every message this instance has\n   * received — the one running and the ones of the same batch waiting behind it — is kept invisible by\n   * re-extending it (`ChangeMessageVisibility`) every third of this, so a step may run longer; only a\n   * crashed instance's messages reappear, after at most this long.\n   */\n  visibilityTimeoutSec?: number;\n  /**\n   * Where a transport failure is reported: a failing receive, a result handler that throws, a result\n   * send that fails, a message whose body isn't JSON. The message involved is NOT deleted: SQS\n   * redelivers it after its visibility timeout, and a queue redrive policy (`maxReceiveCount` → DLQ)\n   * moves one that keeps failing aside. Default `console.error`.\n   */\n  onError?: (err: unknown) => void;\n}\n\n/** A received message, as the poll loops use it. */\ninterface Received {\n  Body?: string | undefined;\n  ReceiptHandle?: string | undefined;\n  MessageId?: string | undefined;\n  MessageAttributes?: Record<string, unknown> | undefined;\n}\n\n/** The results queue's visibility timeout (seconds). */\nconst RESULT_VISIBILITY_SEC = 30;\n\n/**\n * An SQS-backed `Transport` — dispatch remote steps over Amazon SQS (or ElasticMQ). Unlike the\n * BullMQ transport, it does **not** mint its own queue names: pass `taskQueueUrl` / `resultsQueueUrl`\n * to ride the queues you already operate. The wire payload is the documented `RemoteTask` /\n * `StepResult` JSON, so non-Node workers on the same queues interoperate.\n *\n * Run one instance engine-side (calls `onResult`, dispatches tasks) and one per worker process\n * (calls `handle()` for its group). SQS is at-least-once: a task whose process crashes before the\n * result is sent reappears after the visibility timeout (durable retry); a duplicate `StepResult`\n * is harmless because the engine resolves a step's `pending` exactly once by `stepId`.\n */\nexport class SqsTransport implements Transport {\n  private readonly client: SQSClient;\n  private readonly ownsClient: boolean;\n  private readonly group?: string | undefined;\n  private readonly prefix: string;\n  private readonly autoCreate: boolean;\n  private readonly marker?: string | undefined;\n  private readonly waitTimeSeconds: number;\n  private readonly visibilityTimeoutSec: number;\n  private readonly taskQueueUrlResolver?: QueueUrlResolver | undefined;\n  private readonly resultsQueueUrlOption?: string | (() => string | Promise<string>) | undefined;\n  private readonly runsQueueUrlResolver?:\n    | ((namespace: string | undefined) => string | Promise<string>)\n    | undefined;\n  private readonly runConsumers = new Set<RunConsumer>();\n  private readonly onError: (err: unknown) => void;\n\n  private readonly handlers = new Map<string, StepHandler>();\n  private readonly urlCache = new Map<string, string>();\n  /** `taskQueueUrl` resolutions per group (the promise, so concurrent dispatches share one call). */\n  private readonly groupUrlCache = new Map<string, Promise<string>>();\n  private running = true;\n  private readonly abort = new AbortController();\n  private taskLoop?: Promise<void>;\n  private resultLoop?: Promise<void>;\n\n  constructor(options: SqsTransportOptions) {\n    this.client = options.client ?? new SQSClient(options.clientConfig ?? {});\n    this.ownsClient = !options.client;\n    this.group = options.group;\n    this.prefix = options.prefix ?? 'durable';\n    this.autoCreate = options.autoCreate ?? false;\n    this.marker = options.marker;\n    this.waitTimeSeconds = options.waitTimeSeconds ?? 20;\n    this.visibilityTimeoutSec = options.visibilityTimeoutSec ?? 60;\n    this.taskQueueUrlResolver = options.taskQueueUrl;\n    this.resultsQueueUrlOption = options.resultsQueueUrl;\n    this.runsQueueUrlResolver = options.runsQueueUrl;\n    this.onError = options.onError ?? ((err) => console.error('[SqsTransport]', err));\n  }\n\n  // ── queue resolution ───────────────────────────────────────────────────────────────────────\n\n  private async resolveByName(name: string): Promise<string> {\n    const cached = this.urlCache.get(name);\n    if (cached) return cached;\n    let url: string;\n    try {\n      const out = await this.client.send(new GetQueueUrlCommand({ QueueName: name }));\n      url = out.QueueUrl as string;\n    } catch (err) {\n      if (this.autoCreate) {\n        const created = await this.client.send(new CreateQueueCommand({ QueueName: name }));\n        url = created.QueueUrl as string;\n      } else {\n        throw err;\n      }\n    }\n    this.urlCache.set(name, url);\n    return url;\n  }\n\n  private async tasksUrl(group: string): Promise<string> {\n    const resolver = this.taskQueueUrlResolver;\n    if (!resolver) return this.resolveByName(`${this.prefix}-tasks-${group}`);\n    let url = this.groupUrlCache.get(group);\n    if (!url) {\n      url = Promise.resolve()\n        .then(() => resolver(group))\n        .catch((err) => {\n          this.groupUrlCache.delete(group);\n          throw err;\n        });\n      this.groupUrlCache.set(group, url);\n    }\n    return url;\n  }\n\n  private async resultsUrl(): Promise<string> {\n    const opt = this.resultsQueueUrlOption;\n    if (typeof opt === 'string') return opt;\n    if (typeof opt === 'function') return opt();\n    return this.resolveByName(`${this.prefix}-results`);\n  }\n\n  private async runsUrl(namespace: string | undefined): Promise<string> {\n    if (this.runsQueueUrlResolver) return this.runsQueueUrlResolver(namespace);\n    const name = namespace ? `${this.prefix}-runs-${namespace}` : `${this.prefix}-runs`;\n    return this.resolveByName(name.replace(/[^A-Za-z0-9_-]/g, '-'));\n  }\n\n  // ── run queue (engine ↔ engine) ─────────────────────────────────────────────────────────────\n\n  /**\n   * Queue `pending` runs for whichever engine instance receives them first, ten per\n   * `SendMessageBatch`. SQS is at-least-once and a standard queue does not deduplicate, so a run may\n   * be received twice; the engine skips a run that is no longer due. Throws if any entry failed.\n   */\n  async dispatchRuns(runs: readonly RunDispatch[], opts?: RunQueueOptions): Promise<void> {\n    if (runs.length === 0) return;\n    const QueueUrl = await this.runsUrl(opts?.namespace);\n    const fifo = QueueUrl.endsWith('.fifo');\n    for (let at = 0; at < runs.length; at += SQS_BATCH_MAX) {\n      const chunk = runs.slice(at, at + SQS_BATCH_MAX);\n      const out = await this.client.send(\n        new SendMessageBatchCommand({\n          QueueUrl,\n          Entries: chunk.map((run, i) => ({\n            Id: String(i),\n            MessageBody: JSON.stringify(run),\n            MessageAttributes: this.marker\n              ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n              : undefined,\n            // FIFO: one group per run (runs are independent; only one run's entries are ordered),\n            // and a fresh deduplication id, so a run queued again later is not dropped as a repeat.\n            ...(fifo\n              ? {\n                  MessageGroupId: run.runId.slice(0, 128),\n                  MessageDeduplicationId: globalThis.crypto.randomUUID(),\n                }\n              : {}),\n          })),\n        }),\n      );\n      if (out.Failed && out.Failed.length > 0) {\n        throw new Error(\n          `SQS refused ${out.Failed.length} run(s): ${out.Failed.map((f) => f.Message ?? f.Code).join('; ')}`,\n        );\n      }\n    }\n  }\n\n  /**\n   * Receive from the run queue, at most `opts.concurrency` runs in flight on this instance. A\n   * message is deleted once its handler settles, and its visibility is extended meanwhile, so it\n   * reappears only after the instance holding it went down. The returned stop takes no more\n   * messages and resolves once the runs in flight settled.\n   */\n  onDispatchedRun(\n    handler: (run: RunDispatch) => Promise<void>,\n    opts: RunConsumerOptions,\n  ): () => Promise<void> {\n    const consumer: RunConsumer = {\n      stopped: false,\n      abort: new AbortController(),\n      inflight: new Set(),\n      slotFreed: undefined,\n      idle: [],\n      loop: Promise.resolve(),\n    };\n    consumer.loop = this.consumeRuns(\n      consumer,\n      handler,\n      Math.max(1, Math.floor(opts.concurrency)),\n      opts.namespace,\n    ).catch((err) => {\n      this.onError(err);\n    });\n    this.runConsumers.add(consumer);\n    return () => this.stopRunConsumer(consumer);\n  }\n\n  /**\n   * Stop taking messages and wait for the runs in flight. A receive still long-polling is not\n   * aborted, since SQS would keep what it hands an aborted request invisible for the visibility\n   * timeout: whatever it returns is released for another instance. `close()` aborts it.\n   */\n  private async stopRunConsumer(consumer: RunConsumer, abort = false): Promise<void> {\n    consumer.stopped = true;\n    consumer.slotFreed?.();\n    if (abort) consumer.abort.abort();\n    if (consumer.inflight.size > 0) {\n      await new Promise<void>((resolve) => consumer.idle.push(resolve));\n    }\n    if (abort) await consumer.loop;\n    this.runConsumers.delete(consumer);\n  }\n\n  private async consumeRuns(\n    consumer: RunConsumer,\n    handler: (run: RunDispatch) => Promise<void>,\n    concurrency: number,\n    namespace: string | undefined,\n  ): Promise<void> {\n    let QueueUrl: string | undefined;\n    while (QueueUrl === undefined && this.running && !consumer.stopped) {\n      try {\n        QueueUrl = await this.runsUrl(namespace);\n      } catch (err) {\n        this.onError(err);\n        await new Promise((r) => setTimeout(r, 1000));\n      }\n    }\n    if (QueueUrl === undefined) return;\n    const url = QueueUrl;\n    const extend = setInterval(\n      () => void this.extendRunVisibility(url, consumer),\n      Math.max(1_000, Math.floor((this.visibilityTimeoutSec * 1000) / 3)),\n    );\n    extend.unref?.();\n    const settled = new Set<Promise<unknown>>();\n    try {\n      while (this.running && !consumer.stopped) {\n        const free = concurrency - consumer.inflight.size;\n        if (free <= 0) {\n          await new Promise<void>((resolve) => {\n            consumer.slotFreed = resolve;\n          });\n          consumer.slotFreed = undefined;\n          continue;\n        }\n        const messages = await this.receiveRuns(url, Math.min(SQS_BATCH_MAX, free), consumer);\n        if (consumer.stopped) {\n          await Promise.allSettled(messages.map((m) => this.release(url, m.ReceiptHandle)));\n          break;\n        }\n        for (const msg of messages) {\n          if (this.shouldSkip(msg)) {\n            await this.release(url, msg.ReceiptHandle);\n            continue;\n          }\n          const receipt = msg.ReceiptHandle;\n          if (!receipt) continue;\n          const run = JSON.parse(msg.Body ?? '{}') as Partial<RunDispatch>;\n          if (typeof run.runId !== 'string') {\n            await this.del(url, receipt).catch(() => undefined);\n            continue;\n          }\n          consumer.inflight.add(receipt);\n          const done = handler(run as RunDispatch)\n            .catch(() => undefined)\n            .then(() => this.del(url, receipt).catch(() => undefined))\n            .finally(() => {\n              consumer.inflight.delete(receipt);\n              settled.delete(done);\n              consumer.slotFreed?.();\n              if (consumer.stopped && consumer.inflight.size === 0) {\n                for (const resolve of consumer.idle.splice(0)) resolve();\n              }\n            });\n          settled.add(done);\n        }\n      }\n      await Promise.allSettled([...settled]);\n    } finally {\n      clearInterval(extend);\n    }\n  }\n\n  private async receiveRuns(QueueUrl: string, max: number, consumer: RunConsumer) {\n    try {\n      const out = await this.client.send(\n        new ReceiveMessageCommand({\n          QueueUrl,\n          MaxNumberOfMessages: max,\n          WaitTimeSeconds: this.waitTimeSeconds,\n          VisibilityTimeout: this.visibilityTimeoutSec,\n          MessageAttributeNames: this.marker ? ['All'] : undefined,\n        }),\n        { abortSignal: consumer.abort.signal },\n      );\n      return out.Messages ?? [];\n    } catch (err) {\n      if (!this.running || consumer.stopped) return [];\n      this.onError(err);\n      await new Promise((r) => setTimeout(r, 1000));\n      return [];\n    }\n  }\n\n  /** Keep the messages of the runs in flight invisible, so a long turn is not received again. */\n  private async extendRunVisibility(QueueUrl: string, consumer: RunConsumer): Promise<void> {\n    await Promise.allSettled(\n      [...consumer.inflight].map((ReceiptHandle) =>\n        this.client.send(\n          new ChangeMessageVisibilityCommand({\n            QueueUrl,\n            ReceiptHandle,\n            VisibilityTimeout: this.visibilityTimeoutSec,\n          }),\n        ),\n      ),\n    );\n  }\n\n  // ── engine → worker ────────────────────────────────────────────────────────────────────────\n\n  async dispatch(task: RemoteTask): Promise<void> {\n    const QueueUrl = await this.tasksUrl(task.group);\n    await this.client.send(\n      new SendMessageCommand({\n        QueueUrl,\n        MessageBody: JSON.stringify(task),\n        MessageAttributes: this.marker\n          ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n          : undefined,\n      }),\n    );\n  }\n\n  // ── worker → engine ────────────────────────────────────────────────────────────────────────\n\n  /** Register a step handler (worker side). Starts the group's task consumer on first call. */\n  handle(name: string, fn: StepHandler): void {\n    if (!this.group) throw new Error('SqsTransport needs a `group` to register handlers');\n    this.handlers.set(name, fn);\n    if (!this.taskLoop) this.taskLoop = this.pollTasks(this.group);\n  }\n\n  onResult(handler: (result: StepResult) => Promise<void>): void {\n    if (!this.resultLoop) this.resultLoop = this.pollResults(handler);\n  }\n\n  onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void {\n    // Not modelled over SQS; the queue's visibility-timeout redelivery is the liveness mechanism.\n  }\n\n  // ── polling loops ──────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Receive a batch and hand each message to `each`, one at a time, never letting a failure escape:\n   * a throw is reported through `onError` and its message is left on the queue (SQS redelivers it\n   * after the visibility timeout; a redrive policy DLQs one that keeps failing). Every message of the\n   * batch is kept invisible until it is handled (see {@link holdVisible}), so the ones waiting behind a\n   * slow handler are never redelivered to another consumer meanwhile.\n   */\n  private async pollLoop(\n    queueUrl: () => Promise<string>,\n    visibilitySec: number,\n    each: (QueueUrl: string, msg: Received) => Promise<void>,\n  ): Promise<void> {\n    while (this.running) {\n      let QueueUrl: string;\n      try {\n        QueueUrl = await queueUrl();\n      } catch (err) {\n        if (!this.running) return;\n        this.onError(err);\n        await this.backoff();\n        continue;\n      }\n      const messages = await this.receive(QueueUrl, visibilitySec);\n      const pending = new Set<Received>(messages);\n      const stopHolding = this.holdVisible(QueueUrl, pending, visibilitySec);\n      try {\n        for (const msg of messages) {\n          if (!this.running) break; // close(): what is left reappears after its visibility timeout\n          try {\n            if (this.shouldSkip(msg)) {\n              // Not ours (shared queue): release immediately so the legacy consumer can take it.\n              pending.delete(msg);\n              await this.release(QueueUrl, msg.ReceiptHandle);\n              continue;\n            }\n            await each(QueueUrl, msg);\n          } catch (err) {\n            this.onError(err);\n          } finally {\n            pending.delete(msg);\n          }\n        }\n      } finally {\n        stopHolding();\n      }\n    }\n  }\n\n  /**\n   * Keep `messages` invisible while they wait or run: every third of the visibility timeout, extend\n   * each one still in the set back to the full timeout. Returns the stop function.\n   */\n  private holdVisible(\n    QueueUrl: string,\n    messages: Set<Received>,\n    visibilitySec: number,\n  ): () => void {\n    if (messages.size === 0) return () => {};\n    const intervalMs = Math.max(200, Math.floor((visibilitySec * 1000) / 3));\n    let round: Promise<void> | undefined;\n    const timer = setInterval(() => {\n      if (round) return;\n      round = Promise.all(\n        [...messages].map((msg) =>\n          msg.ReceiptHandle\n            ? this.client\n                .send(\n                  new ChangeMessageVisibilityCommand({\n                    QueueUrl,\n                    ReceiptHandle: msg.ReceiptHandle,\n                    VisibilityTimeout: visibilitySec,\n                  }),\n                )\n                .then(() => undefined)\n                .catch((err) => {\n                  if (this.running) this.onError(err);\n                })\n            : undefined,\n        ),\n      ).then(() => {\n        round = undefined;\n      });\n    }, intervalMs);\n    timer.unref?.();\n    return () => clearInterval(timer);\n  }\n\n  private parse<T>(msg: Received): T {\n    try {\n      return JSON.parse(msg.Body ?? '') as T;\n    } catch {\n      throw new Error(\n        `[SqsTransport] message ${msg.MessageId ?? '?'} has a non-JSON body; leaving it for the queue's redrive policy`,\n      );\n    }\n  }\n\n  private pollTasks(group: string): Promise<void> {\n    return this.pollLoop(\n      () => this.tasksUrl(group),\n      this.visibilityTimeoutSec,\n      async (QueueUrl, msg) => {\n        const task = this.parse<RemoteTask>(msg);\n        const result = await runStepHandler(task, this.handlers.get(task.name));\n        await this.client.send(\n          new SendMessageCommand({\n            QueueUrl: await this.resultsUrl(),\n            MessageBody: JSON.stringify(result),\n            MessageAttributes: this.marker\n              ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n              : undefined,\n          }),\n        );\n        await this.del(QueueUrl, msg.ReceiptHandle);\n      },\n    );\n  }\n\n  private pollResults(handler: (result: StepResult) => Promise<void>): Promise<void> {\n    return this.pollLoop(\n      () => this.resultsUrl(),\n      RESULT_VISIBILITY_SEC,\n      async (QueueUrl, msg) => {\n        await handler(this.parse<StepResult>(msg));\n        await this.del(QueueUrl, msg.ReceiptHandle);\n      },\n    );\n  }\n\n  /** Wait 1s, or until `close()` aborts. The abort listener is removed when the timer fires, so\n   *  sustained failures never accumulate listeners on the shared signal. */\n  private backoff(): Promise<void> {\n    return new Promise((resolve) => {\n      const signal = this.abort.signal;\n      if (signal.aborted) return resolve();\n      const onAbort = () => {\n        clearTimeout(timer);\n        resolve();\n      };\n      const timer = setTimeout(() => {\n        signal.removeEventListener('abort', onAbort);\n        resolve();\n      }, 1000);\n      signal.addEventListener('abort', onAbort, { once: true });\n    });\n  }\n\n  /** One long-poll receive. Swallows the abort thrown on `close()`; logs and backs off otherwise. */\n  private async receive(QueueUrl: string, visibility: number): Promise<Received[]> {\n    try {\n      const out = await this.client.send(\n        new ReceiveMessageCommand({\n          QueueUrl,\n          MaxNumberOfMessages: 10,\n          WaitTimeSeconds: this.waitTimeSeconds,\n          VisibilityTimeout: visibility,\n          MessageAttributeNames: this.marker ? ['All'] : undefined,\n        }),\n        { abortSignal: this.abort.signal },\n      );\n      return out.Messages ?? [];\n    } catch (err) {\n      if (!this.running) return [];\n      this.onError(err);\n      await this.backoff();\n      return [];\n    }\n  }\n\n  private shouldSkip(msg: { MessageAttributes?: Record<string, unknown> | undefined }): boolean {\n    return !!this.marker && !msg.MessageAttributes?.[this.marker];\n  }\n\n  private async del(QueueUrl: string, ReceiptHandle?: string): Promise<void> {\n    if (!ReceiptHandle) return;\n    await this.client.send(new DeleteMessageCommand({ QueueUrl, ReceiptHandle }));\n  }\n\n  private async release(QueueUrl: string, ReceiptHandle?: string): Promise<void> {\n    if (!ReceiptHandle) return;\n    await this.client\n      .send(new ChangeMessageVisibilityCommand({ QueueUrl, ReceiptHandle, VisibilityTimeout: 0 }))\n      .catch(() => {});\n  }\n\n  /** Stop the pollers and (if we created it) destroy the SQS client so the process can exit. */\n  async close(): Promise<void> {\n    this.running = false;\n    this.abort.abort();\n    await Promise.allSettled([\n      this.taskLoop,\n      this.resultLoop,\n      ...[...this.runConsumers].map((c) => this.stopRunConsumer(c, true)),\n    ]);\n    if (this.ownsClient) this.client.destroy();\n  }\n}\n"],"mappings":"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","names":["ChangeMessageVisibilityCommand","CreateQueueCommand","DeleteMessageCommand","GetQueueUrlCommand","ReceiveMessageCommand","SQSClient","SendMessageBatchCommand","SendMessageCommand","runStepHandler","SQS_BATCH_MAX","RESULT_VISIBILITY_SEC","SqsTransport","client","ownsClient","group","prefix","autoCreate","marker","waitTimeSeconds","visibilityTimeoutSec","taskQueueUrlResolver","resultsQueueUrlOption","runsQueueUrlResolver","runConsumers","Set","onError","handlers","Map","urlCache","groupUrlCache","running","abort","AbortController","taskLoop","resultLoop","options","SQSClient","clientConfig","taskQueueUrl","resultsQueueUrl","runsQueueUrl","err","console","error","resolveByName","name","cached","get","url","out","send","GetQueueUrlCommand","QueueName","QueueUrl","created","CreateQueueCommand","set","tasksUrl","resolver","Promise","resolve","then","catch","delete","resultsUrl","opt","runsUrl","namespace","replace","dispatchRuns","runs","opts","length","fifo","endsWith","at","chunk","slice","SendMessageBatchCommand","Entries","map","run","i","Id","String","MessageBody","JSON","stringify","MessageAttributes","DataType","StringValue","undefined","MessageGroupId","runId","MessageDeduplicationId","globalThis","crypto","randomUUID","Failed","Error","f","Message","Code","join","onDispatchedRun","handler","consumer","stopped","inflight","slotFreed","idle","loop","consumeRuns","Math","max","floor","concurrency","add","stopRunConsumer","size","push","r","setTimeout","extend","setInterval","extendRunVisibility","unref","settled","free","messages","receiveRuns","min","allSettled","m","release","ReceiptHandle","msg","shouldSkip","receipt","parse","Body","del","done","finally","splice","clearInterval","ReceiveMessageCommand","MaxNumberOfMessages","WaitTimeSeconds","VisibilityTimeout","MessageAttributeNames","abortSignal","signal","Messages","ChangeMessageVisibilityCommand","dispatch","task","SendMessageCommand","handle","fn","pollTasks","onResult","pollResults","onHeartbeat","_handler","pollLoop","queueUrl","visibilitySec","each","backoff","receive","pending","stopHolding","holdVisible","intervalMs","round","timer","all","MessageId","result","runStepHandler","aborted","onAbort","clearTimeout","removeEventListener","addEventListener","once","visibility","DeleteMessageCommand","close","c","destroy"]}
+{"version":3,"sources":["../src/sqs-transport.ts"],"sourcesContent":["import {\n  ChangeMessageVisibilityCommand,\n  CreateQueueCommand,\n  DeleteMessageCommand,\n  GetQueueUrlCommand,\n  ReceiveMessageCommand,\n  SQSClient,\n  type SQSClientConfig,\n  SendMessageBatchCommand,\n  SendMessageCommand,\n} from '@aws-sdk/client-sqs';\nimport {\n  type Heartbeat,\n  type RemoteTask,\n  type RunConsumerOptions,\n  type RunDispatch,\n  type RunQueueOptions,\n  type StepHandler,\n  type StepResult,\n  type Transport,\n  runStepHandler,\n} from '@dudousxd/nestjs-durable-core';\n\n/** SQS's limit on the entries of one `SendMessageBatch`. */\nconst SQS_BATCH_MAX = 10;\n\n/** A run-queue consumer started by {@link SqsTransport.onDispatchedRun}. */\ninterface RunConsumer {\n  stopped: boolean;\n  abort: AbortController;\n  /** Receipt handles of the messages whose runs are in flight. */\n  inflight: Set<string>;\n  slotFreed: (() => void) | undefined;\n  /** Resolved, once stopped, when the runs in flight settled. */\n  idle: (() => void)[];\n  loop: Promise<void>;\n}\n\n/** Resolve a group's tasks queue URL. Sync or async; resolved once per group and cached (a rejected\n *  resolution is not cached — the next call asks again). */\nexport type QueueUrlResolver = (group: string) => string | Promise<string>;\n\nexport interface SqsTransportOptions {\n  /**\n   * Reuse an existing SQS client (recommended — share the app's). When omitted, one is built\n   * from `clientConfig` and destroyed on `close()`.\n   */\n  client?: SQSClient;\n  /** Used only when `client` is omitted — e.g. `{ region, endpoint, credentials }` for ElasticMQ. */\n  clientConfig?: SQSClientConfig;\n\n  /** The worker group this instance serves. Required to register `handle()` consumers. */\n  group?: string;\n\n  /**\n   * Map a group → an **existing** tasks queue URL. This is the seam for reusing queues you already\n   * have (e.g. `extraction`, `ingestion`) instead of letting the transport mint its own. When\n   * omitted, the transport resolves `${prefix}-tasks-${group}` by name (and creates it if\n   * `autoCreate`). Return value is awaited and cached per group.\n   */\n  taskQueueUrl?: QueueUrlResolver;\n  /**\n   * The results queue URL (worker → engine). A literal URL or a resolver. When omitted, the\n   * transport resolves `${prefix}-results` by name (and creates it if `autoCreate`).\n   */\n  resultsQueueUrl?: string | (() => string | Promise<string>);\n\n  /**\n   * The run queue URL for an engine namespace (undefined for an engine that drives every\n   * namespace): where the engine queues runs for whichever instance takes them first. When omitted,\n   * the transport resolves `${prefix}-runs` (or `${prefix}-runs-<namespace>`) by name, creating it\n   * if `autoCreate`. A FIFO queue (`.fifo`) gets one message group per run.\n   */\n  runsQueueUrl?: (namespace: string | undefined) => string | Promise<string>;\n\n  /** Prefix for the fallback `${prefix}-tasks-*` / `${prefix}-results` names. Default `durable`. */\n  prefix?: string;\n  /**\n   * Create the fallback-named queues on first use if they don't exist (handy for ElasticMQ / dev).\n   * Ignored for queues you supply via `taskQueueUrl` / `resultsQueueUrl` — those must already exist.\n   */\n  autoCreate?: boolean;\n\n  /**\n   * When set, durable messages carry this SQS message attribute and pollers **skip** messages\n   * that lack it (releasing them for a co-resident legacy consumer). Enables sharing one physical\n   * queue with a non-durable consumer — but only if that consumer likewise ignores tagged messages.\n   * Leave unset for the clean case: a queue dedicated to durable traffic.\n   */\n  marker?: string;\n\n  /** SQS receive long-poll seconds (0–20). Default 20. */\n  waitTimeSeconds?: number;\n  /**\n   * Visibility timeout for a received task, in seconds. Default 60. Every message this instance has\n   * received — the one running and the ones of the same batch waiting behind it — is kept invisible by\n   * re-extending it (`ChangeMessageVisibility`) every third of this, so a step may run longer; only a\n   * crashed instance's messages reappear, after at most this long.\n   */\n  visibilityTimeoutSec?: number;\n  /**\n   * Where a transport failure is reported: a failing receive, a result handler that throws, a result\n   * send that fails, a message whose body isn't JSON. The message involved is NOT deleted: SQS\n   * redelivers it after its visibility timeout, and a queue redrive policy (`maxReceiveCount` → DLQ)\n   * moves one that keeps failing aside. Default `console.error`.\n   */\n  onError?: (err: unknown) => void;\n}\n\n/** A received message, as the poll loops use it. */\ninterface Received {\n  Body?: string | undefined;\n  ReceiptHandle?: string | undefined;\n  MessageId?: string | undefined;\n  MessageAttributes?: Record<string, unknown> | undefined;\n}\n\n/** The results queue's visibility timeout (seconds). */\nconst RESULT_VISIBILITY_SEC = 30;\n\n/**\n * How many receive loops consume the results queue on one instance. Each hands every message of a\n * receive to the engine at once, so up to this many times ten results are in flight here: the\n * engine writes one run's waiting results together, so a wide fan settles in few writes.\n */\nconst RESULT_RECEIVERS = 8;\n\n/** `SendMessageBatch` calls {@link SqsTransport.dispatchMany} has in flight at once. */\nconst TASK_BATCHES_IN_FLIGHT = 10;\n\n/**\n * An SQS-backed `Transport` — dispatch remote steps over Amazon SQS (or ElasticMQ). Unlike the\n * BullMQ transport, it does **not** mint its own queue names: pass `taskQueueUrl` / `resultsQueueUrl`\n * to ride the queues you already operate. The wire payload is the documented `RemoteTask` /\n * `StepResult` JSON, so non-Node workers on the same queues interoperate.\n *\n * Run one instance engine-side (calls `onResult`, dispatches tasks) and one per worker process\n * (calls `handle()` for its group). SQS is at-least-once: a task whose process crashes before the\n * result is sent reappears after the visibility timeout (durable retry); a duplicate `StepResult`\n * is harmless because the engine resolves a step's `pending` exactly once by `stepId`.\n */\nexport class SqsTransport implements Transport {\n  private readonly client: SQSClient;\n  private readonly ownsClient: boolean;\n  private readonly group?: string | undefined;\n  private readonly prefix: string;\n  private readonly autoCreate: boolean;\n  private readonly marker?: string | undefined;\n  private readonly waitTimeSeconds: number;\n  private readonly visibilityTimeoutSec: number;\n  private readonly taskQueueUrlResolver?: QueueUrlResolver | undefined;\n  private readonly resultsQueueUrlOption?: string | (() => string | Promise<string>) | undefined;\n  private readonly runsQueueUrlResolver?:\n    | ((namespace: string | undefined) => string | Promise<string>)\n    | undefined;\n  private readonly runConsumers = new Set<RunConsumer>();\n  private readonly onError: (err: unknown) => void;\n\n  private readonly handlers = new Map<string, StepHandler>();\n  private readonly urlCache = new Map<string, string>();\n  /** `taskQueueUrl` resolutions per group (the promise, so concurrent dispatches share one call). */\n  private readonly groupUrlCache = new Map<string, Promise<string>>();\n  private running = true;\n  private readonly abort = new AbortController();\n  private taskLoop?: Promise<void>;\n  private resultLoop?: Promise<void>;\n\n  constructor(options: SqsTransportOptions) {\n    this.client = options.client ?? new SQSClient(options.clientConfig ?? {});\n    this.ownsClient = !options.client;\n    this.group = options.group;\n    this.prefix = options.prefix ?? 'durable';\n    this.autoCreate = options.autoCreate ?? false;\n    this.marker = options.marker;\n    this.waitTimeSeconds = options.waitTimeSeconds ?? 20;\n    this.visibilityTimeoutSec = options.visibilityTimeoutSec ?? 60;\n    this.taskQueueUrlResolver = options.taskQueueUrl;\n    this.resultsQueueUrlOption = options.resultsQueueUrl;\n    this.runsQueueUrlResolver = options.runsQueueUrl;\n    this.onError = options.onError ?? ((err) => console.error('[SqsTransport]', err));\n  }\n\n  // ── queue resolution ───────────────────────────────────────────────────────────────────────\n\n  private async resolveByName(name: string): Promise<string> {\n    const cached = this.urlCache.get(name);\n    if (cached) return cached;\n    let url: string;\n    try {\n      const out = await this.client.send(new GetQueueUrlCommand({ QueueName: name }));\n      url = out.QueueUrl as string;\n    } catch (err) {\n      if (this.autoCreate) {\n        const created = await this.client.send(new CreateQueueCommand({ QueueName: name }));\n        url = created.QueueUrl as string;\n      } else {\n        throw err;\n      }\n    }\n    this.urlCache.set(name, url);\n    return url;\n  }\n\n  private async tasksUrl(group: string): Promise<string> {\n    const resolver = this.taskQueueUrlResolver;\n    if (!resolver) return this.resolveByName(`${this.prefix}-tasks-${group}`);\n    let url = this.groupUrlCache.get(group);\n    if (!url) {\n      url = Promise.resolve()\n        .then(() => resolver(group))\n        .catch((err) => {\n          this.groupUrlCache.delete(group);\n          throw err;\n        });\n      this.groupUrlCache.set(group, url);\n    }\n    return url;\n  }\n\n  private async resultsUrl(): Promise<string> {\n    const opt = this.resultsQueueUrlOption;\n    if (typeof opt === 'string') return opt;\n    if (typeof opt === 'function') return opt();\n    return this.resolveByName(`${this.prefix}-results`);\n  }\n\n  private async runsUrl(namespace: string | undefined): Promise<string> {\n    if (this.runsQueueUrlResolver) return this.runsQueueUrlResolver(namespace);\n    const name = namespace ? `${this.prefix}-runs-${namespace}` : `${this.prefix}-runs`;\n    return this.resolveByName(name.replace(/[^A-Za-z0-9_-]/g, '-'));\n  }\n\n  // ── run queue (engine ↔ engine) ─────────────────────────────────────────────────────────────\n\n  /**\n   * Queue `pending` runs for whichever engine instance receives them first, ten per\n   * `SendMessageBatch`. SQS is at-least-once and a standard queue does not deduplicate, so a run may\n   * be received twice; the engine skips a run that is no longer due. Throws if any entry failed.\n   */\n  async dispatchRuns(runs: readonly RunDispatch[], opts?: RunQueueOptions): Promise<void> {\n    if (runs.length === 0) return;\n    const QueueUrl = await this.runsUrl(opts?.namespace);\n    const fifo = QueueUrl.endsWith('.fifo');\n    for (let at = 0; at < runs.length; at += SQS_BATCH_MAX) {\n      const chunk = runs.slice(at, at + SQS_BATCH_MAX);\n      const out = await this.client.send(\n        new SendMessageBatchCommand({\n          QueueUrl,\n          Entries: chunk.map((run, i) => ({\n            Id: String(i),\n            MessageBody: JSON.stringify(run),\n            MessageAttributes: this.marker\n              ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n              : undefined,\n            // FIFO: one group per run (runs are independent; only one run's entries are ordered),\n            // and a fresh deduplication id, so a run queued again later is not dropped as a repeat.\n            ...(fifo\n              ? {\n                  MessageGroupId: run.runId.slice(0, 128),\n                  MessageDeduplicationId: globalThis.crypto.randomUUID(),\n                }\n              : {}),\n          })),\n        }),\n      );\n      if (out.Failed && out.Failed.length > 0) {\n        throw new Error(\n          `SQS refused ${out.Failed.length} run(s): ${out.Failed.map((f) => f.Message ?? f.Code).join('; ')}`,\n        );\n      }\n    }\n  }\n\n  /**\n   * Receive from the run queue, at most `opts.concurrency` runs in flight on this instance. A\n   * message is deleted once its handler settles, and its visibility is extended meanwhile, so it\n   * reappears only after the instance holding it went down. The returned stop takes no more\n   * messages and resolves once the runs in flight settled.\n   */\n  onDispatchedRun(\n    handler: (run: RunDispatch) => Promise<void>,\n    opts: RunConsumerOptions,\n  ): () => Promise<void> {\n    const consumer: RunConsumer = {\n      stopped: false,\n      abort: new AbortController(),\n      inflight: new Set(),\n      slotFreed: undefined,\n      idle: [],\n      loop: Promise.resolve(),\n    };\n    consumer.loop = this.consumeRuns(\n      consumer,\n      handler,\n      Math.max(1, Math.floor(opts.concurrency)),\n      opts.namespace,\n    ).catch((err) => {\n      this.onError(err);\n    });\n    this.runConsumers.add(consumer);\n    return () => this.stopRunConsumer(consumer);\n  }\n\n  /**\n   * Stop taking messages and wait for the runs in flight. A receive still long-polling is not\n   * aborted, since SQS would keep what it hands an aborted request invisible for the visibility\n   * timeout: whatever it returns is released for another instance. `close()` aborts it.\n   */\n  private async stopRunConsumer(consumer: RunConsumer, abort = false): Promise<void> {\n    consumer.stopped = true;\n    consumer.slotFreed?.();\n    if (abort) consumer.abort.abort();\n    if (consumer.inflight.size > 0) {\n      await new Promise<void>((resolve) => consumer.idle.push(resolve));\n    }\n    if (abort) await consumer.loop;\n    this.runConsumers.delete(consumer);\n  }\n\n  private async consumeRuns(\n    consumer: RunConsumer,\n    handler: (run: RunDispatch) => Promise<void>,\n    concurrency: number,\n    namespace: string | undefined,\n  ): Promise<void> {\n    let QueueUrl: string | undefined;\n    while (QueueUrl === undefined && this.running && !consumer.stopped) {\n      try {\n        QueueUrl = await this.runsUrl(namespace);\n      } catch (err) {\n        this.onError(err);\n        await new Promise((r) => setTimeout(r, 1000));\n      }\n    }\n    if (QueueUrl === undefined) return;\n    const url = QueueUrl;\n    const extend = setInterval(\n      () => void this.extendRunVisibility(url, consumer),\n      Math.max(1_000, Math.floor((this.visibilityTimeoutSec * 1000) / 3)),\n    );\n    extend.unref?.();\n    const settled = new Set<Promise<unknown>>();\n    try {\n      while (this.running && !consumer.stopped) {\n        const free = concurrency - consumer.inflight.size;\n        if (free <= 0) {\n          await new Promise<void>((resolve) => {\n            consumer.slotFreed = resolve;\n          });\n          consumer.slotFreed = undefined;\n          continue;\n        }\n        const messages = await this.receiveRuns(url, Math.min(SQS_BATCH_MAX, free), consumer);\n        if (consumer.stopped) {\n          await Promise.allSettled(messages.map((m) => this.release(url, m.ReceiptHandle)));\n          break;\n        }\n        for (const msg of messages) {\n          if (this.shouldSkip(msg)) {\n            await this.release(url, msg.ReceiptHandle);\n            continue;\n          }\n          const receipt = msg.ReceiptHandle;\n          if (!receipt) continue;\n          const run = JSON.parse(msg.Body ?? '{}') as Partial<RunDispatch>;\n          if (typeof run.runId !== 'string') {\n            await this.del(url, receipt).catch(() => undefined);\n            continue;\n          }\n          consumer.inflight.add(receipt);\n          const done = handler(run as RunDispatch)\n            .catch(() => undefined)\n            .then(() => this.del(url, receipt).catch(() => undefined))\n            .finally(() => {\n              consumer.inflight.delete(receipt);\n              settled.delete(done);\n              consumer.slotFreed?.();\n              if (consumer.stopped && consumer.inflight.size === 0) {\n                for (const resolve of consumer.idle.splice(0)) resolve();\n              }\n            });\n          settled.add(done);\n        }\n      }\n      await Promise.allSettled([...settled]);\n    } finally {\n      clearInterval(extend);\n    }\n  }\n\n  private async receiveRuns(QueueUrl: string, max: number, consumer: RunConsumer) {\n    try {\n      const out = await this.client.send(\n        new ReceiveMessageCommand({\n          QueueUrl,\n          MaxNumberOfMessages: max,\n          WaitTimeSeconds: this.waitTimeSeconds,\n          VisibilityTimeout: this.visibilityTimeoutSec,\n          MessageAttributeNames: this.marker ? ['All'] : undefined,\n        }),\n        { abortSignal: consumer.abort.signal },\n      );\n      return out.Messages ?? [];\n    } catch (err) {\n      if (!this.running || consumer.stopped) return [];\n      this.onError(err);\n      await new Promise((r) => setTimeout(r, 1000));\n      return [];\n    }\n  }\n\n  /** Keep the messages of the runs in flight invisible, so a long turn is not received again. */\n  private async extendRunVisibility(QueueUrl: string, consumer: RunConsumer): Promise<void> {\n    await Promise.allSettled(\n      [...consumer.inflight].map((ReceiptHandle) =>\n        this.client.send(\n          new ChangeMessageVisibilityCommand({\n            QueueUrl,\n            ReceiptHandle,\n            VisibilityTimeout: this.visibilityTimeoutSec,\n          }),\n        ),\n      ),\n    );\n  }\n\n  // ── engine → worker ────────────────────────────────────────────────────────────────────────\n\n  async dispatch(task: RemoteTask): Promise<void> {\n    const QueueUrl = await this.tasksUrl(task.group);\n    await this.client.send(\n      new SendMessageCommand({\n        QueueUrl,\n        MessageBody: JSON.stringify(task),\n        MessageAttributes: this.marker\n          ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n          : undefined,\n      }),\n    );\n  }\n\n  /**\n   * {@link dispatch} for many tasks: ten per `SendMessageBatch`, a few batches at a time. Throws if\n   * any entry failed (the engine then dispatches the batch again one task at a time).\n   */\n  async dispatchMany(tasks: RemoteTask[]): Promise<void> {\n    const byGroup = new Map<string, RemoteTask[]>();\n    for (const task of tasks) {\n      const grouped = byGroup.get(task.group);\n      if (grouped) grouped.push(task);\n      else byGroup.set(task.group, [task]);\n    }\n    for (const [group, grouped] of byGroup) {\n      const QueueUrl = await this.tasksUrl(group);\n      const batches: RemoteTask[][] = [];\n      for (let at = 0; at < grouped.length; at += SQS_BATCH_MAX) {\n        batches.push(grouped.slice(at, at + SQS_BATCH_MAX));\n      }\n      for (let at = 0; at < batches.length; at += TASK_BATCHES_IN_FLIGHT) {\n        await Promise.all(\n          batches.slice(at, at + TASK_BATCHES_IN_FLIGHT).map(async (batch) => {\n            const out = await this.client.send(\n              new SendMessageBatchCommand({\n                QueueUrl,\n                Entries: batch.map((task, i) => ({\n                  Id: String(i),\n                  MessageBody: JSON.stringify(task),\n                  MessageAttributes: this.marker\n                    ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n                    : undefined,\n                })),\n              }),\n            );\n            if (out.Failed && out.Failed.length > 0) {\n              throw new Error(\n                `SQS refused ${out.Failed.length} task(s): ${out.Failed.map((f) => f.Message ?? f.Code).join('; ')}`,\n              );\n            }\n          }),\n        );\n      }\n    }\n  }\n\n  // ── worker → engine ────────────────────────────────────────────────────────────────────────\n\n  /** Register a step handler (worker side). Starts the group's task consumer on first call. */\n  handle(name: string, fn: StepHandler): void {\n    if (!this.group) throw new Error('SqsTransport needs a `group` to register handlers');\n    this.handlers.set(name, fn);\n    if (!this.taskLoop) this.taskLoop = this.pollTasks(this.group);\n  }\n\n  onResult(handler: (result: StepResult) => Promise<void>): void {\n    if (this.resultLoop) return;\n    this.resultLoop = Promise.all(\n      Array.from({ length: RESULT_RECEIVERS }, () => this.pollResults(handler)),\n    ).then(() => undefined);\n  }\n\n  onHeartbeat(_handler: (beat: Heartbeat) => Promise<void>): void {\n    // Not modelled over SQS; the queue's visibility-timeout redelivery is the liveness mechanism.\n  }\n\n  // ── polling loops ──────────────────────────────────────────────────────────────────────────\n\n  /**\n   * Receive a batch and hand each message to `each` — one at a time, or all at once when\n   * `concurrent` — never letting a failure escape: a throw is reported through `onError` and its\n   * message is left on the queue (SQS redelivers it after the visibility timeout; a redrive policy\n   * DLQs one that keeps failing). Every message of the batch is kept invisible until it is handled\n   * (see {@link holdVisible}), so the ones waiting behind a slow handler are never redelivered to\n   * another consumer meanwhile.\n   */\n  private async pollLoop(\n    queueUrl: () => Promise<string>,\n    visibilitySec: number,\n    each: (QueueUrl: string, msg: Received) => Promise<void>,\n    concurrent = false,\n  ): Promise<void> {\n    while (this.running) {\n      let QueueUrl: string;\n      try {\n        QueueUrl = await queueUrl();\n      } catch (err) {\n        if (!this.running) return;\n        this.onError(err);\n        await this.backoff();\n        continue;\n      }\n      const messages = await this.receive(QueueUrl, visibilitySec);\n      const pending = new Set<Received>(messages);\n      const stopHolding = this.holdVisible(QueueUrl, pending, visibilitySec);\n      const handle = async (msg: Received): Promise<void> => {\n        try {\n          if (this.shouldSkip(msg)) {\n            // Not ours (shared queue): release immediately so the legacy consumer can take it.\n            pending.delete(msg);\n            await this.release(QueueUrl, msg.ReceiptHandle);\n            return;\n          }\n          await each(QueueUrl, msg);\n        } catch (err) {\n          this.onError(err);\n        } finally {\n          pending.delete(msg);\n        }\n      };\n      try {\n        if (concurrent) {\n          if (this.running) await Promise.all(messages.map(handle));\n        } else {\n          for (const msg of messages) {\n            if (!this.running) break; // close(): what is left reappears after its visibility timeout\n            await handle(msg);\n          }\n        }\n      } finally {\n        stopHolding();\n      }\n    }\n  }\n\n  /**\n   * Keep `messages` invisible while they wait or run: every third of the visibility timeout, extend\n   * each one still in the set back to the full timeout. Returns the stop function.\n   */\n  private holdVisible(\n    QueueUrl: string,\n    messages: Set<Received>,\n    visibilitySec: number,\n  ): () => void {\n    if (messages.size === 0) return () => {};\n    const intervalMs = Math.max(200, Math.floor((visibilitySec * 1000) / 3));\n    let round: Promise<void> | undefined;\n    const timer = setInterval(() => {\n      if (round) return;\n      round = Promise.all(\n        [...messages].map((msg) =>\n          msg.ReceiptHandle\n            ? this.client\n                .send(\n                  new ChangeMessageVisibilityCommand({\n                    QueueUrl,\n                    ReceiptHandle: msg.ReceiptHandle,\n                    VisibilityTimeout: visibilitySec,\n                  }),\n                )\n                .then(() => undefined)\n                .catch((err) => {\n                  if (this.running) this.onError(err);\n                })\n            : undefined,\n        ),\n      ).then(() => {\n        round = undefined;\n      });\n    }, intervalMs);\n    timer.unref?.();\n    return () => clearInterval(timer);\n  }\n\n  private parse<T>(msg: Received): T {\n    try {\n      return JSON.parse(msg.Body ?? '') as T;\n    } catch {\n      throw new Error(\n        `[SqsTransport] message ${msg.MessageId ?? '?'} has a non-JSON body; leaving it for the queue's redrive policy`,\n      );\n    }\n  }\n\n  private pollTasks(group: string): Promise<void> {\n    return this.pollLoop(\n      () => this.tasksUrl(group),\n      this.visibilityTimeoutSec,\n      async (QueueUrl, msg) => {\n        const task = this.parse<RemoteTask>(msg);\n        const result = await runStepHandler(task, this.handlers.get(task.name));\n        await this.client.send(\n          new SendMessageCommand({\n            QueueUrl: await this.resultsUrl(),\n            MessageBody: JSON.stringify(result),\n            MessageAttributes: this.marker\n              ? { [this.marker]: { DataType: 'String', StringValue: '1' } }\n              : undefined,\n          }),\n        );\n        await this.del(QueueUrl, msg.ReceiptHandle);\n      },\n    );\n  }\n\n  private pollResults(handler: (result: StepResult) => Promise<void>): Promise<void> {\n    return this.pollLoop(\n      () => this.resultsUrl(),\n      RESULT_VISIBILITY_SEC,\n      async (QueueUrl, msg) => {\n        await handler(this.parse<StepResult>(msg));\n        await this.del(QueueUrl, msg.ReceiptHandle);\n      },\n      true,\n    );\n  }\n\n  /** Wait 1s, or until `close()` aborts. The abort listener is removed when the timer fires, so\n   *  sustained failures never accumulate listeners on the shared signal. */\n  private backoff(): Promise<void> {\n    return new Promise((resolve) => {\n      const signal = this.abort.signal;\n      if (signal.aborted) return resolve();\n      const onAbort = () => {\n        clearTimeout(timer);\n        resolve();\n      };\n      const timer = setTimeout(() => {\n        signal.removeEventListener('abort', onAbort);\n        resolve();\n      }, 1000);\n      signal.addEventListener('abort', onAbort, { once: true });\n    });\n  }\n\n  /** One long-poll receive. Swallows the abort thrown on `close()`; logs and backs off otherwise. */\n  private async receive(QueueUrl: string, visibility: number): Promise<Received[]> {\n    try {\n      const out = await this.client.send(\n        new ReceiveMessageCommand({\n          QueueUrl,\n          MaxNumberOfMessages: 10,\n          WaitTimeSeconds: this.waitTimeSeconds,\n          VisibilityTimeout: visibility,\n          MessageAttributeNames: this.marker ? ['All'] : undefined,\n        }),\n        { abortSignal: this.abort.signal },\n      );\n      return out.Messages ?? [];\n    } catch (err) {\n      if (!this.running) return [];\n      this.onError(err);\n      await this.backoff();\n      return [];\n    }\n  }\n\n  private shouldSkip(msg: { MessageAttributes?: Record<string, unknown> | undefined }): boolean {\n    return !!this.marker && !msg.MessageAttributes?.[this.marker];\n  }\n\n  private async del(QueueUrl: string, ReceiptHandle?: string): Promise<void> {\n    if (!ReceiptHandle) return;\n    await this.client.send(new DeleteMessageCommand({ QueueUrl, ReceiptHandle }));\n  }\n\n  private async release(QueueUrl: string, ReceiptHandle?: string): Promise<void> {\n    if (!ReceiptHandle) return;\n    await this.client\n      .send(new ChangeMessageVisibilityCommand({ QueueUrl, ReceiptHandle, VisibilityTimeout: 0 }))\n      .catch(() => {});\n  }\n\n  /** Stop the pollers and (if we created it) destroy the SQS client so the process can exit. */\n  async close(): Promise<void> {\n    this.running = false;\n    this.abort.abort();\n    await Promise.allSettled([\n      this.taskLoop,\n      this.resultLoop,\n      ...[...this.runConsumers].map((c) => this.stopRunConsumer(c, true)),\n    ]);\n    if (this.ownsClient) this.client.destroy();\n  }\n}\n"],"mappings":"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","names":["ChangeMessageVisibilityCommand","CreateQueueCommand","DeleteMessageCommand","GetQueueUrlCommand","ReceiveMessageCommand","SQSClient","SendMessageBatchCommand","SendMessageCommand","runStepHandler","SQS_BATCH_MAX","RESULT_VISIBILITY_SEC","RESULT_RECEIVERS","TASK_BATCHES_IN_FLIGHT","SqsTransport","client","ownsClient","group","prefix","autoCreate","marker","waitTimeSeconds","visibilityTimeoutSec","taskQueueUrlResolver","resultsQueueUrlOption","runsQueueUrlResolver","runConsumers","Set","onError","handlers","Map","urlCache","groupUrlCache","running","abort","AbortController","taskLoop","resultLoop","options","SQSClient","clientConfig","taskQueueUrl","resultsQueueUrl","runsQueueUrl","err","console","error","resolveByName","name","cached","get","url","out","send","GetQueueUrlCommand","QueueName","QueueUrl","created","CreateQueueCommand","set","tasksUrl","resolver","Promise","resolve","then","catch","delete","resultsUrl","opt","runsUrl","namespace","replace","dispatchRuns","runs","opts","length","fifo","endsWith","at","chunk","slice","SendMessageBatchCommand","Entries","map","run","i","Id","String","MessageBody","JSON","stringify","MessageAttributes","DataType","StringValue","undefined","MessageGroupId","runId","MessageDeduplicationId","globalThis","crypto","randomUUID","Failed","Error","f","Message","Code","join","onDispatchedRun","handler","consumer","stopped","inflight","slotFreed","idle","loop","consumeRuns","Math","max","floor","concurrency","add","stopRunConsumer","size","push","r","setTimeout","extend","setInterval","extendRunVisibility","unref","settled","free","messages","receiveRuns","min","allSettled","m","release","ReceiptHandle","msg","shouldSkip","receipt","parse","Body","del","done","finally","splice","clearInterval","ReceiveMessageCommand","MaxNumberOfMessages","WaitTimeSeconds","VisibilityTimeout","MessageAttributeNames","abortSignal","signal","Messages","ChangeMessageVisibilityCommand","dispatch","task","SendMessageCommand","dispatchMany","tasks","byGroup","grouped","batches","all","batch","handle","fn","pollTasks","onResult","Array","from","pollResults","onHeartbeat","_handler","pollLoop","queueUrl","visibilitySec","each","concurrent","backoff","receive","pending","stopHolding","holdVisible","intervalMs","round","timer","MessageId","result","runStepHandler","aborted","onAbort","clearTimeout","removeEventListener","addEventListener","once","visibility","DeleteMessageCommand","close","c","destroy"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-durable-transport-sqs",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Amazon SQS Transport for nestjs-durable — dispatch remote steps over existing SQS queues (ElasticMQ-compatible)",
   "license": "MIT",
   "author": "Davide Carvalho",
@@ -35,7 +35,7 @@
     "typescript": "5.9.3",
     "zod": "3.25.76",
     "tsup": "8.3.5",
-    "@dudousxd/nestjs-durable-core": "^0.85.0"
+    "@dudousxd/nestjs-durable-core": "^0.85.7"
   },
   "module": "./dist/index.js",
   "exports": {