@ddd-ts-kit/rabbitmq 0.0.0-stage → 0.1.1

package/dist/rabbit-mq-event-bus.js

@@ -0,0 +1,168 @@
+import { inspect } from 'node:util';
+import { connect } from 'amqplib';
+import { ATTEMPT_HEADER } from './codec/headers.js';
+import { republication } from './codec/republication.js';
+import { BrokerLink } from './connection/broker-link.js';
+import { Consumption } from './consumption/consumption.js';
+import { ConsumerNameRequiredError } from './errors/consumer-name-required-error.js';
+import { MESSAGING_SYSTEM } from './messaging-system.js';
+import { EventBusClosedError } from './errors/event-bus-closed-error.js';
+import { settingsOf } from './options/settings-of.js';
+import { Publications } from './publication/publications.js';
+import { conceal } from './secrecy/conceal.js';
+import { sendConfirmed } from './publication/send-confirmed.js';
+import { declareTopology } from './topology/declare-topology.js';
+import { queueNamesOf } from './topology/queue-names-of.js';
+import { topologyOf } from './topology/topology-of.js';
+const DESCRIPTION = 'RabbitMqEventBus [connection concealed]';
+/**
+ * The provider for RabbitMQ and other AMQP 0-9-1 brokers.
+ *
+ * Publishing: a durable topic exchange, routing key = event type, persistent messages, and
+ * `publish` resolves only when the broker confirmed every message, so it is a safe target for
+ * the outbox relay. Consuming: a durable queue per consumer and event type, acknowledged
+ * after the handlers resolved, a bounded number of delayed retries, then a dead queue.
+ * Delivery is at least once and unordered: consumers deduplicate.
+ */
+export class RabbitMqEventBus {
+    /** Read by what observes the bus from outside: the name of the transport. */
+    messagingSystem = MESSAGING_SYSTEM;
+    settings;
+    link;
+    publications;
+    consumption;
+    closed = false;
+    constructor(options) {
+        this.settings = settingsOf(options, connect);
+        const channelLost = () => {
+            this.link.restart();
+        };
+        this.publications = new Publications({ ...this.settings, channelLost });
+        this.consumption = new Consumption({
+            ...this.settings,
+            topology: topologySettingsOf(this.settings),
+            channelLost,
+        });
+        this.link = new BrokerLink(this.settings, {
+            opened: async (model) => {
+                await this.publications.attach(model);
+                await this.consumption.attach(model);
+            },
+            lost: () => {
+                this.publications.detach();
+                this.consumption.detach();
+            },
+            failed: (code) => {
+                this.settings.onFailure({ kind: 'connection', code });
+            },
+        });
+        conceal(this);
+    }
+    /** Messages delivered to this bus whose handlers have not finished yet. */
+    get deliveriesInFlight() {
+        return this.consumption.inFlight;
+    }
+    /**
+     * Resolves when the broker confirmed every event, rejects otherwise: nothing is buffered
+     * for later, so the caller (the outbox relay) knows what to retry.
+     */
+    async publish(events) {
+        if (events.length === 0) {
+            return;
+        }
+        await this.link.opened();
+        // The queues of this bus are bound before it publishes: it never misses its own events.
+        await this.consumption.started();
+        await this.publications.publish(events);
+    }
+    /** Subscribes the consumer named by the `consumer` option. */
+    subscribe(type, handler) {
+        if (this.settings.consumer === undefined) {
+            throw new ConsumerNameRequiredError();
+        }
+        return this.consume({ consumer: this.settings.consumer, type }, handler);
+    }
+    /** A subscriber for one consuming context, on the connection of this bus. */
+    forConsumer(consumer) {
+        if (consumer.length === 0) {
+            throw new ConsumerNameRequiredError();
+        }
+        return { subscribe: (type, handler) => this.consume({ consumer, type }, handler) };
+    }
+    /**
+     * Connects if needed and declares the exchange, the queues and the bindings of the
+     * subscriptions made so far. Idempotent. Resolves once those subscriptions are consuming.
+     */
+    async assertTopology() {
+        const model = await this.link.opened();
+        // On a channel of its own: a refused declaration closes the channel it was made on.
+        const channel = await model.createChannel();
+        channel.on('error', () => undefined);
+        await declareTopology(channel, this.describeTopology());
+        await channel.close();
+        await this.consumption.started();
+    }
+    describeTopology() {
+        return topologyOf(topologySettingsOf(this.settings), this.consumption.bindings());
+    }
+    /**
+     * Moves up to `limit` messages from the dead queue of a consumer back to its work queue,
+     * with a fresh attempt budget. Returns how many were moved.
+     */
+    async replayDead(binding, limit = 100) {
+        const { work, dead } = queueNamesOf(binding);
+        const channel = await (await this.link.opened()).createConfirmChannel();
+        channel.on('error', () => undefined);
+        let replayed = 0;
+        try {
+            for (; replayed < limit; replayed += 1) {
+                const message = await channel.get(dead, { noAck: false });
+                if (message === false) {
+                    break;
+                }
+                await sendConfirmed(channel, work, republication(message, { [ATTEMPT_HEADER]: 1 }));
+                channel.ack(message);
+            }
+        }
+        finally {
+            await channel.close().catch(() => undefined);
+        }
+        return replayed;
+    }
+    /** Stops consuming, waits for the handlers and the confirmations in flight, disconnects. */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        await this.consumption.drain();
+        await this.publications.close();
+        await this.link.close();
+    }
+    /** What a serialisation shows of the bus: its name, never its connection. */
+    toJSON() {
+        return DESCRIPTION;
+    }
+    /** What `console.log` and `util.inspect` show of the bus: the same. */
+    [inspect.custom]() {
+        return DESCRIPTION;
+    }
+    /** Adds a handler to the queue of one consumer for one type, and connects if needed. */
+    consume(binding, handler) {
+        if (this.closed) {
+            throw new EventBusClosedError();
+        }
+        const subscription = this.consumption.add(binding, handler);
+        // Connects in the background; a failure is reported by the link and retried.
+        void this.link.opened().catch(() => undefined);
+        return subscription;
+    }
+}
+function topologySettingsOf(settings) {
+    return {
+        exchange: settings.exchange,
+        queueType: settings.queueType,
+        retryDelayMs: settings.retry.delayMs,
+    };
+}
+//# sourceMappingURL=rabbit-mq-event-bus.js.map

package/dist/rabbit-mq-event-bus.js.map

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

package/dist/secrecy/conceal.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Takes the fields an instance holds so far out of enumeration: `Object.keys`, a spread and a
+ * comparison no longer reach the client or the connection behind them, whose options carry
+ * credentials. Called last in a constructor, next to a `toJSON` and an inspection method that
+ * answer a name: nothing the instance is shown through leads to what it holds.
+ */
+export declare function conceal(instance: object): void;
+//# sourceMappingURL=conceal.d.ts.map

package/dist/secrecy/conceal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conceal.d.ts","sourceRoot":"","sources":["../../src/secrecy/conceal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAI9C"}

package/dist/secrecy/conceal.js

@@ -0,0 +1,12 @@
+/**
+ * Takes the fields an instance holds so far out of enumeration: `Object.keys`, a spread and a
+ * comparison no longer reach the client or the connection behind them, whose options carry
+ * credentials. Called last in a constructor, next to a `toJSON` and an inspection method that
+ * answer a name: nothing the instance is shown through leads to what it holds.
+ */
+export function conceal(instance) {
+    for (const field of Object.keys(instance)) {
+        Object.defineProperty(instance, field, { enumerable: false });
+    }
+}
+//# sourceMappingURL=conceal.js.map

package/dist/secrecy/conceal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conceal.js","sourceRoot":"","sources":["../../src/secrecy/conceal.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,QAAgB;IACtC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1C,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}

package/dist/topology/binding-description.d.ts

@@ -0,0 +1,6 @@
+export interface BindingDescription {
+    readonly exchange: string;
+    readonly queue: string;
+    readonly routingKey: string;
+}
+//# sourceMappingURL=binding-description.d.ts.map

package/dist/topology/binding-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-description.d.ts","sourceRoot":"","sources":["../../src/topology/binding-description.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}

package/dist/topology/binding-description.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=binding-description.js.map

package/dist/topology/binding-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-description.js","sourceRoot":"","sources":["../../src/topology/binding-description.ts"],"names":[],"mappings":""}

package/dist/topology/consumer-binding.d.ts

@@ -0,0 +1,6 @@
+/** One consuming context listening to one event type. */
+export interface ConsumerBinding {
+    readonly consumer: string;
+    readonly type: string;
+}
+//# sourceMappingURL=consumer-binding.d.ts.map

package/dist/topology/consumer-binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-binding.d.ts","sourceRoot":"","sources":["../../src/topology/consumer-binding.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/topology/consumer-binding.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=consumer-binding.js.map

package/dist/topology/consumer-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-binding.js","sourceRoot":"","sources":["../../src/topology/consumer-binding.ts"],"names":[],"mappings":""}

package/dist/topology/declare-topology.d.ts

@@ -0,0 +1,5 @@
+import type { Channel } from 'amqplib';
+import type { RabbitMqTopology } from './rabbit-mq-topology.js';
+/** Idempotent: declaring what already exists with the same arguments changes nothing. */
+export declare function declareTopology(channel: Channel, topology: RabbitMqTopology): Promise<void>;
+//# sourceMappingURL=declare-topology.d.ts.map

package/dist/topology/declare-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declare-topology.d.ts","sourceRoot":"","sources":["../../src/topology/declare-topology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,yFAAyF;AACzF,wBAAsB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjG"}

package/dist/topology/declare-topology.js

@@ -0,0 +1,13 @@
+/** Idempotent: declaring what already exists with the same arguments changes nothing. */
+export async function declareTopology(channel, topology) {
+    for (const exchange of topology.exchanges) {
+        await channel.assertExchange(exchange.name, exchange.type, { durable: exchange.durable });
+    }
+    for (const queue of topology.queues) {
+        await channel.assertQueue(queue.name, { durable: queue.durable, arguments: queue.arguments });
+    }
+    for (const binding of topology.bindings) {
+        await channel.bindQueue(binding.queue, binding.exchange, binding.routingKey);
+    }
+}
+//# sourceMappingURL=declare-topology.js.map

package/dist/topology/declare-topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declare-topology.js","sourceRoot":"","sources":["../../src/topology/declare-topology.ts"],"names":[],"mappings":"AAGA,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAgB,EAAE,QAA0B;IAChF,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1C,MAAM,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5F,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC"}

package/dist/topology/exchange-description.d.ts

@@ -0,0 +1,6 @@
+export interface ExchangeDescription {
+    readonly name: string;
+    readonly type: 'topic';
+    readonly durable: true;
+}
+//# sourceMappingURL=exchange-description.d.ts.map

package/dist/topology/exchange-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-description.d.ts","sourceRoot":"","sources":["../../src/topology/exchange-description.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;CACxB"}

package/dist/topology/exchange-description.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exchange-description.js.map

package/dist/topology/exchange-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-description.js","sourceRoot":"","sources":["../../src/topology/exchange-description.ts"],"names":[],"mappings":""}

package/dist/topology/queue-description.d.ts

@@ -0,0 +1,8 @@
+export interface QueueDescription {
+    readonly name: string;
+    /** `work` is consumed, `retry` holds a failed message for the delay, `dead` keeps it. */
+    readonly role: 'work' | 'retry' | 'dead';
+    readonly durable: true;
+    readonly arguments: Readonly<Record<string, string | number>>;
+}
+//# sourceMappingURL=queue-description.d.ts.map

package/dist/topology/queue-description.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-description.d.ts","sourceRoot":"","sources":["../../src/topology/queue-description.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;CAC/D"}

package/dist/topology/queue-description.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-description.js.map

package/dist/topology/queue-description.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-description.js","sourceRoot":"","sources":["../../src/topology/queue-description.ts"],"names":[],"mappings":""}

package/dist/topology/queue-names-of.d.ts

@@ -0,0 +1,4 @@
+import type { ConsumerBinding } from './consumer-binding.js';
+import type { QueueNames } from './queue-names.js';
+export declare function queueNamesOf({ consumer, type }: ConsumerBinding): QueueNames;
+//# sourceMappingURL=queue-names-of.d.ts.map

package/dist/topology/queue-names-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-names-of.d.ts","sourceRoot":"","sources":["../../src/topology/queue-names-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,eAAe,GAAG,UAAU,CAI5E"}

package/dist/topology/queue-names-of.js

@@ -0,0 +1,5 @@
+export function queueNamesOf({ consumer, type }) {
+    const work = `${consumer}.${type}`;
+    return { work, retry: `${work}.retry`, dead: `${work}.dead` };
+}
+//# sourceMappingURL=queue-names-of.js.map

package/dist/topology/queue-names-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-names-of.js","sourceRoot":"","sources":["../../src/topology/queue-names-of.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,YAAY,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAmB;IAC9D,MAAM,IAAI,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;IAEnC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;AAChE,CAAC"}

package/dist/topology/queue-names.d.ts

@@ -0,0 +1,6 @@
+export interface QueueNames {
+    readonly work: string;
+    readonly retry: string;
+    readonly dead: string;
+}
+//# sourceMappingURL=queue-names.d.ts.map

package/dist/topology/queue-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-names.d.ts","sourceRoot":"","sources":["../../src/topology/queue-names.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB"}

package/dist/topology/queue-names.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-names.js.map

package/dist/topology/queue-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-names.js","sourceRoot":"","sources":["../../src/topology/queue-names.ts"],"names":[],"mappings":""}

package/dist/topology/rabbit-mq-topology.d.ts

@@ -0,0 +1,10 @@
+import type { BindingDescription } from './binding-description.js';
+import type { ExchangeDescription } from './exchange-description.js';
+import type { QueueDescription } from './queue-description.js';
+/** Everything the bus declares on the broker, as data: for documentation and reviews. */
+export interface RabbitMqTopology {
+    readonly exchanges: readonly ExchangeDescription[];
+    readonly queues: readonly QueueDescription[];
+    readonly bindings: readonly BindingDescription[];
+}
+//# sourceMappingURL=rabbit-mq-topology.d.ts.map

package/dist/topology/rabbit-mq-topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rabbit-mq-topology.d.ts","sourceRoot":"","sources":["../../src/topology/rabbit-mq-topology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAClD"}

package/dist/topology/rabbit-mq-topology.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rabbit-mq-topology.js.map

package/dist/topology/rabbit-mq-topology.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rabbit-mq-topology.js","sourceRoot":"","sources":["../../src/topology/rabbit-mq-topology.ts"],"names":[],"mappings":""}

package/dist/topology/topology-of.d.ts

@@ -0,0 +1,5 @@
+import type { ConsumerBinding } from './consumer-binding.js';
+import type { RabbitMqTopology } from './rabbit-mq-topology.js';
+import type { TopologySettings } from './topology-settings.js';
+export declare function topologyOf(settings: TopologySettings, bindings: readonly ConsumerBinding[]): RabbitMqTopology;
+//# sourceMappingURL=topology-of.d.ts.map

package/dist/topology/topology-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-of.d.ts","sourceRoot":"","sources":["../../src/topology/topology-of.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAI7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,gBAAgB,CAU7G"}

package/dist/topology/topology-of.js

@@ -0,0 +1,50 @@
+import { queueNamesOf } from './queue-names-of.js';
+export function topologyOf(settings, bindings) {
+    return {
+        exchanges: [{ name: settings.exchange, type: 'topic', durable: true }],
+        queues: bindings.flatMap((binding) => queuesOf(settings, queueNamesOf(binding))),
+        bindings: bindings.map((binding) => ({
+            exchange: settings.exchange,
+            queue: queueNamesOf(binding).work,
+            routingKey: binding.type,
+        })),
+    };
+}
+// The default exchange ('') routes to the queue named by the routing key: retries and dead
+// letters reach their queue without an exchange or a binding of their own.
+const DEFAULT_EXCHANGE_OF_THE_BROKER = '';
+function queuesOf(settings, names) {
+    const type = { 'x-queue-type': settings.queueType };
+    return [
+        {
+            name: names.work,
+            role: 'work',
+            durable: true,
+            arguments: { ...type, ...deadLetteringTo(names.dead) },
+        },
+        {
+            name: names.retry,
+            role: 'retry',
+            durable: true,
+            arguments: {
+                ...type,
+                'x-message-ttl': settings.retryDelayMs,
+                ...deadLetteringTo(names.work),
+                ...lossless(settings.queueType),
+            },
+        },
+        { name: names.dead, role: 'dead', durable: true, arguments: type },
+    ];
+}
+function deadLetteringTo(queue) {
+    return {
+        'x-dead-letter-exchange': DEFAULT_EXCHANGE_OF_THE_BROKER,
+        'x-dead-letter-routing-key': queue,
+    };
+}
+// A quorum queue dead-letters at most once unless told otherwise: an expired retry must not
+// be lost on its way back. The strategy requires the overflow policy that goes with it.
+function lossless(queueType) {
+    return queueType === 'quorum' ? { 'x-dead-letter-strategy': 'at-least-once', 'x-overflow': 'reject-publish' } : {};
+}
+//# sourceMappingURL=topology-of.js.map

package/dist/topology/topology-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-of.js","sourceRoot":"","sources":["../../src/topology/topology-of.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,MAAM,UAAU,UAAU,CAAC,QAA0B,EAAE,QAAoC;IACzF,OAAO;QACL,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACtE,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QAChF,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI;YACjC,UAAU,EAAE,OAAO,CAAC,IAAI;SACzB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,2EAA2E;AAC3E,MAAM,8BAA8B,GAAG,EAAE,CAAC;AAE1C,SAAS,QAAQ,CAAC,QAA0B,EAAE,KAAiB;IAC7D,MAAM,IAAI,GAAG,EAAE,cAAc,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC;IAEpD,OAAO;QACL;YACE,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE;SACvD;QACD;YACE,IAAI,EAAE,KAAK,CAAC,KAAK;YACjB,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,IAAI;YACb,SAAS,EAAE;gBACT,GAAG,IAAI;gBACP,eAAe,EAAE,QAAQ,CAAC,YAAY;gBACtC,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;gBAC9B,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;aAChC;SACF;QACD,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;KACnE,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO;QACL,wBAAwB,EAAE,8BAA8B;QACxD,2BAA2B,EAAE,KAAK;KACnC,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,wFAAwF;AACxF,SAAS,QAAQ,CAAC,SAAoB;IACpC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,wBAAwB,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACrH,CAAC"}

package/dist/topology/topology-settings.d.ts

@@ -0,0 +1,7 @@
+import type { QueueType } from '../options/queue-type.js';
+export interface TopologySettings {
+    readonly exchange: string;
+    readonly queueType: QueueType;
+    readonly retryDelayMs: number;
+}
+//# sourceMappingURL=topology-settings.d.ts.map

package/dist/topology/topology-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-settings.d.ts","sourceRoot":"","sources":["../../src/topology/topology-settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B"}

package/dist/topology/topology-settings.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=topology-settings.js.map

package/dist/topology/topology-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology-settings.js","sourceRoot":"","sources":["../../src/topology/topology-settings.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,39 @@
 {
   "name": "@ddd-ts-kit/rabbitmq",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "RabbitMQ provider for integration events: confirmed publishing for the outbox relay, durable queue per consumer, manual acknowledgement, bounded retries and dead-lettering.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gbourgeat/ddd-ts-kit.git",
+    "directory": "packages/rabbitmq"
+  },
+  "homepage": "https://github.com/gbourgeat/ddd-ts-kit/tree/main/packages/rabbitmq#readme",
+  "bugs": "https://github.com/gbourgeat/ddd-ts-kit/issues",
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@ddd-ts-kit/kernel": "0.1.1",
+    "@ddd-ts-kit/events": "0.1.1"
+  },
+  "peerDependencies": {
+    "amqplib": ">=0.10.0"
+  },
+  "devDependencies": {
+    "amqplib": "latest",
+    "@ddd-ts-kit/testing": "0.1.1"
+  }
+}