@danielsimonjr/memoryjs 1.0.0 → 1.1.0

package/dist/utils/MemoryMonitor.js

@@ -1,306 +0,0 @@
-/**
- * Memory Usage Monitor
- *
- * Phase 12 Sprint 6: Track memory usage across all components
- * with human-readable formatting.
- *
- * @module utils/MemoryMonitor
- */
-/**
- * Default memory thresholds.
- */
-const DEFAULT_THRESHOLDS = {
-    warning: 100 * 1024 * 1024, // 100 MB
-    critical: 500 * 1024 * 1024, // 500 MB
-};
-/**
- * Memory Monitor for tracking usage across components.
- *
- * @example
- * ```typescript
- * const monitor = new MemoryMonitor();
- *
- * // Register components
- * monitor.registerComponent('entities', () => entities.length * 500);
- * monitor.registerComponent('vectors', () => vectors.size * dimension * 4);
- *
- * // Get usage stats
- * const stats = monitor.getUsage();
- * console.log(`Total memory: ${stats.totalFormatted}`);
- *
- * // Check for alerts
- * const alerts = monitor.checkThresholds();
- * ```
- */
-export class MemoryMonitor {
-    componentEstimators;
-    itemCounters;
-    thresholds;
-    listeners;
-    lastUsage = null;
-    constructor(thresholds) {
-        this.componentEstimators = new Map();
-        this.itemCounters = new Map();
-        this.thresholds = { ...DEFAULT_THRESHOLDS, ...thresholds };
-        this.listeners = [];
-    }
-    /**
-     * Register a component for memory tracking.
-     *
-     * @param name - Component name
-     * @param estimator - Function that returns estimated bytes
-     * @param itemCounter - Optional function that returns item count
-     */
-    registerComponent(name, estimator, itemCounter) {
-        this.componentEstimators.set(name, estimator);
-        if (itemCounter) {
-            this.itemCounters.set(name, itemCounter);
-        }
-    }
-    /**
-     * Unregister a component.
-     *
-     * @param name - Component name
-     */
-    unregisterComponent(name) {
-        this.componentEstimators.delete(name);
-        this.itemCounters.delete(name);
-    }
-    /**
-     * Get current memory usage statistics.
-     */
-    getUsage() {
-        const components = [];
-        let totalBytes = 0;
-        for (const [name, estimator] of this.componentEstimators) {
-            const bytes = estimator();
-            totalBytes += bytes;
-            const itemCounter = this.itemCounters.get(name);
-            const itemCount = itemCounter ? itemCounter() : undefined;
-            const bytesPerItem = itemCount && itemCount > 0 ? Math.round(bytes / itemCount) : undefined;
-            components.push({
-                name,
-                bytes,
-                itemCount,
-                bytesPerItem,
-            });
-        }
-        // Sort by usage descending
-        components.sort((a, b) => b.bytes - a.bytes);
-        // Get Node.js heap stats if available
-        let heapStats;
-        if (typeof process !== 'undefined' && process.memoryUsage) {
-            const mem = process.memoryUsage();
-            heapStats = {
-                heapUsed: mem.heapUsed,
-                heapTotal: mem.heapTotal,
-                external: mem.external,
-                rss: mem.rss,
-            };
-        }
-        const stats = {
-            totalBytes,
-            totalFormatted: this.formatBytes(totalBytes),
-            components,
-            timestamp: new Date(),
-            heapStats,
-        };
-        this.lastUsage = stats;
-        this.notifyListeners(stats);
-        return stats;
-    }
-    /**
-     * Get memory usage for a specific component.
-     *
-     * @param name - Component name
-     */
-    getComponentUsage(name) {
-        const estimator = this.componentEstimators.get(name);
-        if (!estimator)
-            return undefined;
-        const bytes = estimator();
-        const itemCounter = this.itemCounters.get(name);
-        const itemCount = itemCounter ? itemCounter() : undefined;
-        const bytesPerItem = itemCount && itemCount > 0 ? Math.round(bytes / itemCount) : undefined;
-        return {
-            name,
-            bytes,
-            itemCount,
-            bytesPerItem,
-        };
-    }
-    /**
-     * Check memory thresholds and return alerts.
-     */
-    checkThresholds() {
-        const alerts = [];
-        const usage = this.getUsage();
-        // Check total memory
-        if (usage.totalBytes >= this.thresholds.critical) {
-            alerts.push({
-                level: 'critical',
-                component: 'total',
-                currentBytes: usage.totalBytes,
-                threshold: this.thresholds.critical,
-                message: `Total memory usage (${this.formatBytes(usage.totalBytes)}) exceeds critical threshold (${this.formatBytes(this.thresholds.critical)})`,
-            });
-        }
-        else if (usage.totalBytes >= this.thresholds.warning) {
-            alerts.push({
-                level: 'warning',
-                component: 'total',
-                currentBytes: usage.totalBytes,
-                threshold: this.thresholds.warning,
-                message: `Total memory usage (${this.formatBytes(usage.totalBytes)}) exceeds warning threshold (${this.formatBytes(this.thresholds.warning)})`,
-            });
-        }
-        // Check per-component thresholds (50% of total threshold per component)
-        const componentWarning = this.thresholds.warning * 0.5;
-        const componentCritical = this.thresholds.critical * 0.5;
-        for (const component of usage.components) {
-            if (component.bytes >= componentCritical) {
-                alerts.push({
-                    level: 'critical',
-                    component: component.name,
-                    currentBytes: component.bytes,
-                    threshold: componentCritical,
-                    message: `Component '${component.name}' (${this.formatBytes(component.bytes)}) exceeds critical threshold`,
-                });
-            }
-            else if (component.bytes >= componentWarning) {
-                alerts.push({
-                    level: 'warning',
-                    component: component.name,
-                    currentBytes: component.bytes,
-                    threshold: componentWarning,
-                    message: `Component '${component.name}' (${this.formatBytes(component.bytes)}) exceeds warning threshold`,
-                });
-            }
-        }
-        return alerts;
-    }
-    /**
-     * Set memory thresholds.
-     *
-     * @param thresholds - New threshold values
-     */
-    setThresholds(thresholds) {
-        this.thresholds = { ...this.thresholds, ...thresholds };
-    }
-    /**
-     * Get current thresholds.
-     */
-    getThresholds() {
-        return { ...this.thresholds };
-    }
-    /**
-     * Add a listener for memory changes.
-     *
-     * @param callback - Callback to invoke on memory changes
-     */
-    addListener(callback) {
-        this.listeners.push(callback);
-    }
-    /**
-     * Remove a listener.
-     *
-     * @param callback - Callback to remove
-     */
-    removeListener(callback) {
-        const index = this.listeners.indexOf(callback);
-        if (index !== -1) {
-            this.listeners.splice(index, 1);
-        }
-    }
-    /**
-     * Get a human-readable summary of memory usage.
-     */
-    getSummary() {
-        const usage = this.getUsage();
-        const lines = [
-            '=== Memory Usage Summary ===',
-            `Total: ${usage.totalFormatted}`,
-            '',
-            'By Component:',
-        ];
-        for (const component of usage.components) {
-            const itemInfo = component.itemCount
-                ? ` (${component.itemCount.toLocaleString()} items, ~${this.formatBytes(component.bytesPerItem ?? 0)}/item)`
-                : '';
-            lines.push(`  ${component.name}: ${this.formatBytes(component.bytes)}${itemInfo}`);
-        }
-        if (usage.heapStats) {
-            lines.push('');
-            lines.push('Node.js Heap:');
-            lines.push(`  Heap Used: ${this.formatBytes(usage.heapStats.heapUsed)}`);
-            lines.push(`  Heap Total: ${this.formatBytes(usage.heapStats.heapTotal)}`);
-            lines.push(`  External: ${this.formatBytes(usage.heapStats.external)}`);
-            lines.push(`  RSS: ${this.formatBytes(usage.heapStats.rss)}`);
-        }
-        return lines.join('\n');
-    }
-    /**
-     * Get the last recorded usage without triggering a new measurement.
-     */
-    getLastUsage() {
-        return this.lastUsage;
-    }
-    /**
-     * Format bytes as human-readable string.
-     *
-     * @param bytes - Number of bytes
-     */
-    formatBytes(bytes) {
-        if (bytes === 0)
-            return '0 B';
-        const units = ['B', 'KB', 'MB', 'GB', 'TB'];
-        const k = 1024;
-        const i = Math.floor(Math.log(bytes) / Math.log(k));
-        const value = bytes / Math.pow(k, i);
-        return `${value.toFixed(i === 0 ? 0 : 2)} ${units[i]}`;
-    }
-    /**
-     * Parse a formatted byte string back to number.
-     *
-     * @param formatted - Formatted string like "10 MB"
-     */
-    parseBytes(formatted) {
-        const match = formatted.match(/^([\d.]+)\s*(B|KB|MB|GB|TB)$/i);
-        if (!match)
-            return 0;
-        const value = parseFloat(match[1]);
-        const unit = match[2].toUpperCase();
-        const units = {
-            'B': 1,
-            'KB': 1024,
-            'MB': 1024 * 1024,
-            'GB': 1024 * 1024 * 1024,
-            'TB': 1024 * 1024 * 1024 * 1024,
-        };
-        return value * (units[unit] ?? 1);
-    }
-    /**
-     * Clear all registered components.
-     */
-    clear() {
-        this.componentEstimators.clear();
-        this.itemCounters.clear();
-        this.lastUsage = null;
-    }
-    // Private methods
-    notifyListeners(usage) {
-        for (const listener of this.listeners) {
-            try {
-                listener(usage);
-            }
-            catch {
-                // Ignore listener errors
-            }
-        }
-    }
-}
-/**
- * Singleton instance for global memory monitoring.
- */
-export const globalMemoryMonitor = new MemoryMonitor();
-//# sourceMappingURL=MemoryMonitor.js.map

package/dist/utils/MemoryMonitor.js.map

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

package/dist/utils/WorkerPoolManager.d.ts

@@ -1,233 +0,0 @@
-/**
- * Worker Pool Manager
- *
- * Phase 12 Sprint 2: Unified worker pool management for all parallelizable operations.
- * Provides centralized lifecycle management, configuration, and statistics.
- *
- * @module utils/WorkerPoolManager
- */
-import type { Pool, PoolStats } from '@danielsimonjr/workerpool';
-/**
- * Configuration options for worker pools.
- */
-export interface WorkerPoolConfig {
-    /** Maximum number of worker threads (default: CPU count - 1) */
-    maxWorkers?: number;
-    /** Worker type: 'thread' or 'process' (default: 'thread') */
-    workerType?: 'thread' | 'process';
-    /** Optional path to worker script file */
-    workerPath?: string;
-    /** Minimum array size to use parallel processing (default: 200) */
-    minParallelSize?: number;
-    /** Default task timeout in milliseconds (default: 30000) */
-    defaultTimeout?: number;
-}
-/**
- * Extended pool statistics with additional metadata.
- */
-export interface ExtendedPoolStats extends PoolStats {
-    /** Pool identifier */
-    poolId: string;
-    /** When the pool was created */
-    createdAt: number;
-    /** Total tasks executed since creation */
-    totalTasksExecuted: number;
-    /** Total execution time in milliseconds */
-    totalExecutionTime: number;
-    /** Average task execution time in milliseconds */
-    averageExecutionTime: number;
-}
-/**
- * Callback for pool events.
- */
-export type PoolEventCallback = (poolId: string, event: 'created' | 'shutdown' | 'error', data?: unknown) => void;
-/**
- * WorkerPoolManager - Unified worker pool management
- *
- * Provides centralized management of worker pools for parallel processing.
- * Features:
- * - Named pool registration with automatic lifecycle management
- * - Pool cleanup on process exit
- * - Statistics tracking per pool
- * - Event callbacks for monitoring
- *
- * @example
- * ```typescript
- * const manager = WorkerPoolManager.getInstance();
- *
- * // Get or create a pool
- * const pool = manager.getPool('fuzzySearch', {
- *   maxWorkers: 4,
- *   workerPath: '/path/to/worker.js'
- * });
- *
- * // Execute task
- * const result = await pool.exec('searchEntities', [data]);
- *
- * // Get statistics
- * const stats = manager.getPoolStats('fuzzySearch');
- *
- * // Shutdown all pools on exit
- * await manager.shutdownAll();
- * ```
- */
-export declare class WorkerPoolManager {
-    private static instance;
-    private pools;
-    private eventCallbacks;
-    private isShuttingDown;
-    private shutdownRegistered;
-    /**
-     * Private constructor for singleton pattern.
-     */
-    private constructor();
-    /**
-     * Get the singleton instance of WorkerPoolManager.
-     *
-     * @returns The WorkerPoolManager instance
-     */
-    static getInstance(): WorkerPoolManager;
-    /**
-     * Reset the singleton instance (primarily for testing).
-     */
-    static resetInstance(): void;
-    /**
-     * Register process exit handlers for cleanup.
-     */
-    private registerShutdownHandlers;
-    /**
-     * Get or create a named worker pool.
-     *
-     * If a pool with the given ID exists, returns the existing pool.
-     * Otherwise, creates a new pool with the provided configuration.
-     *
-     * @param poolId - Unique identifier for the pool
-     * @param config - Pool configuration options
-     * @returns The worker pool instance
-     */
-    getPool(poolId: string, config?: WorkerPoolConfig): Pool;
-    /**
-     * Create a new worker pool with the given ID.
-     *
-     * @param poolId - Unique identifier for the pool
-     * @param config - Pool configuration options
-     * @returns The newly created worker pool
-     * @throws Error if a pool with the same ID already exists
-     */
-    createPool(poolId: string, config?: WorkerPoolConfig): Pool;
-    /**
-     * Check if a pool with the given ID exists.
-     *
-     * @param poolId - Pool identifier to check
-     * @returns True if pool exists
-     */
-    hasPool(poolId: string): boolean;
-    /**
-     * Get the configuration for a pool.
-     *
-     * @param poolId - Pool identifier
-     * @returns Pool configuration or undefined if not found
-     */
-    getPoolConfig(poolId: string): WorkerPoolConfig | undefined;
-    /**
-     * Get extended statistics for a pool.
-     *
-     * @param poolId - Pool identifier
-     * @returns Extended pool statistics or undefined if not found
-     */
-    getPoolStats(poolId: string): ExtendedPoolStats | undefined;
-    /**
-     * Get statistics for all pools.
-     *
-     * @returns Map of pool IDs to their statistics
-     */
-    getAllPoolStats(): Map<string, ExtendedPoolStats>;
-    /**
-     * Record task execution for statistics tracking.
-     *
-     * @param poolId - Pool identifier
-     * @param executionTimeMs - Task execution time in milliseconds
-     */
-    recordTaskExecution(poolId: string, executionTimeMs: number): void;
-    /**
-     * Execute a task on a pool with automatic statistics tracking.
-     *
-     * @template T - Result type
-     * @param poolId - Pool identifier
-     * @param method - Method name to execute (for worker script pools) or inline function
-     * @param args - Arguments to pass to the method/function
-     * @param timeout - Optional timeout in milliseconds
-     * @returns Promise resolving to the task result
-     */
-    executeTask<T>(poolId: string, method: string | ((...args: unknown[]) => T), args?: unknown[], timeout?: number): Promise<T>;
-    /**
-     * Shutdown a specific pool.
-     *
-     * @param poolId - Pool identifier
-     * @param force - If true, forcefully terminate workers (default: false)
-     * @returns Promise resolving when shutdown is complete
-     */
-    shutdownPool(poolId: string, force?: boolean): Promise<void>;
-    /**
-     * Shutdown all pools asynchronously.
-     *
-     * @param force - If true, forcefully terminate workers (default: false)
-     * @returns Promise resolving when all pools are shut down
-     */
-    shutdownAll(force?: boolean): Promise<void>;
-    /**
-     * Synchronous shutdown for process exit handlers.
-     * Forces immediate termination of all pools.
-     */
-    private shutdownAllSync;
-    /**
-     * Register an event callback for pool events.
-     *
-     * @param callback - Callback function to invoke on events
-     * @returns Unsubscribe function
-     */
-    onEvent(callback: PoolEventCallback): () => void;
-    /**
-     * Emit an event to all registered callbacks.
-     */
-    private emitEvent;
-    /**
-     * Get the number of active pools.
-     *
-     * @returns Number of pools currently managed
-     */
-    get poolCount(): number;
-    /**
-     * Get all pool IDs.
-     *
-     * @returns Array of pool identifiers
-     */
-    getPoolIds(): string[];
-    /**
-     * Check if the minimum parallel size threshold is met.
-     *
-     * @param poolId - Pool identifier
-     * @param size - Size of the data to process
-     * @returns True if size meets or exceeds minimum threshold
-     */
-    shouldUseParallel(poolId: string, size: number): boolean;
-    /**
-     * Get the default configuration values.
-     *
-     * @returns Copy of default configuration
-     */
-    static getDefaultConfig(): Required<WorkerPoolConfig>;
-    /**
-     * Get the CPU count available for workers.
-     *
-     * @returns Number of CPUs
-     */
-    static getCpuCount(): number;
-}
-/**
- * Convenience function to get the WorkerPoolManager instance.
- *
- * @returns The WorkerPoolManager singleton
- */
-export declare function getWorkerPoolManager(): WorkerPoolManager;
-//# sourceMappingURL=WorkerPoolManager.d.ts.map

package/dist/utils/WorkerPoolManager.d.ts.map

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