pynect 0.0.0-stage → 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,182 @@
+/**
+ * pynect - Main Entry Point
+ *
+ * Run Python libraries from Node.js as if they were Native.
+ * Embeds CPython in-process via N-API addon with full TypeScript types,
+ * Proxy-based API, async/await support, and Next.js integration.
+ *
+ * @example
+ * ```typescript
+ * import { init, py } from 'pynect';
+ *
+ * await init({
+ * virtualenv: {
+ * path: './.venv',
+ * packages: ['pandas', 'numpy'],
+ * autoInstall: true,
+ * },
+ * });
+ *
+ * const pd = await py.import('pandas');
+ * const df = await pd.read_csv('data.csv');
+ * const result = await df.describe().to_dict('records');
+ * ```
+ */
+import { PyRuntime } from './core/PyRuntime';
+import type { PynectConfig } from './types/config';
+import type { PyProxyInterface } from './types/python';
+import type { IsolatedCallOptions } from './core/IsolatedWorker';
+/**
+ * The main `py` object - a proxy over the PyRuntime singleton.
+ * Provides access to all PyRuntime methods after initialization.
+ *
+ * @throws {PynectNotInitializedError} if accessed before calling `init()`
+ */
+export declare const py: PyRuntime;
+/**
+ * Initialize the pynect runtime.
+ * Must be called before using `py` or any other pynect API.
+ *
+ * Calling `init()` multiple times is safe - subsequent calls are no-ops
+ * unless `shutdown()` was called first, or `force: true` is passed.
+ *
+ * @param config - pynect configuration options
+ * @param options - Additional initialization options
+ * @returns Promise that resolves when Python is ready
+ *
+ * @example
+ * ```typescript
+ * await init({
+ * virtualenv: { path: '.venv', packages: ['pandas'], autoInstall: true },
+ * logLevel: 'info',
+ * });
+ * ```
+ */
+export declare function init(config?: PynectConfig, options?: {
+    force?: boolean;
+}): Promise<void>;
+/**
+ * Shut down the pynect runtime and release all Python resources.
+ * After calling this, `py` is no longer accessible until `init()` is called again.
+ *
+ * @example
+ * ```typescript
+ * await shutdown();
+ * ```
+ */
+export declare function shutdown(): Promise<void>;
+/**
+ * Check if pynect is initialized and ready to use.
+ */
+export declare function isInitialized(): boolean;
+/**
+ * Get the current PyRuntime instance.
+ * @throws {PynectNotInitializedError} if not initialized
+ */
+export declare function getRuntime(): PyRuntime;
+/**
+ * Initialize the default runtime when needed, then import a Python module.
+ * Call `init(config)` first when custom runtime settings are required.
+ *
+ * @example
+ * ```typescript
+ * const np = await importModule('numpy');
+ * const arr = await np.array([1, 2, 3]);
+ * ```
+ */
+/** Module types contributed by `pynect codegen`. */
+export interface PynectModules {
+}
+export declare function importModule<Name extends keyof PynectModules & string>(moduleName: Name): Promise<PynectModules[Name]>;
+export declare function importModule(moduleName: string): Promise<PyProxyInterface>;
+/** Call a JSON-compatible function through the optional killable Python worker. */
+export declare function callIsolated<T = unknown>(moduleName: string, functionName: string, args?: unknown[], options?: IsolatedCallOptions): Promise<T>;
+/**
+ * Evaluate a Python expression and return the result.
+ * Shorthand for `py.eval(expression)`.
+ *
+ * @example
+ * ```typescript
+ * const result = await evalPython('1 + 2 + 3');
+ * // result === 6
+ * ```
+ */
+export declare function evalPython(expression: string): Promise<unknown>;
+/**
+ * Execute Python code (statements, not expressions).
+ * Shorthand for `py.exec(code)`.
+ *
+ * @example
+ * ```typescript
+ * await execPython(`
+ * import sys
+ * print(f"Python {sys.version}")
+ * `);
+ * ```
+ */
+export declare function execPython(code: string): Promise<void>;
+/**
+ * Run a Python script file.
+ */
+export declare function runFile(filePath: string): Promise<unknown>;
+/**
+ * Install Python packages into the configured virtualenv.
+ *
+ * @example
+ * ```typescript
+ * await installPackages(['pandas', 'numpy>=1.24.0', 'scikit-learn']);
+ * ```
+ */
+export declare function installPackages(packages: string[]): Promise<void>;
+/**
+ * Get memory statistics for the Python heap.
+ */
+export declare function getMemoryStats(): Promise<{
+    pythonHeapBytes: number;
+    pythonHeapPeakBytes: number;
+    trackedObjects: number;
+    pendingCallbacks: number;
+}>;
+/**
+ * Trigger Python garbage collection.
+ */
+export declare function collectGarbage(): Promise<void>;
+export { PyRuntime } from './core/PyRuntime';
+export { PyProxy, PYNECT_WITH_OPTIONS } from './core/PyProxy';
+export type { PynectFunction } from './core/PyProxy';
+export { PyModule } from './core/PyModule';
+export { PyCallable } from './core/PyCallable';
+export { PyIterator } from './core/PyIterator';
+export { PyContext } from './core/PyContext';
+export { IsolatedWorker } from './core/IsolatedWorker';
+export type { IsolatedCallOptions } from './core/IsolatedWorker';
+export { Serializer } from './serialization/Serializer';
+export { NumpyBridge } from './serialization/NumpyBridge';
+export { DataFrameBridge } from './serialization/DataFrameBridge';
+export { PythonError, PythonValueError, PythonTypeError, PythonKeyError, PythonIndexError, PythonAttributeError, PythonImportError, PythonModuleNotFoundError, PythonFileNotFoundError, PythonPermissionError, PythonRuntimeError, PythonMemoryError, PythonStopIteration, PythonTimeoutError, PynectNotInitializedError, PynectShutdownError, translatePythonError, isPythonError, isPythonErrorOfType, } from './utils/ErrorTranslator';
+export { PythonDetector } from './env/PythonDetector';
+export { VenvManager } from './env/VenvManager';
+export { PackageInstaller } from './env/PackageInstaller';
+export { createProjectPlan, discoverPynectContributions, moduleDispatcherIncludes, resolveExposedModule, syncProject, validateProjectEnvironment, } from './env/ProjectEnvironment';
+export { resolveProjectConfig } from './config/project';
+export { PluginManager } from './plugins/PluginManager';
+export type { PynectConfig, ResolvedPynectConfig, VirtualenvConfig, IsolationConfig, DispatcherConfig, LogLevel, PyObjectId, PyTypeInfo, PyParamInfo, PyCallableInfo, PyClassInfo, PyModuleInspection, SerializedFormat, SerializedValue, PyCallResult, PyErrorInfo, DataFrameResult, SeriesResult, NumPyArrayResult, PyProxyInterface, AttributePath, NativeAddon, PyCallOptions, } from './types/index';
+export type { AutoSyncMode, PynectModuleManifest, PynectPackageManifest, ResolvedProjectConfig, } from './config/project';
+export type { ExposedModule, PynectContribution, PynectEnvironmentState, PynectProjectPlan, SyncProjectOptions, SyncProjectResult, } from './env/ProjectEnvironment';
+declare const _default: {
+    init: typeof init;
+    shutdown: typeof shutdown;
+    isInitialized: typeof isInitialized;
+    getRuntime: typeof getRuntime;
+    py: PyRuntime;
+    import: typeof importModule;
+    callIsolated: typeof callIsolated;
+    eval: typeof evalPython;
+    exec: typeof execPython;
+    runFile: typeof runFile;
+    installPackages: typeof installPackages;
+    getMemoryStats: typeof getMemoryStats;
+    collectGarbage: typeof collectGarbage;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAG7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAajE;;;;;GAKG;AACH,eAAO,MAAM,EAAE,EAAE,SAgCf,CAAC;AAIH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,IAAI,CACxB,MAAM,CAAC,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,IAAI,CAAC,CAmBf;AAmBD;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAY9C;AAqBD;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,SAAS,CAKtC;AAID;;;;;;;;;GASG;AACH,oDAAoD;AACpD,MAAM,WAAW,aAAa;CAAG;AAEjC,wBAAgB,YAAY,CAAC,IAAI,SAAS,MAAM,aAAa,GAAG,MAAM,EACpE,UAAU,EAAE,IAAI,GACf,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAa5E,mFAAmF;AACnF,wBAAsB,YAAY,CAAC,CAAC,GAAG,OAAO,EAC5C,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,IAAI,GAAE,OAAO,EAAO,EACpB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,CAAC,CAAC,CAGZ;AAED;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGrE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG5D;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhE;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC,CAGD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpD;AA8BD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAGjE,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,yBAAyB,EACzB,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACpB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EACL,iBAAiB,EACjB,2BAA2B,EAC3B,wBAAwB,EACxB,oBAAoB,EACpB,WAAW,EACX,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGxD,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,QAAQ,EACR,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,aAAa,GACd,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;;;;;;;;;;;;;;;;AAGlC,wBAcE"}

package/dist/index.js

@@ -0,0 +1,393 @@
+"use strict";
+/**
+ * pynect - Main Entry Point
+ *
+ * Run Python libraries from Node.js as if they were Native.
+ * Embeds CPython in-process via N-API addon with full TypeScript types,
+ * Proxy-based API, async/await support, and Next.js integration.
+ *
+ * @example
+ * ```typescript
+ * import { init, py } from 'pynect';
+ *
+ * await init({
+ * virtualenv: {
+ * path: './.venv',
+ * packages: ['pandas', 'numpy'],
+ * autoInstall: true,
+ * },
+ * });
+ *
+ * const pd = await py.import('pandas');
+ * const df = await pd.read_csv('data.csv');
+ * const result = await df.describe().to_dict('records');
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginManager = exports.resolveProjectConfig = exports.validateProjectEnvironment = exports.syncProject = exports.resolveExposedModule = exports.moduleDispatcherIncludes = exports.discoverPynectContributions = exports.createProjectPlan = exports.PackageInstaller = exports.VenvManager = exports.PythonDetector = exports.isPythonErrorOfType = exports.isPythonError = exports.translatePythonError = exports.PynectShutdownError = exports.PynectNotInitializedError = exports.PythonTimeoutError = exports.PythonStopIteration = exports.PythonMemoryError = exports.PythonRuntimeError = exports.PythonPermissionError = exports.PythonFileNotFoundError = exports.PythonModuleNotFoundError = exports.PythonImportError = exports.PythonAttributeError = exports.PythonIndexError = exports.PythonKeyError = exports.PythonTypeError = exports.PythonValueError = exports.PythonError = exports.DataFrameBridge = exports.NumpyBridge = exports.Serializer = exports.IsolatedWorker = exports.PyContext = exports.PyIterator = exports.PyCallable = exports.PyModule = exports.PYNECT_WITH_OPTIONS = exports.PyProxy = exports.PyRuntime = exports.py = void 0;
+exports.init = init;
+exports.shutdown = shutdown;
+exports.isInitialized = isInitialized;
+exports.getRuntime = getRuntime;
+exports.importModule = importModule;
+exports.callIsolated = callIsolated;
+exports.evalPython = evalPython;
+exports.execPython = execPython;
+exports.runFile = runFile;
+exports.installPackages = installPackages;
+exports.getMemoryStats = getMemoryStats;
+exports.collectGarbage = collectGarbage;
+const PyRuntime_1 = require("./core/PyRuntime");
+const Logger_1 = require("./utils/Logger");
+const ErrorTranslator_1 = require("./utils/ErrorTranslator");
+const ProjectEnvironment_1 = require("./env/ProjectEnvironment");
+const Locking_1 = require("./utils/Locking");
+// Singleton Runtime Management
+let _runtime = null;
+let _autoShutdownEnabled = true;
+const _logger = new Logger_1.Logger('pynect');
+// Main py Object (Proxy over PyRuntime)
+/**
+ * The main `py` object - a proxy over the PyRuntime singleton.
+ * Provides access to all PyRuntime methods after initialization.
+ *
+ * @throws {PynectNotInitializedError} if accessed before calling `init()`
+ */
+exports.py = new Proxy({}, {
+    get(_target, prop) {
+        if (!_runtime) {
+            // Provide helpful error for common misuse
+            if (prop === 'then') {
+                // Prevent silent "awaiting py" mistakes
+                return undefined;
+            }
+            throw new ErrorTranslator_1.PynectNotInitializedError(`Cannot access py.${String(prop)} because Pynect is not initialized. ` +
+                `Call 'await init()' before using 'py'.`);
+        }
+        const value = _runtime[prop];
+        if (typeof value === 'function') {
+            return value.bind(_runtime);
+        }
+        return value;
+    },
+    set(_target, prop, value) {
+        if (!_runtime) {
+            throw new ErrorTranslator_1.PynectNotInitializedError('Pynect is not initialized.');
+        }
+        _runtime[prop] = value;
+        return true;
+    },
+    has(_target, prop) {
+        if (!_runtime) {
+            return false;
+        }
+        return prop in _runtime;
+    },
+});
+// Lifecycle Functions
+/**
+ * Initialize the pynect runtime.
+ * Must be called before using `py` or any other pynect API.
+ *
+ * Calling `init()` multiple times is safe - subsequent calls are no-ops
+ * unless `shutdown()` was called first, or `force: true` is passed.
+ *
+ * @param config - pynect configuration options
+ * @param options - Additional initialization options
+ * @returns Promise that resolves when Python is ready
+ *
+ * @example
+ * ```typescript
+ * await init({
+ * virtualenv: { path: '.venv', packages: ['pandas'], autoInstall: true },
+ * logLevel: 'info',
+ * });
+ * ```
+ */
+async function init(config, options) {
+    await (0, Locking_1.withPynectLock)({ operation: 'init' }, async () => {
+        if (_runtime && !options?.force) {
+            _logger.debug('Pynect already initialized; skipping');
+            return;
+        }
+        if (_runtime && options?.force)
+            await _doShutdown();
+        await _doInit(config);
+    }, undefined, {
+        key: 'pynect-runtime-lifecycle',
+        name: 'Pynect runtime lifecycle',
+        namespace: 'pynect',
+        scope: 'memory',
+    });
+}
+async function _doInit(config) {
+    _logger.info('Initializing Pynect runtime');
+    const startTime = performance.now();
+    try {
+        _runtime = await PyRuntime_1.PyRuntime.create(config);
+        _autoShutdownEnabled = _runtime.getConfig().autoShutdown;
+        if (_autoShutdownEnabled) {
+            _registerCleanup();
+        }
+        const elapsed = (performance.now() - startTime).toFixed(0);
+        _logger.success(`Pynect runtime ready in ${elapsed}ms`);
+    }
+    catch (err) {
+        _runtime = null;
+        _logger.error('Failed to initialize Pynect runtime', err);
+        throw err;
+    }
+}
+/**
+ * Shut down the pynect runtime and release all Python resources.
+ * After calling this, `py` is no longer accessible until `init()` is called again.
+ *
+ * @example
+ * ```typescript
+ * await shutdown();
+ * ```
+ */
+async function shutdown() {
+    await (0, Locking_1.withPynectLock)({ operation: 'shutdown' }, async () => _doShutdown(), undefined, {
+        key: 'pynect-runtime-lifecycle',
+        name: 'Pynect runtime lifecycle',
+        namespace: 'pynect',
+        scope: 'memory',
+    });
+}
+async function _doShutdown() {
+    if (!_runtime) {
+        _logger.debug('Pynect is not initialized; nothing to shut down');
+        return;
+    }
+    _logger.info('Shutting down Pynect runtime');
+    const runtime = _runtime;
+    try {
+        await runtime.shutdown();
+        _runtime = null;
+        _logger.success('Pynect runtime shut down');
+    }
+    catch (err) {
+        _logger.error('Error during Pynect shutdown', err);
+        throw err;
+    }
+}
+/**
+ * Check if pynect is initialized and ready to use.
+ */
+function isInitialized() {
+    return _runtime !== null && _runtime.isRunning();
+}
+/**
+ * Get the current PyRuntime instance.
+ * @throws {PynectNotInitializedError} if not initialized
+ */
+function getRuntime() {
+    if (!_runtime) {
+        throw new ErrorTranslator_1.PynectNotInitializedError();
+    }
+    return _runtime;
+}
+async function importModule(moduleName) {
+    if (!_runtime) {
+        await init();
+    }
+    if (!_runtime) {
+        throw new ErrorTranslator_1.PynectNotInitializedError();
+    }
+    const exposed = moduleName.includes(':')
+        ? (0, ProjectEnvironment_1.resolveExposedModule)(moduleName, _runtime.getConfig().projectRoot)
+        : undefined;
+    if (moduleName.includes(':') && !exposed) {
+        throw new Error(`Unknown Pynect module id: ${moduleName}`);
+    }
+    return _runtime.import(exposed?.import ?? moduleName);
+}
+/** Call a JSON-compatible function through the optional killable Python worker. */
+async function callIsolated(moduleName, functionName, args = [], options = {}) {
+    if (!_runtime) {
+        throw new ErrorTranslator_1.PynectNotInitializedError();
+    }
+    return _runtime.callIsolated(moduleName, functionName, args, options);
+}
+/**
+ * Evaluate a Python expression and return the result.
+ * Shorthand for `py.eval(expression)`.
+ *
+ * @example
+ * ```typescript
+ * const result = await evalPython('1 + 2 + 3');
+ * // result === 6
+ * ```
+ */
+async function evalPython(expression) {
+    if (!_runtime) {
+        throw new ErrorTranslator_1.PynectNotInitializedError();
+    }
+    return _runtime.eval(expression);
+}
+/**
+ * Execute Python code (statements, not expressions).
+ * Shorthand for `py.exec(code)`.
+ *
+ * @example
+ * ```typescript
+ * await execPython(`
+ * import sys
+ * print(f"Python {sys.version}")
+ * `);
+ * ```
+ */
+async function execPython(code) {
+    if (!_runtime) {
+        throw new ErrorTranslator_1.PynectNotInitializedError();
+    }
+    return _runtime.exec(code);
+}
+/**
+ * Run a Python script file.
+ */
+async function runFile(filePath) {
+    if (!_runtime) {
+        throw new ErrorTranslator_1.PynectNotInitializedError();
+    }
+    return _runtime.runFile(filePath);
+}
+/**
+ * Install Python packages into the configured virtualenv.
+ *
+ * @example
+ * ```typescript
+ * await installPackages(['pandas', 'numpy>=1.24.0', 'scikit-learn']);
+ * ```
+ */
+async function installPackages(packages) {
+    if (!_runtime) {
+        throw new ErrorTranslator_1.PynectNotInitializedError();
+    }
+    return _runtime.installPackages(packages);
+}
+/**
+ * Get memory statistics for the Python heap.
+ */
+async function getMemoryStats() {
+    if (!_runtime) {
+        throw new ErrorTranslator_1.PynectNotInitializedError();
+    }
+    return _runtime.getMemoryStats();
+}
+/**
+ * Trigger Python garbage collection.
+ */
+async function collectGarbage() {
+    if (!_runtime) {
+        throw new ErrorTranslator_1.PynectNotInitializedError();
+    }
+    return _runtime.collectGarbage();
+}
+// Auto-cleanup on process exit
+let _cleanupRegistered = false;
+function _registerCleanup() {
+    if (_cleanupRegistered) {
+        return;
+    }
+    _cleanupRegistered = true;
+    const cleanup = () => {
+        if (!_autoShutdownEnabled || !_runtime) {
+            return Promise.resolve();
+        }
+        return shutdown().catch(() => undefined);
+    };
+    process.on('beforeExit', cleanup);
+    process.on('exit', () => {
+        if (_autoShutdownEnabled && _runtime) {
+            try {
+                _runtime.shutdownSync();
+            }
+            catch {
+                // Process exit cleanup is best-effort.
+            }
+        }
+    });
+}
+// Exports
+// Core
+var PyRuntime_2 = require("./core/PyRuntime");
+Object.defineProperty(exports, "PyRuntime", { enumerable: true, get: function () { return PyRuntime_2.PyRuntime; } });
+var PyProxy_1 = require("./core/PyProxy");
+Object.defineProperty(exports, "PyProxy", { enumerable: true, get: function () { return PyProxy_1.PyProxy; } });
+Object.defineProperty(exports, "PYNECT_WITH_OPTIONS", { enumerable: true, get: function () { return PyProxy_1.PYNECT_WITH_OPTIONS; } });
+var PyModule_1 = require("./core/PyModule");
+Object.defineProperty(exports, "PyModule", { enumerable: true, get: function () { return PyModule_1.PyModule; } });
+var PyCallable_1 = require("./core/PyCallable");
+Object.defineProperty(exports, "PyCallable", { enumerable: true, get: function () { return PyCallable_1.PyCallable; } });
+var PyIterator_1 = require("./core/PyIterator");
+Object.defineProperty(exports, "PyIterator", { enumerable: true, get: function () { return PyIterator_1.PyIterator; } });
+var PyContext_1 = require("./core/PyContext");
+Object.defineProperty(exports, "PyContext", { enumerable: true, get: function () { return PyContext_1.PyContext; } });
+var IsolatedWorker_1 = require("./core/IsolatedWorker");
+Object.defineProperty(exports, "IsolatedWorker", { enumerable: true, get: function () { return IsolatedWorker_1.IsolatedWorker; } });
+// Serialization
+var Serializer_1 = require("./serialization/Serializer");
+Object.defineProperty(exports, "Serializer", { enumerable: true, get: function () { return Serializer_1.Serializer; } });
+var NumpyBridge_1 = require("./serialization/NumpyBridge");
+Object.defineProperty(exports, "NumpyBridge", { enumerable: true, get: function () { return NumpyBridge_1.NumpyBridge; } });
+var DataFrameBridge_1 = require("./serialization/DataFrameBridge");
+Object.defineProperty(exports, "DataFrameBridge", { enumerable: true, get: function () { return DataFrameBridge_1.DataFrameBridge; } });
+// Error types
+var ErrorTranslator_2 = require("./utils/ErrorTranslator");
+Object.defineProperty(exports, "PythonError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonError; } });
+Object.defineProperty(exports, "PythonValueError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonValueError; } });
+Object.defineProperty(exports, "PythonTypeError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonTypeError; } });
+Object.defineProperty(exports, "PythonKeyError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonKeyError; } });
+Object.defineProperty(exports, "PythonIndexError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonIndexError; } });
+Object.defineProperty(exports, "PythonAttributeError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonAttributeError; } });
+Object.defineProperty(exports, "PythonImportError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonImportError; } });
+Object.defineProperty(exports, "PythonModuleNotFoundError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonModuleNotFoundError; } });
+Object.defineProperty(exports, "PythonFileNotFoundError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonFileNotFoundError; } });
+Object.defineProperty(exports, "PythonPermissionError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonPermissionError; } });
+Object.defineProperty(exports, "PythonRuntimeError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonRuntimeError; } });
+Object.defineProperty(exports, "PythonMemoryError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonMemoryError; } });
+Object.defineProperty(exports, "PythonStopIteration", { enumerable: true, get: function () { return ErrorTranslator_2.PythonStopIteration; } });
+Object.defineProperty(exports, "PythonTimeoutError", { enumerable: true, get: function () { return ErrorTranslator_2.PythonTimeoutError; } });
+Object.defineProperty(exports, "PynectNotInitializedError", { enumerable: true, get: function () { return ErrorTranslator_2.PynectNotInitializedError; } });
+Object.defineProperty(exports, "PynectShutdownError", { enumerable: true, get: function () { return ErrorTranslator_2.PynectShutdownError; } });
+Object.defineProperty(exports, "translatePythonError", { enumerable: true, get: function () { return ErrorTranslator_2.translatePythonError; } });
+Object.defineProperty(exports, "isPythonError", { enumerable: true, get: function () { return ErrorTranslator_2.isPythonError; } });
+Object.defineProperty(exports, "isPythonErrorOfType", { enumerable: true, get: function () { return ErrorTranslator_2.isPythonErrorOfType; } });
+// Environment management
+var PythonDetector_1 = require("./env/PythonDetector");
+Object.defineProperty(exports, "PythonDetector", { enumerable: true, get: function () { return PythonDetector_1.PythonDetector; } });
+var VenvManager_1 = require("./env/VenvManager");
+Object.defineProperty(exports, "VenvManager", { enumerable: true, get: function () { return VenvManager_1.VenvManager; } });
+var PackageInstaller_1 = require("./env/PackageInstaller");
+Object.defineProperty(exports, "PackageInstaller", { enumerable: true, get: function () { return PackageInstaller_1.PackageInstaller; } });
+var ProjectEnvironment_2 = require("./env/ProjectEnvironment");
+Object.defineProperty(exports, "createProjectPlan", { enumerable: true, get: function () { return ProjectEnvironment_2.createProjectPlan; } });
+Object.defineProperty(exports, "discoverPynectContributions", { enumerable: true, get: function () { return ProjectEnvironment_2.discoverPynectContributions; } });
+Object.defineProperty(exports, "moduleDispatcherIncludes", { enumerable: true, get: function () { return ProjectEnvironment_2.moduleDispatcherIncludes; } });
+Object.defineProperty(exports, "resolveExposedModule", { enumerable: true, get: function () { return ProjectEnvironment_2.resolveExposedModule; } });
+Object.defineProperty(exports, "syncProject", { enumerable: true, get: function () { return ProjectEnvironment_2.syncProject; } });
+Object.defineProperty(exports, "validateProjectEnvironment", { enumerable: true, get: function () { return ProjectEnvironment_2.validateProjectEnvironment; } });
+var project_1 = require("./config/project");
+Object.defineProperty(exports, "resolveProjectConfig", { enumerable: true, get: function () { return project_1.resolveProjectConfig; } });
+// Plugins
+var PluginManager_1 = require("./plugins/PluginManager");
+Object.defineProperty(exports, "PluginManager", { enumerable: true, get: function () { return PluginManager_1.PluginManager; } });
+// Default export
+exports.default = {
+    init,
+    shutdown,
+    isInitialized,
+    getRuntime,
+    py: exports.py,
+    import: importModule,
+    callIsolated,
+    eval: evalPython,
+    exec: execPython,
+    runFile,
+    installPackages,
+    getMemoryStats,
+    collectGarbage,
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/native/NativeAddonLoader.d.ts

@@ -0,0 +1,11 @@
+import type { NativeAddon } from '../types/addon';
+export interface NativeAddonBuildOptions {
+    projectRoot: string;
+    pythonExecutable: string;
+}
+/**
+ * Load an addon built for the selected Python, compiling it through the active
+ * JavaScript runtime when no exact match exists.
+ */
+export declare function loadOrBuildNativeAddon(options: NativeAddonBuildOptions): NativeAddon;
+//# sourceMappingURL=NativeAddonLoader.d.ts.map

package/dist/native/NativeAddonLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeAddonLoader.d.ts","sourceRoot":"","sources":["../../src/native/NativeAddonLoader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,WAAW,CA2CpF"}