@zdavison/matador 2.0.2 → 2.0.4

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

@@ -0,0 +1,98 @@
+import { describe, expect, it, mock } from 'bun:test';
+import { RabbitMQTransport, redactAmqpUrl } from './rabbitmq-transport.js';
+describe('redactAmqpUrl', () => {
+    it('should redact username and password with 4 asterisks', () => {
+        const url = 'amqp://myuser:mypassword@localhost:5672';
+        const redacted = redactAmqpUrl(url);
+        expect(redacted).toBe('amqp://****:****@localhost:5672');
+    });
+    it('should redact credentials in amqps URLs', () => {
+        const url = 'amqps://admin:secret123@rabbitmq.example.com:5671';
+        const redacted = redactAmqpUrl(url);
+        expect(redacted).toBe('amqps://****:****@rabbitmq.example.com:5671');
+    });
+    it('should redact long credentials to exactly 4 asterisks', () => {
+        const url = 'amqp://verylongusername:verylongpassword@rabbitmq-cluster.svc.local:5672';
+        const redacted = redactAmqpUrl(url);
+        expect(redacted).toBe('amqp://****:****@rabbitmq-cluster.svc.local:5672');
+    });
+    it('should redact short credentials to exactly 4 asterisks', () => {
+        const url = 'amqp://a:b@host:5672';
+        const redacted = redactAmqpUrl(url);
+        expect(redacted).toBe('amqp://****:****@host:5672');
+    });
+    it('should preserve vhost in URL', () => {
+        const url = 'amqp://user:pass@host:5672/myvhost';
+        const redacted = redactAmqpUrl(url);
+        expect(redacted).toBe('amqp://****:****@host:5672/myvhost');
+    });
+    it('should not modify URL without credentials', () => {
+        const url = 'amqp://localhost:5672';
+        const redacted = redactAmqpUrl(url);
+        expect(redacted).toBe('amqp://localhost:5672');
+    });
+    it('should not modify URL with only username (no password)', () => {
+        const url = 'amqp://guest@localhost:5672';
+        const redacted = redactAmqpUrl(url);
+        expect(redacted).toBe('amqp://guest@localhost:5672');
+    });
+    it('should handle URL-encoded credentials', () => {
+        // URL-encoded @ in password: p%40ssword
+        const url = 'amqp://user:p%40ssword@host:5672';
+        const redacted = redactAmqpUrl(url);
+        expect(redacted).toBe('amqp://****:****@host:5672');
+    });
+});
+describe('RabbitMQTransport', () => {
+    describe('connection logging', () => {
+        it('should log redacted connection URL when connecting', async () => {
+            const mockLogger = {
+                debug: mock(() => { }),
+                info: mock(() => { }),
+                warn: mock(() => { }),
+                error: mock(() => { }),
+            };
+            const transport = new RabbitMQTransport({
+                url: 'amqp://testuser:testpass@localhost:5672',
+                logger: mockLogger,
+                connection: {
+                    maxReconnectAttempts: 1, // Only try once to avoid long retries
+                    initialReconnectDelay: 10,
+                },
+            });
+            // Attempt to connect - it will fail since there's no RabbitMQ server
+            // but the log should still be emitted before the connection attempt
+            try {
+                await transport.connect();
+            }
+            catch {
+                // Expected to fail - no RabbitMQ server running
+            }
+            // Verify the log was called with the redacted URL
+            expect(mockLogger.info).toHaveBeenCalledWith("[Matador] \u23F3 Connecting to RabbitMQ at 'amqp://****:****@localhost:5672'.");
+        });
+        it('should log connection URL as-is when no credentials provided', async () => {
+            const mockLogger = {
+                debug: mock(() => { }),
+                info: mock(() => { }),
+                warn: mock(() => { }),
+                error: mock(() => { }),
+            };
+            const transport = new RabbitMQTransport({
+                url: 'amqp://localhost:5672',
+                logger: mockLogger,
+                connection: {
+                    maxReconnectAttempts: 1,
+                    initialReconnectDelay: 10,
+                },
+            });
+            try {
+                await transport.connect();
+            }
+            catch {
+                // Expected to fail
+            }
+            expect(mockLogger.info).toHaveBeenCalledWith("[Matador] \u23F3 Connecting to RabbitMQ at 'amqp://localhost:5672'.");
+        });
+    });
+});

package/dist/types/dispatcher.d.ts

@@ -0,0 +1,14 @@
+import type { SendResult } from '../core/fanout.js';
+import type { Event, EventClass, EventOptions } from './event.js';
+/**
+ * Interface for dispatching events.
+ * Implemented by Matador to allow subscribers to send events.
+ */
+export interface Dispatcher {
+    /**
+     * Sends an event to all registered subscribers.
+     */
+    send<T>(eventClass: EventClass<T>, data: T, options?: EventOptions): Promise<SendResult>;
+    send<T>(event: Event<T>, options?: EventOptions): Promise<SendResult>;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/types/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,CAAC,CAAC,EACJ,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACvE"}

package/dist/types/dispatcher.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -1,9 +1,10 @@
 export type { DeliveryMode, Idempotency, Importance, ValidationError, ValidationResult, } from './common.js';
 export { invalidResult, validResult } from './common.js';
+export type { Dispatcher } from './dispatcher.js';
 export type { CreateEnvelopeOptions, Docket, Envelope } from './envelope.js';
 export { createEnvelope } from './envelope.js';
 export type { Event, EventClass, EventData, EventKey, EventOptions, EventStatic, JsonPrimitive, JsonRecord, JsonValue, } from './event.js';
 export { MatadorEvent } from './event.js';
-export type { AnySubscriber, BaseSubscriberOptions, CreateResumableSubscriberInput, CreateStandardSubscriberInput, CreateSubscriberInput, EnvelopeOf, ResumableCallback, ResumableSubscriber, ResumableSubscriberOptions, StandardCallback, StandardSubscriber, StandardSubscriberOptions, Subscriber, SubscriberCallback, SubscriberDefinition, SubscriberOptions, SubscriberStub, } from './subscriber.js';
+export type { AnySubscriber, BaseSubscriberOptions, CallbackContext, CreateResumableSubscriberInput, CreateStandardSubscriberInput, CreateSubscriberInput, EnvelopeOf, ResumableCallback, ResumableCallbackContext, ResumableSubscriber, ResumableSubscriberOptions, StandardCallback, StandardSubscriber, StandardSubscriberOptions, Subscriber, SubscriberCallback, SubscriberDefinition, SubscriberOptions, SubscriberStub, } from './subscriber.js';
 export { createSubscriber, createSubscriberStub, isResumableSubscriber, isStandardSubscriber, isSubscriber, isSubscriberStub, } from './subscriber.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD,YAAY,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,YAAY,EACV,KAAK,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,8BAA8B,EAC9B,6BAA6B,EAC7B,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEzD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,YAAY,EAAE,qBAAqB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,YAAY,EACV,KAAK,EACL,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,aAAa,EACb,UAAU,EACV,SAAS,GACV,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EACV,aAAa,EACb,qBAAqB,EACrB,eAAe,EACf,8BAA8B,EAC9B,6BAA6B,EAC7B,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,0BAA0B,EAC1B,gBAAgB,EAChB,kBAAkB,EAClB,yBAAyB,EACzB,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,YAAY,EACZ,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/types/subscriber.d.ts

@@ -1,7 +1,16 @@
 import type { SubscriberContext } from '../checkpoint/index.js';
 import type { Idempotency, Importance } from './common.js';
+import type { Dispatcher } from './dispatcher.js';
 import type { Envelope } from './envelope.js';
 import type { MatadorEvent } from './event.js';
+/**
+ * Context passed to subscriber callbacks.
+ * Provides access to the Matador instance for sending additional events.
+ */
+export interface CallbackContext {
+    /** Matador dispatcher for sending additional events from within a subscriber */
+    readonly matador: Dispatcher;
+}
 /**
  * Helper type to get the envelope type for a subscriber callback.
  * Extracts the data type from a MatadorEvent and wraps it in an Envelope.
@@ -14,14 +23,21 @@ import type { MatadorEvent } from './event.js';
 export type EnvelopeOf<T extends MatadorEvent> = Envelope<T['data']>;
 /**
  * Callback function executed when an event is received (standard subscribers).
- * Receives the full envelope containing id, data, and docket.
+ * Receives the full envelope containing id, data, and docket, plus a context
+ * with access to the matador instance for sending additional events.
+ */
+export type StandardCallback<T = unknown> = (envelope: Envelope<T>, context: CallbackContext) => Promise<void> | void;
+/**
+ * Context for resumable subscriber callbacks.
+ * Combines checkpoint operations (io, all) with matador access.
  */
-export type StandardCallback<T = unknown> = (envelope: Envelope<T>) => Promise<void> | void;
+export type ResumableCallbackContext = SubscriberContext & CallbackContext;
 /**
  * Callback function for resumable subscribers.
- * Receives the envelope and a SubscriberContext with io() for checkpointed operations.
+ * Receives the envelope and a context with io() for checkpointed operations
+ * and matador for sending additional events.
  */
-export type ResumableCallback<T = unknown> = (envelope: Envelope<T>, context: SubscriberContext) => Promise<void> | void;
+export type ResumableCallback<T = unknown> = (envelope: Envelope<T>, context: ResumableCallbackContext) => Promise<void> | void;
 /**
  * Callback function executed when an event is received.
  * @deprecated Use StandardCallback or ResumableCallback instead.

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zdavison/matador",
-  "version": "2.0.2",
+  "version": "2.0.4",
   "description": "A batteries-included event system.",
   "type": "module",
   "main": "./dist/index.cjs",

package/src/core/matador.ts

@@ -18,6 +18,7 @@ import { getQualifiedQueueName } from '../topology/index.js';
 import type { Subscription, Transport } from '../transport/index.js';
 import type {
   AnySubscriber,
+  Dispatcher,
   Event,
   EventClass,
   EventOptions,
@@ -71,7 +72,7 @@ export interface MatadorConfig {
  * - Fanout: Event sending
  * - Shutdown: Graceful termination
  */
-export class Matador {
+export class Matador implements Dispatcher {
   private readonly transport: Transport;
   private readonly topology: Topology;
   private readonly schema;
@@ -114,6 +115,7 @@ export class Matador {
       retryPolicy: this.retryPolicy,
       hooks: this.hooks,
       checkpointStore: config.checkpointStore,
+      dispatcher: this,
     });
 
     // Create fanout engine
@@ -199,12 +201,23 @@ export class Matador {
     }
 
     // Connect transport
+    this.hooks.logger.info(
+      `[Matador] ⏳ Starting backend '${this.transport.name}'...`,
+    );
     await this.transport.connect();
+    this.hooks.logger.info(
+      `[Matador] 🟢 Backend '${this.transport.name}' started.`,
+    );
 
     // Apply topology
     await this.transport.applyTopology(this.topology);
 
     // Subscribe to queues
+    if (this.consumeFrom.length > 0) {
+      this.hooks.logger.info(
+        `[Matador] 🟢 Worker subscribing to '${this.consumeFrom.join(',')}'.`,
+      );
+    }
     for (const queueName of this.consumeFrom) {
       const qualifiedName = getQualifiedQueueName(
         this.topology.namespace,

package/src/index.ts

@@ -19,8 +19,10 @@ export {
 export type {
   AnySubscriber,
   BaseSubscriberOptions,
+  CallbackContext,
   CreateEnvelopeOptions,
   DeliveryMode,
+  Dispatcher,
   Docket,
   Envelope,
   EnvelopeOf,
@@ -33,6 +35,9 @@ export type {
   Idempotency,
   Importance,
   JsonRecord,
+  ResumableCallback,
+  ResumableCallbackContext,
+  StandardCallback,
   Subscriber,
   SubscriberCallback,
   SubscriberDefinition,
@@ -91,13 +96,17 @@ export type {
   DeadLetterQueueConfig,
   QueueDefinition,
   QueueOptions,
+  RabbitMQQueueDefinition,
+  RabbitMQQueueOptions,
   RetryConfig,
   Topology,
+  TransportQueueOptions,
 } from './topology/index.js';
 export {
   getDeadLetterQueueName,
   getQualifiedQueueName,
   getRetryQueueName,
+  resolveQueueName,
   TopologyBuilder,
   TopologyValidationError,
 } from './topology/index.js';

package/src/pipeline/pipeline.test.ts

@@ -10,7 +10,11 @@ import type { RetryDecision, RetryPolicy } from '../retry/index.js';
 import { StandardRetryPolicy } 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';
 import { createEnvelope } from '../types/index.js';
 import type { PipelineConfig } from './pipeline.js';
 import { ProcessingPipeline } from './pipeline.js';
@@ -324,7 +328,13 @@ describe('ProcessingPipeline', () => {
       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 as unknown as [
+        [Envelope, { matador: Dispatcher }],
+      ];
+      expect(calls[0][0]).toEqual(envelope);
+      expect(calls[0][1]).toHaveProperty('matador');
     });
 
     it('should handle callback throwing error', async () => {
@@ -1189,6 +1199,7 @@ function createMockConfig(
     codec: Partial<Codec>;
     retryPolicy: RetryPolicy | Partial<RetryPolicy>;
     hooks: Partial<SafeHooks>;
+    dispatcher: Partial<Dispatcher>;
   }> = {},
 ): PipelineConfig {
   const defaultTransport: Transport = {
@@ -1272,12 +1283,23 @@ function createMockConfig(
     ...overrides.hooks,
   } as SafeHooks;
 
+  const defaultDispatcher: Dispatcher = {
+    send: mock(async () => ({
+      eventKey: 'test.event',
+      subscribersSent: 0,
+      subscribersSkipped: 0,
+      errors: [],
+    })),
+    ...overrides.dispatcher,
+  } as Dispatcher;
+
   return {
     transport: defaultTransport,
     schema: { ...defaultSchema, ...overrides.schema } as SchemaRegistry,
     codec: defaultCodec,
     retryPolicy: defaultRetryPolicy,
     hooks: defaultHooks,
+    dispatcher: defaultDispatcher,
   };
 }
 

package/src/pipeline/pipeline.ts

@@ -10,7 +10,13 @@ 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 {
+  CallbackContext,
+  Dispatcher,
+  Envelope,
+  ResumableCallbackContext,
+  SubscriberDefinition,
+} from '../types/index.js';
 import { isResumableSubscriber } from '../types/index.js';
 
 /**
@@ -24,6 +30,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;
 }
 
 /**
@@ -54,6 +62,7 @@ export class ProcessingPipeline {
   private readonly retryPolicy: RetryPolicy;
   private readonly hooks: SafeHooks;
   private readonly checkpointStore: CheckpointStore;
+  private readonly dispatcher: Dispatcher;
 
   constructor(config: PipelineConfig) {
     this.transport = config.transport;
@@ -62,6 +71,7 @@ export class ProcessingPipeline {
     this.retryPolicy = config.retryPolicy;
     this.hooks = config.hooks;
     this.checkpointStore = config.checkpointStore ?? new NoOpCheckpointStore();
+    this.dispatcher = config.dispatcher;
   }
 
   /**
@@ -180,24 +190,36 @@ export class ProcessingPipeline {
       });
     }
 
+    // Create base callback context with matador dispatcher
+    const callbackContext: 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 as (
             envelope: Envelope,
-            context: ResumableContext,
+            context: ResumableCallbackContext,
           ) => Promise<void> | void;
-          result = await resumableCallback(envelope, context);
+          // Create combined context by binding class methods and adding matador
+          const fullContext: ResumableCallbackContext = {
+            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 as (
             envelope: Envelope,
+            context: CallbackContext,
           ) => Promise<void> | void;
-          result = await standardCallback(envelope);
+          result = await standardCallback(envelope, callbackContext);
         }
       } catch (e) {
         error = e instanceof Error ? e : new Error(String(e));

package/src/topology/builder.test.ts

@@ -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', () => {
@@ -271,5 +272,180 @@ describe('TopologyBuilder', () => {
 
       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',
+    );
   });
 });