@drarzter/kafka-client 0.8.0 → 0.9.2

package/dist/testing.js

@@ -20,6 +20,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/testing.ts
 var testing_exports = {};
 __export(testing_exports, {
+  FakeAdmin: () => FakeAdmin,
+  FakeConsumer: () => FakeConsumer,
+  FakeProducer: () => FakeProducer,
+  FakeTransaction: () => FakeTransaction,
+  FakeTransport: () => FakeTransport,
   KafkaTestContainer: () => KafkaTestContainer,
   createMockKafkaClient: () => createMockKafkaClient
 });
@@ -69,11 +74,13 @@ function createMockKafkaClient(mockFactory) {
     ),
     startConsumer: resolved({
       groupId: "mock-group",
-      stop: mock().mockResolvedValue(void 0)
+      stop: mock().mockResolvedValue(void 0),
+      ready: mock().mockResolvedValue(void 0)
     }),
     startBatchConsumer: resolved({
       groupId: "mock-group",
-      stop: mock().mockResolvedValue(void 0)
+      stop: mock().mockResolvedValue(void 0),
+      ready: mock().mockResolvedValue(void 0)
     }),
     stopConsumer: resolved(void 0),
     consume: returning(
@@ -181,8 +188,297 @@ var KafkaTestContainer = class {
     return [`${host}:${port}`];
   }
 };
+
+// src/testing/fake-transport.ts
+var FakeTransaction = class {
+  constructor(producer) {
+    this.producer = producer;
+  }
+  /** Records staged within this transaction (not yet committed). */
+  staged = [];
+  /** True after `commit()` was called. */
+  committed = false;
+  /** True after `abort()` was called. */
+  aborted = false;
+  /** sendOffsets calls (for EOS assertions). */
+  offsetsCommitted = [];
+  async send(record) {
+    this.staged.push(record);
+  }
+  async sendOffsets(options) {
+    this.offsetsCommitted.push(options);
+  }
+  async commit() {
+    if (this.aborted) throw new Error("FakeTransaction: already aborted");
+    this.committed = true;
+    for (const record of this.staged) {
+      this.producer.sent.push(record);
+    }
+  }
+  async abort() {
+    if (this.committed) throw new Error("FakeTransaction: already committed");
+    this.aborted = true;
+    this.staged.length = 0;
+  }
+};
+var FakeProducer = class {
+  /** All records delivered via `send()` (direct + committed transactions). */
+  sent = [];
+  /** All transactions opened via `transaction()`. */
+  transactions = [];
+  options;
+  connected = false;
+  constructor(options) {
+    this.options = options;
+  }
+  async connect() {
+    this.connected = true;
+  }
+  async disconnect() {
+    this.connected = false;
+  }
+  async send(record) {
+    this.sent.push(record);
+  }
+  async transaction() {
+    const tx = new FakeTransaction(this);
+    this.transactions.push(tx);
+    return tx;
+  }
+  /** Return the last committed transaction, or throw if none exist. */
+  get lastTransaction() {
+    const tx = this.transactions.at(-1);
+    if (!tx) throw new Error("FakeProducer: no transactions opened yet");
+    return tx;
+  }
+  /** All topic names that received at least one message. */
+  sentTopics() {
+    return [...new Set(this.sent.map((r) => r.topic))];
+  }
+  /** All messages sent to a specific topic. */
+  sentTo(topic) {
+    return this.sent.filter((r) => r.topic === topic).flatMap((r) => r.messages);
+  }
+};
+var FakeConsumer = class {
+  groupId;
+  fromBeginning;
+  /** Topics subscribed via `subscribe()`. */
+  subscribed = [];
+  _runConfig;
+  _assignments = [];
+  pausedTopics = /* @__PURE__ */ new Set();
+  connected = false;
+  onRebalance;
+  constructor(options) {
+    this.groupId = options.groupId;
+    this.fromBeginning = options.fromBeginning ?? false;
+    this.onRebalance = options.onRebalance;
+  }
+  async connect() {
+    this.connected = true;
+  }
+  async disconnect() {
+    this.connected = false;
+  }
+  async subscribe(options) {
+    for (const t of options.topics) {
+      if (typeof t === "string") this.subscribed.push(t);
+    }
+    this._assignments = this.subscribed.map((topic) => ({ topic, partition: 0 }));
+    this.onRebalance?.("assign", this._assignments);
+  }
+  async run(config) {
+    this._runConfig = config;
+  }
+  pause(assignments) {
+    for (const { topic } of assignments) this.pausedTopics.add(topic);
+  }
+  resume(assignments) {
+    for (const { topic } of assignments) this.pausedTopics.delete(topic);
+  }
+  seek(_options) {
+  }
+  assignment() {
+    return this._assignments;
+  }
+  async commitOffsets(_offsets) {
+  }
+  async stop() {
+    this.connected = false;
+  }
+  // ── Test helpers ─────────────────────────────────────────────────────
+  /**
+   * Push a message through the `eachMessage` handler.
+   * Throws if `run()` has not been called yet.
+   */
+  async deliver(topic, message, partition = 0, offset = "0") {
+    if (!this._runConfig?.eachMessage) {
+      throw new Error(
+        `FakeConsumer(${this.groupId}): run() with eachMessage not called yet`
+      );
+    }
+    await this._runConfig.eachMessage({
+      topic,
+      partition,
+      message: {
+        value: message.value,
+        headers: message.headers ?? {},
+        offset,
+        key: message.key
+      }
+    });
+  }
+  /**
+   * Simulate a partition-assign rebalance event.
+   * Useful for testing onRebalance callbacks.
+   */
+  triggerRebalance(type, assignments) {
+    this.onRebalance?.(type, assignments);
+  }
+  /** Whether `run()` has been called (consumer is active). */
+  get isRunning() {
+    return this._runConfig !== void 0;
+  }
+};
+var FakeAdmin = class {
+  /** Topics returned by `listTopics()`. Add to this from your test. */
+  existingTopics = [];
+  /** Per-topic partition watermarks returned by `fetchTopicOffsets()`. */
+  topicOffsets = /* @__PURE__ */ new Map();
+  /** Per-groupId committed offsets returned by `fetchOffsets()`. */
+  groupOffsets = /* @__PURE__ */ new Map();
+  /** Calls captured by `setOffsets()` — inspect in tests. */
+  setOffsetsCalls = [];
+  /** Group IDs deleted via `deleteGroups()`. */
+  deletedGroups = [];
+  /** Records deleted via `deleteTopicRecords()`. */
+  deletedRecords = [];
+  connected = false;
+  async connect() {
+    this.connected = true;
+  }
+  async disconnect() {
+    this.connected = false;
+  }
+  async createTopics(options) {
+    for (const { topic } of options.topics) {
+      if (!this.existingTopics.includes(topic)) this.existingTopics.push(topic);
+    }
+  }
+  async fetchTopicOffsets(topic) {
+    return this.topicOffsets.get(topic) ?? [{ partition: 0, low: "0", high: "0" }];
+  }
+  async fetchTopicOffsetsByTimestamp(_topic, _timestamp) {
+    return [];
+  }
+  async fetchOffsets(options) {
+    return this.groupOffsets.get(options.groupId) ?? [];
+  }
+  async setOffsets(options) {
+    this.setOffsetsCalls.push(options);
+  }
+  async listTopics() {
+    return this.existingTopics;
+  }
+  async listGroups() {
+    return { groups: [] };
+  }
+  async fetchTopicMetadata(_options) {
+    return { topics: [] };
+  }
+  async deleteGroups(groupIds) {
+    this.deletedGroups.push(...groupIds);
+  }
+  async deleteTopicRecords(options) {
+    this.deletedRecords.push(options);
+  }
+};
+var FakeTransport = class {
+  _producers = [];
+  _consumers = [];
+  _admin = new FakeAdmin();
+  producer(options) {
+    const p = new FakeProducer(options);
+    this._producers.push(p);
+    return p;
+  }
+  consumer(options) {
+    const c = new FakeConsumer(options);
+    this._consumers.push(c);
+    return c;
+  }
+  admin() {
+    return this._admin;
+  }
+  // ── Convenience accessors ─────────────────────────────────────────
+  /** The admin client shared across all admin() calls. */
+  get fakeAdmin() {
+    return this._admin;
+  }
+  /**
+   * The first (default) producer — the non-transactional producer
+   * created during `KafkaClient` construction.
+   */
+  get mainProducer() {
+    const p = this._producers[0];
+    if (!p) throw new Error("FakeTransport: no producers created yet");
+    return p;
+  }
+  /** All producers created so far (main + transactional). */
+  get producers() {
+    return this._producers;
+  }
+  /** All consumers created so far. */
+  get consumers() {
+    return this._consumers;
+  }
+  /**
+   * Find the consumer for a given group ID.
+   * Throws if no consumer with that group exists.
+   */
+  consumerFor(groupId) {
+    const c = this._consumers.find(
+      (c2) => c2.groupId === groupId || c2.groupId.startsWith(groupId)
+    );
+    if (!c)
+      throw new Error(
+        `FakeTransport: no consumer for group "${groupId}". Available: ${this._consumers.map((c2) => c2.groupId).join(", ") || "(none)"}`
+      );
+    return c;
+  }
+  /**
+   * Deliver a JSON-serialized message to the first consumer subscribed to `topic`.
+   * Simulates a broker dispatching a message to the consumer handler.
+   */
+  async deliver(topic, payload, options = {}) {
+    const consumer = this._consumers.find((c) => c.subscribed.includes(topic));
+    if (!consumer) {
+      throw new Error(
+        `FakeTransport: no consumer subscribed to "${topic}". Subscribed topics: ${this._consumers.flatMap((c) => c.subscribed).join(", ") || "(none)"}`
+      );
+    }
+    await consumer.deliver(
+      topic,
+      {
+        value: Buffer.from(JSON.stringify(payload)),
+        headers: options.headers ? Object.fromEntries(
+          Object.entries(options.headers).map(([k, v]) => [k, [v]])
+        ) : {},
+        key: options.key !== void 0 ? Buffer.from(options.key) : void 0
+      },
+      options.partition ?? 0,
+      options.offset ?? "0"
+    );
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  FakeAdmin,
+  FakeConsumer,
+  FakeProducer,
+  FakeTransaction,
+  FakeTransport,
   KafkaTestContainer,
   createMockKafkaClient
 });

package/dist/testing.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/testing.ts","../src/testing/mock-client.ts","../src/testing/test-container.ts"],"sourcesContent":["export * from \"./testing/index\";\n","import type { IKafkaClient, TopicMapConstraint } from \"../client/types\";\n\n/**\n * Fully typed mock of `IKafkaClient<T>` where every method is a mock function.\n * Compatible with Jest, Vitest, or any framework whose `fn()` returns\n * an object with `.mock`, `.mockResolvedValue`, etc.\n */\nexport type MockKafkaClient<T extends TopicMapConstraint<T>> = {\n  [K in keyof IKafkaClient<T>]: IKafkaClient<T>[K] & Record<string, any>;\n};\n\n/** Factory that creates a no-op mock function (e.g. `() => jest.fn()`). */\nexport type MockFactory = () => (...args: any[]) => any;\n\nfunction detectMockFactory(): MockFactory {\n  // Jest and Vitest inject their globals (`jest` / `vi`) as module-scope\n  // bindings, not as properties of `globalThis`. The only reliable way to\n  // detect them without a hard import is via `eval`, which evaluates in the\n  // current module scope where those bindings are available.\n  try {\n    if (eval(\"typeof jest === 'object' && typeof jest.fn === 'function'\")) {\n      return () => eval(\"jest.fn()\");\n    }\n  } catch {\n    /* not available */\n  }\n  try {\n    if (eval(\"typeof vi === 'object' && typeof vi.fn === 'function'\")) {\n      return () => eval(\"vi.fn()\");\n    }\n  } catch {\n    /* not available */\n  }\n  throw new Error(\n    \"createMockKafkaClient: no mock framework detected (jest/vitest). \" +\n      \"Pass a custom mockFactory.\",\n  );\n}\n\n/**\n * Create a fully typed mock implementing every `IKafkaClient<T>` method.\n * Useful for unit-testing services that depend on `KafkaClient` without\n * touching a real broker.\n *\n * Auto-detects Jest (`jest.fn()`) or Vitest (`vi.fn()`). Pass a custom\n * `mockFactory` for other frameworks.\n *\n * All methods resolve to sensible defaults:\n * - `checkStatus()` → `{ status: 'up', clientId: 'mock-client', topics: [] }`\n * - `getClientId()` → `\"mock-client\"`\n * - void methods → `undefined`\n *\n * @example\n * ```ts\n * const kafka = createMockKafkaClient<MyTopics>();\n *\n * const service = new OrdersService(kafka);\n * await service.createOrder();\n *\n * expect(kafka.sendMessage).toHaveBeenCalledWith(\n *   'order.created',\n *   expect.objectContaining({ orderId: '123' }),\n * );\n * ```\n */\nexport function createMockKafkaClient<T extends TopicMapConstraint<T>>(\n  mockFactory?: MockFactory,\n): MockKafkaClient<T> {\n  const fn = mockFactory ?? detectMockFactory();\n\n  const mock = () => fn() as any;\n  const resolved = (value: unknown) => mock().mockResolvedValue(value);\n  const returning = (value: unknown) => mock().mockReturnValue(value);\n\n  return {\n    checkStatus: resolved({\n      status: \"up\",\n      clientId: \"mock-client\",\n      topics: [],\n    }),\n    getConsumerLag: resolved([]),\n    getClientId: returning(\"mock-client\"),\n    sendMessage: resolved(undefined),\n    sendBatch: resolved(undefined),\n    transaction: mock().mockImplementation(\n      async (cb: (ctx: Record<string, unknown>) => Promise<void>) => {\n        const ctx = {\n          send: resolved(undefined),\n          sendBatch: resolved(undefined),\n        };\n        await cb(ctx);\n      },\n    ),\n    startConsumer: resolved({\n      groupId: \"mock-group\",\n      stop: mock().mockResolvedValue(undefined),\n    }),\n    startBatchConsumer: resolved({\n      groupId: \"mock-group\",\n      stop: mock().mockResolvedValue(undefined),\n    }),\n    stopConsumer: resolved(undefined),\n    consume: returning(\n      (function* () {})() as unknown as AsyncIterableIterator<any>,\n    ),\n    replayDlq: resolved({ replayed: 0, skipped: 0 }),\n    resetOffsets: resolved(undefined),\n    seekToOffset: resolved(undefined),\n    seekToTimestamp: resolved(undefined),\n    getCircuitState: returning(undefined),\n    pauseConsumer: mock(),\n    resumeConsumer: mock(),\n    getMetrics: returning({\n      processedCount: 0,\n      retryCount: 0,\n      dlqCount: 0,\n      dedupCount: 0,\n    }),\n    resetMetrics: mock(),\n    disconnect: resolved(undefined),\n    enableGracefulShutdown: mock(),\n  } as unknown as MockKafkaClient<T>;\n}\n","import {\n  KafkaContainer,\n  type StartedKafkaContainer,\n} from \"@testcontainers/kafka\";\nimport { KafkaJS } from \"@confluentinc/kafka-javascript\";\nconst { Kafka, logLevel: KafkaLogLevel } = KafkaJS;\n\n/** Options for `KafkaTestContainer`. */\nexport interface KafkaTestContainerOptions {\n  /** Docker image. Default: `\"confluentinc/cp-kafka:7.7.0\"`. */\n  image?: string;\n  /** Warm up the transactional coordinator on start. Default: `true`. */\n  transactionWarmup?: boolean;\n  /** Topics to pre-create. Each entry can be a string (1 partition) or `{ topic, numPartitions }`. */\n  topics?: Array<string | { topic: string; numPartitions?: number }>;\n}\n\n/**\n * Thin wrapper around `@testcontainers/kafka` that starts a single-node\n * KRaft Kafka container and exposes `brokers` for use with `KafkaClient`.\n *\n * Handles common setup pain points:\n * - Transaction coordinator warmup (avoids transactional producer hangs)\n * - Topic pre-creation (avoids race conditions)\n *\n * @example\n * ```ts\n * const container = new KafkaTestContainer({ topics: ['orders', 'payments'] });\n * const brokers = await container.start();\n *\n * const kafka = new KafkaClient('test', 'test-group', brokers);\n * // ... run tests ...\n *\n * await container.stop();\n * ```\n *\n * @example Jest lifecycle\n * ```ts\n * let container: KafkaTestContainer;\n * let brokers: string[];\n *\n * beforeAll(async () => {\n *   container = new KafkaTestContainer({ topics: ['orders'] });\n *   brokers = await container.start();\n * }, 120_000);\n *\n * afterAll(() => container.stop());\n * ```\n */\nexport class KafkaTestContainer {\n  private container: StartedKafkaContainer | undefined;\n  private readonly image: string;\n  private readonly transactionWarmup: boolean;\n  private readonly topics: Array<\n    string | { topic: string; numPartitions?: number }\n  >;\n\n  constructor(options?: KafkaTestContainerOptions) {\n    this.image = options?.image ?? \"confluentinc/cp-kafka:7.7.0\";\n    this.transactionWarmup = options?.transactionWarmup ?? true;\n    this.topics = options?.topics ?? [];\n  }\n\n  /**\n   * Start the Kafka container, pre-create topics, and optionally warm up\n   * the transaction coordinator.\n   *\n   * @returns Broker connection strings, e.g. `[\"localhost:55123\"]`.\n   */\n  async start(): Promise<string[]> {\n    this.container = await new KafkaContainer(this.image)\n      .withKraft()\n      .withExposedPorts(9093)\n      .withEnvironment({\n        KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR: \"1\",\n        KAFKA_TRANSACTION_STATE_LOG_MIN_ISR: \"1\",\n      })\n      .start();\n\n    const host = this.container.getHost();\n    const port = this.container.getMappedPort(9093);\n    const brokers = [`${host}:${port}`];\n\n    const kafka = new Kafka({\n      kafkaJS: {\n        clientId: \"test-container-setup\",\n        brokers,\n        logLevel: KafkaLogLevel.NOTHING,\n      },\n    });\n\n    if (this.topics.length > 0) {\n      const admin = kafka.admin();\n      await admin.connect();\n      await admin.createTopics({\n        topics: this.topics.map((t) =>\n          typeof t === \"string\"\n            ? { topic: t, numPartitions: 1 }\n            : { topic: t.topic, numPartitions: t.numPartitions ?? 1 },\n        ),\n      });\n      await admin.disconnect();\n    }\n\n    if (this.transactionWarmup) {\n      const warmupKafka = new Kafka({\n        kafkaJS: {\n          clientId: \"test-container-warmup\",\n          brokers,\n          logLevel: KafkaLogLevel.NOTHING,\n        },\n      });\n      const txProducer = warmupKafka.producer({\n        kafkaJS: {\n          transactionalId: \"test-container-warmup-tx\",\n          idempotent: true,\n          maxInFlightRequests: 1,\n        },\n      });\n      await txProducer.connect();\n      const tx = await txProducer.transaction();\n      await tx.abort();\n      await txProducer.disconnect();\n    }\n\n    return brokers;\n  }\n\n  /** Stop and remove the container. */\n  async stop(): Promise<void> {\n    await this.container?.stop();\n    this.container = undefined;\n  }\n\n  /** Broker connection strings. Throws if container is not started. */\n  get brokers(): string[] {\n    if (!this.container) {\n      throw new Error(\"KafkaTestContainer is not started. Call start() first.\");\n    }\n    const host = this.container.getHost();\n    const port = this.container.getMappedPort(9093);\n    return [`${host}:${port}`];\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/testing.ts","../src/testing/mock-client.ts","../src/testing/test-container.ts","../src/testing/fake-transport.ts"],"sourcesContent":["export * from \"./testing/index\";\n","import type { IKafkaClient, TopicMapConstraint } from \"../client/types\";\n\n/**\n * Fully typed mock of `IKafkaClient<T>` where every method is a mock function.\n * Compatible with Jest, Vitest, or any framework whose `fn()` returns\n * an object with `.mock`, `.mockResolvedValue`, etc.\n */\nexport type MockKafkaClient<T extends TopicMapConstraint<T>> = {\n  [K in keyof IKafkaClient<T>]: IKafkaClient<T>[K] & Record<string, any>;\n};\n\n/** Factory that creates a no-op mock function (e.g. `() => jest.fn()`). */\nexport type MockFactory = () => (...args: any[]) => any;\n\nfunction detectMockFactory(): MockFactory {\n  // Jest and Vitest inject their globals (`jest` / `vi`) as module-scope\n  // bindings, not as properties of `globalThis`. The only reliable way to\n  // detect them without a hard import is via `eval`, which evaluates in the\n  // current module scope where those bindings are available.\n  try {\n    if (eval(\"typeof jest === 'object' && typeof jest.fn === 'function'\")) {\n      return () => eval(\"jest.fn()\");\n    }\n  } catch {\n    /* not available */\n  }\n  try {\n    if (eval(\"typeof vi === 'object' && typeof vi.fn === 'function'\")) {\n      return () => eval(\"vi.fn()\");\n    }\n  } catch {\n    /* not available */\n  }\n  throw new Error(\n    \"createMockKafkaClient: no mock framework detected (jest/vitest). \" +\n      \"Pass a custom mockFactory.\",\n  );\n}\n\n/**\n * Create a fully typed mock implementing every `IKafkaClient<T>` method.\n * Useful for unit-testing services that depend on `KafkaClient` without\n * touching a real broker.\n *\n * Auto-detects Jest (`jest.fn()`) or Vitest (`vi.fn()`). Pass a custom\n * `mockFactory` for other frameworks.\n *\n * All methods resolve to sensible defaults:\n * - `checkStatus()` → `{ status: 'up', clientId: 'mock-client', topics: [] }`\n * - `getClientId()` → `\"mock-client\"`\n * - void methods → `undefined`\n *\n * @example\n * ```ts\n * const kafka = createMockKafkaClient<MyTopics>();\n *\n * const service = new OrdersService(kafka);\n * await service.createOrder();\n *\n * expect(kafka.sendMessage).toHaveBeenCalledWith(\n *   'order.created',\n *   expect.objectContaining({ orderId: '123' }),\n * );\n * ```\n */\nexport function createMockKafkaClient<T extends TopicMapConstraint<T>>(\n  mockFactory?: MockFactory,\n): MockKafkaClient<T> {\n  const fn = mockFactory ?? detectMockFactory();\n\n  const mock = () => fn() as any;\n  const resolved = (value: unknown) => mock().mockResolvedValue(value);\n  const returning = (value: unknown) => mock().mockReturnValue(value);\n\n  return {\n    checkStatus: resolved({\n      status: \"up\",\n      clientId: \"mock-client\",\n      topics: [],\n    }),\n    getConsumerLag: resolved([]),\n    getClientId: returning(\"mock-client\"),\n    sendMessage: resolved(undefined),\n    sendBatch: resolved(undefined),\n    transaction: mock().mockImplementation(\n      async (cb: (ctx: Record<string, unknown>) => Promise<void>) => {\n        const ctx = {\n          send: resolved(undefined),\n          sendBatch: resolved(undefined),\n        };\n        await cb(ctx);\n      },\n    ),\n    startConsumer: resolved({\n      groupId: \"mock-group\",\n      stop: mock().mockResolvedValue(undefined),\n      ready: mock().mockResolvedValue(undefined),\n    }),\n    startBatchConsumer: resolved({\n      groupId: \"mock-group\",\n      stop: mock().mockResolvedValue(undefined),\n      ready: mock().mockResolvedValue(undefined),\n    }),\n    stopConsumer: resolved(undefined),\n    consume: returning(\n      (function* () {})() as unknown as AsyncIterableIterator<any>,\n    ),\n    replayDlq: resolved({ replayed: 0, skipped: 0 }),\n    resetOffsets: resolved(undefined),\n    seekToOffset: resolved(undefined),\n    seekToTimestamp: resolved(undefined),\n    getCircuitState: returning(undefined),\n    pauseConsumer: mock(),\n    resumeConsumer: mock(),\n    getMetrics: returning({\n      processedCount: 0,\n      retryCount: 0,\n      dlqCount: 0,\n      dedupCount: 0,\n    }),\n    resetMetrics: mock(),\n    disconnect: resolved(undefined),\n    enableGracefulShutdown: mock(),\n  } as unknown as MockKafkaClient<T>;\n}\n","import {\n  KafkaContainer,\n  type StartedKafkaContainer,\n} from \"@testcontainers/kafka\";\nimport { KafkaJS } from \"@confluentinc/kafka-javascript\";\nconst { Kafka, logLevel: KafkaLogLevel } = KafkaJS;\n\n/** Options for `KafkaTestContainer`. */\nexport interface KafkaTestContainerOptions {\n  /** Docker image. Default: `\"confluentinc/cp-kafka:7.7.0\"`. */\n  image?: string;\n  /** Warm up the transactional coordinator on start. Default: `true`. */\n  transactionWarmup?: boolean;\n  /** Topics to pre-create. Each entry can be a string (1 partition) or `{ topic, numPartitions }`. */\n  topics?: Array<string | { topic: string; numPartitions?: number }>;\n}\n\n/**\n * Thin wrapper around `@testcontainers/kafka` that starts a single-node\n * KRaft Kafka container and exposes `brokers` for use with `KafkaClient`.\n *\n * Handles common setup pain points:\n * - Transaction coordinator warmup (avoids transactional producer hangs)\n * - Topic pre-creation (avoids race conditions)\n *\n * @example\n * ```ts\n * const container = new KafkaTestContainer({ topics: ['orders', 'payments'] });\n * const brokers = await container.start();\n *\n * const kafka = new KafkaClient('test', 'test-group', brokers);\n * // ... run tests ...\n *\n * await container.stop();\n * ```\n *\n * @example Jest lifecycle\n * ```ts\n * let container: KafkaTestContainer;\n * let brokers: string[];\n *\n * beforeAll(async () => {\n *   container = new KafkaTestContainer({ topics: ['orders'] });\n *   brokers = await container.start();\n * }, 120_000);\n *\n * afterAll(() => container.stop());\n * ```\n */\nexport class KafkaTestContainer {\n  private container: StartedKafkaContainer | undefined;\n  private readonly image: string;\n  private readonly transactionWarmup: boolean;\n  private readonly topics: Array<\n    string | { topic: string; numPartitions?: number }\n  >;\n\n  constructor(options?: KafkaTestContainerOptions) {\n    this.image = options?.image ?? \"confluentinc/cp-kafka:7.7.0\";\n    this.transactionWarmup = options?.transactionWarmup ?? true;\n    this.topics = options?.topics ?? [];\n  }\n\n  /**\n   * Start the Kafka container, pre-create topics, and optionally warm up\n   * the transaction coordinator.\n   *\n   * @returns Broker connection strings, e.g. `[\"localhost:55123\"]`.\n   */\n  async start(): Promise<string[]> {\n    this.container = await new KafkaContainer(this.image)\n      .withKraft()\n      .withExposedPorts(9093)\n      .withEnvironment({\n        KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR: \"1\",\n        KAFKA_TRANSACTION_STATE_LOG_MIN_ISR: \"1\",\n      })\n      .start();\n\n    const host = this.container.getHost();\n    const port = this.container.getMappedPort(9093);\n    const brokers = [`${host}:${port}`];\n\n    const kafka = new Kafka({\n      kafkaJS: {\n        clientId: \"test-container-setup\",\n        brokers,\n        logLevel: KafkaLogLevel.NOTHING,\n      },\n    });\n\n    if (this.topics.length > 0) {\n      const admin = kafka.admin();\n      await admin.connect();\n      await admin.createTopics({\n        topics: this.topics.map((t) =>\n          typeof t === \"string\"\n            ? { topic: t, numPartitions: 1 }\n            : { topic: t.topic, numPartitions: t.numPartitions ?? 1 },\n        ),\n      });\n      await admin.disconnect();\n    }\n\n    if (this.transactionWarmup) {\n      const warmupKafka = new Kafka({\n        kafkaJS: {\n          clientId: \"test-container-warmup\",\n          brokers,\n          logLevel: KafkaLogLevel.NOTHING,\n        },\n      });\n      const txProducer = warmupKafka.producer({\n        kafkaJS: {\n          transactionalId: \"test-container-warmup-tx\",\n          idempotent: true,\n          maxInFlightRequests: 1,\n        },\n      });\n      await txProducer.connect();\n      const tx = await txProducer.transaction();\n      await tx.abort();\n      await txProducer.disconnect();\n    }\n\n    return brokers;\n  }\n\n  /** Stop and remove the container. */\n  async stop(): Promise<void> {\n    await this.container?.stop();\n    this.container = undefined;\n  }\n\n  /** Broker connection strings. Throws if container is not started. */\n  get brokers(): string[] {\n    if (!this.container) {\n      throw new Error(\"KafkaTestContainer is not started. Call start() first.\");\n    }\n    const host = this.container.getHost();\n    const port = this.container.getMappedPort(9093);\n    return [`${host}:${port}`];\n  }\n}\n","import type {\n  KafkaTransport,\n  IProducer,\n  IConsumer,\n  IAdmin,\n  ITransaction,\n  IProducerRecord,\n  IProducerCreationOptions,\n  IConsumerCreationOptions,\n  IConsumerRunConfig,\n  ITopicPartition,\n  ITopicPartitions,\n  ITopicPartitionOffset,\n  IPartitionWatermarks,\n  IPartitionOffset,\n  IGroupTopicOffsets,\n  IGroupDescription,\n  ITopicMetadata,\n  IMessage,\n} from \"../client/transport\";\n\n// ── FakeTransaction ───────────────────────────────────────────────────────────\n\n/**\n * An in-memory Kafka transaction.\n * Staged sends are visible in `staged`; committed sends are flushed\n * to the owning `FakeProducer.sent` on `commit()`.\n */\nexport class FakeTransaction implements ITransaction {\n  /** Records staged within this transaction (not yet committed). */\n  readonly staged: IProducerRecord[] = [];\n  /** True after `commit()` was called. */\n  committed = false;\n  /** True after `abort()` was called. */\n  aborted = false;\n  /** sendOffsets calls (for EOS assertions). */\n  readonly offsetsCommitted: Array<{\n    consumer: IConsumer;\n    topics: Array<{ topic: string; partitions: IPartitionOffset[] }>;\n  }> = [];\n\n  constructor(private readonly producer: FakeProducer) {}\n\n  async send(record: IProducerRecord): Promise<void> {\n    this.staged.push(record);\n  }\n\n  async sendOffsets(options: {\n    consumer: IConsumer;\n    topics: Array<{ topic: string; partitions: Array<{ partition: number; offset: string }> }>;\n  }): Promise<void> {\n    this.offsetsCommitted.push(options);\n  }\n\n  async commit(): Promise<void> {\n    if (this.aborted) throw new Error(\"FakeTransaction: already aborted\");\n    this.committed = true;\n    for (const record of this.staged) {\n      this.producer.sent.push(record);\n    }\n  }\n\n  async abort(): Promise<void> {\n    if (this.committed) throw new Error(\"FakeTransaction: already committed\");\n    this.aborted = true;\n    this.staged.length = 0;\n  }\n}\n\n// ── FakeProducer ──────────────────────────────────────────────────────────────\n\n/**\n * In-memory producer. All `send()` calls are captured in `sent`.\n * Transactions are backed by `FakeTransaction`.\n */\nexport class FakeProducer implements IProducer {\n  /** All records delivered via `send()` (direct + committed transactions). */\n  readonly sent: IProducerRecord[] = [];\n  /** All transactions opened via `transaction()`. */\n  readonly transactions: FakeTransaction[] = [];\n\n  readonly options: IProducerCreationOptions | undefined;\n  connected = false;\n\n  constructor(options?: IProducerCreationOptions) {\n    this.options = options;\n  }\n\n  async connect(): Promise<void> {\n    this.connected = true;\n  }\n\n  async disconnect(): Promise<void> {\n    this.connected = false;\n  }\n\n  async send(record: IProducerRecord): Promise<void> {\n    this.sent.push(record);\n  }\n\n  async transaction(): Promise<ITransaction> {\n    const tx = new FakeTransaction(this);\n    this.transactions.push(tx);\n    return tx;\n  }\n\n  /** Return the last committed transaction, or throw if none exist. */\n  get lastTransaction(): FakeTransaction {\n    const tx = this.transactions.at(-1);\n    if (!tx) throw new Error(\"FakeProducer: no transactions opened yet\");\n    return tx;\n  }\n\n  /** All topic names that received at least one message. */\n  sentTopics(): string[] {\n    return [...new Set(this.sent.map((r) => r.topic))];\n  }\n\n  /** All messages sent to a specific topic. */\n  sentTo(topic: string): IProducerRecord[\"messages\"] {\n    return this.sent.filter((r) => r.topic === topic).flatMap((r) => r.messages);\n  }\n}\n\n// ── FakeConsumer ──────────────────────────────────────────────────────────────\n\n/**\n * In-memory consumer.\n * Call `deliver(topic, message)` from your test to push messages through\n * the `eachMessage` handler without a real broker.\n */\nexport class FakeConsumer implements IConsumer {\n  readonly groupId: string;\n  readonly fromBeginning: boolean;\n\n  /** Topics subscribed via `subscribe()`. */\n  readonly subscribed: string[] = [];\n\n  private _runConfig: IConsumerRunConfig | undefined;\n  private _assignments: ITopicPartition[] = [];\n  readonly pausedTopics = new Set<string>();\n  connected = false;\n\n  private readonly onRebalance: IConsumerCreationOptions[\"onRebalance\"];\n\n  constructor(options: IConsumerCreationOptions) {\n    this.groupId = options.groupId;\n    this.fromBeginning = options.fromBeginning ?? false;\n    this.onRebalance = options.onRebalance;\n  }\n\n  async connect(): Promise<void> {\n    this.connected = true;\n  }\n\n  async disconnect(): Promise<void> {\n    this.connected = false;\n  }\n\n  async subscribe(options: { topics: (string | RegExp)[] }): Promise<void> {\n    for (const t of options.topics) {\n      if (typeof t === \"string\") this.subscribed.push(t);\n    }\n    // Auto-assign one partition per subscribed topic and immediately fire the\n    // rebalance callback so that handle.ready() resolves without a real broker.\n    this._assignments = this.subscribed.map((topic) => ({ topic, partition: 0 }));\n    this.onRebalance?.(\"assign\", this._assignments);\n  }\n\n  async run(config: IConsumerRunConfig): Promise<void> {\n    this._runConfig = config;\n  }\n\n  pause(assignments: ITopicPartitions[]): void {\n    for (const { topic } of assignments) this.pausedTopics.add(topic);\n  }\n\n  resume(assignments: ITopicPartitions[]): void {\n    for (const { topic } of assignments) this.pausedTopics.delete(topic);\n  }\n\n  seek(_options: ITopicPartitionOffset): void {}\n\n  assignment(): ITopicPartition[] {\n    return this._assignments;\n  }\n\n  async commitOffsets(_offsets: ITopicPartitionOffset[]): Promise<void> {}\n\n  async stop(): Promise<void> {\n    this.connected = false;\n  }\n\n  // ── Test helpers ─────────────────────────────────────────────────────\n\n  /**\n   * Push a message through the `eachMessage` handler.\n   * Throws if `run()` has not been called yet.\n   */\n  async deliver(\n    topic: string,\n    message: Partial<IMessage> & { value: Buffer | null },\n    partition = 0,\n    offset = \"0\",\n  ): Promise<void> {\n    if (!this._runConfig?.eachMessage) {\n      throw new Error(\n        `FakeConsumer(${this.groupId}): run() with eachMessage not called yet`,\n      );\n    }\n    await this._runConfig.eachMessage({\n      topic,\n      partition,\n      message: {\n        value: message.value,\n        headers: message.headers ?? {},\n        offset,\n        key: message.key,\n      },\n    });\n  }\n\n  /**\n   * Simulate a partition-assign rebalance event.\n   * Useful for testing onRebalance callbacks.\n   */\n  triggerRebalance(\n    type: \"assign\" | \"revoke\",\n    assignments: ITopicPartition[],\n  ): void {\n    this.onRebalance?.(type, assignments);\n  }\n\n  /** Whether `run()` has been called (consumer is active). */\n  get isRunning(): boolean {\n    return this._runConfig !== undefined;\n  }\n}\n\n// ── FakeAdmin ─────────────────────────────────────────────────────────────────\n\n/**\n * In-memory admin client.\n * Pre-populate `topicOffsets`, `groupOffsets`, and `existingTopics`\n * to control what admin queries return.\n */\nexport class FakeAdmin implements IAdmin {\n  /** Topics returned by `listTopics()`. Add to this from your test. */\n  readonly existingTopics: string[] = [];\n\n  /** Per-topic partition watermarks returned by `fetchTopicOffsets()`. */\n  readonly topicOffsets = new Map<string, IPartitionWatermarks[]>();\n\n  /** Per-groupId committed offsets returned by `fetchOffsets()`. */\n  readonly groupOffsets = new Map<string, IGroupTopicOffsets[]>();\n\n  /** Calls captured by `setOffsets()` — inspect in tests. */\n  readonly setOffsetsCalls: Array<{\n    groupId: string;\n    topic: string;\n    partitions: IPartitionOffset[];\n  }> = [];\n\n  /** Group IDs deleted via `deleteGroups()`. */\n  readonly deletedGroups: string[] = [];\n\n  /** Records deleted via `deleteTopicRecords()`. */\n  readonly deletedRecords: Array<{\n    topic: string;\n    partitions: IPartitionOffset[];\n  }> = [];\n\n  connected = false;\n\n  async connect(): Promise<void> {\n    this.connected = true;\n  }\n\n  async disconnect(): Promise<void> {\n    this.connected = false;\n  }\n\n  async createTopics(options: {\n    topics: Array<{ topic: string; numPartitions: number }>;\n  }): Promise<void> {\n    for (const { topic } of options.topics) {\n      if (!this.existingTopics.includes(topic)) this.existingTopics.push(topic);\n    }\n  }\n\n  async fetchTopicOffsets(topic: string): Promise<IPartitionWatermarks[]> {\n    return this.topicOffsets.get(topic) ?? [{ partition: 0, low: \"0\", high: \"0\" }];\n  }\n\n  async fetchTopicOffsetsByTimestamp(\n    _topic: string,\n    _timestamp: number,\n  ): Promise<IPartitionOffset[]> {\n    return [];\n  }\n\n  async fetchOffsets(options: {\n    groupId: string;\n  }): Promise<IGroupTopicOffsets[]> {\n    return this.groupOffsets.get(options.groupId) ?? [];\n  }\n\n  async setOffsets(options: {\n    groupId: string;\n    topic: string;\n    partitions: IPartitionOffset[];\n  }): Promise<void> {\n    this.setOffsetsCalls.push(options);\n  }\n\n  async listTopics(): Promise<string[]> {\n    return this.existingTopics;\n  }\n\n  async listGroups(): Promise<{ groups: IGroupDescription[] }> {\n    return { groups: [] };\n  }\n\n  async fetchTopicMetadata(_options?: {\n    topics?: string[];\n  }): Promise<{ topics: ITopicMetadata[] }> {\n    return { topics: [] };\n  }\n\n  async deleteGroups(groupIds: string[]): Promise<void> {\n    this.deletedGroups.push(...groupIds);\n  }\n\n  async deleteTopicRecords(options: {\n    topic: string;\n    partitions: IPartitionOffset[];\n  }): Promise<void> {\n    this.deletedRecords.push(options);\n  }\n}\n\n// ── FakeTransport ─────────────────────────────────────────────────────────────\n\n/**\n * In-memory `KafkaTransport` for unit testing.\n *\n * Inject into `KafkaClient` via `KafkaClientOptions.transport` to test\n * producer/consumer logic without `jest.mock('@confluentinc/kafka-javascript')`.\n *\n * @example\n * ```ts\n * const transport = new FakeTransport();\n * const client = new KafkaClient('svc', 'grp', [], { transport });\n *\n * await client.connectProducer();\n * await client.sendMessage('orders', { id: '1' });\n *\n * expect(transport.mainProducer.sentTo('orders')).toHaveLength(1);\n * ```\n */\nexport class FakeTransport implements KafkaTransport {\n  private readonly _producers: FakeProducer[] = [];\n  private readonly _consumers: FakeConsumer[] = [];\n  private readonly _admin = new FakeAdmin();\n\n  producer(options?: IProducerCreationOptions): IProducer {\n    const p = new FakeProducer(options);\n    this._producers.push(p);\n    return p;\n  }\n\n  consumer(options: IConsumerCreationOptions): IConsumer {\n    const c = new FakeConsumer(options);\n    this._consumers.push(c);\n    return c;\n  }\n\n  admin(): IAdmin {\n    return this._admin;\n  }\n\n  // ── Convenience accessors ─────────────────────────────────────────\n\n  /** The admin client shared across all admin() calls. */\n  get fakeAdmin(): FakeAdmin {\n    return this._admin;\n  }\n\n  /**\n   * The first (default) producer — the non-transactional producer\n   * created during `KafkaClient` construction.\n   */\n  get mainProducer(): FakeProducer {\n    const p = this._producers[0];\n    if (!p) throw new Error(\"FakeTransport: no producers created yet\");\n    return p;\n  }\n\n  /** All producers created so far (main + transactional). */\n  get producers(): readonly FakeProducer[] {\n    return this._producers;\n  }\n\n  /** All consumers created so far. */\n  get consumers(): readonly FakeConsumer[] {\n    return this._consumers;\n  }\n\n  /**\n   * Find the consumer for a given group ID.\n   * Throws if no consumer with that group exists.\n   */\n  consumerFor(groupId: string): FakeConsumer {\n    const c = this._consumers.find(\n      (c) => c.groupId === groupId || c.groupId.startsWith(groupId),\n    );\n    if (!c)\n      throw new Error(\n        `FakeTransport: no consumer for group \"${groupId}\". ` +\n          `Available: ${this._consumers.map((c) => c.groupId).join(\", \") || \"(none)\"}`,\n      );\n    return c;\n  }\n\n  /**\n   * Deliver a JSON-serialized message to the first consumer subscribed to `topic`.\n   * Simulates a broker dispatching a message to the consumer handler.\n   */\n  async deliver<T>(\n    topic: string,\n    payload: T,\n    options: {\n      key?: string;\n      headers?: Record<string, string>;\n      partition?: number;\n      offset?: string;\n    } = {},\n  ): Promise<void> {\n    const consumer = this._consumers.find((c) => c.subscribed.includes(topic));\n    if (!consumer) {\n      throw new Error(\n        `FakeTransport: no consumer subscribed to \"${topic}\". ` +\n          `Subscribed topics: ${this._consumers.flatMap((c) => c.subscribed).join(\", \") || \"(none)\"}`,\n      );\n    }\n    await consumer.deliver(\n      topic,\n      {\n        value: Buffer.from(JSON.stringify(payload)),\n        headers: options.headers\n          ? Object.fromEntries(\n              Object.entries(options.headers).map(([k, v]) => [k, [v]]),\n            )\n          : {},\n        key: options.key !== undefined ? Buffer.from(options.key) : undefined,\n      },\n      options.partition ?? 0,\n      options.offset ?? \"0\",\n    );\n  }\n}\n"],"mappings":"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","names":["c"]}