computesdk 1.10.1 → 1.10.2

package/dist/index.d.mts

@@ -3089,10 +3089,12 @@ interface ExplicitComputeConfig {
     };
 }
 /**
- * Options for creating a sandbox
+ * Options for creating a sandbox via the gateway
+ *
+ * Note: Runtime is determined by the provider, not specified at creation time.
+ * Use sandbox.runCode(code, runtime) to specify which runtime to use for execution.
  */
 interface CreateSandboxOptions {
-    runtime?: 'node' | 'python';
     timeout?: number;
     templateId?: string;
     metadata?: Record<string, any>;
@@ -3134,6 +3136,23 @@ declare class ComputeManager {
      * Get gateway config, throwing if not configured
      */
     private getGatewayConfig;
+    /**
+     * Explicitly configure the compute singleton
+     *
+     * @example
+     * ```typescript
+     * import { compute } from 'computesdk';
+     *
+     * compute.setConfig({
+     *   provider: 'e2b',
+     *   apiKey: 'computesdk_xxx',
+     *   e2b: { apiKey: 'e2b_xxx' }
+     * });
+     *
+     * const sandbox = await compute.sandbox.create();
+     * ```
+     */
+    setConfig(config: ExplicitComputeConfig): void;
     sandbox: {
         /**
          * Create a new sandbox
@@ -3175,6 +3194,8 @@ declare class ComputeManager {
 interface CallableCompute extends ComputeManager {
     /** Create a new compute instance with explicit configuration */
     (config: ExplicitComputeConfig): ComputeManager;
+    /** Explicitly configure the singleton */
+    setConfig(config: ExplicitComputeConfig): void;
 }
 /**
  * Callable compute - works as both singleton and factory function
@@ -3270,57 +3291,4 @@ declare const PROVIDER_ENV_VARS: {
     readonly blaxel: readonly ["BL_API_KEY", "BL_WORKSPACE"];
 };
 
-/**
- * Simplified Request Handler for Web Framework Integration
- *
- * Handles JSON requests for sandbox and code execution operations.
- */
-type GatewayRuntime = 'node' | 'python';
-/**
- * Request structure supporting sandbox and code execution capabilities
- */
-interface ComputeRequest {
-    /** Action in dot notation (e.g., 'compute.sandbox.create') */
-    action: string;
-    /** Parameters for the action */
-    sandboxId?: string;
-    code?: string;
-    command?: string;
-    args?: string[];
-    runtime?: GatewayRuntime;
-    path?: string;
-    content?: string;
-    /** Command options (for runCommand action) */
-    commandOptions?: {
-        background?: boolean;
-    };
-    /** Sandbox creation options */
-    options?: {
-        runtime?: GatewayRuntime;
-        timeout?: number;
-        name?: string;
-        namespace?: string;
-    };
-}
-/**
- * Response structure for compute operations
- */
-interface ComputeResponse {
-    success: boolean;
-    error?: string;
-    sandboxId: string;
-    provider: string;
-    [key: string]: any;
-}
-/**
- * Main request handler - handles HTTP requests and pre-parsed bodies
- */
-declare function handleComputeRequest(requestOrBody: Request | ComputeRequest): Promise<Response | ComputeResponse>;
-/**
- * Parameters for handleComputeRequest
- */
-interface HandleComputeRequestParams {
-    request: ComputeRequest;
-}
-
-export { type CodeResult$1 as CodeResult, CommandExitError, type CommandResult$1 as CommandResult, type ComputeRequest, type ComputeResponse, type CreateSandboxOptions$1 as CreateSandboxOptions, type FileEntry, FileWatcher, GATEWAY_URL, Sandbox as GatewaySandbox, type HandleComputeRequestParams, MessageType, PROVIDER_AUTH, PROVIDER_DASHBOARD_URLS, PROVIDER_ENV_MAP, PROVIDER_ENV_VARS, PROVIDER_HEADERS, PROVIDER_NAMES, PROVIDER_PRIORITY, type ProviderName, type ProviderSandboxInfo, type RunCommandOptions, type Runtime, Sandbox, type SandboxFileSystem, type SandboxInfo$1 as SandboxInfo, type Sandbox$1 as SandboxInterface, type SandboxStatus, SignalService, TerminalInstance, autoConfigureCompute, buildProviderHeaders, compute, decodeBinaryMessage, detectProvider, encodeBinaryMessage, getMissingEnvVars, getProviderConfigFromEnv, getProviderHeaders, handleComputeRequest, isCommandExitError, isGatewayModeEnabled, isProviderAuthComplete, isValidProvider };
+export { type CodeResult$1 as CodeResult, CommandExitError, type CommandResult$1 as CommandResult, type CreateSandboxOptions$1 as CreateSandboxOptions, type FileEntry, FileWatcher, GATEWAY_URL, Sandbox as GatewaySandbox, MessageType, PROVIDER_AUTH, PROVIDER_DASHBOARD_URLS, PROVIDER_ENV_MAP, PROVIDER_ENV_VARS, PROVIDER_HEADERS, PROVIDER_NAMES, PROVIDER_PRIORITY, type ProviderName, type ProviderSandboxInfo, type RunCommandOptions, type Runtime, Sandbox, type SandboxFileSystem, type SandboxInfo$1 as SandboxInfo, type Sandbox$1 as SandboxInterface, type SandboxStatus, SignalService, TerminalInstance, autoConfigureCompute, buildProviderHeaders, compute, decodeBinaryMessage, detectProvider, encodeBinaryMessage, getMissingEnvVars, getProviderConfigFromEnv, getProviderHeaders, isCommandExitError, isGatewayModeEnabled, isProviderAuthComplete, isValidProvider };

package/dist/index.d.ts

@@ -3089,10 +3089,12 @@ interface ExplicitComputeConfig {
     };
 }
 /**
- * Options for creating a sandbox
+ * Options for creating a sandbox via the gateway
+ *
+ * Note: Runtime is determined by the provider, not specified at creation time.
+ * Use sandbox.runCode(code, runtime) to specify which runtime to use for execution.
  */
 interface CreateSandboxOptions {
-    runtime?: 'node' | 'python';
     timeout?: number;
     templateId?: string;
     metadata?: Record<string, any>;
@@ -3134,6 +3136,23 @@ declare class ComputeManager {
      * Get gateway config, throwing if not configured
      */
     private getGatewayConfig;
+    /**
+     * Explicitly configure the compute singleton
+     *
+     * @example
+     * ```typescript
+     * import { compute } from 'computesdk';
+     *
+     * compute.setConfig({
+     *   provider: 'e2b',
+     *   apiKey: 'computesdk_xxx',
+     *   e2b: { apiKey: 'e2b_xxx' }
+     * });
+     *
+     * const sandbox = await compute.sandbox.create();
+     * ```
+     */
+    setConfig(config: ExplicitComputeConfig): void;
     sandbox: {
         /**
          * Create a new sandbox
@@ -3175,6 +3194,8 @@ declare class ComputeManager {
 interface CallableCompute extends ComputeManager {
     /** Create a new compute instance with explicit configuration */
     (config: ExplicitComputeConfig): ComputeManager;
+    /** Explicitly configure the singleton */
+    setConfig(config: ExplicitComputeConfig): void;
 }
 /**
  * Callable compute - works as both singleton and factory function
@@ -3270,57 +3291,4 @@ declare const PROVIDER_ENV_VARS: {
     readonly blaxel: readonly ["BL_API_KEY", "BL_WORKSPACE"];
 };
 
-/**
- * Simplified Request Handler for Web Framework Integration
- *
- * Handles JSON requests for sandbox and code execution operations.
- */
-type GatewayRuntime = 'node' | 'python';
-/**
- * Request structure supporting sandbox and code execution capabilities
- */
-interface ComputeRequest {
-    /** Action in dot notation (e.g., 'compute.sandbox.create') */
-    action: string;
-    /** Parameters for the action */
-    sandboxId?: string;
-    code?: string;
-    command?: string;
-    args?: string[];
-    runtime?: GatewayRuntime;
-    path?: string;
-    content?: string;
-    /** Command options (for runCommand action) */
-    commandOptions?: {
-        background?: boolean;
-    };
-    /** Sandbox creation options */
-    options?: {
-        runtime?: GatewayRuntime;
-        timeout?: number;
-        name?: string;
-        namespace?: string;
-    };
-}
-/**
- * Response structure for compute operations
- */
-interface ComputeResponse {
-    success: boolean;
-    error?: string;
-    sandboxId: string;
-    provider: string;
-    [key: string]: any;
-}
-/**
- * Main request handler - handles HTTP requests and pre-parsed bodies
- */
-declare function handleComputeRequest(requestOrBody: Request | ComputeRequest): Promise<Response | ComputeResponse>;
-/**
- * Parameters for handleComputeRequest
- */
-interface HandleComputeRequestParams {
-    request: ComputeRequest;
-}
-
-export { type CodeResult$1 as CodeResult, CommandExitError, type CommandResult$1 as CommandResult, type ComputeRequest, type ComputeResponse, type CreateSandboxOptions$1 as CreateSandboxOptions, type FileEntry, FileWatcher, GATEWAY_URL, Sandbox as GatewaySandbox, type HandleComputeRequestParams, MessageType, PROVIDER_AUTH, PROVIDER_DASHBOARD_URLS, PROVIDER_ENV_MAP, PROVIDER_ENV_VARS, PROVIDER_HEADERS, PROVIDER_NAMES, PROVIDER_PRIORITY, type ProviderName, type ProviderSandboxInfo, type RunCommandOptions, type Runtime, Sandbox, type SandboxFileSystem, type SandboxInfo$1 as SandboxInfo, type Sandbox$1 as SandboxInterface, type SandboxStatus, SignalService, TerminalInstance, autoConfigureCompute, buildProviderHeaders, compute, decodeBinaryMessage, detectProvider, encodeBinaryMessage, getMissingEnvVars, getProviderConfigFromEnv, getProviderHeaders, handleComputeRequest, isCommandExitError, isGatewayModeEnabled, isProviderAuthComplete, isValidProvider };
+export { type CodeResult$1 as CodeResult, CommandExitError, type CommandResult$1 as CommandResult, type CreateSandboxOptions$1 as CreateSandboxOptions, type FileEntry, FileWatcher, GATEWAY_URL, Sandbox as GatewaySandbox, MessageType, PROVIDER_AUTH, PROVIDER_DASHBOARD_URLS, PROVIDER_ENV_MAP, PROVIDER_ENV_VARS, PROVIDER_HEADERS, PROVIDER_NAMES, PROVIDER_PRIORITY, type ProviderName, type ProviderSandboxInfo, type RunCommandOptions, type Runtime, Sandbox, type SandboxFileSystem, type SandboxInfo$1 as SandboxInfo, type Sandbox$1 as SandboxInterface, type SandboxStatus, SignalService, TerminalInstance, autoConfigureCompute, buildProviderHeaders, compute, decodeBinaryMessage, detectProvider, encodeBinaryMessage, getMissingEnvVars, getProviderConfigFromEnv, getProviderHeaders, isCommandExitError, isGatewayModeEnabled, isProviderAuthComplete, isValidProvider };

package/dist/index.js

@@ -44,7 +44,6 @@ __export(index_exports, {
   getMissingEnvVars: () => getMissingEnvVars,
   getProviderConfigFromEnv: () => getProviderConfigFromEnv,
   getProviderHeaders: () => getProviderHeaders,
-  handleComputeRequest: () => handleComputeRequest,
   isCommandExitError: () => isCommandExitError,
   isGatewayModeEnabled: () => isGatewayModeEnabled,
   isProviderAuthComplete: () => isProviderAuthComplete,
@@ -3670,11 +3669,39 @@ var ComputeManager = class {
     this.ensureConfigured();
     if (!this.config) {
       throw new Error(
-        'No gateway configuration found.\n\nOptions:\n1. Zero-config mode: Set COMPUTESDK_API_KEY and provider credentials (e.g., E2B_API_KEY)\n2. Explicit mode: Call compute({ provider: "e2b", apiKey: "...", e2b: { apiKey: "..." } })\n3. Direct mode: Import createCompute from @computesdk/provider to bypass the gateway\n\nDocs: https://computesdk.com/docs/quickstart'
+        `No ComputeSDK configuration found.
+
+Options:
+1. Zero-config: Set COMPUTESDK_API_KEY and provider credentials (e.g., E2B_API_KEY)
+2. Explicit: Call compute.setConfig({ provider: "e2b", apiKey: "...", e2b: { apiKey: "..." } })
+3. Use provider directly: import { e2b } from '@computesdk/e2b'
+
+Docs: https://computesdk.com/docs/quickstart`
       );
     }
     return this.config;
   }
+  /**
+   * Explicitly configure the compute singleton
+   * 
+   * @example
+   * ```typescript
+   * import { compute } from 'computesdk';
+   * 
+   * compute.setConfig({
+   *   provider: 'e2b',
+   *   apiKey: 'computesdk_xxx',
+   *   e2b: { apiKey: 'e2b_xxx' }
+   * });
+   * 
+   * const sandbox = await compute.sandbox.create();
+   * ```
+   */
+  setConfig(config) {
+    const gatewayConfig = createConfigFromExplicit(config);
+    this.config = gatewayConfig;
+    this.autoConfigured = false;
+  }
 };
 var singletonInstance = new ComputeManager();
 function computeFactory(config) {
@@ -3699,192 +3726,6 @@ var compute = new Proxy(
     }
   }
 );
-
-// src/request-handler.ts
-async function executeAction(body) {
-  try {
-    const { action, sandboxId } = body;
-    if (action === "compute.sandbox.create") {
-      const sandbox2 = await compute.sandbox.create(body.options || { runtime: "python" });
-      return {
-        success: true,
-        sandboxId: sandbox2.sandboxId,
-        provider: sandbox2.provider
-      };
-    }
-    if (action === "compute.sandbox.list") {
-      throw new Error("List operation not supported in gateway mode");
-    }
-    if (action === "compute.sandbox.destroy") {
-      if (!sandboxId) {
-        throw new Error("sandboxId is required for destroy action");
-      }
-      await compute.sandbox.destroy(sandboxId);
-      return {
-        success: true,
-        sandboxId,
-        provider: "gateway"
-      };
-    }
-    if (!sandboxId) {
-      throw new Error("sandboxId is required for this action");
-    }
-    const sandbox = await compute.sandbox.getById(sandboxId);
-    if (!sandbox) {
-      throw new Error(`Sandbox ${sandboxId} not found`);
-    }
-    if (action === "compute.sandbox.getInfo") {
-      const result = await sandbox.getInfo();
-      return {
-        success: true,
-        sandboxId,
-        provider: sandbox.provider,
-        info: {
-          id: result.id,
-          provider: result.provider,
-          runtime: result.runtime,
-          status: result.status,
-          createdAt: result.createdAt.toISOString(),
-          timeout: result.timeout,
-          metadata: result.metadata
-        }
-      };
-    }
-    if (action === "compute.sandbox.runCode") {
-      if (!body.code) throw new Error("code is required");
-      const result = await sandbox.runCode(body.code, body.runtime);
-      return {
-        success: true,
-        sandboxId,
-        provider: sandbox.provider,
-        result: {
-          output: result.output,
-          exitCode: result.exitCode,
-          language: result.language
-        }
-      };
-    }
-    if (action === "compute.sandbox.runCommand") {
-      if (!body.command) throw new Error("command is required");
-      const result = await sandbox.runCommand(body.command, body.args, body.commandOptions);
-      return {
-        success: true,
-        sandboxId,
-        provider: sandbox.provider,
-        result: {
-          stdout: result.stdout,
-          stderr: result.stderr,
-          exitCode: result.exitCode,
-          durationMs: result.durationMs
-        }
-      };
-    }
-    if (action === "compute.sandbox.filesystem.readFile") {
-      if (!body.path) throw new Error("path is required");
-      const result = await sandbox.filesystem.readFile(body.path);
-      return {
-        success: true,
-        sandboxId,
-        provider: sandbox.provider,
-        fileContent: result
-      };
-    }
-    if (action === "compute.sandbox.filesystem.writeFile") {
-      if (!body.path) throw new Error("path is required");
-      if (body.content === void 0) throw new Error("content is required");
-      await sandbox.filesystem.writeFile(body.path, body.content);
-      return { success: true, sandboxId, provider: sandbox.provider };
-    }
-    if (action === "compute.sandbox.filesystem.mkdir") {
-      if (!body.path) throw new Error("path is required");
-      await sandbox.filesystem.mkdir(body.path);
-      return { success: true, sandboxId, provider: sandbox.provider };
-    }
-    if (action === "compute.sandbox.filesystem.readdir") {
-      if (!body.path) throw new Error("path is required");
-      const result = await sandbox.filesystem.readdir(body.path);
-      return {
-        success: true,
-        sandboxId,
-        provider: sandbox.provider,
-        files: result.map((entry) => ({
-          name: entry.name,
-          path: entry.path,
-          isDirectory: entry.isDirectory,
-          size: entry.size,
-          lastModified: entry.lastModified.toISOString()
-        }))
-      };
-    }
-    if (action === "compute.sandbox.filesystem.exists") {
-      if (!body.path) throw new Error("path is required");
-      const result = await sandbox.filesystem.exists(body.path);
-      return {
-        success: true,
-        sandboxId,
-        provider: sandbox.provider,
-        exists: result
-      };
-    }
-    if (action === "compute.sandbox.filesystem.remove") {
-      if (!body.path) throw new Error("path is required");
-      await sandbox.filesystem.remove(body.path);
-      return { success: true, sandboxId, provider: sandbox.provider };
-    }
-    throw new Error(`Unknown action: ${action}`);
-  } catch (error) {
-    return {
-      success: false,
-      error: error instanceof Error ? error.message : "Unknown error occurred",
-      sandboxId: body.sandboxId || "",
-      provider: "gateway"
-    };
-  }
-}
-async function handleComputeRequest(requestOrBody) {
-  try {
-    let body;
-    if (requestOrBody instanceof Request) {
-      if (requestOrBody.method !== "POST") {
-        return Response.json({
-          success: false,
-          error: "Only POST requests are supported",
-          sandboxId: "",
-          provider: "gateway"
-        }, { status: 405 });
-      }
-      try {
-        body = await requestOrBody.json();
-      } catch (parseError) {
-        return Response.json({
-          success: false,
-          error: "Invalid JSON in request body",
-          sandboxId: "",
-          provider: "gateway"
-        }, { status: 400 });
-      }
-      const result = await executeAction(body);
-      return Response.json(result, {
-        status: result.success ? 200 : 500
-      });
-    } else {
-      body = requestOrBody;
-      return await executeAction(body);
-    }
-  } catch (error) {
-    const errorResponse = {
-      success: false,
-      error: error instanceof Error ? error.message : "Request handling failed",
-      sandboxId: "",
-      provider: "gateway"
-    };
-    if (requestOrBody instanceof Request) {
-      return Response.json(errorResponse, { status: 500 });
-    } else {
-      return errorResponse;
-    }
-  }
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CommandExitError,
@@ -3911,7 +3752,6 @@ async function handleComputeRequest(requestOrBody) {
   getMissingEnvVars,
   getProviderConfigFromEnv,
   getProviderHeaders,
-  handleComputeRequest,
   isCommandExitError,
   isGatewayModeEnabled,
   isProviderAuthComplete,