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

package/dist/connection/broker-link.js

@@ -0,0 +1,160 @@
+import { inspect } from 'node:util';
+import { BrokerUnavailableError } from '../errors/broker-unavailable-error.js';
+import { EventBusClosedError } from '../errors/event-bus-closed-error.js';
+import { failureCode } from '../errors/failure-code.js';
+import { ignore } from '../ignore.js';
+import { conceal } from '../secrecy/conceal.js';
+const DESCRIPTION = 'BrokerLink [connection concealed]';
+/**
+ * The one connection of a bus. The client reconnects by itself and resumes its consumers;
+ * the link opens the first connection, with a delay that grows with each failed attempt,
+ * knows when the server is away, and opens another connection if the client ever gives up.
+ */
+export class BrokerLink {
+    settings;
+    hooks;
+    connection;
+    opening;
+    retry;
+    failures = 0;
+    away = false;
+    closed = false;
+    constructor(settings, hooks) {
+        this.settings = settings;
+        this.hooks = hooks;
+        conceal(this);
+    }
+    /**
+     * The live connection. Opens the first one, joins an attempt in progress, and fails at
+     * once while the server is away so that a publisher never hangs on it.
+     */
+    async opened() {
+        if (this.closed) {
+            throw new EventBusClosedError();
+        }
+        if (this.connection !== undefined) {
+            return this.present(this.connection);
+        }
+        if (this.opening === undefined && this.retry === undefined) {
+            this.open();
+        }
+        if (this.opening === undefined) {
+            throw new BrokerUnavailableError('RECONNECTING');
+        }
+        return this.opening;
+    }
+    /** Drops the connection so that everything is rebuilt, after a consumer died on its own. */
+    restart() {
+        const connection = this.connection;
+        if (connection !== undefined) {
+            this.lost(connection);
+            void connection.close().catch(ignore);
+        }
+    }
+    /** Sends what is buffered, acknowledgements included, unless the server is away; disconnects. */
+    async close() {
+        this.closed = true;
+        clearTimeout(this.retry);
+        this.retry = undefined;
+        const connection = this.connection ?? (await this.opening?.catch(ignore));
+        this.connection = undefined;
+        if (!this.away) {
+            await connection?.flush().catch(ignore);
+        }
+        await connection?.close().catch(ignore);
+    }
+    toJSON() {
+        return DESCRIPTION;
+    }
+    [inspect.custom]() {
+        return DESCRIPTION;
+    }
+    present(connection) {
+        if (this.away) {
+            throw new BrokerUnavailableError('RECONNECTING');
+        }
+        return connection;
+    }
+    open() {
+        const opening = this.establish();
+        this.opening = opening;
+        void opening
+            .then(() => {
+            this.failures = 0;
+        }, (error) => {
+            this.failed(error instanceof BrokerUnavailableError ? error.reason : failureCode(error));
+        })
+            .finally(() => {
+            this.opening = undefined;
+        });
+    }
+    async establish() {
+        const connection = await this.connect();
+        try {
+            await this.hooks.opened(connection);
+        }
+        catch (error) {
+            this.hooks.lost();
+            await connection.close().catch(ignore);
+            throw new BrokerUnavailableError(failureCode(error));
+        }
+        if (this.closed) {
+            await connection.close().catch(ignore);
+            throw new EventBusClosedError();
+        }
+        this.away = false;
+        this.connection = connection;
+        void this.watch(connection);
+        return connection;
+    }
+    async connect() {
+        try {
+            return await this.settings.open();
+        }
+        catch (error) {
+            // Rethrown without its message or cause: a connection error may quote the URL.
+            throw new BrokerUnavailableError(failureCode(error));
+        }
+    }
+    async watch(connection) {
+        void connection.closed().then(() => {
+            this.lost(connection);
+        });
+        for await (const status of connection.status()) {
+            if (this.connection !== connection) {
+                return;
+            }
+            if (status.type === 'disconnect') {
+                this.away = true;
+                this.hooks.failed('CONNECTION_LOST');
+            }
+            else if (status.type === 'reconnect') {
+                this.away = false;
+            }
+        }
+    }
+    lost(connection) {
+        if (this.connection !== connection) {
+            return;
+        }
+        this.connection = undefined;
+        this.hooks.lost();
+        if (!this.closed) {
+            this.failed('CONNECTION_CLOSED');
+        }
+    }
+    failed(code) {
+        if (this.closed) {
+            return;
+        }
+        this.hooks.failed(code);
+        const { initialMs, factor, maxMs } = this.settings.reconnect;
+        const delay = Math.min(maxMs, initialMs * factor ** this.failures);
+        this.failures += 1;
+        this.retry = setTimeout(() => {
+            this.retry = undefined;
+            this.open();
+        }, delay);
+    }
+}
+//# sourceMappingURL=broker-link.js.map

package/dist/connection/broker-link.js.map

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

package/dist/consumption/consumption.d.ts

@@ -0,0 +1,56 @@
+import type { NatsConnection } from '@nats-io/transport-node';
+import type { IntegrationEventCallback, Subscription } from '@ddd-ts-kit/kernel';
+import type { NatsDelivery } from '../options/nats-delivery.js';
+import type { NatsFailure } from '../options/nats-failure.js';
+import type { RetryOptions } from '../options/retry-options.js';
+import type { Publications } from '../publication/publications.js';
+import type { ConsumerBinding } from '../topology/consumer-binding.js';
+import type { TopologySettings } from '../topology/topology-settings.js';
+export interface ConsumptionSettings {
+    readonly topology: TopologySettings;
+    readonly prefetch: number;
+    readonly retry: Required<RetryOptions>;
+    readonly onFailure: (failure: NatsFailure) => void;
+    readonly onDelivery: (delivery: NatsDelivery) => void;
+    /** Called when a consumer dies while the connection lives. */
+    readonly consumerLost: () => void;
+}
+/**
+ * The consuming side: one durable pull consumer per consumer and event type, an explicit
+ * acknowledgement once every handler resolved, and for a failure a refusal with a delay,
+ * then a copy to the dead-letter stream when the attempts are spent. A message is never
+ * delivered again at once: no hot loop.
+ */
+export declare class Consumption {
+    private readonly publications;
+    private readonly settings;
+    private readonly subscriptions;
+    private readonly starting;
+    private readonly handling;
+    private session;
+    constructor(publications: Publications, settings: ConsumptionSettings);
+    get inFlight(): number;
+    bindings(): ConsumerBinding[];
+    add(binding: ConsumerBinding, handler: IntegrationEventCallback): Subscription;
+    attach(connection: NatsConnection): Promise<void>;
+    detach(): void;
+    /** Resolves once the subscriptions made so far are consuming, or have failed to. */
+    started(): Promise<void>;
+    /** Stops taking messages, lets the handlers in progress finish and acknowledge. */
+    drain(): Promise<void>;
+    private subscriptionOf;
+    private startOrGiveUp;
+    private start;
+    /** Hands each message to the handlers, `prefetch` of them at once at most. */
+    private pump;
+    private process;
+    private handle;
+    private deliveryOf;
+    private buryPoison;
+    private retryOrBury;
+    /** Acknowledged copy to the dead-letter stream first, termination second: never lost in between. */
+    private bury;
+    private settled;
+    private remove;
+}
+//# sourceMappingURL=consumption.d.ts.map

package/dist/consumption/consumption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumption.d.ts","sourceRoot":"","sources":["../../src/consumption/consumption.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAmC,wBAAwB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAalH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAKzE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;IACtD,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC;CACnC;AAmBD;;;;;GAKG;AACH,qBAAa,WAAW;IAUpB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAV3B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0C;IAExE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAErD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IAErD,OAAO,CAAC,OAAO,CAAsB;IAErC,YACmB,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,mBAAmB,EAC5C;IAEJ,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,QAAQ,IAAI,eAAe,EAAE,CAE5B;IAED,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,wBAAwB,GAAG,YAAY,CAU7E;IAEK,MAAM,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtD;IAED,MAAM,IAAI,IAAI,CAMb;IAED,oFAAoF;IAC9E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAI7B;IAED,mFAAmF;IAC7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAS3B;IAED,OAAO,CAAC,cAAc;YAmBR,aAAa;YASb,KAAK;IAenB,8EAA8E;YAChE,IAAI;YAwBJ,OAAO;YAqBP,MAAM;IAapB,OAAO,CAAC,UAAU;YAUJ,UAAU;YAQV,WAAW;IAmBzB,oGAAoG;YACtF,IAAI;IAkBlB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,MAAM;CAWf"}

package/dist/consumption/consumption.js

@@ -0,0 +1,223 @@
+import { jetstream, jetstreamManager, } from '@nats-io/jetstream';
+import { decode } from '../codec/decode.js';
+import { ATTEMPT_HEADER, DEAD_REASON_HEADER, ERROR_CODE_HEADER, REPLAY_FOR_HEADER, SOURCE_HEADER, } from '../codec/headers.js';
+import { republication } from '../codec/republication.js';
+import { failureCode } from '../errors/failure-code.js';
+import { ignore } from '../ignore.js';
+import { MESSAGING_SYSTEM } from '../messaging-system.js';
+import { bindingNamesOf } from '../topology/binding-names-of.js';
+import { declareTopology } from '../topology/declare-topology.js';
+import { topologyOf } from '../topology/topology-of.js';
+import { failureOf } from './failure-of.js';
+import { POISON_MESSAGE } from './poison-message.js';
+import { track } from './track.js';
+/**
+ * The consuming side: one durable pull consumer per consumer and event type, an explicit
+ * acknowledgement once every handler resolved, and for a failure a refusal with a delay,
+ * then a copy to the dead-letter stream when the attempts are spent. A message is never
+ * delivered again at once: no hot loop.
+ */
+export class Consumption {
+    publications;
+    settings;
+    subscriptions = new Map();
+    starting = new Set();
+    handling = new Set();
+    session;
+    constructor(publications, settings) {
+        this.publications = publications;
+        this.settings = settings;
+    }
+    get inFlight() {
+        return this.handling.size;
+    }
+    bindings() {
+        return [...this.subscriptions.values()].map((subscription) => subscription.binding);
+    }
+    add(binding, handler) {
+        const subscription = this.subscriptionOf(binding);
+        subscription.handlers.add(handler);
+        return {
+            unsubscribe: () => {
+                this.remove(subscription, handler);
+            },
+        };
+    }
+    async attach(connection) {
+        const session = { client: jetstream(connection), manager: await jetstreamManager(connection) };
+        await declareTopology(session.manager, topologyOf(this.settings.topology, []));
+        // The map is iterated live: a subscription added meanwhile is started by this loop.
+        for (const subscription of this.subscriptions.values()) {
+            await this.start(session, subscription);
+        }
+        this.session = session;
+    }
+    detach() {
+        this.session = undefined;
+        for (const subscription of this.subscriptions.values()) {
+            subscription.messages = undefined;
+        }
+    }
+    /** Resolves once the subscriptions made so far are consuming, or have failed to. */
+    async started() {
+        while (this.starting.size > 0) {
+            await Promise.allSettled([...this.starting]);
+        }
+    }
+    /** Stops taking messages, lets the handlers in progress finish and acknowledge. */
+    async drain() {
+        this.session = undefined;
+        const pulls = [...this.subscriptions.values()].map((subscription) => stop(subscription));
+        await Promise.allSettled(pulls);
+        while (this.handling.size > 0) {
+            await Promise.allSettled([...this.handling]);
+        }
+    }
+    subscriptionOf(binding) {
+        const names = bindingNamesOf(binding, this.settings.topology.subjectPrefix);
+        const existing = this.subscriptions.get(names.durable);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const subscription = { binding, names, handlers: new Set(), messages: undefined };
+        this.subscriptions.set(names.durable, subscription);
+        if (this.session !== undefined) {
+            track(this.starting, this.startOrGiveUp(this.session, subscription));
+        }
+        return subscription;
+    }
+    async startOrGiveUp(session, subscription) {
+        try {
+            await this.start(session, subscription);
+        }
+        catch (error) {
+            this.settings.onFailure({ kind: 'connection', code: failureCode(error) });
+            this.settings.consumerLost();
+        }
+    }
+    async start(session, subscription) {
+        const { topology, prefetch } = this.settings;
+        await declareTopology(session.manager, {
+            streams: [],
+            consumers: topologyOf(topology, [subscription.binding]).consumers,
+        });
+        const consumer = await session.client.consumers.get(topology.stream, subscription.names.durable);
+        const messages = await consumer.consume({ max_messages: prefetch });
+        subscription.messages = messages;
+        void this.pump(subscription, messages);
+    }
+    /** Hands each message to the handlers, `prefetch` of them at once at most. */
+    async pump(subscription, messages) {
+        const running = new Set();
+        try {
+            for await (const message of messages) {
+                const work = this.process({ subscription, message });
+                track(running, work);
+                track(this.handling, work);
+                if (running.size >= this.settings.prefetch) {
+                    await Promise.race(running);
+                }
+            }
+        }
+        catch (error) {
+            this.settings.onFailure({ kind: 'connection', code: failureCode(error) });
+        }
+        if (subscription.messages === messages) {
+            // The pull ended by itself (consumer deleted, stream gone): rebuild everything.
+            this.settings.consumerLost();
+        }
+    }
+    async process(delivery) {
+        const { subscription, message } = delivery;
+        const target = message.headers?.get(REPLAY_FOR_HEADER) ?? '';
+        if (target !== '' && target !== subscription.names.durable) {
+            message.ack();
+            return;
+        }
+        const event = decode(message.data);
+        if (event === undefined) {
+            await this.buryPoison(delivery);
+        }
+        else if (subscription.handlers.size === 0) {
+            message.nak();
+        }
+        else {
+            await this.handle(delivery, event);
+        }
+    }
+    async handle(delivery, event) {
+        const code = await failureOf(delivery.subscription.handlers, event, this.deliveryOf(delivery));
+        if (code === undefined) {
+            this.settled(delivery, 'acknowledged');
+            delivery.message.ack();
+            return;
+        }
+        await this.retryOrBury(delivery, event, code);
+    }
+    deliveryOf({ subscription, message }) {
+        return {
+            attempt: message.info.deliveryCount,
+            maxAttempts: this.settings.retry.maxAttempts,
+            system: MESSAGING_SYSTEM,
+            destination: message.subject,
+            consumer: subscription.names.durable,
+        };
+    }
+    async buryPoison(delivery) {
+        const consumer = delivery.subscription.names.durable;
+        this.settings.onFailure({ kind: 'poison', consumer, code: POISON_MESSAGE });
+        this.settled(delivery, 'poison');
+        await this.bury(delivery, { [ERROR_CODE_HEADER]: POISON_MESSAGE, [DEAD_REASON_HEADER]: 'poison' });
+    }
+    async retryOrBury(delivery, event, code) {
+        const { retry, onFailure } = this.settings;
+        const consumer = delivery.subscription.names.durable;
+        const attempt = delivery.message.info.deliveryCount;
+        const dead = attempt >= retry.maxAttempts;
+        const { id: eventId, type: eventType } = event;
+        onFailure({ kind: 'handler', consumer, eventId, eventType, code, attempt, dead });
+        this.settled(delivery, dead ? 'dead' : 'retried');
+        if (dead) {
+            const headers = { [ERROR_CODE_HEADER]: code, [DEAD_REASON_HEADER]: 'max-attempts' };
+            await this.bury(delivery, { ...headers, [ATTEMPT_HEADER]: String(attempt) });
+        }
+        else {
+            delivery.message.nak(retry.delayMs);
+        }
+    }
+    /** Acknowledged copy to the dead-letter stream first, termination second: never lost in between. */
+    async bury({ subscription, message }, headers) {
+        const { stream } = this.settings.topology;
+        const { durable, deadSubject } = subscription.names;
+        const source = { [SOURCE_HEADER]: `${stream}/${String(message.seq)}` };
+        // A redelivery of the same message is the same dead letter: the stream keeps one.
+        const copy = { data: message.data, headers: message.headers, messageId: `${durable}.${String(message.seq)}` };
+        try {
+            await this.publications.send(deadSubject, republication(copy, { ...headers, ...source }));
+        }
+        catch {
+            message.nak(this.settings.retry.delayMs);
+            return;
+        }
+        message.term();
+    }
+    settled({ subscription, message }, outcome) {
+        const consumer = subscription.names.durable;
+        this.settings.onDelivery({ consumer, attempt: message.info.deliveryCount, outcome });
+    }
+    remove(subscription, handler) {
+        subscription.handlers.delete(handler);
+        if (subscription.handlers.size > 0) {
+            return;
+        }
+        // The durable consumer stays: it keeps its place in the stream, it only stopped reading.
+        this.subscriptions.delete(subscription.names.durable);
+        void stop(subscription);
+    }
+}
+async function stop(subscription) {
+    const { messages } = subscription;
+    subscription.messages = undefined;
+    await messages?.close().catch(ignore);
+}
+//# sourceMappingURL=consumption.js.map

package/dist/consumption/consumption.js.map

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

package/dist/consumption/failure-of.d.ts

@@ -0,0 +1,7 @@
+import type { EventDelivery, IntegrationEvent, IntegrationEventCallback } from '@ddd-ts-kit/kernel';
+/**
+ * Runs every handler, so one that fails does not starve the others; gives the first code. Each
+ * handler is told which delivery this is, for what observes it from outside.
+ */
+export declare function failureOf(handlers: ReadonlySet<IntegrationEventCallback>, event: IntegrationEvent, delivery: EventDelivery): Promise<string | undefined>;
+//# sourceMappingURL=failure-of.d.ts.map

package/dist/consumption/failure-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-of.d.ts","sourceRoot":"","sources":["../../src/consumption/failure-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAGpG;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,WAAW,CAAC,wBAAwB,CAAC,EAC/C,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B"}

package/dist/consumption/failure-of.js

@@ -0,0 +1,18 @@
+import { failureCode } from '../errors/failure-code.js';
+/**
+ * Runs every handler, so one that fails does not starve the others; gives the first code. Each
+ * handler is told which delivery this is, for what observes it from outside.
+ */
+export async function failureOf(handlers, event, delivery) {
+    let code;
+    for (const handler of [...handlers]) {
+        try {
+            await handler(event, delivery);
+        }
+        catch (error) {
+            code ??= failureCode(error);
+        }
+    }
+    return code;
+}
+//# sourceMappingURL=failure-of.js.map

package/dist/consumption/failure-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-of.js","sourceRoot":"","sources":["../../src/consumption/failure-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAExD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,QAA+C,EAC/C,KAAuB,EACvB,QAAuB;IAEvB,IAAI,IAAwB,CAAC;IAE7B,KAAK,MAAM,OAAO,IAAI,CAAC,GAAG,QAAQ,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/consumption/poison-message.d.ts

@@ -0,0 +1,3 @@
+/** The error code reported for a message whose body is not an envelope. */
+export declare const POISON_MESSAGE = "POISON_MESSAGE";
+//# sourceMappingURL=poison-message.d.ts.map

package/dist/consumption/poison-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poison-message.d.ts","sourceRoot":"","sources":["../../src/consumption/poison-message.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,eAAO,MAAM,cAAc,mBAAmB,CAAC"}

package/dist/consumption/poison-message.js

@@ -0,0 +1,3 @@
+/** The error code reported for a message whose body is not an envelope. */
+export const POISON_MESSAGE = 'POISON_MESSAGE';
+//# sourceMappingURL=poison-message.js.map

package/dist/consumption/poison-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poison-message.js","sourceRoot":"","sources":["../../src/consumption/poison-message.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,CAAC,MAAM,cAAc,GAAG,gBAAgB,CAAC"}

package/dist/consumption/track.d.ts

@@ -0,0 +1,3 @@
+/** Keeps `work` in `set` for as long as it is pending. */
+export declare function track(set: Set<Promise<void>>, work: Promise<void>): void;
+//# sourceMappingURL=track.d.ts.map

package/dist/consumption/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","sourceRoot":"","sources":["../../src/consumption/track.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAQxE"}

package/dist/consumption/track.js

@@ -0,0 +1,9 @@
+/** Keeps `work` in `set` for as long as it is pending. */
+export function track(set, work) {
+    set.add(work);
+    const done = () => {
+        set.delete(work);
+    };
+    void work.then(done, done);
+}
+//# sourceMappingURL=track.js.map

package/dist/consumption/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","sourceRoot":"","sources":["../../src/consumption/track.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,UAAU,KAAK,CAAC,GAAuB,EAAE,IAAmB;IAChE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC,CAAC;IAEF,KAAK,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/errors/broker-unavailable-error.d.ts

@@ -0,0 +1,8 @@
+/** No live connection: the first one failed, or a reconnection is pending. */
+export declare class BrokerUnavailableError extends Error {
+    readonly reason: string;
+    readonly code = "BROKER_UNAVAILABLE";
+    /** `reason` is the code of what made the server unreachable, never a message. */
+    constructor(reason: string);
+}
+//# sourceMappingURL=broker-unavailable-error.d.ts.map

package/dist/errors/broker-unavailable-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-unavailable-error.d.ts","sourceRoot":"","sources":["../../src/errors/broker-unavailable-error.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,qBAAa,sBAAuB,SAAQ,KAAK;IAInC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAHnC,QAAQ,CAAC,IAAI,wBAAwB;IAErC,iFAAiF;IACjF,YAAqB,MAAM,EAAE,MAAM,EAGlC;CACF"}

package/dist/errors/broker-unavailable-error.js

@@ -0,0 +1,12 @@
+/** No live connection: the first one failed, or a reconnection is pending. */
+export class BrokerUnavailableError extends Error {
+    reason;
+    code = 'BROKER_UNAVAILABLE';
+    /** `reason` is the code of what made the server unreachable, never a message. */
+    constructor(reason) {
+        super(`The broker is unavailable (${reason})`);
+        this.reason = reason;
+        this.name = 'BrokerUnavailableError';
+    }
+}
+//# sourceMappingURL=broker-unavailable-error.js.map

package/dist/errors/broker-unavailable-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-unavailable-error.js","sourceRoot":"","sources":["../../src/errors/broker-unavailable-error.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAI1B,MAAM;IAHlB,IAAI,GAAG,oBAAoB,CAAC;IAErC,iFAAiF;IACjF,YAAqB,MAAc;QACjC,KAAK,CAAC,8BAA8B,MAAM,GAAG,CAAC,CAAC;sBAD5B,MAAM;QAEzB,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF"}

package/dist/errors/consumer-name-required-error.d.ts

@@ -0,0 +1,5 @@
+export declare class ConsumerNameRequiredError extends Error {
+    readonly code = "CONSUMER_NAME_REQUIRED";
+    constructor();
+}
+//# sourceMappingURL=consumer-name-required-error.d.ts.map

package/dist/errors/consumer-name-required-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-name-required-error.d.ts","sourceRoot":"","sources":["../../src/errors/consumer-name-required-error.ts"],"names":[],"mappings":"AAAA,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,IAAI,4BAA4B;IAEzC,cAIC;CACF"}

package/dist/errors/consumer-name-required-error.js

@@ -0,0 +1,8 @@
+export class ConsumerNameRequiredError extends Error {
+    code = 'CONSUMER_NAME_REQUIRED';
+    constructor() {
+        super('Subscribing needs a consumer name: build the bus with `consumer`, or use `forConsumer(name)`');
+        this.name = 'ConsumerNameRequiredError';
+    }
+}
+//# sourceMappingURL=consumer-name-required-error.js.map

package/dist/errors/consumer-name-required-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-name-required-error.js","sourceRoot":"","sources":["../../src/errors/consumer-name-required-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,IAAI,GAAG,wBAAwB,CAAC;IAEzC;QACE,KAAK,CAAC,8FAA8F,CAAC,CAAC;QAEtG,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF"}

package/dist/errors/event-bus-closed-error.d.ts

@@ -0,0 +1,5 @@
+export declare class EventBusClosedError extends Error {
+    readonly code = "EVENT_BUS_CLOSED";
+    constructor();
+}
+//# sourceMappingURL=event-bus-closed-error.d.ts.map

package/dist/errors/event-bus-closed-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus-closed-error.d.ts","sourceRoot":"","sources":["../../src/errors/event-bus-closed-error.ts"],"names":[],"mappings":"AAAA,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,sBAAsB;IAEnC,cAGC;CACF"}

package/dist/errors/event-bus-closed-error.js

@@ -0,0 +1,8 @@
+export class EventBusClosedError extends Error {
+    code = 'EVENT_BUS_CLOSED';
+    constructor() {
+        super('The event bus is closed');
+        this.name = 'EventBusClosedError';
+    }
+}
+//# sourceMappingURL=event-bus-closed-error.js.map

package/dist/errors/event-bus-closed-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus-closed-error.js","sourceRoot":"","sources":["../../src/errors/event-bus-closed-error.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,IAAI,GAAG,kBAAkB,CAAC;IAEnC;QACE,KAAK,CAAC,yBAAyB,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/errors/failure-code.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 declare function failureCode(error: unknown): string;
+//# sourceMappingURL=failure-code.d.ts.map

package/dist/errors/failure-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-code.d.ts","sourceRoot":"","sources":["../../src/errors/failure-code.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAalD"}