@cloudflare/sandbox 0.0.0-7bccc85 → 0.0.0-7edbfa9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/CHANGELOG.md +308 -0
  2. package/Dockerfile +142 -9
  3. package/README.md +147 -49
  4. package/dist/index.d.ts +1907 -0
  5. package/dist/index.d.ts.map +1 -0
  6. package/dist/index.js +3159 -0
  7. package/dist/index.js.map +1 -0
  8. package/package.json +16 -10
  9. package/src/clients/base-client.ts +295 -0
  10. package/src/clients/command-client.ts +115 -0
  11. package/src/clients/file-client.ts +300 -0
  12. package/src/clients/git-client.ts +91 -0
  13. package/src/clients/index.ts +60 -0
  14. package/src/clients/interpreter-client.ts +333 -0
  15. package/src/clients/port-client.ts +105 -0
  16. package/src/clients/process-client.ts +180 -0
  17. package/src/clients/sandbox-client.ts +39 -0
  18. package/src/clients/types.ts +88 -0
  19. package/src/clients/utility-client.ts +123 -0
  20. package/src/errors/adapter.ts +238 -0
  21. package/src/errors/classes.ts +594 -0
  22. package/src/errors/index.ts +109 -0
  23. package/src/file-stream.ts +169 -0
  24. package/src/index.ts +91 -120
  25. package/src/interpreter.ts +168 -0
  26. package/src/request-handler.ts +183 -0
  27. package/src/sandbox.ts +1247 -0
  28. package/src/security.ts +119 -0
  29. package/src/sse-parser.ts +144 -0
  30. package/src/version.ts +6 -0
  31. package/startup.sh +3 -0
  32. package/tests/base-client.test.ts +364 -0
  33. package/tests/command-client.test.ts +444 -0
  34. package/tests/file-client.test.ts +831 -0
  35. package/tests/file-stream.test.ts +310 -0
  36. package/tests/get-sandbox.test.ts +149 -0
  37. package/tests/git-client.test.ts +415 -0
  38. package/tests/port-client.test.ts +293 -0
  39. package/tests/process-client.test.ts +683 -0
  40. package/tests/request-handler.test.ts +292 -0
  41. package/tests/sandbox.test.ts +702 -0
  42. package/tests/sse-parser.test.ts +291 -0
  43. package/tests/utility-client.test.ts +339 -0
  44. package/tests/version.test.ts +16 -0
  45. package/tests/wrangler.jsonc +35 -0
  46. package/tsconfig.json +9 -1
  47. package/tsdown.config.ts +12 -0
  48. package/vitest.config.ts +31 -0
  49. package/container_src/index.ts +0 -2900
  50. package/container_src/package.json +0 -9
  51. package/src/client.ts +0 -1929
  52. package/tests/client.example.ts +0 -308
  53. package/tests/connection-test.ts +0 -81
  54. package/tests/simple-test.ts +0 -81
  55. package/tests/test1.ts +0 -281
  56. package/tests/test2.ts +0 -929
package/CHANGELOG.md CHANGED
@@ -1,5 +1,313 @@
1
1
  # @cloudflare/sandbox
2
2
 
3
+ ## 0.4.13
4
+
5
+ ### Patch Changes
6
+
7
+ - [#168](https://github.com/cloudflare/sandbox-sdk/pull/168) [`6b08f02`](https://github.com/cloudflare/sandbox-sdk/commit/6b08f02c061aef07cc98188abef2973ac92365f8) Thanks [@threepointone](https://github.com/threepointone)! - Fix type generation
8
+
9
+ We inline types from `@repo/shared` so that it includes the types we reexport. Fixes #165
10
+
11
+ - [#162](https://github.com/cloudflare/sandbox-sdk/pull/162) [`c4db459`](https://github.com/cloudflare/sandbox-sdk/commit/c4db459389a7b86048a03410d67d4dd7bf4a6085) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - Add WebSocket support via connect() method for routing client WebSocket connections directly to container services
12
+
13
+ ## 0.4.12
14
+
15
+ ### Patch Changes
16
+
17
+ - [#137](https://github.com/cloudflare/sandbox-sdk/pull/137) [`7f4442b`](https://github.com/cloudflare/sandbox-sdk/commit/7f4442b7a097587d8f8e8f9ff2f887df6943a3db) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - add keepAlive flag to prevent containers from shutting down
18
+
19
+ ## 0.4.11
20
+
21
+ ### Patch Changes
22
+
23
+ - [#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
24
+
25
+ ## 0.4.10
26
+
27
+ ### Patch Changes
28
+
29
+ - [#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
30
+
31
+ ## 0.4.9
32
+
33
+ ### Patch Changes
34
+
35
+ - [#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
36
+
37
+ 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()`.
38
+
39
+ The implementation is end-to-end:
40
+
41
+ - New `FileExistsResult` and `FileExistsRequest` types in shared package
42
+ - Handler endpoint at `/api/exists` in container layer
43
+ - Client method in `FileClient` and `Sandbox` classes
44
+ - Full test coverage (unit tests and E2E tests)
45
+
46
+ ## 0.4.8
47
+
48
+ ### Patch Changes
49
+
50
+ - [#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
51
+
52
+ ## 0.4.7
53
+
54
+ ### Patch Changes
55
+
56
+ - [#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
57
+
58
+ - [#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
59
+
60
+ ## 0.4.6
61
+
62
+ ### Patch Changes
63
+
64
+ - [#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
65
+
66
+ ## 0.4.5
67
+
68
+ ### Patch Changes
69
+
70
+ - [#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
71
+
72
+ ## 0.4.4
73
+
74
+ ### Patch Changes
75
+
76
+ - [#125](https://github.com/cloudflare/sandbox-sdk/pull/125) [`fddccfd`](https://github.com/cloudflare/sandbox-sdk/commit/fddccfdce8204ce2aa7dadc0ad9fb2acbdeaec51) Thanks [@whoiskatrin](https://github.com/whoiskatrin)! - add docker image to pkg workflow
77
+
78
+ ## 0.4.3
79
+
80
+ ### Patch Changes
81
+
82
+ - [#114](https://github.com/cloudflare/sandbox-sdk/pull/114) [`8c1f440`](https://github.com/cloudflare/sandbox-sdk/commit/8c1f440ad6fd89a5c69f9ca9d055ad9b183dd1c3) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Debloat base docker image (2.63GB → 1.03GB)
83
+
84
+ ## 0.4.2
85
+
86
+ ### Patch Changes
87
+
88
+ - [`e53d7e7`](https://github.com/cloudflare/sandbox-sdk/commit/e53d7e7ce185f79bdd899029bb532e9651ae7ba5) Thanks [@threepointone](https://github.com/threepointone)! - fix build by inlining repo/shared
89
+
90
+ ## 0.4.1
91
+
92
+ ### Patch Changes
93
+
94
+ - [#111](https://github.com/cloudflare/sandbox-sdk/pull/111) [`1b5496b`](https://github.com/cloudflare/sandbox-sdk/commit/1b5496bfceaee53c31911b409476ea87bebffe4c) Thanks [@threepointone](https://github.com/threepointone)! - trigger a release
95
+
96
+ ## 0.4.0
97
+
98
+ ### Minor Changes
99
+
100
+ - [#95](https://github.com/cloudflare/sandbox-sdk/pull/95) [`7aee736`](https://github.com/cloudflare/sandbox-sdk/commit/7aee736bf07a4bf9020e2109bdaaa70214d52a01) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Rewrite SDK with cleaner design patterns and tests. Remove the unnecessary isolation cruft and fix foundational issues with streaming, sessions, validations and error handling. Cover the SDK with unit & e2e tests.
101
+
102
+ ### Patch Changes
103
+
104
+ - [#106](https://github.com/cloudflare/sandbox-sdk/pull/106) [`da947cd`](https://github.com/cloudflare/sandbox-sdk/commit/da947cd9543fc99831eefb1e8741fc905cb8fa42) Thanks [@jahands](https://github.com/jahands)! - fix examples failing to deploy and prevent committing node_modules
105
+
106
+ ## 0.3.3
107
+
108
+ ### Patch Changes
109
+
110
+ - [#83](https://github.com/cloudflare/sandbox-sdk/pull/83) [`eec5bb6`](https://github.com/cloudflare/sandbox-sdk/commit/eec5bb6203dd5d775b4b54e91c26de25eeb767ce) Thanks [@mikenomitch](https://github.com/mikenomitch)! - Bump containers package version
111
+
112
+ ## 0.3.2
113
+
114
+ ### Patch Changes
115
+
116
+ - [#76](https://github.com/cloudflare/sandbox-sdk/pull/76) [`ef9e320`](https://github.com/cloudflare/sandbox-sdk/commit/ef9e320dcef30e57797fef6ebd9a9383fa9720d9) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Replace Jupyter with lightweight interpreters for >90% faster cold starts for `.runCode` calls, while maintaining full code execution capabilities and rich output support.
117
+
118
+ ## 0.3.1
119
+
120
+ ### Patch Changes
121
+
122
+ - [#71](https://github.com/cloudflare/sandbox-sdk/pull/71) [`fb3c9c2`](https://github.com/cloudflare/sandbox-sdk/commit/fb3c9c22242d9d4f157c26f547f1e697ef7875f9) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Bump containers package version
123
+
124
+ - [#70](https://github.com/cloudflare/sandbox-sdk/pull/70) [`e1fa354`](https://github.com/cloudflare/sandbox-sdk/commit/e1fa354ab1bc7b0e89db4901b67028ebf1a93d0a) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix escaped quotes in file write operations
125
+
126
+ - [#68](https://github.com/cloudflare/sandbox-sdk/pull/68) [`69b91d1`](https://github.com/cloudflare/sandbox-sdk/commit/69b91d1a8f6afb63262cc381ea93e94a033ed5e8) Thanks [@CyrusNuevoDia](https://github.com/CyrusNuevoDia)! - Configurable timeouts via environment variables in isolation.ts
127
+
128
+ - [#66](https://github.com/cloudflare/sandbox-sdk/pull/66) [`eca93b9`](https://github.com/cloudflare/sandbox-sdk/commit/eca93b97e40fa0d3bd9dc27af2cc214ec355b696) Thanks [@peterp](https://github.com/peterp)! - Determine if the port is specified in the URL.
129
+
130
+ ## 0.3.0
131
+
132
+ ### Minor Changes
133
+
134
+ - [#59](https://github.com/cloudflare/sandbox-sdk/pull/59) [`b6757f7`](https://github.com/cloudflare/sandbox-sdk/commit/b6757f730c34381d5a70d513944bbf9840f598ab) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Add process isolation for sandbox commands
135
+
136
+ Implements PID namespace isolation to protect control plane processes (Jupyter, Bun) from sandboxed code. Commands executed via `exec()` now run in isolated namespaces that cannot see or interact with system processes.
137
+
138
+ **Key security improvements:**
139
+
140
+ - Control plane processes are hidden from sandboxed commands
141
+ - Platform secrets in `/proc/1/environ` are inaccessible
142
+ - Ports 8888 (Jupyter) and 3000 (Bun) are protected from hijacking
143
+
144
+ **Breaking changes:**
145
+
146
+ 1. **Removed `sessionId` parameter**: The `sessionId` parameter has been removed from all methods (`exec()`, `execStream()`, `startProcess()`, etc.). Each sandbox now maintains its own persistent session automatically.
147
+
148
+ ```javascript
149
+ // Before: manual session management
150
+ await sandbox.exec("cd /app", { sessionId: "my-session" });
151
+
152
+ // After: automatic session per sandbox
153
+ await sandbox.exec("cd /app");
154
+ ```
155
+
156
+ 2. **Commands now maintain state**: Commands within the same sandbox now share state (working directory, environment variables, background processes). Previously each command was stateless.
157
+
158
+ ```javascript
159
+ // Before: each exec was independent
160
+ await sandbox.exec("cd /app");
161
+ await sandbox.exec("pwd"); // Output: /workspace
162
+
163
+ // After: state persists in session
164
+ await sandbox.exec("cd /app");
165
+ await sandbox.exec("pwd"); // Output: /app
166
+ ```
167
+
168
+ **Migration guide:**
169
+
170
+ - Remove `sessionId` from all method calls - each sandbox maintains its own session
171
+ - If you need isolated execution contexts within the same sandbox, use `sandbox.createSession()`:
172
+ ```javascript
173
+ // Create independent sessions with different environments
174
+ const buildSession = await sandbox.createSession({
175
+ name: "build",
176
+ env: { NODE_ENV: "production" },
177
+ cwd: "/build",
178
+ });
179
+ const testSession = await sandbox.createSession({
180
+ name: "test",
181
+ env: { NODE_ENV: "test" },
182
+ cwd: "/test",
183
+ });
184
+ ```
185
+ - Environment variables set in one command persist to the next
186
+ - Background processes remain active until explicitly killed
187
+ - Requires CAP_SYS_ADMIN (available in production, falls back gracefully in dev)
188
+
189
+ ### Patch Changes
190
+
191
+ - [#62](https://github.com/cloudflare/sandbox-sdk/pull/62) [`4bedc3a`](https://github.com/cloudflare/sandbox-sdk/commit/4bedc3aba347f3d4090a6efe2c9778bac00ce74a) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix broken build due to bun lockfile not being used
192
+
193
+ ## 0.2.4
194
+
195
+ ### Patch Changes
196
+
197
+ - [#57](https://github.com/cloudflare/sandbox-sdk/pull/57) [`12bbd12`](https://github.com/cloudflare/sandbox-sdk/commit/12bbd1229c07ef8c1c0bf58a4235a27938155b08) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Add listFiles method
198
+
199
+ ## 0.2.3
200
+
201
+ ### Patch Changes
202
+
203
+ - [#53](https://github.com/cloudflare/sandbox-sdk/pull/53) [`c87db11`](https://github.com/cloudflare/sandbox-sdk/commit/c87db117693a86cfb667bf09fb7720d6a6e0524d) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Improve jupyterlab config to speed up startup
204
+
205
+ ## 0.2.2
206
+
207
+ ### Patch Changes
208
+
209
+ - [#51](https://github.com/cloudflare/sandbox-sdk/pull/51) [`4aceb32`](https://github.com/cloudflare/sandbox-sdk/commit/4aceb3215c836f59afcb88b2b325016b3f623f46) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Handle intermittent interpreter failures and decouple jupyter startup
210
+
211
+ ## 0.2.1
212
+
213
+ ### Patch Changes
214
+
215
+ - [#49](https://github.com/cloudflare/sandbox-sdk/pull/49) [`d81d2a5`](https://github.com/cloudflare/sandbox-sdk/commit/d81d2a563c9af8947d5444019ed4d6156db563e3) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Implement code interpreter API
216
+
217
+ ## 0.2.0
218
+
219
+ ### Minor Changes
220
+
221
+ - [#47](https://github.com/cloudflare/sandbox-sdk/pull/47) [`8a93d0c`](https://github.com/cloudflare/sandbox-sdk/commit/8a93d0cae18a25bda6506b8b0a08d9e9eb3bb290) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Change default directory to a clean /workspace
222
+
223
+ ## 0.1.4
224
+
225
+ ### Patch Changes
226
+
227
+ - [#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
228
+
229
+ - [#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
230
+
231
+ - [#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`
232
+
233
+ - [#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
234
+
235
+ ## 0.1.3
236
+
237
+ ### Patch Changes
238
+
239
+ - [#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
240
+
241
+ ## 0.1.2
242
+
243
+ ### Patch Changes
244
+
245
+ - [#30](https://github.com/cloudflare/sandbox-sdk/pull/30) [`30e5c25`](https://github.com/cloudflare/sandbox-sdk/commit/30e5c25cf7d4b07f9049724206c531e2d5d29d5c) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Remove actions timeout
246
+
247
+ - [#29](https://github.com/cloudflare/sandbox-sdk/pull/29) [`d78508f`](https://github.com/cloudflare/sandbox-sdk/commit/d78508f7287a59e0423edd2999c2c83e9e34ccfd) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Create multi-platform Docker image and switch to Cloudflare official repo
248
+
249
+ ## 0.1.1
250
+
251
+ ### Patch Changes
252
+
253
+ - [`157dde9`](https://github.com/cloudflare/sandbox-sdk/commit/157dde9b1f23e9bb6f3e9c3f0514b639a8813897) Thanks [@threepointone](https://github.com/threepointone)! - update deps
254
+
255
+ - [`a04f6b6`](https://github.com/cloudflare/sandbox-sdk/commit/a04f6b6c0b2ef9e3ce0851b53769f1c10d8c6de6) Thanks [@threepointone](https://github.com/threepointone)! - trigger a build with updated deps
256
+
257
+ ## 0.1.0
258
+
259
+ ### Minor Changes
260
+
261
+ - [#24](https://github.com/cloudflare/sandbox-sdk/pull/24) [`cecde0a`](https://github.com/cloudflare/sandbox-sdk/commit/cecde0a7530a87deffd8562fb8b01d66ee80ee19) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Redesign command execution API
262
+
263
+ ### Patch Changes
264
+
265
+ - [#22](https://github.com/cloudflare/sandbox-sdk/pull/22) [`f5fcd52`](https://github.com/cloudflare/sandbox-sdk/commit/f5fcd52025d1f7958a374e69d75e3fc590275f3f) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Allow setting env variables dynamically and remove command restrictions
266
+
267
+ ## 0.0.9
268
+
269
+ ### Patch Changes
270
+
271
+ - [#20](https://github.com/cloudflare/sandbox-sdk/pull/20) [`f106fda`](https://github.com/cloudflare/sandbox-sdk/commit/f106fdac98e7ef35677326290d45cbf3af88982c) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - add preview URLs and dynamic port forwarding
272
+
273
+ ## 0.0.8
274
+
275
+ ### Patch Changes
276
+
277
+ - [`60af265`](https://github.com/cloudflare/sandbox-sdk/commit/60af265d834e83fd30a921a3e1be232f13fe24da) Thanks [@threepointone](https://github.com/threepointone)! - update dependencies
278
+
279
+ ## 0.0.7
280
+
281
+ ### Patch Changes
282
+
283
+ - [`d1c7c99`](https://github.com/cloudflare/sandbox-sdk/commit/d1c7c99df6555eff71bcd59852e4b8eed2ad8cb6) Thanks [@threepointone](https://github.com/threepointone)! - fix file operations
284
+
285
+ ## 0.0.6
286
+
287
+ ### Patch Changes
288
+
289
+ - [#9](https://github.com/cloudflare/sandbox-sdk/pull/9) [`24f5470`](https://github.com/cloudflare/sandbox-sdk/commit/24f547048d5a26137de4656cea13d83ad2cc0b43) Thanks [@ItsWendell](https://github.com/ItsWendell)! - fix baseUrl for stub and stub forwarding
290
+
291
+ ## 0.0.5
292
+
293
+ ### Patch Changes
294
+
295
+ - [#5](https://github.com/cloudflare/sandbox-sdk/pull/5) [`7c15b81`](https://github.com/cloudflare/sandbox-sdk/commit/7c15b817899e4d9e1f25747aaf439e5e9e880d15) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Make package ready for deployment
296
+
297
+ ## 0.0.4
298
+
299
+ ### Patch Changes
300
+
301
+ - [`c0d9d33`](https://github.com/cloudflare/sandbox-sdk/commit/c0d9d3396badee1eab45e6b4a73d48957f31409b) Thanks [@threepointone](https://github.com/threepointone)! - actually work
302
+
303
+ - [`444d2da`](https://github.com/cloudflare/sandbox-sdk/commit/444d2dafde9a0f190e50c879b0e768da1b289b51) Thanks [@threepointone](https://github.com/threepointone)! - add experimental label
304
+
305
+ ## 0.0.3
306
+
307
+ ### Patch Changes
308
+
309
+ - [`2b087c4`](https://github.com/cloudflare/sandbox-sdk/commit/2b087c40a29697c20dad19b4e3b8512f5d404bd3) Thanks [@ghostwriternr](https://github.com/ghostwriternr)! - Fix worker unable to find container port
310
+
3
311
  ## 0.0.2
4
312
 
5
313
  ### Patch Changes
package/Dockerfile CHANGED
@@ -1,16 +1,149 @@
1
- # syntax=docker/dockerfile:1
1
+ # Sandbox container image with full development environment
2
+ # Multi-stage build optimized for Turborepo monorepo
3
+
4
+ # ============================================================================
5
+ # Stage 1: Prune monorepo to only include necessary packages
6
+ # ============================================================================
7
+ FROM node:20-alpine AS pruner
8
+
9
+ WORKDIR /app
10
+
11
+ # Install Turborepo globally
12
+ RUN npm install -g turbo
13
+
14
+ # Copy entire monorepo
15
+ COPY . .
16
+
17
+ # Prune to only @repo/sandbox-container and its dependencies (@repo/shared)
18
+ # The --docker flag generates out/json and out/full directories
19
+ RUN turbo prune @repo/sandbox-container --docker
20
+
21
+ # ============================================================================
22
+ # Stage 2: Install dependencies and build packages
23
+ # ============================================================================
24
+ FROM node:20-alpine AS builder
25
+
26
+ WORKDIR /app
27
+
28
+ # Copy pruned lockfile and package.json files (for Docker layer caching)
29
+ COPY --from=pruner /app/out/json/ .
30
+ COPY --from=pruner /app/out/package-lock.json ./package-lock.json
31
+
32
+ # Install ALL dependencies with cache mount for npm packages
33
+ RUN --mount=type=cache,target=/root/.npm \
34
+ npm ci
35
+
36
+ # Copy pruned source code
37
+ COPY --from=pruner /app/out/full/ .
38
+
39
+ # Build all packages (Turborepo handles dependency order automatically)
40
+ # This builds @repo/shared first, then @repo/sandbox-container
41
+ RUN npx turbo run build
42
+
43
+ # ============================================================================
44
+ # Stage 3: Install production-only dependencies
45
+ # ============================================================================
46
+ FROM node:20-alpine AS prod-deps
2
47
 
3
- FROM oven/bun:latest
4
- # Set destination for COPY
5
48
  WORKDIR /app
6
49
 
7
- # Install git
8
- RUN apt-get update && apt-get install -y git
50
+ # Copy package files from builder
51
+ COPY --from=builder /app/package.json ./package.json
52
+ COPY --from=builder /app/package-lock.json ./package-lock.json
53
+ COPY --from=builder /app/packages ./packages
54
+ COPY --from=builder /app/tooling ./tooling
55
+
56
+ # Install ONLY production dependencies (excludes typescript, @types/*, etc.)
57
+ RUN --mount=type=cache,target=/root/.npm \
58
+ npm ci --production
59
+
60
+ # ============================================================================
61
+ # Stage 4: Runtime - Ubuntu 22.04 with only runtime dependencies
62
+ # ============================================================================
63
+ FROM ubuntu:22.04 AS runtime
9
64
 
10
- COPY container_src/* ./
11
- # RUN bun install
65
+ # Accept version as build argument (passed from npm_package_version)
66
+ ARG SANDBOX_VERSION=unknown
12
67
 
68
+ # Prevent interactive prompts during package installation
69
+ ENV DEBIAN_FRONTEND=noninteractive
70
+
71
+ # Set the sandbox version as an environment variable for version checking
72
+ ENV SANDBOX_VERSION=${SANDBOX_VERSION}
73
+
74
+ # Install essential runtime packages with cache mounts
75
+ RUN --mount=type=cache,target=/var/cache/apt,sharing=locked \
76
+ --mount=type=cache,target=/var/lib/apt,sharing=locked \
77
+ rm -f /etc/apt/apt.conf.d/docker-clean && \
78
+ echo 'Binary::apt::APT::Keep-Downloaded-Packages "true";' >/etc/apt/apt.conf.d/keep-cache && \
79
+ apt-get update && apt-get install -y --no-install-recommends \
80
+ curl \
81
+ wget \
82
+ ca-certificates \
83
+ python3.11 \
84
+ python3-pip \
85
+ python3.11-venv \
86
+ procps \
87
+ git \
88
+ unzip \
89
+ zip \
90
+ jq \
91
+ file
92
+
93
+ # Set Python 3.11 as default python3
94
+ RUN update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1
95
+
96
+ # Install Node.js 20 LTS using official NodeSource setup script
97
+ RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash - \
98
+ && apt-get install -y nodejs \
99
+ && rm -rf /var/lib/apt/lists/*
100
+
101
+ # Install Bun runtime from official image
102
+ COPY --from=oven/bun:1 /usr/local/bin/bun /usr/local/bin/bun
103
+
104
+ # Install essential Python packages with cache mount
105
+ RUN --mount=type=cache,target=/root/.cache/pip \
106
+ pip3 install \
107
+ matplotlib \
108
+ numpy \
109
+ pandas \
110
+ ipython
111
+
112
+ # Set up runtime container server directory
113
+ WORKDIR /container-server
114
+
115
+ # Copy built sandbox-container package
116
+ COPY --from=builder /app/packages/sandbox-container/dist ./dist
117
+ COPY --from=builder /app/packages/sandbox-container/package.json ./package.json
118
+
119
+ # Copy Python executor to runtime location
120
+ COPY --from=builder /app/packages/sandbox-container/src/runtime/executors/python/ipython_executor.py ./dist/runtime/executors/python/
121
+
122
+ # Copy production-only node_modules (excludes typescript, @types/*, etc.)
123
+ # Includes: @repo/shared, zod, esbuild (runtime dependencies)
124
+ COPY --from=prod-deps /app/node_modules ./node_modules
125
+
126
+ # Copy workspace packages
127
+ COPY --from=prod-deps /app/packages/shared/dist ./packages/shared/dist
128
+ COPY --from=prod-deps /app/packages/shared/package.json ./packages/shared/package.json
129
+
130
+ # Configure process pool sizes (can be overridden at runtime)
131
+ ENV PYTHON_POOL_MIN_SIZE=3
132
+ ENV PYTHON_POOL_MAX_SIZE=15
133
+ ENV JAVASCRIPT_POOL_MIN_SIZE=3
134
+ ENV JAVASCRIPT_POOL_MAX_SIZE=10
135
+ ENV TYPESCRIPT_POOL_MIN_SIZE=3
136
+ ENV TYPESCRIPT_POOL_MAX_SIZE=10
137
+
138
+ # Create clean workspace directory for user code
139
+ RUN mkdir -p /workspace
140
+
141
+ # Expose the application port (3000 for control)
13
142
  EXPOSE 3000
14
- # Run
15
- CMD ["bun", "index.ts"]
16
143
 
144
+ # Copy and make startup script executable
145
+ COPY packages/sandbox/startup.sh ./
146
+ RUN chmod +x startup.sh
147
+
148
+ # Use startup script
149
+ CMD ["./startup.sh"]