@treesap/sandbox 0.2.0

package/dist/index.js

@@ -0,0 +1,66 @@
+/**
+ * TreeSap Sandbox v1.0
+ *
+ * A self-hosted sandbox API for isolated code execution and file management.
+ * Provides a Cloudflare-style API for managing sandboxed environments.
+ *
+ * @example Server usage
+ * ```typescript
+ * import { startServer } from '@treesap/sandbox';
+ *
+ * // Start the sandbox server
+ * const { server, manager } = await startServer({
+ *   port: 3000,
+ *   basePath: './.sandboxes'
+ * });
+ * ```
+ *
+ * @example Client SDK usage
+ * ```typescript
+ * import { SandboxClient } from '@treesap/sandbox';
+ *
+ * // Create a new sandbox
+ * const sandbox = await SandboxClient.create('http://localhost:3000');
+ *
+ * // Execute commands
+ * const result = await sandbox.exec('npm install');
+ * console.log(result.stdout);
+ *
+ * // File operations
+ * await sandbox.writeFile('package.json', JSON.stringify(pkg, null, 2));
+ * const files = await sandbox.listFiles();
+ *
+ * // Process management
+ * const server = await sandbox.startProcess('node server.js');
+ * const logs = await sandbox.streamProcessLogs(server.id);
+ *
+ * // Cleanup
+ * await sandbox.destroy({ cleanup: true });
+ * ```
+ *
+ * @packageDocumentation
+ */
+// ============================================================================
+// Server API
+// ============================================================================
+export { startServer, createServer } from './api-server';
+// ============================================================================
+// Client SDK
+// ============================================================================
+export { SandboxClient, parseSSEStream } from './client';
+// ============================================================================
+// Core Components
+// ============================================================================
+export { Sandbox } from './sandbox';
+export { SandboxManager } from './sandbox-manager';
+export { FileService } from './file-service';
+export { StreamService } from './stream-service';
+// ============================================================================
+// Auth & Middleware
+// ============================================================================
+export { createAuthMiddleware, parseApiKeysFromEnv } from './auth-middleware';
+// ============================================================================
+// HTTP Exposure
+// ============================================================================
+export { HttpExposureService } from './http-exposure-service';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGzD,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAGzD,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAwBjD,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG9E,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/sandbox-manager.d.ts

@@ -0,0 +1,76 @@
+import { Sandbox, SandboxConfig } from './sandbox';
+import { EventEmitter } from 'events';
+export interface SandboxManagerConfig {
+    basePath?: string;
+    maxSandboxes?: number;
+    defaultTimeout?: number;
+    autoCleanup?: boolean;
+    cleanupInterval?: number;
+    maxIdleTime?: number;
+}
+/**
+ * Manages multiple sandbox instances
+ */
+export declare class SandboxManager extends EventEmitter {
+    private sandboxes;
+    private lastActivity;
+    private config;
+    private cleanupIntervalId?;
+    constructor(config?: SandboxManagerConfig);
+    /**
+     * Create a new sandbox
+     */
+    createSandbox(config?: SandboxConfig): Promise<Sandbox>;
+    /**
+     * Get a sandbox by ID
+     */
+    getSandbox(id: string): Sandbox | undefined;
+    /**
+     * List all sandboxes
+     */
+    listSandboxes(): Array<{
+        id: string;
+        status: ReturnType<Sandbox['getStatus']>;
+    }>;
+    /**
+     * Destroy a sandbox
+     */
+    destroySandbox(id: string, options?: {
+        cleanup?: boolean;
+    }): Promise<void>;
+    /**
+     * Destroy all sandboxes
+     */
+    destroyAll(options?: {
+        cleanup?: boolean;
+    }): Promise<void>;
+    /**
+     * Get manager statistics
+     */
+    getStats(): {
+        totalSandboxes: number;
+        maxSandboxes: number | undefined;
+        totalProcesses: number;
+        basePath: string | undefined;
+        autoCleanup: boolean | undefined;
+    };
+    /**
+     * Start periodic cleanup task
+     */
+    private startCleanupTask;
+    /**
+     * Clean up idle sandboxes
+     */
+    private cleanupIdleSandboxes;
+    /**
+     * Update last activity time for a sandbox
+     */
+    private updateActivity;
+    /**
+     * Shutdown the manager (cleanup all sandboxes)
+     */
+    shutdown(options?: {
+        cleanup?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=sandbox-manager.d.ts.map

package/dist/sandbox-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-manager.d.ts","sourceRoot":"","sources":["../src/sandbox-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,iBAAiB,CAAC,CAAiB;gBAE/B,MAAM,GAAE,oBAAyB;IAqB7C;;OAEG;IACG,aAAa,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,OAAO,CAAC;IAkCjE;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAQ3C;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAA;KAAE,CAAC;IAOhF;;OAEG;IACG,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAapF;;OAEG;IACG,UAAU,CAAC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpE;;OAEG;IACH,QAAQ;;;;;;;IAgBR;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;YACW,oBAAoB;IAkBlC;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACG,QAAQ,CAAC,OAAO,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAQnE"}

package/dist/sandbox-manager.js

@@ -0,0 +1,161 @@
+import { Sandbox } from './sandbox';
+import { EventEmitter } from 'events';
+import * as path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * Manages multiple sandbox instances
+ */
+export class SandboxManager extends EventEmitter {
+    sandboxes = new Map();
+    lastActivity = new Map();
+    config;
+    cleanupIntervalId;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            basePath: config.basePath || path.join(process.cwd(), '.sandboxes'),
+            maxSandboxes: config.maxSandboxes || 100,
+            defaultTimeout: config.defaultTimeout || 300000, // 5 minutes
+            autoCleanup: config.autoCleanup !== false, // Default true
+            cleanupInterval: config.cleanupInterval || 60000, // 1 minute
+            maxIdleTime: config.maxIdleTime || 1800000, // 30 minutes
+        };
+        // Ensure basePath is always set
+        if (!this.config.basePath) {
+            this.config.basePath = path.join(process.cwd(), '.sandboxes');
+        }
+        if (this.config.autoCleanup) {
+            this.startCleanupTask();
+        }
+    }
+    /**
+     * Create a new sandbox
+     */
+    async createSandbox(config = {}) {
+        // Check sandbox limit
+        if (this.config.maxSandboxes && this.sandboxes.size >= this.config.maxSandboxes) {
+            throw new Error(`Maximum sandbox limit reached (${this.config.maxSandboxes})`);
+        }
+        // Generate ID first if not provided
+        const sandboxId = config.id || uuidv4();
+        // Create sandbox with base path
+        const sandboxConfig = {
+            ...config,
+            id: sandboxId,
+            workDir: config.workDir || path.join(this.config.basePath, sandboxId),
+            timeout: config.timeout || this.config.defaultTimeout,
+        };
+        const sandbox = new Sandbox(sandboxConfig);
+        await sandbox.initialize();
+        // Track sandbox
+        this.sandboxes.set(sandbox.id, sandbox);
+        this.lastActivity.set(sandbox.id, Date.now());
+        // Listen for sandbox events to track activity
+        sandbox.on('output', () => this.updateActivity(sandbox.id));
+        sandbox.on('exec_complete', () => this.updateActivity(sandbox.id));
+        sandbox.on('process_started', () => this.updateActivity(sandbox.id));
+        this.emit('sandbox_created', { id: sandbox.id });
+        return sandbox;
+    }
+    /**
+     * Get a sandbox by ID
+     */
+    getSandbox(id) {
+        const sandbox = this.sandboxes.get(id);
+        if (sandbox) {
+            this.updateActivity(id);
+        }
+        return sandbox;
+    }
+    /**
+     * List all sandboxes
+     */
+    listSandboxes() {
+        return Array.from(this.sandboxes.entries()).map(([id, sandbox]) => ({
+            id,
+            status: sandbox.getStatus(),
+        }));
+    }
+    /**
+     * Destroy a sandbox
+     */
+    async destroySandbox(id, options = {}) {
+        const sandbox = this.sandboxes.get(id);
+        if (!sandbox) {
+            throw new Error(`Sandbox ${id} not found`);
+        }
+        await sandbox.destroy(options);
+        this.sandboxes.delete(id);
+        this.lastActivity.delete(id);
+        this.emit('sandbox_destroyed', { id });
+    }
+    /**
+     * Destroy all sandboxes
+     */
+    async destroyAll(options = {}) {
+        const destroyPromises = Array.from(this.sandboxes.keys()).map((id) => this.destroySandbox(id, options).catch((err) => {
+            console.error(`Error destroying sandbox ${id}:`, err);
+        }));
+        await Promise.all(destroyPromises);
+    }
+    /**
+     * Get manager statistics
+     */
+    getStats() {
+        const sandboxList = this.listSandboxes();
+        const totalProcesses = sandboxList.reduce((sum, { status }) => sum + status.processCount, 0);
+        return {
+            totalSandboxes: this.sandboxes.size,
+            maxSandboxes: this.config.maxSandboxes,
+            totalProcesses,
+            basePath: this.config.basePath,
+            autoCleanup: this.config.autoCleanup,
+        };
+    }
+    /**
+     * Start periodic cleanup task
+     */
+    startCleanupTask() {
+        this.cleanupIntervalId = setInterval(() => {
+            this.cleanupIdleSandboxes();
+        }, this.config.cleanupInterval);
+        // Don't keep process alive for cleanup
+        this.cleanupIntervalId.unref();
+    }
+    /**
+     * Clean up idle sandboxes
+     */
+    async cleanupIdleSandboxes() {
+        const now = Date.now();
+        const maxIdleTime = this.config.maxIdleTime;
+        const idleSandboxes = Array.from(this.lastActivity.entries())
+            .filter(([_, lastActive]) => now - lastActive > maxIdleTime)
+            .map(([id]) => id);
+        for (const id of idleSandboxes) {
+            try {
+                await this.destroySandbox(id, { cleanup: true });
+                this.emit('sandbox_cleaned_up', { id, reason: 'idle' });
+            }
+            catch (error) {
+                console.error(`Error cleaning up sandbox ${id}:`, error);
+            }
+        }
+    }
+    /**
+     * Update last activity time for a sandbox
+     */
+    updateActivity(id) {
+        this.lastActivity.set(id, Date.now());
+    }
+    /**
+     * Shutdown the manager (cleanup all sandboxes)
+     */
+    async shutdown(options = {}) {
+        if (this.cleanupIntervalId) {
+            clearInterval(this.cleanupIntervalId);
+        }
+        await this.destroyAll(options);
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=sandbox-manager.js.map

package/dist/sandbox-manager.js.map

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

package/dist/sandbox.d.ts

@@ -0,0 +1,118 @@
+import { EventEmitter } from 'events';
+export interface SandboxConfig {
+    id?: string;
+    workDir?: string;
+    env?: Record<string, string>;
+    timeout?: number;
+    maxProcesses?: number;
+}
+export interface ProcessInfo {
+    id: string;
+    pid: number;
+    command: string;
+    status: 'running' | 'completed' | 'failed';
+    startTime: number;
+    exitCode?: number;
+}
+export interface ExecOptions {
+    stream?: boolean;
+    onOutput?: (stream: 'stdout' | 'stderr', data: string) => void;
+    timeout?: number;
+    cwd?: string;
+    env?: Record<string, string>;
+}
+export interface ExecuteResponse {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    timedOut?: boolean;
+}
+/**
+ * Represents a single isolated sandbox instance
+ * Each sandbox has its own working directory and process management
+ */
+export declare class Sandbox extends EventEmitter {
+    readonly id: string;
+    readonly workDir: string;
+    readonly createdAt: number;
+    private processes;
+    private runningProcesses;
+    private config;
+    private destroyed;
+    constructor(config?: SandboxConfig);
+    /**
+     * Initialize the sandbox (create working directory)
+     */
+    initialize(): Promise<void>;
+    /**
+     * Execute a command and return the complete result
+     */
+    exec(command: string, options?: ExecOptions): Promise<ExecuteResponse>;
+    /**
+     * Start a long-running background process
+     */
+    startProcess(command: string, options?: ExecOptions): Promise<ProcessInfo>;
+    /**
+     * List all processes (running and completed)
+     */
+    listProcesses(): ProcessInfo[];
+    /**
+     * Get information about a specific process
+     */
+    getProcess(processId: string): ProcessInfo | undefined;
+    /**
+     * Kill a specific process
+     */
+    killProcess(processId: string, signal?: string): Promise<void>;
+    /**
+     * Kill all running processes
+     */
+    killAllProcesses(signal?: string): Promise<void>;
+    /**
+     * Get sandbox status
+     */
+    getStatus(): {
+        id: string;
+        workDir: string;
+        createdAt: number;
+        uptime: number;
+        processCount: number;
+        totalProcesses: number;
+        destroyed: boolean;
+    };
+    /**
+     * Set a single environment variable
+     */
+    setEnv(key: string, value: string): void;
+    /**
+     * Set multiple environment variables at once
+     */
+    setEnvBatch(variables: Record<string, string>): void;
+    /**
+     * Get environment variable(s)
+     * If key is provided, returns the value for that key
+     * Otherwise returns all environment variables
+     */
+    getEnv(): Record<string, string>;
+    getEnv(key: string): string | undefined;
+    /**
+     * Get list of environment variable names (for security, not exposing values)
+     */
+    getEnvKeys(): string[];
+    /**
+     * Unset (remove) an environment variable
+     */
+    unsetEnv(key: string): boolean;
+    /**
+     * Destroy the sandbox (kill all processes, optionally clean up files)
+     */
+    destroy(options?: {
+        cleanup?: boolean;
+    }): Promise<void>;
+    /**
+     * Parse a command string into command and arguments
+     */
+    private parseCommand;
+}
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/sandbox.d.ts.map

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