@ddd-ts-kit/nats 0.0.0-stage → 0.1.0

package/dist/errors/failure-code.js

@@ -0,0 +1,19 @@
+import { errorCode } from '@ddd-ts-kit/events';
+/**
+ * What may be reported about a caught error. JetStream answers a refused request with a
+ * numeric error code (`10058` for a stream that exists with another configuration): it
+ * becomes `JETSTREAM_10058`. A connection error wraps the system error: its code
+ * (`ECONNREFUSED`) is the one reported. Never the message.
+ */
+export function failureCode(error) {
+    if (typeof error !== 'object' || error === null) {
+        return errorCode(error);
+    }
+    if ('code' in error && typeof error.code === 'number' && Number.isInteger(error.code)) {
+        return `JETSTREAM_${String(error.code)}`;
+    }
+    const cause = 'cause' in error ? error.cause : undefined;
+    const causeCode = errorCode(cause);
+    return causeCode === 'UNKNOWN_ERROR' || causeCode === 'Error' ? errorCode(error) : causeCode;
+}
+//# sourceMappingURL=failure-code.js.map

package/dist/errors/failure-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-code.js","sourceRoot":"","sources":["../../src/errors/failure-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtF,OAAO,aAAa,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3C,CAAC;IAED,MAAM,KAAK,GAAY,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAEnC,OAAO,SAAS,KAAK,eAAe,IAAI,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/F,CAAC"}

package/dist/errors/publish-not-acknowledged-error.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The stream did not acknowledge the message in time: it may or may not hold it. Publish
+ * again; inside the duplicate window the stream drops the second copy.
+ */
+export declare class PublishNotAcknowledgedError extends Error {
+    readonly eventId: string;
+    readonly reason: string;
+    readonly code = "PUBLISH_NOT_ACKNOWLEDGED";
+    constructor(eventId: string, reason: string);
+}
+//# sourceMappingURL=publish-not-acknowledged-error.d.ts.map

package/dist/errors/publish-not-acknowledged-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-not-acknowledged-error.d.ts","sourceRoot":"","sources":["../../src/errors/publish-not-acknowledged-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IAIlD,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM;IAJzB,QAAQ,CAAC,IAAI,8BAA8B;IAE3C,YACW,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EAIxB;CACF"}

package/dist/errors/publish-not-acknowledged-error.js

@@ -0,0 +1,16 @@
+/**
+ * The stream did not acknowledge the message in time: it may or may not hold it. Publish
+ * again; inside the duplicate window the stream drops the second copy.
+ */
+export class PublishNotAcknowledgedError extends Error {
+    eventId;
+    reason;
+    code = 'PUBLISH_NOT_ACKNOWLEDGED';
+    constructor(eventId, reason) {
+        super(`The stream did not acknowledge event ${eventId} (${reason})`);
+        this.eventId = eventId;
+        this.reason = reason;
+        this.name = 'PublishNotAcknowledgedError';
+    }
+}
+//# sourceMappingURL=publish-not-acknowledged-error.js.map

package/dist/errors/publish-not-acknowledged-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-not-acknowledged-error.js","sourceRoot":"","sources":["../../src/errors/publish-not-acknowledged-error.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAIzC,OAAO;IACP,MAAM;IAJR,IAAI,GAAG,0BAA0B,CAAC;IAE3C,YACW,OAAe,EACf,MAAc;QAEvB,KAAK,CAAC,wCAAwC,OAAO,KAAK,MAAM,GAAG,CAAC,CAAC;uBAH5D,OAAO;sBACP,MAAM;QAGf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF"}

package/dist/ignore.d.ts

@@ -0,0 +1,3 @@
+/** For a rejection or an event that needs no answer: closing what is already closed. */
+export declare function ignore(): undefined;
+//# sourceMappingURL=ignore.d.ts.map

package/dist/ignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.d.ts","sourceRoot":"","sources":["../src/ignore.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,wBAAgB,MAAM,IAAI,SAAS,CAElC"}

package/dist/ignore.js

@@ -0,0 +1,5 @@
+/** For a rejection or an event that needs no answer: closing what is already closed. */
+export function ignore() {
+    return undefined;
+}
+//# sourceMappingURL=ignore.js.map

package/dist/ignore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ignore.js","sourceRoot":"","sources":["../src/ignore.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,UAAU,MAAM;IACpB,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+export { NatsEventBus } from './nats-event-bus.js';
+export { DEFAULT_STREAM, DEFAULT_SUBJECT_PREFIX } from './options/nats-event-bus-options.js';
+export type { NatsEventBusOptions } from './options/nats-event-bus-options.js';
+export type { NatsDelivery } from './options/nats-delivery.js';
+export type { NatsFailure } from './options/nats-failure.js';
+export type { ReconnectOptions } from './options/reconnect-options.js';
+export type { RetryOptions } from './options/retry-options.js';
+export type { StreamStorage } from './options/stream-storage.js';
+export { bindingNamesOf } from './topology/binding-names-of.js';
+export { deadStreamOf } from './topology/dead-stream-of.js';
+export type { BindingNames } from './topology/binding-names.js';
+export type { ConsumerBinding } from './topology/consumer-binding.js';
+export type { ConsumerDescription } from './topology/consumer-description.js';
+export type { NatsTopology } from './topology/nats-topology.js';
+export type { StreamDescription } from './topology/stream-description.js';
+export { ATTEMPT_HEADER, CORRELATION_HEADER, DEAD_REASON_HEADER, ERROR_CODE_HEADER, EVENT_TYPE_HEADER, EVENT_VERSION_HEADER, MESSAGE_ID_HEADER, REPLAY_FOR_HEADER, SOURCE_HEADER, TRACEPARENT_HEADER, } from './codec/headers.js';
+export { POISON_MESSAGE } from './consumption/poison-message.js';
+export { BrokerUnavailableError } from './errors/broker-unavailable-error.js';
+export { ConsumerNameRequiredError } from './errors/consumer-name-required-error.js';
+export { EventBusClosedError } from './errors/event-bus-closed-error.js';
+export { PublishNotAcknowledgedError } from './errors/publish-not-acknowledged-error.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":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAC7F,YAAY,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { NatsEventBus } from './nats-event-bus.js';
+export { DEFAULT_STREAM, DEFAULT_SUBJECT_PREFIX } from './options/nats-event-bus-options.js';
+export { bindingNamesOf } from './topology/binding-names-of.js';
+export { deadStreamOf } from './topology/dead-stream-of.js';
+export { ATTEMPT_HEADER, CORRELATION_HEADER, DEAD_REASON_HEADER, ERROR_CODE_HEADER, EVENT_TYPE_HEADER, EVENT_VERSION_HEADER, MESSAGE_ID_HEADER, REPLAY_FOR_HEADER, SOURCE_HEADER, TRACEPARENT_HEADER, } from './codec/headers.js';
+export { POISON_MESSAGE } from './consumption/poison-message.js';
+export { BrokerUnavailableError } from './errors/broker-unavailable-error.js';
+export { ConsumerNameRequiredError } from './errors/consumer-name-required-error.js';
+export { EventBusClosedError } from './errors/event-bus-closed-error.js';
+export { PublishNotAcknowledgedError } from './errors/publish-not-acknowledged-error.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,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAO7F,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAM5D,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC"}

package/dist/messaging-system.d.ts

@@ -0,0 +1,3 @@
+/** The name of the transport in what the bus says of itself and of each delivery. */
+export declare const MESSAGING_SYSTEM = "nats";
+//# sourceMappingURL=messaging-system.d.ts.map

package/dist/messaging-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-system.d.ts","sourceRoot":"","sources":["../src/messaging-system.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,SAAS,CAAC"}

package/dist/messaging-system.js

@@ -0,0 +1,3 @@
+/** The name of the transport in what the bus says of itself and of each delivery. */
+export const MESSAGING_SYSTEM = 'nats';
+//# sourceMappingURL=messaging-system.js.map

package/dist/messaging-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging-system.js","sourceRoot":"","sources":["../src/messaging-system.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC"}

package/dist/nats-event-bus.d.ts

@@ -0,0 +1,57 @@
+import { inspect } from 'node:util';
+import type { EventBus, IntegrationEvent, IntegrationEventCallback, IntegrationEventSubscriber, Subscription } from '@ddd-ts-kit/kernel';
+import type { NatsEventBusOptions } from './options/nats-event-bus-options.js';
+import type { ConsumerBinding } from './topology/consumer-binding.js';
+import type { NatsTopology } from './topology/nats-topology.js';
+/**
+ * The provider for NATS JetStream.
+ *
+ * Publishing: one stream capturing `<prefix>.>`, subject = `<prefix>.<event type>`, the event
+ * id as message id, and `publish` resolves only when the stream acknowledged every message,
+ * so it is a safe target for the outbox relay. Consuming: a durable pull consumer per
+ * consumer and event type, acknowledged after the handlers resolved, a bounded number of
+ * delayed redeliveries, then a dead-letter stream. Delivery is at least once and unordered:
+ * consumers deduplicate.
+ */
+export declare class NatsEventBus implements EventBus {
+    /** Read by what observes the bus from outside: the name of the transport. */
+    readonly messagingSystem = "nats";
+    private readonly settings;
+    private readonly link;
+    private readonly publications;
+    private readonly consumption;
+    private closed;
+    constructor(options: NatsEventBusOptions);
+    /** Messages delivered to this bus whose handlers have not finished yet. */
+    get deliveriesInFlight(): number;
+    /**
+     * Resolves when the stream acknowledged every event, rejects otherwise: nothing is
+     * buffered for later, so the caller (the outbox relay) knows what to retry.
+     */
+    publish(events: readonly IntegrationEvent[]): Promise<void>;
+    /** Subscribes the consumer named by the `consumer` option. */
+    subscribe(type: string, handler: IntegrationEventCallback): Subscription;
+    /** A subscriber for one consuming context, on the connection of this bus. */
+    forConsumer(consumer: string): IntegrationEventSubscriber;
+    /**
+     * Connects if needed and creates the streams and the durable consumers of the
+     * subscriptions made so far. Idempotent. Resolves once those subscriptions are consuming.
+     */
+    assertTopology(): Promise<void>;
+    describeTopology(): NatsTopology;
+    /**
+     * Moves up to `limit` messages of a consumer from the dead-letter stream back to the
+     * subject they came from, for that consumer only and with a fresh attempt budget. Returns
+     * how many were moved.
+     */
+    replayDead(binding: ConsumerBinding, limit?: number): Promise<number>;
+    /** Stops consuming, waits for the handlers in flight and their acknowledgements, disconnects. */
+    close(): Promise<void>;
+    /** What a serialisation shows of the bus: its name, never its connection. */
+    toJSON(): string;
+    /** What `console.log` and `util.inspect` show of the bus: the same. */
+    [inspect.custom](): string;
+    /** Adds a handler to the durable consumer of one consumer for one type, and connects if needed. */
+    private consume;
+}
+//# sourceMappingURL=nats-event-bus.d.ts.map

package/dist/nats-event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-event-bus.d.ts","sourceRoot":"","sources":["../src/nats-event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,YAAY,EACb,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAM/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAGtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMhE;;;;;;;;;GASG;AACH,qBAAa,YAAa,YAAW,QAAQ;IAC3C,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,UAAoB;IAE5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IAEpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAE5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAE1C,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,OAAO,EAAE,mBAAmB,EA2BvC;IAED,2EAA2E;IAC3E,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAShE;IAED,8DAA8D;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,YAAY,CAMvE;IAED,6EAA6E;IAC7E,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,0BAA0B,CAMxD;IAED;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAKpC;IAED,gBAAgB,IAAI,YAAY,CAE/B;IAED;;;;OAIG;IACG,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsBvE;IAED,iGAAiG;IAC3F,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAS3B;IAED,6EAA6E;IAC7E,MAAM,IAAI,MAAM,CAEf;IAED,uEAAuE;IACvE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAEzB;IAED,mGAAmG;IACnG,OAAO,CAAC,OAAO;CAYhB"}

package/dist/nats-event-bus.js

@@ -0,0 +1,168 @@
+import { inspect } from 'node:util';
+import { jetstreamManager } from '@nats-io/jetstream';
+import { connect } from '@nats-io/transport-node';
+import { REPLAY_FOR_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 { bindingNamesOf } from './topology/binding-names-of.js';
+import { deadStreamOf } from './topology/dead-stream-of.js';
+import { declareTopology } from './topology/declare-topology.js';
+import { topologyOf } from './topology/topology-of.js';
+const DESCRIPTION = 'NatsEventBus [connection concealed]';
+/**
+ * The provider for NATS JetStream.
+ *
+ * Publishing: one stream capturing `<prefix>.>`, subject = `<prefix>.<event type>`, the event
+ * id as message id, and `publish` resolves only when the stream acknowledged every message,
+ * so it is a safe target for the outbox relay. Consuming: a durable pull consumer per
+ * consumer and event type, acknowledged after the handlers resolved, a bounded number of
+ * delayed redeliveries, then a dead-letter stream. Delivery is at least once and unordered:
+ * consumers deduplicate.
+ */
+export class NatsEventBus {
+    /** 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);
+        this.publications = new Publications(this.settings);
+        this.consumption = new Consumption(this.publications, {
+            ...this.settings,
+            topology: topologySettingsOf(this.settings),
+            consumerLost: () => {
+                this.link.restart();
+            },
+        });
+        this.link = new BrokerLink(this.settings, {
+            opened: async (connection) => {
+                this.publications.attach(connection);
+                await this.consumption.attach(connection);
+            },
+            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 stream acknowledged 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 consumers of this bus exist 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 creates the streams and the durable consumers of the
+     * subscriptions made so far. Idempotent. Resolves once those subscriptions are consuming.
+     */
+    async assertTopology() {
+        const manager = await jetstreamManager(await this.link.opened());
+        await declareTopology(manager, this.describeTopology());
+        await this.consumption.started();
+    }
+    describeTopology() {
+        return topologyOf(topologySettingsOf(this.settings), this.consumption.bindings());
+    }
+    /**
+     * Moves up to `limit` messages of a consumer from the dead-letter stream back to the
+     * subject they came from, for that consumer only and with a fresh attempt budget. Returns
+     * how many were moved.
+     */
+    async replayDead(binding, limit = 100) {
+        const { stream, subjectPrefix } = this.settings;
+        const { durable, subject, deadSubject } = bindingNamesOf(binding, subjectPrefix);
+        const { streams, direct } = await jetstreamManager(await this.link.opened());
+        let replayed = 0;
+        for (let seq = 1; replayed < limit; replayed += 1) {
+            const dead = await direct.getMessage(deadStreamOf(stream), { seq, next_by_subj: deadSubject });
+            if (dead === null) {
+                break;
+            }
+            // A message id of its own: inside the duplicate window the original id would drop it.
+            const copy = { data: dead.data, headers: dead.header, messageId: `${durable}.replay.${String(dead.seq)}` };
+            await this.publications.send(subject, republication(copy, { [REPLAY_FOR_HEADER]: durable }));
+            await streams.deleteMessage(deadStreamOf(stream), dead.seq);
+            seq = dead.seq + 1;
+        }
+        return replayed;
+    }
+    /** Stops consuming, waits for the handlers in flight and their acknowledgements, disconnects. */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        await this.consumption.drain();
+        await this.link.close();
+        this.publications.detach();
+    }
+    /** 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 durable consumer 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 {
+        stream: settings.stream,
+        subjectPrefix: settings.subjectPrefix,
+        storage: settings.storage,
+        replicas: settings.replicas,
+        duplicateWindowMs: settings.duplicateWindowMs,
+        ackWaitMs: settings.ackWaitMs,
+        maxAttempts: settings.retry.maxAttempts,
+    };
+}
+//# sourceMappingURL=nats-event-bus.js.map

package/dist/nats-event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-event-bus.js","sourceRoot":"","sources":["../src/nats-event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAQlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AACrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAGzE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAGvD,MAAM,WAAW,GAAG,qCAAqC,CAAC;AAE1D;;;;;;;;;GASG;AACH,MAAM,OAAO,YAAY;IACvB,6EAA6E;IACpE,eAAe,GAAG,gBAAgB,CAAC;IAE3B,QAAQ,CAAW;IAEnB,IAAI,CAAa;IAEjB,YAAY,CAAe;IAE3B,WAAW,CAAc;IAElC,MAAM,GAAG,KAAK,CAAC;IAEvB,YAAY,OAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEpD,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE;YACpD,GAAG,IAAI,CAAC,QAAQ;YAChB,QAAQ,EAAE,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC;YAC3C,YAAY,EAAE,GAAG,EAAE;gBACjB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACtB,CAAC;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE;YACxC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;gBAC3B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBACrC,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;YACD,IAAI,EAAE,GAAG,EAAE;gBACT,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YAC5B,CAAC;YACD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACf,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,2EAA2E;IAC3E,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,MAAmC;QAC/C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,uFAAuF;QACvF,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,8DAA8D;IAC9D,SAAS,CAAC,IAAY,EAAE,OAAiC;QACvD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,IAAI,yBAAyB,EAAE,CAAC;QACxC,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED,6EAA6E;IAC7E,WAAW,CAAC,QAAgB;QAC1B,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,yBAAyB,EAAE,CAAC;QACxC,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC;IACrF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAEjE,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC;QACxD,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;IACnC,CAAC;IAED,gBAAgB;QACd,OAAO,UAAU,CAAC,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC;IACpF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,OAAwB,EAAE,KAAK,GAAG,GAAG;QACpD,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QAChD,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,cAAc,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QACjF,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7E,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,QAAQ,GAAG,KAAK,EAAE,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;YAE/F,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAClB,MAAM;YACR,CAAC;YAED,sFAAsF;YACtF,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,WAAW,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YAE3G,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YAC7F,MAAM,OAAO,CAAC,aAAa,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YAC5D,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;QACrB,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,iGAAiG;IACjG,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAC/B,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED,6EAA6E;IAC7E,MAAM;QACJ,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,uEAAuE;IACvE,CAAC,OAAO,CAAC,MAAM,CAAC;QACd,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,mGAAmG;IAC3F,OAAO,CAAC,OAAwB,EAAE,OAAiC;QACzE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAE5D,6EAA6E;QAC7E,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAE/C,OAAO,YAAY,CAAC;IACtB,CAAC;CACF;AAED,SAAS,kBAAkB,CAAC,QAAkB;IAC5C,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;QAC7C,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW;KACxC,CAAC;AACJ,CAAC"}

package/dist/options/nats-delivery.d.ts

@@ -0,0 +1,14 @@
+/** One message settled by a consumer of this bus. Counted by outcome, it is the metric to watch. */
+export interface NatsDelivery {
+    /** The durable consumer the message was delivered to. */
+    readonly consumer: string;
+    /** Which delivery of the message this was, starting at 1: the delivery count of the server. */
+    readonly attempt: number;
+    /**
+     * `acknowledged`: every handler resolved. `retried`: refused with a delay, the server
+     * delivers it again. `dead`: attempts spent, copied to the dead-letter stream and
+     * terminated. `poison`: not an envelope, copied there too.
+     */
+    readonly outcome: 'acknowledged' | 'retried' | 'dead' | 'poison';
+}
+//# sourceMappingURL=nats-delivery.d.ts.map

package/dist/options/nats-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-delivery.d.ts","sourceRoot":"","sources":["../../src/options/nats-delivery.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+FAA+F;IAC/F,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;CAClE"}

package/dist/options/nats-delivery.js

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

package/dist/options/nats-delivery.js.map

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

package/dist/options/nats-event-bus-options.d.ts

@@ -0,0 +1,40 @@
+import type { NatsConnection, NodeConnectionOptions } from '@nats-io/transport-node';
+import type { NatsDelivery } from './nats-delivery.js';
+import type { NatsFailure } from './nats-failure.js';
+import type { ReconnectOptions } from './reconnect-options.js';
+import type { RetryOptions } from './retry-options.js';
+import type { StreamStorage } from './stream-storage.js';
+export declare const DEFAULT_STREAM = "integration-events";
+export declare const DEFAULT_SUBJECT_PREFIX = "events";
+export interface NatsEventBusOptions {
+    /**
+     * Server URLs, connection options of the client, or a factory opening a NEW connection each
+     * time it is called (credentials, TLS). The bus owns what it opens and closes it.
+     */
+    readonly connection: string | readonly string[] | NodeConnectionOptions | (() => Promise<NatsConnection>);
+    /** The stream that keeps the events. Default `integration-events`. */
+    readonly stream?: string;
+    /** Events are published to `<subjectPrefix>.<event type>`. Default `events`. */
+    readonly subjectPrefix?: string;
+    /** The consuming context `subscribe` creates its durable consumers for. See also `forConsumer`. */
+    readonly consumer?: string;
+    /** Messages of one durable consumer this bus handles at once. Default 10. */
+    readonly prefetch?: number;
+    /** Default `file`. */
+    readonly storage?: StreamStorage;
+    /** Replicas of the streams the bus creates. Default 1; use 3 on a cluster. */
+    readonly replicas?: number;
+    /** Time during which the stream drops a second message with the same event id. Default 120000. */
+    readonly duplicateWindowMs?: number;
+    /** Time a handler has before the server delivers its message to someone else. Default 30000. */
+    readonly ackWaitMs?: number;
+    /** Time the stream has to acknowledge a publication before `publish` rejects. Default 5000. */
+    readonly publishTimeoutMs?: number;
+    readonly retry?: RetryOptions;
+    readonly reconnect?: ReconnectOptions;
+    /** Observability hook. It receives codes only, so it is safe to log as is. */
+    readonly onFailure?: (failure: NatsFailure) => void;
+    /** Metrics hook, called once per message a consumer settles, before it is acknowledged. */
+    readonly onDelivery?: (delivery: NatsDelivery) => void;
+}
+//# sourceMappingURL=nats-event-bus-options.d.ts.map

package/dist/options/nats-event-bus-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-event-bus-options.d.ts","sourceRoot":"","sources":["../../src/options/nats-event-bus-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,eAAO,MAAM,cAAc,uBAAuB,CAAC;AACnD,eAAO,MAAM,sBAAsB,WAAW,CAAC;AAE/C,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,qBAAqB,GAAG,CAAC,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;IAC1G,sEAAsE;IACtE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,mGAAmG;IACnG,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,kGAAkG;IAClG,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,gGAAgG;IAChG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+FAA+F;IAC/F,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACpD,2FAA2F;IAC3F,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;CACxD"}

package/dist/options/nats-event-bus-options.js

@@ -0,0 +1,3 @@
+export const DEFAULT_STREAM = 'integration-events';
+export const DEFAULT_SUBJECT_PREFIX = 'events';
+//# sourceMappingURL=nats-event-bus-options.js.map

package/dist/options/nats-event-bus-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-event-bus-options.js","sourceRoot":"","sources":["../../src/options/nats-event-bus-options.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC;AACnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,QAAQ,CAAC"}

package/dist/options/nats-failure.d.ts

@@ -0,0 +1,17 @@
+export type NatsFailure = {
+    readonly kind: 'handler';
+    readonly consumer: string;
+    readonly eventId: string;
+    readonly eventType: string;
+    readonly code: string;
+    readonly attempt: number;
+    readonly dead: boolean;
+} | {
+    readonly kind: 'poison';
+    readonly consumer: string;
+    readonly code: string;
+} | {
+    readonly kind: 'connection';
+    readonly code: string;
+};
+//# sourceMappingURL=nats-failure.d.ts.map

package/dist/options/nats-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nats-failure.d.ts","sourceRoot":"","sources":["../../src/options/nats-failure.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7E;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/options/nats-failure.js

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

package/dist/options/nats-failure.js.map

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

package/dist/options/reconnect-options.d.ts

@@ -0,0 +1,9 @@
+export interface ReconnectOptions {
+    /** Delay before the first reconnection attempt. Default 200. */
+    readonly initialMs?: number;
+    /** Multiplier applied at each further attempt to open a first connection. Default 2. */
+    readonly factor?: number;
+    /** Upper bound of the delay. Default 30000. */
+    readonly maxMs?: number;
+}
+//# sourceMappingURL=reconnect-options.d.ts.map

package/dist/options/reconnect-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconnect-options.d.ts","sourceRoot":"","sources":["../../src/options/reconnect-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,gEAAgE;IAChE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/options/reconnect-options.js

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

package/dist/options/reconnect-options.js.map

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

package/dist/options/retry-options.d.ts

@@ -0,0 +1,7 @@
+export interface RetryOptions {
+    /** Deliveries after which a message goes to the dead-letter stream. Default 5. */
+    readonly maxAttempts?: number;
+    /** Time the server waits before it delivers a failed message again. Default 5000. */
+    readonly delayMs?: number;
+}
+//# sourceMappingURL=retry-options.d.ts.map

package/dist/options/retry-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-options.d.ts","sourceRoot":"","sources":["../../src/options/retry-options.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,kFAAkF;IAClF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/options/retry-options.js

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

package/dist/options/retry-options.js.map

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

package/dist/options/settings-of.d.ts

@@ -0,0 +1,5 @@
+import type { NatsConnection, NodeConnectionOptions } from '@nats-io/transport-node';
+import { type NatsEventBusOptions } from './nats-event-bus-options.js';
+import type { Settings } from './settings.js';
+export declare function settingsOf(options: NatsEventBusOptions, connect: (target: NodeConnectionOptions) => Promise<NatsConnection>): Settings;
+//# sourceMappingURL=settings-of.d.ts.map

package/dist/options/settings-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-of.d.ts","sourceRoot":"","sources":["../../src/options/settings-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrF,OAAO,EAA0C,KAAK,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAG/G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,wBAAgB,UAAU,CACxB,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,OAAO,CAAC,cAAc,CAAC,GAClE,QAAQ,CAoBV"}

package/dist/options/settings-of.js

@@ -0,0 +1,55 @@
+import { DEFAULT_STREAM, DEFAULT_SUBJECT_PREFIX } from './nats-event-bus-options.js';
+export function settingsOf(options, connect) {
+    const reconnect = reconnectOf(options.reconnect);
+    const { connection } = options;
+    return {
+        open: typeof connection === 'function' ? connection : () => connect(targetOf(connection, reconnect)),
+        stream: options.stream ?? DEFAULT_STREAM,
+        subjectPrefix: options.subjectPrefix ?? DEFAULT_SUBJECT_PREFIX,
+        consumer: options.consumer,
+        prefetch: options.prefetch ?? 10,
+        storage: options.storage ?? 'file',
+        replicas: options.replicas ?? 1,
+        duplicateWindowMs: options.duplicateWindowMs ?? 120_000,
+        ackWaitMs: options.ackWaitMs ?? 30_000,
+        publishTimeoutMs: options.publishTimeoutMs ?? 5_000,
+        retry: retryOf(options.retry),
+        reconnect,
+        onFailure: guarded(options.onFailure),
+        onDelivery: guarded(options.onDelivery),
+    };
+}
+// The client reconnects by itself, for ever unless told otherwise: the bus only has to open
+// the first connection, and another one if the client gives up.
+function targetOf(connection, reconnect) {
+    const given = typeof connection === 'string' || isList(connection) ? { servers: [...asList(connection)] } : connection;
+    return { maxReconnectAttempts: -1, reconnectTimeWait: reconnect.initialMs, ...given };
+}
+function isList(connection) {
+    return Array.isArray(connection);
+}
+function asList(connection) {
+    return typeof connection === 'string' ? [connection] : connection;
+}
+function retryOf(retry = {}) {
+    return { maxAttempts: retry.maxAttempts ?? 5, delayMs: retry.delayMs ?? 5_000 };
+}
+function reconnectOf(reconnect = {}) {
+    return {
+        initialMs: reconnect.initialMs ?? 200,
+        factor: reconnect.factor ?? 2,
+        maxMs: reconnect.maxMs ?? 30_000,
+    };
+}
+// A hook that throws must not leave a message unacknowledged or stop a reconnection.
+function guarded(hook) {
+    return (value) => {
+        try {
+            hook?.(value);
+        }
+        catch {
+            return;
+        }
+    };
+}
+//# sourceMappingURL=settings-of.js.map

package/dist/options/settings-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-of.js","sourceRoot":"","sources":["../../src/options/settings-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAA4B,MAAM,6BAA6B,CAAC;AAK/G,MAAM,UAAU,UAAU,CACxB,OAA4B,EAC5B,OAAmE;IAEnE,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAE/B,OAAO;QACL,IAAI,EAAE,OAAO,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;QACpG,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,cAAc;QACxC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,sBAAsB;QAC9D,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;QAChC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM;QAClC,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;QAC/B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,OAAO;QACvD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM;QACtC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,KAAK;QACnD,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7B,SAAS;QACT,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;QACrC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC;KACxC,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,gEAAgE;AAChE,SAAS,QAAQ,CACf,UAA8D,EAC9D,SAAqC;IAErC,MAAM,KAAK,GACT,OAAO,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IAE3G,OAAO,EAAE,oBAAoB,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,SAAS,CAAC,SAAS,EAAE,GAAG,KAAK,EAAE,CAAC;AACxF,CAAC;AAED,SAAS,MAAM,CAAC,UAAmB;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,MAAM,CAAC,UAAsC;IACpD,OAAO,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;AACpE,CAAC;AAED,SAAS,OAAO,CAAC,KAAK,GAAiB,EAAE;IACvC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,EAAE,CAAC;AAClF,CAAC;AAED,SAAS,WAAW,CAAC,SAAS,GAAqB,EAAE;IACnD,OAAO;QACL,SAAS,EAAE,SAAS,CAAC,SAAS,IAAI,GAAG;QACrC,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,CAAC;QAC7B,KAAK,EAAE,SAAS,CAAC,KAAK,IAAI,MAAM;KACjC,CAAC;AACJ,CAAC;AAED,qFAAqF;AACrF,SAAS,OAAO,CAAI,IAAsC;IACxD,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}