computesdk 2.1.1 → 2.1.2

package/dist/index.d.mts

@@ -3700,6 +3700,7 @@ declare class Sandbox {
      * @param options.env - Environment variables (server uses cmd.Env)
      * @param options.onStdout - Callback for streaming stdout data
      * @param options.onStderr - Callback for streaming stderr data
+     * @param options.timeout - Timeout in seconds (max 300 for long-running commands)
      * @returns Command execution result
      *
      * @example
@@ -3721,6 +3722,9 @@ declare class Sandbox {
      *   onStdout: (data) => console.log(data),
      *   onStderr: (data) => console.error(data),
      * })
+     *
+     * // With timeout for long-running commands
+     * await sandbox.runCommand('npm install', { timeout: 120 })
      * ```
      */
     runCommand(command: string, options?: {
@@ -3729,6 +3733,8 @@ declare class Sandbox {
         env?: Record<string, string>;
         onStdout?: (data: string) => void;
         onStderr?: (data: string) => void;
+        /** Timeout in seconds (max 300 for long-running commands) */
+        timeout?: number;
     }): Promise<{
         stdout: string;
         stderr: string;

package/dist/index.d.ts

@@ -3700,6 +3700,7 @@ declare class Sandbox {
      * @param options.env - Environment variables (server uses cmd.Env)
      * @param options.onStdout - Callback for streaming stdout data
      * @param options.onStderr - Callback for streaming stderr data
+     * @param options.timeout - Timeout in seconds (max 300 for long-running commands)
      * @returns Command execution result
      *
      * @example
@@ -3721,6 +3722,9 @@ declare class Sandbox {
      *   onStdout: (data) => console.log(data),
      *   onStderr: (data) => console.error(data),
      * })
+     *
+     * // With timeout for long-running commands
+     * await sandbox.runCommand('npm install', { timeout: 120 })
      * ```
      */
     runCommand(command: string, options?: {
@@ -3729,6 +3733,8 @@ declare class Sandbox {
         env?: Record<string, string>;
         onStdout?: (data: string) => void;
         onStderr?: (data: string) => void;
+        /** Timeout in seconds (max 300 for long-running commands) */
+        timeout?: number;
     }): Promise<{
         stdout: string;
         stderr: string;

package/dist/index.js

@@ -2364,7 +2364,9 @@ var Sandbox = class {
     terminal.setWaitCommandHandler(async (cmdId, timeout) => {
       const params = timeout ? new URLSearchParams({ timeout: timeout.toString() }) : "";
       const endpoint = `/terminals/${terminalId}/commands/${cmdId}/wait${params ? `?${params}` : ""}`;
-      return this.request(endpoint);
+      return this.request(endpoint, {
+        headers: timeout ? { "X-Request-Timeout": timeout.toString() } : void 0
+      });
     });
     terminal.setDestroyHandler(async () => {
       await this.request(`/terminals/${terminalId}`, {
@@ -2380,6 +2382,11 @@ var Sandbox = class {
   async request(endpoint, options = {}) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    if (process.env.COMPUTESDK_DEBUG) {
+      console.log(`[ComputeSDK] Request: ${options.method || "GET"} ${this.config.sandboxUrl}${endpoint}`);
+      console.log(`[ComputeSDK]   Sandbox ID: ${this.config.sandboxId}`);
+      console.log(`[ComputeSDK]   Token: ${this._token || "(no token)"}`);
+    }
     try {
       const headers = {
         ...this.config.headers
@@ -2422,6 +2429,15 @@ API request failed (${response.status}): ${error}`
             );
           }
         }
+        if (response.status === 403 && process.env.COMPUTESDK_DEBUG) {
+          console.error(`[ComputeSDK] 403 Forbidden Debug Info:`);
+          console.error(`  Endpoint: ${endpoint}`);
+          console.error(`  Method: ${options.method || "GET"}`);
+          console.error(`  Sandbox URL: ${this.config.sandboxUrl}`);
+          console.error(`  Sandbox ID: ${this.config.sandboxId}`);
+          console.error(`  Token: ${this._token || "(no token)"}`);
+          console.error(`  Error: ${error}`);
+        }
         throw new Error(`API request failed (${response.status}): ${error}`);
       }
       return data;
@@ -2941,7 +2957,9 @@ API request failed (${response.status}): ${error}`
   async waitForCommand(terminalId, cmdId, timeout) {
     const params = timeout ? new URLSearchParams({ timeout: timeout.toString() }) : "";
     const endpoint = `/terminals/${terminalId}/commands/${cmdId}/wait${params ? `?${params}` : ""}`;
-    return this.request(endpoint);
+    return this.request(endpoint, {
+      headers: timeout ? { "X-Request-Timeout": timeout.toString() } : void 0
+    });
   }
   /**
    * Wait for a background command to complete using long-polling
@@ -3392,6 +3410,7 @@ API request failed (${response.status}): ${error}`
    * @param options.env - Environment variables (server uses cmd.Env)
    * @param options.onStdout - Callback for streaming stdout data
    * @param options.onStderr - Callback for streaming stderr data
+   * @param options.timeout - Timeout in seconds (max 300 for long-running commands)
    * @returns Command execution result
    * 
    * @example
@@ -3413,11 +3432,21 @@ API request failed (${response.status}): ${error}`
    *   onStdout: (data) => console.log(data),
    *   onStderr: (data) => console.error(data),
    * })
+   * 
+   * // With timeout for long-running commands
+   * await sandbox.runCommand('npm install', { timeout: 120 })
    * ```
    */
   async runCommand(command, options) {
     const hasStreamingCallbacks = options?.onStdout || options?.onStderr;
     if (!hasStreamingCallbacks) {
+      if (options?.timeout && !options?.background) {
+        return this.run.command(command, {
+          ...options,
+          background: true,
+          waitForCompletion: { timeoutSeconds: options.timeout }
+        });
+      }
       return this.run.command(command, options);
     }
     const ws = await this.ensureWebSocket();
@@ -3475,9 +3504,20 @@ API request failed (${response.status}): ${error}`
         durationMs: 0
       };
     }
-    return new Promise((resolve) => {
+    const commandPromise = new Promise((resolve) => {
       resolvePromise = resolve;
     });
+    if (options?.timeout) {
+      const timeoutMs = options.timeout * 1e3;
+      const timeoutPromise = new Promise((_, reject) => {
+        setTimeout(() => {
+          cleanup();
+          reject(new Error(`Command timed out after ${options.timeout} seconds`));
+        }, timeoutMs);
+      });
+      return Promise.race([commandPromise, timeoutPromise]);
+    }
+    return commandPromise;
   }
   /**
    * Get server information
@@ -4079,7 +4119,7 @@ Get your API key at: https://computesdk.com/dashboard`
   const providerHeaders = buildProviderHeaders2(config);
   return {
     apiKey: computesdkApiKey,
-    gatewayUrl: config.gatewayUrl || GATEWAY_URL,
+    gatewayUrl: config.gatewayUrl || process.env.COMPUTESDK_GATEWAY_URL || GATEWAY_URL,
     provider: config.provider,
     providerHeaders,
     requestTimeoutMs: config.requestTimeoutMs,