@scelar/nodepod 1.0.3 → 1.0.5

package/dist/memory-volume.d.ts

@@ -1,147 +1,157 @@
-import type { VolumeSnapshot } from './engine-types';
-export interface VolumeNode {
-    kind: 'file' | 'directory' | 'symlink';
-    content?: Uint8Array;
-    children?: Map<string, VolumeNode>;
-    target?: string;
-    modified: number;
-}
-type FileChangeHandler = (filePath: string, content: string) => void;
-type FileDeleteHandler = (filePath: string) => void;
-export interface FileStat {
-    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;
-    atimeNs: bigint;
-    mtimeNs: bigint;
-    ctimeNs: bigint;
-    birthtimeNs: bigint;
-}
-export type WatchEventKind = 'change' | 'rename';
-export type WatchCallback = (event: WatchEventKind, name: string | null) => void;
-export interface FileWatchHandle {
-    close(): void;
-    ref(): this;
-    unref(): this;
-    on(event: string, listener: (...args: unknown[]) => void): this;
-    once(event: string, listener: (...args: unknown[]) => void): this;
-    removeListener(event: string, listener: (...args: unknown[]) => void): this;
-    off(event: string, listener: (...args: unknown[]) => void): this;
-    addListener(event: string, listener: (...args: unknown[]) => void): this;
-    removeAllListeners(event?: string): this;
-    emit(event: string, ...args: unknown[]): boolean;
-}
-export interface SystemError extends Error {
-    code: string;
-    errno: number;
-    syscall: string;
-    path?: string;
-}
-export declare function makeSystemError(code: 'ENOENT' | 'ENOTDIR' | 'EISDIR' | 'EEXIST' | 'ENOTEMPTY', syscall: string, targetPath: string, detail?: string): SystemError;
-export declare class MemoryVolume {
-    private tree;
-    private textEncoder;
-    private textDecoder;
-    private activeWatchers;
-    private subscribers;
-    constructor();
-    on(event: 'change', handler: FileChangeHandler): this;
-    on(event: 'delete', handler: FileDeleteHandler): this;
-    off(event: 'change', handler: FileChangeHandler): this;
-    off(event: 'delete', handler: FileDeleteHandler): this;
-    private broadcast;
-    toSnapshot(): VolumeSnapshot;
-    private collectEntries;
-    static fromBinarySnapshot(snapshot: {
-        manifest: Array<{
-            path: string;
-            offset: number;
-            length: number;
-            isDirectory: boolean;
-        }>;
-        data: ArrayBuffer;
-    }): MemoryVolume;
-    static fromSnapshot(snapshot: VolumeSnapshot): MemoryVolume;
-    private normalize;
-    private segments;
-    private parentOf;
-    private nameOf;
-    private locateRaw;
-    private locate;
-    private ensureDir;
-    private writeInternal;
-    existsSync(p: string): boolean;
-    statSync(p: string): FileStat;
-    lstatSync(p: string): FileStat;
-    readFileSync(p: string): Uint8Array;
-    readFileSync(p: string, encoding: 'utf8' | 'utf-8'): string;
-    writeFileSync(p: string, data: string | Uint8Array): void;
-    mkdirSync(p: string, options?: {
-        recursive?: boolean;
-    }): void;
-    readdirSync(p: string): string[];
-    unlinkSync(p: string): void;
-    rmdirSync(p: string): void;
-    renameSync(from: string, to: string): void;
-    accessSync(p: string, _mode?: number): void;
-    copyFileSync(src: string, dest: string): void;
-    realpathSync(p: string): string;
-    symlinkSync(target: string, linkPath: string, _type?: string): void;
-    readlinkSync(p: string): string;
-    linkSync(existingPath: string, newPath: string): void;
-    chmodSync(_p: string, _mode: number): void;
-    chownSync(_p: string, _uid: number, _gid: number): void;
-    appendFileSync(p: string, data: string | Uint8Array): void;
-    truncateSync(p: string, len?: number): void;
-    readFile(p: string, optionsOrCb?: {
-        encoding?: string;
-    } | ((err: Error | null, data?: Uint8Array | string) => void), cb?: (err: Error | null, data?: Uint8Array | string) => void): void;
-    stat(p: string, cb?: (err: Error | null, stats?: FileStat) => void): void;
-    lstat(p: string, cb?: (err: Error | null, stats?: FileStat) => void): void;
-    readdir(p: string, optionsOrCb?: {
-        withFileTypes?: boolean;
-    } | ((err: Error | null, files?: string[]) => void), cb?: (err: Error | null, files?: string[]) => void): void;
-    realpath(p: string, cb?: (err: Error | null, resolved?: string) => void): void;
-    access(p: string, modeOrCb?: number | ((err: Error | null) => void), cb?: (err: Error | null) => void): void;
-    watch(target: string, optionsOrCb?: {
-        persistent?: boolean;
-        recursive?: boolean;
-        encoding?: string;
-    } | WatchCallback, cb?: WatchCallback): FileWatchHandle;
-    private triggerWatchers;
-    private globalChangeListeners;
-    onGlobalChange(cb: (path: string, event: string) => void): () => void;
-    private notifyGlobalListeners;
-    createReadStream(p: string): {
-        on: (event: string, cb: (...args: unknown[]) => void) => void;
-        pipe: (dest: unknown) => unknown;
-    };
-    createWriteStream(p: string): {
-        write: (data: string | Uint8Array) => boolean;
-        end: (data?: string | Uint8Array) => void;
-        on: (event: string, cb: (...args: unknown[]) => void) => void;
-    };
-}
-export {};
+import type { VolumeSnapshot } from './engine-types';
+import type { MemoryHandler } from './memory-handler';
+export interface VolumeNode {
+    kind: 'file' | 'directory' | 'symlink';
+    content?: Uint8Array;
+    children?: Map<string, VolumeNode>;
+    target?: string;
+    modified: number;
+}
+type FileChangeHandler = (filePath: string, content: string) => void;
+type FileDeleteHandler = (filePath: string) => void;
+export interface FileStat {
+    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;
+    atimeNs: bigint;
+    mtimeNs: bigint;
+    ctimeNs: bigint;
+    birthtimeNs: bigint;
+}
+export type WatchEventKind = 'change' | 'rename';
+export type WatchCallback = (event: WatchEventKind, name: string | null) => void;
+export interface FileWatchHandle {
+    close(): void;
+    ref(): this;
+    unref(): this;
+    on(event: string, listener: (...args: unknown[]) => void): this;
+    once(event: string, listener: (...args: unknown[]) => void): this;
+    removeListener(event: string, listener: (...args: unknown[]) => void): this;
+    off(event: string, listener: (...args: unknown[]) => void): this;
+    addListener(event: string, listener: (...args: unknown[]) => void): this;
+    removeAllListeners(event?: string): this;
+    emit(event: string, ...args: unknown[]): boolean;
+}
+export interface SystemError extends Error {
+    code: string;
+    errno: number;
+    syscall: string;
+    path?: string;
+}
+export declare function makeSystemError(code: 'ENOENT' | 'ENOTDIR' | 'EISDIR' | 'EEXIST' | 'ENOTEMPTY', syscall: string, targetPath: string, detail?: string): SystemError;
+export declare class MemoryVolume {
+    private tree;
+    private textEncoder;
+    private textDecoder;
+    private activeWatchers;
+    private subscribers;
+    private _handler;
+    constructor(handler?: MemoryHandler | null);
+    on(event: 'change', handler: FileChangeHandler): this;
+    on(event: 'delete', handler: FileDeleteHandler): this;
+    off(event: 'change', handler: FileChangeHandler): this;
+    off(event: 'delete', handler: FileDeleteHandler): this;
+    private broadcast;
+    getStats(): {
+        fileCount: number;
+        totalBytes: number;
+        dirCount: number;
+        watcherCount: number;
+    };
+    /** Clean up all watchers, subscribers, and global listeners. */
+    dispose(): void;
+    toSnapshot(excludePrefixes?: string[], excludeDirNames?: Set<string>): VolumeSnapshot;
+    private collectEntries;
+    static fromBinarySnapshot(snapshot: {
+        manifest: Array<{
+            path: string;
+            offset: number;
+            length: number;
+            isDirectory: boolean;
+        }>;
+        data: ArrayBuffer;
+    }): MemoryVolume;
+    static fromSnapshot(snapshot: VolumeSnapshot): MemoryVolume;
+    private normalize;
+    private segments;
+    private parentOf;
+    private nameOf;
+    private locateRaw;
+    private locate;
+    private ensureDir;
+    private writeInternal;
+    existsSync(p: string): boolean;
+    statSync(p: string): FileStat;
+    lstatSync(p: string): FileStat;
+    readFileSync(p: string): Uint8Array;
+    readFileSync(p: string, encoding: 'utf8' | 'utf-8'): string;
+    writeFileSync(p: string, data: string | Uint8Array): void;
+    mkdirSync(p: string, options?: {
+        recursive?: boolean;
+    }): void;
+    readdirSync(p: string): string[];
+    unlinkSync(p: string): void;
+    rmdirSync(p: string): void;
+    renameSync(from: string, to: string): void;
+    accessSync(p: string, _mode?: number): void;
+    copyFileSync(src: string, dest: string): void;
+    realpathSync(p: string): string;
+    symlinkSync(target: string, linkPath: string, _type?: string): void;
+    readlinkSync(p: string): string;
+    linkSync(existingPath: string, newPath: string): void;
+    chmodSync(_p: string, _mode: number): void;
+    chownSync(_p: string, _uid: number, _gid: number): void;
+    appendFileSync(p: string, data: string | Uint8Array): void;
+    truncateSync(p: string, len?: number): void;
+    readFile(p: string, optionsOrCb?: {
+        encoding?: string;
+    } | ((err: Error | null, data?: Uint8Array | string) => void), cb?: (err: Error | null, data?: Uint8Array | string) => void): void;
+    stat(p: string, cb?: (err: Error | null, stats?: FileStat) => void): void;
+    lstat(p: string, cb?: (err: Error | null, stats?: FileStat) => void): void;
+    readdir(p: string, optionsOrCb?: {
+        withFileTypes?: boolean;
+    } | ((err: Error | null, files?: string[]) => void), cb?: (err: Error | null, files?: string[]) => void): void;
+    realpath(p: string, cb?: (err: Error | null, resolved?: string) => void): void;
+    access(p: string, modeOrCb?: number | ((err: Error | null) => void), cb?: (err: Error | null) => void): void;
+    watch(target: string, optionsOrCb?: {
+        persistent?: boolean;
+        recursive?: boolean;
+        encoding?: string;
+    } | WatchCallback, cb?: WatchCallback): FileWatchHandle;
+    private triggerWatchers;
+    private globalChangeListeners;
+    onGlobalChange(cb: (path: string, event: string) => void): () => void;
+    private notifyGlobalListeners;
+    createReadStream(p: string): {
+        on: (event: string, cb: (...args: unknown[]) => void) => void;
+        pipe: (dest: unknown) => unknown;
+    };
+    createWriteStream(p: string): {
+        write: (data: string | Uint8Array) => boolean;
+        end: (data?: string | Uint8Array) => void;
+        on: (event: string, cb: (...args: unknown[]) => void) => void;
+    };
+}
+export {};

package/dist/packages/installer.d.ts

@@ -1,41 +1,44 @@
-import { MemoryVolume } from "../memory-volume";
-import { RegistryConfig } from "./registry-client";
-import { ResolvedDependency } from "./version-resolver";
-export interface InstallFlags {
-    registry?: string;
-    persist?: boolean;
-    persistDev?: boolean;
-    withDevDeps?: boolean;
-    withOptionalDeps?: boolean;
-    onProgress?: (message: string) => void;
-    transformModules?: boolean;
-}
-export interface InstallOutcome {
-    resolved: Map<string, ResolvedDependency>;
-    newPackages: string[];
-}
-declare function splitSpecifier(spec: string): {
-    name: string;
-    version?: string;
-};
-export declare class DependencyInstaller {
-    private vol;
-    private registryClient;
-    private workingDir;
-    constructor(vol: MemoryVolume, opts?: {
-        cwd?: string;
-    } & RegistryConfig);
-    install(packageName: string, version?: string, flags?: InstallFlags): Promise<InstallOutcome>;
-    installFromManifest(manifestPath?: string, flags?: InstallFlags): Promise<InstallOutcome>;
-    listInstalled(): Record<string, string>;
-    private materializePackages;
-    private createBinStubs;
-    private writeLockFile;
-    private patchManifest;
-}
-export declare function install(specifier: string, vol: MemoryVolume, flags?: InstallFlags): Promise<InstallOutcome>;
-export { RegistryClient } from "./registry-client";
-export type { RegistryConfig, VersionDetail, PackageMetadata, } from "./registry-client";
-export type { ResolvedDependency, ResolutionConfig } from "./version-resolver";
-export type { ExtractionOptions } from "./archive-extractor";
-export { splitSpecifier };
+import { MemoryVolume } from "../memory-volume";
+import { RegistryConfig } from "./registry-client";
+import { ResolvedDependency } from "./version-resolver";
+import type { IDBSnapshotCache } from "../persistence/idb-cache";
+export interface InstallFlags {
+    registry?: string;
+    persist?: boolean;
+    persistDev?: boolean;
+    withDevDeps?: boolean;
+    withOptionalDeps?: boolean;
+    onProgress?: (message: string) => void;
+    transformModules?: boolean;
+}
+export interface InstallOutcome {
+    resolved: Map<string, ResolvedDependency>;
+    newPackages: string[];
+}
+declare function splitSpecifier(spec: string): {
+    name: string;
+    version?: string;
+};
+export declare class DependencyInstaller {
+    private vol;
+    private registryClient;
+    private workingDir;
+    private _snapshotCache;
+    constructor(vol: MemoryVolume, opts?: {
+        cwd?: string;
+        snapshotCache?: IDBSnapshotCache | null;
+    } & RegistryConfig);
+    install(packageName: string, version?: string, flags?: InstallFlags): Promise<InstallOutcome>;
+    installFromManifest(manifestPath?: string, flags?: InstallFlags): Promise<InstallOutcome>;
+    listInstalled(): Record<string, string>;
+    private materializePackages;
+    private createBinStubs;
+    private writeLockFile;
+    private patchManifest;
+}
+export declare function install(specifier: string, vol: MemoryVolume, flags?: InstallFlags): Promise<InstallOutcome>;
+export { RegistryClient } from "./registry-client";
+export type { RegistryConfig, VersionDetail, PackageMetadata, } from "./registry-client";
+export type { ResolvedDependency, ResolutionConfig } from "./version-resolver";
+export type { ExtractionOptions } from "./archive-extractor";
+export { splitSpecifier };

package/dist/persistence/idb-cache.d.ts

@@ -0,0 +1,7 @@
+import type { VolumeSnapshot } from '../engine-types';
+export interface IDBSnapshotCache {
+    get(packageJsonHash: string): Promise<VolumeSnapshot | null>;
+    set(packageJsonHash: string, snapshot: VolumeSnapshot): Promise<void>;
+    close(): void;
+}
+export declare function openSnapshotCache(): Promise<IDBSnapshotCache | null>;

package/dist/polyfills/wasi.d.ts

@@ -1,12 +1,53 @@
+interface WasiFileStat {
+    isFile(): boolean;
+    isDirectory(): boolean;
+    isSymbolicLink(): boolean;
+    size: number;
+    mtimeMs: number;
+    atimeMs: number;
+    ctimeMs: number;
+    ino?: number;
+    nlink?: number;
+}
+interface WasiFS {
+    readFileSync(p: string): Uint8Array;
+    writeFileSync(p: string, data: string | Uint8Array): void;
+    mkdirSync(p: string, options?: {
+        recursive?: boolean;
+    }): void;
+    statSync(p: string): WasiFileStat;
+    readdirSync(p: string): string[];
+    unlinkSync(p: string): void;
+    rmdirSync(p: string): void;
+    renameSync(from: string, to: string): void;
+    existsSync(p: string): boolean;
+    symlinkSync?(target: string, linkPath: string): void;
+    readlinkSync?(p: string): string;
+}
+export declare class ExitStatus extends Error {
+    readonly code: number;
+    constructor(code: number);
+}
+export interface WASIOptions {
+    version?: "preview1" | "unstable";
+    args?: string[];
+    env?: Record<string, string>;
+    preopens?: Record<string, string>;
+    returnOnExit?: boolean;
+    stdin?: number;
+    stdout?: number;
+    stderr?: number;
+    fs?: WasiFS;
+}
 export interface WASI {
     readonly wasiImport: Record<string, Function>;
-    start(_instance: object): number;
-    initialize(_instance: object): void;
+    start(instance: object): number;
+    initialize(instance: object): void;
     getImportObject(): Record<string, Record<string, Function>>;
 }
 interface WASIConstructor {
-    new (_options?: object): WASI;
-    (this: any, _options?: object): void;
+    new (options?: WASIOptions): WASI;
+    (this: any, options?: WASIOptions): void;
     prototype: any;
 }
 export declare const WASI: WASIConstructor;

package/dist/script-engine.d.ts

@@ -1,81 +1,84 @@
-import { MemoryVolume } from "./memory-volume";
-import type { ExecutionOutcome } from "./engine-types";
-import { ProcessObject } from "./polyfills/process";
-export declare function setChildProcessPolyfill(mod: any): void;
-export interface ModuleRecord {
-    id: string;
-    filename: string;
-    exports: unknown;
-    loaded: boolean;
-    children: ModuleRecord[];
-    paths: string[];
-    parent: ModuleRecord | null;
-}
-export interface EngineOptions {
-    cwd?: string;
-    env?: Record<string, string>;
-    onConsole?: (method: string, args: unknown[]) => void;
-    onStdout?: (data: string) => void;
-    onStderr?: (data: string) => void;
-    workerThreadsOverride?: {
-        isMainThread: boolean;
-        parentPort: unknown;
-        workerData: unknown;
-        threadId: number;
-    };
-}
-export interface ResolverFn {
-    (id: string): unknown;
-    resolve: (id: string, options?: {
-        paths?: string[];
-    }) => string;
-    cache: Record<string, ModuleRecord>;
-    extensions: Record<string, unknown>;
-    main: ModuleRecord | null;
-    _ownerRecord?: ModuleRecord;
-}
-export declare class ScriptEngine {
-    private vol;
-    private fsBridge;
-    private proc;
-    private moduleRegistry;
-    private opts;
-    private transformCache;
-    constructor(vol: MemoryVolume, opts?: EngineOptions);
-    private patchTextDecoder;
-    private patchStackTraceApi;
-    execute(code: string, filename?: string): {
-        exports: unknown;
-        module: ModuleRecord;
-    };
-    executeSync: (code: string, filename?: string) => {
-        exports: unknown;
-        module: ModuleRecord;
-    };
-    executeAsync(code: string, filename?: string): Promise<ExecutionOutcome>;
-    runFile(filename: string): {
-        exports: unknown;
-        module: ModuleRecord;
-    };
-    runFileSync: (filename: string) => {
-        exports: unknown;
-        module: ModuleRecord;
-    };
-    runFileTLA(filename: string): Promise<{
-        exports: unknown;
-        module: ModuleRecord;
-    }>;
-    runFileAsync(filename: string): Promise<ExecutionOutcome>;
-    clearCache(): void;
-    getVolume(): MemoryVolume;
-    getProcess(): ProcessObject;
-    createREPL(): {
-        eval: (code: string) => unknown;
-    };
-}
-export declare function executeCode(code: string, vol: MemoryVolume, opts?: EngineOptions): {
-    exports: unknown;
-    module: ModuleRecord;
-};
-export type { IScriptEngine, ExecutionOutcome, EngineConfig, } from "./engine-types";
-export default ScriptEngine;
+import { MemoryVolume } from "./memory-volume";
+import type { ExecutionOutcome } from "./engine-types";
+import { ProcessObject } from "./polyfills/process";
+export declare function setChildProcessPolyfill(mod: any): void;
+export interface ModuleRecord {
+    id: string;
+    filename: string;
+    exports: unknown;
+    loaded: boolean;
+    children: ModuleRecord[];
+    paths: string[];
+    parent: ModuleRecord | null;
+}
+export interface EngineOptions {
+    cwd?: string;
+    env?: Record<string, string>;
+    onConsole?: (method: string, args: unknown[]) => void;
+    onStdout?: (data: string) => void;
+    onStderr?: (data: string) => void;
+    workerThreadsOverride?: {
+        isMainThread: boolean;
+        parentPort: unknown;
+        workerData: unknown;
+        threadId: number;
+    };
+    handler?: import('./memory-handler').MemoryHandler;
+}
+export interface ResolverFn {
+    (id: string): unknown;
+    resolve: (id: string, options?: {
+        paths?: string[];
+    }) => string;
+    cache: Record<string, ModuleRecord>;
+    extensions: Record<string, unknown>;
+    main: ModuleRecord | null;
+    _ownerRecord?: ModuleRecord;
+}
+export declare class ScriptEngine {
+    private vol;
+    private fsBridge;
+    private proc;
+    private moduleRegistry;
+    private opts;
+    private transformCache;
+    constructor(vol: MemoryVolume, opts?: EngineOptions);
+    private patchTextDecoder;
+    private patchStackTraceApi;
+    execute(code: string, filename?: string): {
+        exports: unknown;
+        module: ModuleRecord;
+    };
+    executeSync: (code: string, filename?: string) => {
+        exports: unknown;
+        module: ModuleRecord;
+    };
+    executeAsync(code: string, filename?: string): Promise<ExecutionOutcome>;
+    runFile(filename: string): {
+        exports: unknown;
+        module: ModuleRecord;
+    };
+    runFileSync: (filename: string) => {
+        exports: unknown;
+        module: ModuleRecord;
+    };
+    runFileTLA(filename: string): Promise<{
+        exports: unknown;
+        module: ModuleRecord;
+    }>;
+    runFileAsync(filename: string): Promise<ExecutionOutcome>;
+    clearCache(): void;
+    /** Evict one node_modules entry when module cache exceeds soft limit. */
+    private _trimModuleCache;
+    getVolume(): MemoryVolume;
+    getProcess(): ProcessObject;
+    createREPL(): {
+        eval: (code: string) => unknown;
+    };
+}
+export declare function executeCode(code: string, vol: MemoryVolume, opts?: EngineOptions): {
+    exports: unknown;
+    module: ModuleRecord;
+};
+export type { IScriptEngine, ExecutionOutcome, EngineConfig, } from "./engine-types";
+export default ScriptEngine;