nodepyx 1.0.0

package/dist/plugins/PluginManager.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * nodepyx — PluginManager
+ *
+ * Manages registration, lifecycle, and dispatch of nodepyx plugins.
+ * PyRuntime holds a single PluginManager 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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginManager = void 0;
+const Logger_1 = require("../utils/Logger");
+const logger = new Logger_1.Logger('PluginManager');
+class PluginManager {
+    _plugins = new Map();
+    _typeMap = new Map();
+    _moduleMap = new Map();
+    // ── Registration ────────────────────────────────────────────────────────────
+    register(plugin) {
+        if (this._plugins.has(plugin.name)) {
+            logger.debug(`Plugin already registered: ${plugin.name} — skipping`);
+            return this;
+        }
+        const entry = {
+            plugin,
+            active: false,
+            loadedAt: Date.now(),
+            modulesBound: new Set(),
+        };
+        this._plugins.set(plugin.name, entry);
+        for (const typeName of plugin.handledTypes ?? []) {
+            const handlers = this._typeMap.get(typeName) ?? [];
+            if (plugin.transformResult) {
+                handlers.push(plugin.transformResult.bind(plugin));
+            }
+            this._typeMap.set(typeName, handlers);
+        }
+        for (const mod of plugin.supportedModules) {
+            const list = this._moduleMap.get(mod) ?? [];
+            list.push(plugin);
+            this._moduleMap.set(mod, list);
+        }
+        logger.debug(`Registered plugin: ${plugin.name} v${plugin.version}`);
+        return this;
+    }
+    async registerBuiltins() {
+        const [{ PandasPlugin }, { NumpyPlugin }, { TorchPlugin }] = await Promise.all([
+            Promise.resolve().then(() => __importStar(require('./builtin/PandasPlugin'))),
+            Promise.resolve().then(() => __importStar(require('./builtin/NumpyPlugin'))),
+            Promise.resolve().then(() => __importStar(require('./builtin/TorchPlugin'))),
+        ]);
+        this.register(new PandasPlugin());
+        this.register(new NumpyPlugin());
+        this.register(new TorchPlugin());
+    }
+    // ── Lifecycle ────────────────────────────────────────────────────────────────
+    async initAll(ctx) {
+        const extCtx = {
+            ...ctx,
+            registerTypeHandler: (typeName, handler) => {
+                const handlers = this._typeMap.get(typeName) ?? [];
+                handlers.push(handler);
+                this._typeMap.set(typeName, handlers);
+            },
+        };
+        for (const [name, entry] of this._plugins) {
+            try {
+                await entry.plugin.onInit?.(extCtx);
+                entry.active = true;
+                logger.debug(`Initialised plugin: ${name}`);
+            }
+            catch (err) {
+                logger.warn(`Plugin ${name} init failed (non-fatal): ${err}`);
+            }
+        }
+    }
+    async shutdownAll() {
+        for (const [name, entry] of this._plugins) {
+            if (!entry.active) {
+                continue;
+            }
+            try {
+                await entry.plugin.onShutdown?.();
+                entry.active = false;
+            }
+            catch (err) {
+                logger.warn(`Plugin ${name} shutdown error (non-fatal): ${err}`);
+            }
+        }
+    }
+    async onModuleImported(moduleName, moduleOid) {
+        const plugins = this._moduleMap.get(moduleName) ?? [];
+        for (const plugin of plugins) {
+            try {
+                await plugin.onModuleImported?.(moduleName, moduleOid);
+            }
+            catch (err) {
+                logger.warn(`Plugin ${plugin.name} onModuleImported error: ${err}`);
+            }
+        }
+    }
+    // ── Transform chain ──────────────────────────────────────────────────────────
+    transformResult(value, typeName, metadata = {}) {
+        const handlers = this._typeMap.get(typeName) ?? [];
+        for (const handler of handlers) {
+            try {
+                const result = handler(value, typeName, metadata);
+                if (result !== null) {
+                    return result;
+                }
+            }
+            catch (err) {
+                logger.warn(`Type transform error for ${typeName}: ${err}`);
+            }
+        }
+        return null;
+    }
+    serializeValue(value, targetTypeName) {
+        for (const [, entry] of this._plugins) {
+            if (!entry.active || !entry.plugin.serializeValue) {
+                continue;
+            }
+            try {
+                const result = entry.plugin.serializeValue(value, targetTypeName);
+                if (result !== null) {
+                    return result;
+                }
+            }
+            catch (err) {
+                logger.warn(`Plugin serialize error: ${err}`);
+            }
+        }
+        return null;
+    }
+    // ── Introspection ────────────────────────────────────────────────────────────
+    get names() { return [...this._plugins.keys()]; }
+    getPlugin(name) { return this._plugins.get(name); }
+    get active() { return [...this._plugins.values()].filter((e) => e.active); }
+    get all() { return [...this._plugins.values()]; }
+    isActive(name) { return this._plugins.get(name)?.active === true; }
+}
+exports.PluginManager = PluginManager;
+//# sourceMappingURL=PluginManager.js.map

package/dist/plugins/PluginManager.js.map

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

package/dist/plugins/builtin/NumpyPlugin.d.ts

@@ -0,0 +1,17 @@
+/**
+ * nodepyx — NumpyPlugin (built-in)
+ * Routes ndarray wire objects through NumpyBridge.
+ */
+import type { nodepyxPlugin, PluginInitContext } from '../Plugin.interface';
+import type { SerializedValue, NumPyArrayResult } from '../../types/python';
+export declare class NumpyPlugin implements nodepyxPlugin {
+    readonly name = "numpy";
+    readonly version = "1.0.0";
+    readonly description = "Enhanced NumPy ndarray \u00E2\u2020\u2019 TypedArray mapping";
+    readonly supportedModules: readonly ["numpy", "np"];
+    readonly handledTypes: readonly ["ndarray", "matrix", "MaskedArray"];
+    onInit(ctx: PluginInitContext): void;
+    transformResult(raw: SerializedValue, typeHint: string): NumPyArrayResult | null;
+    private _handle;
+}
+//# sourceMappingURL=NumpyPlugin.d.ts.map

package/dist/plugins/builtin/NumpyPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumpyPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/builtin/NumpyPlugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAO5E,qBAAa,WAAY,YAAW,aAAa;IAC/C,QAAQ,CAAC,IAAI,WAAuB;IACpC,QAAQ,CAAC,OAAO,WAAoB;IACpC,QAAQ,CAAC,WAAW,kEAAwD;IAC5E,QAAQ,CAAC,gBAAgB,2BAA4B;IACrD,QAAQ,CAAC,YAAY,gDAAqD;IAE1E,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAKpC,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAKhF,OAAO,CAAC,OAAO;CAIhB"}

package/dist/plugins/builtin/NumpyPlugin.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * nodepyx — NumpyPlugin (built-in)
+ * Routes ndarray wire objects through NumpyBridge.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NumpyPlugin = void 0;
+const NumpyBridge_1 = require("../../serialization/NumpyBridge");
+const Logger_1 = require("../../utils/Logger");
+const logger = new Logger_1.Logger('NumpyPlugin');
+const bridge = new NumpyBridge_1.NumpyBridge();
+class NumpyPlugin {
+    name = 'numpy';
+    version = '1.0.0';
+    description = 'Enhanced NumPy ndarray → TypedArray mapping';
+    supportedModules = ['numpy', 'np'];
+    handledTypes = ['ndarray', 'matrix', 'MaskedArray'];
+    onInit(ctx) {
+        for (const t of this.handledTypes) {
+            ctx.registerTypeHandler(t, this._handle.bind(this));
+        }
+        logger.debug('NumpyPlugin initialised');
+    }
+    transformResult(raw, typeHint) {
+        if (this.handledTypes.includes(typeHint)) {
+            return this._handle(raw, typeHint, {});
+        }
+        return null;
+    }
+    _handle(raw, _type, _meta) {
+        try {
+            return bridge.deserialize(raw);
+        }
+        catch (err) {
+            logger.warn(`ndarray deserialization error: ${err}`);
+            return null;
+        }
+    }
+}
+exports.NumpyPlugin = NumpyPlugin;
+//# sourceMappingURL=NumpyPlugin.js.map

package/dist/plugins/builtin/NumpyPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NumpyPlugin.js","sourceRoot":"","sources":["../../../src/plugins/builtin/NumpyPlugin.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,iEAA8D;AAC9D,+CAA4C;AAE5C,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,aAAa,CAAC,CAAC;AACzC,MAAM,MAAM,GAAG,IAAI,yBAAW,EAAE,CAAC;AAEjC,MAAa,WAAW;IACb,IAAI,GAAe,OAAO,CAAC;IAC3B,OAAO,GAAY,OAAO,CAAC;IAC3B,WAAW,GAAQ,+CAA+C,CAAC;IACnE,gBAAgB,GAAG,CAAC,OAAO,EAAE,IAAI,CAAU,CAAC;IAC5C,YAAY,GAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAU,CAAC;IAE1E,MAAM,CAAC,GAAsB;QAC3B,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAAA,GAAG,CAAC,mBAAmB,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAAA,CAAC;QACzF,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC1C,CAAC;IAED,eAAe,CAAC,GAAoB,EAAE,QAAgB;QACpD,IAAK,IAAI,CAAC,YAAkC,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAA,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAAA,CAAC;QAC1G,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,OAAO,CAAC,GAAoB,EAAE,KAAc,EAAE,KAA+B;QACnF,IAAI,CAAC;YAAC,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QACvC,OAAO,GAAG,EAAE,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACpF,CAAC;CACF;AArBD,kCAqBC"}

package/dist/plugins/builtin/PandasPlugin.d.ts

@@ -0,0 +1,19 @@
+/**
+ * nodepyx — PandasPlugin (built-in)
+ * Intercepts DataFrame/Series wire objects and routes through DataFrameBridge.
+ */
+import type { nodepyxPlugin, PluginInitContext } from '../Plugin.interface';
+import type { SerializedValue, DataFrameResult, SeriesResult } from '../../types/python';
+export declare class PandasPlugin implements nodepyxPlugin {
+    readonly name = "pandas";
+    readonly version = "1.0.0";
+    readonly description = "Enhanced pandas DataFrame and Series support";
+    readonly supportedModules: readonly ["pandas", "pd"];
+    readonly handledTypes: readonly ["DataFrame", "Series", "DataFrameGroupBy", "SeriesGroupBy"];
+    onInit(ctx: PluginInitContext): void;
+    onModuleImported(moduleName: string): void;
+    transformResult(raw: SerializedValue, typeHint: string): DataFrameResult | SeriesResult | null;
+    private _handleDF;
+    private _handleSeries;
+}
+//# sourceMappingURL=PandasPlugin.d.ts.map

package/dist/plugins/builtin/PandasPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PandasPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/builtin/PandasPlugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOzF,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,IAAI,YAAwB;IACrC,QAAQ,CAAC,OAAO,WAAoB;IACpC,QAAQ,CAAC,WAAW,kDAAuD;IAC3E,QAAQ,CAAC,gBAAgB,4BAA6B;IACtD,QAAQ,CAAC,YAAY,wEAA6E;IAElG,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAQpC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI1C,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,YAAY,GAAG,IAAI;IAM9F,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,aAAa;CAItB"}

package/dist/plugins/builtin/PandasPlugin.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * nodepyx — PandasPlugin (built-in)
+ * Intercepts DataFrame/Series wire objects and routes through DataFrameBridge.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PandasPlugin = void 0;
+const DataFrameBridge_1 = require("../../serialization/DataFrameBridge");
+const Logger_1 = require("../../utils/Logger");
+const logger = new Logger_1.Logger('PandasPlugin');
+const bridge = new DataFrameBridge_1.DataFrameBridge();
+class PandasPlugin {
+    name = 'pandas';
+    version = '1.0.0';
+    description = 'Enhanced pandas DataFrame and Series support';
+    supportedModules = ['pandas', 'pd'];
+    handledTypes = ['DataFrame', 'Series', 'DataFrameGroupBy', 'SeriesGroupBy'];
+    onInit(ctx) {
+        ctx.registerTypeHandler('DataFrame', this._handleDF.bind(this));
+        ctx.registerTypeHandler('DataFrameGroupBy', this._handleDF.bind(this));
+        ctx.registerTypeHandler('Series', this._handleSeries.bind(this));
+        ctx.registerTypeHandler('SeriesGroupBy', this._handleSeries.bind(this));
+        logger.debug('PandasPlugin initialised');
+    }
+    onModuleImported(moduleName) {
+        logger.debug(`pandas module imported: ${moduleName}`);
+    }
+    transformResult(raw, typeHint) {
+        if (typeHint === 'DataFrame' || typeHint === 'DataFrameGroupBy') {
+            return this._handleDF(raw, typeHint, {});
+        }
+        if (typeHint === 'Series' || typeHint === 'SeriesGroupBy') {
+            return this._handleSeries(raw, typeHint, {});
+        }
+        return null;
+    }
+    _handleDF(raw, _typeHint, _meta) {
+        try {
+            return bridge.deserializeDataFrame(raw);
+        }
+        catch (err) {
+            logger.warn(`DataFrame deserialization error: ${err}`);
+            return null;
+        }
+    }
+    _handleSeries(raw, _typeHint, _meta) {
+        try {
+            return bridge.deserializeSeries(raw);
+        }
+        catch (err) {
+            logger.warn(`Series deserialization error: ${err}`);
+            return null;
+        }
+    }
+}
+exports.PandasPlugin = PandasPlugin;
+//# sourceMappingURL=PandasPlugin.js.map

package/dist/plugins/builtin/PandasPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PandasPlugin.js","sourceRoot":"","sources":["../../../src/plugins/builtin/PandasPlugin.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,yEAAsE;AACtE,+CAA4C;AAE5C,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,cAAc,CAAC,CAAC;AAC1C,MAAM,MAAM,GAAG,IAAI,iCAAe,EAAE,CAAC;AAErC,MAAa,YAAY;IACd,IAAI,GAAe,QAAQ,CAAC;IAC5B,OAAO,GAAY,OAAO,CAAC;IAC3B,WAAW,GAAQ,8CAA8C,CAAC;IAClE,gBAAgB,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAU,CAAC;IAC7C,YAAY,GAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,eAAe,CAAU,CAAC;IAElG,MAAM,CAAC,GAAsB;QAC3B,GAAG,CAAC,mBAAmB,CAAC,WAAW,EAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,GAAG,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACvE,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAY,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,GAAG,CAAC,mBAAmB,CAAC,eAAe,EAAK,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC3C,CAAC;IAED,gBAAgB,CAAC,UAAkB;QACjC,MAAM,CAAC,KAAK,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,eAAe,CAAC,GAAoB,EAAE,QAAgB;QACpD,IAAI,QAAQ,KAAK,WAAW,IAAI,QAAQ,KAAK,kBAAkB,EAAE,CAAC;YAAA,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAAA,CAAC;QAC5G,IAAI,QAAQ,KAAK,QAAQ,IAAM,QAAQ,KAAK,eAAe,EAAK,CAAC;YAAA,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAAA,CAAC;QAC/G,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,SAAS,CAAC,GAAoB,EAAE,SAAkB,EAAE,KAA+B;QACzF,IAAI,CAAC;YAAC,OAAO,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAChD,OAAO,GAAG,EAAE,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,oCAAoC,GAAG,EAAE,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACtF,CAAC;IAEO,aAAa,CAAC,GAAoB,EAAE,SAAkB,EAAE,KAA+B;QAC7F,IAAI,CAAC;YAAC,OAAO,MAAM,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;QAC7C,OAAO,GAAG,EAAE,CAAC;YAAC,MAAM,CAAC,IAAI,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC;IACnF,CAAC;CACF;AAlCD,oCAkCC"}

package/dist/plugins/builtin/TorchPlugin.d.ts

@@ -0,0 +1,23 @@
+/**
+ * nodepyx — TorchPlugin (built-in)
+ * Handles PyTorch Tensor objects — delegates to NumpyBridge (tensors are NumPy-compatible).
+ */
+import type { nodepyxPlugin, PluginInitContext } from '../Plugin.interface';
+import type { SerializedValue, NumPyArrayResult } from '../../types/python';
+export type TensorResult = NumPyArrayResult & {
+    requiresGrad: boolean;
+    isCuda: boolean;
+    device: string;
+    gradFn: string | null;
+};
+export declare class TorchPlugin implements nodepyxPlugin {
+    readonly name = "torch";
+    readonly version = "1.0.0";
+    readonly description = "Enhanced PyTorch Tensor support";
+    readonly supportedModules: readonly ["torch"];
+    readonly handledTypes: readonly ["Tensor"];
+    onInit(ctx: PluginInitContext): void;
+    transformResult(raw: SerializedValue, typeHint: string, meta: Record<string, unknown>): TensorResult | null;
+    private _handle;
+}
+//# sourceMappingURL=TorchPlugin.d.ts.map

package/dist/plugins/builtin/TorchPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TorchPlugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/builtin/TorchPlugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAO5E,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG;IAC5C,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAQ,OAAO,CAAC;IACtB,MAAM,EAAQ,MAAM,CAAC;IACrB,MAAM,EAAQ,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAA;AAED,qBAAa,WAAY,YAAW,aAAa;IAC/C,QAAQ,CAAC,IAAI,WAAuB;IACpC,QAAQ,CAAC,OAAO,WAAoB;IACpC,QAAQ,CAAC,WAAW,qCAA0C;IAC9D,QAAQ,CAAC,gBAAgB,qBAAsB;IAC/C,QAAQ,CAAC,YAAY,sBAA2B;IAEhD,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,IAAI;IAKpC,eAAe,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,GAAG,IAAI;IAI3G,OAAO,CAAC,OAAO;CAkBhB"}

package/dist/plugins/builtin/TorchPlugin.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * nodepyx — TorchPlugin (built-in)
+ * Handles PyTorch Tensor objects — delegates to NumpyBridge (tensors are NumPy-compatible).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TorchPlugin = void 0;
+const NumpyBridge_1 = require("../../serialization/NumpyBridge");
+const Logger_1 = require("../../utils/Logger");
+const logger = new Logger_1.Logger('TorchPlugin');
+const bridge = new NumpyBridge_1.NumpyBridge();
+class TorchPlugin {
+    name = 'torch';
+    version = '1.0.0';
+    description = 'Enhanced PyTorch Tensor support';
+    supportedModules = ['torch'];
+    handledTypes = ['Tensor'];
+    onInit(ctx) {
+        ctx.registerTypeHandler('Tensor', this._handle.bind(this));
+        logger.debug('TorchPlugin initialised');
+    }
+    transformResult(raw, typeHint, meta) {
+        return typeHint === 'Tensor' ? this._handle(raw, typeHint, meta) : null;
+    }
+    _handle(raw, _t, meta) {
+        try {
+            const base = bridge.deserialize(raw);
+            if (!base) {
+                return null;
+            }
+            const isCuda = Boolean(meta?.['isCuda']);
+            if (isCuda) {
+                logger.warn('CUDA Tensor: data was copied to CPU for transfer.');
+            }
+            return {
+                ...base,
+                requiresGrad: Boolean(meta?.['requiresGrad']),
+                isCuda,
+                device: String(meta?.['device'] ?? 'cpu'),
+                gradFn: meta?.['gradFn'] !== null && meta?.['gradFn'] !== undefined ? String(meta?.['gradFn']) : null,
+            };
+        }
+        catch (err) {
+            logger.warn(`Tensor deserialization error: ${err}`);
+            return null;
+        }
+    }
+}
+exports.TorchPlugin = TorchPlugin;
+//# sourceMappingURL=TorchPlugin.js.map

package/dist/plugins/builtin/TorchPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TorchPlugin.js","sourceRoot":"","sources":["../../../src/plugins/builtin/TorchPlugin.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,iEAA8D;AAC9D,+CAA4C;AAE5C,MAAM,MAAM,GAAG,IAAI,eAAM,CAAC,aAAa,CAAC,CAAC;AACzC,MAAM,MAAM,GAAG,IAAI,yBAAW,EAAE,CAAC;AASjC,MAAa,WAAW;IACb,IAAI,GAAe,OAAO,CAAC;IAC3B,OAAO,GAAY,OAAO,CAAC;IAC3B,WAAW,GAAQ,iCAAiC,CAAC;IACrD,gBAAgB,GAAG,CAAC,OAAO,CAAU,CAAC;IACtC,YAAY,GAAO,CAAC,QAAQ,CAAU,CAAC;IAEhD,MAAM,CAAC,GAAsB;QAC3B,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC1C,CAAC;IAED,eAAe,CAAC,GAAoB,EAAE,QAAgB,EAAE,IAA6B;QACnF,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1E,CAAC;IAEO,OAAO,CAAC,GAAoB,EAAE,EAAW,EAAE,IAA8B;QAC/E,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACrC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAAA,OAAO,IAAI,CAAC;YAAA,CAAC;YACzB,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;YACzC,IAAI,MAAM,EAAE,CAAC;gBAAA,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;YAAA,CAAC;YAC/E,OAAO;gBACL,GAAG,IAAI;gBACP,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,cAAc,CAAC,CAAC;gBAC7C,MAAM;gBACN,MAAM,EAAG,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC;gBAC1C,MAAM,EAAG,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;aACvF,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAlCD,kCAkCC"}

package/dist/plugins/index.d.ts

@@ -0,0 +1,7 @@
+export type { nodepyxPlugin, PluginRegistration, PluginInitContext, TypeTransformHandler, PythonTypeName } from './Plugin.interface';
+export { PluginManager } from './PluginManager';
+export { PandasPlugin } from './builtin/PandasPlugin';
+export { NumpyPlugin } from './builtin/NumpyPlugin';
+export { TorchPlugin } from './builtin/TorchPlugin';
+export type { TensorResult } from './builtin/TorchPlugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACrI,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAO,uBAAuB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAO,uBAAuB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/plugins/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TorchPlugin = exports.NumpyPlugin = exports.PandasPlugin = exports.PluginManager = void 0;
+var PluginManager_1 = require("./PluginManager");
+Object.defineProperty(exports, "PluginManager", { enumerable: true, get: function () { return PluginManager_1.PluginManager; } });
+var PandasPlugin_1 = require("./builtin/PandasPlugin");
+Object.defineProperty(exports, "PandasPlugin", { enumerable: true, get: function () { return PandasPlugin_1.PandasPlugin; } });
+var NumpyPlugin_1 = require("./builtin/NumpyPlugin");
+Object.defineProperty(exports, "NumpyPlugin", { enumerable: true, get: function () { return NumpyPlugin_1.NumpyPlugin; } });
+var TorchPlugin_1 = require("./builtin/TorchPlugin");
+Object.defineProperty(exports, "TorchPlugin", { enumerable: true, get: function () { return TorchPlugin_1.TorchPlugin; } });
+//# sourceMappingURL=index.js.map

package/dist/plugins/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":";;;AACA,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,uDAAsD;AAA7C,4GAAA,YAAY,OAAA;AACrB,qDAAqD;AAA5C,0GAAA,WAAW,OAAA;AACpB,qDAAqD;AAA5C,0GAAA,WAAW,OAAA"}

package/dist/serialization/DataFrameBridge.d.ts

@@ -0,0 +1,141 @@
+/**
+ * nodepyx — DataFrameBridge
+ * Converts Pandas DataFrames and Series to/from JavaScript objects.
+ *
+ * ─── Wire Protocol ──────────────────────────────────────────────────────────
+ *
+ * DataFrames use the "split" orientation of pandas JSON:
+ *   {
+ *     "columns": ["col1", "col2", ...],
+ *     "data":    [[row0_val0, row0_val1], [row1_val0, row1_val1], ...],
+ *     "index":   [0, 1, 2, ...],
+ *     "dtypes":  {"col1": "int64", "col2": "object", ...},
+ *     "shape":   [nrows, ncols]
+ *   }
+ *
+ * For large DataFrames (>64KB) the JSON is embedded in a MessagePack
+ * binary to reduce parse overhead.  The format field in SerializedValue
+ * tells the bridge which path to take:
+ *   format === 'pandas_dataframe'  → DataFrame decode
+ *   format === 'pandas_series'     → Series decode
+ *
+ * Series wire format:
+ *   {
+ *     "name":   "my_series",
+ *     "data":   [1, 2, 3, 4],
+ *     "index":  [0, 1, 2, 3],
+ *     "dtype":  "int64",
+ *     "length": 4
+ *   }
+ *
+ * ─── JavaScript representation ───────────────────────────────────────────────
+ *
+ * DataFrameResult (records orientation is built client-side):
+ *   {
+ *     columns: string[],
+ *     data:    Record<string, unknown>[],   ← row objects
+ *     index:   unknown[],
+ *     dtypes:  Record<string, string>,
+ *     shape:   [number, number]
+ *   }
+ *
+ * SeriesResult:
+ *   {
+ *     name:   string,
+ *     data:   unknown[],
+ *     index:  unknown[],
+ *     dtype:  string,
+ *     length: number
+ *   }
+ */
+import type { SerializedValue, DataFrameResult, SeriesResult } from '../types/python';
+interface DataFrameSerializeOptions {
+    /**
+     * Row limit when serializing JS → Python.
+     * Excess rows are truncated.  Default: unlimited.
+     */
+    maxRows?: number;
+    /**
+     * Use MessagePack instead of JSON for the wire format.
+     * Default: true when data size > 64 KB.
+     */
+    forceMsgPack?: boolean;
+}
+/**
+ * DataFrameBridge — bidirectional conversion for Pandas DataFrames and Series.
+ *
+ * @example
+ * ```typescript
+ * const bridge = new DataFrameBridge();
+ *
+ * // Deserialize a DataFrame received from Python
+ * const df: DataFrameResult = bridge.deserializeDataFrame(sv);
+ * console.log(df.columns);   // ['city', 'population']
+ * console.log(df.data[0]);   // { city: 'Algiers', population: 3500000 }
+ *
+ * // Serialize a records-array back to Python
+ * const sv2 = bridge.serializeDataFrame(df.data, df.columns);
+ * ```
+ */
+export declare class DataFrameBridge {
+    /**
+     * Deserialize a PANDAS_DATAFRAME SerializedValue → DataFrameResult.
+     */
+    deserializeDataFrame(sv: SerializedValue): DataFrameResult;
+    /**
+     * Deserialize a PANDAS_SERIES SerializedValue → SeriesResult.
+     */
+    deserializeSeries(sv: SerializedValue): SeriesResult;
+    /**
+     * Serialize a records-array (array of row objects) into a PANDAS_DATAFRAME
+     * SerializedValue that Python can reconstruct with pd.DataFrame(wire).
+     *
+     * @param records - array of row objects (e.g. [{col1: val1, col2: val2}, ...])
+     * @param columns - explicit column order; inferred from first record if omitted
+     */
+    serializeDataFrame(records: Record<string, unknown>[], columns?: string[], options?: DataFrameSerializeOptions): SerializedValue;
+    /**
+     * Serialize a plain array of values into a PANDAS_SERIES SerializedValue.
+     *
+     * @param data  - the series values
+     * @param name  - series name
+     * @param index - optional explicit index
+     */
+    serializeSeries(data: unknown[], name?: string, index?: unknown[]): SerializedValue;
+    /**
+     * Convert a DataFrameResult to a 2-D array (column-major).
+     * Useful for charting libraries.
+     */
+    static toColumnArrays(df: DataFrameResult): Record<string, unknown[]>;
+    /**
+     * Convert a DataFrameResult to a 2-D raw array (no column keys).
+     * Row-major: result[row][colIndex].
+     */
+    static toMatrix(df: DataFrameResult): unknown[][];
+    /**
+     * Filter rows of a DataFrameResult.
+     */
+    static filterRows(df: DataFrameResult, predicate: (row: Record<string, unknown>, index: unknown) => boolean): DataFrameResult;
+    /**
+     * Select specific columns from a DataFrameResult.
+     */
+    static selectColumns(df: DataFrameResult, cols: string[]): DataFrameResult;
+    /**
+     * Compute basic descriptive stats for a numeric column in a DataFrameResult.
+     */
+    static describeColumn(df: DataFrameResult, col: string): {
+        count: number;
+        mean: number;
+        std: number;
+        min: number;
+        max: number;
+        sum: number;
+    };
+    private _decodeWire;
+    private _encodeWire;
+    private _buildDataFrameResult;
+    private _buildSeriesResult;
+    private _inferDtype;
+}
+export {};
+//# sourceMappingURL=DataFrameBridge.d.ts.map

package/dist/serialization/DataFrameBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataFrameBridge.d.ts","sourceRoot":"","sources":["../../src/serialization/DataFrameBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAGH,OAAO,KAAK,EACV,eAAe,EAEf,eAAe,EACf,YAAY,EACb,MAAM,iBAAiB,CAAC;AAyBzB,UAAU,yBAAyB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;IAI1B;;OAEG;IACH,oBAAoB,CAAC,EAAE,EAAE,eAAe,GAAG,eAAe;IAU1D;;OAEG;IACH,iBAAiB,CAAC,EAAE,EAAE,eAAe,GAAG,YAAY;IAYpD;;;;;;OAMG;IACH,kBAAkB,CAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAClC,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,OAAO,GAAE,yBAA8B,GACtC,eAAe;IAiBlB;;;;;;OAMG;IACH,eAAe,CACb,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,GAAE,MAAW,EACjB,KAAK,CAAC,EAAE,OAAO,EAAE,GAChB,eAAe;IAclB;;;OAGG;IACH,MAAM,CAAC,cAAc,CACnB,EAAE,EAAE,eAAe,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAQ5B;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,eAAe,GAAG,OAAO,EAAE,EAAE;IAIjD;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,EAAE,EAAE,eAAe,EACnB,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,GACnE,eAAe;IAsBlB;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe;IAa1E;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,MAAM,GAAG;QACvD,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;KACb;IAoBD,OAAO,CAAC,WAAW;IAwBnB,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,qBAAqB;IA2B7B,OAAO,CAAC,kBAAkB;IAa1B,OAAO,CAAC,WAAW;CAYpB"}