@rangojs/router 0.0.0-experimental.debug-cache-2383ca26 → 0.0.0-experimental.df7974ff

package/dist/cache/cf/cf-cache-store.js

@@ -0,0 +1,242 @@
+/// <reference path="../../vite/version.d.ts" />
+import { getRequestContext, } from "../../server/request-context.js";
+import { VERSION } from "@rangojs/router:version";
+// ============================================================================
+// Constants
+// ============================================================================
+/** Header storing timestamp when entry becomes stale */
+export const CACHE_STALE_AT_HEADER = "x-edge-cache-stale-at";
+/** Header storing cache status: HIT | REVALIDATING */
+export const CACHE_STATUS_HEADER = "x-edge-cache-status";
+/**
+ * Maximum age in seconds for REVALIDATING status before allowing new revalidation.
+ * After this period, a stale entry in REVALIDATING status will trigger revalidation again.
+ * @internal
+ */
+export const MAX_REVALIDATION_INTERVAL = 30;
+// ============================================================================
+// CFCacheStore Implementation
+// ============================================================================
+export class CFCacheStore {
+    constructor(options) {
+        if (!options.ctx) {
+            throw new Error("[CFCacheStore] ExecutionContext (ctx) is required. " +
+                "Pass the Cloudflare ExecutionContext from your worker's fetch handler: " +
+                "new CFCacheStore({ ctx: env.ctx })");
+        }
+        this.namespace = options.namespace;
+        this.baseUrl = options.baseUrl ?? this.deriveBaseUrl();
+        this.defaults = options.defaults;
+        this.version = options.version ?? VERSION;
+        this.keyGenerator = options.keyGenerator;
+        this.waitUntil = (fn) => options.ctx.waitUntil(fn());
+    }
+    /**
+     * Derive base URL from request hostname via requestContext.
+     * Uses internal fallback for dev/preview environments.
+     * @internal
+     */
+    deriveBaseUrl() {
+        const fallback = "https://rsc-cache.internal.com/";
+        const ctx = getRequestContext();
+        if (!ctx?.request) {
+            return fallback;
+        }
+        try {
+            const url = new URL(ctx.request.url);
+            const hostname = url.hostname;
+            // Use fallback for dev/preview environments
+            if (hostname === "localhost" ||
+                hostname === "127.0.0.1" ||
+                hostname.endsWith(".workers.dev") ||
+                hostname.endsWith(".pages.dev")) {
+                return fallback;
+            }
+            // Use actual hostname for production
+            return `https://${hostname}/`;
+        }
+        catch {
+            return fallback;
+        }
+    }
+    /**
+     * Get the cache instance - uses caches.default unless namespace is specified.
+     * @internal
+     */
+    getCache() {
+        if (this.namespace) {
+            return caches.open(this.namespace);
+        }
+        return caches.default;
+    }
+    /**
+     * Get cached entry data by key.
+     *
+     * Handles SWR atomically:
+     * - If stale and not already revalidating, marks as REVALIDATING and returns shouldRevalidate: true
+     * - If already REVALIDATING (and recent), returns shouldRevalidate: false
+     * - If fresh, returns shouldRevalidate: false
+     *
+     * The atomic mark prevents thundering herd - only first request triggers revalidation.
+     */
+    async get(key) {
+        try {
+            const cache = await this.getCache();
+            const request = this.keyToRequest(key);
+            const response = await cache.match(request);
+            if (!response) {
+                return null;
+            }
+            // Read status headers
+            const status = response.headers.get(CACHE_STATUS_HEADER);
+            const age = Number(response.headers.get("age") ?? "0");
+            const staleAt = Number(response.headers.get(CACHE_STALE_AT_HEADER) ?? "0");
+            const isStale = staleAt > 0 && Date.now() > staleAt;
+            const isRevalidating = status === "REVALIDATING" && age < MAX_REVALIDATION_INTERVAL;
+            // Case 1: Fresh or already being revalidated - just return data
+            if (!isStale || isRevalidating) {
+                const data = (await response.json());
+                return { data, shouldRevalidate: false };
+            }
+            // Case 2: Stale and needs revalidation - atomically mark REVALIDATING
+            const [b1, b2] = response.body.tee();
+            const headers = new Headers(response.headers);
+            headers.set(CACHE_STATUS_HEADER, "REVALIDATING");
+            // Blocking write - must complete before returning to prevent race
+            await cache.put(request, new Response(b1, { status: response.status, headers }));
+            const data = (await new Response(b2).json());
+            return { data, shouldRevalidate: true };
+        }
+        catch (error) {
+            console.error("[CFCacheStore] get failed:", error);
+            return null;
+        }
+    }
+    /**
+     * Store entry data with TTL and optional SWR window.
+     * Uses waitUntil for non-blocking write when available.
+     */
+    async set(key, data, ttl, swr) {
+        try {
+            const cache = await this.getCache();
+            const request = this.keyToRequest(key);
+            // Extended TTL covers SWR window
+            const swrWindow = swr ?? this.defaults?.swr ?? 0;
+            const totalTtl = ttl + swrWindow;
+            const staleAt = Date.now() + ttl * 1000;
+            const response = new Response(JSON.stringify(data), {
+                headers: {
+                    "Content-Type": "application/json",
+                    "Cache-Control": `public, max-age=${totalTtl}`,
+                    [CACHE_STALE_AT_HEADER]: String(staleAt),
+                    [CACHE_STATUS_HEADER]: "HIT",
+                },
+            });
+            const putPromise = cache.put(request, response);
+            if (this.waitUntil) {
+                // Non-blocking write
+                this.waitUntil(async () => {
+                    await putPromise;
+                });
+            }
+            else {
+                // Blocking fallback
+                await putPromise;
+            }
+        }
+        catch (error) {
+            console.error("[CFCacheStore] set failed:", error);
+        }
+    }
+    /**
+     * Delete a cached entry
+     */
+    async delete(key) {
+        try {
+            const cache = await this.getCache();
+            return await cache.delete(this.keyToRequest(key));
+        }
+        catch (error) {
+            console.error("[CFCacheStore] delete failed:", error);
+            return false;
+        }
+    }
+    // ============================================================================
+    // Document Cache Methods
+    // ============================================================================
+    /**
+     * Get a cached Response by key (for document-level caching).
+     * Returns the response and whether it should be revalidated (SWR).
+     */
+    async getResponse(key) {
+        try {
+            const cache = await this.getCache();
+            const request = this.keyToRequest(`doc:${key}`);
+            const response = await cache.match(request);
+            if (!response || response.status !== 200) {
+                return null;
+            }
+            // Check staleness
+            const staleAt = Number(response.headers.get(CACHE_STALE_AT_HEADER) || 0);
+            const isStale = staleAt > 0 && Date.now() > staleAt;
+            return {
+                response,
+                shouldRevalidate: isStale,
+            };
+        }
+        catch (error) {
+            console.error("[CFCacheStore] getResponse failed:", error);
+            return null;
+        }
+    }
+    /**
+     * Store a Response with TTL and optional SWR window (for document-level caching).
+     */
+    async putResponse(key, response, ttl, swr) {
+        try {
+            const cache = await this.getCache();
+            const request = this.keyToRequest(`doc:${key}`);
+            // Extended TTL covers SWR window
+            const swrWindow = swr ?? this.defaults?.swr ?? 0;
+            const totalTtl = ttl + swrWindow;
+            const staleAt = Date.now() + ttl * 1000;
+            // Clone and add cache headers
+            const headers = new Headers(response.headers);
+            headers.set("Cache-Control", `public, max-age=${totalTtl}`);
+            headers.set(CACHE_STALE_AT_HEADER, String(staleAt));
+            const toCache = new Response(response.body, {
+                status: response.status,
+                statusText: response.statusText,
+                headers,
+            });
+            const putPromise = cache.put(request, toCache);
+            if (this.waitUntil) {
+                // Non-blocking write
+                this.waitUntil(async () => {
+                    await putPromise;
+                });
+            }
+            else {
+                // Blocking fallback
+                await putPromise;
+            }
+        }
+        catch (error) {
+            console.error("[CFCacheStore] putResponse failed:", error);
+        }
+    }
+    /**
+     * Convert string key to Request object for CF Cache API.
+     * Includes version in URL if specified (for cache invalidation on code changes).
+     * @internal
+     */
+    keyToRequest(key) {
+        const encodedKey = encodeURIComponent(key);
+        // Include version in URL path to invalidate cache when version changes
+        const versionPath = this.version ? `v/${this.version}/` : "";
+        return new Request(`${this.baseUrl}${versionPath}${encodedKey}`, {
+            method: "GET",
+        });
+    }
+}
+//# sourceMappingURL=cf-cache-store.js.map

package/dist/cache/cf/cf-cache-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-cache-store.js","sourceRoot":"","sources":["../../../src/cache/cf/cf-cache-store.ts"],"names":[],"mappings":"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"}

package/dist/cache/cf/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Cloudflare Cache Store Exports
+ *
+ * Main export:
+ * - CFCacheStore - Production cache store using Cloudflare's Cache API
+ *
+ * Header constants (for inspection/debugging):
+ * - CACHE_STALE_AT_HEADER - Header containing staleness timestamp
+ * - CACHE_STATUS_HEADER - Header containing HIT/REVALIDATING status
+ */
+export { CFCacheStore, type CFCacheStoreOptions } from "./cf-cache-store.js";
+export { CACHE_STALE_AT_HEADER, CACHE_STATUS_HEADER } from "./cf-cache-store.js";
+export { type CacheStatus, MAX_REVALIDATION_INTERVAL } from "./cf-cache-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/cf/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cache/cf/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAGjF,OAAO,EAAE,KAAK,WAAW,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cache/cf/index.js

@@ -0,0 +1,17 @@
+/**
+ * Cloudflare Cache Store Exports
+ *
+ * Main export:
+ * - CFCacheStore - Production cache store using Cloudflare's Cache API
+ *
+ * Header constants (for inspection/debugging):
+ * - CACHE_STALE_AT_HEADER - Header containing staleness timestamp
+ * - CACHE_STATUS_HEADER - Header containing HIT/REVALIDATING status
+ */
+// Public API
+export { CFCacheStore } from "./cf-cache-store.js";
+// Header constants for debugging and inspection
+export { CACHE_STALE_AT_HEADER, CACHE_STATUS_HEADER } from "./cf-cache-store.js";
+// Internal exports (re-exported for backwards compatibility, marked @internal in source)
+export { MAX_REVALIDATION_INTERVAL } from "./cf-cache-store.js";
+//# sourceMappingURL=index.js.map

package/dist/cache/cf/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cache/cf/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,aAAa;AACb,OAAO,EAAE,YAAY,EAA4B,MAAM,qBAAqB,CAAC;AAE7E,gDAAgD;AAChD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,yFAAyF;AACzF,OAAO,EAAoB,yBAAyB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cache/document-cache.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Document-Level Cache Middleware
+ *
+ * Caches full HTTP responses at the edge based on Cache-Control headers.
+ * Routes opt-in to caching by setting s-maxage or stale-while-revalidate headers.
+ *
+ * Flow:
+ * 1. Check cache for existing response
+ * 2. If fresh hit → return cached response
+ * 3. If stale hit (within SWR window) → return cached, revalidate in background
+ * 4. If miss → run handler, cache if response has cache headers
+ */
+import type { MiddlewareFn, MiddlewareContext } from "../router/middleware.js";
+export interface DocumentCacheOptions<TEnv = any> {
+    /**
+     * Skip caching for specific paths (e.g., API routes)
+     */
+    skipPaths?: string[];
+    /**
+     * Custom cache key generator
+     */
+    keyGenerator?: (url: URL) => string;
+    /**
+     * Callback to determine if caching should be enabled for this request.
+     * Receives the middleware context and returns true to enable caching.
+     * If not provided, caching is enabled by default.
+     *
+     * @example
+     * ```typescript
+     * createDocumentCacheMiddleware({
+     *   isEnabled: (ctx) => !ctx.request.headers.has('x-skip-cache'),
+     * })
+     * ```
+     */
+    isEnabled?: (ctx: MiddlewareContext<TEnv>) => boolean | Promise<boolean>;
+    /**
+     * Enable debug logging for cache operations.
+     * Logs HIT, MISS, STALE, and REVALIDATED events.
+     * Defaults to false.
+     */
+    debug?: boolean;
+}
+/**
+ * Create document cache middleware
+ *
+ * Add this middleware to your router to enable document-level caching.
+ * It uses the cache store's getResponse/putResponse methods for caching.
+ * Routes opt-in by setting Cache-Control headers with s-maxage.
+ *
+ * @example
+ * ```typescript
+ * // Add middleware to router
+ * const router = createRouter<AppEnv>()
+ *   .use(createDocumentCacheMiddleware({
+ *     isEnabled: (ctx) => ctx.url.pathname !== '/admin',
+ *   }))
+ *   .route("home", (ctx) => {
+ *     ctx.headers.set("Cache-Control", "s-maxage=60, stale-while-revalidate=300");
+ *     return <HomePage />;
+ *   });
+ * ```
+ */
+export declare function createDocumentCacheMiddleware<TEnv = any>(options?: DocumentCacheOptions<TEnv>): MiddlewareFn<TEnv>;
+//# sourceMappingURL=document-cache.d.ts.map

package/dist/cache/document-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-cache.d.ts","sourceRoot":"","sources":["../../src/cache/document-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAoH/E,MAAM,WAAW,oBAAoB,CAAC,IAAI,GAAG,GAAG;IAC9C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;IAEpC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzE;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,GAAG,GAAG,EACtD,OAAO,GAAE,oBAAoB,CAAC,IAAI,CAAM,GACvC,YAAY,CAAC,IAAI,CAAC,CA2JpB"}

package/dist/cache/document-cache.js

@@ -0,0 +1,228 @@
+/**
+ * Document-Level Cache Middleware
+ *
+ * Caches full HTTP responses at the edge based on Cache-Control headers.
+ * Routes opt-in to caching by setting s-maxage or stale-while-revalidate headers.
+ *
+ * Flow:
+ * 1. Check cache for existing response
+ * 2. If fresh hit → return cached response
+ * 3. If stale hit (within SWR window) → return cached, revalidate in background
+ * 4. If miss → run handler, cache if response has cache headers
+ */
+import { getRequestContext } from "../server/request-context.js";
+// ============================================================================
+// Constants
+// ============================================================================
+/** Header indicating cache status for debugging */
+const CACHE_STATUS_HEADER = "x-document-cache-status";
+/**
+ * Simple hash function for segment IDs.
+ * Creates a short, deterministic hash to differentiate cache keys
+ * based on which segments the client already has.
+ */
+function hashSegmentIds(segmentIds) {
+    if (!segmentIds)
+        return "";
+    let hash = 0;
+    for (let i = 0; i < segmentIds.length; i++) {
+        const char = segmentIds.charCodeAt(i);
+        hash = ((hash << 5) - hash + char) | 0;
+    }
+    // Convert to base36 for shorter string, take absolute value
+    return Math.abs(hash).toString(36);
+}
+/**
+ * Parse Cache-Control header for s-maxage and stale-while-revalidate directives
+ */
+function parseCacheControl(header) {
+    if (!header)
+        return null;
+    const directives = {};
+    // Parse s-maxage
+    const sMaxAgeMatch = header.match(/s-maxage\s*=\s*(\d+)/i);
+    if (sMaxAgeMatch) {
+        directives.sMaxAge = parseInt(sMaxAgeMatch[1], 10);
+    }
+    // Parse stale-while-revalidate
+    const swrMatch = header.match(/stale-while-revalidate\s*=\s*(\d+)/i);
+    if (swrMatch) {
+        directives.staleWhileRevalidate = parseInt(swrMatch[1], 10);
+    }
+    // Only return if we have at least s-maxage (required for document caching)
+    if (directives.sMaxAge !== undefined) {
+        return directives;
+    }
+    return null;
+}
+/**
+ * Check if response should be cached based on Cache-Control headers
+ */
+function shouldCacheResponse(response) {
+    // Only cache successful responses
+    if (response.status !== 200) {
+        return null;
+    }
+    const cacheControl = response.headers.get("Cache-Control");
+    return parseCacheControl(cacheControl);
+}
+// ============================================================================
+// Response Helpers
+// ============================================================================
+/**
+ * Add cache status header to response for debugging
+ */
+function addCacheStatusHeader(response, status) {
+    const headers = new Headers(response.headers);
+    headers.set(CACHE_STATUS_HEADER, status);
+    return new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}
+/**
+ * Run onResponse callbacks registered on the request context
+ */
+function runOnResponseCallbacks(response, callbacks) {
+    let result = response;
+    for (const callback of callbacks) {
+        result = callback(result);
+    }
+    return result;
+}
+/**
+ * Create document cache middleware
+ *
+ * Add this middleware to your router to enable document-level caching.
+ * It uses the cache store's getResponse/putResponse methods for caching.
+ * Routes opt-in by setting Cache-Control headers with s-maxage.
+ *
+ * @example
+ * ```typescript
+ * // Add middleware to router
+ * const router = createRouter<AppEnv>()
+ *   .use(createDocumentCacheMiddleware({
+ *     isEnabled: (ctx) => ctx.url.pathname !== '/admin',
+ *   }))
+ *   .route("home", (ctx) => {
+ *     ctx.headers.set("Cache-Control", "s-maxage=60, stale-while-revalidate=300");
+ *     return <HomePage />;
+ *   });
+ * ```
+ */
+export function createDocumentCacheMiddleware(options = {}) {
+    const { skipPaths = [], keyGenerator, isEnabled, debug = false } = options;
+    const log = debug
+        ? (message) => console.log(message)
+        : () => { };
+    return async function documentCacheMiddleware(ctx, next) {
+        const url = ctx.url;
+        // Skip RSC action requests (mutations shouldn't be cached)
+        if (url.searchParams.has("_rsc_action")) {
+            return next();
+        }
+        // Skip loader requests (have their own caching)
+        if (url.searchParams.has("_rsc_loader")) {
+            return next();
+        }
+        // Skip configured paths
+        if (skipPaths.some((path) => url.pathname.startsWith(path))) {
+            return next();
+        }
+        // Check if caching is enabled for this request
+        if (isEnabled) {
+            const enabled = await isEnabled(ctx);
+            if (!enabled) {
+                return next();
+            }
+        }
+        // Get request context and cache store
+        const requestCtx = getRequestContext();
+        const store = requestCtx?._cacheStore;
+        // Skip if no cache store or store doesn't support response caching
+        if (!store?.getResponse || !store?.putResponse) {
+            return next();
+        }
+        // Determine request type for cache key differentiation
+        const isPartial = url.searchParams.has("_rsc_partial");
+        const typeLabel = isPartial ? "RSC" : "HTML";
+        // Generate cache key
+        // For partial requests, include hash of client segments to prevent serving
+        // wrong cached response when navigating from different pages with different layouts
+        const clientSegments = url.searchParams.get("_rsc_segments") || "";
+        const segmentHash = isPartial && clientSegments ? `:${hashSegmentIds(clientSegments)}` : "";
+        const typeSuffix = isPartial ? ":rsc" : ":html";
+        const cacheKey = keyGenerator
+            ? keyGenerator(url) + segmentHash + typeSuffix
+            : `${url.pathname}${segmentHash}${typeSuffix}`;
+        try {
+            // 1. Check cache
+            const cached = await store.getResponse(cacheKey);
+            if (cached && cached.response.status === 200) {
+                if (!cached.shouldRevalidate) {
+                    // Fresh hit - return immediately
+                    log(`[DocumentCache] HIT ${typeLabel}: ${url.pathname}`);
+                    let response = addCacheStatusHeader(cached.response, "HIT");
+                    // Run onResponse callbacks even for cache hits
+                    if (requestCtx && requestCtx._onResponseCallbacks.length > 0) {
+                        response = runOnResponseCallbacks(response, requestCtx._onResponseCallbacks);
+                    }
+                    return response;
+                }
+                // Stale hit - return cached response, revalidate in background
+                log(`[DocumentCache] STALE ${typeLabel}: ${url.pathname} (revalidating)`);
+                if (requestCtx) {
+                    requestCtx.waitUntil(async () => {
+                        try {
+                            const fresh = await next();
+                            const directives = shouldCacheResponse(fresh);
+                            if (directives) {
+                                await store.putResponse(cacheKey, fresh, directives.sMaxAge, directives.staleWhileRevalidate);
+                                log(`[DocumentCache] REVALIDATED ${typeLabel}: ${url.pathname}`);
+                            }
+                        }
+                        catch (error) {
+                            console.error(`[DocumentCache] Revalidation failed:`, error);
+                        }
+                    });
+                }
+                let response = addCacheStatusHeader(cached.response, "STALE");
+                // Run onResponse callbacks even for stale cache hits
+                if (requestCtx && requestCtx._onResponseCallbacks.length > 0) {
+                    response = runOnResponseCallbacks(response, requestCtx._onResponseCallbacks);
+                }
+                return response;
+            }
+            // 2. Cache miss - run handler
+            const originalResponse = await next();
+            // 3. Cache if response has appropriate headers
+            const directives = shouldCacheResponse(originalResponse);
+            if (directives) {
+                log(`[DocumentCache] MISS ${typeLabel}: ${url.pathname} (caching with s-maxage=${directives.sMaxAge})`);
+                // Tee the body so we can return one stream and cache the other
+                const [returnStream, cacheStream] = originalResponse.body.tee();
+                // Clone response for caching (non-blocking)
+                if (requestCtx) {
+                    requestCtx.waitUntil(async () => {
+                        try {
+                            await store.putResponse(cacheKey, new Response(cacheStream, originalResponse), directives.sMaxAge, directives.staleWhileRevalidate);
+                        }
+                        catch (error) {
+                            console.error(`[DocumentCache] Cache write failed:`, error);
+                        }
+                    });
+                }
+                return addCacheStatusHeader(new Response(returnStream, originalResponse), "MISS");
+            }
+            // No cache headers - pass through
+            return originalResponse;
+        }
+        catch (error) {
+            console.error(`[DocumentCache] Error:`, error);
+            // On any cache error, fall through to handler
+            return next();
+        }
+    };
+}
+//# sourceMappingURL=document-cache.js.map

package/dist/cache/document-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-cache.js","sourceRoot":"","sources":["../../src/cache/document-cache.ts"],"names":[],"mappings":"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"}

package/dist/cache/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Cache Store
+ *
+ * Server-side caching for RSC segments and loader data.
+ *
+ * Main exports for users:
+ * - SegmentCacheStore - Interface for implementing custom cache stores
+ * - MemorySegmentCacheStore - In-memory cache for development/testing
+ * - CFCacheStore - Cloudflare edge cache store for production
+ * - CacheScope / createCacheScope - Request-scoped cache provider
+ */
+export type { CacheStore, CacheEntry, CacheValue, CacheValueType, CachePutOptions, CacheMetadata, } from "./types.js";
+export { MemoryCacheStore } from "./memory-store.js";
+export type { SegmentCacheStore, SegmentCacheProvider, CachedEntryData, CachedEntryResult, CacheGetResult, SerializedSegmentData, SegmentHandleData, CacheConfig, CacheConfigOrFactory, } from "./types.js";
+export { MemorySegmentCacheStore } from "./memory-segment-store.js";
+export { CFCacheStore, type CFCacheStoreOptions, CACHE_STALE_AT_HEADER, CACHE_STATUS_HEADER, } from "./cf/index.js";
+export { CacheScope, createCacheScope } from "./cache-scope.js";
+export { createDocumentCacheMiddleware, type DocumentCacheOptions, } from "./document-cache.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cache/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,YAAY,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,WAAW,EACX,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGhE,OAAO,EACL,6BAA6B,EAC7B,KAAK,oBAAoB,GAC1B,MAAM,qBAAqB,CAAC"}

package/dist/cache/index.js

@@ -0,0 +1,21 @@
+/**
+ * Cache Store
+ *
+ * Server-side caching for RSC segments and loader data.
+ *
+ * Main exports for users:
+ * - SegmentCacheStore - Interface for implementing custom cache stores
+ * - MemorySegmentCacheStore - In-memory cache for development/testing
+ * - CFCacheStore - Cloudflare edge cache store for production
+ * - CacheScope / createCacheScope - Request-scoped cache provider
+ */
+// Generic memory cache (reserved for future extensibility)
+export { MemoryCacheStore } from "./memory-store.js";
+export { MemorySegmentCacheStore } from "./memory-segment-store.js";
+// Cloudflare cache store
+export { CFCacheStore, CACHE_STALE_AT_HEADER, CACHE_STATUS_HEADER, } from "./cf/index.js";
+// Cache scope
+export { CacheScope, createCacheScope } from "./cache-scope.js";
+// Document-level cache middleware
+export { createDocumentCacheMiddleware, } from "./document-cache.js";
+//# sourceMappingURL=index.js.map

package/dist/cache/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cache/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,2DAA2D;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAerD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,yBAAyB;AACzB,OAAO,EACL,YAAY,EAEZ,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,cAAc;AACd,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,kCAAkC;AAClC,OAAO,EACL,6BAA6B,GAE9B,MAAM,qBAAqB,CAAC"}