@pantheon-systems/nextjs-cache-handler 0.1.0

package/dist/handlers/base.js

@@ -0,0 +1,278 @@
+import { serializeForStorage, deserializeFromStorage } from '../utils/serialization.js';
+import { getBuildId, isBuildPhase } from '../utils/build-detection.js';
+import { createLogger } from '../utils/logger.js';
+// Global singleton to track if build invalidation has been checked for this process
+let buildInvalidationChecked = false;
+/**
+ * Reset the build invalidation check flag.
+ * Useful for testing purposes.
+ * @internal
+ */
+export function resetBuildInvalidationCheck() {
+    buildInvalidationChecked = false;
+}
+/**
+ * Abstract base class for cache handlers.
+ * Provides shared functionality for tag mapping, serialization, and build invalidation.
+ */
+export class BaseCacheHandler {
+    constructor(context, handlerName) {
+        this.context = context;
+        this.handlerName = handlerName;
+        this.log = createLogger(handlerName);
+        // Only log during server runtime, not during build (too noisy with parallel workers)
+        if (!isBuildPhase()) {
+            this.log.info('Initializing cache handler');
+        }
+    }
+    /**
+     * Initialize the handler. Should be called after construction.
+     * Handles build invalidation check and tags mapping initialization.
+     */
+    async initialize() {
+        await this.initializeTagsMapping();
+        // Only check build invalidation once per process
+        // Skip during build phase to avoid race conditions with parallel workers
+        if (!buildInvalidationChecked && !isBuildPhase()) {
+            await this.checkBuildInvalidation();
+            buildInvalidationChecked = true;
+        }
+    }
+    // ============================================================================
+    // Shared tag mapping methods
+    // ============================================================================
+    async updateTagsMapping(cacheKey, tags, isDelete = false) {
+        try {
+            const tagsMapping = await this.readTagsMapping();
+            if (isDelete) {
+                this.removeKeysFromAllTags(tagsMapping, [cacheKey]);
+            }
+            else {
+                this.addKeyToTags(tagsMapping, cacheKey, tags);
+            }
+            await this.writeTagsMapping(tagsMapping);
+        }
+        catch (error) {
+            this.log.error('Error updating tags mapping:', error);
+        }
+    }
+    async updateTagsMappingBulkDelete(cacheKeysToDelete, tagsMapping) {
+        try {
+            this.removeKeysFromAllTags(tagsMapping, cacheKeysToDelete);
+            await this.writeTagsMapping(tagsMapping);
+        }
+        catch (error) {
+            this.log.error('Error bulk updating tags mapping:', error);
+        }
+    }
+    /**
+     * Removes cache keys from all tag mappings they're associated with.
+     * This is used when cache entries are deleted to keep the tag mapping consistent.
+     * Empty tags are cleaned up automatically.
+     */
+    removeKeysFromAllTags(tagsMapping, keysToRemove) {
+        const keysSet = new Set(keysToRemove);
+        for (const tag of Object.keys(tagsMapping)) {
+            tagsMapping[tag] = tagsMapping[tag].filter((key) => !keysSet.has(key));
+            if (tagsMapping[tag].length === 0) {
+                delete tagsMapping[tag];
+            }
+        }
+    }
+    addKeyToTags(tagsMapping, cacheKey, tags) {
+        for (const tag of tags) {
+            if (!tagsMapping[tag]) {
+                tagsMapping[tag] = [];
+            }
+            if (!tagsMapping[tag].includes(cacheKey)) {
+                tagsMapping[tag].push(cacheKey);
+            }
+        }
+    }
+    // ============================================================================
+    // Build invalidation
+    // ============================================================================
+    async checkBuildInvalidation() {
+        const currentBuildId = getBuildId();
+        try {
+            const buildMeta = await this.readBuildMeta();
+            if (buildMeta.buildId !== currentBuildId) {
+                this.log.info(`New build detected (${buildMeta.buildId} -> ${currentBuildId}), invalidating route cache`);
+                await this.invalidateRouteCache();
+                await this.writeBuildMeta({
+                    buildId: currentBuildId,
+                    timestamp: Date.now(),
+                });
+            }
+        }
+        catch {
+            // No previous build metadata - first run, just save current build ID
+            await this.writeBuildMeta({
+                buildId: currentBuildId,
+                timestamp: Date.now(),
+            });
+        }
+    }
+    // ============================================================================
+    // Serialization helpers
+    // ============================================================================
+    serializeForStorage(data) {
+        return serializeForStorage(data);
+    }
+    deserializeFromStorage(data) {
+        return deserializeFromStorage(data);
+    }
+    // ============================================================================
+    // Cache type determination
+    // ============================================================================
+    determineCacheType(ctx) {
+        if (!ctx) {
+            return 'route';
+        }
+        if ('fetchCache' in ctx && ctx.fetchCache === true) {
+            return 'fetch';
+        }
+        if ('fetchUrl' in ctx) {
+            return 'fetch';
+        }
+        if ('fetchIdx' in ctx) {
+            return 'fetch';
+        }
+        return 'route';
+    }
+    determineCacheTypeFromValue(incrementalCacheValue) {
+        if (incrementalCacheValue &&
+            typeof incrementalCacheValue === 'object' &&
+            'kind' in incrementalCacheValue &&
+            incrementalCacheValue.kind === 'FETCH') {
+            return 'fetch';
+        }
+        return 'route';
+    }
+    // ============================================================================
+    // CacheHandler interface implementation
+    // ============================================================================
+    async get(cacheKey, ctx) {
+        this.log.debug(`GET: ${cacheKey}`);
+        try {
+            const cacheType = this.determineCacheType(ctx);
+            const entry = await this.readCacheEntry(cacheKey, cacheType);
+            if (!entry) {
+                this.log.debug(`MISS: ${cacheKey} (${cacheType})`);
+                return null;
+            }
+            this.log.debug(`HIT: ${cacheKey} (${cacheType})`, {
+                entryType: typeof entry,
+                hasValue: entry && typeof entry === 'object' && 'value' in entry,
+            });
+            return entry;
+        }
+        catch (error) {
+            this.log.error(`Error reading cache for key ${cacheKey}:`, error);
+            return null;
+        }
+    }
+    async set(cacheKey, incrementalCacheValue, ctx) {
+        const cacheType = this.determineCacheTypeFromValue(incrementalCacheValue);
+        this.log.debug(`SET: ${cacheKey} (${cacheType})`, {
+            valueType: typeof incrementalCacheValue,
+            hasKind: incrementalCacheValue && typeof incrementalCacheValue === 'object' && 'kind' in incrementalCacheValue,
+        });
+        try {
+            const { tags = [] } = ctx;
+            const cacheHandlerValue = {
+                value: incrementalCacheValue,
+                lastModified: Date.now(),
+                tags: Object.freeze(tags),
+            };
+            await this.writeCacheEntry(cacheKey, cacheHandlerValue, cacheType);
+            if (tags.length > 0) {
+                await this.updateTagsMapping(cacheKey, tags);
+                this.log.debug(`Updated tags mapping for ${cacheKey} with tags:`, tags);
+            }
+            // For route cache updates (ISR), trigger edge cache invalidation
+            if (cacheType === 'route') {
+                this.onRouteCacheSet(cacheKey);
+            }
+            this.log.debug(`Cached ${cacheKey} in ${cacheType} cache`);
+        }
+        catch (error) {
+            this.log.error(`Error setting cache for key ${cacheKey}:`, error);
+        }
+    }
+    async revalidateTag(tag) {
+        this.log.debug(`REVALIDATE TAG: ${tag}`);
+        const tagArray = [tag].flat();
+        const deletedKeys = [];
+        let tagsMapping;
+        try {
+            tagsMapping = await this.readTagsMapping();
+        }
+        catch (error) {
+            this.log.error('Error reading tags mapping during revalidateTag:', error);
+            tagsMapping = {};
+        }
+        for (const currentTag of tagArray) {
+            const cacheKeysForTag = tagsMapping[currentTag] || [];
+            if (cacheKeysForTag.length === 0) {
+                this.log.debug(`No cache entries found for tag: ${currentTag}`);
+                continue;
+            }
+            this.log.debug(`Found ${cacheKeysForTag.length} cache entries for tag: ${currentTag}`);
+            for (const cacheKey of cacheKeysForTag) {
+                const deleted = await this.tryDeleteCacheEntry(cacheKey);
+                if (deleted) {
+                    deletedKeys.push(cacheKey);
+                }
+            }
+        }
+        if (deletedKeys.length > 0) {
+            await this.updateTagsMappingBulkDelete(deletedKeys, tagsMapping);
+            this.log.debug(`Updated tags mapping after deleting ${deletedKeys.length} entries`);
+        }
+        this.log.info(`Revalidated ${deletedKeys.length} entries for tags: ${tagArray.join(', ')}`);
+        // Hook for subclasses to perform additional cleanup (e.g., edge cache clearing)
+        await this.onRevalidateComplete(tagArray, deletedKeys);
+    }
+    /**
+     * Hook called after revalidation is complete.
+     * Subclasses can override to perform additional cleanup.
+     */
+    async onRevalidateComplete(_tags, _deletedKeys) {
+        // Default implementation does nothing
+    }
+    /**
+     * Hook called when a route cache entry is set (ISR page update).
+     * Subclasses can override to perform edge cache invalidation.
+     */
+    onRouteCacheSet(_cacheKey) {
+        // Default implementation does nothing
+    }
+    async tryDeleteCacheEntry(cacheKey) {
+        // Try fetch cache first
+        try {
+            await this.deleteCacheEntry(cacheKey, 'fetch');
+            this.log.debug(`Deleted fetch cache entry: ${cacheKey}`);
+            return true;
+        }
+        catch {
+            // Entry might not exist in fetch cache
+        }
+        // Try route cache
+        try {
+            await this.deleteCacheEntry(cacheKey, 'route');
+            this.log.debug(`Deleted route cache entry: ${cacheKey}`);
+            return true;
+        }
+        catch {
+            this.log.warn(`Cache entry not found in either cache: ${cacheKey}`);
+        }
+        return false;
+    }
+    resetRequestCache() {
+        this.log.debug('RESET REQUEST CACHE: No-op for this cache handler');
+        // For persistent cache handlers, this is typically a no-op since we're not maintaining
+        // per-request caches. The storage backend is the source of truth.
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/handlers/base.js.map

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

package/dist/handlers/file.d.ts

@@ -0,0 +1,62 @@
+import type { CacheStats, CacheHandlerValue, FileSystemCacheContext } from '../types.js';
+import { BaseCacheHandler, type BuildMeta } from './base.js';
+/**
+ * File-based cache handler for local development.
+ * Stores cache entries in the .next/cache directory.
+ */
+export declare class FileCacheHandler extends BaseCacheHandler {
+    private readonly baseDir;
+    private readonly fetchCacheDir;
+    private readonly routeCacheDir;
+    private readonly buildMetaFile;
+    private readonly tagsDir;
+    private readonly tagsMapFile;
+    private readonly tagsBuffer;
+    constructor(context: FileSystemCacheContext);
+    private ensureCacheDir;
+    protected initializeTagsMapping(): Promise<void>;
+    /**
+     * Read tags mapping, flushing any pending updates first to ensure accuracy.
+     */
+    protected readTagsMapping(): Promise<Record<string, string[]>>;
+    /**
+     * Direct read from file system without flushing buffer.
+     * Used internally by the buffer.
+     */
+    private readTagsMappingDirect;
+    /**
+     * Write tags mapping directly to file system.
+     * Used by the buffer for batched writes.
+     */
+    protected writeTagsMapping(tagsMapping: Record<string, string[]>): Promise<void>;
+    /**
+     * Direct write to file system (sync).
+     * Used internally by the buffer.
+     */
+    private writeTagsMappingDirect;
+    /**
+     * Override to use buffered updates instead of immediate writes.
+     */
+    protected updateTagsMapping(cacheKey: string, tags: string[], isDelete?: boolean): Promise<void>;
+    /**
+     * Override to use buffered deletes instead of immediate writes.
+     */
+    protected updateTagsMappingBulkDelete(cacheKeysToDelete: string[], _tagsMapping: Record<string, string[]>): Promise<void>;
+    private getCacheFilePath;
+    protected readCacheEntry(cacheKey: string, cacheType: 'fetch' | 'route'): Promise<CacheHandlerValue | null>;
+    protected writeCacheEntry(cacheKey: string, cacheValue: CacheHandlerValue, cacheType: 'fetch' | 'route'): Promise<void>;
+    protected deleteCacheEntry(cacheKey: string, cacheType: 'fetch' | 'route'): Promise<void>;
+    protected readBuildMeta(): Promise<BuildMeta>;
+    protected writeBuildMeta(meta: BuildMeta): Promise<void>;
+    protected invalidateRouteCache(): Promise<void>;
+}
+/**
+ * Get cache statistics for the file-based cache.
+ */
+export declare function getSharedCacheStats(): Promise<CacheStats>;
+/**
+ * Clear all cache entries for the file-based cache.
+ */
+export declare function clearSharedCache(): Promise<number>;
+export default FileCacheHandler;
+//# sourceMappingURL=file.d.ts.map

package/dist/handlers/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/handlers/file.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EAEV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAW7D;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,OAAO,EAAE,sBAAsB;IA2B3C,OAAO,CAAC,cAAc;cAgBN,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUtD;;OAEG;cACa,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAMpE;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAa7B;;;OAGG;cACa,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAItF;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;OAEG;cACsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,UAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7G;;OAEG;cACsB,2BAA2B,CAClD,iBAAiB,EAAE,MAAM,EAAE,EAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GACrC,OAAO,CAAC,IAAI,CAAC;IAUhB,OAAO,CAAC,gBAAgB;cAMR,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;cAWjG,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,OAAO,GAAG,OAAO,GAC3B,OAAO,CAAC,IAAI,CAAC;cAWA,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;cAgB/E,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;cAKnC,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;cAM9C,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;CAQtD;AAMD;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC,CAsB/D;AAmDD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CA2BxD;AA+DD,eAAe,gBAAgB,CAAC"}