@outbox-event-bus/rabbitmq-publisher 1.0.0

package/README.md

@@ -0,0 +1,152 @@
+# RabbitMQ Publisher
+
+![npm version](https://img.shields.io/npm/v/@outbox-event-bus/rabbitmq-publisher?style=flat-square&color=2563eb)
+![license](https://img.shields.io/npm/l/@outbox-event-bus/rabbitmq-publisher?style=flat-square&color=2563eb)
+
+> **Enterprise-Grade Message Routing**
+
+RabbitMQ (AMQP) publisher for [outbox-event-bus](https://github.com/dunika/outbox-event-bus#readme). Forwards events to RabbitMQ exchanges with intelligent routing and configurable retries.
+
+```typescript
+import { RabbitMQPublisher } from '@outbox-event-bus/rabbitmq-publisher';
+
+const publisher = new RabbitMQPublisher(bus, {
+  channel: amqpChannel,
+  exchange: 'events-exchange',
+  routingKey: 'my-app.events' // Optional
+});
+
+publisher.subscribe(['user.created']);
+```
+
+## When to Use
+
+**Choose RabbitMQ Publisher when:**
+- You need **complex routing** (fanout, topic, direct).
+- You require **message prioritization**.
+- You want to use **standard AMQP** protocols.
+- You need to integrate with heterogeneous systems that support RabbitMQ.
+
+**Consider alternatives when:**
+- You want a **fully managed serverless service** (use AWS SNS/EventBridge).
+- You need **distributed log streaming** (use Kafka).
+- You want the **simplest possible setup** (use Redis Streams).
+
+## Installation
+
+```bash
+npm install @outbox-event-bus/rabbitmq-publisher amqplib
+```
+
+## Configuration
+
+### RabbitMQPublisherConfig
+
+```typescript
+interface RabbitMQPublisherConfig {
+  channel: Channel;               // amqplib Channel instance
+  exchange: string;               // Target exchange name
+  routingKey?: string;            // Optional static routing key
+  processingConfig?: {
+    bufferSize?: number;          // Default: 50
+    bufferTimeoutMs?: number;     // Default: 100
+    concurrency?: number;         // Default: 5
+    maxBatchSize?: number;        // Optional downstream batch limit
+  };
+  retryConfig?: {
+    maxAttempts?: number;         // Default: 3
+    initialDelayMs?: number;      // Default: 1000
+    maxDelayMs?: number;          // Default: 10000
+  };
+}
+```
+
+## Batching & Buffering
+
+This publisher has **buffering enabled by default** (50 items or 100ms). This safe default ensures efficient use of the AMQP channel while maintaining low latency.
+
+To tune buffering, adjust the `processingConfig`:
+```typescript
+const publisher = new RabbitMQPublisher(bus, {
+  // ...
+  processingConfig: {
+    bufferSize: 100,
+    bufferTimeoutMs: 50
+  }
+});
+```
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { RabbitMQPublisher } from '@outbox-event-bus/rabbitmq-publisher';
+
+const publisher = new RabbitMQPublisher(bus, {
+  channel: myChannel,
+  exchange: 'app-events'
+});
+
+publisher.subscribe(['*']);
+```
+
+### Dynamic Routing
+If `routingKey` is not provided, the **event type** is used as the routing key automatically.
+
+### Configuration Options
+
+- `channel`: An instance of the `amqplib` `Channel`.
+- `exchange`: The exchange to publish to.
+- `routingKey`: (Optional) The routing key. Default: uses `event.type`.
+- `processingConfig`: (Optional) Settings for accumulation and batching.
+    - `bufferSize`: Number of events to accumulate in memory before publishing. Default: `50`.
+    - `bufferTimeoutMs`: Maximum time to wait for a buffer to fill before flushing. Default: `100ms`.
+    - `concurrency`: Maximum number of concurrent processing tasks. Default: `5`.
+    - `maxBatchSize`: (Optional) If set, the accumulated buffer will be split into smaller downstream batches.
+- `retryConfig`: (Optional) Custom retry settings for publishing failures.
+    - `maxAttempts`: Maximum number of publication attempts. Default: `3`.
+    - `initialDelayMs`: Initial backoff delay in milliseconds. Default: `1000ms`.
+    - `maxDelayMs`: Maximum backoff delay in milliseconds. Default: `10000ms`.
+
+> [!NOTE]
+> RabbitMQ publishers are often used with smaller buffers for lower latency, but larger buffers can significantly improve throughput for high-volume event streams.
+
+## Message Format
+
+Messages are published as JSON buffers:
+
+| AMQP Field | Value | Description |
+|------------|-------|-------------|
+| **Body** | `JSON.stringify(event)` | The full event object. |
+| **Routing Key** | `config.routingKey` or `event.type` | Used for routing to queues. |
+| **Headers** | `eventType`, `eventId` | Metadata headers. |
+
+## Error Handling
+
+### Application-Level Retries
+The RabbitMQ publisher implements **exponential backoff retries** to handle channel buffer saturation or temporary connection drops.
+
+```typescript
+const publisher = new RabbitMQPublisher(bus, {
+  // ...
+  retryConfig: {
+    maxAttempts: 5,
+    initialDelayMs: 500
+  }
+});
+```
+
+## Troubleshooting
+
+### `channel buffer full`
+- **Cause**: Publishing faster than RabbitMQ can accept (backpressure).
+- **Solution**: Check your RabbitMQ server load and memory. The publisher will retry, but persistent failure indicates an infrastructure bottleneck.
+
+### Unrouteable Messages
+- **Cause**: Misconfigured exchange or routing keys.
+- **Solution**: Ensure the exchange exists and queues are bound with appropriate keys matching the event type.
+
+## License
+
+MIT © [Dunika](https://github.com/dunika)

package/dist/index.cjs

@@ -0,0 +1,34 @@
+let outbox_event_bus = require("outbox-event-bus");
+
+//#region src/rabbitmq-publisher.ts
+var RabbitMQPublisher = class {
+	channel;
+	exchange;
+	routingKey;
+	publisher;
+	constructor(bus, config) {
+		this.channel = config.channel;
+		this.exchange = config.exchange;
+		this.routingKey = config.routingKey ?? "";
+		this.publisher = new outbox_event_bus.EventPublisher(bus, config);
+	}
+	subscribe(eventTypes) {
+		this.publisher.subscribe(eventTypes, async (events) => {
+			for (const event of events) {
+				const message = JSON.stringify(event);
+				const routingKey = this.routingKey || event.type;
+				if (!this.channel.publish(this.exchange, routingKey, Buffer.from(message), {
+					contentType: "application/json",
+					headers: {
+						eventType: event.type,
+						eventId: event.id
+					}
+				})) throw new outbox_event_bus.BackpressureError("RabbitMQ channel");
+			}
+		});
+	}
+};
+
+//#endregion
+exports.RabbitMQPublisher = RabbitMQPublisher;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["EventPublisher","BackpressureError"],"sources":["../src/rabbitmq-publisher.ts"],"sourcesContent":["import type { Channel } from \"amqplib\"\nimport type { BusEvent, IOutboxEventBus, IPublisher, PublisherConfig } from \"outbox-event-bus\"\nimport { BackpressureError, EventPublisher } from \"outbox-event-bus\"\n\nexport interface RabbitMQPublisherConfig extends PublisherConfig {\n  channel: Channel\n  exchange: string\n  routingKey?: string\n}\n\nexport class RabbitMQPublisher<TTransaction = unknown> implements IPublisher {\n  private readonly channel: Channel\n  private readonly exchange: string\n  private readonly routingKey: string\n  private readonly publisher: EventPublisher<TTransaction>\n\n  constructor(bus: IOutboxEventBus<TTransaction>, config: RabbitMQPublisherConfig) {\n    this.channel = config.channel\n    this.exchange = config.exchange\n    this.routingKey = config.routingKey ?? \"\"\n    this.publisher = new EventPublisher(bus, config)\n  }\n\n  subscribe(eventTypes: string[]): void {\n    this.publisher.subscribe(eventTypes, async (events: BusEvent[]) => {\n      for (const event of events) {\n        const message = JSON.stringify(event)\n        const routingKey = this.routingKey || event.type\n\n        const published = this.channel.publish(this.exchange, routingKey, Buffer.from(message), {\n          contentType: \"application/json\",\n          headers: {\n            eventType: event.type,\n            eventId: event.id,\n          },\n        })\n\n        if (!published) {\n          throw new BackpressureError(\"RabbitMQ channel\")\n        }\n      }\n    })\n  }\n}\n"],"mappings":";;;AAUA,IAAa,oBAAb,MAA6E;CAC3E,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,KAAoC,QAAiC;AAC/E,OAAK,UAAU,OAAO;AACtB,OAAK,WAAW,OAAO;AACvB,OAAK,aAAa,OAAO,cAAc;AACvC,OAAK,YAAY,IAAIA,gCAAe,KAAK,OAAO;;CAGlD,UAAU,YAA4B;AACpC,OAAK,UAAU,UAAU,YAAY,OAAO,WAAuB;AACjE,QAAK,MAAM,SAAS,QAAQ;IAC1B,MAAM,UAAU,KAAK,UAAU,MAAM;IACrC,MAAM,aAAa,KAAK,cAAc,MAAM;AAU5C,QAAI,CARc,KAAK,QAAQ,QAAQ,KAAK,UAAU,YAAY,OAAO,KAAK,QAAQ,EAAE;KACtF,aAAa;KACb,SAAS;MACP,WAAW,MAAM;MACjB,SAAS,MAAM;MAChB;KACF,CAAC,CAGA,OAAM,IAAIC,mCAAkB,mBAAmB;;IAGnD"}

package/dist/index.d.cts

@@ -0,0 +1,76 @@
+import { Channel } from "amqplib";
+
+//#region ../../core/src/types/types.d.ts
+type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+type BusEvent<T extends string = string, P = unknown> = {
+  id: string;
+  type: T;
+  payload: P;
+  occurredAt: Date;
+  metadata?: Record<string, unknown>;
+};
+type FailedBusEvent<T extends string = string, P = unknown> = BusEvent<T, P> & {
+  error?: string;
+  retryCount: number;
+  lastAttemptAt?: Date;
+};
+type BusEventInput<T extends string = string, P = unknown> = PartialBy<BusEvent<T, P>, "id" | "occurredAt">;
+type AnyListener = (...args: unknown[]) => unknown;
+type RetryOptions = {
+  maxAttempts?: number;
+  initialDelayMs?: number;
+  maxDelayMs?: number;
+};
+type ProcessingOptions = {
+  bufferSize?: number;
+  bufferTimeoutMs?: number;
+  concurrency?: number;
+  maxBatchSize?: number;
+};
+type PublisherConfig = {
+  retryConfig?: RetryOptions;
+  processingConfig?: ProcessingOptions;
+};
+//#endregion
+//#region ../../core/src/types/interfaces.d.ts
+interface IOutboxEventBus<TTransaction> {
+  emit: <T extends string, P>(event: BusEventInput<T, P>, transaction?: TTransaction) => Promise<void>;
+  emitMany: <T extends string, P>(events: BusEventInput<T, P>[], transaction?: TTransaction) => Promise<void>;
+  on: <T extends string, P = unknown>(eventType: T, handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  addListener: <T extends string, P = unknown>(eventType: T, handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  off: <T extends string, P = unknown>(eventType: T, handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  removeListener: <T extends string, P = unknown>(eventType: T, handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  once: <T extends string, P = unknown>(eventType: T, handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  removeAllListeners: <T extends string>(eventType?: T) => this;
+  getSubscriptionCount: () => number;
+  listenerCount: (eventType: string) => number;
+  getListener: (eventType: string) => AnyListener | undefined;
+  eventNames: () => string[];
+  start: () => void;
+  stop: () => Promise<void>;
+  subscribe: <T extends string, P = unknown>(eventTypes: T[], handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  waitFor: <T extends string, P = unknown>(eventType: T, timeoutMs?: number) => Promise<BusEvent<T, P>>;
+  getFailedEvents: () => Promise<FailedBusEvent[]>;
+  retryEvents: (eventIds: string[]) => Promise<void>;
+}
+interface IPublisher {
+  subscribe(eventTypes: string[]): void;
+}
+//#endregion
+//#region src/rabbitmq-publisher.d.ts
+interface RabbitMQPublisherConfig extends PublisherConfig {
+  channel: Channel;
+  exchange: string;
+  routingKey?: string;
+}
+declare class RabbitMQPublisher<TTransaction = unknown> implements IPublisher {
+  private readonly channel;
+  private readonly exchange;
+  private readonly routingKey;
+  private readonly publisher;
+  constructor(bus: IOutboxEventBus<TTransaction>, config: RabbitMQPublisherConfig);
+  subscribe(eventTypes: string[]): void;
+}
+//#endregion
+export { RabbitMQPublisher, RabbitMQPublisherConfig };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../../../core/src/types/types.ts","../../../core/src/types/interfaces.ts","../src/rabbitmq-publisher.ts"],"sourcesContent":[],"mappings":";;;KAEK,6BAA6B,KAAK,KAAK,GAAG,KAAK,QAAQ,KAAK,GAAG;KAExD;EAFP,EAAA,EAAA,MAAA;EAA6B,IAAA,EAI1B,CAJ0B;EAAU,OAAA,EAKjC,CALiC;EAAG,UAAA,EAMjC,IANiC;EAAR,QAAA,CAAA,EAO1B,MAP0B,CAAA,MAAA,EAAA,OAAA,CAAA;CAA0B;AAAG,KAUxD,cAVwD,CAAA,UAAA,MAAA,GAAA,MAAA,EAAA,IAAA,OAAA,CAAA,GAUC,QAVD,CAUU,CAVV,EAUa,CAVb,CAAA,GAAA;EAAR,KAAA,CAAA,EAAA,MAAA;EAAR,UAAA,EAAA,MAAA;EAAO,aAAA,CAAA,EAazC,IAbyC;AAE3D,CAAA;AAEQ,KAYI,aAZJ,CAAA,UAAA,MAAA,GAAA,MAAA,EAAA,IAAA,OAAA,CAAA,GAY4D,SAZ5D,CAaN,QAbM,CAaG,CAbH,EAaM,CAbN,CAAA,EAAA,IAAA,GAAA,YAAA,CAAA;AAEM,KAmBF,WAAA,GAnBE,CAAA,GAAA,IAAA,EAAA,OAAA,EAAA,EAAA,GAAA,OAAA;AACK,KAsBP,YAAA,GAtBO;EAGP,WAAA,CAAA,EAAA,MAAc;EAAoD,cAAA,CAAA,EAAA,MAAA;EAAG,UAAA,CAAA,EAAA,MAAA;CAAZ;AAGnD,KAsBN,iBAAA,GAtBM;EAAI,UAAA,CAAA,EAAA,MAAA;EAGV,eAAA,CAAa,EAAA,MAAA;EACd,WAAA,CAAA,EAAA,MAAA;EAAG,YAAA,CAAA,EAAA,MAAA;CAAZ;AADkE,KA0BxD,eAAA,GA1BwD;EAAS,WAAA,CAAA,EA2B7D,YA3B6D;EASjE,gBAAW,CAAA,EAmBF,iBAnBE;AAIvB,CAAA;;;AA7BiE,UCQhD,eDRgD,CAAA,YAAA,CAAA,CAAA;EAAG,IAAA,EAAA,CAAA,UAAA,MAAA,EAAA,CAAA,CAAA,CAAA,KAAA,ECUzD,aDVyD,CCU3C,CDV2C,ECUxC,CDVwC,CAAA,EAAA,WAAA,CAAA,ECWlD,YDXkD,EAAA,GCY7D,ODZ6D,CAAA,IAAA,CAAA;EAAR,QAAA,EAAA,CAAA,UAAA,MAAA,EAAA,CAAA,CAAA,CAAA,MAAA,ECchD,aDdgD,CCclC,CDdkC,ECc/B,CDd+B,CAAA,EAAA,EAAA,WAAA,CAAA,ECe1C,YDf0C,EAAA,GCgBrD,ODhBqD,CAAA,IAAA,CAAA;EAAR,EAAA,EAAA,CAAA,UAAA,MAAA,EAAA,IAAA,OAAA,CAAA,CAAA,SAAA,ECkBrC,CDlBqC,EAAA,OAAA,EAAA,CAAA,KAAA,ECmB/B,QDnB+B,CCmBtB,CDnBsB,ECmBnB,CDnBmB,CAAA,EAAA,GCmBZ,ODnBY,CAAA,IAAA,CAAA,EAAA,GAAA,IAAA;EAAO,WAAA,EAAA,CAAA,UAAA,MAAA,EAAA,IAAA,OAAA,CAAA,CAAA,SAAA,ECsB5C,CDtB4C,EAAA,OAAA,EAAA,CAAA,KAAA,ECuBtC,QDvBsC,CCuB7B,CDvB6B,ECuB1B,CDvB0B,CAAA,EAAA,GCuBnB,ODvBmB,CAAA,IAAA,CAAA,EAAA,GAAA,IAAA;EAE/C,GAAA,EAAA,CAAA,UAAQ,MAAA,EAAA,IAAA,OAAA,CAAA,CAAA,SAAA,ECwBL,CDxBK,EAAA,OAAA,EAAA,CAAA,KAAA,ECyBC,QDzBD,CCyBU,CDzBV,ECyBa,CDzBb,CAAA,EAAA,GCyBoB,ODzBpB,CAAA,IAAA,CAAA,EAAA,GAAA,IAAA;EAEZ,cAAA,EAAA,CAAA,UAAA,MAAA,EAAA,IAAA,OAAA,CAAA,CAAA,SAAA,EC0BO,CD1BP,EAAA,OAAA,EAAA,CAAA,KAAA,EC2Ba,QD3Bb,CC2BsB,CD3BtB,EC2ByB,CD3BzB,CAAA,EAAA,GC2BgC,OD3BhC,CAAA,IAAA,CAAA,EAAA,GAAA,IAAA;EACG,IAAA,EAAA,CAAA,UAAA,MAAA,EAAA,IAAA,OAAA,CAAA,CAAA,SAAA,EC6BI,CD7BJ,EAAA,OAAA,EAAA,CAAA,KAAA,EC8BU,QD9BV,CC8BmB,CD9BnB,EC8BsB,CD9BtB,CAAA,EAAA,GC8B6B,OD9B7B,CAAA,IAAA,CAAA,EAAA,GAAA,IAAA;EACG,kBAAA,EAAA,CAAA,UAAA,MAAA,CAAA,CAAA,SAAA,CAAA,EC+BuC,CD/BvC,EAAA,GAAA,IAAA;EACD,oBAAA,EAAA,GAAA,GAAA,MAAA;EAAM,aAAA,EAAA,CAAA,SAAA,EAAA,MAAA,EAAA,GAAA,MAAA;EAGP,WAAA,EAAA,CAAA,SAAc,EAAA,MAAA,EAAA,GC8BY,WD9BZ,GAAA,SAAA;EAAoD,UAAA,EAAA,GAAA,GAAA,MAAA,EAAA;EAAG,KAAA,EAAA,GAAA,GAAA,IAAA;EAAZ,IAAA,EAAA,GAAA,GCiCvD,ODjCuD,CAAA,IAAA,CAAA;EAGnD,SAAA,EAAA,CAAA,UAAA,MAAA,EAAA,IAAA,OAAA,CAAA,CAAA,UAAA,ECgCF,CDhCE,EAAA,EAAA,OAAA,EAAA,CAAA,KAAA,ECiCG,QDjCH,CCiCY,CDjCZ,ECiCe,CDjCf,CAAA,EAAA,GCiCsB,ODjCtB,CAAA,IAAA,CAAA,EAAA,GAAA,IAAA;EAAI,OAAA,EAAA,CAAA,UAAA,MAAA,EAAA,IAAA,OAAA,CAAA,CAAA,SAAA,ECoCP,CDpCO,EAAA,SAAA,CAAA,EAAA,MAAA,EAAA,GCsCf,ODtCe,CCsCP,QDtCO,CCsCE,CDtCF,ECsCK,CDtCL,CAAA,CAAA;EAGV,eAAA,EAAa,GAAA,GCoCA,ODpCA,CCoCQ,cDpCR,EAAA,CAAA;EACd,WAAA,EAAA,CAAA,QAAA,EAAA,MAAA,EAAA,EAAA,GCoC4B,ODpC5B,CAAA,IAAA,CAAA;;AAAT,UCuCe,UAAA,CDvCf;EADkE,SAAA,CAAA,UAAA,EAAA,MAAA,EAAA,CAAA,EAAA,IAAA;;;;UEdnD,uBAAA,SAAgC;EFF5C,OAAA,EEGM,OFHG;EAAoB,QAAA,EAAA,MAAA;EAAU,UAAA,CAAA,EAAA,MAAA;;AAAL,cEQ1B,iBFR0B,CAAA,eAAA,OAAA,CAAA,YEQ2B,UFR3B,CAAA;EAA0B,iBAAA,OAAA;EAAG,iBAAA,QAAA;EAAR,iBAAA,UAAA;EAAR,iBAAA,SAAA;EAAO,WAAA,CAAA,GAAA,EEcxC,eFdwC,CEcxB,YFdwB,CAAA,EAAA,MAAA,EEcD,uBFdC;EAE/C,SAAA,CAAA,UAAQ,EAAA,MAAA,EAAA,CAAA,EAAA,IAAA"}

package/dist/index.d.mts

@@ -0,0 +1,76 @@
+import { Channel } from "amqplib";
+
+//#region ../../core/src/types/types.d.ts
+type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+type BusEvent<T extends string = string, P = unknown> = {
+  id: string;
+  type: T;
+  payload: P;
+  occurredAt: Date;
+  metadata?: Record<string, unknown>;
+};
+type FailedBusEvent<T extends string = string, P = unknown> = BusEvent<T, P> & {
+  error?: string;
+  retryCount: number;
+  lastAttemptAt?: Date;
+};
+type BusEventInput<T extends string = string, P = unknown> = PartialBy<BusEvent<T, P>, "id" | "occurredAt">;
+type AnyListener = (...args: unknown[]) => unknown;
+type RetryOptions = {
+  maxAttempts?: number;
+  initialDelayMs?: number;
+  maxDelayMs?: number;
+};
+type ProcessingOptions = {
+  bufferSize?: number;
+  bufferTimeoutMs?: number;
+  concurrency?: number;
+  maxBatchSize?: number;
+};
+type PublisherConfig = {
+  retryConfig?: RetryOptions;
+  processingConfig?: ProcessingOptions;
+};
+//#endregion
+//#region ../../core/src/types/interfaces.d.ts
+interface IOutboxEventBus<TTransaction> {
+  emit: <T extends string, P>(event: BusEventInput<T, P>, transaction?: TTransaction) => Promise<void>;
+  emitMany: <T extends string, P>(events: BusEventInput<T, P>[], transaction?: TTransaction) => Promise<void>;
+  on: <T extends string, P = unknown>(eventType: T, handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  addListener: <T extends string, P = unknown>(eventType: T, handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  off: <T extends string, P = unknown>(eventType: T, handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  removeListener: <T extends string, P = unknown>(eventType: T, handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  once: <T extends string, P = unknown>(eventType: T, handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  removeAllListeners: <T extends string>(eventType?: T) => this;
+  getSubscriptionCount: () => number;
+  listenerCount: (eventType: string) => number;
+  getListener: (eventType: string) => AnyListener | undefined;
+  eventNames: () => string[];
+  start: () => void;
+  stop: () => Promise<void>;
+  subscribe: <T extends string, P = unknown>(eventTypes: T[], handler: (event: BusEvent<T, P>) => Promise<void>) => this;
+  waitFor: <T extends string, P = unknown>(eventType: T, timeoutMs?: number) => Promise<BusEvent<T, P>>;
+  getFailedEvents: () => Promise<FailedBusEvent[]>;
+  retryEvents: (eventIds: string[]) => Promise<void>;
+}
+interface IPublisher {
+  subscribe(eventTypes: string[]): void;
+}
+//#endregion
+//#region src/rabbitmq-publisher.d.ts
+interface RabbitMQPublisherConfig extends PublisherConfig {
+  channel: Channel;
+  exchange: string;
+  routingKey?: string;
+}
+declare class RabbitMQPublisher<TTransaction = unknown> implements IPublisher {
+  private readonly channel;
+  private readonly exchange;
+  private readonly routingKey;
+  private readonly publisher;
+  constructor(bus: IOutboxEventBus<TTransaction>, config: RabbitMQPublisherConfig);
+  subscribe(eventTypes: string[]): void;
+}
+//#endregion
+export { RabbitMQPublisher, RabbitMQPublisherConfig };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../core/src/types/types.ts","../../../core/src/types/interfaces.ts","../src/rabbitmq-publisher.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,34 @@
+import { BackpressureError, EventPublisher } from "outbox-event-bus";
+
+//#region src/rabbitmq-publisher.ts
+var RabbitMQPublisher = class {
+	channel;
+	exchange;
+	routingKey;
+	publisher;
+	constructor(bus, config) {
+		this.channel = config.channel;
+		this.exchange = config.exchange;
+		this.routingKey = config.routingKey ?? "";
+		this.publisher = new EventPublisher(bus, config);
+	}
+	subscribe(eventTypes) {
+		this.publisher.subscribe(eventTypes, async (events) => {
+			for (const event of events) {
+				const message = JSON.stringify(event);
+				const routingKey = this.routingKey || event.type;
+				if (!this.channel.publish(this.exchange, routingKey, Buffer.from(message), {
+					contentType: "application/json",
+					headers: {
+						eventType: event.type,
+						eventId: event.id
+					}
+				})) throw new BackpressureError("RabbitMQ channel");
+			}
+		});
+	}
+};
+
+//#endregion
+export { RabbitMQPublisher };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/rabbitmq-publisher.ts"],"sourcesContent":["import type { Channel } from \"amqplib\"\nimport type { BusEvent, IOutboxEventBus, IPublisher, PublisherConfig } from \"outbox-event-bus\"\nimport { BackpressureError, EventPublisher } from \"outbox-event-bus\"\n\nexport interface RabbitMQPublisherConfig extends PublisherConfig {\n  channel: Channel\n  exchange: string\n  routingKey?: string\n}\n\nexport class RabbitMQPublisher<TTransaction = unknown> implements IPublisher {\n  private readonly channel: Channel\n  private readonly exchange: string\n  private readonly routingKey: string\n  private readonly publisher: EventPublisher<TTransaction>\n\n  constructor(bus: IOutboxEventBus<TTransaction>, config: RabbitMQPublisherConfig) {\n    this.channel = config.channel\n    this.exchange = config.exchange\n    this.routingKey = config.routingKey ?? \"\"\n    this.publisher = new EventPublisher(bus, config)\n  }\n\n  subscribe(eventTypes: string[]): void {\n    this.publisher.subscribe(eventTypes, async (events: BusEvent[]) => {\n      for (const event of events) {\n        const message = JSON.stringify(event)\n        const routingKey = this.routingKey || event.type\n\n        const published = this.channel.publish(this.exchange, routingKey, Buffer.from(message), {\n          contentType: \"application/json\",\n          headers: {\n            eventType: event.type,\n            eventId: event.id,\n          },\n        })\n\n        if (!published) {\n          throw new BackpressureError(\"RabbitMQ channel\")\n        }\n      }\n    })\n  }\n}\n"],"mappings":";;;AAUA,IAAa,oBAAb,MAA6E;CAC3E,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,KAAoC,QAAiC;AAC/E,OAAK,UAAU,OAAO;AACtB,OAAK,WAAW,OAAO;AACvB,OAAK,aAAa,OAAO,cAAc;AACvC,OAAK,YAAY,IAAI,eAAe,KAAK,OAAO;;CAGlD,UAAU,YAA4B;AACpC,OAAK,UAAU,UAAU,YAAY,OAAO,WAAuB;AACjE,QAAK,MAAM,SAAS,QAAQ;IAC1B,MAAM,UAAU,KAAK,UAAU,MAAM;IACrC,MAAM,aAAa,KAAK,cAAc,MAAM;AAU5C,QAAI,CARc,KAAK,QAAQ,QAAQ,KAAK,UAAU,YAAY,OAAO,KAAK,QAAQ,EAAE;KACtF,aAAa;KACb,SAAS;MACP,WAAW,MAAM;MACjB,SAAS,MAAM;MAChB;KACF,CAAC,CAGA,OAAM,IAAI,kBAAkB,mBAAmB;;IAGnD"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@outbox-event-bus/rabbitmq-publisher",
+  "version": "1.0.0",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/dunika/outbox-event-bus.git",
+    "directory": "publishers/rabbitmq"
+  },
+  "homepage": "https://github.com/dunika/outbox-event-bus/tree/main/publishers/rabbitmq#readme",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "outbox-event-bus": "1.0.0"
+  },
+  "peerDependencies": {
+    "amqplib": "^0.10.9"
+  },
+  "devDependencies": {
+    "@types/amqplib": "^0.10.8",
+    "@types/node": "^25.0.3",
+    "tsdown": "^0.18.2",
+    "typescript": "5.9.3",
+    "vitest": "^4.0.16",
+    "@outbox-event-bus/config": "0.0.1"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./rabbitmq-publisher"

package/src/rabbitmq-publisher.test.ts

@@ -0,0 +1,44 @@
+import { BackpressureError } from "outbox-event-bus"
+import { beforeEach, describe, expect, it, vi } from "vitest"
+import { RabbitMQPublisher } from "./rabbitmq-publisher"
+
+describe("RabbitMQPublisher", () => {
+  let mockChannel: any
+  let _mockConnection: any
+  let mockBus: any
+
+  beforeEach(() => {
+    mockChannel = {
+      assertExchange: vi.fn().mockResolvedValue({}),
+      publish: vi.fn().mockReturnValue(true),
+    }
+    _mockConnection = {
+      createChannel: vi.fn().mockResolvedValue(mockChannel),
+    }
+    mockBus = {
+      subscribe: vi.fn(),
+    }
+  })
+
+  it("should throw BackpressureError when channel buffer is full", async () => {
+    const publisher = new RabbitMQPublisher(mockBus, {
+      channel: mockChannel,
+      exchange: "test-exchange",
+    })
+
+    publisher.subscribe(["test-event"])
+    const handler = mockBus.subscribe.mock.calls[0][1]
+
+    // Simulate backpressure
+    mockChannel.publish.mockReturnValue(false)
+
+    const event = {
+      id: "1",
+      type: "test-event",
+      payload: {},
+      occurredAt: new Date(),
+    }
+
+    await expect(handler([event])).rejects.toThrow(BackpressureError)
+  })
+})

package/src/rabbitmq-publisher.ts

@@ -0,0 +1,44 @@
+import type { Channel } from "amqplib"
+import type { BusEvent, IOutboxEventBus, IPublisher, PublisherConfig } from "outbox-event-bus"
+import { BackpressureError, EventPublisher } from "outbox-event-bus"
+
+export interface RabbitMQPublisherConfig extends PublisherConfig {
+  channel: Channel
+  exchange: string
+  routingKey?: string
+}
+
+export class RabbitMQPublisher<TTransaction = unknown> implements IPublisher {
+  private readonly channel: Channel
+  private readonly exchange: string
+  private readonly routingKey: string
+  private readonly publisher: EventPublisher<TTransaction>
+
+  constructor(bus: IOutboxEventBus<TTransaction>, config: RabbitMQPublisherConfig) {
+    this.channel = config.channel
+    this.exchange = config.exchange
+    this.routingKey = config.routingKey ?? ""
+    this.publisher = new EventPublisher(bus, config)
+  }
+
+  subscribe(eventTypes: string[]): void {
+    this.publisher.subscribe(eventTypes, async (events: BusEvent[]) => {
+      for (const event of events) {
+        const message = JSON.stringify(event)
+        const routingKey = this.routingKey || event.type
+
+        const published = this.channel.publish(this.exchange, routingKey, Buffer.from(message), {
+          contentType: "application/json",
+          headers: {
+            eventType: event.type,
+            eventId: event.id,
+          },
+        })
+
+        if (!published) {
+          throw new BackpressureError("RabbitMQ channel")
+        }
+      }
+    })
+  }
+}