tywrap 0.2.0 → 0.3.0

package/dist/runtime/errors.js

@@ -15,6 +15,15 @@ export class BridgeTimeoutError extends BridgeError {
 }
 export class BridgeDisposedError extends BridgeError {
 }
+export class BridgeCodecError extends BridgeError {
+    codecPhase;
+    valueType;
+    constructor(message, options) {
+        super(message, { code: options?.code, cause: options?.cause });
+        this.codecPhase = options?.codecPhase;
+        this.valueType = options?.valueType;
+    }
+}
 export class BridgeExecutionError extends BridgeError {
     traceback;
 }

package/dist/runtime/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/runtime/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,IAAI,CAAU;IACd,YAAY,OAAe,EAAE,OAA4C;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC1B,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YAClB,IAAoC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;CAAG;AACvD,MAAM,OAAO,kBAAmB,SAAQ,WAAW;CAAG;AACtD,MAAM,OAAO,mBAAoB,SAAQ,WAAW;CAAG;AAEvD,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,SAAS,CAAU;CACpB"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/runtime/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,IAAI,CAAU;IACd,YAAY,OAAe,EAAE,OAA4C;QACvE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,IAAI,CAAC;QAC1B,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YAClB,IAAoC,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,WAAW;CAAG;AACvD,MAAM,OAAO,kBAAmB,SAAQ,WAAW;CAAG;AACtD,MAAM,OAAO,mBAAoB,SAAQ,WAAW;CAAG;AAEvD,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IAC/C,UAAU,CAAU;IACpB,SAAS,CAAU;IAEnB,YACE,OAAe,EACf,OAAqF;QAErF,KAAK,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,SAAS,CAAU;CACpB"}

package/dist/runtime/http-io.d.ts

@@ -0,0 +1,91 @@
+/**
+ * HTTP Transport for BridgeProtocol.
+ *
+ * Provides stateless HTTP POST-based communication with a Python server.
+ * Each request is independent - no connection state is maintained.
+ *
+ * @see https://github.com/bbopen/tywrap/issues/149
+ */
+import type { Transport } from './transport.js';
+/**
+ * Configuration options for HttpIO transport.
+ */
+export interface HttpIOOptions {
+    /** Base URL for the Python server (e.g., 'http://localhost:8000') */
+    baseURL: string;
+    /** Additional headers to include in each request */
+    headers?: Record<string, string>;
+    /** Default timeout in milliseconds. Default: 30000 (30 seconds) */
+    defaultTimeoutMs?: number;
+}
+/**
+ * HTTP-based transport for BridgeProtocol.
+ *
+ * This transport sends protocol messages as HTTP POST requests to a Python
+ * server. It is stateless - each request is independent and the transport
+ * is always ready after construction.
+ *
+ * Features:
+ * - Stateless design (init/dispose are no-ops)
+ * - Timeout handling via AbortController
+ * - External signal support for cancellation
+ * - Proper error classification
+ *
+ * @example
+ * ```typescript
+ * const transport = new HttpIO({ baseURL: 'http://localhost:8000' });
+ * await transport.init(); // No-op but follows Transport contract
+ *
+ * const response = await transport.send(
+ *   JSON.stringify({ id: '1', type: 'call', module: 'math', functionName: 'sqrt', args: [16] }),
+ *   5000
+ * );
+ *
+ * await transport.dispose(); // Marks as disposed
+ * ```
+ */
+export declare class HttpIO implements Transport {
+    private readonly baseURL;
+    private readonly headers;
+    private readonly defaultTimeoutMs;
+    private _isDisposed;
+    constructor(options: HttpIOOptions);
+    /**
+     * Initialize the transport.
+     *
+     * HTTP is stateless, so this is a no-op. The transport is ready
+     * immediately after construction.
+     */
+    init(): Promise<void>;
+    /**
+     * Dispose the transport.
+     *
+     * Marks the transport as disposed. Subsequent send() calls will fail.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Whether the transport is ready to send messages.
+     *
+     * Returns true unless dispose() has been called.
+     */
+    get isReady(): boolean;
+    /**
+     * Send a message to the Python server and wait for the response.
+     *
+     * @param message - The JSON-encoded protocol message to send
+     * @param timeoutMs - Timeout in milliseconds (0 = no timeout, negative = use default)
+     * @param signal - Optional AbortSignal for external cancellation
+     * @returns The raw response string (JSON-encoded ProtocolResponse)
+     *
+     * @throws BridgeDisposedError if the transport has been disposed
+     * @throws BridgeTimeoutError if the operation times out or is aborted
+     * @throws BridgeExecutionError if the server returns a non-2xx status
+     * @throws BridgeProtocolError if the response cannot be read
+     */
+    send(message: string, timeoutMs: number, signal?: AbortSignal): Promise<string>;
+    /**
+     * Safely read response body as text, returning empty string on failure.
+     */
+    private safeReadText;
+}
+//# sourceMappingURL=http-io.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-io.d.ts","sourceRoot":"","sources":["../../src/runtime/http-io.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAMhD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;IAEhB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,MAAO,YAAW,SAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,aAAa;IAclC;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;;OAIG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAMD;;;;;;;;;;;;OAYG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAwGrF;;OAEG;YACW,YAAY;CAO3B"}

package/dist/runtime/http-io.js

@@ -0,0 +1,195 @@
+/**
+ * HTTP Transport for BridgeProtocol.
+ *
+ * Provides stateless HTTP POST-based communication with a Python server.
+ * Each request is independent - no connection state is maintained.
+ *
+ * @see https://github.com/bbopen/tywrap/issues/149
+ */
+import { BridgeDisposedError, BridgeExecutionError, BridgeProtocolError, BridgeTimeoutError, } from './errors.js';
+// =============================================================================
+// HTTP TRANSPORT
+// =============================================================================
+/**
+ * HTTP-based transport for BridgeProtocol.
+ *
+ * This transport sends protocol messages as HTTP POST requests to a Python
+ * server. It is stateless - each request is independent and the transport
+ * is always ready after construction.
+ *
+ * Features:
+ * - Stateless design (init/dispose are no-ops)
+ * - Timeout handling via AbortController
+ * - External signal support for cancellation
+ * - Proper error classification
+ *
+ * @example
+ * ```typescript
+ * const transport = new HttpIO({ baseURL: 'http://localhost:8000' });
+ * await transport.init(); // No-op but follows Transport contract
+ *
+ * const response = await transport.send(
+ *   JSON.stringify({ id: '1', type: 'call', module: 'math', functionName: 'sqrt', args: [16] }),
+ *   5000
+ * );
+ *
+ * await transport.dispose(); // Marks as disposed
+ * ```
+ */
+export class HttpIO {
+    baseURL;
+    headers;
+    defaultTimeoutMs;
+    _isDisposed = false;
+    constructor(options) {
+        // Normalize URL - remove trailing slash
+        this.baseURL = options.baseURL.replace(/\/$/, '');
+        this.headers = {
+            'Content-Type': 'application/json',
+            ...options.headers,
+        };
+        this.defaultTimeoutMs = options.defaultTimeoutMs ?? 30000;
+    }
+    // ===========================================================================
+    // LIFECYCLE
+    // ===========================================================================
+    /**
+     * Initialize the transport.
+     *
+     * HTTP is stateless, so this is a no-op. The transport is ready
+     * immediately after construction.
+     */
+    async init() {
+        // HTTP is stateless - nothing to initialize
+    }
+    /**
+     * Dispose the transport.
+     *
+     * Marks the transport as disposed. Subsequent send() calls will fail.
+     */
+    async dispose() {
+        this._isDisposed = true;
+    }
+    /**
+     * Whether the transport is ready to send messages.
+     *
+     * Returns true unless dispose() has been called.
+     */
+    get isReady() {
+        return !this._isDisposed;
+    }
+    // ===========================================================================
+    // SEND
+    // ===========================================================================
+    /**
+     * Send a message to the Python server and wait for the response.
+     *
+     * @param message - The JSON-encoded protocol message to send
+     * @param timeoutMs - Timeout in milliseconds (0 = no timeout, negative = use default)
+     * @param signal - Optional AbortSignal for external cancellation
+     * @returns The raw response string (JSON-encoded ProtocolResponse)
+     *
+     * @throws BridgeDisposedError if the transport has been disposed
+     * @throws BridgeTimeoutError if the operation times out or is aborted
+     * @throws BridgeExecutionError if the server returns a non-2xx status
+     * @throws BridgeProtocolError if the response cannot be read
+     */
+    async send(message, timeoutMs, signal) {
+        if (this._isDisposed) {
+            throw new BridgeDisposedError('Transport has been disposed');
+        }
+        // Determine effective timeout
+        // 0 = no timeout (per interface contract), negative = use default
+        const effectiveTimeout = timeoutMs === 0 ? 0 : timeoutMs > 0 ? timeoutMs : this.defaultTimeoutMs;
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        let timeoutId;
+        // Set up timeout if enabled
+        if (effectiveTimeout > 0) {
+            timeoutId = setTimeout(() => {
+                controller.abort();
+            }, effectiveTimeout);
+        }
+        // Handle external signal - abort our controller when external aborts
+        const externalAbortHandler = () => {
+            controller.abort();
+        };
+        if (signal) {
+            // Check if already aborted
+            if (signal.aborted) {
+                if (timeoutId !== undefined) {
+                    clearTimeout(timeoutId);
+                }
+                throw new BridgeTimeoutError('Operation aborted');
+            }
+            signal.addEventListener('abort', externalAbortHandler, { once: true });
+        }
+        try {
+            const response = await fetch(this.baseURL, {
+                method: 'POST',
+                headers: this.headers,
+                body: message,
+                signal: controller.signal,
+            });
+            // Handle non-2xx status codes
+            if (!response.ok) {
+                const errorBody = await this.safeReadText(response);
+                throw new BridgeExecutionError(`HTTP ${response.status}: ${errorBody || response.statusText}`, { code: `HTTP_${response.status}` });
+            }
+            // Read response body
+            const responseText = await response.text();
+            return responseText;
+        }
+        catch (error) {
+            // Handle abort errors (timeout or external signal)
+            if (error instanceof Error && error.name === 'AbortError') {
+                // Determine if it was timeout or external abort
+                if (signal?.aborted) {
+                    throw new BridgeTimeoutError('Operation aborted');
+                }
+                throw new BridgeTimeoutError(`Request timed out after ${effectiveTimeout}ms`);
+            }
+            // Re-throw bridge errors as-is
+            if (error instanceof BridgeTimeoutError ||
+                error instanceof BridgeExecutionError ||
+                error instanceof BridgeProtocolError) {
+                throw error;
+            }
+            // Wrap network errors
+            if (error instanceof TypeError) {
+                // fetch throws TypeError for network failures
+                throw new BridgeExecutionError(`Network error: ${error.message}`, { cause: error });
+            }
+            // Wrap unknown errors
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new BridgeExecutionError(`Request failed: ${errorMessage}`, {
+                cause: error instanceof Error ? error : undefined,
+            });
+        }
+        finally {
+            // Clean up timeout
+            if (timeoutId !== undefined) {
+                clearTimeout(timeoutId);
+            }
+            // Clean up external signal listener
+            if (signal) {
+                signal.removeEventListener('abort', externalAbortHandler);
+            }
+        }
+    }
+    // ===========================================================================
+    // HELPERS
+    // ===========================================================================
+    /**
+     * Safely read response body as text, returning empty string on failure.
+     */
+    async safeReadText(response) {
+        try {
+            return await response.text();
+        }
+        catch {
+            return '';
+        }
+    }
+}
+//# sourceMappingURL=http-io.js.map

package/dist/runtime/http-io.js.map

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

package/dist/runtime/http.d.ts

@@ -1,22 +1,57 @@
 /**
- * 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);
+    protected doInit(): Promise<void>;
 }
 //# 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;AAOpD;;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;cAkBtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAKxC"}

package/dist/runtime/http.js

@@ -1,79 +1,66 @@
 /**
- * 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();
+import { BridgeProtocol } from './bridge-protocol.js';
+import { HttpIO } from './http-io.js';
+import { autoRegisterArrowDecoder } from '../utils/codec.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);
     }
-    catch {
-        return '';
+    async doInit() {
+        // Best-effort: keep apache-arrow optional and avoid breaking non-Node runtimes.
+        await autoRegisterArrowDecoder();
+        await super.doInit();
     }
 }
 //# 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;AAEtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAuB7D,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;IAES,KAAK,CAAC,MAAM;QACpB,gFAAgF;QAChF,MAAM,wBAAwB,EAAE,CAAC;QACjC,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;CACF"}