tiryaq-shared 1.2.30 → 1.3.2

package/dist/kafka/dlq-handler.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Dead Letter Queue Handler
+ *
+ * Handles messages that fail processing after all retry attempts.
+ * Sends failed messages to a service-specific DLQ topic with complete error context.
+ *
+ * Features:
+ * - Service-specific DLQ topics ({service-name}-dlq)
+ * - Preserves original message payload and metadata
+ * - Includes error details and retry count
+ * - Maintains message ordering within partitions
+ * - Structured logging for all DLQ operations
+ *
+ * Note: This implementation requires kafkajs to be installed in the consuming service.
+ * Install with: npm install kafkajs
+ */
+import { Logger } from '@nestjs/common';
+import { KafkaClientConfig } from './types';
+/**
+ * Context information for DLQ operations
+ */
+export interface DLQContext {
+    topic: string;
+    partition: number;
+    offset: string;
+    retryCount: number;
+}
+/**
+ * DeadLetterQueueHandler class manages failed message handling
+ *
+ * Provides methods to send failed messages to DLQ topics with complete
+ * error context and metadata preservation.
+ *
+ * Requires kafkajs to be installed in the consuming service.
+ */
+export declare class DeadLetterQueueHandler {
+    private logger;
+    private kafkaLogger;
+    private producer;
+    private serviceName;
+    private kafkaConfig;
+    private kafka;
+    private isConnected;
+    private KafkaClass;
+    /**
+     * Create a new DeadLetterQueueHandler instance
+     *
+     * @param serviceName - Name of the service (used for DLQ topic naming)
+     * @param kafkaConfig - Kafka client configuration
+     * @param logger - Optional NestJS Logger instance
+     */
+    constructor(serviceName: string, kafkaConfig: KafkaClientConfig, logger?: Logger);
+    /**
+     * Initialize DLQ producer and connect to Kafka
+     *
+     * Creates a Kafka producer instance with the provided configuration
+     * and establishes connection to the Kafka cluster.
+     *
+     * @throws Error if connection fails or kafkajs is not installed
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect DLQ producer and cleanup resources
+     *
+     * Gracefully disconnects the producer and releases resources.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Send message to dead letter queue
+     *
+     * Creates a DLQ message with complete error context and sends it to the
+     * service-specific DLQ topic. Preserves message ordering within partitions.
+     *
+     * @param originalMessage - The original message payload that failed processing
+     * @param error - The error that caused the failure
+     * @param context - Context information (topic, partition, offset, retry count)
+     * @throws Error if producer is not connected or send fails
+     */
+    sendToDLQ(originalMessage: any, error: Error, context: DLQContext): Promise<void>;
+    /**
+     * Get DLQ topic name for service
+     *
+     * Returns the DLQ topic name following the naming convention:
+     * {service-name}-dlq
+     *
+     * @returns DLQ topic name
+     */
+    getDLQTopicName(): string;
+    /**
+     * Check if DLQ handler is connected
+     *
+     * @returns True if connected, false otherwise
+     */
+    isConnectedToBroker(): boolean;
+    /**
+     * Get service name
+     *
+     * @returns Service name used by this handler
+     */
+    getServiceName(): string;
+}
+//# sourceMappingURL=dlq-handler.d.ts.map

package/dist/kafka/dlq-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq-handler.d.ts","sourceRoot":"","sources":["../../src/kafka/dlq-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAc,MAAM,SAAS,CAAC;AAqDxD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,UAAU,CAAmC;IAErD;;;;;;OAMG;gBAED,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,iBAAiB,EAC9B,MAAM,CAAC,EAAE,MAAM;IA4BjB;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgD9B;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBjC;;;;;;;;;;OAUG;IACG,SAAS,CACb,eAAe,EAAE,GAAG,EACpB,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC;IA4DhB;;;;;;;OAOG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;OAIG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;;;OAIG;IACH,cAAc,IAAI,MAAM;CAGzB"}

package/dist/kafka/dlq-handler.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * Dead Letter Queue Handler
+ *
+ * Handles messages that fail processing after all retry attempts.
+ * Sends failed messages to a service-specific DLQ topic with complete error context.
+ *
+ * Features:
+ * - Service-specific DLQ topics ({service-name}-dlq)
+ * - Preserves original message payload and metadata
+ * - Includes error details and retry count
+ * - Maintains message ordering within partitions
+ * - Structured logging for all DLQ operations
+ *
+ * Note: This implementation requires kafkajs to be installed in the consuming service.
+ * Install with: npm install kafkajs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeadLetterQueueHandler = void 0;
+const common_1 = require("@nestjs/common");
+const kafka_logger_1 = require("./kafka-logger");
+/**
+ * DeadLetterQueueHandler class manages failed message handling
+ *
+ * Provides methods to send failed messages to DLQ topics with complete
+ * error context and metadata preservation.
+ *
+ * Requires kafkajs to be installed in the consuming service.
+ */
+class DeadLetterQueueHandler {
+    /**
+     * Create a new DeadLetterQueueHandler instance
+     *
+     * @param serviceName - Name of the service (used for DLQ topic naming)
+     * @param kafkaConfig - Kafka client configuration
+     * @param logger - Optional NestJS Logger instance
+     */
+    constructor(serviceName, kafkaConfig, logger) {
+        this.producer = null;
+        this.kafka = null;
+        this.isConnected = false;
+        this.KafkaClass = null;
+        if (!serviceName || serviceName.trim() === '') {
+            throw new Error('serviceName is required and cannot be empty');
+        }
+        if (!kafkaConfig) {
+            throw new Error('kafkaConfig is required');
+        }
+        this.serviceName = serviceName.trim();
+        this.kafkaConfig = kafkaConfig;
+        this.logger = logger || new common_1.Logger('DeadLetterQueueHandler');
+        this.kafkaLogger = new kafka_logger_1.KafkaLogger(serviceName, this.logger);
+        // Dynamically load kafkajs if available
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-var-requires
+            const kafkajs = require('kafkajs');
+            this.KafkaClass = kafkajs.Kafka;
+        }
+        catch (error) {
+            this.logger.warn('kafkajs not found. DLQ handler will not be functional. ' +
+                'Install kafkajs with: npm install kafkajs');
+        }
+    }
+    /**
+     * Initialize DLQ producer and connect to Kafka
+     *
+     * Creates a Kafka producer instance with the provided configuration
+     * and establishes connection to the Kafka cluster.
+     *
+     * @throws Error if connection fails or kafkajs is not installed
+     */
+    async connect() {
+        if (this.isConnected && this.producer) {
+            this.logger.warn('DLQ handler already connected');
+            return;
+        }
+        if (!this.KafkaClass) {
+            throw new Error('kafkajs is not installed. Install it with: npm install kafkajs');
+        }
+        try {
+            this.logger.log(`Connecting DLQ handler for service: ${this.serviceName}`);
+            // Create Kafka instance
+            this.kafka = new this.KafkaClass({
+                clientId: `${this.kafkaConfig.clientId}-dlq`,
+                brokers: this.kafkaConfig.brokers,
+                ssl: this.kafkaConfig.ssl,
+                sasl: this.kafkaConfig.sasl,
+                connectionTimeout: this.kafkaConfig.connectionTimeout,
+                requestTimeout: this.kafkaConfig.requestTimeout,
+                retry: this.kafkaConfig.retry
+            });
+            // Create producer
+            this.producer = this.kafka.producer({
+                allowAutoTopicCreation: true,
+                transactionTimeout: 30000,
+                retry: this.kafkaConfig.retry
+            });
+            // Connect producer
+            await this.producer.connect();
+            this.isConnected = true;
+            this.logger.log(`DLQ handler connected successfully for service: ${this.serviceName}`);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to connect DLQ handler: ${errorMessage}`, error instanceof Error ? error.stack : undefined);
+            throw new Error(`DLQ handler connection failed: ${errorMessage}`);
+        }
+    }
+    /**
+     * Disconnect DLQ producer and cleanup resources
+     *
+     * Gracefully disconnects the producer and releases resources.
+     */
+    async disconnect() {
+        if (!this.isConnected || !this.producer) {
+            this.logger.warn('DLQ handler not connected, skipping disconnect');
+            return;
+        }
+        try {
+            this.logger.log(`Disconnecting DLQ handler for service: ${this.serviceName}`);
+            await this.producer.disconnect();
+            this.producer = null;
+            this.kafka = null;
+            this.isConnected = false;
+            this.logger.log(`DLQ handler disconnected successfully`);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Error disconnecting DLQ handler: ${errorMessage}`, error instanceof Error ? error.stack : undefined);
+            throw new Error(`DLQ handler disconnect failed: ${errorMessage}`);
+        }
+    }
+    /**
+     * Send message to dead letter queue
+     *
+     * Creates a DLQ message with complete error context and sends it to the
+     * service-specific DLQ topic. Preserves message ordering within partitions.
+     *
+     * @param originalMessage - The original message payload that failed processing
+     * @param error - The error that caused the failure
+     * @param context - Context information (topic, partition, offset, retry count)
+     * @throws Error if producer is not connected or send fails
+     */
+    async sendToDLQ(originalMessage, error, context) {
+        if (!this.isConnected || !this.producer) {
+            throw new Error('DLQ handler is not connected. Call connect() before sending messages.');
+        }
+        try {
+            // Build DLQ message with complete context
+            const dlqMessage = {
+                originalTopic: context.topic,
+                originalPartition: context.partition,
+                originalOffset: context.offset,
+                payload: originalMessage,
+                error: {
+                    message: error.message,
+                    stack: error.stack,
+                    code: error.code || 'UNKNOWN_ERROR'
+                },
+                retryCount: context.retryCount,
+                timestamp: new Date(),
+                serviceName: this.serviceName
+            };
+            // Get DLQ topic name
+            const dlqTopic = this.getDLQTopicName();
+            // Prepare producer record
+            const producerRecord = {
+                topic: dlqTopic,
+                messages: [
+                    {
+                        key: `${context.topic}-${context.partition}-${context.offset}`,
+                        value: JSON.stringify(dlqMessage),
+                        partition: context.partition, // Preserve partition for ordering
+                        timestamp: dlqMessage.timestamp.getTime().toString()
+                    }
+                ]
+            };
+            // Send to DLQ
+            await this.producer.send(producerRecord);
+            // Log DLQ event
+            this.kafkaLogger.logDLQEvent(dlqMessage);
+            this.logger.log(`Message sent to DLQ: ${dlqTopic} ` +
+                `(original: ${context.topic}, partition: ${context.partition}, offset: ${context.offset})`);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Failed to send message to DLQ: ${errorMessage}`, error instanceof Error ? error.stack : undefined);
+            throw new Error(`DLQ send failed: ${errorMessage}`);
+        }
+    }
+    /**
+     * Get DLQ topic name for service
+     *
+     * Returns the DLQ topic name following the naming convention:
+     * {service-name}-dlq
+     *
+     * @returns DLQ topic name
+     */
+    getDLQTopicName() {
+        return `${this.serviceName}-dlq`;
+    }
+    /**
+     * Check if DLQ handler is connected
+     *
+     * @returns True if connected, false otherwise
+     */
+    isConnectedToBroker() {
+        return this.isConnected;
+    }
+    /**
+     * Get service name
+     *
+     * @returns Service name used by this handler
+     */
+    getServiceName() {
+        return this.serviceName;
+    }
+}
+exports.DeadLetterQueueHandler = DeadLetterQueueHandler;
+//# sourceMappingURL=dlq-handler.js.map

package/dist/kafka/dlq-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq-handler.js","sourceRoot":"","sources":["../../src/kafka/dlq-handler.ts"],"names":[],"mappings":"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"}

package/dist/kafka/health-check.provider.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Kafka Health Check Provider
+ *
+ * Provides health check functionality for Kafka connections.
+ * Verifies connection status and broker availability with timeout protection.
+ *
+ * Used by NestJS health check endpoints to monitor Kafka connectivity.
+ */
+import { Logger } from '@nestjs/common';
+import { ClientKafka } from '@nestjs/microservices';
+import { KafkaHealthStatus } from './types';
+/**
+ * Health check provider options
+ */
+export interface KafkaHealthCheckOptions {
+    timeout?: number;
+    logger?: Logger;
+}
+/**
+ * KafkaHealthCheckProvider class for monitoring Kafka connection health
+ */
+export declare class KafkaHealthCheckProvider {
+    private client;
+    private logger;
+    private checkTimeout;
+    private connectedAt?;
+    constructor(client: ClientKafka, options?: KafkaHealthCheckOptions);
+    /**
+     * Check if Kafka connection is healthy
+     *
+     * Performs a quick health check by attempting to fetch broker metadata.
+     * Returns true if connection is healthy, false otherwise.
+     *
+     * @returns Promise<boolean> - true if healthy, false if unhealthy
+     */
+    isHealthy(): Promise<boolean>;
+    /**
+     * Get detailed health status
+     *
+     * Fetches comprehensive health information including:
+     * - Connection status (up/down)
+     * - Broker list and count
+     * - Connection timestamp
+     * - Error details if unhealthy
+     * - Last check timestamp
+     *
+     * @returns Promise<KafkaHealthStatus> - Detailed health status object
+     */
+    getHealthStatus(): Promise<KafkaHealthStatus>;
+    /**
+     * Fetch broker metadata with timeout protection
+     *
+     * Attempts to fetch broker metadata from the Kafka client.
+     * Implements timeout to prevent blocking health check endpoints.
+     *
+     * @returns Promise<any> - Broker metadata object
+     * @throws Error if timeout is exceeded or metadata fetch fails
+     * @private
+     */
+    private fetchBrokerMetadata;
+    /**
+     * Set the connected timestamp
+     *
+     * Allows external code to set the connection timestamp when the client
+     * successfully connects. This is useful for tracking connection uptime.
+     *
+     * @param timestamp - Connection timestamp
+     */
+    setConnectedAt(timestamp: Date): void;
+    /**
+     * Reset the connected timestamp
+     *
+     * Clears the connection timestamp, typically called when the client
+     * disconnects or connection is lost.
+     */
+    resetConnectedAt(): void;
+}
+//# sourceMappingURL=health-check.provider.d.ts.map

package/dist/kafka/health-check.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.provider.d.ts","sourceRoot":"","sources":["../../src/kafka/health-check.provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAOD;;GAEG;AACH,qBAAa,wBAAwB;IAMjC,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAO;gBAGjB,MAAM,EAAE,WAAW,EAC3B,OAAO,CAAC,EAAE,uBAAuB;IAMnC;;;;;;;OAOG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAUnC;;;;;;;;;;;OAWG;IACG,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAuDnD;;;;;;;;;OASG;YACW,mBAAmB;IA4CjC;;;;;;;OAOG;IACH,cAAc,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI;IAIrC;;;;;OAKG;IACH,gBAAgB,IAAI,IAAI;CAGzB"}

package/dist/kafka/health-check.provider.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Kafka Health Check Provider
+ *
+ * Provides health check functionality for Kafka connections.
+ * Verifies connection status and broker availability with timeout protection.
+ *
+ * Used by NestJS health check endpoints to monitor Kafka connectivity.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KafkaHealthCheckProvider = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Default health check timeout (5 seconds)
+ */
+const DEFAULT_HEALTH_CHECK_TIMEOUT = 5000;
+/**
+ * KafkaHealthCheckProvider class for monitoring Kafka connection health
+ */
+class KafkaHealthCheckProvider {
+    constructor(client, options) {
+        this.client = client;
+        this.logger = options?.logger || new common_1.Logger('KafkaHealthCheckProvider');
+        this.checkTimeout = options?.timeout || DEFAULT_HEALTH_CHECK_TIMEOUT;
+    }
+    /**
+     * Check if Kafka connection is healthy
+     *
+     * Performs a quick health check by attempting to fetch broker metadata.
+     * Returns true if connection is healthy, false otherwise.
+     *
+     * @returns Promise<boolean> - true if healthy, false if unhealthy
+     */
+    async isHealthy() {
+        try {
+            const status = await this.getHealthStatus();
+            return status.status === 'up';
+        }
+        catch (error) {
+            this.logger.error('Health check failed with exception', error);
+            return false;
+        }
+    }
+    /**
+     * Get detailed health status
+     *
+     * Fetches comprehensive health information including:
+     * - Connection status (up/down)
+     * - Broker list and count
+     * - Connection timestamp
+     * - Error details if unhealthy
+     * - Last check timestamp
+     *
+     * @returns Promise<KafkaHealthStatus> - Detailed health status object
+     */
+    async getHealthStatus() {
+        const lastChecked = new Date();
+        try {
+            // Attempt to fetch broker metadata with timeout
+            const metadata = await this.fetchBrokerMetadata();
+            // If we successfully fetched metadata, connection is healthy
+            if (metadata && metadata.brokers && metadata.brokers.length > 0) {
+                // Set connectedAt timestamp if not already set
+                if (!this.connectedAt) {
+                    this.connectedAt = new Date();
+                }
+                const brokers = metadata.brokers.map((broker) => `${broker.host}:${broker.port}`);
+                this.logger.log(`Kafka health check passed: ${brokers.length} broker(s) available`);
+                return {
+                    status: 'up',
+                    brokers,
+                    brokerCount: brokers.length,
+                    connectedAt: this.connectedAt,
+                    lastChecked
+                };
+            }
+            // No brokers found
+            this.logger.warn('Kafka health check failed: No brokers available');
+            this.connectedAt = undefined;
+            return {
+                status: 'down',
+                error: 'No brokers available',
+                lastChecked
+            };
+        }
+        catch (error) {
+            // Health check failed
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Kafka health check failed: ${errorMessage}`);
+            this.connectedAt = undefined;
+            return {
+                status: 'down',
+                error: errorMessage,
+                lastChecked
+            };
+        }
+    }
+    /**
+     * Fetch broker metadata with timeout protection
+     *
+     * Attempts to fetch broker metadata from the Kafka client.
+     * Implements timeout to prevent blocking health check endpoints.
+     *
+     * @returns Promise<any> - Broker metadata object
+     * @throws Error if timeout is exceeded or metadata fetch fails
+     * @private
+     */
+    async fetchBrokerMetadata() {
+        return new Promise((resolve, reject) => {
+            // Set timeout to prevent hanging
+            const timeoutId = setTimeout(() => {
+                reject(new Error(`Health check timeout after ${this.checkTimeout}ms`));
+            }, this.checkTimeout);
+            try {
+                // Access the underlying Kafka client
+                // ClientKafka wraps the KafkaJS client, we need to access it
+                const kafkaClient = this.client.client;
+                if (!kafkaClient) {
+                    clearTimeout(timeoutId);
+                    reject(new Error('Kafka client not initialized'));
+                    return;
+                }
+                // Fetch broker metadata using KafkaJS admin client
+                const admin = kafkaClient.admin();
+                admin.connect()
+                    .then(() => admin.fetchTopicMetadata())
+                    .then((metadata) => {
+                    clearTimeout(timeoutId);
+                    admin.disconnect().catch(() => {
+                        // Ignore disconnect errors
+                    });
+                    resolve(metadata);
+                })
+                    .catch((error) => {
+                    clearTimeout(timeoutId);
+                    admin.disconnect().catch(() => {
+                        // Ignore disconnect errors
+                    });
+                    reject(error);
+                });
+            }
+            catch (error) {
+                clearTimeout(timeoutId);
+                reject(error);
+            }
+        });
+    }
+    /**
+     * Set the connected timestamp
+     *
+     * Allows external code to set the connection timestamp when the client
+     * successfully connects. This is useful for tracking connection uptime.
+     *
+     * @param timestamp - Connection timestamp
+     */
+    setConnectedAt(timestamp) {
+        this.connectedAt = timestamp;
+    }
+    /**
+     * Reset the connected timestamp
+     *
+     * Clears the connection timestamp, typically called when the client
+     * disconnects or connection is lost.
+     */
+    resetConnectedAt() {
+        this.connectedAt = undefined;
+    }
+}
+exports.KafkaHealthCheckProvider = KafkaHealthCheckProvider;
+//# sourceMappingURL=health-check.provider.js.map

package/dist/kafka/health-check.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.provider.js","sourceRoot":"","sources":["../../src/kafka/health-check.provider.ts"],"names":[],"mappings":"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"}

package/dist/kafka/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Kafka Utilities Index
+ *
+ * Central export point for all Kafka configuration utilities, types, and classes
+ * used across the Tiryaq microservices platform.
+ */
+export * from './types';
+export { KafkaConfigManager } from './kafka-config.manager';
+export { BrokerParser } from './broker-parser';
+export { KafkaLogger } from './kafka-logger';
+export { KafkaSubscriptionRegistry } from './subscription-registry';
+export { KafkaHealthCheckProvider, KafkaHealthCheckOptions } from './health-check.provider';
+export { CircuitBreakerProvider } from './circuit-breaker.provider';
+export { DeadLetterQueueHandler, DLQContext } from './dlq-handler';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kafka/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/kafka/index.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Kafka Utilities Index
+ *
+ * Central export point for all Kafka configuration utilities, types, and classes
+ * used across the Tiryaq microservices platform.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeadLetterQueueHandler = exports.CircuitBreakerProvider = exports.KafkaHealthCheckProvider = exports.KafkaSubscriptionRegistry = exports.KafkaLogger = exports.BrokerParser = exports.KafkaConfigManager = void 0;
+// Export all types and interfaces
+__exportStar(require("./types"), exports);
+// Export classes (will be implemented in subsequent tasks)
+var kafka_config_manager_1 = require("./kafka-config.manager");
+Object.defineProperty(exports, "KafkaConfigManager", { enumerable: true, get: function () { return kafka_config_manager_1.KafkaConfigManager; } });
+var broker_parser_1 = require("./broker-parser");
+Object.defineProperty(exports, "BrokerParser", { enumerable: true, get: function () { return broker_parser_1.BrokerParser; } });
+var kafka_logger_1 = require("./kafka-logger");
+Object.defineProperty(exports, "KafkaLogger", { enumerable: true, get: function () { return kafka_logger_1.KafkaLogger; } });
+var subscription_registry_1 = require("./subscription-registry");
+Object.defineProperty(exports, "KafkaSubscriptionRegistry", { enumerable: true, get: function () { return subscription_registry_1.KafkaSubscriptionRegistry; } });
+var health_check_provider_1 = require("./health-check.provider");
+Object.defineProperty(exports, "KafkaHealthCheckProvider", { enumerable: true, get: function () { return health_check_provider_1.KafkaHealthCheckProvider; } });
+var circuit_breaker_provider_1 = require("./circuit-breaker.provider");
+Object.defineProperty(exports, "CircuitBreakerProvider", { enumerable: true, get: function () { return circuit_breaker_provider_1.CircuitBreakerProvider; } });
+var dlq_handler_1 = require("./dlq-handler");
+Object.defineProperty(exports, "DeadLetterQueueHandler", { enumerable: true, get: function () { return dlq_handler_1.DeadLetterQueueHandler; } });
+//# sourceMappingURL=index.js.map

package/dist/kafka/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kafka/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;AAEH,kCAAkC;AAClC,0CAAwB;AAExB,2DAA2D;AAC3D,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,iEAAoE;AAA3D,kIAAA,yBAAyB,OAAA;AAClC,iEAA4F;AAAnF,iIAAA,wBAAwB,OAAA;AACjC,uEAAoE;AAA3D,kIAAA,sBAAsB,OAAA;AAC/B,6CAAmE;AAA1D,qHAAA,sBAAsB,OAAA"}