@danielsimonjr/memoryjs 1.0.0 → 1.2.0

package/dist/utils/operationUtils.d.ts

@@ -1,124 +0,0 @@
-/**
- * Operation Utilities
- *
- * Phase 9B: Utilities for long-running operations with progress tracking
- * and cancellation support.
- *
- * @module utils/operationUtils
- */
-import type { ProgressCallback } from './taskScheduler.js';
-/**
- * Check if an operation has been cancelled via AbortSignal.
- * Throws OperationCancelledError if the signal is aborted.
- *
- * @param signal - Optional AbortSignal to check
- * @param operation - Optional operation name for error message
- * @throws OperationCancelledError if signal is aborted
- *
- * @example
- * ```typescript
- * for (const item of items) {
- *   checkCancellation(options?.signal, 'batch processing');
- *   await processItem(item);
- * }
- * ```
- */
-export declare function checkCancellation(signal?: AbortSignal, operation?: string): void;
-/**
- * Create a throttled progress reporter to avoid excessive callback invocations.
- * Returns undefined if no callback is provided.
- *
- * @param callback - Optional progress callback to throttle
- * @param throttleMs - Minimum time between callbacks (default: 100ms)
- * @returns Throttled callback or undefined
- *
- * @example
- * ```typescript
- * const reportProgress = createProgressReporter(options?.onProgress, 50);
- * for (let i = 0; i < total; i++) {
- *   reportProgress?.({ completed: i, total, percentage: (i / total) * 100 });
- * }
- * ```
- */
-export declare function createProgressReporter(callback?: ProgressCallback, throttleMs?: number): ProgressCallback | undefined;
-/**
- * Create a progress object for reporting.
- *
- * @param completed - Number of completed items
- * @param total - Total number of items
- * @param currentTaskId - Optional current task identifier
- * @returns Progress object suitable for ProgressCallback
- *
- * @example
- * ```typescript
- * reportProgress?.(createProgress(50, 100, 'processing entities'));
- * // { completed: 50, total: 100, percentage: 50, currentTaskId: 'processing entities' }
- * ```
- */
-export declare function createProgress(completed: number, total: number, currentTaskId?: string): {
-    completed: number;
-    total: number;
-    percentage: number;
-    currentTaskId?: string;
-};
-/**
- * Phase definition for executeWithPhases.
- */
-export interface PhaseDefinition<T> {
-    /** Phase name (used for progress reporting and cancellation error messages) */
-    name: string;
-    /** Weight of this phase relative to others (higher = more of total progress) */
-    weight: number;
-    /** Executor function that performs the phase work */
-    execute: (phaseProgress: (pct: number) => void) => Promise<T>;
-}
-/**
- * Execute an operation with multiple distinct phases.
- * Useful when an operation has multiple distinct phases with different weights.
- *
- * @param phases - Array of phase definitions with weight and executor
- * @param onProgress - Optional progress callback
- * @param signal - Optional abort signal
- * @returns Array of results from each phase
- * @throws OperationCancelledError if cancelled during any phase
- *
- * @example
- * ```typescript
- * const [parseResult, processResult, saveResult] = await executeWithPhases([
- *   { name: 'parsing', weight: 20, execute: () => parseData() },
- *   { name: 'processing', weight: 60, execute: () => processEntities() },
- *   { name: 'saving', weight: 20, execute: () => saveResults() },
- * ], options?.onProgress, options?.signal);
- * ```
- */
-export declare function executeWithPhases<T>(phases: PhaseDefinition<T>[], onProgress?: ProgressCallback, signal?: AbortSignal): Promise<T[]>;
-/**
- * Execute an operation in batches with progress tracking and cancellation support.
- *
- * @param items - Array of items to process
- * @param batchSize - Size of each batch
- * @param processBatch - Function to process each batch
- * @param onProgress - Optional progress callback
- * @param signal - Optional abort signal
- * @param operationName - Optional operation name for cancellation error
- * @returns Array of results from all batches
- *
- * @example
- * ```typescript
- * const results = await processBatchesWithProgress(
- *   entities,
- *   100,
- *   async (batch) => {
- *     for (const entity of batch) {
- *       await saveEntity(entity);
- *     }
- *     return batch.length;
- *   },
- *   options?.onProgress,
- *   options?.signal,
- *   'createEntities'
- * );
- * ```
- */
-export declare function processBatchesWithProgress<T, R>(items: T[], batchSize: number, processBatch: (batch: T[], batchIndex: number) => Promise<R>, onProgress?: ProgressCallback, signal?: AbortSignal, operationName?: string): Promise<R[]>;
-//# sourceMappingURL=operationUtils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"operationUtils.d.ts","sourceRoot":"","sources":["../../src/utils/operationUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAIhF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,CAAC,EAAE,gBAAgB,EAC3B,UAAU,GAAE,MAAY,GACvB,gBAAgB,GAAG,SAAS,CAa9B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,GACrB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,CAOlF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,EAAE,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,EAC5B,UAAU,CAAC,EAAE,gBAAgB,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,CAAC,EAAE,CAAC,CAkCd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,0BAA0B,CAAC,CAAC,EAAE,CAAC,EACnD,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC5D,UAAU,CAAC,EAAE,gBAAgB,EAC7B,MAAM,CAAC,EAAE,WAAW,EACpB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,CAAC,EAAE,CAAC,CAqBd"}

package/dist/utils/operationUtils.js

@@ -1,176 +0,0 @@
-/**
- * Operation Utilities
- *
- * Phase 9B: Utilities for long-running operations with progress tracking
- * and cancellation support.
- *
- * @module utils/operationUtils
- */
-import { OperationCancelledError } from './errors.js';
-/**
- * Check if an operation has been cancelled via AbortSignal.
- * Throws OperationCancelledError if the signal is aborted.
- *
- * @param signal - Optional AbortSignal to check
- * @param operation - Optional operation name for error message
- * @throws OperationCancelledError if signal is aborted
- *
- * @example
- * ```typescript
- * for (const item of items) {
- *   checkCancellation(options?.signal, 'batch processing');
- *   await processItem(item);
- * }
- * ```
- */
-export function checkCancellation(signal, operation) {
-    if (signal?.aborted) {
-        throw new OperationCancelledError(operation);
-    }
-}
-/**
- * Create a throttled progress reporter to avoid excessive callback invocations.
- * Returns undefined if no callback is provided.
- *
- * @param callback - Optional progress callback to throttle
- * @param throttleMs - Minimum time between callbacks (default: 100ms)
- * @returns Throttled callback or undefined
- *
- * @example
- * ```typescript
- * const reportProgress = createProgressReporter(options?.onProgress, 50);
- * for (let i = 0; i < total; i++) {
- *   reportProgress?.({ completed: i, total, percentage: (i / total) * 100 });
- * }
- * ```
- */
-export function createProgressReporter(callback, throttleMs = 100) {
-    if (!callback)
-        return undefined;
-    let lastCallTime = 0;
-    return (progress) => {
-        const now = Date.now();
-        // Always report 0% and 100%
-        if (progress.percentage === 0 || progress.percentage >= 100 || now - lastCallTime >= throttleMs) {
-            lastCallTime = now;
-            callback(progress);
-        }
-    };
-}
-/**
- * Create a progress object for reporting.
- *
- * @param completed - Number of completed items
- * @param total - Total number of items
- * @param currentTaskId - Optional current task identifier
- * @returns Progress object suitable for ProgressCallback
- *
- * @example
- * ```typescript
- * reportProgress?.(createProgress(50, 100, 'processing entities'));
- * // { completed: 50, total: 100, percentage: 50, currentTaskId: 'processing entities' }
- * ```
- */
-export function createProgress(completed, total, currentTaskId) {
-    return {
-        completed,
-        total,
-        percentage: total > 0 ? Math.round((completed / total) * 100) : 0,
-        currentTaskId,
-    };
-}
-/**
- * Execute an operation with multiple distinct phases.
- * Useful when an operation has multiple distinct phases with different weights.
- *
- * @param phases - Array of phase definitions with weight and executor
- * @param onProgress - Optional progress callback
- * @param signal - Optional abort signal
- * @returns Array of results from each phase
- * @throws OperationCancelledError if cancelled during any phase
- *
- * @example
- * ```typescript
- * const [parseResult, processResult, saveResult] = await executeWithPhases([
- *   { name: 'parsing', weight: 20, execute: () => parseData() },
- *   { name: 'processing', weight: 60, execute: () => processEntities() },
- *   { name: 'saving', weight: 20, execute: () => saveResults() },
- * ], options?.onProgress, options?.signal);
- * ```
- */
-export async function executeWithPhases(phases, onProgress, signal) {
-    const totalWeight = phases.reduce((sum, p) => sum + p.weight, 0);
-    let completedWeight = 0;
-    const results = [];
-    for (const phase of phases) {
-        checkCancellation(signal, phase.name);
-        const phaseStartWeight = completedWeight;
-        const phaseProgress = (phasePct) => {
-            if (onProgress) {
-                const overallPct = ((phaseStartWeight + (phase.weight * phasePct / 100)) / totalWeight) * 100;
-                onProgress({
-                    completed: Math.round(overallPct),
-                    total: 100,
-                    percentage: Math.round(overallPct),
-                    currentTaskId: phase.name,
-                });
-            }
-        };
-        const result = await phase.execute(phaseProgress);
-        results.push(result);
-        completedWeight += phase.weight;
-    }
-    // Report 100% completion
-    onProgress?.({
-        completed: 100,
-        total: 100,
-        percentage: 100,
-    });
-    return results;
-}
-/**
- * Execute an operation in batches with progress tracking and cancellation support.
- *
- * @param items - Array of items to process
- * @param batchSize - Size of each batch
- * @param processBatch - Function to process each batch
- * @param onProgress - Optional progress callback
- * @param signal - Optional abort signal
- * @param operationName - Optional operation name for cancellation error
- * @returns Array of results from all batches
- *
- * @example
- * ```typescript
- * const results = await processBatchesWithProgress(
- *   entities,
- *   100,
- *   async (batch) => {
- *     for (const entity of batch) {
- *       await saveEntity(entity);
- *     }
- *     return batch.length;
- *   },
- *   options?.onProgress,
- *   options?.signal,
- *   'createEntities'
- * );
- * ```
- */
-export async function processBatchesWithProgress(items, batchSize, processBatch, onProgress, signal, operationName) {
-    const results = [];
-    const total = items.length;
-    let processed = 0;
-    const reportProgress = createProgressReporter(onProgress);
-    reportProgress?.(createProgress(0, total, operationName));
-    for (let i = 0; i < items.length; i += batchSize) {
-        checkCancellation(signal, operationName);
-        const batch = items.slice(i, i + batchSize);
-        const result = await processBatch(batch, Math.floor(i / batchSize));
-        results.push(result);
-        processed += batch.length;
-        reportProgress?.(createProgress(processed, total, operationName));
-    }
-    reportProgress?.(createProgress(total, total, operationName));
-    return results;
-}
-//# sourceMappingURL=operationUtils.js.map

package/dist/utils/operationUtils.js.map

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

package/dist/utils/parallelUtils.d.ts

@@ -1,76 +0,0 @@
-/**
- * Parallel Utilities
- *
- * Utilities for parallel array operations using workerpool.
- * Phase 8 Sprint 3: Parallel array operations for improved performance.
- *
- * **SECURITY WARNING:** These functions use `new Function()` internally for worker serialization.
- * The `fn` parameter MUST be a real function object, never a user-provided string.
- * Runtime validation ensures only function objects are accepted.
- *
- * @module utils/parallelUtils
- */
-import workerpool from '@danielsimonjr/workerpool';
-/**
- * Shutdown the shared worker pool and clean up resources.
- * Should be called when parallel utilities are no longer needed.
- */
-export declare function shutdownParallelUtils(): Promise<void>;
-/**
- * Map items in parallel using workerpool.
- *
- * Splits the array into chunks and processes each chunk in a worker thread.
- * Falls back to single-threaded for small arrays (< MIN_PARALLEL_SIZE).
- *
- * **Note:** The mapping function must be serializable (no closures, external variables).
- * Due to ESM/worker thread compatibility issues, this may fall back to single-threaded
- * execution in some environments (e.g., vitest test runner).
- *
- * @template T - Input item type
- * @template R - Output item type
- * @param items - Array of items to map
- * @param fn - Mapping function (must be serializable)
- * @param chunkSize - Optional chunk size (default: DEFAULT_CHUNK_SIZE)
- * @returns Promise resolving to array of mapped results
- *
- * @example
- * ```typescript
- * // Map numbers to their squares
- * const numbers = [1, 2, 3, 4, 5];
- * const squared = await parallelMap(numbers, (n: number) => n * n);
- * // Result: [1, 4, 9, 16, 25]
- * ```
- */
-export declare function parallelMap<T, R>(items: T[], fn: (item: T) => R, chunkSize?: number): Promise<R[]>;
-/**
- * Filter items in parallel using workerpool.
- *
- * Splits the array into chunks and processes each chunk in a worker thread.
- * Falls back to single-threaded for small arrays (< MIN_PARALLEL_SIZE).
- *
- * **Note:** The predicate function must be serializable (no closures, external variables).
- * Due to ESM/worker thread compatibility issues, this may fall back to single-threaded
- * execution in some environments (e.g., vitest test runner).
- *
- * @template T - Item type
- * @param items - Array of items to filter
- * @param predicate - Filter predicate (must be serializable)
- * @param chunkSize - Optional chunk size (default: DEFAULT_CHUNK_SIZE)
- * @returns Promise resolving to filtered array
- *
- * @example
- * ```typescript
- * // Filter even numbers
- * const numbers = [1, 2, 3, 4, 5, 6];
- * const evens = await parallelFilter(numbers, (n: number) => n % 2 === 0);
- * // Result: [2, 4, 6]
- * ```
- */
-export declare function parallelFilter<T>(items: T[], predicate: (item: T) => boolean, chunkSize?: number): Promise<T[]>;
-/**
- * Get statistics about the worker pool.
- *
- * @returns Pool statistics or null if pool is not initialized
- */
-export declare function getPoolStats(): workerpool.PoolStats | null;
-//# sourceMappingURL=parallelUtils.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"parallelUtils.d.ts","sourceRoot":"","sources":["../../src/utils/parallelUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,UAAU,MAAM,2BAA2B,CAAC;AAmDnD;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC,CAK3D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,CAAC,EACpC,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAClB,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,CAAC,EAAE,CAAC,CA2Cd;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,KAAK,EAAE,CAAC,EAAE,EACV,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,EAC/B,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,CAAC,EAAE,CAAC,CA2Cd;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,UAAU,CAAC,SAAS,GAAG,IAAI,CAK1D"}

package/dist/utils/parallelUtils.js

@@ -1,192 +0,0 @@
-/**
- * Parallel Utilities
- *
- * Utilities for parallel array operations using workerpool.
- * Phase 8 Sprint 3: Parallel array operations for improved performance.
- *
- * **SECURITY WARNING:** These functions use `new Function()` internally for worker serialization.
- * The `fn` parameter MUST be a real function object, never a user-provided string.
- * Runtime validation ensures only function objects are accepted.
- *
- * @module utils/parallelUtils
- */
-import workerpool from '@danielsimonjr/workerpool';
-/**
- * Validates that the input is a real function object.
- * Prevents code injection through string masquerading as functions.
- *
- * @param fn - Function to validate
- * @param paramName - Parameter name for error message
- * @throws {TypeError} If fn is not a function
- * @internal
- */
-function validateFunction(fn, paramName) {
-    if (typeof fn !== 'function') {
-        throw new TypeError(`${paramName} must be a function, got ${typeof fn}`);
-    }
-}
-/**
- * Default chunk size for parallel operations.
- * Can be overridden per operation.
- */
-const DEFAULT_CHUNK_SIZE = 100;
-/**
- * Minimum array size to activate parallel processing.
- * For smaller arrays, single-threaded is more efficient due to worker overhead.
- */
-const MIN_PARALLEL_SIZE = 200;
-/**
- * Shared worker pool instance for all parallel utilities.
- * Initialized lazily on first use.
- */
-let sharedPool = null;
-/**
- * Get or create the shared worker pool.
- * Uses inline worker execution (no separate worker file needed).
- *
- * @returns Worker pool instance
- */
-function getPool() {
-    if (!sharedPool) {
-        sharedPool = workerpool.pool({
-            maxWorkers: Math.max(1, workerpool.cpus - 1),
-            workerType: 'thread',
-        });
-    }
-    return sharedPool;
-}
-/**
- * Shutdown the shared worker pool and clean up resources.
- * Should be called when parallel utilities are no longer needed.
- */
-export async function shutdownParallelUtils() {
-    if (sharedPool) {
-        await sharedPool.terminate();
-        sharedPool = null;
-    }
-}
-/**
- * Map items in parallel using workerpool.
- *
- * Splits the array into chunks and processes each chunk in a worker thread.
- * Falls back to single-threaded for small arrays (< MIN_PARALLEL_SIZE).
- *
- * **Note:** The mapping function must be serializable (no closures, external variables).
- * Due to ESM/worker thread compatibility issues, this may fall back to single-threaded
- * execution in some environments (e.g., vitest test runner).
- *
- * @template T - Input item type
- * @template R - Output item type
- * @param items - Array of items to map
- * @param fn - Mapping function (must be serializable)
- * @param chunkSize - Optional chunk size (default: DEFAULT_CHUNK_SIZE)
- * @returns Promise resolving to array of mapped results
- *
- * @example
- * ```typescript
- * // Map numbers to their squares
- * const numbers = [1, 2, 3, 4, 5];
- * const squared = await parallelMap(numbers, (n: number) => n * n);
- * // Result: [1, 4, 9, 16, 25]
- * ```
- */
-export async function parallelMap(items, fn, chunkSize = DEFAULT_CHUNK_SIZE) {
-    // Security: Validate that fn is a real function, not a user-provided string
-    validateFunction(fn, 'fn');
-    // Fall back to single-threaded for small arrays
-    if (items.length < MIN_PARALLEL_SIZE) {
-        return items.map(fn);
-    }
-    try {
-        const pool = getPool();
-        // Split items into chunks
-        const chunks = [];
-        for (let i = 0; i < items.length; i += chunkSize) {
-            chunks.push(items.slice(i, i + chunkSize));
-        }
-        // Convert function to string for serialization
-        const fnString = fn.toString();
-        // Process chunks in parallel using inline function execution
-        const results = await Promise.all(chunks.map(chunk => pool.exec((chunkData, fnStr) => {
-            // Reconstruct function from string
-            // eslint-disable-next-line no-new-func
-            const mapFn = new Function('return ' + fnStr)();
-            return chunkData.map(mapFn);
-        }, [chunk, fnString])));
-        // Flatten results
-        return results.flat();
-    }
-    catch (error) {
-        // Fall back to single-threaded if worker execution fails
-        // (e.g., in test environments with ESM/worker compatibility issues)
-        return items.map(fn);
-    }
-}
-/**
- * Filter items in parallel using workerpool.
- *
- * Splits the array into chunks and processes each chunk in a worker thread.
- * Falls back to single-threaded for small arrays (< MIN_PARALLEL_SIZE).
- *
- * **Note:** The predicate function must be serializable (no closures, external variables).
- * Due to ESM/worker thread compatibility issues, this may fall back to single-threaded
- * execution in some environments (e.g., vitest test runner).
- *
- * @template T - Item type
- * @param items - Array of items to filter
- * @param predicate - Filter predicate (must be serializable)
- * @param chunkSize - Optional chunk size (default: DEFAULT_CHUNK_SIZE)
- * @returns Promise resolving to filtered array
- *
- * @example
- * ```typescript
- * // Filter even numbers
- * const numbers = [1, 2, 3, 4, 5, 6];
- * const evens = await parallelFilter(numbers, (n: number) => n % 2 === 0);
- * // Result: [2, 4, 6]
- * ```
- */
-export async function parallelFilter(items, predicate, chunkSize = DEFAULT_CHUNK_SIZE) {
-    // Security: Validate that predicate is a real function, not a user-provided string
-    validateFunction(predicate, 'predicate');
-    // Fall back to single-threaded for small arrays
-    if (items.length < MIN_PARALLEL_SIZE) {
-        return items.filter(predicate);
-    }
-    try {
-        const pool = getPool();
-        // Split items into chunks
-        const chunks = [];
-        for (let i = 0; i < items.length; i += chunkSize) {
-            chunks.push(items.slice(i, i + chunkSize));
-        }
-        // Convert function to string for serialization
-        const predicateString = predicate.toString();
-        // Process chunks in parallel using inline function execution
-        const results = await Promise.all(chunks.map(chunk => pool.exec((chunkData, predicateStr) => {
-            // Reconstruct function from string
-            // eslint-disable-next-line no-new-func
-            const filterFn = new Function('return ' + predicateStr)();
-            return chunkData.filter(filterFn);
-        }, [chunk, predicateString])));
-        // Flatten results
-        return results.flat();
-    }
-    catch (error) {
-        // Fall back to single-threaded if worker execution fails
-        // (e.g., in test environments with ESM/worker compatibility issues)
-        return items.filter(predicate);
-    }
-}
-/**
- * Get statistics about the worker pool.
- *
- * @returns Pool statistics or null if pool is not initialized
- */
-export function getPoolStats() {
-    if (!sharedPool) {
-        return null;
-    }
-    return sharedPool.stats();
-}
-//# sourceMappingURL=parallelUtils.js.map

package/dist/utils/parallelUtils.js.map

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