veryfront 0.1.128 → 0.1.129

package/esm/src/security/http/response/security-handler.d.ts

@@ -2,6 +2,7 @@ import * as dntShim from "../../../../_dnt.shims.js";
 import type { RuntimeAdapter } from "../../../platform/adapters/base.js";
 import type { SecurityConfig } from "./types.js";
 export declare function generateNonce(): string;
+export declare function serializeCSPDirectives(csp: SecurityConfig["csp"], nonce?: string): string | null;
 export declare function buildCSP(isDev: boolean, nonce: string, cspUserHeader: string | null, config?: SecurityConfig | null, adapter?: RuntimeAdapter): string;
 export declare function getSecurityHeader(headerName: string, defaultValue: string, config?: SecurityConfig | null, adapter?: RuntimeAdapter): string;
 export declare function applySecurityHeaders(headers: dntShim.Headers, isDev: boolean, nonce: string, cspUserHeader: string | null, config?: SecurityConfig | null, adapter?: RuntimeAdapter, isVeryfrontDomain?: boolean): void;

package/esm/src/security/http/response/security-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"security-handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/security/http/response/security-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD,wBAAgB,aAAa,IAAI,MAAM,CAItC;AA2CD,wBAAgB,QAAQ,CACtB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CA4BR;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAMR;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE,cAAc,EACxB,iBAAiB,CAAC,EAAE,OAAO,GAC1B,IAAI,CA6DN"}
+{"version":3,"file":"security-handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/security/http/response/security-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjD,wBAAgB,aAAa,IAAI,MAAM,CAItC;AA2CD,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,EAC1B,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAef;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAiBR;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE,cAAc,GACvB,MAAM,CAMR;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,OAAO,CAAC,OAAO,EACxB,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI,EAC9B,OAAO,CAAC,EAAE,cAAc,EACxB,iBAAiB,CAAC,EAAE,OAAO,GAC1B,IAAI,CA6DN"}

package/esm/src/security/http/response/security-handler.js

@@ -49,6 +49,20 @@ function buildDefaultCSP(nonce) {
         `form-action 'self'`,
     ].join("; ");
 }
+export function serializeCSPDirectives(csp, nonce) {
+    if (!csp || typeof csp !== "object")
+        return null;
+    const pieces = [];
+    for (const [key, value] of Object.entries(csp)) {
+        if (value === undefined)
+            continue;
+        const directive = key.replace(/[A-Z]/g, (match) => `-${match.toLowerCase()}`);
+        const sources = Array.isArray(value) ? value.join(" ") : String(value);
+        const serialized = `${directive} ${sources}`;
+        pieces.push(nonce ? serialized.replace(/{NONCE}/g, nonce) : serialized);
+    }
+    return pieces.length ? pieces.join("; ") : null;
+}
 export function buildCSP(isDev, nonce, cspUserHeader, config, adapter) {
     const envCsp = adapter?.env?.get?.("VERYFRONT_CSP");
     if (envCsp?.trim())
@@ -56,18 +70,9 @@ export function buildCSP(isDev, nonce, cspUserHeader, config, adapter) {
     if (cspUserHeader?.trim())
         return cspUserHeader.replace(/{NONCE}/g, nonce);
     const cfgCsp = config?.csp;
-    if (cfgCsp && typeof cfgCsp === "object") {
-        const pieces = [];
-        for (const [k, v] of Object.entries(cfgCsp)) {
-            if (v === undefined)
-                continue;
-            const key = k.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);
-            const val = Array.isArray(v) ? v.join(" ") : String(v);
-            pieces.push(`${key} ${val}`.replace(/{NONCE}/g, nonce));
-        }
-        if (pieces.length)
-            return pieces.join("; ");
-    }
+    const serializedConfigCsp = serializeCSPDirectives(cfgCsp, nonce);
+    if (serializedConfigCsp)
+        return serializedConfigCsp;
     // No explicit CSP configured — apply a secure default in production.
     // Dev mode skips the default to avoid blocking HMR and dev tooling.
     if (!isDev) {

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

@@ -8,8 +8,10 @@ export { BaseHandler } from "./http/base-handler.js";
 export type { HandlerHelpers } from "./http/base-handler.js";
 export { CommonSchemas, createValidatedHandler, createValidationError, DEFAULT_LIMITS, INPUT_VALIDATION_FAILED, parseFormData, parseJsonBody, parseQueryParams, readBodyWithLimit, sanitizeData, validateRequestLimits, } from "./input-validation/index.js";
 export type { ParseFormOptions, ParseJsonOptions, RequestLimits, ValidatedData, ValidatedHandlerConfig, ValidatedHandlerFunction, } from "./input-validation/index.js";
-export { AuthHandler, loadSecurityConfig, SecurityConfigLoader, setCors, } from "./http/handlers-index.js";
-export type { CORSConfig, CSPDirectives, SecurityConfig } from "./http/handlers-index.js";
+export { AuthHandler } from "./http/auth.js";
+export { SecurityConfigLoader } from "./http/config.js";
+export { loadSecurityConfig, setCors } from "./http/middleware/index.js";
+export type { CORSConfig, CSPDirectives, SecurityConfig } from "./http/middleware/index.js";
 export { CsrfHandler } from "./http/csrf/index.js";
 export { applyCsrfCookie, generateCsrfToken, validateCsrf } from "./csrf/index.js";
 export type { CsrfConfig, CsrfTokenOptions } from "./csrf/index.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/security/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,OAAO,GACR,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1F,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,IAAI,EACJ,UAAU,EACV,eAAe,IAAI,oBAAoB,EACvC,eAAe,IAAI,YAAY,EAC/B,eAAe,IAAI,oBAAoB,EACvC,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,UAAU,IAAI,WAAW,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAErF,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEjG,OAAO,EACL,cAAc,EACd,QAAQ,EACR,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAErF,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/security/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,EACL,aAAa,EACb,sBAAsB,EACtB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,GACtB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACnF,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,IAAI,EACJ,UAAU,EACV,eAAe,IAAI,oBAAoB,EACvC,eAAe,IAAI,YAAY,EAC/B,eAAe,IAAI,oBAAoB,EACvC,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,UAAU,IAAI,WAAW,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAErF,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAEjG,OAAO,EACL,cAAc,EACd,QAAQ,EACR,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAErF,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC"}

package/esm/src/security/index.js

@@ -6,7 +6,9 @@
  */
 export { BaseHandler } from "./http/base-handler.js";
 export { CommonSchemas, createValidatedHandler, createValidationError, DEFAULT_LIMITS, INPUT_VALIDATION_FAILED, parseFormData, parseJsonBody, parseQueryParams, readBodyWithLimit, sanitizeData, validateRequestLimits, } from "./input-validation/index.js";
-export { AuthHandler, loadSecurityConfig, SecurityConfigLoader, setCors, } from "./http/handlers-index.js";
+export { AuthHandler } from "./http/auth.js";
+export { SecurityConfigLoader } from "./http/config.js";
+export { loadSecurityConfig, setCors } from "./http/middleware/index.js";
 export { CsrfHandler } from "./http/csrf/index.js";
 export { applyCsrfCookie, generateCsrfToken, validateCsrf } from "./csrf/index.js";
 export { isValidSecurityConfig } from "./http/middleware/index.js";

package/esm/src/server/handlers/dev/styles-css.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles-css.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/styles-css.handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAgCnG,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,QAAQ,EAAE,eAAe,CAKvB;IAEI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAiKjE,cAAc;IAkB5B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,wBAAwB;IA0BhC,OAAO,CAAC,4BAA4B;YA2CtB,2BAA2B;YAoD3B,oBAAoB;YASpB,2BAA2B;IA2BzC,OAAO,CAAC,oCAAoC;YAI9B,4BAA4B;CAsB3C"}
+{"version":3,"file":"styles-css.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/dev/styles-css.handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AAGrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAiCnG,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,QAAQ,EAAE,eAAe,CAKvB;IAEI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAkLjE,cAAc;IAkB5B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,qBAAqB;IAW7B,OAAO,CAAC,wBAAwB;IA0BhC,OAAO,CAAC,4BAA4B;YA2CtB,2BAA2B;YAoD3B,oBAAoB;YASpB,2BAA2B;IA2BzC,OAAO,CAAC,oCAAoC;YAI9B,4BAA4B;CAsB3C"}

package/esm/src/server/handlers/dev/styles-css.handler.js

@@ -8,6 +8,7 @@ import { createPreparedProjectCSSContext, storePreparedProjectCSS, tryGetPrepare
 import { createStyleScopeProfile } from "../../../html/styles-builder/style-scope-profile.js";
 import { serverLogger } from "../../../utils/index.js";
 import { extractProjectCandidates } from "./styles-candidate-scanner.js";
+import { profilePhase } from "../../../observability/request-profiler.js";
 const logger = serverLogger.component("styles-css-handler");
 export class StylesCSSHandler extends BaseHandler {
     metadata = {
@@ -27,7 +28,7 @@ export class StylesCSSHandler extends BaseHandler {
                 const contentContext = this.getContentContext(ctx);
                 let rawCss;
                 try {
-                    rawCss = await this.loadStylesheet(ctx);
+                    rawCss = await profilePhase("css.load_stylesheet", () => this.loadStylesheet(ctx));
                 }
                 catch (error) {
                     logger.error("Failed to load stylesheet", {
@@ -37,7 +38,7 @@ export class StylesCSSHandler extends BaseHandler {
                 }
                 const preparedContext = this.createPreparedCSSContext(projectScope, rawCss, styleProfile.hash, contentContext, ctx);
                 if (preparedContext) {
-                    const prepared = await tryGetPreparedProjectCSS(preparedContext);
+                    const prepared = await profilePhase("css.prepared_cache_lookup", () => tryGetPreparedProjectCSS(preparedContext));
                     if (prepared) {
                         logger.debug("Prepared CSS cache hit", {
                             projectScope,
@@ -48,7 +49,7 @@ export class StylesCSSHandler extends BaseHandler {
                         return this.respond(responseBuilder.withContentType("text/css; charset=utf-8", prepared.css, HTTP_OK));
                     }
                 }
-                const remotePrepared = await this.tryResolveRemotePreparedCSS(ctx, projectScope, styleProfile.hash, contentContext, preparedContext);
+                const remotePrepared = await profilePhase("css.remote_artifact_lookup", () => this.tryResolveRemotePreparedCSS(ctx, projectScope, styleProfile.hash, contentContext, preparedContext));
                 if (remotePrepared) {
                     logger.debug("Prepared CSS resolved via style artifact metadata", {
                         projectScope,
@@ -59,7 +60,7 @@ export class StylesCSSHandler extends BaseHandler {
                 }
                 let candidates;
                 try {
-                    candidates = await extractProjectCandidates(ctx);
+                    candidates = await profilePhase("css.extract_candidates", () => extractProjectCandidates(ctx));
                 }
                 catch (error) {
                     logger.error("Failed to extract candidates", {
@@ -69,7 +70,7 @@ export class StylesCSSHandler extends BaseHandler {
                 }
                 let result;
                 try {
-                    result = await this.generateStylesheet(ctx, rawCss, candidates);
+                    result = await profilePhase("css.generate_stylesheet", () => this.generateStylesheet(ctx, rawCss, candidates));
                 }
                 catch (error) {
                     const formatted = formatCSSError(error instanceof Error ? error : String(error));
@@ -116,10 +117,10 @@ body::before {
                     cssHash: "hash" in result ? result.hash : undefined,
                 });
                 if (preparedContext && "hash" in result) {
-                    await storePreparedProjectCSS(preparedContext, {
+                    await profilePhase("css.store_prepared", () => storePreparedProjectCSS(preparedContext, {
                         css: result.css,
                         hash: result.hash,
-                    });
+                    }));
                 }
                 if ("hash" in result) {
                     await this.registerPreparedCSSArtifact(ctx, styleProfile.hash, contentContext, result.hash);

package/esm/src/server/handlers/monitoring/metrics.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/monitoring/metrics.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAUnG,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,EAAE,eAAe,CAKvB;IAEF,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAmCzE,OAAO,CAAC,QAAQ;CAUjB"}
+{"version":3,"file":"metrics.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/monitoring/metrics.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAWnG,qBAAa,cAAe,SAAQ,WAAW;IAC7C,QAAQ,EAAE,eAAe,CAKvB;IAEF,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAoCzE,OAAO,CAAC,QAAQ;CAUjB"}

package/esm/src/server/handlers/monitoring/metrics.handler.js

@@ -1,5 +1,6 @@
 import { BaseHandler } from "../response/base.js";
 import { metrics } from "../../../observability/simple-metrics/index.js";
+import { snapshotRequestProfiles } from "../../../observability/request-profiler.js";
 import { ResponseBuilder } from "../../../security/index.js";
 import { HTTP_INTERNAL_SERVER_ERROR, HTTP_OK, PRIORITY_HIGH, } from "../../../utils/constants/index.js";
 import { memoryUsage, uptime } from "../../../platform/compat/process.js";
@@ -20,9 +21,10 @@ export class MetricsHandler extends BaseHandler {
         const corsConfig = ctx.securityConfig?.cors;
         try {
             const snap = metrics.snapshot();
+            const profiling = snapshotRequestProfiles();
             const memory = this.safeCall(memoryUsage);
             const uptimeValue = this.safeCall(uptime);
-            const response = ResponseBuilder.json({ counters: snap, memory, uptime: uptimeValue }, req, { securityConfig, corsConfig, status: HTTP_OK });
+            const response = ResponseBuilder.json({ counters: snap, profiling, memory, uptime: uptimeValue }, req, { securityConfig, corsConfig, status: HTTP_OK });
             return Promise.resolve(this.respond(response));
         }
         catch (e) {

package/esm/src/server/handlers/request/module/module-server-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-server-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/request/module/module-server-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAIhE,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,CAAC,OAAO,EACpB,GAAG,EAAE,cAAc,EACnB,qBAAqB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,eAAe,EAC/D,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,aAAa,EACtD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,EACvF,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAC1C,OAAO,CAAC,aAAa,CAAC,CAkDxB"}
+{"version":3,"file":"module-server-handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/request/module/module-server-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAKhE,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,CAAC,OAAO,EACpB,GAAG,EAAE,cAAc,EACnB,qBAAqB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,eAAe,EAC/D,OAAO,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,aAAa,EACtD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,EACvF,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,GAC1C,OAAO,CAAC,aAAa,CAAC,CAwDxB"}

package/esm/src/server/handlers/request/module/module-server-handler.js

@@ -1,27 +1,30 @@
 import { ResponseBuilder } from "../../../../security/index.js";
 import { withSpan } from "../../../../observability/tracing/otlp-setup.js";
 import { resolveProjectReactVersion } from "../../../../transforms/esm/package-registry.js";
+import { profilePhase } from "../../../../observability/request-profiler.js";
 export function handleModuleServer(req, ctx, createResponseBuilder, respond, logDebug, getErrorMessage) {
     const url = new URL(req.url);
     return withSpan("module.server.handle", async () => {
         try {
-            const reactVersion = await resolveProjectReactVersion({
+            const reactVersion = await profilePhase("module.resolve_react_version", () => resolveProjectReactVersion({
                 projectDir: ctx.projectDir,
                 config: ctx.config,
-            });
-            const { serveModule } = await import("../../../../modules/server/index.js");
-            const moduleResponse = await serveModule(req, {
-                projectId: ctx.projectId ?? ctx.projectDir,
-                projectDir: ctx.projectDir,
-                adapter: ctx.adapter,
-                dev: !!ctx.isLocalProject,
-                projectUUID: ctx.projectId,
-                projectSlug: ctx.projectSlug,
-                branch: ctx.parsedDomain?.branch ?? null,
-                releaseId: ctx.releaseId ?? null,
-                allowedImportDirs: ctx.config?.security?.allowedImportDirs,
-                reactVersion,
-                mode: ctx.requestContext?.mode,
+            }));
+            const moduleResponse = await profilePhase("module.serve", async () => {
+                const { serveModule } = await import("../../../../modules/server/index.js");
+                return await serveModule(req, {
+                    projectId: ctx.projectId ?? ctx.projectDir,
+                    projectDir: ctx.projectDir,
+                    adapter: ctx.adapter,
+                    dev: !!ctx.isLocalProject,
+                    projectUUID: ctx.projectId,
+                    projectSlug: ctx.projectSlug,
+                    branch: ctx.parsedDomain?.branch ?? null,
+                    releaseId: ctx.releaseId ?? null,
+                    allowedImportDirs: ctx.config?.security?.allowedImportDirs,
+                    reactVersion,
+                    mode: ctx.requestContext?.mode,
+                });
             });
             const response = createResponseBuilder(ctx)
                 .withCORS(req, ctx.securityConfig?.cors)

package/esm/src/server/handlers/request/prod-hydration-module.handler.d.ts

@@ -0,0 +1,8 @@
+import * as dntShim from "../../../../_dnt.shims.js";
+import { BaseHandler } from "../response/base.js";
+import type { HandlerContext, HandlerMetadata, HandlerResult } from "../types.js";
+export declare class ProdHydrationModuleHandler extends BaseHandler {
+    metadata: HandlerMetadata;
+    handle(req: dntShim.Request, ctx: HandlerContext): Promise<HandlerResult>;
+}
+//# sourceMappingURL=prod-hydration-module.handler.d.ts.map

package/esm/src/server/handlers/request/prod-hydration-module.handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prod-hydration-module.handler.d.ts","sourceRoot":"","sources":["../../../../../src/src/server/handlers/request/prod-hydration-module.handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAmB,aAAa,EAAE,MAAM,aAAa,CAAC;AAqBnG,qBAAa,0BAA2B,SAAQ,WAAW;IACzD,QAAQ,EAAE,eAAe,CAOvB;IAEI,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA2BhF"}

package/esm/src/server/handlers/request/prod-hydration-module.handler.js

@@ -0,0 +1,41 @@
+import { BaseHandler } from "../response/base.js";
+import { generateProdHydrationModule, PROD_HYDRATION_MODULE_PATH, } from "../../../html/hydration-script-builder/prod-scripts.js";
+import { computeStrongEtag, hasMatchingEtag } from "../utils/etag.js";
+import { HTTP_OK, PRIORITY_HIGH_DEV } from "../../../utils/constants/index.js";
+let cachedModule = null;
+function getProdHydrationModuleBundle() {
+    if (cachedModule)
+        return cachedModule;
+    const js = generateProdHydrationModule();
+    cachedModule = {
+        js,
+        etag: computeStrongEtag(js),
+    };
+    return cachedModule;
+}
+export class ProdHydrationModuleHandler extends BaseHandler {
+    metadata = {
+        name: "ProdHydrationModuleHandler",
+        priority: PRIORITY_HIGH_DEV,
+        patterns: [
+            { pattern: PROD_HYDRATION_MODULE_PATH, exact: true, method: "GET" },
+            { pattern: PROD_HYDRATION_MODULE_PATH, exact: true, method: "HEAD" },
+        ],
+    };
+    async handle(req, ctx) {
+        if (!this.shouldHandle(req, ctx)) {
+            return this.continue();
+        }
+        const method = req.method.toUpperCase();
+        const { js, etag } = getProdHydrationModuleBundle();
+        const builder = this.createResponseBuilder(ctx).withCORS(req, ctx.securityConfig?.cors);
+        if (hasMatchingEtag(req, etag)) {
+            return this.respond(builder.withSecurity(ctx.securityConfig ?? undefined, req).notModified(etag));
+        }
+        return this.respond(builder
+            .withSecurity(ctx.securityConfig ?? undefined, req)
+            .withCache("no-cache")
+            .withETag(etag)
+            .withContentType("application/javascript; charset=utf-8", method === "HEAD" ? null : js, HTTP_OK));
+    }
+}

package/esm/src/server/handlers/request/ssr/ssr.handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr.handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/request/ssr/ssr.handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,4CAA4C,CAAC;AAMpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAKzE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,QAAQ,EAAE,eAAe,CAIvB;IAEF,OAAO,CAAC,UAAU,CAAiB;gBAEvB,UAAU,CAAC,EAAE,cAAc;IAKvC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BzE,OAAO,CAAC,qBAAqB;IAkE7B,OAAO,CAAC,iBAAiB;IA2DzB,OAAO,CAAC,cAAc;YAgBR,cAAc;YA6Bd,sBAAsB;YAgBtB,aAAa;CAU5B"}
+{"version":3,"file":"ssr.handler.d.ts","sourceRoot":"","sources":["../../../../../../src/src/server/handlers/request/ssr/ssr.handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,OAAO,MAAM,8BAA8B,CAAC;AAGxD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,aAAa,EACd,MAAM,gBAAgB,CAAC;AAWxB,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,4CAA4C,CAAC;AAMpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAKzE;AAED;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,WAAW;IACzC,QAAQ,EAAE,eAAe,CAIvB;IAEF,OAAO,CAAC,UAAU,CAAiB;gBAEvB,UAAU,CAAC,EAAE,cAAc;IAKvC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IA8BzE,OAAO,CAAC,qBAAqB;IAkE7B,OAAO,CAAC,iBAAiB;IA8DzB,OAAO,CAAC,cAAc;YAgBR,cAAc;YA6Bd,sBAAsB;YAgBtB,aAAa;CAU5B"}

package/esm/src/server/handlers/request/ssr/ssr.handler.js

@@ -134,6 +134,8 @@ export class SSRHandler extends BaseHandler {
             const pageId = url.searchParams.get("page_id") || undefined;
             const noHmr = url.searchParams.get("noHmr") === "1" ||
                 url.searchParams.get("no_hmr") === "1";
+            const forceProductionScripts = url.searchParams.get("forceProductionScripts") === "1" ||
+                url.searchParams.get("force_production_scripts") === "1";
             const useNoCache = shouldUseNoCacheHeadersFromHandler(ctx);
             const result = await this.ssrService.renderPage(ctx, {
                 request: req,
@@ -144,6 +146,7 @@ export class SSRHandler extends BaseHandler {
                 projectId,
                 pageId,
                 noHmr,
+                forceProductionScripts,
                 useNoCache,
             });
             endRequest(requestId);

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":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAoBrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAetE,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,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC9C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,oFAAoF;IACpF,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,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,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CA0IvB"}
+{"version":3,"file":"production-server.d.ts","sourceRoot":"","sources":["../../../src/src/server/production-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAInE,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA4BrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAmFtE,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,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;IAC9C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,oFAAoF;IACpF,eAAe,CAAC,EAAE,gBAAgB,CAAC;IACnC,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,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,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,YAAY,CAAC,CAkJvB"}

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

@@ -8,6 +8,10 @@ import { isDebugEnabled } from "../utils/constants/env.js";
 import { initializeOTLPWithApis, shutdownOTLP, withSpan, } from "../observability/tracing/otlp-setup.js";
 import { getMemorySnapshot, startMemoryMonitoring, stopMemoryMonitoring, } from "../utils/memory/index.js";
 import { initializeDistributedCaches } from "../cache/distributed-cache-init.js";
+import { getConfig } from "../config/index.js";
+import { resolveStyleContentVersion } from "../html/styles-builder/content-version.js";
+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 { enableSSRClientOnlyFetching, enableSSRFetchInterception, setSSRServerPort, } from "../rendering/ssr-globals.js";
 const serverLog = logger.component("server");
@@ -19,6 +23,60 @@ const DEFAULT_MEMORY_MONITORING_INTERVAL_MS = 30_000;
 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) {
+    if (options.defaultEnvironment !== "production")
+        return;
+    const projectsToWarm = new Map();
+    if (options.localProjects) {
+        for (const [projectSlug, projectDir] of Object.entries(options.localProjects)) {
+            projectsToWarm.set(projectSlug, projectDir);
+        }
+    }
+    if (options.defaultProjectSlug && options.projectDir) {
+        projectsToWarm.set(options.defaultProjectSlug, options.projectDir);
+    }
+    else if (projectsToWarm.size === 0 && options.defaultProjectId && options.projectDir) {
+        projectsToWarm.set(options.defaultProjectId, options.projectDir);
+    }
+    if (projectsToWarm.size === 0)
+        return;
+    await Promise.all([...projectsToWarm.entries()].map(async ([projectSlug, projectDir]) => {
+        try {
+            const config = await getConfig(projectDir, adapter, { cacheKey: projectSlug });
+            const styleProfile = createStyleScopeProfile(config);
+            const files = await collectLocalProjectSourceFiles({
+                projectDir,
+                styleProfile,
+            });
+            const stylesheet = await readLocalProjectStylesheet(projectDir, config?.tailwind?.stylesheet);
+            const result = await buildPreparedCSSArtifactFromFiles({
+                projectSlug,
+                projectVersion: resolveStyleContentVersion(null),
+                projectDir,
+                files,
+                styleProfile,
+                stylesheet,
+                stylesheetPath: config?.tailwind?.stylesheet,
+                minify: true,
+                environment: "preview",
+                buildMode: "production",
+            });
+            serverLog.debug("Prewarmed local production CSS artifact", {
+                projectSlug,
+                projectDir,
+                fileCount: files.length,
+                fromCache: result.fromCache,
+            });
+        }
+        catch (error) {
+            serverLog.debug("Skipping local production CSS prewarm", {
+                projectSlug,
+                projectDir,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }));
+}
 export function startProductionServer(options) {
     return withSpan("server.startProductionServer", async () => {
         const { projectDir, port, bindAddress = "0.0.0.0", signal, debug, defaultProjectSlug, defaultProjectId, defaultEnvironment, requestInterceptor, bootstrapResult, discoveryConfig, localProjects, } = options;
@@ -29,6 +87,13 @@ export function startProductionServer(options) {
         if (bootstrap.usingFSAdapter) {
             logger.debug("FSAdapter initialized", { type: bootstrap.fsAdapterType });
         }
+        await prewarmLocalProductionCSSArtifacts(bootstrap.adapter, {
+            projectDir,
+            defaultProjectSlug,
+            defaultProjectId,
+            defaultEnvironment,
+            localProjects,
+        });
         // Enable SSR fetch interception to handle relative URLs during SSR
         setSSRServerPort(port);
         enableSSRFetchInterception();

package/esm/src/server/runtime-handler/handler-context-builder.d.ts

@@ -14,7 +14,7 @@ type CspUserHeader = string | null;
 import type { ParsedDomain } from "../utils/domain-parser.js";
 import type { HandlerContext } from "../handlers/types.js";
 import type { RouteRegistry } from "../../routing/registry/index.js";
-interface HandlerContextOptions {
+export interface HandlerContextOptions {
     /** Project directory */
     projectDir: string;
     /** Runtime adapter */

package/esm/src/server/runtime-handler/handler-context-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler-context-builder.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/handler-context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,uEAAuE;AACvE,KAAK,aAAa,GAAG,MAAM,GAAG,IAAI,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAIrE,UAAU,qBAAqB;IAC7B,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,sBAAsB;IACtB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,sBAAsB;IACtB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,iBAAiB;IACjB,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,uBAAuB;IACvB,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,yBAAyB;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,mBAAmB;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iDAAiD;IACjD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,uBAAuB;IACvB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,2BAA2B;IAC3B,mBAAmB,EAAE,SAAS,GAAG,YAAY,CAAC;IAC9C,kDAAkD;IAClD,cAAc,EAAE,OAAO,+BAA+B,EAAE,cAAc,CAAC;IACvE,qBAAqB;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,sCAAsC;IACtC,cAAc,EAAE,OAAO,CAAC;IACxB,wBAAwB;IACxB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,iFAAiF;IACjF,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,6FAA6F;IAC7F,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CAmD/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,cAAc,GAAG,IAAI,EACrC,aAAa,EAAE,aAAa,GAAG,IAAI,EACnC,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,MAAM,EAAE,eAAe,GAAG,SAAS,GAClC,cAAc,CAShB"}
+{"version":3,"file":"handler-context-builder.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/handler-context-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,uEAAuE;AACvE,KAAK,aAAa,GAAG,MAAM,GAAG,IAAI,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAIrE,MAAM,WAAW,qBAAqB;IACpC,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,sBAAsB;IACtB,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,sBAAsB;IACtB,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;IACpC,iBAAiB;IACjB,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,uBAAuB;IACvB,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IACpC,yBAAyB;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,mBAAmB;IACnB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iBAAiB;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,iDAAiD;IACjD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,uBAAuB;IACvB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,2BAA2B;IAC3B,mBAAmB,EAAE,SAAS,GAAG,YAAY,CAAC;IAC9C,kDAAkD;IAClD,cAAc,EAAE,OAAO,+BAA+B,EAAE,cAAc,CAAC;IACvE,qBAAqB;IACrB,aAAa,EAAE,aAAa,CAAC;IAC7B,sCAAsC;IACtC,cAAc,EAAE,OAAO,CAAC;IACxB,wBAAwB;IACxB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,iFAAiF;IACjF,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,6FAA6F;IAC7F,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,cAAc,CAmD/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,cAAc,GAAG,IAAI,EACrC,aAAa,EAAE,aAAa,GAAG,IAAI,EACnC,KAAK,EAAE,OAAO,GAAG,SAAS,EAC1B,MAAM,EAAE,eAAe,GAAG,SAAS,GAClC,cAAc,CAShB"}

package/esm/src/server/runtime-handler/index.d.ts

@@ -14,7 +14,7 @@ import type { Handler } from "../../types/index.js";
 import { ApiHandlerWrapper } from "../handlers/request/api/index.js";
 export { parseProxyEnvironment, type ProxyEnvironment } from "./proxy-environment.js";
 /** Handler names in registration order. */
-export declare const HANDLER_NAMES: readonly ["AuthHandler", "CsrfHandler", "HMRHandler", "CorsHandler", "HealthHandler", "MetricsHandler", "MemoryDebugHandler", "ClientLogHandler", "DevEndpointsHandler", "StylesCSSHandler", "DebugContextHandler", "OpenAPIHandler", "OpenAPIDocsHandler", "InternalAgentsListHandler", "AgentStreamHandler", "AgentRunResumeHandler", "AgentRunCancelHandler", "ChannelInvokeHandler", "DevDashboardHandler", "ProjectsHandler", "StudioBridgeModulesHandler", "CSSHandler", "DevFileHandler", "SnippetHandler", "StaticHandler", "LibModulesHandler", "RSCHandler", "ModuleHandler", "ApiHandlerWrapper", "MarkdownPreviewHandler", "SSRHandler", "NotFoundHandler"];
+export declare const HANDLER_NAMES: readonly ["AuthHandler", "CsrfHandler", "HMRHandler", "CorsHandler", "HealthHandler", "MetricsHandler", "MemoryDebugHandler", "ClientLogHandler", "DevEndpointsHandler", "StylesCSSHandler", "DebugContextHandler", "OpenAPIHandler", "OpenAPIDocsHandler", "InternalAgentsListHandler", "AgentStreamHandler", "AgentRunResumeHandler", "AgentRunCancelHandler", "ChannelInvokeHandler", "DevDashboardHandler", "ProjectsHandler", "StudioBridgeModulesHandler", "ProdHydrationModuleHandler", "CSSHandler", "DevFileHandler", "SnippetHandler", "StaticHandler", "LibModulesHandler", "RSCHandler", "ModuleHandler", "ApiHandlerWrapper", "MarkdownPreviewHandler", "SSRHandler", "NotFoundHandler"];
 /** Union of all registered handler names. */
 export type HandlerName = (typeof HANDLER_NAMES)[number];
 /**

package/esm/src/server/runtime-handler/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAQlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA0BpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AA8DrE,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAMtF,2CAA2C;AAC3C,eAAO,MAAM,aAAa,yoBAiChB,CAAC;AAEX,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAyCD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,mBAAwB,GAC7B;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAuB5D;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CAC/C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,qBAAsC,GAC3C,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAyYnF;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAQlD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA+BpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AA+DrE,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAMtF,2CAA2C;AAC3C,eAAO,MAAM,aAAa,uqBAkChB,CAAC;AAEX,6CAA6C;AAC7C,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA0CD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,mBAAwB,GAC7B;IAAE,QAAQ,EAAE,aAAa,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAA;CAAE,CAuB5D;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,uGAAuG;IACvG,kBAAkB,CAAC,EAAE,SAAS,GAAG,YAAY,CAAC;CAC/C;AAED,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,qBAAsC,GAC3C,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAganF;AAGD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC"}

package/esm/src/server/runtime-handler/index.js

@@ -22,6 +22,7 @@ import { CsrfHandler } from "../../security/http/csrf/csrf-handler.js";
 import { CorsHandler } from "../handlers/response/cors.js";
 import { HealthHandler } from "../handlers/monitoring/health.handler.js";
 import { MetricsHandler } from "../handlers/monitoring/metrics.handler.js";
+import { finalizeRequestProfiling, runWithRequestProfiling, } from "../../observability/request-profiler.js";
 import { ClientLogHandler } from "../handlers/monitoring/client-log.handler.js";
 import { MemoryDebugHandler } from "../handlers/monitoring/memory.handler.js";
 import { DevEndpointsHandler } from "../handlers/dev/endpoints.handler.js";
@@ -32,6 +33,7 @@ import { StudioBridgeModulesHandler } from "../handlers/studio/bridge-modules.ha
 import { StaticHandler } from "../handlers/request/static.handler.js";
 import { SnippetHandler } from "../handlers/request/snippet.handler.js";
 import { LibModulesHandler } from "../handlers/request/lib-modules.handler.js";
+import { ProdHydrationModuleHandler } from "../handlers/request/prod-hydration-module.handler.js";
 import { CSSHandler } from "../handlers/request/css.handler.js";
 import { RSCHandler } from "../handlers/request/rsc/index.js";
 import { ModuleHandler } from "../handlers/request/module/index.js";
@@ -59,7 +61,7 @@ import { localProjectCache } from "./local-project-discovery.js";
 import { resolveEnvironment } from "./environment-resolution.js";
 import { buildHandlerContext, buildMinimalContext } from "./handler-context-builder.js";
 import { handleProjectsRequest, shouldHandleProjectsUI } from "./projects-handler.js";
-import { HTTP_GATEWAY_TIMEOUT, isLightweightPath, isMonitoringPath, isWebSocketPath, } from "./request-utils.js";
+import { HTTP_GATEWAY_TIMEOUT, isLightweightPath, isMonitoringPath, isWebSocketPath, shouldSkipEnrichedContext, } from "./request-utils.js";
 import { withRequestTimeout } from "./timeout-manager.js";
 import { EnvironmentVariableCache, fetchProjectEnvVars, runWithProjectEnv, } from "../project-env/index.js";
 import { SCANNER_PATH_PATTERN } from "../../utils/constants/security.js";
@@ -90,6 +92,7 @@ export const HANDLER_NAMES = [
     "DevDashboardHandler",
     "ProjectsHandler",
     "StudioBridgeModulesHandler",
+    "ProdHydrationModuleHandler",
     "CSSHandler",
     "DevFileHandler",
     "SnippetHandler",
@@ -125,6 +128,7 @@ const handlerFactories = {
     DevDashboardHandler: () => new DevDashboardHandler(),
     ProjectsHandler: () => new ProjectsHandler(),
     StudioBridgeModulesHandler: () => new StudioBridgeModulesHandler(),
+    ProdHydrationModuleHandler: () => new ProdHydrationModuleHandler(),
     CSSHandler: () => new CSSHandler(),
     DevFileHandler: () => new DevFileHandler(),
     SnippetHandler: () => new SnippetHandler(),
@@ -383,7 +387,7 @@ export function createVeryfrontHandler(projectDir, adapter, opts = { projectDir
                     if (envRes.errorResponse) {
                         return envRes.errorResponse;
                     }
-                    const isInternalAgentControlPlanePath = url.pathname.startsWith("/internal/agents/");
+                    const skipRenderEnrichedContext = shouldSkipEnrichedContext(url.pathname);
                     // Build handler context
                     const ctx = buildHandlerContext({
                         projectDir: adapterRes.projectDir,
@@ -404,7 +408,7 @@ export function createVeryfrontHandler(projectDir, adapter, opts = { projectDir
                         isLocalProject: adapterRes.isLocalProject,
                         moduleServerUrl: opts.moduleServerUrl,
                         environmentId: headers.environmentId,
-                        skipEnrichedContext: isInternalAgentControlPlanePath,
+                        skipEnrichedContext: skipRenderEnrichedContext,
                     });
                     // Fetch per-project env vars for remote projects
                     let envVarsForRequest = {};
@@ -425,15 +429,36 @@ export function createVeryfrontHandler(projectDir, adapter, opts = { projectDir
                     // reqCtx.token indicates the request came through the proxy with auth.
                     // Without it (standalone / test), host env must remain accessible.
                     const shouldIsolateEnv = !adapterRes.isLocalProject && !!reqCtx.token;
-                    const response = await withSpan(SpanNames.HANDLER_EXECUTE, () => {
-                        if (shouldIsolateEnv) {
-                            return runWithProjectEnv(envVarsForRequest, executeRoute);
+                    const response = await runWithRequestProfiling({
+                        category: url.pathname.startsWith("/_vf_styles/")
+                            ? "css"
+                            : url.pathname.startsWith("/_vf_modules/")
+                                ? "module"
+                                : url.pathname.startsWith("/api/")
+                                    ? "api"
+                                    : "html",
+                        method: req.method,
+                        pathname: url.pathname,
+                        projectSlug: projectRes.projectSlug,
+                        requestMode: envRes.resolvedEnvironment,
+                    }, async () => {
+                        let routedResponse;
+                        try {
+                            routedResponse = await withSpan(SpanNames.HANDLER_EXECUTE, () => {
+                                if (shouldIsolateEnv) {
+                                    return runWithProjectEnv(envVarsForRequest, executeRoute);
+                                }
+                                return executeRoute();
+                            }, {
+                                "handler.project_slug": projectRes.projectSlug || "unknown",
+                                "handler.path": url.pathname,
+                                "handler.method": req.method,
+                            });
+                            return routedResponse;
+                        }
+                        finally {
+                            finalizeRequestProfiling(routedResponse?.status);
                         }
-                        return executeRoute();
-                    }, {
-                        "handler.project_slug": projectRes.projectSlug || "unknown",
-                        "handler.path": url.pathname,
-                        "handler.method": req.method,
                     });
                     if (response)
                         return response;

package/esm/src/server/runtime-handler/request-utils.d.ts

@@ -24,4 +24,11 @@ export declare const LIGHTWEIGHT_PATH_PREFIXES: string[];
 export declare function isLightweightPath(pathname: string): boolean;
 /** Check if path is the WebSocket endpoint (long-lived, handled by HMR handler) */
 export declare function isWebSocketPath(pathname: string): boolean;
+/**
+ * Requests that do not need render-specific enriched context.
+ *
+ * These routes still receive the normal handler context, but they can skip
+ * render cache prefix/content-source derivation and the enriched render payload.
+ */
+export declare function shouldSkipEnrichedContext(pathname: string): boolean;
 //# sourceMappingURL=request-utils.d.ts.map

package/esm/src/server/runtime-handler/request-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request-utils.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/request-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAkBpD;AAED,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,aAA+C,CAAC;AAK7E,yFAAyF;AACzF,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,eAA4B,CAAC;AAE1D,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,uFAAuF;AACvF,eAAO,MAAM,yBAAyB,UAOrC,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD"}
+{"version":3,"file":"request-utils.d.ts","sourceRoot":"","sources":["../../../../src/src/server/runtime-handler/request-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAkBpD;AAED,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,aAA+C,CAAC;AAK7E,yFAAyF;AACzF,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAC;AAEhC,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,eAA4B,CAAC;AAE1D,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,uFAAuF;AACvF,eAAO,MAAM,yBAAyB,UAQrC,CAAC;AAEF,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,mFAAmF;AACnF,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnE"}