@relaybus/rabbitmq 0.2.0 → 0.3.1

package/dist/index.d.cts

@@ -1,5 +1,7 @@
 import { EventEmitter } from 'node:events';
-import { NonRetryableError, RelayBusError, EventHeaders, EventEnvelope, RetryPolicyOptions, Duration, RelayBusLogger, Transport, TransportMessageHandler } from '@relaybus/core';
+import { NonRetryableError, RelayBusError, EventHeaders, EventEnvelope, RetryPolicyOptions, Duration, RelayBusLogger, CloseOptions } from '@relaybus/core';
+import { JsonEnvelopeMapping, SubscribingTransport, TransportSubscription } from '@relaybus/core/internal';
+export { fromHeader, fromPayloadField } from '@relaybus/core/internal';
 
 /**
  * The slice of amqplib this package relies on. Declaring it here keeps the
@@ -74,18 +76,26 @@ interface AmqpConnection extends EventEmitter {
  * Always retryable; the outbox keeps the delivery and tries again.
  */
 declare class RabbitMqUnavailableError extends RelayBusError {
+    name: string;
+    readonly code: string;
 }
 /** The broker negatively acknowledged a published message. Retryable. */
 declare class RabbitMqPublishRejectedError extends RelayBusError {
+    name: string;
+    readonly code: string;
 }
 /**
  * The broker accepted the message but no queue is bound to its routing key, so
  * it would have been discarded. Retryable: it succeeds once a consumer binds.
  */
 declare class UnroutableMessageError extends RelayBusError {
+    name: string;
+    readonly code: string;
 }
 /** A received message is not a valid relaybus CloudEvent. It is dead-lettered. */
 declare class MalformedMessageError extends RelayBusError {
+    name: string;
+    readonly code: string;
 }
 /**
  * The payload of an event cannot be represented as JSON without losing or
@@ -94,6 +104,7 @@ declare class MalformedMessageError extends RelayBusError {
  */
 declare class UnserializablePayloadError extends NonRetryableError {
     name: string;
+    readonly code: string;
 }
 /**
  * A value exceeds a protocol limit of AMQP 0-9-1, for example an event id or a
@@ -101,6 +112,15 @@ declare class UnserializablePayloadError extends NonRetryableError {
  */
 declare class AmqpLimitExceededError extends NonRetryableError {
     name: string;
+    readonly code: string;
+}
+/**
+ * An event the configured codec cannot write: a header name the format
+ * reserves, or a type a fixed-type route does not carry. Never retried.
+ */
+declare class RabbitMqUnencodableEventError extends NonRetryableError {
+    name: string;
+    readonly code: string;
 }
 
 /**
@@ -210,6 +230,73 @@ declare function decodeCloudEvent(message: AmqpMessage): EventEnvelope;
  */
 declare function plainJsonDecoder(options: PlainJsonDecoderOptions): RabbitMqMessageDecoder;
 
+/** A serialized event, ready for `channel.publish`. */
+interface EncodedMessage {
+    readonly content: Buffer;
+    readonly options: AmqpPublishOptions;
+}
+
+/**
+ * The wire format of a {@link RabbitMqTransport}: how an event becomes a
+ * message (`encode`, on publish) and a consumed message becomes an event
+ * (`decode`).
+ *
+ * Both must be synchronous and free of side effects. What `encode` throws
+ * fails the publish: the outbox retries it, unless it is a `NonRetryableError`
+ * such as {@link RabbitMqUnencodableEventError}. Give every message a
+ * `messageId`: the transport matches broker returns of unroutable messages by
+ * it. What `decode` throws marks the message as malformed: it is
+ * dead-lettered and the consumer moves on. See {@link RabbitMqMessageDecoder}
+ * for the decode contract.
+ */
+interface RabbitMqCodec {
+    readonly encode: (envelope: EventEnvelope) => EncodedMessage;
+    readonly decode: RabbitMqMessageDecoder;
+}
+/**
+ * CloudEvents 1.0 binary content mode, the default: the body is the JSON
+ * payload, the attributes travel as `cloudEvents:*` headers mirrored in the
+ * AMQP properties. Decoding is strict: any other message is malformed.
+ */
+declare const cloudEventsBinary: RabbitMqCodec;
+/**
+ * CloudEvents 1.0 structured content mode: the body is one
+ * `application/cloudevents+json` document with the attributes and `data`.
+ * Decoding accepts structured and binary mode ({@link decodeCloudEvent}).
+ * Event headers travel under their own names; names starting with `x-death`,
+ * `x-first-death-`, `x-last-death-` or `x-relaybus-` are refused.
+ */
+declare const cloudEventsStructured: RabbitMqCodec;
+/**
+ * Where each value of a JSON message lives, for {@link jsonEnvelope}. Besides
+ * `{ body }` and `{ header }`, the id may be `'message-id-property'`: the
+ * AMQP `messageId` property, which the codec always writes and which survives
+ * redeliveries; a message without one is malformed.
+ */
+type RabbitMqJsonEnvelopeMapping = JsonEnvelopeMapping<'message-id-property'>;
+/**
+ * A JSON wire format declared by a mapping, in both directions: for queues
+ * shared with services that wrap events in their own envelope
+ * (`{ "eventName": ..., "data": {...} }`, MassTransit) or send the bare
+ * payload. Every message also gets the AMQP properties of binary mode:
+ * `messageId` (the event id), `type`, `appId` (the source), `correlationId`,
+ * `timestamp` (seconds) and `persistent`. Event
+ * headers that are message headers are written as they are, so a name the
+ * mapping uses for another field, or one the broker reserves, is refused
+ * with {@link RabbitMqUnencodableEventError}.
+ *
+ * ```ts
+ * codec: jsonEnvelope({
+ *   type: { body: 'eventName' },
+ *   id: 'message-id-property',
+ *   payload: { body: 'data' },
+ * })
+ * ```
+ *
+ * @throws ConfigurationError for an incomplete or self-overlapping mapping.
+ */
+declare function jsonEnvelope(mapping: RabbitMqJsonEnvelopeMapping): RabbitMqCodec;
+
 /** Connection settings accepted by `amqplib.connect`, given as an object instead of a URL. */
 interface BrokerConnectionSettings {
     readonly protocol?: string;
@@ -246,9 +333,11 @@ interface RabbitMqTransportOptions {
     readonly url?: string | BrokerConnectionSettings;
     /**
      * Opens one connection. Called again after every connection loss. Use it for
-     * TLS options, custom credentials or an alternative amqplib instance.
+     * TLS options, custom credentials or an alternative amqplib instance. `signal` aborts when a
+     * shutdown runs past its deadline: pass it on (`amqplib.connect(url, { signal })`) so a broker
+     * that never answers the handshake cannot hold the socket open.
      */
-    readonly connect?: () => Promise<AmqpConnection>;
+    readonly connect?: (options: ConnectOptions) => Promise<AmqpConnection>;
     /** Topic exchange events are published to. Durable, created when missing. Default `'relaybus'`. */
     readonly exchange?: string;
     /**
@@ -317,22 +406,35 @@ interface RabbitMqTransportOptions {
     /** How long `close` waits for running handlers. Default `'30s'`. */
     readonly shutdownTimeout?: Duration;
     /**
-     * How consumed messages become events. Default: CloudEvents binary mode as
-     * relaybus producers write it (`cloudEvents:*` headers, AMQP properties as
-     * fallback); any other message is malformed and dead-lettered. Set it to
-     * consume messages from services that do not use relaybus:
-     * {@link decodeCloudEvent} also accepts structured mode, {@link plainJsonDecoder}
-     * maps plain JSON messages, and a function of your own can do anything else
-     * (switch on `message.fields.routingKey` to decode routing keys differently).
-     * Whatever a decoder throws marks the message as malformed: it is
+     * The wire format, both ways: how events become messages and consumed
+     * messages become events. Default {@link cloudEventsBinary}: CloudEvents
+     * binary mode (`cloudEvents:*` headers, AMQP properties as fallback), any
+     * other message is malformed and dead-lettered. {@link cloudEventsStructured}
+     * writes structured mode and reads both, {@link jsonEnvelope} maps a JSON
+     * format of your own (an envelope with the payload inside, or the bare
+     * payload), and an object with `encode` and `decode` can do anything else.
+     * Whatever `decode` throws marks the message as malformed: it is
      * dead-lettered, the consumer keeps running.
      */
+    readonly codec?: RabbitMqCodec;
+    /**
+     * How consumed messages become events; events are still written in
+     * CloudEvents binary mode.
+     *
+     * @deprecated Use `codec`: `decode: fn` is `codec: { encode: encodeEnvelope, decode: fn }`.
+     * Giving both `decode` and `codec` is a configuration error.
+     */
     readonly decode?: RabbitMqMessageDecoder;
     /** Default: `console`. */
     readonly logger?: RelayBusLogger;
     /** Random source for jitter. Default `Math.random`. Intended for tests. */
     readonly random?: () => number;
 }
+/** What `connect` gets for each connection it opens. */
+interface ConnectOptions {
+    /** Aborted when a shutdown runs past its deadline; destroys a socket still connecting. */
+    readonly signal: AbortSignal;
+}
 
 /**
  * RabbitMQ {@link Transport} built on amqplib.
@@ -356,9 +458,10 @@ interface RabbitMqTransportOptions {
  * consumer. Events published meanwhile are rejected, and therefore retried by
  * the outbox, rather than buffered in memory.
  */
-declare class RabbitMqTransport implements Transport {
+declare class RabbitMqTransport extends SubscribingTransport {
     #private;
     readonly name: string;
+    readonly system = "rabbitmq";
     constructor(options: RabbitMqTransportOptions);
     /**
      * True while the connection is open and publishing and consuming are set up.
@@ -381,6 +484,7 @@ declare class RabbitMqTransport implements Transport {
      * @throws {RabbitMqUnavailableError} not connected, channel lost, or confirm timed out
      * @throws {RabbitMqPublishRejectedError} the broker nacked the message
      * @throws {UnroutableMessageError} no queue is bound to `destination` (unless `allowUnroutable`)
+     * @throws whatever the `codec`'s `encode` throws, such as {@link RabbitMqUnencodableEventError}
      */
     publish(envelope: EventEnvelope, destination: string): Promise<void>;
     /**
@@ -388,42 +492,14 @@ declare class RabbitMqTransport implements Transport {
      * to `onMessage`. Call it once per transport; give each subscription its own
      * transport instance, with its own `name` and `consumerGroup`.
      */
-    subscribe(destinations: readonly string[], onMessage: TransportMessageHandler): Promise<void>;
+    protected openSubscription({ destinations, onMessage, hooks, }: TransportSubscription): Promise<void>;
     /**
      * Stops consuming, waits up to `shutdownTimeout` for running handlers
      * (messages still being retried go back to the queue), then closes the
-     * channels and the connection.
+     * channels and the connection. Once `options.signal` aborts (the bus shutdown deadline passed),
+     * the connection's socket is destroyed instead of waiting for the broker.
      */
-    close(): Promise<void>;
+    close(options?: CloseOptions): Promise<void>;
 }
 
-/**
- * Reads one header of an incoming message, for the `type`, `id`, `key` or
- * `source` option of {@link plainJsonDecoder}. Header names are compared
- * exactly (AMQP header names are case-sensitive). Returns undefined when the
- * header is absent, so the decoder falls back to its default.
- *
- * ```ts
- * plainJsonDecoder({ type: fromHeader('event-type'), id: fromHeader('message-id') })
- * ```
- */
-declare function fromHeader(name: string): (message: {
-    readonly headers: EventHeaders;
-}) => string | undefined;
-/**
- * Reads a field of the JSON payload by a dotted path (`'meta.eventType'`), for
- * the `type`, `id`, `key` or `source` option of {@link plainJsonDecoder}. A
- * string is returned as is and a safe integer as its decimal text (numeric ids
- * are common). Anything else returns undefined so the decoder falls back to its
- * default: a missing field, and also a fraction or an integer beyond 2^53, which
- * JSON parsing may already have rounded, so two different ids could collide.
- *
- * ```ts
- * plainJsonDecoder({ type: fromPayloadField('eventType'), key: fromPayloadField('order.id') })
- * ```
- */
-declare function fromPayloadField(path: string): (message: {
-    readonly payload: unknown;
-}) => string | undefined;
-
-export { type AmqpChannel, type AmqpConfirmChannel, type AmqpConnection, AmqpLimitExceededError, type AmqpMessage, type AmqpMessageProperties, type AmqpPublishOptions, type BrokerConnectionSettings, type DecodedEvent, MalformedMessageError, type PlainJsonDecoderOptions, type PlainJsonMessage, type RabbitMqMessageDecoder, RabbitMqPublishRejectedError, RabbitMqTransport, type RabbitMqTransportOptions, RabbitMqUnavailableError, type ReconnectOptions, type RedeliveryOptions, UnroutableMessageError, UnserializablePayloadError, decodeCloudEvent, fromHeader, fromPayloadField, plainJsonDecoder };
+export { type AmqpChannel, type AmqpConfirmChannel, type AmqpConnection, AmqpLimitExceededError, type AmqpMessage, type AmqpMessageProperties, type AmqpPublishOptions, type BrokerConnectionSettings, type DecodedEvent, type EncodedMessage, MalformedMessageError, type PlainJsonDecoderOptions, type PlainJsonMessage, type RabbitMqCodec, type RabbitMqJsonEnvelopeMapping, type RabbitMqMessageDecoder, RabbitMqPublishRejectedError, RabbitMqTransport, type RabbitMqTransportOptions, RabbitMqUnavailableError, RabbitMqUnencodableEventError, type ReconnectOptions, type RedeliveryOptions, UnroutableMessageError, UnserializablePayloadError, cloudEventsBinary, cloudEventsStructured, decodeCloudEvent, jsonEnvelope, plainJsonDecoder };

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { EventEmitter } from 'node:events';
-import { NonRetryableError, RelayBusError, EventHeaders, EventEnvelope, RetryPolicyOptions, Duration, RelayBusLogger, Transport, TransportMessageHandler } from '@relaybus/core';
+import { NonRetryableError, RelayBusError, EventHeaders, EventEnvelope, RetryPolicyOptions, Duration, RelayBusLogger, CloseOptions } from '@relaybus/core';
+import { JsonEnvelopeMapping, SubscribingTransport, TransportSubscription } from '@relaybus/core/internal';
+export { fromHeader, fromPayloadField } from '@relaybus/core/internal';
 
 /**
  * The slice of amqplib this package relies on. Declaring it here keeps the
@@ -74,18 +76,26 @@ interface AmqpConnection extends EventEmitter {
  * Always retryable; the outbox keeps the delivery and tries again.
  */
 declare class RabbitMqUnavailableError extends RelayBusError {
+    name: string;
+    readonly code: string;
 }
 /** The broker negatively acknowledged a published message. Retryable. */
 declare class RabbitMqPublishRejectedError extends RelayBusError {
+    name: string;
+    readonly code: string;
 }
 /**
  * The broker accepted the message but no queue is bound to its routing key, so
  * it would have been discarded. Retryable: it succeeds once a consumer binds.
  */
 declare class UnroutableMessageError extends RelayBusError {
+    name: string;
+    readonly code: string;
 }
 /** A received message is not a valid relaybus CloudEvent. It is dead-lettered. */
 declare class MalformedMessageError extends RelayBusError {
+    name: string;
+    readonly code: string;
 }
 /**
  * The payload of an event cannot be represented as JSON without losing or
@@ -94,6 +104,7 @@ declare class MalformedMessageError extends RelayBusError {
  */
 declare class UnserializablePayloadError extends NonRetryableError {
     name: string;
+    readonly code: string;
 }
 /**
  * A value exceeds a protocol limit of AMQP 0-9-1, for example an event id or a
@@ -101,6 +112,15 @@ declare class UnserializablePayloadError extends NonRetryableError {
  */
 declare class AmqpLimitExceededError extends NonRetryableError {
     name: string;
+    readonly code: string;
+}
+/**
+ * An event the configured codec cannot write: a header name the format
+ * reserves, or a type a fixed-type route does not carry. Never retried.
+ */
+declare class RabbitMqUnencodableEventError extends NonRetryableError {
+    name: string;
+    readonly code: string;
 }
 
 /**
@@ -210,6 +230,73 @@ declare function decodeCloudEvent(message: AmqpMessage): EventEnvelope;
  */
 declare function plainJsonDecoder(options: PlainJsonDecoderOptions): RabbitMqMessageDecoder;
 
+/** A serialized event, ready for `channel.publish`. */
+interface EncodedMessage {
+    readonly content: Buffer;
+    readonly options: AmqpPublishOptions;
+}
+
+/**
+ * The wire format of a {@link RabbitMqTransport}: how an event becomes a
+ * message (`encode`, on publish) and a consumed message becomes an event
+ * (`decode`).
+ *
+ * Both must be synchronous and free of side effects. What `encode` throws
+ * fails the publish: the outbox retries it, unless it is a `NonRetryableError`
+ * such as {@link RabbitMqUnencodableEventError}. Give every message a
+ * `messageId`: the transport matches broker returns of unroutable messages by
+ * it. What `decode` throws marks the message as malformed: it is
+ * dead-lettered and the consumer moves on. See {@link RabbitMqMessageDecoder}
+ * for the decode contract.
+ */
+interface RabbitMqCodec {
+    readonly encode: (envelope: EventEnvelope) => EncodedMessage;
+    readonly decode: RabbitMqMessageDecoder;
+}
+/**
+ * CloudEvents 1.0 binary content mode, the default: the body is the JSON
+ * payload, the attributes travel as `cloudEvents:*` headers mirrored in the
+ * AMQP properties. Decoding is strict: any other message is malformed.
+ */
+declare const cloudEventsBinary: RabbitMqCodec;
+/**
+ * CloudEvents 1.0 structured content mode: the body is one
+ * `application/cloudevents+json` document with the attributes and `data`.
+ * Decoding accepts structured and binary mode ({@link decodeCloudEvent}).
+ * Event headers travel under their own names; names starting with `x-death`,
+ * `x-first-death-`, `x-last-death-` or `x-relaybus-` are refused.
+ */
+declare const cloudEventsStructured: RabbitMqCodec;
+/**
+ * Where each value of a JSON message lives, for {@link jsonEnvelope}. Besides
+ * `{ body }` and `{ header }`, the id may be `'message-id-property'`: the
+ * AMQP `messageId` property, which the codec always writes and which survives
+ * redeliveries; a message without one is malformed.
+ */
+type RabbitMqJsonEnvelopeMapping = JsonEnvelopeMapping<'message-id-property'>;
+/**
+ * A JSON wire format declared by a mapping, in both directions: for queues
+ * shared with services that wrap events in their own envelope
+ * (`{ "eventName": ..., "data": {...} }`, MassTransit) or send the bare
+ * payload. Every message also gets the AMQP properties of binary mode:
+ * `messageId` (the event id), `type`, `appId` (the source), `correlationId`,
+ * `timestamp` (seconds) and `persistent`. Event
+ * headers that are message headers are written as they are, so a name the
+ * mapping uses for another field, or one the broker reserves, is refused
+ * with {@link RabbitMqUnencodableEventError}.
+ *
+ * ```ts
+ * codec: jsonEnvelope({
+ *   type: { body: 'eventName' },
+ *   id: 'message-id-property',
+ *   payload: { body: 'data' },
+ * })
+ * ```
+ *
+ * @throws ConfigurationError for an incomplete or self-overlapping mapping.
+ */
+declare function jsonEnvelope(mapping: RabbitMqJsonEnvelopeMapping): RabbitMqCodec;
+
 /** Connection settings accepted by `amqplib.connect`, given as an object instead of a URL. */
 interface BrokerConnectionSettings {
     readonly protocol?: string;
@@ -246,9 +333,11 @@ interface RabbitMqTransportOptions {
     readonly url?: string | BrokerConnectionSettings;
     /**
      * Opens one connection. Called again after every connection loss. Use it for
-     * TLS options, custom credentials or an alternative amqplib instance.
+     * TLS options, custom credentials or an alternative amqplib instance. `signal` aborts when a
+     * shutdown runs past its deadline: pass it on (`amqplib.connect(url, { signal })`) so a broker
+     * that never answers the handshake cannot hold the socket open.
      */
-    readonly connect?: () => Promise<AmqpConnection>;
+    readonly connect?: (options: ConnectOptions) => Promise<AmqpConnection>;
     /** Topic exchange events are published to. Durable, created when missing. Default `'relaybus'`. */
     readonly exchange?: string;
     /**
@@ -317,22 +406,35 @@ interface RabbitMqTransportOptions {
     /** How long `close` waits for running handlers. Default `'30s'`. */
     readonly shutdownTimeout?: Duration;
     /**
-     * How consumed messages become events. Default: CloudEvents binary mode as
-     * relaybus producers write it (`cloudEvents:*` headers, AMQP properties as
-     * fallback); any other message is malformed and dead-lettered. Set it to
-     * consume messages from services that do not use relaybus:
-     * {@link decodeCloudEvent} also accepts structured mode, {@link plainJsonDecoder}
-     * maps plain JSON messages, and a function of your own can do anything else
-     * (switch on `message.fields.routingKey` to decode routing keys differently).
-     * Whatever a decoder throws marks the message as malformed: it is
+     * The wire format, both ways: how events become messages and consumed
+     * messages become events. Default {@link cloudEventsBinary}: CloudEvents
+     * binary mode (`cloudEvents:*` headers, AMQP properties as fallback), any
+     * other message is malformed and dead-lettered. {@link cloudEventsStructured}
+     * writes structured mode and reads both, {@link jsonEnvelope} maps a JSON
+     * format of your own (an envelope with the payload inside, or the bare
+     * payload), and an object with `encode` and `decode` can do anything else.
+     * Whatever `decode` throws marks the message as malformed: it is
      * dead-lettered, the consumer keeps running.
      */
+    readonly codec?: RabbitMqCodec;
+    /**
+     * How consumed messages become events; events are still written in
+     * CloudEvents binary mode.
+     *
+     * @deprecated Use `codec`: `decode: fn` is `codec: { encode: encodeEnvelope, decode: fn }`.
+     * Giving both `decode` and `codec` is a configuration error.
+     */
     readonly decode?: RabbitMqMessageDecoder;
     /** Default: `console`. */
     readonly logger?: RelayBusLogger;
     /** Random source for jitter. Default `Math.random`. Intended for tests. */
     readonly random?: () => number;
 }
+/** What `connect` gets for each connection it opens. */
+interface ConnectOptions {
+    /** Aborted when a shutdown runs past its deadline; destroys a socket still connecting. */
+    readonly signal: AbortSignal;
+}
 
 /**
  * RabbitMQ {@link Transport} built on amqplib.
@@ -356,9 +458,10 @@ interface RabbitMqTransportOptions {
  * consumer. Events published meanwhile are rejected, and therefore retried by
  * the outbox, rather than buffered in memory.
  */
-declare class RabbitMqTransport implements Transport {
+declare class RabbitMqTransport extends SubscribingTransport {
     #private;
     readonly name: string;
+    readonly system = "rabbitmq";
     constructor(options: RabbitMqTransportOptions);
     /**
      * True while the connection is open and publishing and consuming are set up.
@@ -381,6 +484,7 @@ declare class RabbitMqTransport implements Transport {
      * @throws {RabbitMqUnavailableError} not connected, channel lost, or confirm timed out
      * @throws {RabbitMqPublishRejectedError} the broker nacked the message
      * @throws {UnroutableMessageError} no queue is bound to `destination` (unless `allowUnroutable`)
+     * @throws whatever the `codec`'s `encode` throws, such as {@link RabbitMqUnencodableEventError}
      */
     publish(envelope: EventEnvelope, destination: string): Promise<void>;
     /**
@@ -388,42 +492,14 @@ declare class RabbitMqTransport implements Transport {
      * to `onMessage`. Call it once per transport; give each subscription its own
      * transport instance, with its own `name` and `consumerGroup`.
      */
-    subscribe(destinations: readonly string[], onMessage: TransportMessageHandler): Promise<void>;
+    protected openSubscription({ destinations, onMessage, hooks, }: TransportSubscription): Promise<void>;
     /**
      * Stops consuming, waits up to `shutdownTimeout` for running handlers
      * (messages still being retried go back to the queue), then closes the
-     * channels and the connection.
+     * channels and the connection. Once `options.signal` aborts (the bus shutdown deadline passed),
+     * the connection's socket is destroyed instead of waiting for the broker.
      */
-    close(): Promise<void>;
+    close(options?: CloseOptions): Promise<void>;
 }
 
-/**
- * Reads one header of an incoming message, for the `type`, `id`, `key` or
- * `source` option of {@link plainJsonDecoder}. Header names are compared
- * exactly (AMQP header names are case-sensitive). Returns undefined when the
- * header is absent, so the decoder falls back to its default.
- *
- * ```ts
- * plainJsonDecoder({ type: fromHeader('event-type'), id: fromHeader('message-id') })
- * ```
- */
-declare function fromHeader(name: string): (message: {
-    readonly headers: EventHeaders;
-}) => string | undefined;
-/**
- * Reads a field of the JSON payload by a dotted path (`'meta.eventType'`), for
- * the `type`, `id`, `key` or `source` option of {@link plainJsonDecoder}. A
- * string is returned as is and a safe integer as its decimal text (numeric ids
- * are common). Anything else returns undefined so the decoder falls back to its
- * default: a missing field, and also a fraction or an integer beyond 2^53, which
- * JSON parsing may already have rounded, so two different ids could collide.
- *
- * ```ts
- * plainJsonDecoder({ type: fromPayloadField('eventType'), key: fromPayloadField('order.id') })
- * ```
- */
-declare function fromPayloadField(path: string): (message: {
-    readonly payload: unknown;
-}) => string | undefined;
-
-export { type AmqpChannel, type AmqpConfirmChannel, type AmqpConnection, AmqpLimitExceededError, type AmqpMessage, type AmqpMessageProperties, type AmqpPublishOptions, type BrokerConnectionSettings, type DecodedEvent, MalformedMessageError, type PlainJsonDecoderOptions, type PlainJsonMessage, type RabbitMqMessageDecoder, RabbitMqPublishRejectedError, RabbitMqTransport, type RabbitMqTransportOptions, RabbitMqUnavailableError, type ReconnectOptions, type RedeliveryOptions, UnroutableMessageError, UnserializablePayloadError, decodeCloudEvent, fromHeader, fromPayloadField, plainJsonDecoder };
+export { type AmqpChannel, type AmqpConfirmChannel, type AmqpConnection, AmqpLimitExceededError, type AmqpMessage, type AmqpMessageProperties, type AmqpPublishOptions, type BrokerConnectionSettings, type DecodedEvent, type EncodedMessage, MalformedMessageError, type PlainJsonDecoderOptions, type PlainJsonMessage, type RabbitMqCodec, type RabbitMqJsonEnvelopeMapping, type RabbitMqMessageDecoder, RabbitMqPublishRejectedError, RabbitMqTransport, type RabbitMqTransportOptions, RabbitMqUnavailableError, RabbitMqUnencodableEventError, type ReconnectOptions, type RedeliveryOptions, UnroutableMessageError, UnserializablePayloadError, cloudEventsBinary, cloudEventsStructured, decodeCloudEvent, jsonEnvelope, plainJsonDecoder };