@drarzter/kafka-client 0.9.4 → 0.11.0

package/dist/client/transport/transport.interface.d.ts

@@ -0,0 +1,221 @@
+/** A topic-partition pair. */
+export type ITopicPartition = {
+    topic: string;
+    partition: number;
+};
+/** A topic-partition pair with an absolute offset string. */
+export type ITopicPartitionOffset = {
+    topic: string;
+    partition: number;
+    offset: string;
+};
+/** Pause / resume assignment shape: one topic + its partition list. */
+export type ITopicPartitions = {
+    topic: string;
+    partitions: number[];
+};
+/** A single message in a produce request. */
+export type IProducerMessage = {
+    /**
+     * Wire payload. `string` for text serdes (e.g. JSON), `Buffer` for binary
+     * serdes (Avro/Protobuf) and for losslessly re-forwarded messages
+     * (DLQ / retry / duplicates / delayed relay). librdkafka accepts both.
+     */
+    value: string | Buffer | null;
+    key?: string | null;
+    headers?: Record<string, string | Buffer | string[]>;
+};
+/** Produce request payload for one topic. */
+export type IProducerRecord = {
+    topic: string;
+    messages: IProducerMessage[];
+};
+/** Options for creating a producer. */
+export type IProducerCreationOptions = {
+    /** When set, the producer uses idempotent + exactly-once semantics. */
+    transactionalId?: string;
+    /** Enable idempotent writes (required for `transactionalId`). */
+    idempotent?: boolean;
+};
+/** An open Kafka transaction. */
+export interface ITransaction {
+    send(record: IProducerRecord): Promise<void>;
+    /**
+     * Atomically commit offsets for `consumer` as part of this transaction.
+     * The `consumer` parameter must be the `IConsumer` whose offsets are being committed.
+     */
+    sendOffsets(options: {
+        consumer: IConsumer;
+        topics: Array<{
+            topic: string;
+            partitions: Array<{
+                partition: number;
+                offset: string;
+            }>;
+        }>;
+    }): Promise<void>;
+    commit(): Promise<void>;
+    abort(): Promise<void>;
+}
+/** A Kafka producer. */
+export interface IProducer {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(record: IProducerRecord): Promise<void>;
+    transaction(): Promise<ITransaction>;
+}
+/** A single message in an `eachMessage` callback. */
+export type IMessage = {
+    value: Buffer | null;
+    /** Header map as returned by librdkafka — values may be arrays. */
+    headers: Record<string, any>;
+    offset: string;
+    key: Buffer | null;
+};
+/** Payload passed to the `eachMessage` handler. */
+export type IEachMessagePayload = {
+    topic: string;
+    partition: number;
+    message: IMessage;
+};
+/** A batch of messages from one topic-partition. */
+export type IMessageBatch = {
+    topic: string;
+    partition: number;
+    messages: IMessage[];
+    highWatermark: string;
+};
+/** Payload passed to the `eachBatch` handler. */
+export type IEachBatchPayload = {
+    batch: IMessageBatch;
+    /** Send a heartbeat to the broker to prevent session timeout. */
+    heartbeat: () => Promise<void>;
+    /** Mark `offset` as processed (without committing). */
+    resolveOffset: (offset: string) => void;
+    /** Commit if the auto-commit threshold has been reached. */
+    commitOffsetsIfNecessary: () => Promise<void>;
+};
+/** Configuration passed to `IConsumer.run()`. */
+export type IConsumerRunConfig = {
+    eachMessage?: (payload: IEachMessagePayload) => Promise<void>;
+    eachBatch?: (payload: IEachBatchPayload) => Promise<void>;
+};
+/** Options for creating a consumer. */
+export type IConsumerCreationOptions = {
+    groupId: string;
+    fromBeginning?: boolean;
+    autoCommit?: boolean;
+    partitionAssigner?: "cooperative-sticky" | "roundrobin" | "range";
+    /**
+     * Static group membership id (`group.instance.id`). A member that restarts
+     * within the broker's `session.timeout.ms` rejoins with the same partitions
+     * and no rebalance — useful for k8s rolling restarts.
+     * Must be unique per member within a consumer group.
+     */
+    groupInstanceId?: string;
+    /** Fired on every partition assign/revoke. */
+    onRebalance?: (type: "assign" | "revoke", assignments: ITopicPartition[]) => void;
+};
+/** A Kafka consumer. */
+export interface IConsumer {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    subscribe(options: {
+        topics: (string | RegExp)[];
+    }): Promise<void>;
+    run(config: IConsumerRunConfig): Promise<void>;
+    pause(assignments: ITopicPartitions[]): void;
+    resume(assignments: ITopicPartitions[]): void;
+    /** Seek a partition to an explicit offset. */
+    seek(options: ITopicPartitionOffset): void;
+    /** Current partition assignment for this consumer. */
+    assignment(): ITopicPartition[];
+    commitOffsets(offsets: ITopicPartitionOffset[]): Promise<void>;
+    /** Stop processing (alias for disconnect in some usages). */
+    stop(): Promise<void>;
+}
+/** Low/current/high watermark offsets for one partition. */
+export type IPartitionWatermarks = {
+    partition: number;
+    low: string;
+    high: string;
+};
+/** A partition → offset pair. */
+export type IPartitionOffset = {
+    partition: number;
+    offset: string;
+};
+/** Committed offsets for a group's topic. */
+export type IGroupTopicOffsets = {
+    topic: string;
+    partitions: IPartitionOffset[];
+};
+/** A consumer group descriptor. */
+export type IGroupDescription = {
+    groupId: string;
+    state?: string;
+};
+/** Partition metadata. */
+export type IPartitionMetadata = {
+    partitionId?: number;
+    partition?: number;
+    leader?: number;
+    replicas?: (number | {
+        nodeId: number;
+    })[];
+    isr?: (number | {
+        nodeId: number;
+    })[];
+};
+/** Topic metadata. */
+export type ITopicMetadata = {
+    name: string;
+    partitions: IPartitionMetadata[];
+};
+/** A Kafka admin client. */
+export interface IAdmin {
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    createTopics(options: {
+        topics: Array<{
+            topic: string;
+            numPartitions: number;
+        }>;
+    }): Promise<void>;
+    fetchTopicOffsets(topic: string): Promise<IPartitionWatermarks[]>;
+    fetchTopicOffsetsByTimestamp(topic: string, timestamp: number): Promise<IPartitionOffset[]>;
+    fetchOffsets(options: {
+        groupId: string;
+    }): Promise<IGroupTopicOffsets[]>;
+    setOffsets(options: {
+        groupId: string;
+        topic: string;
+        partitions: IPartitionOffset[];
+    }): Promise<void>;
+    listTopics(): Promise<string[]>;
+    listGroups(): Promise<{
+        groups: IGroupDescription[];
+    }>;
+    fetchTopicMetadata(options?: {
+        topics?: string[];
+    }): Promise<{
+        topics: ITopicMetadata[];
+    }>;
+    deleteGroups(groupIds: string[]): Promise<void>;
+    deleteTopicRecords(options: {
+        topic: string;
+        partitions: IPartitionOffset[];
+    }): Promise<void>;
+}
+/**
+ * Factory that creates connected Kafka primitives.
+ * The default implementation wraps `@confluentinc/kafka-javascript` via
+ * `ConfluentTransport`. Inject a custom transport (e.g. a fake) via
+ * `KafkaClientOptions.transport` for testing or alternative broker support.
+ */
+export interface KafkaTransport {
+    producer(options?: IProducerCreationOptions): IProducer;
+    consumer(options: IConsumerCreationOptions): IConsumer;
+    admin(): IAdmin;
+}
+//# sourceMappingURL=transport.interface.d.ts.map

package/dist/client/transport/transport.interface.d.ts.map

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

package/dist/client/types/admin.interface.d.ts

@@ -0,0 +1,174 @@
+import type { TopicMapConstraint } from "./common";
+import type { KafkaHealthResult, ConsumerGroupSummary, TopicDescription, ReadSnapshotOptions, CheckpointResult, RestoreCheckpointOptions, CheckpointRestoreResult, DlqReplayOptions } from "./admin.types";
+import type { EventEnvelope } from "../message/envelope";
+/** Admin, offset-management, and state methods of `IKafkaClient`. */
+export interface IKafkaAdmin<T extends TopicMapConstraint<T>> {
+    /**
+     * @example
+     * ```ts
+     * const status = await kafka.checkStatus();
+     * if (status.status === 'down') console.error(status.error);
+     * ```
+     */
+    checkStatus(): Promise<KafkaHealthResult>;
+    /**
+     * List all consumer groups known to the broker.
+     *
+     * @example
+     * ```ts
+     * const groups = await kafka.listConsumerGroups();
+     * console.log(groups.map(g => `${g.groupId}: ${g.state}`));
+     * ```
+     */
+    listConsumerGroups(): Promise<ConsumerGroupSummary[]>;
+    /**
+     * Describe topics — returns partition layout, leader, replicas, and ISR for each topic.
+     * Omit `topics` to describe all topics visible to this client.
+     *
+     * @example
+     * ```ts
+     * const [desc] = await kafka.describeTopics(['orders.created']);
+     * console.log(desc.partitions.length);
+     * ```
+     */
+    describeTopics(topics?: string[]): Promise<TopicDescription[]>;
+    /**
+     * Delete records from a topic up to (but not including) the specified offsets.
+     *
+     * @example
+     * ```ts
+     * await kafka.deleteRecords('orders.created', [
+     *   { partition: 0, offset: '1000' },
+     *   { partition: 1, offset: '500'  },
+     * ]);
+     * ```
+     */
+    deleteRecords(topic: string, partitions: Array<{
+        partition: number;
+        offset: string;
+    }>): Promise<void>;
+    /**
+     * Query the consumer group lag per partition.
+     * Lag = (broker high-watermark offset) − (last committed offset).
+     *
+     * @example
+     * ```ts
+     * const lag = await kafka.getConsumerLag();
+     * const total = lag.reduce((sum, p) => sum + p.lag, 0);
+     * ```
+     */
+    getConsumerLag(groupId?: string): Promise<Array<{
+        topic: string;
+        partition: number;
+        lag: number;
+    }>>;
+    /**
+     * Consume all messages in `{topic}.dlq` and re-publish each to its original topic
+     * (or `options.targetTopic`). The DLQ topic itself is not modified.
+     *
+     * @returns `{ replayed, skipped }` counts.
+     *
+     * @example
+     * ```ts
+     * const { replayed } = await kafka.replayDlq('orders.created');
+     * ```
+     */
+    replayDlq(topic: string, options?: DlqReplayOptions): Promise<{
+        replayed: number;
+        skipped: number;
+    }>;
+    /**
+     * Reset committed offsets to `'earliest'` or `'latest'`.
+     * The consumer group must be inactive — call `stopConsumer(groupId)` first.
+     *
+     * @example
+     * ```ts
+     * await kafka.stopConsumer('billing-service');
+     * await kafka.resetOffsets('billing-service', 'orders.created', 'earliest');
+     * ```
+     */
+    resetOffsets(groupId: string | undefined, topic: string, position: "earliest" | "latest"): Promise<void>;
+    /**
+     * Seek specific partitions to explicit offsets.
+     * The consumer group must be inactive.
+     *
+     * @example
+     * ```ts
+     * await kafka.seekToOffset('billing-service', [
+     *   { topic: 'orders.created', partition: 0, offset: '1000' },
+     * ]);
+     * ```
+     */
+    seekToOffset(groupId: string | undefined, assignments: Array<{
+        topic: string;
+        partition: number;
+        offset: string;
+    }>): Promise<void>;
+    /**
+     * Seek partitions to the offset nearest to a given Unix timestamp (ms).
+     * The consumer group must be inactive.
+     *
+     * @example
+     * ```ts
+     * const midnight = new Date('2025-01-01').getTime();
+     * await kafka.seekToTimestamp('billing-service', [
+     *   { topic: 'orders.created', partition: 0, timestamp: midnight },
+     * ]);
+     * ```
+     */
+    seekToTimestamp(groupId: string | undefined, assignments: Array<{
+        topic: string;
+        partition: number;
+        timestamp: number;
+    }>): Promise<void>;
+    /**
+     * Returns the current circuit breaker state for a topic partition.
+     * Returns `undefined` when `circuitBreaker` is not configured or never tripped.
+     *
+     * @example
+     * ```ts
+     * const state = kafka.getCircuitState('orders.created', 0);
+     * if (state?.status === 'open') console.warn('Circuit open!', state.failures);
+     * ```
+     */
+    getCircuitState(topic: string, partition: number, groupId?: string): {
+        status: "closed" | "open" | "half-open";
+        failures: number;
+        windowSize: number;
+    } | undefined;
+    /**
+     * Read a compacted topic from the beginning to its high-watermark and return a
+     * `Map<key, EventEnvelope<T>>` with the latest value per key.
+     * Tombstone records remove the key from the map.
+     *
+     * @example
+     * ```ts
+     * const orders = await kafka.readSnapshot('orders.state');
+     * // orders.get('order-123') → latest EventEnvelope for that key
+     * ```
+     */
+    readSnapshot<K extends keyof T & string>(topic: K, options?: ReadSnapshotOptions): Promise<Map<string, EventEnvelope<T[K]>>>;
+    /**
+     * Snapshot the current committed offsets of a consumer group into a Kafka topic.
+     * Requires `connectProducer()` to have been called.
+     *
+     * @example
+     * ```ts
+     * const result = await kafka.checkpointOffsets(undefined, 'checkpoints');
+     * console.log(`Saved ${result.partitionCount} offsets at ${result.savedAt}`);
+     * ```
+     */
+    checkpointOffsets(groupId: string | undefined, checkpointTopic: string): Promise<CheckpointResult>;
+    /**
+     * Restore a consumer group's committed offsets from the nearest checkpoint.
+     * The consumer group must be stopped before calling this method.
+     *
+     * @example
+     * ```ts
+     * await kafka.stopConsumer('billing-service');
+     * const result = await kafka.restoreFromCheckpoint(undefined, 'checkpoints');
+     * ```
+     */
+    restoreFromCheckpoint(groupId: string | undefined, checkpointTopic: string, options?: RestoreCheckpointOptions): Promise<CheckpointRestoreResult>;
+}
+//# sourceMappingURL=admin.interface.d.ts.map

package/dist/client/types/admin.interface.d.ts.map

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

package/dist/client/types/admin.types.d.ts

@@ -0,0 +1,140 @@
+import type { MessageHeaders } from "./common";
+import type { SchemaLike } from "../message/topic";
+/**
+ * Options for `readSnapshot`.
+ *
+ * @example
+ * ```ts
+ * const snapshot = await kafka.readSnapshot('users.state', {
+ *   schema: UserSchema,
+ *   onTombstone: (key) => console.log(`Key ${key} was compacted away`),
+ * });
+ * ```
+ */
+export interface ReadSnapshotOptions {
+    /**
+     * Schema to validate each message payload against (Zod, Valibot, ArkType, or any `.parse()` shape).
+     * Messages that fail validation are skipped with a warning log — they do not throw.
+     */
+    schema?: SchemaLike;
+    /**
+     * Called when a tombstone record (null-value message) is encountered.
+     * The corresponding key is removed from the snapshot automatically.
+     * Use this for auditing or logging which keys were compacted away.
+     */
+    onTombstone?: (key: string) => void;
+}
+/** A single partition offset entry stored in a checkpoint record. */
+export interface CheckpointEntry {
+    topic: string;
+    partition: number;
+    offset: string;
+}
+/** Result returned by a successful `checkpointOffsets` call. */
+export interface CheckpointResult {
+    /** Consumer group whose offsets were saved. */
+    groupId: string;
+    /** Topics included in the checkpoint. */
+    topics: string[];
+    /** Total number of topic-partition pairs saved. */
+    partitionCount: number;
+    /** Unix timestamp (ms) when the checkpoint was created. */
+    savedAt: number;
+}
+/** Options for `restoreFromCheckpoint`. */
+export interface RestoreCheckpointOptions {
+    /**
+     * Target Unix timestamp (ms). The newest checkpoint whose `savedAt` is **≤ this value**
+     * is selected. Defaults to the latest available checkpoint when omitted.
+     */
+    timestamp?: number;
+}
+/** Result returned by a successful `restoreFromCheckpoint` call. */
+export interface CheckpointRestoreResult {
+    /** Consumer group that was repositioned. */
+    groupId: string;
+    /** The committed offsets restored from the checkpoint. */
+    offsets: CheckpointEntry[];
+    /** Unix timestamp (ms) recorded when the checkpoint was originally saved. */
+    restoredAt: number;
+    /** Age of the restored checkpoint in milliseconds (now − `restoredAt`). */
+    checkpointAge: number;
+}
+/**
+ * Options for `replayDlq`.
+ *
+ * @example
+ * ```ts
+ * await kafka.replayDlq('orders.created', {
+ *   targetTopic: 'orders.retry-manual',
+ *   dryRun: false,
+ *   filter: (headers, value) =>
+ *     headers['x-dlq-reason'] === 'handler-error' &&
+ *     JSON.parse(value).amount > 0,
+ * });
+ * ```
+ */
+export interface DlqReplayOptions {
+    /**
+     * Override the target topic to re-publish to.
+     * Default: reads the `x-dlq-original-topic` header from each DLQ message.
+     */
+    targetTopic?: string;
+    /**
+     * Dry-run mode — log what would be replayed without actually sending.
+     * Increments the `replayed` counter so you can see what would happen.
+     */
+    dryRun?: boolean;
+    /**
+     * Optional filter — return `false` to skip a message.
+     * @param headers All headers on the DLQ message (including `x-dlq-*` metadata).
+     * @param value Raw message value (JSON string).
+     */
+    filter?: (headers: MessageHeaders, value: string) => boolean;
+    /**
+     * Seek to the earliest available offset before consuming, regardless of any
+     * previously committed offsets for the replay consumer group.
+     * Default: `true` — full replay of all DLQ messages on every call.
+     * Set to `false` to replay only messages added since the previous `replayDlq` call.
+     */
+    fromBeginning?: boolean;
+}
+/** Result returned by `KafkaClient.checkStatus()`. */
+export type KafkaHealthResult = {
+    status: "up";
+    clientId: string;
+    topics: string[];
+} | {
+    status: "down";
+    clientId: string;
+    error: string;
+};
+/** Summary of a consumer group returned by `listConsumerGroups`. */
+export interface ConsumerGroupSummary {
+    /** Consumer group ID. */
+    groupId: string;
+    /**
+     * Current broker-reported state of the group.
+     * Common values: `'Empty'`, `'Stable'`, `'PreparingRebalance'`, `'CompletingRebalance'`, `'Dead'`.
+     */
+    state: string;
+}
+/** Partition-level metadata for a topic. */
+export interface TopicPartitionInfo {
+    /** Partition index (0-based). */
+    partition: number;
+    /** Node ID of the partition leader broker. */
+    leader: number;
+    /** Node IDs of all replica brokers. */
+    replicas: number[];
+    /** Node IDs of in-sync replicas. */
+    isr: number[];
+}
+/** Topic metadata returned by `describeTopics`. */
+export interface TopicDescription {
+    /** Topic name. */
+    name: string;
+    /** Per-partition metadata. */
+    partitions: TopicPartitionInfo[];
+}
+//# sourceMappingURL=admin.types.d.ts.map

package/dist/client/types/admin.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.types.d.ts","sourceRoot":"","sources":["../../../src/client/types/admin.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAID,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,2CAA2C;AAC3C,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,uBAAuB;IACtC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;CACvB;AAID;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC7D;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAID,sDAAsD;AACtD,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,oCAAoC;IACpC,GAAG,EAAE,MAAM,EAAE,CAAC;CACf;AAED,mDAAmD;AACnD,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC"}

package/dist/client/types/client.d.ts

@@ -0,0 +1,21 @@
+import type { TopicMapConstraint } from "./common";
+import type { IKafkaProducer } from "./producer.interface";
+import type { IKafkaConsumer } from "./consumer.interface";
+import type { IKafkaAdmin } from "./admin.interface";
+import type { IKafkaLifecycle } from "./lifecycle.interface";
+export type { IKafkaProducer } from "./producer.interface";
+export type { IKafkaConsumer } from "./consumer.interface";
+export type { IKafkaAdmin } from "./admin.interface";
+export type { IKafkaLifecycle } from "./lifecycle.interface";
+/**
+ * Full Kafka client interface — the union of all role-specific sub-interfaces.
+ *
+ * Compose sub-interfaces directly when you need a narrower dependency:
+ * ```ts
+ * function sendOrder(producer: IKafkaProducer<MyTopics>) { ... }
+ * function startWorker(consumer: IKafkaConsumer<MyTopics>) { ... }
+ * ```
+ */
+export interface IKafkaClient<T extends TopicMapConstraint<T>> extends IKafkaProducer<T>, IKafkaConsumer<T>, IKafkaAdmin<T>, IKafkaLifecycle {
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/types/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,CAC3D,SAAQ,cAAc,CAAC,CAAC,CAAC,EACvB,cAAc,CAAC,CAAC,CAAC,EACjB,WAAW,CAAC,CAAC,CAAC,EACd,eAAe;CAAG"}

package/dist/client/types/common.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Mapping of topic names to their message types.
+ * Define this interface to get type-safe publish/subscribe across your app.
+ *
+ * @example
+ * ```ts
+ * // with explicit extends (IDE hints for values)
+ * interface MyTopics extends TTopicMessageMap {
+ *   "orders.created": { orderId: string; amount: number };
+ *   "users.updated": { userId: string; name: string };
+ * }
+ *
+ * // or plain interface / type — works the same
+ * interface MyTopics {
+ *   "orders.created": { orderId: string; amount: number };
+ * }
+ * ```
+ */
+export type TTopicMessageMap = {
+    [topic: string]: Record<string, any>;
+};
+/**
+ * Generic constraint for topic-message maps.
+ * Works with both `type` aliases and `interface` declarations.
+ */
+export type TopicMapConstraint<T> = {
+    [K in keyof T]: Record<string, any>;
+};
+export type ClientId = string;
+export type GroupId = string;
+export type MessageHeaders = Record<string, string>;
+/**
+ * Message compression codec.
+ * Maps directly to the underlying librdkafka codec values.
+ * - `'none'` — no compression (default)
+ * - `'gzip'` — widely supported, moderate compression ratio
+ * - `'snappy'` — fast, moderate compression ratio
+ * - `'lz4'` — fastest, slightly lower ratio
+ * - `'zstd'` — best ratio, slightly slower
+ */
+export type CompressionType = "none" | "gzip" | "snappy" | "lz4" | "zstd";
+/**
+ * Logger interface for KafkaClient.
+ * Compatible with NestJS Logger, console, winston, pino, or any custom logger.
+ *
+ * `debug` is optional — omit it to suppress debug output in production.
+ *
+ * @example
+ * ```ts
+ * // Pass a NestJS logger:
+ * const kafka = new KafkaClient(config, groupId, { logger: this.logger });
+ *
+ * // Or a minimal pino wrapper:
+ * const kafka = new KafkaClient(config, groupId, {
+ *   logger: {
+ *     log:   (msg) => pino.info(msg),
+ *     warn:  (msg, ...a) => pino.warn(msg, ...a),
+ *     error: (msg, ...a) => pino.error(msg, ...a),
+ *     debug: (msg, ...a) => pino.debug(msg, ...a),
+ *   },
+ * });
+ * ```
+ */
+export interface KafkaLogger {
+    log(message: string): void;
+    warn(message: string, ...args: any[]): void;
+    error(message: string, ...args: any[]): void;
+    debug?(message: string, ...args: any[]): void;
+}
+/**
+ * Snapshot of internal event counters accumulated since client creation
+ * (or since the last `resetMetrics()` call).
+ */
+export interface KafkaMetrics {
+    /** Total messages successfully processed by the consumer handler. */
+    processedCount: number;
+    /** Total retry attempts routed — covers both in-process retries and retry-topic hops. */
+    retryCount: number;
+    /** Total messages sent to a DLQ topic. */
+    dlqCount: number;
+    /** Total duplicate messages detected by the Lamport clock. */
+    dedupCount: number;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/client/types/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/client/types/common.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAAE,CAAC;AAE5E,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAC9B,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC;AAE7B,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC/C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAC;CACpB"}