veryfront 0.1.174 → 0.1.177

package/esm/deno.js

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

package/esm/src/platform/adapters/fs/veryfront/read-operations.d.ts

@@ -28,8 +28,10 @@ export declare class ReadOperations {
     private setupInFlightFetch;
     private tryResolveExtensionlessPath;
     private tryResolveExtensionlessPathFromFileList;
+    private finalizeResolvedExtension;
     private cacheResolvedContent;
     private storeFetchedContent;
+    private fetchPublishedVariant;
     private fetchContent;
     private fetchPublishedContent;
     private tryFallbackExtensions;

package/esm/src/platform/adapters/fs/veryfront/read-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAapE,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAY9B,qBAAa,cAAc;IAWvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAfpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAI9B;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA6B;gBAGnD,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,sBAAsB,YAAA,EACxC,kBAAkB,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,aAAA,EAC7C,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAC/C,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CACtD,aAAA;IAKH,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIrD,kBAAkB,IAAI,IAAI;IAK1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY3C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3C,OAAO,CAAC,mBAAmB;YAsBb,+BAA+B;YA0C/B,mBAAmB;IA0CjC,OAAO,CAAC,kBAAkB;YAoFZ,2BAA2B;YA8D3B,uCAAuC;IAmCrD,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,mBAAmB;YAUb,YAAY;YA6JZ,qBAAqB;YA4DrB,qBAAqB;YA8CrB,+BAA+B;YA4D/B,iBAAiB;CAuBhC"}
+{"version":3,"file":"read-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAKnD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAapE,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAY9B,qBAAa,cAAc;IAWvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IAfpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAI9B;IACH,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,mGAAmG;IACnG,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAA6B;gBAGnD,MAAM,EAAE,kBAAkB,EAC1B,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,sBAAsB,YAAA,EACxC,kBAAkB,CAAC,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,aAAA,EAC7C,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAC/C,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,SAAS,CACtD,aAAA;IAKH,uBAAuB,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAIrD,kBAAkB,IAAI,IAAI;IAK1B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY3C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY3C,OAAO,CAAC,mBAAmB;YAsBb,+BAA+B;YA0C/B,mBAAmB;IA0CjC,OAAO,CAAC,kBAAkB;YAoFZ,2BAA2B;YAmD3B,uCAAuC;IAiCrD,OAAO,CAAC,yBAAyB;IAmCjC,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,qBAAqB;YAYf,YAAY;YA6JZ,qBAAqB;YAwDrB,qBAAqB;YA8CrB,+BAA+B;YAwD/B,iBAAiB;CAuBhC"}

package/esm/src/platform/adapters/fs/veryfront/read-operations.js

@@ -219,17 +219,15 @@ export class ReadOperations {
             if (!resolved)
                 return null;
             const resolvedPath = this.normalizer.normalize(resolved.path);
-            const resolvedCacheKey = getResolvedCacheKey(cacheKeyPrefix, resolvedPath);
-            // Cache the path mapping to avoid future API resolution calls
-            this.extensionResolutionCache.set(apiPath, resolvedPath);
-            logger.debug("Resolved extension for base path", {
-                basePath: apiPath,
+            return this.finalizeResolvedExtension({
+                requestedPath: apiPath,
                 resolvedPath,
+                cacheKeyPrefix,
                 cacheKey,
-                resolvedCacheKey: resolvedCacheKey === cacheKey ? undefined : resolvedCacheKey,
+                content: resolved.content,
+                persistToCache: isProduction && !skipPersistentCaches,
+                logMessage: "Resolved extension for base path",
             });
-            this.cacheResolvedContent(cacheKey, resolvedCacheKey, resolved.content, isProduction && !skipPersistentCaches);
-            return resolved.content;
         }
         catch (error) {
             logger.debug("resolveFileWithExtension failed", {
@@ -244,8 +242,6 @@ export class ReadOperations {
         const resolved = await this.fileListIndex.findFirstMatch(candidatePaths);
         if (resolved.status !== "hit" || !resolved.path || !resolved.content)
             return resolved;
-        const resolvedCacheKey = getResolvedCacheKey(cacheKeyPrefix, resolved.path);
-        this.extensionResolutionCache.set(normalizedPath, resolved.path);
         logContentMetric("FILE_LIST_HIT", {
             path: normalizedPath,
             resolvedPath: resolved.path,
@@ -253,15 +249,30 @@ export class ReadOperations {
             cacheKey,
             isPreviewMode,
         });
-        logger.debug("Resolved extension from file list index", {
-            basePath: normalizedPath,
+        this.finalizeResolvedExtension({
+            requestedPath: normalizedPath,
             resolvedPath: resolved.path,
+            cacheKeyPrefix,
             cacheKey,
-            resolvedCacheKey: resolvedCacheKey === cacheKey ? undefined : resolvedCacheKey,
+            content: resolved.content,
+            persistToCache: isProduction,
+            logMessage: "Resolved extension from file list index",
         });
-        this.cacheResolvedContent(cacheKey, resolvedCacheKey, resolved.content, isProduction);
         return resolved;
     }
+    finalizeResolvedExtension({ requestedPath, resolvedPath, cacheKeyPrefix, cacheKey, content, persistToCache, logMessage, }) {
+        const resolvedCacheKey = getResolvedCacheKey(cacheKeyPrefix, resolvedPath);
+        // Cache the path mapping to avoid future API resolution calls.
+        this.extensionResolutionCache.set(requestedPath, resolvedPath);
+        logger.debug(logMessage, {
+            basePath: requestedPath,
+            resolvedPath,
+            cacheKey,
+            resolvedCacheKey: resolvedCacheKey === cacheKey ? undefined : resolvedCacheKey,
+        });
+        this.cacheResolvedContent(cacheKey, resolvedCacheKey, content, persistToCache);
+        return content;
+    }
     cacheResolvedContent(cacheKey, resolvedCacheKey, content, persistToCache) {
         if (persistToCache) {
             this.cache.set(cacheKey, content);
@@ -279,6 +290,9 @@ export class ReadOperations {
         setRequestScopedFile(cacheKey, content);
         return content;
     }
+    fetchPublishedVariant(apiPath, releaseId, environmentName) {
+        return this.client.getPublishedFileContent(apiPath, releaseId ?? undefined, environmentName ?? undefined);
+    }
     async fetchContent(normalizedPath) {
         // Framework paths should NEVER be fetched from API - they must be read from local filesystem.
         // If we reach here for a framework path, the module server's local resolution failed.
@@ -357,7 +371,7 @@ export class ReadOperations {
             environmentName: environmentName ?? undefined,
         });
         try {
-            const content = await this.client.getPublishedFileContent(apiPath, releaseId ?? undefined, environmentName ?? undefined);
+            const content = await this.fetchPublishedVariant(apiPath, releaseId, environmentName);
             logger.debug("Fetched published content", {
                 path: normalizedPath,
                 contentLength: content.length,
@@ -423,7 +437,7 @@ export class ReadOperations {
         const candidates = EXTENSION_PRIORITY.filter((ext) => ext !== originalExt);
         const startTime = performance.now();
         const promises = candidates.map(async (ext) => {
-            const content = await this.client.getPublishedFileContent(basePath + ext, releaseId ?? undefined, environmentName ?? undefined);
+            const content = await this.fetchPublishedVariant(basePath + ext, releaseId, environmentName);
             return { ext, content };
         });
         // Mark all promises as handled to prevent unhandled rejection errors

package/esm/src/platform/adapters/fs/veryfront/stat-operations.d.ts

@@ -18,6 +18,7 @@ export declare class StatOperations extends VeryfrontOperationsBase {
     private normalizeMatchedPaths;
     private tryResolveViaApiSearch;
     private hasCachedFileList;
+    private resolveFromIndex;
     exists(path: string): Promise<boolean>;
     resolveFile(basePath: string, options?: ResolveFileOptions): Promise<string | null>;
 }

package/esm/src/platform/adapters/fs/veryfront/stat-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stat-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/stat-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAuB/D,qBAAa,cAAe,SAAQ,uBAAuB;IACzD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,aAAa,CAA8B;IAEnD,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,qBAAqB,CAA8B;IAE3D,OAAO,CAAC,WAAW,CAAkC;IAErD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAGrC;IAEH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAiHvB,gBAAgB;YAwChB,UAAU;IAkDxB,UAAU,IAAI,IAAI;IAMlB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;YAIpC,cAAc;IAU5B,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,qBAAqB;YAQf,sBAAsB;YA8EtB,iBAAiB;IASzB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CAkI1F"}
+{"version":3,"file":"stat-operations.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/stat-operations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAuB/D,qBAAa,cAAe,SAAQ,uBAAuB;IACzD,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,cAAc,CAA4B;IAClD,OAAO,CAAC,aAAa,CAA8B;IAEnD,OAAO,CAAC,sBAAsB,CAA6B;IAC3D,OAAO,CAAC,qBAAqB,CAA8B;IAE3D,OAAO,CAAC,WAAW,CAAkC;IAErD,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAGrC;IAEH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;YAiHvB,gBAAgB;YAwChB,UAAU;IAkDxB,UAAU,IAAI,IAAI;IAMlB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;YAIpC,cAAc;IAU5B,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,qBAAqB;YAQf,sBAAsB;YA8EtB,iBAAiB;IAS/B,OAAO,CAAC,gBAAgB;IA6DlB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;CA0F1F"}

package/esm/src/platform/adapters/fs/veryfront/stat-operations.js

@@ -310,6 +310,51 @@ export class StatOperations extends VeryfrontOperationsBase {
         const files = await this.contextProvider?.getFileList?.();
         return Array.isArray(files) && files.length > 0;
     }
+    resolveFromIndex(fileIdx, normalizedPath, options, indexMs, resolveStart) {
+        if (fileIdx.has(normalizedPath)) {
+            const totalMs = Math.round(performance.now() - resolveStart);
+            logger.debug("resolveFile exact match found", {
+                normalizedPath,
+                indexMs,
+                totalMs,
+            });
+            return normalizedPath;
+        }
+        const pathWithoutExt = stripKnownExtension(normalizedPath, EXTENSION_PRIORITY);
+        const resolvedDirect = resolveByExtensionPriority(fileIdx, pathWithoutExt, EXTENSION_PRIORITY);
+        if (resolvedDirect) {
+            const totalMs = Math.round(performance.now() - resolveStart);
+            logger.debug("resolveFile found with extension", {
+                pathWithExt: resolvedDirect,
+                indexMs,
+                totalMs,
+            });
+            return resolvedDirect;
+        }
+        if (options?.allowPagesPrefix !== false && !pathWithoutExt.startsWith("pages/")) {
+            const resolvedPages = resolveByExtensionPriority(fileIdx, `pages/${pathWithoutExt}`, EXTENSION_PRIORITY);
+            if (resolvedPages) {
+                const totalMs = Math.round(performance.now() - resolveStart);
+                logger.debug("resolveFile found with pages prefix", {
+                    pathWithExt: resolvedPages,
+                    indexMs,
+                    totalMs,
+                });
+                return resolvedPages;
+            }
+        }
+        const indexPath = resolveIndexByExtensionPriority(fileIdx, pathWithoutExt, EXTENSION_PRIORITY);
+        if (indexPath) {
+            const totalMs = Math.round(performance.now() - resolveStart);
+            logger.debug("resolveFile found index file", {
+                indexPath,
+                indexMs,
+                totalMs,
+            });
+            return indexPath;
+        }
+        return null;
+    }
     async exists(path) {
         const normalizedPath = this.normalizer.normalize(path);
         try {
@@ -364,47 +409,9 @@ export class StatOperations extends VeryfrontOperationsBase {
             logger.debug("resolveFile - no file index", { indexMs });
             return null;
         }
-        if (fileIdx.has(normalizedPath)) {
-            const totalMs = Math.round(performance.now() - resolveStart);
-            logger.debug("resolveFile exact match found", {
-                normalizedPath,
-                indexMs,
-                totalMs,
-            });
-            return normalizedPath;
-        }
-        const pathWithoutExt = stripKnownExtension(normalizedPath, EXTENSION_PRIORITY);
-        const resolvedDirect = resolveByExtensionPriority(fileIdx, pathWithoutExt, EXTENSION_PRIORITY);
-        if (resolvedDirect) {
-            const totalMs = Math.round(performance.now() - resolveStart);
-            logger.debug("resolveFile found with extension", {
-                pathWithExt: resolvedDirect,
-                indexMs,
-                totalMs,
-            });
-            return resolvedDirect;
-        }
-        if (options?.allowPagesPrefix !== false && !pathWithoutExt.startsWith("pages/")) {
-            const resolvedPages = resolveByExtensionPriority(fileIdx, `pages/${pathWithoutExt}`, EXTENSION_PRIORITY);
-            if (resolvedPages) {
-                const totalMs = Math.round(performance.now() - resolveStart);
-                logger.debug("resolveFile found with pages prefix", {
-                    pathWithExt: resolvedPages,
-                    indexMs,
-                    totalMs,
-                });
-                return resolvedPages;
-            }
-        }
-        const indexPath = resolveIndexByExtensionPriority(fileIdx, pathWithoutExt, EXTENSION_PRIORITY);
-        if (indexPath) {
-            const totalMs = Math.round(performance.now() - resolveStart);
-            logger.debug("resolveFile found index file", {
-                indexPath,
-                indexMs,
-                totalMs,
-            });
-            return indexPath;
+        const indexedResolution = this.resolveFromIndex(fileIdx, normalizedPath, options, indexMs, resolveStart);
+        if (indexedResolution) {
+            return indexedResolution;
         }
         if (attemptedApiResolve) {
             logger.debug("resolveFile not found after pre-index API search", {

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

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.1.174";
+export declare const VERSION = "0.1.177";
 //# sourceMappingURL=version-constant.d.ts.map

package/esm/src/utils/version-constant.js

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.174";
+export const VERSION = "0.1.177";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "veryfront",
-  "version": "0.1.174",
+  "version": "0.1.177",
   "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.174",
+  "version": "0.1.177",
   "license": "Apache-2.0",
   "nodeModulesDir": "auto",
   "exclude": [

package/src/src/platform/adapters/fs/veryfront/read-operations.ts

@@ -316,26 +316,15 @@ export class ReadOperations {
       if (!resolved) return null;
 
       const resolvedPath = this.normalizer.normalize(resolved.path);
-      const resolvedCacheKey = getResolvedCacheKey(cacheKeyPrefix, resolvedPath);
-
-      // Cache the path mapping to avoid future API resolution calls
-      this.extensionResolutionCache.set(apiPath, resolvedPath);
-
-      logger.debug("Resolved extension for base path", {
-        basePath: apiPath,
+      return this.finalizeResolvedExtension({
+        requestedPath: apiPath,
         resolvedPath,
+        cacheKeyPrefix,
         cacheKey,
-        resolvedCacheKey: resolvedCacheKey === cacheKey ? undefined : resolvedCacheKey,
+        content: resolved.content,
+        persistToCache: isProduction && !skipPersistentCaches,
+        logMessage: "Resolved extension for base path",
       });
-
-      this.cacheResolvedContent(
-        cacheKey,
-        resolvedCacheKey,
-        resolved.content,
-        isProduction && !skipPersistentCaches,
-      );
-
-      return resolved.content;
     } catch (error) {
       logger.debug("resolveFileWithExtension failed", {
         basePath: apiPath,
@@ -357,10 +346,6 @@ export class ReadOperations {
     const resolved = await this.fileListIndex.findFirstMatch(candidatePaths);
     if (resolved.status !== "hit" || !resolved.path || !resolved.content) return resolved;
 
-    const resolvedCacheKey = getResolvedCacheKey(cacheKeyPrefix, resolved.path);
-
-    this.extensionResolutionCache.set(normalizedPath, resolved.path);
-
     logContentMetric("FILE_LIST_HIT", {
       path: normalizedPath,
       resolvedPath: resolved.path,
@@ -368,18 +353,55 @@ export class ReadOperations {
       cacheKey,
       isPreviewMode,
     });
-    logger.debug("Resolved extension from file list index", {
-      basePath: normalizedPath,
+
+    this.finalizeResolvedExtension({
+      requestedPath: normalizedPath,
       resolvedPath: resolved.path,
+      cacheKeyPrefix,
       cacheKey,
-      resolvedCacheKey: resolvedCacheKey === cacheKey ? undefined : resolvedCacheKey,
+      content: resolved.content,
+      persistToCache: isProduction,
+      logMessage: "Resolved extension from file list index",
     });
 
-    this.cacheResolvedContent(cacheKey, resolvedCacheKey, resolved.content, isProduction);
-
     return resolved;
   }
 
+  private finalizeResolvedExtension(
+    {
+      requestedPath,
+      resolvedPath,
+      cacheKeyPrefix,
+      cacheKey,
+      content,
+      persistToCache,
+      logMessage,
+    }: {
+      requestedPath: string;
+      resolvedPath: string;
+      cacheKeyPrefix: string;
+      cacheKey: string;
+      content: string;
+      persistToCache: boolean;
+      logMessage: string;
+    },
+  ): string {
+    const resolvedCacheKey = getResolvedCacheKey(cacheKeyPrefix, resolvedPath);
+
+    // Cache the path mapping to avoid future API resolution calls.
+    this.extensionResolutionCache.set(requestedPath, resolvedPath);
+
+    logger.debug(logMessage, {
+      basePath: requestedPath,
+      resolvedPath,
+      cacheKey,
+      resolvedCacheKey: resolvedCacheKey === cacheKey ? undefined : resolvedCacheKey,
+    });
+
+    this.cacheResolvedContent(cacheKey, resolvedCacheKey, content, persistToCache);
+    return content;
+  }
+
   private cacheResolvedContent(
     cacheKey: string,
     resolvedCacheKey: string,
@@ -406,6 +428,18 @@ export class ReadOperations {
     return content;
   }
 
+  private fetchPublishedVariant(
+    apiPath: string,
+    releaseId: string | null,
+    environmentName?: string | null,
+  ): Promise<string> {
+    return this.client.getPublishedFileContent(
+      apiPath,
+      releaseId ?? undefined,
+      environmentName ?? undefined,
+    );
+  }
+
   private async fetchContent(normalizedPath: string): Promise<string> {
     // Framework paths should NEVER be fetched from API - they must be read from local filesystem.
     // If we reach here for a framework path, the module server's local resolution failed.
@@ -579,11 +613,7 @@ export class ReadOperations {
     });
 
     try {
-      const content = await this.client.getPublishedFileContent(
-        apiPath,
-        releaseId ?? undefined,
-        environmentName ?? undefined,
-      );
+      const content = await this.fetchPublishedVariant(apiPath, releaseId, environmentName);
 
       logger.debug("Fetched published content", {
         path: normalizedPath,
@@ -686,11 +716,7 @@ export class ReadOperations {
     const startTime = performance.now();
 
     const promises = candidates.map(async (ext) => {
-      const content = await this.client.getPublishedFileContent(
-        basePath + ext,
-        releaseId ?? undefined,
-        environmentName ?? undefined,
-      );
+      const content = await this.fetchPublishedVariant(basePath + ext, releaseId, environmentName);
       return { ext, content };
     });
 

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

@@ -390,6 +390,67 @@ export class StatOperations extends VeryfrontOperationsBase {
     return Array.isArray(files) && files.length > 0;
   }
 
+  private resolveFromIndex(
+    fileIdx: Map<string, ProjectFile>,
+    normalizedPath: string,
+    options: ResolveFileOptions | undefined,
+    indexMs: number,
+    resolveStart: number,
+  ): string | null {
+    if (fileIdx.has(normalizedPath)) {
+      const totalMs = Math.round(performance.now() - resolveStart);
+      logger.debug("resolveFile exact match found", {
+        normalizedPath,
+        indexMs,
+        totalMs,
+      });
+      return normalizedPath;
+    }
+
+    const pathWithoutExt = stripKnownExtension(normalizedPath, EXTENSION_PRIORITY);
+
+    const resolvedDirect = resolveByExtensionPriority(fileIdx, pathWithoutExt, EXTENSION_PRIORITY);
+    if (resolvedDirect) {
+      const totalMs = Math.round(performance.now() - resolveStart);
+      logger.debug("resolveFile found with extension", {
+        pathWithExt: resolvedDirect,
+        indexMs,
+        totalMs,
+      });
+      return resolvedDirect;
+    }
+
+    if (options?.allowPagesPrefix !== false && !pathWithoutExt.startsWith("pages/")) {
+      const resolvedPages = resolveByExtensionPriority(
+        fileIdx,
+        `pages/${pathWithoutExt}`,
+        EXTENSION_PRIORITY,
+      );
+      if (resolvedPages) {
+        const totalMs = Math.round(performance.now() - resolveStart);
+        logger.debug("resolveFile found with pages prefix", {
+          pathWithExt: resolvedPages,
+          indexMs,
+          totalMs,
+        });
+        return resolvedPages;
+      }
+    }
+
+    const indexPath = resolveIndexByExtensionPriority(fileIdx, pathWithoutExt, EXTENSION_PRIORITY);
+    if (indexPath) {
+      const totalMs = Math.round(performance.now() - resolveStart);
+      logger.debug("resolveFile found index file", {
+        indexPath,
+        indexMs,
+        totalMs,
+      });
+      return indexPath;
+    }
+
+    return null;
+  }
+
   async exists(path: string): Promise<boolean> {
     const normalizedPath = this.normalizer.normalize(path);
     try {
@@ -453,55 +514,15 @@ export class StatOperations extends VeryfrontOperationsBase {
       return null;
     }
 
-    if (fileIdx.has(normalizedPath)) {
-      const totalMs = Math.round(performance.now() - resolveStart);
-      logger.debug("resolveFile exact match found", {
-        normalizedPath,
-        indexMs,
-        totalMs,
-      });
-      return normalizedPath;
-    }
-
-    const pathWithoutExt = stripKnownExtension(normalizedPath, EXTENSION_PRIORITY);
-
-    const resolvedDirect = resolveByExtensionPriority(fileIdx, pathWithoutExt, EXTENSION_PRIORITY);
-    if (resolvedDirect) {
-      const totalMs = Math.round(performance.now() - resolveStart);
-      logger.debug("resolveFile found with extension", {
-        pathWithExt: resolvedDirect,
-        indexMs,
-        totalMs,
-      });
-      return resolvedDirect;
-    }
-
-    if (options?.allowPagesPrefix !== false && !pathWithoutExt.startsWith("pages/")) {
-      const resolvedPages = resolveByExtensionPriority(
-        fileIdx,
-        `pages/${pathWithoutExt}`,
-        EXTENSION_PRIORITY,
-      );
-      if (resolvedPages) {
-        const totalMs = Math.round(performance.now() - resolveStart);
-        logger.debug("resolveFile found with pages prefix", {
-          pathWithExt: resolvedPages,
-          indexMs,
-          totalMs,
-        });
-        return resolvedPages;
-      }
-    }
-
-    const indexPath = resolveIndexByExtensionPriority(fileIdx, pathWithoutExt, EXTENSION_PRIORITY);
-    if (indexPath) {
-      const totalMs = Math.round(performance.now() - resolveStart);
-      logger.debug("resolveFile found index file", {
-        indexPath,
-        indexMs,
-        totalMs,
-      });
-      return indexPath;
+    const indexedResolution = this.resolveFromIndex(
+      fileIdx,
+      normalizedPath,
+      options,
+      indexMs,
+      resolveStart,
+    );
+    if (indexedResolution) {
+      return indexedResolution;
     }
 
     if (attemptedApiResolve) {

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

@@ -1,3 +1,3 @@
 // Keep in sync with deno.json version.
 // scripts/release.ts updates this constant during releases.
-export const VERSION = "0.1.174";
+export const VERSION = "0.1.177";