@spinajs/queue-amqp-transport 2.0.482 → 2.0.485

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.AmqpQueueClient({
+        ...options,
+        clientId: `${appName}-${env}-${options.name}`,
+    });
+    await c.resolve();
+    return c;
+}).as(connection_js_1.AmqpQueueClient);
+//# 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,mDAAkD;AAClD,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,+BAAe,CAAC;QAC5B,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,+BAAe,CAAC,CAAC"}

package/lib/cjs/connection.d.ts

@@ -0,0 +1,148 @@
+import { IQueueMessage, IQueueConnectionOptions, QueueClient, QueueMessage } from '@spinajs/queue';
+import { Channel, ChannelModel, ConfirmChannel, ConsumeMessage, Options } from 'amqplib';
+import { Constructor } from '@spinajs/di';
+import { ResiliencePipeline } from '@spinajs/util';
+/**
+ * Everything needed to re-establish a subscription after a reconnect. amqplib consumers do not
+ * survive a dropped connection, so we keep descriptors and replay them on every (re)connect.
+ */
+interface ISubscriptionDescriptor {
+    channel: string;
+    callback: (e: IQueueMessage) => Promise<void>;
+    subscriptionId?: string;
+    durable: boolean;
+    /** Runtime state - refreshed on every (re)connect. */
+    consumerTag?: string;
+    queue?: string;
+}
+interface IPendingEmit {
+    message: IQueueMessage;
+    resolve: () => void;
+    reject: (err: unknown) => void;
+}
+export declare class AmqpQueueClient extends QueueClient {
+    protected Connection: ChannelModel;
+    /** Confirm channel used for publishing so emit() resolves only after a broker ack. */
+    protected PublishChannel: ConfirmChannel;
+    /** Separate channel for consumers so publisher back-pressure cannot stall consumer acks. */
+    protected ConsumeChannel: Channel;
+    protected Subscriptions: Map<string, ISubscriptionDescriptor>;
+    protected AssertedQueues: Set<string>;
+    protected AssertedExchanges: Set<string>;
+    protected AssertedRetryQueues: Set<string>;
+    /** Messages emitted while disconnected - flushed on (re)connect. */
+    protected PendingEmits: IPendingEmit[];
+    protected Connected: boolean;
+    protected Disposing: boolean;
+    protected ReconnectTimer?: ReturnType<typeof setTimeout>;
+    /** Publisher-side resilience: time-bound + retry each publish so transient broker hiccups
+     * don't lose an emit. Safe against the resulting duplicates because consumers dedupe by JobId. */
+    protected EmitPipeline: ResiliencePipeline<void>;
+    get ClientId(): string;
+    protected get TopicPrefix(): string;
+    protected get ReconnectDelay(): number;
+    protected get Prefetch(): number;
+    get IsConnected(): boolean;
+    constructor(options: IQueueConnectionOptions);
+    resolve(): Promise<void>;
+    /**
+     * Creates the underlying amqplib connection. Isolated as a seam so tests can inject a fake
+     * broker without a real server ( mirrors the STOMP transport's createClient seam ).
+     */
+    protected createConnection(url: string | Options.Connect, socketOptions: Record<string, unknown>): Promise<ChannelModel>;
+    /**
+     * Builds the amqplib connection target from the configured options.
+     *
+     * A url-style host ( `amqp://.../vhost` ) is parsed into an explicit {@link Options.Connect}
+     * object rather than passed as a raw string, so every setting - crucially the credentials - is a
+     * clear field instead of being buried in the url. amqplib derives credentials for a *string* url
+     * only from the url's own userinfo, which is why the discrete `login` / `password` config fields
+     * were previously ignored for a url host. Credentials embedded in the url still win; the config
+     * fields are the fallback when the url carries none ( matching amqplib's own precedence ).
+     */
+    protected buildConnectionTarget(): Options.Connect;
+    /** Connect-options object built from the discrete `host` / `port` / `login` / `password` fields. */
+    protected connectOptionsFromFields(hostname: string): Options.Connect;
+    dispose(): Promise<void>;
+    /**
+     * Establishes the connection + channels, then replays subscriptions and flushes buffered emits.
+     * Called on initial resolve and on every reconnect.
+     */
+    protected connect(): Promise<void>;
+    /**
+     * Handles an unexpected connection drop by scheduling a reconnect ( unless we are disposing ).
+     */
+    protected onConnectionLost(): void;
+    protected scheduleReconnect(): void;
+    emit(message: IQueueMessage): Promise<void>;
+    subscribe(channelOrMessage: string | Constructor<QueueMessage>, callback: (e: IQueueMessage) => Promise<void>, subscriptionId?: string, durable?: boolean): Promise<void>;
+    unsubscribe(channelOrMessage: string | Constructor<QueueMessage>, _removeDurable?: boolean): void;
+    /**
+     * Re-establishes every known subscription. Called after a (re)connect.
+     */
+    protected replaySubscriptions(): Promise<void>;
+    /**
+     * Declares the queue for a subscription and starts consuming, wiring ack/nack + retry/dead-letter.
+     */
+    protected startConsumer(descriptor: ISubscriptionDescriptor): Promise<void>;
+    /**
+     * Handles a message whose consumer callback rejected.
+     *
+     * Events are fire-and-forget - logged and acked ( dropped ). Jobs are retried up to their
+     * RetryCount by re-publishing to a TTL "retry" queue that dead-letters back to the work queue
+     * after an exponential delay, then dead-lettered once retries are exhausted.
+     */
+    protected handleFailedMessage(msg: ConsumeMessage, qMessage: IQueueMessage, channel: string, err: unknown): void;
+    /**
+     * Republishes a failed job to a per-delay TTL retry queue that dead-letters back to the work
+     * queue after the delay, giving broker-side ( crash-safe ) exponential backoff. Then acks original.
+     */
+    protected retryJob(msg: ConsumeMessage, qMessage: IQueueMessage, workQueue: string, nextAttempt: number, reason: string): Promise<void>;
+    /**
+     * Publishes a failed/unparseable message to the dead-letter queue and acks the original to
+     * unblock the source queue. When no dead-letter queue is configured the message is dropped
+     * ( acked ) with a warning - we never nack-loop a poison message forever.
+     */
+    protected deadLetterRaw(msg: ConsumeMessage, dlq: string | undefined, channel: string, reason: string, attempt?: number): void;
+    /**
+     * Exponential backoff ( ms ) for the given retry attempt, based on `Options.retryDelay`.
+     * Returns 0 ( immediate redelivery ) when no base delay is configured.
+     */
+    protected retryBackoff(attempt: number): number;
+    /**
+     * Publisher-side resilience pipeline: bounds each publish by a timeout and retries transient
+     * failures / nacks with exponential backoff. Consumer dedup ( by JobId ) makes the resulting
+     * rare duplicates harmless.
+     */
+    protected buildEmitPipeline(): ResiliencePipeline<void>;
+    protected publishMessage(message: IQueueMessage): Promise<void>;
+    /** Asserts the destination ( once ) and publishes a single message on the confirm channel. */
+    protected publishToChannel(channel: string, buffer: Buffer, options: Options.Publish): Promise<void>;
+    /**
+     * Publishes on the confirm channel and resolves only once the broker acks the message.
+     */
+    protected publishWithConfirm(exchange: string, routingKey: string, content: Buffer, options: Options.Publish): Promise<void>;
+    protected flushPendingEmits(): Promise<void>;
+    /**
+     * Declares ( and for topics binds ) the broker queue a subscription should consume from.
+     */
+    protected assertSubscriptionQueue(channel: string, subscriptionId?: string, durable?: boolean): Promise<string>;
+    /**
+     * Declares a durable work queue, asserting it on the broker only once per connection.
+     */
+    protected assertQueue(channel: Channel | ConfirmChannel, name: string): Promise<string>;
+    /**
+     * Declares a durable fanout exchange, asserting it on the broker only once per connection.
+     */
+    protected assertExchange(channel: Channel | ConfirmChannel, name: string): Promise<void>;
+    /**
+     * Declares a durable TTL retry queue that dead-letters expired messages back to `workQueue`
+     * ( via the default exchange, routing key = queue name ). One queue per distinct delay.
+     */
+    protected assertRetryQueue(workQueue: string, delay: number): Promise<string>;
+    protected isTopic(channel: string): boolean;
+    protected closeChannel(channel?: Channel | ConfirmChannel): Promise<void>;
+    protected warnOnUnsupportedScheduling(message: IQueueMessage): 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":"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"}