veryfront 0.1.1054 → 0.1.1055

package/esm/cli/commands/serve/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/command.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AA8FD,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvE"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/serve/command.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,YAAY,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AA+FD,wBAAsB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAcvE"}

package/esm/cli/commands/serve/command.js

@@ -1,4 +1,5 @@
 import { cwd } from "../../../src/platform/index.js";
+import { gracefullyShutdownProductionServer } from "../../../src/server/index.js";
 import { cliLogger } from "../../utils/index.js";
 import { exitProcess, registerTerminationSignals, showLogo } from "../../utils/index.js";
 import { generateDefaultProjectId } from "../../utils/project.js";
@@ -56,10 +57,13 @@ async function runProductionServer(options) {
         if (shuttingDown)
             return;
         shuttingDown = true;
-        cliLogger.info(`Received ${signal}, shutting down production server...`);
         try {
-            shutdownController.abort();
-            await server.stop();
+            await gracefullyShutdownProductionServer({
+                signal,
+                abort: () => shutdownController.abort(),
+                stop: server.stop,
+                logger: cliLogger,
+            });
         }
         catch (error) {
             cliLogger.warn("Error while shutting down production server:", error);
@@ -68,9 +72,7 @@ async function runProductionServer(options) {
             exitProcess(0);
         }
     };
-    registerTerminationSignals((signal) => {
-        void shutdown(signal);
-    });
+    registerTerminationSignals(shutdown);
     await new Promise(() => { });
 }
 export async function serveCommand(options) {

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.1054",
+    "version": "0.1.1055",
     "license": "Apache-2.0",
     "nodeModulesDir": "auto",
     "minimumDependencyAge": {

package/esm/src/server/graceful-shutdown.d.ts

@@ -0,0 +1,59 @@
+/** Default drain timeout leaves headroom under Kubernetes' default 30 second grace period. */
+export declare const DEFAULT_SHUTDOWN_DRAIN_TIMEOUT_MS = 25000;
+/** Cleanup timeout keeps total shutdown below the default 30 second grace period. */
+export declare const DEFAULT_SHUTDOWN_CLEANUP_TIMEOUT_MS = 4000;
+interface GracefulShutdownRequestTracker {
+    getInFlightCount(): number;
+    waitForDrain(timeoutMs: number): Promise<boolean>;
+    shutdown(): void;
+}
+/**
+ * Inputs required to drain and stop a production server process.
+ *
+ * This lifecycle mutates process-wide readiness, shutdown, and request-tracking
+ * state. Use it once from the process signal handler, not for individual server
+ * instances or requests.
+ */
+export interface GracefulProductionShutdownOptions {
+    /** Operating-system signal that initiated shutdown. */
+    signal: "SIGINT" | "SIGTERM";
+    /** Maximum drain time. Defaults to SHUTDOWN_DRAIN_TIMEOUT_MS or 25 seconds. */
+    drainTimeoutMs?: number;
+    /** Total time allowed for cleanup after draining. Defaults to 4 seconds. */
+    cleanupTimeoutMs?: number;
+    /** Stops signal-aware background work before the HTTP server closes. */
+    abort: () => void;
+    /** Stops the production HTTP server. */
+    stop: () => Promise<void>;
+    /** Releases optional bootstrap resources before the server closes. */
+    dispose?: () => void | Promise<void>;
+    /** Logger used for shutdown progress and failures. */
+    logger: {
+        info(message: string, context?: Record<string, unknown>): void;
+        warn(message: string, context?: unknown): void;
+    };
+}
+interface GracefulProductionShutdownDependencies {
+    markServerShuttingDown: () => void;
+    setServerInitialized: (ready: boolean) => void;
+    requestTracker: GracefulShutdownRequestTracker;
+    shutdownTelemetry: () => Promise<void>;
+}
+export declare function parseShutdownDrainTimeoutMs(raw: string | undefined): number;
+export declare function parseShutdownCleanupTimeoutMs(raw: string | undefined): number;
+/**
+ * Stops new agent work, drains tracked requests and SSE response bodies, and then
+ * releases server resources.
+ */
+export declare function gracefullyShutdownProductionServerWithDependencies(options: GracefulProductionShutdownOptions, dependencies: GracefulProductionShutdownDependencies): Promise<boolean>;
+/**
+ * Enter lame-duck mode, mark readiness false, drain tracked requests and SSE
+ * response bodies, and stop a production server process.
+ *
+ * This is a one-shot, process-level lifecycle. Call it once from a SIGINT or
+ * SIGTERM handler. The function returns `true` when every tracked request drains
+ * before the timeout and `false` when cleanup continues after the timeout.
+ */
+export declare function gracefullyShutdownProductionServer(options: GracefulProductionShutdownOptions): Promise<boolean>;
+export {};
+//# sourceMappingURL=graceful-shutdown.d.ts.map

package/esm/src/server/graceful-shutdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graceful-shutdown.d.ts","sourceRoot":"","sources":["../../../src/src/server/graceful-shutdown.ts"],"names":[],"mappings":"AAMA,8FAA8F;AAC9F,eAAO,MAAM,iCAAiC,QAAS,CAAC;AACxD,qFAAqF;AACrF,eAAO,MAAM,mCAAmC,OAAQ,CAAC;AAEzD,UAAU,8BAA8B;IACtC,gBAAgB,IAAI,MAAM,CAAC;IAC3B,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iCAAiC;IAChD,uDAAuD;IACvD,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,wCAAwC;IACxC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,sDAAsD;IACtD,MAAM,EAAE;QACN,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;KAChD,CAAC;CACH;AAID,UAAU,sCAAsC;IAC9C,sBAAsB,EAAE,MAAM,IAAI,CAAC;IACnC,oBAAoB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,cAAc,EAAE,8BAA8B,CAAC;IAC/C,iBAAiB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AASD,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE3E;AAED,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE7E;AAgED;;;GAGG;AACH,wBAAsB,kDAAkD,CACtE,OAAO,EAAE,iCAAiC,EAC1C,YAAY,EAAE,sCAAsC,GACnD,OAAO,CAAC,OAAO,CAAC,CAsElB;AAED;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,iCAAiC,GACzC,OAAO,CAAC,OAAO,CAAC,CAElB"}

package/esm/src/server/graceful-shutdown.js

@@ -0,0 +1,118 @@
+import { shutdownOTLP } from "../observability/tracing/otlp-setup.js";
+import { getEnv } from "../platform/compat/process.js";
+import { setServerInitialized } from "./handlers/monitoring/health.handler.js";
+import { requestTracker } from "./runtime-handler/request-tracker.js";
+import { markServerShuttingDown } from "./shutdown-state.js";
+/** Default drain timeout leaves headroom under Kubernetes' default 30 second grace period. */
+export const DEFAULT_SHUTDOWN_DRAIN_TIMEOUT_MS = 25_000;
+/** Cleanup timeout keeps total shutdown below the default 30 second grace period. */
+export const DEFAULT_SHUTDOWN_CLEANUP_TIMEOUT_MS = 4_000;
+const defaultDependencies = {
+    markServerShuttingDown,
+    setServerInitialized,
+    requestTracker,
+    shutdownTelemetry: shutdownOTLP,
+};
+export function parseShutdownDrainTimeoutMs(raw) {
+    return parseShutdownTimeoutMs(raw, DEFAULT_SHUTDOWN_DRAIN_TIMEOUT_MS);
+}
+export function parseShutdownCleanupTimeoutMs(raw) {
+    return parseShutdownTimeoutMs(raw, DEFAULT_SHUTDOWN_CLEANUP_TIMEOUT_MS);
+}
+function parseShutdownTimeoutMs(raw, fallback) {
+    if (raw === undefined || raw.trim() === "")
+        return fallback;
+    const parsed = Number(raw);
+    return Number.isInteger(parsed) && parsed >= 0 ? parsed : fallback;
+}
+function normalizeShutdownTimeoutMs(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    return Number.isInteger(value) && value >= 0 ? value : fallback;
+}
+async function runCleanupStep(description, action, logger, cleanupDeadlineMs) {
+    let result;
+    try {
+        result = action();
+    }
+    catch (error) {
+        logger.warn(`Failed to ${description} during graceful shutdown`, { error });
+        return;
+    }
+    if (!result || typeof result.then !== "function")
+        return;
+    const actionPromise = Promise.resolve(result);
+    const remainingMs = Math.max(0, cleanupDeadlineMs - Date.now());
+    if (remainingMs === 0) {
+        logger.warn("Graceful shutdown cleanup deadline exceeded", { step: description });
+        void actionPromise.catch((error) => {
+            logger.warn(`Failed to ${description} after cleanup deadline exceeded`, { error });
+        });
+        return;
+    }
+    let timeoutId;
+    const outcome = await Promise.race([
+        actionPromise.then(() => ({ status: "completed" }), (error) => ({ status: "failed", error })),
+        new Promise((resolve) => {
+            timeoutId = setTimeout(() => resolve({ status: "timeout" }), remainingMs);
+        }),
+    ]);
+    if (timeoutId !== undefined)
+        clearTimeout(timeoutId);
+    if (outcome.status === "failed") {
+        logger.warn(`Failed to ${description} during graceful shutdown`, { error: outcome.error });
+    }
+    else if (outcome.status === "timeout") {
+        logger.warn("Graceful shutdown cleanup deadline exceeded", { step: description });
+    }
+}
+/**
+ * Stops new agent work, drains tracked requests and SSE response bodies, and then
+ * releases server resources.
+ */
+export async function gracefullyShutdownProductionServerWithDependencies(options, dependencies) {
+    const { logger } = options;
+    const drainTimeoutMs = normalizeShutdownTimeoutMs(options.drainTimeoutMs, parseShutdownDrainTimeoutMs(getEnv("SHUTDOWN_DRAIN_TIMEOUT_MS")));
+    const cleanupTimeoutMs = normalizeShutdownTimeoutMs(options.cleanupTimeoutMs, parseShutdownCleanupTimeoutMs(getEnv("SHUTDOWN_CLEANUP_TIMEOUT_MS")));
+    logger.info(`Received ${options.signal}, initiating graceful shutdown...`, {
+        inFlightRequests: dependencies.requestTracker.getInFlightCount(),
+        drainTimeoutMs,
+        cleanupTimeoutMs,
+    });
+    dependencies.markServerShuttingDown();
+    dependencies.setServerInitialized(false);
+    logger.info("Server marked as not ready, waiting for in-flight requests to drain...");
+    let drained = false;
+    try {
+        drained = await dependencies.requestTracker.waitForDrain(drainTimeoutMs);
+    }
+    catch (error) {
+        logger.warn("Failed while waiting for in-flight requests to drain", { error });
+    }
+    if (!drained) {
+        logger.warn("Drain timeout exceeded, forcing shutdown", {
+            remainingRequests: dependencies.requestTracker.getInFlightCount(),
+        });
+    }
+    const cleanupDeadlineMs = Date.now() + cleanupTimeoutMs;
+    await runCleanupStep("stop request tracking", () => dependencies.requestTracker.shutdown(), logger, cleanupDeadlineMs);
+    if (options.dispose) {
+        await runCleanupStep("dispose the production bootstrap", options.dispose, logger, cleanupDeadlineMs);
+    }
+    await runCleanupStep("abort the production server", options.abort, logger, cleanupDeadlineMs);
+    await runCleanupStep("stop the production server", options.stop, logger, cleanupDeadlineMs);
+    await runCleanupStep("shut down telemetry", dependencies.shutdownTelemetry, logger, cleanupDeadlineMs);
+    logger.info("Graceful shutdown complete");
+    return drained;
+}
+/**
+ * Enter lame-duck mode, mark readiness false, drain tracked requests and SSE
+ * response bodies, and stop a production server process.
+ *
+ * This is a one-shot, process-level lifecycle. Call it once from a SIGINT or
+ * SIGTERM handler. The function returns `true` when every tracked request drains
+ * before the timeout and `false` when cleanup continues after the timeout.
+ */
+export function gracefullyShutdownProductionServer(options) {
+    return gracefullyShutdownProductionServerWithDependencies(options, defaultDependencies);
+}

package/esm/src/server/index.d.ts

@@ -24,6 +24,7 @@ import "../../_dnt.polyfills.js";
 import { DevServer, type DevServerOptions, type FileWatcherMetrics, type RouteDirectory, startDevServer } from "./dev-server.js";
 import { type DiscoveryOptions, type ServerHandle, startProductionServer, type StartProductionServerOptions } from "./production-server.js";
 export { DevServer, startDevServer, startProductionServer };
+export { gracefullyShutdownProductionServer, type GracefulProductionShutdownOptions, } from "./graceful-shutdown.js";
 export { createVeryfrontServer, type CreateVeryfrontServerOptions, type NodeVeryfrontServiceServer, startNodeVeryfrontServer, type StartNodeVeryfrontServerOptions, startVeryfrontServer, type StartVeryfrontServerOptions, type VeryfrontServiceServer, type VeryfrontServiceServerFetch, type VeryfrontServiceServerLogger, type VeryfrontServiceServerModule, type VeryfrontServiceServerModuleResponse, type VeryfrontServiceServerRuntime, type VeryfrontServiceServerRuntimeKind, } from "./service-server.js";
 export type { DevServerOptions, DiscoveryOptions, FileWatcherMetrics, RouteDirectory, ServerHandle, StartProductionServerOptions, };
 import { ReloadNotifier } from "./reload-notifier.js";

package/esm/src/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/server/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/server/index.ts"],"names":[],"mappings":"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"}

package/esm/src/server/index.js

@@ -35,6 +35,7 @@ import { HMR_MAX_MESSAGES_PER_MINUTE } from "../utils/index.js";
 /** Default server port when no port is specified */
 const DEFAULT_SERVER_PORT = 3_000;
 export { DevServer, startDevServer, startProductionServer };
+export { gracefullyShutdownProductionServer, } from "./graceful-shutdown.js";
 export { createVeryfrontServer, startNodeVeryfrontServer, startVeryfrontServer, } from "./service-server.js";
 import { ReloadNotifier } from "./reload-notifier.js";
 export { ReloadNotifier };

package/esm/src/server/production-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"production-server.d.ts","sourceRoot":"","sources":["../../../src/src/server/production-server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA6BrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAgFtE,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC9C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,oFAAoF;IACpF,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,mDAAmD;AACnD,MAAM,WAAW,4BAA6B,SAAQ,aAAa;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,8FAA8F;IAC9F,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,gCAAgC;AAChC,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CA4JvB"}
+{"version":3,"file":"production-server.d.ts","sourceRoot":"","sources":["../../../src/src/server/production-server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA4BrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AA4EtE,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8FAA8F;IAC9F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC9C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,oFAAoF;IACpF,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,6CAA6C;AAC7C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,mDAAmD;AACnD,MAAM,WAAW,4BAA6B,SAAQ,aAAa;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,8FAA8F;IAC9F,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,gCAAgC;AAChC,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CA4JvB"}

package/esm/src/server/production-server.js

@@ -1,11 +1,10 @@
 import { serverLogger as logger } from "../utils/index.js";
 import { runtime } from "../platform/adapters/detect.js";
 import { createVeryfrontHandler } from "./runtime-handler/index.js";
-import { requestTracker } from "./runtime-handler/request-tracker.js";
 import { bootstrapProd } from "./bootstrap.js";
 import { cwd, onGlobalError, onSignal } from "../platform/compat/process.js";
 import { isDebugEnabled } from "../utils/constants/env.js";
-import { initializeOTLPWithApis, shutdownOTLP, withSpan, } from "../observability/tracing/otlp-setup.js";
+import { initializeOTLPWithApis, withSpan } from "../observability/tracing/otlp-setup.js";
 import { startConfiguredMemoryMonitoring, stopMemoryMonitoring, } from "../utils/memory/index.js";
 import { initializeDistributedCaches } from "../cache/distributed-cache-init.js";
 import { defaultDistributedCacheInitializers } from "./distributed-cache-initializers.js";
@@ -14,13 +13,10 @@ import { resolveStyleContentVersion } from "../html/styles-builder/content-versi
 import { buildPreparedCSSArtifactFromFiles, collectLocalProjectSourceFiles, readLocalProjectStylesheet, } from "../html/styles-builder/css-pregeneration.js";
 import { createStyleScopeProfile } from "../html/styles-builder/style-scope-profile.js";
 import { setServerInitialized } from "./handlers/monitoring/health.handler.js";
-import { markServerShuttingDown } from "./shutdown-state.js";
+import { gracefullyShutdownProductionServer, parseShutdownDrainTimeoutMs, } from "./graceful-shutdown.js";
 import { enableSSRClientOnlyFetching, enableSSRFetchInterception, setSSRServerPort, } from "../rendering/ssr-globals.js";
 const serverLog = logger.component("server");
 const globalLog = logger.component("global");
-/** Default time to wait for in-flight requests to drain during shutdown.
- *  K8s default terminationGracePeriodSeconds is 30s, so 25s leaves headroom. */
-const DEFAULT_SHUTDOWN_DRAIN_TIMEOUT_MS = 25_000;
 /** Default port when PORT / VERYFRONT_PORT env vars are not set */
 const DEFAULT_SERVER_PORT = 3_000;
 async function prewarmLocalProductionCSSArtifacts(adapter, options) {
@@ -266,43 +262,20 @@ if (globalThis[Symbol.for("import-meta-ponyfill-esmodule")](import.meta).main) {
         logger.info("Server fully initialized, ready to accept traffic");
         // Graceful shutdown for direct CLI execution (e.g., deno run)
         // Default drain timeout: 25 seconds (K8s default terminationGracePeriodSeconds is 30)
-        const drainTimeoutMs = parseInt(adapter.env.get("SHUTDOWN_DRAIN_TIMEOUT_MS") ?? String(DEFAULT_SHUTDOWN_DRAIN_TIMEOUT_MS), 10);
+        const drainTimeoutMs = parseShutdownDrainTimeoutMs(adapter.env.get("SHUTDOWN_DRAIN_TIMEOUT_MS"));
         let shuttingDown = false;
         const shutdown = async (signal) => {
             if (shuttingDown)
                 return;
             shuttingDown = true;
-            logger.info(`Received ${signal}, initiating graceful shutdown...`, {
-                inFlightRequests: requestTracker.getInFlightCount(),
+            await gracefullyShutdownProductionServer({
+                signal,
                 drainTimeoutMs,
+                abort: () => shutdownController.abort(),
+                dispose: bootstrap.dispose,
+                stop: server.stop,
+                logger,
             });
-            // Phase 1: Enter lame-duck mode. markServerShuttingDown() makes the
-            // agent-work handlers reject NEW requests with 503 (before any side
-            // effects) so the API can retry against another instance, even while the
-            // pod IP is still directly reachable. setServerInitialized(false) flips
-            // /readyz to not-ready so K8s stops routing Service traffic.
-            markServerShuttingDown();
-            setServerInitialized(false);
-            logger.info("Server marked as not ready, waiting for in-flight requests to drain...");
-            try {
-                // Phase 2: Wait for in-flight requests to complete (graceful drain)
-                const drained = await requestTracker.waitForDrain(drainTimeoutMs);
-                if (!drained) {
-                    logger.warn("Drain timeout exceeded, forcing shutdown", {
-                        remainingRequests: requestTracker.getInFlightCount(),
-                    });
-                }
-                // Phase 3: Stop accepting new connections and clean up
-                requestTracker.shutdown();
-                await bootstrap.dispose?.();
-                shutdownController.abort();
-                await server.stop();
-                await shutdownOTLP();
-                logger.info("Graceful shutdown complete");
-            }
-            catch (error) {
-                logger.warn("Error while shutting down production server:", error);
-            }
         };
         const handleSignal = (signal) => {
             void shutdown(signal).catch((error) => {

package/esm/src/utils/version-constant.d.ts

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.1054";
+export declare const VERSION = "0.1.1055";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,4 +1,4 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
 /** Shared version value. */
-export const VERSION = "0.1.1054";
+export const VERSION = "0.1.1055";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.1054",
+  "version": "0.1.1055",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",
@@ -328,10 +328,10 @@
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "ws": "8.21.0",
-    "@veryfront/ext-bundler-esbuild": "0.1.1054",
-    "@veryfront/ext-content-mdx": "0.1.1054",
-    "@veryfront/ext-css-tailwind": "0.1.1054",
-    "@veryfront/ext-parser-babel": "0.1.1054"
+    "@veryfront/ext-bundler-esbuild": "0.1.1055",
+    "@veryfront/ext-content-mdx": "0.1.1055",
+    "@veryfront/ext-css-tailwind": "0.1.1055",
+    "@veryfront/ext-parser-babel": "0.1.1055"
   },
   "devDependencies": {
     "@types/node": "20.9.0"