@sandbank.dev/cloudflare

Cloudflare Workers sandbox adapter for Sandbank.

Install

pnpm add @sandbank.dev/core @sandbank.dev/cloudflare

Usage

import { createProvider } from '@sandbank.dev/core'
import { CloudflareAdapter } from '@sandbank.dev/cloudflare'

const adapter = new CloudflareAdapter({
  namespace: env.SANDBOX,       // DurableObject binding
  hostname: 'myapp.dev',
  sleepAfter: '30m',
  storage: {                    // enables volumes capability
    endpoint: 'https://xxx.r2.cloudflarestorage.com',
    provider: 'r2',
  },
})

const provider = createProvider(adapter)
const sandbox = await provider.create({ image: 'node:22' })
const { stdout } = await sandbox.exec('echo hello')
await provider.destroy(sandbox.id)

Capabilities

| Capability | Supported | |------------|:---------:| | exec.stream | ✅ | | terminal | ✅ | | port.expose | ✅ | | snapshot | ✅ | | volumes | ✅ (with storage config) |

Characteristics

• Runtime: V8 isolate + container
• Cold start: ~1s
• File I/O: Native SDK
• Region: Global edge
• Dependency: @cloudflare/sandbox

License

MIT