@cloudflare/sandbox 0.0.0-1a42464 → 0.0.0-1ab3f9d

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @cloudflare/sandbox
 
+## 0.1.4
+
+### Patch Changes
+
+- [#46](https://github.com/cloudflare/sandbox-sdk/pull/46) [`7de28be`](https://github.com/cloudflare/sandbox-sdk/commit/7de28be482d9634551572d548c7c4b5842df812d) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Update README
+
+- [#44](https://github.com/cloudflare/sandbox-sdk/pull/44) [`215ab49`](https://github.com/cloudflare/sandbox-sdk/commit/215ab494427d7e2a92bb9a25384cb493a221c200) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Update example to use env & cwd
+
+- [#42](https://github.com/cloudflare/sandbox-sdk/pull/42) [`bb72193`](https://github.com/cloudflare/sandbox-sdk/commit/bb72193ad75695979bd1132206f481e91fe37325) Thanks [@jonasnobile](https://github.com/jonasnobile)! - Propagate `cwd` and `env` options in `executeCommand`
+
+- [#27](https://github.com/cloudflare/sandbox-sdk/pull/27) [`fd5ec7f`](https://github.com/cloudflare/sandbox-sdk/commit/fd5ec7f34bc12b06320a89356c4af07801f52d64) Thanks [@threepointone](https://github.com/threepointone)! - remove yarn and pnpm from the image
+
+## 0.1.3
+
+### Patch Changes
+
+- [#32](https://github.com/cloudflare/sandbox-sdk/pull/32) [`1a42464`](https://github.com/cloudflare/sandbox-sdk/commit/1a4246479369c5d0160705caf192aa1816540d52) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Bring back package README
+
 ## 0.1.2
 
 ### Patch Changes

package/Dockerfile

@@ -55,8 +55,6 @@ RUN apt-get update && apt-get install -y ca-certificates curl gnupg \
 COPY --from=bun-source /usr/local/bin/bun /usr/local/bin/bun
 COPY --from=bun-source /usr/local/bin/bunx /usr/local/bin/bunx
 
-# Install global npm packages as root
-RUN npm install -g yarn pnpm
 
 # Set up working directory
 WORKDIR /app
@@ -65,9 +63,8 @@ WORKDIR /app
 RUN python3 --version && \
     node --version && \
     npm --version && \
-    bun --version && \
-    yarn --version && \
-    pnpm --version
+    bun --version
+    
 
 # Copy container source files
 COPY container_src/ ./

package/README.md

@@ -64,12 +64,10 @@ npm install @cloudflare/sandbox
 1. **Create a Dockerfile** (temporary requirement, will be removed in future releases):
 
 ```dockerfile
-FROM docker.io/cloudflare/sandbox:0.1.2
+FROM docker.io/cloudflare/sandbox:0.1.4
 
+# Expose the ports you want to expose
 EXPOSE 3000
-
-# Run the same command as the original image
-CMD ["bun", "index.ts"]
 ```
 
 2. **Configure wrangler.json**:
@@ -284,7 +282,7 @@ The SDK handles:
 
 ```dockerfile
 # In your Dockerfile (only needed for local dev)
-FROM oven/bun:latest
+FROM docker.io/cloudflare/sandbox:0.1.3
 
 # Expose the ports you'll be using
 EXPOSE 3000  # For a web server

package/container_src/handler/exec.ts

@@ -1,11 +1,10 @@
 import { type SpawnOptions, spawn } from "node:child_process";
-import type { ExecuteRequest, SessionData } from "../types";
+import type { ExecuteOptions, ExecuteRequest, SessionData } from "../types";
 
 function executeCommand(
   sessions: Map<string, SessionData>,
   command: string,
-  sessionId?: string,
-  background?: boolean
+  options: ExecuteOptions,
 ): Promise<{
   success: boolean;
   stdout: string;
@@ -16,14 +15,16 @@ function executeCommand(
     const spawnOptions: SpawnOptions = {
       shell: true,
       stdio: ["pipe", "pipe", "pipe"] as const,
-      detached: background || false,
+      detached: options.background || false,
+      cwd: options.cwd,
+      env: options.env ? { ...process.env, ...options.env } : process.env
     };
 
     const child = spawn(command, spawnOptions);
 
     // Store the process reference for cleanup if sessionId is provided
-    if (sessionId && sessions.has(sessionId)) {
-      const session = sessions.get(sessionId)!;
+    if (options.sessionId && sessions.has(options.sessionId)) {
+      const session = sessions.get(options.sessionId)!;
       session.activeProcess = child;
     }
 
@@ -38,7 +39,7 @@ function executeCommand(
       stderr += data.toString();
     });
 
-    if (background) {
+    if (options.background) {
       // For background processes, unref and return quickly
       child.unref();
 
@@ -61,8 +62,8 @@ function executeCommand(
       // Normal synchronous execution
       child.on("close", (code) => {
         // Clear the active process reference
-        if (sessionId && sessions.has(sessionId)) {
-          const session = sessions.get(sessionId)!;
+        if (options.sessionId && sessions.has(options.sessionId)) {
+          const session = sessions.get(options.sessionId)!;
           session.activeProcess = null;
         }
 
@@ -78,8 +79,8 @@ function executeCommand(
 
       child.on("error", (error) => {
         // Clear the active process reference
-        if (sessionId && sessions.has(sessionId)) {
-          const session = sessions.get(sessionId)!;
+        if (options.sessionId && sessions.has(options.sessionId)) {
+          const session = sessions.get(options.sessionId)!;
           session.activeProcess = null;
         }
 
@@ -96,7 +97,7 @@ export async function handleExecuteRequest(
 ): Promise<Response> {
   try {
     const body = (await req.json()) as ExecuteRequest;
-    const { command, sessionId, background } = body;
+    const { command, sessionId, background, cwd, env } = body;
 
     if (!command || typeof command !== "string") {
       return new Response(
@@ -115,7 +116,7 @@ export async function handleExecuteRequest(
 
     console.log(`[Server] Executing command: ${command}`);
 
-    const result = await executeCommand(sessions, command, sessionId, background);
+    const result = await executeCommand(sessions, command, { sessionId, background, cwd, env });
 
     return new Response(
       JSON.stringify({

package/container_src/types.ts

@@ -38,10 +38,15 @@ export interface StartProcessRequest {
   };
 }
 
-export interface ExecuteRequest {
-  command: string;
-  sessionId?: string;
+export interface ExecuteOptions {
+  sessionId?: string | null;
   background?: boolean;
+  cwd?: string | URL;
+  env?: Record<string, string>;
+}
+
+export interface ExecuteRequest extends ExecuteOptions {
+  command: string;
 }
 
 export interface GitCheckoutRequest {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudflare/sandbox",
-  "version": "0.0.0-1a42464",
+  "version": "0.0.0-1ab3f9d",
   "repository": {
     "type": "git",
     "url": "https://github.com/cloudflare/sandbox-sdk"

package/src/client.ts

@@ -1,5 +1,7 @@
+import type { ExecuteRequest } from "../container_src/types";
 import type { Sandbox } from "./index";
 import type {
+  BaseExecOptions,
   GetProcessLogsResponse,
   GetProcessResponse,
   ListProcessesResponse,
@@ -7,11 +9,6 @@ import type {
   StartProcessResponse
 } from "./types";
 
-interface ExecuteRequest {
-  command: string;
-  sessionId?: string;
-}
-
 export interface ExecuteResponse {
   success: boolean;
   stdout: string;
@@ -255,16 +252,19 @@ export class HttpClient {
 
   async execute(
     command: string,
-    sessionId?: string
+    options: Pick<BaseExecOptions, 'sessionId' | 'cwd' | 'env'>
   ): Promise<ExecuteResponse> {
     try {
-      const targetSessionId = sessionId || this.sessionId;
+      const targetSessionId = options.sessionId || this.sessionId;
+      const executeRequest = {
+        command,
+        sessionId: targetSessionId,
+        cwd: options.cwd,
+        env: options.env,
+      } satisfies ExecuteRequest;
 
       const response = await this.doFetch(`/api/execute`, {
-        body: JSON.stringify({
-          command,
-          sessionId: targetSessionId,
-        } as ExecuteRequest),
+        body: JSON.stringify(executeRequest),
         headers: {
           "Content-Type": "application/json",
         },

package/src/sandbox.ts

@@ -150,7 +150,11 @@ export class Sandbox<Env = unknown> extends Container<Env> implements ISandbox {
         // Regular execution
         const response = await this.client.execute(
           command,
-          options?.sessionId
+          {
+            sessionId: options?.sessionId,
+            cwd: options?.cwd,
+            env: options?.env,
+          }
         );
 
         const duration = Date.now() - startTime;