@pantheon-systems/nextjs-cache-handler 0.1.0

package/dist/handlers/file.js

@@ -0,0 +1,332 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { promisify } from 'util';
+import { BaseCacheHandler } from './base.js';
+import { getStaticRoutes } from '../utils/static-routes.js';
+import { TagsBuffer } from '../utils/tags-buffer.js';
+import { createLogger } from '../utils/logger.js';
+const fileLog = createLogger('FileCacheHandler');
+const writeFile = promisify(fs.writeFile);
+const readFile = promisify(fs.readFile);
+const mkdir = promisify(fs.mkdir);
+/**
+ * File-based cache handler for local development.
+ * Stores cache entries in the .next/cache directory.
+ */
+export class FileCacheHandler extends BaseCacheHandler {
+    constructor(context) {
+        super(context, 'FileCacheHandler');
+        this.baseDir = path.join(process.cwd(), '.next', 'cache');
+        this.fetchCacheDir = path.join(this.baseDir, 'fetch-cache');
+        this.routeCacheDir = path.join(this.baseDir, 'route-cache');
+        // Store build-meta.json outside .next/ to survive Next.js cache clearing during builds
+        this.buildMetaFile = path.join(process.cwd(), '.cache', 'build-meta.json');
+        this.tagsDir = path.join(this.baseDir, 'tags');
+        this.tagsMapFile = path.join(this.tagsDir, 'tags.json');
+        // Create tags buffer for batched writes (improves performance)
+        this.tagsBuffer = new TagsBuffer({
+            flushIntervalMs: 100, // File system can handle faster flushes than GCS
+            readTagsMapping: () => Promise.resolve(this.readTagsMappingDirect()),
+            writeTagsMapping: (mapping) => {
+                this.writeTagsMappingDirect(mapping);
+                return Promise.resolve();
+            },
+            handlerName: 'FileCacheHandler',
+        });
+        this.ensureCacheDir();
+        // Initialize asynchronously (don't await to avoid blocking constructor)
+        this.initialize().catch(() => { });
+    }
+    ensureCacheDir() {
+        try {
+            fs.mkdirSync(this.fetchCacheDir, { recursive: true });
+            fs.mkdirSync(this.routeCacheDir, { recursive: true });
+            fs.mkdirSync(this.tagsDir, { recursive: true });
+        }
+        catch (error) {
+            if (error.code !== 'EEXIST') {
+                this.log.error('Error creating cache directories:', error);
+            }
+        }
+    }
+    // ============================================================================
+    // Tags mapping implementation (buffered for improved performance)
+    // ============================================================================
+    async initializeTagsMapping() {
+        try {
+            if (!fs.existsSync(this.tagsMapFile)) {
+                fs.writeFileSync(this.tagsMapFile, JSON.stringify({}, null, 2), 'utf-8');
+            }
+        }
+        catch {
+            // Silently fail - tags mapping will be created on first write
+        }
+    }
+    /**
+     * Read tags mapping, flushing any pending updates first to ensure accuracy.
+     */
+    async readTagsMapping() {
+        // Flush pending updates before reading to ensure we have accurate data
+        await this.tagsBuffer.flush();
+        return this.readTagsMappingDirect();
+    }
+    /**
+     * Direct read from file system without flushing buffer.
+     * Used internally by the buffer.
+     */
+    readTagsMappingDirect() {
+        try {
+            if (!fs.existsSync(this.tagsMapFile)) {
+                return {};
+            }
+            const data = fs.readFileSync(this.tagsMapFile, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch (error) {
+            this.log.warn('Error reading tags mapping:', error);
+            return {};
+        }
+    }
+    /**
+     * Write tags mapping directly to file system.
+     * Used by the buffer for batched writes.
+     */
+    async writeTagsMapping(tagsMapping) {
+        this.writeTagsMappingDirect(tagsMapping);
+    }
+    /**
+     * Direct write to file system (sync).
+     * Used internally by the buffer.
+     */
+    writeTagsMappingDirect(tagsMapping) {
+        try {
+            fs.writeFileSync(this.tagsMapFile, JSON.stringify(tagsMapping, null, 2), 'utf-8');
+        }
+        catch (error) {
+            this.log.error('Error writing tags mapping:', error);
+            throw error; // Re-throw so buffer can retry
+        }
+    }
+    /**
+     * Override to use buffered updates instead of immediate writes.
+     */
+    async updateTagsMapping(cacheKey, tags, isDelete = false) {
+        if (isDelete) {
+            this.tagsBuffer.deleteKey(cacheKey);
+        }
+        else if (tags.length > 0) {
+            this.tagsBuffer.addTags(cacheKey, tags);
+        }
+        // Updates are queued and will be flushed automatically
+        this.log.debug(`Queued tags update for ${cacheKey} (pending: ${this.tagsBuffer.pendingCount})`);
+    }
+    /**
+     * Override to use buffered deletes instead of immediate writes.
+     */
+    async updateTagsMappingBulkDelete(cacheKeysToDelete, _tagsMapping) {
+        this.tagsBuffer.deleteKeys(cacheKeysToDelete);
+        // Force flush after bulk delete to ensure consistency for revalidation
+        await this.tagsBuffer.flush();
+    }
+    // ============================================================================
+    // Cache entry implementation
+    // ============================================================================
+    getCacheFilePath(cacheKey, cacheType) {
+        const safeKey = cacheKey.replace(/[^a-zA-Z0-9-]/g, '_');
+        const dir = cacheType === 'fetch' ? this.fetchCacheDir : this.routeCacheDir;
+        return path.join(dir, `${safeKey}.json`);
+    }
+    async readCacheEntry(cacheKey, cacheType) {
+        try {
+            const filePath = this.getCacheFilePath(cacheKey, cacheType);
+            const data = await readFile(filePath, 'utf-8');
+            const parsedData = JSON.parse(data);
+            return this.deserializeFromStorage({ [cacheKey]: parsedData })[cacheKey] || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async writeCacheEntry(cacheKey, cacheValue, cacheType) {
+        try {
+            this.ensureCacheDir();
+            const filePath = this.getCacheFilePath(cacheKey, cacheType);
+            const serializedData = this.serializeForStorage({ [cacheKey]: cacheValue });
+            await writeFile(filePath, JSON.stringify(serializedData[cacheKey], null, 2), 'utf-8');
+        }
+        catch (error) {
+            this.log.error(`Error writing cache entry ${cacheKey}:`, error);
+        }
+    }
+    async deleteCacheEntry(cacheKey, cacheType) {
+        try {
+            const filePath = this.getCacheFilePath(cacheKey, cacheType);
+            await fs.promises.unlink(filePath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                this.log.error(`Error deleting cache entry ${cacheKey}:`, error);
+            }
+            throw error;
+        }
+    }
+    // ============================================================================
+    // Build meta implementation
+    // ============================================================================
+    async readBuildMeta() {
+        const data = await readFile(this.buildMetaFile, 'utf-8');
+        return JSON.parse(data);
+    }
+    async writeBuildMeta(meta) {
+        const buildMetaDir = path.dirname(this.buildMetaFile);
+        await mkdir(buildMetaDir, { recursive: true });
+        await writeFile(this.buildMetaFile, JSON.stringify(meta), 'utf-8');
+    }
+    async invalidateRouteCache() {
+        try {
+            await fs.promises.rm(this.routeCacheDir, { recursive: true, force: true });
+            await fs.promises.mkdir(this.routeCacheDir, { recursive: true });
+        }
+        catch {
+            // Directory might not exist or can't be created - not critical
+        }
+    }
+}
+// ============================================================================
+// Standalone functions for API usage
+// ============================================================================
+/**
+ * Get cache statistics for the file-based cache.
+ */
+export async function getSharedCacheStats() {
+    const fetchCacheDir = path.join(process.cwd(), '.next', 'cache', 'fetch-cache');
+    const routeCacheDir = path.join(process.cwd(), '.next', 'cache', 'route-cache');
+    const keys = [];
+    const entries = [];
+    try {
+        await processCacheDirectory(fetchCacheDir, 'fetch', keys, entries);
+        await processCacheDirectory(routeCacheDir, 'route', keys, entries);
+        fileLog.debug(`Found ${keys.length} cache entries ` +
+            `(${keys.filter((k) => k.startsWith('fetch:')).length} fetch, ` +
+            `${keys.filter((k) => k.startsWith('route:')).length} route)`);
+        return { size: keys.length, keys, entries };
+    }
+    catch (error) {
+        fileLog.error('Error reading cache directories:', error);
+        return { size: 0, keys: [], entries: [] };
+    }
+}
+async function processCacheDirectory(dir, cacheType, keys, entries) {
+    try {
+        const files = await fs.promises.readdir(dir);
+        const jsonFiles = files.filter((file) => file.endsWith('.json'));
+        for (const file of jsonFiles) {
+            await processJsonCacheFile(dir, file, cacheType, keys, entries);
+        }
+    }
+    catch {
+        // Directory might not exist
+    }
+}
+async function processJsonCacheFile(dir, file, cacheType, keys, entries) {
+    const cacheKey = file.replace('.json', '').replace(/_/g, '-');
+    const displayKey = `${cacheType}:${cacheKey}`;
+    keys.push(displayKey);
+    try {
+        const filePath = path.join(dir, file);
+        const data = await fs.promises.readFile(filePath, 'utf-8');
+        const cacheData = JSON.parse(data);
+        entries.push({
+            key: displayKey,
+            tags: cacheData.tags || [],
+            lastModified: cacheData.lastModified || Date.now(),
+            type: cacheType,
+        });
+    }
+    catch {
+        entries.push({
+            key: displayKey,
+            tags: [],
+            type: cacheType,
+        });
+    }
+}
+/**
+ * Clear all cache entries for the file-based cache.
+ */
+export async function clearSharedCache() {
+    const fetchCacheDir = path.join(process.cwd(), '.next', 'cache', 'fetch-cache');
+    const routeCacheDir = path.join(process.cwd(), '.next', 'cache', 'route-cache');
+    const tagsFilePath = path.join(process.cwd(), '.next', 'cache', 'tags', 'tags.json');
+    const staticRoutes = getStaticRoutes();
+    let clearedCount = 0;
+    let preservedCount = 0;
+    try {
+        // Clear fetch cache (data cache - always clearable)
+        clearedCount += await clearFetchCache(fetchCacheDir);
+        // Clear route cache (skip static routes)
+        const routeResult = await clearRouteCache(routeCacheDir, staticRoutes);
+        clearedCount += routeResult.cleared;
+        preservedCount = routeResult.preserved;
+        // Clear tags mapping
+        await clearTagsMapping(tagsFilePath);
+        fileLog.info(`Total cleared: ${clearedCount} cache entries`);
+        return clearedCount;
+    }
+    catch (error) {
+        fileLog.error('Error clearing cache directories:', error);
+        return 0;
+    }
+}
+async function clearFetchCache(dir) {
+    try {
+        const files = await fs.promises.readdir(dir);
+        const jsonFiles = files.filter((file) => file.endsWith('.json'));
+        for (const file of jsonFiles) {
+            await fs.promises.unlink(path.join(dir, file));
+        }
+        fileLog.debug(`Cleared ${jsonFiles.length} fetch cache entries`);
+        return jsonFiles.length;
+    }
+    catch {
+        return 0;
+    }
+}
+async function clearRouteCache(dir, staticRoutes) {
+    let cleared = 0;
+    let preserved = 0;
+    try {
+        const files = await fs.promises.readdir(dir);
+        const jsonFiles = files.filter((file) => file.endsWith('.json'));
+        for (const file of jsonFiles) {
+            const cacheKey = file.replace('.json', '');
+            if (staticRoutes.has(cacheKey)) {
+                preserved++;
+                continue;
+            }
+            await fs.promises.unlink(path.join(dir, file));
+            cleared++;
+        }
+        fileLog.debug(`Route cache: cleared ${cleared}, preserved ${preserved} static routes`);
+    }
+    catch {
+        // Directory might not exist
+    }
+    return { cleared, preserved };
+}
+async function clearTagsMapping(tagsFilePath) {
+    try {
+        const exists = await fs.promises
+            .access(tagsFilePath)
+            .then(() => true)
+            .catch(() => false);
+        if (exists) {
+            await fs.promises.unlink(tagsFilePath);
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+}
+export default FileCacheHandler;
+//# sourceMappingURL=file.js.map

package/dist/handlers/file.js.map

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

package/dist/handlers/gcs.d.ts

@@ -0,0 +1,66 @@
+import type { CacheStats, CacheHandlerValue, FileSystemCacheContext } from '../types.js';
+import { BaseCacheHandler, type BuildMeta } from './base.js';
+/**
+ * Google Cloud Storage cache handler for production/Pantheon environments.
+ * Stores cache entries in a GCS bucket.
+ */
+export declare class GcsCacheHandler extends BaseCacheHandler {
+    private readonly bucket;
+    private readonly fetchCachePrefix;
+    private readonly routeCachePrefix;
+    private readonly buildMetaKey;
+    private readonly tagsPrefix;
+    private readonly tagsMapKey;
+    private readonly edgeCacheClearer;
+    private readonly tagsBuffer;
+    constructor(context: FileSystemCacheContext);
+    protected initializeTagsMapping(): Promise<void>;
+    /**
+     * Read tags mapping, flushing any pending updates first to ensure accuracy.
+     */
+    protected readTagsMapping(): Promise<Record<string, string[]>>;
+    /**
+     * Direct read from GCS without flushing buffer.
+     * Used internally by the buffer.
+     */
+    private readTagsMappingDirect;
+    /**
+     * Write tags mapping directly to GCS.
+     * Used by the buffer for batched writes.
+     */
+    protected writeTagsMapping(tagsMapping: Record<string, string[]>): Promise<void>;
+    /**
+     * 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 getCacheKey;
+    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>;
+    private clearEdgeCache;
+    protected onRevalidateComplete(tags: string[], deletedKeys: string[]): Promise<void>;
+    /**
+     * Called when a route cache entry is set (ISR page update).
+     * Clears the edge cache for this specific route so users get the fresh version.
+     */
+    protected onRouteCacheSet(cacheKey: string): void;
+    private cacheKeyToRoutePath;
+    private extractRoutePaths;
+}
+/**
+ * Get cache statistics for the GCS-based cache.
+ */
+export declare function getSharedCacheStats(): Promise<CacheStats>;
+/**
+ * Clear all cache entries for the GCS-based cache.
+ */
+export declare function clearSharedCache(): Promise<number>;
+export default GcsCacheHandler;
+//# sourceMappingURL=gcs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gcs.d.ts","sourceRoot":"","sources":["../../src/handlers/gcs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAEV,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AAQ7D;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;gBAE5B,OAAO,EAAE,sBAAsB;cAmC3B,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBtD;;OAEG;cACa,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAMpE;;;OAGG;YACW,qBAAqB;IAiBnC;;;OAGG;cACa,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtF;;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,WAAW;cAMH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;cAmBjG,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,iBAAiB,EAC7B,SAAS,EAAE,OAAO,GAAG,OAAO,GAC3B,OAAO,CAAC,IAAI,CAAC;cAeA,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;cAiB/E,aAAa,IAAI,OAAO,CAAC,SAAS,CAAC;cAMnC,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;cAO9C,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrD,OAAO,CAAC,cAAc;cASG,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAenG;;;OAGG;cACgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAS1D,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,iBAAiB;CAU1B;AAMD;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC,CA+B/D;AAmDD;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CA2CxD;AAkED,eAAe,eAAe,CAAC"}