@drarzter/kafka-client 0.9.3 → 0.10.0

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

@@ -0,0 +1,167 @@
+import type { IProducer } from "../../transport/transport.interface";
+type Producer = IProducer;
+import type { EventEnvelope } from "../../message/envelope";
+import type { SchemaLike } from "../../message/topic";
+import type { ConsumerInterceptor, DlqReason, KafkaInstrumentation, KafkaLogger, MessageHeaders, MessageLostContext, RetryOptions, TopicMapConstraint } from "../../types";
+import { toError } from "../../errors";
+export { toError };
+/**
+ * Return a Promise that resolves after `ms` milliseconds.
+ * Used for exponential backoff between retry attempts.
+ * @param ms Delay in milliseconds.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/** Parse raw message as JSON. Returns null on failure (logs error). */
+export declare function parseJsonMessage(raw: string, topic: string, logger: KafkaLogger): any | null;
+/**
+ * Validate a parsed message against the schema map.
+ * On failure: logs error, sends to DLQ if enabled, calls interceptor.onError.
+ * Returns validated message or null.
+ */
+export declare function validateWithSchema<T extends TopicMapConstraint<T>>(message: any, raw: string, topic: string, schemaMap: Map<string, SchemaLike>, interceptors: ConsumerInterceptor<T>[], dlq: boolean, deps: {
+    logger: KafkaLogger;
+    producer: Producer;
+    onMessageLost?: (ctx: MessageLostContext) => void | Promise<void>;
+    originalHeaders?: MessageHeaders;
+    instrumentation?: KafkaInstrumentation[];
+}): Promise<any | null>;
+export interface DlqMetadata {
+    error: Error;
+    attempt: number;
+    /** Original Kafka message headers — forwarded to DLQ to preserve correlationId, traceparent, etc. */
+    originalHeaders?: MessageHeaders;
+}
+/** Build the DLQ send payload without sending it. Used by sendToDlq and EOS routing. */
+export declare function buildDlqPayload(topic: string, rawMessage: string, meta?: DlqMetadata): {
+    topic: string;
+    messages: Array<{
+        value: string;
+        headers: MessageHeaders;
+    }>;
+};
+/**
+ * Produce a message to `<topic>.dlq`, stamping standard DLQ headers.
+ * Falls back to `onMessageLost` when the DLQ produce itself fails.
+ * @param topic Original topic the message was consumed from.
+ * @param rawMessage Raw JSON string of the original message.
+ * @param deps Logger, producer, and optional `onMessageLost` callback.
+ * @param meta Error, attempt count, and original headers to attach as DLQ metadata headers.
+ */
+export declare function sendToDlq(topic: string, rawMessage: string, deps: {
+    logger: KafkaLogger;
+    producer: Producer;
+    onMessageLost?: (ctx: MessageLostContext) => void | Promise<void>;
+}, meta?: DlqMetadata): Promise<void>;
+/** Headers stamped on messages sent to a `<topic>.retry` topic. */
+export declare const RETRY_HEADER_ATTEMPT = "x-retry-attempt";
+export declare const RETRY_HEADER_AFTER = "x-retry-after";
+export declare const RETRY_HEADER_MAX_RETRIES = "x-retry-max-retries";
+export declare const RETRY_HEADER_ORIGINAL_TOPIC = "x-retry-original-topic";
+/** Build the retry topic send payload without sending it. Used by sendToRetryTopic and EOS routing. */
+export declare function buildRetryTopicPayload(originalTopic: string, rawMessages: string[], attempt: number, maxRetries: number, delayMs: number, 
+/** Per-message headers (array) or a single object applied to all messages. */
+originalHeaders: MessageHeaders | MessageHeaders[]): {
+    topic: string;
+    messages: Array<{
+        value: string;
+        headers: MessageHeaders;
+    }>;
+};
+/**
+ * Send raw messages to the retry topic `<originalTopic>.retry`.
+ * Stamps scheduling headers so the retry consumer knows when and how many times to retry.
+ */
+export declare function sendToRetryTopic(originalTopic: string, rawMessages: string[], attempt: number, maxRetries: number, delayMs: number, 
+/** Per-message headers (array) or a single object applied to all messages. */
+originalHeaders: MessageHeaders | MessageHeaders[], deps: {
+    logger: KafkaLogger;
+    producer: Producer;
+    onMessageLost?: (ctx: MessageLostContext) => void | Promise<void>;
+}): Promise<void>;
+export interface DuplicateMetadata {
+    /** The `x-lamport-clock` value from the incoming (duplicate) message. */
+    incomingClock: number;
+    /** The last processed clock value for this topic/partition. */
+    lastProcessedClock: number;
+    /** Original Kafka message headers — forwarded to preserve correlationId, traceparent, etc. */
+    originalHeaders?: MessageHeaders;
+}
+/** Build the payload for a duplicate message forwarded to a custom topic. */
+export declare function buildDuplicateTopicPayload(sourceTopic: string, rawMessage: string, destinationTopic: string, meta?: DuplicateMetadata): {
+    topic: string;
+    messages: Array<{
+        value: string;
+        headers: MessageHeaders;
+    }>;
+};
+/**
+ * Forward a duplicate message to a dedicated topic (e.g. `<topic>.duplicates`).
+ * Stamps reason metadata headers so consumers of that topic know why it landed there.
+ */
+export declare function sendToDuplicatesTopic(sourceTopic: string, rawMessage: string, destinationTopic: string, deps: {
+    logger: KafkaLogger;
+    producer: Producer;
+}, meta?: DuplicateMetadata): Promise<void>;
+/**
+ * Run `fn` through the full instrumentation and interceptor lifecycle:
+ *   beforeConsume → interceptor.before → fn → interceptor.after → cleanup
+ *
+ * On error: fires `onConsumeError` and cleanup, then returns the error.
+ * The caller is responsible for calling `notifyInterceptorsOnError` (with
+ * a possibly-wrapped error) and deciding what happens next.
+ *
+ * Returns `null` on success, the caught `Error` on failure.
+ */
+export declare function runHandlerWithPipeline<T extends TopicMapConstraint<T>>(fn: () => Promise<void>, envelopes: EventEnvelope<any>[], interceptors: ConsumerInterceptor<T>[], instrumentation: KafkaInstrumentation[]): Promise<Error | null>;
+/**
+ * Call `interceptor.onError` for every envelope with the given error.
+ * Separated from `runHandlerWithPipeline` so callers can wrap the raw error
+ * (e.g. in `KafkaRetryExhaustedError`) before notifying interceptors.
+ */
+export declare function notifyInterceptorsOnError<T extends TopicMapConstraint<T>>(envelopes: EventEnvelope<any>[], interceptors: ConsumerInterceptor<T>[], error: Error): Promise<void>;
+/**
+ * Input context passed to `executeWithRetry`.
+ * Bundles the envelope(s), raw message bytes, interceptors, and retry/DLQ policy
+ * so the retry loop has everything it needs without relying on closure state.
+ */
+export interface ExecuteWithRetryContext<T extends TopicMapConstraint<T>> {
+    envelope: EventEnvelope<any> | EventEnvelope<any>[];
+    rawMessages: string[];
+    interceptors: ConsumerInterceptor<T>[];
+    dlq: boolean;
+    retry?: RetryOptions;
+    isBatch?: boolean;
+    /**
+     * When `true`, failed messages are routed to `<topic>.retry` instead of being
+     * retried in-process. All backoff and subsequent attempts are handled by the
+     * companion retry consumer started by `startRetryTopicConsumers`.
+     */
+    retryTopics?: boolean;
+}
+/**
+ * Execute a handler with retry, interceptors, instrumentation, and DLQ support.
+ * Used by both single-message and batch consumers.
+ */
+export declare function executeWithRetry<T extends TopicMapConstraint<T>>(fn: () => Promise<void>, ctx: ExecuteWithRetryContext<T>, deps: {
+    logger: KafkaLogger;
+    producer: Producer;
+    instrumentation: KafkaInstrumentation[];
+    onMessageLost?: (ctx: MessageLostContext) => void | Promise<void>;
+    onRetry?: (envelope: EventEnvelope<any>, attempt: number, maxRetries: number) => void;
+    onDlq?: (envelope: EventEnvelope<any>, reason: DlqReason) => void;
+    onMessage?: (envelope: EventEnvelope<any>) => void;
+    /** Fired once per failed handler attempt — drives the circuit breaker. */
+    onFailure?: (envelope: EventEnvelope<any>) => void;
+    /**
+     * EOS atomic routing to `<topic>.retry.1` (main consumer only).
+     * When present, replaces `sendToRetryTopic` with a Kafka transaction that
+     * sends to the retry topic AND commits the source offset atomically.
+     */
+    eosRouteToRetry?: (rawMessages: string[], envelopes: EventEnvelope<any>[], delay: number) => Promise<void>;
+    /**
+     * Manual offset commit for the success path when the main consumer runs
+     * with `autoCommit: false` (required when `eosRouteToRetry` is active).
+     */
+    eosCommitOnSuccess?: () => Promise<void>;
+}): Promise<void>;
+//# sourceMappingURL=pipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../src/client/kafka.client/consumer/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,KAAK,QAAQ,GAAG,SAAS,CAAC;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,KAAK,EAAE,UAAU,EAAsB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,KAAK,EAEV,mBAAmB,EACnB,SAAS,EACT,oBAAoB,EACpB,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAMrB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAID,uEAAuE;AACvE,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,GAClB,GAAG,GAAG,IAAI,CAUZ;AAID;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EACtE,OAAO,EAAE,GAAG,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAClC,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,EACtC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE;IACJ,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAC1C,GACA,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAmDrB;AAID,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,eAAe,CAAC,EAAE,cAAc,CAAC;CAClC;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,CAAC,EAAE,WAAW,GACjB;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;CAC7D,CAWA;AAED;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE;IACJ,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE,EACD,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAID,mEAAmE;AACnE,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AACtD,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAClD,eAAO,MAAM,wBAAwB,wBAAwB,CAAC;AAC9D,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AAEpE,uGAAuG;AACvG,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM;AACf,8EAA8E;AAC9E,eAAe,EAAE,cAAc,GAAG,cAAc,EAAE,GACjD;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;CAC7D,CAgCA;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM;AACf,8EAA8E;AAC9E,eAAe,EAAE,cAAc,GAAG,cAAc,EAAE,EAClD,IAAI,EAAE;IACJ,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE,GACA,OAAO,CAAC,IAAI,CAAC,CA6Bf;AAID,MAAM,WAAW,iBAAiB;IAChC,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,kBAAkB,EAAE,MAAM,CAAC;IAC3B,8FAA8F;IAC9F,eAAe,CAAC,EAAE,cAAc,CAAC;CAClC;AAED,6EAA6E;AAC7E,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE,iBAAiB,GACvB;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,CAAC,CAAC;CAC7D,CAaA;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,EACjD,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAmBD;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAC1E,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACvB,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,EAC/B,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,EACtC,eAAe,EAAE,oBAAoB,EAAE,GACtC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAiDvB;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAE/B,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,EAC/B,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,EACtC,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,IAAI,CAAC,CAIf;AAID;;;;GAIG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC;IACtE,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;IACpD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EACpE,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACvB,GAAG,EAAE,uBAAuB,CAAC,CAAC,CAAC,EAC/B,IAAI,EAAE;IACJ,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,CAAC,EAAE,CACR,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,KACf,IAAI,CAAC;IACV,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAClE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IACnD,0EAA0E;IAC1E,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IACnD;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAChB,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,EAC/B,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1C,GACA,OAAO,CAAC,IAAI,CAAC,CAmIf"}

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

@@ -0,0 +1,37 @@
+/** Push-to-pull async queue used by consume() to bridge Kafka's push model to AsyncIterableIterator. */
+export declare class AsyncQueue<V> {
+    private readonly highWaterMark;
+    private readonly onFull;
+    private readonly onDrained;
+    private readonly items;
+    private readonly waiting;
+    private closed;
+    private error?;
+    private paused;
+    constructor(highWaterMark?: number, onFull?: () => void, onDrained?: () => void);
+    /**
+     * Enqueue an item. If a consumer is already awaiting the next item, delivers it immediately.
+     * When the internal buffer reaches `highWaterMark`, calls `onFull` to signal backpressure.
+     * @param item The value to enqueue.
+     */
+    push(item: V): void;
+    /**
+     * Terminate the queue with an error. All pending and future `next()` calls will reject.
+     * @param err The error to propagate to all waiting consumers.
+     */
+    fail(err: Error): void;
+    /**
+     * Signal end-of-stream. All pending `next()` calls resolve with `{ done: true }`,
+     * and future `next()` calls resolve immediately with `{ done: true }`.
+     */
+    close(): void;
+    /**
+     * Pull the next item from the queue, conforming to the `AsyncIterator` protocol.
+     * Rejects if the queue has been failed. Resolves with `{ done: true }` if it has been closed.
+     * Suspends (returns a pending Promise) when the queue is empty and not yet closed.
+     * When items drain below `highWaterMark / 2`, calls `onDrained` to resume backpressure.
+     * @returns A Promise resolving to an `IteratorResult<V>`.
+     */
+    next(): Promise<IteratorResult<V>>;
+}
+//# sourceMappingURL=queue.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../src/client/kafka.client/consumer/queue.ts"],"names":[],"mappings":"AAAA,wGAAwG;AACxG,qBAAa,UAAU,CAAC,CAAC;IAWrB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAZ5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGhB;IACR,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,MAAM,CAAS;gBAGJ,aAAa,SAAW,EACxB,MAAM,GAAE,MAAM,IAAe,EAC7B,SAAS,GAAE,MAAM,IAAe;IAGnD;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAanB;;;OAGG;IACH,IAAI,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI;IAMtB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAMb;;;;;;OAMG;IACH,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;CAgBnC"}

package/dist/client/kafka.client/consumer/retry-topic.d.ts

@@ -0,0 +1,65 @@
+import type { IConsumer, IProducer } from "../../transport/transport.interface";
+type Consumer = IConsumer;
+type Producer = IProducer;
+import type { EventEnvelope } from "../../message/envelope";
+import type { SchemaLike } from "../../message/topic";
+import type { ConsumerInterceptor, DlqReason, KafkaClientOptions, KafkaInstrumentation, KafkaLogger } from "../../types";
+/**
+ * Dependencies injected into retry topic consumers by `KafkaClient`.
+ * Provides infrastructure (producer, logger, instrumentation), lifecycle callbacks,
+ * and factories for creating consumers and transactional producers per retry level.
+ */
+export type RetryTopicDeps = {
+    logger: KafkaLogger;
+    producer: Producer;
+    instrumentation: KafkaInstrumentation[];
+    onMessageLost: KafkaClientOptions["onMessageLost"];
+    onRetry?: (envelope: EventEnvelope<any>, attempt: number, maxRetries: number) => void;
+    onDlq?: (envelope: EventEnvelope<any>, reason: DlqReason) => void;
+    onMessage?: (envelope: EventEnvelope<any>) => void;
+    /** Fired on every failed handler attempt inside the retry chain — drives the circuit breaker. */
+    onFailure?: (envelope: EventEnvelope<any>) => void;
+    ensureTopic: (topic: string) => Promise<void>;
+    getOrCreateConsumer: (groupId: string, fromBeginning: boolean, autoCommit: boolean) => Consumer;
+    runningConsumers: Map<string, "eachMessage" | "eachBatch">;
+    /** Factory that creates and connects a transactional producer for EOS routing. */
+    createRetryTxProducer: (transactionalId: string) => Promise<Producer>;
+    /**
+     * Called immediately after each retry level consumer successfully starts and
+     * receives partition assignments. Allows the caller to register the group ID
+     * incrementally so partial startup failures still leave started consumers tracked.
+     */
+    onLevelStarted?: (groupId: string) => void;
+};
+/**
+ * Poll `consumer.assignment()` until the consumer has received at least one
+ * partition for the given topics, then return. Logs a warning and returns
+ * (rather than throwing) on timeout so that a slow broker does not break
+ * the caller.
+ */
+export declare function waitForPartitionAssignment(consumer: Consumer, topics: string[], logger: KafkaLogger, timeoutMs?: number): Promise<void>;
+/**
+ * Start one consumer per retry level on `<topic>.retry.<level>` topics.
+ *
+ * With `maxRetries: N`, creates N consumers:
+ *   - `${groupId}-retry.1` → `<topic>.retry.1`
+ *   - `${groupId}-retry.2` → `<topic>.retry.2`
+ *   - …
+ *   - `${groupId}-retry.N` → `<topic>.retry.N`
+ *
+ * Each level consumer uses pause/sleep/resume to honour the scheduled delay
+ * without committing the offset early. Failed message routing (to the next
+ * level or DLQ) is wrapped in a Kafka transaction via `sendOffsetsToTransaction`
+ * for exactly-once routing semantics — no duplicates even if the process
+ * crashes between the produce and the offset commit.
+ *
+ * Returns the list of started consumer group IDs so the caller can stop
+ * them selectively via `stopConsumer`.
+ */
+export declare function startRetryTopicConsumers(originalTopics: string[], originalGroupId: string, handleMessage: (envelope: EventEnvelope<any>) => Promise<void>, retry: {
+    maxRetries: number;
+    backoffMs?: number;
+    maxBackoffMs?: number;
+}, dlq: boolean, interceptors: ConsumerInterceptor<any>[], schemaMap: Map<string, SchemaLike>, deps: RetryTopicDeps, assignmentTimeoutMs?: number): Promise<string[]>;
+export {};
+//# sourceMappingURL=retry-topic.d.ts.map

package/dist/client/kafka.client/consumer/retry-topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-topic.d.ts","sourceRoot":"","sources":["../../../../src/client/kafka.client/consumer/retry-topic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AAChF,KAAK,QAAQ,GAAG,SAAS,CAAC;AAC1B,KAAK,QAAQ,GAAG,SAAS,CAAC;AAM1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAgB5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EACV,mBAAmB,EACnB,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,oBAAoB,EAAE,CAAC;IACxC,aAAa,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACnD,OAAO,CAAC,EAAE,CACR,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,EAC5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,KACf,IAAI,CAAC;IACV,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAClE,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IACnD,iGAAiG;IACjG,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;IACnD,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,mBAAmB,EAAE,CACnB,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,OAAO,EACtB,UAAU,EAAE,OAAO,KAChB,QAAQ,CAAC;IACd,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAAC,CAAC;IAC3D,kFAAkF;IAClF,qBAAqB,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtE;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EAAE,EAChB,MAAM,EAAE,WAAW,EACnB,SAAS,SAAS,GACjB,OAAO,CAAC,IAAI,CAAC,CAgBf;AA4SD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,cAAc,EAAE,MAAM,EAAE,EACxB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAC9D,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EACxE,GAAG,EAAE,OAAO,EACZ,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,EACxC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EAClC,IAAI,EAAE,cAAc,EACpB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,MAAM,EAAE,CAAC,CAgCnB"}

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

@@ -0,0 +1,63 @@
+import type { IConsumer, IProducer } from "../../transport/transport.interface";
+import type { SchemaLike } from "../../message/topic";
+import type { EventEnvelope } from "../../message/envelope";
+import type { KafkaClientContext } from "../context";
+import type { TopicMapConstraint, ConsumerOptions, ConsumerInterceptor, RetryOptions } from "../../types";
+import type { MessageHandlerDeps, DeduplicationContext } from "./handler";
+/** Guard checks shared by startConsumer and startBatchConsumer. */
+export declare function validateTopicConsumerOpts<T extends TopicMapConstraint<T>>(topics: any[], options: ConsumerOptions<T>): void;
+/** Ensure all required topics exist for a consumer: base, DLQ, and dedup topics. */
+export declare function ensureConsumerTopics<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>, topicNames: string[], dlq: boolean, deduplication: import("../../types").DeduplicationOptions | undefined): Promise<void>;
+/**
+ * Shared consumer bootstrap: groupId conflict check, schema map, connect, subscribe.
+ * Returns all values needed by startConsumer / startBatchConsumer.
+ */
+export declare function setupConsumer<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>, topics: any[], mode: "eachMessage" | "eachBatch", options: ConsumerOptions<T>): Promise<{
+    consumer: IConsumer;
+    schemaMap: Map<string, SchemaLike<any>>;
+    topicNames: string[];
+    gid: string;
+    dlq: boolean;
+    interceptors: ConsumerInterceptor<T>[];
+    retry: RetryOptions | undefined;
+    hasRegex: boolean;
+    readyPromise: Promise<void>;
+}>;
+/**
+ * Create or retrieve the deduplication context for a consumer group.
+ *
+ * Uses the user-supplied `options.store` when present, otherwise an
+ * `InMemoryDedupStore` backed by `ctx.dedupStates` — so `stopConsumer` /
+ * `disconnect` clearing that map continues to reset in-memory dedup state.
+ */
+export declare function resolveDeduplicationContext<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>, groupId: string, options: import("../../types").DeduplicationOptions | undefined): DeduplicationContext | undefined;
+/** Build MessageHandlerDeps with circuit-breaker callbacks bound to the given groupId. */
+export declare function messageDepsFor<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>, gid: string, options?: Pick<import("../../types").ConsumerOptions<T>, "onMessageLost" | "onRetry">): MessageHandlerDeps;
+/** Build the RetryTopicDeps object passed to retry topic consumers. */
+export declare function buildRetryTopicDeps<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>): {
+    logger: import("../../types").KafkaLogger;
+    producer: IProducer;
+    instrumentation: import("../../types").KafkaInstrumentation[];
+    onMessageLost: ((ctx: import("../../types").MessageLostContext) => void | Promise<void>) | undefined;
+    onRetry: (envelope: EventEnvelope<any>, attempt: number, maxRetries: number) => void;
+    onDlq: (envelope: EventEnvelope<any>, reason: import("../../types").DlqReason) => void;
+    onMessage: (envelope: EventEnvelope<any>, gid?: string) => void;
+    ensureTopic: (t: string) => Promise<void>;
+    getOrCreateConsumer: (gid: string, fb: boolean, ac: boolean) => IConsumer;
+    runningConsumers: Map<string, "eachMessage" | "eachBatch">;
+    createRetryTxProducer: (txId: string) => Promise<IProducer>;
+};
+/** Create EOS transactional producer context for atomic main → retry.1 routing. */
+export declare function makeEosMainContext<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>, gid: string, consumer: IConsumer, options: ConsumerOptions<T>): Promise<{
+    txProducer: IProducer;
+    consumer: IConsumer;
+} | undefined>;
+/** Start companion retry-level consumers and register them under the main groupId. */
+export declare function launchRetryChain<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>, gid: string, topicNames: string[], handleMessage: (env: EventEnvelope<any>) => Promise<void>, opts: {
+    retry: RetryOptions;
+    dlq: boolean;
+    interceptors: ConsumerInterceptor<T>[];
+    schemaMap: Map<string, SchemaLike>;
+    assignmentTimeoutMs?: number;
+}): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

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

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

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

@@ -0,0 +1,7 @@
+import type { KafkaClientContext } from "../context";
+import type { TopicMapConstraint, ConsumerOptions, ConsumerHandle, BatchMeta, TransactionalHandlerContext } from "../../types";
+import type { EventEnvelope } from "../../message/envelope";
+export declare function startConsumerImpl<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>, topics: any[], handleMessage: (envelope: EventEnvelope<any>) => Promise<void>, options?: ConsumerOptions<T>): Promise<ConsumerHandle>;
+export declare function startBatchConsumerImpl<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>, topics: any[], handleBatch: (envelopes: EventEnvelope<any>[], meta: BatchMeta) => Promise<void>, options?: ConsumerOptions<T>): Promise<ConsumerHandle>;
+export declare function startTransactionalConsumerImpl<T extends TopicMapConstraint<T>>(ctx: KafkaClientContext<T>, topics: any[], handler: (envelope: EventEnvelope<any>, tx: TransactionalHandlerContext<T>) => Promise<void>, options?: ConsumerOptions<T>): Promise<ConsumerHandle>;
+//# sourceMappingURL=start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../../../src/client/kafka.client/consumer/start.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,SAAS,EAGT,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAiB5D,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EACrE,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAE,GAAG,EAAE,EACb,aAAa,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAC9D,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GAC/B,OAAO,CAAC,cAAc,CAAC,CAqDzB;AAID,wBAAsB,sBAAsB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAC1E,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAE,GAAG,EAAE,EACb,WAAW,EAAE,CACX,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,EAC/B,IAAI,EAAE,SAAS,KACZ,OAAO,CAAC,IAAI,CAAC,EAClB,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GAC/B,OAAO,CAAC,cAAc,CAAC,CAmEzB;AAID,wBAAsB,8BAA8B,CAClD,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAE/B,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC1B,MAAM,EAAE,GAAG,EAAE,EACb,OAAO,EAAE,CACP,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,EAC5B,EAAE,EAAE,2BAA2B,CAAC,CAAC,CAAC,KAC/B,OAAO,CAAC,IAAI,CAAC,EAClB,OAAO,GAAE,eAAe,CAAC,CAAC,CAAM,GAC/B,OAAO,CAAC,cAAc,CAAC,CAmGzB"}

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

@@ -0,0 +1,19 @@
+import type { KafkaClientContext } from "../context";
+import type { TopicMapConstraint } from "../../types";
+/** Minimal context surface required by this module. */
+type StopCtx<T extends TopicMapConstraint<T>> = Pick<KafkaClientContext<T>, "circuitBreaker" | "companionGroupIds" | "consumerCreationOptions" | "consumers" | "dedupStates" | "defaultGroupId" | "logger" | "retryTxProducers" | "runningConsumers">;
+export declare function stopConsumerImpl<T extends TopicMapConstraint<T>>(ctx: StopCtx<T>, groupId?: string): Promise<void>;
+export declare function pauseConsumerImpl<T extends TopicMapConstraint<T>>(ctx: StopCtx<T>, groupId: string | undefined, assignments: Array<{
+    topic: string;
+    partitions: number[];
+}>): void;
+export declare function resumeConsumerImpl<T extends TopicMapConstraint<T>>(ctx: StopCtx<T>, groupId: string | undefined, assignments: Array<{
+    topic: string;
+    partitions: number[];
+}>): void;
+/** Pause all assigned partitions of a topic for a consumer group (backpressure for consume()). */
+export declare function pauseTopicAllPartitions<T extends TopicMapConstraint<T>>(ctx: StopCtx<T>, gid: string, topic: string): void;
+/** Resume all assigned partitions of a topic for a consumer group (backpressure for consume()). */
+export declare function resumeTopicAllPartitions<T extends TopicMapConstraint<T>>(ctx: StopCtx<T>, gid: string, topic: string): void;
+export {};
+//# sourceMappingURL=stop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stop.d.ts","sourceRoot":"","sources":["../../../../src/client/kafka.client/consumer/stop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,uDAAuD;AACvD,KAAK,OAAO,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,IAAI,IAAI,CAClD,kBAAkB,CAAC,CAAC,CAAC,EACnB,gBAAgB,GAChB,mBAAmB,GACnB,yBAAyB,GACzB,WAAW,GACX,aAAa,GACb,gBAAgB,GAChB,QAAQ,GACR,kBAAkB,GAClB,kBAAkB,CACrB,CAAC;AAIF,wBAAsB,gBAAgB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EACpE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA8Ff;AAID,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAC/D,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAC1D,IAAI,CAYN;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAChE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,WAAW,EAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAC1D,IAAI,CAYN;AAED,kGAAkG;AAClG,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EACrE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,IAAI,CASN;AAED,mGAAmG;AACnG,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EACtE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,IAAI,CASN"}

package/dist/client/kafka.client/consumer/subscribe-retry.d.ts

@@ -0,0 +1,4 @@
+import type { IConsumer } from "../../transport/transport.interface";
+import type { KafkaLogger, SubscribeRetryOptions } from "../../types";
+export declare function subscribeWithRetry(consumer: IConsumer, topics: (string | RegExp)[], logger: KafkaLogger, retryOpts?: SubscribeRetryOptions): Promise<void>;
+//# sourceMappingURL=subscribe-retry.d.ts.map

package/dist/client/kafka.client/consumer/subscribe-retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe-retry.d.ts","sourceRoot":"","sources":["../../../../src/client/kafka.client/consumer/subscribe-retry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGtE,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,SAAS,EACnB,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAC3B,MAAM,EAAE,WAAW,EACnB,SAAS,CAAC,EAAE,qBAAqB,GAChC,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/client/kafka.client/context.d.ts

@@ -0,0 +1,72 @@
+import type { KafkaTransport, IProducer, IConsumer } from "../transport/transport.interface";
+import type { SchemaLike } from "../message/topic";
+import type { ClientId, KafkaClientOptions, KafkaInstrumentation, KafkaLogger } from "../types";
+import type { CircuitBreakerManager } from "./infra/circuit-breaker.manager";
+import type { AdminOps } from "./admin/ops";
+import type { MetricsManager } from "./infra/metrics.manager";
+import type { InFlightTracker } from "./infra/inflight.tracker";
+import type { BuildSendPayloadDeps } from "./producer/ops";
+import type { ConsumerOpsDeps } from "./consumer/ops";
+import type { RetryTopicDeps } from "./consumer/retry-topic";
+/**
+ * All shared state for a `KafkaClient` instance passed to extracted
+ * implementation functions. The class stores this as `this.ctx` and
+ * delegates every method to the relevant module.
+ */
+export type KafkaClientContext<T> = {
+    /** @internal Phantom type carrier — keeps the topic-map generic flowing through impl modules. */
+    readonly __topicMap?: T;
+    readonly clientId: ClientId;
+    readonly defaultGroupId: string;
+    readonly logger: KafkaLogger;
+    readonly autoCreateTopicsEnabled: boolean;
+    readonly strictSchemasEnabled: boolean;
+    readonly numPartitions: number;
+    readonly txId: string;
+    readonly clockRecoveryTopics: string[];
+    /** Max time to wait for clock recovery before proceeding with a partial result. */
+    readonly clockRecoveryTimeoutMs: number;
+    readonly lagThrottleOpts: KafkaClientOptions["lagThrottle"];
+    readonly instrumentation: KafkaInstrumentation[];
+    readonly onMessageLost: KafkaClientOptions["onMessageLost"];
+    readonly onTtlExpired: KafkaClientOptions["onTtlExpired"];
+    readonly onRebalance: KafkaClientOptions["onRebalance"];
+    readonly transport: KafkaTransport;
+    readonly producer: IProducer;
+    /** Lazy transactional producer — created on first `transaction()` call. */
+    txProducer: IProducer | undefined;
+    /** Guards concurrent init so only one producer is created. */
+    txProducerInitPromise: Promise<IProducer> | undefined;
+    /** Per-transactionalId producers used by retry level consumers. */
+    readonly retryTxProducers: Map<string, IProducer>;
+    /**
+     * Serialises `transaction()` calls — a transactional producer supports only
+     * one open transaction at a time, so overlapping calls queue behind this chain.
+     */
+    _txChain: Promise<void>;
+    readonly consumers: Map<string, IConsumer>;
+    readonly runningConsumers: Map<string, "eachMessage" | "eachBatch">;
+    readonly consumerCreationOptions: Map<string, {
+        fromBeginning: boolean;
+        autoCommit: boolean;
+    }>;
+    /** Maps main groupId → companion retry-level groupIds. */
+    readonly companionGroupIds: Map<string, string[]>;
+    /** Per-groupId Lamport clock dedup state: `"topic:partition"` → last seen clock. */
+    readonly dedupStates: Map<string, Map<string, number>>;
+    readonly ensuredTopics: Set<string>;
+    /** Pending createTopics promises — deduplicates concurrent calls for the same topic. */
+    readonly ensureTopicPromises: Map<string, Promise<void>>;
+    readonly schemaRegistry: Map<string, SchemaLike>;
+    _lagThrottled: boolean;
+    _lagThrottleTimer: ReturnType<typeof setInterval> | undefined;
+    _lamportClock: number;
+    readonly circuitBreaker: CircuitBreakerManager;
+    readonly adminOps: AdminOps;
+    readonly metrics: MetricsManager;
+    readonly inFlight: InFlightTracker;
+    readonly producerOpsDeps: BuildSendPayloadDeps;
+    readonly consumerOpsDeps: ConsumerOpsDeps;
+    retryTopicDeps: RetryTopicDeps;
+};
+//# sourceMappingURL=context.d.ts.map

package/dist/client/kafka.client/context.d.ts.map

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