bootifyjs 1.2.0 → 1.2.1

package/dist/events/retry/retry-handler.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RetryHandler = void 0;
+/**
+ * Handles retry logic with exponential backoff for failed events
+ */
+class RetryHandler {
+    constructor(config) {
+        this.deadLetterQueue = [];
+        this.retryStats = {
+            totalRetries: 0,
+            successfulRetries: 0,
+            failedRetries: 0,
+            deadLetterCount: 0,
+            averageRetryDelay: 0
+        };
+        this.config = config;
+    }
+    /**
+     * Handle event with retry logic
+     * @param event Event to process
+     * @param handler Event handler function
+     * @returns Promise that resolves when event is processed or moved to DLQ
+     */
+    async handleWithRetry(event, handler) {
+        const retryableEvent = this.createRetryableEvent(event);
+        for (let attempt = 0; attempt <= this.config.retryAttempts; attempt++) {
+            try {
+                // Update retry count
+                retryableEvent.retryCount = attempt;
+                // Execute handler
+                await handler.handle(retryableEvent);
+                // Success - update stats and return
+                if (attempt > 0) {
+                    this.retryStats.successfulRetries++;
+                }
+                return;
+            }
+            catch (error) {
+                const retryAttempt = {
+                    attempt,
+                    timestamp: Date.now(),
+                    error: error
+                };
+                retryableEvent.retryAttempts.push(retryAttempt);
+                retryableEvent.lastError = error;
+                this.retryStats.totalRetries++;
+                // Check if we should retry
+                if (attempt < this.config.retryAttempts) {
+                    const delay = this.calculateRetryDelay(attempt);
+                    retryAttempt.nextRetryAt = Date.now() + delay;
+                    console.warn(`Event ${retryableEvent.type} failed (attempt ${attempt + 1}/${this.config.retryAttempts + 1}). ` +
+                        `Retrying in ${delay}ms. Error:`, error);
+                    await this.delay(delay);
+                }
+                else {
+                    // Max retries exceeded - move to dead letter queue
+                    this.moveToDeadLetterQueue(retryableEvent, error);
+                    this.retryStats.failedRetries++;
+                    console.error(`Event ${retryableEvent.type} failed after ${this.config.retryAttempts + 1} attempts. ` +
+                        `Moved to dead letter queue. Final error:`, error);
+                    throw new Error(`Event processing failed after ${this.config.retryAttempts + 1} attempts`);
+                }
+            }
+        }
+    }
+    /**
+     * Calculate retry delay using exponential backoff with jitter
+     * @param attempt Current attempt number (0-based)
+     * @returns Delay in milliseconds
+     */
+    calculateRetryDelay(attempt) {
+        // Use configured delays if available
+        if (attempt < this.config.retryDelays.length) {
+            const baseDelay = this.config.retryDelays[attempt];
+            // Add jitter (±25% of base delay)
+            const jitter = baseDelay * 0.25 * (Math.random() - 0.5);
+            return Math.max(100, baseDelay + jitter); // Minimum 100ms
+        }
+        // Fallback to exponential backoff
+        const baseDelay = 1000; // 1 second
+        const exponentialDelay = baseDelay * Math.pow(2, attempt);
+        const maxDelay = 30000; // 30 seconds max
+        // Add jitter
+        const jitter = exponentialDelay * 0.25 * (Math.random() - 0.5);
+        return Math.min(maxDelay, Math.max(100, exponentialDelay + jitter));
+    }
+    /**
+     * Create retryable event from regular event
+     */
+    createRetryableEvent(event) {
+        return {
+            ...event,
+            retryCount: event.retryCount || 0,
+            retryAttempts: [],
+            maxRetries: this.config.retryAttempts
+        };
+    }
+    /**
+     * Move event to dead letter queue
+     */
+    moveToDeadLetterQueue(event, finalError) {
+        const deadLetterEntry = {
+            event,
+            finalError,
+            timestamp: Date.now(),
+            totalAttempts: event.retryAttempts.length
+        };
+        this.deadLetterQueue.push(deadLetterEntry);
+        this.retryStats.deadLetterCount++;
+        // Limit DLQ size to prevent memory issues
+        const maxDLQSize = 1000;
+        if (this.deadLetterQueue.length > maxDLQSize) {
+            this.deadLetterQueue.shift(); // Remove oldest entry
+        }
+    }
+    /**
+     * Get dead letter queue entries
+     */
+    getDeadLetterQueue() {
+        return [...this.deadLetterQueue];
+    }
+    /**
+     * Get retry statistics
+     */
+    getRetryStats() {
+        // Calculate average retry delay
+        if (this.retryStats.totalRetries > 0) {
+            const totalDelay = this.config.retryDelays.reduce((sum, delay) => sum + delay, 0);
+            this.retryStats.averageRetryDelay = totalDelay / this.config.retryDelays.length;
+        }
+        return { ...this.retryStats };
+    }
+    /**
+     * Clear dead letter queue
+     */
+    clearDeadLetterQueue() {
+        this.deadLetterQueue.length = 0;
+        this.retryStats.deadLetterCount = 0;
+    }
+    /**
+     * Reprocess events from dead letter queue
+     * @param handler Event handler to use for reprocessing
+     * @param maxEvents Maximum number of events to reprocess
+     */
+    async reprocessDeadLetterQueue(handler, maxEvents = 10) {
+        const eventsToProcess = this.deadLetterQueue.splice(0, maxEvents);
+        let processed = 0;
+        let failed = 0;
+        for (const entry of eventsToProcess) {
+            try {
+                // Reset retry count for reprocessing
+                const event = {
+                    ...entry.event,
+                    retryCount: 0,
+                    retryAttempts: [],
+                    lastError: undefined
+                };
+                await this.handleWithRetry(event, handler);
+                processed++;
+                this.retryStats.deadLetterCount--;
+            }
+            catch (error) {
+                // Put back in DLQ if still failing
+                this.deadLetterQueue.push(entry);
+                failed++;
+                console.error('Failed to reprocess dead letter event:', error);
+            }
+        }
+        return { processed, failed };
+    }
+    /**
+     * Check if event should be retried based on error type
+     */
+    shouldRetry(error) {
+        // Don't retry certain types of errors
+        const nonRetryableErrors = [
+            'ValidationError',
+            'AuthenticationError',
+            'AuthorizationError',
+            'SyntaxError',
+            'TypeError'
+        ];
+        return !nonRetryableErrors.includes(error.constructor.name);
+    }
+    /**
+     * Delay execution for specified milliseconds
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    /**
+     * Reset retry statistics
+     */
+    resetStats() {
+        this.retryStats = {
+            totalRetries: 0,
+            successfulRetries: 0,
+            failedRetries: 0,
+            deadLetterCount: this.deadLetterQueue.length,
+            averageRetryDelay: 0
+        };
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(config) {
+        this.config = config;
+    }
+}
+exports.RetryHandler = RetryHandler;
+//# sourceMappingURL=retry-handler.js.map

package/dist/events/retry/retry-handler.js.map

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

package/dist/events/shared-buffer.d.ts

@@ -0,0 +1,92 @@
+import { IEvent } from './event.types';
+/**
+ * Priority levels for events
+ */
+export type EventPriority = 'critical' | 'normal' | 'low';
+/**
+ * Extended event interface with priority and metadata
+ */
+export interface PriorityEvent extends IEvent {
+    priority?: EventPriority;
+    timestamp?: number;
+    retryCount?: number;
+}
+/**
+ * Configuration for shared buffer
+ */
+export interface SharedBufferConfig {
+    maxEvents: number;
+    maxEventSize: number;
+    totalMemoryMB: number;
+}
+/**
+ * Thread-safe circular buffer for event processing
+ * Uses SharedArrayBuffer for zero-copy inter-thread communication
+ */
+export declare class SharedEventBuffer {
+    private buffer;
+    private writeIndex;
+    private readIndex;
+    private eventCount;
+    private eventData;
+    private maxEvents;
+    private maxEventSize;
+    private eventSlotSize;
+    constructor(config?: SharedBufferConfig);
+    /**
+     * Enqueue an event to the buffer (thread-safe)
+     * @param event Event to enqueue
+     * @returns true if successful, false if buffer is full
+     */
+    enqueue(event: PriorityEvent): boolean;
+    /**
+     * Dequeue an event from the buffer (thread-safe)
+     * @returns Event or null if buffer is empty
+     */
+    dequeue(): PriorityEvent | null;
+    /**
+     * Get current queue size
+     */
+    size(): number;
+    /**
+     * Check if buffer is full
+     */
+    isFull(): boolean;
+    /**
+     * Check if buffer is empty
+     */
+    isEmpty(): boolean;
+    /**
+     * Get buffer utilization percentage
+     */
+    getUtilization(): number;
+    /**
+     * Get buffer statistics
+     */
+    getStats(): {
+        size: number;
+        maxEvents: number;
+        utilization: number;
+        isFull: boolean;
+        isEmpty: boolean;
+        writeIndex: number;
+        readIndex: number;
+    };
+    /**
+     * Serialize event to Uint8Array
+     */
+    private serializeEvent;
+    /**
+     * Deserialize event from Uint8Array
+     */
+    private deserializeEvent;
+    /**
+     * Clear all events from buffer (for testing/debugging)
+     */
+    clear(): void;
+    /**
+     * Get the underlying SharedArrayBuffer (for worker initialization)
+     */
+    getSharedBuffer(): SharedArrayBuffer;
+}
+//# sourceMappingURL=shared-buffer.d.ts.map

package/dist/events/shared-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-buffer.d.ts","sourceRoot":"","sources":["../../src/events/shared-buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,KAAK,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,MAAM;IAC3C,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAS;gBAElB,MAAM,GAAE,kBAInB;IA6BD;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IAmCtC;;;OAGG;IACH,OAAO,IAAI,aAAa,GAAG,IAAI;IA0C/B;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,QAAQ;;;;;;;;;IAYR;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,eAAe,IAAI,iBAAiB;CAGrC"}

package/dist/events/shared-buffer.js

@@ -0,0 +1,179 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SharedEventBuffer = void 0;
+/**
+ * Thread-safe circular buffer for event processing
+ * Uses SharedArrayBuffer for zero-copy inter-thread communication
+ */
+class SharedEventBuffer {
+    constructor(config = {
+        maxEvents: 10000,
+        maxEventSize: 5120, // 5KB
+        totalMemoryMB: 50
+    }) {
+        this.maxEvents = config.maxEvents;
+        this.maxEventSize = config.maxEventSize;
+        // Calculate slot size (event size + metadata)
+        this.eventSlotSize = this.maxEventSize + 64; // Extra space for metadata
+        // Calculate total buffer size
+        const metadataSize = 12; // 3 Int32 values (writeIndex, readIndex, eventCount)
+        const dataSize = this.maxEvents * this.eventSlotSize;
+        const totalSize = metadataSize + dataSize;
+        // Create shared buffer
+        this.buffer = new SharedArrayBuffer(totalSize);
+        // Initialize metadata arrays
+        this.writeIndex = new Int32Array(this.buffer, 0, 1);
+        this.readIndex = new Int32Array(this.buffer, 4, 1);
+        this.eventCount = new Int32Array(this.buffer, 8, 1);
+        // Initialize event data array
+        this.eventData = new Uint8Array(this.buffer, metadataSize);
+        // Initialize indices
+        Atomics.store(this.writeIndex, 0, 0);
+        Atomics.store(this.readIndex, 0, 0);
+        Atomics.store(this.eventCount, 0, 0);
+    }
+    /**
+     * Enqueue an event to the buffer (thread-safe)
+     * @param event Event to enqueue
+     * @returns true if successful, false if buffer is full
+     */
+    enqueue(event) {
+        // Check if buffer is full
+        const currentCount = Atomics.load(this.eventCount, 0);
+        if (currentCount >= this.maxEvents) {
+            return false; // Buffer full
+        }
+        // Serialize event
+        const serializedEvent = this.serializeEvent(event);
+        if (serializedEvent.length > this.maxEventSize) {
+            throw new Error(`Event size ${serializedEvent.length} exceeds maximum ${this.maxEventSize}`);
+        }
+        // Get current write position
+        const writePos = Atomics.load(this.writeIndex, 0);
+        const slotOffset = writePos * this.eventSlotSize;
+        // Write event size first (4 bytes)
+        const sizeView = new Int32Array(this.buffer, 12 + slotOffset, 1);
+        Atomics.store(sizeView, 0, serializedEvent.length);
+        // Write event data
+        const eventView = new Uint8Array(this.buffer, 12 + slotOffset + 4, serializedEvent.length);
+        eventView.set(serializedEvent);
+        // Update write index atomically
+        const nextWritePos = (writePos + 1) % this.maxEvents;
+        Atomics.store(this.writeIndex, 0, nextWritePos);
+        // Increment event count
+        Atomics.add(this.eventCount, 0, 1);
+        return true;
+    }
+    /**
+     * Dequeue an event from the buffer (thread-safe)
+     * @returns Event or null if buffer is empty
+     */
+    dequeue() {
+        // Check if buffer is empty
+        const currentCount = Atomics.load(this.eventCount, 0);
+        if (currentCount === 0) {
+            return null;
+        }
+        // Get current read position
+        const readPos = Atomics.load(this.readIndex, 0);
+        const slotOffset = readPos * this.eventSlotSize;
+        // Read event size
+        const sizeView = new Int32Array(this.buffer, 12 + slotOffset, 1);
+        const eventSize = Atomics.load(sizeView, 0);
+        if (eventSize === 0 || eventSize > this.maxEventSize) {
+            // Invalid event size, skip this slot
+            const nextReadPos = (readPos + 1) % this.maxEvents;
+            Atomics.store(this.readIndex, 0, nextReadPos);
+            Atomics.sub(this.eventCount, 0, 1);
+            return null;
+        }
+        // Read event data
+        const eventView = new Uint8Array(this.buffer, 12 + slotOffset + 4, eventSize);
+        const eventData = new Uint8Array(eventSize);
+        eventData.set(eventView);
+        // Update read index atomically
+        const nextReadPos = (readPos + 1) % this.maxEvents;
+        Atomics.store(this.readIndex, 0, nextReadPos);
+        // Decrement event count
+        Atomics.sub(this.eventCount, 0, 1);
+        // Clear the slot
+        Atomics.store(sizeView, 0, 0);
+        // Deserialize and return event
+        return this.deserializeEvent(eventData);
+    }
+    /**
+     * Get current queue size
+     */
+    size() {
+        return Atomics.load(this.eventCount, 0);
+    }
+    /**
+     * Check if buffer is full
+     */
+    isFull() {
+        return this.size() >= this.maxEvents;
+    }
+    /**
+     * Check if buffer is empty
+     */
+    isEmpty() {
+        return this.size() === 0;
+    }
+    /**
+     * Get buffer utilization percentage
+     */
+    getUtilization() {
+        return (this.size() / this.maxEvents) * 100;
+    }
+    /**
+     * Get buffer statistics
+     */
+    getStats() {
+        return {
+            size: this.size(),
+            maxEvents: this.maxEvents,
+            utilization: this.getUtilization(),
+            isFull: this.isFull(),
+            isEmpty: this.isEmpty(),
+            writeIndex: Atomics.load(this.writeIndex, 0),
+            readIndex: Atomics.load(this.readIndex, 0)
+        };
+    }
+    /**
+     * Serialize event to Uint8Array
+     */
+    serializeEvent(event) {
+        // Add timestamp and priority if not present
+        const enrichedEvent = {
+            ...event,
+            timestamp: event.timestamp || Date.now(),
+            priority: event.priority || 'normal',
+            retryCount: event.retryCount || 0
+        };
+        const jsonString = JSON.stringify(enrichedEvent);
+        return new TextEncoder().encode(jsonString);
+    }
+    /**
+     * Deserialize event from Uint8Array
+     */
+    deserializeEvent(data) {
+        const jsonString = new TextDecoder().decode(data);
+        return JSON.parse(jsonString);
+    }
+    /**
+     * Clear all events from buffer (for testing/debugging)
+     */
+    clear() {
+        Atomics.store(this.writeIndex, 0, 0);
+        Atomics.store(this.readIndex, 0, 0);
+        Atomics.store(this.eventCount, 0, 0);
+    }
+    /**
+     * Get the underlying SharedArrayBuffer (for worker initialization)
+     */
+    getSharedBuffer() {
+        return this.buffer;
+    }
+}
+exports.SharedEventBuffer = SharedEventBuffer;
+//# sourceMappingURL=shared-buffer.js.map

package/dist/events/shared-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-buffer.js","sourceRoot":"","sources":["../../src/events/shared-buffer.ts"],"names":[],"mappings":";;;AAyBA;;;GAGG;AACH,MAAa,iBAAiB;IAU5B,YAAY,SAA6B;QACvC,SAAS,EAAE,KAAK;QAChB,YAAY,EAAE,IAAI,EAAE,MAAM;QAC1B,aAAa,EAAE,EAAE;KAClB;QACC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;QAExC,8CAA8C;QAC9C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC,CAAC,2BAA2B;QAExE,8BAA8B;QAC9B,MAAM,YAAY,GAAG,EAAE,CAAC,CAAC,qDAAqD;QAC9E,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC;QACrD,MAAM,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;QAE1C,uBAAuB;QACvB,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAE/C,6BAA6B;QAC7B,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEpD,8BAA8B;QAC9B,IAAI,CAAC,SAAS,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QAE3D,qBAAqB;QACrB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,KAAoB;QAC1B,0BAA0B;QAC1B,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACtD,IAAI,YAAY,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC,CAAC,cAAc;QAC9B,CAAC;QAED,kBAAkB;QAClB,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACnD,IAAI,eAAe,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,cAAc,eAAe,CAAC,MAAM,oBAAoB,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC/F,CAAC;QAED,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAClD,MAAM,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC;QAEjD,mCAAmC;QACnC,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC;QACjE,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;QAEnD,mBAAmB;QACnB,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,UAAU,GAAG,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;QAC3F,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAE/B,gCAAgC;QAChC,MAAM,YAAY,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;QAEhD,wBAAwB;QACxB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,2BAA2B;QAC3B,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACtD,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,4BAA4B;QAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC;QAEhD,kBAAkB;QAClB,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAE5C,IAAI,SAAS,KAAK,CAAC,IAAI,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACrD,qCAAqC;YACrC,MAAM,WAAW,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YACnD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,kBAAkB;QAClB,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,GAAG,UAAU,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9E,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;QAC5C,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEzB,+BAA+B;QAC/B,MAAM,WAAW,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;QACnD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;QAE9C,wBAAwB;QACxB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEnC,iBAAiB;QACjB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAE9B,+BAA+B;QAC/B,OAAO,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,IAAI,CAAC,cAAc,EAAE;YAClC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;YACvB,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YAC5C,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;SAC3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,KAAoB;QACzC,4CAA4C;QAC5C,MAAM,aAAa,GAAG;YACpB,GAAG,KAAK;YACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;YACxC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,QAAQ;YACpC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;SAClC,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACjD,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,IAAgB;QACvC,MAAM,UAAU,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAkB,CAAC;IACjD,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACrC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACpC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAnND,8CAmNC"}

package/dist/events/worker/event-processor.worker.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Event processor worker implementation
+ */
+declare class EventProcessorWorker {
+    private workerId;
+    private config;
+    private buffer;
+    private retryHandler;
+    private handlers;
+    private isRunning;
+    private isShuttingDown;
+    private eventsProcessed;
+    private eventsSucceeded;
+    private eventsFailed;
+    private processingTimes;
+    private startTime;
+    private lastActivity;
+    private healthCheckInterval?;
+    private processingLoop?;
+    constructor();
+    /**
+     * Setup message handling with main thread
+     */
+    private setupMessageHandling;
+    /**
+     * Handle messages from main thread
+     */
+    private handleMessage;
+    /**
+     * Initialize worker with configuration and shared buffer
+     */
+    private initialize;
+    /**
+     * Register event handler
+     */
+    private registerHandler;
+    /**
+     * Start the main event processing loop
+     */
+    private startProcessingLoop;
+    /**
+     * Process a single event
+     */
+    private processEvent;
+    /**
+     * Start health monitoring
+     */
+    private startHealthMonitoring;
+    /**
+     * Send health status to main thread
+     */
+    private sendHealthStatus;
+    /**
+     * Send worker statistics
+     */
+    private sendStats;
+    /**
+     * Shutdown worker gracefully
+     */
+    private shutdown;
+    /**
+     * Send message to main thread
+     */
+    private sendMessage;
+    /**
+     * Send error message to main thread
+     */
+    private sendError;
+    /**
+     * Sleep for specified milliseconds
+     */
+    private sleep;
+}
+export { EventProcessorWorker };
+//# sourceMappingURL=event-processor.worker.d.ts.map

package/dist/events/worker/event-processor.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-processor.worker.d.ts","sourceRoot":"","sources":["../../../src/events/worker/event-processor.worker.ts"],"names":[],"mappings":"AAqCA;;GAEG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAyC;IACzD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;IAG/B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAAc;IAGlC,OAAO,CAAC,mBAAmB,CAAC,CAAiB;IAC7C,OAAO,CAAC,cAAc,CAAC,CAAgB;;IAOvC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA2B5B;;OAEG;YACW,aAAa;IA2B3B;;OAEG;YACW,UAAU;IAwBxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;YACW,mBAAmB;IA0BjC;;OAEG;YACW,YAAY;IA8C1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8BxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;YACW,QAAQ;IA6BtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd;AAOD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}