veryfront 0.1.111 → 0.1.113

package/esm/src/transforms/mdx/esm-module-loader/cache-format.js

@@ -1,15 +1,17 @@
 import { hashCodeHex } from "../../../utils/hash-utils.js";
 import { createCacheNamespace } from "../../../utils/cache-namespace.js";
+import { REACT_DEFAULT_VERSION } from "../../../utils/constants/cdn.js";
+import { VERSION } from "../../../utils/version.js";
 import { UNRESOLVED_VF_MODULES_PATTERN } from "./constants.js";
 import { hashString } from "./utils/hash.js";
 const ALL_FILE_URL_PATTERN_SOURCE = /file:\/\/([^"'\s]+)/.source;
 const MJS_FILE_URL_PATTERN_SOURCE = /file:\/\/([^"'\s]+\.mjs)/.source;
 const CACHE_NAMESPACE_SENTINEL = "__vf_cache_namespace__";
-function formatMdxEsmTransformCacheKey(namespace, projectId, contentSourceId, normalizedPath, contentHash) {
-    return `${namespace}:${projectId}:${contentSourceId}:${normalizedPath}:${contentHash}:ssr`;
+function formatMdxEsmTransformCacheKey(namespace, projectId, contentSourceId, reactVersion, normalizedPath, contentHash) {
+    return `${namespace}:${projectId}:${contentSourceId}:${reactVersion}:${normalizedPath}:${contentHash}:ssr`;
 }
-function formatMdxEsmPathCacheKey(namespace, normalizedPath) {
-    return `${namespace}:${normalizedPath}`;
+function formatMdxEsmPathCacheKey(namespace, reactVersion, normalizedPath) {
+    return `${namespace}:${reactVersion}:${normalizedPath}`;
 }
 function formatMdxEsmModuleFileName(namespace, contentHash) {
     return `vfmod-${namespace}-${contentHash}.mjs`;
@@ -25,8 +27,8 @@ function formatFrameworkVfModuleCacheFileName(namespace, pathHash, envKey, conte
 }
 function buildMdxEsmCacheSchemaSample() {
     return {
-        transformKey: formatMdxEsmTransformCacheKey(CACHE_NAMESPACE_SENTINEL, "__vf_project__", "preview-main", "_vf_modules/pages/index.js", "deadbeef"),
-        pathKey: formatMdxEsmPathCacheKey(CACHE_NAMESPACE_SENTINEL, "_vf_modules/pages/index.js"),
+        transformKey: formatMdxEsmTransformCacheKey(CACHE_NAMESPACE_SENTINEL, "__vf_project__", "preview-main", "19.1.1", "_vf_modules/pages/index.js", "deadbeef"),
+        pathKey: formatMdxEsmPathCacheKey(CACHE_NAMESPACE_SENTINEL, REACT_DEFAULT_VERSION, "_vf_modules/pages/index.js"),
         moduleFile: formatMdxEsmModuleFileName(CACHE_NAMESPACE_SENTINEL, "deadbeef"),
         moduleRecoveryKey: formatMdxEsmModuleRecoveryCacheKey(CACHE_NAMESPACE_SENTINEL, "__vf_project__", "preview-main", formatMdxEsmModuleFileName(CACHE_NAMESPACE_SENTINEL, "deadbeef")),
         jsxFile: formatMdxJsxCacheFileName(CACHE_NAMESPACE_SENTINEL, "/tmp/project/Button.tsx"),
@@ -37,6 +39,7 @@ function buildMdxEsmCacheSchemaSample() {
             hashString("_vf_modules/pages/index.jsexport default 1;"),
             hashString("/tmp/project/Button.tsx"),
         ],
+        frameworkVersion: VERSION,
     };
 }
 function buildFrameworkVfModuleCacheSchemaSample() {
@@ -48,11 +51,11 @@ export const MDX_ESM_ALL_FILE_URL_PATTERN_SOURCE = ALL_FILE_URL_PATTERN_SOURCE;
 export const MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE = MJS_FILE_URL_PATTERN_SOURCE;
 export const MDX_ESM_CACHE_NAMESPACE = createCacheNamespace("mdx-esm", buildMdxEsmCacheSchemaSample());
 export const FRAMEWORK_VF_MODULE_CACHE_NAMESPACE = createCacheNamespace("vf-framework", buildFrameworkVfModuleCacheSchemaSample());
-export function buildMdxEsmTransformCacheKey(projectId, contentSourceId, normalizedPath, contentHash) {
-    return formatMdxEsmTransformCacheKey(MDX_ESM_CACHE_NAMESPACE, projectId, contentSourceId, normalizedPath, contentHash);
+export function buildMdxEsmTransformCacheKey(projectId, contentSourceId, reactVersion, normalizedPath, contentHash) {
+    return formatMdxEsmTransformCacheKey(MDX_ESM_CACHE_NAMESPACE, projectId, contentSourceId, reactVersion, normalizedPath, contentHash);
 }
-export function buildMdxEsmPathCacheKey(normalizedPath) {
-    return formatMdxEsmPathCacheKey(MDX_ESM_CACHE_NAMESPACE, normalizedPath);
+export function buildMdxEsmPathCacheKey(normalizedPath, reactVersion = REACT_DEFAULT_VERSION) {
+    return formatMdxEsmPathCacheKey(MDX_ESM_CACHE_NAMESPACE, reactVersion, normalizedPath);
 }
 export function buildMdxEsmModuleFileName(contentHash) {
     return formatMdxEsmModuleFileName(MDX_ESM_CACHE_NAMESPACE, contentHash);

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/cache-keys.d.ts

@@ -10,6 +10,6 @@
  * CRITICAL: The :ssr suffix is required to avoid cache collisions with browser-mode transforms
  * that use relative paths (../lib/utils.js) instead of absolute paths (/_vf_modules/lib/utils.js).
  */
-export declare function getTransformCacheKey(projectId: string, contentSourceId: string, normalizedPath: string, contentHash: string): string;
-export declare function getVersionedPathCacheKey(normalizedPath: string): string;
+export declare function getTransformCacheKey(projectId: string, contentSourceId: string, reactVersion: string, normalizedPath: string, contentHash: string): string;
+export declare function getVersionedPathCacheKey(normalizedPath: string, reactVersion: string): string;
 //# sourceMappingURL=cache-keys.d.ts.map

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/cache-keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-keys.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/cache-keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER;AAED,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAEvE"}
+{"version":3,"file":"cache-keys.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/cache-keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR;AAED,wBAAgB,wBAAwB,CAAC,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE7F"}

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/cache-keys.js

@@ -11,9 +11,9 @@ import { buildMdxEsmPathCacheKey, buildMdxEsmTransformCacheKey } from "../cache-
  * CRITICAL: The :ssr suffix is required to avoid cache collisions with browser-mode transforms
  * that use relative paths (../lib/utils.js) instead of absolute paths (/_vf_modules/lib/utils.js).
  */
-export function getTransformCacheKey(projectId, contentSourceId, normalizedPath, contentHash) {
-    return buildMdxEsmTransformCacheKey(projectId, contentSourceId, normalizedPath, contentHash);
+export function getTransformCacheKey(projectId, contentSourceId, reactVersion, normalizedPath, contentHash) {
+    return buildMdxEsmTransformCacheKey(projectId, contentSourceId, reactVersion, normalizedPath, contentHash);
 }
-export function getVersionedPathCacheKey(normalizedPath) {
-    return buildMdxEsmPathCacheKey(normalizedPath);
+export function getVersionedPathCacheKey(normalizedPath, reactVersion) {
+    return buildMdxEsmPathCacheKey(normalizedPath, reactVersion);
 }

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/framework-validator.d.ts

@@ -20,9 +20,8 @@ interface MdxRecoveryOptions {
  * 2. HTTP bundle cache paths (file:///app/.cache/veryfront-http-bundle/...) that don't match local cache dir
  * 3. MDX ESM cache paths (file:///app/.cache/veryfront-mdx-esm/...) that don't match local cache dir
  *
- * IMPORTANT: This function creates a new RegExp on each call to avoid race conditions
- * when multiple modules are processed concurrently. Using a shared global regex with
- * the 'g' flag would cause interleaved exec() calls to skip paths.
+ * This check also walks transitively imported VF modules so nested stale paths
+ * are rejected before import-time failures.
  */
 export declare function hasIncompatibleFrameworkPaths(code: string, log: Logger): Promise<boolean>;
 /**

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/framework-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-validator.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/framework-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AASjE,UAAU,kBAAkB;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAqE/F;AAED;;;;;;GAMG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAYD,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,kBAAkB,GACnC,OAAO,CAAC,OAAO,CAAC,CAgFlB"}
+{"version":3,"file":"framework-validator.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/framework-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAiBjE,UAAU,kBAAkB;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAkGD;;;;;;;;;;;GAWG;AACH,wBAAsB,6BAA6B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAsB/F;AAED;;;;;;GAMG;AACH,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB;AAYD,wBAAsB,oBAAoB,CACxC,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,YAAY,EAAE,MAAM,EACpB,eAAe,CAAC,EAAE,kBAAkB,GACnC,OAAO,CAAC,OAAO,CAAC,CAgFlB"}

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/framework-validator.js

@@ -6,90 +6,119 @@
  *
  * @module transforms/mdx/esm-module-loader/module-fetcher/framework-validator
  */
-import { getHttpBundleCacheDir, getMdxEsmCacheDir } from "../../../../utils/cache-dir.js";
+import { extractAllFilePaths, extractAllFilePathsRecursive, extractAllHttpBundlePathsRecursive, visitImportedVfModules, } from "../../../../modules/react-loader/ssr-module-loader/http-bundle-helpers.js";
+import { getCacheBaseDir, getHttpBundleCacheDir, getMdxEsmCacheDir, } from "../../../../utils/cache-dir.js";
 import { FRAMEWORK_ROOT, LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { getLocalFs } from "../cache/index.js";
-import { extractHttpBundlePaths } from "../../../../modules/react-loader/ssr-module-loader/http-bundle-helpers.js";
 import { ensureHttpBundlesExist } from "../../../esm/http-cache.js";
-import { MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE } from "../cache-format.js";
 import { ensureMdxModuleDependencies } from "./dependency-recovery.js";
-/**
- * Check if cached code has file:// paths that are incompatible with this environment.
- * Returns true if the cached code should be invalidated (has paths from a different environment).
- *
- * Checks for:
- * 1. Framework source paths (file:///app/src/...) that don't match FRAMEWORK_ROOT
- * 2. HTTP bundle cache paths (file:///app/.cache/veryfront-http-bundle/...) that don't match local cache dir
- * 3. MDX ESM cache paths (file:///app/.cache/veryfront-mdx-esm/...) that don't match local cache dir
- *
- * IMPORTANT: This function creates a new RegExp on each call to avoid race conditions
- * when multiple modules are processed concurrently. Using a shared global regex with
- * the 'g' flag would cause interleaved exec() calls to skip paths.
- */
-export async function hasIncompatibleFrameworkPaths(code, log) {
-    // Check for esm.sh URLs that reference /_vf_modules/ paths - these are invalid
-    // and indicate a cached transform from before the fix was deployed
-    if (/esm\.sh\/_?vf_modules\//.test(code)) {
-        log.debug(`${LOG_PREFIX_MDX_LOADER} Cached code has invalid esm.sh/_vf_modules URL`);
-        return true;
-    }
-    const localHttpCacheDir = getHttpBundleCacheDir();
-    const localMdxCacheDir = getMdxEsmCacheDir();
+const INVALID_VFMOD_ESM_URL_PATTERN = /esm\.sh\/_?vf_modules\//;
+async function hasIncompatibleFrameworkPathsInCode(code, log, options) {
     const localFs = getLocalFs();
-    // Create a NEW regex for each call to avoid race conditions with concurrent calls.
-    // Global regexes maintain lastIndex state that can interleave between concurrent calls.
-    const allFilePathsPattern = /file:\/\/([^"'\s]+)/gi;
-    const allPaths = [];
-    let match;
-    while ((match = allFilePathsPattern.exec(code)) !== null) {
-        if (match[1])
-            allPaths.push(match[1]);
+    const sourceContext = options.sourcePath ? { vfModulePath: options.sourcePath } : {};
+    if (INVALID_VFMOD_ESM_URL_PATTERN.test(code)) {
+        log.debug(`${LOG_PREFIX_MDX_LOADER} Cached code has invalid esm.sh/_vf_modules URL`, sourceContext);
+        return true;
     }
+    const allPaths = extractAllFilePaths(code);
     for (const path of allPaths) {
         if (path.includes("veryfront-http-bundle")) {
-            if (!path.startsWith(localHttpCacheDir)) {
+            if (!path.startsWith(options.localHttpCacheDir)) {
                 log.debug(`${LOG_PREFIX_MDX_LOADER} HTTP bundle path from different environment`, {
                     path,
-                    expectedDir: localHttpCacheDir,
+                    expectedDir: options.localHttpCacheDir,
+                    ...sourceContext,
                 });
                 return true;
             }
             continue;
         }
         if (path.includes("veryfront-mdx-esm")) {
-            if (!path.startsWith(localMdxCacheDir)) {
+            if (!path.startsWith(options.localMdxCacheDir)) {
                 log.debug(`${LOG_PREFIX_MDX_LOADER} MDX cache path from different environment`, {
                     path,
-                    expectedDir: localMdxCacheDir,
+                    expectedDir: options.localMdxCacheDir,
+                    ...sourceContext,
                 });
                 return true;
             }
             continue;
         }
+        // Legacy cache entries sometimes point directly at pod-local .cache source files
+        // like file:///app/.cache/markdown.tsx. These paths are not portable across pods.
+        // Allow local cache-base paths so valid local file:// dependencies under .cache
+        // are not evicted on every read.
+        if (path.includes(".cache/") && !path.startsWith(options.localCacheBaseDir)) {
+            log.debug(`${LOG_PREFIX_MDX_LOADER} Legacy cache path is not portable`, {
+                path,
+                expectedBaseDir: options.localCacheBaseDir,
+                ...sourceContext,
+            });
+            return true;
+        }
         if (!path.includes("/src/") || path.includes(".cache"))
             continue;
         if (!path.startsWith(FRAMEWORK_ROOT)) {
             log.debug(`${LOG_PREFIX_MDX_LOADER} Framework path from different environment`, {
                 path,
                 expectedRoot: FRAMEWORK_ROOT,
+                ...sourceContext,
             });
             return true;
         }
         try {
             const stat = await localFs.stat(path);
             if (!stat?.isFile) {
-                log.debug(`${LOG_PREFIX_MDX_LOADER} Framework path does not exist`, { path });
+                log.debug(`${LOG_PREFIX_MDX_LOADER} Framework path does not exist`, {
+                    path,
+                    ...sourceContext,
+                });
                 return true;
             }
         }
         catch (_) {
             /* expected: framework file may not exist in this environment */
-            log.debug(`${LOG_PREFIX_MDX_LOADER} Framework path not accessible`, { path });
+            log.debug(`${LOG_PREFIX_MDX_LOADER} Framework path not accessible`, {
+                path,
+                ...sourceContext,
+            });
             return true;
         }
     }
     return false;
 }
+/**
+ * Check if cached code has file:// paths that are incompatible with this environment.
+ * Returns true if the cached code should be invalidated (has paths from a different environment).
+ *
+ * Checks for:
+ * 1. Framework source paths (file:///app/src/...) that don't match FRAMEWORK_ROOT
+ * 2. HTTP bundle cache paths (file:///app/.cache/veryfront-http-bundle/...) that don't match local cache dir
+ * 3. MDX ESM cache paths (file:///app/.cache/veryfront-mdx-esm/...) that don't match local cache dir
+ *
+ * This check also walks transitively imported VF modules so nested stale paths
+ * are rejected before import-time failures.
+ */
+export async function hasIncompatibleFrameworkPaths(code, log) {
+    const options = {
+        localHttpCacheDir: getHttpBundleCacheDir(),
+        localMdxCacheDir: getMdxEsmCacheDir(),
+        localCacheBaseDir: getCacheBaseDir(),
+    };
+    if (await hasIncompatibleFrameworkPathsInCode(code, log, options)) {
+        return true;
+    }
+    let incompatible = false;
+    await visitImportedVfModules(code, async (vfModuleCode, vfModulePath) => {
+        if (incompatible)
+            return;
+        incompatible = await hasIncompatibleFrameworkPathsInCode(vfModuleCode, log, {
+            ...options,
+            sourcePath: vfModulePath,
+        });
+    });
+    return incompatible;
+}
 /**
  * Check if cached code has file:// paths that don't exist locally.
  * Returns list of missing paths, or empty array if all exist.
@@ -99,17 +128,9 @@ export async function hasIncompatibleFrameworkPaths(code, log) {
  */
 export async function findMissingFileDependenciesInCode(code, log) {
     const localFs = getLocalFs();
-    const pattern = new RegExp(MDX_ESM_MJS_FILE_URL_PATTERN_SOURCE, "gi");
     const missing = [];
-    const checked = new Set();
-    let match;
-    while ((match = pattern.exec(code)) !== null) {
-        const path = match[1];
-        // Skip query parameters in paths
-        const cleanPath = path.replace(/\?.*$/, "");
-        if (checked.has(cleanPath))
-            continue;
-        checked.add(cleanPath);
+    const allPaths = await extractAllFilePathsRecursive(code);
+    for (const cleanPath of allPaths) {
         try {
             const stat = await localFs.stat(cleanPath);
             if (!stat?.isFile) {
@@ -151,7 +172,7 @@ export async function validateCachedModule(normalizedPath, cachedPath, cachedCod
         }
         return false;
     }
-    const bundlePaths = extractHttpBundlePaths(cachedCode);
+    const bundlePaths = await extractAllHttpBundlePathsRecursive(cachedCode);
     if (bundlePaths.length > 0) {
         const cacheDir = getHttpBundleCacheDir();
         const failed = await ensureHttpBundlesExist(bundlePaths, cacheDir);

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAM5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAexD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAS5E;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAOtD;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,SAAS,EAAE,MAAM;CAI9B;AAcD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,EAC7B,gBAAgB,CAAC,EAAE,MAAM,EACzB,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwFxB;AAqRD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GACA,oBAAoB,CAUtB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAO5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAexD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAS5E;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAOtD;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;gBAC1C,SAAS,EAAE,MAAM;CAI9B;AAcD;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,EAC7B,gBAAgB,CAAC,EAAE,MAAM,EACzB,OAAO,GAAE,GAAG,CAAC,MAAM,CAAa,GAC/B,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAwFxB;AAoSD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,EACvB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;IACR,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GACA,oBAAoB,CAUtB"}

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/index.js

@@ -16,6 +16,7 @@ import { transformToESM } from "../../../esm-transform.js";
 import { cacheHttpImportsToLocal } from "../../../esm/http-cache.js";
 import { loadImportMap } from "../../../../modules/import-map/index.js";
 import { getHttpBundleCacheDir } from "../../../../utils/cache-dir.js";
+import { REACT_DEFAULT_VERSION } from "../../../../utils/constants/cdn.js";
 import { LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { getLocalFs, getModulePathCache } from "../cache/index.js";
 import { hashString } from "../utils/hash.js";
@@ -149,8 +150,9 @@ export async function fetchAndCacheModule(modulePath, context, parentModulePath,
 async function doFetchAndCacheModule(normalizedPath, context, fetchAndCacheModuleFn, projectSlug, parentModulePath) {
     const log = getLog(context);
     const { esmCacheDir, adapter, projectDir, projectId, contentSourceId } = context;
+    const effectiveReactVersion = context.reactVersion ?? REACT_DEFAULT_VERSION;
     const pathCache = await getModulePathCache(esmCacheDir);
-    const versionedKey = getVersionedPathCacheKey(normalizedPath);
+    const versionedKey = getVersionedPathCacheKey(normalizedPath, effectiveReactVersion);
     const cachedPath = pathCache.get(versionedKey);
     if (cachedPath) {
         try {
@@ -178,7 +180,7 @@ async function doFetchAndCacheModule(normalizedPath, context, fetchAndCacheModul
         if (!resolved) {
             const moduleCode = await fetchModuleViaHTTP(normalizedPath, adapter, fetchAndCacheModuleFn, log, projectSlug, context.isLocalProject);
             if (moduleCode) {
-                return await cacheModule(normalizedPath, moduleCode, esmCacheDir, pathCache, log);
+                return await cacheModule(normalizedPath, moduleCode, esmCacheDir, pathCache, log, effectiveReactVersion);
             }
             if (context.strictMissingModules ?? true) {
                 throw buildMissingModuleError({
@@ -192,7 +194,7 @@ async function doFetchAndCacheModule(normalizedPath, context, fetchAndCacheModul
         const { sourceCode, actualFilePath } = resolved;
         const contentHash = hashString(sourceCode);
         const transformCacheKey = contentSourceId
-            ? getTransformCacheKey(projectId, contentSourceId, normalizedPath, contentHash)
+            ? getTransformCacheKey(projectId, contentSourceId, effectiveReactVersion, normalizedPath, contentHash)
             : null;
         let moduleCode = null;
         let needsDistributedCacheWrite = false;
@@ -200,7 +202,7 @@ async function doFetchAndCacheModule(normalizedPath, context, fetchAndCacheModul
         // Returns null only if no distributed backend is configured.
         // Otherwise returns { code, distributedCache } where code may be null (miss).
         const distResult = transformCacheKey
-            ? await readDistributedCache(transformCacheKey, projectId, contentSourceId, normalizedPath, projectSlug, projectDir, context.reactVersion, log)
+            ? await readDistributedCache(transformCacheKey, projectId, contentSourceId, normalizedPath, projectSlug, projectDir, effectiveReactVersion, log)
             : null;
         if (distResult?.code) {
             moduleCode = distResult.code;
@@ -316,7 +318,7 @@ async function doFetchAndCacheModule(normalizedPath, context, fetchAndCacheModul
             normalizedPath,
         });
         const cacheStart = performance.now();
-        const finalCachedPath = await cacheModule(normalizedPath, moduleCode, esmCacheDir, pathCache, log);
+        const finalCachedPath = await cacheModule(normalizedPath, moduleCode, esmCacheDir, pathCache, log, effectiveReactVersion);
         log.debug(`${LOG_PREFIX_MDX_LOADER} [fetchAndCacheModule] cacheModule DONE`, {
             projectSlug,
             normalizedPath,

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/module-cache.d.ts

@@ -18,5 +18,5 @@ export declare function normalizePath(modulePath: string, parentModulePath?: str
  * dependency resolution). Otherwise writes to the local filesystem cache
  * and updates the path cache map.
  */
-export declare function cacheModule(normalizedPath: string, moduleCode: string, esmCacheDir: string, pathCache: Map<string, string>, log: Logger): Promise<string | null>;
+export declare function cacheModule(normalizedPath: string, moduleCode: string, esmCacheDir: string, pathCache: Map<string, string>, log: Logger, reactVersion?: string): Promise<string | null>;
 //# sourceMappingURL=module-cache.d.ts.map

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/module-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-cache.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/module-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAQjE;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAanF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmCxB"}
+{"version":3,"file":"module-cache.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/module-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AASjE;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAanF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC/B,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,YAAY,SAAwB,GACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmCxB"}

package/esm/src/transforms/mdx/esm-module-loader/module-fetcher/module-cache.js

@@ -8,6 +8,7 @@
  */
 import { join } from "../../../../platform/compat/path/index.js";
 import * as posix from "../../../../../deps/jsr.io/@std/path/1.1.4/posix/mod.js";
+import { REACT_DEFAULT_VERSION } from "../../../../utils/constants/cdn.js";
 import { LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { getLocalFs, saveModulePathCache } from "../cache/index.js";
 import { hashString } from "../utils/hash.js";
@@ -38,7 +39,7 @@ export function normalizePath(modulePath, parentModulePath) {
  * dependency resolution). Otherwise writes to the local filesystem cache
  * and updates the path cache map.
  */
-export async function cacheModule(normalizedPath, moduleCode, esmCacheDir, pathCache, log) {
+export async function cacheModule(normalizedPath, moduleCode, esmCacheDir, pathCache, log, reactVersion = REACT_DEFAULT_VERSION) {
     const unresolved = hasUnresolvedImports(moduleCode);
     if (unresolved.count > 0) {
         log.warn(`${LOG_PREFIX_MDX_LOADER} Module has ${unresolved.count} unresolved imports, skipping cache`, { path: normalizedPath, unresolved: unresolved.paths });
@@ -46,7 +47,7 @@ export async function cacheModule(normalizedPath, moduleCode, esmCacheDir, pathC
     }
     const contentHash = hashString(normalizedPath + moduleCode);
     const cachePath = join(esmCacheDir, buildMdxEsmModuleFileName(contentHash));
-    const pathCacheKey = buildMdxEsmPathCacheKey(normalizedPath);
+    const pathCacheKey = buildMdxEsmPathCacheKey(normalizedPath, reactVersion);
     const localFs = getLocalFs();
     try {
         const stat = await localFs.stat(cachePath);

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

@@ -1,4 +1,4 @@
-export declare const VERSION = "0.1.111";
+export declare const VERSION = "0.1.113";
 export declare function normalizeVeryfrontVersion(version: string | undefined): string | undefined;
 export declare function resolveRuntimeVersion(options?: {
     veryfrontVersion?: string;

package/esm/src/utils/version.js

@@ -2,7 +2,7 @@ import denoConfig from "../../deno.js";
 import { getEnv } from "../platform/compat/process.js";
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.111";
+export const VERSION = "0.1.113";
 export function normalizeVeryfrontVersion(version) {
     if (!version)
         return undefined;

package/package.json

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

package/src/cli/auth/login.ts

@@ -8,6 +8,7 @@ import { canOpenBrowser, openBrowser } from "./browser.js";
 import { isTTY, promptUser } from "../utils/index.js";
 import { brand, dim, error, muted, success, warning } from "../ui/colors.js";
 import { DEFAULT_LOGIN_TIMEOUT_MS, getApiUrl } from "../shared/constants.js";
+import { createSuccessEnvelope, isJsonMode, outputJson } from "../shared/json-output.js";
 
 export type AuthMethod = "google" | "github" | "microsoft" | "token";
 
@@ -251,6 +252,10 @@ export async function whoami(
   if (env.apiToken) {
     const userInfo = await validateToken(env.apiToken);
     if (userInfo) {
+      if (isJsonMode()) {
+        await outputJson(createSuccessEnvelope("whoami", { ...userInfo, source: "env" }));
+        return userInfo;
+      }
       console.log();
       console.log("  " + success("✓") + " Logged in as " + brand(userInfo.email));
       console.log("  " + dim("(via VERYFRONT_API_TOKEN)"));
@@ -262,6 +267,10 @@ export async function whoami(
   if (storedToken) {
     const userInfo = await validateToken(storedToken);
     if (userInfo) {
+      if (isJsonMode()) {
+        await outputJson(createSuccessEnvelope("whoami", { ...userInfo, source: "token-store" }));
+        return userInfo;
+      }
       console.log();
       console.log("  " + success("✓") + " Logged in as " + brand(userInfo.email));
       console.log("  " + dim(`Token stored at: ${getTokenLocation()}`));
@@ -269,6 +278,11 @@ export async function whoami(
     }
   }
 
+  if (isJsonMode()) {
+    await outputJson(createSuccessEnvelope("whoami", { authenticated: false }));
+    return null;
+  }
+
   console.log();
   console.log("  " + warning("✗") + " Not logged in");
   console.log("  " + dim("Run 'veryfront login' to authenticate"));

package/src/cli/commands/analyze-chunks/command-help.ts

@@ -2,6 +2,7 @@ import type { CommandHelp } from "../../help/types.js";
 
 export const analyzeChunksHelp: CommandHelp = {
   name: "analyze-chunks",
+  category: "development",
   description: "Analyze bundle chunks and sizes",
   usage: "veryfront analyze-chunks [options]",
   options: [

package/src/cli/commands/build/command-help.ts

@@ -2,6 +2,7 @@ import type { CommandHelp } from "../../help/types.js";
 
 export const buildHelp: CommandHelp = {
   name: "build",
+  category: "development",
   description: "Build your application for production",
   usage: "veryfront build [options]",
   options: [

package/src/cli/commands/build/command.ts

@@ -7,6 +7,7 @@ import { displayBuildConfig, displayBuildStart } from "./config-display.js";
 import { handleBuildError } from "./error-handler.js";
 import { displayBuildSuccess } from "./stats-display.js";
 import type { BuildOptions } from "./types.js";
+import { isJsonMode, streamJsonLine } from "../../shared/json-output.js";
 
 export function buildCommand(options: BuildOptions): Promise<void> {
   return withSpan(
@@ -17,12 +18,21 @@ export function buildCommand(options: BuildOptions): Promise<void> {
       const dryRun = options.dryRun ?? false;
 
       try {
-        displayBuildConfig({ ...options, outputDir });
+        if (isJsonMode()) {
+          streamJsonLine({ type: "step", name: "config", status: "started" });
+        } else {
+          displayBuildConfig({ ...options, outputDir });
+        }
 
         const adapter = await runtime.get();
         await getConfig(options.projectDir, adapter);
 
-        displayBuildStart();
+        if (isJsonMode()) {
+          streamJsonLine({ type: "step", name: "config", status: "completed" });
+          streamJsonLine({ type: "step", name: "build", status: "started" });
+        } else {
+          displayBuildStart();
+        }
 
         const stats = await buildProduction({
           projectDir: options.projectDir,
@@ -36,8 +46,43 @@ export function buildCommand(options: BuildOptions): Promise<void> {
           dryRun,
         });
 
+        const elapsed = Date.now() - startTime;
+
+        if (isJsonMode()) {
+          streamJsonLine({
+            type: "step",
+            name: "build",
+            status: "completed",
+            duration_ms: elapsed,
+          });
+          streamJsonLine({
+            type: "result",
+            success: true,
+            data: {
+              pages: stats.pages,
+              chunks: stats.chunks,
+              assets: stats.assets,
+              totalSize: stats.totalSize,
+              duration_ms: elapsed,
+              outputDir,
+              dryRun,
+            },
+          });
+          return;
+        }
+
         displayBuildSuccess(stats, startTime, outputDir, dryRun);
       } catch (error) {
+        if (isJsonMode()) {
+          streamJsonLine({
+            type: "result",
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+          });
+          const { exit } = await import("../../../src/platform/index.js");
+          exit(1);
+          return;
+        }
         handleBuildError(error);
       }
     },

package/src/cli/commands/clean/command-help.ts

@@ -2,6 +2,7 @@ import type { CommandHelp } from "../../help/types.js";
 
 export const cleanHelp: CommandHelp = {
   name: "clean",
+  category: "development",
   description: "Clean build artifacts and caches",
   usage: "veryfront clean [options]",
   options: [

package/src/cli/commands/completions/command-help.ts

@@ -0,0 +1,15 @@
+import type { CommandHelp } from "../../help/types.js";
+
+export const completionsHelp: CommandHelp = {
+  name: "completions",
+  category: "development",
+  description: "Generate shell completion scripts",
+  usage: "veryfront completions <shell>",
+  options: [],
+  examples: [
+    "veryfront completions bash",
+    "veryfront completions zsh",
+    "veryfront completions fish",
+    'eval "$(veryfront completions bash)"',
+  ],
+};