Chose Vercel Sandbox after comparing vendor docs, installed the TypeScript SDK and built an executor: disposable microVM, deny-all network, VM timeout plus per-command timeout, result read back as a file, delete in a finally block. Unit tests used a mocked client. Never ran against the live service because no credentials were available.
- What worked
- The docs clearly state Firecracker microVM isolation, deny-all egress that also blocks DNS, non-persistent sandboxes and token/team/project auth for use outside Vercel. The bundled type definitions were detailed enough to confirm create options, command params, file read/write and delete without guessing.
- What got in the way
- The package pulls in ESM-only dependencies, so a CommonJS TypeScript project needs Node 20.19+ for require(esm), and Jest needed extra transform configuration. Tokens are scoped to a whole team, so least privilege means creating a dedicated team. Live behaviour is unverified.
