@sandboxxjs/core 0.3.0 → 0.5.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { WithState, StateLog } from "@sandboxxjs/state";
-type IsolatorType = "local" | "cloudflare" | "e2b" | "docker";
-type Runtime = "shell" | "node" | "python";
+type IsolatorType = "none" | "srt" | "cloudflare" | "e2b";
+type RuntimeType = "node" | "python";
 interface StateConfig {
 	/** Simple environment variable initialization */
 	env?: Record<string, string>;
@@ -14,8 +14,8 @@ interface StateConfig {
 interface SandboxConfig {
 	/** Isolator type */
 	isolator: IsolatorType;
-	/** Runtime type (default: shell) */
-	runtime?: Runtime;
+	/** Runtime type */
+	runtime: RuntimeType;
 	/** Resource limits */
 	limits?: ResourceLimits;
 	/** State configuration */
@@ -46,13 +46,17 @@ interface PythonConfig {
 	useVenv?: boolean;
 }
 /**
-* Base Sandbox interface - 4 core APIs + ID
+* Base Sandbox interface - core APIs
 */
 interface Sandbox {
 	/** Unique sandbox ID */
 	readonly id: string;
 	/** Execute shell command */
 	shell(command: string): Promise<ShellResult>;
+	/** Execute code (script mode - stdout) */
+	execute(code: string): Promise<ExecuteResult>;
+	/** Evaluate expression (REPL mode - return value) */
+	evaluate(expr: string): Promise<EvaluateResult>;
 	/** Upload file to sandbox */
 	upload(data: Buffer, remotePath: string): Promise<void>;
 	/** Download file from sandbox */
@@ -76,11 +80,8 @@ interface ShellResult {
 	executionTime: number;
 }
 /**
-* Code execution capability
+* Code execution result (same as ShellResult)
 */
-interface WithExecute {
-	execute(code: string): Promise<ExecuteResult>;
-}
 interface ExecuteResult {
 	/** Whether execution succeeded */
 	success: boolean;
@@ -93,28 +94,36 @@ interface ExecuteResult {
 	/** Execution time in milliseconds */
 	executionTime: number;
 }
-/** Node sandbox = Base + State + Execute */
-type NodeSandbox = Sandbox & WithState & WithExecute;
-/** Python sandbox = Base + State + Execute */
-type PythonSandbox = Sandbox & WithState & WithExecute;
-/** Sandbox with State only */
+/**
+* Expression evaluation result
+*/
+interface EvaluateResult {
+	/** Expression result value (as string) */
+	value: string;
+	/** Execution time in milliseconds */
+	executionTime: number;
+}
+/** Sandbox with State (fs, env, storage) */
 type StateSandbox = Sandbox & WithState;
 /** Sandbox constructor type */
 type SandboxConstructor<T extends Sandbox = Sandbox> = new (config: SandboxConfig) => T;
-/** Mixin function type */
-type SandboxMixin<
-	T extends Sandbox,
-	U
-> = (Base: SandboxConstructor<T>) => SandboxConstructor<T & U>;
-interface ShellOptions {
+interface IsolatorOptions {
 	timeout?: number;
 	env?: Record<string, string>;
 }
 declare abstract class Isolator {
+	protected runtime: RuntimeType;
+	constructor(runtime: RuntimeType);
 	/**
-	* Execute shell command in isolated environment
+	* Execute code (script mode - stdout)
+	* Command depends on runtime: node -e / python3 -c
 	*/
-	abstract shell(command: string, options?: ShellOptions): Promise<ShellResult>;
+	abstract execute(code: string, options?: IsolatorOptions): Promise<ExecuteResult>;
+	/**
+	* Evaluate expression (REPL mode - return value)
+	* Command depends on runtime: node -p / python3 -c 'print(...)'
+	*/
+	abstract evaluate(expr: string, options?: IsolatorOptions): Promise<EvaluateResult>;
 	/**
 	* Upload file to isolated environment
 	*/
@@ -139,6 +148,14 @@ declare class BaseSandbox implements Sandbox {
 	*/
 	shell(command: string): Promise<ShellResult>;
 	/**
+	* Execute code (script mode)
+	*/
+	execute(code: string): Promise<ExecuteResult>;
+	/**
+	* Evaluate expression (REPL mode)
+	*/
+	evaluate(expr: string): Promise<EvaluateResult>;
+	/**
 	* Upload file to sandbox
 	*/
 	upload(data: Buffer, remotePath: string): Promise<void>;
@@ -151,13 +168,78 @@ declare class BaseSandbox implements Sandbox {
 	*/
 	destroy(): Promise<void>;
 }
-declare class LocalIsolator extends Isolator {
+declare class NoneIsolator extends Isolator {
 	private workDir;
-	constructor();
+	constructor(runtime: RuntimeType);
 	/**
 	* Execute shell command
 	*/
-	shell(command: string, options?: ShellOptions): Promise<ShellResult>;
+	shell(command: string, options?: IsolatorOptions): Promise<ShellResult>;
+	/**
+	* Execute code (script mode)
+	*/
+	execute(code: string, options?: IsolatorOptions): Promise<ExecuteResult>;
+	/**
+	* Evaluate expression (REPL mode)
+	*/
+	evaluate(expr: string, options?: IsolatorOptions): Promise<EvaluateResult>;
+	/**
+	* Build execute command based on runtime
+	*/
+	private buildExecuteCommand;
+	/**
+	* Build evaluate command based on runtime
+	*/
+	private buildEvaluateCommand;
+	/**
+	* Run command in work directory
+	*/
+	private runCommand;
+	/**
+	* Upload file to sandbox
+	*/
+	upload(data: Buffer, remotePath: string): Promise<void>;
+	/**
+	* Download file from sandbox
+	*/
+	download(remotePath: string): Promise<Buffer>;
+	/**
+	* Destroy isolator and cleanup
+	*/
+	destroy(): Promise<void>;
+}
+declare class SrtIsolator extends Isolator {
+	private workDir;
+	private initialized;
+	constructor(runtime: RuntimeType);
+	/**
+	* Initialize SandboxManager if not already initialized
+	*/
+	private ensureInitialized;
+	/**
+	* Execute shell command with srt isolation
+	*/
+	shell(command: string, options?: IsolatorOptions): Promise<ShellResult>;
+	/**
+	* Execute code (script mode) with srt isolation
+	*/
+	execute(code: string, options?: IsolatorOptions): Promise<ExecuteResult>;
+	/**
+	* Evaluate expression (REPL mode) with srt isolation
+	*/
+	evaluate(expr: string, options?: IsolatorOptions): Promise<EvaluateResult>;
+	/**
+	* Build execute command based on runtime
+	*/
+	private buildExecuteCommand;
+	/**
+	* Build evaluate command based on runtime
+	*/
+	private buildEvaluateCommand;
+	/**
+	* Run command with srt sandbox wrapper
+	*/
+	private runCommand;
 	/**
 	* Upload file to sandbox
 	*/
@@ -175,7 +257,7 @@ declare class CloudflareContainerIsolator extends Isolator {
 	private serverProcess?;
 	private serverUrl?;
 	private isReady;
-	constructor();
+	constructor(runtime: RuntimeType);
 	/**
 	* Find an available port
 	*/
@@ -195,7 +277,19 @@ declare class CloudflareContainerIsolator extends Isolator {
 	/**
 	* Execute shell command
 	*/
-	shell(command: string, options?: ShellOptions): Promise<ShellResult>;
+	shell(command: string, options?: IsolatorOptions): Promise<ShellResult>;
+	/**
+	* Execute code (script mode)
+	*/
+	execute(code: string, options?: IsolatorOptions): Promise<ExecuteResult>;
+	/**
+	* Evaluate expression (REPL mode)
+	*/
+	evaluate(expr: string, options?: IsolatorOptions): Promise<EvaluateResult>;
+	/**
+	* Call server to execute command
+	*/
+	private callServer;
 	/**
 	* Upload file to sandbox
 	*/
@@ -216,14 +310,6 @@ import { WithState as WithState2 } from "@sandboxxjs/state";
 */
 declare function withState<T extends Sandbox>(Base: SandboxConstructor<T>): SandboxConstructor<T & WithState2>;
 /**
-* Add Node.js execute capability to sandbox
-*/
-declare function withNodeExecute<T extends Sandbox>(Base: SandboxConstructor<T>): SandboxConstructor<T & WithExecute>;
-/**
-* Add Python execute capability to sandbox
-*/
-declare function withPythonExecute<T extends Sandbox>(Base: SandboxConstructor<T>): SandboxConstructor<T & WithExecute>;
-/**
 * Error types for SandboX
 */
 declare class SandboxError extends Error {
@@ -238,4 +324,4 @@ declare class TimeoutError extends SandboxError {
 declare class IsolationError extends SandboxError {
 	constructor(message: string);
 }
-export { withState, withPythonExecute, withNodeExecute, loadStateLog, buildStateLog, WithState3 as WithState, WithExecute, TimeoutError, Storage, StateStorage, StateSandbox, StateLogEntry, StateLog2 as StateLog, StateFS, StateError, StateEnv, StateConfig, ShellResult, SandboxMixin, SandboxError, SandboxConstructor, SandboxConfig, Sandbox, Runtime, ResourceLimits, PythonSandbox, PythonConfig, NodeSandbox, NodeConfig, LocalIsolator, IsolatorType, Isolator, IsolationError, FileSystemError, FileSystem, ExecutionError, ExecuteResult, Environment, CloudflareContainerIsolator, BaseSandbox };
+export { withState, loadStateLog, buildStateLog, WithState3 as WithState, TimeoutError, Storage, StateStorage, StateSandbox, StateLogEntry, StateLog2 as StateLog, StateFS, StateError, StateEnv, StateConfig, SrtIsolator, ShellResult, SandboxError, SandboxConstructor, SandboxConfig, Sandbox, RuntimeType, ResourceLimits, PythonConfig, NoneIsolator, NodeConfig, IsolatorType, Isolator, IsolationError, FileSystemError, FileSystem, ExecutionError, ExecuteResult, EvaluateResult, Environment, CloudflareContainerIsolator, BaseSandbox };