@drarzter/kafka-client 0.9.4 → 0.11.0

package/dist/index.mjs

@@ -1,21 +1,43 @@
 import {
+  ConfluentTransport,
   HEADER_CORRELATION_ID,
+  HEADER_DELAYED_TARGET,
+  HEADER_DELAYED_UNTIL,
   HEADER_EVENT_ID,
   HEADER_LAMPORT_CLOCK,
   HEADER_SCHEMA_VERSION,
   HEADER_TIMESTAMP,
   HEADER_TRACEPARENT,
+  InMemoryDedupStore,
+  InMemoryOutboxStore,
   KafkaClient,
   KafkaProcessingError,
   KafkaRetryExhaustedError,
   KafkaValidationError,
+  awsMskIamProvider,
   buildEnvelopeHeaders,
+  consumerOptionsFromEnv,
   decodeHeaders,
+  describeRequiredAcls,
   extractEnvelope,
+  gcpAccessTokenProvider,
   getEnvelopeContext,
+  kafkaClientConfigFromEnv,
+  mergeConsumerOptions,
+  resolveSecurityOptions,
   runWithEnvelopeContext,
-  topic
-} from "./chunk-SM4FZKAZ.mjs";
+  startOutboxRelay,
+  toError,
+  toKafkaAclCommands,
+  toMskIamPolicy,
+  topic,
+  versionedSchema
+} from "./chunk-OR7TPAAE.mjs";
+import {
+  JsonSerde,
+  SchemaRegistryClient,
+  registrySchema
+} from "./chunk-PQVBRDNV.mjs";
 import {
   __decorateClass,
   __decorateParam
@@ -68,11 +90,14 @@ var SubscribeTo = (topics, options) => {
 };
 
 // src/nest/kafka.explorer.ts
+var wiredSubscriptions = /* @__PURE__ */ new WeakMap();
 var KafkaExplorer = class {
   constructor(discoveryService, moduleRef) {
     this.discoveryService = discoveryService;
     this.moduleRef = moduleRef;
   }
+  discoveryService;
+  moduleRef;
   logger = new Logger(KafkaExplorer.name);
   /**
    * Scan all NestJS providers for `@SubscribeTo()` metadata and wire each decorated
@@ -92,6 +117,14 @@ var KafkaExplorer = class {
       if (!metadata || metadata.length === 0) continue;
       for (const entry of metadata) {
         const token = getKafkaClientToken(entry.clientName);
+        const entryKey = `${token}:${String(entry.methodName)}`;
+        let wired = wiredSubscriptions.get(instance);
+        if (!wired) {
+          wired = /* @__PURE__ */ new Set();
+          wiredSubscriptions.set(instance, wired);
+        }
+        if (wired.has(entryKey)) continue;
+        wired.add(entryKey);
         let client;
         try {
           client = this.moduleRef.get(token, { strict: false });
@@ -181,6 +214,12 @@ var KafkaModule = class {
         instrumentation: options.instrumentation,
         onMessageLost: options.onMessageLost,
         onRebalance: options.onRebalance,
+        transactionalId: options.transactionalId,
+        clockRecovery: options.clockRecovery,
+        lagThrottle: options.lagThrottle,
+        onTtlExpired: options.onTtlExpired,
+        transport: options.transport,
+        security: options.security,
         logger: new Logger2(`KafkaClient:${options.clientId}`)
       }
     );
@@ -203,13 +242,19 @@ KafkaHealthIndicator = __decorateClass([
   Injectable2()
 ], KafkaHealthIndicator);
 export {
+  ConfluentTransport,
   HEADER_CORRELATION_ID,
+  HEADER_DELAYED_TARGET,
+  HEADER_DELAYED_UNTIL,
   HEADER_EVENT_ID,
   HEADER_LAMPORT_CLOCK,
   HEADER_SCHEMA_VERSION,
   HEADER_TIMESTAMP,
   HEADER_TRACEPARENT,
+  InMemoryDedupStore,
+  InMemoryOutboxStore,
   InjectKafkaClient,
+  JsonSerde,
   KAFKA_CLIENT,
   KAFKA_SUBSCRIBER_METADATA,
   KafkaClient,
@@ -219,13 +264,27 @@ export {
   KafkaProcessingError,
   KafkaRetryExhaustedError,
   KafkaValidationError,
+  SchemaRegistryClient,
   SubscribeTo,
+  awsMskIamProvider,
   buildEnvelopeHeaders,
+  consumerOptionsFromEnv,
   decodeHeaders,
+  describeRequiredAcls,
   extractEnvelope,
+  gcpAccessTokenProvider,
   getEnvelopeContext,
   getKafkaClientToken,
+  kafkaClientConfigFromEnv,
+  mergeConsumerOptions,
+  registrySchema,
+  resolveSecurityOptions,
   runWithEnvelopeContext,
-  topic
+  startOutboxRelay,
+  toError,
+  toKafkaAclCommands,
+  toMskIamPolicy,
+  topic,
+  versionedSchema
 };
 //# sourceMappingURL=index.mjs.map

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: [kafkaClientProvider, KafkaExplorer],\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: [kafkaClientProvider, KafkaExplorer],\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","/** 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  /**\n   * Scan all NestJS providers for `@SubscribeTo()` metadata and wire each decorated\n   * method to its Kafka client via `startConsumer` or `startBatchConsumer`.\n   *\n   * Called automatically by the NestJS lifecycle — do not invoke manually.\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\n/** Reflect metadata key used to store `@SubscribeTo` entries on a class constructor. */\nexport const KAFKA_SUBSCRIBER_METADATA = \"KAFKA_SUBSCRIBER_METADATA\";\n\n/** Internal shape stored per `@SubscribeTo()` decoration on a class. */\nexport interface KafkaSubscriberMetadata {\n  /** Resolved topic name strings (descriptors are unwrapped to their `__topic` string). */\n  topics: string[];\n  /** Per-topic schema validators extracted from `TopicDescriptor` objects (if any). */\n  schemas?: Map<string, SchemaLike>;\n  /** Additional consumer options forwarded to `startConsumer` / `startBatchConsumer`. */\n  options?: ConsumerOptions;\n  /** Named client identifier — resolves to `KAFKA_CLIENT_<clientName>` in the DI container. */\n  clientName?: string;\n  /** When `true`, routes to `startBatchConsumer` instead of `startConsumer`. */\n  batch?: boolean;\n  /** Name of the decorated method on the provider class. */\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 * Method decorator that auto-subscribes the decorated method to one or more Kafka topics\n * when the NestJS module initialises.\n *\n * The decorated method receives a fully-decoded `EventEnvelope` for each message\n * (or an array of envelopes + `BatchMeta` when `batch: true`).\n *\n * @param topics One or more topic names or `TopicDescriptor` objects. Schemas embedded in\n *   descriptors are automatically extracted and forwarded to the consumer.\n * @param options Consumer and routing options:\n *   - All `ConsumerOptions` fields (`groupId`, `retry`, `dlq`, `fromBeginning`, …)\n *   - `clientName` — target a named `KafkaClient` (resolves `KAFKA_CLIENT_<name>` from the DI container)\n *   - `batch` — use `startBatchConsumer` instead of `startConsumer`\n *\n * @example\n * ```ts\n * @SubscribeTo('orders.created', { groupId: 'orders-svc', retry: { maxRetries: 3 } })\n * async handleOrder(envelope: EventEnvelope<Order>) { ... }\n *\n * @SubscribeTo(OrdersTopic, { batch: true })\n * async handleBatch(envelopes: EventEnvelope<Order>[], meta: BatchMeta) { ... }\n * ```\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 type {\n  IKafkaClient,\n  KafkaHealthResult,\n  TopicMapConstraint,\n} from \"../client/types\";\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: IKafkaClient<T>,\n  ): Promise<KafkaHealthResult> {\n    return client.checkStatus();\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  /** Transactional producer ID — must be unique per process/replica. @see `KafkaClientOptions.transactionalId` */\n  transactionalId?: KafkaClientOptions[\"transactionalId\"];\n  /** Recover the Lamport clock from these topics on startup. @see `KafkaClientOptions.clockRecovery` */\n  clockRecovery?: KafkaClientOptions[\"clockRecovery\"];\n  /** Delay producer sends when consumer lag exceeds a threshold. @see `KafkaClientOptions.lagThrottle` */\n  lagThrottle?: KafkaClientOptions[\"lagThrottle\"];\n  /** Client-wide TTL expiry callback. @see `KafkaClientOptions.onTtlExpired` */\n  onTtlExpired?: KafkaClientOptions[\"onTtlExpired\"];\n  /** Custom transport implementation (e.g. `FakeTransport` in tests). @see `KafkaClientOptions.transport` */\n  transport?: KafkaClientOptions[\"transport\"];\n  /** Transport security (TLS + SASL, incl. MSK IAM / GCP OAUTHBEARER). @see `KafkaClientOptions.security` */\n  security?: KafkaClientOptions[\"security\"];\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: [kafkaClientProvider, KafkaExplorer],\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: [kafkaClientProvider, KafkaExplorer],\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        transactionalId: options.transactionalId,\n        clockRecovery: options.clockRecovery,\n        lagThrottle: options.lagThrottle,\n        onTtlExpired: options.onTtlExpired,\n        transport: options.transport,\n        security: options.security,\n        logger: new Logger(`KafkaClient:${options.clientId}`),\n      },\n    );\n    await client.connectProducer();\n    return client;\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/**\n * Process-level registry of already-wired subscriptions, keyed by provider\n * instance. Every `KafkaModule.register()` call contributes its own\n * `KafkaExplorer`, and each explorer scans ALL providers — without this guard\n * a multi-client app would wire every `@SubscribeTo` handler once per\n * registered module (duplicate consumers / \"called twice\" startup errors).\n * Keyed by instance (not constructor) so separate Nest apps in one process\n * (e.g. tests) still wire their own instances independently.\n */\nconst wiredSubscriptions = new WeakMap<object, Set<string>>();\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  /**\n   * Scan all NestJS providers for `@SubscribeTo()` metadata and wire each decorated\n   * method to its Kafka client via `startConsumer` or `startBatchConsumer`.\n   *\n   * Called automatically by the NestJS lifecycle — do not invoke manually.\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\n        const entryKey = `${token}:${String(entry.methodName)}`;\n        let wired = wiredSubscriptions.get(instance);\n        if (!wired) {\n          wired = new Set();\n          wiredSubscriptions.set(instance, wired);\n        }\n        if (wired.has(entryKey)) continue; // already wired by another KafkaExplorer instance\n        wired.add(entryKey);\n\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\n/** Reflect metadata key used to store `@SubscribeTo` entries on a class constructor. */\nexport const KAFKA_SUBSCRIBER_METADATA = \"KAFKA_SUBSCRIBER_METADATA\";\n\n/** Internal shape stored per `@SubscribeTo()` decoration on a class. */\nexport interface KafkaSubscriberMetadata {\n  /** Resolved topic name strings (descriptors are unwrapped to their `__topic` string). */\n  topics: string[];\n  /** Per-topic schema validators extracted from `TopicDescriptor` objects (if any). */\n  schemas?: Map<string, SchemaLike>;\n  /** Additional consumer options forwarded to `startConsumer` / `startBatchConsumer`. */\n  options?: ConsumerOptions;\n  /** Named client identifier — resolves to `KAFKA_CLIENT_<clientName>` in the DI container. */\n  clientName?: string;\n  /** When `true`, routes to `startBatchConsumer` instead of `startConsumer`. */\n  batch?: boolean;\n  /** Name of the decorated method on the provider class. */\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 * Method decorator that auto-subscribes the decorated method to one or more Kafka topics\n * when the NestJS module initialises.\n *\n * The decorated method receives a fully-decoded `EventEnvelope` for each message\n * (or an array of envelopes + `BatchMeta` when `batch: true`).\n *\n * @param topics One or more topic names or `TopicDescriptor` objects. Schemas embedded in\n *   descriptors are automatically extracted and forwarded to the consumer.\n * @param options Consumer and routing options:\n *   - All `ConsumerOptions` fields (`groupId`, `retry`, `dlq`, `fromBeginning`, …)\n *   - `clientName` — target a named `KafkaClient` (resolves `KAFKA_CLIENT_<name>` from the DI container)\n *   - `batch` — use `startBatchConsumer` instead of `startConsumer`\n *\n * @example\n * ```ts\n * @SubscribeTo('orders.created', { groupId: 'orders-svc', retry: { maxRetries: 3 } })\n * async handleOrder(envelope: EventEnvelope<Order>) { ... }\n *\n * @SubscribeTo(OrdersTopic, { batch: true })\n * async handleBatch(envelopes: EventEnvelope<Order>[], meta: BatchMeta) { ... }\n * ```\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 type {\n  IKafkaClient,\n  KafkaHealthResult,\n  TopicMapConstraint,\n} from \"../client/types\";\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: IKafkaClient<T>,\n  ): Promise<KafkaHealthResult> {\n    return client.checkStatus();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,QAAiC,UAAAA,eAAc;AACxD,SAAS,uBAAuB;;;ACAzB,IAAM,eAAe;AAGrB,IAAM,sBAAsB,CAAC,SAClC,OAAO,gBAAgB,IAAI,KAAK;;;ACLlC,SAAS,UAAAC,SAAQ,YAA0B,cAAc;AACzD,SAAS,kBAAkB,iBAAiB;;;ACD5C,SAAS,cAAc;AAMhB,IAAM,4BAA4B;AAmBlC,IAAM,oBAAoB,CAAC,SAChC,OAAO,oBAAoB,IAAI,CAAC;AAyB3B,IAAM,cAAc,CACzB,QAMA,YACoB;AACpB,QAAM,MAAM,MAAM,QAAQ,MAAM,IAAI,SAAS,CAAC,MAAM;AACpD,QAAM,cAAc,IAAI,IAAI,CAAC,MAAO,OAAO,MAAM,WAAW,IAAI,EAAE,OAAQ;AAG1E,QAAM,UAAU,oBAAI,IAAwB;AAC5C,aAAW,KAAK,KAAK;AACnB,QAAI,OAAO,MAAM,YAAY,EAAE,UAAU;AACvC,cAAQ,IAAI,EAAE,SAAS,EAAE,QAAQ;AAAA,IACnC;AAAA,EACF;AAEA,QAAM,EAAE,YAAY,OAAO,GAAG,gBAAgB,IAAI,WAAW,CAAC;AAE9D,SAAO,CAAC,QAAQ,aAAa,gBAAgB;AAC3C,UAAM,WACJ,QAAQ,YAAY,2BAA2B,OAAO,WAAW,KAAK,CAAC;AAEzE,YAAQ;AAAA,MACN;AAAA,MACA;AAAA,QACE,GAAG;AAAA,QACH;AAAA,UACE,QAAQ;AAAA,UACR,SAAS,QAAQ,OAAO,IAAI,UAAU;AAAA,UACtC,SAAS,OAAO,KAAK,eAAe,EAAE,SAClC,kBACA;AAAA,UACJ;AAAA,UACA;AAAA,UACA,YAAY;AAAA,QACd;AAAA,MACF;AAAA,MACA,OAAO;AAAA,IACT;AAAA,EACF;AACF;;;ADzEA,IAAM,qBAAqB,oBAAI,QAA6B;AAIrD,IAAM,gBAAN,MAA4C;AAAA,EAGjD,YAEmB,kBAEA,WACjB;AAHiB;AAEA;AAAA,EAChB;AAAA,EAHgB;AAAA,EAEA;AAAA,EANF,SAAS,IAAI,OAAO,cAAc,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAevD,MAAM,eAAe;AACnB,UAAM,YAAY,KAAK,iBAAiB,aAAa;AAErD,eAAW,WAAW,WAAW;AAC/B,YAAM,EAAE,SAAS,IAAI;AACrB,UAAI,CAAC,YAAY,OAAO,aAAa,SAAU;AAE/C,YAAM,WAA0C,QAAQ;AAAA,QACtD;AAAA,QACA,SAAS;AAAA,MACX;AAEA,UAAI,CAAC,YAAY,SAAS,WAAW,EAAG;AAExC,iBAAW,SAAS,UAAU;AAC5B,cAAM,QAAQ,oBAAoB,MAAM,UAAU;AAElD,cAAM,WAAW,GAAG,KAAK,IAAI,OAAO,MAAM,UAAU,CAAC;AACrD,YAAI,QAAQ,mBAAmB,IAAI,QAAQ;AAC3C,YAAI,CAAC,OAAO;AACV,kBAAQ,oBAAI,IAAI;AAChB,6BAAmB,IAAI,UAAU,KAAK;AAAA,QACxC;AACA,YAAI,MAAM,IAAI,QAAQ,EAAG;AACzB,cAAM,IAAI,QAAQ;AAElB,YAAI;AAEJ,YAAI;AACF,mBAAS,KAAK,UAAU,IAAI,OAAO,EAAE,QAAQ,MAAM,CAAC;AAAA,QACtD,QAAQ;AACN,eAAK,OAAO;AAAA,YACV,gBAAgB,MAAM,cAAc,SAAS,mCAAmC,SAAS,YAAY,IAAI,IAAI,OAAO,MAAM,UAAU,CAAC;AAAA,UACvI;AACA;AAAA,QACF;AAEA,cAAM,UAAW,SAAiB,MAAM,UAAU,EAAE,KAAK,QAAQ;AAEjE,cAAM,kBAAkB,EAAE,GAAG,MAAM,QAAQ;AAC3C,YAAI,MAAM,SAAS;AACjB,0BAAgB,UAAU,MAAM;AAAA,QAClC;AAEA,YAAI,MAAM,OAAO;AACf,gBAAM,OAAO;AAAA,YACX,MAAM;AAAA,YACN,OAAO,WAAkB,SAAc;AACrC,oBAAM,QAAQ,WAAW,IAAI;AAAA,YAC/B;AAAA,YACA;AAAA,UACF;AAAA,QACF,OAAO;AACL,gBAAM,OAAO;AAAA,YACX,MAAM;AAAA,YACN,OAAO,aAAkB;AACvB,oBAAM,QAAQ,QAAQ;AAAA,YACxB;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAEA,aAAK,OAAO;AAAA,UACV,2BAA2B,MAAM,OAAO,KAAK,IAAI,CAAC,IAAI,MAAM,QAAQ,aAAa,EAAE,OAAO,SAAS,YAAY,IAAI,IAAI,OAAO,MAAM,UAAU,CAAC;AAAA,QACjJ;AAAA,MACF;AAAA,IACF;AAAA,EACF;AACF;AApFa,gBAAN;AAAA,EADN,WAAW;AAAA,EAKP,mBAAAC,QAAO,gBAAgB;AAAA,EAEvB,mBAAAA,QAAO,SAAS;AAAA,GANR;;;AF2CN,IAAM,cAAN,MAAkB;AAAA;AAAA,EAEvB,OAAO,SACL,SACe;AACf,UAAM,QAAQ,oBAAoB,QAAQ,IAAI;AAE9C,UAAM,sBAAgC;AAAA,MACpC,SAAS;AAAA,MACT,YAAY,MAAM,YAAY,YAAe,OAAO;AAAA,IACtD;AAEA,WAAO;AAAA,MACL,QAAQ,QAAQ,YAAY;AAAA,MAC5B,QAAQ;AAAA,MACR,SAAS,CAAC,eAAe;AAAA,MACzB,WAAW,CAAC,qBAAqB,aAAa;AAAA,MAC9C,SAAS,CAAC,mBAAmB;AAAA,IAC/B;AAAA,EACF;AAAA;AAAA,EAGA,OAAO,cACL,cACe;AACf,UAAM,QAAQ,oBAAoB,aAAa,IAAI;AAEnD,UAAM,sBAAgC;AAAA,MACpC,SAAS;AAAA,MACT,YAAY,UAAU,SACpB,YAAY,YAAe,MAAM,aAAa,WAAW,GAAG,IAAI,CAAC;AAAA,MACnE,QAAQ,aAAa,UAAU,CAAC;AAAA,IAClC;AAEA,WAAO;AAAA,MACL,QAAQ,aAAa,YAAY;AAAA,MACjC,QAAQ;AAAA,MACR,SAAS,CAAC,GAAI,aAAa,WAAW,CAAC,GAAI,eAAe;AAAA,MAC1D,WAAW,CAAC,qBAAqB,aAAa;AAAA,MAC9C,SAAS,CAAC,mBAAmB;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,aAAqB,YACnB,SACyB;AACzB,UAAM,SAAS,IAAI;AAAA,MACjB,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR;AAAA,QACE,kBAAkB,QAAQ;AAAA,QAC1B,eAAe,QAAQ;AAAA,QACvB,eAAe,QAAQ;AAAA,QACvB,iBAAiB,QAAQ;AAAA,QACzB,eAAe,QAAQ;AAAA,QACvB,aAAa,QAAQ;AAAA,QACrB,iBAAiB,QAAQ;AAAA,QACzB,eAAe,QAAQ;AAAA,QACvB,aAAa,QAAQ;AAAA,QACrB,cAAc,QAAQ;AAAA,QACtB,WAAW,QAAQ;AAAA,QACnB,UAAU,QAAQ;AAAA,QAClB,QAAQ,IAAIC,QAAO,eAAe,QAAQ,QAAQ,EAAE;AAAA,MACtD;AAAA,IACF;AACA,UAAM,OAAO,gBAAgB;AAC7B,WAAO;AAAA,EACT;AACF;AArEa,cAAN;AAAA,EADN,OAAO,CAAC,CAAC;AAAA,GACG;;;AIrEb,SAAS,cAAAC,mBAAkB;AAUpB,IAAM,uBAAN,MAA2B;AAAA,EAChC,MAAM,MACJ,QAC4B;AAC5B,WAAO,OAAO,YAAY;AAAA,EAC5B;AACF;AANa,uBAAN;AAAA,EADNC,YAAW;AAAA,GACC;","names":["Logger","Inject","Inject","Logger","Injectable","Injectable"]}

package/dist/nest/kafka.constants.d.ts

@@ -0,0 +1,5 @@
+/** Default DI token for the Kafka client. */
+export declare const KAFKA_CLIENT = "KAFKA_CLIENT";
+/** Returns the DI token for a named (or default) Kafka client instance. */
+export declare const getKafkaClientToken: (name?: string) => string;
+//# sourceMappingURL=kafka.constants.d.ts.map

package/dist/nest/kafka.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kafka.constants.d.ts","sourceRoot":"","sources":["../../src/nest/kafka.constants.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,KAAG,MACN,CAAC"}

package/dist/nest/kafka.decorator.d.ts

@@ -0,0 +1,49 @@
+import { ConsumerOptions } from "../client/kafka.client";
+import { TopicDescriptor, SchemaLike } from "../client/message/topic";
+/** Reflect metadata key used to store `@SubscribeTo` entries on a class constructor. */
+export declare const KAFKA_SUBSCRIBER_METADATA = "KAFKA_SUBSCRIBER_METADATA";
+/** Internal shape stored per `@SubscribeTo()` decoration on a class. */
+export interface KafkaSubscriberMetadata {
+    /** Resolved topic name strings (descriptors are unwrapped to their `__topic` string). */
+    topics: string[];
+    /** Per-topic schema validators extracted from `TopicDescriptor` objects (if any). */
+    schemas?: Map<string, SchemaLike>;
+    /** Additional consumer options forwarded to `startConsumer` / `startBatchConsumer`. */
+    options?: ConsumerOptions;
+    /** Named client identifier — resolves to `KAFKA_CLIENT_<clientName>` in the DI container. */
+    clientName?: string;
+    /** When `true`, routes to `startBatchConsumer` instead of `startConsumer`. */
+    batch?: boolean;
+    /** Name of the decorated method on the provider class. */
+    methodName?: string | symbol;
+}
+/** Inject a `KafkaClient` instance. Pass a name to target a specific named client. */
+export declare const InjectKafkaClient: (name?: string) => ParameterDecorator;
+/**
+ * Method decorator that auto-subscribes the decorated method to one or more Kafka topics
+ * when the NestJS module initialises.
+ *
+ * The decorated method receives a fully-decoded `EventEnvelope` for each message
+ * (or an array of envelopes + `BatchMeta` when `batch: true`).
+ *
+ * @param topics One or more topic names or `TopicDescriptor` objects. Schemas embedded in
+ *   descriptors are automatically extracted and forwarded to the consumer.
+ * @param options Consumer and routing options:
+ *   - All `ConsumerOptions` fields (`groupId`, `retry`, `dlq`, `fromBeginning`, …)
+ *   - `clientName` — target a named `KafkaClient` (resolves `KAFKA_CLIENT_<name>` from the DI container)
+ *   - `batch` — use `startBatchConsumer` instead of `startConsumer`
+ *
+ * @example
+ * ```ts
+ * @SubscribeTo('orders.created', { groupId: 'orders-svc', retry: { maxRetries: 3 } })
+ * async handleOrder(envelope: EventEnvelope<Order>) { ... }
+ *
+ * @SubscribeTo(OrdersTopic, { batch: true })
+ * async handleBatch(envelopes: EventEnvelope<Order>[], meta: BatchMeta) { ... }
+ * ```
+ */
+export declare const SubscribeTo: (topics: string | string[] | TopicDescriptor | TopicDescriptor[] | (string | TopicDescriptor)[], options?: ConsumerOptions & {
+    clientName?: string;
+    batch?: boolean;
+}) => MethodDecorator;
+//# sourceMappingURL=kafka.decorator.d.ts.map

package/dist/nest/kafka.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kafka.decorator.d.ts","sourceRoot":"","sources":["../../src/nest/kafka.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEtE,wFAAwF;AACxF,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE,wEAAwE;AACxE,MAAM,WAAW,uBAAuB;IACtC,yFAAyF;IACzF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,qFAAqF;IACrF,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClC,uFAAuF;IACvF,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,6FAA6F;IAC7F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AAED,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,kBACf,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,WAAW,GACtB,QACI,MAAM,GACN,MAAM,EAAE,GACR,eAAe,GACf,eAAe,EAAE,GACjB,CAAC,MAAM,GAAG,eAAe,CAAC,EAAE,EAChC,UAAU,eAAe,GAAG;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,KACnE,eAoCF,CAAC"}

package/dist/nest/kafka.explorer.d.ts

@@ -0,0 +1,17 @@
+import { OnModuleInit } from "@nestjs/common";
+import { DiscoveryService, ModuleRef } from "@nestjs/core";
+/** Discovers `@SubscribeTo()` decorators and wires them to their Kafka clients on startup. */
+export declare class KafkaExplorer implements OnModuleInit {
+    private readonly discoveryService;
+    private readonly moduleRef;
+    private readonly logger;
+    constructor(discoveryService: DiscoveryService, moduleRef: ModuleRef);
+    /**
+     * Scan all NestJS providers for `@SubscribeTo()` metadata and wire each decorated
+     * method to its Kafka client via `startConsumer` or `startBatchConsumer`.
+     *
+     * Called automatically by the NestJS lifecycle — do not invoke manually.
+     */
+    onModuleInit(): Promise<void>;
+}
+//# sourceMappingURL=kafka.explorer.d.ts.map

package/dist/nest/kafka.explorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kafka.explorer.d.ts","sourceRoot":"","sources":["../../src/nest/kafka.explorer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAU,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAuB3D,8FAA8F;AAC9F,qBACa,aAAc,YAAW,YAAY;IAK9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IAEjC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;gBAItC,gBAAgB,EAAE,gBAAgB,EAElC,SAAS,EAAE,SAAS;IAGvC;;;;;OAKG;IACG,YAAY;CAoEnB"}

package/dist/nest/kafka.health.d.ts

@@ -0,0 +1,7 @@
+import type { IKafkaClient, KafkaHealthResult, TopicMapConstraint } from "../client/types";
+export type { KafkaHealthResult } from "../client/types";
+/** Health check service. Call `check(client)` to verify broker connectivity. */
+export declare class KafkaHealthIndicator {
+    check<T extends TopicMapConstraint<T>>(client: IKafkaClient<T>): Promise<KafkaHealthResult>;
+}
+//# sourceMappingURL=kafka.health.d.ts.map

package/dist/nest/kafka.health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kafka.health.d.ts","sourceRoot":"","sources":["../../src/nest/kafka.health.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,gFAAgF;AAChF,qBACa,oBAAoB;IACzB,KAAK,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EACzC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,GACtB,OAAO,CAAC,iBAAiB,CAAC;CAG9B"}

package/dist/nest/kafka.module.d.ts

@@ -0,0 +1,61 @@
+import { DynamicModule } from "@nestjs/common";
+import { ClientId, GroupId, TopicMapConstraint, KafkaInstrumentation, KafkaClientOptions } from "../client/kafka.client";
+/** Shared configuration fields for both `register()` and `registerAsync()`. */
+interface KafkaModuleBaseOptions {
+    /** Optional name for multi-client setups. Must match `@InjectKafkaClient(name)`. */
+    name?: string;
+    /** If true, makes KAFKA_CLIENT available globally without importing KafkaModule in every feature module. */
+    isGlobal?: boolean;
+}
+/** Synchronous configuration for `KafkaModule.register()`. */
+export interface KafkaModuleOptions extends KafkaModuleBaseOptions {
+    /** Unique Kafka client identifier. */
+    clientId: ClientId;
+    /** Consumer group identifier. */
+    groupId: GroupId;
+    /** List of Kafka broker addresses. */
+    brokers: string[];
+    /** Auto-create topics via admin on first use (send/consume). Useful for development. */
+    autoCreateTopics?: boolean;
+    /** When `true`, string topic keys are validated against any schema previously registered via a TopicDescriptor. Default: `true`. */
+    strictSchemas?: boolean;
+    /** Number of partitions for auto-created topics. Default: `1`. */
+    numPartitions?: number;
+    /** Client-wide instrumentation hooks (e.g. OTel). Applied to both send and consume paths. */
+    instrumentation?: KafkaInstrumentation[];
+    /** Called when a message is dropped without being sent to a DLQ. @see `KafkaClientOptions.onMessageLost` */
+    onMessageLost?: KafkaClientOptions["onMessageLost"];
+    /** Called whenever a consumer group rebalance occurs. @see `KafkaClientOptions.onRebalance` */
+    onRebalance?: KafkaClientOptions["onRebalance"];
+    /** Transactional producer ID — must be unique per process/replica. @see `KafkaClientOptions.transactionalId` */
+    transactionalId?: KafkaClientOptions["transactionalId"];
+    /** Recover the Lamport clock from these topics on startup. @see `KafkaClientOptions.clockRecovery` */
+    clockRecovery?: KafkaClientOptions["clockRecovery"];
+    /** Delay producer sends when consumer lag exceeds a threshold. @see `KafkaClientOptions.lagThrottle` */
+    lagThrottle?: KafkaClientOptions["lagThrottle"];
+    /** Client-wide TTL expiry callback. @see `KafkaClientOptions.onTtlExpired` */
+    onTtlExpired?: KafkaClientOptions["onTtlExpired"];
+    /** Custom transport implementation (e.g. `FakeTransport` in tests). @see `KafkaClientOptions.transport` */
+    transport?: KafkaClientOptions["transport"];
+    /** Transport security (TLS + SASL, incl. MSK IAM / GCP OAUTHBEARER). @see `KafkaClientOptions.security` */
+    security?: KafkaClientOptions["security"];
+}
+/** Async configuration for `KafkaModule.registerAsync()` with dependency injection. */
+export interface KafkaModuleAsyncOptions extends KafkaModuleBaseOptions {
+    imports?: any[];
+    useFactory: (...args: any[]) => KafkaModuleOptions | Promise<KafkaModuleOptions>;
+    inject?: any[];
+}
+/**
+ * NestJS dynamic module for registering type-safe Kafka clients.
+ * Use `register()` for static config or `registerAsync()` for DI-based config.
+ */
+export declare class KafkaModule {
+    /** Register a Kafka client with static options. */
+    static register<T extends TopicMapConstraint<T>>(options: KafkaModuleOptions): DynamicModule;
+    /** Register a Kafka client with async/factory-based options. */
+    static registerAsync<T extends TopicMapConstraint<T>>(asyncOptions: KafkaModuleAsyncOptions): DynamicModule;
+    private static buildClient;
+}
+export {};
+//# sourceMappingURL=kafka.module.d.ts.map

package/dist/nest/kafka.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kafka.module.d.ts","sourceRoot":"","sources":["../../src/nest/kafka.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,aAAa,EAAoB,MAAM,gBAAgB,CAAC;AAEzE,OAAO,EAEL,QAAQ,EACR,OAAO,EACP,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAIhC,+EAA+E;AAC/E,UAAU,sBAAsB;IAC9B,oFAAoF;IACpF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4GAA4G;IAC5G,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,8DAA8D;AAC9D,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB;IAChE,sCAAsC;IACtC,QAAQ,EAAE,QAAQ,CAAC;IACnB,iCAAiC;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wFAAwF;IACxF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oIAAoI;IACpI,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6FAA6F;IAC7F,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACzC,4GAA4G;IAC5G,aAAa,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACpD,+FAA+F;IAC/F,WAAW,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAChD,gHAAgH;IAChH,eAAe,CAAC,EAAE,kBAAkB,CAAC,iBAAiB,CAAC,CAAC;IACxD,sGAAsG;IACtG,aAAa,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACpD,wGAAwG;IACxG,WAAW,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAChD,8EAA8E;IAC9E,YAAY,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAClD,2GAA2G;IAC3G,SAAS,CAAC,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC5C,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED,uFAAuF;AACvF,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;IACrE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC;IAChB,UAAU,EAAE,CACV,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;CAChB;AAED;;;GAGG;AACH,qBACa,WAAW;IACtB,mDAAmD;IACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAC7C,OAAO,EAAE,kBAAkB,GAC1B,aAAa;IAiBhB,gEAAgE;IAChE,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAClD,YAAY,EAAE,uBAAuB,GACpC,aAAa;mBAmBK,WAAW;CA0BjC"}

package/dist/otel.d.ts

@@ -1,5 +1,7 @@
-import { K as KafkaInstrumentation } from './consumer.types-fFCag3VJ.js';
-
+import type { Meter } from "@opentelemetry/api";
+import type { KafkaInstrumentation } from "./client/types";
+import type { IKafkaAdmin } from "./client/types/admin.interface";
+import type { TopicMapConstraint } from "./client/types/common";
 /**
  * Create a `KafkaInstrumentation` that automatically propagates
  * W3C Trace Context via Kafka headers.
@@ -22,6 +24,82 @@ import { K as KafkaInstrumentation } from './consumer.types-fFCag3VJ.js';
  * });
  * ```
  */
-declare function otelInstrumentation(): KafkaInstrumentation;
-
-export { otelInstrumentation };
+export declare function otelInstrumentation(): KafkaInstrumentation;
+/**
+ * Create a `KafkaInstrumentation` that records OpenTelemetry **metrics** for
+ * both the send and consume paths.
+ *
+ * Requires `@opentelemetry/api` as a peer dependency. Instruments are created
+ * once per instrumentation instance (not per message), so a single call to this
+ * factory registers all counters/histograms exactly once.
+ *
+ * Recorded instruments (all under meter `@drarzter/kafka-client`):
+ *
+ * | Instrument | Type | Attributes | Recorded in |
+ * |---|---|---|---|
+ * | `kafka.client.messages.sent` | Counter | `topic` | `afterSend` |
+ * | `kafka.client.messages.processed` | Counter | `topic` | `onMessage` |
+ * | `kafka.client.messages.retried` | Counter | `topic` | `onRetry` |
+ * | `kafka.client.messages.dlq` | Counter | `topic`, `reason` | `onDlq` |
+ * | `kafka.client.messages.duplicate` | Counter | `topic`, `strategy` | `onDuplicate` |
+ * | `kafka.client.consume.errors` | Counter | `topic` | `onConsumeError` |
+ * | `kafka.client.consume.duration` | Histogram (ms) | `topic` | `beforeConsume` → `cleanup()` |
+ *
+ * Composes with `otelInstrumentation()` (traces): list both in
+ * `instrumentation`. They share nothing and can be added in any order.
+ *
+ * @param options.meter - Override the meter used to create instruments.
+ *   Defaults to `metrics.getMeter("@drarzter/kafka-client")`.
+ *
+ * @example
+ * ```ts
+ * import {
+ *   otelInstrumentation,
+ *   otelMetricsInstrumentation,
+ * } from '@drarzter/kafka-client/otel';
+ *
+ * const kafka = new KafkaClient('my-app', 'my-group', brokers, {
+ *   instrumentation: [otelInstrumentation(), otelMetricsInstrumentation()],
+ * });
+ * ```
+ */
+export declare function otelMetricsInstrumentation(options?: {
+    meter?: Meter;
+}): KafkaInstrumentation;
+/**
+ * Register an OpenTelemetry **ObservableGauge** `kafka.client.consumer.lag`
+ * that reports per-partition consumer lag by polling `kafka.getConsumerLag()`
+ * on each metric collection cycle.
+ *
+ * Requires `@opentelemetry/api` as a peer dependency. Accepts any object
+ * implementing the `IKafkaAdmin` sub-interface (i.e. any `KafkaClient`).
+ *
+ * The async callback swallows errors silently — a broker query failure during
+ * a collection cycle simply reports no lag samples for that cycle rather than
+ * throwing inside the OTel metric reader.
+ *
+ * Gauge attributes: `topic`, `partition`, and `groupId` (empty string when the
+ * client's default group is used).
+ *
+ * @param kafka - The client (or any `IKafkaAdmin`) to poll for lag.
+ * @param options.meter - Override the meter. Defaults to
+ *   `metrics.getMeter("@drarzter/kafka-client")`.
+ * @param options.groupId - Consumer group to query. Defaults to the client's
+ *   constructor group.
+ * @returns An unregister function that removes the observable callback. Call it
+ *   on shutdown to stop observing.
+ *
+ * @example
+ * ```ts
+ * import { otelLagGauge } from '@drarzter/kafka-client/otel';
+ *
+ * const unregister = otelLagGauge(kafka, { groupId: 'billing-service' });
+ * // ...later, on shutdown:
+ * unregister();
+ * ```
+ */
+export declare function otelLagGauge<T extends TopicMapConstraint<T>>(kafka: IKafkaAdmin<T>, options?: {
+    meter?: Meter;
+    groupId?: string;
+}): () => void;
+//# sourceMappingURL=otel.d.ts.map

package/dist/otel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.d.ts","sourceRoot":"","sources":["../src/otel.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,KAAK,EAAoB,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAuB,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGhE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,IAAI,oBAAoB,CA0D1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,GAAG,oBAAoB,CA4EvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAC1D,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,MAAM,IAAI,CA4BZ"}

package/dist/otel.js

@@ -20,13 +20,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/otel.ts
 var otel_exports = {};
 __export(otel_exports, {
-  otelInstrumentation: () => otelInstrumentation
+  otelInstrumentation: () => otelInstrumentation,
+  otelLagGauge: () => otelLagGauge,
+  otelMetricsInstrumentation: () => otelMetricsInstrumentation
 });
 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();
+  const activeSpans = /* @__PURE__ */ new WeakMap();
   return {
     beforeSend(_topic, headers) {
       import_api.propagation.inject(import_api.context.active(), headers);
@@ -50,11 +52,11 @@ function otelInstrumentation() {
         parentCtx
       );
       const spanCtx = import_api.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 import_api.context.with(spanCtx, fn);
@@ -62,7 +64,7 @@ function otelInstrumentation() {
       };
     },
     onConsumeError(envelope, error) {
-      const span = activeSpans.get(envelope.eventId);
+      const span = activeSpans.get(envelope);
       if (span) {
         span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: error.message });
         span.recordException(error);
@@ -70,8 +72,100 @@ function otelInstrumentation() {
     }
   };
 }
+function otelMetricsInstrumentation(options) {
+  const meter = options?.meter ?? import_api.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 ?? import_api.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);
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  otelInstrumentation
+  otelInstrumentation,
+  otelLagGauge,
+  otelMetricsInstrumentation
 });
 //# sourceMappingURL=otel.js.map