doc-freshness-checker 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cosmocoder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,305 @@
+# Documentation Freshness Checker
+
+[![npm version](https://img.shields.io/npm/v/doc-freshness-checker.svg)](https://www.npmjs.com/package/doc-freshness-checker)
+[![npm downloads](https://img.shields.io/npm/dm/doc-freshness-checker.svg)](https://www.npmjs.com/package/doc-freshness-checker)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D22.19.0-brightgreen.svg)](https://nodejs.org/)
+[![CI](https://github.com/cosmocoder/doc-freshness-checker/actions/workflows/release.yml/badge.svg)](https://github.com/cosmocoder/doc-freshness-checker/actions/workflows/release.yml)
+
+Validate documentation against your codebase to catch stale references before they create confusion or slow onboarding. `doc-freshness-checker` scans your docs, extracts references to files, URLs, versions, symbols, dependencies, and directory trees, then validates each one against source code and manifests.
+
+## Table of Contents
+
+- [Why Use It](#why-use-it)
+- [Features](#features)
+- [Prerequisites](#prerequisites)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [CLI Reference](#cli-reference)
+- [What Gets Validated](#what-gets-validated)
+- [Configuration](#configuration)
+- [CI Integration](#ci-integration)
+- [Programmatic API](#programmatic-api)
+- [Contributing](#contributing)
+- [Acknowledgments](#acknowledgments)
+- [License](#license)
+
+## Why Use It
+
+- Reduce drift between docs and implementation.
+- Catch broken file links and dead external URLs.
+- Detect version mismatches between docs and manifests.
+- Surface code symbols mentioned in docs that no longer exist.
+- Run in CI as a quality gate or reporting step.
+
+## Features
+
+- **Documentation formats:** Markdown (`.md`, `.markdown`), reStructuredText (`.rst`), AsciiDoc (`.adoc`, `.asciidoc`), plaintext (`.txt`).
+- **Source indexing for symbol validation:** JavaScript, TypeScript, Python, Go, Rust, Java.
+- **Manifest parsing for version/dependency checks:** `package.json`, `requirements.txt`, `pyproject.toml`, `go.mod`, `Cargo.toml`, `pom.xml`.
+- **Reporters:** `console`, `json`, `markdown`, `enhanced`.
+- **Advanced modes:** incremental checking, freshness scoring, graph linking, semantic vector search.
+
+## Prerequisites
+
+- **Node.js** >= 22.19.0
+- **npm**
+
+## Installation
+
+```bash
+npm install --save-dev doc-freshness-checker
+```
+
+Global installation is also supported:
+
+```bash
+npm install -g doc-freshness-checker
+```
+
+## Quick Start
+
+Run with defaults (checks `docs/**/*.md` and `README.md`):
+
+```bash
+doc-freshness
+```
+
+Example console output:
+
+```
+📚 Documentation Freshness Report
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📊 Summary:
+   Total references checked: 42
+   ✅ Valid: 38
+   ❌ Errors: 2
+   ⚠️  Warnings: 2
+   ⏭️  Skipped: 0
+
+📋 Issues by Document:
+
+📄 docs/getting-started.md
+────────────────────────────────────────
+  ❌ Line 14: File not found: src/old-module.ts
+     💡 File may have been moved or renamed
+  ⚠️  Line 27: Version mismatch: docs say 2.1.0, package.json has 3.0.0
+
+📄 README.md
+────────────────────────────────────────
+  ❌ Line 45: Broken URL: https://example.com/dead-link (404)
+  ⚠️  Line 82: Symbol not found in source: calculateTotal()
+     💡 Symbol may have been renamed or removed
+```
+
+Create a minimal config:
+
+```js
+// .doc-freshness.config.js
+export default {
+  include: ['docs/**/*.md', 'README.md'],
+  exclude: ['**/node_modules/**'],
+};
+```
+
+Generate a Markdown report file:
+
+```bash
+doc-freshness --reporter markdown --output .doc-freshness-reports/report.md
+```
+
+## CLI Reference
+
+```bash
+doc-freshness [options]
+
+Options:
+  -c, --config <path>     Path to config file
+  -r, --reporter <type>   Reporter type (console, json, markdown, enhanced)
+  -o, --output <path>     Output file path for reports
+  -v, --verbose           Enable verbose logging
+  --only <types>          Only check specific reference types (comma-separated)
+  --skip-urls             Skip URL validation
+  --files <patterns>      Only check specific files (comma-separated glob patterns)
+  --manifest <files>      Manifest files to use (comma-separated)
+  --source <patterns>     Source patterns to use (comma-separated)
+  --no-cache              Disable caching
+  --clear-cache           Clear cache before running
+  --score                 Include freshness scores in report
+  --incremental           Only check changed files (requires cache)
+  --vector-search         Enable semantic vector search for doc-code mismatches
+```
+
+### Common Examples
+
+```bash
+# Basic scan
+doc-freshness
+
+# JSON report file
+doc-freshness --reporter json --output reports/doc-freshness.json
+
+# Faster run when network checks are not needed
+doc-freshness --skip-urls
+
+# Restrict to selected files
+doc-freshness --files "README.md,docs/usage.md"
+
+# Enable scoring and incremental mode
+doc-freshness --score --incremental
+```
+
+### Exit Codes
+
+- `0`: no validation errors
+- `1`: at least one validation error, or runtime/config failure
+
+## What Gets Validated
+
+| Reference type        | What is checked                                           |
+| --------------------- | --------------------------------------------------------- |
+| `file-path`           | Referenced files/directories exist                        |
+| `external-url`        | External URLs are reachable (with caching and skip rules) |
+| `version`             | Mentioned versions compared to parsed manifests           |
+| `directory-structure` | Tree snippets align with actual structure                 |
+| `code-pattern`        | Mentioned symbols exist in indexed source                 |
+| `dependency`          | Mentioned packages exist in manifest dependencies         |
+
+### URL Validation Behavior
+
+- Deduplicates repeated URLs per run.
+- Skips template-like URLs with placeholders.
+- Supports skip domains (defaults include `localhost`, `127.0.0.1`, `example.com`).
+- Treats auth-required responses (`401`/`403`) as valid-with-note.
+- Handles GitHub `404` private-repo behavior conservatively.
+- Caches URL results to reduce repeated checks.
+
+### False Positive Reduction
+
+Illustrative paths and symbols (e.g., tutorial placeholders) are detected automatically and can be skipped or downgraded in severity via rule configuration.
+
+## Configuration
+
+### Auto-Discovery
+
+When `--config` is not provided, the loader checks these names in project root:
+
+- `.doc-freshness.config.js`
+- `.doc-freshness.config.json`
+- `doc-freshness.config.js`
+- `doc-freshness.config.json`
+
+### Explicit Config Path
+
+With `--config`, the loader supports `.json`, `.cjs`, and JS/ESM config files.
+
+### Type-Safe Config
+
+Use `defineConfig` for better editor inference:
+
+```js
+import { defineConfig } from 'doc-freshness-checker';
+
+export default defineConfig({
+  include: ['docs/**/*.md', 'README.md'],
+  rules: {
+    'file-path': { enabled: true, severity: 'error' },
+    'external-url': { enabled: true, severity: 'warning' },
+  },
+});
+```
+
+<details>
+<summary>Full configuration example</summary>
+
+```js
+/** @type {import('doc-freshness-checker').DocFreshnessConfig} */
+export default {
+  rootDir: process.cwd(),
+  include: ['docs/**/*.md', 'README.md'],
+  exclude: ['**/node_modules/**', '**/dist/**'],
+
+  // Optional: auto-detected when null/omitted
+  manifestFiles: null,
+  sourcePatterns: null,
+
+  urlValidation: {
+    enabled: true,
+    timeout: 10000,
+    concurrency: 5,
+    skipDomains: ['localhost', '127.0.0.1', 'example.com'],
+    cacheSeconds: 3600,
+  },
+
+  rules: {
+    'file-path': { enabled: true, severity: 'error' },
+    'external-url': { enabled: true, severity: 'warning' },
+    version: { enabled: true, severity: 'warning' },
+    'directory-structure': { enabled: true, severity: 'warning' },
+    'code-pattern': { enabled: true, severity: 'warning' },
+    dependency: { enabled: true, severity: 'info' },
+  },
+
+  reporters: ['console'],
+  cache: { enabled: true, dir: '.doc-freshness-cache', maxAge: 86400000 },
+  incremental: { enabled: false },
+  vectorSearch: { enabled: false, similarityThreshold: 0.3 },
+  verbose: false,
+};
+```
+
+</details>
+
+For details on CLI-to-config mapping and precedence, see [CLI and Configuration Precedence](docs/cli-and-config-precedence.md). For the internal execution pipeline, see [Runtime Architecture](docs/runtime-architecture.md).
+
+## CI Integration
+
+This repository includes a GitHub Actions workflow at `.github/workflows/doc-freshness.yml` for a working example.
+
+Minimal CI command:
+
+```bash
+npx doc-freshness --reporter markdown --output .doc-freshness-reports/report.md
+```
+
+The same command works in GitHub Actions, GitLab CI, CircleCI, and other CI systems.
+
+## Programmatic API
+
+```js
+import { loadConfig, run } from 'doc-freshness-checker';
+
+const config = await loadConfig();
+const results = await run(config);
+
+console.log(results.summary);
+```
+
+Key exports:
+
+| Export                                                                    | Purpose                                              |
+| ------------------------------------------------------------------------- | ---------------------------------------------------- |
+| `run`, `runWithConfig`                                                    | Execute the checker programmatically                 |
+| `loadConfig`, `defineConfig`                                              | Load/merge configuration and type-safe config helper |
+| `DocumentParser`                                                          | Parse documentation files and extract references     |
+| `ValidationEngine`                                                        | Dispatch references to validators                    |
+| `ConsoleReporter`, `JsonReporter`, `MarkdownReporter`, `EnhancedReporter` | Reporter classes                                     |
+| `GraphBuilder`, `FreshnessScorer`, `VectorSearch`                         | Advanced analysis modules                            |
+| `DocFreshnessConfig`, `ValidationResults`                                 | Core types                                           |
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions, development workflow, and PR guidelines.
+
+## Acknowledgments
+
+- [Commander.js](https://github.com/tj/commander.js/) — CLI argument parsing
+- [glob](https://github.com/isaacs/node-glob) — File pattern matching
+- [semver](https://github.com/npm/node-semver) — Semantic version parsing and comparison
+- [FastEmbed](https://github.com/Anush008/fastembed) — Local embedding generation for semantic checks
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

package/dist/cache/cacheManager.d.ts

@@ -0,0 +1,42 @@
+import { CodeDocGraph } from '../graph/codeDocGraph.js';
+import type { CacheStats2, DocFreshnessConfig, UrlCacheEntry } from '../types.js';
+/**
+ * Manages caching of graph and URL validation results
+ */
+export declare class CacheManager {
+    private config;
+    private cacheDir;
+    private cacheFile;
+    private urlCacheFile;
+    constructor(config: DocFreshnessConfig);
+    private ensureCacheDir;
+    /**
+     * Save the code-to-doc graph
+     */
+    saveGraph(graph: CodeDocGraph): Promise<void>;
+    /**
+     * Load the cached graph
+     */
+    loadGraph(): Promise<CodeDocGraph | null>;
+    /**
+     * Check if cache is valid based on config hash and git state
+     */
+    isCacheValid(graph: CodeDocGraph | null, currentCommit: string | null): boolean;
+    private getConfigHash;
+    /**
+     * Save URL validation cache
+     */
+    saveUrlCache(urlResults: Record<string, UrlCacheEntry>): Promise<void>;
+    /**
+     * Load URL validation cache
+     */
+    loadUrlCache(): Promise<Record<string, UrlCacheEntry>>;
+    /**
+     * Clear all caches
+     */
+    clearCache(): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): Promise<CacheStats2>;
+}

package/dist/cache/cacheManager.js

@@ -0,0 +1,138 @@
+import fs from 'fs';
+import path from 'path';
+import crypto from 'crypto';
+import { CodeDocGraph } from '../graph/codeDocGraph.js';
+import { isWithinRoot, resolveProjectRoot } from '../utils/pathSecurity.js';
+/**
+ * Manages caching of graph and URL validation results
+ */
+export class CacheManager {
+    config;
+    cacheDir;
+    cacheFile;
+    urlCacheFile;
+    constructor(config) {
+        this.config = config;
+        const rawDir = config.cache?.dir || config.graph?.cacheDir || '.doc-freshness-cache';
+        const rootDir = resolveProjectRoot(config.rootDir);
+        // Path traversal protection: resolve and verify cache dir stays within project root
+        const resolved = path.resolve(rootDir, rawDir);
+        if (!isWithinRoot(resolved, rootDir)) {
+            throw new Error(`Cache directory "${rawDir}" resolves outside project root`);
+        }
+        this.cacheDir = resolved;
+        this.cacheFile = path.join(this.cacheDir, 'graph-cache.json');
+        this.urlCacheFile = path.join(this.cacheDir, 'url-cache.json');
+    }
+    async ensureCacheDir() {
+        await fs.promises.mkdir(this.cacheDir, { recursive: true });
+    }
+    /**
+     * Save the code-to-doc graph
+     */
+    async saveGraph(graph) {
+        await this.ensureCacheDir();
+        const data = graph.serialize();
+        data.configHash = this.getConfigHash();
+        await fs.promises.writeFile(this.cacheFile, JSON.stringify(data, null, 2));
+    }
+    /**
+     * Load the cached graph
+     */
+    async loadGraph() {
+        try {
+            const content = await fs.promises.readFile(this.cacheFile, 'utf-8');
+            const data = JSON.parse(content);
+            return CodeDocGraph.deserialize(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Check if cache is valid based on config hash and git state
+     */
+    isCacheValid(graph, currentCommit) {
+        if (!graph)
+            return false;
+        if (!graph.buildTimestamp)
+            return false;
+        const configHash = this.getConfigHash();
+        if (graph.configHash && graph.configHash !== configHash) {
+            return false;
+        }
+        if (currentCommit && graph.gitCommit) {
+            return currentCommit === graph.gitCommit;
+        }
+        const maxAge = this.config.cache?.maxAge || this.config.graph?.cacheMaxAge || 24 * 60 * 60 * 1000;
+        return Date.now() - graph.buildTimestamp < maxAge;
+    }
+    getConfigHash() {
+        const relevantConfig = {
+            include: this.config.include,
+            exclude: this.config.exclude,
+            sourcePatterns: this.config.sourcePatterns,
+            manifestFiles: this.config.manifestFiles,
+        };
+        return crypto.createHash('md5').update(JSON.stringify(relevantConfig)).digest('hex');
+    }
+    /**
+     * Save URL validation cache
+     */
+    async saveUrlCache(urlResults) {
+        await this.ensureCacheDir();
+        await fs.promises.writeFile(this.urlCacheFile, JSON.stringify(urlResults, null, 2));
+    }
+    /**
+     * Load URL validation cache
+     */
+    async loadUrlCache() {
+        try {
+            const content = await fs.promises.readFile(this.urlCacheFile, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return {};
+        }
+    }
+    /**
+     * Clear all caches
+     */
+    async clearCache() {
+        try {
+            await fs.promises.rm(this.cacheDir, { recursive: true });
+        }
+        catch {
+            // Directory doesn't exist
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    async getCacheStats() {
+        const stats = {
+            exists: false,
+            graphSize: 0,
+            urlCacheSize: 0,
+            lastUpdated: null,
+        };
+        try {
+            const graphStat = await fs.promises.stat(this.cacheFile);
+            stats.exists = true;
+            stats.graphSize = graphStat.size;
+            stats.lastUpdated = graphStat.mtime;
+        }
+        catch {
+            // File doesn't exist
+        }
+        try {
+            const urlStat = await fs.promises.stat(this.urlCacheFile);
+            stats.urlCacheSize = urlStat.size;
+        }
+        catch {
+            // File doesn't exist
+        }
+        return stats;
+    }
+}
+//# sourceMappingURL=cacheManager.js.map

package/dist/cache/cacheManager.js.map

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

package/dist/cache/cacheManager.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cache/cacheManager.test.js

@@ -0,0 +1,142 @@
+import fs from 'fs';
+import path from 'path';
+import { CacheManager } from './cacheManager.js';
+import { CodeDocGraph } from '../graph/codeDocGraph.js';
+describe('CacheManager', () => {
+    const cacheDir = path.join(process.cwd(), '.doc-freshness-cache', 'test-cache');
+    const config = {
+        rootDir: process.cwd(),
+        cache: { dir: '.doc-freshness-cache/test-cache' },
+    };
+    afterAll(async () => {
+        await fs.promises.rm(cacheDir, { recursive: true, force: true }).catch(() => { });
+    });
+    it('throws if cache dir resolves outside project root', () => {
+        const badConfig = {
+            rootDir: '/project',
+            cache: { dir: '../../etc/evil' },
+        };
+        expect(() => new CacheManager(badConfig)).toThrow('outside project root');
+    });
+    describe('graph operations', () => {
+        it('saves and loads a graph', async () => {
+            const manager = new CacheManager(config);
+            const graph = new CodeDocGraph();
+            graph.addReference('doc.md', 'src/a.ts', { type: 'file-path', value: 'a.ts', lineNumber: 1, raw: 'a.ts', sourceFile: 'doc.md' });
+            graph.buildTimestamp = Date.now();
+            await manager.saveGraph(graph);
+            const loaded = await manager.loadGraph();
+            expect(loaded).not.toBeNull();
+            expect(loaded.getCodeReferencedByDoc('doc.md').has('src/a.ts')).toBe(true);
+        });
+        it('loadGraph returns null when no cache exists', async () => {
+            const freshConfig = {
+                rootDir: process.cwd(),
+                cache: { dir: '.doc-freshness-cache/nonexistent-test' },
+            };
+            const manager = new CacheManager(freshConfig);
+            expect(await manager.loadGraph()).toBeNull();
+        });
+    });
+    describe('URL cache operations', () => {
+        it('saves and loads URL cache', async () => {
+            const manager = new CacheManager(config);
+            const urlData = { 'https://example.com': { result: { valid: true }, timestamp: Date.now() } };
+            await manager.saveUrlCache(urlData);
+            const loaded = await manager.loadUrlCache();
+            expect(loaded['https://example.com'].result.valid).toBe(true);
+        });
+        it('returns empty object when URL cache missing', async () => {
+            const freshConfig = { rootDir: process.cwd(), cache: { dir: '.doc-freshness-cache/no-url-cache' } };
+            const manager = new CacheManager(freshConfig);
+            expect(await manager.loadUrlCache()).toEqual({});
+        });
+    });
+    describe('isCacheValid', () => {
+        it('returns false for null graph', () => {
+            const manager = new CacheManager(config);
+            expect(manager.isCacheValid(null, null)).toBe(false);
+        });
+        it('returns false when graph has no buildTimestamp', () => {
+            const manager = new CacheManager(config);
+            const graph = new CodeDocGraph();
+            expect(manager.isCacheValid(graph, null)).toBe(false);
+        });
+        it('returns true when git commit matches', () => {
+            const manager = new CacheManager(config);
+            const graph = new CodeDocGraph();
+            graph.buildTimestamp = Date.now();
+            graph.gitCommit = 'abc123';
+            expect(manager.isCacheValid(graph, 'abc123')).toBe(true);
+        });
+        it('returns false when git commit differs', () => {
+            const manager = new CacheManager(config);
+            const graph = new CodeDocGraph();
+            graph.buildTimestamp = Date.now();
+            graph.gitCommit = 'abc123';
+            expect(manager.isCacheValid(graph, 'def456')).toBe(false);
+        });
+        it('uses time-based expiry when no git info', () => {
+            const manager = new CacheManager({ ...config, cache: { ...config.cache, maxAge: 1000 } });
+            const graph = new CodeDocGraph();
+            graph.buildTimestamp = Date.now();
+            expect(manager.isCacheValid(graph, null)).toBe(true);
+            graph.buildTimestamp = Date.now() - 2000;
+            expect(manager.isCacheValid(graph, null)).toBe(false);
+        });
+    });
+    describe('clearCache', () => {
+        it('removes the cache directory', async () => {
+            const manager = new CacheManager(config);
+            await manager.saveUrlCache({ test: { result: { valid: true }, timestamp: Date.now() } });
+            await manager.clearCache();
+            expect(await manager.loadUrlCache()).toEqual({});
+        });
+        it('handles non-existent cache directory', async () => {
+            const freshConfig = { rootDir: process.cwd(), cache: { dir: '.doc-freshness-cache/ghost' } };
+            const manager = new CacheManager(freshConfig);
+            await expect(manager.clearCache()).resolves.not.toThrow();
+        });
+    });
+    describe('isCacheValid - configHash', () => {
+        it('returns false when configHash differs', () => {
+            const manager = new CacheManager(config);
+            const graph = new CodeDocGraph();
+            graph.buildTimestamp = Date.now();
+            graph.configHash = 'stale-hash';
+            expect(manager.isCacheValid(graph, null)).toBe(false);
+        });
+        it('ignores configHash check when graph has no configHash', () => {
+            const manager = new CacheManager(config);
+            const graph = new CodeDocGraph();
+            graph.buildTimestamp = Date.now();
+            graph.configHash = null;
+            expect(manager.isCacheValid(graph, null)).toBe(true);
+        });
+    });
+    describe('getCacheStats', () => {
+        it('returns stats for existing cache', async () => {
+            const manager = new CacheManager(config);
+            const graph = new CodeDocGraph();
+            graph.buildTimestamp = Date.now();
+            await manager.saveGraph(graph);
+            const stats = await manager.getCacheStats();
+            expect(stats.exists).toBe(true);
+            expect(stats.graphSize).toBeGreaterThan(0);
+        });
+        it('returns empty stats when no cache', async () => {
+            const freshConfig = { rootDir: process.cwd(), cache: { dir: '.doc-freshness-cache/no-stats' } };
+            const manager = new CacheManager(freshConfig);
+            const stats = await manager.getCacheStats();
+            expect(stats.exists).toBe(false);
+            expect(stats.lastUpdated).toBeNull();
+        });
+        it('returns URL cache size when URL cache exists', async () => {
+            const manager = new CacheManager(config);
+            await manager.saveUrlCache({ 'https://x.com': { result: { valid: true }, timestamp: Date.now() } });
+            const stats = await manager.getCacheStats();
+            expect(stats.urlCacheSize).toBeGreaterThan(0);
+        });
+    });
+});
+//# sourceMappingURL=cacheManager.test.js.map

package/dist/cache/cacheManager.test.js.map

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