@drarzter/kafka-client 0.3.0 → 0.5.0

package/dist/otel.mjs

@@ -0,0 +1,49 @@
+import "./chunk-EQQGB2QZ.mjs";
+
+// src/otel.ts
+import {
+  trace,
+  context,
+  propagation,
+  SpanKind,
+  SpanStatusCode
+} from "@opentelemetry/api";
+function otelInstrumentation() {
+  const tracer = trace.getTracer("@drarzter/kafka-client");
+  return {
+    beforeSend(topic, headers) {
+      propagation.inject(context.active(), headers);
+    },
+    afterSend(_topic) {
+    },
+    beforeConsume(envelope) {
+      const parentCtx = propagation.extract(context.active(), envelope.headers);
+      const span = tracer.startSpan(
+        `kafka.consume ${envelope.topic}`,
+        {
+          kind: SpanKind.CONSUMER,
+          attributes: {
+            "messaging.system": "kafka",
+            "messaging.destination.name": envelope.topic,
+            "messaging.message.id": envelope.eventId,
+            "messaging.kafka.partition": envelope.partition,
+            "messaging.kafka.offset": envelope.offset
+          }
+        },
+        parentCtx
+      );
+      return () => span.end();
+    },
+    onConsumeError(envelope, error) {
+      const span = trace.getActiveSpan();
+      if (span) {
+        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
+        span.recordException(error);
+      }
+    }
+  };
+}
+export {
+  otelInstrumentation
+};
+//# sourceMappingURL=otel.mjs.map

package/dist/otel.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/otel.ts"],"sourcesContent":["import {\n  trace,\n  context,\n  propagation,\n  SpanKind,\n  SpanStatusCode,\n} from \"@opentelemetry/api\";\nimport type { KafkaInstrumentation } from \"./client/types\";\nimport type { EventEnvelope } from \"./client/envelope\";\n\n/**\n * Create a `KafkaInstrumentation` that automatically propagates\n * W3C Trace Context via Kafka headers.\n *\n * Requires `@opentelemetry/api` as a peer dependency.\n *\n * **Send path:** injects `traceparent` into message headers from the\n * active OpenTelemetry context.\n *\n * **Consume path:** extracts `traceparent` from message headers,\n * starts a `CONSUMER` span as a child of the extracted context,\n * and ends it when the handler completes.\n *\n * @example\n * ```ts\n * import { otelInstrumentation } from '@drarzter/kafka-client/otel';\n *\n * const kafka = new KafkaClient('my-app', 'my-group', brokers, {\n *   instrumentation: [otelInstrumentation()],\n * });\n * ```\n */\nexport function otelInstrumentation(): KafkaInstrumentation {\n  const tracer = trace.getTracer(\"@drarzter/kafka-client\");\n\n  return {\n    beforeSend(topic: string, headers: Record<string, string>) {\n      propagation.inject(context.active(), headers);\n    },\n\n    afterSend(_topic: string) {\n      // Span management for producers is left to the caller's OTel setup.\n      // We only inject context — creating producer spans here would be\n      // inaccurate since buildSendPayload runs synchronously per-message.\n    },\n\n    beforeConsume(envelope: EventEnvelope<any>) {\n      const parentCtx = propagation.extract(context.active(), envelope.headers);\n      const span = tracer.startSpan(\n        `kafka.consume ${envelope.topic}`,\n        {\n          kind: SpanKind.CONSUMER,\n          attributes: {\n            \"messaging.system\": \"kafka\",\n            \"messaging.destination.name\": envelope.topic,\n            \"messaging.message.id\": envelope.eventId,\n            \"messaging.kafka.partition\": envelope.partition,\n            \"messaging.kafka.offset\": envelope.offset,\n          },\n        },\n        parentCtx,\n      );\n      return () => span.end();\n    },\n\n    onConsumeError(envelope: EventEnvelope<any>, error: Error) {\n      const span = trace.getActiveSpan();\n      if (span) {\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });\n        span.recordException(error);\n      }\n    },\n  };\n}\n"],"mappings":";;;AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AA0BA,SAAS,sBAA4C;AAC1D,QAAM,SAAS,MAAM,UAAU,wBAAwB;AAEvD,SAAO;AAAA,IACL,WAAW,OAAe,SAAiC;AACzD,kBAAY,OAAO,QAAQ,OAAO,GAAG,OAAO;AAAA,IAC9C;AAAA,IAEA,UAAU,QAAgB;AAAA,IAI1B;AAAA,IAEA,cAAc,UAA8B;AAC1C,YAAM,YAAY,YAAY,QAAQ,QAAQ,OAAO,GAAG,SAAS,OAAO;AACxE,YAAM,OAAO,OAAO;AAAA,QAClB,iBAAiB,SAAS,KAAK;AAAA,QAC/B;AAAA,UACE,MAAM,SAAS;AAAA,UACf,YAAY;AAAA,YACV,oBAAoB;AAAA,YACpB,8BAA8B,SAAS;AAAA,YACvC,wBAAwB,SAAS;AAAA,YACjC,6BAA6B,SAAS;AAAA,YACtC,0BAA0B,SAAS;AAAA,UACrC;AAAA,QACF;AAAA,QACA;AAAA,MACF;AACA,aAAO,MAAM,KAAK,IAAI;AAAA,IACxB;AAAA,IAEA,eAAe,UAA8B,OAAc;AACzD,YAAM,OAAO,MAAM,cAAc;AACjC,UAAI,MAAM;AACR,aAAK,UAAU,EAAE,MAAM,eAAe,OAAO,SAAS,MAAM,QAAQ,CAAC;AACrE,aAAK,gBAAgB,KAAK;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/testing.d.mts

@@ -0,0 +1,104 @@
+import { T as TopicMapConstraint, I as IKafkaClient } from './envelope-QK1trQu4.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()` → `{ 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[];
+}
+
+export { KafkaTestContainer, type KafkaTestContainerOptions, type MockKafkaClient, createMockKafkaClient };

package/dist/testing.d.ts

@@ -0,0 +1,104 @@
+import { T as TopicMapConstraint, I as IKafkaClient } from './envelope-QK1trQu4.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()` → `{ 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[];
+}
+
+export { KafkaTestContainer, type KafkaTestContainerOptions, type MockKafkaClient, createMockKafkaClient };

package/dist/testing.js

@@ -0,0 +1,157 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/testing.ts
+var testing_exports = {};
+__export(testing_exports, {
+  KafkaTestContainer: () => KafkaTestContainer,
+  createMockKafkaClient: () => createMockKafkaClient
+});
+module.exports = __toCommonJS(testing_exports);
+
+// src/testing/mock-client.ts
+function detectMockFactory() {
+  try {
+    const jestFn = eval("typeof jest !== 'undefined' && jest.fn");
+    if (typeof jestFn === "function") return () => eval("jest.fn")();
+  } catch {
+  }
+  try {
+    const viFn = eval("typeof vi !== 'undefined' && vi.fn");
+    if (typeof viFn === "function") return () => eval("vi.fn")();
+  } catch {
+  }
+  throw new Error(
+    "createMockKafkaClient: no mock framework detected (jest/vitest). Pass a custom mockFactory."
+  );
+}
+function createMockKafkaClient(mockFactory) {
+  const fn = mockFactory ?? detectMockFactory();
+  const mock = () => fn();
+  const resolved = (value) => mock().mockResolvedValue(value);
+  const returning = (value) => mock().mockReturnValue(value);
+  return {
+    checkStatus: resolved({ topics: [] }),
+    getClientId: returning("mock-client"),
+    sendMessage: resolved(void 0),
+    sendBatch: resolved(void 0),
+    transaction: mock().mockImplementation(async (cb) => {
+      const ctx = {
+        send: resolved(void 0),
+        sendBatch: resolved(void 0)
+      };
+      await cb(ctx);
+    }),
+    startConsumer: resolved(void 0),
+    startBatchConsumer: resolved(void 0),
+    stopConsumer: resolved(void 0),
+    disconnect: resolved(void 0)
+  };
+}
+
+// src/testing/test-container.ts
+var import_kafka = require("@testcontainers/kafka");
+var import_kafka_javascript = require("@confluentinc/kafka-javascript");
+var { Kafka, logLevel: KafkaLogLevel } = import_kafka_javascript.KafkaJS;
+var KafkaTestContainer = class {
+  container;
+  image;
+  transactionWarmup;
+  topics;
+  constructor(options) {
+    this.image = options?.image ?? "confluentinc/cp-kafka:7.7.0";
+    this.transactionWarmup = options?.transactionWarmup ?? true;
+    this.topics = options?.topics ?? [];
+  }
+  /**
+   * Start the Kafka container, pre-create topics, and optionally warm up
+   * the transaction coordinator.
+   *
+   * @returns Broker connection strings, e.g. `["localhost:55123"]`.
+   */
+  async start() {
+    this.container = await new import_kafka.KafkaContainer(this.image).withKraft().withExposedPorts(9093).withEnvironment({
+      KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR: "1",
+      KAFKA_TRANSACTION_STATE_LOG_MIN_ISR: "1"
+    }).start();
+    const host = this.container.getHost();
+    const port = this.container.getMappedPort(9093);
+    const brokers = [`${host}:${port}`];
+    const kafka = new Kafka({
+      kafkaJS: {
+        clientId: "test-container-setup",
+        brokers,
+        logLevel: KafkaLogLevel.NOTHING
+      }
+    });
+    if (this.topics.length > 0) {
+      const admin = kafka.admin();
+      await admin.connect();
+      await admin.createTopics({
+        topics: this.topics.map(
+          (t) => typeof t === "string" ? { topic: t, numPartitions: 1 } : { topic: t.topic, numPartitions: t.numPartitions ?? 1 }
+        )
+      });
+      await admin.disconnect();
+    }
+    if (this.transactionWarmup) {
+      const warmupKafka = new Kafka({
+        kafkaJS: {
+          clientId: "test-container-warmup",
+          brokers,
+          logLevel: KafkaLogLevel.NOTHING
+        }
+      });
+      const txProducer = warmupKafka.producer({
+        kafkaJS: {
+          transactionalId: "test-container-warmup-tx",
+          idempotent: true,
+          maxInFlightRequests: 1
+        }
+      });
+      await txProducer.connect();
+      const tx = await txProducer.transaction();
+      await tx.abort();
+      await txProducer.disconnect();
+    }
+    return brokers;
+  }
+  /** Stop and remove the container. */
+  async stop() {
+    await this.container?.stop();
+    this.container = void 0;
+  }
+  /** Broker connection strings. Throws if container is not started. */
+  get brokers() {
+    if (!this.container) {
+      throw new Error(
+        "KafkaTestContainer is not started. Call start() first."
+      );
+    }
+    const host = this.container.getHost();
+    const port = this.container.getMappedPort(9093);
+    return [`${host}:${port}`];
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  KafkaTestContainer,
+  createMockKafkaClient
+});
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +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   \n  // Jest and Vitest inject globals into the test environment scope,\n  // which may not be on `globalThis`. Use eval to check the actual scope.\n  try {\n    const jestFn = eval(\"typeof jest !== 'undefined' && jest.fn\");\n    if (typeof jestFn === \"function\") return () => (eval(\"jest.fn\") as () => (...args: any[]) => any)();\n  } catch { /* not available */ }\n  try {\n    const viFn = eval(\"typeof vi !== 'undefined' && vi.fn\");\n    if (typeof viFn === \"function\") return () => (eval(\"vi.fn\") as () => (...args: any[]) => any)();\n  } catch { /* not available */ }\n   \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()` → `{ 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({ topics: [] }),\n    getClientId: returning(\"mock-client\"),\n    sendMessage: resolved(undefined),\n    sendBatch: resolved(undefined),\n    transaction: mock().mockImplementation(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    startConsumer: resolved(undefined),\n    startBatchConsumer: resolved(undefined),\n    stopConsumer: resolved(undefined),\n    disconnect: resolved(undefined),\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(\n        \"KafkaTestContainer is not started. Call start() first.\",\n      );\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":[]}

package/dist/testing.mjs

@@ -0,0 +1,133 @@
+import "./chunk-EQQGB2QZ.mjs";
+
+// src/testing/mock-client.ts
+function detectMockFactory() {
+  try {
+    const jestFn = eval("typeof jest !== 'undefined' && jest.fn");
+    if (typeof jestFn === "function") return () => eval("jest.fn")();
+  } catch {
+  }
+  try {
+    const viFn = eval("typeof vi !== 'undefined' && vi.fn");
+    if (typeof viFn === "function") return () => eval("vi.fn")();
+  } catch {
+  }
+  throw new Error(
+    "createMockKafkaClient: no mock framework detected (jest/vitest). Pass a custom mockFactory."
+  );
+}
+function createMockKafkaClient(mockFactory) {
+  const fn = mockFactory ?? detectMockFactory();
+  const mock = () => fn();
+  const resolved = (value) => mock().mockResolvedValue(value);
+  const returning = (value) => mock().mockReturnValue(value);
+  return {
+    checkStatus: resolved({ topics: [] }),
+    getClientId: returning("mock-client"),
+    sendMessage: resolved(void 0),
+    sendBatch: resolved(void 0),
+    transaction: mock().mockImplementation(async (cb) => {
+      const ctx = {
+        send: resolved(void 0),
+        sendBatch: resolved(void 0)
+      };
+      await cb(ctx);
+    }),
+    startConsumer: resolved(void 0),
+    startBatchConsumer: resolved(void 0),
+    stopConsumer: resolved(void 0),
+    disconnect: resolved(void 0)
+  };
+}
+
+// src/testing/test-container.ts
+import {
+  KafkaContainer
+} from "@testcontainers/kafka";
+import { KafkaJS } from "@confluentinc/kafka-javascript";
+var { Kafka, logLevel: KafkaLogLevel } = KafkaJS;
+var KafkaTestContainer = class {
+  container;
+  image;
+  transactionWarmup;
+  topics;
+  constructor(options) {
+    this.image = options?.image ?? "confluentinc/cp-kafka:7.7.0";
+    this.transactionWarmup = options?.transactionWarmup ?? true;
+    this.topics = options?.topics ?? [];
+  }
+  /**
+   * Start the Kafka container, pre-create topics, and optionally warm up
+   * the transaction coordinator.
+   *
+   * @returns Broker connection strings, e.g. `["localhost:55123"]`.
+   */
+  async start() {
+    this.container = await new KafkaContainer(this.image).withKraft().withExposedPorts(9093).withEnvironment({
+      KAFKA_TRANSACTION_STATE_LOG_REPLICATION_FACTOR: "1",
+      KAFKA_TRANSACTION_STATE_LOG_MIN_ISR: "1"
+    }).start();
+    const host = this.container.getHost();
+    const port = this.container.getMappedPort(9093);
+    const brokers = [`${host}:${port}`];
+    const kafka = new Kafka({
+      kafkaJS: {
+        clientId: "test-container-setup",
+        brokers,
+        logLevel: KafkaLogLevel.NOTHING
+      }
+    });
+    if (this.topics.length > 0) {
+      const admin = kafka.admin();
+      await admin.connect();
+      await admin.createTopics({
+        topics: this.topics.map(
+          (t) => typeof t === "string" ? { topic: t, numPartitions: 1 } : { topic: t.topic, numPartitions: t.numPartitions ?? 1 }
+        )
+      });
+      await admin.disconnect();
+    }
+    if (this.transactionWarmup) {
+      const warmupKafka = new Kafka({
+        kafkaJS: {
+          clientId: "test-container-warmup",
+          brokers,
+          logLevel: KafkaLogLevel.NOTHING
+        }
+      });
+      const txProducer = warmupKafka.producer({
+        kafkaJS: {
+          transactionalId: "test-container-warmup-tx",
+          idempotent: true,
+          maxInFlightRequests: 1
+        }
+      });
+      await txProducer.connect();
+      const tx = await txProducer.transaction();
+      await tx.abort();
+      await txProducer.disconnect();
+    }
+    return brokers;
+  }
+  /** Stop and remove the container. */
+  async stop() {
+    await this.container?.stop();
+    this.container = void 0;
+  }
+  /** Broker connection strings. Throws if container is not started. */
+  get brokers() {
+    if (!this.container) {
+      throw new Error(
+        "KafkaTestContainer is not started. Call start() first."
+      );
+    }
+    const host = this.container.getHost();
+    const port = this.container.getMappedPort(9093);
+    return [`${host}:${port}`];
+  }
+};
+export {
+  KafkaTestContainer,
+  createMockKafkaClient
+};
+//# sourceMappingURL=testing.mjs.map

package/dist/testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/testing/mock-client.ts","../src/testing/test-container.ts"],"sourcesContent":["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   \n  // Jest and Vitest inject globals into the test environment scope,\n  // which may not be on `globalThis`. Use eval to check the actual scope.\n  try {\n    const jestFn = eval(\"typeof jest !== 'undefined' && jest.fn\");\n    if (typeof jestFn === \"function\") return () => (eval(\"jest.fn\") as () => (...args: any[]) => any)();\n  } catch { /* not available */ }\n  try {\n    const viFn = eval(\"typeof vi !== 'undefined' && vi.fn\");\n    if (typeof viFn === \"function\") return () => (eval(\"vi.fn\") as () => (...args: any[]) => any)();\n  } catch { /* not available */ }\n   \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()` → `{ 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({ topics: [] }),\n    getClientId: returning(\"mock-client\"),\n    sendMessage: resolved(undefined),\n    sendBatch: resolved(undefined),\n    transaction: mock().mockImplementation(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    startConsumer: resolved(undefined),\n    startBatchConsumer: resolved(undefined),\n    stopConsumer: resolved(undefined),\n    disconnect: resolved(undefined),\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(\n        \"KafkaTestContainer is not started. Call start() first.\",\n      );\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":[]}