Graceful shutdown

Author: max-lt

Dockerfile

@@ -18,6 +18,7 @@ FROM installer AS sources
 COPY src /build/src
 COPY examples /build/examples
 COPY tsconfig.json /build/tsconfig.json
+COPY server.ts /build
 
 # Builder Image
 FROM sources AS builder

package.json

@@ -6,7 +6,7 @@
   "scripts": {
     "dev": "bun --hot src/index.ts",
     "start": "bun src/index.ts",
-    "compile": "bun build --compile --minify --sourcemap src/index.ts --outfile dist/openworkers-api",
+    "compile": "bun build --compile --minify --sourcemap server.ts --outfile dist/openworkers-api",
     "test": "bun test"
   },
   "dependencies": {

server.ts

@@ -0,0 +1,26 @@
+/**
+ * Production server entrypoint with graceful shutdown support
+ *
+ * This file is used for:
+ * - Production runtime (bun server.ts)
+ * - Compiled binary (bun run compile)
+ *
+ * It explicitly creates a Bun server to handle SIGTERM/SIGINT signals
+ * for graceful shutdown (Docker, Ctrl+C, process managers).
+ *
+ * For development, use `bun --hot src/index.ts` which relies on
+ * the default export and lets Bun handle hot reload lifecycle.
+ */
+import app from "./src";
+
+const server = Bun.serve(app);
+
+process.on("SIGTERM", () => {
+  console.log("SIGTERM received, shutting down gracefully...");
+  server.stop(true);
+});
+
+process.on("SIGINT", () => {
+  console.log("SIGINT received, shutting down gracefully...");
+  server.stop(true);
+});

src/index.ts

@@ -40,12 +40,13 @@ v1.route("/", users);
 
 app.route("/api/v1", v1);
 
-import { port } from "./config";
+import { nodeEnv, port } from "./config";
 
 // Start server
 console.log(`OpenWorkers API starting on port ${port}...`);
 
 export default {
   port,
   fetch: app.fetch,
+  development: nodeEnv === "development",
 };