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

package/dist/consumption/group-consumer.js

@@ -0,0 +1,145 @@
+import { reasonOf } from '../errors/reason-of.js';
+import { ignore } from '../ignore.js';
+import { topologyOf } from '../topology/topology-of.js';
+import { Backoff } from './backoff.js';
+import { postpone } from './postpone.js';
+import { RecordHandling } from './record-handling.js';
+import { Timers } from './timers.js';
+/**
+ * One consuming context: a member of the consumer group named after it. It joins the group,
+ * subscribes to the topics of its event types as they are added, starts again after a delay
+ * when the cluster fails it, and hands each record it reads to its `RecordHandling`.
+ */
+export class GroupConsumer {
+    name;
+    dependencies;
+    topics = new Set();
+    subscribed = new Set();
+    timers = new Timers();
+    backoff;
+    records;
+    client;
+    running = false;
+    work = Promise.resolve();
+    joined = Promise.resolve();
+    join = ignore;
+    draining = false;
+    constructor(name, dependencies) {
+        this.name = name;
+        this.dependencies = dependencies;
+        const { publications, settings } = dependencies;
+        this.backoff = new Backoff(settings.reconnect);
+        this.records = new RecordHandling(name, {
+            publications,
+            retry: settings.retry,
+            backoff: this.backoff,
+            timers: this.timers,
+            commit: async (position) => {
+                await this.client?.commitOffsets([position]);
+            },
+            onFailure: settings.onFailure,
+            onDelivery: settings.onDelivery,
+        });
+    }
+    get inFlight() {
+        return this.records.inFlight;
+    }
+    get partitionsAssigned() {
+        return this.client?.assignment().length ?? 0;
+    }
+    types() {
+        return this.records.types();
+    }
+    add(type, handler) {
+        const subscription = this.records.add(type, handler);
+        this.topics.add(this.dependencies.settings.topology.topicOf(type));
+        this.synchronize();
+        return subscription;
+    }
+    /** Resolves once the group has its partitions for the subscriptions made so far, or failed to. */
+    async started() {
+        await this.work;
+        await this.joined;
+    }
+    /** Stops reading, lets the handlers in progress finish and commit, leaves the group. */
+    async drain() {
+        this.draining = true;
+        this.timers.cancel();
+        this.records.abandonWaiting();
+        await this.work;
+        // The client stays until it has left: the handlers in progress still commit through it.
+        await this.client?.disconnect().catch(ignore);
+        this.client = undefined;
+    }
+    synchronize() {
+        this.work = this.work.then(() => this.subscribePending());
+    }
+    async subscribePending() {
+        const pending = [...this.topics].filter((topic) => !this.subscribed.has(topic));
+        if (this.draining || pending.length === 0) {
+            return;
+        }
+        try {
+            await this.dependencies.link.declare(this.topology().topics);
+            const client = await this.connected();
+            this.joined = new Promise((resolve) => {
+                this.join = resolve;
+            });
+            await client.subscribe({ topics: pending });
+            await this.run(client);
+            pending.forEach((topic) => this.subscribed.add(topic));
+            this.backoff.reset();
+        }
+        catch (error) {
+            this.restartLater(reasonOf(error));
+        }
+    }
+    topology() {
+        const bindings = this.types().map((type) => ({ consumer: this.name, type }));
+        return topologyOf({ ...this.dependencies.settings.topology, publishedTypes: [] }, bindings);
+    }
+    async connected() {
+        const { link } = this.dependencies;
+        this.client ??= await link.connected(link.consumer(this.name, (rebalance) => {
+            this.rebalanced(rebalance);
+        }));
+        return this.client;
+    }
+    rebalanced({ assigned, partitions }) {
+        if (assigned) {
+            this.join();
+            return;
+        }
+        this.records.forget(partitions);
+    }
+    async run(client) {
+        if (this.running) {
+            return;
+        }
+        this.running = true;
+        await client.run({
+            partitionsConsumedConcurrently: this.dependencies.settings.concurrency,
+            eachMessage: (delivery) => this.deliver(delivery),
+        });
+    }
+    async deliver(delivery) {
+        if (this.draining) {
+            postpone(delivery, ignore);
+        }
+        await this.records.deliver(delivery);
+    }
+    restartLater(code) {
+        this.dependencies.settings.onFailure({ kind: 'connection', code });
+        const client = this.client;
+        this.client = undefined;
+        this.running = false;
+        this.subscribed.clear();
+        void client?.disconnect().catch(ignore);
+        this.join();
+        this.timers.later(() => {
+            this.synchronize();
+        }, this.backoff.delayMs);
+        this.backoff.failed();
+    }
+}
+//# sourceMappingURL=group-consumer.js.map

package/dist/consumption/group-consumer.js.map

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

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

@@ -0,0 +1,3 @@
+/** The error code reported for a record whose value 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 record whose value 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/postpone.d.ts

@@ -0,0 +1,9 @@
+import type { KafkaJS } from '@confluentinc/kafka-javascript';
+type Delivery = KafkaJS.EachMessagePayload;
+/**
+ * Pauses the partition of the record and hands `release` the way to resume it. Throwing is
+ * how the client is told to read the record again instead of moving to the next one.
+ */
+export declare function postpone(delivery: Delivery, release: (resume: () => void) => void): never;
+export {};
+//# sourceMappingURL=postpone.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postpone.d.ts","sourceRoot":"","sources":["../../src/consumption/postpone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAI9D,KAAK,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,IAAI,KAAK,IAAI,GAAG,KAAK,CAGzF"}

package/dist/consumption/postpone.js

@@ -0,0 +1,30 @@
+import { ignore } from '../ignore.js';
+import { DeliveryPostponed } from './delivery-postponed.js';
+/**
+ * Pauses the partition of the record and hands `release` the way to resume it. Throwing is
+ * how the client is told to read the record again instead of moving to the next one.
+ */
+export function postpone(delivery, release) {
+    release(quietly(pausing(delivery)));
+    throw new DeliveryPostponed();
+}
+// Pausing or resuming a partition the group took back throws: the new owner reads the record.
+function pausing(delivery) {
+    try {
+        return delivery.pause();
+    }
+    catch {
+        return ignore;
+    }
+}
+function quietly(act) {
+    return () => {
+        try {
+            act();
+        }
+        catch {
+            return;
+        }
+    };
+}
+//# sourceMappingURL=postpone.js.map

package/dist/consumption/postpone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postpone.js","sourceRoot":"","sources":["../../src/consumption/postpone.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAI5D;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAkB,EAAE,OAAqC;IAChF,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,IAAI,iBAAiB,EAAE,CAAC;AAChC,CAAC;AAED,8FAA8F;AAC9F,SAAS,OAAO,CAAC,QAAkB;IACjC,IAAI,CAAC;QACH,OAAO,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,GAAe;IAC9B,OAAO,GAAG,EAAE;QACV,IAAI,CAAC;YACH,GAAG,EAAE,CAAC;QACR,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/consumption/record-handling.d.ts

@@ -0,0 +1,58 @@
+import type { KafkaJS } from '@confluentinc/kafka-javascript';
+import type { IntegrationEventCallback, Subscription } from '@ddd-ts-kit/kernel';
+import type { KafkaDelivery } from '../options/kafka-delivery.js';
+import type { KafkaFailure } from '../options/kafka-failure.js';
+import type { RetryOptions } from '../options/retry-options.js';
+import type { Publications } from '../publication/publications.js';
+import type { Backoff } from './backoff.js';
+import type { Timers } from './timers.js';
+export interface RecordHandlingDependencies {
+    readonly publications: Publications;
+    readonly retry: Required<RetryOptions>;
+    readonly backoff: Backoff;
+    readonly timers: Timers;
+    /** Commits the offset that follows a record, through the client of the group. */
+    readonly commit: (position: KafkaJS.TopicPartitionOffset) => Promise<void>;
+    readonly onFailure: (failure: KafkaFailure) => void;
+    readonly onDelivery: (delivery: KafkaDelivery) => void;
+}
+type Delivery = KafkaJS.EachMessagePayload;
+/**
+ * What a consuming context does with one record. An offset is committed once every handler
+ * of the record resolved, never before. A record whose handler fails keeps its place: its
+ * partition is paused for the delay and the record is read again, so the records of a key
+ * stay in order, and after the last attempt it is copied to the dead-letter topic and the
+ * partition moves on.
+ */
+export declare class RecordHandling {
+    private readonly consumer;
+    private readonly dependencies;
+    private readonly handlers;
+    private readonly attempts;
+    private readonly waitingForHandlers;
+    private handling;
+    constructor(consumer: string, dependencies: RecordHandlingDependencies);
+    get inFlight(): number;
+    types(): string[];
+    add(type: string, handler: IntegrationEventCallback): Subscription;
+    /** The group took these partitions back: their next owner counts the attempts again. */
+    forget(partitions: readonly KafkaJS.TopicPartition[]): void;
+    /** The records that wait for a handler stay where they are: the consumer is going away. */
+    abandonWaiting(): void;
+    deliver(delivery: Delivery): Promise<void>;
+    private resumeWaiting;
+    private process;
+    /** A replayed dead letter is on the topic for the one consumer that had given up on it. */
+    private isForAnotherConsumer;
+    private handle;
+    private deliveryOf;
+    private retryOrBury;
+    private buryPoison;
+    /** Acknowledged copy to the dead-letter topic first, commit second: never lost in between. */
+    private bury;
+    private commit;
+    private postponeAfter;
+    private settled;
+}
+export {};
+//# sourceMappingURL=record-handling.d.ts.map

package/dist/consumption/record-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-handling.d.ts","sourceRoot":"","sources":["../../src/consumption/record-handling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAmC,wBAAwB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAalH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,QAAQ,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;CACxD;AAED,KAAK,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC;AAE3C;;;;;;GAMG;AACH,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAV/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoD;IAE7E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAE3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAyB;IAE5D,OAAO,CAAC,QAAQ,CAAK;IAErB,YACmB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,0BAA0B,EACvD;IAEJ,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,KAAK,IAAI,MAAM,EAAE,CAEhB;IAED,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,YAAY,CAYjE;IAED,wFAAwF;IACxF,MAAM,CAAC,UAAU,EAAE,SAAS,OAAO,CAAC,cAAc,EAAE,GAAG,IAAI,CAI1D;IAED,2FAA2F;IAC3F,cAAc,IAAI,IAAI,CAErB;IAEK,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/C;IAED,OAAO,CAAC,aAAa;YAQP,OAAO;IA2BrB,2FAA2F;IAC3F,OAAO,CAAC,oBAAoB;YAMd,MAAM;IAmBpB,OAAO,CAAC,UAAU;YAUJ,WAAW;YAyBX,UAAU;IASxB,8FAA8F;YAChF,IAAI;YAaJ,MAAM;IAepB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,OAAO;CAMhB"}

package/dist/consumption/record-handling.js

@@ -0,0 +1,183 @@
+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 { sourceOf } from '../codec/source-of.js';
+import { textHeader } from '../codec/text-header.js';
+import { reasonOf } from '../errors/reason-of.js';
+import { MESSAGING_SYSTEM } from '../messaging-system.js';
+import { deadTopicOf } from '../topology/dead-topic-of.js';
+import { Attempts } from './attempts.js';
+import { failureOf } from './failure-of.js';
+import { POISON_MESSAGE } from './poison-message.js';
+import { postpone } from './postpone.js';
+/**
+ * What a consuming context does with one record. An offset is committed once every handler
+ * of the record resolved, never before. A record whose handler fails keeps its place: its
+ * partition is paused for the delay and the record is read again, so the records of a key
+ * stay in order, and after the last attempt it is copied to the dead-letter topic and the
+ * partition moves on.
+ */
+export class RecordHandling {
+    consumer;
+    dependencies;
+    handlers = new Map();
+    attempts = new Attempts();
+    waitingForHandlers = new Set();
+    handling = 0;
+    constructor(consumer, dependencies) {
+        this.consumer = consumer;
+        this.dependencies = dependencies;
+    }
+    get inFlight() {
+        return this.handling;
+    }
+    types() {
+        return [...this.handlers.keys()];
+    }
+    add(type, handler) {
+        const handlers = this.handlers.get(type) ?? new Set();
+        this.handlers.set(type, handlers.add(handler));
+        this.resumeWaiting();
+        return {
+            // The group keeps its place in the log: the consumer only stopped reading.
+            unsubscribe: () => {
+                handlers.delete(handler);
+            },
+        };
+    }
+    /** The group took these partitions back: their next owner counts the attempts again. */
+    forget(partitions) {
+        for (const partition of partitions) {
+            this.attempts.forget(partition);
+        }
+    }
+    /** The records that wait for a handler stay where they are: the consumer is going away. */
+    abandonWaiting() {
+        this.waitingForHandlers.clear();
+    }
+    async deliver(delivery) {
+        this.handling += 1;
+        try {
+            await this.process(delivery);
+        }
+        finally {
+            this.handling -= 1;
+        }
+    }
+    resumeWaiting() {
+        for (const resume of this.waitingForHandlers) {
+            resume();
+        }
+        this.waitingForHandlers.clear();
+    }
+    async process(delivery) {
+        if (this.isForAnotherConsumer(delivery)) {
+            await this.commit(delivery);
+            return;
+        }
+        const event = decode(delivery.message.value);
+        if (event === undefined) {
+            await this.buryPoison(delivery);
+            return;
+        }
+        const handlers = this.handlers.get(event.type);
+        if (handlers === undefined) {
+            // A type this consumer never subscribed to, on a topic that carries several.
+            await this.commit(delivery);
+            return;
+        }
+        await this.handle(delivery, event, handlers);
+    }
+    /** A replayed dead letter is on the topic for the one consumer that had given up on it. */
+    isForAnotherConsumer(delivery) {
+        const target = textHeader(delivery, REPLAY_FOR_HEADER);
+        return target !== undefined && target !== this.consumer;
+    }
+    async handle(delivery, event, handlers) {
+        if (handlers.size === 0) {
+            postpone(delivery, (resume) => this.waitingForHandlers.add(resume));
+        }
+        const code = await failureOf(handlers, event, this.deliveryOf(delivery));
+        if (code === undefined) {
+            this.settled(delivery, 'acknowledged');
+            await this.commit(delivery);
+        }
+        else {
+            await this.retryOrBury(delivery, event, code);
+        }
+    }
+    deliveryOf(delivery) {
+        return {
+            attempt: this.attempts.of(delivery),
+            maxAttempts: this.dependencies.retry.maxAttempts,
+            system: MESSAGING_SYSTEM,
+            destination: delivery.topic,
+            consumer: this.consumer,
+        };
+    }
+    async retryOrBury(delivery, event, code) {
+        const { retry, timers, onFailure } = this.dependencies;
+        const attempt = this.attempts.of(delivery);
+        const dead = attempt >= retry.maxAttempts;
+        const { id: eventId, type: eventType } = event;
+        const { consumer } = this;
+        onFailure({ kind: 'handler', consumer, topic: delivery.topic, 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) });
+            return;
+        }
+        this.attempts.failed(delivery);
+        postpone(delivery, (resume) => {
+            timers.later(resume, retry.delayMs);
+        });
+    }
+    async buryPoison(delivery) {
+        const { consumer } = this;
+        const { topic } = delivery;
+        this.dependencies.onFailure({ kind: 'poison', consumer, topic, code: POISON_MESSAGE });
+        this.settled(delivery, 'poison');
+        await this.bury(delivery, { [ERROR_CODE_HEADER]: POISON_MESSAGE, [DEAD_REASON_HEADER]: 'poison' });
+    }
+    /** Acknowledged copy to the dead-letter topic first, commit second: never lost in between. */
+    async bury(delivery, headers) {
+        const dead = deadTopicOf(this.consumer, delivery.topic);
+        const source = { [SOURCE_HEADER]: sourceOf(delivery) };
+        try {
+            await this.dependencies.publications.send(republication(delivery, dead, { ...headers, ...source }));
+        }
+        catch (error) {
+            this.postponeAfter(delivery, error);
+        }
+        await this.commit(delivery);
+    }
+    async commit(delivery) {
+        const { topic, partition, message } = delivery;
+        const offset = String(BigInt(message.offset) + 1n);
+        this.attempts.forget(delivery);
+        try {
+            await this.dependencies.commit({ topic, partition, offset });
+            this.dependencies.backoff.reset();
+        }
+        catch (error) {
+            this.postponeAfter(delivery, error);
+        }
+    }
+    // The partition must not move past a record that is neither committed nor parked.
+    postponeAfter(delivery, error) {
+        const { backoff, timers, onFailure } = this.dependencies;
+        onFailure({ kind: 'connection', code: reasonOf(error) });
+        const delay = backoff.delayMs;
+        backoff.failed();
+        postpone(delivery, (resume) => {
+            timers.later(resume, delay);
+        });
+    }
+    settled(delivery, outcome) {
+        const { topic, partition } = delivery;
+        const attempt = this.attempts.of(delivery);
+        this.dependencies.onDelivery({ consumer: this.consumer, topic, partition, attempt, outcome });
+    }
+}
+//# sourceMappingURL=record-handling.js.map

package/dist/consumption/record-handling.js.map

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

package/dist/consumption/timers.d.ts

@@ -0,0 +1,7 @@
+/** The delayed actions of a consumer, so that draining it cancels every one of them. */
+export declare class Timers {
+    private readonly pending;
+    later(act: () => void, delayMs: number): void;
+    cancel(): void;
+}
+//# sourceMappingURL=timers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timers.d.ts","sourceRoot":"","sources":["../../src/consumption/timers.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IAEpE,KAAK,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAO5C;IAED,MAAM,IAAI,IAAI,CAIb;CACF"}

package/dist/consumption/timers.js

@@ -0,0 +1,17 @@
+/** The delayed actions of a consumer, so that draining it cancels every one of them. */
+export class Timers {
+    pending = new Set();
+    later(act, delayMs) {
+        const timer = setTimeout(() => {
+            this.pending.delete(timer);
+            act();
+        }, delayMs);
+        this.pending.add(timer);
+    }
+    cancel() {
+        for (const timer of this.pending) {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=timers.js.map

package/dist/consumption/timers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.js","sourceRoot":"","sources":["../../src/consumption/timers.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,MAAM,OAAO,MAAM;IACA,OAAO,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEpE,KAAK,CAAC,GAAe,EAAE,OAAe;QACpC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,GAAG,EAAE,CAAC;QACR,CAAC,EAAE,OAAO,CAAC,CAAC;QAEZ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM;QACJ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,8 @@
+/** The cluster cannot be reached, or did not answer in time. */
+export declare class BrokerUnavailableError extends Error {
+    readonly reason: string;
+    readonly code = "BROKER_UNAVAILABLE";
+    /** `reason` is the code of what made the cluster 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,gEAAgE;AAChE,qBAAa,sBAAuB,SAAQ,KAAK;IAInC,QAAQ,CAAC,MAAM,EAAE,MAAM;IAHnC,QAAQ,CAAC,IAAI,wBAAwB;IAErC,kFAAkF;IAClF,YAAqB,MAAM,EAAE,MAAM,EAGlC;CACF"}

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

@@ -0,0 +1,12 @@
+/** The cluster cannot be reached, or did not answer in time. */
+export class BrokerUnavailableError extends Error {
+    reason;
+    code = 'BROKER_UNAVAILABLE';
+    /** `reason` is the code of what made the cluster 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,gEAAgE;AAChE,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAI1B,MAAM;IAHlB,IAAI,GAAG,oBAAoB,CAAC;IAErC,kFAAkF;IAClF,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,6 @@
+/**
+ * What may be reported about an error of the client. librdkafka names its errors in `type`
+ * (`ERR__MSG_TIMED_OUT`, `ERR_UNKNOWN_TOPIC_OR_PART`): that name is the code. 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;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAUlD"}

package/dist/errors/failure-code.js

@@ -0,0 +1,15 @@
+import { errorCode } from '@ddd-ts-kit/events';
+/**
+ * What may be reported about an error of the client. librdkafka names its errors in `type`
+ * (`ERR__MSG_TIMED_OUT`, `ERR_UNKNOWN_TOPIC_OR_PART`): that name is the code. Never the message.
+ */
+export function failureCode(error) {
+    if (typeof error === 'object' && error !== null && 'type' in error) {
+        const { type } = error;
+        if (typeof type === 'string' && /^ERR_[A-Z_]+$/.test(type)) {
+            return type;
+        }
+    }
+    return errorCode(error);
+}
+//# sourceMappingURL=failure-code.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"failure-code.js","sourceRoot":"","sources":["../../src/errors/failure-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;QACnE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QAEvB,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3D,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC"}