@drarzter/kafka-client 0.5.6 → 0.5.7

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/nest/kafka.module.ts","../src/nest/kafka.constants.ts","../src/nest/kafka.explorer.ts","../src/nest/kafka.decorator.ts","../src/nest/kafka.health.ts"],"sourcesContent":["import { Module, DynamicModule, Provider, Logger } from \"@nestjs/common\";\nimport { DiscoveryModule } from \"@nestjs/core\";\nimport {\n  KafkaClient,\n  ClientId,\n  GroupId,\n  TopicMapConstraint,\n  KafkaInstrumentation,\n  KafkaClientOptions,\n} from \"../client/kafka.client\";\nimport { getKafkaClientToken } from \"./kafka.constants\";\nimport { KafkaExplorer } from \"./kafka.explorer\";\n\n/** Shared configuration fields for both `register()` and `registerAsync()`. */\ninterface KafkaModuleBaseOptions {\n  /** Optional name for multi-client setups. Must match `@InjectKafkaClient(name)`. */\n  name?: string;\n  /** If true, makes KAFKA_CLIENT available globally without importing KafkaModule in every feature module. */\n  isGlobal?: boolean;\n}\n\n/** Synchronous configuration for `KafkaModule.register()`. */\nexport interface KafkaModuleOptions extends KafkaModuleBaseOptions {\n  /** Unique Kafka client identifier. */\n  clientId: ClientId;\n  /** Consumer group identifier. */\n  groupId: GroupId;\n  /** List of Kafka broker addresses. */\n  brokers: string[];\n  /** Auto-create topics via admin on first use (send/consume). Useful for development. */\n  autoCreateTopics?: boolean;\n  /** When `true`, string topic keys are validated against any schema previously registered via a TopicDescriptor. Default: `true`. */\n  strictSchemas?: boolean;\n  /** Number of partitions for auto-created topics. Default: `1`. */\n  numPartitions?: number;\n  /** Client-wide instrumentation hooks (e.g. OTel). Applied to both send and consume paths. */\n  instrumentation?: KafkaInstrumentation[];\n  /** Called when a message is dropped without being sent to a DLQ. @see `KafkaClientOptions.onMessageLost` */\n  onMessageLost?: KafkaClientOptions[\"onMessageLost\"];\n  /** Called whenever a consumer group rebalance occurs. @see `KafkaClientOptions.onRebalance` */\n  onRebalance?: KafkaClientOptions[\"onRebalance\"];\n}\n\n/** Async configuration for `KafkaModule.registerAsync()` with dependency injection. */\nexport interface KafkaModuleAsyncOptions extends KafkaModuleBaseOptions {\n  imports?: any[];\n  useFactory: (\n    ...args: any[]\n  ) => KafkaModuleOptions | Promise<KafkaModuleOptions>;\n  inject?: any[];\n}\n\n/**\n * NestJS dynamic module for registering type-safe Kafka clients.\n * Use `register()` for static config or `registerAsync()` for DI-based config.\n */\n@Module({})\nexport class KafkaModule {\n  /** Register a Kafka client with static options. */\n  static register<T extends TopicMapConstraint<T>>(\n    options: KafkaModuleOptions,\n  ): DynamicModule {\n    const token = getKafkaClientToken(options.name);\n\n    const kafkaClientProvider: Provider = {\n      provide: token,\n      useFactory: () => KafkaModule.buildClient<T>(options),\n    };\n\n    return {\n      global: options.isGlobal ?? false,\n      module: KafkaModule,\n      imports: [DiscoveryModule],\n      providers: [\n        kafkaClientProvider,\n        KafkaModule.buildDestroyProvider(token),\n        KafkaExplorer,\n      ],\n      exports: [kafkaClientProvider],\n    };\n  }\n\n  /** Register a Kafka client with async/factory-based options. */\n  static registerAsync<T extends TopicMapConstraint<T>>(\n    asyncOptions: KafkaModuleAsyncOptions,\n  ): DynamicModule {\n    const token = getKafkaClientToken(asyncOptions.name);\n\n    const kafkaClientProvider: Provider = {\n      provide: token,\n      useFactory: async (...args: any[]): Promise<KafkaClient<T>> =>\n        KafkaModule.buildClient<T>(await asyncOptions.useFactory(...args)),\n      inject: asyncOptions.inject || [],\n    };\n\n    return {\n      global: asyncOptions.isGlobal ?? false,\n      module: KafkaModule,\n      imports: [...(asyncOptions.imports || []), DiscoveryModule],\n      providers: [\n        kafkaClientProvider,\n        KafkaModule.buildDestroyProvider(token),\n        KafkaExplorer,\n      ],\n      exports: [kafkaClientProvider],\n    };\n  }\n\n  private static async buildClient<T extends TopicMapConstraint<T>>(\n    options: KafkaModuleOptions,\n  ): Promise<KafkaClient<T>> {\n    const client = new KafkaClient<T>(\n      options.clientId,\n      options.groupId,\n      options.brokers,\n      {\n        autoCreateTopics: options.autoCreateTopics,\n        strictSchemas: options.strictSchemas,\n        numPartitions: options.numPartitions,\n        instrumentation: options.instrumentation,\n        onMessageLost: options.onMessageLost,\n        onRebalance: options.onRebalance,\n        logger: new Logger(`KafkaClient:${options.clientId}`),\n      },\n    );\n    await client.connectProducer();\n    return client;\n  }\n\n  private static buildDestroyProvider<T extends TopicMapConstraint<T>>(\n    token: string,\n  ): Provider {\n    return {\n      provide: `${token}_DESTROY`,\n      useFactory: (client: KafkaClient<T>) => ({\n        onModuleDestroy: () => client.disconnect(),\n      }),\n      inject: [token],\n    };\n  }\n}\n","/** Default DI token for the Kafka client. */\nexport const KAFKA_CLIENT = \"KAFKA_CLIENT\";\n\n/** Returns the DI token for a named (or default) Kafka client instance. */\nexport const getKafkaClientToken = (name?: string): string =>\n  name ? `KAFKA_CLIENT_${name}` : KAFKA_CLIENT;\n","import { Inject, Injectable, OnModuleInit, Logger } from \"@nestjs/common\";\nimport { DiscoveryService, ModuleRef } from \"@nestjs/core\";\nimport { KafkaClient } from \"../client/kafka.client\";\nimport {\n  KAFKA_SUBSCRIBER_METADATA,\n  KafkaSubscriberMetadata,\n} from \"./kafka.decorator\";\nimport { getKafkaClientToken } from \"./kafka.constants\";\n\ninterface SubscriberEntry extends KafkaSubscriberMetadata {\n  methodName: string | symbol;\n}\n\n/** Discovers `@SubscribeTo()` decorators and wires them to their Kafka clients on startup. */\n@Injectable()\nexport class KafkaExplorer implements OnModuleInit {\n  private readonly logger = new Logger(KafkaExplorer.name);\n\n  constructor(\n    @Inject(DiscoveryService)\n    private readonly discoveryService: DiscoveryService,\n    @Inject(ModuleRef)\n    private readonly moduleRef: ModuleRef,\n  ) {}\n\n  async onModuleInit() {\n    const providers = this.discoveryService.getProviders();\n\n    for (const wrapper of providers) {\n      const { instance } = wrapper;\n      if (!instance || typeof instance !== \"object\") continue;\n\n      const metadata: SubscriberEntry[] | undefined = Reflect.getMetadata(\n        KAFKA_SUBSCRIBER_METADATA,\n        instance.constructor,\n      );\n\n      if (!metadata || metadata.length === 0) continue;\n\n      for (const entry of metadata) {\n        const token = getKafkaClientToken(entry.clientName);\n        let client: KafkaClient<any>;\n\n        try {\n          client = this.moduleRef.get(token, { strict: false });\n        } catch {\n          this.logger.error(\n            `KafkaClient \"${entry.clientName || \"default\"}\" not found for @SubscribeTo on ${instance.constructor.name}.${String(entry.methodName)}`,\n          );\n          continue;\n        }\n\n        const handler = (instance as any)[entry.methodName].bind(instance);\n\n        const consumerOptions = { ...entry.options };\n        if (entry.schemas) {\n          consumerOptions.schemas = entry.schemas;\n        }\n\n        if (entry.batch) {\n          await client.startBatchConsumer(\n            entry.topics as any,\n            async (envelopes: any[], meta: any) => {\n              await handler(envelopes, meta);\n            },\n            consumerOptions,\n          );\n        } else {\n          await client.startConsumer(\n            entry.topics as any,\n            async (envelope: any) => {\n              await handler(envelope);\n            },\n            consumerOptions,\n          );\n        }\n\n        this.logger.log(\n          `Registered @SubscribeTo(${entry.topics.join(\", \")})${entry.batch ? \" [batch]\" : \"\"} on ${instance.constructor.name}.${String(entry.methodName)}`,\n        );\n      }\n    }\n  }\n}\n","import { Inject } from \"@nestjs/common\";\nimport { getKafkaClientToken } from \"./kafka.constants\";\nimport { ConsumerOptions } from \"../client/kafka.client\";\nimport { TopicDescriptor, SchemaLike } from \"../client/message/topic\";\n\nexport const KAFKA_SUBSCRIBER_METADATA = \"KAFKA_SUBSCRIBER_METADATA\";\n\nexport interface KafkaSubscriberMetadata {\n  topics: string[];\n  schemas?: Map<string, SchemaLike>;\n  options?: ConsumerOptions;\n  clientName?: string;\n  batch?: boolean;\n  methodName?: string | symbol;\n}\n\n/** Inject a `KafkaClient` instance. Pass a name to target a specific named client. */\nexport const InjectKafkaClient = (name?: string): ParameterDecorator =>\n  Inject(getKafkaClientToken(name));\n\n/**\n * Decorator that auto-subscribes a method to Kafka topics on module init.\n * The decorated method receives `(message, topic)` for each consumed message.\n */\nexport const SubscribeTo = (\n  topics:\n    | string\n    | string[]\n    | TopicDescriptor\n    | TopicDescriptor[]\n    | (string | TopicDescriptor)[],\n  options?: ConsumerOptions & { clientName?: string; batch?: boolean },\n): MethodDecorator => {\n  const arr = Array.isArray(topics) ? topics : [topics];\n  const topicsArray = arr.map((t) => (typeof t === \"string\" ? t : t.__topic));\n\n  // Extract schemas from descriptors that have them\n  const schemas = new Map<string, SchemaLike>();\n  for (const t of arr) {\n    if (typeof t !== \"string\" && t.__schema) {\n      schemas.set(t.__topic, t.__schema);\n    }\n  }\n\n  const { clientName, batch, ...consumerOptions } = options || {};\n\n  return (target, propertyKey, _descriptor) => {\n    const existing: KafkaSubscriberMetadata[] =\n      Reflect.getMetadata(KAFKA_SUBSCRIBER_METADATA, target.constructor) || [];\n\n    Reflect.defineMetadata(\n      KAFKA_SUBSCRIBER_METADATA,\n      [\n        ...existing,\n        {\n          topics: topicsArray,\n          schemas: schemas.size > 0 ? schemas : undefined,\n          options: Object.keys(consumerOptions).length\n            ? consumerOptions\n            : undefined,\n          clientName,\n          batch,\n          methodName: propertyKey,\n        },\n      ],\n      target.constructor,\n    );\n  };\n};\n","import { Injectable } from \"@nestjs/common\";\nimport { KafkaClient, TopicMapConstraint } from \"../client/kafka.client\";\n\n/** Result returned by `KafkaHealthIndicator.check()`. */\nexport type KafkaHealthResult =\n  | { status: \"up\"; clientId: string; topics: string[] }\n  | { status: \"down\"; clientId: string; error: string };\n\n/** Health check service. Call `check(client)` to verify broker connectivity. */\n@Injectable()\nexport class KafkaHealthIndicator {\n  async check<T extends TopicMapConstraint<T>>(\n    client: KafkaClient<T>,\n  ): Promise<KafkaHealthResult> {\n    try {\n      return await client.checkStatus();\n    } catch (error) {\n      return {\n        status: \"down\",\n        clientId: client.clientId,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  }\n}\n"],"mappings":"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","names":["Logger","Inject","Inject","Logger","Injectable","Injectable"]}
+{"version":3,"sources":["../src/nest/kafka.module.ts","../src/nest/kafka.constants.ts","../src/nest/kafka.explorer.ts","../src/nest/kafka.decorator.ts","../src/nest/kafka.health.ts"],"sourcesContent":["import { Module, DynamicModule, Provider, Logger } from \"@nestjs/common\";\nimport { DiscoveryModule } from \"@nestjs/core\";\nimport {\n  KafkaClient,\n  ClientId,\n  GroupId,\n  TopicMapConstraint,\n  KafkaInstrumentation,\n  KafkaClientOptions,\n} from \"../client/kafka.client\";\nimport { getKafkaClientToken } from \"./kafka.constants\";\nimport { KafkaExplorer } from \"./kafka.explorer\";\n\n/** Shared configuration fields for both `register()` and `registerAsync()`. */\ninterface KafkaModuleBaseOptions {\n  /** Optional name for multi-client setups. Must match `@InjectKafkaClient(name)`. */\n  name?: string;\n  /** If true, makes KAFKA_CLIENT available globally without importing KafkaModule in every feature module. */\n  isGlobal?: boolean;\n}\n\n/** Synchronous configuration for `KafkaModule.register()`. */\nexport interface KafkaModuleOptions extends KafkaModuleBaseOptions {\n  /** Unique Kafka client identifier. */\n  clientId: ClientId;\n  /** Consumer group identifier. */\n  groupId: GroupId;\n  /** List of Kafka broker addresses. */\n  brokers: string[];\n  /** Auto-create topics via admin on first use (send/consume). Useful for development. */\n  autoCreateTopics?: boolean;\n  /** When `true`, string topic keys are validated against any schema previously registered via a TopicDescriptor. Default: `true`. */\n  strictSchemas?: boolean;\n  /** Number of partitions for auto-created topics. Default: `1`. */\n  numPartitions?: number;\n  /** Client-wide instrumentation hooks (e.g. OTel). Applied to both send and consume paths. */\n  instrumentation?: KafkaInstrumentation[];\n  /** Called when a message is dropped without being sent to a DLQ. @see `KafkaClientOptions.onMessageLost` */\n  onMessageLost?: KafkaClientOptions[\"onMessageLost\"];\n  /** Called whenever a consumer group rebalance occurs. @see `KafkaClientOptions.onRebalance` */\n  onRebalance?: KafkaClientOptions[\"onRebalance\"];\n}\n\n/** Async configuration for `KafkaModule.registerAsync()` with dependency injection. */\nexport interface KafkaModuleAsyncOptions extends KafkaModuleBaseOptions {\n  imports?: any[];\n  useFactory: (\n    ...args: any[]\n  ) => KafkaModuleOptions | Promise<KafkaModuleOptions>;\n  inject?: any[];\n}\n\n/**\n * NestJS dynamic module for registering type-safe Kafka clients.\n * Use `register()` for static config or `registerAsync()` for DI-based config.\n */\n@Module({})\nexport class KafkaModule {\n  /** Register a Kafka client with static options. */\n  static register<T extends TopicMapConstraint<T>>(\n    options: KafkaModuleOptions,\n  ): DynamicModule {\n    const token = getKafkaClientToken(options.name);\n\n    const kafkaClientProvider: Provider = {\n      provide: token,\n      useFactory: () => KafkaModule.buildClient<T>(options),\n    };\n\n    return {\n      global: options.isGlobal ?? false,\n      module: KafkaModule,\n      imports: [DiscoveryModule],\n      providers: [\n        kafkaClientProvider,\n        KafkaModule.buildDestroyProvider(token),\n        KafkaExplorer,\n      ],\n      exports: [kafkaClientProvider],\n    };\n  }\n\n  /** Register a Kafka client with async/factory-based options. */\n  static registerAsync<T extends TopicMapConstraint<T>>(\n    asyncOptions: KafkaModuleAsyncOptions,\n  ): DynamicModule {\n    const token = getKafkaClientToken(asyncOptions.name);\n\n    const kafkaClientProvider: Provider = {\n      provide: token,\n      useFactory: async (...args: any[]): Promise<KafkaClient<T>> =>\n        KafkaModule.buildClient<T>(await asyncOptions.useFactory(...args)),\n      inject: asyncOptions.inject || [],\n    };\n\n    return {\n      global: asyncOptions.isGlobal ?? false,\n      module: KafkaModule,\n      imports: [...(asyncOptions.imports || []), DiscoveryModule],\n      providers: [\n        kafkaClientProvider,\n        KafkaModule.buildDestroyProvider(token),\n        KafkaExplorer,\n      ],\n      exports: [kafkaClientProvider],\n    };\n  }\n\n  private static async buildClient<T extends TopicMapConstraint<T>>(\n    options: KafkaModuleOptions,\n  ): Promise<KafkaClient<T>> {\n    const client = new KafkaClient<T>(\n      options.clientId,\n      options.groupId,\n      options.brokers,\n      {\n        autoCreateTopics: options.autoCreateTopics,\n        strictSchemas: options.strictSchemas,\n        numPartitions: options.numPartitions,\n        instrumentation: options.instrumentation,\n        onMessageLost: options.onMessageLost,\n        onRebalance: options.onRebalance,\n        logger: new Logger(`KafkaClient:${options.clientId}`),\n      },\n    );\n    await client.connectProducer();\n    return client;\n  }\n\n  private static buildDestroyProvider<T extends TopicMapConstraint<T>>(\n    token: string,\n  ): Provider {\n    return {\n      provide: `${token}_DESTROY`,\n      useFactory: (client: KafkaClient<T>) => ({\n        onModuleDestroy: () => client.disconnect(),\n      }),\n      inject: [token],\n    };\n  }\n}\n","/** Default DI token for the Kafka client. */\nexport const KAFKA_CLIENT = \"KAFKA_CLIENT\";\n\n/** Returns the DI token for a named (or default) Kafka client instance. */\nexport const getKafkaClientToken = (name?: string): string =>\n  name ? `KAFKA_CLIENT_${name}` : KAFKA_CLIENT;\n","import { Inject, Injectable, OnModuleInit, Logger } from \"@nestjs/common\";\nimport { DiscoveryService, ModuleRef } from \"@nestjs/core\";\nimport { KafkaClient } from \"../client/kafka.client\";\nimport {\n  KAFKA_SUBSCRIBER_METADATA,\n  KafkaSubscriberMetadata,\n} from \"./kafka.decorator\";\nimport { getKafkaClientToken } from \"./kafka.constants\";\n\ninterface SubscriberEntry extends KafkaSubscriberMetadata {\n  methodName: string | symbol;\n}\n\n/** Discovers `@SubscribeTo()` decorators and wires them to their Kafka clients on startup. */\n@Injectable()\nexport class KafkaExplorer implements OnModuleInit {\n  private readonly logger = new Logger(KafkaExplorer.name);\n\n  constructor(\n    @Inject(DiscoveryService)\n    private readonly discoveryService: DiscoveryService,\n    @Inject(ModuleRef)\n    private readonly moduleRef: ModuleRef,\n  ) {}\n\n  async onModuleInit() {\n    const providers = this.discoveryService.getProviders();\n\n    for (const wrapper of providers) {\n      const { instance } = wrapper;\n      if (!instance || typeof instance !== \"object\") continue;\n\n      const metadata: SubscriberEntry[] | undefined = Reflect.getMetadata(\n        KAFKA_SUBSCRIBER_METADATA,\n        instance.constructor,\n      );\n\n      if (!metadata || metadata.length === 0) continue;\n\n      for (const entry of metadata) {\n        const token = getKafkaClientToken(entry.clientName);\n        let client: KafkaClient<any>;\n\n        try {\n          client = this.moduleRef.get(token, { strict: false });\n        } catch {\n          this.logger.error(\n            `KafkaClient \"${entry.clientName || \"default\"}\" not found for @SubscribeTo on ${instance.constructor.name}.${String(entry.methodName)}`,\n          );\n          continue;\n        }\n\n        const handler = (instance as any)[entry.methodName].bind(instance);\n\n        const consumerOptions = { ...entry.options };\n        if (entry.schemas) {\n          consumerOptions.schemas = entry.schemas;\n        }\n\n        if (entry.batch) {\n          await client.startBatchConsumer(\n            entry.topics as any,\n            async (envelopes: any[], meta: any) => {\n              await handler(envelopes, meta);\n            },\n            consumerOptions,\n          );\n        } else {\n          await client.startConsumer(\n            entry.topics as any,\n            async (envelope: any) => {\n              await handler(envelope);\n            },\n            consumerOptions,\n          );\n        }\n\n        this.logger.log(\n          `Registered @SubscribeTo(${entry.topics.join(\", \")})${entry.batch ? \" [batch]\" : \"\"} on ${instance.constructor.name}.${String(entry.methodName)}`,\n        );\n      }\n    }\n  }\n}\n","import { Inject } from \"@nestjs/common\";\nimport { getKafkaClientToken } from \"./kafka.constants\";\nimport { ConsumerOptions } from \"../client/kafka.client\";\nimport { TopicDescriptor, SchemaLike } from \"../client/message/topic\";\n\nexport const KAFKA_SUBSCRIBER_METADATA = \"KAFKA_SUBSCRIBER_METADATA\";\n\nexport interface KafkaSubscriberMetadata {\n  topics: string[];\n  schemas?: Map<string, SchemaLike>;\n  options?: ConsumerOptions;\n  clientName?: string;\n  batch?: boolean;\n  methodName?: string | symbol;\n}\n\n/** Inject a `KafkaClient` instance. Pass a name to target a specific named client. */\nexport const InjectKafkaClient = (name?: string): ParameterDecorator =>\n  Inject(getKafkaClientToken(name));\n\n/**\n * Decorator that auto-subscribes a method to Kafka topics on module init.\n * The decorated method receives `(message, topic)` for each consumed message.\n */\nexport const SubscribeTo = (\n  topics:\n    | string\n    | string[]\n    | TopicDescriptor\n    | TopicDescriptor[]\n    | (string | TopicDescriptor)[],\n  options?: ConsumerOptions & { clientName?: string; batch?: boolean },\n): MethodDecorator => {\n  const arr = Array.isArray(topics) ? topics : [topics];\n  const topicsArray = arr.map((t) => (typeof t === \"string\" ? t : t.__topic));\n\n  // Extract schemas from descriptors that have them\n  const schemas = new Map<string, SchemaLike>();\n  for (const t of arr) {\n    if (typeof t !== \"string\" && t.__schema) {\n      schemas.set(t.__topic, t.__schema);\n    }\n  }\n\n  const { clientName, batch, ...consumerOptions } = options || {};\n\n  return (target, propertyKey, _descriptor) => {\n    const existing: KafkaSubscriberMetadata[] =\n      Reflect.getMetadata(KAFKA_SUBSCRIBER_METADATA, target.constructor) || [];\n\n    Reflect.defineMetadata(\n      KAFKA_SUBSCRIBER_METADATA,\n      [\n        ...existing,\n        {\n          topics: topicsArray,\n          schemas: schemas.size > 0 ? schemas : undefined,\n          options: Object.keys(consumerOptions).length\n            ? consumerOptions\n            : undefined,\n          clientName,\n          batch,\n          methodName: propertyKey,\n        },\n      ],\n      target.constructor,\n    );\n  };\n};\n","import { Injectable } from \"@nestjs/common\";\nimport { KafkaClient, TopicMapConstraint } from \"../client/kafka.client\";\nexport type { KafkaHealthResult } from \"../client/types\";\n\n/** Health check service. Call `check(client)` to verify broker connectivity. */\n@Injectable()\nexport class KafkaHealthIndicator {\n  async check<T extends TopicMapConstraint<T>>(\n    client: KafkaClient<T>,\n  ): Promise<import(\"../client/types\").KafkaHealthResult> {\n    return client.checkStatus();\n  }\n}\n"],"mappings":"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","names":["Logger","Inject","Inject","Logger","Injectable","Injectable"]}

package/dist/otel.d.mts

@@ -1,4 +1,4 @@
-import { K as KafkaInstrumentation } from './envelope-LeO5e3ob.mjs';
+import { K as KafkaInstrumentation } from './types-DwERZ6ql.mjs';
 
 /**
  * Create a `KafkaInstrumentation` that automatically propagates

package/dist/otel.d.ts

@@ -1,4 +1,4 @@
-import { K as KafkaInstrumentation } from './envelope-LeO5e3ob.js';
+import { K as KafkaInstrumentation } from './types-DwERZ6ql.js';
 
 /**
  * Create a `KafkaInstrumentation` that automatically propagates

package/dist/otel.js

@@ -26,8 +26,9 @@ module.exports = __toCommonJS(otel_exports);
 var import_api = require("@opentelemetry/api");
 function otelInstrumentation() {
   const tracer = import_api.trace.getTracer("@drarzter/kafka-client");
+  const activeSpans = /* @__PURE__ */ new Map();
   return {
-    beforeSend(topic, headers) {
+    beforeSend(_topic, headers) {
       import_api.propagation.inject(import_api.context.active(), headers);
     },
     afterSend(_topic) {
@@ -48,10 +49,14 @@ function otelInstrumentation() {
         },
         parentCtx
       );
-      return () => span.end();
+      activeSpans.set(envelope.eventId, span);
+      return () => {
+        span.end();
+        activeSpans.delete(envelope.eventId);
+      };
     },
-    onConsumeError(_envelope, error) {
-      const span = import_api.trace.getActiveSpan();
+    onConsumeError(envelope, error) {
+      const span = activeSpans.get(envelope.eventId);
       if (span) {
         span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: error.message });
         span.recordException(error);

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 { 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\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;AAAA;AAAA;AAAA;AAAA,iBAMO;AA0BA,SAAS,sBAA4C;AAC1D,QAAM,SAAS,iBAAM,UAAU,wBAAwB;AAEvD,SAAO;AAAA,IACL,WAAW,OAAe,SAAiC;AACzD,6BAAY,OAAO,mBAAQ,OAAO,GAAG,OAAO;AAAA,IAC9C;AAAA,IAEA,UAAU,QAAgB;AAAA,IAI1B;AAAA,IAEA,cAAc,UAA8B;AAC1C,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,aAAO,MAAM,KAAK,IAAI;AAAA,IACxB;AAAA,IAEA,eAAe,WAA+B,OAAc;AAC1D,YAAM,OAAO,iBAAM,cAAc;AACjC,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  SpanKind,\n  SpanStatusCode,\n} from \"@opentelemetry/api\";\nimport type { 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  // Keyed by eventId so beforeConsume/onConsumeError can share the span reference\n  // without requiring the span to be set as the active context.\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>) {\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      activeSpans.set(envelope.eventId, span);\n      return () => {\n        span.end();\n        activeSpans.delete(envelope.eventId);\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;AAGvD,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,UAA8B;AAC1C,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,kBAAY,IAAI,SAAS,SAAS,IAAI;AACtC,aAAO,MAAM;AACX,aAAK,IAAI;AACT,oBAAY,OAAO,SAAS,OAAO;AAAA,MACrC;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":[]}

package/dist/otel.mjs

@@ -10,8 +10,9 @@ import {
 } from "@opentelemetry/api";
 function otelInstrumentation() {
   const tracer = trace.getTracer("@drarzter/kafka-client");
+  const activeSpans = /* @__PURE__ */ new Map();
   return {
-    beforeSend(topic, headers) {
+    beforeSend(_topic, headers) {
       propagation.inject(context.active(), headers);
     },
     afterSend(_topic) {
@@ -32,10 +33,14 @@ function otelInstrumentation() {
         },
         parentCtx
       );
-      return () => span.end();
+      activeSpans.set(envelope.eventId, span);
+      return () => {
+        span.end();
+        activeSpans.delete(envelope.eventId);
+      };
     },
-    onConsumeError(_envelope, error) {
-      const span = trace.getActiveSpan();
+    onConsumeError(envelope, error) {
+      const span = activeSpans.get(envelope.eventId);
       if (span) {
         span.setStatus({ code: SpanStatusCode.ERROR, message: error.message });
         span.recordException(error);

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 { 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\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,WAA+B,OAAc;AAC1D,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":[]}
+{"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/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 eventId so beforeConsume/onConsumeError can share the span reference\n  // without requiring the span to be set as the active context.\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>) {\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      activeSpans.set(envelope.eventId, span);\n      return () => {\n        span.end();\n        activeSpans.delete(envelope.eventId);\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;AAGvD,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,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,kBAAY,IAAI,SAAS,SAAS,IAAI;AACtC,aAAO,MAAM;AACX,aAAK,IAAI;AACT,oBAAY,OAAO,SAAS,OAAO;AAAA,MACrC;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":[]}

package/dist/testing.d.mts

@@ -1,4 +1,4 @@
-import { T as TopicMapConstraint, I as IKafkaClient } from './envelope-LeO5e3ob.mjs';
+import { T as TopicMapConstraint, I as IKafkaClient } from './types-DwERZ6ql.mjs';
 
 /**
  * Fully typed mock of `IKafkaClient<T>` where every method is a mock function.

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { T as TopicMapConstraint, I as IKafkaClient } from './envelope-LeO5e3ob.js';
+import { T as TopicMapConstraint, I as IKafkaClient } from './types-DwERZ6ql.js';
 
 /**
  * Fully typed mock of `IKafkaClient<T>` where every method is a mock function.

package/dist/{envelope-LeO5e3ob.d.mts → types-DwERZ6ql.d.mts}

@@ -32,8 +32,8 @@ interface TopicDescriptor<N extends string = string, M extends Record<string, an
  *
  * @example
  * ```ts
- * // Without schema — type provided explicitly:
- * const OrderCreated = topic('order.created')<{ orderId: string; amount: number }>();
+ * // Without schema — explicit type via .type<T>():
+ * const OrderCreated = topic('order.created').type<{ orderId: string; amount: number }>();
  *
  * // With schema — type inferred from schema:
  * const OrderCreated = topic('order.created').schema(z.object({
@@ -50,16 +50,17 @@ interface TopicDescriptor<N extends string = string, M extends Record<string, an
  * ```
  */
 declare function topic<N extends string>(name: N): {
-    <M extends Record<string, any>>(): TopicDescriptor<N, M>;
-    schema<S extends SchemaLike<Record<string, any>>>(schema: S): TopicDescriptor<N, InferSchema<S>>;
+    /** Provide an explicit message type without a runtime schema. */
+    type: <M extends Record<string, any>>() => TopicDescriptor<N, M>;
+    schema: <S extends SchemaLike<Record<string, any>>>(schema: S) => TopicDescriptor<N, InferSchema<S>>;
 };
 /**
  * Build a topic-message map type from a union of TopicDescriptors.
  *
  * @example
  * ```ts
- * const OrderCreated = topic('order.created')<{ orderId: string }>();
- * const OrderCompleted = topic('order.completed')<{ completedAt: string }>();
+ * const OrderCreated = topic('order.created').type<{ orderId: string }>();
+ * const OrderCompleted = topic('order.completed').type<{ completedAt: string }>();
  *
  * type MyTopics = TopicsFrom<typeof OrderCreated | typeof OrderCompleted>;
  * // { 'order.created': { orderId: string }; 'order.completed': { completedAt: string } }
@@ -69,6 +70,77 @@ type TopicsFrom<D extends TopicDescriptor<any, any>> = {
     [K in D as K["__topic"]]: K["__type"];
 };
 
+declare const HEADER_EVENT_ID = "x-event-id";
+declare const HEADER_CORRELATION_ID = "x-correlation-id";
+declare const HEADER_TIMESTAMP = "x-timestamp";
+declare const HEADER_SCHEMA_VERSION = "x-schema-version";
+declare const HEADER_TRACEPARENT = "traceparent";
+/**
+ * Typed wrapper combining a parsed message payload with Kafka metadata
+ * and envelope headers.
+ *
+ * On **send**, the library auto-generates envelope headers
+ * (`x-event-id`, `x-correlation-id`, `x-timestamp`, `x-schema-version`).
+ *
+ * On **consume**, the library extracts those headers and assembles
+ * an `EventEnvelope` that is passed to the handler.
+ */
+interface EventEnvelope<T> {
+    /** Deserialized + validated message body. */
+    payload: T;
+    /** Topic the message was produced to / consumed from. */
+    topic: string;
+    /** Kafka partition (consume-side only, `-1` on send). */
+    partition: number;
+    /** Kafka offset (consume-side only, empty string on send). */
+    offset: string;
+    /** ISO-8601 timestamp set by the producer. */
+    timestamp: string;
+    /** Unique ID for this event (UUID v4). */
+    eventId: string;
+    /** Correlation ID — auto-propagated via AsyncLocalStorage. */
+    correlationId: string;
+    /** Schema version of the payload. */
+    schemaVersion: number;
+    /** W3C Trace Context `traceparent` header (set by OTel instrumentation). */
+    traceparent?: string;
+    /** All decoded Kafka headers for extensibility. */
+    headers: MessageHeaders;
+}
+interface EnvelopeCtx {
+    correlationId: string;
+    traceparent?: string;
+}
+/** Read the current envelope context (correlationId / traceparent) from ALS. */
+declare function getEnvelopeContext(): EnvelopeCtx | undefined;
+/** Execute `fn` inside an envelope context so nested sends inherit correlationId. */
+declare function runWithEnvelopeContext<R>(ctx: EnvelopeCtx, fn: () => R): R;
+/** Options accepted by `buildEnvelopeHeaders`. */
+interface EnvelopeHeaderOptions {
+    correlationId?: string;
+    schemaVersion?: number;
+    eventId?: string;
+    headers?: MessageHeaders;
+}
+/**
+ * Generate envelope headers for the send path.
+ *
+ * Priority for `correlationId`:
+ *   explicit option → ALS context → new UUID.
+ */
+declare function buildEnvelopeHeaders(options?: EnvelopeHeaderOptions): MessageHeaders;
+/**
+ * Decode kafkajs headers (`Record<string, Buffer | string | undefined>`)
+ * into plain `Record<string, string>`.
+ */
+declare function decodeHeaders(raw: Record<string, Buffer | string | (Buffer | string)[] | undefined> | undefined): MessageHeaders;
+/**
+ * Build an `EventEnvelope` from a consumed kafkajs message.
+ * Tolerates missing envelope headers — generates defaults so messages
+ * from non-envelope producers still work.
+ */
+declare function extractEnvelope<T>(payload: T, headers: MessageHeaders, topic: string, partition: number, offset: string): EventEnvelope<T>;
+
 /**
  * Mapping of topic names to their message types.
  * Define this interface to get type-safe publish/subscribe across your app.
@@ -165,6 +237,12 @@ interface ConsumerOptions<T extends TopicMapConstraint<T> = TTopicMessageMap> {
      * On exhaustion, messages go to `<topic>.dlq` (if `dlq: true`) or `onMessageLost`.
      */
     retryTopics?: boolean;
+    /**
+     * Timeout (ms) for waiting until each retry level consumer receives partition
+     * assignments after `startConsumer` connects. Default: `10000`.
+     * Increase this when the broker is slow to rebalance.
+     */
+    retryTopicAssignmentTimeoutMs?: number;
     /**
      * Log a warning if the message handler has not resolved within this window (ms).
      * The handler is not cancelled — this is a diagnostic aid to surface stuck handlers
@@ -226,13 +304,19 @@ interface ConsumerHandle {
     /** Stop this consumer. Equivalent to calling `client.stopConsumer(groupId)`. */
     stop(): Promise<void>;
 }
+/** Result returned by `KafkaClient.checkStatus()`. */
+type KafkaHealthResult = {
+    status: "up";
+    clientId: string;
+    topics: string[];
+} | {
+    status: "down";
+    clientId: string;
+    error: string;
+};
 /** Interface describing all public methods of the Kafka client. */
 interface IKafkaClient<T extends TopicMapConstraint<T>> {
-    checkStatus(): Promise<{
-        status: "up";
-        clientId: string;
-        topics: string[];
-    }>;
+    checkStatus(): Promise<KafkaHealthResult>;
     /**
      * Query the consumer group lag per partition using the admin API.
      * Lag = (broker high-watermark offset) − (last committed offset).
@@ -325,75 +409,4 @@ interface SubscribeRetryOptions {
     backoffMs?: number;
 }
 
-declare const HEADER_EVENT_ID = "x-event-id";
-declare const HEADER_CORRELATION_ID = "x-correlation-id";
-declare const HEADER_TIMESTAMP = "x-timestamp";
-declare const HEADER_SCHEMA_VERSION = "x-schema-version";
-declare const HEADER_TRACEPARENT = "traceparent";
-/**
- * Typed wrapper combining a parsed message payload with Kafka metadata
- * and envelope headers.
- *
- * On **send**, the library auto-generates envelope headers
- * (`x-event-id`, `x-correlation-id`, `x-timestamp`, `x-schema-version`).
- *
- * On **consume**, the library extracts those headers and assembles
- * an `EventEnvelope` that is passed to the handler.
- */
-interface EventEnvelope<T> {
-    /** Deserialized + validated message body. */
-    payload: T;
-    /** Topic the message was produced to / consumed from. */
-    topic: string;
-    /** Kafka partition (consume-side only, `-1` on send). */
-    partition: number;
-    /** Kafka offset (consume-side only, empty string on send). */
-    offset: string;
-    /** ISO-8601 timestamp set by the producer. */
-    timestamp: string;
-    /** Unique ID for this event (UUID v4). */
-    eventId: string;
-    /** Correlation ID — auto-propagated via AsyncLocalStorage. */
-    correlationId: string;
-    /** Schema version of the payload. */
-    schemaVersion: number;
-    /** W3C Trace Context `traceparent` header (set by OTel instrumentation). */
-    traceparent?: string;
-    /** All decoded Kafka headers for extensibility. */
-    headers: MessageHeaders;
-}
-interface EnvelopeCtx {
-    correlationId: string;
-    traceparent?: string;
-}
-/** Read the current envelope context (correlationId / traceparent) from ALS. */
-declare function getEnvelopeContext(): EnvelopeCtx | undefined;
-/** Execute `fn` inside an envelope context so nested sends inherit correlationId. */
-declare function runWithEnvelopeContext<R>(ctx: EnvelopeCtx, fn: () => R): R;
-/** Options accepted by `buildEnvelopeHeaders`. */
-interface EnvelopeHeaderOptions {
-    correlationId?: string;
-    schemaVersion?: number;
-    eventId?: string;
-    headers?: MessageHeaders;
-}
-/**
- * Generate envelope headers for the send path.
- *
- * Priority for `correlationId`:
- *   explicit option → ALS context → new UUID.
- */
-declare function buildEnvelopeHeaders(options?: EnvelopeHeaderOptions): MessageHeaders;
-/**
- * Decode kafkajs headers (`Record<string, Buffer | string | undefined>`)
- * into plain `Record<string, string>`.
- */
-declare function decodeHeaders(raw: Record<string, Buffer | string | (Buffer | string)[] | undefined> | undefined): MessageHeaders;
-/**
- * Build an `EventEnvelope` from a consumed kafkajs message.
- * Tolerates missing envelope headers — generates defaults so messages
- * from non-envelope producers still work.
- */
-declare function extractEnvelope<T>(payload: T, headers: MessageHeaders, topic: string, partition: number, offset: string): EventEnvelope<T>;
-
-export { type BatchMessageItem as B, type ClientId as C, type EnvelopeHeaderOptions as E, type GroupId as G, HEADER_CORRELATION_ID as H, type IKafkaClient as I, type KafkaInstrumentation as K, type MessageHeaders as M, type RetryOptions as R, type SchemaLike as S, type TopicMapConstraint as T, type KafkaClientOptions as a, type ConsumerOptions as b, type TopicDescriptor as c, type BatchMeta as d, type ConsumerHandle as e, type ConsumerInterceptor as f, type EventEnvelope as g, HEADER_EVENT_ID as h, HEADER_SCHEMA_VERSION as i, HEADER_TIMESTAMP as j, HEADER_TRACEPARENT as k, type InferSchema as l, type KafkaLogger as m, type MessageLostContext as n, type SendOptions as o, type SubscribeRetryOptions as p, type TTopicMessageMap as q, type TopicsFrom as r, type TransactionContext as s, buildEnvelopeHeaders as t, decodeHeaders as u, extractEnvelope as v, getEnvelopeContext as w, runWithEnvelopeContext as x, topic as y };
+export { type BatchMessageItem as B, type ClientId as C, type EnvelopeHeaderOptions as E, type GroupId as G, HEADER_CORRELATION_ID as H, type IKafkaClient as I, type KafkaInstrumentation as K, type MessageHeaders as M, type RetryOptions as R, type SchemaLike as S, type TopicMapConstraint as T, type KafkaClientOptions as a, type ConsumerOptions as b, type TopicDescriptor as c, type KafkaHealthResult as d, type BatchMeta as e, type ConsumerHandle as f, type ConsumerInterceptor as g, type EventEnvelope as h, HEADER_EVENT_ID as i, HEADER_SCHEMA_VERSION as j, HEADER_TIMESTAMP as k, HEADER_TRACEPARENT as l, type InferSchema as m, type KafkaLogger as n, type MessageLostContext as o, type SendOptions as p, type SubscribeRetryOptions as q, type TTopicMessageMap as r, type TopicsFrom as s, type TransactionContext as t, buildEnvelopeHeaders as u, decodeHeaders as v, extractEnvelope as w, getEnvelopeContext as x, runWithEnvelopeContext as y, topic as z };