tywrap 0.2.0 → 0.3.0

package/dist/runtime/pyodide.d.ts

@@ -1,27 +1,59 @@
 /**
- * Pyodide runtime bridge (browser)
+ * Pyodide runtime bridge for BridgeProtocol.
+ *
+ * PyodideBridge extends BridgeProtocol and uses PyodideIO transport for
+ * in-memory Python execution in browser environments via WebAssembly.
+ *
+ * @see https://github.com/bbopen/tywrap/issues/149
+ */
+import { BridgeProtocol } from './bridge-protocol.js';
+import type { CodecOptions } from './safe-codec.js';
+/**
+ * Configuration options for PyodideBridge.
  */
-import { RuntimeBridge } from './base.js';
 export interface PyodideBridgeOptions {
-    indexURL: string;
+    /** URL for Pyodide CDN. Default: official CDN */
+    indexURL?: string;
+    /** Python packages to load during initialization */
     packages?: string[];
+    /** Timeout in ms for operations. Default: 30000 (30 seconds) */
+    timeoutMs?: number;
+    /** Codec options for validation/serialization */
+    codec?: CodecOptions;
 }
-export declare class PyodideBridge extends RuntimeBridge {
-    private readonly indexURL;
-    private readonly packages;
-    private py?;
-    private initPromise?;
+/**
+ * Browser-based runtime bridge for executing Python code via Pyodide.
+ *
+ * PyodideBridge provides in-memory Python execution using Pyodide (Python
+ * compiled to WebAssembly). This enables running Python directly in the
+ * browser without a server.
+ *
+ * Features:
+ * - Zero network overhead (in-memory execution)
+ * - Automatic Pyodide loading from CDN or module
+ * - Python package loading support
+ * - Full SafeCodec validation (NaN/Infinity rejection, key validation)
+ * - Proper proxy cleanup to prevent memory leaks
+ *
+ * @example
+ * ```typescript
+ * const bridge = new PyodideBridge({
+ *   packages: ['numpy'],
+ * });
+ * await bridge.init();
+ *
+ * const result = await bridge.call('math', 'sqrt', [16]);
+ * console.log(result); // 4.0
+ *
+ * await bridge.dispose();
+ * ```
+ */
+export declare class PyodideBridge extends BridgeProtocol {
+    /**
+     * Create a new PyodideBridge instance.
+     *
+     * @param options - Configuration options for the bridge
+     */
     constructor(options?: PyodideBridgeOptions);
-    private ensureReady;
-    private doInit;
-    init(): Promise<void>;
-    private resolveLoadPyodide;
-    private bootstrapHelpers;
-    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 destroyPyProxy;
 }
 //# sourceMappingURL=pyodide.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pyodide.d.ts","sourceRoot":"","sources":["../../src/runtime/pyodide.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAYD,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,EAAE,CAAC,CAAkB;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAgB;gBAExB,OAAO,GAAE,oBAAwE;YAM/E,WAAW;YAaX,MAAM;IAYd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAIb,kBAAkB;YAmBlB,gBAAgB;IA8BxB,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;IAuBP,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;IAuBP,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;IAuBP,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB9C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B,OAAO,CAAC,cAAc;CASvB"}
+{"version":3,"file":"pyodide.d.ts","sourceRoot":"","sources":["../../src/runtime/pyodide.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,oBAAoB;IACnC,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,iDAAiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C;;;;OAIG;gBACS,OAAO,GAAE,oBAAyB;CAgB/C"}

package/dist/runtime/pyodide.js

@@ -1,191 +1,62 @@
 /**
- * Pyodide runtime bridge (browser)
+ * Pyodide runtime bridge for BridgeProtocol.
+ *
+ * PyodideBridge extends BridgeProtocol and uses PyodideIO transport for
+ * in-memory Python execution in browser environments via WebAssembly.
+ *
+ * @see https://github.com/bbopen/tywrap/issues/149
  */
-import { RuntimeBridge } from './base.js';
-export class PyodideBridge extends RuntimeBridge {
-    indexURL;
-    packages;
-    py;
-    initPromise;
-    constructor(options = { indexURL: 'https://cdn.jsdelivr.net/pyodide/' }) {
-        super();
-        this.indexURL = options.indexURL;
-        this.packages = [...(options.packages ?? [])];
-    }
-    async ensureReady() {
-        if (this.py) {
-            return;
-        }
-        // If already initializing, wait for that promise
-        if (this.initPromise) {
-            return this.initPromise;
-        }
-        // Start initialization and store the promise to prevent concurrent initialization
-        this.initPromise = this.doInit();
-        return this.initPromise;
-    }
-    async doInit() {
-        const loadPyodideFn = await this.resolveLoadPyodide();
-        if (!loadPyodideFn) {
-            throw new Error('Pyodide is not available in this environment');
-        }
-        this.py = await loadPyodideFn({ indexURL: this.indexURL });
-        if (this.packages.length > 0) {
-            await this.py.loadPackage([...this.packages]);
-        }
-        await this.bootstrapHelpers();
-    }
-    async init() {
-        await this.ensureReady();
-    }
-    async resolveLoadPyodide() {
-        // Prefer global loadPyodide when present (browser script tag include)
-        const g = globalThis ?? {};
-        if (typeof g.loadPyodide === 'function') {
-            return g.loadPyodide;
-        }
-        try {
-            // Attempt dynamic import if available
-            const mod = (await import('pyodide'));
-            if (typeof mod.loadPyodide === 'function') {
-                return mod.loadPyodide;
-            }
-        }
-        catch {
-            // Ignore import errors - pyodide may not be installed
-            // This is expected in most environments
-        }
-        return undefined;
-    }
-    async bootstrapHelpers() {
-        if (!this.py) {
-            return;
-        }
-        const helper = [
-            'import importlib',
-            '__tywrap_instances = {}',
-            'def __tywrap_call(module, function_name, args, kwargs):',
-            '    mod = importlib.import_module(module)',
-            '    fn = getattr(mod, function_name)',
-            '    return fn(*args, **(kwargs or {}))',
-            'def __tywrap_instantiate(module, class_name, args, kwargs):',
-            '    mod = importlib.import_module(module)',
-            '    cls = getattr(mod, class_name)',
-            '    obj = cls(*args, **(kwargs or {}))',
-            '    handle = str(id(obj))',
-            '    __tywrap_instances[handle] = obj',
-            '    return handle',
-            'def __tywrap_call_method(handle, method_name, args, kwargs):',
-            '    if handle not in __tywrap_instances:',
-            '        raise KeyError(f"Unknown handle: {handle}")',
-            '    obj = __tywrap_instances[handle]',
-            '    fn = getattr(obj, method_name)',
-            '    return fn(*args, **(kwargs or {}))',
-            'def __tywrap_dispose_instance(handle):',
-            '    return __tywrap_instances.pop(handle, None) is not None',
-        ].join('\n');
-        await this.py.runPythonAsync(helper);
-    }
-    async call(module, functionName, args, kwargs) {
-        await this.ensureReady();
-        const py = this.py;
-        if (!py) {
-            throw new Error('Pyodide not initialized');
-        }
-        const fn = py.globals.get('__tywrap_call');
-        if (!fn) {
-            throw new Error('Pyodide helper not initialized');
-        }
-        const invoke = fn;
-        const pyArgs = py.toPy(args ?? []);
-        const pyKwargs = py.toPy(kwargs ?? {});
-        try {
-            const out = invoke(module, functionName, pyArgs, pyKwargs);
-            return out;
-        }
-        finally {
-            this.destroyPyProxy(pyArgs);
-            this.destroyPyProxy(pyKwargs);
-            this.destroyPyProxy(fn);
-        }
-    }
-    async instantiate(module, className, args, kwargs) {
-        await this.ensureReady();
-        const py = this.py;
-        if (!py) {
-            throw new Error('Pyodide not initialized');
-        }
-        const fn = py.globals.get('__tywrap_instantiate');
-        if (!fn) {
-            throw new Error('Pyodide helper not initialized');
-        }
-        const invoke = fn;
-        const pyArgs = py.toPy(args ?? []);
-        const pyKwargs = py.toPy(kwargs ?? {});
-        try {
-            const out = invoke(module, className, pyArgs, pyKwargs);
-            return out;
-        }
-        finally {
-            this.destroyPyProxy(pyArgs);
-            this.destroyPyProxy(pyKwargs);
-            this.destroyPyProxy(fn);
-        }
-    }
-    async callMethod(handle, methodName, args, kwargs) {
-        await this.ensureReady();
-        const py = this.py;
-        if (!py) {
-            throw new Error('Pyodide not initialized');
-        }
-        const fn = py.globals.get('__tywrap_call_method');
-        if (!fn) {
-            throw new Error('Pyodide helper not initialized');
-        }
-        const invoke = fn;
-        const pyArgs = py.toPy(args ?? []);
-        const pyKwargs = py.toPy(kwargs ?? {});
-        try {
-            const out = invoke(handle, methodName, pyArgs, pyKwargs);
-            return out;
-        }
-        finally {
-            this.destroyPyProxy(pyArgs);
-            this.destroyPyProxy(pyKwargs);
-            this.destroyPyProxy(fn);
-        }
-    }
-    async disposeInstance(handle) {
-        await this.ensureReady();
-        const py = this.py;
-        if (!py) {
-            throw new Error('Pyodide not initialized');
-        }
-        const fn = py.globals.get('__tywrap_dispose_instance');
-        if (!fn) {
-            throw new Error('Pyodide helper not initialized');
-        }
-        const invoke = fn;
-        try {
-            invoke(handle);
-        }
-        finally {
-            this.destroyPyProxy(fn);
-        }
-    }
-    async dispose() {
-        // Pyodide has no explicit dispose for instance; rely on GC
-        this.py = undefined;
-    }
-    destroyPyProxy(value) {
-        if (value && typeof value.destroy === 'function') {
-            try {
-                value.destroy();
-            }
-            catch {
-                // ignore cleanup failures
-            }
-        }
+import { BridgeProtocol } from './bridge-protocol.js';
+import { PyodideIO } from './pyodide-io.js';
+// =============================================================================
+// PYODIDE BRIDGE
+// =============================================================================
+/**
+ * Browser-based runtime bridge for executing Python code via Pyodide.
+ *
+ * PyodideBridge provides in-memory Python execution using Pyodide (Python
+ * compiled to WebAssembly). This enables running Python directly in the
+ * browser without a server.
+ *
+ * Features:
+ * - Zero network overhead (in-memory execution)
+ * - Automatic Pyodide loading from CDN or module
+ * - Python package loading support
+ * - Full SafeCodec validation (NaN/Infinity rejection, key validation)
+ * - Proper proxy cleanup to prevent memory leaks
+ *
+ * @example
+ * ```typescript
+ * const bridge = new PyodideBridge({
+ *   packages: ['numpy'],
+ * });
+ * await bridge.init();
+ *
+ * const result = await bridge.call('math', 'sqrt', [16]);
+ * console.log(result); // 4.0
+ *
+ * await bridge.dispose();
+ * ```
+ */
+export class PyodideBridge extends BridgeProtocol {
+    /**
+     * Create a new PyodideBridge instance.
+     *
+     * @param options - Configuration options for the bridge
+     */
+    constructor(options = {}) {
+        // Create Pyodide transport
+        const transport = new PyodideIO({
+            indexURL: options.indexURL,
+            packages: options.packages,
+        });
+        // Initialize BridgeProtocol with transport and codec options
+        const protocolOptions = {
+            transport,
+            codec: options.codec,
+            defaultTimeoutMs: options.timeoutMs,
+        };
+        super(protocolOptions);
     }
 }
 //# sourceMappingURL=pyodide.js.map

package/dist/runtime/pyodide.js.map

@@ -1 +1 @@
-{"version":3,"file":"pyodide.js","sourceRoot":"","sources":["../../src/runtime/pyodide.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pyodide.js","sourceRoot":"","sources":["../../src/runtime/pyodide.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAA8B,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAwB5C,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C;;;;OAIG;IACH,YAAY,UAAgC,EAAE;QAC5C,2BAA2B;QAC3B,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC;YAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,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/safe-codec.d.ts

@@ -0,0 +1,103 @@
+/**
+ * SafeCodec - Unified validation and serialization for JS<->Python boundary crossing.
+ *
+ * Provides safe encoding/decoding with configurable guardrails for:
+ * - Special float rejection (NaN, Infinity)
+ * - Non-string key detection
+ * - Payload size limits
+ * - Binary data handling
+ */
+/**
+ * Configuration options for SafeCodec behavior.
+ */
+export interface CodecOptions {
+    /** Reject NaN/Infinity in arguments. Default: true */
+    rejectSpecialFloats?: boolean;
+    /** Reject non-string keys in objects. Default: true */
+    rejectNonStringKeys?: boolean;
+    /** Max payload size in bytes. Default: 10MB */
+    maxPayloadBytes?: number;
+    /** How to handle bytes/bytearray. Default: 'base64' */
+    bytesHandling?: 'base64' | 'reject' | 'passthrough';
+}
+/**
+ * SafeCodec provides unified validation and serialization for JS<->Python
+ * boundary crossing with configurable guardrails.
+ *
+ * @example
+ * ```typescript
+ * const codec = new SafeCodec({ rejectSpecialFloats: true });
+ *
+ * // Encoding a request
+ * const payload = codec.encodeRequest({ data: [1, 2, 3] });
+ *
+ * // Decoding a response
+ * const result = codec.decodeResponse<MyType>(responsePayload);
+ *
+ * // Async decoding with Arrow support
+ * const dataframe = await codec.decodeResponseAsync<ArrowTable>(arrowPayload);
+ * ```
+ */
+export declare class SafeCodec {
+    private readonly rejectSpecialFloats;
+    private readonly rejectNonStringKeys;
+    private readonly maxPayloadBytes;
+    private readonly bytesHandling;
+    private readonly reviveValueBound;
+    private static readonly base64Pattern;
+    constructor(options?: CodecOptions);
+    private assertValidBase64;
+    /**
+     * Convert base64 string to Uint8Array.
+     *
+     * Why: Python bridge represents bytes/bytearray as base64 envelopes. Decoding them here
+     * restores ergonomic JS types at the boundary.
+     */
+    private fromBase64;
+    /**
+     * JSON.parse reviver that decodes bytes envelopes.
+     *
+     * Supported shapes:
+     * - { "__tywrap_bytes__": true, "b64": "..." } (JS SafeCodec.encodeRequest; also allowed in responses)
+     * - { "__type__": "bytes", "encoding": "base64", "data": "..." } (Python SafeCodec default encoder)
+     */
+    private reviveValue;
+    private toBridgeExecutionError;
+    private extractResultFromResponseEnvelope;
+    /**
+     * Validate and encode a request payload.
+     * Called before sending to Python.
+     *
+     * @param message - The message to encode
+     * @returns JSON string ready to send
+     * @throws BridgeCodecError if validation fails or encoding fails
+     */
+    encodeRequest(message: unknown): string;
+    /**
+     * Decode and validate a response payload.
+     * Called after receiving from Python.
+     *
+     * @param payload - The JSON string received from Python
+     * @returns Decoded and validated result
+     * @throws BridgeCodecError if payload is invalid or decoding fails
+     * @throws BridgeProtocolError if protocol envelope is invalid
+     * @throws BridgeExecutionError if response contains a Python error
+     */
+    decodeResponse<T>(payload: string): T;
+    /**
+     * Async version that applies Arrow decoders.
+     * Use this when the response may contain encoded DataFrames or ndarrays.
+     *
+     * @param payload - The JSON string received from Python
+     * @returns Decoded and validated result with Arrow decoding applied
+     * @throws BridgeCodecError if payload is invalid or decoding fails
+     * @throws BridgeProtocolError if protocol envelope is invalid
+     * @throws BridgeExecutionError if response contains a Python error
+     */
+    decodeResponseAsync<T>(payload: string): Promise<T>;
+    /**
+     * Convert Uint8Array to base64 string.
+     */
+    private toBase64;
+}
+//# sourceMappingURL=safe-codec.d.ts.map

package/dist/runtime/safe-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-codec.d.ts","sourceRoot":"","sources":["../../src/runtime/safe-codec.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,aAAa,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,aAAa,CAAC;CACrD;AA2QD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsC;IACpE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2C;IAC5E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CACgC;gBAEzD,OAAO,GAAE,YAAiB;IAQtC,OAAO,CAAC,iBAAiB;IASzB;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAkBlB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAiCnB,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,iCAAiC;IAiCzC;;;;;;;OAOG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAgEvC;;;;;;;;;OASG;IACH,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC;IA0CrC;;;;;;;;;OASG;IACG,mBAAmB,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAuDzD;;OAEG;IACH,OAAO,CAAC,QAAQ;CAajB"}