@drarzter/kafka-client 0.9.4 → 0.10.0

package/dist/client/errors.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Coerce an unknown thrown value to an `Error` instance.
+ * Returns the value as-is if it is already an `Error`; otherwise wraps it with `String(error)`.
+ * @param error The value caught in a `catch` clause.
+ * @returns A guaranteed `Error` instance.
+ */
+export declare function toError(error: unknown): Error;
+/**
+ * Error thrown when a consumer message handler fails.
+ * @example
+ * ```ts
+ * await kafka.startConsumer(['orders'], async (envelope) => {
+ *   try { await process(envelope); }
+ *   catch (err) {
+ *     if (err instanceof KafkaProcessingError) {
+ *       console.error(err.topic, err.originalMessage);
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export declare class KafkaProcessingError extends Error {
+    readonly topic: string;
+    readonly originalMessage: unknown;
+    readonly cause?: Error;
+    constructor(message: string, topic: string, originalMessage: unknown, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when schema validation fails on send or consume.
+ * @example
+ * ```ts
+ * try { await kafka.sendMessage('orders.created', invalidPayload); }
+ * catch (err) {
+ *   if (err instanceof KafkaValidationError) {
+ *     console.error('Validation failed for topic:', err.topic);
+ *   }
+ * }
+ * ```
+ */
+export declare class KafkaValidationError extends Error {
+    readonly topic: string;
+    readonly originalMessage: unknown;
+    readonly cause?: Error;
+    constructor(topic: string, originalMessage: unknown, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Error thrown when all retry attempts are exhausted for a message.
+ * @example
+ * ```ts
+ * const kafka = new KafkaClient(config, groupId, { onMessageLost: (ctx) => {
+ *   if (ctx.error instanceof KafkaRetryExhaustedError) {
+ *     console.error(`Exhausted after ${ctx.error.attempts} attempts on ${ctx.error.topic}`);
+ *   }
+ * }});
+ * ```
+ */
+export declare class KafkaRetryExhaustedError extends KafkaProcessingError {
+    readonly attempts: number;
+    constructor(topic: string, originalMessage: unknown, attempts: number, options?: {
+        cause?: Error;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAE7C;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAK3B,KAAK,EAAE,MAAM;aACb,eAAe,EAAE,OAAO;IAL1C,SAAiB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAG7B,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,OAAO,EACxC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAM9B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAI3B,KAAK,EAAE,MAAM;aACb,eAAe,EAAE,OAAO;IAJ1C,SAAiB,KAAK,CAAC,EAAE,KAAK,CAAC;gBAGb,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,OAAO,EACxC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAM9B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,wBAAyB,SAAQ,oBAAoB;aAI9C,QAAQ,EAAE,MAAM;gBAFhC,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,OAAO,EACR,QAAQ,EAAE,MAAM,EAChC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE;CAU9B"}

package/dist/client/kafka.client/admin/ops.d.ts

@@ -0,0 +1,114 @@
+import type { IAdmin } from "../../transport/transport.interface";
+type Admin = IAdmin;
+import type { ClientId, ConsumerGroupSummary, KafkaHealthResult, KafkaLogger, TopicDescription } from "../../types";
+export type AdminOpsDeps = {
+    admin: Admin;
+    logger: KafkaLogger;
+    runningConsumers: Map<string, "eachMessage" | "eachBatch">;
+    defaultGroupId: string;
+    clientId: ClientId;
+};
+export declare class AdminOps {
+    private readonly deps;
+    private isConnected;
+    constructor(deps: AdminOpsDeps);
+    /** Underlying admin client — used by index.ts for topic validation. */
+    get admin(): Admin;
+    /** Whether the admin client is currently connected. */
+    get connected(): boolean;
+    /**
+     * Connect the admin client if not already connected.
+     * The flag is only set to `true` after a successful connect — if `admin.connect()`
+     * throws the flag remains `false` so the next call will retry the connection.
+     */
+    ensureConnected(): Promise<void>;
+    /** Disconnect admin if connected. Resets the connected flag. */
+    disconnect(): Promise<void>;
+    resetOffsets(groupId: string | undefined, topic: string, position: "earliest" | "latest"): Promise<void>;
+    /**
+     * Seek specific topic-partition pairs to explicit offsets for a stopped consumer group.
+     * Throws if the group is still running — call `stopConsumer(groupId)` first.
+     * Assignments are grouped by topic and committed via `admin.setOffsets`.
+     */
+    seekToOffset(groupId: string | undefined, assignments: Array<{
+        topic: string;
+        partition: number;
+        offset: string;
+    }>): Promise<void>;
+    /**
+     * Seek specific topic-partition pairs to the offset nearest to a given timestamp
+     * (in milliseconds) for a stopped consumer group.
+     * Throws if the group is still running — call `stopConsumer(groupId)` first.
+     * Assignments are grouped by topic and committed via `admin.setOffsets`.
+     * If no offset exists at the requested timestamp (e.g. empty partition or
+     * future timestamp), the partition falls back to `-1` (end of topic — new messages only).
+     */
+    seekToTimestamp(groupId: string | undefined, assignments: Array<{
+        topic: string;
+        partition: number;
+        timestamp: number;
+    }>): Promise<void>;
+    /**
+     * Query consumer group lag per partition.
+     * Lag = broker high-watermark − last committed offset.
+     * A committed offset of -1 (nothing committed yet) counts as full lag.
+     *
+     * Returns an empty array when the consumer group has never committed any
+     * offsets (freshly created group, `autoCommit: false` with no manual commits,
+     * or group not yet assigned). This is a Kafka protocol limitation:
+     * `fetchOffsets` only returns data for topic-partitions that have at least one
+     * committed offset. Use `checkStatus()` to verify broker connectivity in that case.
+     */
+    getConsumerLag(groupId?: string): Promise<Array<{
+        topic: string;
+        partition: number;
+        lag: number;
+    }>>;
+    /** Check broker connectivity. Never throws — returns a discriminated union. */
+    checkStatus(): Promise<KafkaHealthResult>;
+    /**
+     * List all consumer groups known to the broker.
+     * Useful for monitoring which groups are active and their current state.
+     */
+    listConsumerGroups(): Promise<ConsumerGroupSummary[]>;
+    /**
+     * Describe topics — returns partition layout, leader, replicas, and ISR.
+     * @param topics Topic names to describe. Omit to describe all topics.
+     */
+    describeTopics(topics?: string[]): Promise<TopicDescription[]>;
+    /**
+     * Delete consumer groups from the broker.
+     * Groups must be empty (no active members) before deletion.
+     * Silently skips unknown group IDs.
+     * @param groupIds Consumer group IDs to delete.
+     */
+    deleteGroups(groupIds: string[]): Promise<void>;
+    /**
+     * Delete records from a topic up to (but not including) the given offsets.
+     * All messages with offsets **before** the given offset are deleted.
+     */
+    deleteRecords(topic: string, partitions: Array<{
+        partition: number;
+        offset: string;
+    }>): Promise<void>;
+    /**
+     * When `retryTopics: true` and `autoCreateTopics: false`, verify that every
+     * `<topic>.retry.<level>` topic already exists. Throws a clear error at startup
+     * rather than silently discovering missing topics on the first handler failure.
+     */
+    validateRetryTopicsExist(topicNames: string[], maxRetries: number): Promise<void>;
+    /**
+     * When `autoCreateTopics` is disabled, verify that `<topic>.dlq` exists for every
+     * consumed topic. Throws a clear error at startup rather than silently discovering
+     * missing DLQ topics on the first handler failure.
+     */
+    validateDlqTopicsExist(topicNames: string[]): Promise<void>;
+    /**
+     * When `deduplication.strategy: 'topic'` and `autoCreateTopics: false`, verify
+     * that every `<topic>.duplicates` destination topic already exists. Throws a
+     * clear error at startup rather than silently dropping duplicates on first hit.
+     */
+    validateDuplicatesTopicsExist(topicNames: string[], customDestination: string | undefined): Promise<void>;
+}
+export {};
+//# sourceMappingURL=ops.d.ts.map

package/dist/client/kafka.client/admin/ops.d.ts.map

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

package/dist/client/kafka.client/consumer/features/delayed.d.ts

@@ -0,0 +1,24 @@
+import type { KafkaClientContext } from "../../context";
+import type { TopicMapConstraint, ConsumerHandle } from "../../../types";
+/** Staging topic name for delayed messages of `topic`. */
+export declare function delayedTopicName(topic: string): string;
+/**
+ * Start a relay consumer that delivers messages produced with
+ * `SendOptions.deliverAfterMs` from `<topic>.delayed` to their target topic
+ * once their `x-delayed-until` deadline passes.
+ *
+ * Semantics mirror the retry-topic chain:
+ * - The partition is paused while waiting for the deadline; the offset is not
+ *   committed during the wait, so a crash redelivers the message (at-least-once).
+ * - Forwarding uses a Kafka transaction (produce to target + commit source
+ *   offset atomically), so no duplicates are relayed even on crash.
+ * - Delivery time is a lower bound — head-of-line waiting applies per partition.
+ *
+ * The relay preserves the original key, value, and headers (minus the
+ * `x-delayed-*` control headers), so envelope metadata (`x-event-id`,
+ * `x-correlation-id`, `x-lamport-clock`, `traceparent`) survives the hop.
+ */
+export declare function startDelayedRelayImpl<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>, topics: string[], options?: {
+    groupId?: string;
+}): Promise<ConsumerHandle>;
+//# sourceMappingURL=delayed.d.ts.map

package/dist/client/kafka.client/consumer/features/delayed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delayed.d.ts","sourceRoot":"","sources":["../../../../../src/client/kafka.client/consumer/features/delayed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AAYzF,0DAA0D;AAC1D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EACzE,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7B,OAAO,CAAC,cAAc,CAAC,CA6HzB"}

package/dist/client/kafka.client/consumer/features/dlq-replay.d.ts

@@ -0,0 +1,52 @@
+import type { IConsumer } from "../../../transport/transport.interface";
+type Consumer = IConsumer;
+import type { KafkaLogger, DlqReplayOptions } from "../../../types";
+/**
+ * Dependencies injected into `replayDlqTopic` by `KafkaClient`.
+ * Abstracts broker access (offset fetching, producing, consumer creation) so the
+ * replay logic can be unit-tested without a real Kafka connection.
+ */
+export type DlqReplayDeps = {
+    logger: KafkaLogger;
+    fetchTopicOffsets: (topic: string) => Promise<Array<{
+        partition: number;
+        low: string;
+        high: string;
+    }>>;
+    send: (topic: string, messages: Array<{
+        value: string;
+        headers: Record<string, string>;
+    }>) => Promise<void>;
+    /**
+     * Create a consumer for the given group.
+     * @param groupId Consumer group ID.
+     * @param fromBeginning When `true`, `auto.offset.reset=earliest` (no committed offsets on a temp group).
+     */
+    createConsumer: (groupId: string, fromBeginning: boolean) => Consumer;
+    /**
+     * Disconnect the consumer and, when `deleteGroup` is `true`, delete the group
+     * from the broker (used for ephemeral temp groups that should not accumulate).
+     */
+    cleanupConsumer: (consumer: Consumer, groupId: string, deleteGroup: boolean) => void;
+    dlqHeaderKeys: Set<string>;
+};
+/**
+ * Re-publish messages from a dead letter queue back to the original topic.
+ *
+ * Messages are consumed from `<topic>.dlq` and re-published to `<topic>`.
+ * The original topic is determined by the `x-dlq-original-topic` header.
+ * The `x-dlq-*` headers are stripped before re-publishing.
+ *
+ * ### Group ID strategy (driven by `options.fromBeginning`):
+ * - `fromBeginning: true` (default) — a new ephemeral group `<topic>.dlq-replay-<ts>` is used
+ *   on every call so there are no committed offsets; reads all messages from the beginning
+ *   every time. The group is deleted from the broker after the replay finishes.
+ * - `fromBeginning: false` — a stable group `<topic>.dlq-replay` is used; committed offsets
+ *   persist between calls so only messages added since the previous call are replayed.
+ */
+export declare function replayDlqTopic(topic: string, deps: DlqReplayDeps, options?: DlqReplayOptions): Promise<{
+    replayed: number;
+    skipped: number;
+}>;
+export {};
+//# sourceMappingURL=dlq-replay.d.ts.map

package/dist/client/kafka.client/consumer/features/dlq-replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq-replay.d.ts","sourceRoot":"","sources":["../../../../../src/client/kafka.client/consumer/features/dlq-replay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,KAAK,QAAQ,GAAG,SAAS,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIpE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAC;IACvG,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5G;;;;OAIG;IACH,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,KAAK,QAAQ,CAAC;IACtE;;;OAGG;IACH,eAAe,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,KAAK,IAAI,CAAC;IACrF,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAwFhD"}

package/dist/client/kafka.client/consumer/features/routed.d.ts

@@ -0,0 +1,4 @@
+import type { KafkaClientContext } from "../../context";
+import type { TopicMapConstraint, ConsumerOptions, ConsumerHandle, RoutingOptions } from "../../../types";
+export declare function startRoutedConsumerImpl<T extends TopicMapConstraint<T>, K extends Array<keyof T>>(ctx: KafkaClientContext<T>, topics: K, routing: RoutingOptions<T[K[number]]>, options?: ConsumerOptions<T>): Promise<ConsumerHandle>;
+//# sourceMappingURL=routed.d.ts.map

package/dist/client/kafka.client/consumer/features/routed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routed.d.ts","sourceRoot":"","sources":["../../../../../src/client/kafka.client/consumer/features/routed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,cAAc,EACf,MAAM,gBAAgB,CAAC;AAMxB,wBAAsB,uBAAuB,CAC3C,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAC/B,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,EAExB,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EACrC,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,cAAc,CAAC,CAezB"}

package/dist/client/kafka.client/consumer/features/snapshot.d.ts

@@ -0,0 +1,10 @@
+import type { KafkaClientContext } from "../../context";
+import type { TopicMapConstraint, ReadSnapshotOptions, CheckpointResult, CheckpointRestoreResult, RestoreCheckpointOptions } from "../../../types";
+import type { EventEnvelope } from "../../../message/envelope";
+/** Minimal context surface required by this module. */
+type SnapshotCtx<T extends TopicMapConstraint<T>> = Pick<KafkaClientContext<T>, "adminOps" | "clientId" | "defaultGroupId" | "transport" | "logger" | "producer" | "runningConsumers">;
+export declare function readSnapshotImpl<T extends TopicMapConstraint<T>, K extends keyof T & string>(ctx: SnapshotCtx<T>, topic: K, options?: ReadSnapshotOptions): Promise<Map<string, EventEnvelope<T[K]>>>;
+export declare function checkpointOffsetsImpl<T extends TopicMapConstraint<T>>(ctx: SnapshotCtx<T>, groupId: string | undefined, checkpointTopic: string): Promise<CheckpointResult>;
+export declare function restoreFromCheckpointImpl<T extends TopicMapConstraint<T>>(ctx: SnapshotCtx<T>, groupId: string | undefined, checkpointTopic: string, options?: RestoreCheckpointOptions): Promise<CheckpointRestoreResult>;
+export {};
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/client/kafka.client/consumer/features/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../../src/client/kafka.client/consumer/features/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EAEzB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI/D,uDAAuD;AACvD,KAAK,WAAW,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,IAAI,IAAI,CACtD,kBAAkB,CAAC,CAAC,CAAC,EACnB,UAAU,GACV,UAAU,GACV,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,UAAU,GACV,kBAAkB,CACrB,CAAC;AAIF,wBAAsB,gBAAgB,CACpC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAC/B,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAE1B,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,KAAK,EAAE,CAAC,EACR,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CA4E3C;AAkDD,wBAAsB,qBAAqB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EACzE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC,gBAAgB,CAAC,CAmC3B;AAID,wBAAsB,yBAAyB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAC7E,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAmJlC"}

package/dist/client/kafka.client/consumer/features/window.d.ts

@@ -0,0 +1,5 @@
+import type { KafkaClientContext } from "../../context";
+import type { TopicMapConstraint, WindowConsumerOptions, WindowMeta, ConsumerHandle } from "../../../types";
+import type { EventEnvelope } from "../../../message/envelope";
+export declare function startWindowConsumerImpl<T extends TopicMapConstraint<T>, K extends keyof T & string>(ctx: KafkaClientContext<T>, topic: K, handler: (envelopes: EventEnvelope<T[K]>[], meta: WindowMeta) => Promise<void>, options: WindowConsumerOptions<T>): Promise<ConsumerHandle>;
+//# sourceMappingURL=window.d.ts.map

package/dist/client/kafka.client/consumer/features/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../../../../src/client/kafka.client/consumer/features/window.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,EACV,cAAc,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAM/D,wBAAsB,uBAAuB,CAC3C,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAC/B,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAE1B,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC1B,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,EAC9E,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC,CAgFzB"}

package/dist/client/kafka.client/consumer/handler.d.ts

@@ -0,0 +1,149 @@
+import type { IProducer, IConsumer } from "../../transport/transport.interface";
+type Producer = IProducer;
+type Consumer = IConsumer;
+import type { EventEnvelope } from "../../message/envelope";
+import type { SchemaLike } from "../../message/topic";
+import type { BatchMeta, ConsumerInterceptor, DedupStore, DeduplicationOptions, DlqReason, KafkaClientOptions, KafkaInstrumentation, KafkaLogger, RetryOptions } from "../../types";
+/**
+ * Runtime dependencies injected into message handler functions by `KafkaClient`.
+ * Holds shared infrastructure (producer, logger, instrumentation) and per-consumer
+ * lifecycle callbacks (onMessageLost, onRetry, onDlq, etc.).
+ */
+export type MessageHandlerDeps = {
+    logger: KafkaLogger;
+    producer: Producer;
+    instrumentation: KafkaInstrumentation[];
+    onMessageLost: KafkaClientOptions["onMessageLost"];
+    onTtlExpired?: KafkaClientOptions["onTtlExpired"];
+    onRetry?: (envelope: EventEnvelope<any>, attempt: number, maxRetries: number) => void;
+    onDlq?: (envelope: EventEnvelope<any>, reason: DlqReason) => void;
+    onDuplicate?: (envelope: EventEnvelope<any>, strategy: "drop" | "dlq" | "topic") => void;
+    onMessage?: (envelope: EventEnvelope<any>) => void;
+    /** Fired on every failed handler attempt — drives the circuit breaker. */
+    onFailure?: (envelope: EventEnvelope<any>) => void;
+};
+/** Active deduplication context passed from KafkaClient to the message handler. */
+export type DeduplicationContext = {
+    options: DeduplicationOptions;
+    /** Backing store for the last processed Lamport clock (in-memory by default). */
+    store: DedupStore;
+    /** Consumer group ID this context belongs to — used as the store key. */
+    groupId: string;
+};
+/**
+ * Per-consumer configuration forwarded from `startConsumer` into `handleEachMessage`.
+ * Carries schema map, handler function, interceptors, retry/DLQ policy, timeout,
+ * deduplication context, TTL options, and the optional EOS routing context.
+ */
+export type EachMessageOpts = {
+    schemaMap: Map<string, SchemaLike>;
+    handleMessage: (envelope: EventEnvelope<any>) => Promise<void>;
+    interceptors: ConsumerInterceptor<any>[];
+    dlq: boolean;
+    retry: RetryOptions | undefined;
+    retryTopics: boolean | undefined;
+    timeoutMs: number | undefined;
+    wrapWithTimeout: <R>(fn: () => Promise<R>, ms: number, topic: string) => Promise<R>;
+    deduplication?: DeduplicationContext;
+    /** Drop messages older than this threshold (ms). See `ConsumerOptions.messageTtlMs`. */
+    messageTtlMs?: number;
+    /**
+     * Per-consumer TTL expiry callback. Takes precedence over the client-level
+     * `KafkaClientOptions.onTtlExpired` stored in `deps.onTtlExpired`.
+     */
+    onTtlExpired?: KafkaClientOptions["onTtlExpired"];
+    /**
+     * EOS context for main consumer → retry.1 routing.
+     * When set, the main consumer runs with `autoCommit: false`. On handler failure,
+     * routing to the retry topic and the source offset commit are wrapped in a single
+     * Kafka transaction — a crash at any point rolls back the transaction, ensuring
+     * the message is not duplicated between the main topic and retry.1.
+     * On success, the offset is committed manually (no transaction needed).
+     */
+    eosMainContext?: {
+        txProducer: Producer;
+        consumer: Consumer;
+    };
+};
+/** Parse, validate and extract an envelope from a single raw Kafka message. Returns null to skip. */
+export declare function parseSingleMessage(message: {
+    value: Buffer | null;
+    headers?: Record<string, any>;
+    offset: string;
+}, topic: string, partition: number, schemaMap: Map<string, SchemaLike>, interceptors: ConsumerInterceptor<any>[], dlq: boolean, deps: MessageHandlerDeps): Promise<EventEnvelope<any> | null>;
+/**
+ * Core single-message processing pipeline invoked by the kafkajs `eachMessage` callback.
+ * Parses, validates, deduplicates, checks TTL, runs the handler with retry/DLQ support,
+ * and manages EOS offset commits when the main consumer runs with `autoCommit: false`.
+ * @param payload Raw kafkajs `eachMessage` payload (topic, partition, message).
+ * @param opts Consumer-level options including handler, schema map, retry policy, and EOS context.
+ * @param deps Shared infrastructure dependencies.
+ */
+export declare function handleEachMessage(payload: {
+    topic: string;
+    partition: number;
+    message: {
+        value: Buffer | null;
+        headers?: Record<string, any>;
+        offset: string;
+    };
+}, opts: EachMessageOpts, deps: MessageHandlerDeps): Promise<void>;
+/**
+ * Per-consumer configuration forwarded from `startBatchConsumer` into `handleEachBatch`.
+ * Mirrors `EachMessageOpts` but carries a batch handler and batch-level EOS context.
+ */
+export type EachBatchOpts = {
+    schemaMap: Map<string, SchemaLike>;
+    handleBatch: (envelopes: EventEnvelope<any>[], meta: BatchMeta) => Promise<void>;
+    interceptors: ConsumerInterceptor<any>[];
+    dlq: boolean;
+    retry: RetryOptions | undefined;
+    retryTopics: boolean | undefined;
+    timeoutMs: number | undefined;
+    wrapWithTimeout: <R>(fn: () => Promise<R>, ms: number, topic: string) => Promise<R>;
+    deduplication?: DeduplicationContext;
+    /** Drop messages older than this threshold (ms). See `ConsumerOptions.messageTtlMs`. */
+    messageTtlMs?: number;
+    /**
+     * Per-consumer TTL expiry callback. Takes precedence over the client-level
+     * `KafkaClientOptions.onTtlExpired` stored in `deps.onTtlExpired`.
+     */
+    onTtlExpired?: KafkaClientOptions["onTtlExpired"];
+    /**
+     * EOS context for batch consumer → retry.1 routing.
+     * When set, the batch consumer runs with `autoCommit: false`.
+     * On handler failure, all messages are routed to retry.1 and the partition
+     * offset is committed atomically in a single Kafka transaction.
+     * On success, the offset is committed manually.
+     */
+    eosMainContext?: {
+        txProducer: Producer;
+        consumer: Consumer;
+    };
+};
+/**
+ * Core batch processing pipeline invoked by the kafkajs `eachBatch` callback.
+ * Iterates messages, parses, validates, deduplicates, and checks TTL for each one,
+ * then calls the batch handler with the surviving envelopes and retry/DLQ support.
+ * Manages EOS offset commits when the consumer runs with `autoCommit: false`.
+ * @param payload Raw kafkajs `eachBatch` payload (batch, heartbeat, resolveOffset, commitOffsetsIfNecessary).
+ * @param opts Consumer-level options including batch handler, schema map, retry policy, and EOS context.
+ * @param deps Shared infrastructure dependencies.
+ */
+export declare function handleEachBatch(payload: {
+    batch: {
+        topic: string;
+        partition: number;
+        highWatermark: string;
+        messages: Array<{
+            value: Buffer | null;
+            headers?: Record<string, any>;
+            offset: string;
+        }>;
+    };
+    heartbeat(): Promise<void>;
+    resolveOffset(offset: string): void;
+    commitOffsetsIfNecessary(): Promise<void>;
+}, opts: EachBatchOpts, deps: MessageHandlerDeps): Promise<void>;
+export {};
+//# sourceMappingURL=handler.d.ts.map

package/dist/client/kafka.client/consumer/handler.d.ts.map

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

package/dist/client/kafka.client/consumer/ops.d.ts

@@ -0,0 +1,51 @@
+import type { IConsumer, KafkaTransport } from "../../transport/transport.interface";
+import type { SchemaLike } from "../../message/topic";
+import type { KafkaClientOptions, KafkaLogger } from "../../types";
+export type ConsumerOpsDeps = {
+    consumers: Map<string, IConsumer>;
+    consumerCreationOptions: Map<string, {
+        fromBeginning: boolean;
+        autoCommit: boolean;
+    }>;
+    transport: KafkaTransport;
+    onRebalance: KafkaClientOptions["onRebalance"];
+    logger: KafkaLogger;
+};
+/**
+ * Return an existing consumer for `groupId`, or create and register a new one.
+ *
+ * If the group already exists with different `fromBeginning` / `autoCommit` options the
+ * existing consumer is returned unchanged and a warning is logged — use a distinct
+ * `groupId` if different options are required.
+ *
+ * Partition assignment strategy defaults to `cooperative-sticky`, which minimises
+ * partition movement during rebalances and is the safest choice for horizontally
+ * scaled deployments.
+ *
+ * @param groupId Kafka consumer group ID.
+ * @param fromBeginning When `true`, the group starts from the earliest available offset.
+ * @param autoCommit When `true`, offsets are committed automatically. Set to `false` for manual EOS commits.
+ * @param deps Shared client dependencies (consumer map, transport, logger, …).
+ * @param partitionAssigner Assignment strategy — `'cooperative-sticky'` (default), `'roundrobin'`, or `'range'`.
+ * @returns The consumer instance for the group (existing or newly created).
+ */
+export declare function getOrCreateConsumer(groupId: string, fromBeginning: boolean, autoCommit: boolean, deps: ConsumerOpsDeps, partitionAssigner?: "roundrobin" | "range" | "cooperative-sticky", onFirstAssignment?: () => void, groupInstanceId?: string): IConsumer;
+/**
+ * Build a local schema map for the topics being subscribed to.
+ *
+ * Schemas are collected from two sources in order:
+ * 1. Inline schemas on `TopicDescriptor` objects in the `topics` array.
+ * 2. Explicit overrides passed in `optionSchemas` (e.g. from `ConsumerOptions.schemas`).
+ *
+ * Both sources are also registered in the shared `schemaRegistry` so that the same
+ * schema is used consistently across producers and consumers. A warning is logged when
+ * a topic already has a different schema registered.
+ *
+ * @param topics Array of topic names or `TopicDescriptor` objects.
+ * @param schemaRegistry Shared client-wide schema map (mutated in place).
+ * @param optionSchemas Additional topic → schema overrides from consumer options.
+ * @param logger Optional logger for schema-conflict warnings.
+ * @returns A topic → schema map scoped to the current subscription.
+ */
+export declare function buildSchemaMap(topics: any[], schemaRegistry: Map<string, SchemaLike>, optionSchemas?: Map<string, SchemaLike>, logger?: KafkaLogger): Map<string, SchemaLike>;
+//# sourceMappingURL=ops.d.ts.map

package/dist/client/kafka.client/consumer/ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops.d.ts","sourceRoot":"","sources":["../../../../src/client/kafka.client/consumer/ops.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGnE,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,uBAAuB,EAAE,GAAG,CAC1B,MAAM,EACN;QAAE,aAAa,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAChD,CAAC;IACF,SAAS,EAAE,cAAc,CAAC;IAC1B,WAAW,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAC/C,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,OAAO,EACtB,UAAU,EAAE,OAAO,EACnB,IAAI,EAAE,eAAe,EACrB,iBAAiB,CAAC,EAAE,YAAY,GAAG,OAAO,GAAG,oBAAoB,EACjE,iBAAiB,CAAC,EAAE,MAAM,IAAI,EAC9B,eAAe,CAAC,EAAE,MAAM,GACvB,SAAS,CAyFX;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,GAAG,EAAE,EACb,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACvC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACvC,MAAM,CAAC,EAAE,WAAW,GACnB,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CA0BzB"}