feat: implement NITRO_UNIX_SOCKET and graceful shutdown env vars

Wire NITRO_UNIX_SOCKET, NITRO_SHUTDOWN_DISABLED, and
NITRO_SHUTDOWN_TIMEOUT through to srvx serve options in the Node, Bun,
and Deno server presets.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: wadefletch

docs/2.deploy/10.runtimes/1.node.md

@@ -31,12 +31,10 @@ You can customize server behavior using following environment variables:
 
 - `NITRO_PORT` or `PORT` (defaults to `3000`)
 - `NITRO_HOST` or `HOST`
-- `NITRO_UNIX_SOCKET` - if provided (a path to the desired socket file) the service will be served over the provided UNIX socket.
+- `NITRO_UNIX_SOCKET` - if provided (a path to the desired socket file) the service will be served over the provided UNIX socket (Node.js and Bun only).
 - `NITRO_SSL_CERT` and `NITRO_SSL_KEY` - if both are present, this will launch the server in HTTPS mode. In the vast majority of cases, this should not be used other than for testing, and the Nitro server should be run behind a reverse proxy like nginx or Cloudflare which terminates SSL.
-- `NITRO_SHUTDOWN_DISABLED` - Disables the graceful shutdown feature when set to `'true'`. If it's set to `'true'`, the graceful shutdown is bypassed to speed up the development process. Defaults to `'false'`.
-- `NITRO_SHUTDOWN_SIGNALS` - Allows you to specify which signals should be handled. Each signal should be separated with a space. Defaults to `'SIGINT SIGTERM'`.
-- `NITRO_SHUTDOWN_TIMEOUT` - Sets the amount of time (in milliseconds) before a forced shutdown occurs. Defaults to `'30000'` milliseconds.
-- `NITRO_SHUTDOWN_FORCE` - When set to true, it triggers `process.exit()` at the end of the shutdown process. If it's set to `'false'`, the process will simply let the event loop clear. Defaults to `'true'`.
+- `NITRO_SHUTDOWN_DISABLED` - Disables the graceful shutdown feature when set to `'true'`. Defaults to `'false'`.
+- `NITRO_SHUTDOWN_TIMEOUT` - Sets the amount of time (in milliseconds) before a forced shutdown occurs. Defaults to `5000` milliseconds.
 
 ## Cluster mode
 

src/presets/bun/runtime/bun.ts

@@ -13,7 +13,15 @@ const port = Number.isNaN(_parsedPort) ? 3000 : _parsedPort;
 const host = process.env.NITRO_HOST || process.env.HOST;
 const cert = process.env.NITRO_SSL_CERT;
 const key = process.env.NITRO_SSL_KEY;
-// const socketPath = process.env.NITRO_UNIX_SOCKET; // TODO
+const socketPath = process.env.NITRO_UNIX_SOCKET;
+
+const _shutdownTimeout = Number.parseInt(process.env.NITRO_SHUTDOWN_TIMEOUT || "", 10);
+const gracefulShutdown =
+  process.env.NITRO_SHUTDOWN_DISABLED === "true"
+    ? false
+    : _shutdownTimeout > 0
+      ? { gracefulTimeout: _shutdownTimeout / 1000 }
+      : undefined;
 
 const nitroApp = useNitroApp();
 
@@ -35,7 +43,9 @@ serve({
   hostname: host,
   tls: cert && key ? { cert, key } : undefined,
   fetch: _fetch,
+  gracefulShutdown,
   bun: {
+    unix: socketPath,
     websocket: import.meta._websocket ? ws?.websocket : undefined,
   },
 });

src/presets/deno/runtime/deno-server.ts

@@ -14,7 +14,14 @@ const port = Number.isNaN(_parsedPort) ? 3000 : _parsedPort;
 const host = process.env.NITRO_HOST || process.env.HOST;
 const cert = process.env.NITRO_SSL_CERT;
 const key = process.env.NITRO_SSL_KEY;
-// const socketPath = process.env.NITRO_UNIX_SOCKET; // TODO
+
+const _shutdownTimeout = Number.parseInt(process.env.NITRO_SHUTDOWN_TIMEOUT || "", 10);
+const gracefulShutdown =
+  process.env.NITRO_SHUTDOWN_DISABLED === "true"
+    ? false
+    : _shutdownTimeout > 0
+      ? { gracefulTimeout: _shutdownTimeout / 1000 }
+      : undefined;
 
 const nitroApp = useNitroApp();
 
@@ -35,6 +42,7 @@ serve({
   hostname: host,
   tls: cert && key ? { cert, key } : undefined,
   fetch: _fetch,
+  gracefulShutdown,
 });
 
 trapUnhandledErrors();

src/presets/node/runtime/node-server.ts

@@ -13,7 +13,15 @@ const port = Number.isNaN(_parsedPort) ? 3000 : _parsedPort;
 const host = process.env.NITRO_HOST || process.env.HOST;
 const cert = process.env.NITRO_SSL_CERT;
 const key = process.env.NITRO_SSL_KEY;
-// const socketPath = process.env.NITRO_UNIX_SOCKET; // TODO
+const socketPath = process.env.NITRO_UNIX_SOCKET;
+
+const _shutdownTimeout = Number.parseInt(process.env.NITRO_SHUTDOWN_TIMEOUT || "", 10);
+const gracefulShutdown =
+  process.env.NITRO_SHUTDOWN_DISABLED === "true"
+    ? false
+    : _shutdownTimeout > 0
+      ? { gracefulTimeout: _shutdownTimeout / 1000 }
+      : undefined;
 
 const nitroApp = useNitroApp();
 
@@ -22,6 +30,8 @@ const server = serve({
   hostname: host,
   tls: cert && key ? { cert, key } : undefined,
   fetch: nitroApp.fetch,
+  gracefulShutdown,
+  node: socketPath ? { path: socketPath } : undefined,
 });
 
 if (import.meta._websocket) {