veryfront 0.1.831 → 0.1.833

package/esm/deno.js

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

package/esm/src/html/html-shell-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-shell-generator.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-shell-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AA2BxE,OAAO,EAGL,aAAa,EACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAqCxD,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC;AAmFzE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,EACtB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC5C,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBzC;AAqRD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,EACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,CAoBjB"}
+{"version":3,"file":"html-shell-generator.d.ts","sourceRoot":"","sources":["../../../src/src/html/html-shell-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAmCxE,OAAO,EAGL,aAAa,EACd,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAgDxD,KAAK,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC;AA0FzE,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,EACtB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,iBAAiB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC5C,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAmBzC;AAqRD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,qBAAqB,EAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAC1C,KAAK,CAAC,EAAE,cAAc,EACtB,iBAAiB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC5C,OAAO,CAAC,MAAM,CAAC,CAoBjB"}

package/esm/src/html/html-shell-generator.js

@@ -5,16 +5,18 @@ import { profilePhase } from "../observability/request-profiler.js";
 import { serverLogger } from "../utils/logger/logger.js";
 import { isMarkdownPreview as checkMarkdownPreview } from "../transforms/md/utils.js";
 import { generateModulePreloadHintsFromManifest, getRouteManifest, } from "../modules/manifest/route-module-manifest.js";
-import { getReadyManifestForRenderAsync } from "../release-assets/manifest-cache.js";
+import { getReadyManifestForRenderAsync, isReleaseAssetManifestEnabled, } from "../release-assets/manifest-cache.js";
+import { RELEASE_MODULE_RUNTIME_VERSION_PARAM, RELEASE_MODULE_VERSION_PARAM, } from "../release-assets/constants.js";
 import { resolveManifestModuleUrl, resolveManifestRoutePreloadUrls, } from "../release-assets/html-consumption.js";
 import { routeForPage } from "../release-assets/route-path.js";
+import { VERSION } from "../utils/version.js";
 import { buildNonceAttribute, escapeHTML } from "./html-escape.js";
 import { generateHydrationData, getDevScripts, getProdHydrationModulePath, getProdScripts, } from "./hydration-script-builder/index.js";
 import { getPreviewStylesheetLink, getStudioScripts } from "./dev-scripts.js";
 import { processMetadata } from "./metadata-builder.js";
 import { extractCandidates, getDevStyles as getErrorOverlayStyles, getProjectCSS, } from "./styles-builder/index.js";
 import { buildImportMap, buildRootAttributes, shouldDisableLayout } from "./utils.js";
-function pathToModuleUrl(path, studioEmbed, manifest) {
+function pathToModuleUrl(path, studioEmbed, manifest, fallbackReleaseId) {
     if (!path)
         return "";
     // Manifest hit → content-addressed asset URL (production only; never in
@@ -28,7 +30,17 @@ function pathToModuleUrl(path, studioEmbed, manifest) {
     const urlBase = withExtReplaced === path && !path.endsWith(".js")
         ? `/_vf_modules/${path}.js`
         : `/_vf_modules/${withExtReplaced}`;
-    return studioEmbed ? `${urlBase}?studio_embed=true` : urlBase;
+    if (studioEmbed)
+        return `${urlBase}?studio_embed=true`;
+    return fallbackReleaseId ? appendReleaseModuleVersion(urlBase, fallbackReleaseId) : urlBase;
+}
+function appendReleaseModuleVersion(url, releaseId) {
+    const separator = url.includes("?") ? "&" : "?";
+    const params = new URLSearchParams({
+        [RELEASE_MODULE_VERSION_PARAM]: releaseId,
+        [RELEASE_MODULE_RUNTIME_VERSION_PARAM]: VERSION,
+    });
+    return `${url}${separator}${params.toString()}`;
 }
 function getRelativePagePath(fullPath, projectDir) {
     if (!fullPath)
@@ -46,6 +58,10 @@ function generateModulePreloadHints(options, releaseManifest) {
     const addedUrls = new Set();
     const projectDir = options.projectDir ?? "";
     const studioEmbed = options.studioEmbed;
+    const fallbackReleaseId = !studioEmbed && !releaseManifest && options.releaseId &&
+        isReleaseAssetManifestEnabled()
+        ? options.releaseId
+        : undefined;
     function addHint(moduleUrl) {
         if (!moduleUrl || addedUrls.has(moduleUrl))
             return;
@@ -54,14 +70,14 @@ function generateModulePreloadHints(options, releaseManifest) {
     }
     if (options.pagePath) {
         const relativePath = getRelativePagePath(options.pagePath, projectDir);
-        addHint(pathToModuleUrl(relativePath, studioEmbed, releaseManifest));
+        addHint(pathToModuleUrl(relativePath, studioEmbed, releaseManifest, fallbackReleaseId));
     }
     for (const layout of options.nestedLayouts ?? []) {
         const layoutPath = layout.path ?? layout.componentPath ?? "";
         if (!layoutPath)
             continue;
         const relativePath = getRelativePagePath(layoutPath, projectDir);
-        addHint(pathToModuleUrl(relativePath, studioEmbed, releaseManifest));
+        addHint(pathToModuleUrl(relativePath, studioEmbed, releaseManifest, fallbackReleaseId));
     }
     // Skip manifest-based preloads in preview/studio-embed mode:
     // HMR reloads modules with ?t=timestamp, so preloaded versions won't match
@@ -90,10 +106,13 @@ function generateModulePreloadHints(options, releaseManifest) {
     if (!manifest || manifest.renderCount <= 0)
         return hints.join("\n  ");
     for (const hint of generateModulePreloadHintsFromManifest(projectSlug, legacyModuleManifestRoute, 50)) {
-        const href = hint.match(/href="([^"]+)"/)?.[1];
+        const rawHref = hint.match(/href="([^"]+)"/)?.[1];
+        const href = rawHref && fallbackReleaseId && rawHref.startsWith("/_vf_modules/")
+            ? appendReleaseModuleVersion(rawHref, fallbackReleaseId)
+            : rawHref;
         if (!href || addedUrls.has(href))
             continue;
-        hints.push(hint);
+        hints.push(href === rawHref ? hint : hint.replace(/href="([^"]+)"/, `href="${href}"`));
         addedUrls.add(href);
     }
     return hints.join("\n  ");

package/esm/src/modules/server/module-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-server.d.ts","sourceRoot":"","sources":["../../../../src/src/modules/server/module-server.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAG5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAuCtE;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwDrD,CAAC;AAiBF,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,uBAAuB;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8XzF;AAwWD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGrD"}
+{"version":3,"file":"module-server.d.ts","sourceRoot":"","sources":["../../../../src/src/modules/server/module-server.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAG5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AA6CtE;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwDrD,CAAC;AA4DF,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,sBAAsB;IACtB,OAAO,EAAE,cAAc,CAAC;IACxB,uBAAuB;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,CA+XzF;AAwWD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAGrD"}

package/esm/src/modules/server/module-server.js

@@ -15,11 +15,13 @@ import { injectNodePositions } from "../../transforms/plugins/babel-node-positio
 import { parseProjectDomain } from "../../server/utils/domain-parser.js";
 import { applySSRImportRewritesAsync, resolveSSRImportTargetModulePath, stripSSRModuleJsExtension, } from "./ssr-import-rewriter.js";
 import { addHMRTimestamps } from "../../transforms/esm/import-rewriter.js";
+import { replaceSpecifiers } from "../../transforms/esm/lexer.js";
 import { FRAMEWORK_ROOT, resolveFrameworkSourcePath, } from "../../platform/compat/framework-source-resolver.js";
 import { getReactUrls, REACT_DEFAULT_VERSION } from "../../utils/constants/cdn.js";
 import { readLimitedCrossProjectSource } from "./cross-project-source-limit.js";
 import { sha256Short } from "../../cache/hash.js";
 import { rewriteReleaseDependencyImportsForModule } from "../../release-assets/module-consumption.js";
+import { RELEASE_ASSET_IMMUTABLE_MAX_AGE_SECONDS, RELEASE_MODULE_RUNTIME_VERSION_PARAM, RELEASE_MODULE_VERSION_PARAM, } from "../../release-assets/constants.js";
 import { buildSourceMissCacheKey, hasSourceMiss, rememberSourceMiss, } from "./module-source-resolution-cache.js";
 import { ensureFilenameDefaultExport } from "../loader-shared/filename-default-export.js";
 const logger = serverLogger.component("module-server");
@@ -96,6 +98,37 @@ const SNIPPET_MODULE_PREFIX = /^\/_vf_modules\/_snippets\/([a-f0-9]+)\.js/;
 // Cross-project import patterns: /_vf_modules/_cross/<slug>[@<version>]/@/<path>
 const CROSS_PROJECT_VERSIONED_PREFIX = /^\/_vf_modules\/_cross\/([a-z0-9-]+)@([\d^~x][\d.x^~-]*)\/\@\/(.+)$/;
 const CROSS_PROJECT_LATEST_PREFIX = /^\/_vf_modules\/_cross\/([a-z0-9-]+)\/\@\/(.+)$/;
+function appendReleaseModuleVersion(url, releaseId) {
+    if (url.includes(`${RELEASE_MODULE_VERSION_PARAM}=`) ||
+        url.includes(`${RELEASE_MODULE_RUNTIME_VERSION_PARAM}=`)) {
+        return url;
+    }
+    const separator = url.includes("?") ? "&" : "?";
+    const params = new URLSearchParams({
+        [RELEASE_MODULE_VERSION_PARAM]: releaseId,
+        [RELEASE_MODULE_RUNTIME_VERSION_PARAM]: VERSION,
+    });
+    return `${url}${separator}${params.toString()}`;
+}
+function shouldCacheReleaseVersionedModule(url, options, isSSR) {
+    if (options.dev || isSSR || !options.releaseId)
+        return false;
+    return url.searchParams.get(RELEASE_MODULE_VERSION_PARAM) === options.releaseId &&
+        url.searchParams.get(RELEASE_MODULE_RUNTIME_VERSION_PARAM) === VERSION;
+}
+function isSSRModuleRequest(req, url) {
+    const userAgent = req.headers.get("user-agent") ?? "";
+    return url.searchParams.get("ssr") === "true" || userAgent.startsWith("Deno/");
+}
+async function addReleaseVersionToFallbackImports(code, releaseId) {
+    if (!releaseId || !code.includes("/_vf_modules/"))
+        return code;
+    return await replaceSpecifiers(code, (specifier) => {
+        if (!specifier.startsWith("/_vf_modules/"))
+            return null;
+        return appendReleaseModuleVersion(specifier, releaseId);
+    });
+}
 /** Serve transformed module at /_vf_modules/* path */
 export function serveModule(req, options) {
     const url = new URL(req.url);
@@ -152,8 +185,7 @@ export function serveModule(req, options) {
                 });
             }
             const { slug: snippetProjectSlug, branch: snippetBranch } = parseProjectDomain(url.host);
-            const userAgent = req.headers.get("user-agent") ?? "";
-            const isSSR = url.searchParams.get("ssr") === "true" || userAgent.startsWith("Deno/");
+            const isSSR = isSSRModuleRequest(req, url);
             logger.debug("Transforming snippet", {
                 hash,
                 isSSR,
@@ -231,8 +263,7 @@ export function serveModule(req, options) {
                         "Cache-Control": "no-cache",
                     });
                 }
-                const userAgent = req.headers.get("user-agent") ?? "";
-                const isSSR = url.searchParams.get("ssr") === "true" || userAgent.startsWith("Deno/");
+                const isSSR = isSSRModuleRequest(req, url);
                 let code = await profileModuleTransform(() => transformToESM(source, crossPath, projectDir, adapter, {
                     projectId: effectiveProjectId,
                     dev,
@@ -325,7 +356,7 @@ export function serveModule(req, options) {
                         : await secureFs.readFile(sourceFile);
                 }
                 const userAgent = req.headers.get("user-agent") ?? "";
-                const isSSR = url.searchParams.get("ssr") === "true" || userAgent.startsWith("Deno/");
+                const isSSR = isSSRModuleRequest(req, url);
                 const studioEmbed = url.searchParams.get("studio_embed") === "true";
                 const shouldInjectPositions = dev || options.mode === "preview";
                 const isJsxFile = /\.(tsx|jsx)$/i.test(sourceFile);
@@ -379,9 +410,12 @@ export function serveModule(req, options) {
                         releaseId: options.releaseId,
                         readDependencySource: (path) => platformFs.readTextFile(path),
                     });
+                    code = await addReleaseVersionToFallbackImports(code, options.releaseId);
                 }
             }
-            const headers = getDevModuleHeaders(modulePath);
+            const headers = getModuleHeaders(modulePath, {
+                cacheable: shouldCacheReleaseVersionedModule(url, options, isSSRModuleRequest(req, url)),
+            });
             logger.debug("Request complete", {
                 path: modulePath,
                 durationMs: (performance.now() - startTime).toFixed(1),
@@ -391,7 +425,7 @@ export function serveModule(req, options) {
         catch (error) {
             const errorMsg = getErrorMessage(error);
             logger.error("Module transform error", { modulePath, error: errorMsg });
-            const headers = getDevModuleHeaders(modulePath);
+            const headers = getModuleHeaders(modulePath);
             const errorBody = createDevModuleErrorBody(modulePath, errorMsg);
             return createModuleResponse(method, errorBody, HTTP_SERVER_ERROR, headers);
         }
@@ -671,10 +705,12 @@ export function isModuleRequest(req) {
     const url = new URL(req.url);
     return DEV_MODULE_PREFIX.test(url.pathname);
 }
-function getDevModuleHeaders(modulePath) {
+function getModuleHeaders(modulePath, options = {}) {
     return {
         "Content-Type": getDevModuleContentType(modulePath),
-        "Cache-Control": "no-cache",
+        "Cache-Control": options.cacheable
+            ? `public, max-age=${RELEASE_ASSET_IMMUTABLE_MAX_AGE_SECONDS}, immutable`
+            : "no-cache",
     };
 }
 function getDevModuleContentType(modulePath) {

package/esm/src/proxy/main.js

@@ -38,6 +38,7 @@ import { handleReleaseAssetRequest, isReleaseAssetPath } from "./asset-handler.j
 import { runProxyRequestLifecycle } from "./request-lifecycle.js";
 import { createUpstreamFailureResponse, createUpstreamTimeoutResponse, UPSTREAM_FAILURE_STATUS, UPSTREAM_TIMEOUT_STATUS, } from "./upstream-error-response.js";
 import { createProxyServerTiming, markProxyServerTimingPhase, profileProxyServerTimingPhase, withProxyServerTimingHeader, } from "./server-timing.js";
+import { removeStickyCookieFromPublicCacheableResponse } from "./response-headers.js";
 function getLocalProjects() {
     const raw = getEnv("LOCAL_PROJECTS");
     return raw ? JSON.parse(raw) : {};
@@ -335,11 +336,11 @@ function forwardToServer(req, url) {
                         else {
                             reqLogger.info(`${response.status} ${req.method} ${url.pathname}`, { ms });
                         }
-                        return withProxyTiming(new Response(response.body, {
+                        return withProxyTiming(removeStickyCookieFromPublicCacheableResponse(new Response(response.body, {
                             status: response.status,
                             statusText: response.statusText,
                             headers: response.headers,
-                        }));
+                        })));
                     }
                     catch (error) {
                         clearTimeout(timeoutId);

package/esm/src/proxy/response-headers.d.ts

@@ -0,0 +1,2 @@
+export declare function removeStickyCookieFromPublicCacheableResponse(response: Response): Response;
+//# sourceMappingURL=response-headers.d.ts.map

package/esm/src/proxy/response-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-headers.d.ts","sourceRoot":"","sources":["../../../src/src/proxy/response-headers.ts"],"names":[],"mappings":"AA+DA,wBAAgB,6CAA6C,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAkB1F"}

package/esm/src/proxy/response-headers.js

@@ -0,0 +1,74 @@
+const STICKY_COOKIE_NAME = "lb";
+function parseCacheControl(cacheControl) {
+    const directives = new Map();
+    if (!cacheControl)
+        return directives;
+    for (const part of cacheControl.split(",")) {
+        const trimmed = part.trim();
+        if (!trimmed)
+            continue;
+        const [rawName, rawValue] = trimmed.split("=", 2);
+        const name = rawName?.trim().toLowerCase();
+        if (!name)
+            continue;
+        directives.set(name, rawValue === undefined ? true : rawValue.trim().replace(/^"|"$/g, ""));
+    }
+    return directives;
+}
+function readPositiveDirectiveSeconds(directives, name) {
+    const value = directives.get(name);
+    if (typeof value !== "string")
+        return 0;
+    const seconds = Number(value);
+    return Number.isFinite(seconds) && seconds > 0 ? seconds : 0;
+}
+function isPublicCacheable(headers) {
+    const directives = parseCacheControl(headers.get("cache-control"));
+    if (!directives.has("public"))
+        return false;
+    if (directives.has("private") || directives.has("no-store") || directives.has("no-cache")) {
+        return false;
+    }
+    return directives.has("immutable") ||
+        readPositiveDirectiveSeconds(directives, "s-maxage") > 0 ||
+        readPositiveDirectiveSeconds(directives, "max-age") > 0;
+}
+function readSetCookies(headers) {
+    const getSetCookie = headers.getSetCookie;
+    if (typeof getSetCookie === "function") {
+        const values = getSetCookie.call(headers);
+        if (values.length > 0)
+            return values;
+    }
+    const values = [];
+    for (const [key, value] of headers) {
+        if (key.toLowerCase() === "set-cookie")
+            values.push(value);
+    }
+    const directValue = headers.get("set-cookie");
+    if (values.length === 0 && directValue)
+        values.push(directValue);
+    return values;
+}
+function isStickyCookie(setCookie) {
+    const [name] = setCookie.split("=", 1);
+    return name?.trim().toLowerCase() === STICKY_COOKIE_NAME;
+}
+export function removeStickyCookieFromPublicCacheableResponse(response) {
+    if (!isPublicCacheable(response.headers))
+        return response;
+    const setCookies = readSetCookies(response.headers);
+    if (setCookies.length === 0 || !setCookies.some(isStickyCookie))
+        return response;
+    const headers = new Headers(response.headers);
+    headers.delete("set-cookie");
+    for (const setCookie of setCookies) {
+        if (!isStickyCookie(setCookie))
+            headers.append("Set-Cookie", setCookie);
+    }
+    return new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}

package/esm/src/release-assets/constants.d.ts

@@ -20,6 +20,10 @@ export declare const RELEASE_ASSET_CONTENT_TYPE_ALLOWLIST: readonly ReleaseAsset
 export declare const RELEASE_ASSET_MAX_SIZE_BYTES: number;
 /** Immutable cache max-age in seconds (1 year). */
 export declare const RELEASE_ASSET_IMMUTABLE_MAX_AGE_SECONDS = 31536000;
+/** Query param that scopes fallback module URLs to an immutable release. */
+export declare const RELEASE_MODULE_VERSION_PARAM: "vf_release";
+/** Query param that scopes fallback module URLs to the Veryfront runtime build. */
+export declare const RELEASE_MODULE_RUNTIME_VERSION_PARAM: "vf_runtime";
 /** Bounded upload concurrency when posting assets during a build. */
 export declare const RELEASE_ASSET_UPLOAD_CONCURRENCY = 8;
 /** Env flag that enables HTML manifest consumption in production (default OFF). */

package/esm/src/release-assets/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/src/release-assets/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4CAA4C;AAC5C,eAAO,MAAM,qCAAqC,EAAG,CAAU,CAAC;AAEhE,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,EAAG,aAAsB,CAAC;AAE9D,kDAAkD;AAClD,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAC7E,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,qBAAqB,CAAC,CAAC;AAElG,0EAA0E;AAC1E,eAAO,MAAM,oCAAoC,EAAE,SAAS,uBAAuB,EAGlF,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,4BAA4B,QAAmB,CAAC;AAE7D,mDAAmD;AACnD,eAAO,MAAM,uCAAuC,WAAa,CAAC;AAElE,qEAAqE;AACrE,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,mFAAmF;AACnF,eAAO,MAAM,+BAA+B,qCAAqC,CAAC;AAElF,mFAAmF;AACnF,eAAO,MAAM,4CAA4C,kDACR,CAAC;AAElD,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,MAAM,CAE7F;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB,uBAAuB,GAAG,IAAI,CAIhC;AAED,6EAA6E;AAC7E,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,KAAK,IAAI,uBAAuB,CAIlC;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/src/release-assets/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4CAA4C;AAC5C,eAAO,MAAM,qCAAqC,EAAG,CAAU,CAAC;AAEhE,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,EAAG,aAAsB,CAAC;AAE9D,kDAAkD;AAClD,eAAO,MAAM,2BAA2B;;;CAG9B,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,MAAM,OAAO,2BAA2B,CAAC;AAC7E,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,qBAAqB,CAAC,CAAC;AAElG,0EAA0E;AAC1E,eAAO,MAAM,oCAAoC,EAAE,SAAS,uBAAuB,EAGlF,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,4BAA4B,QAAmB,CAAC;AAE7D,mDAAmD;AACnD,eAAO,MAAM,uCAAuC,WAAa,CAAC;AAElE,4EAA4E;AAC5E,eAAO,MAAM,4BAA4B,EAAG,YAAqB,CAAC;AAElE,mFAAmF;AACnF,eAAO,MAAM,oCAAoC,EAAG,YAAqB,CAAC;AAE1E,qEAAqE;AACrE,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD,mFAAmF;AACnF,eAAO,MAAM,+BAA+B,qCAAqC,CAAC;AAElF,mFAAmF;AACnF,eAAO,MAAM,4CAA4C,kDACR,CAAC;AAElD,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,MAAM,CAE7F;AAED,yEAAyE;AACzE,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,GAChB,uBAAuB,GAAG,IAAI,CAIhC;AAED,6EAA6E;AAC7E,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,KAAK,IAAI,uBAAuB,CAIlC;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/esm/src/release-assets/constants.js

@@ -21,6 +21,10 @@ export const RELEASE_ASSET_CONTENT_TYPE_ALLOWLIST = [
 export const RELEASE_ASSET_MAX_SIZE_BYTES = 10 * 1024 * 1024;
 /** Immutable cache max-age in seconds (1 year). */
 export const RELEASE_ASSET_IMMUTABLE_MAX_AGE_SECONDS = 31_536_000;
+/** Query param that scopes fallback module URLs to an immutable release. */
+export const RELEASE_MODULE_VERSION_PARAM = "vf_release";
+/** Query param that scopes fallback module URLs to the Veryfront runtime build. */
+export const RELEASE_MODULE_RUNTIME_VERSION_PARAM = "vf_runtime";
 /** Bounded upload concurrency when posting assets during a build. */
 export const RELEASE_ASSET_UPLOAD_CONCURRENCY = 8;
 /** Env flag that enables HTML manifest consumption in production (default OFF). */

package/esm/src/release-assets/manifest-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest-cache.d.ts","sourceRoot":"","sources":["../../../src/src/release-assets/manifest-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAOH,OAAO,EAA6B,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAmC5F;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAC1B;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAChE,CAAC;CACH;AAKD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,2BAA2B,GACnC,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,2BAA2B,GAAG,SAAS,GAC/C,IAAI,CAMN;AASD,yEAAyE;AACzE,wBAAgB,6BAA6B,IAAI,OAAO,CAKvD;AA6BD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,oBAAoB,GAAG,IAAI,CAoB7B;AAED;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAetC;AAqED,6EAA6E;AAC7E,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD;AAED,uEAAuE;AACvE,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD"}
+{"version":3,"file":"manifest-cache.d.ts","sourceRoot":"","sources":["../../../src/src/release-assets/manifest-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAWH,OAAO,EAA6B,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAmC5F;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAC1B;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAChE,CAAC;CACH;AAKD;;;;;;GAMG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,2BAA2B,GACnC,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,OAAO,EAAE,2BAA2B,GAAG,SAAS,GAC/C,IAAI,CAMN;AASD,yEAAyE;AACzE,wBAAgB,6BAA6B,IAAI,OAAO,CAKvD;AAiCD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,oBAAoB,GAAG,IAAI,CAgC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA4BtC;AA+ED,6EAA6E;AAC7E,wBAAgB,gCAAgC,IAAI,IAAI,CAIvD;AAED,uEAAuE;AACvE,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD"}

package/esm/src/release-assets/manifest-cache.js

@@ -26,6 +26,7 @@ import { serverLogger } from "../utils/index.js";
 import { LRUCache } from "../utils/lru-wrapper.js";
 import { registerLRUCache } from "../cache/index.js";
 import { getHostEnv } from "../platform/compat/process.js";
+import { markRequestProfilePhase, profilePhase, } from "../observability/request-profiler.js";
 import { RELEASE_ASSET_MANIFEST_ENV_FLAG } from "./constants.js";
 import { parseReleaseAssetManifest } from "./manifest-schema.js";
 const logger = serverLogger.component("release-asset-manifest");
@@ -92,6 +93,9 @@ export function isReleaseAssetManifestEnabled() {
 function cacheKey(releaseId, manifestVersion) {
     return manifestVersion !== undefined ? `${releaseId}:${manifestVersion}` : releaseId;
 }
+function markManifestDecision(decision) {
+    markRequestProfilePhase(`release_manifest.${decision}`);
+}
 function findCachedReadyEntry(releaseId) {
     let best = null;
     for (const [k, v] of manifestCache.entries()) {
@@ -121,14 +125,21 @@ function maybeScheduleReadyRefresh(releaseId, entry) {
  * the flag is off or no fetcher is registered for this releaseId.
  */
 export function getReadyManifestForRender(releaseId) {
-    if (!releaseId)
+    if (!releaseId) {
+        markManifestDecision("no_release_id");
         return null;
-    if (!isReleaseAssetManifestEnabled())
+    }
+    if (!isReleaseAssetManifestEnabled()) {
+        markManifestDecision("disabled");
         return null;
-    if (!resolveFetcher(releaseId))
+    }
+    if (!resolveFetcher(releaseId)) {
+        markManifestDecision("no_fetcher");
         return null;
+    }
     const best = findCachedReadyEntry(releaseId);
     if (best) {
+        markManifestDecision("cached_ready");
         maybeScheduleReadyRefresh(releaseId, best);
         return best.manifest;
     }
@@ -136,8 +147,10 @@ export function getReadyManifestForRender(releaseId) {
     const plain = manifestCache.get(releaseId);
     if (plain && plain.expiresAt > Date.now()) {
         // Non-ready entry still warm — return null without scheduling another fetch.
+        markManifestDecision("cached_null");
         return null;
     }
+    markManifestDecision("cache_miss");
     scheduleFetch(releaseId);
     return null;
 }
@@ -150,20 +163,29 @@ export function getReadyManifestForRender(releaseId) {
  * manifest is unavailable, or the fetch fails.
  */
 export async function getReadyManifestForRenderAsync(releaseId) {
-    if (!releaseId)
+    if (!releaseId) {
+        markManifestDecision("no_release_id");
         return null;
-    if (!isReleaseAssetManifestEnabled())
+    }
+    if (!isReleaseAssetManifestEnabled()) {
+        markManifestDecision("disabled");
         return null;
-    if (!resolveFetcher(releaseId))
+    }
+    if (!resolveFetcher(releaseId)) {
+        markManifestDecision("no_fetcher");
         return null;
+    }
     const best = findCachedReadyEntry(releaseId);
     if (best) {
+        markManifestDecision("cached_ready");
         maybeScheduleReadyRefresh(releaseId, best);
         return best.manifest;
     }
     const plain = manifestCache.get(releaseId);
-    if (plain && plain.expiresAt > Date.now())
+    if (plain && plain.expiresAt > Date.now()) {
+        markManifestDecision("cached_null");
         return null;
+    }
     return await fetchManifest(releaseId);
 }
 function scheduleFetch(releaseId) {
@@ -171,19 +193,24 @@ function scheduleFetch(releaseId) {
 }
 function fetchManifest(releaseId) {
     const existing = inFlight.get(releaseId);
-    if (existing)
+    if (existing) {
+        markManifestDecision("await_inflight");
         return existing.promise;
+    }
     const active = resolveFetcher(releaseId);
-    if (!active)
+    if (!active) {
+        markManifestDecision("no_fetcher");
         return Promise.resolve(null);
+    }
     const fetchGeneration = cacheGeneration;
     const token = Symbol(releaseId);
-    const promise = Promise.resolve().then(async () => {
+    const promise = profilePhase("release_manifest.fetch", async () => {
         try {
             const result = await active(releaseId);
             if (fetchGeneration !== cacheGeneration)
                 return null;
             if (!result) {
+                markManifestDecision("fetch_missing");
                 manifestCache.set(releaseId, { manifest: null, expiresAt: Date.now() + NON_READY_TTL_MS });
                 return null;
             }
@@ -191,6 +218,7 @@ function fetchManifest(releaseId) {
                 ? parseReleaseAssetManifest(result.manifest)
                 : null;
             if (manifest) {
+                markManifestDecision("fetch_ready");
                 const key = cacheKey(releaseId, manifest.manifestVersion);
                 manifestCache.set(key, {
                     manifest,
@@ -206,6 +234,7 @@ function fetchManifest(releaseId) {
                 return manifest;
             }
             else {
+                markManifestDecision("fetch_not_ready");
                 manifestCache.set(releaseId, {
                     manifest: null,
                     expiresAt: Date.now() + NON_READY_TTL_MS,
@@ -220,6 +249,7 @@ function fetchManifest(releaseId) {
             });
             if (fetchGeneration !== cacheGeneration)
                 return null;
+            markManifestDecision("fetch_failed");
             manifestCache.set(releaseId, { manifest: null, expiresAt: Date.now() + NON_READY_TTL_MS });
             return null;
         }

package/esm/src/rendering/orchestrator/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAuBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA+ChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxE,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;CAC1E;AA0BD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,MAAM,EAAE,oBAAoB;IAaxC;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAKxB,OAAO,CAAC,UAAU;YAIJ,0BAA0B;IAaxC;;;;;;;;;OASG;YACW,qBAAqB;IAyDnC;;;OAGG;YACW,mBAAmB;IAiGjC,OAAO,CAAC,uBAAuB;IAkCzB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA2Q9E,+EAA+E;IACzE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAsFzE,kBAAkB;YA2ClB,cAAc;IAW5B,OAAO,CAAC,uBAAuB;YAYjB,kBAAkB;IA8EhC,OAAO,CAAC,kBAAkB;YAQZ,uBAAuB;IAmBrC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAStB"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/orchestrator/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAwBH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AA+ChF,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACxE,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,wBAAwB,CAAC;IAC3C,YAAY,EAAE,YAAY,CAAC;IAC3B,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,eAAe,CAAC;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,OAAO,qBAAqB,EAAE,sBAAsB,CAAC;CAC1E;AA0BD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,kBAAkB,CAAqB;gBAEnC,MAAM,EAAE,oBAAoB;IAaxC;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAKxB,OAAO,CAAC,UAAU;YAIJ,0BAA0B;IAaxC;;;;;;;;;OASG;YACW,qBAAqB;IAyDnC;;;OAGG;YACW,mBAAmB;IA8GjC,OAAO,CAAC,uBAAuB;IAkCzB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAsS9E,+EAA+E;IACzE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,gBAAgB,CAAC;YAiGzE,kBAAkB;YA2ClB,cAAc;IAW5B,OAAO,CAAC,uBAAuB;YAYjB,kBAAkB;IAyFhC,OAAO,CAAC,kBAAkB;YAQZ,uBAAuB;IAmBrC;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;CAStB"}

package/esm/src/rendering/orchestrator/pipeline.js

@@ -17,6 +17,7 @@ import { rendererLogger as logger } from "../../utils/index.js";
 import { getExtensionName } from "../../utils/path-utils.js";
 import { createBuildVersion } from "../../utils/version.js";
 import { withSpan } from "../../observability/tracing/otlp-setup.js";
+import { profilePhase } from "../../observability/request-profiler.js";
 import { SpanNames } from "../../observability/tracing/span-names.js";
 import { VeryfrontError } from "../../errors/index.js";
 import { FILE_NOT_FOUND, RENDER_ERROR } from "../../errors/error-registry.js";
@@ -178,12 +179,12 @@ export class RenderPipeline {
         if (modulesToLoad.length === 0) {
             return { params, pageProps, layoutProps };
         }
-        const loadedModules = await withSpan(SpanNames.RENDER_LOAD_MODULES, () => withTimeoutThrow(this.loadModulesInParallel(modulesToLoad), MODULE_LOAD_TIMEOUT_MS, `Module loading for ${slug}`), { "render.module_count": modulesToLoad.length });
+        const loadedModules = await profilePhase("render.load_modules", () => withSpan(SpanNames.RENDER_LOAD_MODULES, () => withTimeoutThrow(this.loadModulesInParallel(modulesToLoad), MODULE_LOAD_TIMEOUT_MS, `Module loading for ${slug}`), { "render.module_count": modulesToLoad.length }));
         const dataJobs = loadedModules.filter((m) => hasDataFetchingFunction(m.mod));
         if (dataJobs.length === 0) {
             return { params, pageProps, layoutProps };
         }
-        const dataResults = await withSpan(SpanNames.RENDER_FETCH_DATA, () => withTimeoutThrow(Promise.all(dataJobs.map(async (job) => {
+        const dataResults = await profilePhase("render.fetch_data", () => withSpan(SpanNames.RENDER_FETCH_DATA, () => withTimeoutThrow(Promise.all(dataJobs.map(async (job) => {
             try {
                 const jobPath = job.path;
                 const fetchOptions = {
@@ -197,7 +198,7 @@ export class RenderPipeline {
             catch (error) {
                 return { ...job, result: null, error: error };
             }
-        })), DATA_FETCH_TIMEOUT_MS, `Data fetch for ${slug}`), { "render.data_job_count": dataJobs.length });
+        })), DATA_FETCH_TIMEOUT_MS, `Data fetch for ${slug}`), { "render.data_job_count": dataJobs.length }));
         this.applyFetchedDataResults(slug, dataResults, pageProps, layoutProps);
         return { params, pageProps, layoutProps };
     }
@@ -255,13 +256,13 @@ export class RenderPipeline {
         const renderOnce = () => withSpan("render.page", async () => {
             const { result } = await runWithCSSCollector(async () => {
                 const pageResolveStart = performance.now();
-                const pageInfo = await withSpan("render.resolve_page", () => this.config.pageResolver.resolvePage(slug), { "render.slug": slug });
+                const pageInfo = await profilePhase("render.resolve_page", () => withSpan("render.resolve_page", () => this.config.pageResolver.resolvePage(slug), { "render.slug": slug }));
                 timing.pageResolve = Math.round(performance.now() - pageResolveStart);
                 const sourceFile = extractRelativePathShared(pageInfo.entity.path, this.config.projectDir);
                 try {
                     const skipLayouts = isDotPath(slug, pageInfo.entity.path);
                     const layoutCollectStart = performance.now();
-                    const layoutResult = skipLayouts ? EMPTY_LAYOUT_RESULT : await withSpan("render.collect_layouts", () => this.config.layoutOrchestrator.collectLayouts(pageInfo), { "render.slug": slug });
+                    const layoutResult = skipLayouts ? EMPTY_LAYOUT_RESULT : await profilePhase("render.collect_layouts", () => withSpan("render.collect_layouts", () => this.config.layoutOrchestrator.collectLayouts(pageInfo), { "render.slug": slug }));
                     timing.layoutCollect = Math.round(performance.now() - layoutCollectStart);
                     const layoutPreloadPromise = !skipLayouts && layoutResult.nestedLayouts.length > 0
                         ? this.config.layoutOrchestrator.preloadLayoutModules(layoutResult.nestedLayouts)
@@ -273,7 +274,7 @@ export class RenderPipeline {
                     let layoutDataMap = new Map();
                     const dataFetchStart = performance.now();
                     if (options?.request && options?.url) {
-                        await withSpan("render.data_fetching", async () => {
+                        await profilePhase("render.data_fetching", () => withSpan("render.data_fetching", async () => {
                             try {
                                 const dataResolution = await this.resolveDataFetching(slug, pageInfo.entity.path, layoutResult.nestedLayouts, options);
                                 resolvedParams = dataResolution.params;
@@ -291,7 +292,7 @@ export class RenderPipeline {
                                 });
                                 throw error;
                             }
-                        }, { "render.slug": slug });
+                        }, { "render.slug": slug }));
                     }
                     timing.dataFetch = Math.round(performance.now() - dataFetchStart);
                     const hasResolvedParams = Object.keys(resolvedParams).length > 0;
@@ -305,7 +306,7 @@ export class RenderPipeline {
                         }
                         : options;
                     const bundlePrepStart = performance.now();
-                    const pageBundleResult = await withSpan("render.prepare_bundles", () => this.config.pageRenderer.preparePageBundles(pageInfo, slug, cacheResult?.cachedModule, mergedOptions), { "render.slug": slug });
+                    const pageBundleResult = await profilePhase("render.prepare_bundles", () => withSpan("render.prepare_bundles", () => this.config.pageRenderer.preparePageBundles(pageInfo, slug, cacheResult?.cachedModule, mergedOptions), { "render.slug": slug }));
                     timing.bundlePrep = Math.round(performance.now() - bundlePrepStart);
                     if (pageBundleResult.scriptResult)
                         return pageBundleResult.scriptResult;
@@ -323,13 +324,16 @@ export class RenderPipeline {
                     const headings = pageBundle.headings || [];
                     await layoutPreloadPromise;
                     const layoutApplyStart = performance.now();
-                    const wrappedElement = await withSpan("render.apply_layouts", () => this.config.layoutOrchestrator.applyLayoutsAndWrappers(pageElement, pageInfo, layoutResult.layoutBundle, layoutResult.nestedLayouts, layoutDataMap, options?.url, resolvedParams, mergedFrontmatter, headings, options?.projectSlug), { "render.slug": slug, "render.layout_count": layoutResult.nestedLayouts.length });
+                    const wrappedElement = await profilePhase("render.apply_layouts", () => withSpan("render.apply_layouts", () => this.config.layoutOrchestrator.applyLayoutsAndWrappers(pageElement, pageInfo, layoutResult.layoutBundle, layoutResult.nestedLayouts, layoutDataMap, options?.url, resolvedParams, mergedFrontmatter, headings, options?.projectSlug), {
+                        "render.slug": slug,
+                        "render.layout_count": layoutResult.nestedLayouts.length,
+                    }));
                     timing.layoutApply = Math.round(performance.now() - layoutApplyStart);
                     // Snapshot CSS imports collected during module loading (before SSR rendering).
                     // These are passed to the HTML generator to be included in the output.
                     const collectedCSSImports = getCSSImports();
                     const ssrStart = performance.now();
-                    const ssrResult = await withSpan("render.ssr", () => withTimeoutThrow(this.config.ssrOrchestrator.performSSRRendering(wrappedElement, {
+                    const ssrResult = await profilePhase("render.ssr", () => withSpan("render.ssr", () => withTimeoutThrow(this.config.ssrOrchestrator.performSSRRendering(wrappedElement, {
                         pageInfo,
                         pageBundle,
                         layoutBundle: layoutResult.layoutBundle,
@@ -337,7 +341,7 @@ export class RenderPipeline {
                         collectedMetadata: pageBundleResult.collectedMetadata,
                         slug,
                         cssImports: collectedCSSImports,
-                    }, mergedOptions), SSR_RENDER_TIMEOUT_MS, `SSR rendering for ${slug}`), { "render.slug": slug, "render.delivery": mergedOptions?.delivery || "full" });
+                    }, mergedOptions), SSR_RENDER_TIMEOUT_MS, `SSR rendering for ${slug}`), { "render.slug": slug, "render.delivery": mergedOptions?.delivery || "full" }));
                     timing.ssr = Math.round(performance.now() - ssrStart);
                     if (collectedCSSImports.length > 0) {
                         renderPipelineLog.debug("CSS imports collected for HTML generation", {
@@ -411,24 +415,22 @@ export class RenderPipeline {
         if (this.config.mode === "development") {
             clearSSRModuleCacheForProject(projectId);
         }
-        const pageInfo = await this.config.pageResolver.resolvePage(slug);
+        const pageInfo = await profilePhase("page_data.resolve_page", () => this.config.pageResolver.resolvePage(slug));
         const skipLayouts = isDotPath(slug, pageInfo.entity.path);
-        const layoutResult = skipLayouts
-            ? EMPTY_LAYOUT_RESULT
-            : await this.config.layoutOrchestrator.collectLayouts(pageInfo);
+        const layoutResult = skipLayouts ? EMPTY_LAYOUT_RESULT : await profilePhase("page_data.collect_layouts", () => this.config.layoutOrchestrator.collectLayouts(pageInfo));
         const pagePath = extractRelativePathShared(pageInfo.entity.path, this.config.projectDir);
         const fileExtension = getExtensionName(pageInfo.entity.path);
         const pageType = fileExtension;
-        const dataResolution = await this.resolveDataFetching(slug, pageInfo.entity.path, layoutResult.nestedLayouts, options);
+        const dataResolution = await profilePhase("page_data.resolve_data", () => this.resolveDataFetching(slug, pageInfo.entity.path, layoutResult.nestedLayouts, options));
         const pageProps = dataResolution.pageProps;
         const params = dataResolution.params;
         const layoutProps = serializeLayoutProps(dataResolution.layoutProps);
-        const { frontmatter, headings } = await this.extractMdxMetadata(pageType, pageInfo, slug, options, params);
+        const { frontmatter, headings } = await profilePhase("page_data.extract_mdx_metadata", () => this.extractMdxMetadata(pageType, pageInfo, slug, options, params));
         const layouts = serializeLayouts(layoutResult.nestedLayouts, this.config.projectDir);
         const providers = [];
         const projectUpdatedAt = this.resolveProjectUpdatedAt();
-        const appPath = await this.resolveAppPath();
-        const { css, cssAction, cssError } = await this.resolvePageDataCss(slug, options, projectUpdatedAt);
+        const appPath = await profilePhase("page_data.resolve_app_path", () => this.resolveAppPath());
+        const { css, cssAction, cssError } = await profilePhase("page_data.resolve_css", () => this.resolvePageDataCss(slug, options, projectUpdatedAt));
         resolvePageDataLog.debug("Resolved page data", {
             slug,
             pagePath,
@@ -515,17 +517,17 @@ export class RenderPipeline {
             return { css: cachedCss, cssAction: undefined, cssError: undefined };
         }
         try {
-            const renderResult = await withTimeout(this.renderPage(slug, {
+            const renderResult = await profilePhase("page_data.css.render_html", () => withTimeout(this.renderPage(slug, {
                 ...options,
                 delivery: "string",
                 skipCacheCheck: true,
                 skipCachePersist: true,
-            }), CSS_SSR_TIMEOUT_MS, `CSS SSR for ${slug}`);
+            }), CSS_SSR_TIMEOUT_MS, `CSS SSR for ${slug}`));
             if (!renderResult?.html) {
                 return { css: undefined, cssAction: undefined, cssError: undefined };
             }
             let cssAction;
-            let css = await this.resolveCssFromRenderedHtml(renderResult.html, options?.projectSlug ?? options?.projectId);
+            let css = await profilePhase("page_data.css.extract_from_html", () => this.resolveCssFromRenderedHtml(renderResult.html, options?.projectSlug ?? options?.projectId));
             if (css) {
                 resolvePageDataLog.debug("Reused SSR CSS for page data", {
                     slug,
@@ -540,7 +542,7 @@ export class RenderPipeline {
                 });
             }
             else {
-                css = await this.generatePageCssFromHtml(slug, renderResult.html, options);
+                css = await profilePhase("page_data.css.generate_from_html", () => this.generatePageCssFromHtml(slug, renderResult.html, options));
             }
             if (css)
                 cachePageCss(cssCacheKey, css);

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

@@ -1,3 +1,3 @@
 /** Shared version value. */
-export declare const VERSION = "0.1.831";
+export declare const VERSION = "0.1.833";
 //# 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.831";
+export const VERSION = "0.1.833";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.831",
+  "version": "0.1.833",
   "description": "The simplest way to build AI-powered apps",
   "keywords": [
     "react",