almostnode 0.1.0

package/dist/virtual-fs.d.ts

@@ -0,0 +1,226 @@
+/**
+ * Virtual File System - In-memory file tree with POSIX-like operations
+ */
+import type { VFSSnapshot } from './runtime-interface';
+export interface FSNode {
+    type: 'file' | 'directory';
+    content?: Uint8Array;
+    children?: Map<string, FSNode>;
+}
+type VFSChangeListener = (path: string, content: string) => void;
+type VFSDeleteListener = (path: string) => void;
+export interface Stats {
+    isFile(): boolean;
+    isDirectory(): boolean;
+    isSymbolicLink(): boolean;
+    isBlockDevice(): boolean;
+    isCharacterDevice(): boolean;
+    isFIFO(): boolean;
+    isSocket(): boolean;
+    size: number;
+    mode: number;
+    mtime: Date;
+    atime: Date;
+    ctime: Date;
+    birthtime: Date;
+    mtimeMs: number;
+    atimeMs: number;
+    ctimeMs: number;
+    birthtimeMs: number;
+    nlink: number;
+    uid: number;
+    gid: number;
+    dev: number;
+    ino: number;
+    rdev: number;
+    blksize: number;
+    blocks: number;
+}
+export type WatchEventType = 'change' | 'rename';
+export type WatchListener = (eventType: WatchEventType, filename: string | null) => void;
+export interface FSWatcher {
+    close(): void;
+    ref(): this;
+    unref(): this;
+}
+/**
+ * Create a Node.js-style error with code property
+ */
+export interface NodeError extends Error {
+    code: string;
+    errno: number;
+    syscall: string;
+    path?: string;
+}
+export declare function createNodeError(code: 'ENOENT' | 'ENOTDIR' | 'EISDIR' | 'EEXIST' | 'ENOTEMPTY', syscall: string, path: string, message?: string): NodeError;
+export declare class VirtualFS {
+    private root;
+    private encoder;
+    private decoder;
+    private watchers;
+    private eventListeners;
+    constructor();
+    /**
+     * Add event listener (for change notifications to workers)
+     */
+    on(event: 'change', listener: VFSChangeListener): this;
+    on(event: 'delete', listener: VFSDeleteListener): this;
+    /**
+     * Remove event listener
+     */
+    off(event: 'change', listener: VFSChangeListener): this;
+    off(event: 'delete', listener: VFSDeleteListener): this;
+    /**
+     * Emit event to listeners
+     */
+    private emit;
+    /**
+     * Serialize the entire file tree to a snapshot (for worker transfer)
+     */
+    toSnapshot(): VFSSnapshot;
+    private serializeNode;
+    /**
+     * Create a VirtualFS from a snapshot
+     */
+    static fromSnapshot(snapshot: VFSSnapshot): VirtualFS;
+    /**
+     * Internal write that optionally emits events
+     */
+    private writeFileSyncInternal;
+    /**
+     * Normalize path - resolve . and .. segments, ensure leading /
+     */
+    private normalizePath;
+    /**
+     * Get path segments from normalized path
+     */
+    private getPathSegments;
+    /**
+     * Get parent directory path
+     */
+    private getParentPath;
+    /**
+     * Get basename from path
+     */
+    private getBasename;
+    /**
+     * Get node at path, returns undefined if not found
+     */
+    private getNode;
+    /**
+     * Get or create directory at path (for mkdir -p behavior)
+     */
+    private ensureDirectory;
+    /**
+     * Check if path exists
+     */
+    existsSync(path: string): boolean;
+    /**
+     * Get stats for path
+     */
+    statSync(path: string): Stats;
+    /**
+     * lstatSync - same as statSync for our virtual FS (no symlinks)
+     */
+    lstatSync(path: string): Stats;
+    /**
+     * Read file contents as Uint8Array
+     */
+    readFileSync(path: string): Uint8Array;
+    readFileSync(path: string, encoding: 'utf8' | 'utf-8'): string;
+    /**
+     * Write data to file, creating parent directories as needed
+     */
+    writeFileSync(path: string, data: string | Uint8Array): void;
+    /**
+     * Create directory, optionally with recursive parent creation
+     */
+    mkdirSync(path: string, options?: {
+        recursive?: boolean;
+    }): void;
+    /**
+     * Read directory contents
+     */
+    readdirSync(path: string): string[];
+    /**
+     * Remove file
+     */
+    unlinkSync(path: string): void;
+    /**
+     * Remove directory (must be empty)
+     */
+    rmdirSync(path: string): void;
+    /**
+     * Rename/move file or directory
+     */
+    renameSync(oldPath: string, newPath: string): void;
+    /**
+     * Read file with optional options parameter
+     */
+    readFile(path: string, optionsOrCallback?: {
+        encoding?: string;
+    } | ((err: Error | null, data?: Uint8Array | string) => void), callback?: (err: Error | null, data?: Uint8Array | string) => void): void;
+    /**
+     * Async stat
+     */
+    stat(path: string, callback: (err: Error | null, stats?: Stats) => void): void;
+    /**
+     * Async lstat
+     */
+    lstat(path: string, callback: (err: Error | null, stats?: Stats) => void): void;
+    /**
+     * Async readdir
+     */
+    readdir(path: string, optionsOrCallback?: {
+        withFileTypes?: boolean;
+    } | ((err: Error | null, files?: string[]) => void), callback?: (err: Error | null, files?: string[]) => void): void;
+    /**
+     * Async realpath
+     */
+    realpath(path: string, callback: (err: Error | null, resolvedPath?: string) => void): void;
+    /**
+     * Sync realpath - in our VFS, just normalize the path
+     */
+    realpathSync(path: string): string;
+    /**
+     * Watch for file changes
+     */
+    watch(filename: string, optionsOrListener?: {
+        persistent?: boolean;
+        recursive?: boolean;
+        encoding?: string;
+    } | WatchListener, listener?: WatchListener): FSWatcher;
+    /**
+     * Notify watchers of file changes
+     */
+    private notifyWatchers;
+    /**
+     * Access check - in our VFS, always succeeds if file exists
+     */
+    accessSync(path: string, mode?: number): void;
+    /**
+     * Async access
+     */
+    access(path: string, modeOrCallback?: number | ((err: Error | null) => void), callback?: (err: Error | null) => void): void;
+    /**
+     * Copy file
+     */
+    copyFileSync(src: string, dest: string): void;
+    /**
+     * Create read stream - simplified implementation
+     */
+    createReadStream(path: string): {
+        on: (event: string, cb: (...args: unknown[]) => void) => void;
+        pipe: (dest: unknown) => unknown;
+    };
+    /**
+     * Create write stream - simplified implementation
+     */
+    createWriteStream(path: string): {
+        write: (data: string | Uint8Array) => boolean;
+        end: (data?: string | Uint8Array) => void;
+        on: (event: string, cb: (...args: unknown[]) => void) => void;
+    };
+}
+export {};
+//# sourceMappingURL=virtual-fs.d.ts.map

package/dist/virtual-fs.d.ts.map

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

package/dist/vite-demo.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Vite Demo - Running Vite in the browser using our Node.js shims
+ */
+import { VirtualFS } from './virtual-fs';
+import { Runtime } from './runtime';
+import { PackageManager } from './npm';
+import { ViteDevServer } from './frameworks/vite-dev-server';
+export declare function createViteProject(vfs: VirtualFS): void;
+export declare function initViteDemo(outputElement: HTMLElement, iframeElement: HTMLIFrameElement | null): Promise<{
+    vfs: VirtualFS;
+    runtime: Runtime;
+    npm: PackageManager;
+}>;
+/**
+ * Install Vite into the virtual file system
+ */
+export declare function installVite(npm: PackageManager, log: (message: string) => void): Promise<void>;
+/**
+ * Try to run Vite's createServer
+ */
+export declare function runVite(runtime: Runtime, log: (message: string) => void): Promise<unknown>;
+/**
+ * Start the dev server using Service Worker approach
+ * This is the recommended way to run the preview - no npm install required!
+ */
+export declare function startDevServer(vfs: VirtualFS, options?: {
+    port?: number;
+    log?: (message: string) => void;
+}): Promise<{
+    server: ViteDevServer;
+    url: string;
+    stop: () => void;
+}>;
+export { VirtualFS, Runtime, PackageManager, ViteDevServer };
+//# sourceMappingURL=vite-demo.d.ts.map

package/dist/vite-demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-demo.d.ts","sourceRoot":"","sources":["../src/vite-demo.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAK7D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAwTtD;AAGD,wBAAsB,YAAY,CAChC,aAAa,EAAE,WAAW,EAC1B,aAAa,EAAE,iBAAiB,GAAG,IAAI,GACtC,OAAO,CAAC;IAAE,GAAG,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,cAAc,CAAA;CAAE,CAAC,CAyCpE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC7B,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAC7B,OAAO,CAAC,OAAO,CAAC,CAuDlB;AAyBD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,SAAS,EACd,OAAO,GAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B,GACL,OAAO,CAAC;IACT,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB,CAAC,CAqDD;AA0BD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}

package/dist/vite-sw.js

@@ -0,0 +1,132 @@
+/**
+ * Service Worker for Vite dev server in browser
+ * Intercepts requests to the virtual Vite server and forwards them to the main thread
+ */
+
+const VITE_ORIGIN = self.location.origin;
+const CACHE_NAME = 'vite-sw-v1';
+
+// Map of pending requests
+const pendingRequests = new Map();
+let requestId = 0;
+
+// BroadcastChannel for communication with main thread
+const channel = new BroadcastChannel('vite-server');
+
+// Listen for messages from main thread
+channel.addEventListener('message', (event) => {
+  const { type, requestId: reqId, response, error } = event.data;
+
+  if (type === 'response' && pendingRequests.has(reqId)) {
+    const { resolve, reject } = pendingRequests.get(reqId);
+    pendingRequests.delete(reqId);
+
+    if (error) {
+      reject(new Error(error));
+    } else {
+      resolve(
+        new Response(response.body, {
+          status: response.status || 200,
+          statusText: response.statusText || 'OK',
+          headers: new Headers(response.headers || {}),
+        })
+      );
+    }
+  }
+});
+
+// Install event - take control immediately
+self.addEventListener('install', (event) => {
+  event.waitUntil(self.skipWaiting());
+});
+
+// Activate event - claim all clients
+self.addEventListener('activate', (event) => {
+  event.waitUntil(
+    Promise.all([
+      self.clients.claim(),
+      // Clear old caches
+      caches.keys().then((cacheNames) =>
+        Promise.all(
+          cacheNames
+            .filter((name) => name !== CACHE_NAME)
+            .map((name) => caches.delete(name))
+        )
+      ),
+    ])
+  );
+});
+
+// Fetch event - intercept requests to Vite dev server paths
+self.addEventListener('fetch', (event) => {
+  const url = new URL(event.request.url);
+
+  // Only intercept requests to our origin
+  if (url.origin !== VITE_ORIGIN) {
+    return;
+  }
+
+  // Check if this is a Vite-related path
+  const vitePatterns = [
+    /^\/@vite\//,
+    /^\/@id\//,
+    /^\/@fs\//,
+    /^\/node_modules\/.vite\//,
+    /^\/src\//,
+    /\.(js|ts|jsx|tsx|css|scss|sass|less|vue|svelte)(\?.*)?$/,
+    /^\/\?.*$/,
+    /^\/__vite_/,
+  ];
+
+  const isViteRequest = vitePatterns.some((pattern) => pattern.test(url.pathname));
+
+  if (!isViteRequest) {
+    return;
+  }
+
+  event.respondWith(handleViteRequest(event.request, url));
+});
+
+async function handleViteRequest(request, url) {
+  const reqId = ++requestId;
+
+  // Create a promise that will be resolved when we get a response
+  const responsePromise = new Promise((resolve, reject) => {
+    pendingRequests.set(reqId, { resolve, reject });
+
+    // Timeout after 30 seconds
+    setTimeout(() => {
+      if (pendingRequests.has(reqId)) {
+        pendingRequests.delete(reqId);
+        reject(new Error('Request timeout'));
+      }
+    }, 30000);
+  });
+
+  // Send request to main thread
+  channel.postMessage({
+    type: 'request',
+    requestId: reqId,
+    url: url.href,
+    method: request.method,
+    headers: Object.fromEntries(request.headers.entries()),
+    // Note: We can't easily clone the body in all cases, handle in main thread
+  });
+
+  try {
+    return await responsePromise;
+  } catch (error) {
+    console.error('[vite-sw] Request failed:', error);
+    return new Response(`Service Worker Error: ${error.message}`, {
+      status: 500,
+      headers: { 'Content-Type': 'text/plain' },
+    });
+  }
+}
+
+// Handle messages from clients (pages)
+self.addEventListener('message', (event) => {
+  if (event.data === 'skipWaiting') {
+    self.skipWaiting();
+  }
+});

package/dist/worker/runtime-worker.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Runtime Worker - Runs the Just Node runtime in a Web Worker
+ *
+ * This worker receives code execution requests from the main thread
+ * and runs them in isolation, preventing UI blocking.
+ */
+export {};
+//# sourceMappingURL=runtime-worker.d.ts.map

package/dist/worker/runtime-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-worker.d.ts","sourceRoot":"","sources":["../../src/worker/runtime-worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/worker-runtime.d.ts

@@ -0,0 +1,50 @@
+/**
+ * WorkerRuntime - Runs code in a Web Worker for non-blocking execution
+ *
+ * This class provides the same IRuntime interface as Runtime,
+ * but executes code in a separate Web Worker thread.
+ */
+import type { VirtualFS } from './virtual-fs';
+import type { IRuntime, IExecuteResult, IRuntimeOptions } from './runtime-interface';
+/**
+ * WorkerRuntime - Executes code in a Web Worker
+ */
+export declare class WorkerRuntime implements IRuntime {
+    private worker;
+    private workerApi;
+    private vfs;
+    private options;
+    private initialized;
+    private changeListener;
+    private deleteListener;
+    constructor(vfs: VirtualFS, options?: IRuntimeOptions);
+    /**
+     * Initialize the worker with VFS snapshot and options
+     */
+    private initWorker;
+    /**
+     * Set up listeners for VFS changes to sync to worker
+     */
+    private setupVFSListeners;
+    /**
+     * Execute code in the worker
+     */
+    execute(code: string, filename?: string): Promise<IExecuteResult>;
+    /**
+     * Run a file from the VFS in the worker
+     */
+    runFile(filename: string): Promise<IExecuteResult>;
+    /**
+     * Clear the module cache in the worker
+     */
+    clearCache(): void;
+    /**
+     * Get the VFS (main thread instance)
+     */
+    getVFS(): VirtualFS;
+    /**
+     * Terminate the worker
+     */
+    terminate(): void;
+}
+//# sourceMappingURL=worker-runtime.d.ts.map

package/dist/worker-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-runtime.d.ts","sourceRoot":"","sources":["../src/worker-runtime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAe,MAAM,qBAAqB,CAAC;AAelG;;GAEG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,cAAc,CAA0D;IAChF,OAAO,CAAC,cAAc,CAAyC;gBAEnD,GAAG,EAAE,SAAS,EAAE,OAAO,GAAE,eAAoB;IAqBzD;;OAEG;YACW,UAAU;IAqBxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAczB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAKvE;;OAEG;IACG,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAKxD;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,MAAM,IAAI,SAAS;IAInB;;OAEG;IACH,SAAS,IAAI,IAAI;CAalB"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "almostnode",
+  "version": "0.1.0",
+  "description": "Node.js in your browser. Just like that.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "node",
+    "browser",
+    "runtime",
+    "virtual-filesystem",
+    "sandbox",
+    "vite",
+    "nextjs",
+    "hmr",
+    "typescript"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/user/almostnode.git"
+  },
+  "homepage": "https://github.com/user/almostnode#readme",
+  "bugs": {
+    "url": "https://github.com/user/almostnode/issues"
+  },
+  "author": "",
+  "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": {
+    "dev": "vite",
+    "build": "vite build",
+    "build:lib": "vite build --config vite.lib.config.js",
+    "build:types": "tsc --project tsconfig.build.json",
+    "build:publish": "npm run build:lib && npm run build:types",
+    "preview": "vite preview",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui",
+    "test:e2e:debug": "playwright test --debug",
+    "sandbox": "vite --port 3002 --config vite.sandbox.config.js",
+    "sandbox:demo": "echo 'Run in two terminals:\\n  Terminal 1: npm run sandbox (serves sandbox on port 3002)\\n  Terminal 2: npm run dev (serves main app on port 5173)\\nThen open: http://localhost:5173/examples/sandbox-next-demo.html'",
+    "prepublishOnly": "npm run test:run && npm run build:publish"
+  },
+  "dependencies": {
+    "brotli": "^1.3.3",
+    "brotli-wasm": "^3.0.1",
+    "comlink": "^4.4.2",
+    "just-bash": "^2.7.0",
+    "pako": "^2.1.0",
+    "resolve.exports": "^2.0.3",
+    "vite-plugin-top-level-await": "^1.6.0",
+    "vite-plugin-wasm": "^3.5.0"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.58.0",
+    "@types/node": "^25.0.10",
+    "@types/pako": "^2.0.4",
+    "jsdom": "^27.4.0",
+    "typescript": "^5.9.3",
+    "vite": "^5.4.0",
+    "vitest": "^4.0.18"
+  }
+}