tywrap 0.1.0

package/dist/runtime/optimized-node.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Optimized Node.js Runtime Bridge with Connection Pooling and Memory Management
+ * High-performance Python subprocess management for production workloads
+ */
+import { RuntimeBridge } from './base.js';
+interface ProcessPoolOptions {
+    minProcesses?: number;
+    maxProcesses?: number;
+    maxIdleTime?: number;
+    maxRequestsPerProcess?: number;
+    pythonPath?: string;
+    scriptPath?: string;
+    virtualEnv?: string | undefined;
+    cwd?: string;
+    timeoutMs?: number;
+    enableJsonFallback?: boolean;
+    env?: Record<string, string | undefined>;
+    warmupCommands?: Array<{
+        method: string;
+        params: unknown;
+    }>;
+}
+interface OptimizedBridgeStats {
+    totalRequests: number;
+    totalTime: number;
+    cacheHits: number;
+    poolHits: number;
+    poolMisses: number;
+    processSpawns: number;
+    processDeaths: number;
+    memoryPeak: number;
+    averageTime: number;
+    cacheHitRate: number;
+}
+interface OptimizedBridgeStatsSnapshot extends OptimizedBridgeStats {
+    poolSize: number;
+    busyWorkers: number;
+    memoryUsage: NodeJS.MemoryUsage;
+    workerStats: Array<{
+        id: string;
+        requestCount: number;
+        averageTime: number;
+        errorCount: number;
+        busy: boolean;
+        pendingRequests: number;
+    }>;
+}
+export declare class OptimizedNodeBridge extends RuntimeBridge {
+    private processPool;
+    private roundRobinIndex;
+    private nextId;
+    private cleanupTimer?;
+    private options;
+    private emitter;
+    private disposed;
+    private stats;
+    constructor(options?: ProcessPoolOptions);
+    init(): Promise<void>;
+    call<T = unknown>(module: string, functionName: string, args: unknown[], kwargs?: Record<string, unknown>): Promise<T>;
+    instantiate<T = unknown>(module: string, className: string, args: unknown[], kwargs?: Record<string, unknown>): Promise<T>;
+    callMethod<T = unknown>(handle: string, methodName: string, args: unknown[], kwargs?: Record<string, unknown>): Promise<T>;
+    disposeInstance(handle: string): Promise<void>;
+    /**
+     * Execute request with intelligent process selection
+     */
+    private executeRequest;
+    /**
+     * Select optimal worker based on load and performance
+     */
+    private selectOptimalWorker;
+    /**
+     * Wait for any worker to become available
+     */
+    private waitForAvailableWorker;
+    /**
+     * Send request to specific worker
+     */
+    private sendToWorker;
+    /**
+     * Spawn new worker process with optimizations
+     */
+    private spawnProcess;
+    /**
+     * Setup event handlers for worker process
+     */
+    private setupProcessHandlers;
+    /**
+     * Handle response from worker process
+     */
+    private handleWorkerResponse;
+    /**
+     * Handle worker process exit
+     */
+    private handleWorkerExit;
+    /**
+     * Warm up processes with configured commands
+     */
+    private warmupProcesses;
+    /**
+     * Heuristic to determine if function result should be cached
+     */
+    private isPureFunctionCandidate;
+    /**
+     * Update performance statistics
+     */
+    private updateStats;
+    /**
+     * Get performance statistics
+     */
+    getStats(): OptimizedBridgeStatsSnapshot;
+    /**
+     * Cleanup idle processes
+     */
+    private cleanup;
+    /**
+     * Gracefully terminate a worker
+     */
+    private terminateWorker;
+    /**
+     * Start cleanup scheduler
+     */
+    private startCleanupScheduler;
+    /**
+     * Dispose all resources
+     */
+    dispose(): Promise<void>;
+    private errorFrom;
+    private handleProtocolError;
+}
+export {};
+//# sourceMappingURL=optimized-node.d.ts.map

package/dist/runtime/optimized-node.d.ts.map

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