doc-freshness-checker 1.0.0

package/dist/validators/urlValidator.js

@@ -0,0 +1,320 @@
+import dns from 'dns/promises';
+import net from 'net';
+import { pruneOldestEntries, setWithMaxEntries } from '../utils/boundedMap.js';
+/**
+ * Browser-like User-Agent to avoid being blocked by sites that reject bots
+ */
+const USER_AGENT = 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36';
+/**
+ * Domains known to not support HEAD requests properly or have bot detection
+ * These will use GET requests directly
+ */
+const DOMAINS_REQUIRING_GET = [
+    'marketplace.visualstudio.com',
+    'code.visualstudio.com',
+    'visualstudio.microsoft.com',
+    'learn.microsoft.com',
+    'docs.microsoft.com',
+];
+const MAX_URL_CACHE_ENTRIES = 5000;
+/**
+ * Check whether a hostname resolves to a private/internal IP range.
+ * Prevents SSRF attacks against cloud metadata services, localhost, etc.
+ */
+function isPrivateHostname(hostname) {
+    // Block obvious private/reserved hostnames
+    if (hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '[::1]' || hostname === '::1' || hostname === '0.0.0.0') {
+        return true;
+    }
+    if (isPrivateIpAddress(hostname)) {
+        return true;
+    }
+    return false;
+}
+function isPrivateIpAddress(value) {
+    const ipVersion = net.isIP(value);
+    if (ipVersion === 4) {
+        const octets = value.split('.').map((part) => Number(part));
+        const [a, b] = octets;
+        if (octets.some((n) => !Number.isInteger(n) || n < 0 || n > 255))
+            return true;
+        if (a === 10)
+            return true; // 10.0.0.0/8
+        if (a === 172 && b >= 16 && b <= 31)
+            return true; // 172.16.0.0/12
+        if (a === 192 && b === 168)
+            return true; // 192.168.0.0/16
+        if (a === 169 && b === 254)
+            return true; // 169.254.0.0/16
+        if (a === 127)
+            return true; // 127.0.0.0/8
+        if (a === 0)
+            return true; // 0.0.0.0/8
+        if (a >= 224)
+            return true; // Multicast/reserved
+        return false;
+    }
+    if (ipVersion === 6) {
+        const normalized = value.toLowerCase();
+        if (normalized === '::1' || normalized === '::')
+            return true;
+        if (normalized.startsWith('fc') || normalized.startsWith('fd'))
+            return true; // fc00::/7
+        if (normalized.startsWith('fe8') || normalized.startsWith('fe9') || normalized.startsWith('fea') || normalized.startsWith('feb')) {
+            return true; // fe80::/10 link-local
+        }
+        if (normalized.startsWith('::ffff:127.'))
+            return true; // IPv4-mapped loopback
+        return false;
+    }
+    return false;
+}
+function hostnameMatchesDomain(hostname, domain) {
+    const normalizedHost = hostname.toLowerCase();
+    const normalizedDomain = domain.toLowerCase();
+    return normalizedHost === normalizedDomain || normalizedHost.endsWith(`.${normalizedDomain}`);
+}
+/**
+ * Validates external URLs are accessible
+ */
+export class UrlValidator {
+    cache;
+    constructor() {
+        this.cache = new Map();
+    }
+    async validateBatch(references, _document, config) {
+        if (!config.urlValidation?.enabled) {
+            return references.map((ref) => ({
+                reference: ref,
+                valid: true,
+                skipped: true,
+            }));
+        }
+        const concurrency = config.urlValidation?.concurrency || 5;
+        const timeout = config.urlValidation?.timeout || 10000;
+        const skipDomains = config.urlValidation?.skipDomains || [];
+        // Deduplicate - each unique URL only needs to be checked once
+        const urlToRefs = new Map();
+        for (const ref of references) {
+            const url = ref.value;
+            if (!urlToRefs.has(url)) {
+                urlToRefs.set(url, []);
+            }
+            urlToRefs.get(url).push(ref);
+        }
+        // Check each unique URL once
+        const uniqueUrls = Array.from(urlToRefs.keys());
+        const urlResults = new Map();
+        for (let i = 0; i < uniqueUrls.length; i += concurrency) {
+            const batch = uniqueUrls.slice(i, i + concurrency);
+            const batchResults = await Promise.all(batch.map(async (url) => {
+                // Create a temporary ref for validation
+                const refs = urlToRefs.get(url);
+                const result = await this.validateUrl(refs[0], timeout, skipDomains, config);
+                return { url, result };
+            }));
+            for (const { url, result } of batchResults) {
+                urlResults.set(url, result);
+            }
+        }
+        // Map results back to all references
+        const results = [];
+        for (const ref of references) {
+            const cachedResult = urlResults.get(ref.value);
+            results.push({
+                ...cachedResult,
+                reference: ref, // Use the actual reference
+            });
+        }
+        return results;
+    }
+    async validateUrl(ref, timeout, skipDomains, config) {
+        const url = ref.value;
+        // Skip URLs with template placeholders (${...}, {{...}}, etc.)
+        if (/\$\{.*\}|\{\{.*\}\}|<%.*%>/.test(url)) {
+            return {
+                reference: ref,
+                valid: true,
+                skipped: true,
+                message: 'URL contains template placeholders',
+            };
+        }
+        // Check skip domains and SSRF protection
+        try {
+            const urlObj = new URL(url);
+            if (urlObj.protocol !== 'http:' && urlObj.protocol !== 'https:') {
+                return {
+                    reference: ref,
+                    valid: false,
+                    severity: config.rules?.['external-url']?.severity || 'warning',
+                    message: `Unsupported URL protocol: ${urlObj.protocol}`,
+                };
+            }
+            if (skipDomains.some((domain) => hostnameMatchesDomain(urlObj.hostname, domain))) {
+                return {
+                    reference: ref,
+                    valid: true,
+                    skipped: true,
+                    message: 'Domain in skip list',
+                };
+            }
+            if (isPrivateHostname(urlObj.hostname)) {
+                return {
+                    reference: ref,
+                    valid: true,
+                    skipped: true,
+                    message: 'Skipped: private/internal address',
+                };
+            }
+            if (await this.resolvesToPrivateAddress(urlObj.hostname)) {
+                return {
+                    reference: ref,
+                    valid: true,
+                    skipped: true,
+                    message: 'Skipped: hostname resolves to private/internal address',
+                };
+            }
+        }
+        catch {
+            return {
+                reference: ref,
+                valid: false,
+                severity: config.rules?.['external-url']?.severity || 'warning',
+                message: `Invalid URL format: ${url}`,
+            };
+        }
+        // Check cache
+        if (this.cache.has(url)) {
+            const cached = this.cache.get(url);
+            if (Date.now() - cached.timestamp < (config.urlValidation?.cacheSeconds || 3600) * 1000) {
+                return {
+                    reference: ref,
+                    ...cached.result,
+                };
+            }
+        }
+        // Validate URL
+        try {
+            const urlObj = new URL(url);
+            const requiresGet = DOMAINS_REQUIRING_GET.some((domain) => urlObj.hostname.includes(domain));
+            // Try HEAD first (unless domain is known to not support it), then fall back to GET
+            let response = await this.fetchWithTimeout(url, requiresGet ? 'GET' : 'HEAD', timeout);
+            // If HEAD returns 404 or 405 (Method Not Allowed), retry with GET
+            if (!requiresGet && (response.status === 404 || response.status === 405)) {
+                response = await this.fetchWithTimeout(url, 'GET', timeout);
+            }
+            let result;
+            if (response.ok) {
+                result = {
+                    valid: true,
+                    statusCode: response.status,
+                };
+            }
+            else if (response.status === 401 || response.status === 403) {
+                // Authentication required - treat as valid but note it
+                result = {
+                    valid: true,
+                    statusCode: response.status,
+                    message: `Requires authentication: ${url}`,
+                };
+            }
+            else if (response.status === 404 && this.isGitHubUrl(url)) {
+                // GitHub private repos return 404 - treat as potentially valid
+                result = {
+                    valid: true,
+                    statusCode: response.status,
+                    message: `May be private repository: ${url}`,
+                };
+            }
+            else {
+                result = {
+                    valid: false,
+                    severity: config.rules?.['external-url']?.severity || 'warning',
+                    message: `${url} returned ${response.status} ${response.statusText}`,
+                    statusCode: response.status,
+                };
+            }
+            this.setCacheEntry(url, result);
+            return {
+                reference: ref,
+                ...result,
+            };
+        }
+        catch (error) {
+            const err = error;
+            const result = {
+                valid: false,
+                severity: (config.rules?.['external-url']?.severity || 'warning'),
+                message: err.name === 'AbortError' ? `URL timeout: ${url}` : `URL check failed: ${url} (${err.message})`,
+            };
+            this.setCacheEntry(url, result);
+            return {
+                reference: ref,
+                ...result,
+            };
+        }
+    }
+    async fetchWithTimeout(url, method, timeout) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                signal: controller.signal,
+                headers: {
+                    'User-Agent': USER_AGENT,
+                    Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+                    'Accept-Language': 'en-US,en;q=0.5',
+                },
+                redirect: 'follow',
+            });
+            const result = { ok: response.ok, status: response.status, statusText: response.statusText };
+            // Drain the response body to free the TCP connection
+            response.body?.cancel().catch(() => { });
+            return result;
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Check if URL is a GitHub URL (repos can be private)
+     */
+    isGitHubUrl(url) {
+        try {
+            const urlObj = new URL(url);
+            return urlObj.hostname === 'github.com' || urlObj.hostname === 'raw.githubusercontent.com' || urlObj.hostname.endsWith('.github.com');
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Load cache from external source
+     */
+    loadCache(cacheData) {
+        for (const [url, data] of Object.entries(cacheData)) {
+            this.cache.set(url, data);
+        }
+        pruneOldestEntries(this.cache, MAX_URL_CACHE_ENTRIES);
+    }
+    /**
+     * Export cache for persistence
+     */
+    exportCache() {
+        return Object.fromEntries(this.cache);
+    }
+    async resolvesToPrivateAddress(hostname) {
+        try {
+            const addresses = await dns.lookup(hostname, { all: true, verbatim: true });
+            return addresses.some((entry) => isPrivateIpAddress(entry.address));
+        }
+        catch {
+            return false;
+        }
+    }
+    setCacheEntry(url, result) {
+        setWithMaxEntries(this.cache, url, { result, timestamp: Date.now() }, MAX_URL_CACHE_ENTRIES);
+    }
+}
+//# sourceMappingURL=urlValidator.js.map

package/dist/validators/urlValidator.js.map

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

package/dist/validators/urlValidator.test.d.ts

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

package/dist/validators/urlValidator.test.js

@@ -0,0 +1,252 @@
+import { UrlValidator } from './urlValidator.js';
+import dns from 'dns/promises';
+import { makeDoc, makeRef as makeBaseRef } from '../test-utils/factories.js';
+vi.mock('dns/promises', () => ({
+    default: {
+        lookup: vi.fn().mockResolvedValue([{ address: '93.184.216.34', family: 4 }]),
+    },
+}));
+function makeRef(url) {
+    return makeBaseRef('external-url', url);
+}
+const doc = makeDoc();
+const enabledConfig = { urlValidation: { enabled: true, timeout: 5000 } };
+describe('UrlValidator', () => {
+    let validator;
+    beforeEach(() => {
+        validator = new UrlValidator();
+    });
+    it('skips all URLs when urlValidation is disabled', async () => {
+        const results = await validator.validateBatch([makeRef('https://example.com')], doc, { urlValidation: { enabled: false } });
+        expect(results).toHaveLength(1);
+        expect(results[0].skipped).toBe(true);
+    });
+    it('skips URLs with template placeholders', async () => {
+        const results = await validator.validateBatch([
+            makeRef('https://api.example.com/${version}/endpoint'),
+            makeRef('https://api.example.com/{{path}}/data'),
+            makeRef('https://api.example.com/<% url %>'),
+        ], doc, enabledConfig);
+        results.forEach((r) => {
+            expect(r.skipped).toBe(true);
+            expect(r.message).toContain('template');
+        });
+    });
+    it('skips domains in the skip list (including subdomains)', async () => {
+        const config = { urlValidation: { enabled: true, skipDomains: ['example.com'] } };
+        const results = await validator.validateBatch([makeRef('https://example.com/path'), makeRef('https://api.example.com/path')], doc, config);
+        results.forEach((r) => expect(r.skipped).toBe(true));
+    });
+    describe('SSRF protection - private hostnames', () => {
+        it.each(['http://localhost:3000', 'http://127.0.0.1/admin', 'http://0.0.0.0/', 'http://[::1]/'])('skips %s', async (url) => {
+            const results = await validator.validateBatch([makeRef(url)], doc, enabledConfig);
+            expect(results[0].skipped).toBe(true);
+        });
+        it.each([
+            ['10.0.0.1', '10.x.x.x range'],
+            ['172.16.0.1', '172.16-31.x.x range'],
+            ['172.31.255.255', '172.16-31.x.x upper bound'],
+            ['192.168.1.1', '192.168.x.x range'],
+            ['169.254.1.1', '169.254.x.x link-local'],
+            ['224.0.0.1', 'multicast range'],
+            ['255.255.255.255', 'broadcast'],
+        ])('skips private IPv4 %s (%s)', async (ip) => {
+            const results = await validator.validateBatch([makeRef(`http://${ip}/`)], doc, enabledConfig);
+            expect(results[0].skipped).toBe(true);
+        });
+    });
+    it('rejects unsupported protocols', async () => {
+        const results = await validator.validateBatch([makeRef('ftp://files.example.com')], doc, enabledConfig);
+        expect(results[0].valid).toBe(false);
+        expect(results[0].message).toContain('Unsupported URL protocol');
+    });
+    it('rejects invalid URL format', async () => {
+        const results = await validator.validateBatch([makeRef('not-a-valid-url')], doc, enabledConfig);
+        expect(results[0].valid).toBe(false);
+        expect(results[0].message).toContain('Invalid URL');
+    });
+    describe('HTTP validation', () => {
+        it('validates accessible URLs as valid (200)', async () => {
+            fetchMock.mockResponseOnce('', { status: 200 });
+            const results = await validator.validateBatch([makeRef('https://httpbin.org/status/200')], doc, enabledConfig);
+            expect(results[0].valid).toBe(true);
+            expect(results[0].statusCode).toBe(200);
+        });
+        it('falls back from HEAD to GET on 404', async () => {
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('', { status: 200 });
+            const results = await validator.validateBatch([makeRef('https://example.com/page')], doc, enabledConfig);
+            expect(results[0].valid).toBe(true);
+            expect(fetchMock).toHaveBeenCalledTimes(2);
+        });
+        it('falls back from HEAD to GET on 405 Method Not Allowed', async () => {
+            fetchMock.mockResponseOnce('', { status: 405 });
+            fetchMock.mockResponseOnce('', { status: 200 });
+            const results = await validator.validateBatch([makeRef('https://example.com/api')], doc, enabledConfig);
+            expect(results[0].valid).toBe(true);
+        });
+        it('uses GET directly for known GET-only domains', async () => {
+            fetchMock.mockResponseOnce('', { status: 200 });
+            const results = await validator.validateBatch([makeRef('https://marketplace.visualstudio.com/items?q=test')], doc, enabledConfig);
+            expect(results[0].valid).toBe(true);
+            expect(fetchMock).toHaveBeenCalledTimes(1);
+            expect(fetchMock.mock.calls[0][1]?.method).toBe('GET');
+        });
+        it('treats 401/403 as valid (auth-protected)', async () => {
+            fetchMock.mockResponseOnce('', { status: 401 });
+            const results = await validator.validateBatch([makeRef('https://api.example.com/protected')], doc, enabledConfig);
+            expect(results[0].valid).toBe(true);
+            expect(results[0].message).toContain('authentication');
+        });
+        it('treats GitHub 404 as potentially valid (private repo)', async () => {
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('', { status: 404 });
+            const results = await validator.validateBatch([makeRef('https://github.com/owner/private-repo')], doc, enabledConfig);
+            expect(results[0].valid).toBe(true);
+            expect(results[0].message).toContain('private');
+        });
+        it('marks non-GitHub 404 as invalid', async () => {
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('', { status: 404 });
+            const results = await validator.validateBatch([makeRef('https://example.com/missing')], doc, enabledConfig);
+            expect(results[0].valid).toBe(false);
+            expect(results[0].message).toContain('404');
+        });
+        it('marks 500 errors as invalid', async () => {
+            fetchMock.mockResponseOnce('', { status: 500 });
+            const results = await validator.validateBatch([makeRef('https://example.com/error')], doc, enabledConfig);
+            expect(results[0].valid).toBe(false);
+            expect(results[0].message).toContain('500');
+        });
+        it('handles fetch timeout (AbortError)', async () => {
+            fetchMock.mockAbortOnce();
+            const results = await validator.validateBatch([makeRef('https://slow.example.com/')], doc, enabledConfig);
+            expect(results[0].valid).toBe(false);
+            expect(results[0].message).toContain('timeout');
+        });
+        it('handles fetch network error', async () => {
+            fetchMock.mockRejectOnce(new Error('ECONNREFUSED'));
+            const results = await validator.validateBatch([makeRef('https://down.example.com/')], doc, enabledConfig);
+            expect(results[0].valid).toBe(false);
+            expect(results[0].message).toContain('ECONNREFUSED');
+        });
+        it('respects custom severity from config', async () => {
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('', { status: 404 });
+            const config = {
+                urlValidation: { enabled: true },
+                rules: { 'external-url': { severity: 'error' } },
+            };
+            const results = await validator.validateBatch([makeRef('https://example.com/missing')], doc, config);
+            expect(results[0].severity).toBe('error');
+        });
+    });
+    describe('deduplication', () => {
+        it('deduplicates identical URLs', async () => {
+            fetchMock.mockResponseOnce('', { status: 200 });
+            const refs = [makeRef('https://same.com'), makeRef('https://same.com')];
+            const results = await validator.validateBatch(refs, doc, enabledConfig);
+            expect(results).toHaveLength(2);
+            expect(fetchMock).toHaveBeenCalledTimes(1);
+        });
+    });
+    describe('cache', () => {
+        it('uses cached result for repeated URL within cache window', async () => {
+            fetchMock.mockResponseOnce('', { status: 200 });
+            await validator.validateBatch([makeRef('https://cached.example.com/')], doc, enabledConfig);
+            const results = await validator.validateBatch([makeRef('https://cached.example.com/')], doc, enabledConfig);
+            expect(results[0].valid).toBe(true);
+            expect(fetchMock).toHaveBeenCalledTimes(1);
+        });
+        it('loadCache and exportCache round-trip correctly', () => {
+            const data = { 'https://example.com': { result: { valid: true }, timestamp: Date.now() } };
+            validator.loadCache(data);
+            const exported = validator.exportCache();
+            expect(exported['https://example.com'].result.valid).toBe(true);
+        });
+    });
+    describe('concurrency', () => {
+        it('respects concurrency limit', async () => {
+            for (let i = 0; i < 10; i++)
+                fetchMock.mockResponseOnce('', { status: 200 });
+            const refs = Array.from({ length: 10 }, (_, i) => makeRef(`https://example${i}.com/`));
+            const config = { urlValidation: { enabled: true, concurrency: 3 } };
+            const results = await validator.validateBatch(refs, doc, config);
+            expect(results).toHaveLength(10);
+        });
+    });
+    describe('IPv6 SSRF protection', () => {
+        it('skips [::1] IPv6 loopback', async () => {
+            const results = await validator.validateBatch([makeRef('http://[::1]:8080/')], doc, enabledConfig);
+            expect(results[0].skipped).toBe(true);
+        });
+    });
+    describe('GitHub URL detection', () => {
+        it('treats raw.githubusercontent.com 404 as potentially valid', async () => {
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('', { status: 404 });
+            const results = await validator.validateBatch([makeRef('https://raw.githubusercontent.com/owner/repo/main/file.txt')], doc, enabledConfig);
+            expect(results[0].valid).toBe(true);
+        });
+        it('treats subdomain.github.com 404 as potentially valid', async () => {
+            fetchMock.mockResponseOnce('', { status: 404 });
+            fetchMock.mockResponseOnce('', { status: 404 });
+            const results = await validator.validateBatch([makeRef('https://docs.github.com/missing')], doc, enabledConfig);
+            expect(results[0].valid).toBe(true);
+        });
+    });
+    it('handles 403 as valid (authentication required)', async () => {
+        fetchMock.mockResponseOnce('', { status: 403 });
+        const results = await validator.validateBatch([makeRef('https://api.example.com/private')], doc, enabledConfig);
+        expect(results[0].valid).toBe(true);
+        expect(results[0].message).toContain('authentication');
+    });
+    describe('cache expiry', () => {
+        it('re-fetches when cache entry expires', async () => {
+            fetchMock.mockResponseOnce('', { status: 200 });
+            await validator.validateBatch([makeRef('https://expires.example.com/')], doc, enabledConfig);
+            expect(fetchMock).toHaveBeenCalledTimes(1);
+            validator.loadCache({
+                'https://expires.example.com/': {
+                    result: { valid: true },
+                    timestamp: Date.now() - 999_999_999,
+                },
+            });
+            fetchMock.mockResponseOnce('', { status: 200 });
+            const results = await validator.validateBatch([makeRef('https://expires.example.com/')], doc, {
+                urlValidation: { enabled: true, cacheSeconds: 1 },
+            });
+            expect(results[0].valid).toBe(true);
+            expect(fetchMock).toHaveBeenCalledTimes(2);
+        });
+    });
+    describe('DNS resolution to private IP', () => {
+        it('skips public hostnames that resolve to private IPs', async () => {
+            vi.mocked(dns.lookup).mockImplementationOnce((async () => {
+                return [{ address: '127.0.0.1', family: 4 }];
+            }));
+            const results = await validator.validateBatch([makeRef('https://public.example.com/api')], doc, enabledConfig);
+            expect(results[0].skipped).toBe(true);
+            expect(results[0].message).toContain('resolves to private');
+        });
+    });
+    describe('unsupported protocol severity', () => {
+        it('uses custom severity for unsupported protocol', async () => {
+            const config = {
+                urlValidation: { enabled: true },
+                rules: { 'external-url': { severity: 'error' } },
+            };
+            const results = await validator.validateBatch([makeRef('ftp://files.example.com')], doc, config);
+            expect(results[0].severity).toBe('error');
+        });
+    });
+    describe('response body draining', () => {
+        it('handles HEAD response with 200 ok', async () => {
+            fetchMock.mockResponseOnce('body content', { status: 200 });
+            const results = await validator.validateBatch([makeRef('https://body-drain.example.com/')], doc, enabledConfig);
+            expect(results[0].valid).toBe(true);
+            expect(results[0].statusCode).toBe(200);
+        });
+    });
+});
+//# sourceMappingURL=urlValidator.test.js.map

package/dist/validators/urlValidator.test.js.map

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

package/dist/validators/validationEngine.d.ts

@@ -0,0 +1,23 @@
+import type { BaseValidator, DocFreshnessConfig, Document, ValidationResults } from '../types.js';
+/**
+ * Orchestrates validation of extracted references
+ */
+export declare class ValidationEngine {
+    private config;
+    private validators;
+    constructor(config: DocFreshnessConfig);
+    /**
+     * Register a validator for a specific reference type
+     */
+    registerValidator(type: string, validator: BaseValidator): void;
+    /**
+     * Validate all references from parsed documents
+     */
+    validate(documents: Document[]): Promise<ValidationResults>;
+    /**
+     * Group references by type
+     */
+    private groupByType;
+    private classifyResult;
+    private incrementSummary;
+}