@mrjasonroy/cache-components-cache-handler 16.0.0-alpha.0

package/dist/data-cache/memory.js

@@ -0,0 +1,310 @@
+/**
+ * Memory-based Data Cache Handler for "use cache" directive
+ * Based on Next.js default handler but with customizable options
+ *
+ * In-memory caches are fragile and should not use stale-while-revalidate
+ * semantics because entries may be evicted before reuse. Stale entries
+ * are considered expired/missing.
+ */
+/**
+ * Simple LRU cache implementation
+ */
+class LRUCache {
+    cache = new Map();
+    maxSize;
+    sizeOf;
+    currentSize = 0;
+    constructor(maxSize, sizeOf) {
+        this.maxSize = maxSize;
+        this.sizeOf = sizeOf;
+    }
+    get(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            // Move to end (most recently used)
+            this.cache.delete(key);
+            this.cache.set(key, value);
+        }
+        return value;
+    }
+    set(key, value) {
+        // Remove existing if present
+        const existing = this.cache.get(key);
+        if (existing !== undefined) {
+            this.currentSize -= this.sizeOf(existing);
+            this.cache.delete(key);
+        }
+        const size = this.sizeOf(value);
+        // Evict oldest entries if needed
+        while (this.currentSize + size > this.maxSize && this.cache.size > 0) {
+            const firstKey = this.cache.keys().next().value;
+            if (firstKey !== undefined) {
+                const firstValue = this.cache.get(firstKey);
+                if (firstValue !== undefined) {
+                    this.currentSize -= this.sizeOf(firstValue);
+                }
+                this.cache.delete(firstKey);
+            }
+        }
+        // Add new entry
+        this.cache.set(key, value);
+        this.currentSize += size;
+    }
+    delete(key) {
+        const value = this.cache.get(key);
+        if (value !== undefined) {
+            this.currentSize -= this.sizeOf(value);
+            this.cache.delete(key);
+        }
+    }
+    clear() {
+        this.cache.clear();
+        this.currentSize = 0;
+    }
+}
+/**
+ * Global tags manifest shared across all handler instances
+ *
+ * This is necessary because Next.js may create multiple handler instances
+ * (e.g., one for "default" profile and one for "remote" profile), but
+ * revalidateTag() needs to invalidate entries across ALL instances.
+ *
+ * ## Tag Revalidation Semantics
+ *
+ * When `updateTags()` is called, it can operate in two modes:
+ *
+ * ### 1. Immediate Expiration (deprecated, for testing)
+ * ```typescript
+ * updateTags(['my-tag'], undefined)
+ * // Sets: expired = now (entries expire immediately)
+ * ```
+ *
+ * ### 2. Stale-While-Revalidate (recommended for production)
+ * ```typescript
+ * updateTags(['my-tag'], { expire: 3600 })
+ * // Sets: stale = now, expired = now + 3600 * 1000
+ * // Entries are marked stale immediately but won't expire for 1 hour
+ * ```
+ *
+ * ## Entry Lifecycle
+ *
+ * When `get()` is called, entries go through these checks:
+ *
+ * 1. **TTL Check**: Entry expires if `now > timestamp + revalidate * 1000`
+ * 2. **Tag Expiration Check**: Entry expires if ANY tag was revalidated after entry creation
+ *    - Skips tags with future expiration times (stale-while-revalidate)
+ * 3. **Tag Staleness Check**: Entry is marked stale (revalidate = -1) if ANY tag's stale
+ *    timestamp is after entry creation
+ *
+ * This allows entries to be served with stale data while revalidating in the background.
+ */
+const globalTagsManifest = new Map();
+/**
+ * Check if tags are expired based on manifest
+ * Returns true if any tag was revalidated (invalidated) after the entry was created
+ */
+function areTagsExpired(tags, timestamp, debug) {
+    const now = Math.round(performance.timeOrigin + performance.now());
+    for (const tag of tags) {
+        const entry = globalTagsManifest.get(tag);
+        const expiredAt = entry?.expired;
+        debug?.("areTagsExpired checking", {
+            tag,
+            entryTimestamp: timestamp,
+            expiredAt,
+            now,
+        });
+        if (typeof expiredAt === "number") {
+            // Match Next.js logic exactly:
+            // Entry is expired if:
+            // 1. expiredAt <= now (tag revalidation time has passed)
+            // 2. expiredAt > timestamp (tag was revalidated AFTER entry was created)
+            const isImmediatelyExpired = expiredAt <= now && expiredAt > timestamp;
+            debug?.("areTagsExpired result", {
+                tag,
+                isImmediatelyExpired,
+                check1: `expiredAt (${expiredAt}) <= now (${now})`,
+                check1Result: expiredAt <= now,
+                check2: `expiredAt (${expiredAt}) > timestamp (${timestamp})`,
+                check2Result: expiredAt > timestamp,
+            });
+            if (isImmediatelyExpired) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+/**
+ * Check if tags are stale based on manifest
+ * Returns true if any tag was marked stale AFTER the entry was created
+ */
+function areTagsStale(tags, timestamp) {
+    for (const tag of tags) {
+        const entry = globalTagsManifest.get(tag);
+        const staleAt = entry?.stale ?? 0;
+        // Match Next.js logic: entry is stale if tag's stale timestamp > entry's creation timestamp
+        if (typeof staleAt === "number" && staleAt > timestamp) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Create a memory-based data cache handler for "use cache" directive
+ *
+ * @example
+ * ```typescript
+ * // cache-handler.mjs
+ * import { createMemoryDataCacheHandler } from '@mrjasonroy/better-nextjs-cache-handler/data-cache';
+ *
+ * export default createMemoryDataCacheHandler({
+ *   maxSize: 100 * 1024 * 1024, // 100MB
+ *   debug: process.env.NODE_ENV === 'development'
+ * });
+ * ```
+ *
+ * Then in next.config.js:
+ * ```javascript
+ * module.exports = {
+ *   cacheComponents: true,
+ *   cacheHandlers: {
+ *     default: require.resolve('./cache-handler.mjs')
+ *   }
+ * }
+ * ```
+ */
+export function createMemoryDataCacheHandler(options = {}) {
+    const maxSize = options.maxSize ?? 50 * 1024 * 1024; // 50MB default
+    // If max size is 0, return a no-op handler
+    if (maxSize === 0) {
+        return {
+            get: () => Promise.resolve(undefined),
+            set: () => Promise.resolve(),
+            refreshTags: () => Promise.resolve(),
+            getExpiration: () => Promise.resolve(0),
+            updateTags: () => Promise.resolve(),
+        };
+    }
+    const memoryCache = new LRUCache(maxSize, (entry) => entry.size);
+    const pendingSets = new Map();
+    const debug = options.debug ? console.debug.bind(console, "[MemoryDataCache]:") : undefined;
+    return {
+        async get(cacheKey, _softTags) {
+            const pendingPromise = pendingSets.get(cacheKey);
+            if (pendingPromise) {
+                debug?.("get", cacheKey, "pending");
+                await pendingPromise;
+            }
+            const privateEntry = memoryCache.get(cacheKey);
+            if (!privateEntry) {
+                debug?.("get", cacheKey, "not found");
+                return undefined;
+            }
+            const entry = privateEntry.entry;
+            const now = performance.timeOrigin + performance.now();
+            // In-memory caches should expire after revalidate time
+            if (now > entry.timestamp + entry.revalidate * 1000) {
+                debug?.("get", cacheKey, "expired");
+                return undefined;
+            }
+            let revalidate = entry.revalidate;
+            if (areTagsExpired(entry.tags, entry.timestamp, debug)) {
+                debug?.("get", cacheKey, "had expired tag");
+                return undefined;
+            }
+            if (areTagsStale(entry.tags, entry.timestamp)) {
+                debug?.("get", cacheKey, "had stale tag");
+                revalidate = -1;
+            }
+            // Tee the stream so we can return it and keep a copy
+            const [returnStream, newSaved] = entry.value.tee();
+            entry.value = newSaved;
+            debug?.("get", cacheKey, "found", {
+                tags: entry.tags,
+                timestamp: entry.timestamp,
+                expire: entry.expire,
+                revalidate,
+            });
+            return {
+                ...entry,
+                revalidate,
+                value: returnStream,
+            };
+        },
+        async set(cacheKey, pendingEntry) {
+            debug?.("set", cacheKey, "start");
+            let resolvePending = () => { };
+            const pendingPromise = new Promise((resolve) => {
+                resolvePending = resolve;
+            });
+            pendingSets.set(cacheKey, pendingPromise);
+            try {
+                const entry = await pendingEntry;
+                let size = 0;
+                // Tee the stream to read size and store value
+                const [value, clonedValue] = entry.value.tee();
+                entry.value = value;
+                const reader = clonedValue.getReader();
+                // Calculate total size by reading the stream
+                // biome-ignore lint/suspicious/noImplicitAnyLet: Chunk type inferred from reader
+                // biome-ignore lint/suspicious/noAssignInExpressions: Idiomatic pattern for stream reading
+                for (let chunk; !(chunk = await reader.read()).done;) {
+                    size += Buffer.from(chunk.value).byteLength;
+                }
+                memoryCache.set(cacheKey, {
+                    entry,
+                    isErrored: false,
+                    errorRetryCount: 0,
+                    size,
+                });
+                debug?.("set", cacheKey, "done", { size });
+            }
+            catch (err) {
+                debug?.("set", cacheKey, "failed", err);
+            }
+            finally {
+                resolvePending();
+                pendingSets.delete(cacheKey);
+            }
+        },
+        async refreshTags() {
+            // Nothing to do for in-memory cache
+            debug?.("refreshTags", "no-op for memory cache");
+        },
+        async getExpiration(tags) {
+            const expirations = tags.map((tag) => {
+                const entry = globalTagsManifest.get(tag);
+                if (!entry)
+                    return 0;
+                // Return the most recent timestamp (either expired or stale)
+                return entry.expired || 0;
+            });
+            const expiration = Math.max(...expirations, 0);
+            debug?.("getExpiration", { tags, expiration });
+            return expiration;
+        },
+        async updateTags(tags, durations) {
+            const now = Math.round(performance.timeOrigin + performance.now());
+            debug?.("updateTags", { tags, timestamp: now, durations });
+            for (const tag of tags) {
+                const existingEntry = globalTagsManifest.get(tag) || {};
+                if (durations) {
+                    // Use provided durations directly
+                    const updates = { ...existingEntry };
+                    // mark as stale immediately
+                    updates.stale = now;
+                    if (durations.expire !== undefined) {
+                        updates.expired = now + durations.expire * 1000; // Convert seconds to ms
+                    }
+                    globalTagsManifest.set(tag, updates);
+                }
+                else {
+                    // Update expired field for immediate expiration (default behavior)
+                    globalTagsManifest.set(tag, { ...existingEntry, expired: now });
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/data-cache/memory.js.map

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

package/dist/data-cache/redis.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Redis-based Data Cache Handler for "use cache" directive
+ * For production use with distributed Next.js deployments
+ *
+ * This handler stores cache entries in Redis, allowing multiple
+ * Next.js instances to share the same cache.
+ */
+import type { DataCacheHandler } from "./types.js";
+export interface RedisDataCacheHandlerOptions {
+    /**
+     * Redis client instance (ioredis or node-redis)
+     */
+    redis: RedisClient;
+    /**
+     * Key prefix for all cache entries
+     * @default "nextjs:data-cache:"
+     */
+    keyPrefix?: string;
+    /**
+     * Key prefix for tag manifest
+     * @default "nextjs:tags:"
+     */
+    tagPrefix?: string;
+    /**
+     * Enable debug logging
+     * @default false
+     */
+    debug?: boolean;
+    /**
+     * Default TTL for cache entries in seconds
+     * Used if entry doesn't specify expiration
+     * @default 86400 (24 hours)
+     */
+    defaultTTL?: number;
+}
+/**
+ * Redis client interface (compatible with ioredis and node-redis)
+ */
+export interface RedisClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ...args: unknown[]): Promise<unknown>;
+    del(...keys: string[]): Promise<number>;
+    exists(...keys: string[]): Promise<number>;
+    ttl(key: string): Promise<number>;
+    hGet(key: string, field: string): Promise<string | null>;
+    hSet(key: string, field: string, value: string): Promise<unknown>;
+    hGetAll(key: string): Promise<Record<string, string>>;
+}
+/**
+ * Create a Redis-based data cache handler for "use cache" directive
+ *
+ * @example
+ * ```typescript
+ * // redis-cache-handler.mjs
+ * import { createClient } from 'redis';
+ * import { createRedisDataCacheHandler } from '@mrjasonroy/better-nextjs-cache-handler/data-cache';
+ *
+ * const redis = createClient({
+ *   url: process.env.REDIS_URL
+ * });
+ *
+ * await redis.connect();
+ *
+ * export default createRedisDataCacheHandler({
+ *   redis,
+ *   keyPrefix: 'myapp:cache:',
+ *   debug: process.env.NODE_ENV === 'development'
+ * });
+ * ```
+ *
+ * Then in next.config.js:
+ * ```javascript
+ * module.exports = {
+ *   cacheComponents: true,
+ *   cacheHandlers: {
+ *     default: require.resolve('./redis-cache-handler.mjs'),
+ *     remote: require.resolve('./redis-cache-handler.mjs') // Same handler for remote
+ *   }
+ * }
+ * ```
+ */
+export declare function createRedisDataCacheHandler(options: RedisDataCacheHandlerOptions): DataCacheHandler;
+//# sourceMappingURL=redis.d.ts.map

package/dist/data-cache/redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis.d.ts","sourceRoot":"","sources":["../../src/data-cache/redis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAkB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnE,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,KAAK,EAAE,WAAW,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,GAAG,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACvD;AAmDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,4BAA4B,GACpC,gBAAgB,CAwMlB"}

package/dist/data-cache/redis.js

@@ -0,0 +1,240 @@
+/**
+ * Redis-based Data Cache Handler for "use cache" directive
+ * For production use with distributed Next.js deployments
+ *
+ * This handler stores cache entries in Redis, allowing multiple
+ * Next.js instances to share the same cache.
+ */
+/**
+ * Convert ReadableStream to Buffer
+ */
+async function streamToBuffer(stream) {
+    const reader = stream.getReader();
+    const chunks = [];
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            chunks.push(value);
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);
+    const result = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const chunk of chunks) {
+        result.set(chunk, offset);
+        offset += chunk.length;
+    }
+    return Buffer.from(result);
+}
+/**
+ * Convert Buffer to ReadableStream
+ */
+function bufferToStream(buffer) {
+    return new ReadableStream({
+        start(controller) {
+            controller.enqueue(new Uint8Array(buffer));
+            controller.close();
+        },
+    });
+}
+/**
+ * Create a Redis-based data cache handler for "use cache" directive
+ *
+ * @example
+ * ```typescript
+ * // redis-cache-handler.mjs
+ * import { createClient } from 'redis';
+ * import { createRedisDataCacheHandler } from '@mrjasonroy/better-nextjs-cache-handler/data-cache';
+ *
+ * const redis = createClient({
+ *   url: process.env.REDIS_URL
+ * });
+ *
+ * await redis.connect();
+ *
+ * export default createRedisDataCacheHandler({
+ *   redis,
+ *   keyPrefix: 'myapp:cache:',
+ *   debug: process.env.NODE_ENV === 'development'
+ * });
+ * ```
+ *
+ * Then in next.config.js:
+ * ```javascript
+ * module.exports = {
+ *   cacheComponents: true,
+ *   cacheHandlers: {
+ *     default: require.resolve('./redis-cache-handler.mjs'),
+ *     remote: require.resolve('./redis-cache-handler.mjs') // Same handler for remote
+ *   }
+ * }
+ * ```
+ */
+export function createRedisDataCacheHandler(options) {
+    const { redis, keyPrefix = "nextjs:data-cache:", tagPrefix = "nextjs:tags:", defaultTTL = 86400, debug = false, } = options;
+    const log = debug ? console.debug.bind(console, "[RedisDataCache]:") : undefined;
+    /**
+     * Get cache key with prefix
+     */
+    function getCacheKey(cacheKey) {
+        return `${keyPrefix}${cacheKey}`;
+    }
+    /**
+     * Get tag key with prefix
+     */
+    function getTagKey(tag) {
+        return `${tagPrefix}${tag}`;
+    }
+    /**
+     * Serialize cache entry for Redis storage
+     */
+    async function serializeEntry(entry) {
+        const buffer = await streamToBuffer(entry.value);
+        return {
+            value: buffer.toString("base64"),
+            tags: entry.tags,
+            stale: entry.stale,
+            timestamp: entry.timestamp,
+            expire: entry.expire,
+            revalidate: entry.revalidate,
+        };
+    }
+    /**
+     * Deserialize cache entry from Redis
+     */
+    function deserializeEntry(data) {
+        const buffer = Buffer.from(data.value, "base64");
+        return {
+            value: bufferToStream(buffer),
+            tags: data.tags,
+            stale: data.stale,
+            timestamp: data.timestamp,
+            expire: data.expire,
+            revalidate: data.revalidate,
+        };
+    }
+    return {
+        async get(cacheKey, _softTags) {
+            const key = getCacheKey(cacheKey);
+            try {
+                const data = await redis.get(key);
+                if (!data) {
+                    log?.("get", cacheKey, "not found");
+                    return undefined;
+                }
+                const entry = deserializeEntry(JSON.parse(data));
+                const now = Date.now();
+                // Check expiration
+                if (now > entry.timestamp + entry.revalidate * 1000) {
+                    log?.("get", cacheKey, "expired");
+                    await redis.del(key);
+                    return undefined;
+                }
+                // Check tag expiration
+                let revalidate = entry.revalidate;
+                for (const tag of entry.tags) {
+                    const tagData = await redis.hGetAll(getTagKey(tag));
+                    if (tagData.expired) {
+                        const expired = Number.parseInt(tagData.expired, 10);
+                        if (expired > entry.timestamp) {
+                            log?.("get", cacheKey, "had expired tag", tag);
+                            await redis.del(key);
+                            return undefined;
+                        }
+                    }
+                    if (tagData.stale) {
+                        const stale = Number.parseInt(tagData.stale, 10);
+                        if (stale > entry.timestamp) {
+                            log?.("get", cacheKey, "had stale tag", tag);
+                            revalidate = -1;
+                        }
+                    }
+                }
+                // Tee the stream
+                const [returnStream, newSaved] = entry.value.tee();
+                entry.value = newSaved;
+                log?.("get", cacheKey, "found", {
+                    tags: entry.tags,
+                    timestamp: entry.timestamp,
+                    revalidate,
+                });
+                return {
+                    ...entry,
+                    revalidate,
+                    value: returnStream,
+                };
+            }
+            catch (error) {
+                log?.("get", cacheKey, "error", error);
+                return undefined;
+            }
+        },
+        async set(cacheKey, pendingEntry) {
+            const key = getCacheKey(cacheKey);
+            try {
+                log?.("set", cacheKey, "start");
+                const entry = await pendingEntry;
+                const serialized = await serializeEntry(entry);
+                // Calculate TTL (use expire time or default)
+                const ttl = entry.expire < 4294967294 ? entry.expire : defaultTTL;
+                // Store in Redis with TTL
+                await redis.set(key, JSON.stringify(serialized), "EX", Math.ceil(ttl));
+                log?.("set", cacheKey, "done", { ttl });
+            }
+            catch (error) {
+                log?.("set", cacheKey, "failed", error);
+            }
+        },
+        async refreshTags() {
+            // For Redis, tags are stored in a hash and don't need periodic refresh
+            // unless you're syncing with an external tags service
+            log?.("refreshTags", "no-op for Redis cache");
+        },
+        async getExpiration(tags) {
+            try {
+                const expirations = await Promise.all(tags.map(async (tag) => {
+                    const data = await redis.hGet(getTagKey(tag), "expired");
+                    return data ? Number.parseInt(data, 10) : 0;
+                }));
+                const expiration = Math.max(...expirations, 0);
+                log?.("getExpiration", { tags, expiration });
+                return expiration;
+            }
+            catch (error) {
+                log?.("getExpiration", "error", error);
+                return 0;
+            }
+        },
+        async updateTags(tags, durations) {
+            const now = Date.now();
+            try {
+                log?.("updateTags", { tags, timestamp: now, durations });
+                await Promise.all(tags.map(async (tag) => {
+                    const key = getTagKey(tag);
+                    if (durations) {
+                        // Mark as stale immediately
+                        await redis.hSet(key, "stale", now.toString());
+                        // Set expiration if provided
+                        if (durations.expire !== undefined) {
+                            const expired = now + durations.expire * 1000;
+                            await redis.hSet(key, "expired", expired.toString());
+                        }
+                    }
+                    else {
+                        // Immediate expiration (default behavior)
+                        await redis.hSet(key, "expired", now.toString());
+                    }
+                }));
+            }
+            catch (error) {
+                log?.("updateTags", "error", error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=redis.js.map

package/dist/data-cache/redis.js.map

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