sandboxedjs 0.1.25 → 0.1.26

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import EventEmitter from 'events';
+import EventEmitter from 'events/events.js';
 import streamModule from 'stream-browserify';
 
 /** The handle a pod's process manager returns. */
@@ -81,7 +81,12 @@ interface RuntimeProcessResult {
 }
 interface RuntimeProcess {
     readonly completion: Promise<RuntimeProcessResult>;
-    on(event: "output" | "error" | "exit", listener: (...args: any[]) => void): this;
+    /**
+     * `output` and `error` carry stdout and stderr; `exit` the code. `rawmode`
+     * reports the program turning terminal raw mode on or off, which a terminal
+     * needs so that it stops echoing input the program is drawing itself.
+     */
+    on(event: "output" | "error" | "exit" | "rawmode", listener: (...args: any[]) => void): this;
     write(data: string): void;
     kill(signal?: string): void;
 }
@@ -390,6 +395,14 @@ declare class Pipe implements InputStream, OutputStream {
     isTTY: boolean;
     /** Set on pipes owned by an outside caller, who may never call `end()`. */
     interactive: boolean;
+    /**
+     * Set while the running program has put the terminal in raw mode.
+     *
+     * A program in raw mode draws its own input — a prompt library redraws the
+     * whole line on every keystroke — so the terminal must stop echoing, or
+     * every character appears twice.
+     */
+    rawMode: boolean;
     columns: number | undefined;
     rows: number | undefined;
     get closed(): boolean;
@@ -2262,6 +2275,16 @@ declare class CommonJsEngine {
     main: CommonJsModule | null;
     /** `package.json` per directory; resolution reads them constantly. */
     private readonly manifests;
+    private evaluationDepth;
+    /**
+     * Is a module body running synchronously right now?
+     *
+     * `process.exit` unwinds by throwing, and that is only safe while one of
+     * this engine's own frames is on the stack to catch it. Thrown from a later
+     * callback — a stream handler, a timer — it would escape into whichever
+     * library called that callback and surface as an unrelated crash.
+     */
+    get isEvaluating(): boolean;
     constructor(volume: RuntimeVolume, options?: Omit<CommonJsEngineOptions, "volume">);
     /**
      * Evaluate an entry point.
@@ -2426,12 +2449,31 @@ interface CoreModulesOptions {
     spawnChild?: SpawnChild;
     /** File holding the process's standard input, exposed as descriptor 0. */
     stdinPath?: string;
+    /** Keep `process.stdin` open and fed by {@link writeStdin} rather than ending it. */
+    interactiveStdin?: boolean;
+    /** Report the standard streams as a terminal, which is what makes CLIs prompt. */
+    tty?: boolean;
+    /** Called when the program turns raw mode on or off. */
+    onRawMode?: (enabled: boolean) => void;
 }
 /** Build the core-module table injected into each isolated JS worker. */
 declare function createCoreModules(options: CoreModulesOptions): {
     builtins: Record<string, unknown>;
     globals: Record<string, unknown>;
     process: Record<string, any>;
+    /** Deliver a chunk of input to an interactive `process.stdin`. */
+    writeStdin(data: string): void;
+    /** Signal end-of-input to an interactive `process.stdin`. */
+    endStdin(): void;
+    /**
+     * Is the program waiting on input?
+     *
+     * Node keeps a process alive for an open stdin only while something is
+     * actually reading it, and that distinction matters here: a CLI sitting on a
+     * prompt has no timers pending and would otherwise look finished, while a
+     * program that never touches stdin must still be allowed to exit.
+     */
+    readingStdin(): boolean;
     /**
      * How many timers this process still has outstanding.
      *

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import EventEmitter from 'events';
+import EventEmitter from 'events/events.js';
 import streamModule from 'stream-browserify';
 
 /** The handle a pod's process manager returns. */
@@ -81,7 +81,12 @@ interface RuntimeProcessResult {
 }
 interface RuntimeProcess {
     readonly completion: Promise<RuntimeProcessResult>;
-    on(event: "output" | "error" | "exit", listener: (...args: any[]) => void): this;
+    /**
+     * `output` and `error` carry stdout and stderr; `exit` the code. `rawmode`
+     * reports the program turning terminal raw mode on or off, which a terminal
+     * needs so that it stops echoing input the program is drawing itself.
+     */
+    on(event: "output" | "error" | "exit" | "rawmode", listener: (...args: any[]) => void): this;
     write(data: string): void;
     kill(signal?: string): void;
 }
@@ -390,6 +395,14 @@ declare class Pipe implements InputStream, OutputStream {
     isTTY: boolean;
     /** Set on pipes owned by an outside caller, who may never call `end()`. */
     interactive: boolean;
+    /**
+     * Set while the running program has put the terminal in raw mode.
+     *
+     * A program in raw mode draws its own input — a prompt library redraws the
+     * whole line on every keystroke — so the terminal must stop echoing, or
+     * every character appears twice.
+     */
+    rawMode: boolean;
     columns: number | undefined;
     rows: number | undefined;
     get closed(): boolean;
@@ -2262,6 +2275,16 @@ declare class CommonJsEngine {
     main: CommonJsModule | null;
     /** `package.json` per directory; resolution reads them constantly. */
     private readonly manifests;
+    private evaluationDepth;
+    /**
+     * Is a module body running synchronously right now?
+     *
+     * `process.exit` unwinds by throwing, and that is only safe while one of
+     * this engine's own frames is on the stack to catch it. Thrown from a later
+     * callback — a stream handler, a timer — it would escape into whichever
+     * library called that callback and surface as an unrelated crash.
+     */
+    get isEvaluating(): boolean;
     constructor(volume: RuntimeVolume, options?: Omit<CommonJsEngineOptions, "volume">);
     /**
      * Evaluate an entry point.
@@ -2426,12 +2449,31 @@ interface CoreModulesOptions {
     spawnChild?: SpawnChild;
     /** File holding the process's standard input, exposed as descriptor 0. */
     stdinPath?: string;
+    /** Keep `process.stdin` open and fed by {@link writeStdin} rather than ending it. */
+    interactiveStdin?: boolean;
+    /** Report the standard streams as a terminal, which is what makes CLIs prompt. */
+    tty?: boolean;
+    /** Called when the program turns raw mode on or off. */
+    onRawMode?: (enabled: boolean) => void;
 }
 /** Build the core-module table injected into each isolated JS worker. */
 declare function createCoreModules(options: CoreModulesOptions): {
     builtins: Record<string, unknown>;
     globals: Record<string, unknown>;
     process: Record<string, any>;
+    /** Deliver a chunk of input to an interactive `process.stdin`. */
+    writeStdin(data: string): void;
+    /** Signal end-of-input to an interactive `process.stdin`. */
+    endStdin(): void;
+    /**
+     * Is the program waiting on input?
+     *
+     * Node keeps a process alive for an open stdin only while something is
+     * actually reading it, and that distinction matters here: a CLI sitting on a
+     * prompt has no timers pending and would otherwise look finished, while a
+     * program that never touches stdin must still be allowed to exit.
+     */
+    readingStdin(): boolean;
     /**
      * How many timers this process still has outstanding.
      *