@cloudflare/sandbox 0.4.1 → 0.4.3

package/dist/index.js

@@ -13,36 +13,46 @@ import {
   UtilityClient,
   getSandbox,
   proxyToSandbox
-} from "./chunk-HGF554LH.js";
+} from "./chunk-EXQOIRZI.js";
 import {
-  CodeInterpreter
-} from "./chunk-BCJ7SF3Q.js";
+  CodeInterpreter,
+  Execution,
+  LogLevel,
+  ResultImpl,
+  TraceContext,
+  createLogger,
+  createNoOpLogger,
+  getLogger,
+  isExecResult,
+  isProcess,
+  isProcessStatus,
+  runWithLogger
+} from "./chunk-JXZMAU2C.js";
 import "./chunk-Z532A7QC.js";
 import {
   asyncIterableToSSEStream,
   parseSSEStream,
   responseToAsyncIterable
 } from "./chunk-EKSWCBCA.js";
-
-// src/index.ts
-export * from "@repo/shared";
-import {
-  isExecResult,
-  isProcess,
-  isProcessStatus
-} from "@repo/shared";
 export {
   CodeInterpreter,
   CommandClient,
+  Execution,
   FileClient,
   GitClient,
+  LogLevel as LogLevelEnum,
   PortClient,
   ProcessClient,
+  ResultImpl,
   Sandbox,
   SandboxClient,
+  TraceContext,
   UtilityClient,
   asyncIterableToSSEStream,
   collectFile,
+  createLogger,
+  createNoOpLogger,
+  getLogger,
   getSandbox,
   isExecResult,
   isProcess,
@@ -50,6 +60,7 @@ export {
   parseSSEStream,
   proxyToSandbox,
   responseToAsyncIterable,
+  runWithLogger,
   streamFile
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Export the main Sandbox class and utilities\n\n\n// Export the new client architecture\nexport {\n  CommandClient,\n  FileClient,\n  GitClient,\n  PortClient,\n  ProcessClient,\n  SandboxClient,\n  UtilityClient\n} from \"./clients\";\nexport { getSandbox, Sandbox } from \"./sandbox\";\n\n// Legacy types are now imported from the new client architecture\n\n// Export core SDK types for consumers\nexport type {\n  BaseExecOptions,\n  ExecEvent,\n  ExecOptions,\n  ExecResult,FileChunk, FileMetadata, FileStreamEvent, \n  ISandbox,\n  LogEvent,\n  Process,\n  ProcessOptions,\n  ProcessStatus,\n  StreamOptions \n} from \"@repo/shared\";\nexport * from '@repo/shared';\n// Export type guards for runtime validation\nexport {\n  isExecResult,\n  isProcess,\n  isProcessStatus\n} from \"@repo/shared\";\n// Export all client types from new architecture\nexport type {\n  BaseApiResponse,\n  CommandsResponse,\n  ContainerStub,\n  ErrorResponse,\n\n  // Command client types\n  ExecuteRequest,\n  ExecuteResponse as CommandExecuteResponse,\n\n  // Port client types\n  ExposePortRequest,\n  FileOperationRequest,\n\n  // Git client types\n  GitCheckoutRequest,\n  GitCheckoutResult,\n  // Base client types\n  HttpClientOptions as SandboxClientOptions,\n\n  // File client types\n  MkdirRequest,\n\n  // Utility client types\n  PingResponse,\n  PortCloseResult,\n  PortExposeResult,\n  PortListResult,\n  ProcessCleanupResult,\n  ProcessInfoResult,\n  ProcessKillResult,\n  ProcessListResult,\n  ProcessLogsResult,\n  ProcessStartResult,\n  ReadFileRequest,\n  RequestConfig,\n  ResponseHandler,\n  SessionRequest,\n\n  // Process client types\n  StartProcessRequest,\n  UnexposePortRequest,\n  WriteFileRequest\n} from \"./clients\";\nexport type { ExecutionCallbacks, InterpreterClient } from './clients/interpreter-client.js';\n// Export file streaming utilities for binary file support\nexport { collectFile, streamFile } from './file-stream';\n// Export interpreter functionality\nexport { CodeInterpreter } from './interpreter.js';\n// Re-export request handler utilities\nexport {\n  proxyToSandbox, type RouteInfo, type SandboxEnv\n} from './request-handler';\n// Export SSE parser for converting ReadableStream to AsyncIterable\nexport { asyncIterableToSSEStream, parseSSEStream, responseToAsyncIterable } from \"./sse-parser\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,cAAc;AAEd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/interpreter.js

@@ -1,6 +1,6 @@
 import {
   CodeInterpreter
-} from "./chunk-BCJ7SF3Q.js";
+} from "./chunk-JXZMAU2C.js";
 import "./chunk-Z532A7QC.js";
 export {
   CodeInterpreter

package/dist/request-handler.js

@@ -1,8 +1,8 @@
 import {
   isLocalhostPattern,
   proxyToSandbox
-} from "./chunk-HGF554LH.js";
-import "./chunk-BCJ7SF3Q.js";
+} from "./chunk-EXQOIRZI.js";
+import "./chunk-JXZMAU2C.js";
 import "./chunk-Z532A7QC.js";
 import "./chunk-EKSWCBCA.js";
 export {

package/dist/sandbox.js

@@ -1,8 +1,8 @@
 import {
   Sandbox,
   getSandbox
-} from "./chunk-HGF554LH.js";
-import "./chunk-BCJ7SF3Q.js";
+} from "./chunk-EXQOIRZI.js";
+import "./chunk-JXZMAU2C.js";
 import "./chunk-Z532A7QC.js";
 import "./chunk-EKSWCBCA.js";
 export {

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@cloudflare/sandbox",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/cloudflare/sandbox-sdk"
   },
   "description": "A sandboxed environment for running commands",
   "dependencies": {
-    "@cloudflare/containers": "^0.0.28",
+    "@cloudflare/containers": "^0.0.28"
+  },
+  "devDependencies": {
     "@repo/shared": "^0.0.0"
   },
   "tags": [

package/src/sandbox.ts

@@ -110,7 +110,6 @@ export class Sandbox<Env = unknown> extends Container<Env> implements ISandbox {
     if (!this.baseUrl) {
       this.baseUrl = baseUrl;
       await this.ctx.storage.put('baseUrl', baseUrl);
-      console.log(`[Sandbox] Stored base URL: ${baseUrl}`);
     } else {
       if(this.baseUrl !== baseUrl) {
         throw new Error('Base URL already set and different from one previously provided');

package/dist/chunk-BCJ7SF3Q.js

@@ -1,117 +0,0 @@
-import {
-  validateLanguage
-} from "./chunk-Z532A7QC.js";
-
-// src/interpreter.ts
-import {
-  Execution,
-  ResultImpl
-} from "@repo/shared";
-var CodeInterpreter = class {
-  interpreterClient;
-  contexts = /* @__PURE__ */ new Map();
-  constructor(sandbox) {
-    this.interpreterClient = sandbox.client.interpreter;
-  }
-  /**
-   * Create a new code execution context
-   */
-  async createCodeContext(options = {}) {
-    validateLanguage(options.language);
-    const context = await this.interpreterClient.createCodeContext(options);
-    this.contexts.set(context.id, context);
-    return context;
-  }
-  /**
-   * Run code with optional context
-   */
-  async runCode(code, options = {}) {
-    let context = options.context;
-    if (!context) {
-      const language = options.language || "python";
-      context = await this.getOrCreateDefaultContext(language);
-    }
-    const execution = new Execution(code, context);
-    await this.interpreterClient.runCodeStream(context.id, code, options.language, {
-      onStdout: (output) => {
-        execution.logs.stdout.push(output.text);
-        if (options.onStdout) return options.onStdout(output);
-      },
-      onStderr: (output) => {
-        execution.logs.stderr.push(output.text);
-        if (options.onStderr) return options.onStderr(output);
-      },
-      onResult: async (result) => {
-        execution.results.push(new ResultImpl(result));
-        if (options.onResult) return options.onResult(result);
-      },
-      onError: (error) => {
-        execution.error = error;
-        if (options.onError) return options.onError(error);
-      }
-    });
-    return execution;
-  }
-  /**
-   * Run code and return a streaming response
-   */
-  async runCodeStream(code, options = {}) {
-    let context = options.context;
-    if (!context) {
-      const language = options.language || "python";
-      context = await this.getOrCreateDefaultContext(language);
-    }
-    const response = await this.interpreterClient.doFetch("/api/execute/code", {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "text/event-stream"
-      },
-      body: JSON.stringify({
-        context_id: context.id,
-        code,
-        language: options.language
-      })
-    });
-    if (!response.ok) {
-      const errorData = await response.json().catch(() => ({ error: "Unknown error" }));
-      throw new Error(
-        errorData.error || `Failed to execute code: ${response.status}`
-      );
-    }
-    if (!response.body) {
-      throw new Error("No response body for streaming execution");
-    }
-    return response.body;
-  }
-  /**
-   * List all code contexts
-   */
-  async listCodeContexts() {
-    const contexts = await this.interpreterClient.listCodeContexts();
-    for (const context of contexts) {
-      this.contexts.set(context.id, context);
-    }
-    return contexts;
-  }
-  /**
-   * Delete a code context
-   */
-  async deleteCodeContext(contextId) {
-    await this.interpreterClient.deleteCodeContext(contextId);
-    this.contexts.delete(contextId);
-  }
-  async getOrCreateDefaultContext(language) {
-    for (const context of this.contexts.values()) {
-      if (context.language === language) {
-        return context;
-      }
-    }
-    return this.createCodeContext({ language });
-  }
-};
-
-export {
-  CodeInterpreter
-};
-//# sourceMappingURL=chunk-BCJ7SF3Q.js.map

package/dist/chunk-BCJ7SF3Q.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/interpreter.ts"],"sourcesContent":["import {\n  type CodeContext,\n  type CreateContextOptions,\n  Execution,\n  type ExecutionError,\n  type OutputMessage,\n  type Result,\n  ResultImpl,\n  type RunCodeOptions,\n} from \"@repo/shared\";\nimport type { InterpreterClient } from \"./clients/interpreter-client.js\";\nimport type { Sandbox } from \"./sandbox.js\";\nimport { validateLanguage } from \"./security.js\";\n\nexport class CodeInterpreter {\n  private interpreterClient: InterpreterClient;\n  private contexts = new Map<string, CodeContext>();\n\n  constructor(sandbox: Sandbox) {\n    // In init-testing architecture, client is a SandboxClient with an interpreter property\n    this.interpreterClient = (sandbox.client as any).interpreter as InterpreterClient;\n  }\n\n  /**\n   * Create a new code execution context\n   */\n  async createCodeContext(\n    options: CreateContextOptions = {}\n  ): Promise<CodeContext> {\n    // Validate language before sending to container\n    validateLanguage(options.language);\n\n    const context = await this.interpreterClient.createCodeContext(options);\n    this.contexts.set(context.id, context);\n    return context;\n  }\n\n  /**\n   * Run code with optional context\n   */\n  async runCode(\n    code: string,\n    options: RunCodeOptions = {}\n  ): Promise<Execution> {\n    // Get or create context\n    let context = options.context;\n    if (!context) {\n      // Try to find or create a default context for the language\n      const language = options.language || \"python\";\n      context = await this.getOrCreateDefaultContext(language);\n    }\n\n    // Create execution object to collect results\n    const execution = new Execution(code, context);\n\n    // Stream execution\n    await this.interpreterClient.runCodeStream(context.id, code, options.language, {\n      onStdout: (output: OutputMessage) => {\n        execution.logs.stdout.push(output.text);\n        if (options.onStdout) return options.onStdout(output);\n      },\n      onStderr: (output: OutputMessage) => {\n        execution.logs.stderr.push(output.text);\n        if (options.onStderr) return options.onStderr(output);\n      },\n      onResult: async (result: Result) => {\n        execution.results.push(new ResultImpl(result) as any);\n        if (options.onResult) return options.onResult(result);\n      },\n      onError: (error: ExecutionError) => {\n        execution.error = error;\n        if (options.onError) return options.onError(error);\n      },\n    });\n\n    return execution;\n  }\n\n  /**\n   * Run code and return a streaming response\n   */\n  async runCodeStream(\n    code: string,\n    options: RunCodeOptions = {}\n  ): Promise<ReadableStream> {\n    // Get or create context\n    let context = options.context;\n    if (!context) {\n      const language = options.language || \"python\";\n      context = await this.getOrCreateDefaultContext(language);\n    }\n\n    // Create streaming response\n    // Note: doFetch is protected but we need direct access for raw stream response\n    const response = await (this.interpreterClient as any).doFetch(\"/api/execute/code\", {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        Accept: \"text/event-stream\",\n      },\n      body: JSON.stringify({\n        context_id: context.id,\n        code,\n        language: options.language,\n      }),\n    });\n\n    if (!response.ok) {\n      const errorData = (await response\n        .json()\n        .catch(() => ({ error: \"Unknown error\" }))) as { error?: string };\n      throw new Error(\n        errorData.error || `Failed to execute code: ${response.status}`\n      );\n    }\n\n    if (!response.body) {\n      throw new Error(\"No response body for streaming execution\");\n    }\n\n    return response.body;\n  }\n\n  /**\n   * List all code contexts\n   */\n  async listCodeContexts(): Promise<CodeContext[]> {\n    const contexts = await this.interpreterClient.listCodeContexts();\n\n    // Update local cache\n    for (const context of contexts) {\n      this.contexts.set(context.id, context);\n    }\n\n    return contexts;\n  }\n\n  /**\n   * Delete a code context\n   */\n  async deleteCodeContext(contextId: string): Promise<void> {\n    await this.interpreterClient.deleteCodeContext(contextId);\n    this.contexts.delete(contextId);\n  }\n\n  private async getOrCreateDefaultContext(\n    language: \"python\" | \"javascript\" | \"typescript\"\n  ): Promise<CodeContext> {\n    // Check if we have a cached context for this language\n    for (const context of this.contexts.values()) {\n      if (context.language === language) {\n        return context;\n      }\n    }\n\n    // Create new default context\n    return this.createCodeContext({ language });\n  }\n}\n"],"mappings":"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","names":[]}