@browsercore/testing 0.1.3 → 0.2.0

package/dist/reference/dump.js

@@ -0,0 +1,102 @@
+/**
+ * curl-impersonate dump parsing + TLS fingerprint derivation.
+ *
+ * Split out of `reference.ts` so the providers and facade stay focused on
+ * dispatch while this file owns the curl-impersonate `--dump-traffic` byte
+ * format and the JA3/JA4 derivation from a captured ClientHello.
+ */
+import { computeJa3, computeJa4Fingerprint } from "../fingerprint/index.js";
+import { loadCaptureMeta } from "../golden/golden.js";
+import { DumpParseError } from "./reference-errors.js";
+/** Map a {@link ProfileId} to its {@link CaptureSource} tag. */
+export function profileToSource(profile) {
+    const p = String(profile);
+    if (p.startsWith("firefox")) {
+        return "firefox-135";
+    }
+    if (p.startsWith("safari")) {
+        return "safari-18";
+    }
+    if (p.startsWith("edge")) {
+        return "edge-140";
+    }
+    return "chrome-140";
+}
+/**
+ * Parse curl-impersonate `--dump-traffic` output into raw bytes.
+ *
+ * The dump format is a hex dump with one line per record; we extract the hex
+ * payload after the `>>> traffic <<<` marker. Throws {@link DumpParseError}
+ * when no hex bytes follow the marker or the hex has odd length.
+ */
+export function parseDumpOutput(stdout) {
+    // Find the hex body — everything after the ">>> traffic <<<" marker.
+    const marker = ">>> traffic <<<";
+    const idx = stdout.indexOf(marker);
+    const body = idx === -1 ? stdout : stdout.slice(idx + marker.length);
+    const hex = body.replaceAll(/[^0-9a-fA-F]/gu, "");
+    if (hex.length === 0) {
+        throw new DumpParseError("no_hex", 0);
+    }
+    if (hex.length % 2 !== 0) {
+        throw new DumpParseError("odd_length", hex.length);
+    }
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = parseInt(hex.slice(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
+}
+/**
+ * Derive a {@link Fingerprint} from a TLS ClientHello capture.
+ *
+ * Computes JA3 + JA4 from the raw bytes and reads the per-extension metadata
+ * (supported groups, signature algorithms, ALPN) from the sidecar
+ * `.meta.json` when available.
+ *
+ * Exported for unit testing the try/catch branches: the happy path reads the
+ * sidecar meta, while the fallback path is taken when the sidecar is missing.
+ */
+export function fingerprintFromTlsCapture(capture) {
+    const ja3 = computeJa3(capture.bytes);
+    const ja4 = computeJa4Fingerprint(capture.bytes);
+    // Read the sidecar meta for richer fields (signature algorithms, ALPN,
+    // supported curves). Fall back to empty arrays if missing.
+    const alpn = [];
+    const signatureAlgorithms = [];
+    const ellipticCurves = [];
+    try {
+        const meta = loadCaptureMeta(capture.id);
+        if (meta.protocol === "tls") {
+            // CaptureMeta doesn't carry ALPN/sigAlgs/curves yet; this is a
+            // placeholder for when the sidecar schema is extended.
+            void meta;
+        }
+    }
+    catch {
+        // Sidecar missing or unparseable — leave richer fields empty.
+    }
+    return {
+        ja3,
+        ja4: ja4.tag,
+        alpn,
+        cipherSuite: cipherSuiteName(ja4.tag),
+        protocolVersion: ja4.tag.slice(5, 7) || "unknown",
+        signatureAlgorithms,
+        ellipticCurves,
+    };
+}
+/**
+ * Extract a human-readable cipher-suite name from a JA4 tag.
+ *
+ * JA4 doesn't directly encode the negotiated cipher; this is a placeholder
+ * that returns the JA4_a segment for inspection. Real cipher-suite resolution
+ * requires parsing the ServerHello, which is out of scope for the capture.
+ *
+ * Exported for unit testing the empty-tag fallback branch.
+ */
+export function cipherSuiteName(ja4Tag) {
+    const a = ja4Tag.split("_")[0] ?? "";
+    return a.length > 0 ? a : "unknown";
+}
+//# sourceMappingURL=dump.js.map

package/dist/reference/dump.js.map

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

package/dist/reference/node-reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node-reference.d.ts","sourceRoot":"","sources":["../../src/reference/node-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EAA4B,SAAS,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAqBjF,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAGhD,iFAAiF;AACjF,eAAO,MAAM,UAAU;IACnB,iEAAiE;4BACpD,UAAU,KAAG,UAAU;IAIpC,iEAAiE;4BACpD,UAAU,KAAG,UAAU;IAIpC;;;OAGG;+BAEY,aAAa,QAClB,UAAU,OACX,UAAU,QACT,UAAU,UACR,MAAM,KACf,UAAU;IAOb,qDAAqD;+BACrC,aAAa,OAAO,UAAU,QAAQ,UAAU,KAAG,UAAU;IAK7E,6DAA6D;mCACzC,MAAM,KAAG,UAAU;IAIvC,yDAAyD;uCACjC,aAAa,KAAG,MAAM;CAGxC,CAAC;AAEX,yDAAyD;AACzD,eAAO,MAAM,OAAO;IAChB,0EAA0E;4BAEhE,MAAM,QACN,OAAO,KACd,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;CAY1D,CAAC;AAEX,kFAAkF;AAClF,eAAO,MAAM,QAAQ;0BACN,UAAU,KAAG,UAAU;4BAGrB,UAAU,KAAG,UAAU;6BAGtB,UAAU,KAAG,UAAU;6BAGvB,UAAU,KAAG,UAAU;oCAGhB,UAAU,KAAG,UAAU;sCAGrB,UAAU,KAAG,UAAU;IAG9C,8EAA8E;4BACzD,OAAO,aAAa;CAGnC,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;IACjB;;;;OAIG;sDAES,MAAM,OACT,MAAM,WACF,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KACrC,UAAU;CAQP,CAAC;AAEX,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAKzC;AAED,sDAAsD;AACtD,MAAM,MAAM,cAAc,GACpB;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GACxB;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,cAAc,CAUhF"}
+{"version":3,"file":"node-reference.d.ts","sourceRoot":"","sources":["../../src/reference/node-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAOH,SAAS,IAAI,aAAa,EAC7B,MAAM,WAAW,CAAC;AAqBnB,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAGhD,iFAAiF;AACjF,eAAO,MAAM,UAAU;IACnB,iEAAiE;aACjE,MAAM,SAAO,UAAU,KAAG,UAAU;IAIpC,iEAAiE;aACjE,MAAM,SAAO,UAAU,KAAG,UAAU;IAIpC;;;OAGG;aACH,IAAI,cACW,aAAa,QAClB,UAAU,OACX,UAAU,QACT,UAAU,UACR,MAAM,KACf,UAAU;IAOb,qDAAqD;aACrD,IAAI,cAAY,aAAa,OAAO,UAAU,QAAQ,UAAU,KAAG,UAAU;IAK7E,6DAA6D;aAC7D,WAAW,WAAS,MAAM,KAAG,UAAU;IAIvC,yDAAyD;aACzD,YAAY,cAAY,aAAa,KAAG,MAAM;CAGxC,CAAC;AAEX,yDAAyD;AACzD,eAAO,MAAM,OAAO;IAChB,0EAA0E;aAC1E,MAAM,SACI,MAAM,QACN,OAAO,KACd,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAA;KAAE,CAAC;CAY1D,CAAC;AAEX,kFAAkF;AAClF,eAAO,MAAM,QAAQ;aACjB,IAAI,SAAO,UAAU,KAAG,UAAU;aAGlC,MAAM,SAAO,UAAU,KAAG,UAAU;aAGpC,OAAO,SAAO,UAAU,KAAG,UAAU;aAGrC,OAAO,SAAO,UAAU,KAAG,UAAU;aAGrC,cAAc,SAAO,UAAU,KAAG,UAAU;aAG5C,gBAAgB,SAAO,UAAU,KAAG,UAAU;IAG9C,8EAA8E;aAC1E,aAAa,EAAI,OAAO,aAAa;CAGnC,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;IACjB;;;;OAIG;aACH,8BAA8B,WAClB,MAAM,OACT,MAAM,WACF,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,KACrC,UAAU;CAQP,CAAC;AAEX,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,KAAK,CAKzC;AAED,sDAAsD;AACtD,MAAM,MAAM,cAAc,GACpB;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GACxB;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzD,uEAAuE;AACvE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,cAAc,CAUhF"}

package/dist/reference/node-reference.js

@@ -16,10 +16,8 @@
  * for comparison with our packages' Uint8Array-centric APIs.
  */
 import { createHash, createHmac, hkdfSync, randomBytes } from "node:crypto";
-import { gunzipSync, gzipSync, brotliCompressSync, brotliDecompressSync } from "node:zlib";
+import { deflateSync, inflateSync, gunzipSync, gzipSync, brotliCompressSync, brotliDecompressSync, constants as zlibConstants, } from "node:zlib";
 import { lookup as dnsLookup } from "node:dns";
-import { deflateSync, inflateSync, constants as zlibConstants } from "node:zlib";
-import { assertNever } from "../utils.js";
 /** Normalize a Node Buffer / Uint8Array / readonly Uint8Array to a fresh Uint8Array. */
 function toBytes(data) {
     return new Uint8Array(data);
@@ -72,7 +70,7 @@ export const nodeCrypto = {
 /** DNS resolution oracle (mirrors our `resolveHost`). */
 export const nodeDns = {
     /** Resolve a host to an address, matching our `resolveHost` semantics. */
-    async lookup(host, ipv6) {
+    lookup(host, ipv6) {
         return new Promise((resolve, reject) => {
             const options = { family: ipv6 ? 6 : 4 };
             dnsLookup(host, options, (err, address, family) => {
@@ -157,5 +155,4 @@ function firstDiff(a, b) {
     }
     return len;
 }
-void assertNever;
 //# sourceMappingURL=node-reference.js.map

package/dist/reference/node-reference.js.map

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

package/dist/reference/reference-errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Typed errors for the reference provider (docs/TEST-SUITE.md, Cat 3/4/14).
+ *
+ * Mirrors the transport pattern: errors carry a `kind` discriminator so callers
+ * can match on type instead of parsing message text. `ReferenceError` is the
+ * base failure for capture / fingerprint; `DumpParseError` covers the
+ * curl-impersonate dump-format failures specifically.
+ */
+import { TestingError } from "../errors.js";
+/**
+ * Raised when a reference provider cannot capture or fingerprint a profile.
+ *
+ * Extends {@link TestingError} (the package-wide base) so it inherits the
+ * `"TestingError"` discriminator; callers can `instanceof ReferenceError` for
+ * the narrower match.
+ */
+export declare class ReferenceError extends TestingError {
+    constructor(message: string, options?: {
+        cause?: Error;
+    });
+}
+/**
+ * Raised when curl-impersonate `--dump-traffic` output cannot be parsed.
+ *
+ * Discriminated by {@link dumpKind}: `"no_hex"` (no hex bytes after the
+ * marker) or `"odd_length"` (an odd number of hex digits cannot form whole
+ * bytes).
+ */
+export declare class DumpParseError extends ReferenceError {
+    readonly dumpKind: DumpParseKind;
+    readonly hexLength: number;
+    constructor(dumpKind: DumpParseKind, hexLength: number);
+}
+/** Why a dump could not be parsed. */
+export type DumpParseKind = "no_hex" | "odd_length";
+//# sourceMappingURL=reference-errors.d.ts.map

package/dist/reference/reference-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-errors.d.ts","sourceRoot":"","sources":["../../src/reference/reference-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC5C,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAE,EAGvD;CACJ;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,cAAc;IAC9C,SAAgB,QAAQ,EAAE,aAAa,CAAC;IACxC,SAAgB,SAAS,EAAE,MAAM,CAAC;IAElC,YAAY,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EASrD;CACJ;AAED,sCAAsC;AACtC,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,YAAY,CAAC"}

package/dist/reference/reference-errors.js

@@ -0,0 +1,43 @@
+/**
+ * Typed errors for the reference provider (docs/TEST-SUITE.md, Cat 3/4/14).
+ *
+ * Mirrors the transport pattern: errors carry a `kind` discriminator so callers
+ * can match on type instead of parsing message text. `ReferenceError` is the
+ * base failure for capture / fingerprint; `DumpParseError` covers the
+ * curl-impersonate dump-format failures specifically.
+ */
+import { TestingError } from "../errors.js";
+/**
+ * Raised when a reference provider cannot capture or fingerprint a profile.
+ *
+ * Extends {@link TestingError} (the package-wide base) so it inherits the
+ * `"TestingError"` discriminator; callers can `instanceof ReferenceError` for
+ * the narrower match.
+ */
+export class ReferenceError extends TestingError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = "ReferenceError";
+    }
+}
+/**
+ * Raised when curl-impersonate `--dump-traffic` output cannot be parsed.
+ *
+ * Discriminated by {@link dumpKind}: `"no_hex"` (no hex bytes after the
+ * marker) or `"odd_length"` (an odd number of hex digits cannot form whole
+ * bytes).
+ */
+export class DumpParseError extends ReferenceError {
+    dumpKind;
+    hexLength;
+    constructor(dumpKind, hexLength) {
+        const message = dumpKind === "no_hex"
+            ? "curl-impersonate dump produced no hex bytes"
+            : `curl-impersonate dump produced odd-length hex (${hexLength})`;
+        super(message);
+        this.name = "DumpParseError";
+        this.dumpKind = dumpKind;
+        this.hexLength = hexLength;
+    }
+}
+//# sourceMappingURL=reference-errors.js.map

package/dist/reference/reference-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-errors.js","sourceRoot":"","sources":["../../src/reference/reference-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;GAMG;AACH,MAAM,OAAO,cAAe,SAAQ,YAAY;IAC5C,YAAY,OAAe,EAAE,OAA2B;QACpD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IACjC,CAAC;CACJ;AAED;;;;;;GAMG;AACH,MAAM,OAAO,cAAe,SAAQ,cAAc;IAC9B,QAAQ,CAAgB;IACxB,SAAS,CAAS;IAElC,YAAY,QAAuB,EAAE,SAAiB;QAClD,MAAM,OAAO,GACT,QAAQ,KAAK,QAAQ;YACjB,CAAC,CAAC,6CAA6C;YAC/C,CAAC,CAAC,kDAAkD,SAAS,GAAG,CAAC;QACzE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;CACJ"}

package/dist/reference/reference-types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Shared types for the reference provider layer.
+ *
+ * Lives in its own module so the providers (`curl-provider.ts`,
+ * `browser-provider.ts`), the dump helpers (`dump.ts`), and the facade
+ * (`reference.ts`) all import from one place without forming an import cycle.
+ */
+import type { ProfileId } from "@browsercore/profiles";
+import type { GoldenCapture } from "../types.js";
+/** Which reference backend to use. Discriminated union — no bare string. */
+export type ReferenceProviderKind = {
+    readonly kind: "curl-impersonate";
+} | {
+    readonly kind: "real-browser";
+};
+/** Observable TLS/HTTP fingerprint of a captured reference exchange. */
+export interface Fingerprint {
+    readonly ja3: string;
+    readonly ja4: string;
+    readonly alpn: readonly string[];
+    readonly cipherSuite: string;
+    readonly protocolVersion: string;
+    readonly signatureAlgorithms: readonly string[];
+    readonly ellipticCurves: readonly string[];
+}
+/** A source of truth for a browser profile's wire behavior. */
+export interface ReferenceProvider {
+    readonly kind: ReferenceProviderKind;
+    capture(profile: ProfileId, url: string): Promise<GoldenCapture>;
+    fingerprint(profile: ProfileId): Promise<Fingerprint>;
+    availableProfiles(): ProfileId[];
+}
+//# sourceMappingURL=reference-types.d.ts.map

package/dist/reference/reference-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-types.d.ts","sourceRoot":"","sources":["../../src/reference/reference-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,4EAA4E;AAC5E,MAAM,MAAM,qBAAqB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAA;CAAE,GACrC;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAA;CAAE,CAAC;AAExC,wEAAwE;AACxE,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IACjE,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACtD,iBAAiB,IAAI,SAAS,EAAE,CAAC;CACpC"}

package/dist/reference/reference-types.js

@@ -0,0 +1,9 @@
+/**
+ * Shared types for the reference provider layer.
+ *
+ * Lives in its own module so the providers (`curl-provider.ts`,
+ * `browser-provider.ts`), the dump helpers (`dump.ts`), and the facade
+ * (`reference.ts`) all import from one place without forming an import cycle.
+ */
+export {};
+//# sourceMappingURL=reference-types.js.map

package/dist/reference/reference-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-types.js","sourceRoot":"","sources":["../../src/reference/reference-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/reference/reference.d.ts

@@ -1,5 +1,5 @@
 /**
- * Pluggable layered reference provider.
+ * Pluggable layered reference provider — facade + factory.
  *
  * The reference implementation is the source of truth for what a given browser
  * profile SHOULD produce on the wire. Three backends are wrapped behind one
@@ -17,90 +17,27 @@
  * primary then secondary; fingerprint is derived from the captured bytes; the
  * node-reference oracle is exposed for primitive-layer comparisons.
  *
- * See docs/TEST-SUITE.md (Cat 3, 4, 14) for how references feed comparison.
+ * The providers and dump helpers live in their own modules; this file owns the
+ * facade + factory dispatch. See docs/TEST-SUITE.md (Cat 3, 4, 14).
  */
 import type { ProfileId } from "@browsercore/profiles";
 import type { GoldenCapture } from "../types.js";
-import { TestingError } from "../errors.js";
-/** Which reference backend to use. Discriminated union — no bare string. */
-export type ReferenceProviderKind = {
-    readonly kind: "curl-impersonate";
-} | {
-    readonly kind: "real-browser";
-};
-/** Observable TLS/HTTP fingerprint of a captured reference exchange. */
-export interface Fingerprint {
-    readonly ja3: string;
-    readonly ja4: string;
-    readonly alpn: readonly string[];
-    readonly cipherSuite: string;
-    readonly protocolVersion: string;
-    readonly signatureAlgorithms: readonly string[];
-    readonly ellipticCurves: readonly string[];
-}
-/** Options for the curl-impersonate provider. */
-export interface CurlImpersonateOptions {
-    /** Path / name of the curl-impersonate binary. Default "curl-impersonate". */
-    readonly command: string;
-    /** Extra argv passed to the binary. */
-    readonly extraArgs?: readonly string[];
-}
-/** Options for the real-browser (pre-recorded capture) provider. */
-export interface RealBrowserOptions {
-    readonly command?: undefined;
-    /** Override captures directory. Defaults to the in-repo `captures/` dir. */
-    readonly capturesDir?: string;
-}
+import type { Fingerprint, ReferenceProvider, ReferenceProviderKind } from "./reference-types.js";
+import { type CurlImpersonateOptions } from "./curl-provider.js";
+import { type RealBrowserOptions } from "./browser-provider.js";
+export { CurlImpersonateProvider } from "./curl-provider.js";
+export type { CurlImpersonateOptions } from "./curl-provider.js";
+export { RealBrowserCaptureProvider } from "./browser-provider.js";
+export type { RealBrowserOptions } from "./browser-provider.js";
+export { ReferenceError, DumpParseError } from "./reference-errors.js";
+export type { DumpParseKind } from "./reference-errors.js";
+export { parseDumpOutput, fingerprintFromTlsCapture, cipherSuiteName } from "./dump.js";
+export type { Fingerprint, ReferenceProvider, ReferenceProviderKind, } from "./reference-types.js";
 /** Options for the {@link ReferenceProviderFacade}. */
 export interface ReferenceFacadeOptions {
     readonly curl?: CurlImpersonateOptions;
     readonly browser?: RealBrowserOptions;
 }
-/** A source of truth for a browser profile's wire behavior. */
-export interface ReferenceProvider {
-    readonly kind: ReferenceProviderKind;
-    capture(profile: ProfileId, url: string): Promise<GoldenCapture>;
-    fingerprint(profile: ProfileId): Promise<Fingerprint>;
-    availableProfiles(): ProfileId[];
-}
-/** Raised when a reference provider cannot capture or fingerprint a profile. */
-export declare class ReferenceError extends TestingError {
-    constructor(message: string, options?: {
-        cause?: Error;
-    });
-}
-/**
- * PRIMARY provider — shells out to curl-impersonate.
- *
- * `capture()` invokes the curl-impersonate binary against `url`, impersonating
- * `profile`, and returns the raw bytes it observed on the wire. The binary
- * must be on PATH (or in `command`); if it is missing, the call throws
- * {@link ReferenceError} so the facade can fall back to the secondary.
- */
-export declare class CurlImpersonateProvider implements ReferenceProvider {
-    readonly kind: ReferenceProviderKind;
-    readonly command: string;
-    readonly extraArgs: readonly string[];
-    constructor(options?: CurlImpersonateOptions);
-    availableProfiles(): ProfileId[];
-    capture(profile: ProfileId, url: string): Promise<GoldenCapture>;
-    fingerprint(profile: ProfileId): Promise<Fingerprint>;
-}
-/**
- * SECONDARY provider — loads pre-recorded captures from the `captures/` dir.
- *
- * `capture()` resolves a stored capture for the profile; `fingerprint()`
- * derives a {@link Fingerprint} from the captured bytes (only TLS
- * ClientHellos are fingerprinted — other protocols return a stub).
- */
-export declare class RealBrowserCaptureProvider implements ReferenceProvider {
-    readonly kind: ReferenceProviderKind;
-    readonly capturesDir: string;
-    constructor(options?: RealBrowserOptions);
-    availableProfiles(): ProfileId[];
-    capture(profile: ProfileId, _url: string): Promise<GoldenCapture>;
-    fingerprint(profile: ProfileId): Promise<Fingerprint>;
-}
 /**
  * Facade wrapping the node-reference oracle + primary (curl-impersonate) and
  * secondary (real-browser) providers behind a single {@link ReferenceProvider}.

package/dist/reference/reference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/reference/reference.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../src/reference/reference.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EACR,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAA2B,KAAK,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAC1F,OAAO,EAA8B,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAM5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvE,YAAY,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACxF,YAAY,EACR,WAAW,EACX,iBAAiB,EACjB,qBAAqB,GACxB,MAAM,sBAAsB,CAAC;AAE9B,uDAAuD;AACvD,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC;CACzC;AAED;;;;;;;;;GASG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC7D,SAAgB,IAAI,EAAE,qBAAqB,CAAyC;IACpF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IAEvD,YAAY,OAAO,CAAC,EAAE,sBAAsB,EAG3C;IAED;;;;OAIG;IACH,IAAI,UAAU,IAAI,OAAO,UAAU,CAElC;IAED,iBAAiB,IAAI,SAAS,EAAE,CAa/B;IAEK,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiBrE;IAEK,WAAW,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAgB1D;CACJ;AAED;;;;GAIG;AACH,OAAO,KAAK,UAAU,MAAM,qBAAqB,CAAC;AAElD,sFAAsF;AACtF,wBAAgB,uBAAuB,CACnC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,CAAC,EAAE,sBAAsB,GAAG,kBAAkB,GACtD,iBAAiB,CAWnB;AAmCD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,uBAAuB,CAE/F"}