@gomessaging/messaging 0.0.1

package/README.md

@@ -0,0 +1,185 @@
+# @gomessaging/messaging
+
+TypeScript implementation of the [messaging specification](https://codeberg.org/messaging/messaging). This package mirrors the Go messaging library, providing identical naming functions, validation, CloudEvents handling, routing, and visualization for Node.js/TypeScript transport implementations.
+
+## Installation
+
+```sh
+npm install @gomessaging/messaging
+```
+
+## Usage
+
+```typescript
+import {
+  // Naming
+  topicExchangeName,
+  serviceEventQueueName,
+  natsStreamName,
+  natsSubject,
+
+  // CloudEvents
+  validateCEHeaders,
+  metadataFromHeaders,
+  normalizeCEHeaders,
+  hasCEHeaders,
+  enrichLegacyMetadata,
+
+  // Validation
+  validate,
+  validateTopologies,
+
+  // Visualization
+  mermaid,
+
+  // Routing
+  matchRoutingKey,
+  routingKeyOverlaps,
+
+  // Types
+  type Topology,
+  type Endpoint,
+  type ConsumableEvent,
+  type Metadata,
+  type EventHandler,
+} from "@gomessaging/messaging";
+```
+
+### Naming
+
+Deterministic resource names for AMQP and NATS:
+
+```typescript
+topicExchangeName("events");
+// "events.topic.exchange"
+
+serviceEventQueueName("events.topic.exchange", "notifications");
+// "events.topic.exchange.queue.notifications"
+
+natsStreamName("audit.topic.exchange");
+// "audit"
+
+natsSubject("events", "Order.Created");
+// "events.Order.Created"
+```
+
+### Validation
+
+Validate service topologies statically:
+
+```typescript
+const errors = validate(topology);
+
+// Cross-validate multiple services
+const errors = validateTopologies([orderTopology, notificationTopology]);
+```
+
+### CloudEvents
+
+Parse and validate CloudEvents headers:
+
+```typescript
+const warnings = validateCEHeaders(headers);
+const metadata = metadataFromHeaders(headers);
+
+// Normalize AMQP prefixes (cloudEvents:type → ce-type)
+const normalized = normalizeCEHeaders(headers);
+
+// Enrich legacy messages without CE headers
+const enriched = enrichLegacyMetadata(metadata, deliveryInfo, () => crypto.randomUUID());
+```
+
+### Visualization
+
+Generate Mermaid diagrams:
+
+```typescript
+const diagram = mermaid([orderTopology, notificationTopology]);
+// Returns a Mermaid flowchart string
+```
+
+### Routing
+
+Match routing keys with AMQP-style wildcards:
+
+```typescript
+matchRoutingKey("Order.*", "Order.Created");   // true
+matchRoutingKey("Order.*", "Order.Item.Added"); // false
+routingKeyOverlaps("Order.*", "Order.Created"); // true
+```
+
+## API Reference
+
+### Naming Functions
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `topicExchangeName` | `(name: string) => string` | Topic exchange name |
+| `serviceEventQueueName` | `(exchange: string, service: string) => string` | Event consumer queue |
+| `serviceRequestExchangeName` | `(service: string) => string` | Request exchange |
+| `serviceResponseExchangeName` | `(service: string) => string` | Response exchange |
+| `serviceRequestQueueName` | `(service: string) => string` | Request queue |
+| `serviceResponseQueueName` | `(target: string, service: string) => string` | Response queue |
+| `natsStreamName` | `(name: string) => string` | NATS stream name |
+| `natsSubject` | `(stream: string, routingKey: string) => string` | NATS subject |
+| `translateWildcard` | `(routingKey: string) => string` | AMQP `#` to NATS `>` |
+
+### Validation Functions
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `validate` | `(topology: Topology) => string \| null` | Single-service validation |
+| `validateTopologies` | `(topologies: Topology[]) => string \| null` | Cross-service validation |
+
+### CloudEvents Functions
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `validateCEHeaders` | `(headers: Headers) => string[]` | Validate CE headers, returns warnings |
+| `metadataFromHeaders` | `(headers: Headers) => Metadata` | Parse headers into Metadata |
+| `normalizeCEHeaders` | `(headers: Headers) => Headers` | Normalize prefix to `ce-` |
+| `hasCEHeaders` | `(headers: Headers) => boolean` | Check if any CE headers present |
+| `enrichLegacyMetadata` | `(m: Metadata, d: DeliveryInfo, idGen: () => string) => Metadata` | Enrich missing fields |
+
+### Core Types
+
+```typescript
+type Transport = "amqp" | "nats";
+type EndpointDirection = "publish" | "consume";
+type ExchangeKind = "topic" | "direct" | "headers";
+type Pattern = "event-stream" | "custom-stream" | "service-request" | "service-response" | "queue-publish";
+
+interface Endpoint {
+  direction: EndpointDirection;
+  pattern: Pattern;
+  exchangeName: string;
+  exchangeKind: ExchangeKind;
+  queueName?: string;
+  routingKey?: string;
+  messageType?: string;
+  ephemeral?: boolean;
+}
+
+interface Topology {
+  transport: Transport;
+  serviceName: string;
+  endpoints: Endpoint[];
+}
+
+interface ConsumableEvent<T> extends Metadata {
+  deliveryInfo: DeliveryInfo;
+  payload: T;
+}
+```
+
+## Conformance
+
+This package is tested against the shared JSON fixtures in [`testdata/`](../testdata/). The same fixtures are used by the Go messaging library, ensuring both implementations produce identical outputs.
+
+```sh
+npm test
+```
+
+## License
+
+MIT

package/dist/cloudevents.d.ts

@@ -0,0 +1,73 @@
+import type { DeliveryInfo, Headers, Metadata } from "./types.js";
+/** CloudEvents attribute header keys for binary content mode (canonical "ce-" prefix). */
+export declare const CESpecVersion = "ce-specversion";
+export declare const CEType = "ce-type";
+export declare const CESource = "ce-source";
+export declare const CEID = "ce-id";
+export declare const CETime = "ce-time";
+export declare const CESpecVersionValue = "1.0";
+/** Optional CE attributes */
+export declare const CEDataContentType = "ce-datacontenttype";
+export declare const CESubject = "ce-subject";
+export declare const CEDataSchema = "ce-dataschema";
+/** Extension attribute for correlation */
+export declare const CECorrelationID = "ce-correlationid";
+/** Bare CE attribute names (without prefix). */
+export declare const CEAttrSpecVersion = "specversion";
+export declare const CEAttrType = "type";
+export declare const CEAttrSource = "source";
+export declare const CEAttrID = "id";
+export declare const CEAttrTime = "time";
+export declare const CEAttrDataContentType = "datacontenttype";
+export declare const CEAttrSubject = "subject";
+export declare const CEAttrCorrelationID = "correlationid";
+/** CERequiredAttributes lists header keys required by CE 1.0. */
+export declare const CERequiredAttributes: string[];
+/**
+ * AMQPCEHeaderKey returns the AMQP application-properties key for a bare
+ * CloudEvents attribute name, using the "cloudEvents:" prefix per the
+ * CloudEvents AMQP Protocol Binding specification.
+ * Example: AMQPCEHeaderKey("specversion") -> "cloudEvents:specversion"
+ */
+export declare function AMQPCEHeaderKey(attr: string): string;
+/**
+ * NormalizeCEHeaders rewrites incoming transport headers so that all
+ * CloudEvents attributes use the canonical "ce-" prefix. This allows
+ * consumers to accept messages with any known prefix variant:
+ *   - "cloudEvents:specversion" -> "ce-specversion"
+ *   - "cloudEvents_specversion" -> "ce-specversion"  (JMS compat)
+ *   - "ce-specversion" -> unchanged
+ *
+ * Non-CE headers are preserved unchanged. A new object is returned.
+ */
+export declare function normalizeCEHeaders(h: Headers): Headers;
+/**
+ * HasCEHeaders reports whether h contains at least one CE required attribute,
+ * checking for "ce-", "cloudEvents:", and "cloudEvents_" prefixes.
+ * Use this to distinguish legacy (pre-CloudEvents) messages from malformed CE messages.
+ */
+export declare function hasCEHeaders(h: Headers): boolean;
+/**
+ * EnrichLegacyMetadata populates empty Metadata fields with synthetic
+ * CloudEvents attributes derived from transport delivery information.
+ *
+ * Fields set when empty: id (randomUUID), timestamp (now), type (from key),
+ * source (from source), dataContentType ("application/json"), specVersion ("1.0").
+ *
+ * Fields NOT set: correlationId, subject (cannot be inferred).
+ * Any non-empty fields in m are preserved (not overwritten).
+ * Returns a new Metadata object; the input is not mutated.
+ */
+export declare function enrichLegacyMetadata(m: Metadata, info: DeliveryInfo): Metadata;
+/**
+ * MetadataFromHeaders extracts CloudEvents metadata from message headers
+ * into a Metadata struct. Invalid (non-RFC3339) timestamps return empty string.
+ */
+export declare function metadataFromHeaders(h: Headers): Metadata;
+/**
+ * ValidateCEHeaders checks that all required CloudEvents 1.0 attributes
+ * are present and are strings. Returns a list of warnings for any
+ * missing or non-string attributes.
+ */
+export declare function validateCEHeaders(h: Headers): string[];
+//# sourceMappingURL=cloudevents.d.ts.map

package/dist/cloudevents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudevents.d.ts","sourceRoot":"","sources":["../src/cloudevents.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAElE,0FAA0F;AAC1F,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAC9C,eAAO,MAAM,MAAM,YAAY,CAAC;AAChC,eAAO,MAAM,QAAQ,cAAc,CAAC;AACpC,eAAO,MAAM,IAAI,UAAU,CAAC;AAC5B,eAAO,MAAM,MAAM,YAAY,CAAC;AAChC,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB,uBAAuB,CAAC;AACtD,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,YAAY,kBAAkB,CAAC;AAE5C,0CAA0C;AAC1C,eAAO,MAAM,eAAe,qBAAqB,CAAC;AAElD,gDAAgD;AAChD,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAC/C,eAAO,MAAM,UAAU,SAAS,CAAC;AACjC,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,QAAQ,OAAO,CAAC;AAC7B,eAAO,MAAM,UAAU,SAAS,CAAC;AACjC,eAAO,MAAM,qBAAqB,oBAAoB,CAAC;AACvD,eAAO,MAAM,aAAa,YAAY,CAAC;AACvC,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AAEnD,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,UAMhC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAYtD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAWhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,QAAQ,EACX,IAAI,EAAE,YAAY,GACjB,QAAQ,CAUV;AAcD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,OAAO,GAAG,QAAQ,CAYxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,EAAE,CAYtD"}

package/dist/cloudevents.js

@@ -0,0 +1,148 @@
+// MIT License
+// Copyright (c) 2026 sparetimecoders
+/** CloudEvents attribute header keys for binary content mode (canonical "ce-" prefix). */
+export const CESpecVersion = "ce-specversion";
+export const CEType = "ce-type";
+export const CESource = "ce-source";
+export const CEID = "ce-id";
+export const CETime = "ce-time";
+export const CESpecVersionValue = "1.0";
+/** Optional CE attributes */
+export const CEDataContentType = "ce-datacontenttype";
+export const CESubject = "ce-subject";
+export const CEDataSchema = "ce-dataschema";
+/** Extension attribute for correlation */
+export const CECorrelationID = "ce-correlationid";
+/** Bare CE attribute names (without prefix). */
+export const CEAttrSpecVersion = "specversion";
+export const CEAttrType = "type";
+export const CEAttrSource = "source";
+export const CEAttrID = "id";
+export const CEAttrTime = "time";
+export const CEAttrDataContentType = "datacontenttype";
+export const CEAttrSubject = "subject";
+export const CEAttrCorrelationID = "correlationid";
+/** CERequiredAttributes lists header keys required by CE 1.0. */
+export const CERequiredAttributes = [
+    CESpecVersion,
+    CEType,
+    CESource,
+    CEID,
+    CETime,
+];
+/**
+ * AMQPCEHeaderKey returns the AMQP application-properties key for a bare
+ * CloudEvents attribute name, using the "cloudEvents:" prefix per the
+ * CloudEvents AMQP Protocol Binding specification.
+ * Example: AMQPCEHeaderKey("specversion") -> "cloudEvents:specversion"
+ */
+export function AMQPCEHeaderKey(attr) {
+    return "cloudEvents:" + attr;
+}
+/**
+ * NormalizeCEHeaders rewrites incoming transport headers so that all
+ * CloudEvents attributes use the canonical "ce-" prefix. This allows
+ * consumers to accept messages with any known prefix variant:
+ *   - "cloudEvents:specversion" -> "ce-specversion"
+ *   - "cloudEvents_specversion" -> "ce-specversion"  (JMS compat)
+ *   - "ce-specversion" -> unchanged
+ *
+ * Non-CE headers are preserved unchanged. A new object is returned.
+ */
+export function normalizeCEHeaders(h) {
+    const out = {};
+    for (const [k, v] of Object.entries(h)) {
+        if (k.startsWith("cloudEvents:")) {
+            out["ce-" + k.slice("cloudEvents:".length)] = v;
+        }
+        else if (k.startsWith("cloudEvents_")) {
+            out["ce-" + k.slice("cloudEvents_".length)] = v;
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+/**
+ * HasCEHeaders reports whether h contains at least one CE required attribute,
+ * checking for "ce-", "cloudEvents:", and "cloudEvents_" prefixes.
+ * Use this to distinguish legacy (pre-CloudEvents) messages from malformed CE messages.
+ */
+export function hasCEHeaders(h) {
+    for (const key of Object.keys(h)) {
+        if (key.startsWith("ce-") ||
+            key.startsWith("cloudEvents:") ||
+            key.startsWith("cloudEvents_")) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * EnrichLegacyMetadata populates empty Metadata fields with synthetic
+ * CloudEvents attributes derived from transport delivery information.
+ *
+ * Fields set when empty: id (randomUUID), timestamp (now), type (from key),
+ * source (from source), dataContentType ("application/json"), specVersion ("1.0").
+ *
+ * Fields NOT set: correlationId, subject (cannot be inferred).
+ * Any non-empty fields in m are preserved (not overwritten).
+ * Returns a new Metadata object; the input is not mutated.
+ */
+export function enrichLegacyMetadata(m, info) {
+    return {
+        ...m,
+        id: m.id || crypto.randomUUID(),
+        timestamp: m.timestamp || new Date().toISOString(),
+        type: m.type || info.key,
+        source: m.source || info.source,
+        dataContentType: m.dataContentType || "application/json",
+        specVersion: m.specVersion || CESpecVersionValue,
+    };
+}
+/** RFC 3339 regex for timestamp validation. */
+const RFC3339_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
+function headerString(h, key) {
+    const v = h[key];
+    if (typeof v === "string") {
+        return v;
+    }
+    return "";
+}
+/**
+ * MetadataFromHeaders extracts CloudEvents metadata from message headers
+ * into a Metadata struct. Invalid (non-RFC3339) timestamps return empty string.
+ */
+export function metadataFromHeaders(h) {
+    const timeStr = headerString(h, CETime);
+    return {
+        id: headerString(h, CEID),
+        source: headerString(h, CESource),
+        type: headerString(h, CEType),
+        subject: headerString(h, CESubject),
+        dataContentType: headerString(h, CEDataContentType),
+        specVersion: headerString(h, CESpecVersion),
+        correlationId: headerString(h, CECorrelationID),
+        timestamp: RFC3339_RE.test(timeStr) ? timeStr : "",
+    };
+}
+/**
+ * ValidateCEHeaders checks that all required CloudEvents 1.0 attributes
+ * are present and are strings. Returns a list of warnings for any
+ * missing or non-string attributes.
+ */
+export function validateCEHeaders(h) {
+    const warnings = [];
+    for (const key of CERequiredAttributes) {
+        if (!(key in h)) {
+            warnings.push(`missing required attribute "${key}"`);
+            continue;
+        }
+        if (typeof h[key] !== "string") {
+            warnings.push(`attribute "${key}" is not a string`);
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=cloudevents.js.map

package/dist/cloudevents.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export type { Transport, EndpointDirection, ExchangeKind, Pattern, Headers, Metadata, DeliveryInfo, ConsumableEvent, Endpoint, Topology, EventHandler, RequestResponseEventHandler, NotificationSource, Notification, ErrorNotification, NotificationHandler, ErrorNotificationHandler, } from "./types.js";
+export { ErrParseJSON } from "./types.js";
+export { DefaultEventExchangeName, KindTopic, KindDirect, KindHeaders, topicExchangeName, serviceEventQueueName, serviceRequestExchangeName, serviceResponseExchangeName, serviceRequestQueueName, serviceResponseQueueName, natsStreamName, natsSubject, translateWildcard, } from "./naming.js";
+export { CESpecVersion, CEType, CESource, CEID, CETime, CESpecVersionValue, CEDataContentType, CESubject, CEDataSchema, CECorrelationID, CEAttrSpecVersion, CEAttrType, CEAttrSource, CEAttrID, CEAttrTime, CEAttrDataContentType, CEAttrSubject, CEAttrCorrelationID, CERequiredAttributes, AMQPCEHeaderKey, normalizeCEHeaders, hasCEHeaders, enrichLegacyMetadata, metadataFromHeaders, validateCEHeaders, } from "./cloudevents.js";
+export { matchRoutingKey, routingKeyOverlaps } from "./routing.js";
+export { validate, validateTopologies } from "./validate.js";
+export { mermaid } from "./visualize.js";
+export {} from "./topology.js";
+export type { MetricsRecorder, RoutingKeyMapper, MetricsOptions } from "./metrics.js";
+export { mapRoutingKey } from "./metrics.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,OAAO,EACP,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,2BAA2B,EAC3B,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EACL,wBAAwB,EACxB,SAAS,EACT,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,aAAa,EACb,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,OAAO,EAAE,MAAM,eAAe,CAAC;AAG/B,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+// MIT License
+// Copyright (c) 2026 sparetimecoders
+export { ErrParseJSON } from "./types.js";
+// Naming
+export { DefaultEventExchangeName, KindTopic, KindDirect, KindHeaders, topicExchangeName, serviceEventQueueName, serviceRequestExchangeName, serviceResponseExchangeName, serviceRequestQueueName, serviceResponseQueueName, natsStreamName, natsSubject, translateWildcard, } from "./naming.js";
+// CloudEvents
+export { CESpecVersion, CEType, CESource, CEID, CETime, CESpecVersionValue, CEDataContentType, CESubject, CEDataSchema, CECorrelationID, CEAttrSpecVersion, CEAttrType, CEAttrSource, CEAttrID, CEAttrTime, CEAttrDataContentType, CEAttrSubject, CEAttrCorrelationID, CERequiredAttributes, AMQPCEHeaderKey, normalizeCEHeaders, hasCEHeaders, enrichLegacyMetadata, metadataFromHeaders, validateCEHeaders, } from "./cloudevents.js";
+// Routing
+export { matchRoutingKey, routingKeyOverlaps } from "./routing.js";
+// Validation
+export { validate, validateTopologies } from "./validate.js";
+// Visualization
+export { mermaid } from "./visualize.js";
+export { mapRoutingKey } from "./metrics.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,qCAAqC;AAsBrC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,SAAS;AACT,OAAO,EACL,wBAAwB,EACxB,SAAS,EACT,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,aAAa,CAAC;AAErB,cAAc;AACd,OAAO,EACL,aAAa,EACb,MAAM,EACN,QAAQ,EACR,IAAI,EACJ,MAAM,EACN,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,qBAAqB,EACrB,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEnE,aAAa;AACb,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE7D,gBAAgB;AAChB,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAOzC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/metrics.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pluggable metrics interface for messaging adapters.
+ *
+ * Users wire this to any metrics backend (prom-client, OpenTelemetry,
+ * StatsD, etc.) by implementing MetricsRecorder and passing it to
+ * ConnectionOptions.
+ */
+/** Records messaging metrics. Implement this interface to wire any metrics backend. */
+export interface MetricsRecorder {
+    /** An event was received from the broker. */
+    eventReceived(queue: string, routingKey: string): void;
+    /** An event was received but no handler matched its routing key. */
+    eventWithoutHandler(queue: string, routingKey: string): void;
+    /** An event could not be parsed (invalid JSON). */
+    eventNotParsable(queue: string, routingKey: string): void;
+    /** An event was acknowledged (successfully processed). */
+    eventAck(queue: string, routingKey: string, durationMs: number): void;
+    /** An event was negatively acknowledged (handler failed). */
+    eventNack(queue: string, routingKey: string, durationMs: number): void;
+    /** A message was published successfully. */
+    publishSucceed(exchange: string, routingKey: string, durationMs: number): void;
+    /** A message failed to publish. */
+    publishFailed(exchange: string, routingKey: string, durationMs: number): void;
+}
+/**
+ * Maps a routing key before it is passed to metrics.
+ * Use this to normalize or redact dynamic segments (e.g. UUIDs)
+ * to prevent unbounded label cardinality.
+ */
+export type RoutingKeyMapper = (key: string) => string;
+/** Options for configuring metrics behavior. */
+export interface MetricsOptions {
+    routingKeyMapper?: RoutingKeyMapper;
+}
+/**
+ * Apply a routing key mapper, defaulting to identity.
+ * Empty mapped values are replaced with "unknown".
+ */
+export declare function mapRoutingKey(key: string, mapper?: RoutingKeyMapper): string;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,uFAAuF;AACvF,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvD,oEAAoE;IACpE,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7D,mDAAmD;IACnD,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1D,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtE,6DAA6D;IAC7D,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvE,4CAA4C;IAC5C,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/E,mCAAmC;IACnC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/E;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;AAEvD,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,gBAAgB,GACxB,MAAM,CAGR"}

package/dist/metrics.js

@@ -0,0 +1,11 @@
+// MIT License
+// Copyright (c) 2026 sparetimecoders
+/**
+ * Apply a routing key mapper, defaulting to identity.
+ * Empty mapped values are replaced with "unknown".
+ */
+export function mapRoutingKey(key, mapper) {
+    const mapped = mapper ? mapper(key) : key;
+    return mapped === "" ? "unknown" : mapped;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,qCAAqC;AA8CrC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAW,EACX,MAAyB;IAEzB,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1C,OAAO,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AAC5C,CAAC"}

package/dist/naming.d.ts

@@ -0,0 +1,54 @@
+/** DefaultEventExchangeName is the default exchange name used for event streaming. */
+export declare const DefaultEventExchangeName = "events";
+/** Exchange kind constants matching AMQP exchange types. */
+export declare const KindTopic = "topic";
+export declare const KindDirect = "direct";
+export declare const KindHeaders = "headers";
+/**
+ * TopicExchangeName returns the topic exchange name for the given name.
+ * Format: `<name>.topic.exchange`
+ */
+export declare function topicExchangeName(name: string): string;
+/**
+ * ServiceEventQueueName returns the durable event queue name for a service.
+ * Format: `<exchangeName>.queue.<service>`
+ */
+export declare function serviceEventQueueName(exchangeName: string, service: string): string;
+/**
+ * ServiceRequestExchangeName returns the direct exchange name for requests to a service.
+ * Format: `<service>.direct.exchange.request`
+ */
+export declare function serviceRequestExchangeName(service: string): string;
+/**
+ * ServiceResponseExchangeName returns the headers exchange name for responses from a service.
+ * Format: `<service>.headers.exchange.response`
+ */
+export declare function serviceResponseExchangeName(service: string): string;
+/**
+ * ServiceRequestQueueName returns the queue name for requests to a service.
+ * Format: `<service>.direct.exchange.request.queue`
+ */
+export declare function serviceRequestQueueName(service: string): string;
+/**
+ * ServiceResponseQueueName returns the queue name for responses from targetService to serviceName.
+ * Format: `<targetService>.headers.exchange.response.queue.<serviceName>`
+ */
+export declare function serviceResponseQueueName(targetService: string, serviceName: string): string;
+/**
+ * NATSStreamName extracts the base stream name from a logical name.
+ * If the name follows the AMQP convention `<name>.topic.exchange`, the prefix is extracted.
+ * Otherwise the name is returned as-is.
+ */
+export declare function natsStreamName(name: string): string;
+/**
+ * NATSSubject builds a NATS subject from a stream name and routing key.
+ * Format: `<stream>.<routingKey>`
+ */
+export declare function natsSubject(stream: string, routingKey: string): string;
+/**
+ * TranslateWildcard converts AMQP-style wildcards to NATS-style wildcards.
+ * AMQP "#" (multi-level) -> NATS ">" (multi-level)
+ * AMQP "*" (single-level) stays "*" in NATS.
+ */
+export declare function translateWildcard(routingKey: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAGA,sFAAsF;AACtF,eAAO,MAAM,wBAAwB,WAAW,CAAC;AAEjD,4DAA4D;AAC5D,eAAO,MAAM,SAAS,UAAU,CAAC;AACjC,eAAO,MAAM,UAAU,WAAW,CAAC;AACnC,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5D"}

package/dist/naming.js

@@ -0,0 +1,78 @@
+// MIT License
+// Copyright (c) 2026 sparetimecoders
+/** DefaultEventExchangeName is the default exchange name used for event streaming. */
+export const DefaultEventExchangeName = "events";
+/** Exchange kind constants matching AMQP exchange types. */
+export const KindTopic = "topic";
+export const KindDirect = "direct";
+export const KindHeaders = "headers";
+/**
+ * TopicExchangeName returns the topic exchange name for the given name.
+ * Format: `<name>.topic.exchange`
+ */
+export function topicExchangeName(name) {
+    return `${name}.${KindTopic}.exchange`;
+}
+/**
+ * ServiceEventQueueName returns the durable event queue name for a service.
+ * Format: `<exchangeName>.queue.<service>`
+ */
+export function serviceEventQueueName(exchangeName, service) {
+    return `${exchangeName}.queue.${service}`;
+}
+/**
+ * ServiceRequestExchangeName returns the direct exchange name for requests to a service.
+ * Format: `<service>.direct.exchange.request`
+ */
+export function serviceRequestExchangeName(service) {
+    return `${service}.${KindDirect}.exchange.request`;
+}
+/**
+ * ServiceResponseExchangeName returns the headers exchange name for responses from a service.
+ * Format: `<service>.headers.exchange.response`
+ */
+export function serviceResponseExchangeName(service) {
+    return `${service}.${KindHeaders}.exchange.response`;
+}
+/**
+ * ServiceRequestQueueName returns the queue name for requests to a service.
+ * Format: `<service>.direct.exchange.request.queue`
+ */
+export function serviceRequestQueueName(service) {
+    return `${serviceRequestExchangeName(service)}.queue`;
+}
+/**
+ * ServiceResponseQueueName returns the queue name for responses from targetService to serviceName.
+ * Format: `<targetService>.headers.exchange.response.queue.<serviceName>`
+ */
+export function serviceResponseQueueName(targetService, serviceName) {
+    return `${serviceResponseExchangeName(targetService)}.queue.${serviceName}`;
+}
+/**
+ * NATSStreamName extracts the base stream name from a logical name.
+ * If the name follows the AMQP convention `<name>.topic.exchange`, the prefix is extracted.
+ * Otherwise the name is returned as-is.
+ */
+export function natsStreamName(name) {
+    const suffix = ".topic.exchange";
+    if (name.endsWith(suffix)) {
+        return name.slice(0, -suffix.length);
+    }
+    return name;
+}
+/**
+ * NATSSubject builds a NATS subject from a stream name and routing key.
+ * Format: `<stream>.<routingKey>`
+ */
+export function natsSubject(stream, routingKey) {
+    return `${stream}.${routingKey}`;
+}
+/**
+ * TranslateWildcard converts AMQP-style wildcards to NATS-style wildcards.
+ * AMQP "#" (multi-level) -> NATS ">" (multi-level)
+ * AMQP "*" (single-level) stays "*" in NATS.
+ */
+export function translateWildcard(routingKey) {
+    return routingKey.replaceAll("#", ">");
+}
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,qCAAqC;AAErC,sFAAsF;AACtF,MAAM,CAAC,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AAEjD,4DAA4D;AAC5D,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC;AACjC,MAAM,CAAC,MAAM,UAAU,GAAG,QAAQ,CAAC;AACnC,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,GAAG,IAAI,IAAI,SAAS,WAAW,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAoB,EACpB,OAAe;IAEf,OAAO,GAAG,YAAY,UAAU,OAAO,EAAE,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAe;IACxD,OAAO,GAAG,OAAO,IAAI,UAAU,mBAAmB,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,OAAe;IACzD,OAAO,GAAG,OAAO,IAAI,WAAW,oBAAoB,CAAC;AACvD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,GAAG,0BAA0B,CAAC,OAAO,CAAC,QAAQ,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,aAAqB,EACrB,WAAmB;IAEnB,OAAO,GAAG,2BAA2B,CAAC,aAAa,CAAC,UAAU,WAAW,EAAE,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,MAAM,GAAG,iBAAiB,CAAC;IACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,UAAkB;IAC5D,OAAO,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;AACnC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC"}