privalint 0.2.0 → 0.4.0

package/dist/data/third-parties.js

@@ -19,6 +19,15 @@ export const embeds = [
     { vendor: 'Facebook plugin', domains: ['facebook.com'], paths: ['/plugins/'] },
     { vendor: 'Spotify embed', domains: ['open.spotify.com'], paths: ['/embed/'] },
     { vendor: 'Disqus', domains: ['disqus.com', 'disquscdn.com'] },
+    { vendor: 'hCaptcha', domains: ['hcaptcha.com'] },
+    {
+        vendor: 'Cloudflare Turnstile',
+        domains: ['challenges.cloudflare.com'],
+        paths: ['/turnstile/'],
+    },
+    { vendor: 'OpenStreetMap tiles', domains: ['tile.openstreetmap.org'] },
+    { vendor: 'TikTok embed', domains: ['tiktok.com'], paths: ['/embed', '/embed.js', '/player/'] },
+    { vendor: 'Calendly', domains: ['calendly.com'] },
 ];
 /** Public CDNs for scripts, styles and icon fonts. */
 export const cdns = [

package/dist/data/third-parties.js.map

@@ -1 +1 @@
-{"version":3,"file":"third-parties.js","sourceRoot":"","sources":["../../src/data/third-parties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,WAAW,CAAC;AAMxD;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAA0B;IAC3C,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,aAAa,EAAE,sBAAsB,EAAE,WAAW,CAAC,EAAE;IACpF,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,kBAAkB,EAAE,cAAc,CAAC,EAAE;IAClE;QACE,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;KACxE;IACD,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE;IACrE,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,eAAe,CAAC,EAAE;IAC1D,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,aAAa,CAAC,EAAE;IAC9F,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE;IACjD,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,sBAAsB,EAAE,yBAAyB,CAAC,EAAE;IAC7F,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,eAAe,EAAE,kBAAkB,CAAC,EAAE;IAC7E,EAAE,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,WAAW,CAAC,EAAE;IAC9E,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE;IAC9E,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC,EAAE;CAC/D,CAAC;AAEF,sDAAsD;AACtD,MAAM,CAAC,MAAM,IAAI,GAA0B;IACzC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,kBAAkB,CAAC,EAAE;IACrD,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE;IAC3C,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,sBAAsB,CAAC,EAAE;IACtD,EAAE,MAAM,EAAE,yBAAyB,EAAE,OAAO,EAAE,CAAC,qBAAqB,CAAC,EAAE;IACvE,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,iBAAiB,CAAC,EAAE;IACtD;QACE,MAAM,EAAE,cAAc;QACtB,OAAO,EAAE,CAAC,4BAA4B,EAAE,yBAAyB,CAAC;KACnE;IACD,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAC,qBAAqB,CAAC,EAAE;IACjE;QACE,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,CAAC,qBAAqB,EAAE,qBAAqB,EAAE,sBAAsB,CAAC;KAChF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC"}
+{"version":3,"file":"third-parties.js","sourceRoot":"","sources":["../../src/data/third-parties.ts"],"names":[],"mappings":"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"}

package/dist/diagnostics.d.ts

@@ -0,0 +1,28 @@
+import type { BrowserContext, Request } from 'playwright';
+import type { CapturePhase, LoadDiagnostic, LoadDiagnostics, LoadIssueKind, RecordedRequest, SkipReason } from './types.js';
+/** Safe for diagnostics and operational logs. Raw URLs remain internal rule input. */
+export declare function diagnosticUrl(raw: string): string;
+/** Classify known transport codes; never persist arbitrary exception messages. */
+export declare function classifyLoadError(error: unknown): LoadIssueKind;
+export declare class Diagnostics {
+    private readonly maxIssues;
+    private readonly maxRecords;
+    readonly data: LoadDiagnostics;
+    phase: CapturePhase;
+    private readonly pending;
+    private readonly earlyFailures;
+    private stopped;
+    private readonly phaseIssues;
+    constructor(maxIssues: number, maxRecords?: number);
+    attach(context: BrowserContext, records: RecordedRequest[]): void;
+    private finish;
+    /** Defer storage until requestfailed to avoid counting adapter + browser errors twice. */
+    fail(request: Request, kind: LoadIssueKind, limit?: LoadDiagnostic['limit'], skippedReason?: SkipReason): void;
+    failUrl(url: string, kind: LoadIssueKind, limit?: LoadDiagnostic['limit'], skippedReason?: SkipReason): void;
+    add(kind: LoadIssueKind, url: string, extra?: Pick<LoadDiagnostic, 'status' | 'limit'>, phase?: CapturePhase): void;
+    private store;
+    hasIssues(phase: CapturePhase): boolean;
+    /** Freeze before closing the context: teardown errors are not resource failures. */
+    stop(): void;
+    private terminalFailure;
+}

package/dist/diagnostics.js

@@ -0,0 +1,202 @@
+/** Safe for diagnostics and operational logs. Raw URLs remain internal rule input. */
+export function diagnosticUrl(raw) {
+    try {
+        const url = new URL(raw);
+        return /^https?:$/.test(url.protocol) ? `${url.origin}/[redacted]` : '[redacted]';
+    }
+    catch {
+        return '[redacted]';
+    }
+}
+/** Classify known transport codes; never persist arbitrary exception messages. */
+export function classifyLoadError(error) {
+    const parts = [];
+    let cause = error;
+    for (let depth = 0; depth < 4 && cause instanceof Error; depth++) {
+        parts.push(cause.message, 'code' in cause ? String(cause.code) : '');
+        cause = cause.cause;
+    }
+    const text = parts.length > 0 ? parts.join(' ') : String(error);
+    if (/ERR_NAME_NOT_RESOLVED|ENOTFOUND|EAI_AGAIN/i.test(text))
+        return 'dns';
+    if (/ERR_CERT|ERR_SSL|CERT_|TLS|SELF_SIGNED|UNABLE_TO_VERIFY_LEAF/i.test(text))
+        return 'tls';
+    if (/timeout|timed.?out|ETIMEDOUT/i.test(text))
+        return 'timeout';
+    if (/ERR_CONNECTION|ECONN|ENETUNREACH|EHOSTUNREACH|socket hang up/i.test(text)) {
+        return 'connection';
+    }
+    return 'browser-failure';
+}
+export class Diagnostics {
+    maxIssues;
+    maxRecords;
+    data = {
+        requests: 0,
+        skippedRequests: 0,
+        failedRequests: 0,
+        securityBlockedRequests: 0,
+        omittedRequests: 0,
+        responses: 0,
+        finished: 0,
+        failed: 0,
+        blocked: 0,
+        httpErrors: 0,
+        bytes: 0,
+        issueCount: 0,
+        dropped: 0,
+        issues: [],
+    };
+    phase = 'before-consent';
+    pending = new Map();
+    earlyFailures = new Map();
+    stopped = false;
+    phaseIssues = { 'before-consent': 0, 'after-reject': 0 };
+    constructor(maxIssues, maxRecords = 5_000) {
+        this.maxIssues = maxIssues;
+        this.maxRecords = maxRecords;
+    }
+    attach(context, records) {
+        context.on('request', (request) => {
+            if (this.stopped)
+                return;
+            const record = {
+                url: request.url(),
+                resourceType: request.resourceType(),
+                outcome: 'pending',
+            };
+            if (records.length < this.maxRecords)
+                records.push(record);
+            else {
+                this.data.omittedRequests++;
+                if (this.data.omittedRequests === 1)
+                    this.add('resource-limit', request.url(), { limit: 'requests' });
+            }
+            const early = this.earlyFailures.get(request.url());
+            const issue = early?.shift();
+            if (early?.length === 0)
+                this.earlyFailures.delete(request.url());
+            this.pending.set(request, { record, phase: this.phase, ...(issue ? { issue } : {}) });
+            this.data.requests++;
+        });
+        context.on('response', (response) => {
+            if (this.stopped)
+                return;
+            const entry = this.pending.get(response.request());
+            if (entry === undefined)
+                return;
+            entry.record.outcome = 'response';
+            entry.record.status = response.status();
+            this.data.responses++;
+            if (response.status() >= 400) {
+                this.data.httpErrors++;
+                this.add('http-error', response.url(), { status: response.status() }, entry.phase);
+            }
+        });
+        context.on('requestfinished', (request) => this.finish(request));
+        context.on('requestfailed', (request) => {
+            const entry = this.pending.get(request);
+            if (entry === undefined || this.stopped)
+                return;
+            entry.record.outcome = 'failed';
+            const issue = entry.issue ?? {
+                kind: classifyLoadError(request.failure()?.errorText),
+                url: diagnosticUrl(request.url()),
+                phase: entry.phase,
+            };
+            this.terminalFailure(issue.kind);
+            this.store(issue);
+            this.data.failed++;
+            this.pending.delete(request);
+        });
+    }
+    finish(request) {
+        if (this.stopped || !this.pending.delete(request))
+            return;
+        this.data.finished++;
+    }
+    /** Defer storage until requestfailed to avoid counting adapter + browser errors twice. */
+    fail(request, kind, limit, skippedReason) {
+        const entry = this.pending.get(request);
+        if (entry === undefined)
+            return;
+        entry.issue = {
+            kind,
+            phase: entry.phase,
+            url: diagnosticUrl(request.url()),
+            ...(limit === undefined ? {} : { limit }),
+            ...(skippedReason === undefined ? {} : { skippedReason }),
+        };
+    }
+    failUrl(url, kind, limit, skippedReason) {
+        if (this.stopped)
+            return;
+        for (const [request, entry] of this.pending) {
+            if (request.url() === url && entry.issue === undefined) {
+                this.fail(request, kind, limit, skippedReason);
+                return;
+            }
+        }
+        // CDP can pause a request before Playwright emits it. Associate the reason on arrival.
+        const early = this.earlyFailures.get(url) ?? [];
+        early.push({
+            kind,
+            url: diagnosticUrl(url),
+            phase: this.phase,
+            ...(limit === undefined ? {} : { limit }),
+            ...(skippedReason === undefined ? {} : { skippedReason }),
+        });
+        this.earlyFailures.set(url, early);
+    }
+    add(kind, url, extra = {}, phase = this.phase) {
+        if (!this.stopped)
+            this.store({ kind, phase, url: diagnosticUrl(url), ...extra });
+    }
+    store(issue) {
+        this.phaseIssues[issue.phase]++;
+        this.data.issueCount++;
+        if (this.data.issues.length < this.maxIssues)
+            this.data.issues.push(issue);
+        else
+            this.data.dropped++;
+    }
+    hasIssues(phase) {
+        return this.phaseIssues[phase] > 0;
+    }
+    /** Freeze before closing the context: teardown errors are not resource failures. */
+    stop() {
+        if (this.stopped)
+            return;
+        for (const [request, entry] of this.pending) {
+            entry.record.outcome = 'failed';
+            const issue = entry.issue ?? {
+                kind: 'timeout',
+                phase: entry.phase,
+                url: diagnosticUrl(request.url()),
+            };
+            this.terminalFailure(issue.kind);
+            this.store(issue);
+            this.data.failed++;
+        }
+        this.pending.clear();
+        for (const issues of this.earlyFailures.values()) {
+            for (const issue of issues)
+                this.store(issue);
+        }
+        this.earlyFailures.clear();
+        this.stopped = true;
+    }
+    terminalFailure(kind) {
+        if (kind === 'security-blocked') {
+            this.data.blocked++;
+            this.data.securityBlockedRequests = (this.data.securityBlockedRequests ?? 0) + 1;
+        }
+        else if (['skipped', 'unsupported-method', 'unsupported-protocol'].includes(kind)) {
+            this.data.skippedRequests = (this.data.skippedRequests ?? 0) + 1;
+        }
+        else {
+            this.data.failedRequests = (this.data.failedRequests ?? 0) + 1;
+        }
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/diagnostics.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,12 @@
+export { loadConfig, type PrivalintConfig, parseConfig } from './config.js';
+export { type ConsentCheckOptions, observeConsent } from './consent.js';
+export { assessCoverage, type CoverageAssessment, type CoverageIssue } from './coverage.js';
 export { type Tracker, type TrackerCategory, trackers } from './data/trackers.js';
+export { diagnosticUrl } from './diagnostics.js';
 export { LANGS, type Lang, type Text } from './i18n.js';
 export { legalReferences, REGIONS, type Region } from './legal.js';
+export { type NetworkAdapter, NetworkError, type NetworkLimits, type NetworkRequest, type NetworkResponse, } from './network.js';
+export { identifyReportSchema, REPORT_SCHEMA_VERSION, type ReportSchemaIdentity, SUPPORTED_REPORT_SCHEMAS, } from './report-contract.js';
 export { defaultRules, googleFonts, impressumLink, preConsentTrackers, privacyPolicyLink, rejectOption, thirdPartyCdns, thirdPartyEmbeds, trackersAfterReject, } from './rules/index.js';
 export { type ScanOptions, scan } from './scanner.js';
 export type * from './types.js';

package/dist/index.js

@@ -1,6 +1,12 @@
+export { loadConfig, parseConfig } from './config.js';
+export { observeConsent } from './consent.js';
+export { assessCoverage } from './coverage.js';
 export { trackers } from './data/trackers.js';
+export { diagnosticUrl } from './diagnostics.js';
 export { LANGS } from './i18n.js';
 export { legalReferences, REGIONS } from './legal.js';
+export { NetworkError, } from './network.js';
+export { identifyReportSchema, REPORT_SCHEMA_VERSION, SUPPORTED_REPORT_SCHEMAS, } from './report-contract.js';
 export { defaultRules, googleFonts, impressumLink, preConsentTrackers, privacyPolicyLink, rejectOption, thirdPartyCdns, thirdPartyEmbeds, trackersAfterReject, } from './rules/index.js';
 export { scan } from './scanner.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsC,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,KAAK,EAAwB,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AACnE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAoB,IAAI,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAwB,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAA4B,cAAc,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,cAAc,EAA+C,MAAM,eAAe,CAAC;AAC5F,OAAO,EAAsC,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,KAAK,EAAwB,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,OAAO,EAAe,MAAM,YAAY,CAAC;AACnE,OAAO,EAEL,YAAY,GAIb,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EAErB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,YAAY,EACZ,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAoB,IAAI,EAAE,MAAM,cAAc,CAAC"}

package/dist/network.d.ts

@@ -0,0 +1,68 @@
+import type { BrowserContext, Page } from 'playwright';
+import { type Diagnostics } from './diagnostics.js';
+import type { LoadDiagnostic, LoadIssueKind, SkipReason } from './types.js';
+export interface NetworkRequest {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body: Uint8Array | null;
+    resourceType: string;
+    /** Covers execution and body consumption. The adapter must honour cancellation. */
+    signal: AbortSignal;
+}
+export interface NetworkResponse {
+    status: number;
+    headers?: Record<string, string | string[]>;
+    /** Stream bodies to enforce byte limits before buffering the entire response. */
+    body?: string | Uint8Array | AsyncIterable<Uint8Array>;
+}
+/** Fetch exactly ONE HTTP hop, never follow redirects. Caller owns shared transport clients. */
+export type NetworkAdapter = (request: NetworkRequest) => Promise<NetworkResponse>;
+export interface NetworkLimits {
+    concurrency?: number;
+    maxRequests?: number;
+    maxResponseBytes?: number;
+    maxTotalBytes?: number;
+    maxRedirects?: number;
+    /** Starts on dequeue; queue wait is bounded separately by captureTimeoutMs. */
+    requestTimeoutMs?: number;
+}
+export declare const NETWORK_DEFAULTS: {
+    concurrency: number;
+    maxRequests: number;
+    maxResponseBytes: number;
+    maxTotalBytes: number;
+    maxRedirects: number;
+    requestTimeoutMs: number;
+};
+export declare class NetworkError extends Error {
+    readonly kind: Exclude<LoadIssueKind, 'http-error'>;
+    readonly limit?: LoadDiagnostic['limit'];
+    readonly skippedReason?: SkipReason | undefined;
+    constructor(kind: Exclude<LoadIssueKind, 'http-error'>, limit?: LoadDiagnostic['limit'], skippedReason?: SkipReason | undefined);
+}
+export declare function networkLimits(options?: NetworkLimits): Required<NetworkLimits>;
+/** Chromium Fetch interception includes redirect hops that Playwright route() auto-continues. */
+export declare class ControlledNetwork {
+    private readonly adapter;
+    private readonly limits;
+    private readonly diagnostics;
+    private readonly signal;
+    private readonly queue;
+    private readonly tasks;
+    private readonly sessions;
+    private active;
+    private admitted;
+    private closed;
+    constructor(adapter: NetworkAdapter, limits: Required<NetworkLimits>, diagnostics: Diagnostics, signal: AbortSignal);
+    attach(context: BrowserContext): Promise<void>;
+    attachPage(page: Page): Promise<void>;
+    private intercept;
+    private pump;
+    private handle;
+    private readBody;
+    private abort;
+    close(): Promise<void>;
+}
+/** Abort without retaining caller reasons or leaving listeners attached. */
+export declare function withSignal<T>(operation: Promise<T>, signal: AbortSignal): Promise<T>;

package/dist/network.js

@@ -0,0 +1,237 @@
+import { classifyLoadError } from './diagnostics.js';
+export const NETWORK_DEFAULTS = {
+    concurrency: 6,
+    maxRequests: 500,
+    maxResponseBytes: 5 * 1024 * 1024,
+    maxTotalBytes: 20 * 1024 * 1024,
+    maxRedirects: 10,
+    requestTimeoutMs: 10_000,
+};
+export class NetworkError extends Error {
+    kind;
+    limit;
+    skippedReason;
+    constructor(kind, limit, skippedReason) {
+        super(kind);
+        this.kind = kind;
+        this.limit = limit;
+        this.skippedReason = skippedReason;
+        this.name = 'NetworkError';
+    }
+}
+export function networkLimits(options = {}) {
+    const limits = { ...NETWORK_DEFAULTS, ...options };
+    for (const [key, value] of Object.entries(limits)) {
+        const min = key === 'maxRedirects' ? 0 : 1;
+        if (!Number.isSafeInteger(value) || value < min)
+            throw new RangeError(`${key} must be a safe integer of at least ${min}`);
+    }
+    return limits;
+}
+function requestBody(request) {
+    if (request.postDataEntries !== undefined) {
+        if (request.postDataEntries.some((entry) => entry.bytes === undefined)) {
+            throw new NetworkError('unsupported-method');
+        }
+        return Buffer.concat(request.postDataEntries.map((entry) => Buffer.from(entry.bytes ?? '', 'base64')));
+    }
+    if (request.postData !== undefined)
+        return Buffer.from(request.postData);
+    if (request.hasPostData)
+        throw new NetworkError('unsupported-method');
+    return null;
+}
+function failureKind(error, signal, timeout) {
+    if (signal.aborted) {
+        return signal.reason instanceof DOMException && signal.reason.name === 'TimeoutError'
+            ? 'timeout'
+            : 'aborted';
+    }
+    if (timeout.aborted)
+        return 'timeout';
+    return error instanceof NetworkError ? error.kind : classifyLoadError(error);
+}
+/** Chromium Fetch interception includes redirect hops that Playwright route() auto-continues. */
+export class ControlledNetwork {
+    adapter;
+    limits;
+    diagnostics;
+    signal;
+    queue = [];
+    tasks = new Set();
+    sessions = new Map();
+    active = 0;
+    admitted = 0;
+    closed = false;
+    constructor(adapter, limits, diagnostics, signal) {
+        this.adapter = adapter;
+        this.limits = limits;
+        this.diagnostics = diagnostics;
+        this.signal = signal;
+    }
+    async attach(context) {
+        context.on('page', (page) => {
+            void this.attachPage(page).catch(() => this.diagnostics.add('browser-failure', page.url()));
+        });
+        await context.routeWebSocket('**/*', (socket) => {
+            this.diagnostics.add('unsupported-protocol', socket.url());
+            socket.close();
+        });
+    }
+    attachPage(page) {
+        const existing = this.sessions.get(page);
+        if (existing)
+            return existing;
+        const attaching = this.intercept(page);
+        this.sessions.set(page, attaching);
+        return attaching;
+    }
+    async intercept(page) {
+        const session = await page.context().newCDPSession(page);
+        const redirects = new Map();
+        session.on('Fetch.requestPaused', (event) => {
+            const count = event.redirectedRequestId
+                ? (redirects.get(event.redirectedRequestId) ?? 0) + 1
+                : 0;
+            if (event.redirectedRequestId)
+                redirects.delete(event.redirectedRequestId);
+            const request = { event, session, redirects: count, redirectCounts: redirects };
+            if (this.closed || this.signal.aborted) {
+                void this.abort(request, 'aborted');
+                return;
+            }
+            this.admitted++;
+            if (this.admitted > this.limits.maxRequests) {
+                void this.abort(request, 'resource-limit', 'requests');
+                return;
+            }
+            this.queue.push(request);
+            this.pump();
+        });
+        await session.send('Fetch.enable', {
+            patterns: [{ urlPattern: '*', requestStage: 'Request' }],
+        });
+    }
+    pump() {
+        while (!this.closed && !this.signal.aborted && this.active < this.limits.concurrency) {
+            const request = this.queue.shift();
+            if (request === undefined)
+                return;
+            this.active++;
+            const task = this.handle(request).finally(() => {
+                this.active--;
+                this.tasks.delete(task);
+                this.pump();
+            });
+            this.tasks.add(task);
+        }
+    }
+    async handle(intercepted) {
+        const { event, session, redirects, redirectCounts } = intercepted;
+        const { request } = event;
+        const controller = new AbortController();
+        const timeout = AbortSignal.timeout(this.limits.requestTimeoutMs);
+        const signal = AbortSignal.any([this.signal, timeout, controller.signal]);
+        try {
+            if (!/^https?:$/.test(new URL(request.url).protocol))
+                throw new NetworkError('unsupported-protocol');
+            if (redirects > this.limits.maxRedirects)
+                throw new NetworkError('resource-limit', 'redirects');
+            if (this.diagnostics.data.bytes >= this.limits.maxTotalBytes)
+                throw new NetworkError('resource-limit', 'total-bytes');
+            const response = await withSignal(this.adapter({
+                url: request.url,
+                method: request.method,
+                headers: request.headers,
+                body: requestBody(request),
+                resourceType: event.resourceType.toLowerCase(),
+                signal,
+            }), signal);
+            const body = await this.readBody(response.body, signal);
+            signal.throwIfAborted();
+            if (!Number.isInteger(response.status) || response.status < 200 || response.status > 599)
+                throw new NetworkError('browser-failure');
+            if ([301, 302, 303, 307, 308].includes(response.status))
+                redirectCounts.set(event.requestId, redirects);
+            await session.send('Fetch.fulfillRequest', {
+                requestId: event.requestId,
+                responseCode: response.status,
+                responseHeaders: Object.entries(response.headers ?? {}).flatMap(([name, value]) => (Array.isArray(value) ? value : [value]).map((item) => ({ name, value: item }))),
+                body: body.toString('base64'),
+            });
+        }
+        catch (error) {
+            const kind = failureKind(error, this.signal, timeout);
+            await this.abort(intercepted, kind, error instanceof NetworkError ? error.limit : undefined, error instanceof NetworkError ? error.skippedReason : undefined);
+        }
+        finally {
+            controller.abort();
+        }
+    }
+    async readBody(body, signal) {
+        const chunks = [];
+        let size = 0;
+        const append = (chunk) => {
+            size += chunk.byteLength;
+            this.diagnostics.data.bytes += chunk.byteLength;
+            if (size > this.limits.maxResponseBytes)
+                throw new NetworkError('resource-limit', 'response-bytes');
+            if (this.diagnostics.data.bytes > this.limits.maxTotalBytes)
+                throw new NetworkError('resource-limit', 'total-bytes');
+            chunks.push(chunk);
+        };
+        if (body === undefined)
+            return Buffer.alloc(0);
+        if (typeof body === 'string' || body instanceof Uint8Array) {
+            append(typeof body === 'string' ? Buffer.from(body) : body);
+        }
+        else {
+            const iterator = body[Symbol.asyncIterator]();
+            try {
+                while (true) {
+                    const chunk = await withSignal(iterator.next(), signal);
+                    if (chunk.done)
+                        break;
+                    append(chunk.value);
+                }
+            }
+            finally {
+                void iterator.return?.().catch(() => { });
+            }
+        }
+        return Buffer.concat(chunks, size);
+    }
+    async abort(request, kind, limit, skippedReason) {
+        this.diagnostics.failUrl(request.event.request.url, kind, limit, skippedReason);
+        await request.session
+            .send('Fetch.failRequest', {
+            requestId: request.event.requestId,
+            errorReason: 'BlockedByClient',
+        })
+            .catch(() => { });
+    }
+    async close() {
+        this.closed = true;
+        await Promise.all(this.queue.splice(0).map((request) => this.abort(request, 'aborted')));
+        await Promise.all(this.tasks);
+    }
+}
+/** Abort without retaining caller reasons or leaving listeners attached. */
+export async function withSignal(operation, signal) {
+    if (signal.aborted) {
+        void operation.catch(() => { });
+        throw new DOMException('Operation aborted', 'AbortError');
+    }
+    let onAbort = () => { };
+    const aborted = new Promise((_resolve, reject) => {
+        onAbort = () => reject(new DOMException('Operation aborted', 'AbortError'));
+        signal.addEventListener('abort', onAbort, { once: true });
+    });
+    try {
+        return await Promise.race([operation, aborted]);
+    }
+    finally {
+        signal.removeEventListener('abort', onAbort);
+    }
+}
+//# sourceMappingURL=network.js.map

package/dist/network.js.map

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

package/dist/observations.d.ts

@@ -0,0 +1,3 @@
+import type { RecordedRequest } from './types.js';
+/** Legacy records remain valid; failed, pending and HTTP-error responses are not loaded vendors. */
+export declare const observedRequests: (requests: readonly RecordedRequest[]) => RecordedRequest[];

package/dist/observations.js

@@ -0,0 +1,4 @@
+/** Legacy records remain valid; failed, pending and HTTP-error responses are not loaded vendors. */
+export const observedRequests = (requests) => requests.filter((request) => request.outcome === undefined ||
+    (request.outcome === 'response' && (request.status ?? 200) < 400));
+//# sourceMappingURL=observations.js.map

package/dist/observations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observations.js","sourceRoot":"","sources":["../src/observations.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,QAAoC,EAAqB,EAAE,CAC1F,QAAQ,CAAC,MAAM,CACb,CAAC,OAAO,EAAE,EAAE,CACV,OAAO,CAAC,OAAO,KAAK,SAAS;IAC7B,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,GAAG,CAAC,CACpE,CAAC"}

package/dist/policy.d.ts

@@ -0,0 +1,6 @@
+import type { Finding, Rule, RuleSettings } from './types.js';
+export declare function validateRuleSettings(settings: RuleSettings, rules: readonly Rule[]): void;
+/** Inherited properties such as constructor must never become severity overrides. */
+export declare function ruleSetting(settings: RuleSettings | undefined, ruleId: string): RuleSettings[string] | undefined;
+/** Apply local policy after region classification. Allowed vendors stay visible as info. */
+export declare function applyPolicy(findings: readonly Finding[], settings?: RuleSettings, allowedVendors?: readonly string[]): Finding[];