@treesap/sandbox 0.2.0

package/dist/file-service.d.ts

@@ -0,0 +1,94 @@
+import { Readable } from 'stream';
+export interface FileInfo {
+    name: string;
+    path: string;
+    type: 'file' | 'directory';
+    size?: number;
+    mtime?: number;
+}
+export interface ListFilesOptions {
+    recursive?: boolean;
+    pattern?: string;
+    includeHidden?: boolean;
+}
+export interface ReadFileOptions {
+    encoding?: BufferEncoding;
+    raw?: boolean;
+}
+export interface WriteFileOptions {
+    encoding?: BufferEncoding;
+    mode?: number;
+    createDirs?: boolean;
+}
+/**
+ * Service for managing file operations within a sandbox
+ * Includes path validation to prevent directory traversal attacks
+ */
+export declare class FileService {
+    private basePath;
+    constructor(basePath: string);
+    /**
+     * Validate and resolve a path within the sandbox
+     * Prevents directory traversal attacks
+     */
+    private resolvePath;
+    /**
+     * Read a file's contents
+     */
+    readFile(filePath: string, options?: ReadFileOptions): Promise<string | Buffer>;
+    /**
+     * Write content to a file
+     */
+    writeFile(filePath: string, content: string | Buffer, options?: WriteFileOptions): Promise<void>;
+    /**
+     * List files in a directory
+     */
+    listFiles(dirPath?: string, options?: ListFilesOptions): Promise<FileInfo[]>;
+    /**
+     * Delete a file or directory
+     */
+    deleteFile(filePath: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    /**
+     * Check if a file or directory exists
+     */
+    exists(filePath: string): Promise<boolean>;
+    /**
+     * Get file stats
+     */
+    stat(filePath: string): Promise<FileInfo>;
+    /**
+     * Create a directory
+     */
+    mkdir(dirPath: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    /**
+     * Copy a file or directory
+     */
+    copy(sourcePath: string, destPath: string, options?: {
+        overwrite?: boolean;
+    }): Promise<void>;
+    /**
+     * Move/rename a file or directory
+     */
+    move(sourcePath: string, destPath: string): Promise<void>;
+    /**
+     * Create a readable stream for a file
+     */
+    createReadStream(filePath: string): Readable;
+    /**
+     * Create a writable stream for a file
+     */
+    createWriteStream(filePath: string): NodeJS.WritableStream;
+    /**
+     * Simple glob pattern matching
+     */
+    private matchPattern;
+    /**
+     * Get the base path of this file service
+     */
+    getBasePath(): string;
+}
+//# sourceMappingURL=file-service.d.ts.map

package/dist/file-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-service.d.ts","sourceRoot":"","sources":["../src/file-service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGlC,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B;;;OAGG;IACH,OAAO,CAAC,WAAW;IAWnB;;OAEG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAWzF;;OAEG;IACG,SAAS,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC;IAmBhB;;OAEG;IACG,SAAS,CAAC,OAAO,GAAE,MAAY,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgD3F;;OAEG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxF;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUhD;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAc/C;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlF;;OAEG;IACG,IAAI,CACR,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GACpC,OAAO,CAAC,IAAI,CAAC;IAmBhB;;OAEG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/D;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ;IAK5C;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc;IAK1D;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB"}

package/dist/file-service.js

@@ -0,0 +1,203 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { createReadStream, createWriteStream } from 'fs';
+/**
+ * Service for managing file operations within a sandbox
+ * Includes path validation to prevent directory traversal attacks
+ */
+export class FileService {
+    basePath;
+    constructor(basePath) {
+        this.basePath = path.resolve(basePath);
+    }
+    /**
+     * Validate and resolve a path within the sandbox
+     * Prevents directory traversal attacks
+     */
+    resolvePath(filePath) {
+        const resolved = path.resolve(this.basePath, filePath);
+        // Ensure the resolved path is within basePath
+        if (!resolved.startsWith(this.basePath)) {
+            throw new Error('Path traversal detected - access denied');
+        }
+        return resolved;
+    }
+    /**
+     * Read a file's contents
+     */
+    async readFile(filePath, options = {}) {
+        const resolved = this.resolvePath(filePath);
+        if (options.raw) {
+            return await fs.readFile(resolved);
+        }
+        const encoding = options.encoding || 'utf-8';
+        return await fs.readFile(resolved, encoding);
+    }
+    /**
+     * Write content to a file
+     */
+    async writeFile(filePath, content, options = {}) {
+        const resolved = this.resolvePath(filePath);
+        // Create parent directories if requested
+        if (options.createDirs) {
+            const dir = path.dirname(resolved);
+            await fs.mkdir(dir, { recursive: true });
+        }
+        const encoding = options.encoding || 'utf-8';
+        const writeOptions = { encoding };
+        if (options.mode) {
+            writeOptions.mode = options.mode;
+        }
+        await fs.writeFile(resolved, content, writeOptions);
+    }
+    /**
+     * List files in a directory
+     */
+    async listFiles(dirPath = '.', options = {}) {
+        const resolved = this.resolvePath(dirPath);
+        const files = [];
+        const entries = await fs.readdir(resolved, { withFileTypes: true });
+        for (const entry of entries) {
+            // Skip hidden files unless requested
+            if (!options.includeHidden && entry.name.startsWith('.')) {
+                continue;
+            }
+            // Apply pattern filter if provided
+            if (options.pattern && !this.matchPattern(entry.name, options.pattern)) {
+                continue;
+            }
+            const fullPath = path.join(resolved, entry.name);
+            const relativePath = path.relative(this.basePath, fullPath);
+            const fileInfo = {
+                name: entry.name,
+                path: relativePath,
+                type: entry.isDirectory() ? 'directory' : 'file',
+            };
+            // Get file stats for size and mtime
+            try {
+                const stats = await fs.stat(fullPath);
+                fileInfo.size = stats.size;
+                fileInfo.mtime = stats.mtimeMs;
+            }
+            catch {
+                // Ignore stat errors
+            }
+            files.push(fileInfo);
+            // Recursively list subdirectories if requested
+            if (options.recursive && entry.isDirectory()) {
+                const subFiles = await this.listFiles(relativePath, options);
+                files.push(...subFiles);
+            }
+        }
+        return files;
+    }
+    /**
+     * Delete a file or directory
+     */
+    async deleteFile(filePath, options = {}) {
+        const resolved = this.resolvePath(filePath);
+        const stats = await fs.stat(resolved);
+        if (stats.isDirectory()) {
+            await fs.rm(resolved, { recursive: options.recursive, force: true });
+        }
+        else {
+            await fs.unlink(resolved);
+        }
+    }
+    /**
+     * Check if a file or directory exists
+     */
+    async exists(filePath) {
+        try {
+            const resolved = this.resolvePath(filePath);
+            await fs.access(resolved);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get file stats
+     */
+    async stat(filePath) {
+        const resolved = this.resolvePath(filePath);
+        const stats = await fs.stat(resolved);
+        const relativePath = path.relative(this.basePath, resolved);
+        return {
+            name: path.basename(resolved),
+            path: relativePath,
+            type: stats.isDirectory() ? 'directory' : 'file',
+            size: stats.size,
+            mtime: stats.mtimeMs,
+        };
+    }
+    /**
+     * Create a directory
+     */
+    async mkdir(dirPath, options = {}) {
+        const resolved = this.resolvePath(dirPath);
+        await fs.mkdir(resolved, { recursive: options.recursive });
+    }
+    /**
+     * Copy a file or directory
+     */
+    async copy(sourcePath, destPath, options = {}) {
+        const resolvedSource = this.resolvePath(sourcePath);
+        const resolvedDest = this.resolvePath(destPath);
+        // Check if destination exists
+        if (!options.overwrite) {
+            try {
+                await fs.access(resolvedDest);
+                throw new Error('Destination already exists');
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT') {
+                    throw err;
+                }
+            }
+        }
+        await fs.cp(resolvedSource, resolvedDest, { recursive: true });
+    }
+    /**
+     * Move/rename a file or directory
+     */
+    async move(sourcePath, destPath) {
+        const resolvedSource = this.resolvePath(sourcePath);
+        const resolvedDest = this.resolvePath(destPath);
+        await fs.rename(resolvedSource, resolvedDest);
+    }
+    /**
+     * Create a readable stream for a file
+     */
+    createReadStream(filePath) {
+        const resolved = this.resolvePath(filePath);
+        return createReadStream(resolved);
+    }
+    /**
+     * Create a writable stream for a file
+     */
+    createWriteStream(filePath) {
+        const resolved = this.resolvePath(filePath);
+        return createWriteStream(resolved);
+    }
+    /**
+     * Simple glob pattern matching
+     */
+    matchPattern(filename, pattern) {
+        // Convert glob pattern to regex
+        const regexPattern = pattern
+            .replace(/\./g, '\\.')
+            .replace(/\*/g, '.*')
+            .replace(/\?/g, '.');
+        const regex = new RegExp(`^${regexPattern}$`, 'i');
+        return regex.test(filename);
+    }
+    /**
+     * Get the base path of this file service
+     */
+    getBasePath() {
+        return this.basePath;
+    }
+}
+//# sourceMappingURL=file-service.js.map

package/dist/file-service.js.map

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

package/dist/http-exposure-service.d.ts

@@ -0,0 +1,71 @@
+/**
+ * HTTP Exposure Service
+ * Integrates with Caddy Admin API to dynamically expose sandbox ports
+ */
+export interface HttpExposureConfig {
+    /**
+     * Caddy Admin API URL (default: http://localhost:2019)
+     */
+    caddyAdminUrl: string;
+    /**
+     * Base domain for sandbox subdomains (e.g., sandbox.yourdomain.com)
+     */
+    baseDomain: string;
+    /**
+     * Protocol to use for generated URLs (default: https)
+     */
+    protocol: 'http' | 'https';
+    /**
+     * Host where sandbox ports are accessible (default: localhost)
+     * This is the internal address Caddy will proxy to
+     */
+    upstreamHost: string;
+}
+export interface ExposedEndpoint {
+    sandboxId: string;
+    port: number;
+    publicUrl: string;
+    routeId: string;
+    createdAt: number;
+}
+/**
+ * Service for managing HTTP exposure of sandbox ports via Caddy
+ */
+export declare class HttpExposureService {
+    private config;
+    private exposures;
+    constructor(config?: Partial<HttpExposureConfig>);
+    /**
+     * Generate a unique subdomain for a sandbox port
+     */
+    private generateSubdomain;
+    /**
+     * Generate a unique route ID for Caddy
+     */
+    private generateRouteId;
+    /**
+     * Expose a sandbox port and return the public URL
+     */
+    expose(sandboxId: string, port: number): Promise<string>;
+    /**
+     * Remove HTTP exposure for a sandbox port (or all ports if port is undefined)
+     */
+    unexpose(sandboxId: string, port?: number): Promise<void>;
+    /**
+     * Get all exposures for a sandbox
+     */
+    getExposures(sandboxId: string): ExposedEndpoint[];
+    /**
+     * Get a specific exposure
+     */
+    getExposure(sandboxId: string, port: number): ExposedEndpoint | undefined;
+    /**
+     * Get all exposures across all sandboxes
+     */
+    getAllExposures(): ExposedEndpoint[];
+    /**
+     * Clean up all exposures for a sandbox (called when sandbox is destroyed)
+     */
+    cleanup(sandboxId: string): Promise<void>;
+}
+//# sourceMappingURL=http-exposure-service.d.ts.map

package/dist/http-exposure-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-exposure-service.d.ts","sourceRoot":"","sources":["../src/http-exposure-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAE3B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AASD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,SAAS,CAA6C;gBAElD,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAYpD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA8E9D;;OAEG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqC/D;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE;IAIlD;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAKzE;;OAEG;IACH,eAAe,IAAI,eAAe,EAAE;IAQpC;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhD"}

package/dist/http-exposure-service.js

@@ -0,0 +1,172 @@
+/**
+ * HTTP Exposure Service
+ * Integrates with Caddy Admin API to dynamically expose sandbox ports
+ */
+const DEFAULT_CONFIG = {
+    caddyAdminUrl: 'http://localhost:2019',
+    baseDomain: 'sandbox.localhost',
+    protocol: 'https',
+    upstreamHost: 'localhost',
+};
+/**
+ * Service for managing HTTP exposure of sandbox ports via Caddy
+ */
+export class HttpExposureService {
+    config;
+    exposures = new Map();
+    constructor(config = {}) {
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config,
+            // Allow env vars to override
+            caddyAdminUrl: config.caddyAdminUrl || process.env.CADDY_ADMIN_URL || DEFAULT_CONFIG.caddyAdminUrl,
+            baseDomain: config.baseDomain || process.env.SANDBOX_DOMAIN || DEFAULT_CONFIG.baseDomain,
+            protocol: (config.protocol || process.env.SANDBOX_PROTOCOL || DEFAULT_CONFIG.protocol),
+            upstreamHost: config.upstreamHost || process.env.SANDBOX_UPSTREAM_HOST || DEFAULT_CONFIG.upstreamHost,
+        };
+    }
+    /**
+     * Generate a unique subdomain for a sandbox port
+     */
+    generateSubdomain(sandboxId, port) {
+        // Use first 8 chars of sandbox ID + port for a shorter, readable subdomain
+        const shortId = sandboxId.substring(0, 8);
+        return `${shortId}-${port}`;
+    }
+    /**
+     * Generate a unique route ID for Caddy
+     */
+    generateRouteId(sandboxId, port) {
+        return `sandbox-${sandboxId}-${port}`;
+    }
+    /**
+     * Expose a sandbox port and return the public URL
+     */
+    async expose(sandboxId, port) {
+        const subdomain = this.generateSubdomain(sandboxId, port);
+        const routeId = this.generateRouteId(sandboxId, port);
+        const hostname = `${subdomain}.${this.config.baseDomain}`;
+        const publicUrl = `${this.config.protocol}://${hostname}`;
+        // Check if already exposed
+        const existing = this.getExposure(sandboxId, port);
+        if (existing) {
+            return existing.publicUrl;
+        }
+        // Create Caddy route configuration
+        const route = {
+            '@id': routeId,
+            match: [{ host: [hostname] }],
+            handle: [
+                {
+                    handler: 'reverse_proxy',
+                    upstreams: [{ dial: `${this.config.upstreamHost}:${port}` }],
+                },
+            ],
+        };
+        try {
+            // Add route to Caddy via Admin API
+            const response = await fetch(`${this.config.caddyAdminUrl}/config/apps/http/servers/srv0/routes`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(route),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to add Caddy route: ${errorText}`);
+            }
+            // Track the exposure
+            const endpoint = {
+                sandboxId,
+                port,
+                publicUrl,
+                routeId,
+                createdAt: Date.now(),
+            };
+            const sandboxExposures = this.exposures.get(sandboxId) || [];
+            sandboxExposures.push(endpoint);
+            this.exposures.set(sandboxId, sandboxExposures);
+            return publicUrl;
+        }
+        catch (error) {
+            // If Caddy is not available, return a placeholder URL for development
+            if (error.cause?.code === 'ECONNREFUSED') {
+                console.warn(`Caddy not available at ${this.config.caddyAdminUrl}. Using placeholder URL.`);
+                // Still track the exposure locally
+                const endpoint = {
+                    sandboxId,
+                    port,
+                    publicUrl: `http://${this.config.upstreamHost}:${port}`,
+                    routeId,
+                    createdAt: Date.now(),
+                };
+                const sandboxExposures = this.exposures.get(sandboxId) || [];
+                sandboxExposures.push(endpoint);
+                this.exposures.set(sandboxId, sandboxExposures);
+                return endpoint.publicUrl;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Remove HTTP exposure for a sandbox port (or all ports if port is undefined)
+     */
+    async unexpose(sandboxId, port) {
+        const endpoints = this.exposures.get(sandboxId) || [];
+        const toRemove = port
+            ? endpoints.filter((e) => e.port === port)
+            : endpoints;
+        for (const endpoint of toRemove) {
+            try {
+                // Remove route from Caddy via Admin API
+                const response = await fetch(`${this.config.caddyAdminUrl}/id/${endpoint.routeId}`, { method: 'DELETE' });
+                // Ignore 404 errors (route doesn't exist)
+                if (!response.ok && response.status !== 404) {
+                    console.warn(`Failed to remove Caddy route ${endpoint.routeId}: ${response.status}`);
+                }
+            }
+            catch (error) {
+                // Ignore connection errors (Caddy not available)
+                if (error.cause?.code !== 'ECONNREFUSED') {
+                    console.warn(`Error removing Caddy route: ${error.message}`);
+                }
+            }
+        }
+        // Update local tracking
+        if (port) {
+            this.exposures.set(sandboxId, endpoints.filter((e) => e.port !== port));
+        }
+        else {
+            this.exposures.delete(sandboxId);
+        }
+    }
+    /**
+     * Get all exposures for a sandbox
+     */
+    getExposures(sandboxId) {
+        return this.exposures.get(sandboxId) || [];
+    }
+    /**
+     * Get a specific exposure
+     */
+    getExposure(sandboxId, port) {
+        const endpoints = this.exposures.get(sandboxId) || [];
+        return endpoints.find((e) => e.port === port);
+    }
+    /**
+     * Get all exposures across all sandboxes
+     */
+    getAllExposures() {
+        const all = [];
+        for (const endpoints of this.exposures.values()) {
+            all.push(...endpoints);
+        }
+        return all;
+    }
+    /**
+     * Clean up all exposures for a sandbox (called when sandbox is destroyed)
+     */
+    async cleanup(sandboxId) {
+        await this.unexpose(sandboxId);
+    }
+}
+//# sourceMappingURL=http-exposure-service.js.map

package/dist/http-exposure-service.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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
+ */
+export { startServer, createServer } from './api-server';
+export type { ServerConfig } from './api-server';
+export { SandboxClient, parseSSEStream } from './client';
+export type { SandboxClientConfig, CreateSandboxResponse } from './client';
+export { Sandbox } from './sandbox';
+export { SandboxManager } from './sandbox-manager';
+export { FileService } from './file-service';
+export { StreamService } from './stream-service';
+export type { SandboxConfig, ProcessInfo, ExecOptions, ExecuteResponse, } from './sandbox';
+export type { SandboxManagerConfig } from './sandbox-manager';
+export type { FileInfo, ListFilesOptions, ReadFileOptions, WriteFileOptions, } from './file-service';
+export type { ExecEvent, ExecEventType, LogEvent } from './stream-service';
+export { createAuthMiddleware, parseApiKeysFromEnv } from './auth-middleware';
+export type { AuthConfig } from './auth-middleware';
+export { HttpExposureService } from './http-exposure-service';
+export type { HttpExposureConfig, ExposedEndpoint } from './http-exposure-service';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAMH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACzD,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMjD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACzD,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAM3E,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;AAMjD,YAAY,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,eAAe,GAChB,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,YAAY,EACV,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAM3E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAMpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}