@zdavison/matador 2.0.12 → 3.0.2

package/dist/index.cjs

@@ -134,6 +134,7 @@ var TransportNotConnectedError = class extends MatadorError {
     );
     this.transportName = transportName;
   }
+  transportName;
   description = "The transport is not connected to the message broker. ACTION: Ensure the transport is connected by calling transport.connect() or matador.start(). Check that the broker (e.g., RabbitMQ) is running and accessible. Verify connection settings (URL, credentials, network access).";
 };
 var TransportClosedError = class extends MatadorError {
@@ -143,6 +144,7 @@ var TransportClosedError = class extends MatadorError {
     );
     this.transportName = transportName;
   }
+  transportName;
   description = "The transport has been closed and will not accept new operations. ACTION: This typically occurs during application shutdown. If unexpected, check for early shutdown triggers. Events sent after transport closure will be lost.";
 };
 var AllTransportsFailedError = class extends MatadorError {
@@ -153,6 +155,8 @@ var AllTransportsFailedError = class extends MatadorError {
     this.queue = queue;
     this.errors = errors;
   }
+  queue;
+  errors;
   description = "All transports failed to send the message. ACTION: Check the health of all configured transports (primary and fallbacks). Review the errors array for specific failure reasons. Ensure at least one transport is properly configured and reachable. Consider adding a LocalTransport as a last-resort fallback.";
 };
 var TransportSendError = class extends MatadorError {
@@ -161,6 +165,8 @@ var TransportSendError = class extends MatadorError {
     this.queue = queue;
     this.cause = cause;
   }
+  queue;
+  cause;
   description = "Failed to send a message through the transport. ACTION: Check the underlying error for details. Common causes: (1) Transport disconnected during send, (2) Network issues between application and broker, (3) Broker rejected the message (size, permissions, queue limits). The message was NOT delivered and should be retried or logged.";
   toJSON() {
     return {
@@ -176,10 +182,11 @@ var TransportSendError = class extends MatadorError {
 var DelayedMessagesNotSupportedError = class extends MatadorError {
   constructor(transportName) {
     super(
-      `Delayed messages require the RabbitMQ delayed message exchange plugin. Install rabbitmq_delayed_message_exchange or remove delayMs from event options.`
+      "Delayed messages require the RabbitMQ delayed message exchange plugin. Install rabbitmq_delayed_message_exchange or remove delayMs from event options."
     );
     this.transportName = transportName;
   }
+  transportName;
   description = "Delayed messages were requested but the transport does not support them. ACTION: For RabbitMQ, install the rabbitmq_delayed_message_exchange plugin. Run: rabbitmq-plugins enable rabbitmq_delayed_message_exchange Then restart RabbitMQ and reconnect. Alternatively, remove delayMs from your event options if delays are not required.";
 };
 var EventNotRegisteredError = class extends MatadorError {
@@ -189,16 +196,19 @@ var EventNotRegisteredError = class extends MatadorError {
     );
     this.eventKey = eventKey;
   }
+  eventKey;
   description = "The event type is not registered in the schema. ACTION: Register the event using matador.register(EventClass, subscribers) before dispatching. If this occurs during message consumption, it may indicate schema drift between services. Ensure all services have matching schema registrations for shared events.";
 };
 var SubscriberNotRegisteredError = class extends MatadorError {
   constructor(subscriberName, eventKey) {
     super(
-      `Subscriber "${subscriberName}" is not registered` + (eventKey ? ` for event "${eventKey}"` : "") + ". Check schema registration."
+      `Subscriber "${subscriberName}" is not registered${eventKey ? ` for event "${eventKey}"` : ""}. Check schema registration.`
     );
     this.subscriberName = subscriberName;
     this.eventKey = eventKey;
   }
+  subscriberName;
+  eventKey;
   description = "The subscriber is not registered for this event in the schema. ACTION: Ensure the subscriber is included in the registration for this event. This may occur if: (1) The subscriber was removed from the schema but messages still exist, (2) Schema drift between producer and consumer services, (3) A deployment is in progress with different schema versions. Check the dead-letter queue for affected messages.";
 };
 var NoSubscribersExistError = class extends MatadorError {
@@ -208,13 +218,15 @@ var NoSubscribersExistError = class extends MatadorError {
     );
     this.eventKey = eventKey;
   }
+  eventKey;
   description = "The event has no subscribers registered. ACTION: Register at least one subscriber for this event type. If subscribers were intentionally removed, consider also removing the event dispatch. Events without subscribers are not useful and may indicate configuration issues.";
 };
 var InvalidSchemaError = class extends MatadorError {
   constructor(message, cause) {
-    super(`Invalid schema: ${message}` + (cause ? `. Cause: ${cause}` : ""));
+    super(`Invalid schema: ${message}${cause ? `. Cause: ${cause}` : ""}`);
     this.cause = cause;
   }
+  cause;
   description = "The schema configuration is invalid. ACTION: Review the schema registration for issues. Common problems: (1) Duplicate subscriber names for the same event, (2) Missing required fields on event class (key, description), (3) Invalid alias configuration. Check the cause property for specific details.";
 };
 var SubscriberIsStubError = class extends MatadorError {
@@ -224,6 +236,7 @@ var SubscriberIsStubError = class extends MatadorError {
     );
     this.subscriberName = subscriberName;
   }
+  subscriberName;
   description = "A SubscriberStub was registered in a consuming schema. ACTION: SubscriberStubs should only be used in producer schemas to declare that a subscriber exists in another service. In the consumer service, provide a full Subscriber with a callback function. Remove the stub from the consumer schema and add the actual implementation.";
 };
 var LocalTransportCannotProcessStubError = class extends MatadorError {
@@ -233,6 +246,7 @@ var LocalTransportCannotProcessStubError = class extends MatadorError {
     );
     this.subscriberName = subscriberName;
   }
+  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.";
 };
 var QueueNotFoundError = class extends MatadorError {
@@ -242,13 +256,15 @@ var QueueNotFoundError = class extends MatadorError {
     );
     this.queueName = queueName;
   }
+  queueName;
   description = "The specified queue does not exist or has not been created. ACTION: Ensure the queue is defined in the topology configuration. Call transport.applyTopology() or matador.start() to create queues. Check that the queue name matches the topology definition.";
 };
 var InvalidEventError = class extends MatadorError {
   constructor(message, cause) {
-    super(`Invalid event: ${message}` + (cause ? `. Cause: ${cause}` : ""));
+    super(`Invalid event: ${message}${cause ? `. Cause: ${cause}` : ""}`);
     this.cause = cause;
   }
+  cause;
   description = "The event is invalid or missing required fields. ACTION: Ensure the event has all required properties. Common issues: missing targetSubscriber during processing, null/undefined data when the event type requires data, malformed event structure from codec decode failure.";
 };
 var MessageMaybePoisonedError = class extends MatadorError {
@@ -260,6 +276,9 @@ var MessageMaybePoisonedError = class extends MatadorError {
     this.deliveryCount = deliveryCount;
     this.maxDeliveries = maxDeliveries;
   }
+  eventId;
+  deliveryCount;
+  maxDeliveries;
   description = "A message was redelivered multiple times without successful processing. This usually indicates the message causes a crash or timeout during processing. ACTION: (1) Check application logs for errors/crashes during message processing, (2) Inspect the message in the dead-letter queue for malformed data, (3) Review the subscriber code for bugs that cause crashes, (4) Consider increasing processing timeout if the operation is legitimately slow. This message will NOT be retried to prevent crash loops.";
 };
 var IdempotentMessageCannotRetryError = class extends MatadorError {
@@ -270,6 +289,8 @@ var IdempotentMessageCannotRetryError = class extends MatadorError {
     this.eventId = eventId;
     this.subscriberName = subscriberName;
   }
+  eventId;
+  subscriberName;
   description = "A non-idempotent subscriber received a redelivered message. Retrying would risk duplicate side effects (e.g., double payments, duplicate emails). ACTION: (1) Mark the subscriber as idempotent if it safely handles duplicates, (2) Implement idempotency keys in the subscriber logic, (3) Manually inspect and replay the message from the dead-letter queue after verification. The message will be sent to the dead-letter queue for manual review.";
 };
 var TimeoutError = class extends MatadorError {
@@ -278,6 +299,8 @@ var TimeoutError = class extends MatadorError {
     this.operation = operation;
     this.timeoutMs = timeoutMs;
   }
+  operation;
+  timeoutMs;
   description = "An operation timed out before completing. ACTION: (1) Increase the timeout if the operation legitimately needs more time, (2) Optimize the operation to complete faster, (3) Check for deadlocks or blocking operations, (4) Verify external service dependencies are responsive.";
 };
 function isMatadorError(error) {
@@ -311,6 +334,8 @@ var DuplicateIoKeyError = class extends MatadorError {
     this.key = key;
     this.subscriberName = subscriberName;
   }
+  key;
+  subscriberName;
   description = "The same io() key was used multiple times in a single subscriber execution. Each io() call must have a unique key to ensure correct checkpoint behavior. ACTION: Ensure all io() keys are unique within the subscriber. For dynamic operations (e.g., loops), include a unique identifier in the key (e.g., `process-item-${item.id}`).";
 };
 var CheckpointStoreError = class extends MatadorError {
@@ -322,6 +347,9 @@ var CheckpointStoreError = class extends MatadorError {
     this.envelopeId = envelopeId;
     this.cause = cause;
   }
+  operation;
+  envelopeId;
+  cause;
   description = "A checkpoint store operation failed. This may cause issues with resumable subscribers. ACTION: Check the underlying storage system (Redis, etc.) for connectivity issues. The subscriber may re-execute operations that were already completed.";
 };
 function isDuplicateIoKeyError(error) {
@@ -358,6 +386,7 @@ var TopologyValidationError = class extends Error {
     this.issues = issues;
     this.name = "TopologyValidationError";
   }
+  issues;
   description = "The topology configuration is invalid. Check the issues array for specific validation failures such as missing namespace, invalid queue names, or conflicting settings. This error occurs during Matador initialization and must be fixed in the configuration.";
 };
 var TopologyBuilder = class _TopologyBuilder {
@@ -902,6 +931,9 @@ var ShutdownManager = class {
     this.disconnectTransport = disconnectTransport;
     this.config = { ...defaultShutdownConfig, ...config };
   }
+  getEnqueueCount;
+  stopReceiving;
+  disconnectTransport;
   _state = "running";
   config;
   eventsBeingProcessed = 0;
@@ -1012,6 +1044,7 @@ var CodecDecodeError = class extends Error {
     this.cause = cause;
     this.name = "CodecDecodeError";
   }
+  cause;
   description = "Failed to decode a message from the transport. This typically indicates corrupted data, incompatible codec versions, or messages from a different system. Check the cause property for the underlying parsing error. The message will be sent to the dead-letter queue for investigation.";
 };
 
@@ -1048,16 +1081,16 @@ var JsonCodec = class {
       return false;
     }
     const envelope = value;
-    if (typeof envelope["id"] !== "string") return false;
+    if (typeof envelope.id !== "string") return false;
     if (!("data" in envelope)) return false;
-    if (typeof envelope["docket"] !== "object" || envelope["docket"] === null)
+    if (typeof envelope.docket !== "object" || envelope.docket === null)
       return false;
-    const docket = envelope["docket"];
-    if (typeof docket["eventKey"] !== "string") return false;
-    if (typeof docket["targetSubscriber"] !== "string") return false;
-    if (typeof docket["attempts"] !== "number") return false;
-    if (typeof docket["createdAt"] !== "string") return false;
-    if (typeof docket["importance"] !== "string") return false;
+    const docket = envelope.docket;
+    if (typeof docket.eventKey !== "string") return false;
+    if (typeof docket.targetSubscriber !== "string") return false;
+    if (typeof docket.attempts !== "number") return false;
+    if (typeof docket.createdAt !== "string") return false;
+    if (typeof docket.importance !== "string") return false;
     return true;
   }
 };
@@ -1147,12 +1180,12 @@ var RabbitMQCodec = class {
   isV1Body(value) {
     if (typeof value !== "object" || value === null) return false;
     const obj = value;
-    return typeof obj["key"] === "string" && typeof obj["targetSubscriber"] === "string" && "data" in obj && !("payload" in obj);
+    return typeof obj.key === "string" && typeof obj.targetSubscriber === "string" && "data" in obj && !("payload" in obj);
   }
   isV2Body(value) {
     if (typeof value !== "object" || value === null) return false;
     const obj = value;
-    return typeof obj["id"] === "string" && "data" in obj && !("key" in obj);
+    return typeof obj.id === "string" && "data" in obj && !("key" in obj);
   }
   decodeV2(body, headers) {
     const eventKey = this.requireStringHeader(headers, HEADERS.EVENT_KEY);
@@ -1210,7 +1243,7 @@ var RabbitMQCodec = class {
       Object.assign(mergedMetadata, body.metadata);
     }
     if (user_id !== void 0 && user_id !== null) {
-      mergedMetadata["user_id"] = user_id;
+      mergedMetadata.user_id = user_id;
     }
     Object.assign(mergedMetadata, otherUniversal);
     const attempts = typeof headers[HEADERS.ATTEMPTS] === "number" ? headers[HEADERS.ATTEMPTS] : 1;
@@ -1774,7 +1807,7 @@ var StandardRetryPolicy = class {
   }
   getDelay(context) {
     const attempt = context.receipt.attemptNumber;
-    const delay = this.config.baseDelay * Math.pow(this.config.backoffMultiplier, attempt - 1);
+    const delay = this.config.baseDelay * this.config.backoffMultiplier ** (attempt - 1);
     return Math.min(delay, this.config.maxDelay);
   }
 };
@@ -2111,17 +2144,16 @@ var Matador = class {
     }
     const isEventClass = typeof eventOrClass === "function" && "key" in eventOrClass;
     if (isEventClass) {
-      const eventClass = eventOrClass;
+      const eventClass2 = eventOrClass;
       const data = dataOrOptions;
-      const options = maybeOptions;
-      const event = new eventClass(data);
-      return this.fanout.send(eventClass, event, options);
-    } else {
-      const event = eventOrClass;
-      const options = dataOrOptions;
-      const eventClass = event.constructor;
-      return this.fanout.send(eventClass, event, options);
+      const options2 = maybeOptions;
+      const event2 = new eventClass2(data);
+      return this.fanout.send(eventClass2, event2, options2);
     }
+    const event = eventOrClass;
+    const options = dataOrOptions;
+    const eventClass = event.constructor;
+    return this.fanout.send(eventClass, event, options);
   }
   /**
    * Gets current handler state.
@@ -2215,6 +2247,8 @@ var ConnectionManager = class {
     this.disconnectFn = disconnectFn;
     this.config = { ...defaultConnectionConfig, ...config };
   }
+  connectFn;
+  disconnectFn;
   _state = { status: "disconnected" };
   listeners = /* @__PURE__ */ new Set();
   reconnectTimer = null;
@@ -2282,7 +2316,7 @@ var ConnectionManager = class {
    * Calculate delay for a given attempt using exponential backoff.
    */
   calculateDelay(attempt) {
-    const delay = this.config.initialReconnectDelay * Math.pow(this.config.backoffMultiplier, attempt - 1);
+    const delay = this.config.initialReconnectDelay * this.config.backoffMultiplier ** (attempt - 1);
     return Math.min(delay, this.config.maxReconnectDelay);
   }
   setState(state) {
@@ -3093,7 +3127,7 @@ var RabbitMQTransport = class {
       const delayedExchange = this.getDelayedExchangeName(topology.namespace);
       await channel.bindQueue(queueName, delayedExchange, queueName);
     }
-    if (topology.retry.enabled) {
+    if (topology.retry.enabled && !queueDef.exact) {
       await this.assertRetryQueue(channel, topology, queueName);
     }
   }