@zdavison/matador 2.0.2 → 2.0.4

package/dist/pipeline/pipeline.d.ts

@@ -4,7 +4,7 @@ import type { SafeHooks } from '../hooks/index.js';
 import type { RetryDecision, RetryPolicy } from '../retry/index.js';
 import type { SchemaRegistry } from '../schema/index.js';
 import type { MessageReceipt, Transport } from '../transport/index.js';
-import type { Envelope, SubscriberDefinition } from '../types/index.js';
+import type { Dispatcher, Envelope, SubscriberDefinition } from '../types/index.js';
 /**
  * Configuration for the processing pipeline.
  */
@@ -16,6 +16,8 @@ export interface PipelineConfig {
     readonly hooks: SafeHooks;
     /** Optional checkpoint store for resumable subscribers */
     readonly checkpointStore?: CheckpointStore | undefined;
+    /** Dispatcher (matador) for sending events from subscriber callbacks */
+    readonly dispatcher: Dispatcher;
 }
 /**
  * Result of pipeline processing.
@@ -44,6 +46,7 @@ export declare class ProcessingPipeline {
     private readonly retryPolicy;
     private readonly hooks;
     private readonly checkpointStore;
+    private readonly dispatcher;
     constructor(config: PipelineConfig);
     /**
      * Processes a raw message from the transport.

package/dist/pipeline/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAM/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAGxE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;gBAEtC,MAAM,EAAE,cAAc;IASlC;;OAEG;IACG,OAAO,CACX,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;YAgNX,mBAAmB;YAqCnB,gBAAgB;IAkB9B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;CA+BlC"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAM/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAEV,UAAU,EACV,QAAQ,EAER,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAG3B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IACvD,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,MAAM,EAAE,cAAc;IAUlC;;OAEG;IACG,OAAO,CACX,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;YA4NX,mBAAmB;YAqCnB,gBAAgB;IAkB9B;;;OAGG;IACH,OAAO,CAAC,yBAAyB;CA+BlC"}

package/dist/pipeline/pipeline.js

@@ -18,6 +18,7 @@ export class ProcessingPipeline {
     retryPolicy;
     hooks;
     checkpointStore;
+    dispatcher;
     constructor(config) {
         this.transport = config.transport;
         this.schema = config.schema;
@@ -25,6 +26,7 @@ export class ProcessingPipeline {
         this.retryPolicy = config.retryPolicy;
         this.hooks = config.hooks;
         this.checkpointStore = config.checkpointStore ?? new NoOpCheckpointStore();
+        this.dispatcher = config.dispatcher;
     }
     /**
      * Processes a raw message from the transport.
@@ -113,19 +115,29 @@ export class ProcessingPipeline {
                 },
             });
         }
+        // Create base callback context with matador dispatcher
+        const callbackContext = { matador: this.dispatcher };
         await this.hooks.onWorkerWrap(envelope, subscriberDef, async () => {
             await this.hooks.onWorkerBeforeProcess(envelope, subscriberDef);
             try {
                 if (isResumable && context) {
-                    // Resumable subscriber: pass context as second argument
+                    // Resumable subscriber: pass combined context (checkpoint + matador)
                     // Cast needed because TypeScript can't narrow the union type based on isResumable
                     const resumableCallback = subscriber.callback;
-                    result = await resumableCallback(envelope, context);
+                    // Create combined context by binding class methods and adding matador
+                    const fullContext = {
+                        io: context.io.bind(context),
+                        all: context.all.bind(context),
+                        attempt: context.attempt,
+                        isRetry: context.isRetry,
+                        matador: this.dispatcher,
+                    };
+                    result = await resumableCallback(envelope, fullContext);
                 }
                 else {
-                    // Standard subscriber: just pass envelope
+                    // Standard subscriber: pass envelope and callback context
                     const standardCallback = subscriber.callback;
-                    result = await standardCallback(envelope);
+                    result = await standardCallback(envelope, callbackContext);
                 }
             }
             catch (e) {

package/dist/pipeline/pipeline.test.js

@@ -255,7 +255,11 @@ describe('ProcessingPipeline', () => {
             const receipt = createReceipt();
             const result = await pipeline.process(new Uint8Array(), receipt);
             expect(result.success).toBe(true);
-            expect(callbackMock).toHaveBeenCalledWith(envelope);
+            expect(callbackMock).toHaveBeenCalledTimes(1);
+            // Callback receives envelope as first argument and context (with matador) as second
+            const calls = callbackMock.mock.calls;
+            expect(calls[0][0]).toEqual(envelope);
+            expect(calls[0][1]).toHaveProperty('matador');
         });
         it('should handle callback throwing error', async () => {
             const envelope = createTestEnvelope();
@@ -1027,12 +1031,22 @@ function createMockConfig(overrides = {}) {
         onDecodeError: async () => { },
         ...overrides.hooks,
     };
+    const defaultDispatcher = {
+        send: mock(async () => ({
+            eventKey: 'test.event',
+            subscribersSent: 0,
+            subscribersSkipped: 0,
+            errors: [],
+        })),
+        ...overrides.dispatcher,
+    };
     return {
         transport: defaultTransport,
         schema: { ...defaultSchema, ...overrides.schema },
         codec: defaultCodec,
         retryPolicy: defaultRetryPolicy,
         hooks: defaultHooks,
+        dispatcher: defaultDispatcher,
     };
 }
 function createTestEnvelope() {

package/dist/topology/builder.d.ts

@@ -31,10 +31,24 @@ export declare class TopologyBuilder {
     withNamespace(namespace: string): this;
     /**
      * Adds a queue to the topology.
+     * @param definition - A complete QueueDefinition object
+     */
+    addQueue(definition: QueueDefinition): this;
+    /**
+     * Adds a queue to the topology.
+     * @param name - Queue name
+     * @param options - Queue options
      */
     addQueue(name: string, options?: QueueOptions): this;
     /**
      * Alias for addQueue().
+     * @param definition - A complete QueueDefinition object
+     */
+    queue(definition: QueueDefinition): this;
+    /**
+     * Alias for addQueue().
+     * @param name - Queue name
+     * @param options - Queue options
      */
     queue(name: string, options?: QueueOptions): this;
     /**

package/dist/topology/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/topology/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;AAEzD;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAM,YAAW,cAAc;aASxD,MAAM,EAAE,SAAS,MAAM,EAAE;IAR3C,QAAQ,CAAC,WAAW,SAIuC;gBAGzD,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,SAAS,MAAM,EAAE;CAK5C;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,eAAe;IAIhC,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAGhB;IACF,OAAO,CAAC,KAAK,CAIX;IAEF;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAKxD;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAIrD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAQvD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAS7C;;OAEG;IACH,YAAY,IAAI,IAAI;IAKpB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAQzB;;OAEG;IACH,QAAQ,IAAI,SAAS,MAAM,EAAE;IAsD7B;;;OAGG;IACH,KAAK,IAAI,QAAQ;CAgBlB"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/topology/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;AAWzD;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAM,YAAW,cAAc;aASxD,MAAM,EAAE,SAAS,MAAM,EAAE;IAR3C,QAAQ,CAAC,WAAW,SAIuC;gBAGzD,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,SAAS,MAAM,EAAE;CAK5C;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,eAAe;IAIhC,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,UAAU,CAGhB;IACF,OAAO,CAAC,KAAK,CAIX;IAEF;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAC3C;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAapD;;;OAGG;IACH,KAAK,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IACxC;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAWjD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAQvD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IAS7C;;OAEG;IACH,YAAY,IAAI,IAAI;IAKpB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAQzB;;OAEG;IACH,QAAQ,IAAI,SAAS,MAAM,EAAE;IAuD7B;;;OAGG;IACH,KAAK,IAAI,QAAQ;CAgBlB"}

package/dist/topology/builder.js

@@ -1,3 +1,9 @@
+/**
+ * Type guard to check if the argument is a QueueDefinition object.
+ */
+function isQueueDefinition(arg) {
+    return typeof arg === 'object' && arg !== null && 'name' in arg;
+}
 /**
  * Error thrown when topology validation fails.
  */
@@ -41,18 +47,20 @@ export class TopologyBuilder {
         this.namespace = namespace;
         return this;
     }
-    /**
-     * Adds a queue to the topology.
-     */
-    addQueue(name, options = {}) {
-        this.queues.push({ name, ...options });
+    addQueue(nameOrDefinition, options = {}) {
+        if (isQueueDefinition(nameOrDefinition)) {
+            this.queues.push(nameOrDefinition);
+        }
+        else {
+            this.queues.push({ name: nameOrDefinition, ...options });
+        }
         return this;
     }
-    /**
-     * Alias for addQueue().
-     */
-    queue(name, options = {}) {
-        return this.addQueue(name, options);
+    queue(nameOrDefinition, options = {}) {
+        if (isQueueDefinition(nameOrDefinition)) {
+            return this.addQueue(nameOrDefinition);
+        }
+        return this.addQueue(nameOrDefinition, options);
     }
     /**
      * Configures dead-letter queue settings.
@@ -111,7 +119,8 @@ export class TopologyBuilder {
             if (!queue.name || queue.name.trim() === '') {
                 issues.push('Queue name cannot be empty');
             }
-            else if (!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(queue.name)) {
+            else if (!queue.exact && !/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(queue.name)) {
+                // Skip pattern validation for exact queues (allows names like 'matador.shared.id-platform')
                 issues.push(`Queue name "${queue.name}" must start with a letter and contain only alphanumeric characters, underscores, and hyphens`);
             }
             else if (queueNames.has(queue.name)) {

package/dist/topology/builder.test.js

@@ -1,5 +1,6 @@
 import { describe, expect, it } from 'bun:test';
 import { TopologyBuilder, TopologyValidationError } from './builder.js';
+import { resolveQueueName } from './types.js';
 describe('TopologyBuilder', () => {
     describe('withNamespace', () => {
         it('should set the namespace', () => {
@@ -218,5 +219,142 @@ describe('TopologyBuilder', () => {
                 .build();
             expect(topology.queues[0]?.exact).toBe(true);
         });
+        it('should allow dots in queue name when exact: true', () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('matador.shared.id-platform', { exact: true })
+                .build();
+            expect(topology.queues[0]?.name).toBe('matador.shared.id-platform');
+            expect(topology.queues[0]?.exact).toBe(true);
+        });
+        it('should reject dots in queue name when exact: false', () => {
+            const builder = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('invalid.queue.name');
+            expect(() => builder.build()).toThrow('must start with a letter');
+        });
+        it('should allow transport-specific RabbitMQ options with exact queue', () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('matador.shared.id-platform', {
+                exact: true,
+                transport: {
+                    rabbitmq: {
+                        options: {
+                            durable: true,
+                            deadLetterExchange: 'matador.shared.dlx-undeliverable',
+                            arguments: {
+                                'x-queue-type': 'quorum',
+                            },
+                        },
+                    },
+                },
+            })
+                .build();
+            expect(topology.queues[0]?.name).toBe('matador.shared.id-platform');
+            expect(topology.queues[0]?.exact).toBe(true);
+            expect(topology.queues[0]?.transport?.rabbitmq?.options?.durable).toBe(true);
+            expect(topology.queues[0]?.transport?.rabbitmq?.options?.deadLetterExchange).toBe('matador.shared.dlx-undeliverable');
+            expect(topology.queues[0]?.transport?.rabbitmq?.options?.arguments?.['x-queue-type']).toBe('quorum');
+        });
+    });
+    describe('addQueue with QueueDefinition object', () => {
+        it('should accept a QueueDefinition object', () => {
+            const queueDef = {
+                name: 'events',
+                concurrency: 5,
+                consumerTimeout: 30000,
+            };
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue(queueDef)
+                .build();
+            expect(topology.queues).toHaveLength(1);
+            expect(topology.queues[0]?.name).toBe('events');
+            expect(topology.queues[0]?.concurrency).toBe(5);
+            expect(topology.queues[0]?.consumerTimeout).toBe(30000);
+        });
+        it('should allow reusing queue definitions across builders', () => {
+            const sharedQueue = {
+                name: 'shared-queue',
+                concurrency: 10,
+                exact: true,
+            };
+            const topology1 = TopologyBuilder.create()
+                .withNamespace('app1')
+                .addQueue(sharedQueue)
+                .build();
+            const topology2 = TopologyBuilder.create()
+                .withNamespace('app2')
+                .addQueue(sharedQueue)
+                .build();
+            expect(topology1.queues[0]).toEqual(sharedQueue);
+            expect(topology2.queues[0]).toEqual(sharedQueue);
+        });
+        it('should work with queue() alias', () => {
+            const queueDef = {
+                name: 'analytics',
+                priorities: true,
+            };
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .queue(queueDef)
+                .build();
+            expect(topology.queues[0]?.name).toBe('analytics');
+            expect(topology.queues[0]?.priorities).toBe(true);
+        });
+        it('should mix QueueDefinition objects with name+options style', () => {
+            const reusableQueue = {
+                name: 'shared',
+                concurrency: 3,
+            };
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue(reusableQueue)
+                .addQueue('local', { concurrency: 1 })
+                .build();
+            expect(topology.queues).toHaveLength(2);
+            expect(topology.queues[0]?.name).toBe('shared');
+            expect(topology.queues[1]?.name).toBe('local');
+        });
+        it('should validate QueueDefinition objects the same way', () => {
+            const invalidQueue = {
+                name: '123invalid',
+                concurrency: 5,
+            };
+            const builder = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue(invalidQueue);
+            expect(() => builder.build()).toThrow('must start with a letter');
+        });
+    });
+});
+describe('resolveQueueName', () => {
+    it('should return namespace.name for regular queues', () => {
+        const queueDef = { name: 'events' };
+        expect(resolveQueueName('myapp', queueDef)).toBe('myapp.events');
+    });
+    it('should return name as-is when exact: true', () => {
+        const queueDef = { name: 'matador.shared.id-platform', exact: true };
+        expect(resolveQueueName('myapp', queueDef)).toBe('matador.shared.id-platform');
+    });
+    it('should return namespace.name when exact: false', () => {
+        const queueDef = { name: 'events', exact: false };
+        expect(resolveQueueName('myapp', queueDef)).toBe('myapp.events');
+    });
+    it('should work with full QueueDefinition including transport options', () => {
+        const queueDef = {
+            name: 'matador.shared.id-platform',
+            exact: true,
+            transport: {
+                rabbitmq: {
+                    options: {
+                        durable: true,
+                        deadLetterExchange: 'matador.shared.dlx-undeliverable',
+                    },
+                },
+            },
+        };
+        expect(resolveQueueName('myapp', queueDef)).toBe('matador.shared.id-platform');
     });
 });

package/dist/topology/index.d.ts

@@ -1,5 +1,5 @@
-export type { DeadLetterConfig, DeadLetterQueueConfig, QueueDefinition, RetryConfig, Topology, } from './types.js';
-export { getDeadLetterQueueName, getQualifiedQueueName, getRetryQueueName, } from './types.js';
+export type { DeadLetterConfig, DeadLetterQueueConfig, QueueDefinition, RabbitMQQueueDefinition, RabbitMQQueueOptions, RetryConfig, Topology, TransportQueueOptions, } from './types.js';
+export { getDeadLetterQueueName, getQualifiedQueueName, getRetryQueueName, resolveQueueName, } from './types.js';
 export type { QueueOptions } from './builder.js';
 export { TopologyBuilder, TopologyValidationError } from './builder.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/topology/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,QAAQ,GACT,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/topology/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,uBAAuB,EACvB,oBAAoB,EACpB,WAAW,EACX,QAAQ,EACR,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/topology/index.js

@@ -1,2 +1,2 @@
-export { getDeadLetterQueueName, getQualifiedQueueName, getRetryQueueName, } from './types.js';
+export { getDeadLetterQueueName, getQualifiedQueueName, getRetryQueueName, resolveQueueName, } from './types.js';
 export { TopologyBuilder, TopologyValidationError } from './builder.js';

package/dist/topology/types.d.ts

@@ -16,7 +16,7 @@ export interface Topology {
  * Individual queue definition.
  */
 export interface QueueDefinition {
-    /** Queue name (will be prefixed with namespace) */
+    /** Queue name (will be prefixed with namespace unless exact: true) */
     readonly name: string;
     /** Concurrency for this queue */
     readonly concurrency?: number | undefined;
@@ -31,6 +31,53 @@ export interface QueueDefinition {
      * queues that are not managed by Matador.
      */
     readonly exact?: boolean | undefined;
+    /** Transport-specific queue options */
+    readonly transport?: TransportQueueOptions | undefined;
+}
+/**
+ * Transport-specific queue options.
+ * Each transport can define its own options under its transport name key.
+ */
+export interface TransportQueueOptions {
+    /** RabbitMQ-specific queue options */
+    readonly rabbitmq?: RabbitMQQueueDefinition | undefined;
+}
+/**
+ * RabbitMQ-specific queue definition options.
+ */
+export interface RabbitMQQueueDefinition {
+    /**
+     * Exact RabbitMQ queue assertion options.
+     * When provided, these options completely replace all auto-computed defaults
+     * (durable, x-queue-type, x-dead-letter-exchange, etc.).
+     */
+    readonly options?: RabbitMQQueueOptions | undefined;
+}
+/**
+ * RabbitMQ queue assertion options.
+ * Maps to amqplib's Options.AssertQueue.
+ */
+export interface RabbitMQQueueOptions {
+    /** Queue survives broker restart */
+    readonly durable?: boolean | undefined;
+    /** Queue is deleted when last consumer unsubscribes */
+    readonly autoDelete?: boolean | undefined;
+    /** Queue can only be used by the declaring connection */
+    readonly exclusive?: boolean | undefined;
+    /** Exchange to which dead-lettered messages are sent */
+    readonly deadLetterExchange?: string | undefined;
+    /** Routing key for dead-lettered messages */
+    readonly deadLetterRoutingKey?: string | undefined;
+    /** Message TTL in milliseconds */
+    readonly messageTtl?: number | undefined;
+    /** Queue expires after this many milliseconds of non-use */
+    readonly expires?: number | undefined;
+    /** Maximum number of messages in the queue */
+    readonly maxLength?: number | undefined;
+    /** Maximum priority level (0-255) */
+    readonly maxPriority?: number | undefined;
+    /** Additional x-* arguments for RabbitMQ */
+    readonly arguments?: Record<string, unknown> | undefined;
 }
 /**
  * Dead-letter queue configuration.
@@ -73,4 +120,9 @@ export declare function getDeadLetterQueueName(namespace: string, queueName: str
  * Gets the retry queue name for a given queue.
  */
 export declare function getRetryQueueName(namespace: string, queueName: string): string;
+/**
+ * Resolves the actual queue name for a given queue definition.
+ * When exact: true, returns name as-is. Otherwise, returns namespace.name.
+ */
+export declare function resolveQueueName(namespace: string, queueDef: QueueDefinition): string;
 //# sourceMappingURL=types.d.ts.map

package/dist/topology/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/topology/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;IAE5C,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAEtC,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,iCAAiC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1C,uCAAuC;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9C,kDAAkD;IAClD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE1C;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAE1C,sDAAsD;IACtD,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,0CAA0C;IAC1C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,GAAG,eAAe,GACrC,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/topology/types.ts"],"names":[],"mappings":"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"}

package/dist/topology/types.js

@@ -16,3 +16,13 @@ export function getDeadLetterQueueName(namespace, queueName, dlqType) {
 export function getRetryQueueName(namespace, queueName) {
     return `${namespace}.${queueName}.retry`;
 }
+/**
+ * Resolves the actual queue name for a given queue definition.
+ * When exact: true, returns name as-is. Otherwise, returns namespace.name.
+ */
+export function resolveQueueName(namespace, queueDef) {
+    if (queueDef.exact) {
+        return queueDef.name;
+    }
+    return `${namespace}.${queueDef.name}`;
+}

package/dist/transport/local/local-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/local/local-transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACV,MAAM,iBAAiB,CAAC;AAiCzB;;;GAGG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,YAAY,wBAAqB;IAE1C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2C;IACzE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAwB;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;IAC1E,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,CAAC,EAAE,MAAM;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBjC,WAAW,IAAI,OAAO;IAIhB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhD,IAAI,CACR,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAe7B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;YAkBhB,OAAO;YAgBP,oBAAoB;IA4B5B,SAAS,CACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,YAAY,CAAC;IAsClB,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,gBAAgB,CACpB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMnC;;OAEG;IACH,YAAY,IAAI,SAAS,cAAc,EAAE;IAIzC;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE;IAMtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;;OAGG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAmBlE,OAAO,CAAC,gBAAgB;CAQzB"}
+{"version":3,"file":"local-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/local/local-transport.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACV,MAAM,iBAAiB,CAAC;AAiCzB;;;GAGG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,YAAY,wBAAqB;IAE1C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2C;IACzE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAwB;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4C;IAC1E,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,MAAM,CAAC,EAAE,MAAM;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBjC,WAAW,IAAI,OAAO;IAIhB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhD,IAAI,CACR,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAe7B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;YAkBhB,OAAO;YAgBP,oBAAoB;IA+B5B,SAAS,CACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,YAAY,CAAC;IAsClB,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD,gBAAgB,CACpB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAQhB;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAMnC;;OAEG;IACH,YAAY,IAAI,SAAS,cAAc,EAAE;IAIzC;;OAEG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE;IAMtD;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;;OAGG;IACG,UAAU,CACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,GAAG,IAAI,CAAC;IAmBlE,OAAO,CAAC,gBAAgB;CAQzB"}

package/dist/transport/rabbitmq/rabbitmq-transport.d.ts

@@ -21,6 +21,14 @@ export interface RabbitMQTransportConfig {
     /** Logger for transport events (defaults to console) */
     readonly logger?: Logger | undefined;
 }
+/**
+ * Redacts credentials from an AMQP URL.
+ * Replaces username and password with '****' regardless of their length.
+ *
+ * @example
+ * redactAmqpUrl('amqp://user:pass@host:5672') // 'amqp://****:****@host:5672'
+ */
+export declare function redactAmqpUrl(url: string): string;
 /**
  * RabbitMQ transport implementation using amqplib.
  */

package/dist/transport/rabbitmq/rabbitmq-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rabbitmq-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/rabbitmq/rabbitmq-transport.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,MAAM,EAAiB,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAmB,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,uCAAuC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,SAAS,CAAC;IAEnE,uDAAuD;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE5C,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9C,8EAA8E;IAC9E,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAErD,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAmBD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IACjD,QAAQ,CAAC,IAAI,cAAc;IAE3B,OAAO,CAAC,aAAa,CAQnB;IAEF,IAAI,YAAY,IAAI,qBAAqB,CAExC;IAED,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,cAAc,CAAwB;IAC9C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmC;IACjE,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAE7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAIrB;IAEF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,wBAAwB,CAAS;gBAE7B,MAAM,EAAE,uBAAuB;IAiBrC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,WAAW,IAAI,OAAO;IAIhB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA0ChD,IAAI,CACR,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IA0DvB,SAAS,CACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,YAAY,CAAC;IAwFlB,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAahD,gBAAgB,CACpB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA6ChB;;;;;OAKG;YACW,uBAAuB;YAqCvB,SAAS;YAgCT,YAAY;YA+CZ,oBAAoB;YAwEpB,eAAe;YAwDf,gBAAgB;YAyBhB,sBAAsB;IA6BpC,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,gBAAgB;IAiBxB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CA0BzB"}
+{"version":3,"file":"rabbitmq-transport.d.ts","sourceRoot":"","sources":["../../../src/transport/rabbitmq/rabbitmq-transport.ts"],"names":[],"mappings":"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"}

package/dist/transport/rabbitmq/rabbitmq-transport.js

@@ -3,6 +3,17 @@ import { RabbitMQCodec } from '../../codec/rabbitmq-codec.js';
 import { DelayedMessagesNotSupportedError, TransportNotConnectedError, } from '../../errors/index.js';
 import { consoleLogger } from '../../hooks/index.js';
 import { ConnectionManager, } from '../connection-manager.js';
+/**
+ * Redacts credentials from an AMQP URL.
+ * Replaces username and password with '****' regardless of their length.
+ *
+ * @example
+ * redactAmqpUrl('amqp://user:pass@host:5672') // 'amqp://****:****@host:5672'
+ */
+export function redactAmqpUrl(url) {
+    const regex = /^(amqps?:\/\/)[^:]+:[^@]+@/;
+    return url.replace(regex, '$1****:****@');
+}
 /**
  * RabbitMQ transport implementation using amqplib.
  */
@@ -260,6 +271,7 @@ export class RabbitMQTransport {
         return queueChannel;
     }
     async doConnect() {
+        this.logger.info(`[Matador] ⏳ Connecting to RabbitMQ at '${redactAmqpUrl(this.config.url)}'.`);
         const connection = await amqplib.connect(this.config.url);
         this.connection = connection;
         // Handle connection errors - let ConnectionManager handle reconnection
@@ -395,29 +407,37 @@ export class RabbitMQTransport {
         const queueName = queueDef.exact
             ? queueDef.name
             : `${topology.namespace}.${queueDef.name}`;
-        const queueOptions = {
-            durable: true,
-            arguments: {},
-        };
-        // Use quorum queues for durability
-        if (this.config.quorumQueues && !queueDef.exact) {
-            queueOptions.arguments['x-queue-type'] = 'quorum';
-        }
-        // Set up dead-letter exchange routing
-        const dlxExchange = this.getDLXExchangeName(topology.namespace);
-        if (topology.deadLetter.unhandled.enabled ||
-            topology.deadLetter.undeliverable.enabled) {
-            queueOptions.arguments['x-dead-letter-exchange'] = dlxExchange;
-        }
-        // Enable priority if requested
-        if (queueDef.priorities) {
-            queueOptions.arguments['x-max-priority'] = 10;
-        }
-        // Set consumer timeout if specified
-        if (queueDef.consumerTimeout) {
-            queueOptions.arguments['x-consumer-timeout'] = queueDef.consumerTimeout;
+        const rabbitmqOptions = queueDef.transport?.rabbitmq?.options;
+        // If user provided exact RabbitMQ options, use them directly (replaces all defaults)
+        if (rabbitmqOptions) {
+            await channel.assertQueue(queueName, rabbitmqOptions);
+        }
+        else {
+            // Use computed defaults
+            const queueOptions = {
+                durable: true,
+                arguments: {},
+            };
+            // Use quorum queues for durability
+            if (this.config.quorumQueues && !queueDef.exact) {
+                queueOptions.arguments['x-queue-type'] = 'quorum';
+            }
+            // Set up dead-letter exchange routing
+            const dlxExchange = this.getDLXExchangeName(topology.namespace);
+            if (topology.deadLetter.unhandled.enabled ||
+                topology.deadLetter.undeliverable.enabled) {
+                queueOptions.arguments['x-dead-letter-exchange'] = dlxExchange;
+            }
+            // Enable priority if requested
+            if (queueDef.priorities) {
+                queueOptions.arguments['x-max-priority'] = 10;
+            }
+            // Set consumer timeout if specified
+            if (queueDef.consumerTimeout) {
+                queueOptions.arguments['x-consumer-timeout'] = queueDef.consumerTimeout;
+            }
+            await channel.assertQueue(queueName, queueOptions);
         }
-        await channel.assertQueue(queueName, queueOptions);
         // Bind queue to main exchange
         const mainExchange = this.getMainExchangeName(topology.namespace);
         await channel.bindQueue(queueName, mainExchange, queueName);

package/dist/transport/rabbitmq/rabbitmq-transport.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rabbitmq-transport.test.d.ts.map

package/dist/transport/rabbitmq/rabbitmq-transport.test.d.ts.map

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