feat: add serve command (#5351)

* feat: add `--serve` flag to `dev` command

* refactor: simplify internal directory clean up

* refactor: load built functions

* refactor: make things nicer

* refactor: add const

* feat: show debug message

* refactor: rename variable

* chore: add `extract-zip` dependency

* chore: update snapshots

* refactor: conditionally set `quiet` flag

* refactor: simplify code

* chore: update docs

* refactor: rename flag to `prod`

* refactor: update message

* feat: do not set `NETLIFY_DEV` when `prod` is set

* chore: remove lint exceptions

* Apply suggestions from code review

Co-authored-by: Matt Kane <m@mk.gg>

* refactor: treat `NETLIFY_DEV` consistently across function types

* refactor: add `internal` source for env vars

* fix: handle internal vars correctly

* chore: update docs

* refactor: remove unused variable

* feat: set `context=production` when `prod` is used

* refactor: add beta label

* feat: create separate `serve` command

* Update src/commands/serve/serve.mjs

Co-authored-by: Matt Kane <m@mk.gg>

* refactor: remove unused flags

* refactor: abort server when build fails

* refactor: always start functions server

* chore: remove ESLint directive

* fix: fix imports

* refactor: always start functions server

* refactor: ensure internal functions directory

* refactor: reinstate functions server check

* refactor: add missing import

* fix: fix imports

* refactor: move logic for ensuring internal functions directory

* chore: fix test

* chore: update docs

* chore: update snapshot

* refactor: add log message

* Update src/commands/serve/serve.mjs

Co-authored-by: Matt Kane <m@mk.gg>

* chore: update docs

Co-authored-by: Matt Kane <m@mk.gg>

README.md

@@ -34,6 +34,7 @@ See the [CLI command line reference](https://cli.netlify.com/commands/) to get s
   - [login](#login)
   - [open](#open)
   - [recipes](#recipes)
+  - [serve](#serve)
   - [sites](#sites)
   - [status](#status)
   - [switch](#switch)
@@ -219,6 +220,10 @@ Open settings for the site linked to the current folder
 | [`recipes:list`](/docs/commands/recipes.md#recipeslist) | (Beta) List the recipes available to create and modify files in a project  |
 
 
+### [serve](/docs/commands/serve.md)
+
+(Beta) Build the site for production and serve locally. This does not watch the code for changes, so if you need to rebuild your site then you must exit and run `serve` again.
+
 ### [sites](/docs/commands/sites.md)
 
 Handle various site operations

docs/README.md

@@ -168,6 +168,10 @@ Open settings for the site linked to the current folder
 | [`recipes:list`](/docs/commands/recipes.md#recipeslist) | (Beta) List the recipes available to create and modify files in a project  |
 
 
+### [serve](/docs/commands/serve.md)
+
+(Beta) Build the site for production and serve locally. This does not watch the code for changes, so if you need to rebuild your site then you must exit and run `serve` again.
+
 ### [sites](/docs/commands/sites.md)
 
 Handle various site operations

docs/commands/dev.md

@@ -30,7 +30,6 @@ netlify dev
 - `live` (*boolean*) - start a public live session
 - `offline` (*boolean*) - disables any features that require network access
 - `port` (*string*) - port of netlify dev
-- `prod` (*boolean*) - (Beta) build the site for production and serve locally
 - `sessionId` (*string*) - (Graph) connect to cloud session with ID [sessionId]
 - `targetPort` (*string*) - port of target app server
 - `debug` (*boolean*) - Print debugging information

docs/commands/index.md

@@ -147,6 +147,10 @@ Open settings for the site linked to the current folder
 | [`recipes:list`](/docs/commands/recipes.md#recipeslist) | (Beta) List the recipes available to create and modify files in a project  |
 
 
+### [serve](/docs/commands/serve.md)
+
+(Beta) Build the site for production and serve locally. This does not watch the code for changes, so if you need to rebuild your site then you must exit and run `serve` again.
+
 ### [sites](/docs/commands/sites.md)
 
 Handle various site operations

src/commands/base-command.mjs

@@ -510,10 +510,7 @@ export default class BaseCommand extends Command {
    * @returns {string}
    */
   getDefaultContext() {
-    const { prod } = this.opts()
-    const isDevCommand = ['dev', 'dev:exec'].includes(this.name())
-
-    if (isDevCommand && prod) {
+    if (this.name() === 'serve') {
       return 'production'
     }