pynect 0.0.0 → 0.2.1

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({
+ * project: {
+ * dependencies: ['pandas', 'numpy'],
+ * },
+ * tool: { pynect: { autoSync: 'if-missing' } },
+ * });
+ *
+ * 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/py-runtime';
+import type { PynectConfig } from './types/config';
+import type { PyProxyInterface } from './types/python';
+import type { IsolatedCallOptions } from './core/isolated-worker';
+/**
+ * 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({
+ * project: { dependencies: ['pandas'] },
+ * tool: { pynect: { autoSync: 'if-missing' } },
+ * 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/py-runtime';
+export { PyProxy, PYNECT_WITH_OPTIONS } from './core/py-proxy';
+export type { PynectFunction } from './core/py-proxy';
+export { PyModule } from './core/py-module';
+export { PyCallable } from './core/py-callable';
+export { PyIterator } from './core/py-iterator';
+export { PyContext } from './core/py-context';
+export { IsolatedWorker } from './core/isolated-worker';
+export type { IsolatedCallOptions } from './core/isolated-worker';
+export { Serializer } from './serialization/serializer';
+export { NumpyBridge } from './serialization/numpy-bridge';
+export { DataFrameBridge } from './serialization/data-frame-bridge';
+export { PythonError, PythonValueError, PythonTypeError, PythonKeyError, PythonIndexError, PythonAttributeError, PythonImportError, PythonModuleNotFoundError, PythonFileNotFoundError, PythonPermissionError, PythonRuntimeError, PythonMemoryError, PythonStopIteration, PythonTimeoutError, PynectNotInitializedError, PynectShutdownError, translatePythonError, isPythonError, isPythonErrorOfType, } from './utils/error-translator';
+export { PythonDetector } from './env/python-detector';
+export { VenvManager } from './env/venv-manager';
+export { PackageInstaller } from './env/package-installer';
+export { createProjectPlan, discoverPynectContributions, moduleDispatcherIncludes, resolveExposedModule, syncProject, validateProjectEnvironment, } from './env/project-environment';
+export { CURRENT_PYNECT_SCHEMA_VERSION, resolveProjectConfig } from './config/project';
+export { PluginManager } from './plugins/plugin-manager';
+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, CanonicalPynectPackageManifest, PynectModuleManifest, PynectPackageManifest, PynectProjectTable, PynectToolTable, PynectUvTable, ProjectConfigOverrides, ResolvedProjectConfig, } from './config/project';
+export type { ExposedModule, PynectContribution, PynectEnvironmentState, PynectProjectPlan, SyncProjectOptions, SyncProjectResult, } from './env/project-environment';
+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":"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"}

package/dist/index.js

@@ -0,0 +1,394 @@
+"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({
+ * project: {
+ * dependencies: ['pandas', 'numpy'],
+ * },
+ * tool: { pynect: { autoSync: 'if-missing' } },
+ * });
+ *
+ * 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.CURRENT_PYNECT_SCHEMA_VERSION = 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 py_runtime_1 = require("./core/py-runtime");
+const logger_1 = require("./utils/logger");
+const error_translator_1 = require("./utils/error-translator");
+const project_environment_1 = require("./env/project-environment");
+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 error_translator_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 error_translator_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({
+ * project: { dependencies: ['pandas'] },
+ * tool: { pynect: { autoSync: 'if-missing' } },
+ * 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 py_runtime_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 error_translator_1.PynectNotInitializedError();
+    }
+    return _runtime;
+}
+async function importModule(moduleName) {
+    if (!_runtime) {
+        await init();
+    }
+    if (!_runtime) {
+        throw new error_translator_1.PynectNotInitializedError();
+    }
+    const exposed = moduleName.includes(':')
+        ? (0, project_environment_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 error_translator_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 error_translator_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 error_translator_1.PynectNotInitializedError();
+    }
+    return _runtime.exec(code);
+}
+/**
+ * Run a Python script file.
+ */
+async function runFile(filePath) {
+    if (!_runtime) {
+        throw new error_translator_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 error_translator_1.PynectNotInitializedError();
+    }
+    return _runtime.installPackages(packages);
+}
+/**
+ * Get memory statistics for the Python heap.
+ */
+async function getMemoryStats() {
+    if (!_runtime) {
+        throw new error_translator_1.PynectNotInitializedError();
+    }
+    return _runtime.getMemoryStats();
+}
+/**
+ * Trigger Python garbage collection.
+ */
+async function collectGarbage() {
+    if (!_runtime) {
+        throw new error_translator_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 py_runtime_2 = require("./core/py-runtime");
+Object.defineProperty(exports, "PyRuntime", { enumerable: true, get: function () { return py_runtime_2.PyRuntime; } });
+var py_proxy_1 = require("./core/py-proxy");
+Object.defineProperty(exports, "PyProxy", { enumerable: true, get: function () { return py_proxy_1.PyProxy; } });
+Object.defineProperty(exports, "PYNECT_WITH_OPTIONS", { enumerable: true, get: function () { return py_proxy_1.PYNECT_WITH_OPTIONS; } });
+var py_module_1 = require("./core/py-module");
+Object.defineProperty(exports, "PyModule", { enumerable: true, get: function () { return py_module_1.PyModule; } });
+var py_callable_1 = require("./core/py-callable");
+Object.defineProperty(exports, "PyCallable", { enumerable: true, get: function () { return py_callable_1.PyCallable; } });
+var py_iterator_1 = require("./core/py-iterator");
+Object.defineProperty(exports, "PyIterator", { enumerable: true, get: function () { return py_iterator_1.PyIterator; } });
+var py_context_1 = require("./core/py-context");
+Object.defineProperty(exports, "PyContext", { enumerable: true, get: function () { return py_context_1.PyContext; } });
+var isolated_worker_1 = require("./core/isolated-worker");
+Object.defineProperty(exports, "IsolatedWorker", { enumerable: true, get: function () { return isolated_worker_1.IsolatedWorker; } });
+// Serialization
+var serializer_1 = require("./serialization/serializer");
+Object.defineProperty(exports, "Serializer", { enumerable: true, get: function () { return serializer_1.Serializer; } });
+var numpy_bridge_1 = require("./serialization/numpy-bridge");
+Object.defineProperty(exports, "NumpyBridge", { enumerable: true, get: function () { return numpy_bridge_1.NumpyBridge; } });
+var data_frame_bridge_1 = require("./serialization/data-frame-bridge");
+Object.defineProperty(exports, "DataFrameBridge", { enumerable: true, get: function () { return data_frame_bridge_1.DataFrameBridge; } });
+// Error types
+var error_translator_2 = require("./utils/error-translator");
+Object.defineProperty(exports, "PythonError", { enumerable: true, get: function () { return error_translator_2.PythonError; } });
+Object.defineProperty(exports, "PythonValueError", { enumerable: true, get: function () { return error_translator_2.PythonValueError; } });
+Object.defineProperty(exports, "PythonTypeError", { enumerable: true, get: function () { return error_translator_2.PythonTypeError; } });
+Object.defineProperty(exports, "PythonKeyError", { enumerable: true, get: function () { return error_translator_2.PythonKeyError; } });
+Object.defineProperty(exports, "PythonIndexError", { enumerable: true, get: function () { return error_translator_2.PythonIndexError; } });
+Object.defineProperty(exports, "PythonAttributeError", { enumerable: true, get: function () { return error_translator_2.PythonAttributeError; } });
+Object.defineProperty(exports, "PythonImportError", { enumerable: true, get: function () { return error_translator_2.PythonImportError; } });
+Object.defineProperty(exports, "PythonModuleNotFoundError", { enumerable: true, get: function () { return error_translator_2.PythonModuleNotFoundError; } });
+Object.defineProperty(exports, "PythonFileNotFoundError", { enumerable: true, get: function () { return error_translator_2.PythonFileNotFoundError; } });
+Object.defineProperty(exports, "PythonPermissionError", { enumerable: true, get: function () { return error_translator_2.PythonPermissionError; } });
+Object.defineProperty(exports, "PythonRuntimeError", { enumerable: true, get: function () { return error_translator_2.PythonRuntimeError; } });
+Object.defineProperty(exports, "PythonMemoryError", { enumerable: true, get: function () { return error_translator_2.PythonMemoryError; } });
+Object.defineProperty(exports, "PythonStopIteration", { enumerable: true, get: function () { return error_translator_2.PythonStopIteration; } });
+Object.defineProperty(exports, "PythonTimeoutError", { enumerable: true, get: function () { return error_translator_2.PythonTimeoutError; } });
+Object.defineProperty(exports, "PynectNotInitializedError", { enumerable: true, get: function () { return error_translator_2.PynectNotInitializedError; } });
+Object.defineProperty(exports, "PynectShutdownError", { enumerable: true, get: function () { return error_translator_2.PynectShutdownError; } });
+Object.defineProperty(exports, "translatePythonError", { enumerable: true, get: function () { return error_translator_2.translatePythonError; } });
+Object.defineProperty(exports, "isPythonError", { enumerable: true, get: function () { return error_translator_2.isPythonError; } });
+Object.defineProperty(exports, "isPythonErrorOfType", { enumerable: true, get: function () { return error_translator_2.isPythonErrorOfType; } });
+// Environment management
+var python_detector_1 = require("./env/python-detector");
+Object.defineProperty(exports, "PythonDetector", { enumerable: true, get: function () { return python_detector_1.PythonDetector; } });
+var venv_manager_1 = require("./env/venv-manager");
+Object.defineProperty(exports, "VenvManager", { enumerable: true, get: function () { return venv_manager_1.VenvManager; } });
+var package_installer_1 = require("./env/package-installer");
+Object.defineProperty(exports, "PackageInstaller", { enumerable: true, get: function () { return package_installer_1.PackageInstaller; } });
+var project_environment_2 = require("./env/project-environment");
+Object.defineProperty(exports, "createProjectPlan", { enumerable: true, get: function () { return project_environment_2.createProjectPlan; } });
+Object.defineProperty(exports, "discoverPynectContributions", { enumerable: true, get: function () { return project_environment_2.discoverPynectContributions; } });
+Object.defineProperty(exports, "moduleDispatcherIncludes", { enumerable: true, get: function () { return project_environment_2.moduleDispatcherIncludes; } });
+Object.defineProperty(exports, "resolveExposedModule", { enumerable: true, get: function () { return project_environment_2.resolveExposedModule; } });
+Object.defineProperty(exports, "syncProject", { enumerable: true, get: function () { return project_environment_2.syncProject; } });
+Object.defineProperty(exports, "validateProjectEnvironment", { enumerable: true, get: function () { return project_environment_2.validateProjectEnvironment; } });
+var project_1 = require("./config/project");
+Object.defineProperty(exports, "CURRENT_PYNECT_SCHEMA_VERSION", { enumerable: true, get: function () { return project_1.CURRENT_PYNECT_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "resolveProjectConfig", { enumerable: true, get: function () { return project_1.resolveProjectConfig; } });
+// Plugins
+var plugin_manager_1 = require("./plugins/plugin-manager");
+Object.defineProperty(exports, "PluginManager", { enumerable: true, get: function () { return plugin_manager_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/native-addon-loader.d.ts

@@ -0,0 +1,13 @@
+import type { NativeAddon } from '../types/addon';
+export interface NativeAddonBuildOptions {
+    projectRoot: string;
+    pythonExecutable: string;
+    pythonLibrary: string;
+    pythonVersion: string;
+}
+/**
+ * Load a compatible packaged prebuild or exact local addon, compiling through
+ * the active JavaScript runtime only when neither can be used.
+ */
+export declare function loadOrBuildNativeAddon(options: NativeAddonBuildOptions): NativeAddon;
+//# sourceMappingURL=native-addon-loader.d.ts.map

package/dist/native/native-addon-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-addon-loader.d.ts","sourceRoot":"","sources":["../../src/native/native-addon-loader.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,uBAAuB,GAAG,WAAW,CAgDpF"}