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

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

@@ -0,0 +1,14 @@
+/**
+ * The in-sync replicas did not acknowledge the records in time: they may or may not be in
+ * the log. Publish again; consumers deduplicate on the event id.
+ */
+export declare class PublishNotAcknowledgedError extends Error {
+    /** The events of the send that failed; some of them may have been written. */
+    readonly eventIds: readonly string[];
+    readonly reason: string;
+    readonly code = "PUBLISH_NOT_ACKNOWLEDGED";
+    constructor(
+    /** The events of the send that failed; some of them may have been written. */
+    eventIds: readonly 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,8EAA8E;IAC9E,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM;IALzB,QAAQ,CAAC,IAAI,8BAA8B;IAE3C;IACE,8EAA8E;IACrE,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,MAAM,EAAE,MAAM,EAIxB;CACF"}

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

@@ -0,0 +1,18 @@
+/**
+ * The in-sync replicas did not acknowledge the records in time: they may or may not be in
+ * the log. Publish again; consumers deduplicate on the event id.
+ */
+export class PublishNotAcknowledgedError extends Error {
+    eventIds;
+    reason;
+    code = 'PUBLISH_NOT_ACKNOWLEDGED';
+    constructor(
+    /** The events of the send that failed; some of them may have been written. */
+    eventIds, reason) {
+        super(`The broker did not acknowledge ${String(eventIds.length)} event(s) (${reason})`);
+        this.eventIds = eventIds;
+        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;IAKzC,QAAQ;IACR,MAAM;IALR,IAAI,GAAG,0BAA0B,CAAC;IAE3C;IACE,8EAA8E;IACrE,QAA2B,EAC3B,MAAc;QAEvB,KAAK,CAAC,kCAAkC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,MAAM,GAAG,CAAC,CAAC;wBAH/E,QAAQ;sBACR,MAAM;QAGf,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;IAC5C,CAAC;CACF"}

package/dist/errors/reason-of.d.ts

@@ -0,0 +1,3 @@
+/** The code of a failure of the cluster, whether the bus already named it or the client raised it. */
+export declare function reasonOf(error: unknown): string;
+//# sourceMappingURL=reason-of.d.ts.map

package/dist/errors/reason-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reason-of.d.ts","sourceRoot":"","sources":["../../src/errors/reason-of.ts"],"names":[],"mappings":"AAIA,sGAAsG;AACtG,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM/C"}

package/dist/errors/reason-of.js

@@ -0,0 +1,11 @@
+import { BrokerUnavailableError } from './broker-unavailable-error.js';
+import { failureCode } from './failure-code.js';
+import { PublishNotAcknowledgedError } from './publish-not-acknowledged-error.js';
+/** The code of a failure of the cluster, whether the bus already named it or the client raised it. */
+export function reasonOf(error) {
+    if (error instanceof BrokerUnavailableError || error instanceof PublishNotAcknowledgedError) {
+        return error.reason;
+    }
+    return failureCode(error);
+}
+//# sourceMappingURL=reason-of.js.map

package/dist/errors/reason-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reason-of.js","sourceRoot":"","sources":["../../src/errors/reason-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAElF,sGAAsG;AACtG,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,KAAK,YAAY,sBAAsB,IAAI,KAAK,YAAY,2BAA2B,EAAE,CAAC;QAC5F,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC"}

package/dist/errors/within.d.ts

@@ -0,0 +1,3 @@
+/** Rejects with `BROKER_UNAVAILABLE` when `work` has not settled after `timeoutMs`. */
+export declare function within<T>(work: Promise<T>, timeoutMs: number, reason: string): Promise<T>;
+//# sourceMappingURL=within.d.ts.map

package/dist/errors/within.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"within.d.ts","sourceRoot":"","sources":["../../src/errors/within.ts"],"names":[],"mappings":"AAEA,uFAAuF;AACvF,wBAAsB,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAc/F"}

package/dist/errors/within.js

@@ -0,0 +1,17 @@
+import { BrokerUnavailableError } from './broker-unavailable-error.js';
+/** Rejects with `BROKER_UNAVAILABLE` when `work` has not settled after `timeoutMs`. */
+export async function within(work, timeoutMs, reason) {
+    let timer;
+    const expired = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => {
+            reject(new BrokerUnavailableError(reason));
+        }, timeoutMs);
+    });
+    try {
+        return await Promise.race([work, expired]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=within.js.map

package/dist/errors/within.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"within.js","sourceRoot":"","sources":["../../src/errors/within.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,uFAAuF;AACvF,MAAM,CAAC,KAAK,UAAU,MAAM,CAAI,IAAgB,EAAE,SAAiB,EAAE,MAAc;IACjF,IAAI,KAAgD,CAAC;IAErD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QACtD,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,MAAM,CAAC,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7C,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7C,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

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,20 @@
+export { KafkaEventBus } from './kafka-event-bus.js';
+export type { KafkaEventBusOptions } from './options/kafka-event-bus-options.js';
+export type { KafkaDelivery } from './options/kafka-delivery.js';
+export type { KafkaFailure } from './options/kafka-failure.js';
+export type { ReconnectOptions } from './options/reconnect-options.js';
+export type { RetryOptions } from './options/retry-options.js';
+export type { TopicOptions } from './options/topic-options.js';
+export { deadTopicOf } from './topology/dead-topic-of.js';
+export { replayGroupOf } from './topology/replay-group-of.js';
+export type { ConsumerBinding } from './topology/consumer-binding.js';
+export type { GroupDescription } from './topology/group-description.js';
+export type { KafkaTopology } from './topology/kafka-topology.js';
+export type { TopicDescription } from './topology/topic-description.js';
+export { ATTEMPT_HEADER, CORRELATION_HEADER, DEAD_REASON_HEADER, ERROR_CODE_HEADER, EVENT_ID_HEADER, EVENT_TYPE_HEADER, EVENT_VERSION_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,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,YAAY,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,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,10 @@
+export { KafkaEventBus } from './kafka-event-bus.js';
+export { deadTopicOf } from './topology/dead-topic-of.js';
+export { replayGroupOf } from './topology/replay-group-of.js';
+export { ATTEMPT_HEADER, CORRELATION_HEADER, DEAD_REASON_HEADER, ERROR_CODE_HEADER, EVENT_ID_HEADER, EVENT_TYPE_HEADER, EVENT_VERSION_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,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAOrD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAK9D,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,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/kafka-event-bus.d.ts

@@ -0,0 +1,58 @@
+import { inspect } from 'node:util';
+import type { EventBus, IntegrationEvent, IntegrationEventCallback, IntegrationEventSubscriber, Subscription } from '@ddd-ts-kit/kernel';
+import type { KafkaEventBusOptions } from './options/kafka-event-bus-options.js';
+import type { ConsumerBinding } from './topology/consumer-binding.js';
+import type { KafkaTopology } from './topology/kafka-topology.js';
+/**
+ * The provider for Apache Kafka and other logs speaking its protocol.
+ *
+ * Publishing: one topic per event type unless `topicOf` says otherwise, record key =
+ * `keyOf(event)`, an idempotent producer with `acks=all`, and `publish` resolves only when
+ * every record is acknowledged, so it is a safe target for the outbox relay. Consuming: one
+ * consumer group per consuming context, the offset committed after the handlers resolved, a
+ * bounded number of delayed retries in place, then a dead-letter topic. Delivery is at least
+ * once, in order for the records of one key: consumers deduplicate.
+ */
+export declare class KafkaEventBus implements EventBus {
+    /** Read by what observes the bus from outside: the name of the transport. */
+    readonly messagingSystem = "kafka";
+    private readonly settings;
+    private readonly link;
+    private readonly publications;
+    private readonly consumption;
+    private closed;
+    constructor(options: KafkaEventBusOptions);
+    /** Records delivered to this bus whose handlers have not finished yet. */
+    get deliveriesInFlight(): number;
+    /** Partitions the consumers of this bus own now: 0 means it consumes nothing. */
+    get partitionsAssigned(): number;
+    /**
+     * Resolves when every in-sync replica 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 clients of this bus. */
+    forConsumer(consumer: string): IntegrationEventSubscriber;
+    /**
+     * Creates the topics of the published types and of the subscriptions made so far, then
+     * resolves once those subscriptions have their partitions. Idempotent.
+     */
+    assertTopology(): Promise<void>;
+    describeTopology(): KafkaTopology;
+    /**
+     * Copies up to `limit` records from the dead-letter topic of a consumer back to the topic
+     * they came from, for that consumer only and with a fresh attempt budget. Returns how many.
+     */
+    replayDead({ consumer, type }: ConsumerBinding, limit?: number): Promise<number>;
+    /** Stops consuming, waits for the handlers and the acknowledgements in flight, disconnects. */
+    close(): Promise<void>;
+    /** What a serialisation shows of the bus: its name, never its clients or their properties. */
+    toJSON(): string;
+    /** What `console.log` and `util.inspect` show of the bus: the same. */
+    [inspect.custom](): string;
+    /** Adds a handler to the group of one consumer for one type; the group joins in the background. */
+    private consume;
+}
+//# sourceMappingURL=kafka-event-bus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kafka-event-bus.d.ts","sourceRoot":"","sources":["../src/kafka-event-bus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,EACV,QAAQ,EACR,gBAAgB,EAChB,wBAAwB,EACxB,0BAA0B,EAC1B,YAAY,EACb,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAMjF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAMlE;;;;;;;;;GASG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC5C,6EAA6E;IAC7E,QAAQ,CAAC,eAAe,WAAoB;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,oBAAoB,EAsBxC;IAED,0EAA0E;IAC1E,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,iFAAiF;IACjF,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhE;IAED,8DAA8D;IAC9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,YAAY,CAMvE;IAED,0EAA0E;IAC1E,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,0BAA0B,CAMxD;IAED;;;OAGG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAOpC;IAED,gBAAgB,IAAI,aAAa,CAEhC;IAED;;;OAGG;IACG,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,KAAK,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAYlF;IAED,+FAA+F;IACzF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAS3B;IAED,8FAA8F;IAC9F,MAAM,IAAI,MAAM,CAEf;IAED,uEAAuE;IACvE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM,CAEzB;IAED,mGAAmG;IACnG,OAAO,CAAC,OAAO;CAOhB"}

package/dist/kafka-event-bus.js

@@ -0,0 +1,147 @@
+import { inspect } from 'node:util';
+import { BrokerLink } from './connection/broker-link.js';
+import { clusterOf } from './connection/cluster-of.js';
+import { Consumption } from './consumption/consumption.js';
+import { GroupConsumer } from './consumption/group-consumer.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 { DeadLetterReplay } from './replay/dead-letter-replay.js';
+import { conceal } from './secrecy/conceal.js';
+import { describeTopic } from './topology/describe-topic.js';
+import { topologyOf } from './topology/topology-of.js';
+const DESCRIPTION = 'KafkaEventBus [clients concealed]';
+/**
+ * The provider for Apache Kafka and other logs speaking its protocol.
+ *
+ * Publishing: one topic per event type unless `topicOf` says otherwise, record key =
+ * `keyOf(event)`, an idempotent producer with `acks=all`, and `publish` resolves only when
+ * every record is acknowledged, so it is a safe target for the outbox relay. Consuming: one
+ * consumer group per consuming context, the offset committed after the handlers resolved, a
+ * bounded number of delayed retries in place, then a dead-letter topic. Delivery is at least
+ * once, in order for the records of one key: consumers deduplicate.
+ */
+export class KafkaEventBus {
+    /** Read by what observes the bus from outside: the name of the transport. */
+    messagingSystem = MESSAGING_SYSTEM;
+    settings;
+    link;
+    publications;
+    consumption;
+    closed = false;
+    constructor(options) {
+        const settings = settingsOf(options);
+        const topology = topologySettingsOf(settings);
+        this.settings = settings;
+        this.link = new BrokerLink(clusterOf(options), { ...settings, createTopics: settings.topics.create });
+        this.publications = new Publications(this.link, {
+            routing: settings,
+            describe: (topic) => describeTopic(topology, topic, 'events'),
+            failed: (code) => {
+                settings.onFailure({ kind: 'connection', code });
+            },
+        });
+        const dependencies = { link: this.link, publications: this.publications };
+        this.consumption = new Consumption((consumer) => new GroupConsumer(consumer, { ...dependencies, settings: { ...settings, topology } }));
+        conceal(this);
+    }
+    /** Records delivered to this bus whose handlers have not finished yet. */
+    get deliveriesInFlight() {
+        return this.consumption.inFlight;
+    }
+    /** Partitions the consumers of this bus own now: 0 means it consumes nothing. */
+    get partitionsAssigned() {
+        return this.consumption.partitionsAssigned;
+    }
+    /**
+     * Resolves when every in-sync replica acknowledged every event, rejects otherwise: nothing
+     * is buffered for later, so the caller (the outbox relay) knows what to retry.
+     */
+    async publish(events) {
+        if (this.closed) {
+            throw new EventBusClosedError();
+        }
+        if (events.length === 0) {
+            return;
+        }
+        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 clients of this bus. */
+    forConsumer(consumer) {
+        if (consumer.length === 0) {
+            throw new ConsumerNameRequiredError();
+        }
+        return { subscribe: (type, handler) => this.consume({ consumer, type }, handler) };
+    }
+    /**
+     * Creates the topics of the published types and of the subscriptions made so far, then
+     * resolves once those subscriptions have their partitions. Idempotent.
+     */
+    async assertTopology() {
+        if (this.closed) {
+            throw new EventBusClosedError();
+        }
+        await this.link.declare(this.describeTopology().topics);
+        await this.consumption.started();
+    }
+    describeTopology() {
+        return topologyOf(topologySettingsOf(this.settings), this.consumption.bindings());
+    }
+    /**
+     * Copies up to `limit` records from the dead-letter topic of a consumer back to the topic
+     * they came from, for that consumer only and with a fresh attempt budget. Returns how many.
+     */
+    async replayDead({ consumer, type }, limit = 100) {
+        if (this.closed) {
+            throw new EventBusClosedError();
+        }
+        const topic = this.settings.topicOf(type);
+        const timeoutMs = this.settings.connectTimeoutMs * 3;
+        const plan = { consumer, topic, limit, timeoutMs };
+        await this.link.declare(topologyOf(topologySettingsOf(this.settings), [{ consumer, type }]).topics);
+        return new DeadLetterReplay(this.link, this.publications, plan).run();
+    }
+    /** Stops consuming, waits for the handlers and the acknowledgements in flight, disconnects. */
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        await this.consumption.drain();
+        await this.publications.close();
+        await this.link.close();
+    }
+    /** What a serialisation shows of the bus: its name, never its clients or their properties. */
+    toJSON() {
+        return DESCRIPTION;
+    }
+    /** What `console.log` and `util.inspect` show of the bus: the same. */
+    [inspect.custom]() {
+        return DESCRIPTION;
+    }
+    /** Adds a handler to the group of one consumer for one type; the group joins in the background. */
+    consume(binding, handler) {
+        if (this.closed) {
+            throw new EventBusClosedError();
+        }
+        return this.consumption.add(binding, handler);
+    }
+}
+function topologySettingsOf(settings) {
+    return {
+        topicOf: settings.topicOf,
+        publishedTypes: settings.publishedTypes,
+        partitions: settings.topics.partitions,
+        replicationFactor: settings.topics.replicationFactor,
+    };
+}
+//# sourceMappingURL=kafka-event-bus.js.map

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

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

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 = "kafka";
+//# 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,UAAU,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 = 'kafka';
+//# 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,OAAO,CAAC"}

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

@@ -0,0 +1,15 @@
+/** One record settled by a consumer of this bus. Counted by outcome, it is the metric to watch. */
+export interface KafkaDelivery {
+    readonly consumer: string;
+    readonly topic: string;
+    readonly partition: number;
+    /** Which delivery of the record this was, starting at 1. */
+    readonly attempt: number;
+    /**
+     * `acknowledged`: every handler resolved, the offset is committed next. `retried`: the
+     * partition is paused for the delay, then the record is read again. `dead`: attempts spent,
+     * copied to the dead-letter topic. `poison`: not an envelope, copied there too.
+     */
+    readonly outcome: 'acknowledged' | 'retried' | 'dead' | 'poison';
+}
+//# sourceMappingURL=kafka-delivery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kafka-delivery.d.ts","sourceRoot":"","sources":["../../src/options/kafka-delivery.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,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/kafka-delivery.js

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

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

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

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

@@ -0,0 +1,42 @@
+import type { GlobalConfig } from '@confluentinc/kafka-javascript';
+import type { IntegrationEvent } from '@ddd-ts-kit/kernel';
+import type { KafkaDelivery } from './kafka-delivery.js';
+import type { KafkaFailure } from './kafka-failure.js';
+import type { ReconnectOptions } from './reconnect-options.js';
+import type { RetryOptions } from './retry-options.js';
+import type { TopicOptions } from './topic-options.js';
+export interface KafkaEventBusOptions {
+    /** Bootstrap brokers as `host:port`, in a list or separated by commas. */
+    readonly brokers: string | readonly string[];
+    /** librdkafka properties given to every client of the bus: TLS, SASL, `client.id`. */
+    readonly client?: GlobalConfig;
+    /** The consuming context `subscribe` works for: its name is the consumer group id. */
+    readonly consumer?: string;
+    /** The topic of an event type. Default: the type itself, one topic per event type. */
+    readonly topicOf?: (type: string) => string;
+    /**
+     * The record key: events with the same key keep their order. Default: the event id, which
+     * orders nothing. Give the aggregate id for per-aggregate order.
+     */
+    readonly keyOf?: (event: IntegrationEvent) => string | undefined;
+    /** Event types this service publishes: `assertTopology` creates their topics at startup. */
+    readonly publishedTypes?: readonly string[];
+    readonly topics?: TopicOptions;
+    /** Where a consumer group that has no committed offset starts. Default `earliest`. */
+    readonly startFrom?: 'earliest' | 'latest';
+    /** Partitions a consumer handles at once; records of one partition are never concurrent. Default 1. */
+    readonly concurrency?: number;
+    /** Time the in-sync replicas have to acknowledge a record before `publish` rejects. Default 30000. */
+    readonly publishTimeoutMs?: number;
+    /** Time a connection or an administrative request may take. Default 10000. */
+    readonly connectTimeoutMs?: number;
+    /** `max.poll.interval.ms`: above it, the handlers of one record lose their partitions. Default 300000. */
+    readonly maxHandlingMs?: number;
+    readonly retry?: RetryOptions;
+    readonly reconnect?: ReconnectOptions;
+    /** Observability hook. It receives codes only, so it is safe to log as is. */
+    readonly onFailure?: (failure: KafkaFailure) => void;
+    /** Metrics hook, called once per record a consumer settles, before its offset is committed. */
+    readonly onDelivery?: (delivery: KafkaDelivery) => void;
+}
+//# sourceMappingURL=kafka-event-bus-options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"kafka-event-bus-options.d.ts","sourceRoot":"","sources":["../../src/options/kafka-event-bus-options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC7C,sFAAsF;IACtF,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,sFAAsF;IACtF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,MAAM,GAAG,SAAS,CAAC;IACjE,4FAA4F;IAC5F,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC;IAC/B,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC;IAC3C,uGAAuG;IACvG,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,sGAAsG;IACtG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,0GAA0G;IAC1G,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,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,YAAY,KAAK,IAAI,CAAC;IACrD,+FAA+F;IAC/F,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;CACzD"}

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"kafka-failure.d.ts","sourceRoot":"","sources":["../../src/options/kafka-failure.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GACpB;IACE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,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,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrG;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/options/kafka-failure.js

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

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

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

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

@@ -0,0 +1,9 @@
+export interface ReconnectOptions {
+    /** Delay before a consumer that could not start, commit or dead-letter tries again. Default 200. */
+    readonly initialMs?: number;
+    /** Multiplier applied at each further attempt. 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,oGAAoG;IACpG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,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 record goes to the dead-letter topic. Default 5. */
+    readonly maxAttempts?: number;
+    /** Time the partition of a failed record stays paused before it is read 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,gFAAgF;IAChF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,gGAAgG;IAChG,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,4 @@
+import type { KafkaEventBusOptions } from './kafka-event-bus-options.js';
+import type { Settings } from './settings.js';
+export declare function settingsOf(options: KafkaEventBusOptions): 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,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAGzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,wBAAgB,UAAU,CAAC,OAAO,EAAE,oBAAoB,GAAG,QAAQ,CAiBlE"}

package/dist/options/settings-of.js

@@ -0,0 +1,47 @@
+export function settingsOf(options) {
+    return {
+        consumer: options.consumer,
+        topicOf: options.topicOf ?? ((type) => type),
+        keyOf: options.keyOf ?? ((event) => event.id),
+        publishedTypes: options.publishedTypes ?? [],
+        topics: topicsOf(options.topics),
+        startFromEarliest: options.startFrom !== 'latest',
+        concurrency: options.concurrency ?? 1,
+        publishTimeoutMs: options.publishTimeoutMs ?? 30_000,
+        connectTimeoutMs: options.connectTimeoutMs ?? 10_000,
+        maxHandlingMs: options.maxHandlingMs ?? 300_000,
+        retry: retryOf(options.retry),
+        reconnect: reconnectOf(options.reconnect),
+        onFailure: guarded(options.onFailure),
+        onDelivery: guarded(options.onDelivery),
+    };
+}
+function topicsOf(topics = {}) {
+    return {
+        partitions: topics.partitions ?? -1,
+        replicationFactor: topics.replicationFactor ?? -1,
+        create: topics.create ?? true,
+    };
+}
+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 record uncommitted or stop a consumer.
+function guarded(hook) {
+    return (value) => {
+        try {
+            hook?.(value);
+        }
+        catch {
+            return;
+        }
+    };
+}
+//# sourceMappingURL=settings-of.js.map