[ { "path": ".codesandbox/tasks.json", "content": "{\n // These tasks will run in order when initializing your CodeSandbox project.\n \"setupTasks\": [\n {\n \"name\": \"Install PNPM\",\n \"command\": \"npm i -g pnpm@~7.4.0 --force\"\n },\n {\n \"name\": \"Install Dependencies\",\n \"command\": \"pnpm install\"\n },\n {\n \"name\": \"Build Dependencies\",\n \"command\": \"pnpm build\"\n }\n ],\n\n // These tasks can be run from CodeSandbox. Running one will open a log in the app.\n \"tasks\": {\n \"install\": {\n \"name\": \"Install Dependencies\",\n \"command\": \"pnpm install\"\n },\n \"build\": {\n \"name\": \"Build\",\n \"command\": \"pnpm build\"\n },\n \"build:prod\": {\n \"name\": \"Build:prod\",\n \"command\": \"IS_PROD_BUILD=1 pnpm build\"\n },\n \"start\": {\n \"name\": \"Start\",\n \"command\": \"pnpm start\",\n \"runAtStart\": true\n },\n \"watch:consumer\": {\n \"name\": \"Watch consumer\",\n \"command\": \"pnpm watch:consumer\",\n \"runAtStart\": true\n },\n \"test:unit\": {\n \"name\": \"Unit tests\",\n \"command\": \"pnpm run test:unit\"\n },\n \"Lint\": {\n \"name\": \"Lint\",\n \"command\": \"pnpm lint\"\n },\n \"Format:write\": {\n \"name\": \"Format:write\",\n \"command\": \"pnpm format:write\"\n }\n }\n}\n" }, { "path": ".editorconfig", "content": "root = true\n\n[*]\nend_of_line = lf\n\n[*.{js,ts,json}]\nindent_style = space\nindent_size = 2\n\n[Makefile]\nindent_style = tab\n" }, { "path": ".env.example", "content": "PREVIEW_HOST=csb.test:3000" }, { "path": ".env.test", "content": "EMULATOR_HOST=localhost:4000\nPREVIEW_HOST=csb.test:3000\nSANDPACK_CDN_ROOT=https://localhost:3500\n" }, { "path": ".eslintignore", "content": ".turbo\nbuild\ninternals/servers/consumer/dist/consumer.js\n/packages/runtime/preview/**/*.js\n/preview\ntmp" }, { "path": ".eslintrc.js", "content": "module.exports = {\n env: { browser: true, es2021: true },\n parser: '@typescript-eslint/parser',\n parserOptions: { ecmaVersion: 'latest', sourceType: 'module' },\n plugins: ['@typescript-eslint'],\n rules: { 'no-console': ['error', { allow: ['warn', 'error'] }] },\n};\n" }, { "path": ".gitignore", "content": "node_modules\n.DS_Store\n.turbo\nbuild\ninternals/servers/consumer/dist/consumer.js\ninternals/servers/consumer/bin\n.env*\n!.env.test\n!.env.example\ncertificates\n/packages/runtime/preview/**/*.js\n*-error.log\n*.log\n/preview\ntmp\ntest-results" }, { "path": ".prettierignore", "content": "fixture\nfixtures\nbuild\ninternals/servers/consumer/dist/consumer.js\n/packages/runtime/preview/**/*.js\n/preview\ntmp" }, { "path": ".prettierrc", "content": "{\n \"semi\": true,\n \"singleQuote\": true,\n \"bracketSpacing\": true,\n \"printWidth\": 120,\n \"tabWidth\": 2,\n \"overrides\": [\n {\n \"files\": \"*.(scss|css)\",\n \"options\": {\n \"singleQuote\": false\n }\n }\n ]\n}\n" }, { "path": ".release-please-manifest.json", "content": "{\"packages/nodebox\":\"0.1.9\"}\n" }, { "path": "ATTRIBUTIONS.md", "content": "# Open Source License Attribution\n\nNodebox uses various components from existing open source projects. You can find the source code of their open source projects along with license information below. We acknowledge and are grateful to these developers for their contributions to open source.\n\n- [Node.js](https://github.com/nodejs/node): MIT - Node.js contributors\n- [bun](https://github.com/oven-sh/bun): MIT - Oven.sh\n- [browserify](https://github.com/browserify/browserify): MIT - James Halliday\n- [os-browserify](https://github.com/CoderPuppy/os-browserify): MIT - CoderPuppy\n- [node-process](https://github.com/defunctzombie/node-process): MIT - Roman Shtylman\n- [deno_std](https://github.com/denoland/deno_std): MIT - Deno authors\n" }, { "path": "LICENSE", "content": "Sustainable Use License\n\nVersion 1.0\n\nAcceptance\n\nBy using the software, you agree to all of the terms and conditions below.\n\nCopyright License\n\nThe licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject to the limitations below.\n\nLimitations\n\nYou may use or modify the software only for your own internal business purposes or for non-commercial or personal use. You may distribute the software or provide it to others only if you do so free of charge for non-commercial purposes. You may not alter, remove, or obscure any licensing, copyright, or other notices of the licensor in the software. Any use of the licensor's trademarks is subject to applicable law.\n\nPatents\n\nThe licensor grants you a license, under any patent claims the licensor can license, or becomes able to license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case subject to the limitations and conditions in this license. This license does not cover any patent claims that you cause to be infringed by modifications or additions to the software. If you or your company make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.\n\nNotices\n\nYou must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms. If you modify the software, you must include in any modified copies of the software a prominent notice stating that you have modified the software.\n\nNo Other Rights\n\nThese terms do not imply any licenses other than those expressly granted in these terms.\n\nTermination\n\nIf you use the software in violation of these terms, such use is not licensed, and your license will automatically terminate. If the licensor provides you with a notice of your violation, and you cease all violation of this license no later than 30 days after you receive that notice, your license will be reinstated retroactively. However, if you violate these terms after such reinstatement, any additional violation of these terms will cause your license to terminate automatically and permanently.\n\nNo Liability\n\nAs far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.\n\nDefinitions\n\nThe \"licensor\" is CodeSandBox B.V.\n\nThe \"software\" is the software the licensor makes available under these terms, including any portion of it.\n\n\"You\" refers to the individual or entity agreeing to these terms.\n\n\"Your company\" is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. Control means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.\n\n\"Your license\" is the license granted to you for the software under these terms.\n\n\"Use\" means anything you do with the software requiring your license.\n\n\"Trademark\" means trademarks, service marks, and similar rights." }, { "path": "README.md", "content": "# Nodebox\n\nNodebox is a runtime for executing Node.js modules in the browser.\n\n## Why we built Nodebox\n\nWith `sandpack-bundler`, we allowed any developer anywhere to instantly create a fast, local, shareable playground inside their browser, without having to wait forever to install dependencies and fight with devtools. This improves the learning, experimentation and sharing experience of client-side JavaScript code.\n\nHowever, server-side JavaScript remained a challenge. At CodeSandbox we have solved this by using [Firecracker VMs](https://codesandbox.io/blog/how-we-clone-a-running-vm-in-2-seconds), allowing us to bring your entire development environment to the cloud regardless of the programming language or tooling you might be using. Unfortunately, as VMs live in the cloud, they require infrastructure and a network connection, resulting in a higher cost compared to our client-side sandboxes.\n\nTo solve this problem, we built Nodebox, a runtime that runs entirely in the browser, eliminating the need for a network connection and infrastructure.\n\nNodebox gives you the same user experience you have come to expect from Sandpack, which means a near-instant server-side JavaScript environment at the click of a button—built for experimentation, examples and documentation.\n\n## The differences between a VM and Nodebox\n\nAs mentioned in the previous section, we solved server-side sandboxes in CodeSandbox by using Firecracker VMs. In this section, we'll explain the advantages and disadvantages of each approach.\n\n### Advantages of VMs over Nodebox\n\n- You get dedicated resources, with no resource limits enforced by the browser\n- You have an entire Unix OS available\n- You can run any language, database, command\n- You can use network sockets\n- You can run large and complex projects\n- A perfect 1:1 environment as compared to your local setup (at least, if you're using a Unix-based system)\n- No emulation, so Node.js would run exactly the same way as locally\n\n### Advantages of Nodebox\n\n- No need for any infrastructure\n- No need for a network connection\n- Instant feedback to any change\n- Easy to get started\n- Easy and instant reset - simply refresh the page/iframe\n- Every page visitor gets their own Nodebox instance automatically\n\n## What makes it different\n\nNodebox is currently the only cross-browser Node.js runtime supporting all the latest browsers:\n\n- Chrome;\n- Firefox;\n- Safari \\*\n\n> - Support for iOS Safari is in beta\n\nNodebox does not emulate Node.js but is, instead, a Node.js-compatible runtime. This means that it implements as much of the Node.js API as possible while keeping a minimal performance imprint, using browser API where applicable and, in some cases, leaving out certain parts of Node.js due to browser [limitations](#Limitations) or complexity.\n\nNodebox uses an internal dependency manager that is fine-tuned to deliver optimal initial load time by utilizing dependency caching via [Sandpack CDN](https://github.com/codesandbox/sandpack-cdn). That CDN is an open-source Rust package manager that runs in the cloud and can be self-hosted pretty easily as well.\n\nWhile there are alternatives to Nodebox, they are closer to mimicking a container-based environment, running commands step-by-step, or even the entire Linux distributive in your browser. That makes them slower and harder to use compared to Nodebox, which is optimized to run sandboxes fast and with as little friction as possible.\n\n## Limitations\n\nUnfortunately, any type of runtime that does not have access to operating system-level APIs will come with certain limitations. For Nodebox, those are the following:\n\n- N-API modules\n- net#Sockets pointing to external IPs\n- Synchronous exec/spawn\n- async_hooks (planned for implementation)\n- Automatic process exiting - users now need to manually call `process.exit` before the process is exited (planned for implementation)\n\nAs we implement every module manually one by one, it is possible that some will not behave correctly. If this happens, feel free to open an issue here on GitHub and we'll make sure to fix it.\n\n## Documentation\n\n- [**Getting started**](#getting-started)\n- [API documentation](https://github.com/codesandbox/nodebox-runtime/blob/main/packages/nodebox/api.md)\n\n---\n\n## Getting started\n\nNodebox is meant for usage in your client-side applications, granting them the capability of running actual Node.js code directly in the browser. Here are a couple of examples of when Nodebox can be used:\n\n- Building interactive examples for server-side code in your documentation;\n- Showcasing a UI component library in the actual framework it's built for;\n- Generally any evaluation of Node.js code and previewing it in the browser.\n\nIn the context of this tutorial, we will be working on a documentation website that illustrates different examples of using a Next.js application. Bear in mind that our documentation itself can be written in any framework of our choosing.\n\n### Install\n\nNodebox can be installed from NPM just like any other dependency:\n\n```sh\nnpm install @codesandbox/nodebox\n```\n\n### Setup\n\nNodebox consists of two main parts:\n\n- A runtime environment evaluating the code;\n- A preview environment serving the result of the evaluation.\n\nCorresponding to these two parts, let's create two iframes in our application:\n\n```html\n\n\n\n\n\n```\n\nAlthough the runtime environment can be self-hosted, we will use the default one pointing to the deployed Nodebox instance on CodeSandbox servers. We do need, however, to specify an `iframe` reference in our application where Nodebox should render its preview.\n\n```js\nimport { Nodebox } from '@codesandbox/nodebox';\n\nconst runtime = new Nodebox({\n // Provide a reference to the \n
\n \n\n \n \n \n\n" }, { "path": "internals/servers/consumer/serve.ts", "content": "import 'dotenv/config';\nimport { setupApp } from '../utils';\n\nimport fastifyStatic from '@fastify/static';\nimport path from 'path';\n\nconst PORT = 5000;\n\nconst app = setupApp();\n\napp.register(fastifyStatic, {\n root: path.join(__dirname, './dist'),\n index: ['index.html'],\n setHeaders: (res) => {\n res.setHeader('x-csb-no-sw-proxy', '1');\n },\n decorateReply: false,\n});\n\napp.listen({ port: PORT }, function (err, address) {\n if (err) {\n app.log.error(err);\n process.exit(1);\n }\n\n /* eslint-disable-next-line no-console */\n console.log(`Server is now listening on ${address}`);\n});\n" }, { "path": "internals/servers/main-server.ts", "content": "import path from 'path';\nimport 'dotenv/config';\nimport { setupApp } from './utils';\n\nimport fastifyStatic from '@fastify/static';\n\nconst PORT = +(process.env.PORT || '4000');\n\nconst app = setupApp();\n\nconst NODE_EMULATOR_RUNTIME_BUILD_DIR = path.join(__dirname, '../../packages/runtime/build');\n\napp.register(fastifyStatic, {\n root: NODE_EMULATOR_RUNTIME_BUILD_DIR,\n index: ['index.html'],\n setHeaders: (res) => {\n res.setHeader('x-csb-no-sw-proxy', '1');\n },\n decorateReply: false,\n});\n\napp.register(fastifyStatic, {\n prefix: '/public/',\n root: path.join(__dirname, '../public'),\n index: ['index.html'],\n setHeaders: (res, filePath) => {\n const parsedPath = path.parse(filePath);\n if (parsedPath.ext === '.gz') {\n res.setHeader('Content-Encoding', 'gzip');\n } else if (parsedPath.ext === '.br') {\n res.setHeader('Content-Encoding', 'br');\n }\n },\n decorateReply: false,\n});\n\n// Run the server!\napp.listen({ port: PORT }, function (err, address) {\n if (err) {\n app.log.error(err);\n process.exit(1);\n }\n\n console.log(`Server is now listening on ${address}`);\n});\n" }, { "path": "internals/servers/preview-server.ts", "content": "import 'dotenv/config';\nimport { setupApp } from './utils';\n\nimport fastifyStatic from '@fastify/static';\nimport path from 'path';\n\nconst PORT = +(process.env.PORT || '3000');\n\nconst app = setupApp();\n\nconst PREVIEW_BUILD_DIR = path.join(__dirname, '../../packages/runtime/preview');\n\napp.register(fastifyStatic, {\n root: PREVIEW_BUILD_DIR,\n index: ['index.html'],\n setHeaders: (res) => {\n res.setHeader('x-csb-no-sw-proxy', '1');\n },\n decorateReply: false,\n});\n\n// Run the server!\napp.listen({ port: PORT }, function (err, address) {\n if (err) {\n app.log.error(err);\n process.exit(1);\n }\n\n console.log(`Server is now listening on ${address}`);\n});\n" }, { "path": "internals/servers/test/index.html", "content": "\n\n \n \n \n \n Test Server\n \n \n \n \n\n

Test server

\n \n \n\n" }, { "path": "internals/servers/test/test-server.ts", "content": "import 'dotenv/config';\nimport { setupApp } from '../utils';\n\nimport fastifyStatic from '@fastify/static';\nimport path from 'path';\n\nconst PORT = 4007;\n\nconst app = setupApp();\n\napp.register(fastifyStatic, {\n root: path.join(__dirname),\n index: ['index.html'],\n decorateReply: false,\n});\n\napp.register(fastifyStatic, {\n root: path.join(__dirname, '../../..', 'packages/nodebox/build'),\n prefix: '/nodebox/',\n decorateReply: false,\n});\n\napp.listen({ port: PORT }, function (err, address) {\n if (err) {\n app.log.error(err);\n process.exit(1);\n }\n\n console.log(`Server is now listening on ${address}`);\n});\n" }, { "path": "internals/servers/utils.ts", "content": "import fastify, { FastifyInstance } from 'fastify';\nimport fs from 'fs';\nimport path from 'path';\n\nexport function setupApp(): FastifyInstance {\n if (process.env.CSB) {\n return fastify({\n logger: true,\n });\n }\n\n const app = fastify({\n logger: true,\n https: {\n key: fs.readFileSync(path.join(__dirname, '../../certificates/cert.key')),\n cert: fs.readFileSync(path.join(__dirname, '../../certificates/cert.crt')),\n },\n });\n\n app.log.level = process.env.NODE_ENV === 'test' ? 'error' : 'debug';\n\n return app;\n}\n" }, { "path": "package.json", "content": "{\n \"private\": true,\n \"name\": \"nodebox\",\n \"version\": \"0.0.0\",\n \"scripts\": {\n \"build\": \"turbo run build --no-cache && pnpm build:consumer\",\n \"build:runtime\": \"turbo run build --filter runtime --no-cache\",\n \"build:api\": \"turbo run build --filter @codesandbox/nodebox --no-cache\",\n \"build:consumer\": \"node -r esbuild-register ./internals/servers/consumer/build.ts\",\n \"---\": \"---\",\n \"watch:consumer\": \"onchange 'tests/**/**.example.js' -- pnpm build:consumer\",\n \"----\": \"----\",\n \"start:preview\": \"node -r esbuild-register ./internals/servers/preview-server.ts\",\n \"start:runtime\": \"node -r esbuild-register ./internals/servers/main-server.ts\",\n \"start:consumer\": \"node -r esbuild-register ./internals/servers/consumer/serve.ts\",\n \"start:test-server\": \"node -r esbuild-register ./internals/servers/test/test-server.ts\",\n \"-----\": \"-----\",\n \"start\": \"concurrently \\\"pnpm start:runtime\\\" \\\"pnpm start:consumer\\\" \\\"pnpm start:preview\\\"\",\n \"cert\": \"mkdir -p certificates && openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout certificates/cert.key -out certificates/cert.crt -config req.conf -extensions v3_req\",\n \"cert:trust\": \"sudo security add-trusted-cert -d -r trustRoot -k \\\"/Library/Keychains/System.keychain\\\" ./certificates/cert.crt\",\n \"test:unit\": \"turbo run test:unit\",\n \"test:e2e\": \"pnpm playwright test\",\n \"test:e2e:debug\": \"PWDEBUG=1 pnpm run test:e2e\",\n \"------\": \"------\",\n \"lint\": \"eslint packages/**/*.{ts,js}\",\n \"format:check\": \"prettier --check packages/**/*.{ts,js}\",\n \"format:write\": \"prettier --write packages/**/*.{ts,js}\"\n },\n \"dependencies\": {\n \"@open-draft/deferred-promise\": \"^2.1.0\",\n \"@swc/helpers\": \"^0.4.2\",\n \"@typescript-eslint/eslint-plugin\": \"^5.43.0\",\n \"@typescript-eslint/parser\": \"^5.43.0\",\n \"base-x\": \"^4.0.0\",\n \"concurrently\": \"^7.5.0\",\n \"cuid\": \"^2.1.8\",\n \"dotenv\": \"^16.0.1\",\n \"esbuild-plugin-alias\": \"^0.2.1\",\n \"esbuild-register\": \"^3.4.1\",\n \"eslint\": \"^8.28.0\",\n \"node-fetch\": \"^2.6.7\",\n \"vite\": \"^2.9.12\"\n },\n \"devDependencies\": {\n \"@fastify/static\": \"^6.4.0\",\n \"@msgpack/msgpack\": \"^2.7.2\",\n \"@playwright/test\": \"^1.25.1\",\n \"@swc/core\": \"^1.2.204\",\n \"@swc/register\": \"^0.1.10\",\n \"@types/fs-extra\": \"^9.0.13\",\n \"@types/glob\": \"8.0.0\",\n \"@types/jest\": \"^29.2.0\",\n \"@types/node\": \"^18.0.0\",\n \"@types/node-fetch\": \"^2.6.2\",\n \"esbuild\": \"^0.14.46\",\n \"fastify\": \"^4.1.0\",\n \"fs-extra\": \"^10.1.0\",\n \"glob\": \"8.0.3\",\n \"glob-promise\": \"5.0.0\",\n \"jest\": \"^29.2.1\",\n \"onchange\": \"7.1.0\",\n \"outvariant\": \"^1.4.0\",\n \"playwright\": \"^1.25.1\",\n \"playwright-testing-library\": \"^4.3.1\",\n \"prettier\": \"^2.7.1\",\n \"rimraf\": \"^3.0.2\",\n \"ts-jest\": \"^29.0.3\",\n \"turbo\": \"^1.5.5\",\n \"typescript\": \"^4.8.4\",\n \"wait-for-expect\": \"^3.0.2\"\n }\n}\n" }, { "path": "packages/nodebox/.npmignore", "content": "src\nbuild.ts\nCHANGELOG.md" }, { "path": "packages/nodebox/CHANGELOG.md", "content": "# Changelog\n\n## [0.1.9](https://github.com/Sandpack/nodebox-internal/compare/nodebox-v0.1.8...nodebox-v0.1.9) (2023-11-29)\n\n\n### Bug Fixes\n\n* force a new release ([5b50af9](https://github.com/Sandpack/nodebox-internal/commit/5b50af93a58a3ddf6bcc9ce001f92cc7711e4702))\n\n## [0.1.8](https://github.com/codesandbox/nodebox-internal/compare/nodebox-v0.1.7...nodebox-v0.1.8) (2023-05-19)\n\n\n### Bug Fixes\n\n* **package.json:** update outvariant dependency to 1.4.0 in all packages ([#378](https://github.com/codesandbox/nodebox-internal/issues/378)) ([1e2658f](https://github.com/codesandbox/nodebox-internal/commit/1e2658f68764373e95b3ee90973a68886d708139))\n\n## [0.1.7](https://github.com/codesandbox/nodebox-internal/compare/nodebox-v0.1.6...nodebox-v0.1.7) (2023-03-30)\n\n\n### Features\n\n* Add `INTERNAL_NODEBOX_DEV` to improve debugging experience ([#372](https://github.com/codesandbox/nodebox-internal/issues/372)) ([f78ebd3](https://github.com/codesandbox/nodebox-internal/commit/f78ebd377a3d8de35bf3a4fafc12fc4c6c83b255))\n* **console:** Implement Console class ([#370](https://github.com/codesandbox/nodebox-internal/issues/370)) ([265e194](https://github.com/codesandbox/nodebox-internal/commit/265e1942ee97a159b1fb3c238f19f0f6725c42f5))\n\n## [0.1.6](https://github.com/codesandbox/nodebox-internal/compare/nodebox-v0.1.5...nodebox-v0.1.6) (2023-03-07)\n\n\n### Features\n\n* **nodebox:** Implement fs.rm api ([#360](https://github.com/codesandbox/nodebox-internal/issues/360)) ([52d7dc3](https://github.com/codesandbox/nodebox-internal/commit/52d7dc3d589dddffb3ca6d0ccd342f9e409022c9))\n\n\n### Bug Fixes\n\n* **nodebox:** add repo url for npm find the package homepage ([#361](https://github.com/codesandbox/nodebox-internal/issues/361)) ([70057b7](https://github.com/codesandbox/nodebox-internal/commit/70057b7da7d97d6c5409c62fd329ba3f16824515))\n\n## [0.1.5](https://github.com/codesandbox/nodebox-internal/compare/nodebox-v0.1.4...nodebox-v0.1.5) (2023-03-05)\n\n\n### Bug Fixes\n\n* API page link ([#355](https://github.com/codesandbox/nodebox-internal/issues/355)) ([2c6970c](https://github.com/codesandbox/nodebox-internal/commit/2c6970c72d237258e10434c6f0b6f2232891be3d))\n\n## [0.1.4](https://github.com/codesandbox/nodebox-internal/compare/nodebox-v0.1.3...nodebox-v0.1.4) (2023-03-02)\n\n\n### Bug Fixes\n\n* **preview:** increase timeout message ([#349](https://github.com/codesandbox/nodebox-internal/issues/349)) ([3aba917](https://github.com/codesandbox/nodebox-internal/commit/3aba91788df1e5eb44f82f022c5298c11ecb2bf8))\n\n## [0.1.3](https://github.com/codesandbox/nodebox-internal/compare/nodebox-v0.1.2...nodebox-v0.1.3) (2023-03-01)\n\n\n### Features\n\n* **shell:** introduce stdin api on shell ([#338](https://github.com/codesandbox/nodebox-internal/issues/338)) ([7630ca2](https://github.com/codesandbox/nodebox-internal/commit/7630ca295107e3a25cdd0d553f97240b79fa6b10))\n\n\n### Bug Fixes\n\n* **fs-writeFile:** content can be string or Uint8Array ([#346](https://github.com/codesandbox/nodebox-internal/issues/346)) ([8309deb](https://github.com/codesandbox/nodebox-internal/commit/8309deb35776b1a1dfee786bdf9b534ef08d99ee))\n\n## [0.1.2](https://github.com/codesandbox/nodebox-internal/compare/nodebox-v0.1.1...nodebox-v0.1.2) (2023-02-23)\n\n\n### Features\n\n* accept custom \"cdnUrl\" ([#273](https://github.com/codesandbox/nodebox-internal/issues/273)) ([21cca7a](https://github.com/codesandbox/nodebox-internal/commit/21cca7a298c64d355bc125ff12339e3c82d8e00f))\n* **nodebox:** Add more fs methods to the public API ([#332](https://github.com/codesandbox/nodebox-internal/issues/332)) ([38c1abc](https://github.com/codesandbox/nodebox-internal/commit/38c1abc29b25d85665f67414042489131fb8637d))\n* **nodebox:** make runtime URL optional and imply the default value ([#299](https://github.com/codesandbox/nodebox-internal/issues/299)) ([bb65224](https://github.com/codesandbox/nodebox-internal/commit/bb6522498fe8529ac74c79ab1bb238727127bdb0))\n* remove picomatch for simple glob util ([#236](https://github.com/codesandbox/nodebox-internal/issues/236)) ([0d10685](https://github.com/codesandbox/nodebox-internal/commit/0d10685a5b733155a50fc928872a90eb966e975a))\n* **shell:** implement stdout/stderr emitters ([#227](https://github.com/codesandbox/nodebox-internal/issues/227)) ([cd7cd9a](https://github.com/codesandbox/nodebox-internal/commit/cd7cd9a63a1c515a04e4d713c9a324773a2fb72a))\n* **shell:** replace \".exit()\" with \".kill()\" ([#226](https://github.com/codesandbox/nodebox-internal/issues/226)) ([43b6e78](https://github.com/codesandbox/nodebox-internal/commit/43b6e78b67ace366ade9fab96e37e79ee66fa6db))\n\n\n### Bug Fixes\n\n* improve error handling, support operation rejections ([#251](https://github.com/codesandbox/nodebox-internal/issues/251)) ([78ce271](https://github.com/codesandbox/nodebox-internal/commit/78ce2714e5c29839e93a655e250042aac57ff36d))\n* incorrect cdnUrl typings on runtime iframe protocol ([b68abb2](https://github.com/codesandbox/nodebox-internal/commit/b68abb272265b96086ac904f232583e933238b92))\n* **nodebox:** check url argument, improve error messages ([#218](https://github.com/codesandbox/nodebox-internal/issues/218)) ([f9ec17c](https://github.com/codesandbox/nodebox-internal/commit/f9ec17c33d674ccb73f1b15dbb4f442ae2b39c15))\n* **nodebox:** publish version ([#334](https://github.com/codesandbox/nodebox-internal/issues/334)) ([18ad452](https://github.com/codesandbox/nodebox-internal/commit/18ad452635f0b82d036f3693ec4fd6a202ea6557))\n* package export for nodebox ([#321](https://github.com/codesandbox/nodebox-internal/issues/321)) ([a486b44](https://github.com/codesandbox/nodebox-internal/commit/a486b44d0dfc86e10fb54c346cb294f5f3e8c215))\n* **progress message:** drop `progress` key in favor of `totalPending` ([#292](https://github.com/codesandbox/nodebox-internal/issues/292)) ([9856a15](https://github.com/codesandbox/nodebox-internal/commit/9856a155e536ae24072c818e8b68986bd27702bc))\n* readme links ([#306](https://github.com/codesandbox/nodebox-internal/issues/306)) ([d83bbbc](https://github.com/codesandbox/nodebox-internal/commit/d83bbbcd0e0d33931a7cafd419252bf68d84b093))\n* **readme:** remove sentence about VMs ([#312](https://github.com/codesandbox/nodebox-internal/issues/312)) ([6c9260f](https://github.com/codesandbox/nodebox-internal/commit/6c9260f1f6cb806351327a69fef316982b0f94af))\n* rename publish script and folder name ([#239](https://github.com/codesandbox/nodebox-internal/issues/239)) ([2dac1db](https://github.com/codesandbox/nodebox-internal/commit/2dac1dba061a1ff42adb29d6265ff88ebc4993ff))\n* **shell:** emit \"exit\" when shell exits ([#287](https://github.com/codesandbox/nodebox-internal/issues/287)) ([3b25008](https://github.com/codesandbox/nodebox-internal/commit/3b25008cb386ef45b58b0672b16a86a86ced2593))\n* **shell:** replace \"shell.listen()\" with \"shell.on()\" ([#234](https://github.com/codesandbox/nodebox-internal/issues/234)) ([1774241](https://github.com/codesandbox/nodebox-internal/commit/17742414bc938707d9142e1895b64f522c5366a0))\n* update configuration steps ([#310](https://github.com/codesandbox/nodebox-internal/issues/310)) ([9d7df79](https://github.com/codesandbox/nodebox-internal/commit/9d7df79ffb90b67632e3e20ba2c2ef5125e0df4d))\n\n## [0.0.41](https://github.com/codesandbox/nodebox-internal/compare/nodebox-v0.0.40...nodebox-v0.0.41) (2023-02-23)\n\n\n### Features\n\n* **nodebox:** Add more fs methods to the public API ([#332](https://github.com/codesandbox/nodebox-internal/issues/332)) ([38c1abc](https://github.com/codesandbox/nodebox-internal/commit/38c1abc29b25d85665f67414042489131fb8637d))\n\n## [0.0.40](https://github.com/codesandbox/nodebox-internal/compare/nodebox-v0.0.39...nodebox-v0.0.40) (2023-02-21)\n\n\n### Bug Fixes\n\n* package export for nodebox ([#321](https://github.com/codesandbox/nodebox-internal/issues/321)) ([a486b44](https://github.com/codesandbox/nodebox-internal/commit/a486b44d0dfc86e10fb54c346cb294f5f3e8c215))\n\n## [0.0.39](https://github.com/codesandbox/nodebox-internal/compare/nodebox-v0.0.38...nodebox-v0.0.39) (2023-02-16)\n\n\n### Bug Fixes\n\n* readme links ([#306](https://github.com/codesandbox/nodebox-internal/issues/306)) ([d83bbbc](https://github.com/codesandbox/nodebox-internal/commit/d83bbbcd0e0d33931a7cafd419252bf68d84b093))\n* **readme:** remove sentence about VMs ([#312](https://github.com/codesandbox/nodebox-internal/issues/312)) ([6c9260f](https://github.com/codesandbox/nodebox-internal/commit/6c9260f1f6cb806351327a69fef316982b0f94af))\n* update configuration steps ([#310](https://github.com/codesandbox/nodebox-internal/issues/310)) ([9d7df79](https://github.com/codesandbox/nodebox-internal/commit/9d7df79ffb90b67632e3e20ba2c2ef5125e0df4d))\n\n## [0.0.38](https://github.com/codesandbox/nodebox/compare/nodebox-v0.0.37...nodebox-v0.0.38) (2023-02-15)\n\n\n### Features\n\n* **nodebox:** make runtime URL optional and imply the default value ([#299](https://github.com/codesandbox/nodebox/issues/299)) ([bb65224](https://github.com/codesandbox/nodebox/commit/bb6522498fe8529ac74c79ab1bb238727127bdb0))\n\n## [0.0.37](https://github.com/codesandbox/nodebox/compare/nodebox-v0.0.36...nodebox-v0.0.37) (2023-02-08)\n\n\n### Bug Fixes\n\n* **progress message:** drop `progress` key in favor of `totalPending` ([#292](https://github.com/codesandbox/nodebox/issues/292)) ([9856a15](https://github.com/codesandbox/nodebox/commit/9856a155e536ae24072c818e8b68986bd27702bc))\n* **shell:** emit \"exit\" when shell exits ([#287](https://github.com/codesandbox/nodebox/issues/287)) ([3b25008](https://github.com/codesandbox/nodebox/commit/3b25008cb386ef45b58b0672b16a86a86ced2593))\n\n## [0.0.36](https://github.com/codesandbox/nodebox/compare/nodebox-v0.0.35...nodebox-v0.0.36) (2023-02-02)\n\n\n### Bug Fixes\n\n* incorrect cdnUrl typings on runtime iframe protocol ([b68abb2](https://github.com/codesandbox/nodebox/commit/b68abb272265b96086ac904f232583e933238b92))\n\n## [0.0.35](https://github.com/codesandbox/nodebox/compare/nodebox-v0.0.34...nodebox-v0.0.35) (2023-01-26)\n\n\n### Features\n\n* accept custom \"cdnUrl\" ([#273](https://github.com/codesandbox/nodebox/issues/273)) ([21cca7a](https://github.com/codesandbox/nodebox/commit/21cca7a298c64d355bc125ff12339e3c82d8e00f))\n\n## [0.0.34](https://github.com/codesandbox/nodebox/compare/nodebox-v0.0.33...nodebox-v0.0.34) (2023-01-17)\n\n\n### Bug Fixes\n\n* improve error handling, support operation rejections ([#251](https://github.com/codesandbox/nodebox/issues/251)) ([78ce271](https://github.com/codesandbox/nodebox/commit/78ce2714e5c29839e93a655e250042aac57ff36d))\n\n## [0.0.33](https://github.com/codesandbox/nodebox/compare/nodebox-v0.0.32...nodebox-v0.0.33) (2023-01-10)\n\n\n### Bug Fixes\n\n* rename publish script and folder name ([#239](https://github.com/codesandbox/nodebox/issues/239)) ([2dac1db](https://github.com/codesandbox/nodebox/commit/2dac1dba061a1ff42adb29d6265ff88ebc4993ff))\n\n## [0.0.32](https://github.com/codesandbox/nodebox/compare/nodebox-v0.0.31...nodebox-v0.0.32) (2023-01-10)\n\n\n### Features\n\n* remove picomatch for simple glob util ([#236](https://github.com/codesandbox/nodebox/issues/236)) ([0d10685](https://github.com/codesandbox/nodebox/commit/0d10685a5b733155a50fc928872a90eb966e975a))\n* **shell:** implement stdout/stderr emitters ([#227](https://github.com/codesandbox/nodebox/issues/227)) ([cd7cd9a](https://github.com/codesandbox/nodebox/commit/cd7cd9a63a1c515a04e4d713c9a324773a2fb72a))\n\n\n### Bug Fixes\n\n* **shell:** replace \"shell.listen()\" with \"shell.on()\" ([#234](https://github.com/codesandbox/nodebox/issues/234)) ([1774241](https://github.com/codesandbox/nodebox/commit/17742414bc938707d9142e1895b64f522c5366a0))\n\n## [0.0.31](https://github.com/codesandbox/nodebox/compare/nodebox-v0.0.30...nodebox-v0.0.31) (2022-12-20)\n\n\n### Features\n\n* **shell:** replace \".exit()\" with \".kill()\" ([#226](https://github.com/codesandbox/nodebox/issues/226)) ([43b6e78](https://github.com/codesandbox/nodebox/commit/43b6e78b67ace366ade9fab96e37e79ee66fa6db))\n\n\n### Bug Fixes\n\n* **nodebox:** check url argument, improve error messages ([#218](https://github.com/codesandbox/nodebox/issues/218)) ([f9ec17c](https://github.com/codesandbox/nodebox/commit/f9ec17c33d674ccb73f1b15dbb4f442ae2b39c15))\n\n## [0.0.30](https://github.com/codesandbox/nodebox/compare/nodebox-v0.0.29...nodebox-v0.0.30) (2022-12-14)\n\n\n### Features\n\n* Refactor node worker spawning to use MessageChannel ([#205](https://github.com/codesandbox/nodebox/issues/205)) ([6896135](https://github.com/codesandbox/nodebox/commit/6896135706bf2bd847c34ab9d289eb67de76a2f7))\n\n## [0.0.29](https://github.com/codesandbox/nodebox/compare/nodebox-v0.0.28...nodebox-v0.0.29) (2022-12-08)\n\n\n### Bug Fixes\n\n* update deferred promises ([#200](https://github.com/codesandbox/nodebox/issues/200)) ([d11066e](https://github.com/codesandbox/nodebox/commit/d11066eb2852b51717f237b918b8eb8f4c878274))\n\n## [0.0.28](https://github.com/codesandbox/browser-node-emulator/compare/nodebox-v0.0.27...nodebox-v0.0.28) (2022-11-29)\n\n\n### Features\n\n* **bridge:** improve worker handling, use MessageChannel for worker ([#162](https://github.com/codesandbox/browser-node-emulator/issues/162)) ([bbe1e11](https://github.com/codesandbox/browser-node-emulator/commit/bbe1e11679daed2b28ff8eec1d5e6aad39373976))\n* fs refactor ([#100](https://github.com/codesandbox/browser-node-emulator/issues/100)) ([5797d19](https://github.com/codesandbox/browser-node-emulator/commit/5797d19528defb2724abbd1d2cf0cb03d05b2b60))\n* **fs:** FSWatcher ([#75](https://github.com/codesandbox/browser-node-emulator/issues/75)) ([b378b76](https://github.com/codesandbox/browser-node-emulator/commit/b378b763e85ec24b117a3ac962ee22ef39f22738))\n* **fs:** read / write files ([#60](https://github.com/codesandbox/browser-node-emulator/issues/60)) ([05c032d](https://github.com/codesandbox/browser-node-emulator/commit/05c032dbe33916faa563a858c67e464c9b03a9f6))\n* **node emulator:** preview interface ([#41](https://github.com/codesandbox/browser-node-emulator/issues/41)) ([e7e66bb](https://github.com/codesandbox/browser-node-emulator/commit/e7e66bbaced7cf5eb20d14b58816e11737f9c3ed))\n* **public fs:** implement fs watch ([#90](https://github.com/codesandbox/browser-node-emulator/issues/90)) ([fe9b0b6](https://github.com/codesandbox/browser-node-emulator/commit/fe9b0b68ef61532483a326e3d3ea0b9e565bc273))\n* **runtime:** runtime protocols ([#131](https://github.com/codesandbox/browser-node-emulator/issues/131)) ([18a92b9](https://github.com/codesandbox/browser-node-emulator/commit/18a92b993d3d21475a903708ff565bb3cf586583))\n* **shell:** Allow custom commands ([#61](https://github.com/codesandbox/browser-node-emulator/issues/61)) ([c90890d](https://github.com/codesandbox/browser-node-emulator/commit/c90890db2e0f1c143221772ab76eacb3cafbe23f))\n* **shellProcess:** consume stdout ([#94](https://github.com/codesandbox/browser-node-emulator/issues/94)) ([7e5667e](https://github.com/codesandbox/browser-node-emulator/commit/7e5667ebaecf2afb968a1ceb6cf57a90df1a9575))\n* **shellProcess:** on exit ([#108](https://github.com/codesandbox/browser-node-emulator/issues/108)) ([dcbd2c5](https://github.com/codesandbox/browser-node-emulator/commit/dcbd2c59aec2479617a37972507081b90bc88fbb))\n* **shell:** ShellProcess interface ([#72](https://github.com/codesandbox/browser-node-emulator/issues/72)) ([cdc0cf7](https://github.com/codesandbox/browser-node-emulator/commit/cdc0cf759f016ac5c923bb957caefd555ccaafab))\n* Worker progress messages ([#122](https://github.com/codesandbox/browser-node-emulator/issues/122)) ([084eb2f](https://github.com/codesandbox/browser-node-emulator/commit/084eb2f9cfe63d205894e7dd5f89016a40b0b200))\n\n\n### Bug Fixes\n\n* **emulator:** get rid of internal dependency ([#173](https://github.com/codesandbox/browser-node-emulator/issues/173)) ([b0db69a](https://github.com/codesandbox/browser-node-emulator/commit/b0db69adb70cb4619169dc6a56c1423f17307217))\n* **emulator:** get rid of internal dependency ([#173](https://github.com/codesandbox/browser-node-emulator/issues/173)) ([d4c9b8f](https://github.com/codesandbox/browser-node-emulator/commit/d4c9b8f94bfb310949ed90005bb615b9ecf88f4a))\n* **node-emulator:** set build target to es2020 ([#38](https://github.com/codesandbox/browser-node-emulator/issues/38)) ([5ff50fc](https://github.com/codesandbox/browser-node-emulator/commit/5ff50fca586101b6270f5f587900a031466c024a))\n* **node-emulator:** trigger a new publish ([4b42c8f](https://github.com/codesandbox/browser-node-emulator/commit/4b42c8f43c8dea0491b48af067b07eb74922848f))\n* **node-emulator:** trigger a new publish ([baef111](https://github.com/codesandbox/browser-node-emulator/commit/baef111bc1bd3bd34b5ff82fbeaa0a141372c417))\n* **node-emulator:** trigger a new publish ([#171](https://github.com/codesandbox/browser-node-emulator/issues/171)) ([8485b15](https://github.com/codesandbox/browser-node-emulator/commit/8485b151f3cbfd88692183a48a263ef070da08b3))\n* **NodeEmulator.ts:** export FilesMap type to consumer ([#57](https://github.com/codesandbox/browser-node-emulator/issues/57)) ([d676be5](https://github.com/codesandbox/browser-node-emulator/commit/d676be50f20f6d88bd7bbd6fa9edf3047e5fa8f2))\n* Potential race condition with public api ([#111](https://github.com/codesandbox/browser-node-emulator/issues/111)) ([e5e0492](https://github.com/codesandbox/browser-node-emulator/commit/e5e04929c2f2b1dc28a22970bd1e796ed2119236))\n* **preview:** remove conditional over listener ([#53](https://github.com/codesandbox/browser-node-emulator/issues/53)) ([5c6e8c0](https://github.com/codesandbox/browser-node-emulator/commit/5c6e8c0a0600a3b408f734a17b13a8f37ef8e09d))\n* public watch api and public message bus refactor ([#117](https://github.com/codesandbox/browser-node-emulator/issues/117)) ([2d23b09](https://github.com/codesandbox/browser-node-emulator/commit/2d23b0969652d9c1ff17a9fac79d512f53c332f8))\n* remove handshake timeout log ([49413a6](https://github.com/codesandbox/browser-node-emulator/commit/49413a6dde5d8300e626298553fb09a9ce32cf4c))\n* **runtime protocol:** remove promise ([#139](https://github.com/codesandbox/browser-node-emulator/issues/139)) ([51a996e](https://github.com/codesandbox/browser-node-emulator/commit/51a996e64ba105bc2a1164bf09000a13f9076936))\n* **runtime-protocol.types.ts:** export `InjectMessage` type ([#133](https://github.com/codesandbox/browser-node-emulator/issues/133)) ([b47387a](https://github.com/codesandbox/browser-node-emulator/commit/b47387adbb303552fdc1dd8f0a3aab93704a7550))\n* **shell stdout:** fix types ([#105](https://github.com/codesandbox/browser-node-emulator/issues/105)) ([e77d244](https://github.com/codesandbox/browser-node-emulator/commit/e77d244ce2d9ca45ff6a28d0b60dc51b3c512eb7))\n* **ShellProcess:** drop restart ([#88](https://github.com/codesandbox/browser-node-emulator/issues/88)) ([5371e4b](https://github.com/codesandbox/browser-node-emulator/commit/5371e4b681c4806112873e1c58a9fafea418ddb6))\n* **shellprocess:** reassign internal state to running after restart ([#77](https://github.com/codesandbox/browser-node-emulator/issues/77)) ([13ae624](https://github.com/codesandbox/browser-node-emulator/commit/13ae6242aded1e8896256bb6a78edeb764aecf81))\n* **shellprocess:** returning id on restart ([#78](https://github.com/codesandbox/browser-node-emulator/issues/78)) ([23f1230](https://github.com/codesandbox/browser-node-emulator/commit/23f1230c33b8c84911eede9d03d3b9e9bb2ac62f))\n* UI tweak on fallback page and improve conditional on FS module ([#102](https://github.com/codesandbox/browser-node-emulator/issues/102)) ([bdfb9cc](https://github.com/codesandbox/browser-node-emulator/commit/bdfb9cc7e89992017bf257133500261fbe7eb933))\n* Use picomatch-browser and fix build script ([#125](https://github.com/codesandbox/browser-node-emulator/issues/125)) ([521a432](https://github.com/codesandbox/browser-node-emulator/commit/521a432e22f6b11cc119af19c06ed29fdaad218f))\n* **worker controller:** fix exit/restart worker ([#114](https://github.com/codesandbox/browser-node-emulator/issues/114)) ([fbb9ad5](https://github.com/codesandbox/browser-node-emulator/commit/fbb9ad5f890c8e188f9cd7c3b39f71de0e9a3c7e))\n\n## [0.0.27](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.26...node-emulator-v0.0.27) (2022-11-24)\n\n\n### Features\n\n* **bridge:** improve worker handling, use MessageChannel for worker ([#162](https://github.com/codesandbox/browser-node-emulator/issues/162)) ([bbe1e11](https://github.com/codesandbox/browser-node-emulator/commit/bbe1e11679daed2b28ff8eec1d5e6aad39373976))\n\n## [0.0.26](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.25...node-emulator-v0.0.26) (2022-11-22)\n\n\n### Bug Fixes\n\n* **emulator:** get rid of internal dependency ([#173](https://github.com/codesandbox/browser-node-emulator/issues/173)) ([d4c9b8f](https://github.com/codesandbox/browser-node-emulator/commit/d4c9b8f94bfb310949ed90005bb615b9ecf88f4a))\n\n## [0.0.25](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.24...node-emulator-v0.0.25) (2022-11-22)\n\n\n### Bug Fixes\n\n* **node-emulator:** trigger a new publish ([#171](https://github.com/codesandbox/browser-node-emulator/issues/171)) ([8485b15](https://github.com/codesandbox/browser-node-emulator/commit/8485b151f3cbfd88692183a48a263ef070da08b3))\n\n## [0.0.24](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.23...node-emulator-v0.0.24) (2022-11-10)\n\n\n### Bug Fixes\n\n* **runtime protocol:** remove promise ([#139](https://github.com/codesandbox/browser-node-emulator/issues/139)) ([51a996e](https://github.com/codesandbox/browser-node-emulator/commit/51a996e64ba105bc2a1164bf09000a13f9076936))\n\n## [0.0.23](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.22...node-emulator-v0.0.23) (2022-11-10)\n\n\n### Bug Fixes\n\n* **runtime-protocol.types.ts:** export `InjectMessage` type ([#133](https://github.com/codesandbox/browser-node-emulator/issues/133)) ([b47387a](https://github.com/codesandbox/browser-node-emulator/commit/b47387adbb303552fdc1dd8f0a3aab93704a7550))\n\n## [0.0.22](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.21...node-emulator-v0.0.22) (2022-11-10)\n\n\n### Features\n\n* **runtime:** runtime protocols ([#131](https://github.com/codesandbox/browser-node-emulator/issues/131)) ([18a92b9](https://github.com/codesandbox/browser-node-emulator/commit/18a92b993d3d21475a903708ff565bb3cf586583))\n\n## [0.0.21](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.20...node-emulator-v0.0.21) (2022-11-01)\n\n\n### Bug Fixes\n\n* Use picomatch-browser and fix build script ([#125](https://github.com/codesandbox/browser-node-emulator/issues/125)) ([521a432](https://github.com/codesandbox/browser-node-emulator/commit/521a432e22f6b11cc119af19c06ed29fdaad218f))\n\n## [0.0.20](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.19...node-emulator-v0.0.20) (2022-11-01)\n\n\n### Features\n\n* Worker progress messages ([#122](https://github.com/codesandbox/browser-node-emulator/issues/122)) ([084eb2f](https://github.com/codesandbox/browser-node-emulator/commit/084eb2f9cfe63d205894e7dd5f89016a40b0b200))\n\n## [0.0.19](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.18...node-emulator-v0.0.19) (2022-10-31)\n\n\n### Bug Fixes\n\n* public watch api and public message bus refactor ([#117](https://github.com/codesandbox/browser-node-emulator/issues/117)) ([2d23b09](https://github.com/codesandbox/browser-node-emulator/commit/2d23b0969652d9c1ff17a9fac79d512f53c332f8))\n\n## [0.0.18](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.17...node-emulator-v0.0.18) (2022-10-28)\n\n\n### Bug Fixes\n\n* **worker controller:** fix exit/restart worker ([#114](https://github.com/codesandbox/browser-node-emulator/issues/114)) ([fbb9ad5](https://github.com/codesandbox/browser-node-emulator/commit/fbb9ad5f890c8e188f9cd7c3b39f71de0e9a3c7e))\n\n## [0.0.17](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.16...node-emulator-v0.0.17) (2022-10-28)\n\n\n### Features\n\n* **shellProcess:** on exit ([#108](https://github.com/codesandbox/browser-node-emulator/issues/108)) ([dcbd2c5](https://github.com/codesandbox/browser-node-emulator/commit/dcbd2c59aec2479617a37972507081b90bc88fbb))\n\n\n### Bug Fixes\n\n* Potential race condition with public api ([#111](https://github.com/codesandbox/browser-node-emulator/issues/111)) ([e5e0492](https://github.com/codesandbox/browser-node-emulator/commit/e5e04929c2f2b1dc28a22970bd1e796ed2119236))\n\n## [0.0.16](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.15...node-emulator-v0.0.16) (2022-10-28)\n\n\n### Features\n\n* fs refactor ([#100](https://github.com/codesandbox/browser-node-emulator/issues/100)) ([5797d19](https://github.com/codesandbox/browser-node-emulator/commit/5797d19528defb2724abbd1d2cf0cb03d05b2b60))\n\n\n### Bug Fixes\n\n* **shell stdout:** fix types ([#105](https://github.com/codesandbox/browser-node-emulator/issues/105)) ([e77d244](https://github.com/codesandbox/browser-node-emulator/commit/e77d244ce2d9ca45ff6a28d0b60dc51b3c512eb7))\n\n## [0.0.15](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.14...node-emulator-v0.0.15) (2022-10-28)\n\n\n### Features\n\n* **shellProcess:** consume stdout ([#94](https://github.com/codesandbox/browser-node-emulator/issues/94)) ([7e5667e](https://github.com/codesandbox/browser-node-emulator/commit/7e5667ebaecf2afb968a1ceb6cf57a90df1a9575))\n\n## [0.0.14](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.13...node-emulator-v0.0.14) (2022-10-27)\n\n\n### Bug Fixes\n\n* UI tweak on fallback page and improve conditional on FS module ([#102](https://github.com/codesandbox/browser-node-emulator/issues/102)) ([bdfb9cc](https://github.com/codesandbox/browser-node-emulator/commit/bdfb9cc7e89992017bf257133500261fbe7eb933))\n\n## [0.0.13](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.12...node-emulator-v0.0.13) (2022-10-27)\n\n\n### Features\n\n* **public fs:** implement fs watch ([#90](https://github.com/codesandbox/browser-node-emulator/issues/90)) ([fe9b0b6](https://github.com/codesandbox/browser-node-emulator/commit/fe9b0b68ef61532483a326e3d3ea0b9e565bc273))\n\n## [0.0.12](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.11...node-emulator-v0.0.12) (2022-10-25)\n\n\n### Features\n\n* **fs:** FSWatcher ([#75](https://github.com/codesandbox/browser-node-emulator/issues/75)) ([b378b76](https://github.com/codesandbox/browser-node-emulator/commit/b378b763e85ec24b117a3ac962ee22ef39f22738))\n\n\n### Bug Fixes\n\n* **ShellProcess:** drop restart ([#88](https://github.com/codesandbox/browser-node-emulator/issues/88)) ([5371e4b](https://github.com/codesandbox/browser-node-emulator/commit/5371e4b681c4806112873e1c58a9fafea418ddb6))\n* **shellprocess:** reassign internal state to running after restart ([#77](https://github.com/codesandbox/browser-node-emulator/issues/77)) ([13ae624](https://github.com/codesandbox/browser-node-emulator/commit/13ae6242aded1e8896256bb6a78edeb764aecf81))\n\n## [0.0.11](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.10...node-emulator-v0.0.11) (2022-10-21)\n\n\n### Bug Fixes\n\n* **shellprocess:** returning id on restart ([#78](https://github.com/codesandbox/browser-node-emulator/issues/78)) ([23f1230](https://github.com/codesandbox/browser-node-emulator/commit/23f1230c33b8c84911eede9d03d3b9e9bb2ac62f))\n\n## [0.0.10](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.9...node-emulator-v0.0.10) (2022-10-20)\n\n\n### Features\n\n* **shell:** ShellProcess interface ([#72](https://github.com/codesandbox/browser-node-emulator/issues/72)) ([cdc0cf7](https://github.com/codesandbox/browser-node-emulator/commit/cdc0cf759f016ac5c923bb957caefd555ccaafab))\n\n## [0.0.9](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.8...node-emulator-v0.0.9) (2022-10-18)\n\n\n### Features\n\n* **fs:** read / write files ([#60](https://github.com/codesandbox/browser-node-emulator/issues/60)) ([05c032d](https://github.com/codesandbox/browser-node-emulator/commit/05c032dbe33916faa563a858c67e464c9b03a9f6))\n* **shell:** Allow custom commands ([#61](https://github.com/codesandbox/browser-node-emulator/issues/61)) ([c90890d](https://github.com/codesandbox/browser-node-emulator/commit/c90890db2e0f1c143221772ab76eacb3cafbe23f))\n\n## [0.0.8](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.7...node-emulator-v0.0.8) (2022-10-17)\n\n\n### Bug Fixes\n\n* **NodeEmulator.ts:** export FilesMap type to consumer ([#57](https://github.com/codesandbox/browser-node-emulator/issues/57)) ([d676be5](https://github.com/codesandbox/browser-node-emulator/commit/d676be50f20f6d88bd7bbd6fa9edf3047e5fa8f2))\n\n## [0.0.7](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.6...node-emulator-v0.0.7) (2022-10-14)\n\n\n### Bug Fixes\n\n* **preview:** remove conditional over listener ([#53](https://github.com/codesandbox/browser-node-emulator/issues/53)) ([5c6e8c0](https://github.com/codesandbox/browser-node-emulator/commit/5c6e8c0a0600a3b408f734a17b13a8f37ef8e09d))\n\n## [0.0.6](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.5...node-emulator-v0.0.6) (2022-10-14)\n\n\n### Bug Fixes\n\n* **node-emulator:** trigger a new publish ([4b42c8f](https://github.com/codesandbox/browser-node-emulator/commit/4b42c8f43c8dea0491b48af067b07eb74922848f))\n\n## [0.0.5](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.4...node-emulator-v0.0.5) (2022-10-14)\n\n\n### Features\n\n* **node emulator:** preview interface ([#41](https://github.com/codesandbox/browser-node-emulator/issues/41)) ([e7e66bb](https://github.com/codesandbox/browser-node-emulator/commit/e7e66bbaced7cf5eb20d14b58816e11737f9c3ed))\n\n## [0.0.4](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.3...node-emulator-v0.0.4) (2022-10-11)\n\n\n### Bug Fixes\n\n* **node-emulator:** set build target to es2020 ([#38](https://github.com/codesandbox/browser-node-emulator/issues/38)) ([5ff50fc](https://github.com/codesandbox/browser-node-emulator/commit/5ff50fca586101b6270f5f587900a031466c024a))\n\n## [0.0.3](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.2...node-emulator-v0.0.3) (2022-10-11)\n\n\n### Bug Fixes\n\n* **node-emulator:** trigger a new publish ([baef111](https://github.com/codesandbox/browser-node-emulator/commit/baef111bc1bd3bd34b5ff82fbeaa0a141372c417))\n\n## [0.0.2](https://github.com/codesandbox/browser-node-emulator/compare/node-emulator-v0.0.1...node-emulator-v0.0.2) (2022-10-10)\n\n\n### Bug Fixes\n\n* remove handshake timeout log ([49413a6](https://github.com/codesandbox/browser-node-emulator/commit/49413a6dde5d8300e626298553fb09a9ce32cf4c))\n" }, { "path": "packages/nodebox/LICENSE", "content": "Sustainable Use License\n\nVersion 1.0\n\nAcceptance\n\nBy using the software, you agree to all of the terms and conditions below.\n\nCopyright License\n\nThe licensor grants you a non-exclusive, royalty-free, worldwide, non-sublicensable, non-transferable license to use, copy, distribute, make available, and prepare derivative works of the software, in each case subject to the limitations below.\n\nLimitations\n\nYou may use or modify the software only for your own internal business purposes or for non-commercial or personal use. You may distribute the software or provide it to others only if you do so free of charge for non-commercial purposes. You may not alter, remove, or obscure any licensing, copyright, or other notices of the licensor in the software. Any use of the licensor's trademarks is subject to applicable law.\n\nPatents\n\nThe licensor grants you a license, under any patent claims the licensor can license, or becomes able to license, to make, have made, use, sell, offer for sale, import and have imported the software, in each case subject to the limitations and conditions in this license. This license does not cover any patent claims that you cause to be infringed by modifications or additions to the software. If you or your company make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.\n\nNotices\n\nYou must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms. If you modify the software, you must include in any modified copies of the software a prominent notice stating that you have modified the software.\n\nNo Other Rights\n\nThese terms do not imply any licenses other than those expressly granted in these terms.\n\nTermination\n\nIf you use the software in violation of these terms, such use is not licensed, and your license will automatically terminate. If the licensor provides you with a notice of your violation, and you cease all violation of this license no later than 30 days after you receive that notice, your license will be reinstated retroactively. However, if you violate these terms after such reinstatement, any additional violation of these terms will cause your license to terminate automatically and permanently.\n\nNo Liability\n\nAs far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.\n\nDefinitions\n\nThe \"licensor\" is CodeSandBox B.V.\n\nThe \"software\" is the software the licensor makes available under these terms, including any portion of it.\n\n\"You\" refers to the individual or entity agreeing to these terms.\n\n\"Your company\" is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. Control means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.\n\n\"Your license\" is the license granted to you for the software under these terms.\n\n\"Use\" means anything you do with the software requiring your license.\n\n\"Trademark\" means trademarks, service marks, and similar rights." }, { "path": "packages/nodebox/README.md", "content": "# Nodebox\n\nNodebox is a runtime for executing Node.js modules in the browser.\n\n## Why we built Nodebox\n\nWith `sandpack-bundler`, we allowed any developer anywhere to instantly create a fast, local, shareable playground inside their browser, without having to wait forever to install dependencies and fight with devtools. This improves the learning, experimentation and sharing experience of client-side JavaScript code.\n\nHowever, server-side JavaScript remained a challenge. At CodeSandbox we have solved this by using [Firecracker VMs](https://codesandbox.io/blog/how-we-clone-a-running-vm-in-2-seconds), allowing us to bring your entire development environment to the cloud regardless of the programming language or tooling you might be using. Unfortunately, as VMs live in the cloud, they require infrastructure and a network connection, resulting in a higher cost compared to our client-side sandboxes.\n\nTo solve this problem, we built Nodebox, a runtime that runs entirely in the browser, eliminating the need for a network connection and infrastructure.\n\nNodebox gives you the same user experience you have come to expect from Sandpack, which means a near-instant server-side JavaScript environment at the click of a button—built for experimentation, examples and documentation.\n\n## The differences between a VM and Nodebox\n\nAs mentioned in the previous section, we solved server-side sandboxes in CodeSandbox by using Firecracker VMs. In this section, we'll explain the advantages and disadvantages of each approach.\n\n### Advantages of VMs over Nodebox\n\n- You get dedicated resources, with no resource limits enforced by the browser\n- You have an entire Unix OS available\n- You can run any language, database, command\n- You can use network sockets\n- You can run large and complex projects\n- A perfect 1:1 environment as compared to your local setup (at least, if you're using a Unix-based system)\n- No emulation, so Node.js would run exactly the same way as locally\n\n### Advantages of Nodebox\n\n- No need for any infrastructure\n- No need for a network connection\n- Instant feedback to any change\n- Easy to get started\n- Easy and instant reset - simply refresh the page/iframe\n- Every page visitor gets their own Nodebox instance automatically\n\n## What makes it different\n\nNodebox is currently the only cross-browser Node.js runtime supporting all the latest browsers:\n\n- Chrome;\n- Firefox;\n- Safari \\*\n\n> - Support for iOS Safari is in beta\n\nNodebox does not emulate Node.js but is, instead, a Node.js-compatible runtime. This means that it implements as much of the Node.js API as possible while keeping a minimal performance imprint, using browser API where applicable and, in some cases, leaving out certain parts of Node.js due to browser [limitations](#Limitations) or complexity.\n\nNodebox uses an internal dependency manager that is fine-tuned to deliver optimal initial load time by utilizing dependency caching via [Sandpack CDN](https://github.com/codesandbox/sandpack-cdn). That CDN is an open-source Rust package manager that runs in the cloud and can be self-hosted pretty easily as well.\n\nWhile there are alternatives to Nodebox, they are closer to mimicking a container-based environment, running commands step-by-step, or even the entire Linux distributive in your browser. That makes them slower and harder to use compared to Nodebox, which is optimized to run sandboxes fast and with as little friction as possible.\n\n## Limitations\n\nUnfortunately, any type of runtime that does not have access to operating system-level APIs will come with certain limitations. For Nodebox, those are the following:\n\n- N-API modules\n- net#Sockets pointing to external IPs\n- Synchronous exec/spawn\n- async_hooks (planned for implementation)\n- Automatic process exiting - users now need to manually call `process.exit` before the process is exited (planned for implementation)\n\nAs we implement every module manually one by one, it is possible that some will not behave correctly. If this happens, feel free to open an issue here on GitHub and we'll make sure to fix it.\n\n## Documentation\n\n- [**Getting started**](#getting-started)\n- [API documentation](https://github.com/codesandbox/nodebox-runtime/blob/main/packages/nodebox/api.md)\n\n---\n\n## Getting started\n\nNodebox is meant for usage in your client-side applications, granting them the capability of running actual Node.js code directly in the browser. Here are a couple of examples of when Nodebox can be used:\n\n- Building interactive examples for server-side code in your documentation;\n- Showcasing a UI component library in the actual framework it's built for;\n- Generally any evaluation of Node.js code and previewing it in the browser.\n\nIn the context of this tutorial, we will be working on a documentation website that illustrates different examples of using a Next.js application. Bear in mind that our documentation itself can be written in any framework of our choosing.\n\n### Install\n\nNodebox can be installed from NPM just like any other dependency:\n\n```sh\nnpm install @codesandbox/nodebox\n```\n\n### Setup\n\nNodebox consists of two main parts:\n\n- A runtime environment evaluating the code;\n- A preview environment serving the result of the evaluation.\n\nCorresponding to these two parts, let's create two iframes in our application:\n\n```html\n\n\n\n\n\n```\n\nAlthough the runtime environment can be self-hosted, we will use the default one pointing to the deployed Nodebox instance on CodeSandbox servers. We do need, however, to specify an `iframe` reference in our application where Nodebox should render its preview.\n\n```js\nimport { Nodebox } from '@codesandbox/nodebox';\n\nconst runtime = new Nodebox({\n // Provide a reference to the \n \n\n" }, { "path": "tests/tsconfig.json", "content": "{\n \"extends\": \"../tsconfig\",\n \"compilerOptions\": {\n \"target\": \"esnext\",\n \"noEmit\": true,\n \"baseUrl\": \"../\",\n \"paths\": {\n \"tests\": [\"./tests\"],\n \"@codesandbox/nodebox\": [\"./packages/nodebox/src\"]\n }\n },\n \"include\": [\"**/*\"]\n}\n" }, { "path": "tsconfig.json", "content": "{\n \"compilerOptions\": {\n \"strict\": true,\n \"noImplicitAny\": true,\n \"allowSyntheticDefaultImports\": true,\n \"moduleResolution\": \"node\",\n \"esModuleInterop\": true,\n \"inlineSourceMap\": true,\n \"useUnknownInCatchVariables\": false,\n \"resolveJsonModule\": true\n },\n \"exclude\": [\"node_modules\", \"build\"]\n}\n" }, { "path": "turbo.json", "content": "{\n \"$schema\": \"https://turborepo.org/schema.json\",\n \"pipeline\": {\n \"build\": {\n \"dependsOn\": [\"^build\"],\n \"outputs\": [\"build/**\"]\n },\n \"test:unit\": {\n \"dependsOn\": [],\n \"outputs\": []\n }\n }\n}\n" }, { "path": "vercel.json", "content": "{\n \"headers\": [\n {\n \"source\": \"/(.*).(js|map|wasm)\",\n \"headers\": [\n {\n \"key\": \"Cache-Control\",\n \"value\": \"public,max-age=31536000,immutable\"\n }\n ]\n },\n {\n \"source\": \"/(.*)\",\n \"headers\": [\n {\n \"key\": \"Cross-Origin-Resource-Policy\",\n \"value\": \"cross-origin\"\n }\n ]\n }\n ]\n}\n" } ]