@zdavison/matador 4.0.2 → 4.1.0

package/dist/core/matador.js

@@ -66,6 +66,10 @@ export class Matador {
             hooks: this.hooks,
             topology: this.topology,
             defaultQueue,
+            maxRetryBufferSize: config.maxRetryBufferSize,
+            maxRetryAttempts: config.maxRetryAttempts,
+            retryIntervalMs: config.retryIntervalMs,
+            maxConsecutiveFlushFailures: config.maxConsecutiveFlushFailures,
         });
         // Create shutdown manager
         this.shutdownManager = new ShutdownManager(() => this.fanout.eventsBeingEnqueuedCount, () => this.unsubscribeAll(), () => this.transport.disconnect(), config.shutdownConfig);
@@ -137,6 +141,10 @@ export class Matador {
         else {
             this.hooks.logger.info('[Matador] 🟡 Worker not subscribing to any queues (consumeFrom is empty).');
         }
+        // Mark as started
+        // Needed for the subscribe calls below, as we might start getting messages
+        // that could send events before the code here finishes subscribing to all the queues
+        this.started = true;
         for (const queueName of this.consumeFrom) {
             const qualifiedName = resolveTargetQueueName(this.topology, queueName);
             const queueDef = findQueueDefinition(this.topology, queueName);
@@ -154,7 +162,6 @@ export class Matador {
                 : undefined);
             this.subscriptions.push(subscription);
         }
-        this.started = true;
     }
     async send(eventOrClass, dataOrOptions, maybeOptions) {
         if (!this.started) {
@@ -247,7 +254,7 @@ export class Matador {
     }
     async unsubscribeAll() {
         for (const subscription of this.subscriptions) {
-            await subscription.unsubscribe();
+            await (subscription.pauseForShutdown ?? subscription.unsubscribe)();
         }
         this.subscriptions.length = 0;
     }

package/dist/core/matador.test.js

@@ -1,8 +1,8 @@
 import { afterEach, beforeEach, describe, expect, it, mock } from 'bun:test';
 import { SomeSendError, TransportSendError } from '../errors/index.js';
 import { TopologyBuilder } from '../topology/builder.js';
-import { LocalTransport } from '../transport/local/local-transport.js';
-import { MatadorEvent, createSubscriber } from '../types/index.js';
+import { LocalTransport, MultiTransport } from '../transport/index.js';
+import { MatadorEvent, createDummyEnvelope, createSubscriber, } from '../types/index.js';
 import { Matador } from './matador.js';
 class UserCreatedEvent extends MatadorEvent {
     data;
@@ -22,6 +22,24 @@ class OrderPlacedEvent extends MatadorEvent {
         this.data = data;
     }
 }
+class StepOneEvent extends MatadorEvent {
+    data;
+    static key = 'step.one';
+    static description = 'First step of a chain';
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+}
+class StepTwoEvent extends MatadorEvent {
+    data;
+    static key = 'step.two';
+    static description = 'Follow-up step dispatched from within step one';
+    constructor(data) {
+        super();
+        this.data = data;
+    }
+}
 describe('Matador', () => {
     let transport;
     let matador;
@@ -208,7 +226,12 @@ describe('Matador', () => {
             const schema = {
                 [UserCreatedEvent.key]: [UserCreatedEvent, [subscriber]],
             };
-            matador = new Matador({ transport, topology, schema });
+            matador = new Matador({
+                transport,
+                topology,
+                schema,
+                consumeFrom: ['events'],
+            });
             await matador.start();
             const event = new UserCreatedEvent({
                 userId: '123',
@@ -231,7 +254,12 @@ describe('Matador', () => {
             const schema = {
                 [UserCreatedEvent.key]: [UserCreatedEvent, [subscriber]],
             };
-            matador = new Matador({ transport, topology, schema });
+            matador = new Matador({
+                transport,
+                topology,
+                schema,
+                consumeFrom: ['events'],
+            });
             await matador.start();
             // Use the shorthand: send(EventClass, data)
             const result = await matador.send(UserCreatedEvent, {
@@ -264,7 +292,12 @@ describe('Matador', () => {
             const schema = {
                 [UserCreatedEvent.key]: [UserCreatedEvent, [sub1, sub2, sub3]],
             };
-            matador = new Matador({ transport, topology, schema });
+            matador = new Matador({
+                transport,
+                topology,
+                schema,
+                consumeFrom: ['events'],
+            });
             await matador.start();
             const event = new UserCreatedEvent({
                 userId: '123',
@@ -286,7 +319,12 @@ describe('Matador', () => {
             const schema = {
                 [UserCreatedEvent.key]: [UserCreatedEvent, [subscriber]],
             };
-            matador = new Matador({ transport, topology, schema });
+            matador = new Matador({
+                transport,
+                topology,
+                schema,
+                consumeFrom: ['events'],
+            });
             await matador.start();
             const event = new UserCreatedEvent({
                 userId: '123',
@@ -481,8 +519,19 @@ describe('Matador', () => {
             const schema = {
                 [UserCreatedEvent.key]: [UserCreatedEvent, [subscriber]],
             };
-            matador = new Matador({ transport, topology, schema });
+            matador = new Matador({
+                transport,
+                topology,
+                schema,
+                consumeFrom: ['events'],
+            });
             await matador.start();
+            // stopReceiving() unsubscribes this instance's own handler. With a real
+            // broker, the queue would still exist independently (another replica,
+            // or this instance after restart, could pick the message up) — simulate
+            // that here with a subscription outside Matador's own lifecycle so
+            // LocalTransport still has somewhere to deliver to.
+            await transport.subscribe('matador.test.events', async () => { });
             await matador.stopReceiving();
             const event = new UserCreatedEvent({
                 userId: '123',
@@ -574,4 +623,284 @@ describe('Matador', () => {
             expect(matador.isConnected()).toBe(true);
         });
     });
+    describe('start() race between subscribing and marking started', () => {
+        it('should allow send() from a subscriber callback fired while start() is still subscribing later queues', async () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('events')
+                .addQueue('notifications')
+                .build();
+            let sendError;
+            const userSub = createSubscriber({
+                name: 'handle-user',
+                description: 'Handles user events',
+                callback: async (_envelope, context) => {
+                    try {
+                        await context.matador.send(OrderPlacedEvent, {
+                            orderId: 'order-1',
+                            amount: 100,
+                        });
+                    }
+                    catch (err) {
+                        sendError = err;
+                    }
+                },
+            });
+            const orderSub = createSubscriber({
+                name: 'handle-order',
+                description: 'Handles order events',
+                callback: async () => { },
+            });
+            const schema = {
+                [UserCreatedEvent.key]: [UserCreatedEvent, [userSub]],
+                [OrderPlacedEvent.key]: [OrderPlacedEvent, [orderSub]],
+            };
+            // Simulates a broker delivering a message on the first subscribed
+            // queue before subscribe() has resolved for a later queue - the
+            // exact window in which `started` used to still be false.
+            let capturedHandler;
+            let releaseSecondSubscribe;
+            const secondSubscribeGate = new Promise((resolve) => {
+                releaseSecondSubscribe = resolve;
+            });
+            const raceTransport = {
+                name: 'race-transport',
+                capabilities: {
+                    deliveryModes: ['at-least-once'],
+                    delayedMessages: false,
+                    deadLetterRouting: 'native',
+                    attemptTracking: true,
+                    concurrencyModel: 'prefetch',
+                    ordering: 'none',
+                    priorities: false,
+                },
+                isConnected: () => true,
+                connect: mock(async () => { }),
+                disconnect: mock(async () => { }),
+                send: mock(async () => 'race-transport'),
+                subscribe: mock(async (queueName, handler) => {
+                    if (queueName === 'matador.test.notifications') {
+                        await secondSubscribeGate;
+                    }
+                    else {
+                        capturedHandler = handler;
+                    }
+                    return { unsubscribe: mock(async () => { }), isActive: true };
+                }),
+                applyTopology: mock(async () => { }),
+                complete: mock(async () => { }),
+            };
+            matador = new Matador({
+                transport: raceTransport,
+                topology,
+                schema,
+                consumeFrom: ['events', 'notifications'],
+            });
+            const startPromise = matador.start();
+            // Wait for the first queue's subscribe() to resolve and capture its
+            // handler, while the second queue's subscribe() is still pending.
+            while (!capturedHandler) {
+                await new Promise((resolve) => setTimeout(resolve, 0));
+            }
+            const envelope = createDummyEnvelope(new UserCreatedEvent({ userId: '123', email: 'test@example.com' }), { targetSubscriber: 'handle-user' });
+            await capturedHandler?.(envelope, {
+                handle: 'msg-1',
+                redelivered: false,
+                attemptNumber: 1,
+                deliveryCount: 1,
+                sourceQueue: 'matador.test.events',
+                sourceTransport: 'race-transport',
+            });
+            expect(sendError).toBeUndefined();
+            releaseSecondSubscribe?.();
+            await startPromise;
+        });
+    });
+    describe('self-dispatch during graceful shutdown (stopReceiving)', () => {
+        it('LOCAL transport only: a self-dispatched follow-up should still be delivered after stopReceiving()', async () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('events')
+                .build();
+            const received = [];
+            let releaseGate;
+            const gate = new Promise((resolve) => {
+                releaseGate = resolve;
+            });
+            let markStarted;
+            const started = new Promise((resolve) => {
+                markStarted = resolve;
+            });
+            const stepOneSub = createSubscriber({
+                name: 'step-one-handler',
+                description: 'Handles step one',
+                callback: async (envelope, context) => {
+                    markStarted?.();
+                    await gate;
+                    await context.matador.send(StepTwoEvent, { id: envelope.data.id });
+                },
+            });
+            const stepTwoSub = createSubscriber({
+                name: 'step-two-handler',
+                description: 'Handles step two',
+                callback: async (envelope) => {
+                    received.push(envelope.data.id);
+                },
+            });
+            const schema = {
+                [StepOneEvent.key]: [StepOneEvent, [stepOneSub]],
+                [StepTwoEvent.key]: [StepTwoEvent, [stepTwoSub]],
+            };
+            matador = new Matador({
+                transport,
+                topology,
+                schema,
+                consumeFrom: ['events'],
+            });
+            await matador.start();
+            void matador.send(StepOneEvent, { id: 'abc' });
+            await started;
+            // Graceful shutdown begins while step-one is still in flight.
+            await matador.stopReceiving();
+            // The in-flight handler now self-dispatches its follow-up event.
+            releaseGate?.();
+            await new Promise((resolve) => setTimeout(resolve, 50));
+            // LocalTransport is process-local — no other consumer could ever pick
+            // this up, so it should still be delivered here.
+            expect(received).toEqual(['abc']);
+        });
+        it('MULTI transport (external primary + local fallback): a dispatched event that falls back to local should still be delivered after stopReceiving()', async () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('events')
+                .build();
+            const received = [];
+            let releaseGate;
+            const gate = new Promise((resolve) => {
+                releaseGate = resolve;
+            });
+            let markStarted;
+            const started = new Promise((resolve) => {
+                markStarted = resolve;
+            });
+            // Always-failing "external" transport, forcing every send to fall
+            // back to the local transport below.
+            const externalMock = {
+                name: 'rabbitmq',
+                capabilities: {
+                    deliveryModes: ['at-least-once'],
+                    delayedMessages: false,
+                    deadLetterRouting: 'native',
+                    attemptTracking: true,
+                    concurrencyModel: 'prefetch',
+                    ordering: 'none',
+                    priorities: false,
+                },
+                isConnected: () => true,
+                connect: mock(async () => { }),
+                disconnect: mock(async () => { }),
+                send: mock(async () => {
+                    throw new Error('RabbitMQ down');
+                }),
+                subscribe: mock(async () => ({
+                    unsubscribe: mock(async () => { }),
+                    isActive: true,
+                })),
+                applyTopology: mock(async () => { }),
+                complete: mock(async () => { }),
+            };
+            const localTransport = new LocalTransport();
+            const multiTransport = new MultiTransport({
+                transports: [externalMock, localTransport],
+            });
+            const stepOneSub = createSubscriber({
+                name: 'step-one-handler',
+                description: 'Handles step one',
+                callback: async (envelope, context) => {
+                    markStarted?.();
+                    await gate;
+                    await context.matador.send(StepTwoEvent, { id: envelope.data.id });
+                },
+            });
+            const stepTwoSub = createSubscriber({
+                name: 'step-two-handler',
+                description: 'Handles step two',
+                callback: async (envelope) => {
+                    received.push(envelope.data.id);
+                },
+            });
+            const schema = {
+                [StepOneEvent.key]: [StepOneEvent, [stepOneSub]],
+                [StepTwoEvent.key]: [StepTwoEvent, [stepTwoSub]],
+            };
+            matador = new Matador({
+                transport: multiTransport,
+                topology,
+                schema,
+                consumeFrom: ['events'],
+            });
+            await matador.start();
+            void matador.send(StepOneEvent, { id: 'abc' });
+            await started;
+            await matador.stopReceiving();
+            releaseGate?.();
+            await new Promise((resolve) => setTimeout(resolve, 50));
+            // The follow-up falls back to the local transport. Local is
+            // process-local — no other consumer could ever pick it up — so it
+            // should still be delivered here, even though the external transport's
+            // own subscription was (correctly) cut off immediately.
+            expect(received).toEqual(['abc']);
+        });
+        it('RABBIT-like (external) transport only: send() after stopReceiving() should still succeed regardless of local subscription state', async () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('events')
+                .build();
+            const subscriber = createSubscriber({
+                name: 'step-one-handler',
+                description: 'Handles step one',
+                callback: async () => { },
+            });
+            const schema = {
+                [StepOneEvent.key]: [StepOneEvent, [subscriber]],
+            };
+            const externalTransport = {
+                name: 'rabbitmq',
+                capabilities: {
+                    deliveryModes: ['at-least-once'],
+                    delayedMessages: false,
+                    deadLetterRouting: 'native',
+                    attemptTracking: true,
+                    concurrencyModel: 'prefetch',
+                    ordering: 'none',
+                    priorities: false,
+                },
+                isConnected: () => true,
+                connect: mock(async () => { }),
+                disconnect: mock(async () => { }),
+                send: mock(async () => 'rabbitmq'),
+                subscribe: mock(async () => ({
+                    unsubscribe: mock(async () => { }),
+                    isActive: true,
+                })),
+                applyTopology: mock(async () => { }),
+                complete: mock(async () => { }),
+            };
+            matador = new Matador({
+                transport: externalTransport,
+                topology,
+                schema,
+                consumeFrom: ['events'],
+            });
+            await matador.start();
+            await matador.stopReceiving();
+            const result = await matador.send(StepOneEvent, { id: 'xyz' });
+            // A real broker doesn't need an active local consumer to accept a
+            // publish — another replica (or this instance, once it stops
+            // pretending to be shut down) could still consume it later. This case
+            // is not part of the bug — included as a contrast baseline.
+            expect(result.subscribersSent).toBe(1);
+            expect(result.errors).toHaveLength(0);
+        });
+    });
 });

package/dist/errors/index.d.ts

@@ -1,6 +1,6 @@
 export type { HasDescription } from './has-description.js';
 export { hasDescription } from './has-description.js';
 export { assertEvent, DontRetry, DoRetry, EventAssertionError, isAssertionError, isDontRetry, isDoRetry, RetryControlError, } from './retry-errors.js';
-export { MatadorError, isMatadorError, NotStartedError, isNotStartedError, ShutdownInProgressError, TransportNotConnectedError, isTransportNotConnectedError, TransportClosedError, TransportSendError, SomeSendError, AllTransportsFailedError, DelayedMessagesNotSupportedError, EventNotRegisteredError, isEventNotRegisteredError, SubscriberNotRegisteredError, isSubscriberNotRegisteredError, NoSubscribersExistError, InvalidSchemaError, SubscriberIsStubError, LocalTransportCannotProcessStubError, QueueNotFoundError, UnknownQueueReferenceError, isUnknownQueueReferenceError, InvalidEventError, MessageMaybePoisonedError, isMessageMaybePoisonedError, IdempotentMessageCannotRetryError, isIdempotentMessageCannotRetryError, TimeoutError, } from './matador-errors.js';
+export { MatadorError, isMatadorError, NotStartedError, isNotStartedError, ShutdownInProgressError, TransportNotConnectedError, isTransportNotConnectedError, TransportClosedError, TransportSendError, SomeSendError, AllTransportsFailedError, DelayedMessagesNotSupportedError, LocalTransportNoActiveSubscriberError, EventNotRegisteredError, isEventNotRegisteredError, SubscriberNotRegisteredError, isSubscriberNotRegisteredError, NoSubscribersExistError, InvalidSchemaError, SubscriberIsStubError, QueueNotFoundError, UnknownQueueReferenceError, isUnknownQueueReferenceError, InvalidEventError, MessageMaybePoisonedError, isMessageMaybePoisonedError, IdempotentMessageCannotRetryError, isIdempotentMessageCannotRetryError, TimeoutError, } from './matador-errors.js';
 export { CheckpointStoreError, DuplicateIoKeyError, isCheckpointStoreError, isDuplicateIoKeyError, } from './checkpoint-errors.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEL,YAAY,EACZ,cAAc,EAEd,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EAEvB,0BAA0B,EAC1B,4BAA4B,EAC5B,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACxB,gCAAgC,EAEhC,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,oCAAoC,EAEpC,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAE5B,iBAAiB,EAEjB,yBAAyB,EACzB,2BAA2B,EAC3B,iCAAiC,EACjC,mCAAmC,EAEnC,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAEL,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EACL,WAAW,EACX,SAAS,EACT,OAAO,EACP,mBAAmB,EACnB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAEL,YAAY,EACZ,cAAc,EAEd,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EAEvB,0BAA0B,EAC1B,4BAA4B,EAC5B,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,wBAAwB,EACxB,gCAAgC,EAChC,qCAAqC,EAErC,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EAErB,kBAAkB,EAClB,0BAA0B,EAC1B,4BAA4B,EAE5B,iBAAiB,EAEjB,yBAAyB,EACzB,2BAA2B,EAC3B,iCAAiC,EACjC,mCAAmC,EAEnC,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAEL,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC"}

package/dist/errors/index.js

@@ -6,9 +6,9 @@ MatadorError, isMatadorError,
 // Lifecycle errors
 NotStartedError, isNotStartedError, ShutdownInProgressError, 
 // Transport errors
-TransportNotConnectedError, isTransportNotConnectedError, TransportClosedError, TransportSendError, SomeSendError, AllTransportsFailedError, DelayedMessagesNotSupportedError, 
+TransportNotConnectedError, isTransportNotConnectedError, TransportClosedError, TransportSendError, SomeSendError, AllTransportsFailedError, DelayedMessagesNotSupportedError, LocalTransportNoActiveSubscriberError, 
 // Schema & configuration errors
-EventNotRegisteredError, isEventNotRegisteredError, SubscriberNotRegisteredError, isSubscriberNotRegisteredError, NoSubscribersExistError, InvalidSchemaError, SubscriberIsStubError, LocalTransportCannotProcessStubError, 
+EventNotRegisteredError, isEventNotRegisteredError, SubscriberNotRegisteredError, isSubscriberNotRegisteredError, NoSubscribersExistError, InvalidSchemaError, SubscriberIsStubError, 
 // Queue errors
 QueueNotFoundError, UnknownQueueReferenceError, isUnknownQueueReferenceError, 
 // Event validation errors

package/dist/errors/matador-errors.d.ts

@@ -98,6 +98,16 @@ export declare class DelayedMessagesNotSupportedError extends MatadorError {
     readonly description: string;
     constructor(transportName: string);
 }
+/**
+ * Thrown when a LocalTransport is sent a message for a queue with no active
+ * subscriber in the current process (e.g. the subscriber is a SubscriberStub
+ * implemented in another service, or matador.start() hasn't subscribed yet).
+ */
+export declare class LocalTransportNoActiveSubscriberError extends MatadorError {
+    readonly queue: string;
+    readonly description: string;
+    constructor(queue: string);
+}
 /**
  * Thrown when an event is not registered in the schema.
  */
@@ -139,14 +149,6 @@ export declare class SubscriberIsStubError extends MatadorError {
     readonly description: string;
     constructor(subscriberName: string);
 }
-/**
- * Thrown when a LocalTransport tries to process a stub subscriber.
- */
-export declare class LocalTransportCannotProcessStubError extends MatadorError {
-    readonly subscriberName: string;
-    readonly description: string;
-    constructor(subscriberName: string);
-}
 /**
  * Thrown when a subscriber's `targetQueue` or a `consumeFrom` entry references
  * a queue that was never declared in the topology.

package/dist/errors/matador-errors.d.ts.map

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

package/dist/errors/matador-errors.js

@@ -168,6 +168,24 @@ export class DelayedMessagesNotSupportedError extends MatadorError {
         this.transportName = transportName;
     }
 }
+/**
+ * Thrown when a LocalTransport is sent a message for a queue with no active
+ * subscriber in the current process (e.g. the subscriber is a SubscriberStub
+ * implemented in another service, or matador.start() hasn't subscribed yet).
+ */
+export class LocalTransportNoActiveSubscriberError extends MatadorError {
+    queue;
+    description = 'The LocalTransport has no active subscriber for this queue in the current process, ' +
+        'so it cannot guarantee delivery. ' +
+        'ACTION: If the subscriber is a SubscriberStub (implemented in another service), ' +
+        'the local transport can never deliver it locally — a distributed transport like ' +
+        'RabbitMQ is required. If the subscriber should run in this process, ensure ' +
+        'matador.start() has subscribed to this queue before sending.';
+    constructor(queue) {
+        super(`LocalTransport has no active subscriber for queue "${queue}"; message cannot be delivered.`);
+        this.queue = queue;
+    }
+}
 // ============================================================================
 // Schema & Configuration Errors
 // ============================================================================
@@ -248,20 +266,6 @@ export class SubscriberIsStubError extends MatadorError {
         this.subscriberName = subscriberName;
     }
 }
-/**
- * Thrown when a LocalTransport tries to process a stub subscriber.
- */
-export class LocalTransportCannotProcessStubError extends MatadorError {
-    subscriberName;
-    description = 'The LocalTransport cannot process events for SubscriberStubs. ' +
-        'ACTION: SubscriberStubs represent remote implementations that only RabbitMQ can route. ' +
-        'If using LocalTransport for testing, provide mock implementations instead of stubs. ' +
-        'For production fallback scenarios, be aware that stub-targeted events will be dropped.';
-    constructor(subscriberName) {
-        super(`LocalTransport cannot process stub subscriber "${subscriberName}". Stub subscribers require a distributed transport like RabbitMQ.`);
-        this.subscriberName = subscriberName;
-    }
-}
 // ============================================================================
 // Queue Errors
 // ============================================================================