amqp-resilient 1.0.0

package/dist/publisher/BasePublisher.js

@@ -0,0 +1,275 @@
+import { randomUUID } from 'crypto';
+import { CircuitBreaker, CircuitBreakerOpenError } from '../patterns/CircuitBreaker.js';
+/** Default retry configuration */
+const DEFAULTS = {
+    MAX_RETRIES: 3,
+    INITIAL_RETRY_DELAY: 100,
+    MAX_RETRY_DELAY: 5000,
+    CIRCUIT_BREAKER_THRESHOLD: 5,
+};
+/**
+ * BasePublisher - Base class for AMQP publishers
+ * Use this class directly or extend it for specific publishers
+ */
+export class BasePublisher {
+    connection;
+    channel = null;
+    isInitialized = false;
+    circuitBreaker = null;
+    logger;
+    exchange;
+    exchangeType;
+    confirm;
+    maxRetries;
+    initialRetryDelay;
+    maxRetryDelay;
+    useCircuitBreaker;
+    constructor(connection, options) {
+        this.connection = connection;
+        this.exchange = options.exchange;
+        this.exchangeType = options.exchangeType ?? 'topic';
+        this.confirm = options.confirm ?? true;
+        this.maxRetries = options.maxRetries ?? DEFAULTS.MAX_RETRIES;
+        this.initialRetryDelay = options.initialRetryDelay ?? DEFAULTS.INITIAL_RETRY_DELAY;
+        this.maxRetryDelay = options.maxRetryDelay ?? DEFAULTS.MAX_RETRY_DELAY;
+        this.useCircuitBreaker = options.useCircuitBreaker ?? true;
+        this.logger = options.logger ?? connection.getLogger();
+        // Initialize circuit breaker if enabled
+        if (this.useCircuitBreaker) {
+            this.circuitBreaker = new CircuitBreaker({
+                name: `publisher-${this.exchange}`,
+                failureThreshold: options.circuitBreakerThreshold ?? DEFAULTS.CIRCUIT_BREAKER_THRESHOLD,
+                resetTimeout: 30000,
+                successThreshold: 3,
+                logger: this.logger,
+            });
+        }
+    }
+    /**
+     * Initialize the publisher - setup exchange
+     */
+    async initialize() {
+        if (this.isInitialized)
+            return;
+        try {
+            // Get appropriate channel type
+            if (this.confirm) {
+                this.channel = await this.connection.getConfirmChannel();
+            }
+            else {
+                this.channel = await this.connection.getChannel();
+            }
+            // Assert the exchange
+            await this.channel.assertExchange(this.exchange, this.exchangeType, { durable: true });
+            this.isInitialized = true;
+            this.logger.info({ exchange: this.exchange, type: this.exchangeType, confirms: this.confirm }, 'Publisher initialized');
+        }
+        catch (error) {
+            this.logger.error({ err: error, exchange: this.exchange }, 'Failed to initialize publisher');
+            throw error;
+        }
+    }
+    /**
+     * Execute single publish attempt
+     */
+    async executePublishAttempt(routingKey, message, options) {
+        if (this.circuitBreaker) {
+            await this.circuitBreaker.execute(() => this.doPublish(routingKey, message, options));
+        }
+        else {
+            await this.doPublish(routingKey, message, options);
+        }
+    }
+    /**
+     * Handle publish retry logic
+     */
+    async handlePublishRetry(routingKey, messageId, retries, lastError) {
+        if (retries > this.maxRetries)
+            return false;
+        const delay = this.calculateRetryDelay(retries);
+        this.logger.warn({
+            exchange: this.exchange,
+            routingKey,
+            messageId,
+            retry: retries,
+            maxRetries: this.maxRetries,
+            delayMs: delay,
+            error: lastError.message,
+        }, 'Retrying publish after failure');
+        await this.sleep(delay);
+        return true;
+    }
+    /**
+     * Log publish failure after all retries exhausted
+     */
+    logPublishFailure(routingKey, messageId, retries, error) {
+        this.logger.error({
+            exchange: this.exchange,
+            routingKey,
+            messageId,
+            retries,
+            error: error?.message,
+        }, 'Failed to publish message after all retries');
+    }
+    /**
+     * Handle circuit breaker error during publish
+     */
+    handleCircuitBreakerError(error, routingKey, messageId) {
+        this.logger.warn({
+            exchange: this.exchange,
+            routingKey,
+            messageId,
+            remainingResetTime: error.remainingResetTime,
+        }, 'Publish blocked by circuit breaker');
+        throw error;
+    }
+    /**
+     * Publish a message to the exchange
+     */
+    async publish(routingKey, message, options = {}) {
+        const messageId = options.messageId ?? randomUUID();
+        const correlationId = options.correlationId ?? randomUUID();
+        const publishOptions = { ...options, messageId, correlationId };
+        let retries = 0;
+        let lastError;
+        while (retries <= this.maxRetries) {
+            try {
+                await this.executePublishAttempt(routingKey, message, publishOptions);
+                if (retries > 0) {
+                    this.logger.info({ exchange: this.exchange, routingKey, messageId, retries }, 'Message published after retry');
+                }
+                return { success: true, messageId, correlationId, retries };
+            }
+            catch (error) {
+                lastError = error instanceof Error ? error : new Error(String(error));
+                if (error instanceof CircuitBreakerOpenError) {
+                    this.handleCircuitBreakerError(error, routingKey, messageId);
+                }
+                retries++;
+                if (!(await this.handlePublishRetry(routingKey, messageId, retries, lastError))) {
+                    break;
+                }
+            }
+        }
+        this.logPublishFailure(routingKey, messageId, retries, lastError);
+        return { success: false, messageId, correlationId, retries, error: lastError };
+    }
+    /**
+     * Publish a message and throw on failure (for critical messages)
+     */
+    async publishOrThrow(routingKey, message, options = {}) {
+        const result = await this.publish(routingKey, message, options);
+        if (!result.success) {
+            throw result.error ?? new Error('Failed to publish message');
+        }
+        return result;
+    }
+    /**
+     * Build publish options
+     */
+    buildPublishOptions(options) {
+        return {
+            messageId: options.messageId,
+            correlationId: options.correlationId,
+            persistent: options.persistent ?? true,
+            contentType: options.contentType ?? 'application/json',
+            timestamp: Date.now(),
+            priority: options.priority,
+            expiration: options.expiration,
+            replyTo: options.replyTo,
+            headers: {
+                ...options.headers,
+                'x-published-at': new Date().toISOString(),
+                'x-publisher': this.exchange,
+            },
+        };
+    }
+    /**
+     * Publish with confirm channel (guaranteed delivery)
+     */
+    async publishWithConfirm(routingKey, content, publishOptions) {
+        await new Promise((resolve, reject) => {
+            this.channel.publish(this.exchange, routingKey, content, publishOptions, (err) => {
+                if (err) {
+                    reject(err instanceof Error ? err : new Error(String(err)));
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Publish without confirmation (fire and forget)
+     */
+    async publishWithoutConfirm(routingKey, content, publishOptions) {
+        if (!this.channel) {
+            throw new Error('Channel not available for publishing');
+        }
+        const published = this.channel.publish(this.exchange, routingKey, content, publishOptions);
+        if (!published) {
+            await new Promise((resolve) => {
+                this.channel?.once('drain', resolve);
+            });
+        }
+    }
+    /**
+     * Internal publish implementation
+     */
+    async doPublish(routingKey, message, options) {
+        if (!this.isInitialized) {
+            await this.initialize();
+        }
+        if (!this.channel) {
+            throw new Error('Publisher not initialized');
+        }
+        const content = Buffer.from(JSON.stringify(message));
+        const publishOptions = this.buildPublishOptions(options);
+        if (this.confirm) {
+            await this.publishWithConfirm(routingKey, content, publishOptions);
+        }
+        else {
+            await this.publishWithoutConfirm(routingKey, content, publishOptions);
+        }
+        this.logger.debug({
+            exchange: this.exchange,
+            routingKey,
+            messageId: options.messageId,
+            correlationId: options.correlationId,
+            confirms: this.confirm,
+        }, 'Message published');
+    }
+    /**
+     * Calculate retry delay with exponential backoff
+     */
+    calculateRetryDelay(retryCount) {
+        const delay = Math.min(this.initialRetryDelay * Math.pow(2, retryCount - 1), this.maxRetryDelay);
+        // Add jitter (0-25%)
+        const jitter = delay * Math.random() * 0.25;
+        return Math.floor(delay + jitter);
+    }
+    /**
+     * Sleep for specified milliseconds
+     */
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Get publisher stats
+     */
+    getStats() {
+        return {
+            exchange: this.exchange,
+            isInitialized: this.isInitialized,
+            confirm: this.confirm,
+            circuitBreakerState: this.circuitBreaker?.getState(),
+        };
+    }
+    /**
+     * Reset circuit breaker (useful for testing or manual recovery)
+     */
+    resetCircuitBreaker() {
+        this.circuitBreaker?.reset();
+    }
+}
+//# sourceMappingURL=BasePublisher.js.map

package/dist/publisher/BasePublisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePublisher.js","sourceRoot":"","sources":["../../src/publisher/BasePublisher.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAGxF,kCAAkC;AAClC,MAAM,QAAQ,GAAG;IACf,WAAW,EAAE,CAAC;IACd,mBAAmB,EAAE,GAAG;IACxB,eAAe,EAAE,IAAI;IACrB,yBAAyB,EAAE,CAAC;CAC7B,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,aAAa;IAeH;IAdb,OAAO,GAAoC,IAAI,CAAC;IAChD,aAAa,GAAG,KAAK,CAAC;IACtB,cAAc,GAA0B,IAAI,CAAC;IAClC,MAAM,CAAa;IAErB,QAAQ,CAAS;IACjB,YAAY,CAA4C;IACxD,OAAO,CAAU;IACjB,UAAU,CAAS;IACnB,iBAAiB,CAAS;IAC1B,aAAa,CAAS;IACtB,iBAAiB,CAAU;IAE5C,YACqB,UAA6B,EAChD,OAAyB;QADN,eAAU,GAAV,UAAU,CAAmB;QAGhD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC,WAAW,CAAC;QAC7D,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,QAAQ,CAAC,mBAAmB,CAAC;QACnF,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,QAAQ,CAAC,eAAe,CAAC;QACvE,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC;QAC3D,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC,SAAS,EAAE,CAAC;QAEvD,wCAAwC;QACxC,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,IAAI,CAAC,cAAc,GAAG,IAAI,cAAc,CAAC;gBACvC,IAAI,EAAE,aAAa,IAAI,CAAC,QAAQ,EAAE;gBAClC,gBAAgB,EAAE,OAAO,CAAC,uBAAuB,IAAI,QAAQ,CAAC,yBAAyB;gBACvF,YAAY,EAAE,KAAK;gBACnB,gBAAgB,EAAE,CAAC;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO;QAE/B,IAAI,CAAC;YACH,+BAA+B;YAC/B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YACpD,CAAC;YAED,sBAAsB;YACtB,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAEvF,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;YAC1B,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,EAC5E,uBAAuB,CACxB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,gCAAgC,CAAC,CAAC;YAC7F,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,UAAkB,EAClB,OAAe,EACf,OAAuF;QAEvF,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACxF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAC9B,UAAkB,EAClB,SAAiB,EACjB,OAAe,EACf,SAAgB;QAEhB,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU;YAAE,OAAO,KAAK,CAAC;QAE5C,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;YACE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU;YACV,SAAS;YACT,KAAK,EAAE,OAAO;YACd,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,SAAS,CAAC,OAAO;SACzB,EACD,gCAAgC,CACjC,CAAC;QACF,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACK,iBAAiB,CACvB,UAAkB,EAClB,SAAiB,EACjB,OAAe,EACf,KAAa;QAEb,IAAI,CAAC,MAAM,CAAC,KAAK,CACf;YACE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU;YACV,SAAS;YACT,OAAO;YACP,KAAK,EAAE,KAAK,EAAE,OAAO;SACtB,EACD,6CAA6C,CAC9C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,yBAAyB,CAC/B,KAA8B,EAC9B,UAAkB,EAClB,SAAiB;QAEjB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd;YACE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU;YACV,SAAS;YACT,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;SAC7C,EACD,oCAAoC,CACrC,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,UAAkB,EAClB,OAAe,EACf,UAA0B,EAAE;QAE5B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,EAAE,CAAC;QACpD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,UAAU,EAAE,CAAC;QAC5D,MAAM,cAAc,GAAG,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;QAChE,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,SAA4B,CAAC;QAEjC,OAAO,OAAO,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;gBACtE,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,EAC3D,+BAA+B,CAChC,CAAC;gBACJ,CAAC;gBACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;YAC9D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtE,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;oBAC7C,IAAI,CAAC,yBAAyB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;gBAC/D,CAAC;gBACD,OAAO,EAAE,CAAC;gBACV,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;oBAChF,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAClE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACjF,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,UAAkB,EAClB,OAAe,EACf,UAA0B,EAAE;QAE5B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,mBAAmB,CACzB,OAAuF;QAYvF,OAAO;YACL,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,IAAI;YACtC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,kBAAkB;YACtD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE;gBACP,GAAG,OAAO,CAAC,OAAO;gBAClB,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBAC1C,aAAa,EAAE,IAAI,CAAC,QAAQ;aAC7B;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAC9B,UAAkB,EAClB,OAAe,EACf,cAAsB;QAEtB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,IAAI,CAAC,OAA0B,CAAC,OAAO,CACtC,IAAI,CAAC,QAAQ,EACb,UAAU,EACV,OAAO,EACP,cAAc,EACd,CAAC,GAAG,EAAE,EAAE;gBACN,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC9D,CAAC;qBAAM,CAAC;oBACN,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,UAAkB,EAClB,OAAe,EACf,cAAsB;QAEtB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QAC3F,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,SAAS,CACrB,UAAkB,EAClB,OAAe,EACf,OAAuF;QAEvF,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACrD,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAEzD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,kBAAkB,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACf;YACE,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU;YACV,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,QAAQ,EAAE,IAAI,CAAC,OAAO;SACvB,EACD,mBAAmB,CACpB,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,mBAAmB,CAAC,UAAkB;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,EACpD,IAAI,CAAC,aAAa,CACnB,CAAC;QACF,qBAAqB;QACrB,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,QAAQ;QAMN,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,mBAAmB,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE;SACrD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,IAAI,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC;IAC/B,CAAC;CACF"}

package/dist/publisher/index.d.ts

@@ -0,0 +1,2 @@
+export { BasePublisher } from './BasePublisher.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/publisher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/publisher/index.js

@@ -0,0 +1,2 @@
+export { BasePublisher } from './BasePublisher.js';
+//# sourceMappingURL=index.js.map

package/dist/publisher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/publisher/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Core types for amqp-resilient
+ */
+/**
+ * Logger interface - inject your own logger implementation
+ * Compatible with pino, winston, bunyan, console, etc.
+ */
+export interface AmqpLogger {
+    info(obj: object, msg?: string): void;
+    warn(obj: object, msg?: string): void;
+    error(obj: object, msg?: string): void;
+    debug(obj: object, msg?: string): void;
+}
+/**
+ * Connection options
+ */
+export interface ConnectionOptions {
+    /** Full AMQP URL (alternative to individual params) */
+    url?: string;
+    /** RabbitMQ host */
+    host?: string;
+    /** RabbitMQ port (default: 5672) */
+    port?: number;
+    /** RabbitMQ username */
+    username?: string;
+    /** RabbitMQ password */
+    password?: string;
+    /** RabbitMQ virtual host (default: /) */
+    vhost?: string;
+    /** Connection name for identification (default: default) */
+    connectionName?: string;
+    /** Prefetch count for channels (default: 10) */
+    prefetch?: number;
+    /** Connection heartbeat in seconds (default: 60) */
+    heartbeat?: number;
+    /** Maximum reconnection attempts (0 = unlimited, default: 0) */
+    maxReconnectAttempts?: number;
+    /** Initial reconnection delay in ms (default: 1000) */
+    initialReconnectDelay?: number;
+    /** Maximum reconnection delay in ms (default: 60000) */
+    maxReconnectDelay?: number;
+    /** Logger instance (optional) */
+    logger?: AmqpLogger;
+}
+/**
+ * Connection status
+ */
+export declare enum ConnectionStatus {
+    DISCONNECTED = "disconnected",
+    CONNECTING = "connecting",
+    CONNECTED = "connected",
+    RECONNECTING = "reconnecting",
+    DEAD = "dead"
+}
+/**
+ * Consumer options
+ */
+export interface ConsumerOptions {
+    /** Queue name to consume from */
+    queue: string;
+    /** Exchange to bind to */
+    exchange: string;
+    /** Routing keys for binding */
+    routingKeys: string[];
+    /** Prefetch count (default: 10) */
+    prefetch?: number;
+    /** Maximum number of retries (default: 3) */
+    maxRetries?: number;
+    /** Initial retry delay in ms (default: 1000) */
+    initialRetryDelay?: number;
+    /** Maximum retry delay in ms (default: 30000) */
+    maxRetryDelay?: number;
+    /** Whether to use circuit breaker (default: true) */
+    useCircuitBreaker?: boolean;
+    /** Circuit breaker failure threshold (default: 5) */
+    circuitBreakerThreshold?: number;
+    /** Exchange type (default: topic) */
+    exchangeType?: 'direct' | 'topic' | 'fanout' | 'headers';
+    /** Logger instance (optional, inherits from connection if not provided) */
+    logger?: AmqpLogger;
+}
+/**
+ * Message context passed to consumer handler
+ */
+export interface MessageContext {
+    /** Routing key */
+    routingKey: string;
+    /** Message ID */
+    messageId: string;
+    /** Correlation ID for tracing */
+    correlationId?: string;
+    /** Current retry count */
+    retryCount: number;
+    /** Timestamp when message was received */
+    receivedAt: Date;
+    /** Raw message headers */
+    headers: Record<string, unknown>;
+}
+/**
+ * Publisher options
+ */
+export interface PublisherOptions {
+    /** Exchange name to publish to */
+    exchange: string;
+    /** Exchange type (default: topic) */
+    exchangeType?: 'direct' | 'topic' | 'fanout' | 'headers';
+    /** Whether to use publisher confirms (default: true) */
+    confirm?: boolean;
+    /** Maximum number of publish retries (default: 3) */
+    maxRetries?: number;
+    /** Initial retry delay in ms (default: 100) */
+    initialRetryDelay?: number;
+    /** Maximum retry delay in ms (default: 5000) */
+    maxRetryDelay?: number;
+    /** Whether to use circuit breaker (default: true) */
+    useCircuitBreaker?: boolean;
+    /** Circuit breaker failure threshold (default: 5) */
+    circuitBreakerThreshold?: number;
+    /** Logger instance (optional, inherits from connection if not provided) */
+    logger?: AmqpLogger;
+}
+/**
+ * Publish options for individual messages
+ */
+export interface PublishOptions {
+    /** Correlation ID for message tracing */
+    correlationId?: string;
+    /** Message ID (auto-generated if not provided) */
+    messageId?: string;
+    /** Message priority (0-9, higher = more important) */
+    priority?: number;
+    /** Message expiration in milliseconds */
+    expiration?: string;
+    /** Custom headers */
+    headers?: Record<string, unknown>;
+    /** Whether message should be persistent (default: true) */
+    persistent?: boolean;
+    /** Reply-to queue for RPC patterns */
+    replyTo?: string;
+    /** Content type (default: application/json) */
+    contentType?: string;
+}
+/**
+ * Publish result
+ */
+export interface PublishResult {
+    /** Whether the publish was successful */
+    success: boolean;
+    /** Message ID */
+    messageId: string;
+    /** Correlation ID */
+    correlationId: string;
+    /** Number of retries needed */
+    retries: number;
+    /** Error if publish failed */
+    error?: Error;
+}
+/**
+ * Circuit breaker options
+ */
+export interface CircuitBreakerOptions {
+    /** Name for logging purposes */
+    name: string;
+    /** Number of failures before opening circuit (default: 5) */
+    failureThreshold?: number;
+    /** Time in ms to wait before attempting recovery (default: 30000) */
+    resetTimeout?: number;
+    /** Number of successful calls in half-open state before closing (default: 3) */
+    successThreshold?: number;
+    /** Time window in ms to count failures (default: 60000) */
+    failureWindow?: number;
+    /** Logger instance (optional) */
+    logger?: AmqpLogger;
+}
+/**
+ * Circuit breaker state
+ */
+export declare enum CircuitState {
+    CLOSED = "CLOSED",
+    OPEN = "OPEN",
+    HALF_OPEN = "HALF_OPEN"
+}
+export declare const noopLogger: AmqpLogger;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,35 @@
+/**
+ * Core types for amqp-resilient
+ */
+/**
+ * Connection status
+ */
+export var ConnectionStatus;
+(function (ConnectionStatus) {
+    ConnectionStatus["DISCONNECTED"] = "disconnected";
+    ConnectionStatus["CONNECTING"] = "connecting";
+    ConnectionStatus["CONNECTED"] = "connected";
+    ConnectionStatus["RECONNECTING"] = "reconnecting";
+    ConnectionStatus["DEAD"] = "dead";
+})(ConnectionStatus || (ConnectionStatus = {}));
+/**
+ * Circuit breaker state
+ */
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (CircuitState = {}));
+/**
+ * No-op logger for when no logger is provided
+ */
+// eslint-disable-next-line @typescript-eslint/no-empty-function
+const noop = () => { };
+export const noopLogger = {
+    info: noop,
+    warn: noop,
+    error: noop,
+    debug: noop,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AA6CH;;GAEG;AACH,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,iDAA6B,CAAA;IAC7B,6CAAyB,CAAA;IACzB,2CAAuB,CAAA;IACvB,iDAA6B,CAAA;IAC7B,iCAAa,CAAA;AACf,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B;AAgID;;GAEG;AACH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,uCAAuB,CAAA;AACzB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAED;;GAEG;AACH,gEAAgE;AAChE,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AACtB,MAAM,CAAC,MAAM,UAAU,GAAe;IACpC,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,KAAK,EAAE,IAAI;CACZ,CAAC"}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "amqp-resilient",
+  "version": "1.0.0",
+  "description": "Production-ready AMQP client with retry, reconnection, and resilience patterns for Node.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "test": "vitest run --exclude tests/integration.test.ts",
+    "test:unit": "vitest run --exclude tests/integration.test.ts",
+    "test:integration": "vitest run tests/integration.test.ts",
+    "test:all": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "prepare": "husky",
+    "prepublishOnly": "npm run lint && npm run typecheck && npm run test && npm run build"
+  },
+  "keywords": [
+    "amqp",
+    "rabbitmq",
+    "queue",
+    "message-queue",
+    "resilient",
+    "retry",
+    "reconnection",
+    "circuit-breaker",
+    "consumer",
+    "publisher",
+    "microservices",
+    "typescript",
+    "nodejs"
+  ],
+  "author": "berkeerdo",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/berkeerdo/amqp-resilient.git"
+  },
+  "bugs": {
+    "url": "https://github.com/berkeerdo/amqp-resilient/issues"
+  },
+  "homepage": "https://github.com/berkeerdo/amqp-resilient#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "amqplib": ">=0.10.0"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^19.6.1",
+    "@commitlint/config-conventional": "^19.6.0",
+    "@eslint/js": "^9.18.0",
+    "@types/amqplib": "^0.10.5",
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "amqplib": "^0.10.5",
+    "eslint": "^9.18.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.3.0",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.20.0",
+    "vitest": "^2.0.0"
+  }
+}