@drarzter/kafka-client 0.9.3 → 0.10.0

package/dist/otel.js.map

@@ -1 +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 { BeforeConsumeResult, KafkaInstrumentation } from \"./client/types\";\nimport type { EventEnvelope } from \"./client/message/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  const activeSpans = new Map<string, ReturnType<typeof tracer.startSpan>>();\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>): BeforeConsumeResult {\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      const spanCtx = trace.setSpan(parentCtx, span);\n      activeSpans.set(envelope.eventId, span);\n      return {\n        cleanup() {\n          span.end();\n          activeSpans.delete(envelope.eventId);\n        },\n        wrap(fn) {\n          return context.with(spanCtx, fn);\n        },\n      };\n    },\n\n    onConsumeError(envelope: EventEnvelope<any>, error: Error) {\n      const span = activeSpans.get(envelope.eventId);\n      if (span) {\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });\n        span.recordException(error);\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAMO;AA0BA,SAAS,sBAA4C;AAC1D,QAAM,SAAS,iBAAM,UAAU,wBAAwB;AACvD,QAAM,cAAc,oBAAI,IAAiD;AAEzE,SAAO;AAAA,IACL,WAAW,QAAgB,SAAiC;AAC1D,6BAAY,OAAO,mBAAQ,OAAO,GAAG,OAAO;AAAA,IAC9C;AAAA,IAEA,UAAU,QAAgB;AAAA,IAI1B;AAAA,IAEA,cAAc,UAAmD;AAC/D,YAAM,YAAY,uBAAY,QAAQ,mBAAQ,OAAO,GAAG,SAAS,OAAO;AACxE,YAAM,OAAO,OAAO;AAAA,QAClB,iBAAiB,SAAS,KAAK;AAAA,QAC/B;AAAA,UACE,MAAM,oBAAS;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,YAAM,UAAU,iBAAM,QAAQ,WAAW,IAAI;AAC7C,kBAAY,IAAI,SAAS,SAAS,IAAI;AACtC,aAAO;AAAA,QACL,UAAU;AACR,eAAK,IAAI;AACT,sBAAY,OAAO,SAAS,OAAO;AAAA,QACrC;AAAA,QACA,KAAK,IAAI;AACP,iBAAO,mBAAQ,KAAK,SAAS,EAAE;AAAA,QACjC;AAAA,MACF;AAAA,IACF;AAAA,IAEA,eAAe,UAA8B,OAAc;AACzD,YAAM,OAAO,YAAY,IAAI,SAAS,OAAO;AAC7C,UAAI,MAAM;AACR,aAAK,UAAU,EAAE,MAAM,0BAAe,OAAO,SAAS,MAAM,QAAQ,CAAC;AACrE,aAAK,gBAAgB,KAAK;AAAA,MAC5B;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../src/otel.ts"],"sourcesContent":["import {\n  trace,\n  context,\n  propagation,\n  metrics,\n  SpanKind,\n  SpanStatusCode,\n} from \"@opentelemetry/api\";\nimport type { Meter, ObservableResult } from \"@opentelemetry/api\";\nimport type { BeforeConsumeResult, KafkaInstrumentation } from \"./client/types\";\nimport type { IKafkaAdmin } from \"./client/types/admin.interface\";\nimport type { TopicMapConstraint } from \"./client/types/common\";\nimport type { EventEnvelope } from \"./client/message/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  // Keyed by envelope object identity (not eventId) so two in-flight messages\n  // that share an eventId cannot overwrite each other's span. WeakMap also\n  // guarantees no leak if a cleanup path is ever missed.\n  const activeSpans = new WeakMap<\n    EventEnvelope<any>,\n    ReturnType<typeof tracer.startSpan>\n  >();\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>): BeforeConsumeResult {\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      const spanCtx = trace.setSpan(parentCtx, span);\n      activeSpans.set(envelope, span);\n      return {\n        cleanup() {\n          span.end();\n          activeSpans.delete(envelope);\n        },\n        wrap(fn) {\n          return context.with(spanCtx, fn);\n        },\n      };\n    },\n\n    onConsumeError(envelope: EventEnvelope<any>, error: Error) {\n      const span = activeSpans.get(envelope);\n      if (span) {\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });\n        span.recordException(error);\n      }\n    },\n  };\n}\n\n/**\n * Create a `KafkaInstrumentation` that records OpenTelemetry **metrics** for\n * both the send and consume paths.\n *\n * Requires `@opentelemetry/api` as a peer dependency. Instruments are created\n * once per instrumentation instance (not per message), so a single call to this\n * factory registers all counters/histograms exactly once.\n *\n * Recorded instruments (all under meter `@drarzter/kafka-client`):\n *\n * | Instrument | Type | Attributes | Recorded in |\n * |---|---|---|---|\n * | `kafka.client.messages.sent` | Counter | `topic` | `afterSend` |\n * | `kafka.client.messages.processed` | Counter | `topic` | `onMessage` |\n * | `kafka.client.messages.retried` | Counter | `topic` | `onRetry` |\n * | `kafka.client.messages.dlq` | Counter | `topic`, `reason` | `onDlq` |\n * | `kafka.client.messages.duplicate` | Counter | `topic`, `strategy` | `onDuplicate` |\n * | `kafka.client.consume.errors` | Counter | `topic` | `onConsumeError` |\n * | `kafka.client.consume.duration` | Histogram (ms) | `topic` | `beforeConsume` → `cleanup()` |\n *\n * Composes with `otelInstrumentation()` (traces): list both in\n * `instrumentation`. They share nothing and can be added in any order.\n *\n * @param options.meter - Override the meter used to create instruments.\n *   Defaults to `metrics.getMeter(\"@drarzter/kafka-client\")`.\n *\n * @example\n * ```ts\n * import {\n *   otelInstrumentation,\n *   otelMetricsInstrumentation,\n * } from '@drarzter/kafka-client/otel';\n *\n * const kafka = new KafkaClient('my-app', 'my-group', brokers, {\n *   instrumentation: [otelInstrumentation(), otelMetricsInstrumentation()],\n * });\n * ```\n */\nexport function otelMetricsInstrumentation(options?: {\n  meter?: Meter;\n}): KafkaInstrumentation {\n  const meter = options?.meter ?? metrics.getMeter(\"@drarzter/kafka-client\");\n\n  const sentCounter = meter.createCounter(\"kafka.client.messages.sent\", {\n    description: \"Number of messages successfully sent to Kafka.\",\n  });\n  const processedCounter = meter.createCounter(\n    \"kafka.client.messages.processed\",\n    {\n      description: \"Number of messages successfully processed by a consumer.\",\n    },\n  );\n  const retriedCounter = meter.createCounter(\"kafka.client.messages.retried\", {\n    description: \"Number of messages queued for retry.\",\n  });\n  const dlqCounter = meter.createCounter(\"kafka.client.messages.dlq\", {\n    description: \"Number of messages routed to a DLQ topic.\",\n  });\n  const duplicateCounter = meter.createCounter(\n    \"kafka.client.messages.duplicate\",\n    {\n      description: \"Number of Lamport-clock duplicate messages detected.\",\n    },\n  );\n  const consumeErrorsCounter = meter.createCounter(\n    \"kafka.client.consume.errors\",\n    {\n      description: \"Number of consumer handler errors.\",\n    },\n  );\n  const consumeDuration = meter.createHistogram(\n    \"kafka.client.consume.duration\",\n    {\n      description: \"Consumer handler duration.\",\n      unit: \"ms\",\n    },\n  );\n\n  return {\n    afterSend(topic: string) {\n      sentCounter.add(1, { topic });\n    },\n\n    beforeConsume(envelope: EventEnvelope<any>): BeforeConsumeResult {\n      const topic = envelope.topic;\n      const start = Date.now();\n      return {\n        cleanup() {\n          consumeDuration.record(Date.now() - start, { topic });\n        },\n      };\n    },\n\n    onConsumeError(envelope: EventEnvelope<any>, _error: Error) {\n      consumeErrorsCounter.add(1, { topic: envelope.topic });\n    },\n\n    onRetry(envelope: EventEnvelope<any>, _attempt: number, _max: number) {\n      retriedCounter.add(1, { topic: envelope.topic });\n    },\n\n    onDlq(envelope: EventEnvelope<any>, reason: string) {\n      dlqCounter.add(1, { topic: envelope.topic, reason });\n    },\n\n    onDuplicate(\n      envelope: EventEnvelope<any>,\n      strategy: \"drop\" | \"dlq\" | \"topic\",\n    ) {\n      duplicateCounter.add(1, { topic: envelope.topic, strategy });\n    },\n\n    onMessage(envelope: EventEnvelope<any>) {\n      processedCounter.add(1, { topic: envelope.topic });\n    },\n  };\n}\n\n/**\n * Register an OpenTelemetry **ObservableGauge** `kafka.client.consumer.lag`\n * that reports per-partition consumer lag by polling `kafka.getConsumerLag()`\n * on each metric collection cycle.\n *\n * Requires `@opentelemetry/api` as a peer dependency. Accepts any object\n * implementing the `IKafkaAdmin` sub-interface (i.e. any `KafkaClient`).\n *\n * The async callback swallows errors silently — a broker query failure during\n * a collection cycle simply reports no lag samples for that cycle rather than\n * throwing inside the OTel metric reader.\n *\n * Gauge attributes: `topic`, `partition`, and `groupId` (empty string when the\n * client's default group is used).\n *\n * @param kafka - The client (or any `IKafkaAdmin`) to poll for lag.\n * @param options.meter - Override the meter. Defaults to\n *   `metrics.getMeter(\"@drarzter/kafka-client\")`.\n * @param options.groupId - Consumer group to query. Defaults to the client's\n *   constructor group.\n * @returns An unregister function that removes the observable callback. Call it\n *   on shutdown to stop observing.\n *\n * @example\n * ```ts\n * import { otelLagGauge } from '@drarzter/kafka-client/otel';\n *\n * const unregister = otelLagGauge(kafka, { groupId: 'billing-service' });\n * // ...later, on shutdown:\n * unregister();\n * ```\n */\nexport function otelLagGauge<T extends TopicMapConstraint<T>>(\n  kafka: IKafkaAdmin<T>,\n  options?: { meter?: Meter; groupId?: string },\n): () => void {\n  const meter = options?.meter ?? metrics.getMeter(\"@drarzter/kafka-client\");\n  const groupId = options?.groupId;\n\n  const gauge = meter.createObservableGauge(\"kafka.client.consumer.lag\", {\n    description: \"Consumer group lag per topic partition.\",\n  });\n\n  const callback = async (result: ObservableResult) => {\n    try {\n      const lag = await kafka.getConsumerLag(groupId);\n      for (const entry of lag) {\n        result.observe(entry.lag, {\n          topic: entry.topic,\n          partition: entry.partition,\n          groupId: groupId ?? \"\",\n        });\n      }\n    } catch {\n      // Swallow — a failed lag query should never break metric collection.\n    }\n  };\n\n  gauge.addCallback(callback);\n\n  return () => {\n    gauge.removeCallback(callback);\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/otel.mjs

@@ -5,12 +5,13 @@ import {
   trace,
   context,
   propagation,
+  metrics,
   SpanKind,
   SpanStatusCode
 } from "@opentelemetry/api";
 function otelInstrumentation() {
   const tracer = trace.getTracer("@drarzter/kafka-client");
-  const activeSpans = /* @__PURE__ */ new Map();
+  const activeSpans = /* @__PURE__ */ new WeakMap();
   return {
     beforeSend(_topic, headers) {
       propagation.inject(context.active(), headers);
@@ -34,11 +35,11 @@ function otelInstrumentation() {
         parentCtx
       );
       const spanCtx = trace.setSpan(parentCtx, span);
-      activeSpans.set(envelope.eventId, span);
+      activeSpans.set(envelope, span);
       return {
         cleanup() {
           span.end();
-          activeSpans.delete(envelope.eventId);
+          activeSpans.delete(envelope);
         },
         wrap(fn) {
           return context.with(spanCtx, fn);
@@ -46,7 +47,7 @@ function otelInstrumentation() {
       };
     },
     onConsumeError(envelope, error) {
-      const span = activeSpans.get(envelope.eventId);
+      const span = activeSpans.get(envelope);
       if (span) {
         span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
         span.recordException(error);
@@ -54,7 +55,99 @@ function otelInstrumentation() {
     }
   };
 }
+function otelMetricsInstrumentation(options) {
+  const meter = options?.meter ?? metrics.getMeter("@drarzter/kafka-client");
+  const sentCounter = meter.createCounter("kafka.client.messages.sent", {
+    description: "Number of messages successfully sent to Kafka."
+  });
+  const processedCounter = meter.createCounter(
+    "kafka.client.messages.processed",
+    {
+      description: "Number of messages successfully processed by a consumer."
+    }
+  );
+  const retriedCounter = meter.createCounter("kafka.client.messages.retried", {
+    description: "Number of messages queued for retry."
+  });
+  const dlqCounter = meter.createCounter("kafka.client.messages.dlq", {
+    description: "Number of messages routed to a DLQ topic."
+  });
+  const duplicateCounter = meter.createCounter(
+    "kafka.client.messages.duplicate",
+    {
+      description: "Number of Lamport-clock duplicate messages detected."
+    }
+  );
+  const consumeErrorsCounter = meter.createCounter(
+    "kafka.client.consume.errors",
+    {
+      description: "Number of consumer handler errors."
+    }
+  );
+  const consumeDuration = meter.createHistogram(
+    "kafka.client.consume.duration",
+    {
+      description: "Consumer handler duration.",
+      unit: "ms"
+    }
+  );
+  return {
+    afterSend(topic) {
+      sentCounter.add(1, { topic });
+    },
+    beforeConsume(envelope) {
+      const topic = envelope.topic;
+      const start = Date.now();
+      return {
+        cleanup() {
+          consumeDuration.record(Date.now() - start, { topic });
+        }
+      };
+    },
+    onConsumeError(envelope, _error) {
+      consumeErrorsCounter.add(1, { topic: envelope.topic });
+    },
+    onRetry(envelope, _attempt, _max) {
+      retriedCounter.add(1, { topic: envelope.topic });
+    },
+    onDlq(envelope, reason) {
+      dlqCounter.add(1, { topic: envelope.topic, reason });
+    },
+    onDuplicate(envelope, strategy) {
+      duplicateCounter.add(1, { topic: envelope.topic, strategy });
+    },
+    onMessage(envelope) {
+      processedCounter.add(1, { topic: envelope.topic });
+    }
+  };
+}
+function otelLagGauge(kafka, options) {
+  const meter = options?.meter ?? metrics.getMeter("@drarzter/kafka-client");
+  const groupId = options?.groupId;
+  const gauge = meter.createObservableGauge("kafka.client.consumer.lag", {
+    description: "Consumer group lag per topic partition."
+  });
+  const callback = async (result) => {
+    try {
+      const lag = await kafka.getConsumerLag(groupId);
+      for (const entry of lag) {
+        result.observe(entry.lag, {
+          topic: entry.topic,
+          partition: entry.partition,
+          groupId: groupId ?? ""
+        });
+      }
+    } catch {
+    }
+  };
+  gauge.addCallback(callback);
+  return () => {
+    gauge.removeCallback(callback);
+  };
+}
 export {
-  otelInstrumentation
+  otelInstrumentation,
+  otelLagGauge,
+  otelMetricsInstrumentation
 };
 //# sourceMappingURL=otel.mjs.map

package/dist/otel.mjs.map

@@ -1 +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 { BeforeConsumeResult, KafkaInstrumentation } from \"./client/types\";\nimport type { EventEnvelope } from \"./client/message/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  const activeSpans = new Map<string, ReturnType<typeof tracer.startSpan>>();\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>): BeforeConsumeResult {\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      const spanCtx = trace.setSpan(parentCtx, span);\n      activeSpans.set(envelope.eventId, span);\n      return {\n        cleanup() {\n          span.end();\n          activeSpans.delete(envelope.eventId);\n        },\n        wrap(fn) {\n          return context.with(spanCtx, fn);\n        },\n      };\n    },\n\n    onConsumeError(envelope: EventEnvelope<any>, error: Error) {\n      const span = activeSpans.get(envelope.eventId);\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;AACvD,QAAM,cAAc,oBAAI,IAAiD;AAEzE,SAAO;AAAA,IACL,WAAW,QAAgB,SAAiC;AAC1D,kBAAY,OAAO,QAAQ,OAAO,GAAG,OAAO;AAAA,IAC9C;AAAA,IAEA,UAAU,QAAgB;AAAA,IAI1B;AAAA,IAEA,cAAc,UAAmD;AAC/D,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,YAAM,UAAU,MAAM,QAAQ,WAAW,IAAI;AAC7C,kBAAY,IAAI,SAAS,SAAS,IAAI;AACtC,aAAO;AAAA,QACL,UAAU;AACR,eAAK,IAAI;AACT,sBAAY,OAAO,SAAS,OAAO;AAAA,QACrC;AAAA,QACA,KAAK,IAAI;AACP,iBAAO,QAAQ,KAAK,SAAS,EAAE;AAAA,QACjC;AAAA,MACF;AAAA,IACF;AAAA,IAEA,eAAe,UAA8B,OAAc;AACzD,YAAM,OAAO,YAAY,IAAI,SAAS,OAAO;AAC7C,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":[]}
+{"version":3,"sources":["../src/otel.ts"],"sourcesContent":["import {\n  trace,\n  context,\n  propagation,\n  metrics,\n  SpanKind,\n  SpanStatusCode,\n} from \"@opentelemetry/api\";\nimport type { Meter, ObservableResult } from \"@opentelemetry/api\";\nimport type { BeforeConsumeResult, KafkaInstrumentation } from \"./client/types\";\nimport type { IKafkaAdmin } from \"./client/types/admin.interface\";\nimport type { TopicMapConstraint } from \"./client/types/common\";\nimport type { EventEnvelope } from \"./client/message/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  // Keyed by envelope object identity (not eventId) so two in-flight messages\n  // that share an eventId cannot overwrite each other's span. WeakMap also\n  // guarantees no leak if a cleanup path is ever missed.\n  const activeSpans = new WeakMap<\n    EventEnvelope<any>,\n    ReturnType<typeof tracer.startSpan>\n  >();\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>): BeforeConsumeResult {\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      const spanCtx = trace.setSpan(parentCtx, span);\n      activeSpans.set(envelope, span);\n      return {\n        cleanup() {\n          span.end();\n          activeSpans.delete(envelope);\n        },\n        wrap(fn) {\n          return context.with(spanCtx, fn);\n        },\n      };\n    },\n\n    onConsumeError(envelope: EventEnvelope<any>, error: Error) {\n      const span = activeSpans.get(envelope);\n      if (span) {\n        span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });\n        span.recordException(error);\n      }\n    },\n  };\n}\n\n/**\n * Create a `KafkaInstrumentation` that records OpenTelemetry **metrics** for\n * both the send and consume paths.\n *\n * Requires `@opentelemetry/api` as a peer dependency. Instruments are created\n * once per instrumentation instance (not per message), so a single call to this\n * factory registers all counters/histograms exactly once.\n *\n * Recorded instruments (all under meter `@drarzter/kafka-client`):\n *\n * | Instrument | Type | Attributes | Recorded in |\n * |---|---|---|---|\n * | `kafka.client.messages.sent` | Counter | `topic` | `afterSend` |\n * | `kafka.client.messages.processed` | Counter | `topic` | `onMessage` |\n * | `kafka.client.messages.retried` | Counter | `topic` | `onRetry` |\n * | `kafka.client.messages.dlq` | Counter | `topic`, `reason` | `onDlq` |\n * | `kafka.client.messages.duplicate` | Counter | `topic`, `strategy` | `onDuplicate` |\n * | `kafka.client.consume.errors` | Counter | `topic` | `onConsumeError` |\n * | `kafka.client.consume.duration` | Histogram (ms) | `topic` | `beforeConsume` → `cleanup()` |\n *\n * Composes with `otelInstrumentation()` (traces): list both in\n * `instrumentation`. They share nothing and can be added in any order.\n *\n * @param options.meter - Override the meter used to create instruments.\n *   Defaults to `metrics.getMeter(\"@drarzter/kafka-client\")`.\n *\n * @example\n * ```ts\n * import {\n *   otelInstrumentation,\n *   otelMetricsInstrumentation,\n * } from '@drarzter/kafka-client/otel';\n *\n * const kafka = new KafkaClient('my-app', 'my-group', brokers, {\n *   instrumentation: [otelInstrumentation(), otelMetricsInstrumentation()],\n * });\n * ```\n */\nexport function otelMetricsInstrumentation(options?: {\n  meter?: Meter;\n}): KafkaInstrumentation {\n  const meter = options?.meter ?? metrics.getMeter(\"@drarzter/kafka-client\");\n\n  const sentCounter = meter.createCounter(\"kafka.client.messages.sent\", {\n    description: \"Number of messages successfully sent to Kafka.\",\n  });\n  const processedCounter = meter.createCounter(\n    \"kafka.client.messages.processed\",\n    {\n      description: \"Number of messages successfully processed by a consumer.\",\n    },\n  );\n  const retriedCounter = meter.createCounter(\"kafka.client.messages.retried\", {\n    description: \"Number of messages queued for retry.\",\n  });\n  const dlqCounter = meter.createCounter(\"kafka.client.messages.dlq\", {\n    description: \"Number of messages routed to a DLQ topic.\",\n  });\n  const duplicateCounter = meter.createCounter(\n    \"kafka.client.messages.duplicate\",\n    {\n      description: \"Number of Lamport-clock duplicate messages detected.\",\n    },\n  );\n  const consumeErrorsCounter = meter.createCounter(\n    \"kafka.client.consume.errors\",\n    {\n      description: \"Number of consumer handler errors.\",\n    },\n  );\n  const consumeDuration = meter.createHistogram(\n    \"kafka.client.consume.duration\",\n    {\n      description: \"Consumer handler duration.\",\n      unit: \"ms\",\n    },\n  );\n\n  return {\n    afterSend(topic: string) {\n      sentCounter.add(1, { topic });\n    },\n\n    beforeConsume(envelope: EventEnvelope<any>): BeforeConsumeResult {\n      const topic = envelope.topic;\n      const start = Date.now();\n      return {\n        cleanup() {\n          consumeDuration.record(Date.now() - start, { topic });\n        },\n      };\n    },\n\n    onConsumeError(envelope: EventEnvelope<any>, _error: Error) {\n      consumeErrorsCounter.add(1, { topic: envelope.topic });\n    },\n\n    onRetry(envelope: EventEnvelope<any>, _attempt: number, _max: number) {\n      retriedCounter.add(1, { topic: envelope.topic });\n    },\n\n    onDlq(envelope: EventEnvelope<any>, reason: string) {\n      dlqCounter.add(1, { topic: envelope.topic, reason });\n    },\n\n    onDuplicate(\n      envelope: EventEnvelope<any>,\n      strategy: \"drop\" | \"dlq\" | \"topic\",\n    ) {\n      duplicateCounter.add(1, { topic: envelope.topic, strategy });\n    },\n\n    onMessage(envelope: EventEnvelope<any>) {\n      processedCounter.add(1, { topic: envelope.topic });\n    },\n  };\n}\n\n/**\n * Register an OpenTelemetry **ObservableGauge** `kafka.client.consumer.lag`\n * that reports per-partition consumer lag by polling `kafka.getConsumerLag()`\n * on each metric collection cycle.\n *\n * Requires `@opentelemetry/api` as a peer dependency. Accepts any object\n * implementing the `IKafkaAdmin` sub-interface (i.e. any `KafkaClient`).\n *\n * The async callback swallows errors silently — a broker query failure during\n * a collection cycle simply reports no lag samples for that cycle rather than\n * throwing inside the OTel metric reader.\n *\n * Gauge attributes: `topic`, `partition`, and `groupId` (empty string when the\n * client's default group is used).\n *\n * @param kafka - The client (or any `IKafkaAdmin`) to poll for lag.\n * @param options.meter - Override the meter. Defaults to\n *   `metrics.getMeter(\"@drarzter/kafka-client\")`.\n * @param options.groupId - Consumer group to query. Defaults to the client's\n *   constructor group.\n * @returns An unregister function that removes the observable callback. Call it\n *   on shutdown to stop observing.\n *\n * @example\n * ```ts\n * import { otelLagGauge } from '@drarzter/kafka-client/otel';\n *\n * const unregister = otelLagGauge(kafka, { groupId: 'billing-service' });\n * // ...later, on shutdown:\n * unregister();\n * ```\n */\nexport function otelLagGauge<T extends TopicMapConstraint<T>>(\n  kafka: IKafkaAdmin<T>,\n  options?: { meter?: Meter; groupId?: string },\n): () => void {\n  const meter = options?.meter ?? metrics.getMeter(\"@drarzter/kafka-client\");\n  const groupId = options?.groupId;\n\n  const gauge = meter.createObservableGauge(\"kafka.client.consumer.lag\", {\n    description: \"Consumer group lag per topic partition.\",\n  });\n\n  const callback = async (result: ObservableResult) => {\n    try {\n      const lag = await kafka.getConsumerLag(groupId);\n      for (const entry of lag) {\n        result.observe(entry.lag, {\n          topic: entry.topic,\n          partition: entry.partition,\n          groupId: groupId ?? \"\",\n        });\n      }\n    } catch {\n      // Swallow — a failed lag query should never break metric collection.\n    }\n  };\n\n  gauge.addCallback(callback);\n\n  return () => {\n    gauge.removeCallback(callback);\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/testing/client.mock.d.ts

@@ -0,0 +1,47 @@
+import type { IKafkaClient, TopicMapConstraint } from "../client/types";
+/**
+ * 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.
+ */
+export type MockKafkaClient<T extends TopicMapConstraint<T>> = {
+    [K in keyof IKafkaClient<T>]: IKafkaClient<T>[K] & Record<string, any>;
+} & {
+    /**
+     * Present on the concrete `KafkaClient` but not part of `IKafkaClient` —
+     * included so services typed against the class can still use the mock.
+     */
+    disconnectProducer: (() => Promise<void>) & Record<string, any>;
+    /** NestJS lifecycle hook on the concrete `KafkaClient`. */
+    onModuleDestroy: (() => Promise<void>) & Record<string, any>;
+};
+/** Factory that creates a no-op mock function (e.g. `() => jest.fn()`). */
+export 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' }),
+ * );
+ * ```
+ */
+export declare function createMockKafkaClient<T extends TopicMapConstraint<T>>(mockFactory?: MockFactory): MockKafkaClient<T>;
+//# sourceMappingURL=client.mock.d.ts.map

package/dist/testing/client.mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mock.d.ts","sourceRoot":"","sources":["../../src/testing/client.mock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,IAAI;KAC5D,CAAC,IAAI,MAAM,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CACvE,GAAG;IACF;;;OAGG;IACH,kBAAkB,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChE,2DAA2D;IAC3D,eAAe,EAAE,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9D,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AA2BxD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EACnE,WAAW,CAAC,EAAE,WAAW,GACxB,eAAe,CAAC,CAAC,CAAC,CAkFpB"}

package/dist/testing/index.d.ts

@@ -0,0 +1,4 @@
+export { createMockKafkaClient, type MockKafkaClient } from "./client.mock";
+export { KafkaTestContainer, type KafkaTestContainerOptions, } from "./test.container";
+export { FakeTransport, FakeProducer, FakeConsumer, FakeAdmin, FakeTransaction, } from "./transport.fake";
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,eAAe,GAChB,MAAM,kBAAkB,CAAC"}

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-D-SxYV2b.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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"}