veryfront 0.0.80 → 0.0.82

package/esm/deno.js

@@ -1,6 +1,6 @@
 export default {
     "name": "veryfront",
-    "version": "0.0.80",
+    "version": "0.0.82",
     "nodeModulesDir": "auto",
     "exclude": [
         "npm/",

package/esm/src/cache/backend.d.ts

@@ -121,6 +121,26 @@ export declare function isApiCacheAvailable(env?: RuntimeEnv): boolean;
  * Preference: API (production) > Redis (local/OSS) > Memory (fallback)
  */
 export declare function createCacheBackend(config?: CacheBackendConfig): Promise<CacheBackend>;
+/**
+ * Check if a cache backend supports distributed (cross-pod) caching.
+ *
+ * Use this instead of checking `backend.type === "memory"` directly,
+ * which is a leaky abstraction that exposes implementation details.
+ */
+export declare function isDistributedBackend(backend: CacheBackend): boolean;
+/**
+ * Create a lazy-initialized distributed cache accessor.
+ *
+ * This encapsulates the common pattern of:
+ * 1. Lazy-init a cache backend via Singleflight
+ * 2. Skip if memory-only (not useful for cross-pod sharing)
+ * 3. Return null if init fails
+ *
+ * @param factory - Function that creates the cache backend
+ * @param name - Log prefix for debug messages
+ * @returns A function that returns the distributed cache backend or null
+ */
+export declare function createDistributedCacheAccessor(factory: () => Promise<CacheBackend>, name: string): () => Promise<CacheBackend | null>;
 /** Convenience wrappers for common cache patterns. */
 export declare const CacheBackends: {
     /** Transform cache for compiled code. */

package/esm/src/cache/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/src/cache/backend.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/src/cache/backend.ts"],"names":[],"mappings":"AAsBA,OAAO,EAA0C,KAAK,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAkCnG,+BAA+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;IAE1C,6BAA6B;IAC7B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEzC,uDAAuD;IACvD,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAE/D,uDAAuD;IACvD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE,qDAAqD;IACrD,QAAQ,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvF,8BAA8B;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhC,8CAA8C;IAC9C,YAAY,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhD,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,6CAA6C;AAC7C,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,OAAO,CAAC,KAAK,CAA2D;IACxE,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,SAA2B;IAIjD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAYxC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAuB7D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuB9C,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED,6EAA6E;AAC7E,qBAAa,iBAAkB,YAAW,YAAY;IACpD,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,SAAS,CAAS;gBAEd,SAAS,SAAc;IAInC,OAAO,CAAC,SAAS;IAIjB,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAoBxB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAWxC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAqB7D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUrF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU/B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAqBrD;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,QAAQ,CAAC,IAAI,EAAG,KAAK,CAAU;IAC/B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,GAAG,CAAC,CAAa;IACzB,OAAO,CAAC,cAAc,CAAC;gBAEX,OAAO,GAAE;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,6CAA6C;QAC7C,GAAG,CAAC,EAAE,UAAU,CAAC;QACjB,4EAA4E;QAC5E,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACxB;IAkBN,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,cAAc;YAIR,OAAO;IAmEf,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQxC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IA4BnE,6EAA6E;YAC/D,eAAe;IAKvB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYrF,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/B,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAMrD;AAED,mCAAmC;AACnC,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC9C,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,GAAG,CAAC,EAAE,UAAU,CAAC;IACjB,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAc7D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,kBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAyCzF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAEnE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,EACpC,IAAI,EAAE,MAAM,GACX,MAAM,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmCpC;AAED,sDAAsD;AACtD,eAAO,MAAM,aAAa;IACxB,yCAAyC;;IAGzC,qGAAqG;;IAGrG,oCAAoC;;IAGpC,uCAAuC;;IAGvC,+CAA+C;;IAG/C;2FACuF;;IAIvF,qEAAqE;;CAEtE,CAAC"}

package/esm/src/cache/backend.js

@@ -449,6 +449,63 @@ export function createCacheBackend(config = {}) {
         "cache.preferred_backend": preferredBackend ?? "auto",
     });
 }
+/**
+ * Check if a cache backend supports distributed (cross-pod) caching.
+ *
+ * Use this instead of checking `backend.type === "memory"` directly,
+ * which is a leaky abstraction that exposes implementation details.
+ */
+export function isDistributedBackend(backend) {
+    return backend.type !== "memory";
+}
+/**
+ * Create a lazy-initialized distributed cache accessor.
+ *
+ * This encapsulates the common pattern of:
+ * 1. Lazy-init a cache backend via Singleflight
+ * 2. Skip if memory-only (not useful for cross-pod sharing)
+ * 3. Return null if init fails
+ *
+ * @param factory - Function that creates the cache backend
+ * @param name - Log prefix for debug messages
+ * @returns A function that returns the distributed cache backend or null
+ */
+export function createDistributedCacheAccessor(factory, name) {
+    let backend;
+    const singleflight = new (class {
+        promise = null;
+        do(fn) {
+            if (!this.promise) {
+                this.promise = fn().finally(() => {
+                    this.promise = null;
+                });
+            }
+            return this.promise;
+        }
+    })();
+    return () => {
+        if (backend !== undefined)
+            return Promise.resolve(backend);
+        return singleflight.do(async () => {
+            try {
+                const b = await factory();
+                if (!isDistributedBackend(b)) {
+                    backend = null;
+                    logger.debug(`[${name}] No distributed cache available (memory only)`);
+                    return null;
+                }
+                backend = b;
+                logger.debug(`[${name}] Distributed cache initialized`, { type: b.type });
+                return b;
+            }
+            catch (error) {
+                logger.debug(`[${name}] Failed to initialize distributed cache`, { error });
+                backend = null;
+                return null;
+            }
+        });
+    };
+}
 /** Convenience wrappers for common cache patterns. */
 export const CacheBackends = {
     /** Transform cache for compiled code. */

package/esm/src/cache/hash.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Cache key types for different cache domains.
+ * Using type prefixes prevents collisions between different caches.
+ */
+export type CacheKeyType = "http" | "mod" | "esm" | "render" | "mdx" | "css" | "file" | "config";
+/**
+ * Fast, synchronous hash function for cache keys.
+ *
+ * Uses DJB2 algorithm - good distribution, very fast.
+ * Returns a positive number suitable for string conversion.
+ *
+ * @param input - String to hash
+ * @returns Positive integer hash
+ */
+export declare function fastHash(input: string): number;
+/**
+ * Convert a hash number to a compact string representation.
+ *
+ * Uses base36 for compact output (0-9, a-z).
+ */
+export declare function hashToString(hash: number): string;
+/**
+ * Fast synchronous hash that returns a string.
+ *
+ * Combines fastHash + hashToString for convenience.
+ */
+export declare function hashString(input: string): string;
+/**
+ * Generate a cache key with type prefix.
+ *
+ * Format: `{type}:{hash}`
+ *
+ * @example
+ * ```typescript
+ * getCacheKey("http", "https://esm.sh/react@18.3.1")
+ * // Returns: "http:1abc2def"
+ *
+ * getCacheKey("mod", "pages/index.tsx")
+ * // Returns: "mod:xyz789"
+ * ```
+ */
+export declare function getCacheKey(type: CacheKeyType, input: string): string;
+/**
+ * Generate a versioned cache key with type prefix.
+ *
+ * Format: `{type}:v{version}:{hash}`
+ *
+ * @example
+ * ```typescript
+ * getVersionedCacheKey("mod", 12, "pages/index.tsx:abc123")
+ * // Returns: "mod:v12:xyz789"
+ * ```
+ */
+export declare function getVersionedCacheKey(type: CacheKeyType, version: number | string, input: string): string;
+/**
+ * Generate a cache key with multiple components.
+ *
+ * Useful for keys that depend on multiple inputs.
+ * Components are joined with colons before hashing.
+ *
+ * @example
+ * ```typescript
+ * getCompoundCacheKey("mod", ["projectId", "filePath", "contentHash"])
+ * // Returns: "mod:abc123"
+ * ```
+ */
+export declare function getCompoundCacheKey(type: CacheKeyType, components: string[]): string;
+/**
+ * Parse a cache key into its components.
+ *
+ * @returns The type prefix and hash, or null if invalid format
+ */
+export declare function parseCacheKey(key: string): {
+    type: string;
+    hash: string;
+    version?: string;
+} | null;
+/**
+ * SHA-256 async hash for content-addressed keys.
+ *
+ * Use this when you need cryptographic strength (e.g., content hashes).
+ * For cache keys where speed matters more, use hashString().
+ */
+export declare function sha256Hash(input: string): Promise<string>;
+/**
+ * Short SHA-256 hash (8 characters).
+ *
+ * Good balance between collision resistance and key length.
+ */
+export declare function sha256Short(input: string): Promise<string>;
+/**
+ * Generate HTTP bundle filename from URL.
+ *
+ * Consistent with existing http-cache.ts format: `http-{hash}.mjs`
+ */
+export declare function getHttpBundleFilename(normalizedUrl: string): string;
+/**
+ * Extract hash from HTTP bundle filename.
+ *
+ * @returns The hash string, or null if not a valid bundle filename
+ */
+export declare function parseHttpBundleFilename(filename: string): string | null;
+/**
+ * Check if a value looks like a cache key.
+ */
+export declare function isCacheKey(value: string): boolean;
+//# sourceMappingURL=hash.d.ts.map

package/esm/src/cache/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../src/src/cache/hash.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,KAAK,GACL,KAAK,GACL,QAAQ,GACR,KAAK,GACL,KAAK,GACL,MAAM,GACN,QAAQ,CAAC;AAEb;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ9C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,KAAK,EAAE,MAAM,GACZ,MAAM,CAGR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CAGpF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,GACV;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBzD;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM/D;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGhE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGvE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/esm/src/cache/hash.js

@@ -0,0 +1,166 @@
+/**
+ * Standardized Cache Hashing Utilities
+ *
+ * Provides consistent hashing for cache keys across the codebase.
+ * All cache keys should use these utilities to ensure:
+ * - Consistent format with type prefixes
+ * - Collision resistance between different cache types
+ * - Easy debugging and key parsing
+ *
+ * Key format: `{type}:{hash}` or `{type}:{version}:{hash}`
+ *
+ * @module cache/hash
+ */
+import * as dntShim from "../../_dnt.shims.js";
+import { simpleHash } from "../utils/hash-utils.js";
+/**
+ * Fast, synchronous hash function for cache keys.
+ *
+ * Uses DJB2 algorithm - good distribution, very fast.
+ * Returns a positive number suitable for string conversion.
+ *
+ * @param input - String to hash
+ * @returns Positive integer hash
+ */
+export function fastHash(input) {
+    let hash = 5381;
+    for (let i = 0; i < input.length; i++) {
+        hash = ((hash << 5) + hash) ^ input.charCodeAt(i);
+    }
+    return hash >>> 0; // Convert to unsigned 32-bit
+}
+/**
+ * Convert a hash number to a compact string representation.
+ *
+ * Uses base36 for compact output (0-9, a-z).
+ */
+export function hashToString(hash) {
+    return hash.toString(36);
+}
+/**
+ * Fast synchronous hash that returns a string.
+ *
+ * Combines fastHash + hashToString for convenience.
+ */
+export function hashString(input) {
+    return hashToString(fastHash(input));
+}
+/**
+ * Generate a cache key with type prefix.
+ *
+ * Format: `{type}:{hash}`
+ *
+ * @example
+ * ```typescript
+ * getCacheKey("http", "https://esm.sh/react@18.3.1")
+ * // Returns: "http:1abc2def"
+ *
+ * getCacheKey("mod", "pages/index.tsx")
+ * // Returns: "mod:xyz789"
+ * ```
+ */
+export function getCacheKey(type, input) {
+    const hash = hashString(input);
+    return `${type}:${hash}`;
+}
+/**
+ * Generate a versioned cache key with type prefix.
+ *
+ * Format: `{type}:v{version}:{hash}`
+ *
+ * @example
+ * ```typescript
+ * getVersionedCacheKey("mod", 12, "pages/index.tsx:abc123")
+ * // Returns: "mod:v12:xyz789"
+ * ```
+ */
+export function getVersionedCacheKey(type, version, input) {
+    const hash = hashString(input);
+    return `${type}:v${version}:${hash}`;
+}
+/**
+ * Generate a cache key with multiple components.
+ *
+ * Useful for keys that depend on multiple inputs.
+ * Components are joined with colons before hashing.
+ *
+ * @example
+ * ```typescript
+ * getCompoundCacheKey("mod", ["projectId", "filePath", "contentHash"])
+ * // Returns: "mod:abc123"
+ * ```
+ */
+export function getCompoundCacheKey(type, components) {
+    const combined = components.join(":");
+    return getCacheKey(type, combined);
+}
+/**
+ * Parse a cache key into its components.
+ *
+ * @returns The type prefix and hash, or null if invalid format
+ */
+export function parseCacheKey(key) {
+    const parts = key.split(":");
+    if (parts.length < 2)
+        return null;
+    const type = parts[0];
+    const rest = parts.slice(1);
+    // Check for version: type:vN:hash
+    if (rest[0]?.startsWith("v") && /^v\d+$/.test(rest[0])) {
+        return {
+            type,
+            version: rest[0].slice(1),
+            hash: rest.slice(1).join(":"),
+        };
+    }
+    return {
+        type,
+        hash: rest.join(":"),
+    };
+}
+/**
+ * SHA-256 async hash for content-addressed keys.
+ *
+ * Use this when you need cryptographic strength (e.g., content hashes).
+ * For cache keys where speed matters more, use hashString().
+ */
+export async function sha256Hash(input) {
+    const data = new TextEncoder().encode(input);
+    const hashBuffer = await dntShim.crypto.subtle.digest("SHA-256", data);
+    return Array.from(new Uint8Array(hashBuffer))
+        .map((b) => b.toString(16).padStart(2, "0"))
+        .join("");
+}
+/**
+ * Short SHA-256 hash (8 characters).
+ *
+ * Good balance between collision resistance and key length.
+ */
+export async function sha256Short(input) {
+    const full = await sha256Hash(input);
+    return full.slice(0, 8);
+}
+/**
+ * Generate HTTP bundle filename from URL.
+ *
+ * Consistent with existing http-cache.ts format: `http-{hash}.mjs`
+ */
+export function getHttpBundleFilename(normalizedUrl) {
+    const hash = simpleHash(normalizedUrl);
+    return `http-${hash}.mjs`;
+}
+/**
+ * Extract hash from HTTP bundle filename.
+ *
+ * @returns The hash string, or null if not a valid bundle filename
+ */
+export function parseHttpBundleFilename(filename) {
+    const match = filename.match(/^http-(\d+)\.mjs$/);
+    return match?.[1] ?? null;
+}
+/**
+ * Check if a value looks like a cache key.
+ */
+export function isCacheKey(value) {
+    return /^[a-z]+:[a-z0-9]+/.test(value);
+}

package/esm/src/cache/index.d.ts

@@ -1,4 +1,7 @@
 export * from "./backend.js";
+export * from "./multi-tier.js";
+export * from "./module-cache.js";
+export * from "./hash.js";
 export { type CacheKeyContext, extractCacheKeyContext, getContentHashKey, getCurrentCacheKeyContext, getProjectScopedKey, getProjectScopedKeyAlways, type MultiProjectRequestContext, runWithCacheKeyContext, tryGetCacheKeyContext, } from "./cache-key-builder.js";
 export { buildComponentCacheKey, buildConfigCacheKey, buildContentHashCacheKey, buildDirCacheKeyPrefix, buildErrorPageCacheKey, buildFileCacheKeyPrefix, buildFileListCacheKey, buildFileOperationCacheKey, buildGitHubBytesCacheKey, buildGitHubContentCacheKey, buildGitHubDirCacheKey, buildGitHubResolveCacheKey, buildGitHubStatCacheKey, buildGitHubTreeCacheKey, buildLayoutComponentCacheKey, buildModuleResolveCacheKey, buildModuleTransformCacheKey, buildProxyManagerCacheKey, buildRedisFileCacheKey, buildRedisSSRModuleKey, buildRedisTransformKey, buildRenderCacheKey, buildRenderCachePrefix, buildSSRModuleCacheKey, buildSSRModuleProjectKey, buildStatCacheKeyPrefix, buildTransformCacheKey, CacheKeyPrefix, cacheRegistry, createCacheKeyFilter, deleteAllKeysForProject, deleteAllKeysForProjectAsync, type FileOperationContext, type FileSourceType, getAllKeysForProject, getAllKeysForProjectAsync, getCacheKeyVersion, parseRenderCacheKey, } from "./keys.js";
 export { type CacheStore, extractProjectIdFromKey, isKeyForProject, LRUCacheStore, MapCacheStore, registerLRUCache, registerMapCache, } from "./registry.js";

package/esm/src/cache/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/cache/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAE7B,OAAO,EACL,KAAK,eAAe,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,UAAU,EACf,uBAAuB,EACvB,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/cache/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,WAAW,CAAC;AAE1B,OAAO,EACL,KAAK,eAAe,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,0BAA0B,EAC/B,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,UAAU,EACf,uBAAuB,EACvB,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,eAAe,CAAC"}

package/esm/src/cache/index.js

@@ -1,4 +1,7 @@
 export * from "./backend.js";
+export * from "./multi-tier.js";
+export * from "./module-cache.js";
+export * from "./hash.js";
 export { extractCacheKeyContext, getContentHashKey, getCurrentCacheKeyContext, getProjectScopedKey, getProjectScopedKeyAlways, runWithCacheKeyContext, tryGetCacheKeyContext, } from "./cache-key-builder.js";
 export { buildComponentCacheKey, buildConfigCacheKey, buildContentHashCacheKey, buildDirCacheKeyPrefix, buildErrorPageCacheKey, buildFileCacheKeyPrefix, buildFileListCacheKey, buildFileOperationCacheKey, buildGitHubBytesCacheKey, buildGitHubContentCacheKey, buildGitHubDirCacheKey, buildGitHubResolveCacheKey, buildGitHubStatCacheKey, buildGitHubTreeCacheKey, buildLayoutComponentCacheKey, buildModuleResolveCacheKey, buildModuleTransformCacheKey, buildProxyManagerCacheKey, buildRedisFileCacheKey, buildRedisSSRModuleKey, buildRedisTransformKey, buildRenderCacheKey, buildRenderCachePrefix, buildSSRModuleCacheKey, buildSSRModuleProjectKey, buildStatCacheKeyPrefix, buildTransformCacheKey, CacheKeyPrefix, cacheRegistry, createCacheKeyFilter, deleteAllKeysForProject, deleteAllKeysForProjectAsync, getAllKeysForProject, getAllKeysForProjectAsync, getCacheKeyVersion, parseRenderCacheKey, } from "./keys.js";
 export { extractProjectIdFromKey, isKeyForProject, LRUCacheStore, MapCacheStore, registerLRUCache, registerMapCache, } from "./registry.js";

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

@@ -0,0 +1,82 @@
+/**
+ * Pod-Level Module Cache Singleton
+ *
+ * Provides shared module caches that persist across all RenderPipeline instances
+ * within a pod. This dramatically improves cache hit rates for unchanged modules
+ * compared to per-request caches.
+ *
+ * Features:
+ * - LRU eviction to bound memory usage
+ * - TTL-based expiration to pick up source changes
+ * - Automatic registration with cache registry for debugging
+ * - Project-scoped invalidation support
+ *
+ * @module cache/module-cache
+ */
+import { LRUCache } from "../utils/lru-wrapper.js";
+/**
+ * Cache statistics for monitoring.
+ */
+interface ModuleCacheStats {
+    moduleCache: {
+        size: number;
+        maxEntries: number;
+        ttlMs: number;
+    };
+    esmCache: {
+        size: number;
+        maxEntries: number;
+        ttlMs: number;
+    };
+}
+/**
+ * Get or create the pod-level module cache.
+ *
+ * The cache is created lazily on first access and persists for the pod's lifetime.
+ * Uses LRU eviction and TTL-based expiration.
+ */
+export declare function getModuleCache(): LRUCache<string, string>;
+/**
+ * Get or create the pod-level ESM cache.
+ *
+ * Used for caching ESM resolution results (specifier → URL mappings).
+ */
+export declare function getEsmCache(): LRUCache<string, string>;
+/**
+ * Create a Map-compatible interface for the module cache.
+ *
+ * This provides backward compatibility with code expecting Map<string, string>.
+ * The underlying storage is the pod-level LRU cache singleton.
+ */
+export declare function createModuleCache(): Map<string, string>;
+/**
+ * Create a Map-compatible interface for the ESM cache.
+ *
+ * This provides backward compatibility with code expecting Map<string, string>.
+ */
+export declare function createEsmCache(): Map<string, string>;
+/**
+ * Get statistics about the module caches.
+ */
+export declare function getModuleCacheStats(): ModuleCacheStats;
+/**
+ * Clear all module caches.
+ *
+ * Used for invalidation when project content changes.
+ */
+export declare function clearModuleCaches(): void;
+/**
+ * Clear module cache entries for a specific project.
+ *
+ * @param projectId - The project ID to clear entries for
+ * @returns Number of entries cleared
+ */
+export declare function clearModuleCacheForProject(projectId: string): number;
+/**
+ * Destroy the module caches and cleanup resources.
+ *
+ * Should be called on server shutdown.
+ */
+export declare function destroyModuleCaches(): void;
+export {};
+//# sourceMappingURL=module-cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module-cache.d.ts","sourceRoot":"","sources":["../../../src/src/cache/module-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AA0BnD;;GAEG;AACH,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;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBtD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAGvD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAGpD;AAyDD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAatD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAsBpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}