@push.rocks/smartproxy 19.5.3 → 19.5.5

package/dist_ts/core/utils/enhanced-connection-pool.js

@@ -0,0 +1,320 @@
+import { LifecycleComponent } from './lifecycle-component.js';
+import { BinaryHeap } from './binary-heap.js';
+import { AsyncMutex } from './async-utils.js';
+import { EventEmitter } from 'events';
+/**
+ * Enhanced connection pool with priority queue, backpressure, and lifecycle management
+ */
+export class EnhancedConnectionPool extends LifecycleComponent {
+    constructor(options) {
+        super();
+        this.availableConnections = [];
+        this.activeConnections = new Map();
+        this.mutex = new AsyncMutex();
+        this.eventEmitter = new EventEmitter();
+        this.connectionIdCounter = 0;
+        this.requestIdCounter = 0;
+        this.isClosing = false;
+        // Metrics
+        this.metrics = {
+            connectionsCreated: 0,
+            connectionsDestroyed: 0,
+            connectionsAcquired: 0,
+            connectionsReleased: 0,
+            acquireTimeouts: 0,
+            validationFailures: 0,
+            queueHighWaterMark: 0,
+        };
+        this.options = {
+            minSize: 0,
+            maxSize: 10,
+            acquireTimeout: 30000,
+            idleTimeout: 300000, // 5 minutes
+            maxUseCount: Infinity,
+            validateOnAcquire: true,
+            validateOnReturn: false,
+            queueTimeout: 60000,
+            ...options,
+        };
+        // Initialize priority queue (higher priority = extracted first)
+        this.waitQueue = new BinaryHeap((a, b) => b.priority - a.priority || a.timestamp - b.timestamp, (item) => item.id);
+        // Start maintenance cycle
+        this.startMaintenance();
+        // Initialize minimum connections
+        this.initializeMinConnections();
+    }
+    /**
+     * Initialize minimum number of connections
+     */
+    async initializeMinConnections() {
+        const promises = [];
+        for (let i = 0; i < this.options.minSize; i++) {
+            promises.push(this.createConnection()
+                .then(conn => {
+                this.availableConnections.push(conn);
+            })
+                .catch(err => {
+                if (this.options.onConnectionError) {
+                    this.options.onConnectionError(err);
+                }
+            }));
+        }
+        await Promise.all(promises);
+    }
+    /**
+     * Start maintenance timer for idle connection cleanup
+     */
+    startMaintenance() {
+        this.setInterval(() => {
+            this.performMaintenance();
+        }, 30000); // Every 30 seconds
+    }
+    /**
+     * Perform maintenance tasks
+     */
+    async performMaintenance() {
+        await this.mutex.runExclusive(async () => {
+            const now = Date.now();
+            const toRemove = [];
+            // Check for idle connections beyond minimum size
+            for (let i = this.availableConnections.length - 1; i >= 0; i--) {
+                const conn = this.availableConnections[i];
+                // Keep minimum connections
+                if (this.availableConnections.length <= this.options.minSize) {
+                    break;
+                }
+                // Remove idle connections
+                if (now - conn.lastUsedAt > this.options.idleTimeout) {
+                    toRemove.push(conn);
+                    this.availableConnections.splice(i, 1);
+                }
+            }
+            // Destroy idle connections
+            for (const conn of toRemove) {
+                await this.destroyConnection(conn);
+            }
+        });
+    }
+    /**
+     * Acquire a connection from the pool
+     */
+    async acquire(priority = 0, timeout) {
+        if (this.isClosing) {
+            throw new Error('Connection pool is closing');
+        }
+        return this.mutex.runExclusive(async () => {
+            // Try to get an available connection
+            const connection = await this.tryAcquireConnection();
+            if (connection) {
+                return connection;
+            }
+            // Check if we can create a new connection
+            const totalConnections = this.availableConnections.length + this.activeConnections.size;
+            if (totalConnections < this.options.maxSize) {
+                try {
+                    const newConnection = await this.createConnection();
+                    return this.checkoutConnection(newConnection);
+                }
+                catch (err) {
+                    // Fall through to queue if creation fails
+                }
+            }
+            // Add to wait queue
+            return this.queueAcquireRequest(priority, timeout);
+        });
+    }
+    /**
+     * Try to acquire an available connection
+     */
+    async tryAcquireConnection() {
+        while (this.availableConnections.length > 0) {
+            const connection = this.availableConnections.shift();
+            // Check if connection exceeded max use count
+            if (connection.useCount >= this.options.maxUseCount) {
+                await this.destroyConnection(connection);
+                continue;
+            }
+            // Validate connection if required
+            if (this.options.validateOnAcquire && this.options.connectionValidator) {
+                try {
+                    const isValid = await this.options.connectionValidator(connection.connection);
+                    if (!isValid) {
+                        this.metrics.validationFailures++;
+                        await this.destroyConnection(connection);
+                        continue;
+                    }
+                }
+                catch (err) {
+                    this.metrics.validationFailures++;
+                    await this.destroyConnection(connection);
+                    continue;
+                }
+            }
+            return this.checkoutConnection(connection);
+        }
+        return null;
+    }
+    /**
+     * Checkout a connection for use
+     */
+    checkoutConnection(connection) {
+        connection.inUse = true;
+        connection.lastUsedAt = Date.now();
+        connection.useCount++;
+        this.activeConnections.set(connection.id, connection);
+        this.metrics.connectionsAcquired++;
+        this.eventEmitter.emit('acquire', connection);
+        return connection;
+    }
+    /**
+     * Queue an acquire request
+     */
+    queueAcquireRequest(priority, timeout) {
+        return new Promise((resolve, reject) => {
+            const request = {
+                id: `req-${this.requestIdCounter++}`,
+                priority,
+                timestamp: Date.now(),
+                resolve,
+                reject,
+            };
+            // Set timeout
+            const timeoutMs = timeout || this.options.queueTimeout;
+            request.timeoutHandle = this.setTimeout(() => {
+                if (this.waitQueue.extractByKey(request.id)) {
+                    this.metrics.acquireTimeouts++;
+                    reject(new Error(`Connection acquire timeout after ${timeoutMs}ms`));
+                }
+            }, timeoutMs);
+            this.waitQueue.insert(request);
+            this.metrics.queueHighWaterMark = Math.max(this.metrics.queueHighWaterMark, this.waitQueue.size);
+            this.eventEmitter.emit('enqueue', { queueSize: this.waitQueue.size });
+        });
+    }
+    /**
+     * Release a connection back to the pool
+     */
+    async release(connection) {
+        return this.mutex.runExclusive(async () => {
+            if (!connection.inUse || !this.activeConnections.has(connection.id)) {
+                throw new Error('Connection is not active');
+            }
+            this.activeConnections.delete(connection.id);
+            connection.inUse = false;
+            connection.lastUsedAt = Date.now();
+            this.metrics.connectionsReleased++;
+            // Check if connection should be destroyed
+            if (connection.useCount >= this.options.maxUseCount) {
+                await this.destroyConnection(connection);
+                return;
+            }
+            // Validate on return if required
+            if (this.options.validateOnReturn && this.options.connectionValidator) {
+                try {
+                    const isValid = await this.options.connectionValidator(connection.connection);
+                    if (!isValid) {
+                        await this.destroyConnection(connection);
+                        return;
+                    }
+                }
+                catch (err) {
+                    await this.destroyConnection(connection);
+                    return;
+                }
+            }
+            // Check if there are waiting requests
+            const request = this.waitQueue.extract();
+            if (request) {
+                this.clearTimeout(request.timeoutHandle);
+                request.resolve(this.checkoutConnection(connection));
+                this.eventEmitter.emit('dequeue', { queueSize: this.waitQueue.size });
+            }
+            else {
+                // Return to available pool
+                this.availableConnections.push(connection);
+                this.eventEmitter.emit('release', connection);
+            }
+        });
+    }
+    /**
+     * Create a new connection
+     */
+    async createConnection() {
+        const rawConnection = await this.options.connectionFactory();
+        const connection = {
+            id: `conn-${this.connectionIdCounter++}`,
+            connection: rawConnection,
+            createdAt: Date.now(),
+            lastUsedAt: Date.now(),
+            useCount: 0,
+            inUse: false,
+        };
+        this.metrics.connectionsCreated++;
+        this.eventEmitter.emit('create', connection);
+        return connection;
+    }
+    /**
+     * Destroy a connection
+     */
+    async destroyConnection(connection) {
+        try {
+            if (this.options.connectionDestroyer) {
+                await this.options.connectionDestroyer(connection.connection);
+            }
+            this.metrics.connectionsDestroyed++;
+            this.eventEmitter.emit('destroy', connection);
+        }
+        catch (err) {
+            if (this.options.onConnectionError) {
+                this.options.onConnectionError(err, connection.connection);
+            }
+        }
+    }
+    /**
+     * Get current pool statistics
+     */
+    getStats() {
+        return {
+            available: this.availableConnections.length,
+            active: this.activeConnections.size,
+            waiting: this.waitQueue.size,
+            total: this.availableConnections.length + this.activeConnections.size,
+            ...this.metrics,
+        };
+    }
+    /**
+     * Subscribe to pool events
+     */
+    on(event, listener) {
+        this.addEventListener(this.eventEmitter, event, listener);
+    }
+    /**
+     * Close the pool and cleanup resources
+     */
+    async onCleanup() {
+        this.isClosing = true;
+        // Clear the wait queue
+        while (!this.waitQueue.isEmpty()) {
+            const request = this.waitQueue.extract();
+            if (request) {
+                this.clearTimeout(request.timeoutHandle);
+                request.reject(new Error('Connection pool is closing'));
+            }
+        }
+        // Wait for active connections to be released (with timeout)
+        const timeout = 30000;
+        const startTime = Date.now();
+        while (this.activeConnections.size > 0 && Date.now() - startTime < timeout) {
+            await new Promise(resolve => setTimeout(resolve, 100));
+        }
+        // Destroy all connections
+        const allConnections = [
+            ...this.availableConnections,
+            ...this.activeConnections.values(),
+        ];
+        await Promise.all(allConnections.map(conn => this.destroyConnection(conn)));
+        this.availableConnections.length = 0;
+        this.activeConnections.clear();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW5oYW5jZWQtY29ubmVjdGlvbi1wb29sLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vdHMvY29yZS91dGlscy9lbmhhbmNlZC1jb25uZWN0aW9uLXBvb2wudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDOUQsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQzlDLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sUUFBUSxDQUFDO0FBNkN0Qzs7R0FFRztBQUNILE1BQU0sT0FBTyxzQkFBMEIsU0FBUSxrQkFBa0I7SUF1Qi9ELFlBQVksT0FBa0M7UUFDNUMsS0FBSyxFQUFFLENBQUM7UUF0Qk8seUJBQW9CLEdBQTJCLEVBQUUsQ0FBQztRQUNsRCxzQkFBaUIsR0FBc0MsSUFBSSxHQUFHLEVBQUUsQ0FBQztRQUVqRSxVQUFLLEdBQUcsSUFBSSxVQUFVLEVBQUUsQ0FBQztRQUN6QixpQkFBWSxHQUFHLElBQUksWUFBWSxFQUFFLENBQUM7UUFFM0Msd0JBQW1CLEdBQUcsQ0FBQyxDQUFDO1FBQ3hCLHFCQUFnQixHQUFHLENBQUMsQ0FBQztRQUNyQixjQUFTLEdBQUcsS0FBSyxDQUFDO1FBRTFCLFVBQVU7UUFDRixZQUFPLEdBQUc7WUFDaEIsa0JBQWtCLEVBQUUsQ0FBQztZQUNyQixvQkFBb0IsRUFBRSxDQUFDO1lBQ3ZCLG1CQUFtQixFQUFFLENBQUM7WUFDdEIsbUJBQW1CLEVBQUUsQ0FBQztZQUN0QixlQUFlLEVBQUUsQ0FBQztZQUNsQixrQkFBa0IsRUFBRSxDQUFDO1lBQ3JCLGtCQUFrQixFQUFFLENBQUM7U0FDdEIsQ0FBQztRQUtBLElBQUksQ0FBQyxPQUFPLEdBQUc7WUFDYixPQUFPLEVBQUUsQ0FBQztZQUNWLE9BQU8sRUFBRSxFQUFFO1lBQ1gs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

package/dist_ts/core/utils/fs-utils.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Async filesystem utilities for SmartProxy
+ * Provides non-blocking alternatives to synchronous filesystem operations
+ */
+import * as plugins from '../../plugins.js';
+export declare class AsyncFileSystem {
+    /**
+     * Check if a file or directory exists
+     * @param path - Path to check
+     * @returns Promise resolving to true if exists, false otherwise
+     */
+    static exists(path: string): Promise<boolean>;
+    /**
+     * Ensure a directory exists, creating it if necessary
+     * @param dirPath - Directory path to ensure
+     * @returns Promise that resolves when directory is ensured
+     */
+    static ensureDir(dirPath: string): Promise<void>;
+    /**
+     * Read a file as string
+     * @param filePath - Path to the file
+     * @param encoding - File encoding (default: utf8)
+     * @returns Promise resolving to file contents
+     */
+    static readFile(filePath: string, encoding?: BufferEncoding): Promise<string>;
+    /**
+     * Read a file as buffer
+     * @param filePath - Path to the file
+     * @returns Promise resolving to file buffer
+     */
+    static readFileBuffer(filePath: string): Promise<Buffer>;
+    /**
+     * Write string data to a file
+     * @param filePath - Path to the file
+     * @param data - String data to write
+     * @param encoding - File encoding (default: utf8)
+     * @returns Promise that resolves when file is written
+     */
+    static writeFile(filePath: string, data: string, encoding?: BufferEncoding): Promise<void>;
+    /**
+     * Write buffer data to a file
+     * @param filePath - Path to the file
+     * @param data - Buffer data to write
+     * @returns Promise that resolves when file is written
+     */
+    static writeFileBuffer(filePath: string, data: Buffer): Promise<void>;
+    /**
+     * Remove a file
+     * @param filePath - Path to the file
+     * @returns Promise that resolves when file is removed
+     */
+    static remove(filePath: string): Promise<void>;
+    /**
+     * Remove a directory and all its contents
+     * @param dirPath - Path to the directory
+     * @returns Promise that resolves when directory is removed
+     */
+    static removeDir(dirPath: string): Promise<void>;
+    /**
+     * Read JSON from a file
+     * @param filePath - Path to the JSON file
+     * @returns Promise resolving to parsed JSON
+     */
+    static readJSON<T = any>(filePath: string): Promise<T>;
+    /**
+     * Write JSON to a file
+     * @param filePath - Path to the file
+     * @param data - Data to write as JSON
+     * @param pretty - Whether to pretty-print JSON (default: true)
+     * @returns Promise that resolves when file is written
+     */
+    static writeJSON(filePath: string, data: any, pretty?: boolean): Promise<void>;
+    /**
+     * Copy a file from source to destination
+     * @param source - Source file path
+     * @param destination - Destination file path
+     * @returns Promise that resolves when file is copied
+     */
+    static copyFile(source: string, destination: string): Promise<void>;
+    /**
+     * Move/rename a file
+     * @param source - Source file path
+     * @param destination - Destination file path
+     * @returns Promise that resolves when file is moved
+     */
+    static moveFile(source: string, destination: string): Promise<void>;
+    /**
+     * Get file stats
+     * @param filePath - Path to the file
+     * @returns Promise resolving to file stats or null if doesn't exist
+     */
+    static getStats(filePath: string): Promise<plugins.fs.Stats | null>;
+    /**
+     * List files in a directory
+     * @param dirPath - Directory path
+     * @returns Promise resolving to array of filenames
+     */
+    static listFiles(dirPath: string): Promise<string[]>;
+    /**
+     * List files in a directory with full paths
+     * @param dirPath - Directory path
+     * @returns Promise resolving to array of full file paths
+     */
+    static listFilesFullPath(dirPath: string): Promise<string[]>;
+    /**
+     * Recursively list all files in a directory
+     * @param dirPath - Directory path
+     * @param fileList - Accumulator for file list (used internally)
+     * @returns Promise resolving to array of all file paths
+     */
+    static listFilesRecursive(dirPath: string, fileList?: string[]): Promise<string[]>;
+    /**
+     * Create a read stream for a file
+     * @param filePath - Path to the file
+     * @param options - Stream options
+     * @returns Read stream
+     */
+    static createReadStream(filePath: string, options?: Parameters<typeof plugins.fs.createReadStream>[1]): plugins.fs.ReadStream;
+    /**
+     * Create a write stream for a file
+     * @param filePath - Path to the file
+     * @param options - Stream options
+     * @returns Write stream
+     */
+    static createWriteStream(filePath: string, options?: Parameters<typeof plugins.fs.createWriteStream>[1]): plugins.fs.WriteStream;
+    /**
+     * Ensure a file exists, creating an empty file if necessary
+     * @param filePath - Path to the file
+     * @returns Promise that resolves when file is ensured
+     */
+    static ensureFile(filePath: string): Promise<void>;
+    /**
+     * Check if a path is a directory
+     * @param path - Path to check
+     * @returns Promise resolving to true if directory, false otherwise
+     */
+    static isDirectory(path: string): Promise<boolean>;
+    /**
+     * Check if a path is a file
+     * @param path - Path to check
+     * @returns Promise resolving to true if file, false otherwise
+     */
+    static isFile(path: string): Promise<boolean>;
+}