@drarzter/kafka-client 0.9.3 → 0.10.0

package/dist/core.mjs

@@ -1,38 +1,74 @@
 import {
   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,
+  SchemaRegistryClient,
+  awsMskIamProvider,
   buildEnvelopeHeaders,
+  consumerOptionsFromEnv,
   decodeHeaders,
+  describeRequiredAcls,
   extractEnvelope,
+  gcpAccessTokenProvider,
   getEnvelopeContext,
+  kafkaClientConfigFromEnv,
+  mergeConsumerOptions,
+  registrySchema,
+  resolveSecurityOptions,
   runWithEnvelopeContext,
-  topic
-} from "./chunk-TPIP5VV7.mjs";
+  startOutboxRelay,
+  toError,
+  toKafkaAclCommands,
+  toMskIamPolicy,
+  topic,
+  versionedSchema
+} from "./chunk-CMO7SMVK.mjs";
 import "./chunk-EQQGB2QZ.mjs";
 export {
   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,
+  SchemaRegistryClient,
+  awsMskIamProvider,
   buildEnvelopeHeaders,
+  consumerOptionsFromEnv,
   decodeHeaders,
+  describeRequiredAcls,
   extractEnvelope,
+  gcpAccessTokenProvider,
   getEnvelopeContext,
+  kafkaClientConfigFromEnv,
+  mergeConsumerOptions,
+  registrySchema,
+  resolveSecurityOptions,
   runWithEnvelopeContext,
-  topic
+  startOutboxRelay,
+  toError,
+  toKafkaAclCommands,
+  toMskIamPolicy,
+  topic,
+  versionedSchema
 };
 //# sourceMappingURL=core.mjs.map

package/dist/index.d.ts

@@ -1,128 +1,7 @@
-import { KafkaClientOptions } from './core.js';
-export { KafkaClient, KafkaProcessingError, KafkaRetryExhaustedError, KafkaValidationError } from './core.js';
-import { T as TopicMapConstraint, C as ClientId, G as GroupId, K as KafkaInstrumentation, S as SchemaLike, a as ConsumerOptions, b as TopicDescriptor } from './consumer.types-fFCag3VJ.js';
-export { B as BatchMessageItem, c as BatchMeta, d as BatchSendOptions, e as BeforeConsumeResult, f as CircuitBreakerOptions, g as CompressionType, h as ConsumerHandle, i as ConsumerInterceptor, D as DeduplicationOptions, j as DlqReason, E as EnvelopeHeaderOptions, k as EventEnvelope, H as HEADER_CORRELATION_ID, l as HEADER_EVENT_ID, m as HEADER_LAMPORT_CLOCK, n as HEADER_SCHEMA_VERSION, o as HEADER_TIMESTAMP, p as HEADER_TRACEPARENT, I as InferSchema, q as KafkaLogger, r as KafkaMetrics, M as MessageHeaders, s as MessageLostContext, R as RetryOptions, t as RoutingOptions, u as SchemaParseContext, v as SendOptions, w as SubscribeRetryOptions, x as TTopicMessageMap, y as TopicsFrom, z as TransactionContext, A as TransactionalHandlerContext, F as TtlExpiredContext, W as WindowConsumerOptions, J as WindowMeta, L as buildEnvelopeHeaders, N as decodeHeaders, O as extractEnvelope, P as getEnvelopeContext, Q as runWithEnvelopeContext, U as topic } from './consumer.types-fFCag3VJ.js';
-import { DynamicModule, OnModuleInit } from '@nestjs/common';
-import { DiscoveryService, ModuleRef } from '@nestjs/core';
-import { I as IKafkaClient, r as KafkaHealthResult } from './client-CBBUDDtu.js';
-export { C as CheckpointEntry, s as CheckpointRestoreResult, t as CheckpointResult, u as ConsumerGroupSummary, D as DlqReplayOptions, v as IKafkaAdmin, w as IKafkaConsumer, x as IKafkaLifecycle, y as IKafkaProducer, R as ReadSnapshotOptions, z as RestoreCheckpointOptions, T as TopicDescription, A as TopicPartitionInfo } from './client-CBBUDDtu.js';
-
-/** 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()`. */
-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"];
-}
-/** Async configuration for `KafkaModule.registerAsync()` with dependency injection. */
-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.
- */
-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;
-}
-
-/** Default DI token for the Kafka client. */
-declare const KAFKA_CLIENT = "KAFKA_CLIENT";
-/** Returns the DI token for a named (or default) Kafka client instance. */
-declare const getKafkaClientToken: (name?: string) => string;
-
-/** Reflect metadata key used to store `@SubscribeTo` entries on a class constructor. */
-declare const KAFKA_SUBSCRIBER_METADATA = "KAFKA_SUBSCRIBER_METADATA";
-/** Internal shape stored per `@SubscribeTo()` decoration on a class. */
-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. */
-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) { ... }
- * ```
- */
-declare const SubscribeTo: (topics: string | string[] | TopicDescriptor | TopicDescriptor[] | (string | TopicDescriptor)[], options?: ConsumerOptions & {
-    clientName?: string;
-    batch?: boolean;
-}) => MethodDecorator;
-
-/** Discovers `@SubscribeTo()` decorators and wires them to their Kafka clients on startup. */
-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>;
-}
-
-/** Health check service. Call `check(client)` to verify broker connectivity. */
-declare class KafkaHealthIndicator {
-    check<T extends TopicMapConstraint<T>>(client: IKafkaClient<T>): Promise<KafkaHealthResult>;
-}
-
-export { ClientId, ConsumerOptions, GroupId, IKafkaClient, InjectKafkaClient, KAFKA_CLIENT, KAFKA_SUBSCRIBER_METADATA, KafkaClientOptions, KafkaExplorer, KafkaHealthIndicator, KafkaHealthResult, KafkaInstrumentation, KafkaModule, type KafkaModuleAsyncOptions, type KafkaModuleOptions, type KafkaSubscriberMetadata, SchemaLike, SubscribeTo, TopicDescriptor, TopicMapConstraint, getKafkaClientToken };
+export * from "./core";
+export * from "./nest/kafka.module";
+export * from "./nest/kafka.constants";
+export * from "./nest/kafka.decorator";
+export * from "./nest/kafka.explorer";
+export * from "./nest/kafka.health";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC"}