tywrap 0.2.0 → 0.2.1

package/dist/runtime/http.d.ts

@@ -1,22 +1,56 @@
 /**
- * HTTP runtime bridge
+ * HTTP runtime bridge for BridgeProtocol.
+ *
+ * HttpBridge extends BridgeProtocol and uses HttpIO transport for
+ * stateless HTTP POST-based communication with a Python server.
+ *
+ * @see https://github.com/bbopen/tywrap/issues/149
+ */
+import { BridgeProtocol } from './bridge-protocol.js';
+import type { CodecOptions } from './safe-codec.js';
+/**
+ * Configuration options for HttpBridge.
  */
-import { RuntimeBridge } from './base.js';
 export interface HttpBridgeOptions {
+    /** Base URL for the Python server (e.g., 'http://localhost:8000') */
     baseURL: string;
+    /** Additional headers to include in each request */
     headers?: Record<string, string>;
+    /** Timeout in ms for requests. Default: 30000 (30 seconds) */
     timeoutMs?: number;
+    /** Codec options for validation/serialization */
+    codec?: CodecOptions;
 }
-export declare class HttpBridge extends RuntimeBridge {
-    private readonly baseURL;
-    private readonly headers;
-    private readonly timeoutMs;
-    constructor(options?: HttpBridgeOptions);
-    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>;
-    dispose(): Promise<void>;
-    private post;
+/**
+ * HTTP-based runtime bridge for executing Python code.
+ *
+ * HttpBridge provides a stateless HTTP transport for communication with
+ * a Python server. Each request is independent - no connection state is
+ * maintained between calls.
+ *
+ * Features:
+ * - Stateless HTTP POST communication
+ * - Timeout handling via AbortController
+ * - Full SafeCodec validation (NaN/Infinity rejection, key validation)
+ * - Automatic Arrow decoding for DataFrames/ndarrays
+ *
+ * @example
+ * ```typescript
+ * const bridge = new HttpBridge({ baseURL: 'http://localhost:8000' });
+ * await bridge.init();
+ *
+ * const result = await bridge.call('math', 'sqrt', [16]);
+ * console.log(result); // 4.0
+ *
+ * await bridge.dispose();
+ * ```
+ */
+export declare class HttpBridge extends BridgeProtocol {
+    /**
+     * Create a new HttpBridge instance.
+     *
+     * @param options - Configuration options for the bridge
+     */
+    constructor(options: HttpBridgeOptions);
 }
 //# sourceMappingURL=http.d.ts.map

package/dist/runtime/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/runtime/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2BD,qBAAa,UAAW,SAAQ,aAAa;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,GAAE,iBAAwD;IAOvE,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAMP,WAAW,CAAC,CAAC,GAAG,OAAO,EAC3B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAMP,UAAU,CAAC,CAAC,GAAG,OAAO,EAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,OAAO,EAAE,EACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,CAAC,CAAC;IAMP,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAIhB,IAAI;CA8BnB"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/runtime/http.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAA8B,MAAM,sBAAsB,CAAC;AAElF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAMpD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAMD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,UAAW,SAAQ,cAAc;IAC5C;;;;OAIG;gBACS,OAAO,EAAE,iBAAiB;CAiBvC"}

package/dist/runtime/http.js

@@ -1,79 +1,60 @@
 /**
- * HTTP runtime bridge
+ * HTTP runtime bridge for BridgeProtocol.
+ *
+ * HttpBridge extends BridgeProtocol and uses HttpIO transport for
+ * stateless HTTP POST-based communication with a Python server.
+ *
+ * @see https://github.com/bbopen/tywrap/issues/149
  */
-import { decodeValueAsync } from '../utils/codec.js';
-import { RuntimeBridge } from './base.js';
-export class HttpBridge extends RuntimeBridge {
-    baseURL;
-    headers;
-    timeoutMs;
-    constructor(options = { baseURL: 'http://localhost:8000' }) {
-        super();
-        this.baseURL = options.baseURL.replace(/\/$/, '');
-        this.headers = { 'content-type': 'application/json', ...(options.headers ?? {}) };
-        this.timeoutMs = options.timeoutMs ?? 30000;
-    }
-    async call(module, functionName, args, kwargs) {
-        const payload = { module, functionName, args, kwargs };
-        const res = await this.post(`${this.baseURL}/call`, payload);
-        return (await decodeValueAsync(res));
-    }
-    async instantiate(module, className, args, kwargs) {
-        const payload = { module, className, args, kwargs };
-        const res = await this.post(`${this.baseURL}/instantiate`, payload);
-        return (await decodeValueAsync(res));
-    }
-    async callMethod(handle, methodName, args, kwargs) {
-        const payload = { handle, methodName, args, kwargs };
-        const res = await this.post(`${this.baseURL}/call_method`, payload);
-        return (await decodeValueAsync(res));
-    }
-    async disposeInstance(handle) {
-        const payload = { handle };
-        await this.post(`${this.baseURL}/dispose_instance`, payload);
-    }
-    async dispose() {
-        // stateless
-    }
-    async post(url, body) {
-        const controller = typeof AbortController !== 'undefined' ? new AbortController() : undefined;
-        const timer = controller ? setTimeout(() => controller.abort(), this.timeoutMs) : undefined;
-        try {
-            const resp = await fetch(url, {
-                method: 'POST',
-                headers: this.headers,
-                body: JSON.stringify(body),
-                signal: controller?.signal,
-            });
-            if (!resp.ok) {
-                const text = await safeText(resp);
-                throw new Error(`HTTP ${resp.status}: ${text || resp.statusText}`);
-            }
-            const ct = resp.headers.get('content-type') ?? '';
-            if (ct.includes('application/json')) {
-                return (await resp.json());
-            }
-            const text = await resp.text();
-            try {
-                return JSON.parse(text);
-            }
-            catch {
-                return text;
-            }
-        }
-        finally {
-            if (timer) {
-                clearTimeout(timer);
-            }
-        }
-    }
-}
-async function safeText(resp) {
-    try {
-        return await resp.text();
-    }
-    catch {
-        return '';
+import { BridgeProtocol } from './bridge-protocol.js';
+import { HttpIO } from './http-io.js';
+// =============================================================================
+// HTTP BRIDGE
+// =============================================================================
+/**
+ * HTTP-based runtime bridge for executing Python code.
+ *
+ * HttpBridge provides a stateless HTTP transport for communication with
+ * a Python server. Each request is independent - no connection state is
+ * maintained between calls.
+ *
+ * Features:
+ * - Stateless HTTP POST communication
+ * - Timeout handling via AbortController
+ * - Full SafeCodec validation (NaN/Infinity rejection, key validation)
+ * - Automatic Arrow decoding for DataFrames/ndarrays
+ *
+ * @example
+ * ```typescript
+ * const bridge = new HttpBridge({ baseURL: 'http://localhost:8000' });
+ * await bridge.init();
+ *
+ * const result = await bridge.call('math', 'sqrt', [16]);
+ * console.log(result); // 4.0
+ *
+ * await bridge.dispose();
+ * ```
+ */
+export class HttpBridge extends BridgeProtocol {
+    /**
+     * Create a new HttpBridge instance.
+     *
+     * @param options - Configuration options for the bridge
+     */
+    constructor(options) {
+        // Create HTTP transport
+        const transport = new HttpIO({
+            baseURL: options.baseURL,
+            headers: options.headers,
+            defaultTimeoutMs: options.timeoutMs,
+        });
+        // Initialize BridgeProtocol with transport and codec options
+        const protocolOptions = {
+            transport,
+            codec: options.codec,
+            defaultTimeoutMs: options.timeoutMs,
+        };
+        super(protocolOptions);
     }
 }
 //# sourceMappingURL=http.js.map

package/dist/runtime/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/runtime/http.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/runtime/http.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAA8B,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAwBtC,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,OAAO,UAAW,SAAQ,cAAc;IAC5C;;;;OAIG;IACH,YAAY,OAA0B;QACpC,wBAAwB;QACxB,MAAM,SAAS,GAAG,IAAI,MAAM,CAAC;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,gBAAgB,EAAE,OAAO,CAAC,SAAS;SACpC,CAAC,CAAC;QAEH,6DAA6D;QAC7D,MAAM,eAAe,GAA0B;YAC7C,SAAS;YACT,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,gBAAgB,EAAE,OAAO,CAAC,SAAS;SACpC,CAAC;QAEF,KAAK,CAAC,eAAe,CAAC,CAAC;IACzB,CAAC;CACF"}

package/dist/runtime/node.d.ts

@@ -1,29 +1,23 @@
 /**
- * Node.js Runtime Bridge with Optional Connection Pooling
+ * Node.js runtime bridge for BridgeProtocol.
  *
- * NodeBridge is the unified Node.js runtime bridge that supports both single-process
- * (correctness-first) and multi-process (pooled) configurations. By default, it runs
- * in single-process mode for maximum compatibility with the original NodeBridge behavior.
+ * NodeBridge extends BridgeProtocol and uses ProcessIO transports with
+ * optional pooling for concurrent Python execution.
  *
- * For high-throughput workloads, configure pooling via minProcesses/maxProcesses options.
+ * @see https://github.com/bbopen/tywrap/issues/149
  */
-import type { BridgeInfo } from '../types/index.js';
-import { RuntimeBridge } from './base.js';
+import { BridgeProtocol } from './bridge-protocol.js';
+import type { CodecOptions } from './safe-codec.js';
 /**
  * Configuration options for NodeBridge.
- *
- * By default, NodeBridge runs in single-process mode (minProcesses=1, maxProcesses=1).
- * For high-throughput workloads, increase these values to enable process pooling.
  */
 export interface NodeBridgeOptions {
     /** Minimum number of Python processes to keep alive. Default: 1 */
     minProcesses?: number;
     /** Maximum number of Python processes to spawn. Default: 1 (single-process mode) */
     maxProcesses?: number;
-    /** Time in ms to keep idle processes alive before termination. Default: 300000 (5 min) */
-    maxIdleTime?: number;
-    /** Restart process after this many requests. Default: 1000 */
-    maxRequestsPerProcess?: number;
+    /** Maximum concurrent requests per process. Default: 10 */
+    maxConcurrentPerProcess?: number;
     /** Path to Python executable. Auto-detected if not specified. */
     pythonPath?: string;
     /** Path to python_bridge.py script. Auto-detected if not specified. */
@@ -34,161 +28,134 @@ export interface NodeBridgeOptions {
     cwd?: string;
     /** Timeout in ms for Python calls. Default: 30000 */
     timeoutMs?: number;
-    /** Maximum line length for JSONL protocol. */
-    maxLineLength?: number;
+    /** Timeout in ms for waiting in pool queue. Default: 30000 */
+    queueTimeoutMs?: number;
     /** Inherit all environment variables from parent process. Default: false */
     inheritProcessEnv?: boolean;
-    /**
-     * When true, sets TYWRAP_CODEC_FALLBACK=json for the Python process to prefer JSON encoding
-     * for rich types (ndarray/dataframe/series). Default: false for fast-fail on Arrow path issues.
-     */
-    enableJsonFallback?: boolean;
     /** Enable result caching for pure functions. Default: false */
     enableCache?: boolean;
     /** Optional extra environment variables to pass to the Python subprocess. */
     env?: Record<string, string | undefined>;
+    /** Codec options for validation/serialization */
+    codec?: CodecOptions;
     /** Commands to run on each process at startup for warming up. */
     warmupCommands?: Array<{
+        module: string;
+        functionName: string;
+        args?: unknown[];
+    } | {
         method: string;
         params: unknown;
     }>;
-}
-interface BridgeStats {
-    totalRequests: number;
-    totalTime: number;
-    cacheHits: number;
-    poolHits: number;
-    poolMisses: number;
-    processSpawns: number;
-    processDeaths: number;
-    memoryPeak: number;
-    averageTime: number;
-    cacheHitRate: number;
-}
-interface BridgeStatsSnapshot extends BridgeStats {
-    poolSize: number;
-    busyWorkers: number;
-    memoryUsage: NodeJS.MemoryUsage;
-    workerStats: Array<{
-        id: string;
-        requestCount: number;
-        averageTime: number;
-        errorCount: number;
-        busy: boolean;
-        pendingRequests: number;
-    }>;
+    /**
+     * @deprecated No longer used. Pool idle time is managed by WorkerPool.
+     */
+    maxIdleTime?: number;
+    /**
+     * @deprecated No longer used. Process restart is managed by ProcessIO.
+     */
+    maxRequestsPerProcess?: number;
+    /**
+     * @deprecated Use codec.bytesHandling option instead.
+     */
+    enableJsonFallback?: boolean;
+    /**
+     * @deprecated Use ProcessIO options instead.
+     */
+    maxLineLength?: number;
 }
 /**
  * Node.js runtime bridge for executing Python code.
  *
- * By default, runs in single-process mode for correctness-first behavior.
- * Configure minProcesses/maxProcesses for process pooling in high-throughput scenarios.
+ * NodeBridge provides subprocess-based Python execution with optional pooling
+ * for high-throughput workloads. By default, it runs in single-process mode.
+ *
+ * Features:
+ * - Single or multi-process execution via process pooling
+ * - Virtual environment support
+ * - Full SafeCodec validation (NaN/Infinity rejection, key validation)
+ * - Automatic Arrow decoding for DataFrames/ndarrays
+ * - Optional result caching for pure functions
+ * - Process warmup commands
  *
  * @example
  * ```typescript
  * // Single-process mode (default)
  * const bridge = new NodeBridge();
+ * await bridge.init();
  *
+ * const result = await bridge.call('math', 'sqrt', [16]);
+ * console.log(result); // 4.0
+ *
+ * await bridge.dispose();
+ * ```
+ *
+ * @example
+ * ```typescript
  * // Multi-process pooling for high throughput
  * const pooledBridge = new NodeBridge({
- *   minProcesses: 2,
- *   maxProcesses: 8,
+ *   maxProcesses: 4,
+ *   maxConcurrentPerProcess: 2,
  *   enableCache: true,
  * });
+ * await pooledBridge.init();
  * ```
  */
-export declare class NodeBridge extends RuntimeBridge {
-    private processPool;
-    private roundRobinIndex;
-    private cleanupTimer?;
-    private options;
-    private emitter;
-    private disposed;
-    private bridgeInfo?;
-    private initPromise?;
-    private stats;
-    constructor(options?: NodeBridgeOptions);
-    init(): Promise<void>;
-    private doInit;
-    getBridgeInfo(options?: {
-        refresh?: boolean;
-    }): Promise<BridgeInfo>;
-    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;
+export declare class NodeBridge extends BridgeProtocol {
+    private readonly resolvedOptions;
+    private readonly pooledTransport;
     /**
-     * Send request to specific worker
+     * Create a new NodeBridge instance.
+     *
+     * @param options - Configuration options for the bridge
      */
-    private sendToWorker;
-    private quarantineWorker;
+    constructor(options?: NodeBridgeOptions);
     /**
-     * Spawn new worker process with optimizations
+     * Initialize the bridge.
+     *
+     * Validates the bridge script exists, registers Arrow decoder,
+     * and initializes the transport pool (which runs warmup commands per-worker).
      */
-    private spawnProcess;
+    protected doInit(): Promise<void>;
     /**
-     * Setup event handlers for worker process
+     * Override call() to add optional caching.
      */
-    private setupProcessHandlers;
+    call<T = unknown>(module: string, functionName: string, args: unknown[], kwargs?: Record<string, unknown>): Promise<T>;
     /**
-     * Handle worker process exit
-     */
-    private handleWorkerExit;
+     * Get current pool statistics.
+     */
+    getPoolStats(): {
+        workerCount: number;
+        queueLength: number;
+        totalInFlight: number;
+    };
+    /**
+     * Get bridge statistics.
+     *
+     * @deprecated Use getPoolStats() instead. This method is provided for
+     * backwards compatibility and returns a subset of the previous stats.
+     */
+    getStats(): {
+        totalRequests: number;
+        totalTime: number;
+        cacheHits: number;
+        poolHits: number;
+        poolMisses: number;
+        processSpawns: number;
+        processDeaths: number;
+        memoryPeak: number;
+        averageTime: number;
+        cacheHitRate: number;
+        poolSize: number;
+        busyWorkers: number;
+    };
     /**
-     * Warm up processes with configured commands
+     * Generate a cache key, returning null if generation fails.
      */
-    private warmupProcesses;
     private safeCacheKey;
     /**
-     * Heuristic to determine if function result should be cached
+     * Heuristic to determine if function result should be cached.
      */
     private isPureFunctionCandidate;
-    /**
-     * Update performance statistics
-     */
-    private updateStats;
-    /**
-     * Get performance statistics
-     */
-    getStats(): BridgeStatsSnapshot;
-    /**
-     * Cleanup idle processes
-     */
-    private cleanup;
-    /**
-     * Gracefully terminate a worker
-     */
-    private terminateWorker;
-    /**
-     * Start cleanup scheduler
-     */
-    private startCleanupScheduler;
-    /**
-     * Dispose all resources
-     */
-    dispose(): Promise<void>;
-    private buildEnv;
-    private refreshBridgeInfo;
 }
-/**
- * @deprecated Use NodeBridge with minProcesses/maxProcesses options instead.
- * This alias is provided for backward compatibility.
- */
-export { NodeBridge as OptimizedNodeBridge };
-/**
- * @deprecated Use NodeBridgeOptions instead.
- */
-export type { NodeBridgeOptions as ProcessPoolOptions };
 //# sourceMappingURL=node.d.ts.map

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

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