page-action-cache 1.0.3 → 2.0.0

package/dist/browser-action-executor.js

@@ -0,0 +1,283 @@
+/**
+ * Browser Action Executor - Page Action Cache
+ * 浏览器动作执行器 - 执行缓存的页面操作
+ */
+/**
+ * 浏览器动作执行器
+ */
+export class BrowserActionExecutor {
+    browserClient = null;
+    constructor() {
+        this.initializeBrowserClient();
+    }
+    /**
+     * 初始化浏览器客户端
+     */
+    initializeBrowserClient() {
+        try {
+            // 尝试连接到 OpenClaw Browser Client
+            // 这里使用 HTTP API 调用
+            const baseURL = process.env.OPENCLAW_BROWSER_CLIENT_URL || 'http://localhost:3000';
+            this.browserClient = {
+                navigate: async (url) => {
+                    try {
+                        const response = await fetch(`${baseURL}/api/browser/navigate`, {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ url })
+                        });
+                        const result = await response.json();
+                        return {
+                            success: result.success || false,
+                            message: result.message || 'Navigation completed'
+                        };
+                    }
+                    catch (error) {
+                        return {
+                            success: false,
+                            message: `Navigation failed: ${error.message}`
+                        };
+                    }
+                },
+                click: async (selector) => {
+                    try {
+                        const response = await fetch(`${baseURL}/api/browser/click`, {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ selector })
+                        });
+                        const result = await response.json();
+                        return {
+                            success: result.success || false,
+                            message: result.message || 'Click completed'
+                        };
+                    }
+                    catch (error) {
+                        return {
+                            success: false,
+                            message: `Click failed: ${error.message}`
+                        };
+                    }
+                },
+                'type': async (selector, text) => {
+                    try {
+                        const response = await fetch(`${baseURL}/api/browser/type`, {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ selector, text })
+                        });
+                        const result = await response.json();
+                        return {
+                            success: result.success || false,
+                            message: result.message || 'Type completed'
+                        };
+                    }
+                    catch (error) {
+                        return {
+                            success: false,
+                            message: `Type failed: ${error.message}`
+                        };
+                    }
+                },
+                screenshot: async (path) => {
+                    try {
+                        const response = await fetch(`${baseURL}/api/browser/screenshot`, {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ path })
+                        });
+                        const result = await response.json();
+                        return {
+                            success: result.success || false,
+                            message: result.message || 'Screenshot saved'
+                        };
+                    }
+                    catch (error) {
+                        return {
+                            success: false,
+                            message: `Screenshot failed: ${error.message}`
+                        };
+                    }
+                },
+                executeScript: async (script) => {
+                    try {
+                        const response = await fetch(`${baseURL}/api/browser/execute-script`, {
+                            method: 'POST',
+                            headers: { 'Content-Type': 'application/json' },
+                            body: JSON.stringify({ script })
+                        });
+                        const result = await response.json();
+                        return {
+                            success: result.success || false,
+                            message: result.message || 'Script executed',
+                            result: result.result
+                        };
+                    }
+                    catch (error) {
+                        return {
+                            success: false,
+                            message: `Script execution failed: ${error.message}`
+                        };
+                    }
+                }
+            };
+            console.log('[BrowserActionExecutor] Browser client initialized');
+        }
+        catch (error) {
+            console.warn('[BrowserActionExecutor] Failed to initialize browser client:', error);
+            this.browserClient = null;
+        }
+    }
+    /**
+     * 执行单个动作
+     */
+    async executeAction(action) {
+        if (!this.browserClient) {
+            return {
+                success: false,
+                message: 'Browser client not available',
+                savedTime: 0
+            };
+        }
+        const startTime = Date.now();
+        try {
+            let result;
+            switch (action.type) {
+                case 'navigate':
+                    if (!action.params?.url) {
+                        return { success: false, message: 'Missing URL parameter', savedTime: 0 };
+                    }
+                    result = await this.browserClient.navigate(action.params.url);
+                    break;
+                case 'click':
+                    if (!action.params?.selector) {
+                        return { success: false, message: 'Missing selector parameter', savedTime: 0 };
+                    }
+                    result = await this.browserClient.click(action.params.selector);
+                    break;
+                case 'type':
+                    if (!action.params?.selector || action.params?.text === undefined) {
+                        return { success: false, message: 'Missing selector or text parameter', savedTime: 0 };
+                    }
+                    result = await this.browserClient['type'](action.params.selector, action.params.text);
+                    break;
+                case 'screenshot':
+                    result = await this.browserClient.screenshot(action.params?.path);
+                    break;
+                case 'script':
+                    if (!action.params?.script) {
+                        return { success: false, message: 'Missing script parameter', savedTime: 0 };
+                    }
+                    result = await this.browserClient.executeScript(action.params.script);
+                    break;
+                default:
+                    return {
+                        success: false,
+                        message: `Unknown action type: ${action.type}`,
+                        savedTime: 0
+                    };
+            }
+            const executionTime = Date.now() - startTime;
+            // 假设每个动作平均可以节省 2 秒
+            const estimatedTimeSaved = 2000;
+            const savedTime = result.success ? Math.max(0, estimatedTimeSaved - executionTime) : 0;
+            return {
+                success: result.success,
+                message: result.message,
+                savedTime
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Action execution error: ${error.message}`,
+                savedTime: 0
+            };
+        }
+    }
+    /**
+     * 执行缓存条目中的所有动作
+     */
+    async executeCacheEntry(entry) {
+        if (!entry.actions || entry.actions.length === 0) {
+            return {
+                success: true,
+                message: 'No actions to execute',
+                executedActions: 0,
+                skippedActions: 0,
+                failedActions: 0,
+                savedTime: 0
+            };
+        }
+        let executedActions = 0;
+        let skippedActions = 0;
+        let failedActions = 0;
+        let totalSavedTime = 0;
+        let hasError = false;
+        let errorMessage = '';
+        for (let i = 0; i < entry.actions.length; i++) {
+            const action = entry.actions[i];
+            // 跳过失败次数过多的动作
+            const totalAttempts = action.successCount + action.failCount;
+            if (totalAttempts > 0 && action.failCount / totalAttempts > 0.7) {
+                skippedActions++;
+                console.log(`[BrowserActionExecutor] Skipping action ${i + 1} (high failure rate): ${action.type}`);
+                continue;
+            }
+            const result = await this.executeAction(action);
+            if (result.success) {
+                executedActions++;
+                totalSavedTime += result.savedTime;
+                console.log(`[BrowserActionExecutor] Executed action ${i + 1}: ${action.type} (${result.message})`);
+            }
+            else {
+                failedActions++;
+                hasError = true;
+                errorMessage = result.message;
+                console.error(`[BrowserActionExecutor] Failed action ${i + 1}: ${action.type} (${result.message})`);
+            }
+        }
+        return {
+            success: !hasError || failedActions < entry.actions.length / 2, // 允许部分失败
+            message: hasError ? `Execution completed with ${failedActions} failures` : 'Execution completed successfully',
+            executedActions,
+            skippedActions,
+            failedActions,
+            savedTime: totalSavedTime,
+            error: errorMessage
+        };
+    }
+    /**
+     * 检查浏览器客户端是否可用
+     */
+    isAvailable() {
+        return this.browserClient !== null;
+    }
+    /**
+     * 设置浏览器客户端（用于测试或自定义实现）
+     */
+    setBrowserClient(client) {
+        this.browserClient = client;
+    }
+    /**
+     * 估算执行时间
+     */
+    estimateExecutionTime(actions) {
+        // 估算每个动作的执行时间（毫秒）
+        const timeEstimates = {
+            navigate: 3000, // 导航通常需要 3 秒
+            click: 500, // 点击通常需要 0.5 秒
+            type: 1000, // 输入通常需要 1 秒
+            screenshot: 1500, // 截图通常需要 1.5 秒
+            script: 500 // 脚本执行通常需要 0.5 秒
+        };
+        return actions.reduce((total, action) => {
+            return total + (timeEstimates[action.type] || 500);
+        }, 0);
+    }
+}
+/**
+ * 单例导出
+ */
+export const browserActionExecutor = new BrowserActionExecutor();
+//# sourceMappingURL=browser-action-executor.js.map

package/dist/browser-action-executor.js.map

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

package/dist/cache-invalidation.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Cache Invalidation - Page Action Cache
+ * 缓存失效管理器 - 页面变化检测和缓存失效
+ */
+/**
+ * 页面变化类型
+ */
+type ChangeType = 'major' | 'minor' | 'none';
+/**
+ * 页面快照
+ */
+interface PageSnapshot {
+    url: string;
+    viewport: string;
+    timestamp: number;
+    htmlHash?: string;
+    structureHash?: string;
+    contentHash?: string;
+}
+/**
+ * 缓存失效策略
+ */
+type InvalidationStrategy = 'soft' | 'hard';
+/**
+ * 页面变化检测结果
+ */
+interface ChangeDetectionResult {
+    changed: boolean;
+    changeType: ChangeType;
+    changeScore: number;
+    confidence: number;
+}
+/**
+ * 缓存失效管理器
+ */
+export declare class CacheInvalidation {
+    private snapshots;
+    private changeHistory;
+    private strategy;
+    private changeThreshold;
+    constructor(strategy?: InvalidationStrategy, changeThreshold?: number);
+    /**
+     * 设置失效策略
+     */
+    setStrategy(strategy: InvalidationStrategy): void;
+    /**
+     * 设置变化阈值
+     */
+    setChangeThreshold(threshold: number): void;
+    /**
+     * 创建页面快照
+     */
+    createSnapshot(url: string, viewport: string, html?: string): PageSnapshot;
+    /**
+     * 保存页面快照
+     */
+    saveSnapshot(url: string, viewport: string, html?: string): void;
+    /**
+     * 检测页面变化
+     */
+    detectChanges(url: string, viewport: string, currentHtml: string): ChangeDetectionResult;
+    /**
+     * 计算变化分数
+     */
+    private calculateChangeScore;
+    /**
+     * 确定变化类型
+     */
+    private determineChangeType;
+    /**
+     * 计算置信度
+     */
+    private calculateConfidence;
+    /**
+     * 记录变化历史
+     */
+    private recordChangeHistory;
+    /**
+     * 判断是否应该失效缓存
+     */
+    shouldInvalidate(url: string, viewport: string, currentHtml: string): boolean;
+    /**
+     * 失效缓存条目
+     */
+    invalidate(url: string, viewport: string): void;
+    /**
+     * 批量失效 URL 相关的所有缓存
+     */
+    invalidateByUrl(url: string): void;
+    /**
+     * 获取失效统计
+     */
+    getInvalidationStats(): {
+        totalSnapshots: number;
+        activeSnapshots: number;
+        invalidationRate: number;
+    };
+    /**
+     * 清理过期快照
+     */
+    cleanup(maxAge?: number): void;
+    /**
+     * 生成哈希
+     */
+    private generateHash;
+    /**
+     * 生成结构哈希
+     */
+    private generateStructureHash;
+    /**
+     * 生成内容哈希
+     */
+    private generateContentHash;
+    /**
+     * 生成快照键
+     */
+    private getSnapshotKey;
+    /**
+     * 重置
+     */
+    reset(): void;
+}
+/**
+ * 单例导出
+ */
+export declare const cacheInvalidation: CacheInvalidation;
+export {};
+//# sourceMappingURL=cache-invalidation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache-invalidation.d.ts","sourceRoot":"","sources":["../src/cache-invalidation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,KAAK,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C;;GAEG;AACH,UAAU,YAAY;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,KAAK,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5C;;GAEG;AACH,UAAU,qBAAqB;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAwC;IACzD,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,eAAe,CAAe;gBAE1B,QAAQ,GAAE,oBAA6B,EAAE,eAAe,GAAE,MAAY;IAKlF;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAIjD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACH,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY;IAgB1E;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAMhE;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,qBAAqB;IA4BxF;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA4B5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAc3B;;OAEG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IA0B7E;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAM/C;;OAEG;IACH,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IASlC;;OAEG;IACH,oBAAoB,IAAI;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAiBD;;OAEG;IACH,OAAO,CAAC,MAAM,GAAE,MAAgC,GAAG,IAAI;IAkBvD;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/cache-invalidation.js

@@ -0,0 +1,262 @@
+/**
+ * Cache Invalidation - Page Action Cache
+ * 缓存失效管理器 - 页面变化检测和缓存失效
+ */
+/**
+ * 缓存失效管理器
+ */
+export class CacheInvalidation {
+    snapshots = new Map();
+    changeHistory = new Map();
+    strategy = 'soft';
+    changeThreshold = 0.5;
+    constructor(strategy = 'soft', changeThreshold = 0.5) {
+        this.strategy = strategy;
+        this.changeThreshold = changeThreshold;
+    }
+    /**
+     * 设置失效策略
+     */
+    setStrategy(strategy) {
+        this.strategy = strategy;
+    }
+    /**
+     * 设置变化阈值
+     */
+    setChangeThreshold(threshold) {
+        this.changeThreshold = Math.max(0, Math.min(1, threshold));
+    }
+    /**
+     * 创建页面快照
+     */
+    createSnapshot(url, viewport, html) {
+        const snapshot = {
+            url,
+            viewport,
+            timestamp: Date.now()
+        };
+        if (html) {
+            snapshot.htmlHash = this.generateHash(html);
+            snapshot.structureHash = this.generateStructureHash(html);
+            snapshot.contentHash = this.generateContentHash(html);
+        }
+        return snapshot;
+    }
+    /**
+     * 保存页面快照
+     */
+    saveSnapshot(url, viewport, html) {
+        const key = this.getSnapshotKey(url, viewport);
+        const snapshot = this.createSnapshot(url, viewport, html);
+        this.snapshots.set(key, snapshot);
+    }
+    /**
+     * 检测页面变化
+     */
+    detectChanges(url, viewport, currentHtml) {
+        const key = this.getSnapshotKey(url, viewport);
+        const previousSnapshot = this.snapshots.get(key);
+        if (!previousSnapshot) {
+            return {
+                changed: true,
+                changeType: 'major',
+                changeScore: 1.0,
+                confidence: 0.8
+            };
+        }
+        const currentSnapshot = this.createSnapshot(url, viewport, currentHtml);
+        const changeScore = this.calculateChangeScore(previousSnapshot, currentSnapshot);
+        const changeType = this.determineChangeType(changeScore);
+        // 记录变化历史
+        this.recordChangeHistory(key, changeScore);
+        return {
+            changed: changeScore > this.changeThreshold,
+            changeType,
+            changeScore,
+            confidence: this.calculateConfidence(previousSnapshot, currentSnapshot)
+        };
+    }
+    /**
+     * 计算变化分数
+     */
+    calculateChangeScore(previous, current) {
+        let totalScore = 0;
+        let weightSum = 0;
+        // HTML 变化 (权重 0.4)
+        if (previous.htmlHash && current.htmlHash) {
+            const htmlChanged = previous.htmlHash !== current.htmlHash ? 1 : 0;
+            totalScore += htmlChanged * 0.4;
+            weightSum += 0.4;
+        }
+        // 结构变化 (权重 0.35)
+        if (previous.structureHash && current.structureHash) {
+            const structureChanged = previous.structureHash !== current.structureHash ? 1 : 0;
+            totalScore += structureChanged * 0.35;
+            weightSum += 0.35;
+        }
+        // 内容变化 (权重 0.25)
+        if (previous.contentHash && current.contentHash) {
+            const contentChanged = previous.contentHash !== current.contentHash ? 1 : 0;
+            totalScore += contentChanged * 0.25;
+            weightSum += 0.25;
+        }
+        return weightSum > 0 ? totalScore / weightSum : 0;
+    }
+    /**
+     * 确定变化类型
+     */
+    determineChangeType(changeScore) {
+        if (changeScore >= 0.7)
+            return 'major';
+        if (changeScore >= 0.3)
+            return 'minor';
+        return 'none';
+    }
+    /**
+     * 计算置信度
+     */
+    calculateConfidence(previous, current) {
+        // 时间越近，置信度越高
+        const timeDiff = current.timestamp - previous.timestamp;
+        const timeFactor = Math.max(0, 1 - timeDiff / (24 * 60 * 60 * 1000)); // 24小时内
+        return timeFactor * 0.8 + 0.2; // 基础置信度 0.2
+    }
+    /**
+     * 记录变化历史
+     */
+    recordChangeHistory(key, changeScore) {
+        if (!this.changeHistory.has(key)) {
+            this.changeHistory.set(key, []);
+        }
+        const history = this.changeHistory.get(key);
+        history.push(changeScore);
+        // 只保留最近 10 次记录
+        if (history.length > 10) {
+            history.shift();
+        }
+    }
+    /**
+     * 判断是否应该失效缓存
+     */
+    shouldInvalidate(url, viewport, currentHtml) {
+        const detection = this.detectChanges(url, viewport, currentHtml);
+        if (this.strategy === 'hard') {
+            // 硬失效：任何变化都失效
+            return detection.changed;
+        }
+        else {
+            // 软失效：根据变化类型和阈值判断
+            const key = this.getSnapshotKey(url, viewport);
+            const history = this.changeHistory.get(key) || [];
+            // 如果是重大变化，立即失效
+            if (detection.changeType === 'major') {
+                return true;
+            }
+            // 如果连续 3 次检测到变化，失效
+            const recentChanges = history.slice(-3);
+            if (recentChanges.length === 3 && recentChanges.every(s => s > this.changeThreshold)) {
+                return true;
+            }
+            return detection.changed && detection.confidence > 0.7;
+        }
+    }
+    /**
+     * 失效缓存条目
+     */
+    invalidate(url, viewport) {
+        const key = this.getSnapshotKey(url, viewport);
+        this.snapshots.delete(key);
+        this.changeHistory.delete(key);
+    }
+    /**
+     * 批量失效 URL 相关的所有缓存
+     */
+    invalidateByUrl(url) {
+        for (const key of this.snapshots.keys()) {
+            if (key.startsWith(`${url}:`)) {
+                this.snapshots.delete(key);
+                this.changeHistory.delete(key);
+            }
+        }
+    }
+    /**
+     * 获取失效统计
+     */
+    getInvalidationStats() {
+        const totalSnapshots = this.changeHistory.size;
+        let activeInvalidations = 0;
+        for (const history of this.changeHistory.values()) {
+            if (history.length > 0 && history[history.length - 1] > this.changeThreshold) {
+                activeInvalidations++;
+            }
+        }
+        return {
+            totalSnapshots,
+            activeSnapshots: this.snapshots.size,
+            invalidationRate: totalSnapshots > 0 ? activeInvalidations / totalSnapshots : 0
+        };
+    }
+    /**
+     * 清理过期快照
+     */
+    cleanup(maxAge = 7 * 24 * 60 * 60 * 1000) {
+        const now = Date.now();
+        const expiredKeys = [];
+        for (const [key, snapshot] of this.snapshots.entries()) {
+            if (now - snapshot.timestamp > maxAge) {
+                expiredKeys.push(key);
+            }
+        }
+        for (const key of expiredKeys) {
+            this.snapshots.delete(key);
+            this.changeHistory.delete(key);
+        }
+        console.log(`[CacheInvalidation] Cleaned up ${expiredKeys.length} expired snapshots`);
+    }
+    /**
+     * 生成哈希
+     */
+    generateHash(str) {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // Convert to 32bit integer
+        }
+        return Math.abs(hash).toString(16);
+    }
+    /**
+     * 生成结构哈希
+     */
+    generateStructureHash(html) {
+        // 移除文本内容，只保留标签结构
+        const structure = html.replace(/>[^<]*</g, '><').replace(/\s+/g, '');
+        return this.generateHash(structure);
+    }
+    /**
+     * 生成内容哈希
+     */
+    generateContentHash(html) {
+        // 移除 HTML 标签，只保留文本内容
+        const content = html.replace(/<[^>]*>/g, '').replace(/\s+/g, ' ').trim();
+        return this.generateHash(content);
+    }
+    /**
+     * 生成快照键
+     */
+    getSnapshotKey(url, viewport) {
+        return `${url}:${viewport}`;
+    }
+    /**
+     * 重置
+     */
+    reset() {
+        this.snapshots.clear();
+        this.changeHistory.clear();
+    }
+}
+/**
+ * 单例导出
+ */
+export const cacheInvalidation = new CacheInvalidation();
+//# sourceMappingURL=cache-invalidation.js.map