veryfront 0.1.81 → 0.1.83

package/esm/src/rendering/orchestrator/module-loader/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/orchestrator/module-loader/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AA6BzE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAkJpE,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE,kBAAkB,EAC1B,eAAe,UAAQ,GACtB,OAAO,CAAC,MAAM,CAAC,CAkSjB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyBD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqClC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/src/rendering/orchestrator/module-loader/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AA2BzE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAkJpE,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,cAAc,EAC5B,MAAM,EAAE,kBAAkB,EAC1B,eAAe,UAAQ,GACtB,OAAO,CAAC,MAAM,CAAC,CA4RjB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC;IACnC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAyBD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAqClC"}

package/esm/src/rendering/orchestrator/module-loader/index.js

@@ -14,14 +14,12 @@ import { createFileSystem } from "../../../platform/compat/fs.js";
 import { getProjectTmpDir } from "../../../modules/react-loader/index.js";
 import { generateCacheKey as generateTransformCacheKey, getOrComputeTransform, initializeTransformCache, setCachedTransformAsync, } from "../../../transforms/esm/transform-cache.js";
 import { TRANSFORM_DISTRIBUTED_TTL_SEC } from "../../../utils/constants/cache.js";
-import { ensureHttpBundlesExist } from "../../../transforms/esm/http-cache.js";
-import { validateBundleGroup } from "../../../transforms/esm/bundle-manifest.js";
+import { validateCachedBundlesByManifestOrCode } from "../../../transforms/esm/cached-bundle-validation.js";
 import { getHttpBundleCacheDir, getMdxEsmCacheDir } from "../../../utils/cache-dir.js";
 import { dirname, join, normalize } from "../../../platform/compat/path/index.js";
 import { hashCodeHex } from "../../../utils/hash-utils.js";
 import { VERSION } from "../../../utils/version.js";
 import { getModulePathCache, lookupMdxEsmCache, saveModulePathCache, } from "../../../transforms/mdx/esm-module-loader/cache/index.js";
-import { extractHttpBundlePaths } from "../../../modules/react-loader/ssr-module-loader/http-bundle-helpers.js";
 const logger = rendererLogger.component("module-loader");
 // Re-export utilities
 export { createEsmCache, createModuleCache, generateHash } from "./cache.js";
@@ -243,30 +241,19 @@ export async function transformModuleWithDeps(filePath, tmpDir, localAdapter, co
     let transformedCode = transformResult.code;
     const cacheDir = getHttpBundleCacheDir();
     let bundlesValid = true;
-    if (transformResult.cacheHit && transformResult.bundleManifestId) {
-        const validation = await validateBundleGroup(transformResult.bundleManifestId, cacheDir);
+    if (transformResult.cacheHit) {
+        const validation = await validateCachedBundlesByManifestOrCode(transformedCode, transformResult.bundleManifestId, cacheDir);
         if (!validation.valid) {
-            logger.warn("Bundle manifest validation failed, re-transforming", {
+            logger.warn("Cached HTTP bundle validation failed, re-transforming", {
                 filePath,
-                manifestId: transformResult.bundleManifestId.slice(0, 12),
+                manifestId: transformResult.bundleManifestId?.slice(0, 12),
                 failedHashes: validation.failedHashes,
+                reason: validation.reason,
+                source: validation.source,
             });
             bundlesValid = false;
         }
     }
-    else {
-        const bundlePaths = extractHttpBundlePaths(transformedCode);
-        if (bundlePaths.length > 0) {
-            const failed = await ensureHttpBundlesExist(bundlePaths, cacheDir);
-            if (failed.length > 0) {
-                logger.warn("HTTP bundle recovery failed, re-transforming", {
-                    filePath,
-                    failed,
-                });
-                bundlesValid = false;
-            }
-        }
-    }
     if (!bundlesValid) {
         transformedCode = await transformToESM(fileContent, filePath, projectDir, adapter, {
             projectId: effectiveProjectId,

package/esm/src/rendering/page-resolution/page-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/page-resolution/page-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAgCvD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,EAAE,mBAAmB;IAOxC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiDxC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAoCxB,sBAAsB;IAoD9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY1C,aAAa,IAAI,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC;CAShD"}
+{"version":3,"file":"page-resolver.d.ts","sourceRoot":"","sources":["../../../../src/src/rendering/page-resolution/page-resolver.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAoCvD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,eAAe,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;CACzB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,EAAE,mBAAmB;IAOxC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAsDxC,WAAW,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YAoCxB,sBAAsB;IAoD9B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY1C,aAAa,IAAI,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC;CAShD"}

package/esm/src/rendering/page-resolution/page-resolver.js

@@ -4,7 +4,7 @@ import { VeryfrontError } from "../../errors/index.js";
 import { FILE_NOT_FOUND } from "../../errors/error-registry.js";
 import { withSpan } from "../../observability/tracing/otlp-setup.js";
 import { getEntityBySlug } from "../../types/entities/getEntityInfo.js";
-import { detectAppRouter, getAppRouteEntity } from "../router-detection.js";
+import { detectAppRouter, getAppRouteEntity, primeRouterDetectionCache, } from "../router-detection.js";
 const PAGE_EXTENSIONS = /\.(mdx|md|tsx|jsx|ts|js)$/;
 const APP_ROUTER_PAGE_PATTERN = /^page\.(mdx|md|tsx|jsx|ts|js)$/;
 function isPageFile(name) {
@@ -40,20 +40,33 @@ export class PageResolver {
     }
     resolvePage(slug) {
         return withSpan("routing.resolve_page", async () => {
-            const useAppRouter = await detectAppRouter(this.projectDir, this.config, this.adapter, { projectId: this.projectId });
             const appDirName = this.config.directories?.app ?? "app";
+            const cacheKey = this.projectId ?? this.projectDir;
             let pageInfo;
-            if (useAppRouter) {
+            if (this.config.router === "app") {
+                pageInfo = await getAppRouteEntity(this.projectDir, slug, this.adapter, appDirName);
+                if (pageInfo) {
+                    primeRouterDetectionCache(cacheKey, "app");
+                }
+            }
+            else if (this.config.router === "pages") {
+                pageInfo = await getEntityBySlug(this.projectDir, slug, this.adapter);
+                if (pageInfo) {
+                    primeRouterDetectionCache(cacheKey, "pages");
+                }
+            }
+            else {
+                // Auto mode stays structural: a single resolved route must not pin router mode
+                // for projects that are still transitioning between app/ and pages/.
                 pageInfo = await getAppRouteEntity(this.projectDir, slug, this.adapter, appDirName);
                 if (!pageInfo) {
-                    logger.debug("App Router resolution failed, falling back to Pages Router", { slug });
+                    pageInfo = await getEntityBySlug(this.projectDir, slug, this.adapter);
                 }
             }
-            pageInfo ??= await getEntityBySlug(this.projectDir, slug, this.adapter);
             if (!pageInfo) {
                 throw FILE_NOT_FOUND.create({
                     detail: `Page not found: ${slug}`,
-                    context: { slug, useAppRouter },
+                    context: { slug, router: this.config.router ?? "auto" },
                 });
             }
             return pageInfo;

package/esm/src/rendering/router-detection.d.ts

@@ -21,6 +21,7 @@ export declare function clearRouterDetectionCache(): void;
  * @param projectId - The project ID used as cache key. Falls back to projectDir for local dev.
  */
 export declare function clearRouterDetectionCacheForProject(projectId: string): void;
+export declare function primeRouterDetectionCache(projectKey: string, mode: "app" | "pages"): void;
 export interface DetectAppRouterOptions {
     /** Project ID for cache isolation in multi-tenant deployments */
     projectId?: string;

package/esm/src/rendering/router-detection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router-detection.d.ts","sourceRoot":"","sources":["../../../src/src/rendering/router-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;4BAO4B;AAK5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQ1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAY5D;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE3E;AAED,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,OAAO,CAAC,CA6BlB"}
+{"version":3,"file":"router-detection.d.ts","sourceRoot":"","sources":["../../../src/src/rendering/router-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;4BAO4B;AAK5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQ1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAY5D;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE3E;AAED,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,KAAK,GAAG,OAAO,GACpB,IAAI,CAEN;AAED,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,OAAO,CAAC,CA6BlB"}

package/esm/src/rendering/router-detection.js

@@ -38,6 +38,9 @@ export function clearRouterDetectionCache() {
 export function clearRouterDetectionCacheForProject(projectId) {
     routerDetectionCache.delete(projectId);
 }
+export function primeRouterDetectionCache(projectKey, mode) {
+    routerDetectionCache.set(projectKey, mode === "app");
+}
 /**
  * Detect if app router should be used based on config and directory structure.
  *

package/esm/src/transforms/esm/bundle-manifest.d.ts

@@ -20,10 +20,12 @@ interface BundleManifest {
     createdAt: number;
     ttlSeconds: number;
 }
+export type ManifestValidationReason = "manifest_missing" | "bundle_missing";
 /** Result of manifest validation. */
-interface ManifestValidationResult {
+export interface ManifestValidationResult {
     valid: boolean;
     failedHashes: string[];
+    reason?: ManifestValidationReason;
 }
 /**
  * Compute a deterministic manifest ID from bundle hashes.

package/esm/src/transforms/esm/bundle-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bundle-manifest.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/bundle-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;4BAQ4B;AAiB5B,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oEAAoE;AACpE,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qCAAqC;AACrC,UAAU,wBAAwB;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAgBD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAc1F;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBjF;AAuBD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,CAAC,CA6CnC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB1E"}
+{"version":3,"file":"bundle-manifest.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/bundle-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;4BAQ4B;AAiB5B,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oEAAoE;AACpE,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,GAAG,gBAAgB,CAAC;AAE7E,qCAAqC;AACrC,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAgBD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAc1F;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBjF;AAuBD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,CAAC,CA6CnC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAErE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB1E"}

package/esm/src/transforms/esm/bundle-manifest.js

@@ -106,7 +106,7 @@ export async function validateBundleGroup(manifestId, cacheDir) {
         logger.debug(`${LOG_PREFIX} Manifest not found in distributed cache`, {
             manifestId: manifestId.slice(0, 12),
         });
-        return { valid: false, failedHashes: [] };
+        return { valid: false, failedHashes: [], reason: "manifest_missing" };
     }
     const missingBundles = [];
     await Promise.all(manifest.bundles.map(async ({ hash }) => {
@@ -132,7 +132,7 @@ export async function validateBundleGroup(manifestId, cacheDir) {
             manifestId: manifestId.slice(0, 12),
             unrecoverable: unrecoverableHashes,
         });
-        return { valid: false, failedHashes: unrecoverableHashes };
+        return { valid: false, failedHashes: unrecoverableHashes, reason: "bundle_missing" };
     }
     logger.info(`${LOG_PREFIX} All missing bundles recovered successfully`, {
         manifestId: manifestId.slice(0, 12),

package/esm/src/transforms/esm/cached-bundle-validation.d.ts

@@ -0,0 +1,9 @@
+import { type ManifestValidationReason } from "./bundle-manifest.js";
+export interface CachedBundleValidationResult {
+    valid: boolean;
+    failedHashes: string[];
+    reason?: ManifestValidationReason;
+    source: "manifest" | "code";
+}
+export declare function validateCachedBundlesByManifestOrCode(code: string, bundleManifestId: string | undefined, cacheDir: string): Promise<CachedBundleValidationResult>;
+//# sourceMappingURL=cached-bundle-validation.d.ts.map

package/esm/src/transforms/esm/cached-bundle-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-bundle-validation.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/esm/cached-bundle-validation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,wBAAwB,EAAuB,MAAM,sBAAsB,CAAC;AAE1F,MAAM,WAAW,4BAA4B;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAClC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;CAC7B;AAED,wBAAsB,qCAAqC,CACzD,IAAI,EAAE,MAAM,EACZ,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,4BAA4B,CAAC,CAwBvC"}

package/esm/src/transforms/esm/cached-bundle-validation.js

@@ -0,0 +1,25 @@
+import { extractHttpBundlePaths } from "../../modules/react-loader/ssr-module-loader/http-bundle-helpers.js";
+import { ensureHttpBundlesExist } from "./http-cache.js";
+import { validateBundleGroup } from "./bundle-manifest.js";
+export async function validateCachedBundlesByManifestOrCode(code, bundleManifestId, cacheDir) {
+    if (bundleManifestId) {
+        const validation = await validateBundleGroup(bundleManifestId, cacheDir);
+        if (validation.valid || validation.reason === "bundle_missing") {
+            return { ...validation, source: "manifest" };
+        }
+    }
+    const bundlePaths = extractHttpBundlePaths(code);
+    if (bundlePaths.length === 0) {
+        return { valid: true, failedHashes: [], source: "code" };
+    }
+    const failedHashes = await ensureHttpBundlesExist(bundlePaths, cacheDir);
+    if (failedHashes.length === 0) {
+        return { valid: true, failedHashes: [], source: "code" };
+    }
+    return {
+        valid: false,
+        failedHashes,
+        reason: "bundle_missing",
+        source: "code",
+    };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"distributed-cache.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/distributed-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAYjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAWjF,qDAAqD;AACrD,KAAK,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC,CAAC,CAAC;AAEhG;;;;;GAKG;AACH,UAAU,0BAA0B;IAClC,4EAA4E;IAC5E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,4DAA4D;IAC5D,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CA4G5C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,gBAAgB,EAClC,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,GACV,IAAI,CAqCN"}
+{"version":3,"file":"distributed-cache.d.ts","sourceRoot":"","sources":["../../../../../../src/src/transforms/mdx/esm-module-loader/module-fetcher/distributed-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AASjE,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AAWjF,qDAAqD;AACrD,KAAK,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC,CAAC,CAAC;AAEhG;;;;;GAKG;AACH,UAAU,0BAA0B;IAClC,4EAA4E;IAC5E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,4DAA4D;IAC5D,gBAAgB,EAAE,gBAAgB,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CACxC,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAoG5C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,gBAAgB,EAAE,gBAAgB,EAClC,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,MAAM,GACV,IAAI,CAqCN"}

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

@@ -7,10 +7,11 @@
  * @module transforms/mdx/esm-module-loader/module-fetcher/distributed-cache
  */
 import { detokenizeAllCachePaths, tokenizeAllVeryFrontPaths } from "../../../../cache/index.js";
-import { cacheHttpImportsToLocal, ensureHttpBundlesExist } from "../../../esm/http-cache.js";
+import { cacheHttpImportsToLocal } from "../../../esm/http-cache.js";
 import { loadImportMap } from "../../../../modules/import-map/index.js";
 import { extractHttpBundlePaths } from "../../../../modules/react-loader/ssr-module-loader/http-bundle-helpers.js";
-import { createBundleManifest, storeBundleManifest, validateBundleGroup, } from "../../../esm/bundle-manifest.js";
+import { createBundleManifest, storeBundleManifest } from "../../../esm/bundle-manifest.js";
+import { validateCachedBundlesByManifestOrCode } from "../../../esm/cached-bundle-validation.js";
 import { getHttpBundleCacheDir } from "../../../../utils/cache-dir.js";
 import { FRAMEWORK_ROOT, LOG_PREFIX_MDX_LOADER } from "../constants.js";
 import { getDistributedTransformBackend } from "../../../esm/transform-cache.js";
@@ -50,33 +51,20 @@ export async function readDistributedCache(transformCacheKey, normalizedPath, pr
         });
         const bundleManifestKey = `${transformCacheKey}:bm`;
         const manifestId = await distributedCache.get(bundleManifestKey).catch(() => null);
-        if (manifestId) {
+        if (moduleCode) {
             const cacheDir = getHttpBundleCacheDir();
-            const validation = await validateBundleGroup(manifestId, cacheDir);
+            const validation = await validateCachedBundlesByManifestOrCode(moduleCode, manifestId ?? undefined, cacheDir);
             if (!validation.valid) {
-                log.warn(`${LOG_PREFIX_MDX_LOADER} Bundle manifest validation failed`, {
+                log.warn(`${LOG_PREFIX_MDX_LOADER} Cached HTTP bundle validation failed`, {
                     normalizedPath,
-                    manifestId: manifestId.slice(0, 12),
+                    manifestId: manifestId?.slice(0, 12),
                     failedHashes: validation.failedHashes,
+                    reason: validation.reason,
+                    source: validation.source,
                 });
                 moduleCode = null;
             }
         }
-        else {
-            // Use detokenized code for bundle path extraction
-            const bundlePaths = extractHttpBundlePaths(moduleCode);
-            if (bundlePaths.length > 0) {
-                const cacheDir = getHttpBundleCacheDir();
-                const failed = await ensureHttpBundlesExist(bundlePaths, cacheDir);
-                if (failed.length > 0) {
-                    log.warn(`${LOG_PREFIX_MDX_LOADER} Some HTTP bundles could not be recovered`, {
-                        normalizedPath,
-                        failed,
-                    });
-                    moduleCode = null;
-                }
-            }
-        }
         // Use detokenized code for framework path checks
         if (moduleCode && await hasIncompatibleFrameworkPaths(moduleCode, log)) {
             log.warn(`${LOG_PREFIX_MDX_LOADER} Cached code has incompatible framework paths`, {

package/esm/src/transforms/pipeline/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAEhB,eAAe,EAChB,MAAM,YAAY,CAAC;AA4IpB,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAoI1B;AAoBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CASjB;AAmCD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,SAAS,EACT,KAAK,EACL,KAAK,EACL,YAAY,GACb,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/src/transforms/pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAEhB,eAAe,EAChB,MAAM,YAAY,CAAC;AA0HpB,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,eAAe,CAAC,CAoI1B;AAoBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,CASjB;AAmCD,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,SAAS,EACT,KAAK,EACL,KAAK,EACL,YAAY,GACb,MAAM,cAAc,CAAC"}

package/esm/src/transforms/pipeline/index.js

@@ -11,10 +11,8 @@ import { computeConfigHash } from "../../cache/config-hash.js";
 import { computeDepsHash } from "../../cache/dependency-graph.js";
 import { compilePlugin, cssStripPlugin, finalizePlugin, parsePlugin, resolveImportsPlugin, ssrHttpCachePlugin, ssrHttpStubPlugin, ssrVfModulesPlugin, } from "./stages/index.js";
 import { createFileSystem, exists } from "../../platform/compat/fs.js";
-import { ensureHttpBundlesExist } from "../esm/http-cache.js";
-import { extractHttpBundlePaths } from "../../modules/react-loader/ssr-module-loader/http-bundle-helpers.js";
 import { getHttpBundleCacheDir } from "../../utils/cache-dir.js";
-import { validateBundleGroup } from "../esm/bundle-manifest.js";
+import { validateCachedBundlesByManifestOrCode } from "../esm/cached-bundle-validation.js";
 import { extractFrameworkBundlePaths } from "../shared/framework-bundle-paths.js";
 const SSR_PIPELINE = [
     parsePlugin,
@@ -96,29 +94,15 @@ async function validateFrameworkBundles(code, cacheKey) {
  */
 async function validateCachedBundles(code, bundleManifestId, cacheKey) {
     const cacheDir = getHttpBundleCacheDir();
-    // If we have a manifest ID, use the faster manifest-based validation
-    if (bundleManifestId) {
-        const validation = await validateBundleGroup(bundleManifestId, cacheDir);
-        if (validation.valid)
-            return true;
-        logger.debug("Bundle manifest validation failed", {
-            cacheKey: cacheKey.slice(-40),
-            manifestId: bundleManifestId.slice(0, 12),
-            failedCount: validation.failedHashes.length,
-        });
-        return false;
-    }
-    // Fall back to extracting bundle paths from code and validating each
-    const bundlePaths = extractHttpBundlePaths(code);
-    if (bundlePaths.length === 0)
-        return true;
-    const failed = await ensureHttpBundlesExist(bundlePaths, cacheDir);
-    if (failed.length === 0)
+    const validation = await validateCachedBundlesByManifestOrCode(code, bundleManifestId, cacheDir);
+    if (validation.valid)
         return true;
-    logger.debug("HTTP bundle validation failed", {
+    logger.debug("Cached HTTP bundle validation failed", {
         cacheKey: cacheKey.slice(-40),
-        failedCount: failed.length,
-        totalBundles: bundlePaths.length,
+        manifestId: bundleManifestId?.slice(0, 12),
+        failedCount: validation.failedHashes.length,
+        reason: validation.reason,
+        source: validation.source,
     });
     return false;
 }

package/esm/src/types/entities/getEntityInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getEntityInfo.d.ts","sourceRoot":"","sources":["../../../../src/src/types/entities/getEntityInfo.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAU,UAAU,EAAe,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAWtE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA6I5B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA+L5B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAyE5B"}
+{"version":3,"file":"getEntityInfo.d.ts","sourceRoot":"","sources":["../../../../src/src/types/entities/getEntityInfo.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAU,UAAU,EAAe,MAAM,gBAAgB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAWtE,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAmJ5B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAwM5B;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAyE5B"}

package/esm/src/types/entities/getEntityInfo.js

@@ -29,37 +29,42 @@ export async function getEntityInfo(filePath, adapter) {
             }
         }
         try {
+            const shouldReadDirectly = adapter
+                ? isExtendedFSAdapter(adapter.fs) && adapter.fs.isVeryfrontAdapter()
+                : false;
+            let content;
             if (adapter) {
-                try {
-                    const stat = await withFallback(() => adapter.fs.stat(normalizedPath), async () => {
-                        const exists = await fs.exists(filePath);
-                        if (!exists) {
-                            throw toError(createError({
-                                type: "file",
-                                message: "File not found",
-                                context: { path: filePath, operation: "read" },
-                            }));
-                        }
-                        return await fs.stat(filePath);
-                    }, { operationName: "stat:getEntityInfo", logError: false });
-                    if (!stat.isFile)
+                if (!shouldReadDirectly) {
+                    try {
+                        const stat = await withFallback(() => adapter.fs.stat(normalizedPath), async () => {
+                            const exists = await fs.exists(filePath);
+                            if (!exists) {
+                                throw toError(createError({
+                                    type: "file",
+                                    message: "File not found",
+                                    context: { path: filePath, operation: "read" },
+                                }));
+                            }
+                            return await fs.stat(filePath);
+                        }, { operationName: "stat:getEntityInfo", logError: false });
+                        if (!stat.isFile)
+                            return null;
+                    }
+                    catch (error) {
+                        entityInfoScope.runSync(() => {
+                            throw error;
+                        }, { path: filePath, details: { reason: "stat-failed" } }, undefined);
                         return null;
+                    }
                 }
-                catch (error) {
-                    entityInfoScope.runSync(() => {
-                        throw error;
-                    }, { path: filePath, details: { reason: "stat-failed" } }, undefined);
-                    return null;
-                }
+                content = await withFallback(() => adapter.fs.readFile(normalizedPath), () => fs.readTextFile(filePath), { operationName: "readFile:getEntityInfo", logError: false });
             }
             else {
                 const exists = await fs.exists(filePath);
                 if (!exists)
                     return null;
+                content = await fs.readTextFile(filePath);
             }
-            const content = adapter
-                ? await withFallback(() => adapter.fs.readFile(normalizedPath), () => fs.readTextFile(filePath), { operationName: "readFile:getEntityInfo", logError: false })
-                : await fs.readTextFile(filePath);
             const ext = pathHelper.extname(filePath).toLowerCase();
             let frontmatter = {};
             let body = content;
@@ -120,23 +125,27 @@ export async function getEntityInfo(filePath, adapter) {
 }
 export async function getEntityBySlug(projectDir, slug, adapter) {
     return await withSpan("types.getEntityBySlug", async () => {
-        const isVeryfrontRoute = slug.startsWith(".veryfront/") || slug === ".veryfront";
+        const normalizedSlug = normalizeSlug(slug);
+        const isVeryfrontRoute = normalizedSlug.startsWith(".veryfront/") ||
+            normalizedSlug === ".veryfront";
         const resolveFile = adapter?.fs.resolveFile;
         logger.debug("START", {
             slug,
+            normalizedSlug,
             projectDir,
             isVeryfrontRoute,
             hasResolveFile: !!resolveFile,
         });
         if (resolveFile) {
-            const basePaths = [pathHelper.join(projectDir, "pages", slug)];
+            const basePaths = [pathHelper.join(projectDir, "pages", normalizedSlug)];
             if (isVeryfrontRoute)
-                basePaths.unshift(pathHelper.join(projectDir, slug));
-            if (slug === "index" || slug === "") {
+                basePaths.unshift(pathHelper.join(projectDir, normalizedSlug));
+            if (normalizedSlug === "index" || normalizedSlug === "") {
                 basePaths.unshift(pathHelper.join(projectDir, "pages", "index"));
             }
             logger.debug("Checking paths (resolveFile branch)", {
                 slug,
+                normalizedSlug,
                 basePaths,
             });
             const pathResults = await parallelMap(basePaths, async (basePath) => {
@@ -153,12 +162,13 @@ export async function getEntityBySlug(projectDir, slug, adapter) {
                 if (info?.entity.isPage) {
                     logger.debug("Found page via resolveFile", {
                         slug,
+                        normalizedSlug,
                         path: info.entity.path,
                     });
                     return info;
                 }
             }
-            const slugParts = slug.split("/");
+            const slugParts = normalizedSlug === "" ? [] : normalizedSlug.split("/");
             for (let depth = slugParts.length - 1; depth >= 0; depth--) {
                 const parentPath = slugParts.slice(0, depth).join("/");
                 const pagesDir = parentPath
@@ -194,25 +204,25 @@ export async function getEntityBySlug(projectDir, slug, adapter) {
                     /* expected: directory may not exist or readDir may fail */
                 }
             }
-            logger.debug("No page found via resolveFile branch", { slug });
+            logger.debug("No page found via resolveFile branch", { slug, normalizedSlug });
             return null;
         }
         const possiblePaths = [
-            pathHelper.join(projectDir, "pages", `${slug}.mdx`),
-            pathHelper.join(projectDir, "pages", `${slug}.md`),
-            pathHelper.join(projectDir, "pages", `${slug}.tsx`),
-            pathHelper.join(projectDir, "pages", `${slug}.jsx`),
-            pathHelper.join(projectDir, "pages", `${slug}.ts`),
-            pathHelper.join(projectDir, "pages", `${slug}/index.mdx`),
-            pathHelper.join(projectDir, "pages", `${slug}/index.md`),
-            pathHelper.join(projectDir, "pages", `${slug}/index.tsx`),
-            pathHelper.join(projectDir, "pages", `${slug}/index.jsx`),
-            pathHelper.join(projectDir, "pages", `${slug}/index.ts`),
+            pathHelper.join(projectDir, "pages", `${normalizedSlug}.mdx`),
+            pathHelper.join(projectDir, "pages", `${normalizedSlug}.md`),
+            pathHelper.join(projectDir, "pages", `${normalizedSlug}.tsx`),
+            pathHelper.join(projectDir, "pages", `${normalizedSlug}.jsx`),
+            pathHelper.join(projectDir, "pages", `${normalizedSlug}.ts`),
+            pathHelper.join(projectDir, "pages", `${normalizedSlug}/index.mdx`),
+            pathHelper.join(projectDir, "pages", `${normalizedSlug}/index.md`),
+            pathHelper.join(projectDir, "pages", `${normalizedSlug}/index.tsx`),
+            pathHelper.join(projectDir, "pages", `${normalizedSlug}/index.jsx`),
+            pathHelper.join(projectDir, "pages", `${normalizedSlug}/index.ts`),
         ];
         if (isVeryfrontRoute) {
-            possiblePaths.unshift(pathHelper.join(projectDir, `${slug}.mdx`), pathHelper.join(projectDir, `${slug}.md`), pathHelper.join(projectDir, `${slug}.tsx`), pathHelper.join(projectDir, `${slug}.ts`));
+            possiblePaths.unshift(pathHelper.join(projectDir, `${normalizedSlug}.mdx`), pathHelper.join(projectDir, `${normalizedSlug}.md`), pathHelper.join(projectDir, `${normalizedSlug}.tsx`), pathHelper.join(projectDir, `${normalizedSlug}.ts`));
         }
-        if (slug === "index" || slug === "") {
+        if (normalizedSlug === "index" || normalizedSlug === "") {
             possiblePaths.unshift(pathHelper.join(projectDir, "pages", "index.mdx"), pathHelper.join(projectDir, "pages", "index.md"), pathHelper.join(projectDir, "pages", "index.tsx"), pathHelper.join(projectDir, "pages", "index.ts"));
         }
         const pathResults = await parallelMap(possiblePaths, async (p) => {
@@ -222,7 +232,7 @@ export async function getEntityBySlug(projectDir, slug, adapter) {
             if (info?.entity.isPage)
                 return info;
         }
-        const slugParts = slug.split("/");
+        const slugParts = normalizedSlug === "" ? [] : normalizedSlug.split("/");
         for (let depth = slugParts.length - 1; depth >= 0; depth--) {
             const parentPath = slugParts.slice(0, depth).join("/");
             const pagesDir = parentPath
@@ -267,7 +277,11 @@ export async function getEntityBySlug(projectDir, slug, adapter) {
             }
         }
         return null;
-    }, { "entity.slug": slug, "entity.projectDir": projectDir });
+    }, {
+        "entity.slug": slug,
+        "entity.normalized_slug": normalizeSlug(slug),
+        "entity.projectDir": projectDir,
+    });
 }
 export async function getLayoutEntity(projectDir, layoutName, adapter) {
     return await withSpan("types.getLayoutEntity", async () => {
@@ -345,3 +359,6 @@ function getSlugFromPath(filePath) {
     const parentDir = parts[parts.length - 2];
     return parentDir === "pages" ? "" : parentDir ?? "";
 }
+function normalizeSlug(slug) {
+    return slug === "/" ? "" : slug.replace(/^\/+/, "").replace(/\/+$/, "");
+}

package/package.json

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

package/src/deno.js

@@ -1,6 +1,6 @@
 export default {
   "name": "veryfront",
-  "version": "0.1.81",
+  "version": "0.1.83",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/platform/adapters/base.ts

@@ -117,7 +117,11 @@ export interface FileSystemAdapter {
   makeTempDir(prefix: string): Promise<string>;
   watch(paths: string | string[], options?: WatchOptions): FileWatcher;
   /** Resolve a file path with extension fallback (e.g., pages/test → pages/test.mdx) */
-  resolveFile?(basePath: string): Promise<string | null>;
+  resolveFile?(basePath: string, options?: ResolveFileOptions): Promise<string | null>;
+}
+
+export interface ResolveFileOptions {
+  allowPagesPrefix?: boolean;
 }
 
 export interface DirEntry {

package/src/src/platform/adapters/fs/github/adapter.ts

@@ -1,6 +1,7 @@
 import { logger } from "../../../../utils/index.js";
 import { CONFIG_INVALID } from "../../../../errors/index.js";
 import { getEnv } from "../../../compat/process.js";
+import type { ResolveFileOptions } from "../../base.js";
 import { FileCache } from "../cache/file-cache.js";
 import type { FSAdapter, FSAdapterConfig } from "../veryfront/types.js";
 import { GitHubApiClient } from "./github-api-client.js";
@@ -115,9 +116,9 @@ export class GitHubFSAdapter implements FSAdapter {
     return this.dirOps.readdir(path);
   }
 
-  async resolveFile(basePath: string): Promise<string | null> {
+  async resolveFile(basePath: string, options?: ResolveFileOptions): Promise<string | null> {
     await this.ensureInitialized();
-    return this.statOps.resolveFile(basePath);
+    return this.statOps.resolveFile(basePath, options);
   }
 
   getCacheStats(): {

package/src/src/platform/adapters/fs/github/stat-operations.ts

@@ -5,6 +5,7 @@ import {
   buildGitHubStatCacheKey,
   buildGitHubTreeCacheKey,
 } from "../../../../cache/index.js";
+import type { ResolveFileOptions } from "../../base.js";
 import type { FileCache } from "../cache/file-cache.js";
 import type { GitHubApiClient } from "./github-api-client.js";
 import type { FileIndexEntry, FileInfo, GitHubTreeEntry, ResolvedGitHubConfig } from "./types.js";
@@ -176,7 +177,7 @@ export class GitHubStatOperations {
     }
   }
 
-  async resolveFile(basePath: string): Promise<string | null> {
+  async resolveFile(basePath: string, options?: ResolveFileOptions): Promise<string | null> {
     await this.ensureIndex();
 
     const normalizedPath = normalizeGitHubPath(basePath, this.projectDir);
@@ -185,7 +186,7 @@ export class GitHubStatOperations {
     if (cached !== undefined) return cached;
 
     const resolved = this.tryResolve(normalizedPath) ??
-      this.tryResolveWithPagesPrefix(normalizedPath);
+      (options?.allowPagesPrefix === false ? null : this.tryResolveWithPagesPrefix(normalizedPath));
 
     this.cache.set(cacheKey, resolved);
     return resolved;