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

package/dist/handlers/redis.js

@@ -0,0 +1,210 @@
+import Redis from "ioredis";
+import { calculateLifespan, isExpired } from "../helpers/lifespan.js";
+/**
+ * Redis cache handler for Next.js 16+ with Cache Components support
+ *
+ * Features:
+ * - Persistent caching across server restarts
+ * - Tag-based revalidation with Redis Sets
+ * - TTL support with automatic expiration
+ * - Compatible with Redis, ElastiCache, and Valkey
+ * - Connection pooling via ioredis
+ *
+ * @example
+ * ```typescript
+ * // In cache-handler.mjs or data-cache-handler.mjs
+ * import { RedisCacheHandler } from "@mrjasonroy/cache-components-cache-handler/handlers/redis";
+ *
+ * export default class NextCacheHandler extends RedisCacheHandler {
+ *   constructor(options) {
+ *     super({
+ *       ...options,
+ *       redis: process.env.REDIS_URL || "redis://localhost:6379",
+ *       keyPrefix: "nextjs:cache:",
+ *       defaultTTL: 3600
+ *     });
+ *   }
+ * }
+ * ```
+ */
+export class RedisCacheHandler {
+    name = "redis";
+    redis;
+    keyPrefix;
+    tagPrefix;
+    defaultTTL;
+    debug;
+    constructor(options = {}) {
+        // Initialize Redis connection
+        if (typeof options.redis === "string") {
+            this.redis = new Redis(options.redis);
+        }
+        else {
+            this.redis = new Redis(options.redis || {});
+        }
+        this.keyPrefix = options.keyPrefix ?? "nextjs:cache:";
+        this.tagPrefix = options.tagPrefix ?? "nextjs:tags:";
+        this.defaultTTL = options.defaultTTL;
+        this.debug = options.debug ?? false;
+        // Handle Redis connection errors
+        this.redis.on("error", (err) => {
+            console.error("[RedisCacheHandler] Redis connection error:", err);
+        });
+        if (this.debug) {
+            console.log("[RedisCacheHandler] Initialized", {
+                keyPrefix: this.keyPrefix,
+                tagPrefix: this.tagPrefix,
+                defaultTTL: this.defaultTTL,
+            });
+        }
+    }
+    log(...args) {
+        if (this.debug) {
+            console.log("[RedisCacheHandler]", ...args);
+        }
+    }
+    getCacheKey(key) {
+        return `${this.keyPrefix}${key}`;
+    }
+    getTagKey(tag) {
+        return `${this.tagPrefix}${tag}`;
+    }
+    async get(key, meta) {
+        try {
+            const cacheKey = this.getCacheKey(key);
+            this.log("GET", cacheKey);
+            // Get the cached entry
+            const data = await this.redis.get(cacheKey);
+            if (!data) {
+                this.log("GET", cacheKey, "MISS");
+                return null;
+            }
+            // Parse the stored entry
+            const entry = JSON.parse(data);
+            // Check if expired based on lifespan
+            if (entry.lifespan && isExpired(entry.lifespan)) {
+                this.log("GET", cacheKey, "EXPIRED");
+                await this.delete(key);
+                return null;
+            }
+            // Check if any tag (explicit or implicit) has been revalidated
+            const allTags = [...entry.tags, ...(meta?.implicitTags ?? [])];
+            for (const tag of allTags) {
+                const tagKey = this.getTagKey(tag);
+                const revalidatedAt = await this.redis.get(tagKey);
+                // If tag was revalidated after entry was last modified, entry is stale
+                if (revalidatedAt && Number.parseInt(revalidatedAt) > entry.lastModified) {
+                    this.log("GET", cacheKey, "STALE (tag revalidated)", tag);
+                    await this.delete(key);
+                    return null;
+                }
+            }
+            this.log("GET", cacheKey, "HIT");
+            return entry.value;
+        }
+        catch (error) {
+            console.error("[RedisCacheHandler] GET error:", error);
+            return null;
+        }
+    }
+    async set(key, value, context) {
+        try {
+            const cacheKey = this.getCacheKey(key);
+            // Calculate lifespan and TTL
+            const lifespan = calculateLifespan(context?.revalidate, this.defaultTTL);
+            const tags = context?.tags ?? [];
+            const entry = {
+                lastModified: Date.now(),
+                lifespan,
+                tags,
+                value,
+            };
+            const serialized = JSON.stringify(entry);
+            // Determine TTL for Redis
+            let ttl;
+            if (lifespan?.expireAt) {
+                // Use expire time as TTL
+                ttl = Math.ceil((lifespan.expireAt - Date.now()) / 1000);
+                if (ttl <= 0) {
+                    this.log("SET", cacheKey, "SKIP (already expired)");
+                    return;
+                }
+            }
+            // Store in Redis with optional TTL
+            if (ttl) {
+                await this.redis.setex(cacheKey, ttl, serialized);
+                this.log("SET", cacheKey, `TTL=${ttl}s`, `kind=${value.kind}`);
+            }
+            else {
+                await this.redis.set(cacheKey, serialized);
+                this.log("SET", cacheKey, "NO_TTL", `kind=${value.kind}`);
+            }
+            // Track tags -> keys mapping for revalidation
+            if (tags.length > 0) {
+                const pipeline = this.redis.pipeline();
+                for (const tag of tags) {
+                    const tagKey = this.getTagKey(tag);
+                    // Use a set to store all cache keys with this tag
+                    pipeline.sadd(`${tagKey}:keys`, cacheKey);
+                    // Set expiration on the tag's key set if we have a TTL
+                    if (ttl) {
+                        pipeline.expire(`${tagKey}:keys`, ttl);
+                    }
+                }
+                await pipeline.exec();
+                this.log("SET", cacheKey, "tags:", tags);
+            }
+        }
+        catch (error) {
+            console.error("[RedisCacheHandler] SET error:", error);
+        }
+    }
+    async revalidateTag(tag, _profile) {
+        try {
+            const tagKey = this.getTagKey(tag);
+            // Store revalidation timestamp
+            await this.redis.set(tagKey, Date.now().toString());
+            this.log("revalidateTag", tag);
+            // Delete all cache keys associated with this tag
+            const keysSetKey = `${tagKey}:keys`;
+            const cacheKeys = await this.redis.smembers(keysSetKey);
+            if (cacheKeys.length > 0) {
+                const pipeline = this.redis.pipeline();
+                for (const cacheKey of cacheKeys) {
+                    pipeline.del(cacheKey);
+                }
+                // Clear the tag's keys set
+                pipeline.del(keysSetKey);
+                await pipeline.exec();
+                this.log("revalidateTag", tag, `deleted ${cacheKeys.length} entries`);
+            }
+        }
+        catch (error) {
+            console.error("[RedisCacheHandler] revalidateTag error:", error);
+        }
+    }
+    async delete(key) {
+        try {
+            const cacheKey = this.getCacheKey(key);
+            await this.redis.del(cacheKey);
+            this.log("DELETE", cacheKey);
+        }
+        catch (error) {
+            console.error("[RedisCacheHandler] DELETE error:", error);
+        }
+    }
+    /**
+     * Close the Redis connection
+     * Call this when shutting down your application
+     */
+    async close() {
+        try {
+            await this.redis.quit();
+            this.log("Connection closed");
+        }
+        catch (error) {
+            console.error("[RedisCacheHandler] close error:", error);
+        }
+    }
+}
+//# sourceMappingURL=redis.js.map

package/dist/handlers/redis.js.map

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

package/dist/helpers/buffer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Buffer conversion utilities for Next.js 15+ compatibility
+ * Next.js 15 changed body/rscData from strings to Buffers
+ */
+/**
+ * Convert a value to base64 string if it's a Buffer
+ * Used when storing cache values (e.g., in Redis)
+ *
+ * @param value - Value that might be a Buffer
+ * @returns Base64 string if Buffer, original value otherwise
+ */
+export declare function bufferToString(value: unknown): unknown;
+/**
+ * Convert a base64 string back to Buffer if it was originally a Buffer
+ * Used when retrieving cache values (e.g., from Redis)
+ *
+ * This is a simplified version - in production you'd need to track
+ * which fields were originally Buffers
+ *
+ * @param value - Value that might be a base64 string
+ * @param isBuffer - Whether this value should be converted to Buffer
+ * @returns Buffer if isBuffer is true, original value otherwise
+ */
+export declare function stringToBuffer(value: string, isBuffer: boolean): Buffer | string;
+//# sourceMappingURL=buffer.d.ts.map

package/dist/helpers/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/helpers/buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAkBtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAKhF"}

package/dist/helpers/buffer.js

@@ -0,0 +1,45 @@
+/**
+ * Buffer conversion utilities for Next.js 15+ compatibility
+ * Next.js 15 changed body/rscData from strings to Buffers
+ */
+/**
+ * Convert a value to base64 string if it's a Buffer
+ * Used when storing cache values (e.g., in Redis)
+ *
+ * @param value - Value that might be a Buffer
+ * @returns Base64 string if Buffer, original value otherwise
+ */
+export function bufferToString(value) {
+    if (Buffer.isBuffer(value)) {
+        return value.toString("base64");
+    }
+    if (typeof value === "object" && value !== null) {
+        const result = {};
+        for (const [key, val] of Object.entries(value)) {
+            result[key] = bufferToString(val);
+        }
+        return result;
+    }
+    if (Array.isArray(value)) {
+        return value.map(bufferToString);
+    }
+    return value;
+}
+/**
+ * Convert a base64 string back to Buffer if it was originally a Buffer
+ * Used when retrieving cache values (e.g., from Redis)
+ *
+ * This is a simplified version - in production you'd need to track
+ * which fields were originally Buffers
+ *
+ * @param value - Value that might be a base64 string
+ * @param isBuffer - Whether this value should be converted to Buffer
+ * @returns Buffer if isBuffer is true, original value otherwise
+ */
+export function stringToBuffer(value, isBuffer) {
+    if (isBuffer && typeof value === "string") {
+        return Buffer.from(value, "base64");
+    }
+    return value;
+}
+//# sourceMappingURL=buffer.js.map

package/dist/helpers/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","sourceRoot":"","sources":["../../src/helpers/buffer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,QAAiB;IAC7D,IAAI,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/helpers/is-implicit-tag.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Check if a tag is an implicit (system-generated) tag
+ * Implicit tags are generated by Next.js with the _N_T_ prefix
+ *
+ * @param tag - The tag to check
+ * @returns True if the tag is implicit, false otherwise
+ */
+export declare function isImplicitTag(tag: string): boolean;
+//# sourceMappingURL=is-implicit-tag.d.ts.map

package/dist/helpers/is-implicit-tag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-implicit-tag.d.ts","sourceRoot":"","sources":["../../src/helpers/is-implicit-tag.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAMlD"}

package/dist/helpers/is-implicit-tag.js

@@ -0,0 +1,16 @@
+import { IMPLICIT_TAG_PREFIX } from "../types.js";
+/**
+ * Check if a tag is an implicit (system-generated) tag
+ * Implicit tags are generated by Next.js with the _N_T_ prefix
+ *
+ * @param tag - The tag to check
+ * @returns True if the tag is implicit, false otherwise
+ */
+export function isImplicitTag(tag) {
+    // Guard against non-string values that Next.js might pass
+    if (typeof tag !== "string") {
+        return false;
+    }
+    return tag.startsWith(IMPLICIT_TAG_PREFIX);
+}
+//# sourceMappingURL=is-implicit-tag.js.map

package/dist/helpers/is-implicit-tag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-implicit-tag.js","sourceRoot":"","sources":["../../src/helpers/is-implicit-tag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,0DAA0D;IAC1D,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAC7C,CAAC"}

package/dist/helpers/lifespan.d.ts

@@ -0,0 +1,18 @@
+import type { LifespanParameters } from "../types.js";
+/**
+ * Calculate lifespan parameters from revalidate value
+ * CRITICAL: All timestamps are in SECONDS, not milliseconds
+ *
+ * @param revalidate - Revalidation period in seconds, or false to disable
+ * @param defaultTTL - Default TTL in seconds if revalidate is undefined
+ * @returns Lifespan parameters or null if no expiration
+ */
+export declare function calculateLifespan(revalidate: number | false | undefined, defaultTTL?: number): LifespanParameters | null;
+/**
+ * Check if a cache entry has expired based on its lifespan
+ *
+ * @param lifespan - Lifespan parameters (null means never expires)
+ * @returns True if expired, false otherwise
+ */
+export declare function isExpired(lifespan: LifespanParameters | null): boolean;
+//# sourceMappingURL=lifespan.d.ts.map

package/dist/helpers/lifespan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifespan.d.ts","sourceRoot":"","sources":["../../src/helpers/lifespan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,kBAAkB,GAAG,IAAI,CAwB3B;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,kBAAkB,GAAG,IAAI,GAAG,OAAO,CAOtE"}

package/dist/helpers/lifespan.js

@@ -0,0 +1,43 @@
+/**
+ * Calculate lifespan parameters from revalidate value
+ * CRITICAL: All timestamps are in SECONDS, not milliseconds
+ *
+ * @param revalidate - Revalidation period in seconds, or false to disable
+ * @param defaultTTL - Default TTL in seconds if revalidate is undefined
+ * @returns Lifespan parameters or null if no expiration
+ */
+export function calculateLifespan(revalidate, defaultTTL) {
+    // If revalidate is explicitly false, no expiration
+    if (revalidate === false) {
+        return null;
+    }
+    // Use revalidate value or default TTL
+    const ttlSeconds = typeof revalidate === "number" ? revalidate : defaultTTL;
+    // If no TTL specified, no expiration
+    if (!ttlSeconds) {
+        return null;
+    }
+    const nowSeconds = Math.floor(Date.now() / 1000);
+    return {
+        lastModifiedAt: nowSeconds,
+        staleAt: nowSeconds + ttlSeconds,
+        expireAt: nowSeconds + ttlSeconds,
+        staleAge: ttlSeconds,
+        expireAge: ttlSeconds,
+        revalidate,
+    };
+}
+/**
+ * Check if a cache entry has expired based on its lifespan
+ *
+ * @param lifespan - Lifespan parameters (null means never expires)
+ * @returns True if expired, false otherwise
+ */
+export function isExpired(lifespan) {
+    if (!lifespan) {
+        return false;
+    }
+    const nowSeconds = Math.floor(Date.now() / 1000);
+    return nowSeconds >= lifespan.expireAt;
+}
+//# sourceMappingURL=lifespan.js.map

package/dist/helpers/lifespan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifespan.js","sourceRoot":"","sources":["../../src/helpers/lifespan.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAsC,EACtC,UAAmB;IAEnB,mDAAmD;IACnD,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,sCAAsC;IACtC,MAAM,UAAU,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC;IAE5E,qCAAqC;IACrC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAEjD,OAAO;QACL,cAAc,EAAE,UAAU;QAC1B,OAAO,EAAE,UAAU,GAAG,UAAU;QAChC,QAAQ,EAAE,UAAU,GAAG,UAAU;QACjC,QAAQ,EAAE,UAAU;QACpB,SAAS,EAAE,UAAU;QACrB,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,QAAmC;IAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IACjD,OAAO,UAAU,IAAI,QAAQ,CAAC,QAAQ,CAAC;AACzC,CAAC"}

package/dist/helpers/next-config.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Helper functions for configuring Next.js cache handlers
+ */
+export interface CacheHandlerConfig {
+    /**
+     * Path to ISR cache handler (for cacheHandler in next.config)
+     */
+    cacheHandler: string;
+    /**
+     * Paths to data cache handlers (for cacheHandlers in next.config)
+     */
+    cacheHandlers: {
+        default: string;
+        remote: string;
+    };
+    /**
+     * Disable Next.js default in-memory cache for "use cache"
+     * Set to 0 to use your own handlers exclusively
+     */
+    cacheMaxMemorySize?: number;
+}
+/**
+ * Create Next.js cache handler configuration for both ISR and Data Cache
+ *
+ * This generates the config needed for both:
+ * - `cacheHandler`: ISR cache (Incremental Static Regeneration)
+ * - `cacheHandlers`: Data cache ("use cache" and "use cache: remote")
+ *
+ * @param options - Configuration options
+ * @param options.isrHandlerPath - Path to ISR cache handler file (for cacheHandler)
+ * @param options.dataCacheHandlerPath - Path to data cache handler file (for cacheHandlers.default and cacheHandlers.remote)
+ * @param options.disableDefaultMemoryCache - Set to true to disable Next.js default in-memory cache (default: true)
+ *
+ * @returns Configuration object to spread into next.config
+ *
+ * @example
+ * ```ts
+ * // next.config.mjs
+ * import { createCacheConfig } from "@mrjasonroy/better-nextjs-cache-handler";
+ * import { resolve } from "path";
+ *
+ * const cacheConfig = createCacheConfig({
+ *   isrHandlerPath: resolve(process.cwd(), "./cache-handler.mjs"),
+ *   dataCacheHandlerPath: resolve(process.cwd(), "./data-cache-handler.mjs"),
+ * });
+ *
+ * export default {
+ *   ...cacheConfig,
+ *   // other Next.js config
+ * };
+ * ```
+ */
+export declare function createCacheConfig(options: {
+    isrHandlerPath: string;
+    dataCacheHandlerPath: string;
+    disableDefaultMemoryCache?: boolean;
+}): CacheHandlerConfig;
+/**
+ * Create Next.js cache handler configuration with separate handlers for default and remote
+ *
+ * This allows you to use different cache handlers for:
+ * - `default`: Used by "use cache" (typically faster, in-memory or local)
+ * - `remote`: Used by "use cache: remote" (typically slower, database or API results)
+ *
+ * @param options - Configuration options
+ * @param options.isrHandlerPath - Path to ISR cache handler file (for cacheHandler)
+ * @param options.defaultDataCacheHandlerPath - Path to data cache handler for "use cache"
+ * @param options.remoteDataCacheHandlerPath - Path to data cache handler for "use cache: remote"
+ * @param options.disableDefaultMemoryCache - Set to true to disable Next.js default in-memory cache (default: true)
+ *
+ * @returns Configuration object to spread into next.config
+ *
+ * @example
+ * ```ts
+ * // next.config.mjs
+ * import { createCacheConfigWithProfiles } from "@mrjasonroy/better-nextjs-cache-handler";
+ * import { resolve } from "path";
+ *
+ * const cacheConfig = createCacheConfigWithProfiles({
+ *   isrHandlerPath: resolve(process.cwd(), "./cache-handler.mjs"),
+ *   defaultDataCacheHandlerPath: resolve(process.cwd(), "./data-cache-memory.mjs"),
+ *   remoteDataCacheHandlerPath: resolve(process.cwd(), "./data-cache-redis.mjs"),
+ * });
+ *
+ * export default {
+ *   ...cacheConfig,
+ *   // other Next.js config
+ * };
+ * ```
+ */
+export declare function createCacheConfigWithProfiles(options: {
+    isrHandlerPath: string;
+    defaultDataCacheHandlerPath: string;
+    remoteDataCacheHandlerPath: string;
+    disableDefaultMemoryCache?: boolean;
+}): CacheHandlerConfig;
+//# sourceMappingURL=next-config.d.ts.map

package/dist/helpers/next-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-config.d.ts","sourceRoot":"","sources":["../../src/helpers/next-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,EAAE;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,kBAAkB,CAcrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,2BAA2B,EAAE,MAAM,CAAC;IACpC,0BAA0B,EAAE,MAAM,CAAC;IACnC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC,GAAG,kBAAkB,CAmBrB"}

package/dist/helpers/next-config.js

@@ -0,0 +1,96 @@
+/**
+ * Helper functions for configuring Next.js cache handlers
+ */
+/**
+ * Create Next.js cache handler configuration for both ISR and Data Cache
+ *
+ * This generates the config needed for both:
+ * - `cacheHandler`: ISR cache (Incremental Static Regeneration)
+ * - `cacheHandlers`: Data cache ("use cache" and "use cache: remote")
+ *
+ * @param options - Configuration options
+ * @param options.isrHandlerPath - Path to ISR cache handler file (for cacheHandler)
+ * @param options.dataCacheHandlerPath - Path to data cache handler file (for cacheHandlers.default and cacheHandlers.remote)
+ * @param options.disableDefaultMemoryCache - Set to true to disable Next.js default in-memory cache (default: true)
+ *
+ * @returns Configuration object to spread into next.config
+ *
+ * @example
+ * ```ts
+ * // next.config.mjs
+ * import { createCacheConfig } from "@mrjasonroy/better-nextjs-cache-handler";
+ * import { resolve } from "path";
+ *
+ * const cacheConfig = createCacheConfig({
+ *   isrHandlerPath: resolve(process.cwd(), "./cache-handler.mjs"),
+ *   dataCacheHandlerPath: resolve(process.cwd(), "./data-cache-handler.mjs"),
+ * });
+ *
+ * export default {
+ *   ...cacheConfig,
+ *   // other Next.js config
+ * };
+ * ```
+ */
+export function createCacheConfig(options) {
+    const { isrHandlerPath, dataCacheHandlerPath, disableDefaultMemoryCache = true } = options;
+    return {
+        cacheHandler: isrHandlerPath,
+        cacheHandlers: {
+            // "use cache" uses this (default cache profile)
+            default: dataCacheHandlerPath,
+            // "use cache: remote" uses this (for DB queries, API calls)
+            remote: dataCacheHandlerPath,
+        },
+        // Disable Next.js default in-memory cache to use our handlers exclusively
+        cacheMaxMemorySize: disableDefaultMemoryCache ? 0 : undefined,
+    };
+}
+/**
+ * Create Next.js cache handler configuration with separate handlers for default and remote
+ *
+ * This allows you to use different cache handlers for:
+ * - `default`: Used by "use cache" (typically faster, in-memory or local)
+ * - `remote`: Used by "use cache: remote" (typically slower, database or API results)
+ *
+ * @param options - Configuration options
+ * @param options.isrHandlerPath - Path to ISR cache handler file (for cacheHandler)
+ * @param options.defaultDataCacheHandlerPath - Path to data cache handler for "use cache"
+ * @param options.remoteDataCacheHandlerPath - Path to data cache handler for "use cache: remote"
+ * @param options.disableDefaultMemoryCache - Set to true to disable Next.js default in-memory cache (default: true)
+ *
+ * @returns Configuration object to spread into next.config
+ *
+ * @example
+ * ```ts
+ * // next.config.mjs
+ * import { createCacheConfigWithProfiles } from "@mrjasonroy/better-nextjs-cache-handler";
+ * import { resolve } from "path";
+ *
+ * const cacheConfig = createCacheConfigWithProfiles({
+ *   isrHandlerPath: resolve(process.cwd(), "./cache-handler.mjs"),
+ *   defaultDataCacheHandlerPath: resolve(process.cwd(), "./data-cache-memory.mjs"),
+ *   remoteDataCacheHandlerPath: resolve(process.cwd(), "./data-cache-redis.mjs"),
+ * });
+ *
+ * export default {
+ *   ...cacheConfig,
+ *   // other Next.js config
+ * };
+ * ```
+ */
+export function createCacheConfigWithProfiles(options) {
+    const { isrHandlerPath, defaultDataCacheHandlerPath, remoteDataCacheHandlerPath, disableDefaultMemoryCache = true, } = options;
+    return {
+        cacheHandler: isrHandlerPath,
+        cacheHandlers: {
+            // "use cache" uses this (default cache profile)
+            default: defaultDataCacheHandlerPath,
+            // "use cache: remote" uses this (for DB queries, API calls)
+            remote: remoteDataCacheHandlerPath,
+        },
+        // Disable Next.js default in-memory cache to use our handlers exclusively
+        cacheMaxMemorySize: disableDefaultMemoryCache ? 0 : undefined,
+    };
+}
+//# sourceMappingURL=next-config.js.map

package/dist/helpers/next-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-config.js","sourceRoot":"","sources":["../../src/helpers/next-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuBH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAIjC;IACC,MAAM,EAAE,cAAc,EAAE,oBAAoB,EAAE,yBAAyB,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE3F,OAAO;QACL,YAAY,EAAE,cAAc;QAC5B,aAAa,EAAE;YACb,gDAAgD;YAChD,OAAO,EAAE,oBAAoB;YAC7B,4DAA4D;YAC5D,MAAM,EAAE,oBAAoB;SAC7B;QACD,0EAA0E;QAC1E,kBAAkB,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9D,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAK7C;IACC,MAAM,EACJ,cAAc,EACd,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,GAAG,IAAI,GACjC,GAAG,OAAO,CAAC;IAEZ,OAAO;QACL,YAAY,EAAE,cAAc;QAC5B,aAAa,EAAE;YACb,gDAAgD;YAChD,OAAO,EAAE,2BAA2B;YACpC,4DAA4D;YAC5D,MAAM,EAAE,0BAA0B;SACnC;QACD,0EAA0E;QAC1E,kBAAkB,EAAE,yBAAyB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;KAC9D,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @mrjasonroy/better-nextjs-cache-handler
+ * Modern cache handler for Next.js 16+ with support for ISR and 'use cache' directive
+ */
+export { CompositeHandler, type CompositeHandlerOptions, createCompositeHandler, } from "./handlers/composite.js";
+export { createMemoryCacheHandler, MemoryCacheHandler, type MemoryCacheHandlerOptions, } from "./handlers/memory.js";
+export { RedisCacheHandler, type RedisCacheHandlerOptions, } from "./handlers/redis.js";
+export { bufferToString, stringToBuffer } from "./helpers/buffer.js";
+export { isImplicitTag } from "./helpers/is-implicit-tag.js";
+export { calculateLifespan, isExpired } from "./helpers/lifespan.js";
+export { createCacheConfig, createCacheConfigWithProfiles, type CacheHandlerConfig, } from "./helpers/next-config.js";
+export type { CacheHandler, CacheHandlerContext, CacheHandlerGetMeta, CacheHandlerOptions, CacheHandlerValue, CacheValue, LifespanParameters, } from "./types.js";
+export { IMPLICIT_TAG_PREFIX } from "./types.js";
+export { createMemoryDataCacheHandler, type MemoryDataCacheHandlerOptions, } from "./data-cache/memory.js";
+export { createRedisDataCacheHandler, type RedisClient, type RedisDataCacheHandlerOptions, } from "./data-cache/redis.js";
+export type { DataCacheEntry, DataCacheHandler, Timestamp, } from "./data-cache/types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EACL,gBAAgB,EAChB,KAAK,uBAAuB,EAC5B,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,GAC9B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EACL,iBAAiB,EACjB,6BAA6B,EAC7B,KAAK,kBAAkB,GACxB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAMjD,OAAO,EACL,4BAA4B,EAC5B,KAAK,6BAA6B,GACnC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,2BAA2B,EAC3B,KAAK,WAAW,EAChB,KAAK,4BAA4B,GAClC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,SAAS,GACV,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * @mrjasonroy/better-nextjs-cache-handler
+ * Modern cache handler for Next.js 16+ with support for ISR and 'use cache' directive
+ */
+// =============================================================================
+// ISR Cache Handlers (for Incremental Static Regeneration)
+// =============================================================================
+export { CompositeHandler, createCompositeHandler, } from "./handlers/composite.js";
+// Handlers
+export { createMemoryCacheHandler, MemoryCacheHandler, } from "./handlers/memory.js";
+export { RedisCacheHandler, } from "./handlers/redis.js";
+export { bufferToString, stringToBuffer } from "./helpers/buffer.js";
+// Helpers
+export { isImplicitTag } from "./helpers/is-implicit-tag.js";
+export { calculateLifespan, isExpired } from "./helpers/lifespan.js";
+export { createCacheConfig, createCacheConfigWithProfiles, } from "./helpers/next-config.js";
+export { IMPLICIT_TAG_PREFIX } from "./types.js";
+// =============================================================================
+// Data Cache Handlers (for "use cache" directive)
+// =============================================================================
+export { createMemoryDataCacheHandler, } from "./data-cache/memory.js";
+export { createRedisDataCacheHandler, } from "./data-cache/redis.js";
+//# sourceMappingURL=index.js.map