sandboxedjs 0.2.14 → 0.2.17

package/README.md

@@ -38,6 +38,13 @@ box.dispose();
 The same line boots in Node and in a page. Nothing is compiled, nothing is downloaded, nothing
 touches your disk.
 
+<div align="center">
+<a href="https://sandboxedjs.pages.dev">
+<img src="https://cdn.jsdelivr.net/npm/sandboxedjs@latest/assets/demo.png" alt="SandboxedJS running a full-stack project in a browser" width="720" />
+</a>
+<p>The image you see above is that I am running a full stack project in a static site deployed on cloudlfare pages, which is a CLI to interact with this sandbox, Try it out! <a href="https://sandboxedjs.pages.dev">Try the live demo →</a></p>
+</div>
+
 ## Why
 
 Run untrusted or AI-generated code. Give an agent a real shell. Build a browser IDE that actually
@@ -151,8 +158,10 @@ await box.exec("npm install", { cwd: "/app/frontend", timeoutMs: 600_000 });
 
 box.spawn("fastapi run", { cwd: "/app/backend" });
 box.spawn("npm run dev", { cwd: "/app/frontend" });
-if (!(await box.waitForPort(8000, { timeoutMs: 60_000 })) ||
-    !(await box.waitForPort(3000, { timeoutMs: 60_000 }))) {
+if (
+  !(await box.waitForPort(8000, { timeoutMs: 60_000 })) ||
+  !(await box.waitForPort(3000, { timeoutMs: 60_000 }))
+) {
   throw new Error("Check backend and frontend startup logs");
 }
 
@@ -187,6 +196,9 @@ its own origin for that proxy before giving up. The guest project needs no proxy
 the host must deploy the generated function. For a separate relay, set `network.proxy`.
 A host serving only static files cannot relay APIs that reject browser requests.
 
+> **Cloudflare Pages:** Dashboard drag-and-drop uploads only see `dist/`. If you deploy a static zip rather than using Git integration, compile `functions/` into `dist/_worker.js` on build:  
+> `"build": "vite build && wrangler pages functions build functions --outdir dist/_worker.js"`
+
 | Where you are                     | What to do                                                                          |
 | --------------------------------- | ----------------------------------------------------------------------------------- |
 | Deployed (Pages, Vercel, Netlify) | `npx sandboxedjs-egress init --allow …`, then deploy                                |

package/dist/index.cjs

@@ -21103,7 +21103,7 @@ var wheels_default = {
 
 // package.json
 var package_default = {
-  version: "0.2.14"};
+  version: "0.2.17"};
 
 // src/python/extension-abi.ts
 var EXTENSION_ABI = {

package/dist/index.js

@@ -21086,7 +21086,7 @@ var wheels_default = {
 
 // package.json
 var package_default = {
-  version: "0.2.14"};
+  version: "0.2.17"};
 
 // src/python/extension-abi.ts
 var EXTENSION_ABI = {

package/docs/fullstack-deployment.md

@@ -92,8 +92,10 @@ A GET to the deployed probe must return JSON containing
 paths automatically. Development uses `npx sandboxedjs-egress --allow ollama.com` or
 `npx sandboxedjs-serve dist`; Vite alone does not execute Pages Functions.
 
-Deploy the function along with the static build. Cloudflare dashboard drag-and-drop does
-not compile a `functions` directory: use Git integration or Wrangler from the project root.
+Deploy the function along with the static build. Cloudflare dashboard drag-and-drop only uploads
+`dist/` and does not compile a root `functions/` directory automatically: either deploy via Git integration
+or Wrangler, or compile it into `dist/_worker.js` during build:
+`wrangler pages functions build functions --outdir dist/_worker.js`.
 See [Cloudflare's deployment documentation](https://developers.cloudflare.com/pages/get-started/direct-upload/).
 
 Keep the relay's allowlist narrow and apply your application's authentication and rate limits

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sandboxedjs",
-  "version": "0.2.14",
+  "version": "0.2.17",
   "description": "A Linux-like container that runs entirely inside Node.js — POSIX shell, ~140 coreutils, Node.js and Python runtimes, virtual filesystem and networking. No Docker, no VM, no native modules.",
   "type": "module",
   "license": "MIT",
@@ -55,6 +55,7 @@
     "README.md",
     "LICENSE",
     "assets/logo.png",
+    "assets/demo.png",
     "docs"
   ],
   "scripts": {