@drarzter/kafka-client 0.9.4 → 0.11.0

package/dist/testing/test.container.d.ts

@@ -0,0 +1,63 @@
+/** Options for `KafkaTestContainer`. */
+export interface KafkaTestContainerOptions {
+    /** Docker image. Default: `"confluentinc/cp-kafka:7.7.0"`. */
+    image?: string;
+    /** Warm up the transactional coordinator on start. Default: `true`. */
+    transactionWarmup?: boolean;
+    /** Topics to pre-create. Each entry can be a string (1 partition) or `{ topic, numPartitions }`. */
+    topics?: Array<string | {
+        topic: string;
+        numPartitions?: number;
+    }>;
+}
+/**
+ * Thin wrapper around `@testcontainers/kafka` that starts a single-node
+ * KRaft Kafka container and exposes `brokers` for use with `KafkaClient`.
+ *
+ * Handles common setup pain points:
+ * - Transaction coordinator warmup (avoids transactional producer hangs)
+ * - Topic pre-creation (avoids race conditions)
+ *
+ * @example
+ * ```ts
+ * const container = new KafkaTestContainer({ topics: ['orders', 'payments'] });
+ * const brokers = await container.start();
+ *
+ * const kafka = new KafkaClient('test', 'test-group', brokers);
+ * // ... run tests ...
+ *
+ * await container.stop();
+ * ```
+ *
+ * @example Jest lifecycle
+ * ```ts
+ * let container: KafkaTestContainer;
+ * let brokers: string[];
+ *
+ * beforeAll(async () => {
+ *   container = new KafkaTestContainer({ topics: ['orders'] });
+ *   brokers = await container.start();
+ * }, 120_000);
+ *
+ * afterAll(() => container.stop());
+ * ```
+ */
+export declare class KafkaTestContainer {
+    private container;
+    private readonly image;
+    private readonly transactionWarmup;
+    private readonly topics;
+    constructor(options?: KafkaTestContainerOptions);
+    /**
+     * Start the Kafka container, pre-create topics, and optionally warm up
+     * the transaction coordinator.
+     *
+     * @returns Broker connection strings, e.g. `["localhost:55123"]`.
+     */
+    start(): Promise<string[]>;
+    /** Stop and remove the container. */
+    stop(): Promise<void>;
+    /** Broker connection strings. Throws if container is not started. */
+    get brokers(): string[];
+}
+//# sourceMappingURL=test.container.d.ts.map

package/dist/testing/test.container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.container.d.ts","sourceRoot":"","sources":["../../src/testing/test.container.ts"],"names":[],"mappings":"AAOA,wCAAwC;AACxC,MAAM,WAAW,yBAAyB;IACxC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oGAAoG;IACpG,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAErB;gBAEU,OAAO,CAAC,EAAE,yBAAyB;IAM/C;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IA2DhC,qCAAqC;IAC/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B,qEAAqE;IACrE,IAAI,OAAO,IAAI,MAAM,EAAE,CAOtB;CACF"}

package/dist/{testing.d.mts → testing/transport.fake.d.ts}

@@ -1,113 +1,10 @@
-import { T as TopicMapConstraint } from './consumer.types-fFCag3VJ.mjs';
-import { I as IKafkaClient, a as IAdmin, b as IPartitionWatermarks, c as IGroupTopicOffsets, d as IPartitionOffset, e as IGroupDescription, f as ITopicMetadata, g as IConsumer, h as IConsumerCreationOptions, i as IConsumerRunConfig, j as ITopicPartitions, k as ITopicPartitionOffset, l as ITopicPartition, m as IMessage, n as IProducer, o as IProducerRecord, p as ITransaction, q as IProducerCreationOptions, K as KafkaTransport } from './client-1irhGEu0.mjs';
-
-/**
- * Fully typed mock of `IKafkaClient<T>` where every method is a mock function.
- * Compatible with Jest, Vitest, or any framework whose `fn()` returns
- * an object with `.mock`, `.mockResolvedValue`, etc.
- */
-type MockKafkaClient<T extends TopicMapConstraint<T>> = {
-    [K in keyof IKafkaClient<T>]: IKafkaClient<T>[K] & Record<string, any>;
-};
-/** Factory that creates a no-op mock function (e.g. `() => jest.fn()`). */
-type MockFactory = () => (...args: any[]) => any;
-/**
- * Create a fully typed mock implementing every `IKafkaClient<T>` method.
- * Useful for unit-testing services that depend on `KafkaClient` without
- * touching a real broker.
- *
- * Auto-detects Jest (`jest.fn()`) or Vitest (`vi.fn()`). Pass a custom
- * `mockFactory` for other frameworks.
- *
- * All methods resolve to sensible defaults:
- * - `checkStatus()` → `{ status: 'up', clientId: 'mock-client', topics: [] }`
- * - `getClientId()` → `"mock-client"`
- * - void methods → `undefined`
- *
- * @example
- * ```ts
- * const kafka = createMockKafkaClient<MyTopics>();
- *
- * const service = new OrdersService(kafka);
- * await service.createOrder();
- *
- * expect(kafka.sendMessage).toHaveBeenCalledWith(
- *   'order.created',
- *   expect.objectContaining({ orderId: '123' }),
- * );
- * ```
- */
-declare function createMockKafkaClient<T extends TopicMapConstraint<T>>(mockFactory?: MockFactory): MockKafkaClient<T>;
-
-/** Options for `KafkaTestContainer`. */
-interface KafkaTestContainerOptions {
-    /** Docker image. Default: `"confluentinc/cp-kafka:7.7.0"`. */
-    image?: string;
-    /** Warm up the transactional coordinator on start. Default: `true`. */
-    transactionWarmup?: boolean;
-    /** Topics to pre-create. Each entry can be a string (1 partition) or `{ topic, numPartitions }`. */
-    topics?: Array<string | {
-        topic: string;
-        numPartitions?: number;
-    }>;
-}
-/**
- * Thin wrapper around `@testcontainers/kafka` that starts a single-node
- * KRaft Kafka container and exposes `brokers` for use with `KafkaClient`.
- *
- * Handles common setup pain points:
- * - Transaction coordinator warmup (avoids transactional producer hangs)
- * - Topic pre-creation (avoids race conditions)
- *
- * @example
- * ```ts
- * const container = new KafkaTestContainer({ topics: ['orders', 'payments'] });
- * const brokers = await container.start();
- *
- * const kafka = new KafkaClient('test', 'test-group', brokers);
- * // ... run tests ...
- *
- * await container.stop();
- * ```
- *
- * @example Jest lifecycle
- * ```ts
- * let container: KafkaTestContainer;
- * let brokers: string[];
- *
- * beforeAll(async () => {
- *   container = new KafkaTestContainer({ topics: ['orders'] });
- *   brokers = await container.start();
- * }, 120_000);
- *
- * afterAll(() => container.stop());
- * ```
- */
-declare class KafkaTestContainer {
-    private container;
-    private readonly image;
-    private readonly transactionWarmup;
-    private readonly topics;
-    constructor(options?: KafkaTestContainerOptions);
-    /**
-     * Start the Kafka container, pre-create topics, and optionally warm up
-     * the transaction coordinator.
-     *
-     * @returns Broker connection strings, e.g. `["localhost:55123"]`.
-     */
-    start(): Promise<string[]>;
-    /** Stop and remove the container. */
-    stop(): Promise<void>;
-    /** Broker connection strings. Throws if container is not started. */
-    get brokers(): string[];
-}
-
+import type { KafkaTransport, IProducer, IConsumer, IAdmin, ITransaction, IProducerRecord, IProducerCreationOptions, IConsumerCreationOptions, IConsumerRunConfig, ITopicPartition, ITopicPartitions, ITopicPartitionOffset, IPartitionWatermarks, IPartitionOffset, IGroupTopicOffsets, IGroupDescription, ITopicMetadata, IMessage } from "../client/transport/transport.interface";
 /**
  * An in-memory Kafka transaction.
  * Staged sends are visible in `staged`; committed sends are flushed
  * to the owning `FakeProducer.sent` on `commit()`.
  */
-declare class FakeTransaction implements ITransaction {
+export declare class FakeTransaction implements ITransaction {
     private readonly producer;
     /** Records staged within this transaction (not yet committed). */
     readonly staged: IProducerRecord[];
@@ -142,7 +39,7 @@ declare class FakeTransaction implements ITransaction {
  * In-memory producer. All `send()` calls are captured in `sent`.
  * Transactions are backed by `FakeTransaction`.
  */
-declare class FakeProducer implements IProducer {
+export declare class FakeProducer implements IProducer {
     /** All records delivered via `send()` (direct + committed transactions). */
     readonly sent: IProducerRecord[];
     /** All transactions opened via `transaction()`. */
@@ -166,7 +63,7 @@ declare class FakeProducer implements IProducer {
  * Call `deliver(topic, message)` from your test to push messages through
  * the `eachMessage` handler without a real broker.
  */
-declare class FakeConsumer implements IConsumer {
+export declare class FakeConsumer implements IConsumer {
     readonly groupId: string;
     readonly fromBeginning: boolean;
     /** Topics subscribed via `subscribe()`. */
@@ -209,7 +106,7 @@ declare class FakeConsumer implements IConsumer {
  * Pre-populate `topicOffsets`, `groupOffsets`, and `existingTopics`
  * to control what admin queries return.
  */
-declare class FakeAdmin implements IAdmin {
+export declare class FakeAdmin implements IAdmin {
     /** Topics returned by `listTopics()`. Add to this from your test. */
     readonly existingTopics: string[];
     /** Per-topic partition watermarks returned by `fetchTopicOffsets()`. */
@@ -280,7 +177,7 @@ declare class FakeAdmin implements IAdmin {
  * expect(transport.mainProducer.sentTo('orders')).toHaveLength(1);
  * ```
  */
-declare class FakeTransport implements KafkaTransport {
+export declare class FakeTransport implements KafkaTransport {
     private readonly _producers;
     private readonly _consumers;
     private readonly _admin;
@@ -314,5 +211,4 @@ declare class FakeTransport implements KafkaTransport {
         offset?: string;
     }): Promise<void>;
 }
-
-export { FakeAdmin, FakeConsumer, FakeProducer, FakeTransaction, FakeTransport, KafkaTestContainer, type KafkaTestContainerOptions, type MockKafkaClient, createMockKafkaClient };
+//# sourceMappingURL=transport.fake.d.ts.map

package/dist/testing/transport.fake.d.ts.map

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

package/dist/testing.d.ts

@@ -1,318 +1,2 @@
-import { T as TopicMapConstraint } from './consumer.types-fFCag3VJ.js';
-import { I as IKafkaClient, a as IAdmin, b as IPartitionWatermarks, c as IGroupTopicOffsets, d as IPartitionOffset, e as IGroupDescription, f as ITopicMetadata, g as IConsumer, h as IConsumerCreationOptions, i as IConsumerRunConfig, j as ITopicPartitions, k as ITopicPartitionOffset, l as ITopicPartition, m as IMessage, n as IProducer, o as IProducerRecord, p as ITransaction, q as IProducerCreationOptions, K as KafkaTransport } from './client-BpFjkHhr.js';
-
-/**
- * Fully typed mock of `IKafkaClient<T>` where every method is a mock function.
- * Compatible with Jest, Vitest, or any framework whose `fn()` returns
- * an object with `.mock`, `.mockResolvedValue`, etc.
- */
-type MockKafkaClient<T extends TopicMapConstraint<T>> = {
-    [K in keyof IKafkaClient<T>]: IKafkaClient<T>[K] & Record<string, any>;
-};
-/** Factory that creates a no-op mock function (e.g. `() => jest.fn()`). */
-type MockFactory = () => (...args: any[]) => any;
-/**
- * Create a fully typed mock implementing every `IKafkaClient<T>` method.
- * Useful for unit-testing services that depend on `KafkaClient` without
- * touching a real broker.
- *
- * Auto-detects Jest (`jest.fn()`) or Vitest (`vi.fn()`). Pass a custom
- * `mockFactory` for other frameworks.
- *
- * All methods resolve to sensible defaults:
- * - `checkStatus()` → `{ status: 'up', clientId: 'mock-client', topics: [] }`
- * - `getClientId()` → `"mock-client"`
- * - void methods → `undefined`
- *
- * @example
- * ```ts
- * const kafka = createMockKafkaClient<MyTopics>();
- *
- * const service = new OrdersService(kafka);
- * await service.createOrder();
- *
- * expect(kafka.sendMessage).toHaveBeenCalledWith(
- *   'order.created',
- *   expect.objectContaining({ orderId: '123' }),
- * );
- * ```
- */
-declare function createMockKafkaClient<T extends TopicMapConstraint<T>>(mockFactory?: MockFactory): MockKafkaClient<T>;
-
-/** Options for `KafkaTestContainer`. */
-interface KafkaTestContainerOptions {
-    /** Docker image. Default: `"confluentinc/cp-kafka:7.7.0"`. */
-    image?: string;
-    /** Warm up the transactional coordinator on start. Default: `true`. */
-    transactionWarmup?: boolean;
-    /** Topics to pre-create. Each entry can be a string (1 partition) or `{ topic, numPartitions }`. */
-    topics?: Array<string | {
-        topic: string;
-        numPartitions?: number;
-    }>;
-}
-/**
- * Thin wrapper around `@testcontainers/kafka` that starts a single-node
- * KRaft Kafka container and exposes `brokers` for use with `KafkaClient`.
- *
- * Handles common setup pain points:
- * - Transaction coordinator warmup (avoids transactional producer hangs)
- * - Topic pre-creation (avoids race conditions)
- *
- * @example
- * ```ts
- * const container = new KafkaTestContainer({ topics: ['orders', 'payments'] });
- * const brokers = await container.start();
- *
- * const kafka = new KafkaClient('test', 'test-group', brokers);
- * // ... run tests ...
- *
- * await container.stop();
- * ```
- *
- * @example Jest lifecycle
- * ```ts
- * let container: KafkaTestContainer;
- * let brokers: string[];
- *
- * beforeAll(async () => {
- *   container = new KafkaTestContainer({ topics: ['orders'] });
- *   brokers = await container.start();
- * }, 120_000);
- *
- * afterAll(() => container.stop());
- * ```
- */
-declare class KafkaTestContainer {
-    private container;
-    private readonly image;
-    private readonly transactionWarmup;
-    private readonly topics;
-    constructor(options?: KafkaTestContainerOptions);
-    /**
-     * Start the Kafka container, pre-create topics, and optionally warm up
-     * the transaction coordinator.
-     *
-     * @returns Broker connection strings, e.g. `["localhost:55123"]`.
-     */
-    start(): Promise<string[]>;
-    /** Stop and remove the container. */
-    stop(): Promise<void>;
-    /** Broker connection strings. Throws if container is not started. */
-    get brokers(): string[];
-}
-
-/**
- * An in-memory Kafka transaction.
- * Staged sends are visible in `staged`; committed sends are flushed
- * to the owning `FakeProducer.sent` on `commit()`.
- */
-declare class FakeTransaction implements ITransaction {
-    private readonly producer;
-    /** Records staged within this transaction (not yet committed). */
-    readonly staged: IProducerRecord[];
-    /** True after `commit()` was called. */
-    committed: boolean;
-    /** True after `abort()` was called. */
-    aborted: boolean;
-    /** sendOffsets calls (for EOS assertions). */
-    readonly offsetsCommitted: Array<{
-        consumer: IConsumer;
-        topics: Array<{
-            topic: string;
-            partitions: IPartitionOffset[];
-        }>;
-    }>;
-    constructor(producer: FakeProducer);
-    send(record: IProducerRecord): Promise<void>;
-    sendOffsets(options: {
-        consumer: IConsumer;
-        topics: Array<{
-            topic: string;
-            partitions: Array<{
-                partition: number;
-                offset: string;
-            }>;
-        }>;
-    }): Promise<void>;
-    commit(): Promise<void>;
-    abort(): Promise<void>;
-}
-/**
- * In-memory producer. All `send()` calls are captured in `sent`.
- * Transactions are backed by `FakeTransaction`.
- */
-declare class FakeProducer implements IProducer {
-    /** All records delivered via `send()` (direct + committed transactions). */
-    readonly sent: IProducerRecord[];
-    /** All transactions opened via `transaction()`. */
-    readonly transactions: FakeTransaction[];
-    readonly options: IProducerCreationOptions | undefined;
-    connected: boolean;
-    constructor(options?: IProducerCreationOptions);
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    send(record: IProducerRecord): Promise<void>;
-    transaction(): Promise<ITransaction>;
-    /** Return the last committed transaction, or throw if none exist. */
-    get lastTransaction(): FakeTransaction;
-    /** All topic names that received at least one message. */
-    sentTopics(): string[];
-    /** All messages sent to a specific topic. */
-    sentTo(topic: string): IProducerRecord["messages"];
-}
-/**
- * In-memory consumer.
- * Call `deliver(topic, message)` from your test to push messages through
- * the `eachMessage` handler without a real broker.
- */
-declare class FakeConsumer implements IConsumer {
-    readonly groupId: string;
-    readonly fromBeginning: boolean;
-    /** Topics subscribed via `subscribe()`. */
-    readonly subscribed: string[];
-    private _runConfig;
-    private _assignments;
-    readonly pausedTopics: Set<string>;
-    connected: boolean;
-    private readonly onRebalance;
-    constructor(options: IConsumerCreationOptions);
-    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(_options: ITopicPartitionOffset): void;
-    assignment(): ITopicPartition[];
-    commitOffsets(_offsets: ITopicPartitionOffset[]): Promise<void>;
-    stop(): Promise<void>;
-    /**
-     * Push a message through the `eachMessage` handler.
-     * Throws if `run()` has not been called yet.
-     */
-    deliver(topic: string, message: Partial<IMessage> & {
-        value: Buffer | null;
-    }, partition?: number, offset?: string): Promise<void>;
-    /**
-     * Simulate a partition-assign rebalance event.
-     * Useful for testing onRebalance callbacks.
-     */
-    triggerRebalance(type: "assign" | "revoke", assignments: ITopicPartition[]): void;
-    /** Whether `run()` has been called (consumer is active). */
-    get isRunning(): boolean;
-}
-/**
- * In-memory admin client.
- * Pre-populate `topicOffsets`, `groupOffsets`, and `existingTopics`
- * to control what admin queries return.
- */
-declare class FakeAdmin implements IAdmin {
-    /** Topics returned by `listTopics()`. Add to this from your test. */
-    readonly existingTopics: string[];
-    /** Per-topic partition watermarks returned by `fetchTopicOffsets()`. */
-    readonly topicOffsets: Map<string, IPartitionWatermarks[]>;
-    /** Per-groupId committed offsets returned by `fetchOffsets()`. */
-    readonly groupOffsets: Map<string, IGroupTopicOffsets[]>;
-    /** Calls captured by `setOffsets()` — inspect in tests. */
-    readonly setOffsetsCalls: Array<{
-        groupId: string;
-        topic: string;
-        partitions: IPartitionOffset[];
-    }>;
-    /** Group IDs deleted via `deleteGroups()`. */
-    readonly deletedGroups: string[];
-    /** Records deleted via `deleteTopicRecords()`. */
-    readonly deletedRecords: Array<{
-        topic: string;
-        partitions: IPartitionOffset[];
-    }>;
-    connected: boolean;
-    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>;
-}
-/**
- * In-memory `KafkaTransport` for unit testing.
- *
- * Inject into `KafkaClient` via `KafkaClientOptions.transport` to test
- * producer/consumer logic without `jest.mock('@confluentinc/kafka-javascript')`.
- *
- * @example
- * ```ts
- * const transport = new FakeTransport();
- * const client = new KafkaClient('svc', 'grp', [], { transport });
- *
- * await client.connectProducer();
- * await client.sendMessage('orders', { id: '1' });
- *
- * expect(transport.mainProducer.sentTo('orders')).toHaveLength(1);
- * ```
- */
-declare class FakeTransport implements KafkaTransport {
-    private readonly _producers;
-    private readonly _consumers;
-    private readonly _admin;
-    producer(options?: IProducerCreationOptions): IProducer;
-    consumer(options: IConsumerCreationOptions): IConsumer;
-    admin(): IAdmin;
-    /** The admin client shared across all admin() calls. */
-    get fakeAdmin(): FakeAdmin;
-    /**
-     * The first (default) producer — the non-transactional producer
-     * created during `KafkaClient` construction.
-     */
-    get mainProducer(): FakeProducer;
-    /** All producers created so far (main + transactional). */
-    get producers(): readonly FakeProducer[];
-    /** All consumers created so far. */
-    get consumers(): readonly FakeConsumer[];
-    /**
-     * Find the consumer for a given group ID.
-     * Throws if no consumer with that group exists.
-     */
-    consumerFor(groupId: string): FakeConsumer;
-    /**
-     * Deliver a JSON-serialized message to the first consumer subscribed to `topic`.
-     * Simulates a broker dispatching a message to the consumer handler.
-     */
-    deliver<T>(topic: string, payload: T, options?: {
-        key?: string;
-        headers?: Record<string, string>;
-        partition?: number;
-        offset?: string;
-    }): Promise<void>;
-}
-
-export { FakeAdmin, FakeConsumer, FakeProducer, FakeTransaction, FakeTransport, KafkaTestContainer, type KafkaTestContainerOptions, type MockKafkaClient, createMockKafkaClient };
+export * from "./testing/index";
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/testing.js

@@ -63,6 +63,7 @@ function createMockKafkaClient(mockFactory) {
     getClientId: returning("mock-client"),
     sendMessage: resolved(void 0),
     sendBatch: resolved(void 0),
+    sendTombstone: resolved(void 0),
     transaction: mock().mockImplementation(
       async (cb) => {
         const ctx = {
@@ -82,6 +83,21 @@ function createMockKafkaClient(mockFactory) {
       stop: mock().mockResolvedValue(void 0),
       ready: mock().mockResolvedValue(void 0)
     }),
+    startWindowConsumer: resolved({
+      groupId: "mock-group",
+      stop: mock().mockResolvedValue(void 0),
+      ready: mock().mockResolvedValue(void 0)
+    }),
+    startRoutedConsumer: resolved({
+      groupId: "mock-group",
+      stop: mock().mockResolvedValue(void 0),
+      ready: mock().mockResolvedValue(void 0)
+    }),
+    startTransactionalConsumer: resolved({
+      groupId: "mock-group",
+      stop: mock().mockResolvedValue(void 0),
+      ready: mock().mockResolvedValue(void 0)
+    }),
     stopConsumer: resolved(void 0),
     consume: returning(
       (function* () {
@@ -101,6 +117,15 @@ function createMockKafkaClient(mockFactory) {
       dedupCount: 0
     }),
     resetMetrics: mock(),
+    listConsumerGroups: resolved([]),
+    describeTopics: resolved([]),
+    deleteRecords: resolved(void 0),
+    readSnapshot: resolved(/* @__PURE__ */ new Map()),
+    checkpointOffsets: resolved({ groupId: "mock-group", checkpoints: [] }),
+    restoreFromCheckpoint: resolved(void 0),
+    connectProducer: resolved(void 0),
+    disconnectProducer: resolved(void 0),
+    onModuleDestroy: resolved(void 0),
     disconnect: resolved(void 0),
     enableGracefulShutdown: mock()
   };
@@ -194,6 +219,7 @@ var FakeTransaction = class {
   constructor(producer) {
     this.producer = producer;
   }
+  producer;
   /** Records staged within this transaction (not yet committed). */
   staged = [];
   /** True after `commit()` was called. */