@plyaz/api 1.0.2 → 1.1.1

package/dist/api/queue/BaseOperationTracker.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Base Operation Tracker
+ *
+ * Abstract base class for tracking operations across the API.
+ * Provides common functionality that can be extended by domain-specific trackers.
+ */
+import { QueueFactory } from './QueueFactory';
+import type { QueueSystem } from './QueueSystem';
+import type { QueueStats, PriorityLevelValue, BaseOperation } from '@plyaz/types/api';
+/**
+ * Operation priority detection function type
+ */
+export type PriorityDetector<T extends BaseOperation> = (operation: T) => PriorityLevelValue;
+/**
+ * Source detection function type
+ */
+export type SourceDetector = () => string;
+/**
+ * Abstract base class for operation trackers
+ */
+export declare abstract class BaseOperationTracker<T extends BaseOperation> {
+    protected readonly queueName: string;
+    protected readonly priorityDetector: PriorityDetector<T>;
+    protected readonly sourceDetector: SourceDetector;
+    protected queue: ReturnType<typeof QueueFactory.createTrackingQueue<T>> | null;
+    protected processor?: (op: T) => void | Promise<void>;
+    protected isReady: boolean;
+    constructor(queueName: string, priorityDetector: PriorityDetector<T>, sourceDetector: SourceDetector);
+    /**
+     * Get or create the queue
+     */
+    protected getQueue(): QueueSystem<T>;
+    /**
+     * Track an operation
+     */
+    track(operation: string, event: string, metadata?: Record<string, unknown>, options?: {
+        priority?: PriorityLevelValue;
+        source?: string;
+    }): void;
+    /**
+     * Create an operation object - can be overridden by subclasses
+     */
+    protected createOperation(operation: string, event: string, metadata: Record<string, unknown>, options?: {
+        priority?: PriorityLevelValue;
+        source?: string;
+    }): T;
+    /**
+     * Set the processor for operations
+     */
+    setProcessor(processor: (op: T) => void | Promise<void>): void;
+    /**
+     * Process a single operation
+     */
+    protected processOperation(op: {
+        data: T;
+    }): Promise<void>;
+    /**
+     * Handle processing errors - can be overridden by subclasses
+     */
+    protected handleProcessingError(error: unknown, operation: T): void;
+    /**
+     * Get queue statistics
+     */
+    getStats(): QueueStats;
+    /**
+     * Reset the tracker
+     */
+    reset(): void;
+    /**
+     * Check if ready to process
+     */
+    isProcessorReady(): boolean;
+    /**
+     * Get queue name
+     */
+    getQueueName(): string;
+}
+/**
+ * Default priority detection based on operation and event strings
+ */
+export declare function createDefaultPriorityDetector<T extends BaseOperation>(): PriorityDetector<T>;
+/**
+ * Default source detection using stack trace analysis
+ */
+export declare function createDefaultSourceDetector(): SourceDetector;
+//# sourceMappingURL=BaseOperationTracker.d.ts.map

package/dist/api/queue/BaseOperationTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseOperationTracker.d.ts","sourceRoot":"","sources":["../../../src/api/queue/BaseOperationTracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,aAAa,IAAI,CAAC,SAAS,EAAE,CAAC,KAAK,kBAAkB,CAAC;AAE7F;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC;AAE1C;;GAEG;AACH,8BAAsB,oBAAoB,CAAC,CAAC,SAAS,aAAa;IAM9D,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM;IACpC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACxD,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc;IAPnD,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAQ;IACtF,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,SAAS,CAAC,OAAO,UAAS;gBAGL,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC,EACrC,cAAc,EAAE,cAAc;IAKnD;;OAEG;IACH,SAAS,CAAC,QAAQ,IAAI,WAAW,CAAC,CAAC,CAAC;IAQpC;;OAEG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACtC,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,kBAAkB,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,IAAI;IAUP;;OAEG;IACH,SAAS,CAAC,eAAe,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,OAAO,CAAC,EAAE;QACR,QAAQ,CAAC,EAAE,kBAAkB,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA,CAAC;IAUJ;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAS9D;;OAEG;cACa,gBAAgB,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAahE;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI;IAWnE;;OAEG;IACH,QAAQ,IAAI,UAAU;IAiBtB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,aAAa,KAAK,gBAAgB,CAAC,CAAC,CAAC,CA+C5F;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,cAAc,CAa5D"}

package/dist/api/queue/BaseQueueManager.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Base Queue Manager
+ *
+ * Abstract base class for all queue managers providing common functionality
+ * and enforcing singleton pattern.
+ */
+import { QueueSystem } from './QueueSystem';
+import type { QueueConfig, QueueStats, QueueOperation } from '@plyaz/types/api';
+import { EventEmitter } from 'events';
+/**
+ * Base class for queue managers
+ */
+export declare abstract class BaseQueueManager<T = unknown> extends EventEmitter {
+    protected queue: QueueSystem<T>;
+    protected config: QueueConfig;
+    protected constructor(config: QueueConfig);
+    /**
+     * Enqueue an operation
+     */
+    enqueue(operation: T): Promise<string>;
+    /**
+     * Dequeue the next operation
+     */
+    dequeue(): T | null;
+    /**
+     * Get queue size
+     */
+    size(): number;
+    /**
+     * Get all operations (for stats/debugging)
+     */
+    getAllOperations(): T[];
+    /**
+     * Get queue statistics
+     */
+    getStats(): QueueStats;
+    /**
+     * Reset the queue
+     */
+    reset(): void;
+    /**
+     * Destroy the queue
+     */
+    destroy(): void;
+    /**
+     * Abstract method to create queue operation from input
+     */
+    protected abstract createQueueOperation(operation: T): QueueOperation<T>;
+    /**
+     * Abstract method to process operations
+     */
+    protected abstract processOperation(operation: T): Promise<void>;
+}
+//# sourceMappingURL=BaseQueueManager.d.ts.map

package/dist/api/queue/BaseQueueManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseQueueManager.d.ts","sourceRoot":"","sources":["../../../src/api/queue/BaseQueueManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC;;GAEG;AACH,8BAAsB,gBAAgB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,YAAY;IACtE,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;IAE9B,SAAS,aAAa,MAAM,EAAE,WAAW;IAMzC;;OAEG;IACU,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAUnD;;OAEG;IACI,OAAO,IAAI,CAAC,GAAG,IAAI;IAM1B;;OAEG;IACI,IAAI,IAAI,MAAM;IAIrB;;OAEG;IACI,gBAAgB,IAAI,CAAC,EAAE;IAK9B;;OAEG;IACI,QAAQ,IAAI,UAAU;IAI7B;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACI,OAAO,IAAI,IAAI;IAItB;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC,SAAS,EAAE,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC;IAExE;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CACjE"}

package/dist/api/queue/BatchProcessor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Batch Processor for Queue Operations
+ *
+ * Efficiently processes operations in batches to reduce overhead
+ * and improve throughput.
+ */
+import type { BatchProcessorConfig, QueueOperation } from '@plyaz/types/api';
+/**
+ * Batch processor implementation
+ */
+export declare class BatchProcessor<T = unknown> {
+    private batch;
+    private timer?;
+    private readonly config;
+    private processing;
+    constructor(config: BatchProcessorConfig<T>);
+    /**
+     * Add operation to the current batch
+     */
+    add(operation: QueueOperation<T>): void;
+    /**
+     * Schedule batch flush
+     */
+    private scheduleFlush;
+    /**
+     * Flush the current batch
+     */
+    flush(): Promise<void>;
+    /**
+     * Get current batch size
+     */
+    size(): number;
+    /**
+     * Clear pending batch
+     */
+    clear(): void;
+    /**
+     * Destroy the processor
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=BatchProcessor.d.ts.map

package/dist/api/queue/BatchProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BatchProcessor.d.ts","sourceRoot":"","sources":["../../../src/api/queue/BatchProcessor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE7E;;GAEG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO;IACrC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,KAAK,CAAC,CAAkC;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0B;IACjD,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAI3C;;OAEG;IACI,GAAG,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAU9C;;OAEG;IACH,OAAO,CAAC,aAAa;IASrB;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBnC;;OAEG;IACI,IAAI,IAAI,MAAM;IAIrB;;OAEG;IACI,KAAK,IAAI,IAAI;IAQpB;;OAEG;IACI,OAAO,IAAI,IAAI;CAGvB"}

package/dist/api/queue/EventQueueManager.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Event Queue Manager
+ * Manages priority-based event processing queue that integrates with the configuration priority system
+ */
+import { BaseQueueManager } from './BaseQueueManager';
+import type { QueueOperation, QueueConfig, ConfigUpdateStrategy, DebuggerConfigSource, EventQueueOperation } from '@plyaz/types/api';
+import { PRIORITY_LEVEL } from '@plyaz/types/api';
+import { EventManager } from '../events/EventManager';
+/**
+ * Priority mapping from config priority to queue priority
+ */
+export declare class ConfigPriorityMapper {
+    /**
+     * Map configuration scope to queue priority
+     */
+    static scopeToPriority(scope: 'global' | 'client' | 'request' | 'temporary'): (typeof PRIORITY_LEVEL)[keyof typeof PRIORITY_LEVEL];
+    /**
+     * Map configuration update strategy to queue priority
+     */
+    static strategyToPriority(strategy: ConfigUpdateStrategy): (typeof PRIORITY_LEVEL)[keyof typeof PRIORITY_LEVEL];
+    /**
+     * Map configuration source to queue priority
+     */
+    static sourceToPriority(source: DebuggerConfigSource): (typeof PRIORITY_LEVEL)[keyof typeof PRIORITY_LEVEL];
+    /**
+     * Calculate combined priority from multiple factors
+     * Takes the highest priority from all factors
+     */
+    static calculateCombinedPriority(scope?: 'global' | 'client' | 'request' | 'temporary', strategy?: ConfigUpdateStrategy, source?: DebuggerConfigSource, explicitPriority?: number): (typeof PRIORITY_LEVEL)[keyof typeof PRIORITY_LEVEL];
+}
+/**
+ * Event Queue Manager
+ * Provides priority-based event processing with integration to configuration priority system
+ */
+export declare class EventQueueManager extends BaseQueueManager<EventQueueOperation> {
+    private readonly eventManager;
+    private readonly processingCallbacks;
+    constructor(config?: QueueConfig & {
+        eventManager?: EventManager;
+    });
+    /**
+     * Create queue operation from EventQueueOperation
+     */
+    protected createQueueOperation(operation: EventQueueOperation): QueueOperation<EventQueueOperation>;
+    /**
+     * Queue an event with automatic priority calculation
+     */
+    queueEvent<TEventData = unknown>(eventType: string, eventData: TEventData, options?: {
+        scope?: 'global' | 'client' | 'request' | 'temporary';
+        configSource?: DebuggerConfigSource;
+        updateStrategy?: ConfigUpdateStrategy;
+        explicitPriority?: number;
+        correlationId?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<string>;
+    /**
+     * Register a processing callback for a specific event type
+     */
+    registerProcessor(eventType: string, processor: (operation: EventQueueOperation) => Promise<void>): void;
+    /**
+     * Remove a processing callback
+     */
+    unregisterProcessor(eventType: string): void;
+    /**
+     * Process a single operation (implementing abstract method)
+     */
+    protected processOperation(operation: EventQueueOperation): Promise<void>;
+    /**
+     * Process a queue operation (for QueueProcessor interface)
+     */
+    private processQueueOperation;
+    /**
+     * Process a single event operation
+     */
+    private processEventOperation;
+    /**
+     * Default event processing when no specific processor is registered
+     */
+    private defaultEventProcessing;
+    /**
+     * Handle processing errors with retry logic
+     */
+    private handleProcessingError;
+    /**
+     * Setup automatic processing based on queue configuration
+     */
+    private setupAutomaticProcessing;
+    /**
+     * Process a batch of operations
+     */
+    private processBatch;
+    /**
+     * Process the next operation in the queue
+     */
+    private processNext;
+    /**
+     * Generate a unique operation ID
+     */
+    private generateOperationId;
+    /**
+     * Get queue statistics specific to events
+     */
+    getEventStats(): {
+        totalEvents: number;
+        eventsByType: Record<string, number>;
+        eventsByPriority: Record<(typeof PRIORITY_LEVEL)[keyof typeof PRIORITY_LEVEL], number>;
+        eventsByScope: Record<string, number>;
+        averageProcessingTime: number;
+        processedCount: number;
+        errorCount: number;
+    };
+}
+/**
+ * Get or create the default event queue manager instance
+ * @returns The default event queue manager
+ */
+export declare function getDefaultEventQueue(): EventQueueManager;
+/**
+ * Get or create the config event queue manager instance
+ * @returns The config event queue manager
+ */
+export declare function getConfigEventQueue(): EventQueueManager;
+/**
+ * Get or create the network event queue manager instance
+ * @returns The network event queue manager
+ */
+export declare function getNetworkEventQueue(): EventQueueManager;
+//# sourceMappingURL=EventQueueManager.d.ts.map

package/dist/api/queue/EventQueueManager.d.ts.map

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

package/dist/api/queue/PriorityQueue.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Priority Queue Implementation
+ *
+ * A min-heap based priority queue for efficient priority-based processing
+ */
+import type { QueueOperation } from '@plyaz/types/api';
+/**
+ * Priority queue using min-heap for O(log n) operations
+ */
+export declare class PriorityQueue<T = unknown> {
+    private heap;
+    /**
+     * Add operation to the priority queue
+     */
+    enqueue(operation: QueueOperation<T>): void;
+    /**
+     * Remove and return the highest priority operation
+     */
+    dequeue(): QueueOperation<T> | undefined;
+    /**
+     * Peek at the highest priority operation without removing
+     */
+    peek(): QueueOperation<T> | undefined;
+    /**
+     * Get queue size
+     */
+    size(): number;
+    /**
+     * Check if queue is empty
+     */
+    isEmpty(): boolean;
+    /**
+     * Clear the queue
+     */
+    clear(): void;
+    /**
+     * Bubble up element to maintain heap property
+     */
+    private bubbleUp;
+    /**
+     * Bubble down element to maintain heap property
+     */
+    private bubbleDown;
+    /**
+     * Compare two operations for priority
+     * Returns negative if a has higher priority, positive if b has higher priority
+     */
+    private compare;
+    /**
+     * Swap two elements in the heap
+     */
+    private swap;
+    /**
+     * Get all operations in priority order (non-destructive)
+     */
+    toArray(): QueueOperation<T>[];
+}
+//# sourceMappingURL=PriorityQueue.d.ts.map

package/dist/api/queue/PriorityQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PriorityQueue.d.ts","sourceRoot":"","sources":["../../../src/api/queue/PriorityQueue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAavD;;GAEG;AACH,qBAAa,aAAa,CAAC,CAAC,GAAG,OAAO;IACpC,OAAO,CAAC,IAAI,CAA2B;IAEvC;;OAEG;IACI,OAAO,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAKlD;;OAEG;IACI,OAAO,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS;IAc/C;;OAEG;IACI,IAAI,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS;IAI5C;;OAEG;IACI,IAAI,IAAI,MAAM;IAIrB;;OAEG;IACI,OAAO,IAAI,OAAO;IAIzB;;OAEG;IACI,KAAK,IAAI,IAAI;IAIpB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAehB;;OAEG;IACH,OAAO,CAAC,UAAU;IAyBlB;;;OAGG;IACH,OAAO,CAAC,OAAO;IAaf;;OAEG;IACH,OAAO,CAAC,IAAI;IAIZ;;OAEG;IACI,OAAO,IAAI,cAAc,CAAC,CAAC,CAAC,EAAE;CAItC"}

package/dist/api/queue/QueueFactory.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Queue Factory for Easy Queue Creation
+ *
+ * Provides factory methods for creating different types of queues
+ * with optimized configurations.
+ */
+import { QueueSystem } from './QueueSystem';
+import type { QueueConfig } from '@plyaz/types/api';
+/**
+ * Factory for creating queue instances
+ */
+export declare class QueueFactory {
+    private static queues;
+    private static defaultStrategy;
+    /**
+     * Set default strategy for all new queues
+     * Used primarily for testing to avoid async processing
+     */
+    static setDefaultStrategy(strategy: 'immediate' | 'batch' | 'throttle' | 'debounce'): void;
+    /**
+     * Create or get a singleton queue
+     */
+    static getQueue<T = unknown>(name: string, config?: Partial<QueueConfig>): QueueSystem<T>;
+    /**
+     * Create a high-performance event queue
+     */
+    static createEventQueue<T = unknown>(name: string): QueueSystem<T>;
+    /**
+     * Create a tracking queue for analytics
+     */
+    static createTrackingQueue<T = unknown>(name: string): QueueSystem<T>;
+    /**
+     * Create a real-time queue for immediate processing
+     */
+    static createRealtimeQueue<T = unknown>(name: string): QueueSystem<T>;
+    /**
+     * Create a throttled queue for rate limiting
+     */
+    static createThrottledQueue<T = unknown>(name: string, ratePerSecond: number): QueueSystem<T>;
+    /**
+     * Create a debounced queue for reducing noise
+     */
+    static createDebouncedQueue<T = unknown>(name: string, delay: number): QueueSystem<T>;
+    /**
+     * Destroy a singleton queue
+     */
+    static destroyQueue(name: string): void;
+    /**
+     * Destroy all singleton queues
+     */
+    static destroyAll(): void;
+    /**
+     * Get statistics for all queues
+     */
+    static getAllStats(): Record<string, ReturnType<QueueSystem['getStats']>>;
+}
+//# sourceMappingURL=QueueFactory.d.ts.map

package/dist/api/queue/QueueFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueFactory.d.ts","sourceRoot":"","sources":["../../../src/api/queue/QueueFactory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;GAEG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAuC;IAC5D,OAAO,CAAC,MAAM,CAAC,eAAe,CAA4D;IAE1F;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI;IAI1F;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC;IAazF;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;IAqBlE;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;IAqBrE;;OAEG;IACH,MAAM,CAAC,mBAAmB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;IAmBrE;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;IAoB7F;;OAEG;IACH,MAAM,CAAC,oBAAoB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;IAoBrF;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQvC;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAOzB;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;CAO1E"}

package/dist/api/queue/QueueOrchestrator.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Queue Orchestrator
+ *
+ * Centralized management of all queue systems in the API package.
+ * Provides unified control, monitoring, and coordination between different queues.
+ */
+import { DebuggerQueueManager, OperationTracker } from '../debugger/queue';
+import { EventQueueManager, ConfigUpdateQueueManager } from '../events/queue';
+import type { OrchestratorConfig, QueueHealth, QueueStats } from '@plyaz/types/api';
+/**
+ * Unified queue orchestrator
+ */
+export declare class QueueOrchestrator {
+    private static instance;
+    private readonly config;
+    private healthCheckTimer?;
+    private readonly registeredQueues;
+    private constructor();
+    /**
+     * Initialize configuration with defaults
+     */
+    private initializeConfig;
+    /**
+     * Register all core queues
+     */
+    private registerCoreQueues;
+    /**
+     * Get singleton instance
+     */
+    static getInstance(config?: OrchestratorConfig): QueueOrchestrator;
+    /**
+     * Initialize all queues
+     */
+    initialize(): void;
+    /**
+     * Register a queue for orchestration
+     */
+    registerQueue(name: string, queueManager: DebuggerQueueManager | EventQueueManager | ConfigUpdateQueueManager | OperationTracker): void;
+    /**
+     * Get all queue statistics
+     */
+    getAllStats(): Record<string, QueueStats>;
+    /**
+     * Check queue size health
+     */
+    private checkQueueSizeHealth;
+    /**
+     * Check failure rate health
+     */
+    private checkFailureRateHealth;
+    /**
+     * Check throughput health
+     */
+    private checkThroughputHealth;
+    /**
+     * Get queue health status
+     */
+    getQueueHealth(): QueueHealth[];
+    /**
+     * Start health monitoring
+     */
+    private startHealthMonitoring;
+    /**
+     * Auto-scale a queue based on load
+     */
+    private autoScaleQueue;
+    /**
+     * Stop health monitoring
+     */
+    stopHealthMonitoring(): void;
+    /**
+     * Reset all queues
+     */
+    resetAll(): void;
+    /**
+     * Destroy the orchestrator
+     */
+    destroy(): void;
+    /**
+     * Get performance metrics
+     */
+    getPerformanceMetrics(): {
+        totalQueued: number;
+        totalProcessed: number;
+        totalFailed: number;
+        avgProcessingTime: number;
+        avgThroughput: number;
+    };
+}
+//# sourceMappingURL=QueueOrchestrator.d.ts.map

package/dist/api/queue/QueueOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueOrchestrator.d.ts","sourceRoot":"","sources":["../../../src/api/queue/QueueOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAcpF;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,gBAAgB,CAAC,CAA4B;IACrD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAG7B;IAEJ,OAAO;IASP;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,iBAAiB;IAKlE;;OAEG;IACI,UAAU,IAAI,IAAI;IAiBzB;;OAEG;IACI,aAAa,CAClB,IAAI,EAAE,MAAM,EACZ,YAAY,EACR,oBAAoB,GACpB,iBAAiB,GACjB,wBAAwB,GACxB,gBAAgB,GACnB,IAAI;IAIP;;OAEG;IACI,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAkBhD;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACI,cAAc,IAAI,WAAW,EAAE;IAsBtC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACI,oBAAoB,IAAI,IAAI;IAOnC;;OAEG;IACI,QAAQ,IAAI,IAAI;IAYvB;;OAEG;IACI,OAAO,IAAI,IAAI;IAMtB;;OAEG;IACI,qBAAqB,IAAI;QAC9B,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,aAAa,EAAE,MAAM,CAAC;KACvB;CA2BF"}

package/dist/api/queue/QueueSystem.d.ts

@@ -0,0 +1,102 @@
+/**
+ * High-Performance Queue System
+ *
+ * Main queue implementation with support for multiple processing strategies
+ * and performance optimization.
+ */
+import type { QueueConfig, QueueOperation, QueueProcessor, BatchQueueProcessor, QueueStats } from '@plyaz/types/api';
+/**
+ * Main queue system implementation
+ */
+export declare class QueueSystem<T = unknown> {
+    private readonly config;
+    private queue;
+    private processor?;
+    private isReady;
+    private batchProcessor?;
+    private throttleTimer?;
+    private debounceTimer?;
+    private processedCount;
+    private failedCount;
+    private totalProcessingTime;
+    private lastProcessTime;
+    private enqueuedCount;
+    constructor(config: QueueConfig);
+    /**
+     * Initialize configuration with defaults
+     */
+    private initializeConfig;
+    /**
+     * Initialize queue based on priority setting
+     */
+    private initializeQueue;
+    /**
+     * Initialize batch processor if needed
+     */
+    private initializeBatchProcessor;
+    /**
+     * Add operation to the queue
+     */
+    add(operation: Omit<QueueOperation<T>, 'id' | 'timestamp'>): void;
+    /**
+     * Set the processor and mark queue as ready
+     */
+    setProcessor(processor: QueueProcessor<T> | BatchQueueProcessor<T>): void;
+    /**
+     * Enqueue operation with size management
+     */
+    private enqueue;
+    /**
+     * Process operation based on strategy
+     */
+    private processOperation;
+    /**
+     * Process immediately
+     */
+    private processImmediate;
+    /**
+     * Process with throttling
+     */
+    private processThrottled;
+    /**
+     * Process with debouncing
+     */
+    private processDebounced;
+    /**
+     * Process batch of operations
+     */
+    private processBatch;
+    /**
+     * Process all queued operations
+     */
+    private processQueued;
+    /**
+     * Drain all operations from queue
+     */
+    private drainQueue;
+    /**
+     * Record successful processing
+     */
+    private recordSuccess;
+    /**
+     * Record failed processing
+     */
+    private recordFailure;
+    /**
+     * Generate unique ID
+     */
+    private generateId;
+    /**
+     * Get queue statistics
+     */
+    getStats(): QueueStats;
+    /**
+     * Reset the queue
+     */
+    reset(): void;
+    /**
+     * Destroy the queue
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=QueueSystem.d.ts.map

package/dist/api/queue/QueueSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueSystem.d.ts","sourceRoot":"","sources":["../../../src/api/queue/QueueSystem.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,UAAU,EACX,MAAM,kBAAkB,CAAC;AAiB1B;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,SAAS,CAAC,CAA6C;IAC/D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAC,CAAoB;IAC3C,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAC,CAAiB;IAGvC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,aAAa,CAAK;gBAEd,MAAM,EAAE,WAAW;IAM/B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;OAEG;IACI,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,WAAW,CAAC,GAAG,IAAI;IAcxE;;OAEG;IACI,YAAY,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,GAAG,IAAI;IAMhF;;OAEG;IACH,OAAO,CAAC,OAAO;IAkBf;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAiBxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAgBlB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACH,OAAO,CAAC,UAAU;IAMlB;;OAEG;IACI,QAAQ,IAAI,UAAU;IAqB7B;;OAEG;IACI,KAAK,IAAI,IAAI;IAyBpB;;OAEG;IACI,OAAO,IAAI,IAAI;CAIvB"}