![\"npm\"](\"https://img.shields.io/npm/v/vercel-node-dev.svg?style=flat-square\")
\n ![\"MIT](\"https://img.shields.io/npm/l/vercel-node-dev.svg?style=flat-square\")
\n ![\"Travis\"](\"https://img.shields.io/travis/ctrlplusb/vercel-node-dev.svg?style=flat-square\")
\n\nAn unofficial development CLI for Vercel applications targeting the Node.js runtime.\n
\n\n\nFast reloads, improved reliability, offline and debugger support.\n
\n\n\n \n \n \n
\n\n## Table of Contents\n\n- [Features](#features)\n- [Motivation](#motivation)\n- [Vercel vs Us?](#vercel-vs-us)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Supported Features](#supported-features)\n- [Supported Frameworks](#supported-frameworks)\n- [Limitations](#limitations)\n- [CLI Options](#cli-options)\n- [Specifying a custom develop command](#specifying-a-custom-develop-command)\n- [Debugging your Lambdas](#debugging-your-lambdas)\n- [Bonus: Unit Testing your Lambdas](#bonus-unit-testing-your-lambdas)\n\n
\n\n## Features\n\n- Optimised for the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Built against the [Vercel specifications](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Supports Vercel [\"Zero Config\"](https://vercel.com/blog/zero-config) approach\n- Supports both JavaScript or TypeScript lambdas\n- Supports the attaching of a debugger session against lambda execution\n- Supports Vercel custom [routes](https://vercel.com/docs/configuration#project/routes) configuration\n- Fast reloading for any changes to your lambdas\n- Extensively tested and verified via an integration test suite\n- Can be run offline\n- No need for a Vercel project to be configured prior to execution\n- Does not need to be installed as a local dependency\n\n
\n\n## Motivation\n\n[Vercel](https://vercel.com/) provides its own development environment via the `vercel dev` command. Whilst this tool is powerful, I was experiencing the following issues:\n\n- **Performance:** The feedback loop when making changes to my lambdas was very slow. After making a change, the subsequent request to the lamda would result in a significant wait for the lambda to be rebuilt and then served.\n- **Reliability:** When making changes to my lambdas the build performance degraded over time, eventually resulting in them becoming unresponsive. The only way I was able to resolve this was to restart the `vercel dev` command, significantly impacting my development flow.\n- **Debugging:** I was unable to attach a debugger instance against my lambdas. Whilst I try not to overuse the debugger, preferring to leverage integration tests, there are times when a debugger session can work wonders at issue discovery.\n- **Usability:** There was a double hit for me here. Firstly, you need to have first set up / linked your project to a project configuration against Vercel. Secondly, and related to the first point, you need to be connected to the internet in order to use the tool.\n\nThe implementation of `vercel-node-dev` addresses these issues; focussing on the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js), which allowed me to create a much more bespoke and optimised development tool.\n\n
\n\n## Vercel vs Us?\n\nThis tool is **_not_** meant to be **_competitive_**!\n\nIt is released with good intentions and respect for the Vercel team and community, offering a temporary alternative for those who may be experiencing similar issues with their development flow.\n\nThe `vercel dev` command is still in **beta**. My belief is that the Vercel team will eventually address the issues above, at which point this CLI will be deprecated. Given that we are following the official Vercel specifications, this would be a zero impact move for those using this CLI. You would only need to switch to executing the official `vercel dev` command instead of this one.\n\n
\n\n## Installation\n\nWe recommend installing this library globally. This will allow you to quickly and easily use it against any of your Vercel applications, without polluting them with additional dependencies.\n\n```bash\nnpm install -g vercel-node-dev\n```\n\nAfter the installation two CLI commands will be available to you, namely;\n\n- `vercel-node-dev`\n- `vnd` - a shorter aliased version\n\n
\n\n## Usage\n\nSimply navigate to the root of the [Vercel](https://vercel.com/) application and execute the CLI.\n\n```bash\nvercel-node-dev\n```\n\nSimilar to the `vercel dev` command we will attempt to bind the development server against port `3000`.\n\nOpen your web browser and browse to `http://localhost:3000`.\n\n
\n\n## Supported Features\n\nBelow is a list of the official Vercel features that we support.\n\nI don't add any additional API features in comparison to the official APIs.\n\nThe design goal of this tool is to support as much of the official API as possible, whilst providing an improved development experience.\n\n- The [\"Zero Config\"](https://vercel.com/blog/zero-config) approach promoted by Vercel.\n- TypeScript (`.ts`) or JavaScript (`.js`) lambdas, within the `/api` directory, with filesystem based routing.\n- The ability to [ignore files/directories](https://vercel.com/docs/v2/serverless-functions/introduction#prevent-endpoint-listing) within your `/api` directory from being bound as lambdas.\n- [Path segments](https://vercel.com/docs/v2/serverless-functions/introduction#path-segments) for your lambdas.\n- A [custom build step](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/custom-build-step-for-node-js), which will be executed prior to the execution of your lambdas.\n- Automatic exposure of any environment variables defined within the `.env` file defined in the root of the project. This is inline with the [approach recommended by Vercel](https://vercel.com/docs/v2/build-step#environment-variables) for managing environment variables.\n- Automated [extension of the HTTP Request and Response objects](https://vercel.com/docs/runtimes#official-runtimes/node-js/node-js-request-and-response-objects/node-js-helpers) that are passed into your lambdas.\n- Custom [routes](https://vercel.com/docs/configuration#project/routes) configuration.\n\nWe follows the design, API, and features of the official [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js) as closely as possible.\n\nThe [official docs](https://vercel.com/docs/runtimes#official-runtimes/node-js) and [advanced usage docs](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage) should be used as your reference for understanding the above features in detail.\n\n**Todo**\n\nThe following configuration options will be supported in the near future:\n\n- [cleanUrls](https://vercel.com/docs/configuration#project/cleanurls)\n- [trailingSlash](https://vercel.com/docs/configuration#project/trailingslash)\n\n
\n\n## Supported Frameworks\n\nI have tested the CLI against the following frameworks, utilising the [\"Zero Config\"](https://vercel.com/blog/zero-config) approach.\n\n- [x] Create React App\n- [x] Create React App + TypeScript\n- [x] Gatsby\n- [x] Vue.js\n- [ ] Svelte\n- [ ] Angular\n- [ ] Ember.js\n- [ ] Hugo\n- [ ] Preact\n- [ ] Docusaurus\n- [ ] Gridsome\n- [ ] Nuxt.js\n- [ ] Eleventy\n- [ ] Hexo\n\n
\n\n## Limitations\n\nBelow is a list of the Vercel features that this CLI does not support. These limitations are intentional, and the likelihood is that I will not extend the CLI to support them.\n\n- Support for any of the other runtimes - i.e. Go, Ruby, Python, or bespoke.\n\n > I feel like Node.js is where Vercel really shines, and IMO feel like they should have gone all in on Node.js rather than supporting an array of runtimes.\n\n- Support for any of the following [`vercel.json` configuration](https://vercel.com/docs/configuration#introduction) options:\n\n - [headers](https://vercel.com/docs/configuration#project/headers)\n - [redirects](https://vercel.com/docs/configuration#project/redirects)\n - [rewrites](https://vercel.com/docs/configuration#project/rewrites)\n\n > Despair not! All of these configuration options can be represented via the [routes](https://vercel.com/docs/configuration#project/routes) configuration, which is supported.\n\n- Support for the raw AWS lambda API, which is currently [supported by the official Node.js runtime](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/aws-lambda-api)\n\n > As stated in their docs, this has been exposed to help clients with existing lambdas migrate over to their platform. I'm not convinced this alternative CLI should support this.\n\n- The bespoke [Vercel](https://vercel.com/) 4XX / 5XX error pages.\n\n > Meh. I return the expected error codes. I'd recommend you implement your own custom error pages in your UI anyways.\n\n- Support for [disabling the Node.js helpers](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/disabling-helpers-for-node-js)\n\n > This has more of an impact on production environments, where you would want to hyper optimise lambda performance in some cases.\n\n- Support for [Next.js](https://nextjs.org/) projects.\n\n > Next has it's own development server with bespoke features around the APIs and pages. I would recommend using the `next dev` command instead.\n\n
\n\n## CLI Options\n\nThe CLI current supports the following options.\n\n- `--debug-apis` | `-d`\n\n Setting this flag will enable the debugger against your lambdas.\n\n- `--debug-apis-port [number]` | `-o [number]`\n\n Allows you to specify the port at which the debugger for your lambdas will run. By default it runs on port `9229`.\n\n- `--port [number]` | `-p [number]`\n\n Allows you to specify the port at which the `vercel-node-dev` server will run. By default it will attempt to bind to port `3000`.\n\n
\n\n## Specifying a custom develop command\n\nIf you aren't using one of the [supported frameworks](#supported-frameworks), or if you would like to customise the develop command, then you can add a `dev` script to your `package.json`:\n\n```json\n{\n \"scripts\": {\n \"dev\": \"my-dev-tool -p $PORT\"\n }\n}\n```\n\n**Note:** It is important that you pass through the `$PORT` environment variable as shown in the example above. This is so that your development server can be correctly managed by `vercel-node-dev`.\n\n
\n\n## Debugging your Lambdas\n\nYou can enabled the debugger for your lambdas by providing the respective option to the CLI:\n\n```bash\nvercel-node-dev --debug-apis\n```\n\nThis will start the development server, with the debugger instance running. By default the debugger runs on port `9229`. You can change the port number via the `--debug-apis-port` option.\n\nOnce the debugger is running you can attach to it utilising your tool of choice.\n\n### Debugging via VSCode\n\nBelow is a set of [`code` debug configurations](https://code.visualstudio.com/docs/editor/debugging), allowing you to either start the `vercel-dev-node` instance with the debugger attached, or to attach to an already executing debugger instance.\n\n```jsonc\n{\n \"version\": \"0.2.0\",\n \"configurations\": [\n // This will start vercel-node-dev with the debugger attached\n {\n \"name\": \"Launch vercel-node-dev\",\n \"type\": \"node\",\n \"request\": \"launch\",\n \"program\": \"vercel-node-dev\",\n \"args\": [\"--debug-apis\"],\n \"skipFiles\": [\"
\n\n## Bonus: Unit Testing your Lambdas\n\nThis tool leverages another library I built, [`vercel-node-server`](https://github.com/ctrlplusb/vercel-node-server), which allows you to create `http` instances of your lambdas. This opens up opportunities for you to write integration or unit tests for you lambdas.\n\nFirstly, install the library as development dependency:\n\n```bash\nnpm install -D vercel-node-server\n```\n\nYou can then write tests for your lambdas similar to the one below:\n\n```javascript\nimport { createServer } from 'vercel-node-server';\nimport listen from 'test-listen';\nimport axios from 'axios';\nimport helloLambda from './api/hello';\n\nlet server;\nlet url;\n\nbeforeAll(async () => {\n server = createServer(routeUnderTest);\n url = await listen(server);\n});\n\nafterAll(() => {\n server.close();\n});\n\nit('should return the expected response', async () => {\n const response = await axios.get(url, { params: { name: 'Pearl' } });\n expect(response.data).toBe('Hello Pearl');\n});\n```\n","readmeFilename":"README.md","gitHead":"1f56cd048136261eebd8278f92683ce65fd66965","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.5.0-alpha.0","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-cUPLDuoaYXJDPKFXz3ZKbrOxMbvwm3q03DmzE7WQ371Kcc6QCQLLtBSraEJ4uIbCgliErH7re1UUxzlbDld18w==","shasum":"1e067c6223f5b00409d53d505f906af116d7e844","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.5.0-alpha.0.tgz","fileCount":18,"unpackedSize":65526,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe3z4QCRA9TVsSAnZWagAA9d4QAKQ3ejGuYHx8jHQy6xjc\nbDEEBCkDPwPURVrUrvpYtFZ7tFYWxD3BziF7mciZB2ZbWEqTMIZQBocj+AAc\noEAq3ES2+ulNLlmkCGfBICL27o7ZdoIS3dm3u98vPjBZahlb46wPt/vDnfkQ\nwmETYWxBZ2/ikp6TYZEmNDmF+FgNQmelz0QtuHCfiMwy0AwkGq1teoXCF0oj\nh9DDIIpdGH2SZqXdgupsTdst5E/D5buwU9mF9zW1FgYg1aTChwAVaR/SBrF9\nOuy0Dta+habdDOrGgcPZm1M5jISHfUzVhaGMQ50li9gI9jifiFn+MngYEz89\nf1F8uhn9zwGGkHkOAh5qNxVn6gYINTpMpg+tXH+Eazz6AtwWLkuNVrodL8JC\nhL9tcS2QkpatrNvlW0+923VgfQgF+iS3FOoZVdzGrsyQpC+UHzok9vmfpov6\nlL/8EES2hWMCU7Y34z+MF39g19Ye3l4Q5Y50VypW0UXwqQd3DRTB5mzYCY1p\n4nZ5y5l4SIFtYIAEtAq6kMtRXfN2nY1EsCuLfByp2a/u7rNCzfy7DWv1VGxX\ngau4gVfkwoaUuXB8EJfftKAvmcSiWNNY9ymIkUne/PH/hpgicPB2INfdIxP4\nW17G8HNjovST2/zmHwvHCYGDwBjkV5XCi7mPc+c11Zj6EpnJGul1OAEcXYNE\nZ1g6\r\n=8iLQ\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIDjzCYEYukKT+P5btmBFKC7+EQJDKEKhwRFr5LCX7tT4AiEAhp7JnlxDL9NY/bIRsO6tpgkHE7tS+h3Ynzf8FlPyjH0="}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.5.0-alpha.0_1591688720494_0.2898784851285239"},"_hasShrinkwrap":false},"0.5.0-alpha.1":{"name":"vercel-node-dev","version":"0.5.0-alpha.1","description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","license":"MIT","author":{"name":"Sean Matheson"},"repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"bin":{"vercel-node-dev":"bin/vercel-node-dev","vnd":"bin/vercel-node-dev"},"engines":{"node":">=10"},"scripts":{"test":"jest","experiment":"FORCE_COLOR=1 VND_TARGET_PATH=targets/finished node -r ts-node/register --preserve-symlinks src"},"dependencies":{"@vercel/build-utils":"^2.3.1","@vercel/frameworks":"^0.0.14","@vercel/node":"^1.6.1","@vercel/routing-utils":"^1.8.2","chalk":"^4.0.0","dedent":"^0.7.0","dotenv":"^8.2.0","execa":"^4.0.2","fs-extra":"^9.0.1","get-port":"^5.1.1","globby":"^11.0.1","http-proxy":"^1.18.1","load-json-file":"^6.2.0","meow":"^7.0.1","npm-run":"^5.0.1","p-timeout":"^3.2.0","pretty-format":"^26.0.1","tempy":"^0.5.0","ts-node-dev":"^1.0.0-pre.44","typescript":"^3.9.5","vercel-node-server":"^2.2.1","wait-port":"^0.2.9","write-json-file":"^4.3.0"},"devDependencies":{"@types/dedent":"^0.7.0","@types/fs-extra":"^9.0.1","@types/http-proxy":"^1.17.4","@types/jest":"^25.2.1","@types/node":"^14.0.12","@typescript-eslint/eslint-plugin":"^3.2.0","@typescript-eslint/parser":"^3.2.0","axios":"^0.19.2","babel-eslint":"^10.1.0","eslint":"^7.1.0","eslint-config-prettier":"^6.11.0","eslint-config-react-app":"^5.2.1","eslint-plugin-flowtype":"^5.1.3","eslint-plugin-import":"^2.21.1","eslint-plugin-jsx-a11y":"^6.2.3","eslint-plugin-prettier":"^3.1.3","eslint-plugin-react":"^7.20.0","eslint-plugin-react-hooks":"^4.0.4","husky":"^4.2.5","jest":"^26.0.1","prettier":"^2.0.5","ts-jest":"^26.1.0"},"prettier":{"semi":true,"singleQuote":true,"trailingComma":"all"},"eslintConfig":{"root":true,"parser":"@typescript-eslint/parser","extends":["react-app","plugin:@typescript-eslint/recommended","prettier","prettier/@typescript-eslint"],"plugins":["@typescript-eslint"],"env":{"commonjs":true,"es6":true,"node":true,"jest":true},"rules":{"@typescript-eslint/explicit-function-return-type":0}},"eslintIgnore":["**/node_modules/*"],"readme":"
\nAn unofficial development CLI for Vercel applications targeting the Node.js runtime.\n
\n\n\nFast reloads, improved reliability, offline and debugger support.\n
\n\n\n \n \n \n
\n\n## Table of Contents\n\n- [Features](#features)\n- [Motivation](#motivation)\n- [Vercel vs Us?](#vercel-vs-us)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Supported Features](#supported-features)\n- [Supported Frameworks](#supported-frameworks)\n- [Limitations](#limitations)\n- [CLI Options](#cli-options)\n- [Specifying a custom develop command](#specifying-a-custom-develop-command)\n- [Debugging your Lambdas](#debugging-your-lambdas)\n- [Bonus: Unit Testing your Lambdas](#bonus-unit-testing-your-lambdas)\n\n
\n\n## Features\n\n- Optimised for the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Built against the [Vercel specifications](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Supports Vercel [\"Zero Config\"](https://vercel.com/blog/zero-config) approach\n- Supports both JavaScript or TypeScript lambdas\n- Supports the attaching of a debugger session against lambda execution\n- Supports Vercel custom [routes](https://vercel.com/docs/configuration#project/routes) configuration\n- Fast reloading for any changes to your lambdas\n- Extensively tested and verified via an integration test suite\n- Can be run offline\n- No need for a Vercel project to be configured prior to execution\n- Does not need to be installed as a local dependency\n\n
\n\n## Motivation\n\n[Vercel](https://vercel.com/) provides its own development environment via the `vercel dev` command. Whilst this tool is powerful, I was experiencing the following issues:\n\n- **Performance:** The feedback loop when making changes to my lambdas was very slow. After making a change, the subsequent request to the lamda would result in a significant wait for the lambda to be rebuilt and then served.\n- **Reliability:** When making changes to my lambdas the build performance degraded over time, eventually resulting in them becoming unresponsive. The only way I was able to resolve this was to restart the `vercel dev` command, significantly impacting my development flow.\n- **Debugging:** I was unable to attach a debugger instance against my lambdas. Whilst I try not to overuse the debugger, preferring to leverage integration tests, there are times when a debugger session can work wonders at issue discovery.\n- **Usability:** There was a double hit for me here. Firstly, you need to have first set up / linked your project to a project configuration against Vercel. Secondly, and related to the first point, you need to be connected to the internet in order to use the tool.\n\nThe implementation of `vercel-node-dev` addresses these issues; focussing on the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js), which allowed me to create a much more bespoke and optimised development tool.\n\n
\n\n## Vercel vs Us?\n\nThis tool is **_not_** meant to be **_competitive_**!\n\nIt is released with good intentions and respect for the Vercel team and community, offering a temporary alternative for those who may be experiencing similar issues with their development flow.\n\nThe `vercel dev` command is still in **beta**. My belief is that the Vercel team will eventually address the issues above, at which point this CLI will be deprecated. Given that we are following the official Vercel specifications, this would be a zero impact move for those using this CLI. You would only need to switch to executing the official `vercel dev` command instead of this one.\n\n
\n\n## Installation\n\nWe recommend installing this library globally. This will allow you to quickly and easily use it against any of your Vercel applications, without polluting them with additional dependencies.\n\n```bash\nnpm install -g vercel-node-dev\n```\n\nAfter the installation two CLI commands will be available to you, namely;\n\n- `vercel-node-dev`\n- `vnd` - a shorter aliased version\n\n
\n\n## Usage\n\nSimply navigate to the root of the [Vercel](https://vercel.com/) application and execute the CLI.\n\n```bash\nvercel-node-dev\n```\n\nSimilar to the `vercel dev` command we will attempt to bind the development server against port `3000`.\n\nOpen your web browser and browse to `http://localhost:3000`.\n\n
\n\n## Supported Features\n\nBelow is a list of the official Vercel features that we support.\n\nI don't add any additional API features in comparison to the official APIs.\n\nThe design goal of this tool is to support as much of the official API as possible, whilst providing an improved development experience.\n\n- The [\"Zero Config\"](https://vercel.com/blog/zero-config) approach promoted by Vercel.\n- TypeScript (`.ts`) or JavaScript (`.js`) lambdas, within the `/api` directory, with filesystem based routing.\n- The ability to [ignore files/directories](https://vercel.com/docs/v2/serverless-functions/introduction#prevent-endpoint-listing) within your `/api` directory from being bound as lambdas.\n- [Path segments](https://vercel.com/docs/v2/serverless-functions/introduction#path-segments) for your lambdas.\n- A [custom build step](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/custom-build-step-for-node-js), which will be executed prior to the execution of your lambdas.\n- Automatic exposure of any environment variables defined within the `.env` file defined in the root of the project. This is inline with the [approach recommended by Vercel](https://vercel.com/docs/v2/build-step#environment-variables) for managing environment variables.\n- Automated [extension of the HTTP Request and Response objects](https://vercel.com/docs/runtimes#official-runtimes/node-js/node-js-request-and-response-objects/node-js-helpers) that are passed into your lambdas.\n- Custom [routes](https://vercel.com/docs/configuration#project/routes) configuration.\n\nWe follows the design, API, and features of the official [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js) as closely as possible.\n\nThe [official docs](https://vercel.com/docs/runtimes#official-runtimes/node-js) and [advanced usage docs](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage) should be used as your reference for understanding the above features in detail.\n\n**Todo**\n\nThe following configuration options will be supported in the near future:\n\n- [cleanUrls](https://vercel.com/docs/configuration#project/cleanurls)\n- [trailingSlash](https://vercel.com/docs/configuration#project/trailingslash)\n\n
\n\n## Supported Frameworks\n\nI have tested the CLI against the following frameworks, utilising the [\"Zero Config\"](https://vercel.com/blog/zero-config) approach.\n\n- [x] Create React App\n- [x] Create React App + TypeScript\n- [x] Gatsby\n- [x] Vue.js\n- [ ] Svelte\n- [ ] Angular\n- [ ] Ember.js\n- [ ] Hugo\n- [ ] Preact\n- [ ] Docusaurus\n- [ ] Gridsome\n- [ ] Nuxt.js\n- [ ] Eleventy\n- [ ] Hexo\n\n
\n\n## Limitations\n\nBelow is a list of the Vercel features that this CLI does not support. These limitations are intentional, and the likelihood is that I will not extend the CLI to support them.\n\n- Support for any of the other runtimes - i.e. Go, Ruby, Python, or bespoke.\n\n > I feel like Node.js is where Vercel really shines, and IMO feel like they should have gone all in on Node.js rather than supporting an array of runtimes.\n\n- Support for any of the following [`vercel.json` configuration](https://vercel.com/docs/configuration#introduction) options:\n\n - [headers](https://vercel.com/docs/configuration#project/headers)\n - [redirects](https://vercel.com/docs/configuration#project/redirects)\n - [rewrites](https://vercel.com/docs/configuration#project/rewrites)\n\n > Despair not! All of these configuration options can be represented via the [routes](https://vercel.com/docs/configuration#project/routes) configuration, which is supported.\n\n- Support for the raw AWS lambda API, which is currently [supported by the official Node.js runtime](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/aws-lambda-api)\n\n > As stated in their docs, this has been exposed to help clients with existing lambdas migrate over to their platform. I'm not convinced this alternative CLI should support this.\n\n- The bespoke [Vercel](https://vercel.com/) 4XX / 5XX error pages.\n\n > Meh. I return the expected error codes. I'd recommend you implement your own custom error pages in your UI anyways.\n\n- Support for [disabling the Node.js helpers](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/disabling-helpers-for-node-js)\n\n > This has more of an impact on production environments, where you would want to hyper optimise lambda performance in some cases.\n\n- Support for [Next.js](https://nextjs.org/) projects.\n\n > Next has it's own development server with bespoke features around the APIs and pages. I would recommend using the `next dev` command instead.\n\n
\n\n## CLI Options\n\nThe CLI current supports the following options.\n\n- `--debug-apis` | `-d`\n\n Setting this flag will enable the debugger against your lambdas.\n\n- `--debug-apis-port [number]` | `-o [number]`\n\n Allows you to specify the port at which the debugger for your lambdas will run. By default it runs on port `9229`.\n\n- `--port [number]` | `-p [number]`\n\n Allows you to specify the port at which the `vercel-node-dev` server will run. By default it will attempt to bind to port `3000`.\n\n
\n\n## Specifying a custom develop command\n\nIf you aren't using one of the [supported frameworks](#supported-frameworks), or if you would like to customise the develop command, then you can add a `dev` script to your `package.json`:\n\n```json\n{\n \"scripts\": {\n \"dev\": \"my-dev-tool -p $PORT\"\n }\n}\n```\n\n**Note:** It is important that you pass through the `$PORT` environment variable as shown in the example above. This is so that your development server can be correctly managed by `vercel-node-dev`.\n\n
\n\n## Debugging your Lambdas\n\nYou can enabled the debugger for your lambdas by providing the respective option to the CLI:\n\n```bash\nvercel-node-dev --debug-apis\n```\n\nThis will start the development server, with the debugger instance running. By default the debugger runs on port `9229`. You can change the port number via the `--debug-apis-port` option.\n\nOnce the debugger is running you can attach to it utilising your tool of choice.\n\n### Debugging via VSCode\n\nBelow is a set of [`code` debug configurations](https://code.visualstudio.com/docs/editor/debugging), allowing you to either start the `vercel-dev-node` instance with the debugger attached, or to attach to an already executing debugger instance.\n\n```jsonc\n{\n \"version\": \"0.2.0\",\n \"configurations\": [\n // This will start vercel-node-dev with the debugger attached\n {\n \"name\": \"Launch vercel-node-dev\",\n \"type\": \"node\",\n \"request\": \"launch\",\n \"program\": \"vercel-node-dev\",\n \"args\": [\"--debug-apis\"],\n \"skipFiles\": [\"
\n\n## Bonus: Unit Testing your Lambdas\n\nThis tool leverages another library I built, [`vercel-node-server`](https://github.com/ctrlplusb/vercel-node-server), which allows you to create `http` instances of your lambdas. This opens up opportunities for you to write integration or unit tests for you lambdas.\n\nFirstly, install the library as development dependency:\n\n```bash\nnpm install -D vercel-node-server\n```\n\nYou can then write tests for your lambdas similar to the one below:\n\n```javascript\nimport { createServer } from 'vercel-node-server';\nimport listen from 'test-listen';\nimport axios from 'axios';\nimport helloLambda from './api/hello';\n\nlet server;\nlet url;\n\nbeforeAll(async () => {\n server = createServer(routeUnderTest);\n url = await listen(server);\n});\n\nafterAll(() => {\n server.close();\n});\n\nit('should return the expected response', async () => {\n const response = await axios.get(url, { params: { name: 'Pearl' } });\n expect(response.data).toBe('Hello Pearl');\n});\n```\n","readmeFilename":"README.md","gitHead":"1f56cd048136261eebd8278f92683ce65fd66965","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.5.0-alpha.1","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-1xM7Iy8GabQ1FVEXr8zoLtxRVndEjHG15/NiOVQAwP5lnDJmtviL23h49egvKrsjvOI2/tEs8ZLPniLBsBcl7w==","shasum":"9fe4374b87b3bd99913176fe56d72b613fe74ace","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.5.0-alpha.1.tgz","fileCount":18,"unpackedSize":65509,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe3z7UCRA9TVsSAnZWagAA9tEP/jb7YHzDhAFFBMki6Y3n\nahQIaDd/Zjg+imHqoUeBwFlRxKDSGz5asB4KawnCoBcHgqqzFbR3+PlzyAKI\nVgiNj1LzzZYDPlaxP+RdMrcQVb4PzzTOFHCdfkywXRJC+kGfqZWTLGFJPgwF\n3EUPRv5Kg94BsHVV2XVyBkbtG3RZI9U+I11yQ7+O1Isahz16foaaBEhSdnZf\nYhF0xANjriDb7z4IWujIKHa0fiLGnR7kqbXuEv7U+j9qtO/WAAwDWqsZyQEF\n1ZC7mvrAx8ZzST8wMNDqU2Y4c0tKBwKALzNB8h5P42TftQsa2Li2ZMitojNE\nFoWdSdqB9V+2xb9VDPYhzeM4Pgeeu2SuYSm7Ny9TBXqh8LLeU02R56USvfDs\n+e+kQmTbok8jR/KMu7uMlK9JypFZOwSXcsYLnNDiP4XQi/6WkMj+zYaBkKLf\nuMdjZfKRxaZDCsBSrXcqeqNtQM2COThhwuBZHnkGAMAvsDD9SAbVNECxkzu7\nVick9LWjH/TZ4ggOVUA8CbJH+nLyEWX5UPY/htth6wT/W5xMxQdJB9ANy/yJ\nxuvBcv1pdI6R7tf5hoXXNMIq0PssQzMtmPDM6qxcC0fiRFIgjl3JkUJ2V2PH\ntPKhuYUEyeBHJEsWf7xK1Df+tjsO1yQOeG9bZeQqPRamnf099n7/lAKLwdLc\ndFjP\r\n=WauD\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCRjWASFcSuNbMJrq6S4eUrqP/jtyqwAENS6QSUiTCGfgIgLrjX5H/0Vi3uC9yqC1yOlNnv4242+jV6PEoFLJVnobA="}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.5.0-alpha.1_1591688916405_0.09435176843690618"},"_hasShrinkwrap":false},"0.5.0-alpha.2":{"name":"vercel-node-dev","version":"0.5.0-alpha.2","description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","license":"MIT","author":{"name":"Sean Matheson"},"repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"bin":{"vercel-node-dev":"bin/vercel-node-dev","vnd":"bin/vercel-node-dev"},"engines":{"node":">=10"},"scripts":{"test":"jest","experiment":"FORCE_COLOR=1 VND_TARGET_PATH=targets/finished node -r ts-node/register --preserve-symlinks src"},"dependencies":{"@vercel/build-utils":"^2.3.1","@vercel/frameworks":"^0.0.14","@vercel/node":"^1.6.1","@vercel/routing-utils":"^1.8.2","chalk":"^4.0.0","dedent":"^0.7.0","dotenv":"^8.2.0","execa":"^4.0.2","fs-extra":"^9.0.1","get-port":"^5.1.1","globby":"^11.0.1","http-proxy":"^1.18.1","load-json-file":"^6.2.0","meow":"^7.0.1","npm-run":"^5.0.1","p-timeout":"^3.2.0","pretty-format":"^26.0.1","tempy":"^0.5.0","ts-node-dev":"^1.0.0-pre.44","typescript":"^3.9.5","vercel-node-server":"^2.2.1","wait-port":"^0.2.9","write-json-file":"^4.3.0"},"devDependencies":{"@types/dedent":"^0.7.0","@types/fs-extra":"^9.0.1","@types/http-proxy":"^1.17.4","@types/jest":"^25.2.1","@types/node":"^14.0.12","@typescript-eslint/eslint-plugin":"^3.2.0","@typescript-eslint/parser":"^3.2.0","axios":"^0.19.2","babel-eslint":"^10.1.0","eslint":"^7.1.0","eslint-config-prettier":"^6.11.0","eslint-config-react-app":"^5.2.1","eslint-plugin-flowtype":"^5.1.3","eslint-plugin-import":"^2.21.1","eslint-plugin-jsx-a11y":"^6.2.3","eslint-plugin-prettier":"^3.1.3","eslint-plugin-react":"^7.20.0","eslint-plugin-react-hooks":"^4.0.4","husky":"^4.2.5","jest":"^26.0.1","prettier":"^2.0.5","ts-jest":"^26.1.0"},"prettier":{"semi":true,"singleQuote":true,"trailingComma":"all"},"eslintConfig":{"root":true,"parser":"@typescript-eslint/parser","extends":["react-app","plugin:@typescript-eslint/recommended","prettier","prettier/@typescript-eslint"],"plugins":["@typescript-eslint"],"env":{"commonjs":true,"es6":true,"node":true,"jest":true},"rules":{"@typescript-eslint/explicit-function-return-type":0}},"eslintIgnore":["**/node_modules/*"],"readme":"
\nAn unofficial development CLI for Vercel applications targeting the Node.js runtime.\n
\n\n\nFast reloads, improved reliability, offline and debugger support.\n
\n\n\n \n \n \n
\n\n## Table of Contents\n\n- [Features](#features)\n- [Motivation](#motivation)\n- [Vercel vs Us?](#vercel-vs-us)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Supported Features](#supported-features)\n- [Supported Frameworks](#supported-frameworks)\n- [Limitations](#limitations)\n- [CLI Options](#cli-options)\n- [Specifying a custom develop command](#specifying-a-custom-develop-command)\n- [Debugging your Lambdas](#debugging-your-lambdas)\n- [Bonus: Unit Testing your Lambdas](#bonus-unit-testing-your-lambdas)\n\n
\n\n## Features\n\n- Optimised for the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Built against the [Vercel specifications](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Supports Vercel [\"Zero Config\"](https://vercel.com/blog/zero-config) approach\n- Supports both JavaScript or TypeScript lambdas\n- Supports the attaching of a debugger session against lambda execution\n- Supports Vercel custom [routes](https://vercel.com/docs/configuration#project/routes) configuration\n- Fast reloading for any changes to your lambdas\n- Extensively tested and verified via an integration test suite\n- Can be run offline\n- No need for a Vercel project to be configured prior to execution\n- Does not need to be installed as a local dependency\n\n
\n\n## Motivation\n\n[Vercel](https://vercel.com/) provides its own development environment via the `vercel dev` command. Whilst this tool is powerful, I was experiencing the following issues:\n\n- **Performance:** The feedback loop when making changes to my lambdas was very slow. After making a change, the subsequent request to the lamda would result in a significant wait for the lambda to be rebuilt and then served.\n- **Reliability:** When making changes to my lambdas the build performance degraded over time, eventually resulting in them becoming unresponsive. The only way I was able to resolve this was to restart the `vercel dev` command, significantly impacting my development flow.\n- **Debugging:** I was unable to attach a debugger instance against my lambdas. Whilst I try not to overuse the debugger, preferring to leverage integration tests, there are times when a debugger session can work wonders at issue discovery.\n- **Usability:** There was a double hit for me here. Firstly, you need to have first set up / linked your project to a project configuration against Vercel. Secondly, and related to the first point, you need to be connected to the internet in order to use the tool.\n\nThe implementation of `vercel-node-dev` addresses these issues; focussing on the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js), which allowed me to create a much more bespoke and optimised development tool.\n\n
\n\n## Vercel vs Us?\n\nThis tool is **_not_** meant to be **_competitive_**!\n\nIt is released with good intentions and respect for the Vercel team and community, offering a temporary alternative for those who may be experiencing similar issues with their development flow.\n\nThe `vercel dev` command is still in **beta**. My belief is that the Vercel team will eventually address the issues above, at which point this CLI will be deprecated. Given that we are following the official Vercel specifications, this would be a zero impact move for those using this CLI. You would only need to switch to executing the official `vercel dev` command instead of this one.\n\n
\n\n## Installation\n\nWe recommend installing this library globally. This will allow you to quickly and easily use it against any of your Vercel applications, without polluting them with additional dependencies.\n\n```bash\nnpm install -g vercel-node-dev\n```\n\nAfter the installation two CLI commands will be available to you, namely;\n\n- `vercel-node-dev`\n- `vnd` - a shorter aliased version\n\n
\n\n## Usage\n\nSimply navigate to the root of the [Vercel](https://vercel.com/) application and execute the CLI.\n\n```bash\nvercel-node-dev\n```\n\nSimilar to the `vercel dev` command we will attempt to bind the development server against port `3000`.\n\nOpen your web browser and browse to `http://localhost:3000`.\n\n
\n\n## Supported Features\n\nBelow is a list of the official Vercel features that we support.\n\nI don't add any additional API features in comparison to the official APIs.\n\nThe design goal of this tool is to support as much of the official API as possible, whilst providing an improved development experience.\n\n- The [\"Zero Config\"](https://vercel.com/blog/zero-config) approach promoted by Vercel.\n- TypeScript (`.ts`) or JavaScript (`.js`) lambdas, within the `/api` directory, with filesystem based routing.\n- The ability to [ignore files/directories](https://vercel.com/docs/v2/serverless-functions/introduction#prevent-endpoint-listing) within your `/api` directory from being bound as lambdas.\n- [Path segments](https://vercel.com/docs/v2/serverless-functions/introduction#path-segments) for your lambdas.\n- A [custom build step](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/custom-build-step-for-node-js), which will be executed prior to the execution of your lambdas.\n- Automatic exposure of any environment variables defined within the `.env` file defined in the root of the project. This is inline with the [approach recommended by Vercel](https://vercel.com/docs/v2/build-step#environment-variables) for managing environment variables.\n- Automated [extension of the HTTP Request and Response objects](https://vercel.com/docs/runtimes#official-runtimes/node-js/node-js-request-and-response-objects/node-js-helpers) that are passed into your lambdas.\n- Custom [routes](https://vercel.com/docs/configuration#project/routes) configuration.\n\nWe follows the design, API, and features of the official [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js) as closely as possible.\n\nThe [official docs](https://vercel.com/docs/runtimes#official-runtimes/node-js) and [advanced usage docs](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage) should be used as your reference for understanding the above features in detail.\n\n**Todo**\n\nThe following configuration options will be supported in the near future:\n\n- [cleanUrls](https://vercel.com/docs/configuration#project/cleanurls)\n- [trailingSlash](https://vercel.com/docs/configuration#project/trailingslash)\n\n
\n\n## Supported Frameworks\n\nI have tested the CLI against the following frameworks, utilising the [\"Zero Config\"](https://vercel.com/blog/zero-config) approach.\n\n- [x] Create React App\n- [x] Create React App + TypeScript\n- [x] Gatsby\n- [x] Vue.js\n- [ ] Svelte\n- [ ] Angular\n- [ ] Ember.js\n- [ ] Hugo\n- [ ] Preact\n- [ ] Docusaurus\n- [ ] Gridsome\n- [ ] Nuxt.js\n- [ ] Eleventy\n- [ ] Hexo\n\n
\n\n## Limitations\n\nBelow is a list of the Vercel features that this CLI does not support. These limitations are intentional, and the likelihood is that I will not extend the CLI to support them.\n\n- Support for any of the other runtimes - i.e. Go, Ruby, Python, or bespoke.\n\n > I feel like Node.js is where Vercel really shines, and IMO feel like they should have gone all in on Node.js rather than supporting an array of runtimes.\n\n- Support for any of the following [`vercel.json` configuration](https://vercel.com/docs/configuration#introduction) options:\n\n - [headers](https://vercel.com/docs/configuration#project/headers)\n - [redirects](https://vercel.com/docs/configuration#project/redirects)\n - [rewrites](https://vercel.com/docs/configuration#project/rewrites)\n\n > Despair not! All of these configuration options can be represented via the [routes](https://vercel.com/docs/configuration#project/routes) configuration, which is supported.\n\n- Support for the raw AWS lambda API, which is currently [supported by the official Node.js runtime](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/aws-lambda-api)\n\n > As stated in their docs, this has been exposed to help clients with existing lambdas migrate over to their platform. I'm not convinced this alternative CLI should support this.\n\n- The bespoke [Vercel](https://vercel.com/) 4XX / 5XX error pages.\n\n > Meh. I return the expected error codes. I'd recommend you implement your own custom error pages in your UI anyways.\n\n- Support for [disabling the Node.js helpers](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/disabling-helpers-for-node-js)\n\n > This has more of an impact on production environments, where you would want to hyper optimise lambda performance in some cases.\n\n- Support for [Next.js](https://nextjs.org/) projects.\n\n > Next has it's own development server with bespoke features around the APIs and pages. I would recommend using the `next dev` command instead.\n\n
\n\n## CLI Options\n\nThe CLI current supports the following options.\n\n- `--debug-apis` | `-d`\n\n Setting this flag will enable the debugger against your lambdas.\n\n- `--debug-apis-port [number]` | `-o [number]`\n\n Allows you to specify the port at which the debugger for your lambdas will run. By default it runs on port `9229`.\n\n- `--port [number]` | `-p [number]`\n\n Allows you to specify the port at which the `vercel-node-dev` server will run. By default it will attempt to bind to port `3000`.\n\n
\n\n## Specifying a custom develop command\n\nIf you aren't using one of the [supported frameworks](#supported-frameworks), or if you would like to customise the develop command, then you can add a `dev` script to your `package.json`:\n\n```json\n{\n \"scripts\": {\n \"dev\": \"my-dev-tool -p $PORT\"\n }\n}\n```\n\n**Note:** It is important that you pass through the `$PORT` environment variable as shown in the example above. This is so that your development server can be correctly managed by `vercel-node-dev`.\n\n
\n\n## Debugging your Lambdas\n\nYou can enabled the debugger for your lambdas by providing the respective option to the CLI:\n\n```bash\nvercel-node-dev --debug-apis\n```\n\nThis will start the development server, with the debugger instance running. By default the debugger runs on port `9229`. You can change the port number via the `--debug-apis-port` option.\n\nOnce the debugger is running you can attach to it utilising your tool of choice.\n\n### Debugging via VSCode\n\nBelow is a set of [`code` debug configurations](https://code.visualstudio.com/docs/editor/debugging), allowing you to either start the `vercel-dev-node` instance with the debugger attached, or to attach to an already executing debugger instance.\n\n```jsonc\n{\n \"version\": \"0.2.0\",\n \"configurations\": [\n // This will start vercel-node-dev with the debugger attached\n {\n \"name\": \"Launch vercel-node-dev\",\n \"type\": \"node\",\n \"request\": \"launch\",\n \"program\": \"vercel-node-dev\",\n \"args\": [\"--debug-apis\"],\n \"skipFiles\": [\"
\n\n## Bonus: Unit Testing your Lambdas\n\nThis tool leverages another library I built, [`vercel-node-server`](https://github.com/ctrlplusb/vercel-node-server), which allows you to create `http` instances of your lambdas. This opens up opportunities for you to write integration or unit tests for you lambdas.\n\nFirstly, install the library as development dependency:\n\n```bash\nnpm install -D vercel-node-server\n```\n\nYou can then write tests for your lambdas similar to the one below:\n\n```javascript\nimport { createServer } from 'vercel-node-server';\nimport listen from 'test-listen';\nimport axios from 'axios';\nimport helloLambda from './api/hello';\n\nlet server;\nlet url;\n\nbeforeAll(async () => {\n server = createServer(routeUnderTest);\n url = await listen(server);\n});\n\nafterAll(() => {\n server.close();\n});\n\nit('should return the expected response', async () => {\n const response = await axios.get(url, { params: { name: 'Pearl' } });\n expect(response.data).toBe('Hello Pearl');\n});\n```\n","readmeFilename":"README.md","gitHead":"1f56cd048136261eebd8278f92683ce65fd66965","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.5.0-alpha.2","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-/+7Ut+lWvdqDKEwJRL3dCQNMmhys2nuZZ6e7C04WUCUh7i19RtnxW3C+FcnInR/5jtz1grdXZjWjPOi0NaUYHQ==","shasum":"96d6a5a4b230dcfdd2871efa5bfc99fdc05abaf5","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.5.0-alpha.2.tgz","fileCount":18,"unpackedSize":65511,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe3z+NCRA9TVsSAnZWagAAj4wQAIHBgcZUTTHqkZF4WppM\nDTh0eiwQLWvNTd2PUtRkUOuBiaAmXjhIt0yqp0Jw/4w7ZUuF02p/9QSsuyE8\nxB0uhXvEm6nFcSjK6zLgQao54HNrGQWYW/49KYI7faymY75bCZbfyP6f6LIc\nZOPUfpJvwFfDO20fCmllsbIaCx/zuNMvyK0I24AoiEnI740EHUnOjkBcOL+I\nv1OlCeFozTH6qpBH37HebVWtqMLz1HRlRScEd1HZFSl5dAhX+3DFqDpZX8XB\nrxvZcg7aix9SiXkFR08zVdA5WyrPHMo2wxZPHEIggzYB5G9l8h0edjz3ZDGA\n4h5Ubb5lVkoR8S3K9wpfh3qsp7ABeZR0Q+rldDnbYCrtJtykbIUwj9abwiJH\nbFkljmyQrGto361QPHwj28uSeNI1SLwdu+LKpcRoWgJVRhwX5h3l27ejEkoi\n1HIyEtU++1EZqxGvnaVckUot1wwKB6O80TD+494jWqFxXLI6dizJAhB9VhWS\n87XwNWpGrhGRZPwrTqAhddQIjyc0lKy2lzH7kEHJGeDN+fIXSZOKG35S5qMj\nZef07jkLVpLCFdbl0RTWM/3Q7jBCP+pZXBq0p16G6+EMv1hMg2W3zMrqlFMF\nK3l1Fqjsnc37Ozn5RyUSnstaCbpN5tdRFSpaNl4wrQn4dQK34Q19eEQg6W6a\nUVtX\r\n=6ybf\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCUfC1fTbVJAXML1Z2PCh3hSvvszCmEQlWbjCiJcGifBwIhAJwbjHVPOIgUgVxTljq51E686TIqt9ZTxcT981/H5wnl"}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.5.0-alpha.2_1591689101000_0.8122578218739591"},"_hasShrinkwrap":false},"0.5.0-alpha.3":{"name":"vercel-node-dev","version":"0.5.0-alpha.3","description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","license":"MIT","author":{"name":"Sean Matheson"},"repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"bin":{"vercel-node-dev":"bin/vercel-node-dev","vnd":"bin/vercel-node-dev"},"engines":{"node":">=10"},"scripts":{"test":"jest","experiment":"FORCE_COLOR=1 VND_TARGET_PATH=targets/finished node -r ts-node/register --preserve-symlinks src"},"dependencies":{"@vercel/build-utils":"^2.3.1","@vercel/frameworks":"^0.0.14","@vercel/node":"^1.6.1","@vercel/routing-utils":"^1.8.2","chalk":"^4.0.0","dedent":"^0.7.0","dotenv":"^8.2.0","execa":"^4.0.2","fs-extra":"^9.0.1","get-port":"^5.1.1","globby":"^11.0.1","http-proxy":"^1.18.1","load-json-file":"^6.2.0","meow":"^7.0.1","npm-run":"^5.0.1","p-timeout":"^3.2.0","pretty-format":"^26.0.1","tempy":"^0.5.0","ts-node-dev":"^1.0.0-pre.44","typescript":"^3.9.5","vercel-node-server":"^2.2.1","wait-port":"^0.2.9","write-json-file":"^4.3.0"},"devDependencies":{"@types/dedent":"^0.7.0","@types/fs-extra":"^9.0.1","@types/http-proxy":"^1.17.4","@types/jest":"^25.2.1","@types/node":"^14.0.12","@typescript-eslint/eslint-plugin":"^3.2.0","@typescript-eslint/parser":"^3.2.0","axios":"^0.19.2","babel-eslint":"^10.1.0","eslint":"^7.1.0","eslint-config-prettier":"^6.11.0","eslint-config-react-app":"^5.2.1","eslint-plugin-flowtype":"^5.1.3","eslint-plugin-import":"^2.21.1","eslint-plugin-jsx-a11y":"^6.2.3","eslint-plugin-prettier":"^3.1.3","eslint-plugin-react":"^7.20.0","eslint-plugin-react-hooks":"^4.0.4","husky":"^4.2.5","jest":"^26.0.1","prettier":"^2.0.5","ts-jest":"^26.1.0"},"prettier":{"semi":true,"singleQuote":true,"trailingComma":"all"},"eslintConfig":{"root":true,"parser":"@typescript-eslint/parser","extends":["react-app","plugin:@typescript-eslint/recommended","prettier","prettier/@typescript-eslint"],"plugins":["@typescript-eslint"],"env":{"commonjs":true,"es6":true,"node":true,"jest":true},"rules":{"@typescript-eslint/explicit-function-return-type":0}},"eslintIgnore":["**/node_modules/*"],"readme":"
\nAn unofficial development CLI for Vercel applications targeting the Node.js runtime.\n
\n\n\nFast reloads, improved reliability, offline and debugger support.\n
\n\n\n \n \n \n
\n\n## Table of Contents\n\n- [Features](#features)\n- [Motivation](#motivation)\n- [Vercel vs Us?](#vercel-vs-us)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Supported Features](#supported-features)\n- [Supported Frameworks](#supported-frameworks)\n- [Limitations](#limitations)\n- [CLI Options](#cli-options)\n- [Specifying a custom develop command](#specifying-a-custom-develop-command)\n- [Debugging your Lambdas](#debugging-your-lambdas)\n- [Bonus: Unit Testing your Lambdas](#bonus-unit-testing-your-lambdas)\n\n
\n\n## Features\n\n- Optimised for the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Built against the [Vercel specifications](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Supports Vercel [\"Zero Config\"](https://vercel.com/blog/zero-config) approach\n- Supports both JavaScript or TypeScript lambdas\n- Supports the attaching of a debugger session against lambda execution\n- Supports Vercel custom [routes](https://vercel.com/docs/configuration#project/routes) configuration\n- Fast reloading for any changes to your lambdas\n- Extensively tested and verified via an integration test suite\n- Can be run offline\n- No need for a Vercel project to be configured prior to execution\n- Does not need to be installed as a local dependency\n\n
\n\n## Motivation\n\n[Vercel](https://vercel.com/) provides its own development environment via the `vercel dev` command. Whilst this tool is powerful, I was experiencing the following issues:\n\n- **Performance:** The feedback loop when making changes to my lambdas was very slow. After making a change, the subsequent request to the lamda would result in a significant wait for the lambda to be rebuilt and then served.\n- **Reliability:** When making changes to my lambdas the build performance degraded over time, eventually resulting in them becoming unresponsive. The only way I was able to resolve this was to restart the `vercel dev` command, significantly impacting my development flow.\n- **Debugging:** I was unable to attach a debugger instance against my lambdas. Whilst I try not to overuse the debugger, preferring to leverage integration tests, there are times when a debugger session can work wonders at issue discovery.\n- **Usability:** There was a double hit for me here. Firstly, you need to have first set up / linked your project to a project configuration against Vercel. Secondly, and related to the first point, you need to be connected to the internet in order to use the tool.\n\nThe implementation of `vercel-node-dev` addresses these issues; focussing on the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js), which allowed me to create a much more bespoke and optimised development tool.\n\n
\n\n## Vercel vs Us?\n\nThis tool is **_not_** meant to be **_competitive_**!\n\nIt is released with good intentions and respect for the Vercel team and community, offering a temporary alternative for those who may be experiencing similar issues with their development flow.\n\nThe `vercel dev` command is still in **beta**. My belief is that the Vercel team will eventually address the issues above, at which point this CLI will be deprecated. Given that we are following the official Vercel specifications, this would be a zero impact move for those using this CLI. You would only need to switch to executing the official `vercel dev` command instead of this one.\n\n
\n\n## Installation\n\nWe recommend installing this library globally. This will allow you to quickly and easily use it against any of your Vercel applications, without polluting them with additional dependencies.\n\n```bash\nnpm install -g vercel-node-dev\n```\n\nAfter the installation two CLI commands will be available to you, namely;\n\n- `vercel-node-dev`\n- `vnd` - a shorter aliased version\n\n
\n\n## Usage\n\nSimply navigate to the root of the [Vercel](https://vercel.com/) application and execute the CLI.\n\n```bash\nvercel-node-dev\n```\n\nSimilar to the `vercel dev` command we will attempt to bind the development server against port `3000`.\n\nOpen your web browser and browse to `http://localhost:3000`.\n\n
\n\n## Supported Features\n\nBelow is a list of the official Vercel features that we support.\n\nI don't add any additional API features in comparison to the official APIs.\n\nThe design goal of this tool is to support as much of the official API as possible, whilst providing an improved development experience.\n\n- The [\"Zero Config\"](https://vercel.com/blog/zero-config) approach promoted by Vercel.\n- TypeScript (`.ts`) or JavaScript (`.js`) lambdas, within the `/api` directory, with filesystem based routing.\n- The ability to [ignore files/directories](https://vercel.com/docs/v2/serverless-functions/introduction#prevent-endpoint-listing) within your `/api` directory from being bound as lambdas.\n- [Path segments](https://vercel.com/docs/v2/serverless-functions/introduction#path-segments) for your lambdas.\n- A [custom build step](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/custom-build-step-for-node-js), which will be executed prior to the execution of your lambdas.\n- Automatic exposure of any environment variables defined within the `.env` file defined in the root of the project. This is inline with the [approach recommended by Vercel](https://vercel.com/docs/v2/build-step#environment-variables) for managing environment variables.\n- Automated [extension of the HTTP Request and Response objects](https://vercel.com/docs/runtimes#official-runtimes/node-js/node-js-request-and-response-objects/node-js-helpers) that are passed into your lambdas.\n- Custom [routes](https://vercel.com/docs/configuration#project/routes) configuration.\n\nWe follows the design, API, and features of the official [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js) as closely as possible.\n\nThe [official docs](https://vercel.com/docs/runtimes#official-runtimes/node-js) and [advanced usage docs](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage) should be used as your reference for understanding the above features in detail.\n\n**Todo**\n\nThe following configuration options will be supported in the near future:\n\n- [cleanUrls](https://vercel.com/docs/configuration#project/cleanurls)\n- [trailingSlash](https://vercel.com/docs/configuration#project/trailingslash)\n\n
\n\n## Supported Frameworks\n\nI have tested the CLI against the following frameworks, utilising the [\"Zero Config\"](https://vercel.com/blog/zero-config) approach.\n\n- [x] Create React App\n- [x] Create React App + TypeScript\n- [x] Gatsby\n- [x] Vue.js\n- [ ] Svelte\n- [ ] Angular\n- [ ] Ember.js\n- [ ] Hugo\n- [ ] Preact\n- [ ] Docusaurus\n- [ ] Gridsome\n- [ ] Nuxt.js\n- [ ] Eleventy\n- [ ] Hexo\n\n
\n\n## Limitations\n\nBelow is a list of the Vercel features that this CLI does not support. These limitations are intentional, and the likelihood is that I will not extend the CLI to support them.\n\n- Support for any of the other runtimes - i.e. Go, Ruby, Python, or bespoke.\n\n > I feel like Node.js is where Vercel really shines, and IMO feel like they should have gone all in on Node.js rather than supporting an array of runtimes.\n\n- Support for any of the following [`vercel.json` configuration](https://vercel.com/docs/configuration#introduction) options:\n\n - [headers](https://vercel.com/docs/configuration#project/headers)\n - [redirects](https://vercel.com/docs/configuration#project/redirects)\n - [rewrites](https://vercel.com/docs/configuration#project/rewrites)\n\n > Despair not! All of these configuration options can be represented via the [routes](https://vercel.com/docs/configuration#project/routes) configuration, which is supported.\n\n- Support for the raw AWS lambda API, which is currently [supported by the official Node.js runtime](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/aws-lambda-api)\n\n > As stated in their docs, this has been exposed to help clients with existing lambdas migrate over to their platform. I'm not convinced this alternative CLI should support this.\n\n- The bespoke [Vercel](https://vercel.com/) 4XX / 5XX error pages.\n\n > Meh. I return the expected error codes. I'd recommend you implement your own custom error pages in your UI anyways.\n\n- Support for [disabling the Node.js helpers](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/disabling-helpers-for-node-js)\n\n > This has more of an impact on production environments, where you would want to hyper optimise lambda performance in some cases.\n\n- Support for [Next.js](https://nextjs.org/) projects.\n\n > Next has it's own development server with bespoke features around the APIs and pages. I would recommend using the `next dev` command instead.\n\n
\n\n## CLI Options\n\nThe CLI current supports the following options.\n\n- `--debug-apis` | `-d`\n\n Setting this flag will enable the debugger against your lambdas.\n\n- `--debug-apis-port [number]` | `-o [number]`\n\n Allows you to specify the port at which the debugger for your lambdas will run. By default it runs on port `9229`.\n\n- `--port [number]` | `-p [number]`\n\n Allows you to specify the port at which the `vercel-node-dev` server will run. By default it will attempt to bind to port `3000`.\n\n
\n\n## Specifying a custom develop command\n\nIf you aren't using one of the [supported frameworks](#supported-frameworks), or if you would like to customise the develop command, then you can add a `dev` script to your `package.json`:\n\n```json\n{\n \"scripts\": {\n \"dev\": \"my-dev-tool -p $PORT\"\n }\n}\n```\n\n**Note:** It is important that you pass through the `$PORT` environment variable as shown in the example above. This is so that your development server can be correctly managed by `vercel-node-dev`.\n\n
\n\n## Debugging your Lambdas\n\nYou can enabled the debugger for your lambdas by providing the respective option to the CLI:\n\n```bash\nvercel-node-dev --debug-apis\n```\n\nThis will start the development server, with the debugger instance running. By default the debugger runs on port `9229`. You can change the port number via the `--debug-apis-port` option.\n\nOnce the debugger is running you can attach to it utilising your tool of choice.\n\n### Debugging via VSCode\n\nBelow is a set of [`code` debug configurations](https://code.visualstudio.com/docs/editor/debugging), allowing you to either start the `vercel-dev-node` instance with the debugger attached, or to attach to an already executing debugger instance.\n\n```jsonc\n{\n \"version\": \"0.2.0\",\n \"configurations\": [\n // This will start vercel-node-dev with the debugger attached\n {\n \"name\": \"Launch vercel-node-dev\",\n \"type\": \"node\",\n \"request\": \"launch\",\n \"program\": \"vercel-node-dev\",\n \"args\": [\"--debug-apis\"],\n \"skipFiles\": [\"
\n\n## Bonus: Unit Testing your Lambdas\n\nThis tool leverages another library I built, [`vercel-node-server`](https://github.com/ctrlplusb/vercel-node-server), which allows you to create `http` instances of your lambdas. This opens up opportunities for you to write integration or unit tests for you lambdas.\n\nFirstly, install the library as development dependency:\n\n```bash\nnpm install -D vercel-node-server\n```\n\nYou can then write tests for your lambdas similar to the one below:\n\n```javascript\nimport { createServer } from 'vercel-node-server';\nimport listen from 'test-listen';\nimport axios from 'axios';\nimport helloLambda from './api/hello';\n\nlet server;\nlet url;\n\nbeforeAll(async () => {\n server = createServer(routeUnderTest);\n url = await listen(server);\n});\n\nafterAll(() => {\n server.close();\n});\n\nit('should return the expected response', async () => {\n const response = await axios.get(url, { params: { name: 'Pearl' } });\n expect(response.data).toBe('Hello Pearl');\n});\n```\n","readmeFilename":"README.md","gitHead":"1f56cd048136261eebd8278f92683ce65fd66965","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.5.0-alpha.3","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-bTB4DySxYswHt4tcVc3GAo4UX1MbuXgnPAfcsHfYzJxR1ohQVFRZ881Ekslyo2iqeidn/UQwN773/T/++tY0Yw==","shasum":"c42baaddad8f8a69008326b45deb9d2b8d0df30d","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.5.0-alpha.3.tgz","fileCount":18,"unpackedSize":65531,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe30CpCRA9TVsSAnZWagAALBMP/3JzDM2CmUbz58oMlRqR\nnAva276p4WahBAevhEShX4oCZBsK03dFj9CQ7aZoEZC3WHfc+6hGaq3yCCTm\neIY459OFTqpkieaEJmL4G9KBQF9fhp2BF1BfcucncVG5kQIwWsgqFmM/SlGX\nzrlqWsmowXN1tIXap0uhAKeOMmSjngfWQFdaIjJNWATYPHI5gQxQ9VO7STVq\nlsBdbI5mmXJv9tmETnaDSU6QQRufm93JU35uqsWc3zotyLrt5aQjD+wNwqeD\nWQYg038tNK3HWeK83g/NUQtJYI2EgrZIeTLPrIZ2njuyUrtue9ZtFSZJ36l3\njYios3FmrTLHLlknRJEiTfYv6UeTbLOqMN6vqqKg3UxXY+/hw3/oDWhsNF60\nZ2IPAoQx1oxV8WR3V2Dgt21RnCuvrHYg2e7AYmep9ySvvy/lU5nBD26lj8y+\nTe6GaGdSu36367KRPfgOrqEwJltWcjXD46dZJjszcgiYfn/01E98SFTj5njw\n0qjIOjErbrAMTwJDuKGvxA56OauZDo9B0+gVtj/eNovBpoutiiCOEllCLWTI\n5BQccoYV8DOnN3DmkcGzTumGl0chaPnx1U8H4wNowMpBkoolbnVxXxq3uIim\n6Mc/waGtfAwuc55V2+1DqopXHRiQxoMju7lv3tH0vYE2HUsbESEgQIxJxEqw\nslNt\r\n=v05F\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIBFpXrnwArbxUn97yalXAKpN302PtgYpmngr/zdLj4RNAiEAijbqbsq3IPw3WaL/KihXyRrGnrd4ig8qSj5r6WWY47o="}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.5.0-alpha.3_1591689384785_0.5147583089013188"},"_hasShrinkwrap":false},"0.5.0-alpha.4":{"name":"vercel-node-dev","version":"0.5.0-alpha.4","description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","license":"MIT","author":{"name":"Sean Matheson"},"repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"bin":{"vercel-node-dev":"bin/vercel-node-dev","vnd":"bin/vercel-node-dev"},"engines":{"node":">=10"},"scripts":{"test":"jest","experiment":"FORCE_COLOR=1 VND_TARGET_PATH=targets/finished node -r ts-node/register --preserve-symlinks src"},"dependencies":{"@vercel/build-utils":"^2.3.1","@vercel/frameworks":"^0.0.14","@vercel/node":"^1.6.1","@vercel/routing-utils":"^1.8.2","chalk":"^4.0.0","dedent":"^0.7.0","dotenv":"^8.2.0","execa":"^4.0.2","fs-extra":"^9.0.1","get-port":"^5.1.1","globby":"^11.0.1","http-proxy":"^1.18.1","load-json-file":"^6.2.0","meow":"^7.0.1","npm-run":"^5.0.1","p-timeout":"^3.2.0","pretty-format":"^26.0.1","tempy":"^0.5.0","ts-node-dev":"^1.0.0-pre.44","typescript":"^3.9.5","vercel-node-server":"^2.2.1","wait-port":"^0.2.9","write-json-file":"^4.3.0"},"devDependencies":{"@types/dedent":"^0.7.0","@types/fs-extra":"^9.0.1","@types/http-proxy":"^1.17.4","@types/jest":"^25.2.1","@types/node":"^14.0.12","@typescript-eslint/eslint-plugin":"^3.2.0","@typescript-eslint/parser":"^3.2.0","axios":"^0.19.2","babel-eslint":"^10.1.0","eslint":"^7.1.0","eslint-config-prettier":"^6.11.0","eslint-config-react-app":"^5.2.1","eslint-plugin-flowtype":"^5.1.3","eslint-plugin-import":"^2.21.1","eslint-plugin-jsx-a11y":"^6.2.3","eslint-plugin-prettier":"^3.1.3","eslint-plugin-react":"^7.20.0","eslint-plugin-react-hooks":"^4.0.4","husky":"^4.2.5","jest":"^26.0.1","prettier":"^2.0.5","ts-jest":"^26.1.0"},"prettier":{"semi":true,"singleQuote":true,"trailingComma":"all"},"eslintConfig":{"root":true,"parser":"@typescript-eslint/parser","extends":["react-app","plugin:@typescript-eslint/recommended","prettier","prettier/@typescript-eslint"],"plugins":["@typescript-eslint"],"env":{"commonjs":true,"es6":true,"node":true,"jest":true},"rules":{"@typescript-eslint/explicit-function-return-type":0}},"eslintIgnore":["**/node_modules/*"],"readme":"
\nAn unofficial development CLI for Vercel applications targeting the Node.js runtime.\n
\n\n\nFast reloads, improved reliability, offline and debugger support.\n
\n\n\n \n \n \n
\n\n## Table of Contents\n\n- [Features](#features)\n- [Motivation](#motivation)\n- [Vercel vs Us?](#vercel-vs-us)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Supported Features](#supported-features)\n- [Supported Frameworks](#supported-frameworks)\n- [Limitations](#limitations)\n- [CLI Options](#cli-options)\n- [Specifying a custom develop command](#specifying-a-custom-develop-command)\n- [Debugging your Lambdas](#debugging-your-lambdas)\n- [Bonus: Unit Testing your Lambdas](#bonus-unit-testing-your-lambdas)\n\n
\n\n## Features\n\n- Optimised for the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Built against the [Vercel specifications](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Supports Vercel [\"Zero Config\"](https://vercel.com/blog/zero-config) approach\n- Supports both JavaScript or TypeScript lambdas\n- Supports the attaching of a debugger session against lambda execution\n- Supports Vercel custom [routes](https://vercel.com/docs/configuration#project/routes) configuration\n- Fast reloading for any changes to your lambdas\n- Extensively tested and verified via an integration test suite\n- Can be run offline\n- No need for a Vercel project to be configured prior to execution\n- Does not need to be installed as a local dependency\n\n
\n\n## Motivation\n\n[Vercel](https://vercel.com/) provides its own development environment via the `vercel dev` command. Whilst this tool is powerful, I was experiencing the following issues:\n\n- **Performance:** The feedback loop when making changes to my lambdas was very slow. After making a change, the subsequent request to the lamda would result in a significant wait for the lambda to be rebuilt and then served.\n- **Reliability:** When making changes to my lambdas the build performance degraded over time, eventually resulting in them becoming unresponsive. The only way I was able to resolve this was to restart the `vercel dev` command, significantly impacting my development flow.\n- **Debugging:** I was unable to attach a debugger instance against my lambdas. Whilst I try not to overuse the debugger, preferring to leverage integration tests, there are times when a debugger session can work wonders at issue discovery.\n- **Usability:** There was a double hit for me here. Firstly, you need to have first set up / linked your project to a project configuration against Vercel. Secondly, and related to the first point, you need to be connected to the internet in order to use the tool.\n\nThe implementation of `vercel-node-dev` addresses these issues; focussing on the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js), which allowed me to create a much more bespoke and optimised development tool.\n\n
\n\n## Vercel vs Us?\n\nThis tool is **_not_** meant to be **_competitive_**!\n\nIt is released with good intentions and respect for the Vercel team and community, offering a temporary alternative for those who may be experiencing similar issues with their development flow.\n\nThe `vercel dev` command is still in **beta**. My belief is that the Vercel team will eventually address the issues above, at which point this CLI will be deprecated. Given that we are following the official Vercel specifications, this would be a zero impact move for those using this CLI. You would only need to switch to executing the official `vercel dev` command instead of this one.\n\n
\n\n## Installation\n\nWe recommend installing this library globally. This will allow you to quickly and easily use it against any of your Vercel applications, without polluting them with additional dependencies.\n\n```bash\nnpm install -g vercel-node-dev\n```\n\nAfter the installation two CLI commands will be available to you, namely;\n\n- `vercel-node-dev`\n- `vnd` - a shorter aliased version\n\n
\n\n## Usage\n\nSimply navigate to the root of the [Vercel](https://vercel.com/) application and execute the CLI.\n\n```bash\nvercel-node-dev\n```\n\nSimilar to the `vercel dev` command we will attempt to bind the development server against port `3000`.\n\nOpen your web browser and browse to `http://localhost:3000`.\n\n
\n\n## Supported Features\n\nBelow is a list of the official Vercel features that we support.\n\nI don't add any additional API features in comparison to the official APIs.\n\nThe design goal of this tool is to support as much of the official API as possible, whilst providing an improved development experience.\n\n- The [\"Zero Config\"](https://vercel.com/blog/zero-config) approach promoted by Vercel.\n- TypeScript (`.ts`) or JavaScript (`.js`) lambdas, within the `/api` directory, with filesystem based routing.\n- The ability to [ignore files/directories](https://vercel.com/docs/v2/serverless-functions/introduction#prevent-endpoint-listing) within your `/api` directory from being bound as lambdas.\n- [Path segments](https://vercel.com/docs/v2/serverless-functions/introduction#path-segments) for your lambdas.\n- A [custom build step](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/custom-build-step-for-node-js), which will be executed prior to the execution of your lambdas.\n- Automatic exposure of any environment variables defined within the `.env` file defined in the root of the project. This is inline with the [approach recommended by Vercel](https://vercel.com/docs/v2/build-step#environment-variables) for managing environment variables.\n- Automated [extension of the HTTP Request and Response objects](https://vercel.com/docs/runtimes#official-runtimes/node-js/node-js-request-and-response-objects/node-js-helpers) that are passed into your lambdas.\n- Custom [routes](https://vercel.com/docs/configuration#project/routes) configuration.\n\nWe follows the design, API, and features of the official [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js) as closely as possible.\n\nThe [official docs](https://vercel.com/docs/runtimes#official-runtimes/node-js) and [advanced usage docs](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage) should be used as your reference for understanding the above features in detail.\n\n**Todo**\n\nThe following configuration options will be supported in the near future:\n\n- [cleanUrls](https://vercel.com/docs/configuration#project/cleanurls)\n- [trailingSlash](https://vercel.com/docs/configuration#project/trailingslash)\n\n
\n\n## Supported Frameworks\n\nI have tested the CLI against the following frameworks, utilising the [\"Zero Config\"](https://vercel.com/blog/zero-config) approach.\n\n- [x] Create React App\n- [x] Create React App + TypeScript\n- [x] Gatsby\n- [x] Vue.js\n- [ ] Svelte\n- [ ] Angular\n- [ ] Ember.js\n- [ ] Hugo\n- [ ] Preact\n- [ ] Docusaurus\n- [ ] Gridsome\n- [ ] Nuxt.js\n- [ ] Eleventy\n- [ ] Hexo\n\n
\n\n## Limitations\n\nBelow is a list of the Vercel features that this CLI does not support. These limitations are intentional, and the likelihood is that I will not extend the CLI to support them.\n\n- Support for any of the other runtimes - i.e. Go, Ruby, Python, or bespoke.\n\n > I feel like Node.js is where Vercel really shines, and IMO feel like they should have gone all in on Node.js rather than supporting an array of runtimes.\n\n- Support for any of the following [`vercel.json` configuration](https://vercel.com/docs/configuration#introduction) options:\n\n - [headers](https://vercel.com/docs/configuration#project/headers)\n - [redirects](https://vercel.com/docs/configuration#project/redirects)\n - [rewrites](https://vercel.com/docs/configuration#project/rewrites)\n\n > Despair not! All of these configuration options can be represented via the [routes](https://vercel.com/docs/configuration#project/routes) configuration, which is supported.\n\n- Support for the raw AWS lambda API, which is currently [supported by the official Node.js runtime](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/aws-lambda-api)\n\n > As stated in their docs, this has been exposed to help clients with existing lambdas migrate over to their platform. I'm not convinced this alternative CLI should support this.\n\n- The bespoke [Vercel](https://vercel.com/) 4XX / 5XX error pages.\n\n > Meh. I return the expected error codes. I'd recommend you implement your own custom error pages in your UI anyways.\n\n- Support for [disabling the Node.js helpers](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/disabling-helpers-for-node-js)\n\n > This has more of an impact on production environments, where you would want to hyper optimise lambda performance in some cases.\n\n- Support for [Next.js](https://nextjs.org/) projects.\n\n > Next has it's own development server with bespoke features around the APIs and pages. I would recommend using the `next dev` command instead.\n\n
\n\n## CLI Options\n\nThe CLI current supports the following options.\n\n- `--debug-apis` | `-d`\n\n Setting this flag will enable the debugger against your lambdas.\n\n- `--debug-apis-port [number]` | `-o [number]`\n\n Allows you to specify the port at which the debugger for your lambdas will run. By default it runs on port `9229`.\n\n- `--port [number]` | `-p [number]`\n\n Allows you to specify the port at which the `vercel-node-dev` server will run. By default it will attempt to bind to port `3000`.\n\n
\n\n## Specifying a custom develop command\n\nIf you aren't using one of the [supported frameworks](#supported-frameworks), or if you would like to customise the develop command, then you can add a `dev` script to your `package.json`:\n\n```json\n{\n \"scripts\": {\n \"dev\": \"my-dev-tool -p $PORT\"\n }\n}\n```\n\n**Note:** It is important that you pass through the `$PORT` environment variable as shown in the example above. This is so that your development server can be correctly managed by `vercel-node-dev`.\n\n
\n\n## Debugging your Lambdas\n\nYou can enabled the debugger for your lambdas by providing the respective option to the CLI:\n\n```bash\nvercel-node-dev --debug-apis\n```\n\nThis will start the development server, with the debugger instance running. By default the debugger runs on port `9229`. You can change the port number via the `--debug-apis-port` option.\n\nOnce the debugger is running you can attach to it utilising your tool of choice.\n\n### Debugging via VSCode\n\nBelow is a set of [`code` debug configurations](https://code.visualstudio.com/docs/editor/debugging), allowing you to either start the `vercel-dev-node` instance with the debugger attached, or to attach to an already executing debugger instance.\n\n```jsonc\n{\n \"version\": \"0.2.0\",\n \"configurations\": [\n // This will start vercel-node-dev with the debugger attached\n {\n \"name\": \"Launch vercel-node-dev\",\n \"type\": \"node\",\n \"request\": \"launch\",\n \"program\": \"vercel-node-dev\",\n \"args\": [\"--debug-apis\"],\n \"skipFiles\": [\"
\n\n## Bonus: Unit Testing your Lambdas\n\nThis tool leverages another library I built, [`vercel-node-server`](https://github.com/ctrlplusb/vercel-node-server), which allows you to create `http` instances of your lambdas. This opens up opportunities for you to write integration or unit tests for you lambdas.\n\nFirstly, install the library as development dependency:\n\n```bash\nnpm install -D vercel-node-server\n```\n\nYou can then write tests for your lambdas similar to the one below:\n\n```javascript\nimport { createServer } from 'vercel-node-server';\nimport listen from 'test-listen';\nimport axios from 'axios';\nimport helloLambda from './api/hello';\n\nlet server;\nlet url;\n\nbeforeAll(async () => {\n server = createServer(routeUnderTest);\n url = await listen(server);\n});\n\nafterAll(() => {\n server.close();\n});\n\nit('should return the expected response', async () => {\n const response = await axios.get(url, { params: { name: 'Pearl' } });\n expect(response.data).toBe('Hello Pearl');\n});\n```\n","readmeFilename":"README.md","gitHead":"1f56cd048136261eebd8278f92683ce65fd66965","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.5.0-alpha.4","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-6JW9nwqPZZvpCGhxXRaKJc2EBv1FmEBdnqFd16nmOWYLdOG9iDjU+GxtSdreIqu1X/sohD1XQSErrjyY5v/Y8A==","shasum":"debc0d7e6736e35f29e83b5f4e8f1c1829b99f2f","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.5.0-alpha.4.tgz","fileCount":18,"unpackedSize":65533,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe31RoCRA9TVsSAnZWagAAXHgP/2OzaN5rNrKdz+RAI0Hc\nEgwKKf56kulFJ4kcdFRMxIDGB2lEYHO/xc+RvQE02I/MX4tN4AlxqWVtuB1O\niZnG8S49ei/doG+UDfd+7TL+/FcHIVaIAqlFtnuOkbEqVW/7cukJTBEw8xnB\nol1ko2e8ayKnErZlRDPAd1QdCDdg137hdix2zG7o8MFt2sMiwhuorm7gfvwS\n9vfpcnxRwH48/ztNg0GZqOHxd2TMwcOaFIrl5hDvOV47E31CR1ZIMt3515nk\nM9WFNWGjYuumCDefT/XoEsi3TUQEWtss0j+v4XH9YByIzl0TnQTm0ExWrDjl\nX1a26yyySZM4vrLeTKeB82VHi4zrp2CmeZlvgL8rqwZwFTKNE7bDe85HdoR0\nUkf2W4W64XYCvMInbbWQ4gFEqIsRqLPHE7RtAhB51zo8E7RkalBimw1ZbQCh\nSsmb8YxZ0LS7HppQ6s6w6Wzm6NbxkbI/5YufZc75hwaxNeN5CUGzV2TU4jqZ\nVB29ArWawMEOnRPaL6cY1eK7f/HwrOxUYVi1rdqjuIlRzZWfwJxc12rCgP0e\nLaT5Bi4kBHD/NAnX7XyyV4ORVeWVA7VYLmgbHLT8jlwutsRBW24ZX+WxrsJF\nqyyA5bcxcwt1YTSG3cKTl9VT3eUYTwZ3tieXDrOZWXsYFXCBdosRE3Vz7fKH\nmQXs\r\n=s8ki\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCM5qe60Ov92/FO+wrDobNdaZExI2SG9ucKaczUk2W96QIhALXxGT/ncQJI5Ulexv/K8x8ccM0fs3dzhltiLxJiH/XU"}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.5.0-alpha.4_1591694439857_0.7173128642343385"},"_hasShrinkwrap":false},"0.5.0-alpha.5":{"name":"vercel-node-dev","version":"0.5.0-alpha.5","description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","license":"MIT","author":{"name":"Sean Matheson"},"repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"bin":{"vercel-node-dev":"bin/vercel-node-dev","vnd":"bin/vercel-node-dev"},"engines":{"node":">=10"},"scripts":{"test":"jest","experiment":"FORCE_COLOR=1 VND_TARGET_PATH=targets/finished node -r ts-node/register --preserve-symlinks src"},"dependencies":{"@vercel/build-utils":"^2.3.1","@vercel/frameworks":"^0.0.14","@vercel/node":"^1.6.1","@vercel/routing-utils":"^1.8.2","chalk":"^4.0.0","dedent":"^0.7.0","dotenv":"^8.2.0","execa":"^4.0.2","fs-extra":"^9.0.1","get-port":"^5.1.1","globby":"^11.0.1","http-proxy":"^1.18.1","load-json-file":"^6.2.0","meow":"^7.0.1","npm-run":"^5.0.1","p-timeout":"^3.2.0","pretty-format":"^26.0.1","tempy":"^0.5.0","ts-node-dev":"^1.0.0-pre.44","typescript":"^3.9.5","vercel-node-server":"^2.2.1","wait-port":"^0.2.9","write-json-file":"^4.3.0"},"devDependencies":{"@types/dedent":"^0.7.0","@types/fs-extra":"^9.0.1","@types/http-proxy":"^1.17.4","@types/jest":"^25.2.1","@types/node":"^14.0.12","@typescript-eslint/eslint-plugin":"^3.2.0","@typescript-eslint/parser":"^3.2.0","axios":"^0.19.2","babel-eslint":"^10.1.0","eslint":"^7.1.0","eslint-config-prettier":"^6.11.0","eslint-config-react-app":"^5.2.1","eslint-plugin-flowtype":"^5.1.3","eslint-plugin-import":"^2.21.1","eslint-plugin-jsx-a11y":"^6.2.3","eslint-plugin-prettier":"^3.1.3","eslint-plugin-react":"^7.20.0","eslint-plugin-react-hooks":"^4.0.4","husky":"^4.2.5","jest":"^26.0.1","prettier":"^2.0.5","ts-jest":"^26.1.0"},"prettier":{"semi":true,"singleQuote":true,"trailingComma":"all"},"eslintConfig":{"root":true,"parser":"@typescript-eslint/parser","extends":["react-app","plugin:@typescript-eslint/recommended","prettier","prettier/@typescript-eslint"],"plugins":["@typescript-eslint"],"env":{"commonjs":true,"es6":true,"node":true,"jest":true},"rules":{"@typescript-eslint/explicit-function-return-type":0}},"eslintIgnore":["**/node_modules/*"],"readme":"
\nAn unofficial development CLI for Vercel applications targeting the Node.js runtime.\n
\n\n\nFast reloads, improved reliability, offline and debugger support.\n
\n\n\n \n \n \n
\n\n## Table of Contents\n\n- [Features](#features)\n- [Motivation](#motivation)\n- [Vercel vs Us?](#vercel-vs-us)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Supported Features](#supported-features)\n- [Supported Frameworks](#supported-frameworks)\n- [Limitations](#limitations)\n- [CLI Options](#cli-options)\n- [Specifying a custom develop command](#specifying-a-custom-develop-command)\n- [Debugging your Lambdas](#debugging-your-lambdas)\n- [Bonus: Unit Testing your Lambdas](#bonus-unit-testing-your-lambdas)\n\n
\n\n## Features\n\n- Optimised for the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Built against the [Vercel specifications](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Supports Vercel [\"Zero Config\"](https://vercel.com/blog/zero-config) approach\n- Supports both JavaScript or TypeScript lambdas\n- Supports the attaching of a debugger session against lambda execution\n- Supports Vercel custom [routes](https://vercel.com/docs/configuration#project/routes) configuration\n- Fast reloading for any changes to your lambdas\n- Extensively tested and verified via an integration test suite\n- Can be run offline\n- No need for a Vercel project to be configured prior to execution\n- Does not need to be installed as a local dependency\n\n
\n\n## Motivation\n\n[Vercel](https://vercel.com/) provides its own development environment via the `vercel dev` command. Whilst this tool is powerful, I was experiencing the following issues:\n\n- **Performance:** The feedback loop when making changes to my lambdas was very slow. After making a change, the subsequent request to the lamda would result in a significant wait for the lambda to be rebuilt and then served.\n- **Reliability:** When making changes to my lambdas the build performance degraded over time, eventually resulting in them becoming unresponsive. The only way I was able to resolve this was to restart the `vercel dev` command, significantly impacting my development flow.\n- **Debugging:** I was unable to attach a debugger instance against my lambdas. Whilst I try not to overuse the debugger, preferring to leverage integration tests, there are times when a debugger session can work wonders at issue discovery.\n- **Usability:** There was a double hit for me here. Firstly, you need to have first set up / linked your project to a project configuration against Vercel. Secondly, and related to the first point, you need to be connected to the internet in order to use the tool.\n\nThe implementation of `vercel-node-dev` addresses these issues; focussing on the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js), which allowed me to create a much more bespoke and optimised development tool.\n\n
\n\n## Vercel vs Us?\n\nThis tool is **_not_** meant to be **_competitive_**!\n\nIt is released with good intentions and respect for the Vercel team and community, offering a temporary alternative for those who may be experiencing similar issues with their development flow.\n\nThe `vercel dev` command is still in **beta**. My belief is that the Vercel team will eventually address the issues above, at which point this CLI will be deprecated. Given that we are following the official Vercel specifications, this would be a zero impact move for those using this CLI. You would only need to switch to executing the official `vercel dev` command instead of this one.\n\n
\n\n## Installation\n\nWe recommend installing this library globally. This will allow you to quickly and easily use it against any of your Vercel applications, without polluting them with additional dependencies.\n\n```bash\nnpm install -g vercel-node-dev\n```\n\nAfter the installation two CLI commands will be available to you, namely;\n\n- `vercel-node-dev`\n- `vnd` - a shorter aliased version\n\n
\n\n## Usage\n\nSimply navigate to the root of the [Vercel](https://vercel.com/) application and execute the CLI.\n\n```bash\nvercel-node-dev\n```\n\nSimilar to the `vercel dev` command we will attempt to bind the development server against port `3000`.\n\nOpen your web browser and browse to `http://localhost:3000`.\n\n
\n\n## Supported Features\n\nBelow is a list of the official Vercel features that we support.\n\nI don't add any additional API features in comparison to the official APIs.\n\nThe design goal of this tool is to support as much of the official API as possible, whilst providing an improved development experience.\n\n- The [\"Zero Config\"](https://vercel.com/blog/zero-config) approach promoted by Vercel.\n- TypeScript (`.ts`) or JavaScript (`.js`) lambdas, within the `/api` directory, with filesystem based routing.\n- The ability to [ignore files/directories](https://vercel.com/docs/v2/serverless-functions/introduction#prevent-endpoint-listing) within your `/api` directory from being bound as lambdas.\n- [Path segments](https://vercel.com/docs/v2/serverless-functions/introduction#path-segments) for your lambdas.\n- A [custom build step](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/custom-build-step-for-node-js), which will be executed prior to the execution of your lambdas.\n- Automatic exposure of any environment variables defined within the `.env` file defined in the root of the project. This is inline with the [approach recommended by Vercel](https://vercel.com/docs/v2/build-step#environment-variables) for managing environment variables.\n- Automated [extension of the HTTP Request and Response objects](https://vercel.com/docs/runtimes#official-runtimes/node-js/node-js-request-and-response-objects/node-js-helpers) that are passed into your lambdas.\n- Custom [routes](https://vercel.com/docs/configuration#project/routes) configuration.\n\nWe follows the design, API, and features of the official [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js) as closely as possible.\n\nThe [official docs](https://vercel.com/docs/runtimes#official-runtimes/node-js) and [advanced usage docs](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage) should be used as your reference for understanding the above features in detail.\n\n**Todo**\n\nThe following configuration options will be supported in the near future:\n\n- [cleanUrls](https://vercel.com/docs/configuration#project/cleanurls)\n- [trailingSlash](https://vercel.com/docs/configuration#project/trailingslash)\n\n
\n\n## Supported Frameworks\n\nI have tested the CLI against the following frameworks, utilising the [\"Zero Config\"](https://vercel.com/blog/zero-config) approach.\n\n- [x] Create React App\n- [x] Create React App + TypeScript\n- [x] Gatsby\n- [x] Vue.js\n- [ ] Svelte\n- [ ] Angular\n- [ ] Ember.js\n- [ ] Hugo\n- [ ] Preact\n- [ ] Docusaurus\n- [ ] Gridsome\n- [ ] Nuxt.js\n- [ ] Eleventy\n- [ ] Hexo\n\n
\n\n## Limitations\n\nBelow is a list of the Vercel features that this CLI does not support. These limitations are intentional, and the likelihood is that I will not extend the CLI to support them.\n\n- Support for any of the other runtimes - i.e. Go, Ruby, Python, or bespoke.\n\n > I feel like Node.js is where Vercel really shines, and IMO feel like they should have gone all in on Node.js rather than supporting an array of runtimes.\n\n- Support for any of the following [`vercel.json` configuration](https://vercel.com/docs/configuration#introduction) options:\n\n - [headers](https://vercel.com/docs/configuration#project/headers)\n - [redirects](https://vercel.com/docs/configuration#project/redirects)\n - [rewrites](https://vercel.com/docs/configuration#project/rewrites)\n\n > Despair not! All of these configuration options can be represented via the [routes](https://vercel.com/docs/configuration#project/routes) configuration, which is supported.\n\n- Support for the raw AWS lambda API, which is currently [supported by the official Node.js runtime](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/aws-lambda-api)\n\n > As stated in their docs, this has been exposed to help clients with existing lambdas migrate over to their platform. I'm not convinced this alternative CLI should support this.\n\n- The bespoke [Vercel](https://vercel.com/) 4XX / 5XX error pages.\n\n > Meh. I return the expected error codes. I'd recommend you implement your own custom error pages in your UI anyways.\n\n- Support for [disabling the Node.js helpers](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/disabling-helpers-for-node-js)\n\n > This has more of an impact on production environments, where you would want to hyper optimise lambda performance in some cases.\n\n- Support for [Next.js](https://nextjs.org/) projects.\n\n > Next has it's own development server with bespoke features around the APIs and pages. I would recommend using the `next dev` command instead.\n\n
\n\n## CLI Options\n\nThe CLI current supports the following options.\n\n- `--debug-apis` | `-d`\n\n Setting this flag will enable the debugger against your lambdas.\n\n- `--debug-apis-port [number]` | `-o [number]`\n\n Allows you to specify the port at which the debugger for your lambdas will run. By default it runs on port `9229`.\n\n- `--port [number]` | `-p [number]`\n\n Allows you to specify the port at which the `vercel-node-dev` server will run. By default it will attempt to bind to port `3000`.\n\n
\n\n## Specifying a custom develop command\n\nIf you aren't using one of the [supported frameworks](#supported-frameworks), or if you would like to customise the develop command, then you can add a `dev` script to your `package.json`:\n\n```json\n{\n \"scripts\": {\n \"dev\": \"my-dev-tool -p $PORT\"\n }\n}\n```\n\n**Note:** It is important that you pass through the `$PORT` environment variable as shown in the example above. This is so that your development server can be correctly managed by `vercel-node-dev`.\n\n
\n\n## Debugging your Lambdas\n\nYou can enabled the debugger for your lambdas by providing the respective option to the CLI:\n\n```bash\nvercel-node-dev --debug-apis\n```\n\nThis will start the development server, with the debugger instance running. By default the debugger runs on port `9229`. You can change the port number via the `--debug-apis-port` option.\n\nOnce the debugger is running you can attach to it utilising your tool of choice.\n\n### Debugging via VSCode\n\nBelow is a set of [`code` debug configurations](https://code.visualstudio.com/docs/editor/debugging), allowing you to either start the `vercel-dev-node` instance with the debugger attached, or to attach to an already executing debugger instance.\n\n```jsonc\n{\n \"version\": \"0.2.0\",\n \"configurations\": [\n // This will start vercel-node-dev with the debugger attached\n {\n \"name\": \"Launch vercel-node-dev\",\n \"type\": \"node\",\n \"request\": \"launch\",\n \"program\": \"vercel-node-dev\",\n \"args\": [\"--debug-apis\"],\n \"skipFiles\": [\"
\n\n## Bonus: Unit Testing your Lambdas\n\nThis tool leverages another library I built, [`vercel-node-server`](https://github.com/ctrlplusb/vercel-node-server), which allows you to create `http` instances of your lambdas. This opens up opportunities for you to write integration or unit tests for you lambdas.\n\nFirstly, install the library as development dependency:\n\n```bash\nnpm install -D vercel-node-server\n```\n\nYou can then write tests for your lambdas similar to the one below:\n\n```javascript\nimport { createServer } from 'vercel-node-server';\nimport listen from 'test-listen';\nimport axios from 'axios';\nimport helloLambda from './api/hello';\n\nlet server;\nlet url;\n\nbeforeAll(async () => {\n server = createServer(routeUnderTest);\n url = await listen(server);\n});\n\nafterAll(() => {\n server.close();\n});\n\nit('should return the expected response', async () => {\n const response = await axios.get(url, { params: { name: 'Pearl' } });\n expect(response.data).toBe('Hello Pearl');\n});\n```\n","readmeFilename":"README.md","gitHead":"1f56cd048136261eebd8278f92683ce65fd66965","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.5.0-alpha.5","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-2CwOpA+1tSV4+iUZ2qdVNy2sGriCqSyT8SHtxYe80PrM3BxJ86V2cz1lqKqt0oROGXTD62DLCuBom5S3iIp8ww==","shasum":"2e345043c50dacbabaf246e838d42dbbc32dda25","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.5.0-alpha.5.tgz","fileCount":18,"unpackedSize":65539,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe31UjCRA9TVsSAnZWagAAhIMP/jfyJOWRJrPA20Hdpk2U\n9C0Q4H5php2tz/GMMmDuAB58rzyswJQvm1tUFqHRon2i5L63snL72tXuTHfs\nZHzFWALz2Hx/yIIMiAMlsUjzblNgCsl9uI5cjVB+FFZHkTVMeB61qBeyK7WW\ne1XIJ2HLKWIrXJNfnL47x9XvM4xNevfy7nCBHhLv29CVTphpYFoVaVdh81rA\nxyS8IZfemmrK1eyKoP+weMHcNzyL3y9GKHJTjmVu85id0u5mq1V37dusWfm4\n18eTuJtQh3vekpaWUTTZF9MOyN74Bto32HwzodX6X8wO6q6HpGMHA7oO0Tep\nT6Xo1RAJp7kPLjpzXaAR1ufpgGay/Fc4VAEkzVuQdpWES69w1fco7pzq4y+U\nx32K5Tp6TtKtIxDDhY/eCa8COt2C8T8avaf6WN68rargWl+ubTxzMEp8CVPU\nThOWLuJ8EbKvfAHbG0VECJf/OBAcHT24OnJrXLC0PFI8cYUvubGc89sNxbGA\nZ5vict15yP7odftLP82hDLbBnP4XPVXeLVBgN/XlWC652ua2U038yDtSOMdz\nSJddwQD5dQuGV3RCA7i0PpqZ7tYmwaDDksKR1fLNdMgRwSzG5CfE969qv4CL\nzsF1uk1nctqJq+2MtZYaStWaMdexxQ1WfVETSKoxYd31hOjTAQO9NKsJoIob\nODUe\r\n=z/8O\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIDcCeXelAPXC6R0N8D1802hFrQ8mrHFpmwAGJaQapqGbAiA954vEjCVdaqM+81Fc8moaLNIp8KqSVd2m+0zmRDrT9w=="}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.5.0-alpha.5_1591694627227_0.30098939403626024"},"_hasShrinkwrap":false},"0.5.0-alpha.6":{"name":"vercel-node-dev","version":"0.5.0-alpha.6","description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","license":"MIT","author":{"name":"Sean Matheson"},"repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"bin":{"vercel-node-dev":"bin/vercel-node-dev","vnd":"bin/vercel-node-dev"},"engines":{"node":">=10"},"scripts":{"test":"jest","experiment":"FORCE_COLOR=1 VND_TARGET_PATH=targets/finished node -r ts-node/register --preserve-symlinks src"},"dependencies":{"@vercel/build-utils":"^2.3.1","@vercel/frameworks":"^0.0.14","@vercel/node":"^1.6.1","@vercel/routing-utils":"^1.8.2","chalk":"^4.0.0","dedent":"^0.7.0","dotenv":"^8.2.0","execa":"^4.0.2","fs-extra":"^9.0.1","get-port":"^5.1.1","globby":"^11.0.1","http-proxy":"^1.18.1","load-json-file":"^6.2.0","meow":"^7.0.1","npm-run":"^5.0.1","p-timeout":"^3.2.0","pretty-format":"^26.0.1","strip-color":"^0.1.0","tempy":"^0.5.0","ts-node-dev":"^1.0.0-pre.44","typescript":"^3.9.5","vercel-node-server":"^2.2.1","wait-port":"^0.2.9","write-json-file":"^4.3.0"},"devDependencies":{"@types/dedent":"^0.7.0","@types/fs-extra":"^9.0.1","@types/http-proxy":"^1.17.4","@types/jest":"^25.2.1","@types/node":"^14.0.12","@types/strip-color":"^0.1.0","@typescript-eslint/eslint-plugin":"^3.2.0","@typescript-eslint/parser":"^3.2.0","axios":"^0.19.2","babel-eslint":"^10.1.0","eslint":"^7.1.0","eslint-config-prettier":"^6.11.0","eslint-config-react-app":"^5.2.1","eslint-plugin-flowtype":"^5.1.3","eslint-plugin-import":"^2.21.1","eslint-plugin-jsx-a11y":"^6.2.3","eslint-plugin-prettier":"^3.1.3","eslint-plugin-react":"^7.20.0","eslint-plugin-react-hooks":"^4.0.4","husky":"^4.2.5","jest":"^26.0.1","prettier":"^2.0.5","ts-jest":"^26.1.0"},"prettier":{"semi":true,"singleQuote":true,"trailingComma":"all"},"eslintConfig":{"root":true,"parser":"@typescript-eslint/parser","extends":["react-app","plugin:@typescript-eslint/recommended","prettier","prettier/@typescript-eslint"],"plugins":["@typescript-eslint"],"env":{"commonjs":true,"es6":true,"node":true,"jest":true},"rules":{"@typescript-eslint/explicit-function-return-type":0}},"eslintIgnore":["**/node_modules/*"],"readme":"
\nAn unofficial development CLI for Vercel applications targeting the Node.js runtime.\n
\n\n\nFast reloads, improved reliability, offline and debugger support.\n
\n\n\n \n \n \n
\n\n## Table of Contents\n\n- [Features](#features)\n- [Motivation](#motivation)\n- [Vercel vs Us?](#vercel-vs-us)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Supported Features](#supported-features)\n- [Supported Frameworks](#supported-frameworks)\n- [Limitations](#limitations)\n- [CLI Options](#cli-options)\n- [Specifying a custom develop command](#specifying-a-custom-develop-command)\n- [Debugging your Lambdas](#debugging-your-lambdas)\n- [Bonus: Unit Testing your Lambdas](#bonus-unit-testing-your-lambdas)\n\n
\n\n## Features\n\n- Optimised for the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Built against the [Vercel specifications](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Supports Vercel [\"Zero Config\"](https://vercel.com/blog/zero-config) approach\n- Supports both JavaScript or TypeScript lambdas\n- Supports the attaching of a debugger session against lambda execution\n- Supports Vercel custom [routes](https://vercel.com/docs/configuration#project/routes) configuration\n- Fast reloading for any changes to your lambdas\n- Extensively tested and verified via an integration test suite\n- Can be run offline\n- No need for a Vercel project to be configured prior to execution\n- Does not need to be installed as a local dependency\n\n
\n\n## Motivation\n\n[Vercel](https://vercel.com/) provides its own development environment via the `vercel dev` command. Whilst this tool is powerful, I was experiencing the following issues:\n\n- **Performance:** The feedback loop when making changes to my lambdas was very slow. After making a change, the subsequent request to the lamda would result in a significant wait for the lambda to be rebuilt and then served.\n- **Reliability:** When making changes to my lambdas the build performance degraded over time, eventually resulting in them becoming unresponsive. The only way I was able to resolve this was to restart the `vercel dev` command, significantly impacting my development flow.\n- **Debugging:** I was unable to attach a debugger instance against my lambdas. Whilst I try not to overuse the debugger, preferring to leverage integration tests, there are times when a debugger session can work wonders at issue discovery.\n- **Usability:** There was a double hit for me here. Firstly, you need to have first set up / linked your project to a project configuration against Vercel. Secondly, and related to the first point, you need to be connected to the internet in order to use the tool.\n\nThe implementation of `vercel-node-dev` addresses these issues; focussing on the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js), which allowed me to create a much more bespoke and optimised development tool.\n\n
\n\n## Vercel vs Us?\n\nThis tool is **_not_** meant to be **_competitive_**!\n\nIt is released with good intentions and respect for the Vercel team and community, offering a temporary alternative for those who may be experiencing similar issues with their development flow.\n\nThe `vercel dev` command is still in **beta**. My belief is that the Vercel team will eventually address the issues above, at which point this CLI will be deprecated. Given that we are following the official Vercel specifications, this would be a zero impact move for those using this CLI. You would only need to switch to executing the official `vercel dev` command instead of this one.\n\n
\n\n## Installation\n\nWe recommend installing this library globally. This will allow you to quickly and easily use it against any of your Vercel applications, without polluting them with additional dependencies.\n\n```bash\nnpm install -g vercel-node-dev\n```\n\nAfter the installation two CLI commands will be available to you, namely;\n\n- `vercel-node-dev`\n- `vnd` - a shorter aliased version\n\n
\n\n## Usage\n\nSimply navigate to the root of the [Vercel](https://vercel.com/) application and execute the CLI.\n\n```bash\nvercel-node-dev\n```\n\nSimilar to the `vercel dev` command we will attempt to bind the development server against port `3000`.\n\nOpen your web browser and browse to `http://localhost:3000`.\n\n
\n\n## Supported Features\n\nBelow is a list of the official Vercel features that we support.\n\nI don't add any additional API features in comparison to the official APIs.\n\nThe design goal of this tool is to support as much of the official API as possible, whilst providing an improved development experience.\n\n- The [\"Zero Config\"](https://vercel.com/blog/zero-config) approach promoted by Vercel.\n- TypeScript (`.ts`) or JavaScript (`.js`) lambdas, within the `/api` directory, with filesystem based routing.\n- The ability to [ignore files/directories](https://vercel.com/docs/v2/serverless-functions/introduction#prevent-endpoint-listing) within your `/api` directory from being bound as lambdas.\n- [Path segments](https://vercel.com/docs/v2/serverless-functions/introduction#path-segments) for your lambdas.\n- A [custom build step](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/custom-build-step-for-node-js), which will be executed prior to the execution of your lambdas.\n- Automatic exposure of any environment variables defined within the `.env` file defined in the root of the project. This is inline with the [approach recommended by Vercel](https://vercel.com/docs/v2/build-step#environment-variables) for managing environment variables.\n- Automated [extension of the HTTP Request and Response objects](https://vercel.com/docs/runtimes#official-runtimes/node-js/node-js-request-and-response-objects/node-js-helpers) that are passed into your lambdas.\n- Custom [routes](https://vercel.com/docs/configuration#project/routes) configuration.\n\nWe follows the design, API, and features of the official [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js) as closely as possible.\n\nThe [official docs](https://vercel.com/docs/runtimes#official-runtimes/node-js) and [advanced usage docs](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage) should be used as your reference for understanding the above features in detail.\n\n**Todo**\n\nThe following configuration options will be supported in the near future:\n\n- [cleanUrls](https://vercel.com/docs/configuration#project/cleanurls)\n- [trailingSlash](https://vercel.com/docs/configuration#project/trailingslash)\n\n
\n\n## Supported Frameworks\n\nI have tested the CLI against the following frameworks, utilising the [\"Zero Config\"](https://vercel.com/blog/zero-config) approach.\n\n- [x] Create React App\n- [x] Create React App + TypeScript\n- [x] Gatsby\n- [x] Vue.js\n- [ ] Svelte\n- [ ] Angular\n- [ ] Ember.js\n- [ ] Hugo\n- [ ] Preact\n- [ ] Docusaurus\n- [ ] Gridsome\n- [ ] Nuxt.js\n- [ ] Eleventy\n- [ ] Hexo\n\n
\n\n## Limitations\n\nBelow is a list of the Vercel features that this CLI does not support. These limitations are intentional, and the likelihood is that I will not extend the CLI to support them.\n\n- Support for any of the other runtimes - i.e. Go, Ruby, Python, or bespoke.\n\n > I feel like Node.js is where Vercel really shines, and IMO feel like they should have gone all in on Node.js rather than supporting an array of runtimes.\n\n- Support for any of the following [`vercel.json` configuration](https://vercel.com/docs/configuration#introduction) options:\n\n - [headers](https://vercel.com/docs/configuration#project/headers)\n - [redirects](https://vercel.com/docs/configuration#project/redirects)\n - [rewrites](https://vercel.com/docs/configuration#project/rewrites)\n\n > Despair not! All of these configuration options can be represented via the [routes](https://vercel.com/docs/configuration#project/routes) configuration, which is supported.\n\n- Support for the raw AWS lambda API, which is currently [supported by the official Node.js runtime](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/aws-lambda-api)\n\n > As stated in their docs, this has been exposed to help clients with existing lambdas migrate over to their platform. I'm not convinced this alternative CLI should support this.\n\n- The bespoke [Vercel](https://vercel.com/) 4XX / 5XX error pages.\n\n > Meh. I return the expected error codes. I'd recommend you implement your own custom error pages in your UI anyways.\n\n- Support for [disabling the Node.js helpers](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/disabling-helpers-for-node-js)\n\n > This has more of an impact on production environments, where you would want to hyper optimise lambda performance in some cases.\n\n- Support for [Next.js](https://nextjs.org/) projects.\n\n > Next has it's own development server with bespoke features around the APIs and pages. I would recommend using the `next dev` command instead.\n\n
\n\n## CLI Options\n\nThe CLI current supports the following options.\n\n- `--debug-apis` | `-d`\n\n Setting this flag will enable the debugger against your lambdas.\n\n- `--debug-apis-port [number]` | `-o [number]`\n\n Allows you to specify the port at which the debugger for your lambdas will run. By default it runs on port `9229`.\n\n- `--port [number]` | `-p [number]`\n\n Allows you to specify the port at which the `vercel-node-dev` server will run. By default it will attempt to bind to port `3000`.\n\n
\n\n## Specifying a custom develop command\n\nIf you aren't using one of the [supported frameworks](#supported-frameworks), or if you would like to customise the develop command, then you can add a `dev` script to your `package.json`:\n\n```json\n{\n \"scripts\": {\n \"dev\": \"my-dev-tool -p $PORT\"\n }\n}\n```\n\n**Note:** It is important that you pass through the `$PORT` environment variable as shown in the example above. This is so that your development server can be correctly managed by `vercel-node-dev`.\n\n
\n\n## Debugging your Lambdas\n\nYou can enabled the debugger for your lambdas by providing the respective option to the CLI:\n\n```bash\nvercel-node-dev --debug-apis\n```\n\nThis will start the development server, with the debugger instance running. By default the debugger runs on port `9229`. You can change the port number via the `--debug-apis-port` option.\n\nOnce the debugger is running you can attach to it utilising your tool of choice.\n\n### Debugging via VSCode\n\nBelow is a set of [`code` debug configurations](https://code.visualstudio.com/docs/editor/debugging), allowing you to either start the `vercel-dev-node` instance with the debugger attached, or to attach to an already executing debugger instance.\n\n```jsonc\n{\n \"version\": \"0.2.0\",\n \"configurations\": [\n // This will start vercel-node-dev with the debugger attached\n {\n \"name\": \"Launch vercel-node-dev\",\n \"type\": \"node\",\n \"request\": \"launch\",\n \"program\": \"vercel-node-dev\",\n \"args\": [\"--debug-apis\"],\n \"skipFiles\": [\"
\n\n## Bonus: Unit Testing your Lambdas\n\nThis tool leverages another library I built, [`vercel-node-server`](https://github.com/ctrlplusb/vercel-node-server), which allows you to create `http` instances of your lambdas. This opens up opportunities for you to write integration or unit tests for you lambdas.\n\nFirstly, install the library as development dependency:\n\n```bash\nnpm install -D vercel-node-server\n```\n\nYou can then write tests for your lambdas similar to the one below:\n\n```javascript\nimport { createServer } from 'vercel-node-server';\nimport listen from 'test-listen';\nimport axios from 'axios';\nimport helloLambda from './api/hello';\n\nlet server;\nlet url;\n\nbeforeAll(async () => {\n server = createServer(routeUnderTest);\n url = await listen(server);\n});\n\nafterAll(() => {\n server.close();\n});\n\nit('should return the expected response', async () => {\n const response = await axios.get(url, { params: { name: 'Pearl' } });\n expect(response.data).toBe('Hello Pearl');\n});\n```\n","readmeFilename":"README.md","gitHead":"1f56cd048136261eebd8278f92683ce65fd66965","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.5.0-alpha.6","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-FnU8/hFHxzYunmmveeIn3jVyPVUOcbmGwXJkKLGg/W1R6PsYpdDu20W0c1u0AqZuFufJ2TteXUbC4Sj0OOOR4g==","shasum":"e1ea3036c4a4e45b02c1795890847667f5b424df","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.5.0-alpha.6.tgz","fileCount":18,"unpackedSize":65567,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe31Y4CRA9TVsSAnZWagAAkrYP/33ZhMUCv27EF0u9M/aR\nDPh7RYV2MmihUnDde65iNPfHLPb6H1bbX2ExGsuFNGofyZovvbgCCitB7+0Z\nGT+YPMk5GlJYvMBnRoN7W9WCJTca727DS9YLuXcNS1TZ45StNi9SdiVo1Vu5\no8tOTWq6c3JZzi7OuDXHXxT86u123dBvpFkjgJOzZaYekjAZcYouDdH5dOL4\nP5oMRj7mFqpQ4sNhbeepkMhZ+60vuY+sdjSEgHEMvRt7CeVcjabfRhdYy5HE\nu2hb0uYIHMBLxox8roRFksCPOME+TivR5Cps31uz6TtOGzBxQMJ6OKgr+s3e\nuEUeq3F+8UrQLCKwaZQKp2f8UWHKGfRj19rDmwS9myPmhT5b2Om+oVof6A4u\n+OrN1kjbzaHHExLoGqWcAj5n57FnBNkl7jRCn5Do8lf+Yp/YsXQpF9rmJ/pR\n3OU2Ep486jZ4UdGEJnL0WHjon2Pa0AwaWiUCnJMt37sI7ck9iSUtR0U20q47\n1DCIEsersiwCLJ/mBBtCmy4qKTIeR0x6vlOwLVayA4sAWMfljeOZT9jkR26l\n0eHyVs8hnM763cC5tIt3P/UT1m2AT3nkUtxL374ZNONFPULGfC7S0E+Ug/om\nnzEonLlBWMbm3TjIhIxPDbgmYQtFoWq6tbIqFgfcAkaVNMl/bKhgV/WSwMaP\nUKFG\r\n=nP1b\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQDp6Pgkrob/gjITWuj+L5+r3NaZcTQevcx4D6y+Pc4dMwIhAJmdC1F7e3rGCCkyCmI8Soc0cup8cOxfA7FXaUnWWDyU"}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.5.0-alpha.6_1591694903973_0.766129993457292"},"_hasShrinkwrap":false},"0.5.0":{"name":"vercel-node-dev","version":"0.5.0","description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","license":"MIT","author":{"name":"Sean Matheson"},"repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"bin":{"vercel-node-dev":"bin/vercel-node-dev","vnd":"bin/vercel-node-dev"},"engines":{"node":">=10"},"scripts":{"test":"jest","experiment":"FORCE_COLOR=1 VND_TARGET_PATH=targets/finished node -r ts-node/register --preserve-symlinks src"},"dependencies":{"@vercel/build-utils":"^2.3.1","@vercel/frameworks":"^0.0.14","@vercel/node":"^1.6.1","@vercel/routing-utils":"^1.8.2","chalk":"^4.0.0","dedent":"^0.7.0","dotenv":"^8.2.0","execa":"^4.0.2","fs-extra":"^9.0.1","get-port":"^5.1.1","globby":"^11.0.1","http-proxy":"^1.18.1","load-json-file":"^6.2.0","meow":"^7.0.1","npm-run":"^5.0.1","p-timeout":"^3.2.0","pretty-format":"^26.0.1","strip-color":"^0.1.0","tempy":"^0.5.0","ts-node-dev":"^1.0.0-pre.44","typescript":"^3.9.5","vercel-node-server":"^2.2.1","wait-port":"^0.2.9","write-json-file":"^4.3.0"},"devDependencies":{"@types/dedent":"^0.7.0","@types/fs-extra":"^9.0.1","@types/http-proxy":"^1.17.4","@types/jest":"^25.2.1","@types/node":"^14.0.12","@types/strip-color":"^0.1.0","@typescript-eslint/eslint-plugin":"^3.2.0","@typescript-eslint/parser":"^3.2.0","axios":"^0.19.2","babel-eslint":"^10.1.0","eslint":"^7.1.0","eslint-config-prettier":"^6.11.0","eslint-config-react-app":"^5.2.1","eslint-plugin-flowtype":"^5.1.3","eslint-plugin-import":"^2.21.1","eslint-plugin-jsx-a11y":"^6.2.3","eslint-plugin-prettier":"^3.1.3","eslint-plugin-react":"^7.20.0","eslint-plugin-react-hooks":"^4.0.4","husky":"^4.2.5","jest":"^26.0.1","prettier":"^2.0.5","ts-jest":"^26.1.0"},"prettier":{"semi":true,"singleQuote":true,"trailingComma":"all"},"eslintConfig":{"root":true,"parser":"@typescript-eslint/parser","extends":["react-app","plugin:@typescript-eslint/recommended","prettier","prettier/@typescript-eslint"],"plugins":["@typescript-eslint"],"env":{"commonjs":true,"es6":true,"node":true,"jest":true},"rules":{"@typescript-eslint/explicit-function-return-type":0}},"eslintIgnore":["**/node_modules/*"],"gitHead":"3f4bbbdbefb1ec6be9e0ff4b2a53548cad576a0d","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.5.0","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-Ghpa+Xv8cyU25MVNysydc6hw/9w1ML6YRNJSi+5NtIshWYkb4btl+23NzguTAdM/zhVy9UuHAO4SeIisS9VGyA==","shasum":"1142fbbe1f4abb8bf8d706aef40fdd93cd741317","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.5.0.tgz","fileCount":18,"unpackedSize":65559,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe31c1CRA9TVsSAnZWagAALO4P/2Tf+xQ7iNlwCrw54C7/\ns3ud9GCxDCBIKIBRD7EjWs7+2hUhqRSftSOHrqNPLSz9z3QEiTaLiLccGpHK\nh3S5WQbdr36vJTgg8mtichdez3EmXO//rtQeze1L807roUG0eRQRHVExongG\n0Mb6rFJVWaVP7rOpOCbMGAt+N+SE4vduSnucUpvT5FrS8UyskcphpihYw4GQ\nu3sY4qMOaF38uuufavSDqP/54Ilp1CPKwWYziEQJNzIouK5psC2zTmoR+8v+\nDe7QBVtVZ4Yrhs7R/K9U1BoDCj4+5FjFMysEf34sv54PwwmzmsMO5Xv+C/gY\nxIBpVTC7eoAoro+ZhV6/S8vSqqan+iGUgaqkbbFATEvQmLxGVppxiSbsW3j0\nDkP6ZNyDzwW1wJjVLGB0f8LeUY3ubDnkcy/mjX4/wFukhOVf1QvUgqrggYoS\nWie44NSM4enZxzxvYUOz/L4CcJbglN+1elnsDu37IWDAvpN/w7VF0Sp1ZNS0\njDDG2EMwOZIxQQTpATKoeMAGa1VV13sGH25MNXeqiGCgpjKGyfK1vj/cDcbj\nmpz9TL+wpXpm6nLYXoPLSRfX9KVp4FoW13UkpcHh9Q2g4KRbTC2NdydrZwll\n3CJUqgI4Tf4mQeur239lCGg5i9/yQMQuiPnkSE+rq+0rkRjwG2E+4cCx+dlP\nr9l0\r\n=Yrmi\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQDCWZf2qlb10uhFeBJr076zNRwSuKF1dBM37I3UbTvHEQIgTPbhduezOP819H9Zp1+Cf8JJ8le4dM1a8fhumLyoSO4="}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.5.0_1591695156730_0.8366361534409472"},"_hasShrinkwrap":false},"0.6.0":{"name":"vercel-node-dev","version":"0.6.0","description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","license":"MIT","author":{"name":"Sean Matheson"},"repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"bin":{"vercel-node-dev":"bin/vercel-node-dev","vnd":"bin/vercel-node-dev"},"engines":{"node":">=10"},"scripts":{"test":"jest","experiment":"FORCE_COLOR=1 VND_TARGET_PATH=targets/finished node -r ts-node/register --preserve-symlinks src"},"dependencies":{"@vercel/build-utils":"^2.3.1","@vercel/frameworks":"^0.0.14","@vercel/node":"^1.6.1","@vercel/routing-utils":"^1.8.2","chalk":"^4.1.0","dedent":"^0.7.0","dotenv":"^8.2.0","execa":"^4.0.2","fs-extra":"^9.0.1","get-port":"^5.1.1","globby":"^11.0.1","http-proxy":"^1.18.1","load-json-file":"^6.2.0","meow":"^7.0.1","npm-run":"^5.0.1","p-timeout":"^3.2.0","pretty-format":"^26.0.1","strip-color":"^0.1.0","tempy":"^0.5.0","ts-node-dev":"^1.0.0-pre.44","typescript":"^3.9.5","vercel-node-server":"^2.2.1","wait-port":"^0.2.9","write-json-file":"^4.3.0"},"devDependencies":{"@types/dedent":"^0.7.0","@types/fs-extra":"^9.0.1","@types/http-proxy":"^1.17.4","@types/jest":"^26.0.0","@types/node":"^14.0.13","@types/strip-color":"^0.1.0","@typescript-eslint/eslint-plugin":"^3.2.0","@typescript-eslint/parser":"^3.2.0","axios":"^0.19.2","babel-eslint":"^10.1.0","eslint":"^7.1.0","eslint-config-prettier":"^6.11.0","eslint-config-react-app":"^5.2.1","eslint-plugin-flowtype":"^5.1.3","eslint-plugin-import":"^2.21.2","eslint-plugin-jsx-a11y":"^6.2.3","eslint-plugin-prettier":"^3.1.3","eslint-plugin-react":"^7.20.0","eslint-plugin-react-hooks":"^4.0.4","husky":"^4.2.5","jest":"^26.0.1","prettier":"^2.0.5","ts-jest":"^26.1.0"},"prettier":{"semi":true,"singleQuote":true,"trailingComma":"all"},"eslintConfig":{"root":true,"parser":"@typescript-eslint/parser","extends":["react-app","plugin:@typescript-eslint/recommended","prettier","prettier/@typescript-eslint"],"plugins":["@typescript-eslint"],"env":{"commonjs":true,"es6":true,"node":true,"jest":true},"rules":{"@typescript-eslint/explicit-function-return-type":0}},"eslintIgnore":["**/node_modules/*"],"gitHead":"8eb9a4d5aef5a8363b8433cf9ae27b294019de02","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.6.0","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-5LtAMeeVP0g5PsY3+5BsTdQq9fMmKeQLIdY6juNbWQiaxWOcQSztr7eLV+/XG96SNAH4rw7l8etaYxA06o/VpQ==","shasum":"756dcbc12ed3f082cd8af8fb1999e97fceb49ce3","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.6.0.tgz","fileCount":18,"unpackedSize":66355,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJe4OHPCRA9TVsSAnZWagAAnh8P/2NDm5dpLL7DErOk8d57\nP0Vw1ai1XQhoTBhJwgRlNREU+2jkWUde2cyDgWJITgf+xA/rpH7B8GKec2Za\n6ECWgDa2P+xDcvljA882qxiWLR1KlreY/UY1bTtWDiQDdIVW0JSixzhLjub8\nSCEacakltO0hjou8kPFNFCoDd2KCuNRDTN616jIRWBXbPHuDK+3scyLDUDLa\n3DhzJr+QTZOnHpFU0DVf/P05MqwniilpbOkbqM8laOYzsTz/tJAfUunkY9M+\nYd8QsDbNVy+II2H19pqhT0fmxqmCRJ3WID0Q6BVfPmLUpgjHm9qJrQK9nSnm\nW+g8hIJazxbf7kTKG6/DTcSbmZLWtp7MXArWTMmD4oumSNzlD8zgiyMs6CZ7\nInqzuugpV4S2CX+FPNURUSCzHmdwajsxrxiOZmPv+//nX4N2jFPWNMr0A8OL\nkiGTlZZgGWnTHA/8LuxTroZGgRpzGlE8sDHxHl9sm8NXU1eaXT3A9KmKbylI\nCi66P8t3M2MdkT+FeR1RoFqWxBbAl/d+TP77ZpncqiIXC0E8nTUgfuMK0sKP\neoPJARjC2NDS4z8SvR5Kf7rH+wBWwIrKCNU7K+fCXsJ3cy+1fr+CIjqlydxe\nIwn2jlOsusbMMxkozdcVDZfZ5bBeMe9xxm9D19fws/K+oVPMlVRfDEIPhmi3\nbAt5\r\n=p04m\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIBVEvlLzr5nZXJkokzo5Yyaa3rKn4R0R/739fKrtJucDAiBulWG+1Bk1zsBWPiI/zaxq3Es5pdDC2sSrSGP0yrb1aQ=="}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.6.0_1591796175273_0.8593058996525402"},"_hasShrinkwrap":false},"0.7.0":{"name":"vercel-node-dev","version":"0.7.0","description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","license":"MIT","author":{"name":"Sean Matheson"},"repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"bin":{"vercel-node-dev":"bin/vercel-node-dev","vnd":"bin/vercel-node-dev"},"engines":{"node":">=10"},"scripts":{"test":"jest","experiment":"FORCE_COLOR=1 VND_TARGET_PATH=targets/finished node -r ts-node/register --preserve-symlinks src"},"dependencies":{"@vercel/build-utils":"^2.3.1","@vercel/frameworks":"^0.0.14","@vercel/node":"^1.6.1","@vercel/routing-utils":"^1.8.2","chalk":"^4.1.0","dedent":"^0.7.0","dotenv":"^8.2.0","execa":"^4.0.2","fs-extra":"^9.0.1","get-port":"^5.1.1","globby":"^11.0.1","http-proxy":"^1.18.1","load-json-file":"^6.2.0","meow":"^7.0.1","npm-run":"^5.0.1","p-timeout":"^3.2.0","pretty-format":"^26.0.1","strip-color":"^0.1.0","tempy":"^0.5.0","ts-node-dev":"^1.0.0-pre.44","typescript":"^3.9.5","vercel-node-server":"^2.2.1","wait-port":"^0.2.9","write-json-file":"^4.3.0"},"devDependencies":{"@types/dedent":"^0.7.0","@types/fs-extra":"^9.0.1","@types/http-proxy":"^1.17.4","@types/jest":"^26.0.0","@types/node":"^14.0.13","@types/strip-color":"^0.1.0","@typescript-eslint/eslint-plugin":"^3.2.0","@typescript-eslint/parser":"^3.2.0","axios":"^0.19.2","babel-eslint":"^10.1.0","eslint":"^7.1.0","eslint-config-prettier":"^6.11.0","eslint-config-react-app":"^5.2.1","eslint-plugin-flowtype":"^5.1.3","eslint-plugin-import":"^2.21.2","eslint-plugin-jsx-a11y":"^6.2.3","eslint-plugin-prettier":"^3.1.3","eslint-plugin-react":"^7.20.0","eslint-plugin-react-hooks":"^4.0.4","husky":"^4.2.5","jest":"^26.0.1","prettier":"^2.0.5","ts-jest":"^26.1.0"},"prettier":{"semi":true,"singleQuote":true,"trailingComma":"all"},"eslintConfig":{"root":true,"parser":"@typescript-eslint/parser","extends":["react-app","plugin:@typescript-eslint/recommended","prettier","prettier/@typescript-eslint"],"plugins":["@typescript-eslint"],"env":{"commonjs":true,"es6":true,"node":true,"jest":true},"rules":{"@typescript-eslint/explicit-function-return-type":0}},"eslintIgnore":["**/node_modules/*"],"gitHead":"aa6ff49820cf5f9f0d7deea8c1d1eed2b0208c95","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.7.0","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-BKyuJ3P7nvfXncJUgwhyFlGd2IWHNuzR/tRnDpxssRXR6FyxpJ6i+lBapdRypHdXqrPf9AFeAnEzJZbzYjYmCA==","shasum":"77dc06f1344d0d14f06f4c9ebfd856b5b8b1ac11","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.7.0.tgz","fileCount":18,"unpackedSize":66600,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJfDwaWCRA9TVsSAnZWagAAInwP/i57rZE9Gc6zGZruJaJ1\nHa0ngRyXhsteDABl5q6scXL1I8TXsy00SkyVECW0ratdVGy0QxpU++m5u49q\nwVF4Ci9zK2w7e3Uo8WaUofQYt5cGqXKbn/YCSOrZvPBFoSWW2EfYMQFLEw6m\nWlVS43/q6oQrWgo2+jm907ZZRBl+MTNpKR0KTyPAypiv42e5g3Otf2vPWGRq\nLfxgp1DY2IpU8rjgsbqaaMMEwVb8KW/XCDPwex3c3ONNHeQTaZONSh/RufiX\n1N2In6ShDcQJe5jsiWJSkZCwZRy3NGvtATvubF+QCYX1bS11OZqdSMLy/mRl\nvkFDlV9QsVKAX7upSJuQKtz6yuqfZg20xkG8GEocBAfLvwslExxcZT/k/Z6l\n212hyFGu5LTV8nTMg1H+/ZllQAQYCOZCwcco0I2AJRu16VCW+IP0RHNRkKoU\nL/I4VNjMD9Wu4YxHUOqYDr09Ytg2sYV0ef844RLjvrEXNVVthcyE5uvhjTn3\n7i8Lh2zSDr8MvQM5vN8adxpEclFnjtvKVkOU5ycAqCwqSDEXL+gj8HEslCpR\nigdtootfvGMP2Dun1goRcqE2uL/LtkEmBN2dQUVTKz/GjpBMZlxnP0t4ATV9\n6kAN3RTEosgugGpjbtho8V6aG1X/uJRDmuaVLnazwnt/oObsJipLnxBCS00+\nDLcv\r\n=7CuD\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIErwcspYavi0VMUmalSie2YWsBmksVuOnfRxfNmnx0JPAiEAwbx1C04KJNIl+4HYAvhtEaVi/lBkhPRWZaEYo7oDIKU="}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.7.0_1594820246083_0.6393297219537588"},"_hasShrinkwrap":false},"0.7.1":{"name":"vercel-node-dev","version":"0.7.1","description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","license":"MIT","author":{"name":"Sean Matheson"},"repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"bin":{"vercel-node-dev":"bin/vercel-node-dev","vnd":"bin/vercel-node-dev"},"engines":{"node":">=10"},"scripts":{"test":"jest","experiment":"FORCE_COLOR=1 VND_TARGET_PATH=targets/finished node -r ts-node/register --preserve-symlinks src"},"dependencies":{"@vercel/build-utils":"^2.4.1","@vercel/frameworks":"^0.0.16","@vercel/node":"^1.7.2","@vercel/routing-utils":"^1.8.3","chalk":"^4.1.0","dedent":"^0.7.0","dotenv":"^8.2.0","execa":"^4.0.3","fs-extra":"^9.0.1","get-port":"^5.1.1","globby":"^11.0.1","http-proxy":"^1.18.1","load-json-file":"^6.2.0","meow":"^7.0.1","npm-run":"^5.0.1","p-timeout":"^3.2.0","pretty-format":"^26.1.0","strip-color":"^0.1.0","tempy":"^0.5.0","ts-node-dev":"^1.0.0-pre.51","typescript":"^3.9.6","vercel-node-server":"^2.2.1","wait-port":"^0.2.9","write-json-file":"^4.3.0"},"devDependencies":{"@types/dedent":"^0.7.0","@types/fs-extra":"^9.0.1","@types/http-proxy":"^1.17.4","@types/jest":"^26.0.4","@types/node":"^14.0.23","@types/strip-color":"^0.1.0","@typescript-eslint/eslint-plugin":"^3.6.1","@typescript-eslint/parser":"^3.6.1","axios":"^0.19.2","babel-eslint":"^10.1.0","eslint":"^7.4.0","eslint-config-prettier":"^6.11.0","eslint-config-react-app":"^5.2.1","eslint-plugin-flowtype":"^5.2.0","eslint-plugin-import":"^2.22.0","eslint-plugin-jsx-a11y":"^6.3.1","eslint-plugin-prettier":"^3.1.4","eslint-plugin-react":"^7.20.3","eslint-plugin-react-hooks":"^4.0.8","husky":"^4.2.5","jest":"^26.1.0","prettier":"^2.0.5","ts-jest":"^26.1.2"},"prettier":{"semi":true,"singleQuote":true,"trailingComma":"all"},"eslintConfig":{"root":true,"parser":"@typescript-eslint/parser","extends":["react-app","plugin:@typescript-eslint/recommended","prettier","prettier/@typescript-eslint"],"plugins":["@typescript-eslint"],"env":{"commonjs":true,"es6":true,"node":true,"jest":true},"rules":{"@typescript-eslint/explicit-function-return-type":0}},"eslintIgnore":["**/node_modules/*"],"gitHead":"5911986027e3da4d9db529e611ddbd50ab1d41a1","bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","_id":"vercel-node-dev@0.7.1","_nodeVersion":"12.16.1","_npmVersion":"6.14.5","dist":{"integrity":"sha512-HyTXK+d2YBwLDq2uNhuCcrZGWvCCxfLJH3Q5WOSuASz9eCt+7/2hVtdRvnbnCb7buGaQSsR5OfWpcWlp4nostg==","shasum":"e5b4d759b4d0a36bdd7489d4ac4f6255e6bbde0b","tarball":"https://registry.npmjs.org/vercel-node-dev/-/vercel-node-dev-0.7.1.tgz","fileCount":18,"unpackedSize":66601,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJfDwmRCRA9TVsSAnZWagAA6m4P/1BrO0W8zVlbYUpdFRs9\ndRetiUYntYoiaFdvNeuIGj9CLZBHrDjdHVYPCQduDXeTMnNPnWKphnf9UEUF\n8XJAC8DSSLqwNWfpuEivwc2lLlq1UyL0NdseVJq3gH+kFTDrU/EOCqdcGbtA\nuDD36+knBe9/r+NW+/PaTCY1sT2wYm6fKlF0S5t7V+rsCPFiyPl6O3Xkq51A\njwHIR5zBnn+CaNO22eenNRfYrz9AwLZaYORzul1mcKjg6w8IpbOhfx+1TwNv\nfi1F+lxspZkJ7BKTIPxOUiG0G9PH9OsiTRcLPGcrjSjEpHLd4+vq7zm1wKkh\nOU/pRwju/sRbiN3LK0JDmoQ9g5tgXLsaADy7cxf1bKwKVwEMROwDo/1P2FzL\nNWCx+iNWULiXLG/5WoqHlnjZdIcPmsAiWNfCzSiN+lcOESWY0P0juHmDihx/\ni66tKhIS/kbn7RT8PGB9oO7Ye2EOWiLc/oLZIqGZjLPjMRyJ1FBb7v86p9il\nJmcZkEWhX+WNlRAdcL2cXo2lOlUNNGhEKY0OdyxosW4J/bgf5kIDw7HX/Esp\n9eHdm4WMgiUkNPJ4vdv1wANHOIeoOFiEaEsBW3TS1IxZjHz+/l+PburTea1D\nUMy6LKozgK7Mt+GET7rGn2VJ+dXTHHtg8NevMNhhwxm2pQd0nZfgWjwxUX6q\n/xJp\r\n=MJqc\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIFdKHJUYkQBNNjbgx4+9JpWcPrydKXDBvaMy89fyn36lAiAOaWNfzqYTfSpOBwiMT51zo8jayauQFl9BRZ+D27vUHQ=="}]},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"_npmUser":{"name":"ctrlplusb","email":"sean@ctrlplusb.com"},"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/vercel-node-dev_0.7.1_1594821008935_0.4975062328185009"},"_hasShrinkwrap":false}},"time":{"created":"2020-06-03T07:40:20.033Z","0.1.0":"2020-06-03T07:40:20.249Z","modified":"2022-05-23T04:59:47.240Z","0.1.1":"2020-06-03T07:58:41.099Z","0.1.2":"2020-06-03T08:00:37.268Z","0.1.3":"2020-06-03T13:35:17.897Z","0.1.4":"2020-06-03T15:54:01.882Z","0.1.5":"2020-06-03T22:22:19.038Z","0.1.6":"2020-06-03T23:49:20.809Z","0.1.7":"2020-06-04T05:54:59.153Z","0.2.0":"2020-06-04T06:51:59.514Z","0.2.1":"2020-06-04T07:23:56.086Z","0.2.2":"2020-06-04T07:30:44.621Z","0.2.3":"2020-06-04T07:57:58.016Z","0.2.4":"2020-06-04T08:05:26.361Z","0.2.5":"2020-06-04T08:12:08.033Z","0.4.0":"2020-06-09T04:52:00.186Z","0.4.1":"2020-06-09T06:46:47.686Z","0.4.2":"2020-06-09T07:22:35.263Z","0.5.0-alpha.0":"2020-06-09T07:45:20.610Z","0.5.0-alpha.1":"2020-06-09T07:48:36.568Z","0.5.0-alpha.2":"2020-06-09T07:51:41.097Z","0.5.0-alpha.3":"2020-06-09T07:56:24.937Z","0.5.0-alpha.4":"2020-06-09T09:20:40.041Z","0.5.0-alpha.5":"2020-06-09T09:23:47.350Z","0.5.0-alpha.6":"2020-06-09T09:28:24.121Z","0.5.0":"2020-06-09T09:32:36.970Z","0.6.0":"2020-06-10T13:36:15.425Z","0.7.0":"2020-07-15T13:37:26.191Z","0.7.1":"2020-07-15T13:50:09.067Z"},"maintainers":[{"name":"ctrlplusb","email":"sean@ctrlplusb.com"}],"description":"An unofficial development CLI for Vercel applications targeting the Node.js runtime.","homepage":"https://github.com/ctrlplusb/vercel-node-dev#readme","repository":{"type":"git","url":"git+https://github.com/ctrlplusb/vercel-node-dev.git"},"author":{"name":"Sean Matheson"},"bugs":{"url":"https://github.com/ctrlplusb/vercel-node-dev/issues"},"license":"MIT","readme":"
\nAn unofficial development CLI for Vercel applications targeting the Node.js runtime.\n
\n\n\nFast reloads, improved reliability, offline and debugger support.\n
\n\n\n \n \n \n
\n\n## Table of Contents\n\n- [Features](#features)\n- [Motivation](#motivation)\n- [Vercel vs Us?](#vercel-vs-us)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Supported Features](#supported-features)\n- [Supported Frameworks](#supported-frameworks)\n- [Limitations](#limitations)\n- [CLI Options](#cli-options)\n- [Specifying a custom develop command](#specifying-a-custom-develop-command)\n- [Debugging your Lambdas](#debugging-your-lambdas)\n- [Bonus: Unit Testing your Lambdas](#bonus-unit-testing-your-lambdas)\n\n
\n\n## Features\n\n- Optimised for the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Built against the [Vercel specifications](https://vercel.com/docs/runtimes#official-runtimes/node-js)\n- Supports Vercel [\"Zero Config\"](https://vercel.com/blog/zero-config) approach\n- Supports both JavaScript or TypeScript lambdas\n- Supports the attaching of a debugger session against lambda execution\n- Supports Vercel custom [routes](https://vercel.com/docs/configuration#project/routes) configuration\n- Fast reloading for any changes to your lambdas\n- Extensively tested and verified via an integration test suite\n- Can be run offline\n- No need for a Vercel project to be configured prior to execution\n- Does not need to be installed as a local dependency\n\n
\n\n## Motivation\n\n[Vercel](https://vercel.com/) provides its own development environment via the `vercel dev` command. Whilst this tool is powerful, I was experiencing the following issues:\n\n- **Performance:** The feedback loop when making changes to my lambdas was very slow. After making a change, the subsequent request to the lamda would result in a significant wait for the lambda to be rebuilt and then served.\n- **Reliability:** When making changes to my lambdas the build performance degraded over time, eventually resulting in them becoming unresponsive. The only way I was able to resolve this was to restart the `vercel dev` command, significantly impacting my development flow.\n- **Debugging:** I was unable to attach a debugger instance against my lambdas. Whilst I try not to overuse the debugger, preferring to leverage integration tests, there are times when a debugger session can work wonders at issue discovery.\n- **Usability:** There was a double hit for me here. Firstly, you need to have first set up / linked your project to a project configuration against Vercel. Secondly, and related to the first point, you need to be connected to the internet in order to use the tool.\n\nThe implementation of `vercel-node-dev` addresses these issues; focussing on the [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js), which allowed me to create a much more bespoke and optimised development tool.\n\n
\n\n## Vercel vs Us?\n\nThis tool is **_not_** meant to be **_competitive_**!\n\nIt is released with good intentions and respect for the Vercel team and community, offering a temporary alternative for those who may be experiencing similar issues with their development flow.\n\nThe `vercel dev` command is still in **beta**. My belief is that the Vercel team will eventually address the issues above, at which point this CLI will be deprecated. Given that we are following the official Vercel specifications, this would be a zero impact move for those using this CLI. You would only need to switch to executing the official `vercel dev` command instead of this one.\n\n
\n\n## Installation\n\nWe recommend installing this library globally. This will allow you to quickly and easily use it against any of your Vercel applications, without polluting them with additional dependencies.\n\n```bash\nnpm install -g vercel-node-dev\n```\n\nAfter the installation two CLI commands will be available to you, namely;\n\n- `vercel-node-dev`\n- `vnd` - a shorter aliased version\n\n
\n\n## Usage\n\nSimply navigate to the root of the [Vercel](https://vercel.com/) application and execute the CLI.\n\n```bash\nvercel-node-dev\n```\n\nSimilar to the `vercel dev` command we will attempt to bind the development server against port `3000`.\n\nOpen your web browser and browse to `http://localhost:3000`.\n\n
\n\n## Supported Features\n\nBelow is a list of the official Vercel features that we support.\n\nI don't add any additional API features in comparison to the official APIs.\n\nThe design goal of this tool is to support as much of the official API as possible, whilst providing an improved development experience.\n\n- The [\"Zero Config\"](https://vercel.com/blog/zero-config) approach promoted by Vercel.\n- TypeScript (`.ts`) or JavaScript (`.js`) lambdas, within the `/api` directory, with filesystem based routing.\n- The ability to [ignore files/directories](https://vercel.com/docs/v2/serverless-functions/introduction#prevent-endpoint-listing) within your `/api` directory from being bound as lambdas.\n- [Path segments](https://vercel.com/docs/v2/serverless-functions/introduction#path-segments) for your lambdas.\n- A [custom build step](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/custom-build-step-for-node-js), which will be executed prior to the execution of your lambdas.\n- Automatic exposure of any environment variables defined within the `.env` file defined in the root of the project. This is inline with the [approach recommended by Vercel](https://vercel.com/docs/v2/build-step#environment-variables) for managing environment variables.\n- Automated [extension of the HTTP Request and Response objects](https://vercel.com/docs/runtimes#official-runtimes/node-js/node-js-request-and-response-objects/node-js-helpers) that are passed into your lambdas.\n- Custom [routes](https://vercel.com/docs/configuration#project/routes) configuration.\n\nWe follows the design, API, and features of the official [Node.js runtime](https://vercel.com/docs/runtimes#official-runtimes/node-js) as closely as possible.\n\nThe [official docs](https://vercel.com/docs/runtimes#official-runtimes/node-js) and [advanced usage docs](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage) should be used as your reference for understanding the above features in detail.\n\n**Todo**\n\nThe following configuration options will be supported in the near future:\n\n- [cleanUrls](https://vercel.com/docs/configuration#project/cleanurls)\n- [trailingSlash](https://vercel.com/docs/configuration#project/trailingslash)\n\n
\n\n## Supported Frameworks\n\nI have tested the CLI against the following frameworks, utilising the [\"Zero Config\"](https://vercel.com/blog/zero-config) approach.\n\n- [x] Create React App\n- [x] Create React App + TypeScript\n- [x] Gatsby\n- [x] Vue.js\n- [ ] Svelte\n- [ ] Angular\n- [ ] Ember.js\n- [ ] Hugo\n- [ ] Preact\n- [ ] Docusaurus\n- [ ] Gridsome\n- [ ] Nuxt.js\n- [ ] Eleventy\n- [ ] Hexo\n\n
\n\n## Limitations\n\nBelow is a list of the Vercel features that this CLI does not support. These limitations are intentional, and the likelihood is that I will not extend the CLI to support them.\n\n- Support for any of the other runtimes - i.e. Go, Ruby, Python, or bespoke.\n\n > I feel like Node.js is where Vercel really shines, and IMO feel like they should have gone all in on Node.js rather than supporting an array of runtimes.\n\n- Support for any of the following [`vercel.json` configuration](https://vercel.com/docs/configuration#introduction) options:\n\n - [headers](https://vercel.com/docs/configuration#project/headers)\n - [redirects](https://vercel.com/docs/configuration#project/redirects)\n - [rewrites](https://vercel.com/docs/configuration#project/rewrites)\n\n > Despair not! All of these configuration options can be represented via the [routes](https://vercel.com/docs/configuration#project/routes) configuration, which is supported.\n\n- Support for the raw AWS lambda API, which is currently [supported by the official Node.js runtime](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/aws-lambda-api)\n\n > As stated in their docs, this has been exposed to help clients with existing lambdas migrate over to their platform. I'm not convinced this alternative CLI should support this.\n\n- The bespoke [Vercel](https://vercel.com/) 4XX / 5XX error pages.\n\n > Meh. I return the expected error codes. I'd recommend you implement your own custom error pages in your UI anyways.\n\n- Support for [disabling the Node.js helpers](https://vercel.com/docs/runtimes#advanced-usage/advanced-node-js-usage/disabling-helpers-for-node-js)\n\n > This has more of an impact on production environments, where you would want to hyper optimise lambda performance in some cases.\n\n- Support for [Next.js](https://nextjs.org/) projects.\n\n > Next has it's own development server with bespoke features around the APIs and pages. I would recommend using the `next dev` command instead.\n\n
\n\n## CLI Options\n\nThe CLI current supports the following options.\n\n- `--debug-apis` | `-d`\n\n Setting this flag will enable the debugger against your lambdas.\n\n- `--debug-apis-port [number]` | `-o [number]`\n\n Allows you to specify the port at which the debugger for your lambdas will run. By default it runs on port `9229`.\n\n- `--port [number]` | `-p [number]`\n\n Allows you to specify the port at which the `vercel-node-dev` server will run. By default it will attempt to bind to port `3000`.\n\n- `--root [string]` | `-r [string]`\n\n Allows you to specify the relative path at which your application code (APIs + UI) live. By default it will be `.`.\n\n
\n\n## Specifying a custom develop command\n\nIf you aren't using one of the [supported frameworks](#supported-frameworks), or if you would like to customise the develop command, then you can add a `dev` script to your `package.json`:\n\n```json\n{\n \"scripts\": {\n \"dev\": \"my-dev-tool -p $PORT\"\n }\n}\n```\n\n**Note:** It is important that you pass through the `$PORT` environment variable as shown in the example above. This is so that your development server can be correctly managed by `vercel-node-dev`.\n\n
\n\n## Debugging your Lambdas\n\nYou can enabled the debugger for your lambdas by providing the respective option to the CLI:\n\n```bash\nvercel-node-dev --debug-apis\n```\n\nThis will start the development server, with the debugger instance running. By default the debugger runs on port `9229`. You can change the port number via the `--debug-apis-port` option.\n\nOnce the debugger is running you can attach to it utilising your tool of choice.\n\n### Debugging via VSCode\n\nBelow is a set of [`code` debug configurations](https://code.visualstudio.com/docs/editor/debugging), allowing you to either start the `vercel-dev-node` instance with the debugger attached, or to attach to an already executing debugger instance.\n\n```jsonc\n{\n \"version\": \"0.2.0\",\n \"configurations\": [\n // This will start vercel-node-dev with the debugger attached\n {\n \"name\": \"Launch vercel-node-dev\",\n \"type\": \"node\",\n \"request\": \"launch\",\n \"program\": \"vercel-node-dev\",\n \"args\": [\"--debug-apis\"],\n \"skipFiles\": [\"
\n\n## Bonus: Unit Testing your Lambdas\n\nThis tool leverages another library I built, [`vercel-node-server`](https://github.com/ctrlplusb/vercel-node-server), which allows you to create `http` instances of your lambdas. This opens up opportunities for you to write integration or unit tests for you lambdas.\n\nFirstly, install the library as development dependency:\n\n```bash\nnpm install -D vercel-node-server\n```\n\nYou can then write tests for your lambdas similar to the one below:\n\n```javascript\nimport { createServer } from 'vercel-node-server';\nimport listen from 'test-listen';\nimport axios from 'axios';\nimport helloLambda from './api/hello';\n\nlet server;\nlet url;\n\nbeforeAll(async () => {\n server = createServer(routeUnderTest);\n url = await listen(server);\n});\n\nafterAll(() => {\n server.close();\n});\n\nit('should return the expected response', async () => {\n const response = await axios.get(url, { params: { name: 'Pearl' } });\n expect(response.data).toBe('Hello Pearl');\n});\n```\n","readmeFilename":"README.md"}