veryfront 0.1.831 → 0.1.832

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.1.831",
+    "version": "0.1.832",
     "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/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/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.832";
 //# 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.832";

package/package.json

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