veryfront 0.0.81 → 0.0.83

package/esm/proxy/tracing.js

@@ -0,0 +1,194 @@
+/**
+ * OpenTelemetry OTLP tracing for proxy.
+ * Env: OTEL_TRACES_ENABLED, OTEL_SERVICE_NAME, OTEL_EXPORTER_OTLP_ENDPOINT, OTEL_EXPORTER_OTLP_HEADERS
+ */
+import * as dntShim from "../_dnt.shims.js";
+// Inline cross-runtime getEnv to avoid dependency on src/platform/compat (not copied in Docker)
+function getEnv(key) {
+    // Deno
+    if (typeof dntShim.Deno !== "undefined" && dntShim.Deno.env?.get) {
+        return dntShim.Deno.env.get(key);
+    }
+    // Node.js / Bun
+    const nodeProcess = dntShim.dntGlobalThis.process;
+    return nodeProcess?.env?.[key];
+}
+let initialized = false;
+let tracerProvider = null;
+let tracer = null;
+function parseHeaders(headerString) {
+    if (!headerString)
+        return {};
+    const headers = {};
+    for (const part of headerString.split(",")) {
+        const [key, ...valueParts] = part.split("=");
+        if (key && valueParts.length > 0) {
+            headers[key.trim()] = valueParts.join("=").trim();
+        }
+    }
+    return headers;
+}
+function getConfig() {
+    return {
+        enabled: getEnv("OTEL_TRACES_ENABLED") === "true",
+        serviceName: getEnv("OTEL_SERVICE_NAME") || "veryfront-proxy",
+        endpoint: getEnv("OTEL_EXPORTER_OTLP_ENDPOINT") || "",
+        headers: parseHeaders(getEnv("OTEL_EXPORTER_OTLP_HEADERS")),
+    };
+}
+let traceApi = null;
+let propagationApi = null;
+async function loadApis() {
+    if (traceApi)
+        return;
+    traceApi = await import("@opentelemetry/api");
+    propagationApi = await import("@opentelemetry/core");
+}
+export async function initializeOTLP() {
+    if (initialized)
+        return;
+    const config = getConfig();
+    if (!config.enabled) {
+        initialized = true;
+        return;
+    }
+    if (!config.endpoint) {
+        console.warn("[otel] No endpoint configured");
+        initialized = true;
+        return;
+    }
+    try {
+        const { trace } = await import("@opentelemetry/api");
+        const { BasicTracerProvider, BatchSpanProcessor } = await import("@opentelemetry/sdk-trace-base");
+        const { OTLPTraceExporter } = await import("@opentelemetry/exporter-trace-otlp-http");
+        const { Resource } = await import("@opentelemetry/resources");
+        const { ATTR_SERVICE_NAME } = await import("@opentelemetry/semantic-conventions");
+        const resource = new Resource({ [ATTR_SERVICE_NAME]: config.serviceName });
+        const exporter = new OTLPTraceExporter({
+            url: `${config.endpoint}/v1/traces`,
+            headers: config.headers,
+        });
+        const provider = new BasicTracerProvider({ resource });
+        provider.addSpanProcessor(new BatchSpanProcessor(exporter));
+        provider.register();
+        tracerProvider = provider;
+        tracer = trace.getTracer(config.serviceName);
+        initialized = true;
+        await loadApis();
+        console.log("[otel] Initialized", {
+            serviceName: config.serviceName,
+            endpoint: config.endpoint,
+        });
+    }
+    catch (error) {
+        console.error("[otel] Init failed", { error });
+        initialized = true;
+    }
+}
+export async function shutdownOTLP() {
+    if (tracerProvider) {
+        try {
+            await tracerProvider.shutdown();
+            console.log("[otel] Shutdown complete");
+        }
+        catch (error) {
+            console.warn("[otel] Shutdown error", { error });
+        }
+    }
+}
+export function isOTLPEnabled() {
+    return initialized && tracerProvider !== null;
+}
+export function extractContext(headers) {
+    if (!traceApi || !propagationApi)
+        return undefined;
+    const carrier = {};
+    headers.forEach((v, k) => (carrier[k.toLowerCase()] = v));
+    return new propagationApi.W3CTraceContextPropagator().extract(traceApi.context.active(), carrier, traceApi.defaultTextMapGetter);
+}
+export function injectContext(headers) {
+    if (!traceApi || !propagationApi)
+        return;
+    const carrier = {};
+    new propagationApi.W3CTraceContextPropagator().inject(traceApi.context.active(), carrier, traceApi.defaultTextMapSetter);
+    Object.entries(carrier).forEach(([k, v]) => headers.set(k, v));
+}
+export function startServerSpan(method, path, parentContext) {
+    if (!traceApi || !tracer)
+        return null;
+    const ctx = parentContext || traceApi.context.active();
+    const span = tracer.startSpan(`${method} ${path}`, { kind: traceApi.SpanKind.SERVER }, ctx);
+    return { span, context: traceApi.trace.setSpan(ctx, span) };
+}
+export function endSpan(span, statusCode, error) {
+    if (!span || !traceApi)
+        return;
+    span.setAttribute("http.status_code", statusCode);
+    if (error) {
+        span.setStatus({ code: traceApi.SpanStatusCode.ERROR, message: error.message });
+        span.recordException(error);
+    }
+    else if (statusCode >= 400) {
+        span.setStatus({ code: traceApi.SpanStatusCode.ERROR });
+    }
+    span.end();
+}
+export function withContext(spanContext, fn) {
+    if (!traceApi)
+        return fn();
+    return traceApi.context.with(spanContext, fn);
+}
+export function getTraceContext() {
+    if (!traceApi)
+        return {};
+    const span = traceApi.trace.getSpan(traceApi.context.active());
+    if (!span)
+        return {};
+    const ctx = span.spanContext();
+    return { traceId: ctx.traceId, spanId: ctx.spanId };
+}
+/**
+ * Span names for proxy tracing.
+ */
+export const ProxySpanNames = {
+    PROXY_REQUEST: "proxy.request",
+    PROXY_PROCESS: "proxy.process",
+    PROXY_TOKEN_FETCH: "proxy.token_fetch",
+    PROXY_DOMAIN_LOOKUP: "proxy.domain_lookup",
+    OAUTH_TOKEN_REQUEST: "oauth.token_request",
+    HTTP_CLIENT_FETCH: "http.client.fetch",
+};
+/**
+ * Execute an async function within a tracing span.
+ * If tracing is disabled, executes the function directly.
+ */
+export async function withSpan(name, fn, attributes) {
+    if (!traceApi || !tracer) {
+        return await fn();
+    }
+    const parentContext = traceApi.context.active();
+    const span = tracer.startSpan(name, {
+        kind: traceApi.SpanKind.INTERNAL,
+        attributes,
+    }, parentContext);
+    const spanContext = traceApi.trace.setSpan(parentContext, span);
+    try {
+        const result = await traceApi.context.with(spanContext, fn);
+        span.setStatus({ code: traceApi.SpanStatusCode.OK });
+        return result;
+    }
+    catch (error) {
+        span.setStatus({
+            code: traceApi.SpanStatusCode.ERROR,
+            message: error instanceof Error ? error.message : String(error),
+        });
+        if (error instanceof Error) {
+            span.recordException(error);
+        }
+        throw error;
+    }
+    finally {
+        span.end();
+    }
+}
+export { initializeOTLP as initializeOTLPWithApis };

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. */
@@ -136,6 +156,8 @@ export declare const CacheBackends: {
     /** HTTP module cache for ESM.sh modules (cross-pod sharing).
      * Uses separate circuit breaker to prevent cascade failures from blocking recovery. */
     httpModule: () => Promise<CacheBackend>;
+    /** SSR module cache for React loader (cross-pod sharing). */
+    ssrModule: () => Promise<CacheBackend>;
     /** Project CSS cache for Tailwind CSS output (cross-pod sharing). */
     projectCSS: () => Promise<CacheBackend>;
 };

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":"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"}

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. */
@@ -464,6 +521,8 @@ export const CacheBackends = {
     /** HTTP module cache for ESM.sh modules (cross-pod sharing).
      * Uses separate circuit breaker to prevent cascade failures from blocking recovery. */
     httpModule: () => createCacheBackend({ keyPrefix: "http-module", circuitBreakerName: "api-cache-http" }),
+    /** SSR module cache for React loader (cross-pod sharing). */
+    ssrModule: () => createCacheBackend({ keyPrefix: "ssr-module" }),
     /** Project CSS cache for Tailwind CSS output (cross-pod sharing). */
     projectCSS: () => createCacheBackend({ keyPrefix: "project-css" }),
 };

package/esm/src/cache/cache-key-builder.d.ts

@@ -21,8 +21,4 @@ export declare function getProjectScopedKey(prefix: string, resourceKey: string)
 export declare function getProjectScopedKeyAlways(prefix: string, resourceKey: string): string | null;
 export declare function extractCacheKeyContext(handlerCtx: HandlerContext): CacheKeyContext;
 export type { MultiProjectRequestContextType as MultiProjectRequestContext };
-/**
- * @deprecated Use tryGetCacheKeyContext() which auto-detects context
- */
-export declare function extractCacheKeyContextFromRequestContext(reqCtx: MultiProjectRequestContextType): CacheKeyContext;
 //# sourceMappingURL=cache-key-builder.d.ts.map

package/esm/src/cache/cache-key-builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-key-builder.d.ts","sourceRoot":"","sources":["../../../src/src/cache/cache-key-builder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,KAAK,8BAA8B,GAAG;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAUF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAQD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAGR;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE9E;AAED,wBAAgB,yBAAyB,IAAI,eAAe,CAQ3D;AA4BD,wBAAgB,qBAAqB,IAAI,eAAe,GAAG,IAAI,CAS9D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5F;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,cAAc,GAAG,eAAe,CAQlF;AAED,YAAY,EAAE,8BAA8B,IAAI,0BAA0B,EAAE,CAAC;AAE7E;;GAEG;AACH,wBAAgB,wCAAwC,CACtD,MAAM,EAAE,8BAA8B,GACrC,eAAe,CAEjB"}
+{"version":3,"file":"cache-key-builder.d.ts","sourceRoot":"","sources":["../../../src/src/cache/cache-key-builder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,KAAK,8BAA8B,GAAG;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC,CAAC;AAUF,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAQD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAGR;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAE9E;AAED,wBAAgB,yBAAyB,IAAI,eAAe,CAQ3D;AA4BD,wBAAgB,qBAAqB,IAAI,eAAe,GAAG,IAAI,CAS9D;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtF;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5F;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,cAAc,GAAG,eAAe,CAQlF;AAED,YAAY,EAAE,8BAA8B,IAAI,0BAA0B,EAAE,CAAC"}

package/esm/src/cache/cache-key-builder.js

@@ -76,9 +76,3 @@ export function extractCacheKeyContext(handlerCtx) {
         : (handlerCtx.parsedDomain?.branch || "main");
     return { projectId, mode, versionId };
 }
-/**
- * @deprecated Use tryGetCacheKeyContext() which auto-detects context
- */
-export function extractCacheKeyContextFromRequestContext(reqCtx) {
-    return extractCacheKeyContextFromMultiProjectContext(reqCtx);
-}

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";