@scelar/nodepod 1.0.2 → 1.0.3

package/dist/index.cjs

@@ -2,7 +2,7 @@
 
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: 'Module' } });
 
-const index = require('./index-cnitc68U.cjs');
+const index = require('./index-BO1i013L.cjs');
 
 
 

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { p, I, q, s, t, v, w, P, x, y, z, A, S, C, F, G, H, J, K, O, Q, U, X, Z, _, $, $ as $2, a0, a1, a2, a3, a4, l, a5, a6, a7, a8, a9, aa, ab, ac, ad, ae, af, ag, ah, ai, aj, ak, al, am, an, ao, ap, aq, ar } from "./index--Qr8LVpQ.js";
+import { p, I, q, s, t, v, w, P, x, y, z, A, S, C, F, G, H, J, K, O, Q, U, X, Z, _, $, $ as $2, a0, a1, a2, a3, a4, l, a5, a6, a7, a8, a9, aa, ab, ac, ad, ae, af, ag, ah, ai, aj, ak, al, am, an, ao, ap, aq, ar } from "./index-Ale2oba_.js";
 export {
   p as DependencyInstaller,
   I as IframeSandbox,

package/dist/script-engine.d.ts

@@ -9,6 +9,7 @@ export interface ModuleRecord {
     loaded: boolean;
     children: ModuleRecord[];
     paths: string[];
+    parent: ModuleRecord | null;
 }
 export interface EngineOptions {
     cwd?: string;
@@ -31,6 +32,7 @@ export interface ResolverFn {
     cache: Record<string, ModuleRecord>;
     extensions: Record<string, unknown>;
     main: ModuleRecord | null;
+    _ownerRecord?: ModuleRecord;
 }
 export declare class ScriptEngine {
     private vol;

package/dist/syntax-transforms.d.ts

@@ -1,3 +1,4 @@
 export declare function esmToCjs(code: string): string;
+export declare function collectEsmCjsPatches(ast: any, code: string, patches: Array<[number, number, string]>): void;
 export declare function hasTopLevelAwait(code: string): boolean;
 export declare function stripTopLevelAwait(code: string, mode?: "topLevelOnly" | "full"): string;

package/package.json

@@ -1,95 +1,97 @@
-{
-  "name": "@scelar/nodepod",
-  "version": "1.0.2",
-  "description": "Browser-native Node.js runtime environment",
-  "type": "module",
-  "license": "MIT WITH Commons-Clause",
-  "author": "R1ck404 (https://github.com/R1ck404)",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ScelarOrg/Nodepod.git"
-  },
-  "bugs": {
-    "url": "https://github.com/ScelarOrg/Nodepod/issues"
-  },
-  "homepage": "https://github.com/ScelarOrg/Nodepod#readme",
-  "keywords": [
-    "node",
-    "browser",
-    "runtime",
-    "sandbox",
-    "typescript",
-    "virtual-filesystem",
-    "polyfill",
-    "webcontainer",
-    "in-browser",
-    "nodejs"
-  ],
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.mjs",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.mjs"
-      },
-      "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.cjs"
-      }
-    }
-  },
-  "files": [
-    "src",
-    "dist"
-  ],
-  "sideEffects": false,
-  "scripts": {
-    "build:lib": "vite build --config vite.lib.config.js && cp static/__sw__.js dist/__sw__.js",
-    "build:types": "tsc --project tsconfig.build.json",
-    "build:publish": "npm run build:lib && npm run build:types",
-    "type-check": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
-  "dependencies": {
-    "acorn": "^8.15.0",
-    "acorn-jsx": "^5.3.2",
-    "brotli": "^1.3.3",
-    "brotli-wasm": "^3.0.1",
-    "comlink": "^4.4.2",
-    "pako": "^2.1.0",
-    "resolve.exports": "^2.0.3",
-    "zod": "^4.3.6"
-  },
-  "peerDependencies": {
-    "@xterm/xterm": "^6.0.0",
-    "@xterm/addon-fit": "^0.11.0",
-    "@xterm/addon-webgl": "^0.19.0"
-  },
-  "peerDependenciesMeta": {
-    "@xterm/xterm": {
-      "optional": true
-    },
-    "@xterm/addon-fit": {
-      "optional": true
-    },
-    "@xterm/addon-webgl": {
-      "optional": true
-    }
-  },
-  "devDependencies": {
-    "@types/node": "^25.0.10",
-    "@types/pako": "^2.0.4",
-    "esbuild": "^0.27.2",
-    "typescript": "^5.9.3",
-    "vite": "^5.4.0",
-    "vite-plugin-top-level-await": "^1.6.0",
-    "vite-plugin-wasm": "^3.5.0",
-    "vitest": "^4.0.18"
-  }
-}
+{
+  "name": "@scelar/nodepod",
+  "version": "1.0.3",
+  "description": "Browser-native Node.js runtime environment",
+  "type": "module",
+  "license": "MIT WITH Commons-Clause",
+  "author": "R1ck404 (https://github.com/R1ck404)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ScelarOrg/Nodepod.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ScelarOrg/Nodepod/issues"
+  },
+  "homepage": "https://github.com/ScelarOrg/Nodepod#readme",
+  "keywords": [
+    "node",
+    "browser",
+    "runtime",
+    "sandbox",
+    "typescript",
+    "virtual-filesystem",
+    "polyfill",
+    "webcontainer",
+    "in-browser",
+    "nodejs"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build:lib": "vite build --config vite.lib.config.js && node -e \"require('fs').copyFileSync('static/__sw__.js','dist/__sw__.js')\"",
+    "build:types": "tsc --project tsconfig.build.json",
+    "build:publish": "npm run build:lib && npm run build:types",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "bench": "vitest bench",
+    "bench:run": "vitest bench --run"
+  },
+  "dependencies": {
+    "acorn": "^8.15.0",
+    "acorn-jsx": "^5.3.2",
+    "brotli": "^1.3.3",
+    "brotli-wasm": "^3.0.1",
+    "comlink": "^4.4.2",
+    "pako": "^2.1.0",
+    "resolve.exports": "^2.0.3",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "@xterm/xterm": "^6.0.0",
+    "@xterm/addon-fit": "^0.11.0",
+    "@xterm/addon-webgl": "^0.19.0"
+  },
+  "peerDependenciesMeta": {
+    "@xterm/xterm": {
+      "optional": true
+    },
+    "@xterm/addon-fit": {
+      "optional": true
+    },
+    "@xterm/addon-webgl": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.10",
+    "@types/pako": "^2.0.4",
+    "esbuild": "^0.27.2",
+    "typescript": "^5.9.3",
+    "vite": "^5.4.0",
+    "vite-plugin-top-level-await": "^1.6.0",
+    "vite-plugin-wasm": "^3.5.0",
+    "vitest": "^4.0.18"
+  }
+}

package/src/__tests__/bench/integration.bench.ts

@@ -0,0 +1,117 @@
+import { describe, bench } from "vitest";
+import { MemoryVolume } from "../../memory-volume";
+import { ScriptEngine } from "../../script-engine";
+
+describe("Integration - end to end", () => {
+  bench("volume + engine + write + execute", () => {
+    const vol = new MemoryVolume();
+    vol.mkdirSync("/app", { recursive: true });
+    vol.writeFileSync(
+      "/app/index.js",
+      `
+      const path = require('path');
+      const result = path.join('/home', 'user', 'project');
+      module.exports = result;
+    `,
+    );
+    const engine = new ScriptEngine(vol, { cwd: "/app" });
+    engine.runFile("/app/index.js");
+  });
+
+  bench("5-module project with require chain", () => {
+    const vol = new MemoryVolume();
+    vol.mkdirSync("/app/src", { recursive: true });
+
+    vol.writeFileSync(
+      "/app/src/config.js",
+      "module.exports = { port: 3000, host: 'localhost' };",
+    );
+    vol.writeFileSync(
+      "/app/src/utils.js",
+      `
+      const path = require('path');
+      module.exports = {
+        resolve: (...args) => path.resolve(...args),
+        join: (...args) => path.join(...args),
+      };
+    `,
+    );
+    vol.writeFileSync(
+      "/app/src/logger.js",
+      `
+      const util = require('util');
+      module.exports = {
+        info: (...args) => util.format(...args),
+        error: (...args) => util.format('ERROR:', ...args),
+      };
+    `,
+    );
+    vol.writeFileSync(
+      "/app/src/router.js",
+      `
+      const { EventEmitter } = require('events');
+      class Router extends EventEmitter {
+        constructor() { super(); this.routes = []; }
+        add(method, path, handler) { this.routes.push({ method, path, handler }); }
+      }
+      module.exports = Router;
+    `,
+    );
+    vol.writeFileSync(
+      "/app/src/index.js",
+      `
+      const config = require('./config');
+      const utils = require('./utils');
+      const logger = require('./logger');
+      const Router = require('./router');
+
+      const router = new Router();
+      router.add('GET', '/', () => 'hello');
+      module.exports = { config, utils, logger, router };
+    `,
+    );
+
+    const engine = new ScriptEngine(vol, { cwd: "/app" });
+    engine.runFile("/app/src/index.js");
+  });
+
+  bench("ESM project with import/export conversion", () => {
+    const vol = new MemoryVolume();
+    vol.mkdirSync("/esm", { recursive: true });
+
+    vol.writeFileSync(
+      "/esm/math.js",
+      `
+      export function add(a, b) { return a + b; }
+      export function multiply(a, b) { return a * b; }
+      export default { add, multiply };
+    `,
+    );
+    vol.writeFileSync(
+      "/esm/index.js",
+      `
+      import math, { add, multiply } from './math.js';
+      const result = add(multiply(3, 4), 5);
+      export default result;
+    `,
+    );
+
+    const engine = new ScriptEngine(vol, { cwd: "/esm" });
+    engine.runFile("/esm/index.js");
+  });
+
+  bench("snapshot round-trip: 100 files + save + restore + verify", () => {
+    const vol = new MemoryVolume();
+    vol.mkdirSync("/proj/src", { recursive: true });
+    for (let i = 0; i < 100; i++) {
+      vol.writeFileSync(
+        `/proj/src/mod${i}.js`,
+        `module.exports = { id: ${i} };`,
+      );
+    }
+
+    const snapshot = vol.toSnapshot();
+    const restored = MemoryVolume.fromSnapshot(snapshot);
+    restored.readFileSync("/proj/src/mod50.js", "utf8");
+  });
+});

package/src/__tests__/bench/memory-volume.bench.ts

@@ -0,0 +1,115 @@
+import { describe, bench, beforeEach } from "vitest";
+import { MemoryVolume } from "../../memory-volume";
+
+function populatedVolume(fileCount: number, fileSize: number): MemoryVolume {
+  const vol = new MemoryVolume();
+  vol.mkdirSync("/project", { recursive: true });
+  const content = "x".repeat(fileSize);
+  for (let i = 0; i < fileCount; i++) {
+    vol.writeFileSync(`/project/file-${i}.txt`, content);
+  }
+  return vol;
+}
+
+describe("MemoryVolume - write", () => {
+  let vol: MemoryVolume;
+  beforeEach(() => { vol = new MemoryVolume(); });
+
+  bench("writeFileSync - 100 bytes", () => {
+    vol.writeFileSync("/test.txt", "a".repeat(100));
+  });
+
+  bench("writeFileSync - 10KB", () => {
+    vol.writeFileSync("/test.txt", "a".repeat(10_000));
+  });
+
+  bench("writeFileSync - 1MB", () => {
+    vol.writeFileSync("/test.txt", "a".repeat(1_000_000));
+  });
+
+  bench("writeFileSync - binary Uint8Array 10KB", () => {
+    vol.writeFileSync("/test.bin", new Uint8Array(10_000));
+  });
+
+  bench("writeFileSync - deep path (6 levels)", () => {
+    vol.writeFileSync("/a/b/c/d/e/f/file.txt", "data");
+  });
+});
+
+describe("MemoryVolume - read", () => {
+  let vol: MemoryVolume;
+  beforeEach(() => { vol = populatedVolume(100, 1000); });
+
+  bench("readFileSync - utf8", () => {
+    vol.readFileSync("/project/file-50.txt", "utf8");
+  });
+
+  bench("readFileSync - binary", () => {
+    vol.readFileSync("/project/file-50.txt");
+  });
+
+  bench("existsSync - hit", () => {
+    vol.existsSync("/project/file-50.txt");
+  });
+
+  bench("existsSync - miss", () => {
+    vol.existsSync("/project/nonexistent.txt");
+  });
+
+  bench("statSync", () => {
+    vol.statSync("/project/file-50.txt");
+  });
+});
+
+describe("MemoryVolume - directories", () => {
+  let vol: MemoryVolume;
+  beforeEach(() => { vol = populatedVolume(200, 100); });
+
+  bench("readdirSync - 200 entries", () => {
+    vol.readdirSync("/project");
+  });
+
+  bench("mkdirSync recursive - 5 levels", () => {
+    vol.mkdirSync("/new/a/b/c/d", { recursive: true });
+  });
+});
+
+describe("MemoryVolume - snapshot", () => {
+  bench("toSnapshot - 100 files", () => {
+    const vol = populatedVolume(100, 500);
+    vol.toSnapshot();
+  });
+
+  bench("fromSnapshot - 100 files", () => {
+    const vol = populatedVolume(100, 500);
+    const snap = vol.toSnapshot();
+    MemoryVolume.fromSnapshot(snap);
+  });
+
+  bench("toSnapshot - 500 files", () => {
+    const vol = populatedVolume(500, 200);
+    vol.toSnapshot();
+  });
+
+  bench("fromSnapshot - 500 files", () => {
+    const vol = populatedVolume(500, 200);
+    const snap = vol.toSnapshot();
+    MemoryVolume.fromSnapshot(snap);
+  });
+});
+
+describe("MemoryVolume - mixed workload", () => {
+  bench("create 50 files + read all + delete all", () => {
+    const vol = new MemoryVolume();
+    vol.mkdirSync("/work", { recursive: true });
+    for (let i = 0; i < 50; i++) {
+      vol.writeFileSync(`/work/f${i}.js`, `const x = ${i};`);
+    }
+    for (let i = 0; i < 50; i++) {
+      vol.readFileSync(`/work/f${i}.js`, "utf8");
+    }
+    for (let i = 0; i < 50; i++) {
+      vol.unlinkSync(`/work/f${i}.js`);
+    }
+  });
+});

package/src/__tests__/bench/polyfills.bench.ts

@@ -0,0 +1,147 @@
+import { describe, bench } from "vitest";
+import { EventEmitter } from "../../polyfills/events";
+import { Buffer } from "../../polyfills/buffer";
+import * as pathPolyfill from "../../polyfills/path";
+import {
+  bytesToBase64,
+  base64ToBytes,
+  bytesToHex,
+} from "../../helpers/byte-encoding";
+import { quickDigest } from "../../helpers/digest";
+
+describe("EventEmitter", () => {
+  bench("on + emit (1 listener, 100 emits)", () => {
+    const ee = new EventEmitter();
+    ee.on("data", () => {});
+    for (let i = 0; i < 100; i++) ee.emit("data", i);
+  });
+
+  bench("on + emit (10 listeners, 100 emits)", () => {
+    const ee = new EventEmitter();
+    for (let i = 0; i < 10; i++) ee.on("data", () => {});
+    for (let i = 0; i < 100; i++) ee.emit("data", i);
+  });
+
+  bench("once + emit (100 cycles)", () => {
+    const ee = new EventEmitter();
+    for (let i = 0; i < 100; i++) {
+      ee.once("event", () => {});
+      ee.emit("event");
+    }
+  });
+
+  bench("removeListener (10 listeners)", () => {
+    const ee = new EventEmitter();
+    const handlers = Array.from({ length: 10 }, () => () => {});
+    handlers.forEach((h) => ee.on("data", h));
+    handlers.forEach((h) => ee.removeListener("data", h));
+  });
+});
+
+describe("Buffer", () => {
+  bench("Buffer.from(string, 'utf8') - 1KB", () => {
+    Buffer.from("x".repeat(1024));
+  });
+
+  bench("Buffer.from(string, 'base64') - 1KB", () => {
+    const b64 = bytesToBase64(new Uint8Array(768));
+    Buffer.from(b64, "base64");
+  });
+
+  bench("Buffer.from(string, 'hex') - 1KB", () => {
+    const hex = bytesToHex(new Uint8Array(512));
+    Buffer.from(hex, "hex");
+  });
+
+  bench("Buffer.alloc(4096)", () => {
+    Buffer.alloc(4096);
+  });
+
+  bench("Buffer.concat (10 x 1KB)", () => {
+    const chunks = Array.from({ length: 10 }, () => Buffer.alloc(1024));
+    Buffer.concat(chunks);
+  });
+
+  bench("Buffer.toString('utf8') - 4KB", () => {
+    const buf = Buffer.alloc(4096, 0x61);
+    buf.toString("utf8");
+  });
+
+  bench("Buffer.toString('base64') - 4KB", () => {
+    const buf = Buffer.alloc(4096, 0x61);
+    buf.toString("base64");
+  });
+});
+
+describe("path polyfill", () => {
+  bench("join (3 segments)", () => {
+    pathPolyfill.join("/usr", "local", "bin");
+  });
+
+  bench("resolve (relative)", () => {
+    pathPolyfill.resolve("src", "index.ts");
+  });
+
+  bench("resolve (absolute)", () => {
+    pathPolyfill.resolve("/home/user", "project", "src");
+  });
+
+  bench("dirname", () => {
+    pathPolyfill.dirname("/home/user/project/src/index.ts");
+  });
+
+  bench("basename", () => {
+    pathPolyfill.basename("/home/user/project/src/index.ts");
+  });
+
+  bench("extname", () => {
+    pathPolyfill.extname("/home/user/project/src/index.ts");
+  });
+
+  bench("normalize (complex)", () => {
+    pathPolyfill.normalize("/home/user/../user/./project//src/./index.ts");
+  });
+
+  bench("parse", () => {
+    pathPolyfill.parse("/home/user/project/src/index.ts");
+  });
+});
+
+describe("Byte encoding", () => {
+  const small = new Uint8Array(256);
+  const medium = new Uint8Array(10_000);
+  const large = new Uint8Array(100_000);
+
+  bench("bytesToBase64 - 256B", () => {
+    bytesToBase64(small);
+  });
+  bench("bytesToBase64 - 10KB", () => {
+    bytesToBase64(medium);
+  });
+  bench("bytesToBase64 - 100KB", () => {
+    bytesToBase64(large);
+  });
+
+  bench("base64ToBytes - 10KB", () => {
+    const encoded = bytesToBase64(medium);
+    base64ToBytes(encoded);
+  });
+
+  bench("bytesToHex - 10KB", () => {
+    bytesToHex(medium);
+  });
+});
+
+describe("quickDigest", () => {
+  bench("short string (50 chars)", () => {
+    quickDigest("a".repeat(50));
+  });
+
+  bench("medium string (5KB)", () => {
+    quickDigest("a".repeat(5_000));
+  });
+
+  bench("long string (50KB)", () => {
+    quickDigest("a".repeat(50_000));
+  });
+});