nodepyx 1.0.0

package/dist/core/PyRuntime.js

@@ -0,0 +1,438 @@
+"use strict";
+/**
+ * nodepyx — PyRuntime
+ * The central manager for the Python interpreter lifecycle.
+ * Creates, configures, and shuts down the embedded CPython instance.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PyRuntime = void 0;
+const path_1 = __importDefault(require("path"));
+const addon_1 = require("../types/addon");
+const config_1 = require("../types/config");
+const PyProxy_1 = require("./PyProxy");
+const PyModule_1 = require("./PyModule");
+const PyContext_1 = require("./PyContext");
+const Serializer_1 = require("../serialization/Serializer");
+const TypeGenerator_1 = require("../types/TypeGenerator");
+const PluginManager_1 = require("../plugins/PluginManager");
+const VenvManager_1 = require("../env/VenvManager");
+const PythonDetector_1 = require("../env/PythonDetector");
+const PackageInstaller_1 = require("../env/PackageInstaller");
+const MemoryMonitor_1 = require("../utils/MemoryMonitor");
+const Logger_1 = require("../utils/Logger");
+const ErrorTranslator_1 = require("../utils/ErrorTranslator");
+const logger = new Logger_1.Logger('PyRuntime');
+/**
+ * PyRuntime — manages the lifecycle of the embedded Python interpreter.
+ *
+ * @example
+ * ```typescript
+ * const runtime = await PyRuntime.create({
+ *   virtualenv: { path: '.venv', packages: ['pandas'], autoInstall: true },
+ * });
+ *
+ * const pd = await runtime.import('pandas');
+ * const df = await pd.read_csv('data.csv');
+ * const result = await df.to_dict('records');
+ *
+ * await runtime.shutdown();
+ * ```
+ */
+class PyRuntime {
+    _config;
+    _addon;
+    _serializer;
+    _typeGenerator;
+    _pluginManager;
+    _memoryMonitor;
+    _moduleCache = new Map();
+    _running = false;
+    constructor(config, addon) {
+        this._config = config;
+        this._addon = addon;
+        this._serializer = Serializer_1.Serializer.getInstance();
+        this._typeGenerator = new TypeGenerator_1.TypeGenerator({ stubsDir: config.stubsDir });
+        this._pluginManager = new PluginManager_1.PluginManager();
+        this._memoryMonitor = new MemoryMonitor_1.MemoryMonitor({
+            gcThreshold: this._parseBytes(config.gcThreshold),
+        });
+        this._memoryMonitor.attach(addon);
+    }
+    /**
+     * Create and initialize a PyRuntime instance.
+     */
+    static async create(config = {}) {
+        const resolved = (0, config_1.resolveConfig)(config);
+        // Set log level
+        Logger_1.Logger.setGlobalLevel(resolved.logLevel);
+        logger.info('Creating PyRuntime...');
+        // Load the native addon
+        let addon;
+        try {
+            addon = (0, addon_1.loadNativeAddon)();
+            logger.debug('Native addon loaded');
+        }
+        catch (err) {
+            logger.error('Failed to load native addon. Make sure nodepyx is built.', err);
+            throw new Error('nodepyx native addon not found. Run "npm install" or "npm run build:native".\n' +
+                `Original error: ${err.message}`);
+        }
+        const runtime = new PyRuntime(resolved, addon);
+        await runtime._initialize(config);
+        return runtime;
+    }
+    // ─── Initialization ────────────────────────────────────────────────────────
+    async _initialize(config) {
+        const startTime = performance.now();
+        // 1. Detect/setup Python environment
+        const pythonExecutable = await this._setupPythonEnvironment(config);
+        // 2. Initialize Python interpreter via C++ addon
+        logger.debug(`Initializing Python interpreter: ${pythonExecutable}`);
+        await this._addon.initializePython({
+            pythonHome: this._config.pythonHome || '',
+            pythonExecutable,
+            threadPoolSize: this._config.threadPoolSize,
+            maxQueueSize: this._config.maxQueueSize,
+            gilReleaseInterval: this._config.gil.releaseInterval,
+            callTimeout: this._config.callTimeout,
+            pythonPathExtra: [
+                path_1.default.join(__dirname, '..', '..', 'python'),
+                ...this._config.pythonPathExtra,
+            ],
+            env: this._config.env,
+            enableProfiling: this._config.profilingEnabled,
+        });
+        logger.debug('Python interpreter initialized');
+        // 3. Bootstrap Python runtime helpers
+        await this._bootstrapPythonRuntime();
+        // 4. Register built-in plugins
+        await this._pluginManager.registerBuiltins();
+        // 5. Start memory monitoring
+        this._memoryMonitor.startMonitoring(10000);
+        this._running = true;
+        const elapsed = (performance.now() - startTime).toFixed(0);
+        logger.success(`PyRuntime ready in ${elapsed}ms (Python: ${pythonExecutable})`);
+    }
+    async _setupPythonEnvironment(config) {
+        let pythonExecutable = this._config.pythonExecutable;
+        if (config.conda) {
+            // Conda environment
+            const { CondaManager } = await Promise.resolve().then(() => __importStar(require('../env/CondaManager')));
+            const condaManager = new CondaManager({ conda: config.conda });
+            pythonExecutable = await condaManager.getPythonExecutable(config.conda.envName) ?? pythonExecutable;
+            logger.info(`Using conda environment: ${config.conda.envName}`);
+        }
+        else if (config.virtualenv) {
+            // Virtualenv
+            const venvManager = new VenvManager_1.VenvManager({ virtualenv: config.virtualenv });
+            const venvResult = await venvManager.setup();
+            pythonExecutable = typeof venvResult === 'string' ? venvResult : venvResult.pythonExecutable ?? pythonExecutable;
+            logger.info(`Using virtualenv: ${config.virtualenv.path}`);
+        }
+        else if (config.pythonPath) {
+            // Explicit Python path
+            pythonExecutable = config.pythonPath;
+        }
+        else {
+            // Auto-detect
+            const detector = new PythonDetector_1.PythonDetector();
+            try {
+                const detected = await detector.detect();
+                pythonExecutable = detected.executable;
+                logger.info(`Auto-detected Python: ${detected.executable} (${detected.version})`);
+            }
+            catch {
+                logger.warn('No Python detected — using system default "python3"');
+                pythonExecutable = 'python3';
+            }
+        }
+        return pythonExecutable;
+    }
+    async _bootstrapPythonRuntime() {
+        try {
+            // Initialize nodepyx Python runtime helpers
+            const bootstrapCode = `
+import sys
+import os
+
+# Add nodepyx runtime to path
+_nodepyx_runtime_dir = os.path.join(os.path.dirname(os.path.abspath(__file__)), 'python')
+if _nodepyx_runtime_dir not in sys.path:
+    sys.path.insert(0, _nodepyx_runtime_dir)
+
+# Initialize runtime
+try:
+    import nodepyx_runtime
+    nodepyx_runtime.initialize()
+except ImportError:
+    pass  # Runtime helpers not available, basic operation only
+`;
+            await this._addon.runPythonCode(bootstrapCode);
+            logger.debug('Python runtime helpers bootstrapped');
+        }
+        catch (err) {
+            // Non-fatal — runtime helpers are optional
+            logger.warn('Failed to bootstrap Python runtime helpers', err);
+        }
+    }
+    // ─── Module Import ──────────────────────────────────────────────────────────
+    /**
+     * Import a Python module and return a PyProxy.
+     *
+     * @example
+     * ```typescript
+     * const pd = await runtime.import('pandas');
+     * const df = await pd.read_csv('data.csv');
+     * ```
+     */
+    async import(moduleName) {
+        this._ensureRunning();
+        // Check cache
+        if (this._moduleCache.has(moduleName)) {
+            return this._moduleCache.get(moduleName);
+        }
+        logger.debug(`Importing Python module: ${moduleName}`);
+        const result = await this._addon.importModule(moduleName);
+        if (!result.success) {
+            if (result.error) {
+                throw (0, ErrorTranslator_1.translatePythonError)({
+                    type: result.error.type,
+                    message: result.error.message,
+                    traceback: result.error.traceback || '',
+                });
+            }
+            throw new Error(`Failed to import Python module '${moduleName}'`);
+        }
+        if (!result.objectId) {
+            throw new Error(`Module '${moduleName}' imported but no object ID returned`);
+        }
+        // Run plugin hooks
+        await this._pluginManager.onModuleImported(moduleName, result.objectId);
+        // Create PyModule
+        const module = PyModule_1.PyModule.fromRef(result.objectId, moduleName, this._addon, this._config.callTimeout);
+        // Generate TypeScript stubs (background, non-blocking)
+        // TypeScript stub generation (non-blocking, background)
+        if (this._config.proxyCache) {
+            this._typeGenerator.generateStub(moduleName, { name: moduleName, functions: [], classes: [], constants: [], submodules: [] }).catch((err) => {
+                logger.debug(`Stub generation for ${moduleName} failed (non-fatal)`, err);
+            });
+        }
+        // Cache
+        this._moduleCache.set(moduleName, module);
+        logger.debug(`Module '${moduleName}' imported (id=${result.objectId})`);
+        return module;
+    }
+    /**
+     * Import multiple modules at once (concurrent).
+     */
+    async importAll(moduleNames) {
+        const modules = await Promise.all(moduleNames.map(async (name) => [name, await this.import(name)]));
+        return Object.fromEntries(modules);
+    }
+    // ─── Code Execution ────────────────────────────────────────────────────────
+    /**
+     * Evaluate a Python expression.
+     */
+    async eval(expression) {
+        this._ensureRunning();
+        const result = await this._addon.evalPython(expression);
+        if (!result.success) {
+            if (result.error) {
+                throw (0, ErrorTranslator_1.translatePythonError)({
+                    type: result.error.type,
+                    message: result.error.message,
+                    traceback: result.error.traceback || '',
+                });
+            }
+            throw new Error('Python eval failed');
+        }
+        if (result.isObject && result.objectId) {
+            return PyProxy_1.PyProxy._createFromObjectId(result.objectId, [], this._addon, this._config.callTimeout);
+        }
+        if (result.resultJson !== undefined) {
+            try {
+                return JSON.parse(result.resultJson);
+            }
+            catch {
+                return result.resultJson;
+            }
+        }
+        return null;
+    }
+    /**
+     * Execute Python statements.
+     */
+    async exec(code) {
+        this._ensureRunning();
+        const result = await this._addon.runPythonCode(code);
+        if (!result.success && result.error) {
+            throw (0, ErrorTranslator_1.translatePythonError)({
+                type: result.error.type,
+                message: result.error.message,
+                traceback: result.error.traceback || '',
+            });
+        }
+    }
+    /**
+     * Run a Python script file.
+     */
+    async runFile(filePath) {
+        this._ensureRunning();
+        const result = await this._addon.runPythonFile(filePath);
+        if (!result.success) {
+            if (result.error) {
+                throw (0, ErrorTranslator_1.translatePythonError)({
+                    type: result.error.type,
+                    message: result.error.message,
+                    traceback: result.error.traceback || '',
+                });
+            }
+            throw new Error('Failed to run Python file');
+        }
+        return null;
+    }
+    // ─── Context Management ─────────────────────────────────────────────────────
+    /**
+     * Create an isolated Python execution context.
+     */
+    async createContext() {
+        this._ensureRunning();
+        return PyContext_1.PyContext.create(this._addon);
+    }
+    // ─── Package Management ────────────────────────────────────────────────────
+    /**
+     * Install Python packages into the active environment.
+     */
+    async installPackages(packages) {
+        this._ensureRunning();
+        const installer = new PackageInstaller_1.PackageInstaller({ pythonExecutable: this._config.pythonExecutable });
+        await installer.install(packages);
+        // Clear module cache so re-imports work
+        this._moduleCache.clear();
+    }
+    // ─── Memory Management ─────────────────────────────────────────────────────
+    /**
+     * Get current memory statistics.
+     */
+    getMemoryStats() {
+        this._ensureRunning();
+        return this._addon.getMemoryStats();
+    }
+    /**
+     * Trigger Python garbage collection.
+     */
+    async collectGarbage() {
+        this._ensureRunning();
+        await this._addon.collectGarbage();
+    }
+    // ─── Direct Addon Access ───────────────────────────────────────────────────
+    /**
+     * Get the underlying native addon.
+     * Advanced use only.
+     */
+    getAddon() {
+        return this._addon;
+    }
+    // ─── State ─────────────────────────────────────────────────────────────────
+    isRunning() {
+        return this._running;
+    }
+    getConfig() {
+        return { ...this._config };
+    }
+    // ─── Shutdown ──────────────────────────────────────────────────────────────
+    /**
+     * Gracefully shut down the Python runtime.
+     * Releases all Python objects and finalizes the interpreter.
+     */
+    async shutdown() {
+        if (!this._running) {
+            return;
+        }
+        logger.info('Shutting down PyRuntime...');
+        this._running = false;
+        // Stop memory monitoring
+        this._memoryMonitor.stopMonitoring();
+        // Clear caches
+        this._moduleCache.clear();
+        // Finalize Python interpreter
+        try {
+            await this._addon.finalizePython();
+            logger.success('PyRuntime shut down');
+        }
+        catch (err) {
+            logger.error('Error during Python finalization', err);
+            throw err;
+        }
+    }
+    /**
+     * Synchronous shutdown (for process.on('exit') handler).
+     * Best-effort only — may not complete all cleanup.
+     */
+    shutdownSync() {
+        if (!this._running) {
+            return;
+        }
+        this._running = false;
+        this._memoryMonitor.stopMonitoring();
+        this._moduleCache.clear();
+        // Cannot await here — best effort
+        logger.debug('Synchronous shutdown initiated');
+    }
+    // ─── Private Helpers ───────────────────────────────────────────────────────
+    _ensureRunning() {
+        if (!this._running) {
+            throw new ErrorTranslator_1.nodepyxShutdownError('PyRuntime has been shut down. Create a new runtime with PyRuntime.create().');
+        }
+    }
+    _parseBytes(str) {
+        const match = str.match(/^(\d+(?:\.\d+)?)\s*(B|KB|MB|GB|TB)?$/i);
+        if (!match) {
+            return 1_073_741_824;
+        }
+        const value = parseFloat(match[1]);
+        const unit = (match[2] ?? 'B').toUpperCase();
+        const units = {
+            B: 1, KB: 1024, MB: 1024 ** 2, GB: 1024 ** 3, TB: 1024 ** 4,
+        };
+        return Math.floor(value * (units[unit] ?? 1));
+    }
+}
+exports.PyRuntime = PyRuntime;
+//# sourceMappingURL=PyRuntime.js.map

package/dist/core/PyRuntime.js.map

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

package/dist/env/CondaManager.d.ts

@@ -0,0 +1,118 @@
+/**
+ * nodepyx — CondaManager
+ * Manages Conda environments for Python package isolation.
+ *
+ * Supports:
+ *   - Detecting an existing conda environment by name
+ *   - Creating new conda environments
+ *   - Installing packages into a conda environment (conda + pip fallback)
+ *   - Returning the Python executable path inside a conda env
+ *
+ * Detection order for conda executable:
+ *   1. CONDA_EXE environment variable
+ *   2. MAMBA_EXE (uses mamba as a drop-in replacement)
+ *   3. condaPath from config
+ *   4. 'conda' on PATH
+ *   5. Common installation locations
+ */
+import type { CondaConfig } from '../types/config';
+export interface CondaEnvInfo {
+    /** Environment name */
+    name: string;
+    /** Absolute prefix path of the environment */
+    prefix: string;
+    /** Python executable inside the env */
+    pythonExecutable: string;
+    /** Whether this is the currently active environment */
+    isActive: boolean;
+}
+export interface CondaSetupResult {
+    /** Absolute path to Python executable */
+    pythonExecutable: string;
+    /** Whether the env was newly created */
+    created: boolean;
+    /** Whether packages were installed */
+    packagesInstalled: boolean;
+    /** Environment info */
+    envInfo: CondaEnvInfo;
+}
+export interface CondaManagerOptions {
+    /** Conda config from nodepyxConfig */
+    conda: CondaConfig;
+    /** Timeout for conda operations (ms). Default: 300000 (5 min) */
+    timeout?: number;
+    /** Use mamba instead of conda if available. Default: true */
+    preferMamba?: boolean;
+}
+/**
+ * CondaManager — manages Conda environments.
+ *
+ * @example
+ * ```typescript
+ * const manager = new CondaManager({
+ *   conda: {
+ *     envName: 'my-ml-env',
+ *     packages: ['numpy', 'pandas', 'scikit-learn'],
+ *     channels: ['conda-forge', 'defaults'],
+ *   }
+ * });
+ *
+ * const result = await manager.setup();
+ * console.log(result.pythonExecutable);  // /opt/conda/envs/my-ml-env/bin/python3
+ * ```
+ */
+export declare class CondaManager {
+    private readonly _config;
+    private readonly _timeout;
+    private readonly _preferMamba;
+    private _condaExec;
+    constructor(options: CondaManagerOptions);
+    /**
+     * Set up the Conda environment.
+     * Creates the environment if it doesn't exist, then installs packages.
+     */
+    setup(): Promise<CondaSetupResult>;
+    /**
+     * List all conda environments.
+     */
+    listEnvironments(): Promise<CondaEnvInfo[]>;
+    /**
+     * Check if a conda environment exists.
+     */
+    environmentExists(envName: string): Promise<boolean>;
+    /**
+     * Get the Python executable for a conda environment.
+     */
+    getPythonExecutable(envName: string): Promise<string | null>;
+    /**
+     * Install packages into an existing environment.
+     */
+    installPackages(envName: string, packages: string[]): Promise<void>;
+    /**
+     * Remove a conda environment.
+     */
+    removeEnvironment(envName: string): Promise<void>;
+    /**
+     * Return the conda executable path (or null if not found).
+     */
+    get condaExecutable(): string | null;
+    private _findCondaExecutable;
+    private _ensureCondaExec;
+    private _findEnv;
+    private _getEnvInfo;
+    private _createEnv;
+    private _installPackages;
+    private _pythonInPrefix;
+    private _which;
+}
+export declare class CondaNotFoundError extends Error {
+    constructor(message: string);
+}
+export declare class CondaEnvError extends Error {
+    constructor(message: string);
+}
+export declare class CondaPackageInstallError extends Error {
+    readonly packages: string[];
+    constructor(packages: string[], detail: string);
+}
+//# sourceMappingURL=CondaManager.d.ts.map

package/dist/env/CondaManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CondaManager.d.ts","sourceRoot":"","sources":["../../src/env/CondaManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMnD,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uBAAuB;IACvB,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,KAAK,EAAE,WAAW,CAAC;IACnB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AA2BD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,UAAU,CAAuB;gBAE7B,OAAO,EAAE,mBAAmB;IAQxC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA6CxC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAmCjD;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1D;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKlE;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzE;;OAEG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAevD;;OAEG;IACH,IAAI,eAAe,IAAI,MAAM,GAAG,IAAI,CAEnC;IAID,OAAO,CAAC,oBAAoB;IA8B5B,OAAO,CAAC,gBAAgB;YAMV,QAAQ;YAUR,WAAW;YASX,UAAU;YA8BV,gBAAgB;IAmE9B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,MAAM;CASf;AAID,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;gBAChB,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM;CAK/C"}