@cloudflare/sandbox 0.0.0-104f455 → 0.0.0-153e416

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # @cloudflare/sandbox
 
+## 0.4.11
+
+### Patch Changes
+
+- [#159](https://github.com/cloudflare/sandbox-sdk/pull/159) [`e16659a`](https://github.com/cloudflare/sandbox-sdk/commit/e16659a1815923f1cd1176f51a052725d820ee16) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Use latest containers package version
+
+## 0.4.10
+
+### Patch Changes
+
+- [#156](https://github.com/cloudflare/sandbox-sdk/pull/156) [`b61841c`](https://github.com/cloudflare/sandbox-sdk/commit/b61841cfb3248022ee8136311e54955ed9faa1ee) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix WebSocket upgrade requests through exposed ports
+
+## 0.4.9
+
+### Patch Changes
+
+- [#152](https://github.com/cloudflare/sandbox-sdk/pull/152) [`8e7773e`](https://github.com/cloudflare/sandbox-sdk/commit/8e7773ec9571a5f968cbbc5f48e38e01d7d13b77) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Add exists() method to check if a file or directory exists
+
+  This adds a new `exists()` method to the SDK that checks whether a file or directory exists at a given path. The method returns a boolean indicating existence, similar to Python's `os.path.exists()` and JavaScript's `fs.existsSync()`.
+
+  The implementation is end-to-end:
+
+  - New `FileExistsResult` and `FileExistsRequest` types in shared package
+  - Handler endpoint at `/api/exists` in container layer
+  - Client method in `FileClient` and `Sandbox` classes
+  - Full test coverage (unit tests and E2E tests)
+
+## 0.4.8
+
+### Patch Changes
+
+- [#153](https://github.com/cloudflare/sandbox-sdk/pull/153) [`f6a5c3e`](https://github.com/cloudflare/sandbox-sdk/commit/f6a5c3e1607fce5fc26f816e9206ae437898d5af) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix token extraction regex causing Invalid token errors
+
+## 0.4.7
+
+### Patch Changes
+
+- [#141](https://github.com/cloudflare/sandbox-sdk/pull/141) [`c39674b`](https://github.com/cloudflare/sandbox-sdk/commit/c39674b8fe2e986e59a794b6bb3a5f51a87bae89) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix commands hanging when reading stdin by redirecting stdin to /dev/null
+
+- [#143](https://github.com/cloudflare/sandbox-sdk/pull/143) [`276efc0`](https://github.com/cloudflare/sandbox-sdk/commit/276efc0ca8776bcc8de79e7e58dd24d9f418cc5c) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Remove unnecessary existing session check
+
+## 0.4.6
+
+### Patch Changes
+
+- [#133](https://github.com/cloudflare/sandbox-sdk/pull/133) [`da2cfb8`](https://github.com/cloudflare/sandbox-sdk/commit/da2cfb876675eb3445970c90b4d70d00288a7c74) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - feat: Add version sync detection between npm package and Docker image
+
+## 0.4.5
+
+### Patch Changes
+
+- [#127](https://github.com/cloudflare/sandbox-sdk/pull/127) [`e79ac80`](https://github.com/cloudflare/sandbox-sdk/commit/e79ac80bc855a3ec527d44cc14585794b23cb129) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - configurable sleepAfter
+
 ## 0.4.4
 
 ### Patch Changes

package/Dockerfile

@@ -60,9 +60,15 @@ RUN npm ci --production
 # ============================================================================
 FROM ubuntu:22.04 AS runtime
 
+# Accept version as build argument (passed from npm_package_version)
+ARG SANDBOX_VERSION=unknown
+
 # Prevent interactive prompts during package installation
 ENV DEBIAN_FRONTEND=noninteractive
 
+# Set the sandbox version as an environment variable for version checking
+ENV SANDBOX_VERSION=${SANDBOX_VERSION}
+
 # Install essential runtime packages
 RUN apt-get update && apt-get install -y --no-install-recommends \
     curl \

package/dist/chunk-FE4PJSRB.js

@@ -0,0 +1,7 @@
+// src/version.ts
+var SDK_VERSION = "0.4.11";
+
+export {
+  SDK_VERSION
+};
+//# sourceMappingURL=chunk-FE4PJSRB.js.map

package/dist/chunk-FE4PJSRB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/version.ts"],"sourcesContent":["/**\n * SDK version - automatically synchronized with package.json by Changesets\n * This file is auto-updated by .github/changeset-version.ts during releases\n * DO NOT EDIT MANUALLY - Changes will be overwritten on the next version bump\n */\nexport const SDK_VERSION = '0.4.11';\n"],"mappings":";AAKO,IAAM,cAAc;","names":[]}

package/dist/{chunk-2P3MDMNJ.js → chunk-SVWLTRHD.js}

@@ -14,6 +14,12 @@ import {
 import {
   parseSSEStream
 } from "./chunk-EKSWCBCA.js";
+import {
+  SDK_VERSION
+} from "./chunk-FE4PJSRB.js";
+
+// src/request-handler.ts
+import { switchPort } from "@cloudflare/containers";
 
 // src/sandbox.ts
 import { Container, getContainer } from "@cloudflare/containers";
@@ -1057,6 +1063,25 @@ var FileClient = class extends BaseHttpClient {
       throw error;
     }
   }
+  /**
+   * Check if a file or directory exists
+   * @param path - Path to check
+   * @param sessionId - The session ID for this operation
+   */
+  async exists(path, sessionId) {
+    try {
+      const data = {
+        path,
+        sessionId
+      };
+      const response = await this.post("/api/exists", data);
+      this.logSuccess("Path existence checked", `${path} (exists: ${response.exists})`);
+      return response;
+    } catch (error) {
+      this.logError("exists", error);
+      throw error;
+    }
+  }
 };
 
 // src/clients/git-client.ts
@@ -1562,6 +1587,20 @@ var UtilityClient = class extends BaseHttpClient {
       throw error;
     }
   }
+  /**
+   * Get the container version
+   * Returns the version embedded in the Docker image during build
+   */
+  async getVersion() {
+    try {
+      const response = await this.get("/api/version");
+      this.logSuccess("Version retrieved", response.version);
+      return response.version;
+    } catch (error) {
+      this.logger.debug("Failed to get container version (may be old container)", { error });
+      return "unknown";
+    }
+  }
 };
 
 // src/clients/sandbox-client.ts
@@ -1595,12 +1634,15 @@ function getSandbox(ns, id, options) {
   if (options?.baseUrl) {
     stub.setBaseUrl(options.baseUrl);
   }
+  if (options?.sleepAfter !== void 0) {
+    stub.setSleepAfter(options.sleepAfter);
+  }
   return stub;
 }
 var Sandbox = class extends Container {
   defaultPort = 3e3;
   // Default port for the container's Bun server
-  sleepAfter = "3m";
+  sleepAfter = "10m";
   // Sleep the sandbox if no requests are made in this timeframe
   client;
   codeInterpreter;
@@ -1658,6 +1700,10 @@ var Sandbox = class extends Container {
       }
     }
   }
+  // RPC method to set the sleep timeout
+  async setSleepAfter(sleepAfter) {
+    this.sleepAfter = sleepAfter;
+  }
   // RPC method to set environment variables
   async setEnvVars(envVars) {
     this.envVars = { ...this.envVars, ...envVars };
@@ -1681,6 +1727,35 @@ var Sandbox = class extends Container {
   }
   onStart() {
     this.logger.debug("Sandbox started");
+    this.checkVersionCompatibility().catch((error) => {
+      this.logger.error("Version compatibility check failed", error instanceof Error ? error : new Error(String(error)));
+    });
+  }
+  /**
+   * Check if the container version matches the SDK version
+   * Logs a warning if there's a mismatch
+   */
+  async checkVersionCompatibility() {
+    try {
+      const sdkVersion = SDK_VERSION;
+      const containerVersion = await this.client.utils.getVersion();
+      if (containerVersion === "unknown") {
+        this.logger.warn(
+          "Container version check: Container version could not be determined. This may indicate an outdated container image. Please update your container to match SDK version " + sdkVersion
+        );
+        return;
+      }
+      if (containerVersion !== sdkVersion) {
+        const message = `Version mismatch detected! SDK version (${sdkVersion}) does not match container version (${containerVersion}). This may cause compatibility issues. Please update your container image to version ${sdkVersion}`;
+        this.logger.warn(message);
+      } else {
+        this.logger.debug("Version check passed", { sdkVersion, containerVersion });
+      }
+    } catch (error) {
+      this.logger.debug("Version compatibility check encountered an error", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
   }
   onStop() {
     this.logger.debug("Sandbox stopped");
@@ -1699,6 +1774,11 @@ var Sandbox = class extends Container {
         this.sandboxName = name;
         await this.ctx.storage.put("sandboxName", name);
       }
+      const upgradeHeader = request.headers.get("Upgrade");
+      const isWebSocket = upgradeHeader?.toLowerCase() === "websocket";
+      if (isWebSocket) {
+        return await super.fetch(request);
+      }
       const port = this.determinePort(url);
       return await this.containerFetch(request, port);
     });
@@ -1731,7 +1811,7 @@ var Sandbox = class extends Container {
         await this.ctx.storage.put("defaultSession", sessionId);
         this.logger.debug("Default session initialized", { sessionId });
       } catch (error) {
-        if (error?.message?.includes("already exists") || error?.message?.includes("Session")) {
+        if (error?.message?.includes("already exists")) {
           this.logger.debug("Reusing existing session after reload", { sessionId });
           this.defaultSession = sessionId;
           await this.ctx.storage.put("defaultSession", sessionId);
@@ -2013,6 +2093,10 @@ var Sandbox = class extends Container {
     const session = await this.ensureDefaultSession();
     return this.client.files.listFiles(path, session, options);
   }
+  async exists(path, sessionId) {
+    const session = sessionId ?? await this.ensureDefaultSession();
+    return this.client.files.exists(path, session);
+  }
   async exposePort(port, options) {
     if (options.hostname.endsWith(".workers.dev")) {
       const errorResponse = {
@@ -2188,6 +2272,7 @@ var Sandbox = class extends Container {
       renameFile: (oldPath, newPath) => this.renameFile(oldPath, newPath, sessionId),
       moveFile: (sourcePath, destPath) => this.moveFile(sourcePath, destPath, sessionId),
       listFiles: (path, options) => this.client.files.listFiles(path, sessionId, options),
+      exists: (path) => this.exists(path, sessionId),
       // Git operations
       gitCheckout: (repoUrl, options) => this.gitCheckout(repoUrl, { ...options, sessionId }),
       // Environment management - needs special handling
@@ -2280,6 +2365,10 @@ async function proxyToSandbox(request, env) {
         );
       }
     }
+    const upgradeHeader = request.headers.get("Upgrade");
+    if (upgradeHeader?.toLowerCase() === "websocket") {
+      return await sandbox.fetch(switchPort(request, port));
+    }
     let proxyUrl;
     if (port !== 3e3) {
       proxyUrl = `http://localhost:${port}${path}${url.search}`;
@@ -2300,14 +2389,14 @@ async function proxyToSandbox(request, env) {
       // @ts-expect-error - duplex required for body streaming in modern runtimes
       duplex: "half"
     });
-    return sandbox.containerFetch(proxyRequest, port);
+    return await sandbox.containerFetch(proxyRequest, port);
   } catch (error) {
     logger.error("Proxy routing error", error instanceof Error ? error : new Error(String(error)));
     return new Response("Proxy routing error", { status: 500 });
   }
 }
 function extractSandboxRoute(url) {
-  const subdomainMatch = url.hostname.match(/^(\d{4,5})-([^.-][^.]*[^.-]|[^.-])-([a-zA-Z0-9_-]{12,20})\.(.+)$/);
+  const subdomainMatch = url.hostname.match(/^(\d{4,5})-([^.-][^.]*?[^.-]|[^.-])-([a-z0-9_-]{16})\.(.+)$/);
   if (!subdomainMatch) {
     return null;
   }
@@ -2364,4 +2453,4 @@ export {
   getSandbox,
   Sandbox
 };
-//# sourceMappingURL=chunk-2P3MDMNJ.js.map
+//# sourceMappingURL=chunk-SVWLTRHD.js.map