Sandbox

import { getSandbox, Sandbox } from '@cloudflare/sandbox';

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const sandbox = getSandbox(env.Sandbox, 'my-sandbox-id');
    
    // Execute a command
    const result = await sandbox.exec('ls -la');
    
    return new Response(result.stdout);
  }
};

const result = await sandbox.exec('npm install', {
  cwd: '/workspace',
  timeout: 30000
});

console.log(result.stdout);

const stream = await sandbox.execStream('npm run build');

for await (const event of parseSSEStream(stream)) {
  if (event.type === 'stdout') {
    console.log(event.data);
  }
}

const proc = await sandbox.startProcess('npm run dev', {
  onOutput: (stream, data) => console.log(`[${stream}]`, data)
});

// Wait for server to be ready
await proc.waitForPort(3000);

const processes = await sandbox.listProcesses();
for (const proc of processes) {
  console.log(`${proc.id}: ${proc.status}`);
}

const proc = await sandbox.getProcess('my-process-id');
if (proc) {
  console.log(proc.status);
}

await sandbox.killProcess('my-process-id', 'SIGTERM');

const count = await sandbox.killAllProcesses();
console.log(`Killed ${count} processes`);

const count = await sandbox.cleanupCompletedProcesses();
console.log(`Cleaned up ${count} processes`);

const logs = await sandbox.getProcessLogs('my-process-id');
console.log(logs.stdout);

const stream = await sandbox.streamProcessLogs('my-process-id');

for await (const event of parseSSEStream(stream)) {
  if (event.type === 'stdout') {
    console.log(event.data);
  }
}

await sandbox.writeFile('/workspace/config.json', 
  JSON.stringify({ setting: 'value' })
);

const result = await sandbox.readFile('/workspace/config.json');
console.log(result.content);

import { streamFile } from '@cloudflare/sandbox';

const stream = await sandbox.readFileStream('/workspace/large-file.bin');
const { metadata, data } = await streamFile(stream);

console.log(`Size: ${metadata.size}, Type: ${metadata.mimeType}`);

await sandbox.mkdir('/workspace/data', { recursive: true });

await sandbox.deleteFile('/workspace/temp.txt');

await sandbox.renameFile('/workspace/old.txt', '/workspace/new.txt');

await sandbox.moveFile('/workspace/file.txt', '/workspace/subdir/file.txt');

const result = await sandbox.listFiles('/workspace', { 
  recursive: true,
  includeHidden: false 
});

for (const file of result.files) {
  console.log(`${file.name} (${file.size} bytes)`);
}

const result = await sandbox.exists('/workspace/config.json');
if (result.exists) {
  console.log('File exists');
}

await sandbox.gitCheckout('https://github.com/user/repo', {
  branch: 'main',
  targetDir: '/workspace/repo',
  depth: 1  // Shallow clone
});

await sandbox.setEnvVars({
  API_KEY: 'secret-key',
  DEBUG: 'true',
  OLD_VAR: undefined  // Unset this variable
});

const session = await sandbox.createSession({
  id: 'build-session',
  env: { NODE_ENV: 'production' },
  cwd: '/workspace/app'
});

// Use session methods
await session.exec('npm run build');

await sandbox.deleteSession('build-session');

const result = await sandbox.runCode(`
import pandas as pd
df = pd.DataFrame({'a': [1, 2, 3]})
df.describe()
`, { language: 'python' });

console.log(result.results);

const ctx = await sandbox.createCodeContext({ 
  language: 'python',
  cwd: '/workspace' 
});

await sandbox.runCode('x = 42', { contextId: ctx.id });
await sandbox.runCode('print(x)', { contextId: ctx.id });  // Uses same context

const contexts = await sandbox.listCodeContexts();
for (const ctx of contexts) {
  console.log(`${ctx.id}: ${ctx.language}`);
}

await sandbox.deleteCodeContext('ctx-id');

await sandbox.mountBucket('my-bucket', '/workspace/data', {
  endpoint: 'https://abc123.r2.cloudflarestorage.com',
  provider: 'r2',
  credentials: {
    accessKeyId: env.R2_ACCESS_KEY_ID,
    secretAccessKey: env.R2_SECRET_ACCESS_KEY
  },
  prefix: '/user-data/',
  readOnly: true
});

await sandbox.unmountBucket('/workspace/data');

const backup = await sandbox.createBackup({
  dir: '/workspace',
  name: 'project-backup',
  ttl: 604800  // 7 days
});

// Store backup handle for later restore
console.log(backup.id);

const result = await sandbox.restoreBackup(backup);
if (result.success) {
  console.log(`Restored ${result.dir}`);
}

await sandbox.destroy();

const response = await sandbox.wsConnect(request, 8080);
return response;

await sandbox.setContainerTimeouts({
  instanceGetTimeoutMS: 15000,
  portReadyTimeoutMS: 30000,
  waitIntervalMS: 500
});