@spinajs/queue-sqs-transport 2.0.482 → 2.0.484

package/lib/cjs/connection-factory.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connection-factory.d.ts.map

package/lib/cjs/connection-factory.d.ts.map

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

package/lib/cjs/connection-factory.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const di_1 = require("@spinajs/di");
+const connection_js_1 = require("./connection.js");
+const configuration_1 = require("@spinajs/configuration");
+/**
+ * Create factory func that sets client-id to connection by app name.
+ * We cannot have two connections with the same ID, so by default we take app-name
+ * with NODE_ENV and then name from options.
+ *
+ * This way we can share the same config/connections across multiple apps.
+ */
+di_1.DI.register(async (container, options) => {
+    const cfg = container.get(configuration_1.Configuration);
+    const appName = cfg.get('app.name', 'no-app');
+    const env = cfg.get('process.env.APP_ENV', 'development');
+    const c = new connection_js_1.SqsQueueClient({
+        ...options,
+        clientId: `${appName}-${env}-${options.name}`,
+    });
+    await c.resolve();
+    return c;
+}).as(connection_js_1.SqsQueueClient);
+//# sourceMappingURL=connection-factory.js.map

package/lib/cjs/connection-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-factory.js","sourceRoot":"","sources":["../../src/connection-factory.ts"],"names":[],"mappings":";;AAAA,oCAAiC;AAEjC,mDAAiD;AACjD,0DAAuD;AAEvD;;;;;;GAMG;AACH,OAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAgC,EAAE,EAAE;IAChE,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,6BAAa,CAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAS,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAS,qBAAqB,EAAE,aAAa,CAAC,CAAC;IAElE,MAAM,CAAC,GAAG,IAAI,8BAAc,CAAC;QAC3B,GAAG,OAAO;QACV,QAAQ,EAAE,GAAG,OAAO,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE;KAC9C,CAAC,CAAC;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IAElB,OAAO,CAAC,CAAC;AACX,CAAC,CAAC,CAAC,EAAE,CAAC,8BAAc,CAAC,CAAC"}

package/lib/cjs/connection.d.ts

@@ -0,0 +1,99 @@
+import { IQueueMessage, IQueueConnectionOptions, QueueClient, QueueMessage } from '@spinajs/queue';
+import { Constructor } from '@spinajs/di';
+import { SQSClient } from '@aws-sdk/client-sqs';
+/**
+ * SQS specific connection options that can be passed through the generic
+ * {@link IQueueConnectionOptions.options} bag.
+ */
+export interface ISqsConnectionOptions {
+    region?: string;
+    queueUrl?: string;
+    endpoint?: string;
+    waitTimeSeconds?: number;
+    visibilityTimeout?: number;
+    maxMessages?: number;
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+    /**
+     * Base delay ( ms ) the poll loop sleeps after a failed ReceiveMessage before
+     * retrying. Escalates ( doubles ) on consecutive failures up to
+     * {@link receiveErrorBackoffMaxMs} and resets after a successful receive.
+     * Prevents a persistent fault ( deleted queue, revoked credentials ) from
+     * hot-looping the receive-error branch. Defaults to 500ms.
+     */
+    receiveErrorBackoffMs?: number;
+    /**
+     * Cap ( ms ) for the escalating receive-error backoff. Defaults to 10000ms.
+     */
+    receiveErrorBackoffMaxMs?: number;
+}
+/**
+ * Tracks a live subscription. Unlike STOMP there is no broker-side subscription
+ * object - a subscription here is a detached long-poll loop over one queue URL.
+ * The descriptor is the loop's control block: `running` gates the loop and the
+ * `AbortController` interrupts an in-flight ( up to WaitTimeSeconds ) ReceiveMessage
+ * so unsubscribe / dispose return promptly instead of blocking on the poll.
+ */
+interface ISqsSubscriptionDescriptor {
+    url: string;
+    callback: (e: IQueueMessage) => Promise<void>;
+    running: boolean;
+    controller: AbortController;
+    /**
+     * Set to true by {@link pollLoop} right before it returns, regardless of how it
+     * exits ( normal stop, abort or a swallowed error ). Lets callers / tests
+     * observe that the detached loop has actually wound down.
+     */
+    exited: boolean;
+}
+export declare class SqsQueueClient extends QueueClient {
+    /**
+     * Underlying AWS SQS client. SQS is a plain HTTP service so there is no
+     * long-lived connection to keep alive - the client is created in {@link resolve}
+     * and reused for every {@link emit}.
+     */
+    protected Sqs: SQSClient;
+    /**
+     * Active subscriptions keyed by queue URL. Each entry owns a detached poll loop.
+     */
+    protected Subscriptions: Map<string, ISqsSubscriptionDescriptor>;
+    constructor(options: IQueueConnectionOptions);
+    resolve(): Promise<void>;
+    emit(message: IQueueMessage): Promise<void>;
+    subscribe(channelOrMessage: string | Constructor<QueueMessage>, callback: (e: IQueueMessage) => Promise<void>, _subscriptionId?: string, _durable?: boolean): Promise<void>;
+    /**
+     * Long-poll loop for a single subscription. Runs until `desc.running` is cleared
+     * ( by unsubscribe / dispose ). On success the message is acked by DeleteMessage;
+     * on handler failure the message is left untouched so the SQS visibility timeout
+     * redelivers it and the redrive policy dead-letters after maxReceiveCount.
+     */
+    protected pollLoop(desc: ISqsSubscriptionDescriptor): Promise<void>;
+    /**
+     * Processes a single received SQS message: parse -> rehydrate -> handler -> ack.
+     * Guards against poison / non-object payloads so a bad message is skipped rather
+     * than crashing the loop. Keeps the ack/nack contract: delete on handler success,
+     * leave ( for redelivery / DLQ ) on handler failure.
+     */
+    protected handleMessage(desc: ISqsSubscriptionDescriptor, m: {
+        Body?: string;
+        ReceiptHandle?: string;
+    }): Promise<void>;
+    unsubscribe(channelOrMessage: string | Constructor<QueueMessage>, _removeDurable?: boolean): void;
+    dispose(): Promise<void>;
+    /**
+     * Abortable delay used by the receive-error backoff. Resolves after `ms`, or
+     * immediately if the descriptor's AbortController fires ( unsubscribe / dispose )
+     * so a disposed subscription never sits parked in a long backoff sleep. The
+     * loop re-checks `desc.running` right after, so an abort mid-sleep exits promptly.
+     */
+    protected backoffSleep(ms: number, signal: AbortSignal): Promise<void>;
+    /**
+     * Stops a subscription's poll loop: clears the running flag and aborts any
+     * in-flight ReceiveMessage. The loop observes both and exits.
+     */
+    protected stop(desc: ISqsSubscriptionDescriptor): void;
+}
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/lib/cjs/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,WAAW,EAAgC,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,SAAS,EAAmE,MAAM,qBAAqB,CAAC;AAIjH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;GAMG;AACH,UAAU,0BAA0B;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,qBAEa,cAAe,SAAQ,WAAW;IAC7C;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,aAAa,0CAAiD;gBAE5D,OAAO,EAAE,uBAAuB;IAI/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBxB,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3C,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BxL;;;;;OAKG;cACa,QAAQ,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IA2EzE;;;;;OAKG;cACa,aAAa,CAAC,IAAI,EAAE,0BAA0B,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDrH,WAAW,CAAC,gBAAgB,EAAE,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI;IAiB3F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrC;;;;;OAKG;IACH,SAAS,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBtE;;;OAGG;IACH,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI;CAIvD"}

package/lib/cjs/connection.js

@@ -0,0 +1,264 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqsQueueClient = void 0;
+const queue_1 = require("@spinajs/queue");
+const di_1 = require("@spinajs/di");
+const client_sqs_1 = require("@aws-sdk/client-sqs");
+const luxon_1 = require("luxon");
+const lodash_1 = __importDefault(require("lodash"));
+let SqsQueueClient = class SqsQueueClient extends queue_1.QueueClient {
+    constructor(options) {
+        super(options);
+        /**
+         * Active subscriptions keyed by queue URL. Each entry owns a detached poll loop.
+         */
+        this.Subscriptions = new Map();
+    }
+    async resolve() {
+        const o = (this.Options.options ?? {});
+        // SQS is HTTP based - there is no eager connection to establish and no
+        // connection-level destination to validate here. Destinations are resolved
+        // per-message at emit time via getChannelForMessage, which consults the
+        // global queue.routing table first and only then falls back to the
+        // connection defaults - so a routing-only connection ( no defaultQueueChannel /
+        // defaultTopicChannel ) is perfectly valid. resolve()'s only job is to build
+        // the SQSClient; region/endpoint/credentials are all optional for the SDK.
+        this.Sqs = new client_sqs_1.SQSClient({
+            region: o.region,
+            endpoint: o.endpoint,
+            credentials: o.credentials,
+        });
+        this.Log.info(`SQS queue client ${this.Options.name} resolved ( region: ${o.region ?? '<default>'}, endpoint: ${o.endpoint ?? '<default>'} )`);
+    }
+    async emit(message) {
+        // routing[message.Name] || defaultQueueChannel|defaultTopicChannel - for SQS
+        // these entries are queue URLs. `Name`/`Type`/`JobId` ride the JSON body so
+        // the core consumer can rehydrate the message on the receiving side.
+        const urls = this.getChannelForMessage(message);
+        const body = JSON.stringify(message);
+        await Promise.all(urls.map((QueueUrl) => {
+            this.Log.trace(`Publishing ${message.Type} Name: ${message.Name} to SQS queue ${QueueUrl} ( ${this.Options.name} )`);
+            return this.Sqs.send(new client_sqs_1.SendMessageCommand({ QueueUrl, MessageBody: body }));
+        }));
+    }
+    async subscribe(channelOrMessage, callback, _subscriptionId, _durable) {
+        // mirror STOMP's overload handling: a raw string is the queue URL itself,
+        // a message class is resolved through the routing table.
+        const urls = lodash_1.default.isString(channelOrMessage) ? [channelOrMessage] : this.getChannelForMessage(channelOrMessage);
+        urls.forEach((url) => {
+            if (this.Subscriptions.has(url)) {
+                this.Log.warn(`SQS queue ${url} already subscribed !`);
+                return;
+            }
+            const desc = {
+                url,
+                callback,
+                running: true,
+                controller: new AbortController(),
+                exited: false,
+            };
+            this.Subscriptions.set(url, desc);
+            // detached loop - subscribe returns as soon as the poll loop is started,
+            // it is NOT awaited. Errors inside the loop must never escape ( there is no
+            // caller to catch them ), so pollLoop swallows/logs everything itself.
+            void this.pollLoop(desc);
+            this.Log.success(`SQS queue ${url} subscribed and polling for messages !`);
+        });
+    }
+    /**
+     * Long-poll loop for a single subscription. Runs until `desc.running` is cleared
+     * ( by unsubscribe / dispose ). On success the message is acked by DeleteMessage;
+     * on handler failure the message is left untouched so the SQS visibility timeout
+     * redelivers it and the redrive policy dead-letters after maxReceiveCount.
+     */
+    async pollLoop(desc) {
+        const o = (this.Options.options ?? {});
+        // Escalating backoff for the receive-error branch. Starts at the base delay,
+        // doubles on each consecutive failure up to the cap, and is reset to the base
+        // after any successful ReceiveMessage. Without this a persistent fault
+        // ( deleted queue, revoked credentials, permanently dead endpoint ) makes the
+        // SDK send throw immediately and the loop spins as a tight infinite loop,
+        // spamming logs and hammering the SQS API.
+        const baseBackoff = Math.max(0, o.receiveErrorBackoffMs ?? 500);
+        const maxBackoff = Math.max(baseBackoff, o.receiveErrorBackoffMaxMs ?? 10000);
+        let backoff = baseBackoff;
+        try {
+            while (desc.running) {
+                let res;
+                try {
+                    res = await this.Sqs.send(new client_sqs_1.ReceiveMessageCommand({
+                        QueueUrl: desc.url,
+                        WaitTimeSeconds: o.waitTimeSeconds ?? 20,
+                        MaxNumberOfMessages: o.maxMessages ?? 1,
+                        VisibilityTimeout: o.visibilityTimeout,
+                    }), { abortSignal: desc.controller.signal });
+                    // a successful receive clears the fault - drop back to the base delay so a
+                    // transient blip doesn't leave the loop permanently slow.
+                    backoff = baseBackoff;
+                }
+                catch (err) {
+                    // aborted by unsubscribe / dispose - the in-flight long poll was cut short
+                    if (!desc.running) {
+                        break;
+                    }
+                    // receive error ( throttling, network blip, or a persistent fault ) - log
+                    // and keep the loop alive, otherwise a single hiccup would silently stop
+                    // consumption. Back off before retrying so a *persistent* fault can't
+                    // hot-loop the receive; the sleep is abortable so unsubscribe / dispose
+                    // still tears the loop down promptly instead of waiting out the delay.
+                    this.Log.warn(`SQS receive error on ${desc.url} ( ${this.Options.name} ), backing off ${backoff}ms: ${err}`);
+                    await this.backoffSleep(backoff, desc.controller.signal);
+                    backoff = Math.min(backoff * 2, maxBackoff);
+                    continue;
+                }
+                for (const m of res?.Messages ?? []) {
+                    // a concurrent unsubscribe / dispose may have flipped this mid-batch
+                    if (!desc.running) {
+                        break;
+                    }
+                    // Defense-in-depth: NOTHING a single message does may escape this loop as
+                    // an unhandled rejection ( the loop runs detached - there is no caller to
+                    // catch it, and an escaped throw would crash the worker / Node process ).
+                    // Any per-message failure is logged and the loop moves on.
+                    try {
+                        await this.handleMessage(desc, m);
+                    }
+                    catch (err) {
+                        this.Log.error(`Unexpected error handling SQS message on ${desc.url} ( ${this.Options.name} ), skipping: ${err}`);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            // last-resort guard: even the loop scaffolding ( e.g. an unexpected throw from
+            // the receive-error branch ) must not reject the detached promise.
+            this.Log.error(`SQS poll loop for ${desc.url} ( ${this.Options.name} ) crashed unexpectedly: ${err}`);
+        }
+        finally {
+            desc.exited = true;
+            this.Log.trace(`SQS poll loop for ${desc.url} ( ${this.Options.name} ) stopped`);
+        }
+    }
+    /**
+     * Processes a single received SQS message: parse -> rehydrate -> handler -> ack.
+     * Guards against poison / non-object payloads so a bad message is skipped rather
+     * than crashing the loop. Keeps the ack/nack contract: delete on handler success,
+     * leave ( for redelivery / DLQ ) on handler failure.
+     */
+    async handleMessage(desc, m) {
+        let parsed;
+        try {
+            parsed = JSON.parse(m.Body);
+        }
+        catch (e) {
+            // poison message - we can't tell its Type so we can't route it. Leave it:
+            // SQS redelivery + the redrive policy will dead-letter it after maxReceiveCount,
+            // which is preferable to deleting evidence of a producer bug.
+            this.Log.error(`Unparseable SQS message on ${desc.url} ( ${this.Options.name} ), leaving for redelivery / DLQ: ${e}`);
+            return;
+        }
+        // JSON.parse happily yields non-object values ( null, numbers, strings,
+        // booleans ) that would blow up the CreatedAt / callback access below with a
+        // TypeError. Treat them as poison and skip so the loop stays alive.
+        if (!parsed || typeof parsed !== 'object') {
+            this.Log.error(`Non-object SQS message body on ${desc.url} ( ${this.Options.name} ), skipping`);
+            return;
+        }
+        const message = parsed;
+        // luxon DateTime serializes to an ISO string over the wire - rehydrate it
+        if (typeof message.CreatedAt === 'string') {
+            message.CreatedAt = luxon_1.DateTime.fromISO(message.CreatedAt);
+        }
+        try {
+            await desc.callback(message);
+        }
+        catch (err) {
+            // NACK: do nothing. The message stays invisible only for the visibility
+            // timeout, after which SQS redelivers; the redrive policy dead-letters it
+            // once maxReceiveCount is hit. No manual retry / DLQ logic here.
+            this.Log.error(`Handler failed for ${message.Name} on ${desc.url}, leaving message for redelivery: ${err}`);
+            return;
+        }
+        // ACK: only delete once the handler has fully succeeded. A delete failure is
+        // non-fatal ( at-least-once: SQS will simply redeliver ) and is logged
+        // distinctly so it is never mistaken for a handler failure.
+        try {
+            await this.Sqs.send(new client_sqs_1.DeleteMessageCommand({ QueueUrl: desc.url, ReceiptHandle: m.ReceiptHandle }));
+            this.Log.trace(`Processed and acked ${message.Type} Name: ${message.Name} from ${desc.url} ( ${this.Options.name} )`);
+        }
+        catch (err) {
+            this.Log.error(`ack/delete failed for message ${message.Name} on ${desc.url} ( ${this.Options.name} ), it will redeliver: ${err}`);
+        }
+    }
+    unsubscribe(channelOrMessage, _removeDurable) {
+        const urls = lodash_1.default.isString(channelOrMessage) ? [channelOrMessage] : this.getChannelForMessage(channelOrMessage);
+        urls.forEach((url) => {
+            const desc = this.Subscriptions.get(url);
+            if (!desc) {
+                return;
+            }
+            this.stop(desc);
+            this.Subscriptions.delete(url);
+            this.Log.info(`Unsubscribed from SQS queue ${url} ( ${this.Options.name} )`);
+        });
+    }
+    async dispose() {
+        // stop every poll loop and interrupt any in-flight long poll so this returns
+        // promptly instead of waiting up to WaitTimeSeconds for the last receive.
+        for (const desc of this.Subscriptions.values()) {
+            this.stop(desc);
+        }
+        this.Subscriptions.clear();
+        this.Sqs?.destroy();
+        this.Log.info(`SQS queue client ${this.Options.name} disposed`);
+    }
+    /**
+     * Abortable delay used by the receive-error backoff. Resolves after `ms`, or
+     * immediately if the descriptor's AbortController fires ( unsubscribe / dispose )
+     * so a disposed subscription never sits parked in a long backoff sleep. The
+     * loop re-checks `desc.running` right after, so an abort mid-sleep exits promptly.
+     */
+    backoffSleep(ms, signal) {
+        if (ms <= 0 || signal.aborted) {
+            return Promise.resolve();
+        }
+        return new Promise((resolve) => {
+            const onAbort = () => {
+                clearTimeout(timer);
+                resolve();
+            };
+            const timer = setTimeout(() => {
+                signal.removeEventListener('abort', onAbort);
+                resolve();
+            }, ms);
+            signal.addEventListener('abort', onAbort, { once: true });
+        });
+    }
+    /**
+     * Stops a subscription's poll loop: clears the running flag and aborts any
+     * in-flight ReceiveMessage. The loop observes both and exits.
+     */
+    stop(desc) {
+        desc.running = false;
+        desc.controller.abort();
+    }
+};
+exports.SqsQueueClient = SqsQueueClient;
+exports.SqsQueueClient = SqsQueueClient = __decorate([
+    (0, di_1.PerInstanceCheck)(),
+    (0, di_1.Injectable)(queue_1.QueueClient),
+    __metadata("design:paramtypes", [Object])
+], SqsQueueClient);
+//# sourceMappingURL=connection.js.map

package/lib/cjs/connection.js.map

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

package/lib/cjs/index.d.ts

@@ -0,0 +1,3 @@
+export * from './connection-factory.js';
+export * from './connection.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

package/lib/cjs/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./connection-factory.js"), exports);
+__exportStar(require("./connection.js"), exports);
+//# sourceMappingURL=index.js.map

package/lib/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,kDAAgC"}

package/lib/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/mjs/connection-factory.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connection-factory.d.ts.map

package/lib/mjs/connection-factory.d.ts.map

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

package/lib/mjs/connection-factory.js

@@ -0,0 +1,22 @@
+import { DI } from '@spinajs/di';
+import { SqsQueueClient } from './connection.js';
+import { Configuration } from '@spinajs/configuration';
+/**
+ * Create factory func that sets client-id to connection by app name.
+ * We cannot have two connections with the same ID, so by default we take app-name
+ * with NODE_ENV and then name from options.
+ *
+ * This way we can share the same config/connections across multiple apps.
+ */
+DI.register(async (container, options) => {
+    const cfg = container.get(Configuration);
+    const appName = cfg.get('app.name', 'no-app');
+    const env = cfg.get('process.env.APP_ENV', 'development');
+    const c = new SqsQueueClient({
+        ...options,
+        clientId: `${appName}-${env}-${options.name}`,
+    });
+    await c.resolve();
+    return c;
+}).as(SqsQueueClient);
+//# sourceMappingURL=connection-factory.js.map

package/lib/mjs/connection-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-factory.js","sourceRoot":"","sources":["../../src/connection-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;;;GAMG;AACH,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,OAAgC,EAAE,EAAE;IAChE,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAS,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAS,qBAAqB,EAAE,aAAa,CAAC,CAAC;IAElE,MAAM,CAAC,GAAG,IAAI,cAAc,CAAC;QAC3B,GAAG,OAAO;QACV,QAAQ,EAAE,GAAG,OAAO,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE;KAC9C,CAAC,CAAC;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;IAElB,OAAO,CAAC,CAAC;AACX,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC"}

package/lib/mjs/connection.d.ts

@@ -0,0 +1,99 @@
+import { IQueueMessage, IQueueConnectionOptions, QueueClient, QueueMessage } from '@spinajs/queue';
+import { Constructor } from '@spinajs/di';
+import { SQSClient } from '@aws-sdk/client-sqs';
+/**
+ * SQS specific connection options that can be passed through the generic
+ * {@link IQueueConnectionOptions.options} bag.
+ */
+export interface ISqsConnectionOptions {
+    region?: string;
+    queueUrl?: string;
+    endpoint?: string;
+    waitTimeSeconds?: number;
+    visibilityTimeout?: number;
+    maxMessages?: number;
+    credentials?: {
+        accessKeyId: string;
+        secretAccessKey: string;
+    };
+    /**
+     * Base delay ( ms ) the poll loop sleeps after a failed ReceiveMessage before
+     * retrying. Escalates ( doubles ) on consecutive failures up to
+     * {@link receiveErrorBackoffMaxMs} and resets after a successful receive.
+     * Prevents a persistent fault ( deleted queue, revoked credentials ) from
+     * hot-looping the receive-error branch. Defaults to 500ms.
+     */
+    receiveErrorBackoffMs?: number;
+    /**
+     * Cap ( ms ) for the escalating receive-error backoff. Defaults to 10000ms.
+     */
+    receiveErrorBackoffMaxMs?: number;
+}
+/**
+ * Tracks a live subscription. Unlike STOMP there is no broker-side subscription
+ * object - a subscription here is a detached long-poll loop over one queue URL.
+ * The descriptor is the loop's control block: `running` gates the loop and the
+ * `AbortController` interrupts an in-flight ( up to WaitTimeSeconds ) ReceiveMessage
+ * so unsubscribe / dispose return promptly instead of blocking on the poll.
+ */
+interface ISqsSubscriptionDescriptor {
+    url: string;
+    callback: (e: IQueueMessage) => Promise<void>;
+    running: boolean;
+    controller: AbortController;
+    /**
+     * Set to true by {@link pollLoop} right before it returns, regardless of how it
+     * exits ( normal stop, abort or a swallowed error ). Lets callers / tests
+     * observe that the detached loop has actually wound down.
+     */
+    exited: boolean;
+}
+export declare class SqsQueueClient extends QueueClient {
+    /**
+     * Underlying AWS SQS client. SQS is a plain HTTP service so there is no
+     * long-lived connection to keep alive - the client is created in {@link resolve}
+     * and reused for every {@link emit}.
+     */
+    protected Sqs: SQSClient;
+    /**
+     * Active subscriptions keyed by queue URL. Each entry owns a detached poll loop.
+     */
+    protected Subscriptions: Map<string, ISqsSubscriptionDescriptor>;
+    constructor(options: IQueueConnectionOptions);
+    resolve(): Promise<void>;
+    emit(message: IQueueMessage): Promise<void>;
+    subscribe(channelOrMessage: string | Constructor<QueueMessage>, callback: (e: IQueueMessage) => Promise<void>, _subscriptionId?: string, _durable?: boolean): Promise<void>;
+    /**
+     * Long-poll loop for a single subscription. Runs until `desc.running` is cleared
+     * ( by unsubscribe / dispose ). On success the message is acked by DeleteMessage;
+     * on handler failure the message is left untouched so the SQS visibility timeout
+     * redelivers it and the redrive policy dead-letters after maxReceiveCount.
+     */
+    protected pollLoop(desc: ISqsSubscriptionDescriptor): Promise<void>;
+    /**
+     * Processes a single received SQS message: parse -> rehydrate -> handler -> ack.
+     * Guards against poison / non-object payloads so a bad message is skipped rather
+     * than crashing the loop. Keeps the ack/nack contract: delete on handler success,
+     * leave ( for redelivery / DLQ ) on handler failure.
+     */
+    protected handleMessage(desc: ISqsSubscriptionDescriptor, m: {
+        Body?: string;
+        ReceiptHandle?: string;
+    }): Promise<void>;
+    unsubscribe(channelOrMessage: string | Constructor<QueueMessage>, _removeDurable?: boolean): void;
+    dispose(): Promise<void>;
+    /**
+     * Abortable delay used by the receive-error backoff. Resolves after `ms`, or
+     * immediately if the descriptor's AbortController fires ( unsubscribe / dispose )
+     * so a disposed subscription never sits parked in a long backoff sleep. The
+     * loop re-checks `desc.running` right after, so an abort mid-sleep exits promptly.
+     */
+    protected backoffSleep(ms: number, signal: AbortSignal): Promise<void>;
+    /**
+     * Stops a subscription's poll loop: clears the running flag and aborts any
+     * in-flight ReceiveMessage. The loop observes both and exits.
+     */
+    protected stop(desc: ISqsSubscriptionDescriptor): void;
+}
+export {};
+//# sourceMappingURL=connection.d.ts.map

package/lib/mjs/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,WAAW,EAAgC,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,SAAS,EAAmE,MAAM,qBAAqB,CAAC;AAIjH;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;GAMG;AACH,UAAU,0BAA0B;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,eAAe,CAAC;IAC5B;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,qBAEa,cAAe,SAAQ,WAAW;IAC7C;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,aAAa,0CAAiD;gBAE5D,OAAO,EAAE,uBAAuB;IAI/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBxB,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAe3C,SAAS,CAAC,gBAAgB,EAAE,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BxL;;;;;OAKG;cACa,QAAQ,CAAC,IAAI,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IA2EzE;;;;;OAKG;cACa,aAAa,CAAC,IAAI,EAAE,0BAA0B,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDrH,WAAW,CAAC,gBAAgB,EAAE,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,IAAI;IAiB3F,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrC;;;;;OAKG;IACH,SAAS,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBtE;;;OAGG;IACH,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI;CAIvD"}