tiryaq-shared 1.2.30 → 1.3.2

package/dist/index.d.ts

@@ -7,6 +7,7 @@ export * from './constants';
 export * from './filters/global-exception.filter';
 export * from './filters/validation-exception.filter';
 export * from './filters/microservice-exception.filter';
+export * from './kafka';
 export { User, UserAddress, RegisterUserDto, LoginDto, UserSettings, SearchQuery, SearchFilters, SortOptions, Pharmacy, Medicine, PharmacyOrder, OrderItem, OpeningHours, Location, Doctor, TimeSlot, Appointment, Prescription, TeleMedicineSession, ChatMessage, LabTest, Lab, LabAppointment, LabReport, Wallet, PaymentCard, Transaction, DoctorWallet, WalletTransaction, WithdrawalRequest, AreebaPaymentRequest, AreebaWithdrawalRequest, NurseWallet, NurseWalletTransaction, NurseWithdrawalRequest, LabWallet, LabWalletTransaction, LabWithdrawalRequest, PhysiotherapyWallet, PhysiotherapyWalletTransaction, PhysiotherapyWithdrawalRequest, Notification, NotificationSettings, ApiResponse, PaginatedResponse, StandardizedServiceProvider, CommissionMessage, AdminFeeMessage, ProviderCommissionMessage, ProviderListRequest, ProviderListResponse, ProviderInfo, ServiceProviderTypesResponse, CommissionRateRequest, CommissionCalculationRequest, CommissionResolutionRequest, CommissionBreakdownResponse, CommissionResolutionResponse, AdminWallet, AdminWalletTransaction, AdminWithdrawalRequest, AdminTransactionType, WithdrawalStatus, TransactionStatus, AdminFeeCollectionParams, TransactionFilters, AnalyticsFilters, WithdrawalFilters, WithdrawalRequestParams, RevenueAnalytics, GrowthTrend, ServicePerformance, FinancialReport, ReportPeriod, ReportSummary, ServiceBreakdown, TransactionSummary, WithdrawalSummary, ReportParams, AdminWalletErrorResponse, AdminFeeCollectionEvent } from './interfaces';
 export { AUTH_PATTERNS, AUTH_REPLY_PATTERNS, CONSULTATION_AND_PHARMACY_PATTERNS, MEDIA_PATTERNS, MEDIA_REPLY_PATTERNS, SETTINGS_PATTERNS, SEARCH_PATTERNS, PHARMACY_PATTERNS, CONSULTATION_PATTERNS, TELEMEDICINE_PATTERNS, LAB_PATTERNS, PAYMENT_PATTERNS, NOTIFICATION_PATTERNS, EVENT_PATTERNS, UserRegisteredEvent, OrderCreatedEvent, AppointmentBookedEvent, PaymentProcessedEvent, NotificationEvent, CommissionUpdatedEvent, AdminFeeUpdatedEvent, ProviderCommissionUpdatedEvent, MessageValidationUtils, KAFKA_CONFIG, SERVICE_PORTS } from './message-patterns';
 export { COMMON_ERROR_CODES, AUTH_ERROR_CODES, PHARMACY_ERROR_CODES, CONSULTATION_ERROR_CODES, CONSULTATION_AND_PHARMACY_ERROR_CODES, PAYMENT_ERROR_CODES, LAB_ERROR_CODES, NOTIFICATION_ERROR_CODES, SEARCH_ERROR_CODES, MEDIA_ERROR_CODES, SUCCESS_CODES, ErrorCode, SuccessCode } from './error-codes';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AAGxD,OAAO,EAEL,IAAI,EACJ,WAAW,EACX,eAAe,EACf,QAAQ,EAGR,YAAY,EAGZ,WAAW,EACX,aAAa,EACb,WAAW,EAGX,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,SAAS,EACT,YAAY,EACZ,QAAQ,EAGR,MAAM,EACN,QAAQ,EACR,WAAW,EACX,YAAY,EAGZ,mBAAmB,EACnB,WAAW,EAGX,OAAO,EACP,GAAG,EACH,cAAc,EACd,SAAS,EAGT,MAAM,EACN,WAAW,EACX,WAAW,EAGX,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EAGvB,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EAGtB,SAAS,EACT,oBAAoB,EACpB,oBAAoB,EAGpB,mBAAmB,EACnB,8BAA8B,EAC9B,8BAA8B,EAG9B,YAAY,EACZ,oBAAoB,EAGpB,WAAW,EACX,iBAAiB,EAGjB,2BAA2B,EAG3B,iBAAiB,EACjB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,4BAA4B,EAC5B,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAG5B,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,aAAa,EACb,mBAAmB,EACnB,kCAAkC,EAClC,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EAGd,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EAGjB,sBAAsB,EACtB,oBAAoB,EACpB,8BAA8B,EAG9B,sBAAsB,EAGtB,YAAY,EACZ,aAAa,EACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,qCAAqC,EACrC,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EAGjB,aAAa,EAGb,SAAS,EACT,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,aAAa,EACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAEL,aAAa,EAGb,KAAK,eAAe,EACpB,KAAK,qCAAqC,EAC1C,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,GACjC,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,yCAAyC,CAAC;AACxD,cAAc,SAAS,CAAC;AAGxB,OAAO,EAEL,IAAI,EACJ,WAAW,EACX,eAAe,EACf,QAAQ,EAGR,YAAY,EAGZ,WAAW,EACX,aAAa,EACb,WAAW,EAGX,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,SAAS,EACT,YAAY,EACZ,QAAQ,EAGR,MAAM,EACN,QAAQ,EACR,WAAW,EACX,YAAY,EAGZ,mBAAmB,EACnB,WAAW,EAGX,OAAO,EACP,GAAG,EACH,cAAc,EACd,SAAS,EAGT,MAAM,EACN,WAAW,EACX,WAAW,EAGX,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,EAGvB,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EAGtB,SAAS,EACT,oBAAoB,EACpB,oBAAoB,EAGpB,mBAAmB,EACnB,8BAA8B,EAC9B,8BAA8B,EAG9B,YAAY,EACZ,oBAAoB,EAGpB,WAAW,EACX,iBAAiB,EAGjB,2BAA2B,EAG3B,iBAAiB,EACjB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,4BAA4B,EAC5B,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAG5B,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,eAAe,EACf,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,aAAa,EACb,mBAAmB,EACnB,kCAAkC,EAClC,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,cAAc,EAGd,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,iBAAiB,EAGjB,sBAAsB,EACtB,oBAAoB,EACpB,8BAA8B,EAG9B,sBAAsB,EAGtB,YAAY,EACZ,aAAa,EACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAEL,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,qCAAqC,EACrC,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EAGjB,aAAa,EAGb,SAAS,EACT,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EAEL,aAAa,EACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAEL,aAAa,EAGb,KAAK,eAAe,EACpB,KAAK,qCAAqC,EAC1C,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,GACjC,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -25,6 +25,7 @@ __exportStar(require("./constants"), exports);
 __exportStar(require("./filters/global-exception.filter"), exports);
 __exportStar(require("./filters/validation-exception.filter"), exports);
 __exportStar(require("./filters/microservice-exception.filter"), exports);
+__exportStar(require("./kafka"), exports);
 // Named exports for better tree-shaking and explicit imports
 var interfaces_1 = require("./interfaces");
 // Standardized service provider types

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,kCAAkC;AAClC,+CAA6B;AAC7B,qDAAmC;AACnC,gDAA8B;AAC9B,mDAAiC;AACjC,kDAAgC;AAChC,8CAA4B;AAC5B,oEAAkD;AAClD,wEAAsD;AACtD,0EAAwD;AAExD,6DAA6D;AAC7D,2CAmHsB;AAzCpB,sCAAsC;AACtC,yHAAA,2BAA2B,OAAA;AAoB3B,kHAAA,oBAAoB,OAAA;AACpB,8GAAA,gBAAgB,OAAA;AAChB,+GAAA,iBAAiB,OAAA;AAoBnB,uDAmC4B;AAlC1B,mBAAmB;AACnB,iHAAA,aAAa,OAAA;AACb,uHAAA,mBAAmB,OAAA;AACnB,sIAAA,kCAAkC,OAAA;AAClC,kHAAA,cAAc,OAAA;AACd,wHAAA,oBAAoB,OAAA;AACpB,qHAAA,iBAAiB,OAAA;AACjB,mHAAA,eAAe,OAAA;AACf,qHAAA,iBAAiB,OAAA;AACjB,yHAAA,qBAAqB,OAAA;AACrB,yHAAA,qBAAqB,OAAA;AACrB,gHAAA,YAAY,OAAA;AACZ,oHAAA,gBAAgB,OAAA;AAChB,yHAAA,qBAAqB,OAAA;AACrB,kHAAA,cAAc,OAAA;AAcd,+BAA+B;AAC/B,0HAAA,sBAAsB,OAAA;AAEtB,gBAAgB;AAChB,gHAAA,YAAY,OAAA;AACZ,iHAAA,aAAa,OAAA;AAGf,6CAmBuB;AAlBrB,cAAc;AACd,iHAAA,kBAAkB,OAAA;AAClB,+GAAA,gBAAgB,OAAA;AAChB,mHAAA,oBAAoB,OAAA;AACpB,uHAAA,wBAAwB,OAAA;AACxB,oIAAA,qCAAqC,OAAA;AACrC,kHAAA,mBAAmB,OAAA;AACnB,8GAAA,eAAe,OAAA;AACf,uHAAA,wBAAwB,OAAA;AACxB,iHAAA,kBAAkB,OAAA;AAClB,gHAAA,iBAAiB,OAAA;AAEjB,gBAAgB;AAChB,4GAAA,aAAa,OAAA;AAOf,mDAG0B;AAFxB,qBAAqB;AACrB,+GAAA,aAAa,OAAA;AAGf,iDAYyB;AAXvB,mBAAmB;AACnB,8GAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,kCAAkC;AAClC,+CAA6B;AAC7B,qDAAmC;AACnC,gDAA8B;AAC9B,mDAAiC;AACjC,kDAAgC;AAChC,8CAA4B;AAC5B,oEAAkD;AAClD,wEAAsD;AACtD,0EAAwD;AACxD,0CAAwB;AAExB,6DAA6D;AAC7D,2CAmHsB;AAzCpB,sCAAsC;AACtC,yHAAA,2BAA2B,OAAA;AAoB3B,kHAAA,oBAAoB,OAAA;AACpB,8GAAA,gBAAgB,OAAA;AAChB,+GAAA,iBAAiB,OAAA;AAoBnB,uDAmC4B;AAlC1B,mBAAmB;AACnB,iHAAA,aAAa,OAAA;AACb,uHAAA,mBAAmB,OAAA;AACnB,sIAAA,kCAAkC,OAAA;AAClC,kHAAA,cAAc,OAAA;AACd,wHAAA,oBAAoB,OAAA;AACpB,qHAAA,iBAAiB,OAAA;AACjB,mHAAA,eAAe,OAAA;AACf,qHAAA,iBAAiB,OAAA;AACjB,yHAAA,qBAAqB,OAAA;AACrB,yHAAA,qBAAqB,OAAA;AACrB,gHAAA,YAAY,OAAA;AACZ,oHAAA,gBAAgB,OAAA;AAChB,yHAAA,qBAAqB,OAAA;AACrB,kHAAA,cAAc,OAAA;AAcd,+BAA+B;AAC/B,0HAAA,sBAAsB,OAAA;AAEtB,gBAAgB;AAChB,gHAAA,YAAY,OAAA;AACZ,iHAAA,aAAa,OAAA;AAGf,6CAmBuB;AAlBrB,cAAc;AACd,iHAAA,kBAAkB,OAAA;AAClB,+GAAA,gBAAgB,OAAA;AAChB,mHAAA,oBAAoB,OAAA;AACpB,uHAAA,wBAAwB,OAAA;AACxB,oIAAA,qCAAqC,OAAA;AACrC,kHAAA,mBAAmB,OAAA;AACnB,8GAAA,eAAe,OAAA;AACf,uHAAA,wBAAwB,OAAA;AACxB,iHAAA,kBAAkB,OAAA;AAClB,gHAAA,iBAAiB,OAAA;AAEjB,gBAAgB;AAChB,4GAAA,aAAa,OAAA;AAOf,mDAG0B;AAFxB,qBAAqB;AACrB,+GAAA,aAAa,OAAA;AAGf,iDAYyB;AAXvB,mBAAmB;AACnB,8GAAA,aAAa,OAAA"}

package/dist/kafka/broker-parser.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Broker Parser
+ *
+ * Parses and validates Kafka broker addresses from environment variables.
+ * Supports both local (localhost:9092) and MSK (AWS) formats.
+ */
+import { Logger } from '@nestjs/common';
+import { BrokerValidationResult } from './types';
+/**
+ * BrokerParser class for parsing and validating Kafka broker addresses
+ */
+export declare class BrokerParser {
+    private logger;
+    constructor(logger?: Logger);
+    /**
+     * Parse brokers from environment variable
+     * Supports both JSON (MSK) and comma-separated (local) formats
+     *
+     * @param kafkaBroker - Broker string from environment variable
+     * @param mode - Kafka mode ('local' or 'msk')
+     * @returns Array of broker addresses
+     */
+    parse(kafkaBroker: string, mode: 'local' | 'msk'): string[];
+    /**
+     * Validate single broker address format
+     * Broker must follow host:port format with port between 1 and 65535
+     *
+     * @param broker - Broker address to validate
+     * @returns Validation result with error message if invalid
+     */
+    validateBroker(broker: string): BrokerValidationResult;
+    /**
+     * Parse JSON configuration for MSK
+     * Expected format:
+     * {
+     *   "kafka_broker": "broker1:9092,broker2:9092",
+     *   "kafka_sasl_mechanism": "plain",
+     *   "kafka_sasl_username": "username",
+     *   "kafka_sasl_password": "password"
+     * }
+     *
+     * @param jsonString - JSON string to parse
+     * @returns Parsed configuration with brokers and SASL settings
+     */
+    parseJsonConfig(jsonString: string): {
+        brokers: string[];
+        sasl?: {
+            mechanism: string;
+            username: string;
+            password: string;
+        };
+    };
+}
+//# sourceMappingURL=broker-parser.d.ts.map

package/dist/kafka/broker-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"broker-parser.d.ts","sourceRoot":"","sources":["../../src/kafka/broker-parser.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAI3B;;;;;;;OAOG;IACH,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,EAAE;IA2C3D;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB;IAyDtD;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;QACnC,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC,EAAE;YACL,SAAS,EAAE,MAAM,CAAC;YAClB,QAAQ,EAAE,MAAM,CAAC;YACjB,QAAQ,EAAE,MAAM,CAAC;SAClB,CAAC;KACH;CAiEF"}

package/dist/kafka/broker-parser.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Broker Parser
+ *
+ * Parses and validates Kafka broker addresses from environment variables.
+ * Supports both local (localhost:9092) and MSK (AWS) formats.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrokerParser = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * BrokerParser class for parsing and validating Kafka broker addresses
+ */
+class BrokerParser {
+    constructor(logger) {
+        this.logger = logger || new common_1.Logger('BrokerParser');
+    }
+    /**
+     * Parse brokers from environment variable
+     * Supports both JSON (MSK) and comma-separated (local) formats
+     *
+     * @param kafkaBroker - Broker string from environment variable
+     * @param mode - Kafka mode ('local' or 'msk')
+     * @returns Array of broker addresses
+     */
+    parse(kafkaBroker, mode) {
+        if (!kafkaBroker || kafkaBroker.trim() === '') {
+            if (mode === 'local') {
+                this.logger.log('No KAFKA_BROKER provided, using default localhost:9092');
+                return ['localhost:9092'];
+            }
+            throw new Error('KAFKA_BROKER environment variable is required for MSK mode');
+        }
+        // Try JSON parsing first for MSK format
+        if (mode === 'msk') {
+            try {
+                const config = this.parseJsonConfig(kafkaBroker);
+                return config.brokers;
+            }
+            catch (error) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                this.logger.error(`Failed to parse MSK JSON configuration: ${errorMessage}`);
+                throw new Error(`Invalid MSK configuration: ${errorMessage}`);
+            }
+        }
+        // Fall back to comma-separated string parsing for local mode
+        const brokers = kafkaBroker
+            .split(',')
+            .map(broker => broker.trim())
+            .filter(broker => broker.length > 0);
+        // Validate each broker
+        const invalidBrokers = [];
+        for (const broker of brokers) {
+            const validation = this.validateBroker(broker);
+            if (!validation.valid) {
+                invalidBrokers.push(`${broker}: ${validation.error}`);
+            }
+        }
+        if (invalidBrokers.length > 0) {
+            throw new Error(`Invalid broker addresses: ${invalidBrokers.join(', ')}`);
+        }
+        return brokers;
+    }
+    /**
+     * Validate single broker address format
+     * Broker must follow host:port format with port between 1 and 65535
+     *
+     * @param broker - Broker address to validate
+     * @returns Validation result with error message if invalid
+     */
+    validateBroker(broker) {
+        if (!broker || broker.trim() === '') {
+            return {
+                valid: false,
+                broker,
+                error: 'Broker address cannot be empty'
+            };
+        }
+        const trimmedBroker = broker.trim();
+        // Check for host:port format
+        const parts = trimmedBroker.split(':');
+        if (parts.length !== 2) {
+            return {
+                valid: false,
+                broker: trimmedBroker,
+                error: 'Broker must follow host:port format'
+            };
+        }
+        const [host, portStr] = parts;
+        // Validate host is not empty
+        if (!host || host.trim() === '') {
+            return {
+                valid: false,
+                broker: trimmedBroker,
+                error: 'Host cannot be empty'
+            };
+        }
+        // Validate port is numeric
+        const port = parseInt(portStr, 10);
+        if (isNaN(port)) {
+            return {
+                valid: false,
+                broker: trimmedBroker,
+                error: 'Port must be a number'
+            };
+        }
+        // Validate port range (1-65535)
+        if (port < 1 || port > 65535) {
+            return {
+                valid: false,
+                broker: trimmedBroker,
+                error: 'Port must be between 1 and 65535'
+            };
+        }
+        return {
+            valid: true,
+            broker: trimmedBroker
+        };
+    }
+    /**
+     * Parse JSON configuration for MSK
+     * Expected format:
+     * {
+     *   "kafka_broker": "broker1:9092,broker2:9092",
+     *   "kafka_sasl_mechanism": "plain",
+     *   "kafka_sasl_username": "username",
+     *   "kafka_sasl_password": "password"
+     * }
+     *
+     * @param jsonString - JSON string to parse
+     * @returns Parsed configuration with brokers and SASL settings
+     */
+    parseJsonConfig(jsonString) {
+        let config;
+        try {
+            config = JSON.parse(jsonString);
+        }
+        catch (error) {
+            throw new Error('KAFKA_BROKER must be valid JSON for MSK mode');
+        }
+        // Validate required fields
+        if (!config.kafka_broker) {
+            throw new Error('MSK configuration must include kafka_broker field');
+        }
+        // Parse broker addresses
+        const brokerString = config.kafka_broker;
+        const brokers = brokerString
+            .split(',')
+            .map((broker) => broker.trim())
+            .filter((broker) => broker.length > 0);
+        if (brokers.length === 0) {
+            throw new Error('MSK configuration must include at least one broker address');
+        }
+        // Validate each broker
+        const invalidBrokers = [];
+        for (const broker of brokers) {
+            const validation = this.validateBroker(broker);
+            if (!validation.valid) {
+                invalidBrokers.push(`${broker}: ${validation.error}`);
+            }
+        }
+        if (invalidBrokers.length > 0) {
+            throw new Error(`Invalid broker addresses in MSK config: ${invalidBrokers.join(', ')}`);
+        }
+        // Parse SASL configuration if present
+        let sasl;
+        if (config.kafka_sasl_mechanism || config.kafka_sasl_username || config.kafka_sasl_password) {
+            // If any SASL field is present, all must be present
+            if (!config.kafka_sasl_mechanism) {
+                throw new Error('MSK configuration with SASL must include kafka_sasl_mechanism');
+            }
+            if (!config.kafka_sasl_username) {
+                throw new Error('MSK configuration with SASL must include kafka_sasl_username');
+            }
+            if (!config.kafka_sasl_password) {
+                throw new Error('MSK configuration with SASL must include kafka_sasl_password');
+            }
+            sasl = {
+                mechanism: config.kafka_sasl_mechanism,
+                username: config.kafka_sasl_username,
+                password: config.kafka_sasl_password
+            };
+        }
+        return {
+            brokers,
+            sasl
+        };
+    }
+}
+exports.BrokerParser = BrokerParser;
+//# sourceMappingURL=broker-parser.js.map

package/dist/kafka/broker-parser.js.map

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

package/dist/kafka/circuit-breaker.provider.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Circuit Breaker Provider
+ *
+ * Implements the circuit breaker pattern for inter-service Kafka calls.
+ * Prevents cascading failures by stopping requests to failing services.
+ *
+ * State Machine:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Service is failing, requests are rejected immediately
+ * - HALF_OPEN: Testing if service has recovered, limited requests allowed
+ */
+import { Logger } from '@nestjs/common';
+import { CircuitBreakerConfig, CircuitBreakerStats } from './types';
+/**
+ * CircuitBreakerProvider implements the circuit breaker pattern
+ *
+ * Features:
+ * - Automatic state transitions based on failure/success rates
+ * - Configurable thresholds and timeouts
+ * - Structured logging of state changes
+ * - Statistics tracking for monitoring
+ */
+export declare class CircuitBreakerProvider {
+    private serviceName;
+    private logger;
+    private config;
+    private state;
+    private failures;
+    private successes;
+    private lastFailureTime?;
+    private lastStateChange;
+    private halfOpenAttempts;
+    private totalRequests;
+    private totalFailures;
+    private failureTimestamps;
+    /**
+     * Create a new CircuitBreakerProvider instance
+     *
+     * @param serviceName - Name of the target service being protected
+     * @param config - Optional circuit breaker configuration (uses defaults if not provided)
+     * @param logger - Optional NestJS Logger instance
+     */
+    constructor(serviceName: string, config?: Partial<CircuitBreakerConfig>, logger?: Logger);
+    /**
+     * Execute a function with circuit breaker protection
+     *
+     * @param fn - Async function to execute
+     * @returns Promise resolving to the function result
+     * @throws Error if circuit is open or function execution fails
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get current circuit breaker statistics
+     *
+     * @returns Circuit breaker statistics object
+     */
+    getStats(): CircuitBreakerStats;
+    /**
+     * Manually reset circuit breaker to closed state
+     *
+     * Useful for administrative operations or testing
+     */
+    reset(): void;
+    /**
+     * Record successful execution
+     *
+     * Updates success counter and handles state transitions from HALF_OPEN to CLOSED
+     */
+    private recordSuccess;
+    /**
+     * Record failed execution
+     *
+     * Updates failure counter and handles state transitions to OPEN
+     */
+    private recordFailure;
+    /**
+     * Check if circuit should open based on failure threshold
+     *
+     * @returns True if circuit should open, false otherwise
+     */
+    private shouldOpen;
+    /**
+     * Check if circuit should transition from OPEN to HALF_OPEN
+     *
+     * Called before each execution when circuit is open
+     */
+    private checkForHalfOpen;
+    /**
+     * Transition circuit to OPEN state
+     *
+     * Rejects all subsequent requests until timeout expires
+     */
+    private transitionToOpen;
+    /**
+     * Transition circuit to HALF_OPEN state
+     *
+     * Allows test requests to check if service has recovered
+     */
+    private transitionToHalfOpen;
+    /**
+     * Transition circuit to CLOSED state
+     *
+     * Resumes normal operation after successful recovery
+     */
+    private transitionToClosed;
+    /**
+     * Clean up failure timestamps outside the monitoring period
+     *
+     * Maintains a sliding window of failures for threshold calculation
+     */
+    private cleanupOldFailures;
+}
+//# sourceMappingURL=circuit-breaker.provider.d.ts.map

package/dist/kafka/circuit-breaker.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.provider.d.ts","sourceRoot":"","sources":["../../src/kafka/circuit-breaker.provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EACL,oBAAoB,EAEpB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAajB;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IAqB/B,OAAO,CAAC,WAAW;IApBrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,eAAe,CAAC,CAAO;IAC/B,OAAO,CAAC,eAAe,CAAO;IAC9B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAS;IAElC;;;;;;OAMG;gBAEO,WAAW,EAAE,MAAM,EAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,EACtC,MAAM,CAAC,EAAE,MAAM;IAcjB;;;;;;OAMG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAwBlD;;;;OAIG;IACH,QAAQ,IAAI,mBAAmB;IAY/B;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAmBb;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAarB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAoBrB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAMlB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAiB1B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;CAQ3B"}

package/dist/kafka/circuit-breaker.provider.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * Circuit Breaker Provider
+ *
+ * Implements the circuit breaker pattern for inter-service Kafka calls.
+ * Prevents cascading failures by stopping requests to failing services.
+ *
+ * State Machine:
+ * - CLOSED: Normal operation, requests pass through
+ * - OPEN: Service is failing, requests are rejected immediately
+ * - HALF_OPEN: Testing if service has recovered, limited requests allowed
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CircuitBreakerProvider = void 0;
+const types_1 = require("./types");
+const kafka_logger_1 = require("./kafka-logger");
+/**
+ * Default circuit breaker configuration
+ */
+const DEFAULT_CIRCUIT_BREAKER_CONFIG = {
+    failureThreshold: 5, // Open after 5 failures
+    successThreshold: 2, // Close after 2 successes in half-open
+    timeout: 60000, // 1 minute before trying half-open
+    monitoringPeriod: 120000 // 2 minute window for failure rate
+};
+/**
+ * CircuitBreakerProvider implements the circuit breaker pattern
+ *
+ * Features:
+ * - Automatic state transitions based on failure/success rates
+ * - Configurable thresholds and timeouts
+ * - Structured logging of state changes
+ * - Statistics tracking for monitoring
+ */
+class CircuitBreakerProvider {
+    /**
+     * Create a new CircuitBreakerProvider instance
+     *
+     * @param serviceName - Name of the target service being protected
+     * @param config - Optional circuit breaker configuration (uses defaults if not provided)
+     * @param logger - Optional NestJS Logger instance
+     */
+    constructor(serviceName, config, logger) {
+        this.serviceName = serviceName;
+        this.config = { ...DEFAULT_CIRCUIT_BREAKER_CONFIG, ...config };
+        this.logger = new kafka_logger_1.KafkaLogger(serviceName, logger);
+        this.state = types_1.CircuitState.CLOSED;
+        this.failures = 0;
+        this.successes = 0;
+        this.lastStateChange = new Date();
+        this.halfOpenAttempts = 0;
+        this.totalRequests = 0;
+        this.totalFailures = 0;
+        this.failureTimestamps = [];
+    }
+    /**
+     * Execute a function with circuit breaker protection
+     *
+     * @param fn - Async function to execute
+     * @returns Promise resolving to the function result
+     * @throws Error if circuit is open or function execution fails
+     */
+    async execute(fn) {
+        this.totalRequests++;
+        // Check circuit state before execution
+        if (this.state === types_1.CircuitState.OPEN) {
+            this.checkForHalfOpen();
+            if (this.state === types_1.CircuitState.OPEN) {
+                throw new Error(`Circuit breaker is OPEN for service: ${this.serviceName}. Service is currently unavailable.`);
+            }
+        }
+        try {
+            const result = await fn();
+            this.recordSuccess();
+            return result;
+        }
+        catch (error) {
+            this.recordFailure();
+            throw error;
+        }
+    }
+    /**
+     * Get current circuit breaker statistics
+     *
+     * @returns Circuit breaker statistics object
+     */
+    getStats() {
+        return {
+            state: this.state,
+            failures: this.failures,
+            successes: this.successes,
+            lastFailureTime: this.lastFailureTime,
+            lastStateChange: this.lastStateChange,
+            totalRequests: this.totalRequests,
+            totalFailures: this.totalFailures
+        };
+    }
+    /**
+     * Manually reset circuit breaker to closed state
+     *
+     * Useful for administrative operations or testing
+     */
+    reset() {
+        const oldState = this.state;
+        this.state = types_1.CircuitState.CLOSED;
+        this.failures = 0;
+        this.successes = 0;
+        this.halfOpenAttempts = 0;
+        this.failureTimestamps = [];
+        this.lastStateChange = new Date();
+        if (oldState !== types_1.CircuitState.CLOSED) {
+            this.logger.logCircuitBreakerStateChange(this.serviceName, oldState, types_1.CircuitState.CLOSED, this.getStats());
+        }
+    }
+    /**
+     * Record successful execution
+     *
+     * Updates success counter and handles state transitions from HALF_OPEN to CLOSED
+     */
+    recordSuccess() {
+        this.successes++;
+        if (this.state === types_1.CircuitState.HALF_OPEN) {
+            this.halfOpenAttempts++;
+            // Close circuit if success threshold is reached
+            if (this.halfOpenAttempts >= this.config.successThreshold) {
+                this.transitionToClosed();
+            }
+        }
+    }
+    /**
+     * Record failed execution
+     *
+     * Updates failure counter and handles state transitions to OPEN
+     */
+    recordFailure() {
+        this.failures++;
+        this.totalFailures++;
+        this.lastFailureTime = new Date();
+        this.failureTimestamps.push(this.lastFailureTime);
+        // Clean up old failure timestamps outside monitoring period
+        this.cleanupOldFailures();
+        if (this.state === types_1.CircuitState.HALF_OPEN) {
+            // Any failure in half-open state reopens the circuit
+            this.transitionToOpen();
+        }
+        else if (this.state === types_1.CircuitState.CLOSED) {
+            // Check if failure threshold is exceeded
+            if (this.shouldOpen()) {
+                this.transitionToOpen();
+            }
+        }
+    }
+    /**
+     * Check if circuit should open based on failure threshold
+     *
+     * @returns True if circuit should open, false otherwise
+     */
+    shouldOpen() {
+        // Count failures within monitoring period
+        const recentFailures = this.failureTimestamps.length;
+        return recentFailures >= this.config.failureThreshold;
+    }
+    /**
+     * Check if circuit should transition from OPEN to HALF_OPEN
+     *
+     * Called before each execution when circuit is open
+     */
+    checkForHalfOpen() {
+        if (this.state !== types_1.CircuitState.OPEN) {
+            return;
+        }
+        const now = new Date();
+        const timeSinceStateChange = now.getTime() - this.lastStateChange.getTime();
+        if (timeSinceStateChange >= this.config.timeout) {
+            this.transitionToHalfOpen();
+        }
+    }
+    /**
+     * Transition circuit to OPEN state
+     *
+     * Rejects all subsequent requests until timeout expires
+     */
+    transitionToOpen() {
+        const oldState = this.state;
+        this.state = types_1.CircuitState.OPEN;
+        this.lastStateChange = new Date();
+        this.halfOpenAttempts = 0;
+        this.logger.logCircuitBreakerStateChange(this.serviceName, oldState, types_1.CircuitState.OPEN, this.getStats());
+    }
+    /**
+     * Transition circuit to HALF_OPEN state
+     *
+     * Allows test requests to check if service has recovered
+     */
+    transitionToHalfOpen() {
+        const oldState = this.state;
+        this.state = types_1.CircuitState.HALF_OPEN;
+        this.lastStateChange = new Date();
+        this.halfOpenAttempts = 0;
+        this.successes = 0;
+        this.logger.logCircuitBreakerStateChange(this.serviceName, oldState, types_1.CircuitState.HALF_OPEN, this.getStats());
+    }
+    /**
+     * Transition circuit to CLOSED state
+     *
+     * Resumes normal operation after successful recovery
+     */
+    transitionToClosed() {
+        const oldState = this.state;
+        this.state = types_1.CircuitState.CLOSED;
+        this.lastStateChange = new Date();
+        this.failures = 0;
+        this.successes = 0;
+        this.halfOpenAttempts = 0;
+        this.failureTimestamps = [];
+        this.logger.logCircuitBreakerStateChange(this.serviceName, oldState, types_1.CircuitState.CLOSED, this.getStats());
+    }
+    /**
+     * Clean up failure timestamps outside the monitoring period
+     *
+     * Maintains a sliding window of failures for threshold calculation
+     */
+    cleanupOldFailures() {
+        const now = new Date();
+        const cutoffTime = now.getTime() - this.config.monitoringPeriod;
+        this.failureTimestamps = this.failureTimestamps.filter(timestamp => timestamp.getTime() > cutoffTime);
+    }
+}
+exports.CircuitBreakerProvider = CircuitBreakerProvider;
+//# sourceMappingURL=circuit-breaker.provider.js.map

package/dist/kafka/circuit-breaker.provider.js.map

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