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

package/dist/options/settings.d.ts

@@ -0,0 +1,23 @@
+import type { NatsConnection } 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 interface Settings {
+    readonly open: () => Promise<NatsConnection>;
+    readonly stream: string;
+    readonly subjectPrefix: string;
+    readonly consumer: string | undefined;
+    readonly prefetch: number;
+    readonly storage: StreamStorage;
+    readonly replicas: number;
+    readonly duplicateWindowMs: number;
+    readonly ackWaitMs: number;
+    readonly publishTimeoutMs: number;
+    readonly retry: Required<RetryOptions>;
+    readonly reconnect: Required<ReconnectOptions>;
+    readonly onFailure: (failure: NatsFailure) => void;
+    readonly onDelivery: (delivery: NatsDelivery) => void;
+}
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/options/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,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,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACnD,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,CAAC;CACvD"}

package/dist/options/settings.js

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

package/dist/options/settings.js.map

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

package/dist/options/stream-storage.d.ts

@@ -0,0 +1,2 @@
+export type StreamStorage = 'file' | 'memory';
+//# sourceMappingURL=stream-storage.d.ts.map

package/dist/options/stream-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-storage.d.ts","sourceRoot":"","sources":["../../src/options/stream-storage.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,QAAQ,CAAC"}

package/dist/options/stream-storage.js

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

package/dist/options/stream-storage.js.map

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

package/dist/publication/publications.d.ts

@@ -0,0 +1,25 @@
+import type { NatsConnection } from '@nats-io/transport-node';
+import type { IntegrationEvent } from '@ddd-ts-kit/kernel';
+import type { Publication } from '../codec/publication.js';
+export interface PublicationSettings {
+    readonly subjectPrefix: string;
+    readonly publishTimeoutMs: number;
+}
+/**
+ * Publishing to JetStream: a publication succeeds only once the stream acknowledged the
+ * message as stored, which is what lets an outbox relay mark it published. The event id is
+ * the message id of the stream, so a second publication of the same event inside the
+ * duplicate window is acknowledged and dropped.
+ */
+export declare class Publications {
+    private readonly settings;
+    private client;
+    constructor(settings: PublicationSettings);
+    attach(connection: NatsConnection): void;
+    detach(): void;
+    /** Resolves when every event is acknowledged; rejects with the first failure otherwise. */
+    publish(events: readonly IntegrationEvent[]): Promise<void>;
+    /** One message to a subject a stream captures, acknowledged by that stream. */
+    send(subject: string, { data, messageId, headers }: Publication): Promise<void>;
+}
+//# sourceMappingURL=publications.d.ts.map

package/dist/publication/publications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publications.d.ts","sourceRoot":"","sources":["../../src/publication/publications.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,MAAM,CAA8B;IAE5C,YAA6B,QAAQ,EAAE,mBAAmB,EAAI;IAE9D,MAAM,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAEvC;IAED,MAAM,IAAI,IAAI,CAEb;IAED,2FAA2F;IACrF,OAAO,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhE;IAED,+EAA+E;IACzE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAYpF;CACF"}

package/dist/publication/publications.js

@@ -0,0 +1,47 @@
+import { jetstream } from '@nats-io/jetstream';
+import { encode } from '../codec/encode.js';
+import { BrokerUnavailableError } from '../errors/broker-unavailable-error.js';
+import { failureCode } from '../errors/failure-code.js';
+import { PublishNotAcknowledgedError } from '../errors/publish-not-acknowledged-error.js';
+/**
+ * Publishing to JetStream: a publication succeeds only once the stream acknowledged the
+ * message as stored, which is what lets an outbox relay mark it published. The event id is
+ * the message id of the stream, so a second publication of the same event inside the
+ * duplicate window is acknowledged and dropped.
+ */
+export class Publications {
+    settings;
+    client;
+    constructor(settings) {
+        this.settings = settings;
+    }
+    attach(connection) {
+        this.client = jetstream(connection);
+    }
+    detach() {
+        this.client = undefined;
+    }
+    /** Resolves when every event is acknowledged; rejects with the first failure otherwise. */
+    async publish(events) {
+        const outcomes = await Promise.allSettled(events.map((event) => this.send(`${this.settings.subjectPrefix}.${event.type}`, encode(event))));
+        for (const outcome of outcomes) {
+            if (outcome.status === 'rejected') {
+                throw outcome.reason;
+            }
+        }
+    }
+    /** One message to a subject a stream captures, acknowledged by that stream. */
+    async send(subject, { data, messageId, headers }) {
+        if (this.client === undefined) {
+            throw new BrokerUnavailableError('RECONNECTING');
+        }
+        const timeout = this.settings.publishTimeoutMs;
+        try {
+            await this.client.publish(subject, data, { msgID: messageId, headers, timeout });
+        }
+        catch (error) {
+            throw new PublishNotAcknowledgedError(messageId, failureCode(error));
+        }
+    }
+}
+//# sourceMappingURL=publications.js.map

package/dist/publication/publications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publications.js","sourceRoot":"","sources":["../../src/publication/publications.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAwB,MAAM,oBAAoB,CAAC;AAGrE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAO1F;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAGM,QAAQ;IAF7B,MAAM,CAA8B;IAE5C,YAA6B,QAA6B;wBAA7B,QAAQ;IAAwB,CAAC;IAE9D,MAAM,CAAC,UAA0B;QAC/B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;IAC1B,CAAC;IAED,2FAA2F;IAC3F,KAAK,CAAC,OAAO,CAAC,MAAmC;QAC/C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,UAAU,CACvC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAChG,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;gBAClC,MAAM,OAAO,CAAC,MAAM,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAe;QACnE,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,MAAM,IAAI,sBAAsB,CAAC,cAAc,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAE/C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,2BAA2B,CAAC,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;CACF"}

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-names-of.d.ts

@@ -0,0 +1,5 @@
+import type { BindingNames } from './binding-names.js';
+import type { ConsumerBinding } from './consumer-binding.js';
+/** A durable name holds neither dot nor wildcard: every other character becomes `_`. */
+export declare function bindingNamesOf({ consumer, type }: ConsumerBinding, subjectPrefix: string): BindingNames;
+//# sourceMappingURL=binding-names-of.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binding-names-of.d.ts","sourceRoot":"","sources":["../../src/topology/binding-names-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,CAQvG"}

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

@@ -0,0 +1,13 @@
+/** A durable name holds neither dot nor wildcard: every other character becomes `_`. */
+export function bindingNamesOf({ consumer, type }, subjectPrefix) {
+    const durable = `${sanitized(consumer)}_${sanitized(type)}`;
+    return {
+        durable,
+        subject: `${subjectPrefix}.${type}`,
+        deadSubject: `dead.${subjectPrefix}.${sanitized(consumer)}.${type}`,
+    };
+}
+function sanitized(name) {
+    return name.replaceAll(/[^A-Za-z0-9_-]/g, '_');
+}
+//# sourceMappingURL=binding-names-of.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binding-names-of.js","sourceRoot":"","sources":["../../src/topology/binding-names-of.ts"],"names":[],"mappings":"AAGA,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAmB,EAAE,aAAqB;IACvF,MAAM,OAAO,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;IAE5D,OAAO;QACL,OAAO;QACP,OAAO,EAAE,GAAG,aAAa,IAAI,IAAI,EAAE;QACnC,WAAW,EAAE,QAAQ,aAAa,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE;KACpE,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,UAAU,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,10 @@
+/** The names a binding has on the server. */
+export interface BindingNames {
+    /** The durable consumer: instances that share it share its messages. */
+    readonly durable: string;
+    /** The subject the events of the type are published to. */
+    readonly subject: string;
+    /** The subject, in the dead-letter stream, of what this consumer gave up on. */
+    readonly deadSubject: string;
+}
+//# sourceMappingURL=binding-names.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"binding-names.d.ts","sourceRoot":"","sources":["../../src/topology/binding-names.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gFAAgF;IAChF,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

package/dist/topology/binding-names.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"binding-names.js","sourceRoot":"","sources":["../../src/topology/binding-names.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/consumer-description.d.ts

@@ -0,0 +1,9 @@
+export interface ConsumerDescription {
+    readonly stream: string;
+    /** The durable name. */
+    readonly name: string;
+    readonly filterSubject: string;
+    readonly ackWaitMs: number;
+    readonly maxDeliver: number;
+}
+//# sourceMappingURL=consumer-description.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consumer-description.d.ts","sourceRoot":"","sources":["../../src/topology/consumer-description.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}

package/dist/topology/consumer-description.js

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

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

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

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

@@ -0,0 +1,2 @@
+export declare function deadStreamOf(stream: string): string;
+//# sourceMappingURL=dead-stream-of.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dead-stream-of.d.ts","sourceRoot":"","sources":["../../src/topology/dead-stream-of.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/topology/dead-stream-of.js

@@ -0,0 +1,4 @@
+export function deadStreamOf(stream) {
+    return `${stream}-dead`;
+}
+//# sourceMappingURL=dead-stream-of.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dead-stream-of.js","sourceRoot":"","sources":["../../src/topology/dead-stream-of.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,GAAG,MAAM,OAAO,CAAC;AAC1B,CAAC"}

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

@@ -0,0 +1,8 @@
+import { type JetStreamManager } from '@nats-io/jetstream';
+import type { NatsTopology } from './nats-topology.js';
+/**
+ * Idempotent. A stream that exists is never altered, whatever its limits; a durable consumer
+ * that exists takes the acknowledgement wait and the delivery limit of this bus.
+ */
+export declare function declareTopology(manager: JetStreamManager, topology: NatsTopology): 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,EAA0D,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGnH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAQtG"}

package/dist/topology/declare-topology.js

@@ -0,0 +1,58 @@
+import { AckPolicy, DeliverPolicy, RetentionPolicy, StorageType } from '@nats-io/jetstream';
+import { failureCode } from '../errors/failure-code.js';
+/**
+ * Idempotent. A stream that exists is never altered, whatever its limits; a durable consumer
+ * that exists takes the acknowledgement wait and the delivery limit of this bus.
+ */
+export async function declareTopology(manager, topology) {
+    for (const stream of topology.streams) {
+        await declareStream(manager, stream);
+    }
+    for (const consumer of topology.consumers) {
+        await declareConsumer(manager, consumer);
+    }
+}
+const STREAM_EXISTS_WITH_ANOTHER_CONFIGURATION = 'JETSTREAM_10058';
+const CONSUMER_EXISTS_WITH_ANOTHER_CONFIGURATION = 'JETSTREAM_10148';
+const NANOSECONDS_PER_MILLISECOND = 1_000_000;
+async function declareStream(manager, stream) {
+    try {
+        await manager.streams.add({
+            name: stream.name,
+            subjects: [...stream.subjects],
+            retention: RetentionPolicy.Limits,
+            storage: stream.storage === 'file' ? StorageType.File : StorageType.Memory,
+            num_replicas: stream.replicas,
+            duplicate_window: stream.duplicateWindowMs * NANOSECONDS_PER_MILLISECOND,
+            // Lets `replayDead` read the dead letters of one subject without a consumer.
+            allow_direct: true,
+        });
+    }
+    catch (error) {
+        if (failureCode(error) !== STREAM_EXISTS_WITH_ANOTHER_CONFIGURATION) {
+            throw error;
+        }
+    }
+}
+async function declareConsumer(manager, consumer) {
+    const limits = {
+        ack_wait: consumer.ackWaitMs * NANOSECONDS_PER_MILLISECOND,
+        max_deliver: consumer.maxDeliver,
+    };
+    try {
+        await manager.consumers.add(consumer.stream, {
+            durable_name: consumer.name,
+            filter_subject: consumer.filterSubject,
+            ack_policy: AckPolicy.Explicit,
+            deliver_policy: DeliverPolicy.All,
+            ...limits,
+        });
+    }
+    catch (error) {
+        if (failureCode(error) !== CONSUMER_EXISTS_WITH_ANOTHER_CONFIGURATION) {
+            throw error;
+        }
+        await manager.consumers.update(consumer.stream, consumer.name, limits);
+    }
+}
+//# 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":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAyB,MAAM,oBAAoB,CAAC;AACnH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAKxD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAyB,EAAE,QAAsB;IACrF,KAAK,MAAM,MAAM,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1C,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,MAAM,wCAAwC,GAAG,iBAAiB,CAAC;AACnE,MAAM,0CAA0C,GAAG,iBAAiB,CAAC;AACrE,MAAM,2BAA2B,GAAG,SAAS,CAAC;AAE9C,KAAK,UAAU,aAAa,CAAC,OAAyB,EAAE,MAAyB;IAC/E,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;YACxB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,QAAQ,EAAE,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC;YAC9B,SAAS,EAAE,eAAe,CAAC,MAAM;YACjC,OAAO,EAAE,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM;YAC1E,YAAY,EAAE,MAAM,CAAC,QAAQ;YAC7B,gBAAgB,EAAE,MAAM,CAAC,iBAAiB,GAAG,2BAA2B;YACxE,6EAA6E;YAC7E,YAAY,EAAE,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,wCAAwC,EAAE,CAAC;YACpE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,OAAyB,EAAE,QAA6B;IACrF,MAAM,MAAM,GAAG;QACb,QAAQ,EAAE,QAAQ,CAAC,SAAS,GAAG,2BAA2B;QAC1D,WAAW,EAAE,QAAQ,CAAC,UAAU;KACjC,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,EAAE;YAC3C,YAAY,EAAE,QAAQ,CAAC,IAAI;YAC3B,cAAc,EAAE,QAAQ,CAAC,aAAa;YACtC,UAAU,EAAE,SAAS,CAAC,QAAQ;YAC9B,cAAc,EAAE,aAAa,CAAC,GAAG;YACjC,GAAG,MAAM;SACV,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,CAAC,KAAK,CAAC,KAAK,0CAA0C,EAAE,CAAC;YACtE,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { ConsumerDescription } from './consumer-description.js';
+import type { StreamDescription } from './stream-description.js';
+/** Everything the bus creates on the server, as data: for documentation and reviews. */
+export interface NatsTopology {
+    readonly streams: readonly StreamDescription[];
+    readonly consumers: readonly ConsumerDescription[];
+}
+//# sourceMappingURL=nats-topology.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nats-topology.d.ts","sourceRoot":"","sources":["../../src/topology/nats-topology.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,wFAAwF;AACxF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD"}

package/dist/topology/nats-topology.js

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

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

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

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

@@ -0,0 +1,11 @@
+import type { StreamStorage } from '../options/stream-storage.js';
+export interface StreamDescription {
+    readonly name: string;
+    /** `events` keeps what is published, `dead` keeps what a consumer gave up on. */
+    readonly role: 'events' | 'dead';
+    readonly subjects: readonly string[];
+    readonly storage: StreamStorage;
+    readonly replicas: number;
+    readonly duplicateWindowMs: number;
+}
+//# sourceMappingURL=stream-description.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stream-description.d.ts","sourceRoot":"","sources":["../../src/topology/stream-description.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC"}

package/dist/topology/stream-description.js

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

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

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

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

@@ -0,0 +1,5 @@
+import type { ConsumerBinding } from './consumer-binding.js';
+import type { NatsTopology } from './nats-topology.js';
+import type { TopologySettings } from './topology-settings.js';
+export declare function topologyOf(settings: TopologySettings, bindings: readonly ConsumerBinding[]): NatsTopology;
+//# 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;AAG7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,YAAY,CAWzG"}

package/dist/topology/topology-of.js

@@ -0,0 +1,29 @@
+import { bindingNamesOf } from './binding-names-of.js';
+import { deadStreamOf } from './dead-stream-of.js';
+export function topologyOf(settings, bindings) {
+    const { stream, subjectPrefix, storage, replicas, duplicateWindowMs } = settings;
+    const shared = { storage, replicas, duplicateWindowMs };
+    return {
+        streams: [
+            { name: stream, role: 'events', subjects: [`${subjectPrefix}.>`], ...shared },
+            { name: deadStreamOf(stream), role: 'dead', subjects: [`dead.${subjectPrefix}.>`], ...shared },
+        ],
+        consumers: bindings.map((binding) => consumerOf(settings, binding)),
+    };
+}
+/**
+ * The bus parks a message at its `maxAttempts`-th failed delivery. The limit of the server
+ * is twice that: a delivery lost without a verdict (a crash, an expired acknowledgement
+ * wait) counts too, and must leave room for the message to be parked.
+ */
+function consumerOf(settings, binding) {
+    const names = bindingNamesOf(binding, settings.subjectPrefix);
+    return {
+        stream: settings.stream,
+        name: names.durable,
+        filterSubject: names.subject,
+        ackWaitMs: settings.ackWaitMs,
+        maxDeliver: settings.maxAttempts * 2,
+    };
+}
+//# 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":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAInD,MAAM,UAAU,UAAU,CAAC,QAA0B,EAAE,QAAoC;IACzF,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,QAAQ,CAAC;IACjF,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAExD,OAAO;QACL,OAAO,EAAE;YACP,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,GAAG,aAAa,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE;YAC7E,EAAE,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,aAAa,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE;SAC/F;QACD,SAAS,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;KACpE,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,UAAU,CAAC,QAA0B,EAAE,OAAwB;IACtE,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,aAAa,CAAC,CAAC;IAE9D,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,IAAI,EAAE,KAAK,CAAC,OAAO;QACnB,aAAa,EAAE,KAAK,CAAC,OAAO;QAC5B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,UAAU,EAAE,QAAQ,CAAC,WAAW,GAAG,CAAC;KACrC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { StreamStorage } from '../options/stream-storage.js';
+export interface TopologySettings {
+    readonly stream: string;
+    readonly subjectPrefix: string;
+    readonly storage: StreamStorage;
+    readonly replicas: number;
+    readonly duplicateWindowMs: number;
+    readonly ackWaitMs: number;
+    readonly maxAttempts: 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,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

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,41 @@
 {
   "name": "@ddd-ts-kit/nats",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "NATS JetStream provider for integration events: acknowledged publishing with message deduplication for the outbox relay, one durable consumer per consumer, explicit acknowledgement, bounded redelivery and a dead-letter subject.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gbourgeat/ddd-ts-kit.git",
+    "directory": "packages/nats"
+  },
+  "homepage": "https://github.com/gbourgeat/ddd-ts-kit/tree/main/packages/nats#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/events": "0.1.0",
+    "@ddd-ts-kit/kernel": "0.1.0"
+  },
+  "devDependencies": {
+    "@ddd-ts-kit/testing": "0.1.0",
+    "@nats-io/jetstream": "^3.4.0",
+    "@nats-io/transport-node": "^3.4.0"
+  },
+  "peerDependencies": {
+    "@nats-io/jetstream": ">=3.0.0 <4",
+    "@nats-io/transport-node": ">=3.0.0 <4"
+  }
+}