computesdk 2.0.2 → 2.1.2

package/dist/index.mjs

@@ -2309,7 +2309,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}`, {
@@ -2325,6 +2327,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
@@ -2367,6 +2374,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;
@@ -2886,7 +2902,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
@@ -3253,6 +3271,7 @@ API request failed (${response.status}): ${error}`
     const response = await this.request("/ready");
     return {
       ready: response.ready,
+      healthy: response.healthy,
       servers: response.servers ?? [],
       overlays: response.overlays ?? []
     };
@@ -3336,6 +3355,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
@@ -3357,11 +3377,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();
@@ -3419,9 +3449,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
@@ -3551,7 +3592,8 @@ var PROVIDER_AUTH = {
   cloudflare: [["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"]],
   codesandbox: [["CSB_API_KEY"]],
   blaxel: [["BL_API_KEY", "BL_WORKSPACE"]],
-  namespace: [["NSC_TOKEN"]]
+  namespace: [["NSC_TOKEN"]],
+  hopx: [["HOPX_API_KEY"]]
 };
 var PROVIDER_NAMES = Object.keys(PROVIDER_AUTH);
 var PROVIDER_HEADERS = {
@@ -3588,7 +3630,7 @@ var PROVIDER_HEADERS = {
     accountId: "X-Cloudflare-Account-Id"
   },
   codesandbox: {
-    apiKey: "X-CSB-API-Key"
+    apiKey: "X-CODESANDBOX-API-Key"
   },
   blaxel: {
     apiKey: "X-Blaxel-API-Key",
@@ -3596,6 +3638,9 @@ var PROVIDER_HEADERS = {
   },
   namespace: {
     token: "X-Namespace-Token"
+  },
+  hopx: {
+    apiKey: "X-HOPX-API-Key"
   }
 };
 var PROVIDER_ENV_MAP = {
@@ -3640,6 +3685,9 @@ var PROVIDER_ENV_MAP = {
   },
   namespace: {
     NSC_TOKEN: "token"
+  },
+  hopx: {
+    HOPX_API_KEY: "apiKey"
   }
 };
 var PROVIDER_DASHBOARD_URLS = {
@@ -3653,7 +3701,8 @@ var PROVIDER_DASHBOARD_URLS = {
   cloudflare: "https://dash.cloudflare.com/profile/api-tokens",
   codesandbox: "https://codesandbox.io/dashboard/settings",
   blaxel: "https://blaxel.ai/dashboard",
-  namespace: "https://cloud.namespace.so"
+  namespace: "https://cloud.namespace.so",
+  hopx: "https://hopx.ai/dashboard"
 };
 function isValidProvider(name) {
   return name in PROVIDER_AUTH;
@@ -3722,7 +3771,8 @@ var PROVIDER_PRIORITY = [
   "cloudflare",
   "codesandbox",
   "blaxel",
-  "namespace"
+  "namespace",
+  "hopx"
 ];
 var PROVIDER_ENV_VARS = {
   e2b: ["E2B_API_KEY"],
@@ -3735,7 +3785,8 @@ var PROVIDER_ENV_VARS = {
   cloudflare: ["CLOUDFLARE_API_TOKEN", "CLOUDFLARE_ACCOUNT_ID"],
   codesandbox: ["CSB_API_KEY"],
   blaxel: ["BL_API_KEY", "BL_WORKSPACE"],
-  namespace: ["NSC_TOKEN"]
+  namespace: ["NSC_TOKEN"],
+  hopx: ["HOPX_API_KEY"]
 };
 
 // src/auto-detect.ts
@@ -3857,6 +3908,11 @@ function getProviderHeaders(provider) {
         headers["X-Namespace-Token"] = process.env.NSC_TOKEN;
       }
       break;
+    case "hopx":
+      if (process.env.HOPX_API_KEY) {
+        headers["X-HOPX-API-Key"] = process.env.HOPX_API_KEY;
+      }
+      break;
   }
   return headers;
 }
@@ -3894,6 +3950,7 @@ To fix this, set one of the following:
   CodeSandbox: export CSB_API_KEY=xxx
   Blaxel:     export BL_API_KEY=xxx BL_WORKSPACE=xxx
   Namespace:  export NSC_TOKEN=xxx
+  HopX:       export HOPX_API_KEY=xxx
 
 Or set COMPUTESDK_PROVIDER to specify explicitly:
   export COMPUTESDK_PROVIDER=e2b
@@ -4007,7 +4064,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,