veryfront 0.1.86 → 0.1.88

package/esm/deno.js

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

package/esm/src/cache/distributed-cache-init.d.ts

@@ -4,7 +4,16 @@ interface DistributedCacheStatus {
     ssrModuleCache: boolean;
     fileCache: boolean;
     projectCSSCache: boolean;
+    httpModuleCache: boolean;
 }
+type DistributedCacheInitializers = {
+    transformCache: () => Promise<boolean>;
+    ssrModuleCache: () => Promise<boolean>;
+    fileCache: () => Promise<boolean>;
+    projectCSSCache: () => Promise<boolean>;
+    httpModuleCache: () => Promise<boolean>;
+};
+export declare function __runDistributedCacheInitializationForTests(backend: DistributedCacheStatus["backend"], initializers: DistributedCacheInitializers): Promise<DistributedCacheStatus>;
 export declare function initializeDistributedCaches(): Promise<DistributedCacheStatus>;
 export {};
 //# sourceMappingURL=distributed-cache-init.d.ts.map

package/esm/src/cache/distributed-cache-init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"distributed-cache-init.d.ts","sourceRoot":"","sources":["../../../src/src/cache/distributed-cache-init.ts"],"names":[],"mappings":"AAYA,UAAU,sBAAsB;IAC9B,OAAO,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAaD,wBAAgB,2BAA2B,IAAI,OAAO,CAAC,sBAAsB,CAAC,CA4E7E"}
+{"version":3,"file":"distributed-cache-init.d.ts","sourceRoot":"","sources":["../../../src/src/cache/distributed-cache-init.ts"],"names":[],"mappings":"AAaA,UAAU,sBAAsB;IAC9B,OAAO,EAAE,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,KAAK,4BAA4B,GAAG;IAClC,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,cAAc,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,eAAe,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC,CAAC;AAyFF,wBAAgB,2CAA2C,CACzD,OAAO,EAAE,sBAAsB,CAAC,SAAS,CAAC,EAC1C,YAAY,EAAE,4BAA4B,GACzC,OAAO,CAAC,sBAAsB,CAAC,CAEjC;AAED,wBAAgB,2BAA2B,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAmB7E"}

package/esm/src/cache/distributed-cache-init.js

@@ -1,6 +1,7 @@
 import { initializeFileCacheBackend } from "../platform/adapters/fs/cache/file-cache.js";
 import { initializeSSRDistributedCache } from "../modules/react-loader/ssr-module-loader/index.js";
 import { initializeTransformCache } from "../transforms/esm/transform-cache.js";
+import { initializeHttpModuleDistributedCache } from "../transforms/esm/http-cache-wrapper.js";
 import { SpanNames } from "../observability/tracing/span-names.js";
 import { withSpan } from "../observability/tracing/otlp-setup.js";
 import { initializeProjectCSSCache } from "../html/styles-builder/tailwind-compiler.js";
@@ -8,6 +9,13 @@ import { logger as baseLogger } from "../utils/logger/logger.js";
 import { isRedisConfigured } from "../utils/redis-client.js";
 import { isApiCacheAvailable, isDiskCacheConfigured } from "./backend.js";
 const logger = baseLogger.component("distributed-cache");
+const defaultInitializers = {
+    transformCache: initializeTransformCache,
+    ssrModuleCache: initializeSSRDistributedCache,
+    fileCache: initializeFileCacheBackend,
+    projectCSSCache: initializeProjectCSSCache,
+    httpModuleCache: initializeHttpModuleDistributedCache,
+};
 function determineBackend() {
     if (isApiCacheAvailable())
         return "api";
@@ -20,6 +28,66 @@ function determineBackend() {
 function wasSuccessful(result) {
     return result.status === "fulfilled" && result.value;
 }
+async function initializeDistributedCachesWithInitializers(backend, initializers) {
+    logger.info("Initializing caches...", { backend });
+    const cacheNames = [
+        "transformCache",
+        "ssrModuleCache",
+        "fileCache",
+        "projectCSSCache",
+        "httpModuleCache",
+    ];
+    const results = await Promise.allSettled([
+        initializers.transformCache(),
+        initializers.ssrModuleCache(),
+        initializers.fileCache(),
+        initializers.projectCSSCache(),
+        initializers.httpModuleCache(),
+    ]);
+    for (let i = 0; i < results.length; i++) {
+        const result = results[i];
+        if (result && result.status === "rejected") {
+            logger.error(`Cache initialization failed: ${cacheNames[i]}`, {
+                backend,
+                error: result.reason instanceof Error ? result.reason.message : String(result.reason),
+            });
+        }
+    }
+    const status = {
+        backend,
+        transformCache: wasSuccessful(results[0]),
+        ssrModuleCache: wasSuccessful(results[1]),
+        fileCache: wasSuccessful(results[2]),
+        projectCSSCache: wasSuccessful(results[3]),
+        httpModuleCache: wasSuccessful(results[4]),
+    };
+    const enabled = [
+        status.transformCache,
+        status.ssrModuleCache,
+        status.fileCache,
+        status.projectCSSCache,
+        status.httpModuleCache,
+    ].filter(Boolean).length;
+    if (enabled === 0) {
+        logger.warn("No caches enabled despite backend being available", {
+            backend,
+        });
+        return status;
+    }
+    logger.info("Initialization complete", {
+        backend,
+        enabled,
+        transform: status.transformCache,
+        ssrModule: status.ssrModuleCache,
+        file: status.fileCache,
+        projectCSS: status.projectCSSCache,
+        httpModule: status.httpModuleCache,
+    });
+    return status;
+}
+export function __runDistributedCacheInitializationForTests(backend, initializers) {
+    return initializeDistributedCachesWithInitializers(backend, initializers);
+}
 export function initializeDistributedCaches() {
     const backend = determineBackend();
     if (backend === "memory") {
@@ -29,58 +97,8 @@ export function initializeDistributedCaches() {
             ssrModuleCache: false,
             fileCache: false,
             projectCSSCache: false,
+            httpModuleCache: false,
         });
     }
-    return withSpan(SpanNames.CACHE_DISTRIBUTED_INIT, async () => {
-        logger.info("Initializing caches...", { backend });
-        const cacheNames = [
-            "transformCache",
-            "ssrModuleCache",
-            "fileCache",
-            "projectCSSCache",
-        ];
-        const results = await Promise.allSettled([
-            initializeTransformCache(),
-            initializeSSRDistributedCache(),
-            initializeFileCacheBackend(),
-            initializeProjectCSSCache(),
-        ]);
-        for (let i = 0; i < results.length; i++) {
-            const result = results[i];
-            if (result && result.status === "rejected") {
-                logger.error(`Cache initialization failed: ${cacheNames[i]}`, {
-                    backend,
-                    error: result.reason instanceof Error ? result.reason.message : String(result.reason),
-                });
-            }
-        }
-        const status = {
-            backend,
-            transformCache: wasSuccessful(results[0]),
-            ssrModuleCache: wasSuccessful(results[1]),
-            fileCache: wasSuccessful(results[2]),
-            projectCSSCache: wasSuccessful(results[3]),
-        };
-        const enabled = [
-            status.transformCache,
-            status.ssrModuleCache,
-            status.fileCache,
-            status.projectCSSCache,
-        ].filter(Boolean).length;
-        if (enabled === 0) {
-            logger.warn("No caches enabled despite backend being available", {
-                backend,
-            });
-            return status;
-        }
-        logger.info("Initialization complete", {
-            backend,
-            enabled,
-            transform: status.transformCache,
-            ssrModule: status.ssrModuleCache,
-            file: status.fileCache,
-            projectCSS: status.projectCSSCache,
-        });
-        return status;
-    }, { "cache.backend": backend });
+    return withSpan(SpanNames.CACHE_DISTRIBUTED_INIT, () => initializeDistributedCachesWithInitializers(backend, defaultInitializers), { "cache.backend": backend });
 }

package/esm/src/cache/module-cache.d.ts

@@ -2,6 +2,10 @@
  * Pod-Level Module Cache Singleton
  **************************/
 import { LRUCache } from "../utils/lru-wrapper.js";
+export interface ModuleCacheMap extends Map<string, string> {
+    getOrInsert(key: string, value: string): string;
+    getOrInsertComputed(key: string, callback: (key: string) => string): string;
+}
 interface ModuleCacheStats {
     moduleCache: {
         size: number;
@@ -16,8 +20,8 @@ interface ModuleCacheStats {
 }
 export declare function getModuleCache(): LRUCache<string, string>;
 export declare function getEsmCache(): LRUCache<string, string>;
-export declare function createModuleCache(): Map<string, string>;
-export declare function createEsmCache(): Map<string, string>;
+export declare function createModuleCache(): ModuleCacheMap;
+export declare function createEsmCache(): ModuleCacheMap;
 export declare function getModuleCacheStats(): ModuleCacheStats;
 export declare function clearModuleCaches(): void;
 export declare function clearModuleCacheForProject(projectId: string): number;

package/esm/src/cache/module-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module-cache.d.ts","sourceRoot":"","sources":["../../../src/src/cache/module-cache.ts"],"names":[],"mappings":"AAAA;;4BAE4B;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAenD,UAAU,gBAAgB;IACxB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAqDD,wBAAgB,cAAc,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtD;AAED,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvD;AAED,wBAAgB,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEpD;AA6DD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAatD;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAgBpE;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}
+{"version":3,"file":"module-cache.d.ts","sourceRoot":"","sources":["../../../src/src/cache/module-cache.ts"],"names":[],"mappings":"AAAA;;4BAE4B;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAenD,MAAM,WAAW,cAAe,SAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IACzD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChD,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC;CAC7E;AAED,UAAU,gBAAgB;IACxB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAqDD,wBAAgB,cAAc,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzD;AAED,wBAAgB,WAAW,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAEtD;AAED,wBAAgB,iBAAiB,IAAI,cAAc,CAElD;AAED,wBAAgB,cAAc,IAAI,cAAc,CAE/C;AA8FD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAatD;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAED,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAgBpE;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}

package/esm/src/cache/module-cache.js

@@ -57,64 +57,81 @@ export function createEsmCache() {
     return createMapInterface(getEsmCache());
 }
 function createMapInterface(cache) {
-    const map = {
-        get(key) {
-            return cache.get(key);
-        },
-        set(key, value) {
-            cache.set(key, value);
-            return map;
-        },
-        has(key) {
-            return cache.has(key);
-        },
-        delete(key) {
-            return cache.delete(key);
-        },
-        clear() {
-            cache.clear();
-        },
-        get size() {
-            return cache.size;
-        },
-        keys() {
-            return cache.keys();
-        },
-        values() {
-            const keysIter = cache.keys();
-            const cacheRef = cache;
-            return (function* () {
-                for (const key of keysIter) {
-                    const value = cacheRef.get(key);
-                    if (value !== undefined)
-                        yield value;
-                }
-            })();
-        },
-        entries() {
-            const keysIter = cache.keys();
-            const cacheRef = cache;
-            return (function* () {
-                for (const key of keysIter) {
-                    const value = cacheRef.get(key);
-                    if (value !== undefined)
-                        yield [key, value];
-                }
-            })();
-        },
-        forEach(callback) {
-            for (const key of cache.keys()) {
-                const value = cache.get(key);
+    return new LRUBackedMap(cache);
+}
+class LRUBackedMap {
+    cache;
+    [Symbol.toStringTag] = "Map";
+    constructor(cache) {
+        this.cache = cache;
+    }
+    get(key) {
+        return this.cache.get(key);
+    }
+    set(key, value) {
+        this.cache.set(key, value);
+        return this;
+    }
+    has(key) {
+        return this.cache.has(key);
+    }
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    clear() {
+        this.cache.clear();
+    }
+    getOrInsert(key, value) {
+        const existing = this.cache.get(key);
+        if (existing !== undefined)
+            return existing;
+        this.cache.set(key, value);
+        return value;
+    }
+    getOrInsertComputed(key, callback) {
+        const existing = this.cache.get(key);
+        if (existing !== undefined)
+            return existing;
+        const value = callback(key);
+        this.cache.set(key, value);
+        return value;
+    }
+    get size() {
+        return this.cache.size;
+    }
+    keys() {
+        return this.cache.keys();
+    }
+    values() {
+        const keysIter = this.cache.keys();
+        const cacheRef = this.cache;
+        return (function* () {
+            for (const key of keysIter) {
+                const value = cacheRef.get(key);
                 if (value !== undefined)
-                    callback(value, key, map);
+                    yield value;
             }
-        },
-        [Symbol.iterator]() {
-            return map.entries();
-        },
-        [Symbol.toStringTag]: "Map",
-    };
-    return map;
+        })();
+    }
+    entries() {
+        const keysIter = this.cache.keys();
+        const cacheRef = this.cache;
+        return (function* () {
+            for (const key of keysIter) {
+                const value = cacheRef.get(key);
+                if (value !== undefined)
+                    yield [key, value];
+            }
+        })();
+    }
+    forEach(callback, thisArg) {
+        for (const [key, value] of this.entries()) {
+            callback.call(thisArg, value, key, this);
+        }
+    }
+    [Symbol.iterator]() {
+        return this.entries();
+    }
 }
 export function getModuleCacheStats() {
     return {

package/esm/src/platform/adapters/fs/veryfront/content-metrics.d.ts

@@ -1,4 +1,4 @@
-export type MissReason = "cold_start" | "not_in_filelist" | "invalidation" | "no_filelist_cache";
+export type MissReason = "cold_start" | "not_in_filelist" | "invalidation" | "no_filelist_cache" | "indexed_without_content";
 interface CumulativeMetrics {
     requestScopedHits: number;
     persistentCacheHits: number;

package/esm/src/platform/adapters/fs/veryfront/content-metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-metrics.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/content-metrics.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,iBAAiB,GAAG,cAAc,GAAG,mBAAmB,CAAC;AAejG,UAAU,iBAAiB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AAsCD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,iBAAiB,CAC/B,cAAc,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,IAAI,CAuCN;AAED,KAAK,kBAAkB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,eAAe,GACf,eAAe,GACf,wBAAwB,GACxB,YAAY,CAAC;AAEjB,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,GACA,IAAI,CAyCN;AAED,wBAAgB,yBAAyB,IAAI,iBAAiB,GAAG;IAC/D,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAOA;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}
+{"version":3,"file":"content-metrics.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/content-metrics.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,iBAAiB,GACjB,cAAc,GACd,mBAAmB,GACnB,yBAAyB,CAAC;AAe9B,UAAU,iBAAiB;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;CACzB;AA4CD,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED,wBAAgB,iBAAiB,CAC/B,cAAc,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACxE,IAAI,CAuCN;AAED,KAAK,kBAAkB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,eAAe,GACf,eAAe,GACf,wBAAwB,GACxB,YAAY,CAAC;AAEjB,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,GACA,IAAI,CAyCN;AAED,wBAAgB,yBAAyB,IAAI,iBAAiB,GAAG;IAC/D,sBAAsB,EAAE,MAAM,CAAC;CAChC,CAOA;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAO1C"}

package/esm/src/platform/adapters/fs/veryfront/content-metrics.js

@@ -20,7 +20,13 @@ function createFreshRequestMetrics() {
         networkFetches: 0,
         networkMs: 0,
         fetchesByType: { page: 0, layout: 0, component: 0, api: 0, data: 0, config: 0, other: 0 },
-        missReasons: { cold_start: 0, not_in_filelist: 0, invalidation: 0, no_filelist_cache: 0 },
+        missReasons: {
+            cold_start: 0,
+            not_in_filelist: 0,
+            invalidation: 0,
+            no_filelist_cache: 0,
+            indexed_without_content: 0,
+        },
         isPreviewMode: null,
         filesAccessed: new Set(),
     };

package/esm/src/platform/adapters/fs/veryfront/file-list-index.d.ts

@@ -2,21 +2,31 @@ interface FileListCacheEntry {
     path: string;
     content?: string;
 }
+export interface FileListMatchResult {
+    status: "unavailable" | "missing" | "present_without_content" | "hit";
+    fresh: boolean;
+    path?: string;
+    content?: string;
+}
 export declare class FileListIndex {
     private readonly getFileListCache?;
     private index;
+    private pathSet;
     private indexKey;
     private indexBuiltAt;
+    private indexFresh;
     private readyPromise;
     constructor(getFileListCache?: (() => Promise<Array<FileListCacheEntry> | undefined>) | undefined);
     setReadyPromise(promise: Promise<void>): void;
     clear(): void;
     private ensureReady;
     lookup(normalizedPath: string): Promise<string | undefined>;
+    match(normalizedPath: string): Promise<FileListMatchResult>;
     findFirstWithContent(normalizedPaths: string[]): Promise<{
         path: string;
         content: string;
     } | undefined>;
+    findFirstMatch(normalizedPaths: string[]): Promise<FileListMatchResult>;
     private getOrBuild;
 }
 export {};

package/esm/src/platform/adapters/fs/veryfront/file-list-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-list-index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/file-list-index.ts"],"names":[],"mappings":"AAIA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAeD,qBAAa,aAAa;IAOtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IANpC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,YAAY,CAA8B;gBAG/B,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC,aAAA;IAG1F,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI7C,KAAK,IAAI,IAAI;YAUC,WAAW;IAWnB,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA4B3D,oBAAoB,CACxB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;YAc3C,UAAU;CA0EzB"}
+{"version":3,"file":"file-list-index.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/file-list-index.ts"],"names":[],"mappings":"AAIA,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,yBAAyB,GAAG,KAAK,CAAC;IACtE,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAeD,qBAAa,aAAa;IAStB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;IARpC,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAA8B;gBAG/B,gBAAgB,CAAC,GAAE,MAAM,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC,aAAA;IAG1F,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI7C,KAAK,IAAI,IAAI;YAYC,WAAW;IAWnB,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAK3D,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA8C3D,oBAAoB,CACxB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAMnD,cAAc,CAClB,eAAe,EAAE,MAAM,EAAE,GACxB,OAAO,CAAC,mBAAmB,CAAC;YA6BjB,UAAU;CAoGzB"}

package/esm/src/platform/adapters/fs/veryfront/file-list-index.js

@@ -13,8 +13,10 @@ const INDEX_STALENESS_LIMIT_MS = 5 * 60 * 1000; // 5 minutes
 export class FileListIndex {
     getFileListCache;
     index = null;
+    pathSet = null;
     indexKey = null;
     indexBuiltAt = 0;
+    indexFresh = false;
     readyPromise = null;
     constructor(getFileListCache) {
         this.getFileListCache = getFileListCache;
@@ -27,8 +29,10 @@ export class FileListIndex {
             return;
         const indexedWithContent = this.index.size;
         this.index = null;
+        this.pathSet = null;
         this.indexKey = null;
         this.indexBuiltAt = 0;
+        this.indexFresh = false;
         logger.debug("Cleared file list index", { indexedWithContent });
     }
     async ensureReady() {
@@ -43,19 +47,35 @@ export class FileListIndex {
         }
     }
     async lookup(normalizedPath) {
+        const match = await this.match(normalizedPath);
+        return match.status === "hit" ? match.content : undefined;
+    }
+    async match(normalizedPath) {
         await this.ensureReady();
-        const index = await this.getOrBuild();
-        if (!index) {
+        const snapshot = await this.getOrBuild();
+        if (!snapshot) {
             logger.debug("No file list cache available");
-            return undefined;
+            return { status: "unavailable", fresh: false };
         }
-        const content = index.get(normalizedPath);
-        if (!content) {
+        if (!snapshot.paths.has(normalizedPath)) {
             logger.debug("Content not in file list index", {
                 path: normalizedPath,
-                indexSize: index.size,
+                indexSize: snapshot.content.size,
+                fresh: snapshot.fresh,
             });
-            return undefined;
+            return { status: "missing", fresh: snapshot.fresh };
+        }
+        const content = snapshot.content.get(normalizedPath);
+        if (!content) {
+            logger.debug("File list index contains path without inline content", {
+                path: normalizedPath,
+                fresh: snapshot.fresh,
+            });
+            return {
+                status: "present_without_content",
+                fresh: snapshot.fresh,
+                path: normalizedPath,
+            };
         }
         logger.debug("FILE_LIST_CACHE_HIT - serving from file list cache", {
             path: normalizedPath,
@@ -63,19 +83,43 @@ export class FileListIndex {
             contentHash: hashPreview(content),
             contentPreview: previewText(content, 200).replace(/\n/g, "\\n"),
         });
-        return content;
+        return {
+            status: "hit",
+            fresh: snapshot.fresh,
+            path: normalizedPath,
+            content,
+        };
     }
     async findFirstWithContent(normalizedPaths) {
-        await this.ensureReady();
-        const index = await this.getOrBuild();
-        if (!index)
+        const match = await this.findFirstMatch(normalizedPaths);
+        if (match.status !== "hit" || !match.path || !match.content)
             return undefined;
+        return { path: match.path, content: match.content };
+    }
+    async findFirstMatch(normalizedPaths) {
+        await this.ensureReady();
+        const snapshot = await this.getOrBuild();
+        if (!snapshot)
+            return { status: "unavailable", fresh: false };
         for (const path of normalizedPaths) {
-            const content = index.get(path);
-            if (content)
-                return { path, content };
+            if (!snapshot.paths.has(path))
+                continue;
+            const content = snapshot.content.get(path);
+            if (content) {
+                return {
+                    status: "hit",
+                    fresh: snapshot.fresh,
+                    path,
+                    content,
+                };
+            }
+            return {
+                status: "present_without_content",
+                fresh: snapshot.fresh,
+                path,
+            };
         }
-        return undefined;
+        return { status: "missing", fresh: snapshot.fresh };
     }
     async getOrBuild() {
         if (!this.getFileListCache) {
@@ -95,7 +139,12 @@ export class FileListIndex {
                         indexSize: this.index.size,
                         indexAgeMs: age,
                     });
-                    return this.index;
+                    this.indexFresh = false;
+                    return {
+                        content: this.index,
+                        paths: this.pathSet ?? new Set(),
+                        fresh: false,
+                    };
                 }
                 logger.debug("getOrBuildFileListIndex: in-memory index too stale, discarding", {
                     indexSize: this.index.size,
@@ -103,7 +152,9 @@ export class FileListIndex {
                     staleLimitMs: INDEX_STALENESS_LIMIT_MS,
                 });
                 this.index = null;
+                this.pathSet = null;
                 this.indexKey = null;
+                this.indexFresh = false;
             }
             logger.debug("[ReadOperations] getOrBuildFileListIndex: getFileListCache returned null/undefined");
             return null;
@@ -117,18 +168,27 @@ export class FileListIndex {
             sampleContentPreview: cacheCheckSample?.content?.slice(0, 200)?.replace(/\n/g, "\\n"),
         });
         const indexKey = `${fileList.length}:${fileList[0]?.path ?? ""}:${fileList[fileList.length - 1]?.path ?? ""}`;
-        if (this.index && this.indexKey === indexKey) {
+        if (this.index && this.pathSet && this.indexKey === indexKey) {
             this.indexBuiltAt = Date.now();
-            return this.index;
+            this.indexFresh = true;
+            return {
+                content: this.index,
+                paths: this.pathSet,
+                fresh: true,
+            };
         }
         const index = new Map();
+        const pathSet = new Set();
         for (const file of fileList) {
+            pathSet.add(file.path);
             if (file.content)
                 index.set(file.path, file.content);
         }
         this.index = index;
+        this.pathSet = pathSet;
         this.indexKey = indexKey;
         this.indexBuiltAt = Date.now();
+        this.indexFresh = true;
         const sampleFile = fileList.find((f) => /welcome/i.test(f.path));
         const sampleContent = sampleFile?.content;
         logger.debug("Built file list index", {
@@ -139,6 +199,10 @@ export class FileListIndex {
             sampleContentHash: sampleContent ? hashPreview(sampleContent) : undefined,
             sampleContentPreview: sampleContent?.slice(0, 200)?.replace(/\n/g, "\\n"),
         });
-        return index;
+        return {
+            content: index,
+            paths: pathSet,
+            fresh: true,
+        };
     }
 }

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

@@ -1,6 +1,9 @@
 import { READ_OPERATION_EXTENSION_PRIORITY } from "./extension-priority.js";
 import type { ResolvedContentContext } from "./types.js";
 export { READ_OPERATION_EXTENSION_PRIORITY };
+export type NotFoundLikeError = Error & {
+    code?: string;
+};
 interface ReadContextProviderLike {
     isProductionMode: () => boolean;
     isPersistentCacheInvalidated?: (prefix: string) => boolean;
@@ -28,9 +31,11 @@ interface BuildReadFetchStateOptions {
 export declare function assertProjectSourcePath(normalizedPath: string): void;
 export declare function buildReadFetchState(options: BuildReadFetchStateOptions): ReadFetchState;
 export declare function getResolvedCacheKey(cacheKeyPrefix: string, normalizedResolvedPath: string): string;
+export declare function buildExtensionCandidatePaths(basePath: string): string[];
 export declare function splitKnownFileExtension(apiPath: string): {
     originalExtension: string;
     basePath: string;
 } | null;
 export declare function isNotFoundLikeError(error: unknown): boolean;
+export declare function createNotFoundLikeError(path: string): NotFoundLikeError;
 //# sourceMappingURL=read-operations-helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"read-operations-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,iCAAiC,EAAE,CAAC;AAE7C,UAAU,uBAAuB;IAC/B,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,0BAA0B;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,cAAc,CA2BvF;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,sBAAsB,EAAE,MAAM,GAC7B,MAAM,CAER;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG3D"}
+{"version":3,"file":"read-operations-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/src/platform/adapters/fs/veryfront/read-operations-helpers.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,EAAE,iCAAiC,EAAE,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,UAAU,uBAAuB;IAC/B,gBAAgB,EAAE,MAAM,OAAO,CAAC;IAChC,4BAA4B,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3D,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5D;AAED,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,UAAU,0BAA0B;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC9C,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAC/C;AAED,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAOpE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,cAAc,CA2BvF;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,MAAM,EACtB,sBAAsB,EAAE,MAAM,GAC7B,MAAM,CAER;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvE;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GACd;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASxD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG3D;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAEvE"}

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

@@ -40,6 +40,9 @@ export function buildReadFetchState(options) {
 export function getResolvedCacheKey(cacheKeyPrefix, normalizedResolvedPath) {
     return `${cacheKeyPrefix}:${normalizedResolvedPath}`;
 }
+export function buildExtensionCandidatePaths(basePath) {
+    return READ_OPERATION_EXTENSION_PRIORITY.map((ext) => `${basePath}${ext}`);
+}
 export function splitKnownFileExtension(apiPath) {
     const extMatch = apiPath.match(/\.(tsx|ts|jsx|js|mdx|md)$/);
     if (!extMatch)
@@ -54,3 +57,6 @@ export function isNotFoundLikeError(error) {
     const errorMessage = error instanceof Error ? error.message : String(error);
     return errorMessage.includes("404") || errorMessage.includes("Not Found");
 }
+export function createNotFoundLikeError(path) {
+    return Object.assign(new Error(`404 Not Found: ${path}`), { code: "ENOENT" });
+}