@zdavison/matador 3.0.6 → 4.0.0

package/dist/core/fanout.d.ts

@@ -1,5 +1,6 @@
 import type { SafeHooks } from '../hooks/index.js';
 import type { SchemaRegistry } from '../schema/index.js';
+import type { Topology } from '../topology/index.js';
 import type { Transport } from '../transport/index.js';
 import type { Event, EventClass, EventOptions } from '../types/index.js';
 /**
@@ -9,7 +10,7 @@ export interface FanoutConfig {
     readonly transport: Transport;
     readonly schema: SchemaRegistry;
     readonly hooks: SafeHooks;
-    readonly namespace: string;
+    readonly topology: Topology;
     readonly defaultQueue: string;
 }
 /**
@@ -42,7 +43,7 @@ export declare class FanoutEngine {
     private readonly transport;
     private readonly schema;
     private readonly hooks;
-    private readonly namespace;
+    private readonly topology;
     private readonly defaultQueue;
     private enqueuingCount;
     constructor(config: FanoutConfig);

package/dist/core/fanout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fanout.d.ts","sourceRoot":"","sources":["../../src/core/fanout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAEV,KAAK,EACL,UAAU,EACV,YAAY,EACb,MAAM,mBAAmB,CAAC;AAG3B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,cAAc,CAAK;gBAEf,MAAM,EAAE,YAAY;IAQhC;;OAEG;IACH,IAAI,wBAAwB,IAAI,MAAM,CAErC;IAED;;OAEG;IACG,IAAI,CAAC,CAAC,EACV,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,UAAU,CAAC;YAsFR,mBAAmB;CAelC"}
+{"version":3,"file":"fanout.d.ts","sourceRoot":"","sources":["../../src/core/fanout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAEV,KAAK,EACL,UAAU,EACV,YAAY,EACb,MAAM,mBAAmB,CAAC;AAG3B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,cAAc,CAAK;gBAEf,MAAM,EAAE,YAAY;IAQhC;;OAEG;IACH,IAAI,wBAAwB,IAAI,MAAM,CAErC;IAED;;OAEG;IACG,IAAI,CAAC,CAAC,EACV,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,EACzB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,UAAU,CAAC;YAsFR,mBAAmB;CAelC"}

package/dist/core/fanout.js

@@ -1,5 +1,5 @@
 import { TransportSendError } from '../errors/index.js';
-import { getQualifiedQueueName } from '../topology/index.js';
+import { resolveTargetQueueName } from '../topology/index.js';
 import { createEnvelope } from '../types/index.js';
 /**
  * Engine for fanning out events to subscribers.
@@ -14,14 +14,14 @@ export class FanoutEngine {
     transport;
     schema;
     hooks;
-    namespace;
+    topology;
     defaultQueue;
     enqueuingCount = 0;
     constructor(config) {
         this.transport = config.transport;
         this.schema = config.schema;
         this.hooks = config.hooks;
-        this.namespace = config.namespace;
+        this.topology = config.topology;
         this.defaultQueue = config.defaultQueue;
     }
     /**
@@ -54,7 +54,7 @@ export class FanoutEngine {
             }
             // Determine target queue
             const targetQueue = subscriber.targetQueue ?? this.defaultQueue;
-            const qualifiedQueue = getQualifiedQueueName(this.namespace, targetQueue);
+            const qualifiedQueue = resolveTargetQueueName(this.topology, targetQueue);
             // Create envelope
             const envelope = createEnvelope({
                 eventKey,

package/dist/core/fanout.test.js

@@ -2,6 +2,7 @@ import { beforeEach, describe, expect, it, mock } from 'bun:test';
 import { TransportSendError } from '../errors/index.js';
 import { SafeHooks } from '../hooks/index.js';
 import { SchemaRegistry } from '../schema/index.js';
+import { TopologyBuilder } from '../topology/index.js';
 import { MatadorEvent, createSubscriber, createSubscriberStub, } from '../types/index.js';
 import { FanoutEngine } from './fanout.js';
 class UserCreatedEvent extends MatadorEvent {
@@ -33,6 +34,13 @@ class UserCreatedEventWithMetadata extends MatadorEvent {
         this.metadata = metadata;
     }
 }
+const testTopology = TopologyBuilder.create()
+    .withNamespace('test')
+    .addQueue('events')
+    .addQueue('notifications')
+    .addQueue('queue-1')
+    .addQueue('queue-2')
+    .build();
 describe('FanoutEngine', () => {
     let transport;
     let schema;
@@ -67,7 +75,7 @@ describe('FanoutEngine', () => {
             transport,
             schema,
             hooks,
-            namespace: 'test',
+            topology: testTopology,
             defaultQueue: 'events',
         });
     });
@@ -80,7 +88,7 @@ describe('FanoutEngine', () => {
                 transport,
                 schema,
                 hooks,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             expect(instance).toBeInstanceOf(FanoutEngine);
@@ -120,7 +128,7 @@ describe('FanoutEngine', () => {
                 email: 'test@example.com',
             });
             await fanout.send(UserCreatedEvent, event);
-            expect(transport.send).toHaveBeenCalledWith('test.events', expect.any(Object), undefined);
+            expect(transport.send).toHaveBeenCalledWith('matador.test.events', expect.any(Object), undefined);
         });
         it('should use subscriber targetQueue when specified', async () => {
             const subscriber = createSubscriber({
@@ -135,7 +143,7 @@ describe('FanoutEngine', () => {
                 email: 'test@example.com',
             });
             await fanout.send(UserCreatedEvent, event);
-            expect(transport.send).toHaveBeenCalledWith('test.notifications', expect.any(Object), undefined);
+            expect(transport.send).toHaveBeenCalledWith('matador.test.notifications', expect.any(Object), undefined);
         });
         it('should create envelope with correct structure', async () => {
             const subscriber = createSubscriber({
@@ -258,8 +266,8 @@ describe('FanoutEngine', () => {
             });
             await fanout.send(UserCreatedEvent, event);
             const calls = transport.send.mock.calls;
-            expect(calls[0]?.[0]).toBe('test.queue-1');
-            expect(calls[1]?.[0]).toBe('test.queue-2');
+            expect(calls[0]?.[0]).toBe('matador.test.queue-1');
+            expect(calls[1]?.[0]).toBe('matador.test.queue-2');
         });
         it('should send to no subscribers when event is not registered', async () => {
             const event = new OrderPlacedEvent({
@@ -338,7 +346,7 @@ describe('FanoutEngine', () => {
                 transport,
                 schema,
                 hooks: hooksInstance,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const subscriber = createSubscriber({
@@ -518,7 +526,7 @@ describe('FanoutEngine', () => {
                 transport: failingTransport,
                 schema,
                 hooks,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const subscriber = createSubscriber({
@@ -536,14 +544,14 @@ describe('FanoutEngine', () => {
             expect(result.subscribersSkipped).toBe(0);
             expect(result.errors).toHaveLength(1);
             expect(result.errors[0]?.subscriberName).toBe('handle-user');
-            expect(result.errors[0]?.queue).toBe('test.events');
+            expect(result.errors[0]?.queue).toBe('matador.test.events');
             expect(result.errors[0]?.error).toBeInstanceOf(TransportSendError);
         });
         it('should continue sending to other subscribers after one fails', async () => {
             const failingTransport = {
                 ...transport,
                 send: mock(async (queue) => {
-                    if (queue === 'test.queue-1') {
+                    if (queue === 'matador.test.queue-1') {
                         throw new Error('Queue 1 failed');
                     }
                     return 'mock';
@@ -553,7 +561,7 @@ describe('FanoutEngine', () => {
                 transport: failingTransport,
                 schema,
                 hooks,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const sub1 = createSubscriber({
@@ -590,7 +598,7 @@ describe('FanoutEngine', () => {
                 transport: failingTransport,
                 schema,
                 hooks,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const subscriber = createSubscriber({
@@ -606,7 +614,7 @@ describe('FanoutEngine', () => {
             const result = await fanoutWithFailingTransport.send(UserCreatedEvent, event);
             expect(result.errors).toHaveLength(1);
             expect(result.errors[0]?.error).toBeInstanceOf(TransportSendError);
-            expect(result.errors[0]?.error.message).toContain('test.events');
+            expect(result.errors[0]?.error.message).toContain('matador.test.events');
         });
     });
     describe('eventsBeingEnqueuedCount tracking', () => {
@@ -625,7 +633,7 @@ describe('FanoutEngine', () => {
                 transport: trackingTransport,
                 schema,
                 hooks,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const subscriber = createSubscriber({
@@ -668,7 +676,7 @@ describe('FanoutEngine', () => {
                 transport: failingTransport,
                 schema,
                 hooks,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const subscriber = createSubscriber({
@@ -715,7 +723,7 @@ describe('FanoutEngine', () => {
                 transport: trackingTransport,
                 schema,
                 hooks,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const event = new UserCreatedEvent({
@@ -802,7 +810,7 @@ describe('FanoutEngine', () => {
                 transport,
                 schema,
                 hooks: hooksInstance,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const subscriber = createSubscriber({
@@ -819,7 +827,7 @@ describe('FanoutEngine', () => {
             expect(onEnqueueSuccess).toHaveBeenCalledTimes(1);
             expect(onEnqueueSuccess).toHaveBeenCalledWith({
                 envelope: expect.any(Object),
-                queue: 'test.events',
+                queue: 'matador.test.events',
                 transport: 'mock',
             });
             const calls = onEnqueueSuccess.mock.calls;
@@ -846,7 +854,7 @@ describe('FanoutEngine', () => {
                 transport: failingTransport,
                 schema,
                 hooks: hooksInstance,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const subscriber = createSubscriber({
@@ -884,7 +892,7 @@ describe('FanoutEngine', () => {
                 transport,
                 schema,
                 hooks: hooksInstance,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const sub1 = createSubscriber({
@@ -920,7 +928,7 @@ describe('FanoutEngine', () => {
                 transport,
                 schema,
                 hooks: hooksInstance,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const subscriber = createSubscriber({
@@ -949,7 +957,7 @@ describe('FanoutEngine', () => {
                 transport,
                 schema,
                 hooks: hooksInstance,
-                namespace: 'test',
+                topology: testTopology,
                 defaultQueue: 'events',
             });
             const subscriber = createSubscriber({
@@ -984,7 +992,7 @@ describe('FanoutEngine', () => {
                 delayMs: 5000,
             };
             await fanout.send(UserCreatedEvent, event, options);
-            expect(transport.send).toHaveBeenCalledWith('test.events', expect.any(Object), { delay: 5000 });
+            expect(transport.send).toHaveBeenCalledWith('matador.test.events', expect.any(Object), { delay: 5000 });
         });
         it('should include delay in envelope', async () => {
             const subscriber = createSubscriber({
@@ -1023,7 +1031,7 @@ describe('FanoutEngine', () => {
                 email: 'test@example.com',
             });
             await fanout.send(UserCreatedEvent, event);
-            expect(transport.send).toHaveBeenCalledWith('test.events', expect.any(Object), undefined);
+            expect(transport.send).toHaveBeenCalledWith('matador.test.events', expect.any(Object), undefined);
         });
     });
     describe('subscriber importance', () => {

package/dist/core/matador.d.ts.map

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

package/dist/core/matador.js

@@ -1,10 +1,10 @@
 import { JsonCodec } from '../codec/index.js';
-import { InvalidSchemaError, NotStartedError, ShutdownInProgressError, } from '../errors/index.js';
+import { InvalidSchemaError, NotStartedError, ShutdownInProgressError, SomeSendError, } from '../errors/index.js';
 import { SafeHooks } from '../hooks/index.js';
 import { ProcessingPipeline } from '../pipeline/index.js';
 import { StandardRetryPolicy } from '../retry/index.js';
 import { SchemaRegistry, isSchemaEntryTuple } from '../schema/index.js';
-import { getQualifiedQueueName } from '../topology/index.js';
+import { findQueueDefinition, resolveTargetQueueName, } from '../topology/index.js';
 import { FanoutEngine } from './fanout.js';
 import { ShutdownManager } from './shutdown.js';
 /**
@@ -64,7 +64,7 @@ export class Matador {
             transport: this.transport,
             schema: this.schema,
             hooks: this.hooks,
-            namespace: this.topology.namespace,
+            topology: this.topology,
             defaultQueue,
         });
         // Create shutdown manager
@@ -134,9 +134,12 @@ export class Matador {
         if (this.consumeFrom.length > 0) {
             this.hooks.logger.info(`[Matador] 🟢 Worker subscribing to '${this.consumeFrom.join(',')}'.`);
         }
+        else {
+            this.hooks.logger.info('[Matador] 🟡 Worker not subscribing to any queues (consumeFrom is empty).');
+        }
         for (const queueName of this.consumeFrom) {
-            const qualifiedName = getQualifiedQueueName(this.topology.namespace, queueName);
-            const queueDef = this.topology.queues.find((q) => q.name === queueName);
+            const qualifiedName = resolveTargetQueueName(this.topology, queueName);
+            const queueDef = findQueueDefinition(this.topology, queueName);
             const subscription = await this.transport.subscribe(qualifiedName, async (envelope, receipt) => {
                 this.shutdownManager.incrementProcessing();
                 try {
@@ -168,13 +171,19 @@ export class Matador {
             const data = dataOrOptions;
             const options = maybeOptions;
             const event = new eventClass(data);
-            return this.fanout.send(eventClass, event, options);
+            const result = await this.fanout.send(eventClass, event, options);
+            if (result.errors.length > 0)
+                throw new SomeSendError(result.eventKey, result.errors);
+            return result;
         }
         // Called as: send(event, options?)
         const event = eventOrClass;
         const options = dataOrOptions;
         const eventClass = event.constructor;
-        return this.fanout.send(eventClass, event, options);
+        const result = await this.fanout.send(eventClass, event, options);
+        if (result.errors.length > 0)
+            throw new SomeSendError(result.eventKey, result.errors);
+        return result;
     }
     /**
      * Gets current handler state.

package/dist/core/matador.test.js

@@ -1,4 +1,5 @@
-import { afterEach, beforeEach, describe, expect, it } from 'bun:test';
+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';
@@ -296,6 +297,36 @@ describe('Matador', () => {
             });
             expect(result.subscribersSent).toBe(1);
         });
+        it('should throw SomeSendError when transport send fails', async () => {
+            const topology = TopologyBuilder.create()
+                .withNamespace('test')
+                .addQueue('events')
+                .build();
+            const subscriber = createSubscriber({
+                name: 'handle-user',
+                description: 'Handles user events',
+                callback: async () => { },
+            });
+            const schema = {
+                [UserCreatedEvent.key]: [UserCreatedEvent, [subscriber]],
+            };
+            matador = new Matador({ transport, topology, schema });
+            await matador.start();
+            const sendError = new Error('Network timeout');
+            transport.send = mock(async () => {
+                throw sendError;
+            });
+            const thrown = await matador
+                .send(new UserCreatedEvent({ userId: '123', email: 'test@example.com' }))
+                .catch((e) => e);
+            expect(thrown).toBeInstanceOf(SomeSendError);
+            expect(thrown.eventKey).toBe(UserCreatedEvent.key);
+            expect(thrown.errors).toHaveLength(1);
+            expect(thrown.errors[0]?.subscriberName).toBe('handle-user');
+            expect(thrown.errors[0]?.queue).toBe('matador.test.events');
+            expect(thrown.errors[0]?.error).toBeInstanceOf(TransportSendError);
+            expect(thrown.errors[0]?.error.cause).toBe(sendError);
+        });
     });
     describe('shutdown', () => {
         it('should gracefully shutdown', async () => {

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, AllTransportsFailedError, DelayedMessagesNotSupportedError, EventNotRegisteredError, isEventNotRegisteredError, SubscriberNotRegisteredError, isSubscriberNotRegisteredError, NoSubscribersExistError, InvalidSchemaError, SubscriberIsStubError, LocalTransportCannotProcessStubError, QueueNotFoundError, InvalidEventError, MessageMaybePoisonedError, isMessageMaybePoisonedError, IdempotentMessageCannotRetryError, isIdempotentMessageCannotRetryError, TimeoutError, } from './matador-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 { 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,wBAAwB,EACxB,gCAAgC,EAEhC,uBAAuB,EACvB,yBAAyB,EACzB,4BAA4B,EAC5B,8BAA8B,EAC9B,uBAAuB,EACvB,kBAAkB,EAClB,qBAAqB,EACrB,oCAAoC,EAEpC,kBAAkB,EAElB,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,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"}

package/dist/errors/index.js

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

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

@@ -72,6 +72,24 @@ export declare class TransportSendError extends MatadorError {
     constructor(queue: string, cause: Error);
     toJSON(): Record<string, unknown>;
 }
+/**
+ * Thrown when send() completes but one or more subscriber publishes failed.
+ * The `errors` array contains per-failure details: subscriber name, target queue, and underlying error.
+ */
+export declare class SomeSendError extends MatadorError {
+    readonly eventKey: string;
+    readonly errors: ReadonlyArray<{
+        subscriberName: string;
+        queue: string;
+        error: Error;
+    }>;
+    readonly description: string;
+    constructor(eventKey: string, errors: ReadonlyArray<{
+        subscriberName: string;
+        queue: string;
+        error: Error;
+    }>);
+}
 /**
  * Thrown when delayed messages are requested but the plugin is not available.
  */
@@ -129,6 +147,15 @@ export declare class LocalTransportCannotProcessStubError extends MatadorError {
     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.
+ */
+export declare class UnknownQueueReferenceError extends MatadorError {
+    readonly queueName: string;
+    readonly description: string;
+    constructor(queueName: string);
+}
 /**
  * Thrown when a queue is not found or not created.
  */
@@ -178,6 +205,7 @@ export declare function isNotStartedError(error: unknown): error is NotStartedEr
 export declare function isTransportNotConnectedError(error: unknown): error is TransportNotConnectedError;
 export declare function isEventNotRegisteredError(error: unknown): error is EventNotRegisteredError;
 export declare function isSubscriberNotRegisteredError(error: unknown): error is SubscriberNotRegisteredError;
+export declare function isUnknownQueueReferenceError(error: unknown): error is UnknownQueueReferenceError;
 export declare function isMessageMaybePoisonedError(error: unknown): error is MessageMaybePoisonedError;
 export declare function isIdempotentMessageCannotRetryError(error: unknown): error is IdempotentMessageCannotRetryError;
 //# sourceMappingURL=matador-errors.d.ts.map

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

@@ -133,6 +133,25 @@ export class TransportSendError extends MatadorError {
         };
     }
 }
+/**
+ * Thrown when send() completes but one or more subscriber publishes failed.
+ * The `errors` array contains per-failure details: subscriber name, target queue, and underlying error.
+ */
+export class SomeSendError extends MatadorError {
+    eventKey;
+    errors;
+    description = 'One or more subscriber messages could not be published during send(). ' +
+        'ACTION: Inspect the `errors` array for per-failure details. ' +
+        'Each entry contains the subscriber name, target queue, and underlying error.';
+    constructor(eventKey, errors) {
+        const summary = errors
+            .map((e) => `${e.subscriberName} (${e.queue}): ${e.error.message}`)
+            .join('; ');
+        super(`send("${eventKey}") failed for ${errors.length} subscriber(s): ${summary}`);
+        this.eventKey = eventKey;
+        this.errors = errors;
+    }
+}
 /**
  * Thrown when delayed messages are requested but the plugin is not available.
  */
@@ -246,6 +265,25 @@ export class LocalTransportCannotProcessStubError extends MatadorError {
 // ============================================================================
 // Queue Errors
 // ============================================================================
+/**
+ * Thrown when a subscriber's `targetQueue` or a `consumeFrom` entry references
+ * a queue that was never declared in the topology.
+ */
+export class UnknownQueueReferenceError extends MatadorError {
+    queueName;
+    description = 'A queue was referenced that is not declared in the topology. ' +
+        'Matador only routes to queues it knows about; an unknown reference would ' +
+        'otherwise be silently namespace-qualified and published to a queue nobody ' +
+        'consumes, losing the message. ' +
+        'ACTION: Declare the queue on the topology before referencing it. ' +
+        'For a Matador-owned queue use `.addQueue(name)`; for a foreign queue owned ' +
+        'by another service use `.addQueue({ name, exact: true })` so it is routed ' +
+        'to verbatim.';
+    constructor(queueName) {
+        super(`Queue reference "${queueName}" is not declared in the topology. Add it via .addQueue(name), or .addQueue({ name, exact: true }) for a foreign queue.`);
+        this.queueName = queueName;
+    }
+}
 /**
  * Thrown when a queue is not found or not created.
  */
@@ -358,6 +396,9 @@ export function isEventNotRegisteredError(error) {
 export function isSubscriberNotRegisteredError(error) {
     return error instanceof SubscriberNotRegisteredError;
 }
+export function isUnknownQueueReferenceError(error) {
+    return error instanceof UnknownQueueReferenceError;
+}
 export function isMessageMaybePoisonedError(error) {
     return error instanceof MessageMaybePoisonedError;
 }