tiryaq-shared 1.2.30 → 1.3.2

package/dist/kafka/kafka-logger.js

@@ -0,0 +1,204 @@
+"use strict";
+/**
+ * Kafka Logger
+ *
+ * Provides structured logging for Kafka operations using NestJS Logger.
+ * Ensures consistent log formatting and credential filtering across all services.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KafkaLogger = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * KafkaLogger class provides structured logging for all Kafka-related operations
+ *
+ * Features:
+ * - Uses NestJS Logger for consistent formatting
+ * - Filters credentials from logs for security
+ * - Provides context-rich log messages
+ * - Supports all Kafka lifecycle events
+ */
+class KafkaLogger {
+    /**
+     * Create a new KafkaLogger instance
+     *
+     * @param serviceName - Name of the service using this logger
+     * @param logger - Optional NestJS Logger instance (creates new one if not provided)
+     */
+    constructor(serviceName, logger) {
+        this.serviceName = serviceName;
+        this.logger = logger || new common_1.Logger('KafkaLogger');
+    }
+    /**
+     * Log Kafka mode detection
+     *
+     * @param mode - Detected Kafka mode (local or msk)
+     */
+    logModeDetection(mode) {
+        this.logger.log(`Kafka mode detected: ${mode.toUpperCase()}`, this.buildContext({ mode }));
+    }
+    /**
+     * Log broker parsing result
+     *
+     * @param brokers - Array of parsed broker addresses
+     */
+    logBrokersParsed(brokers) {
+        this.logger.log(`Kafka brokers parsed: ${brokers.join(', ')}`, this.buildContext({ brokerCount: brokers.length, brokers }));
+    }
+    /**
+     * Log SASL configuration (without credentials)
+     *
+     * @param mechanism - SASL mechanism being used
+     */
+    logSaslConfig(mechanism) {
+        this.logger.log(`SASL configuration loaded with mechanism: ${mechanism}`, this.buildContext({ saslMechanism: mechanism }));
+    }
+    /**
+     * Log connection attempt
+     *
+     * @param clientId - Kafka client identifier
+     */
+    logConnectionAttempt(clientId) {
+        this.logger.log(`Attempting to connect Kafka client: ${clientId}`, this.buildContext({ clientId }));
+    }
+    /**
+     * Log successful connection
+     *
+     * @param clientId - Kafka client identifier
+     * @param brokers - Connected broker addresses
+     */
+    logConnectionSuccess(clientId, brokers) {
+        this.logger.log(`Kafka client connected successfully: ${clientId}`, this.buildContext({ clientId, brokers, brokerCount: brokers.length }));
+    }
+    /**
+     * Log connection failure
+     *
+     * @param clientId - Kafka client identifier
+     * @param error - Error that occurred during connection
+     */
+    logConnectionFailure(clientId, error) {
+        this.logger.error(`Kafka client connection failed: ${clientId} - ${error.message}`, error.stack, this.buildContext({ clientId, errorMessage: error.message }));
+    }
+    /**
+     * Log subscription registration
+     *
+     * @param pattern - Message pattern being subscribed to
+     * @param clientName - Name of the client subscribing
+     */
+    logSubscription(pattern, clientName) {
+        this.logger.log(`Subscribed to pattern: ${pattern} on client: ${clientName}`, this.buildContext({ pattern, clientName }));
+    }
+    /**
+     * Log message send operation
+     *
+     * @param pattern - Message pattern being sent
+     * @param context - Optional additional context
+     */
+    logMessageSend(pattern, context) {
+        this.logger.log(`Sending message with pattern: ${pattern}`, this.buildContext({ pattern, ...context }));
+    }
+    /**
+     * Log message receive operation
+     *
+     * @param pattern - Message pattern received
+     * @param context - Optional additional context
+     */
+    logMessageReceive(pattern, context) {
+        this.logger.log(`Received message with pattern: ${pattern}`, this.buildContext({ pattern, ...context }));
+    }
+    /**
+     * Log message processing error
+     *
+     * @param pattern - Message pattern that failed processing
+     * @param error - Error that occurred
+     * @param context - Optional additional context
+     */
+    logProcessingError(pattern, error, context) {
+        this.logger.error(`Error processing message with pattern: ${pattern} - ${error.message}`, error.stack, this.buildContext({ pattern, errorMessage: error.message, ...context }));
+    }
+    /**
+     * Log dead letter queue event
+     *
+     * @param message - DLQ message being logged
+     */
+    logDLQEvent(message) {
+        this.logger.warn(`Message sent to DLQ: ${message.originalTopic} - ${message.error.message}`, this.buildContext({
+            topic: message.originalTopic,
+            partition: message.originalPartition,
+            offset: message.originalOffset,
+            retryCount: message.retryCount,
+            errorMessage: message.error.message,
+            errorCode: message.error.code
+        }));
+    }
+    /**
+     * Log circuit breaker state change
+     *
+     * @param serviceName - Target service name
+     * @param oldState - Previous circuit state
+     * @param newState - New circuit state
+     * @param stats - Circuit breaker statistics
+     */
+    logCircuitBreakerStateChange(serviceName, oldState, newState, stats) {
+        this.logger.warn(`Circuit breaker state changed for ${serviceName}: ${oldState} -> ${newState}`, this.buildContext({
+            targetService: serviceName,
+            oldState,
+            newState,
+            failures: stats.failures,
+            successes: stats.successes,
+            totalRequests: stats.totalRequests,
+            totalFailures: stats.totalFailures
+        }));
+    }
+    /**
+     * Build log context with service name and additional metadata
+     *
+     * @param metadata - Additional metadata to include in context
+     * @returns Formatted context string
+     */
+    buildContext(metadata) {
+        const context = {
+            serviceName: this.serviceName,
+            ...this.filterCredentials(metadata)
+        };
+        return JSON.stringify(context);
+    }
+    /**
+     * Filter credentials from metadata to prevent logging sensitive information
+     *
+     * @param metadata - Metadata object that may contain credentials
+     * @returns Filtered metadata with credentials removed
+     */
+    filterCredentials(metadata) {
+        const filtered = { ...metadata };
+        // List of keys that should be filtered
+        const credentialKeys = [
+            'password',
+            'saslPassword',
+            'sasl_password',
+            'kafka_sasl_password',
+            'username',
+            'saslUsername',
+            'sasl_username',
+            'kafka_sasl_username',
+            'secret',
+            'token',
+            'apiKey',
+            'api_key'
+        ];
+        // Remove credential keys from metadata
+        credentialKeys.forEach(key => {
+            if (key in filtered) {
+                filtered[key] = '[FILTERED]';
+            }
+        });
+        // Recursively filter nested objects
+        Object.keys(filtered).forEach(key => {
+            if (filtered[key] && typeof filtered[key] === 'object' && !Array.isArray(filtered[key])) {
+                filtered[key] = this.filterCredentials(filtered[key]);
+            }
+        });
+        return filtered;
+    }
+}
+exports.KafkaLogger = KafkaLogger;
+//# sourceMappingURL=kafka-logger.js.map

package/dist/kafka/kafka-logger.js.map

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

package/dist/kafka/subscription-registry.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Kafka Subscription Registry
+ *
+ * Centralized management of Kafka message pattern subscriptions for microservices.
+ * This class provides a structured way to declare and register all Kafka subscriptions
+ * in one place instead of scattering them across controllers.
+ *
+ * Requirements: 3.1, 3.2, 3.3, 3.5
+ */
+import { Logger } from '@nestjs/common';
+import { ClientKafka } from '@nestjs/microservices';
+import { ServiceSubscriptions, SubscriptionConfig } from './types';
+/**
+ * KafkaSubscriptionRegistry manages message pattern subscriptions for a service
+ *
+ * Features:
+ * - Centralized subscription declaration
+ * - Grouped subscriptions by target service
+ * - Ordered registration before client connections
+ * - Structured logging of all subscriptions
+ *
+ * @example
+ * ```typescript
+ * const subscriptions: ServiceSubscriptions = {
+ *   auth: {
+ *     clientName: 'AUTH_SERVICE',
+ *     patterns: [AUTH_PATTERNS.UPDATE_USER, AUTH_PATTERNS.GET_USER],
+ *     description: 'Auth service patterns for user management'
+ *   }
+ * };
+ *
+ * const registry = new KafkaSubscriptionRegistry(subscriptions);
+ * await registry.registerSubscriptions({ authClient });
+ * ```
+ */
+export declare class KafkaSubscriptionRegistry {
+    private logger;
+    private subscriptions;
+    /**
+     * Create a new subscription registry
+     *
+     * @param subscriptions - Service subscriptions grouped by client
+     * @param logger - Optional NestJS logger instance
+     */
+    constructor(subscriptions: ServiceSubscriptions, logger?: Logger);
+    /**
+     * Register all subscriptions for a service
+     *
+     * This method iterates through all configured subscriptions and registers
+     * each pattern with the corresponding Kafka client. Subscriptions are
+     * registered in the order they are declared.
+     *
+     * Requirements: 3.1, 3.3
+     *
+     * @param clients - Record of ClientKafka instances keyed by client name
+     * @returns Promise that resolves when all subscriptions are registered
+     *
+     * @example
+     * ```typescript
+     * await registry.registerSubscriptions({
+     *   authClient: authServiceClient,
+     *   consultationClient: consultationServiceClient
+     * });
+     * ```
+     */
+    registerSubscriptions(clients: Record<string, ClientKafka>): Promise<void>;
+    /**
+     * Register subscriptions for a specific client
+     *
+     * This method registers all patterns for a single Kafka client.
+     * Each pattern is logged for debugging and traceability.
+     *
+     * Requirements: 3.2, 3.3, 3.5
+     *
+     * @param client - ClientKafka instance to register patterns with
+     * @param config - Subscription configuration containing patterns and metadata
+     *
+     * @example
+     * ```typescript
+     * registry.registerClientSubscriptions(authClient, {
+     *   clientName: 'AUTH_SERVICE',
+     *   patterns: [AUTH_PATTERNS.UPDATE_USER],
+     *   description: 'Auth patterns'
+     * });
+     * ```
+     */
+    registerClientSubscriptions(client: ClientKafka, config: SubscriptionConfig): void;
+    /**
+     * Get all registered patterns across all clients
+     *
+     * Requirements: 3.1, 3.2
+     *
+     * @returns Array of all pattern strings
+     *
+     * @example
+     * ```typescript
+     * const allPatterns = registry.getAllPatterns();
+     * // ['auth.update_user', 'auth.get_user', 'consultation.get_documents']
+     * ```
+     */
+    getAllPatterns(): string[];
+    /**
+     * Get patterns registered for a specific client
+     *
+     * Requirements: 3.2
+     *
+     * @param clientName - Name of the client to get patterns for
+     * @returns Array of pattern strings for the specified client
+     *
+     * @example
+     * ```typescript
+     * const authPatterns = registry.getPatternsByClient('AUTH_SERVICE');
+     * // ['auth.update_user', 'auth.get_user']
+     * ```
+     */
+    getPatternsByClient(clientName: string): string[];
+    /**
+     * Find a client by its configured name
+     *
+     * This helper method searches through the clients record to find a client
+     * that matches the configured client name. It handles various naming conventions
+     * (camelCase, lowercase, etc.).
+     *
+     * @param clients - Record of ClientKafka instances
+     * @param clientName - Name to search for
+     * @returns ClientKafka instance or undefined if not found
+     *
+     * @private
+     */
+    private findClientByName;
+    /**
+     * Convert a string to camelCase
+     *
+     * @param str - String to convert (e.g., "AUTH_SERVICE")
+     * @returns camelCase string (e.g., "authService")
+     *
+     * @private
+     */
+    private toCamelCase;
+}
+//# sourceMappingURL=subscription-registry.d.ts.map

package/dist/kafka/subscription-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-registry.d.ts","sourceRoot":"","sources":["../../src/kafka/subscription-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAuB;IAE5C;;;;;OAKG;gBACS,aAAa,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,MAAM;IAKhE;;;;;;;;;;;;;;;;;;;OAmBG;IACG,qBAAqB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgChF;;;;;;;;;;;;;;;;;;;OAmBG;IACH,2BAA2B,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAmClF;;;;;;;;;;;;OAYG;IACH,cAAc,IAAI,MAAM,EAAE;IAY1B;;;;;;;;;;;;;OAaG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAUjD;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,gBAAgB;IA0BxB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;CAKpB"}

package/dist/kafka/subscription-registry.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * Kafka Subscription Registry
+ *
+ * Centralized management of Kafka message pattern subscriptions for microservices.
+ * This class provides a structured way to declare and register all Kafka subscriptions
+ * in one place instead of scattering them across controllers.
+ *
+ * Requirements: 3.1, 3.2, 3.3, 3.5
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KafkaSubscriptionRegistry = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * KafkaSubscriptionRegistry manages message pattern subscriptions for a service
+ *
+ * Features:
+ * - Centralized subscription declaration
+ * - Grouped subscriptions by target service
+ * - Ordered registration before client connections
+ * - Structured logging of all subscriptions
+ *
+ * @example
+ * ```typescript
+ * const subscriptions: ServiceSubscriptions = {
+ *   auth: {
+ *     clientName: 'AUTH_SERVICE',
+ *     patterns: [AUTH_PATTERNS.UPDATE_USER, AUTH_PATTERNS.GET_USER],
+ *     description: 'Auth service patterns for user management'
+ *   }
+ * };
+ *
+ * const registry = new KafkaSubscriptionRegistry(subscriptions);
+ * await registry.registerSubscriptions({ authClient });
+ * ```
+ */
+class KafkaSubscriptionRegistry {
+    /**
+     * Create a new subscription registry
+     *
+     * @param subscriptions - Service subscriptions grouped by client
+     * @param logger - Optional NestJS logger instance
+     */
+    constructor(subscriptions, logger) {
+        this.subscriptions = subscriptions;
+        this.logger = logger || new common_1.Logger(KafkaSubscriptionRegistry.name);
+    }
+    /**
+     * Register all subscriptions for a service
+     *
+     * This method iterates through all configured subscriptions and registers
+     * each pattern with the corresponding Kafka client. Subscriptions are
+     * registered in the order they are declared.
+     *
+     * Requirements: 3.1, 3.3
+     *
+     * @param clients - Record of ClientKafka instances keyed by client name
+     * @returns Promise that resolves when all subscriptions are registered
+     *
+     * @example
+     * ```typescript
+     * await registry.registerSubscriptions({
+     *   authClient: authServiceClient,
+     *   consultationClient: consultationServiceClient
+     * });
+     * ```
+     */
+    async registerSubscriptions(clients) {
+        this.logger.log('Starting subscription registration for all clients');
+        // Track total subscriptions registered
+        let totalSubscriptions = 0;
+        // Iterate through each service subscription configuration
+        for (const [serviceName, config] of Object.entries(this.subscriptions)) {
+            if (!config) {
+                continue;
+            }
+            // Find the matching client by name
+            const client = this.findClientByName(clients, config.clientName);
+            if (!client) {
+                this.logger.warn(`Client not found for service "${serviceName}" (expected client name: "${config.clientName}"). Skipping subscriptions.`);
+                continue;
+            }
+            // Register subscriptions for this client
+            this.registerClientSubscriptions(client, config);
+            totalSubscriptions += config.patterns.length;
+        }
+        this.logger.log(`Subscription registration complete. Total patterns registered: ${totalSubscriptions}`);
+    }
+    /**
+     * Register subscriptions for a specific client
+     *
+     * This method registers all patterns for a single Kafka client.
+     * Each pattern is logged for debugging and traceability.
+     *
+     * Requirements: 3.2, 3.3, 3.5
+     *
+     * @param client - ClientKafka instance to register patterns with
+     * @param config - Subscription configuration containing patterns and metadata
+     *
+     * @example
+     * ```typescript
+     * registry.registerClientSubscriptions(authClient, {
+     *   clientName: 'AUTH_SERVICE',
+     *   patterns: [AUTH_PATTERNS.UPDATE_USER],
+     *   description: 'Auth patterns'
+     * });
+     * ```
+     */
+    registerClientSubscriptions(client, config) {
+        const { clientName, patterns, description } = config;
+        this.logger.log(`Registering ${patterns.length} subscription(s) for client "${clientName}"${description ? `: ${description}` : ''}`);
+        // Register each pattern in order
+        for (const pattern of patterns) {
+            try {
+                // Subscribe to response pattern
+                client.subscribeToResponseOf(pattern);
+                this.logger.debug(`Subscribed to pattern "${pattern}" on client "${clientName}"`);
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                const errorStack = error instanceof Error ? error.stack : undefined;
+                this.logger.error(`Failed to subscribe to pattern "${pattern}" on client "${clientName}": ${errorMessage}`, errorStack);
+                throw error;
+            }
+        }
+        this.logger.log(`Successfully registered ${patterns.length} pattern(s) for client "${clientName}"`);
+    }
+    /**
+     * Get all registered patterns across all clients
+     *
+     * Requirements: 3.1, 3.2
+     *
+     * @returns Array of all pattern strings
+     *
+     * @example
+     * ```typescript
+     * const allPatterns = registry.getAllPatterns();
+     * // ['auth.update_user', 'auth.get_user', 'consultation.get_documents']
+     * ```
+     */
+    getAllPatterns() {
+        const patterns = [];
+        for (const config of Object.values(this.subscriptions)) {
+            if (config && config.patterns) {
+                patterns.push(...config.patterns);
+            }
+        }
+        return patterns;
+    }
+    /**
+     * Get patterns registered for a specific client
+     *
+     * Requirements: 3.2
+     *
+     * @param clientName - Name of the client to get patterns for
+     * @returns Array of pattern strings for the specified client
+     *
+     * @example
+     * ```typescript
+     * const authPatterns = registry.getPatternsByClient('AUTH_SERVICE');
+     * // ['auth.update_user', 'auth.get_user']
+     * ```
+     */
+    getPatternsByClient(clientName) {
+        for (const config of Object.values(this.subscriptions)) {
+            if (config && config.clientName === clientName) {
+                return [...config.patterns];
+            }
+        }
+        return [];
+    }
+    /**
+     * Find a client by its configured name
+     *
+     * This helper method searches through the clients record to find a client
+     * that matches the configured client name. It handles various naming conventions
+     * (camelCase, lowercase, etc.).
+     *
+     * @param clients - Record of ClientKafka instances
+     * @param clientName - Name to search for
+     * @returns ClientKafka instance or undefined if not found
+     *
+     * @private
+     */
+    findClientByName(clients, clientName) {
+        // Try exact match first
+        if (clients[clientName]) {
+            return clients[clientName];
+        }
+        // Try case-insensitive match
+        const normalizedName = clientName.toLowerCase();
+        for (const [key, client] of Object.entries(clients)) {
+            if (key.toLowerCase() === normalizedName) {
+                return client;
+            }
+        }
+        // Try converting to camelCase (e.g., AUTH_SERVICE -> authService)
+        const camelCaseName = this.toCamelCase(clientName);
+        if (clients[camelCaseName]) {
+            return clients[camelCaseName];
+        }
+        return undefined;
+    }
+    /**
+     * Convert a string to camelCase
+     *
+     * @param str - String to convert (e.g., "AUTH_SERVICE")
+     * @returns camelCase string (e.g., "authService")
+     *
+     * @private
+     */
+    toCamelCase(str) {
+        return str
+            .toLowerCase()
+            .replace(/_([a-z])/g, (_, letter) => letter.toUpperCase());
+    }
+}
+exports.KafkaSubscriptionRegistry = KafkaSubscriptionRegistry;
+//# sourceMappingURL=subscription-registry.js.map

package/dist/kafka/subscription-registry.js.map

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