sandboxedjs 0.1.27 → 0.1.28

package/dist/index.d.cts

@@ -9,6 +9,14 @@ interface ChildHandle {
     on(event: "stdout" | "stderr" | "exit", listener: (...args: any[]) => void): unknown;
     exec(): void;
     sendStdin(data: string): void;
+    /**
+     * Close the child's input.
+     *
+     * Without this a child that reads stdin to EOF — every filter, and every
+     * tool a library pipes into, `xsel` and `base64` alike — waits forever for
+     * an end that never comes, and the parent waits on its exit.
+     */
+    endStdin?(): void;
     kill(signal?: string): void;
 }
 interface ChildSpawnConfig {
@@ -2426,6 +2434,8 @@ declare class VirtualHttpRouter {
     onListen: ((port: number) => void) | undefined;
     register(port: number, server: VirtualHttpServer, owner: string): void;
     unregister(port: number, server: VirtualHttpServer): void;
+    /** Whether anything in this container is listening on `port`. */
+    activePortsIncludes(port: number): boolean;
     activePorts(owner?: string): number[];
     closeOwner(owner: string): void;
     closeAll(): void;
@@ -2443,6 +2453,7 @@ interface CoreModulesOptions {
     http?: {
         router: VirtualHttpRouter;
         owner: string;
+        fetch?: typeof globalThis.fetch;
     };
     /** Backs `child_process`; without it the module reports as unavailable. */
     spawnChild?: SpawnChild;
@@ -2485,6 +2496,14 @@ declare function createCoreModules(options: CoreModulesOptions): {
     pendingHandles(): number;
     /** Active timers which called `unref()` and therefore only merit startup grace. */
     pendingUnrefed(): number;
+    /**
+     * Client requests sent but not yet read to completion.
+     *
+     * An outbound request is event-loop work in exactly the way a timer is, and
+     * it schedules no timer of its own. Counting it is what stops a program from
+     * exiting in the gap between `http.get` and its response callback.
+     */
+    pendingRequests(): number;
 };
 
 interface EsmTransformResult {
@@ -2572,6 +2591,8 @@ declare class LocalRuntimePod implements RuntimePod {
     private readonly modules;
     private readonly esbuild;
     private rolldownBinding;
+    /** Backs outbound `http`/`https` client requests from inside the sandbox. */
+    private readonly fetch;
     private constructor();
     static boot(options?: LocalRuntimeOptions): Promise<LocalRuntimePod>;
     spawn(command: string, args?: string[], options?: Record<string, unknown>): Promise<RuntimeProcess>;

package/dist/index.d.ts

@@ -9,6 +9,14 @@ interface ChildHandle {
     on(event: "stdout" | "stderr" | "exit", listener: (...args: any[]) => void): unknown;
     exec(): void;
     sendStdin(data: string): void;
+    /**
+     * Close the child's input.
+     *
+     * Without this a child that reads stdin to EOF — every filter, and every
+     * tool a library pipes into, `xsel` and `base64` alike — waits forever for
+     * an end that never comes, and the parent waits on its exit.
+     */
+    endStdin?(): void;
     kill(signal?: string): void;
 }
 interface ChildSpawnConfig {
@@ -2426,6 +2434,8 @@ declare class VirtualHttpRouter {
     onListen: ((port: number) => void) | undefined;
     register(port: number, server: VirtualHttpServer, owner: string): void;
     unregister(port: number, server: VirtualHttpServer): void;
+    /** Whether anything in this container is listening on `port`. */
+    activePortsIncludes(port: number): boolean;
     activePorts(owner?: string): number[];
     closeOwner(owner: string): void;
     closeAll(): void;
@@ -2443,6 +2453,7 @@ interface CoreModulesOptions {
     http?: {
         router: VirtualHttpRouter;
         owner: string;
+        fetch?: typeof globalThis.fetch;
     };
     /** Backs `child_process`; without it the module reports as unavailable. */
     spawnChild?: SpawnChild;
@@ -2485,6 +2496,14 @@ declare function createCoreModules(options: CoreModulesOptions): {
     pendingHandles(): number;
     /** Active timers which called `unref()` and therefore only merit startup grace. */
     pendingUnrefed(): number;
+    /**
+     * Client requests sent but not yet read to completion.
+     *
+     * An outbound request is event-loop work in exactly the way a timer is, and
+     * it schedules no timer of its own. Counting it is what stops a program from
+     * exiting in the gap between `http.get` and its response callback.
+     */
+    pendingRequests(): number;
 };
 
 interface EsmTransformResult {
@@ -2572,6 +2591,8 @@ declare class LocalRuntimePod implements RuntimePod {
     private readonly modules;
     private readonly esbuild;
     private rolldownBinding;
+    /** Backs outbound `http`/`https` client requests from inside the sandbox. */
+    private readonly fetch;
     private constructor();
     static boot(options?: LocalRuntimeOptions): Promise<LocalRuntimePod>;
     spawn(command: string, args?: string[], options?: Record<string, unknown>): Promise<RuntimeProcess>;