splp-nodejs 1.0.0

package/dist/lib/kafka/kafka-wrapper.d.ts

@@ -0,0 +1,27 @@
+import { Producer, Consumer, EachMessagePayload } from 'kafkajs';
+import type { KafkaConfig } from '../../types/index.js';
+export declare class KafkaWrapper {
+    private kafka;
+    private producer;
+    private consumer;
+    private admin;
+    private config;
+    private isConsuming;
+    private static instanceCounter;
+    private instanceId;
+    constructor(config: KafkaConfig);
+    connectProducer(): Promise<Producer>;
+    connectConsumer(groupId?: string): Promise<Consumer>;
+    getProducer(): Producer;
+    getConsumer(): Consumer;
+    sendMessage(topic: string, message: string, key?: string): Promise<{
+        partition: number;
+        offset: string;
+    }>;
+    subscribe(topics: string[], messageHandler: (payload: EachMessagePayload) => Promise<void>): Promise<void>;
+    createTopics(topics: string[]): Promise<void>;
+    disconnect(): Promise<void>;
+    isProducerConnected(): boolean;
+    isConsumerConnected(): boolean;
+}
+//# sourceMappingURL=kafka-wrapper.d.ts.map

package/dist/lib/kafka/kafka-wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kafka-wrapper.d.ts","sourceRoot":"","sources":["../../../lib/kafka/kafka-wrapper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,QAAQ,EAAE,QAAQ,EAAS,kBAAkB,EAAyE,MAAM,SAAS,CAAC;AACtJ,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAK;IACnC,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,WAAW;IAyDzB,eAAe,IAAI,OAAO,CAAC,QAAQ,CAAC;IAiBpC,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuC1D,WAAW,IAAI,QAAQ;IAOvB,WAAW,IAAI,QAAQ;IAOjB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BzG,SAAS,CACb,MAAM,EAAE,MAAM,EAAE,EAChB,cAAc,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAC7D,OAAO,CAAC,IAAI,CAAC;IAuBV,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B7C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAYjC,mBAAmB,IAAI,OAAO;IAI9B,mBAAmB,IAAI,OAAO;CAG/B"}

package/dist/lib/kafka/kafka-wrapper.js

@@ -0,0 +1,206 @@
+import { Kafka, Partitioners, PartitionAssigners, CompressionTypes, CompressionCodecs } from 'kafkajs';
+import SnappyCodec from 'kafkajs-snappy';
+// Register Snappy compression codec globally before creating any Kafka instances
+CompressionCodecs[CompressionTypes.Snappy] = SnappyCodec;
+export class KafkaWrapper {
+    kafka;
+    producer = null;
+    consumer = null;
+    admin;
+    config;
+    isConsuming = false;
+    static instanceCounter = 0;
+    instanceId;
+    constructor(config) {
+        this.instanceId = ++KafkaWrapper.instanceCounter;
+        console.log(`[KafkaWrapper#${this.instanceId}] NEW INSTANCE created for clientId: ${config.clientId}`);
+        this.config = config;
+        // Connection timeout settings for remote brokers
+        const connectionTimeout = config.connectionTimeout || 10000;
+        const requestTimeout = config.requestTimeout || 60000;
+        const socketTimeout = config.socketTimeout || 60000;
+        console.log(`[KafkaWrapper#${this.instanceId}] Kafka configuration:`);
+        console.log(`  Brokers: ${config.brokers.join(', ')}`);
+        console.log(`  Connection timeout: ${connectionTimeout}ms`);
+        console.log(`  Request timeout: ${requestTimeout}ms`);
+        console.log(`  Socket timeout: ${socketTimeout}ms`);
+        if (config.ssl) {
+            console.log(`  SSL/TLS: enabled`);
+            console.log(`  Servername: ${config.ssl.servername || 'not set'}`);
+        }
+        // Build Kafka configuration
+        const kafkaConfig = {
+            clientId: config.clientId,
+            brokers: config.brokers,
+            connectionTimeout: connectionTimeout,
+            requestTimeout: requestTimeout,
+            socketTimeout: socketTimeout,
+            retry: config.retry || {
+                retries: 8,
+                initialRetryTime: 300,
+                maxRetryTime: 30000,
+                multiplier: 2,
+                restartOnFailure: async (e) => {
+                    console.error(`[KafkaWrapper#${this.instanceId}] Connection failed, will retry:`, e.message);
+                    return true;
+                },
+            },
+        };
+        // Add SSL configuration if provided
+        if (config.ssl) {
+            kafkaConfig.ssl = config.ssl;
+        }
+        // Add logging configuration if provided
+        if (config.logLevel !== undefined) {
+            kafkaConfig.logLevel = config.logLevel;
+        }
+        if (config.logCreator) {
+            kafkaConfig.logCreator = config.logCreator;
+        }
+        this.kafka = new Kafka(kafkaConfig);
+        this.admin = this.kafka.admin();
+    }
+    async connectProducer() {
+        if (this.producer) {
+            return this.producer;
+        }
+        const maxRequestSize = this.config.maxRequestSize || 10485760;
+        this.producer = this.kafka.producer({
+            createPartitioner: Partitioners.LegacyPartitioner,
+            maxRequestSize: maxRequestSize,
+        });
+        await this.producer.connect();
+        console.log('Kafka producer connected');
+        console.log(`  Max request size: ${(maxRequestSize / 1024 / 1024).toFixed(2)}MB`);
+        return this.producer;
+    }
+    async connectConsumer(groupId) {
+        if (this.consumer) {
+            return this.consumer;
+        }
+        const consumerGroupId = groupId || this.config.groupId || this.config.clientId;
+        const maxBytes = this.config.maxBytes || this.config.maxBytesPerPartition || 10485760;
+        const fetchMaxBytes = this.config.fetchMaxBytes || 52428800;
+        this.consumer = this.kafka.consumer({
+            groupId: consumerGroupId,
+            sessionTimeout: this.config.sessionTimeout || 60000,
+            heartbeatInterval: this.config.heartbeatInterval || 5000,
+            rebalanceTimeout: this.config.rebalanceTimeout || 120000,
+            maxBytes: maxBytes,
+            maxBytesPerPartition: maxBytes,
+            partitionAssigners: [PartitionAssigners.roundRobin],
+        });
+        try {
+            await this.consumer.connect();
+            console.log(`Kafka consumer connected with group: ${consumerGroupId}`);
+            console.log(`  Session timeout: ${this.config.sessionTimeout || 60000}ms`);
+            console.log(`  Heartbeat interval: ${this.config.heartbeatInterval || 5000}ms`);
+        }
+        catch (error) {
+            const errorMsg = error instanceof Error ? error.message : String(error);
+            console.error(`[KafkaWrapper#${this.instanceId}] Failed to connect consumer:`, errorMsg);
+            console.error(`\nTroubleshooting Connection Timeout:\n`);
+            console.error(`  1. Verify Kafka broker is accessible: ${this.config.brokers.join(', ')}`);
+            console.error(`  2. Check network connectivity`);
+            console.error(`  3. Check firewall rules`);
+            console.error(`  4. Verify broker address is correct\n`);
+            throw error;
+        }
+        console.log(`  Max bytes per partition: ${(maxBytes / 1024 / 1024).toFixed(2)}MB`);
+        console.log(`  Total fetch max bytes: ${(fetchMaxBytes / 1024 / 1024).toFixed(2)}MB`);
+        return this.consumer;
+    }
+    getProducer() {
+        if (!this.producer) {
+            throw new Error('Producer not connected. Call connectProducer() first.');
+        }
+        return this.producer;
+    }
+    getConsumer() {
+        if (!this.consumer) {
+            throw new Error('Consumer not connected. Call connectConsumer() first.');
+        }
+        return this.consumer;
+    }
+    async sendMessage(topic, message, key) {
+        const producer = this.getProducer();
+        const result = await producer.send({
+            topic,
+            messages: [
+                {
+                    key: key || null,
+                    value: message,
+                },
+            ],
+        });
+        if (result && result.length > 0) {
+            return {
+                partition: result[0].partition,
+                offset: result[0].offset ?? '0',
+            };
+        }
+        return {
+            partition: 0,
+            offset: '0',
+        };
+    }
+    async subscribe(topics, messageHandler) {
+        const consumer = this.getConsumer();
+        if (this.isConsuming) {
+            console.warn(`[KafkaWrapper#${this.instanceId}] Consumer is already running. Ignoring duplicate subscribe() call.`);
+            return;
+        }
+        this.isConsuming = true;
+        for (const topic of topics) {
+            await consumer.subscribe({ topic, fromBeginning: false });
+        }
+        await consumer.run({
+            eachMessage: async (payload) => {
+                await messageHandler(payload);
+            },
+        });
+        console.log(`[KafkaWrapper#${this.instanceId}] Subscribed to topics: ${topics.join(', ')}`);
+    }
+    async createTopics(topics) {
+        await this.admin.connect();
+        const maxMessageBytes = this.config.maxMessageBytes || 10485760;
+        const topicConfigs = topics.map((topic) => ({
+            topic,
+            numPartitions: 3,
+            replicationFactor: 1,
+            configEntries: [
+                { name: 'max.message.bytes', value: String(maxMessageBytes) },
+                { name: 'retention.ms', value: '604800000' },
+            ],
+        }));
+        const created = await this.admin.createTopics({
+            topics: topicConfigs,
+            waitForLeaders: true,
+        });
+        if (created) {
+            console.log(`Topics created: ${topics.join(', ')}`);
+            console.log(`  Max message bytes: ${(maxMessageBytes / 1024 / 1024).toFixed(2)}MB`);
+        }
+        else {
+            console.log('Topics already exist');
+        }
+        await this.admin.disconnect();
+    }
+    async disconnect() {
+        if (this.producer) {
+            await this.producer.disconnect();
+            console.log('Producer disconnected');
+        }
+        if (this.consumer) {
+            await this.consumer.disconnect();
+            console.log('Consumer disconnected');
+        }
+    }
+    isProducerConnected() {
+        return this.producer !== null;
+    }
+    isConsumerConnected() {
+        return this.consumer !== null;
+    }
+}
+//# sourceMappingURL=kafka-wrapper.js.map

package/dist/lib/kafka/kafka-wrapper.js.map

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

package/dist/lib/tracing/tracer.d.ts

@@ -0,0 +1,19 @@
+import { Span } from '@opentelemetry/api';
+import type { Context } from '@opentelemetry/api';
+export interface TracingConfig {
+    serviceName: string;
+    tempoEndpoint?: string;
+    enabled?: boolean;
+}
+export declare function initTracing(config: TracingConfig): void;
+export declare function shutdownTracing(): Promise<void>;
+export declare function getTracer(name?: string): import("@opentelemetry/api").Tracer;
+export declare function requestIdToTraceId(requestId: string): string;
+export declare function setCustomTraceId(requestId: string): Context;
+export declare function withSpan<T>(name: string, fn: (span: Span) => Promise<T>, parentContext?: Context): Promise<T>;
+export declare function addSpanAttributes(attributes: Record<string, string | number | boolean>): void;
+export declare function addSpanEvent(name: string, attributes?: Record<string, string | number | boolean>): void;
+export declare function extractTraceContext(headers: Record<string, Buffer | string | undefined>): Context;
+export declare function injectTraceContext(headers?: Record<string, string>): Record<string, string>;
+export declare function createChildSpan(name: string, headers: Record<string, Buffer | string | undefined>): Span;
+//# sourceMappingURL=tracer.d.ts.map

package/dist/lib/tracing/tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer.d.ts","sourceRoot":"","sources":["../../../lib/tracing/tracer.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkC,IAAI,EAAwC,MAAM,oBAAoB,CAAC;AAChH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CA2CvD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAOrD;AAED,wBAAgB,SAAS,CAAC,IAAI,GAAE,MAAkB,uCAEjD;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAwB3D;AAED,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAC9B,aAAa,CAAC,EAAE,OAAO,GACtB,OAAO,CAAC,CAAC,CAAC,CAoBZ;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAO7F;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAKvG;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,OAAO,CAiBjG;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAU/F;AAED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GACnD,IAAI,CAKN"}

package/dist/lib/tracing/tracer.js

@@ -0,0 +1,147 @@
+import { NodeSDK } from '@opentelemetry/sdk-node';
+import { OTLPTraceExporter } from '@opentelemetry/exporter-trace-otlp-http';
+import { Resource } from '@opentelemetry/resources';
+import { SemanticResourceAttributes } from '@opentelemetry/semantic-conventions';
+import { getNodeAutoInstrumentations } from '@opentelemetry/auto-instrumentations-node';
+import { trace, context, SpanStatusCode } from '@opentelemetry/api';
+import { W3CTraceContextPropagator } from '@opentelemetry/core';
+let sdk = null;
+let isInitialized = false;
+const w3cPropagator = new W3CTraceContextPropagator();
+export function initTracing(config) {
+    if (isInitialized) {
+        console.log('Tracing already initialized');
+        return;
+    }
+    if (config.enabled === false) {
+        console.log('Tracing disabled');
+        return;
+    }
+    const tempoEndpoint = config.tempoEndpoint || process.env.TEMPO_ENDPOINT || 'http://localhost:4318/v1/traces';
+    const traceExporter = new OTLPTraceExporter({
+        url: tempoEndpoint,
+    });
+    sdk = new NodeSDK({
+        resource: new Resource({
+            [SemanticResourceAttributes.SERVICE_NAME]: config.serviceName,
+        }),
+        traceExporter,
+        instrumentations: [
+            getNodeAutoInstrumentations({
+                '@opentelemetry/instrumentation-fs': {
+                    enabled: false,
+                },
+            }),
+        ],
+    });
+    sdk.start();
+    isInitialized = true;
+    console.log(`Tracing initialized for service: ${config.serviceName}`);
+    console.log(`Tempo endpoint: ${tempoEndpoint}`);
+    process.on('SIGTERM', () => {
+        sdk?.shutdown()
+            .then(() => console.log('Tracing terminated'))
+            .catch((error) => console.error('Error terminating tracing', error))
+            .finally(() => process.exit(0));
+    });
+}
+export async function shutdownTracing() {
+    if (sdk) {
+        await sdk.shutdown();
+        isInitialized = false;
+        sdk = null;
+        console.log('Tracing shut down');
+    }
+}
+export function getTracer(name = 'default') {
+    return trace.getTracer(name);
+}
+export function requestIdToTraceId(requestId) {
+    const cleaned = requestId.replace(/-/g, '');
+    if (cleaned.length === 32) {
+        return cleaned;
+    }
+    return cleaned.padEnd(32, '0').substring(0, 32);
+}
+export function setCustomTraceId(requestId) {
+    const traceId = requestIdToTraceId(requestId);
+    const fakeSpanId = Array.from({ length: 16 }, () => Math.floor(Math.random() * 16).toString(16)).join('');
+    const traceparent = `00-${traceId}-${fakeSpanId}-01`;
+    const carrier = { traceparent };
+    const ctx = w3cPropagator.extract(context.active(), carrier, {
+        get(carrier, key) {
+            return carrier[key];
+        },
+        keys(carrier) {
+            return Object.keys(carrier);
+        },
+    });
+    return ctx;
+}
+export async function withSpan(name, fn, parentContext) {
+    const tracer = getTracer();
+    const ctx = parentContext || context.active();
+    return tracer.startActiveSpan(name, {}, ctx, async (span) => {
+        try {
+            const result = await fn(span);
+            span.setStatus({ code: SpanStatusCode.OK });
+            return result;
+        }
+        catch (error) {
+            span.setStatus({
+                code: SpanStatusCode.ERROR,
+                message: error instanceof Error ? error.message : 'Unknown error',
+            });
+            span.recordException(error);
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+export function addSpanAttributes(attributes) {
+    const span = trace.getActiveSpan();
+    if (span) {
+        Object.entries(attributes).forEach(([key, value]) => {
+            span.setAttribute(key, value);
+        });
+    }
+}
+export function addSpanEvent(name, attributes) {
+    const span = trace.getActiveSpan();
+    if (span) {
+        span.addEvent(name, attributes);
+    }
+}
+export function extractTraceContext(headers) {
+    const carrier = {};
+    for (const [key, value] of Object.entries(headers)) {
+        if (value !== undefined) {
+            carrier[key] = typeof value === 'string' ? value : value.toString();
+        }
+    }
+    return w3cPropagator.extract(context.active(), carrier, {
+        get(carrier, key) {
+            return carrier[key];
+        },
+        keys(carrier) {
+            return Object.keys(carrier);
+        },
+    });
+}
+export function injectTraceContext(headers = {}) {
+    const carrier = { ...headers };
+    w3cPropagator.inject(context.active(), carrier, {
+        set(carrier, key, value) {
+            carrier[key] = value;
+        },
+    });
+    return carrier;
+}
+export function createChildSpan(name, headers) {
+    const tracer = getTracer();
+    const parentContext = extractTraceContext(headers);
+    return tracer.startSpan(name, {}, parentContext);
+}
+//# sourceMappingURL=tracer.js.map

package/dist/lib/tracing/tracer.js.map

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

package/dist/lib/utils/circuit-breaker.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Circuit Breaker Pattern Implementation
+ * Provides fault tolerance and prevents cascading failures
+ */
+export declare enum CircuitState {
+    CLOSED = "CLOSED",
+    OPEN = "OPEN",
+    HALF_OPEN = "HALF_OPEN"
+}
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    recoveryTimeout: number;
+    monitoringPeriod: number;
+}
+export declare class CircuitBreaker {
+    private state;
+    private failureCount;
+    private lastFailureTime;
+    private config;
+    constructor(config: CircuitBreakerConfig);
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    private onSuccess;
+    private onFailure;
+    getState(): CircuitState;
+    getFailureCount(): number;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/lib/utils/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../lib/utils/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,EAAE,oBAAoB;IAIlC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAmBlD,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,SAAS;IASjB,QAAQ,IAAI,YAAY;IAIxB,eAAe,IAAI,MAAM;CAG1B"}

package/dist/lib/utils/circuit-breaker.js

@@ -0,0 +1,56 @@
+/**
+ * Circuit Breaker Pattern Implementation
+ * Provides fault tolerance and prevents cascading failures
+ */
+export var CircuitState;
+(function (CircuitState) {
+    CircuitState["CLOSED"] = "CLOSED";
+    CircuitState["OPEN"] = "OPEN";
+    CircuitState["HALF_OPEN"] = "HALF_OPEN";
+})(CircuitState || (CircuitState = {}));
+export class CircuitBreaker {
+    state = CircuitState.CLOSED;
+    failureCount = 0;
+    lastFailureTime = 0;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async execute(fn) {
+        if (this.state === CircuitState.OPEN) {
+            if (Date.now() - this.lastFailureTime > this.config.recoveryTimeout) {
+                this.state = CircuitState.HALF_OPEN;
+            }
+            else {
+                throw new Error('Circuit breaker is OPEN - service unavailable');
+            }
+        }
+        try {
+            const result = await fn();
+            this.onSuccess();
+            return result;
+        }
+        catch (error) {
+            this.onFailure();
+            throw error;
+        }
+    }
+    onSuccess() {
+        this.failureCount = 0;
+        this.state = CircuitState.CLOSED;
+    }
+    onFailure() {
+        this.failureCount++;
+        this.lastFailureTime = Date.now();
+        if (this.failureCount >= this.config.failureThreshold) {
+            this.state = CircuitState.OPEN;
+        }
+    }
+    getState() {
+        return this.state;
+    }
+    getFailureCount() {
+        return this.failureCount;
+    }
+}
+//# sourceMappingURL=circuit-breaker.js.map

package/dist/lib/utils/circuit-breaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../../lib/utils/circuit-breaker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;IACb,uCAAuB,CAAA;AACzB,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB;AAQD,MAAM,OAAO,cAAc;IACjB,KAAK,GAAiB,YAAY,CAAC,MAAM,CAAC;IAC1C,YAAY,GAAG,CAAC,CAAC;IACjB,eAAe,GAAG,CAAC,CAAC;IACpB,MAAM,CAAuB;IAErC,YAAY,MAA4B;QACtC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAO,CAAI,EAAoB;QACnC,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,CAAC,IAAI,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;gBACpE,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC;IACnC,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAElC,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;YACtD,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC;QACjC,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;CACF"}

package/dist/lib/utils/request-id.d.ts

@@ -0,0 +1,3 @@
+export declare function generateRequestId(): string;
+export declare function isValidRequestId(requestId: string): boolean;
+//# sourceMappingURL=request-id.d.ts.map

package/dist/lib/utils/request-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-id.d.ts","sourceRoot":"","sources":["../../../lib/utils/request-id.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG3D"}

package/dist/lib/utils/request-id.js

@@ -0,0 +1,9 @@
+import { randomUUID } from 'crypto';
+export function generateRequestId() {
+    return randomUUID();
+}
+export function isValidRequestId(requestId) {
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(requestId);
+}
+//# sourceMappingURL=request-id.js.map

package/dist/lib/utils/request-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-id.js","sourceRoot":"","sources":["../../../lib/utils/request-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC,MAAM,UAAU,iBAAiB;IAC/B,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,MAAM,SAAS,GAAG,wEAAwE,CAAC;IAC3F,OAAO,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC"}

package/dist/lib/utils/retry-manager.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Retry Mechanism with Exponential Backoff
+ * Provides automatic retry for transient failures
+ */
+export interface RetryConfig {
+    maxAttempts: number;
+    baseDelay: number;
+    maxDelay: number;
+    backoffMultiplier: number;
+    jitter: boolean;
+}
+export declare class RetryManager {
+    private config;
+    constructor(config: RetryConfig);
+    execute<T>(fn: () => Promise<T>, isRetryableError?: (error: Error) => boolean): Promise<T>;
+    private calculateDelay;
+    private sleep;
+}
+export declare const RetryConfigs: {
+    readonly FAST: {
+        readonly maxAttempts: 3;
+        readonly baseDelay: 100;
+        readonly maxDelay: 1000;
+        readonly backoffMultiplier: 2;
+        readonly jitter: true;
+    };
+    readonly STANDARD: {
+        readonly maxAttempts: 5;
+        readonly baseDelay: 500;
+        readonly maxDelay: 5000;
+        readonly backoffMultiplier: 2;
+        readonly jitter: true;
+    };
+    readonly SLOW: {
+        readonly maxAttempts: 3;
+        readonly baseDelay: 2000;
+        readonly maxDelay: 10000;
+        readonly backoffMultiplier: 2;
+        readonly jitter: true;
+    };
+};
+//# sourceMappingURL=retry-manager.d.ts.map

package/dist/lib/utils/retry-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-manager.d.ts","sourceRoot":"","sources":["../../../lib/utils/retry-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAc;gBAEhB,MAAM,EAAE,WAAW;IAIzB,OAAO,CAAC,CAAC,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,gBAAgB,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,GAC3C,OAAO,CAAC,CAAC,CAAC;IA2Bb,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,KAAK;CAGd;AAED,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;CAwBf,CAAC"}