@browsercore/testing 0.1.3 → 0.2.1

package/dist/bench/bench.js

@@ -1,19 +1,119 @@
 /**
  * Benchmark suite for protocol operations.
  *
- * Typed stubs for now — real benchmarks require live servers and the
- * underlying protocol stacks.
+ * Benchmarks here measure operations that need no live server — capture
+ * parsing, fingerprint computation, golden comparison, and compression
+ * round-trips — so they run in CI. Live TLS-handshake / HTTP/2-request
+ * benchmarks (which require a functional protocol stack + loopback server)
+ * remain a future addition; see docs/TEST-SUITE.md (Phase 10) for the full
+ * roadmap.
+ *
+ * Each benchmark runs `iterations` repetitions, collects per-iteration
+ * timings in microseconds, and reports p50/p95/p99 latency plus average
+ * throughput.
+ */
+import { gunzipSync, gzipSync } from "node:zlib";
+import { computeJa3, computeJa4 } from "../fingerprint/index.js";
+import { compareBytes } from "../utils.js";
+import { createFileSystem, createPath } from "../node-provider.js";
+const fileSystem = createFileSystem();
+const path = createPath();
+const compression = {
+    gzip: (data) => new Uint8Array(gzipSync(data)),
+    gunzip: (data) => new Uint8Array(gunzipSync(data)),
+};
+const here = import.meta.dirname;
+// src/bench -> package root -> captures/
+const capturesDir = path.join(here, "..", "..", "captures");
+/** Deterministic payload: byte[i] = i % 256 (reproducible, never random). */
+function detBuffer(length) {
+    const bytes = new Uint8Array(length);
+    for (let i = 0; i < length; i++) {
+        bytes[i] = i % 256;
+    }
+    return bytes;
+}
+/** High-resolution timestamp in microseconds (browser-safe fallback). */
+function nowUs() {
+    return performance.now() * 1000;
+}
+/**
+ * Run `fn` for `iterations` repetitions and return the per-iteration timings
+ * in microseconds, sorted ascending. The warm-up iteration is discarded to
+ * eliminate first-call JIT / cache effects.
  */
-/** Benchmark a single TLS handshake over `iterations` runs. */
-export function benchmarkTlsHandshake(_iterations, _options) {
-    void _iterations;
+function measure(iterations, fn) {
+    // Warm-up.
+    fn();
+    const timings = [];
+    for (let i = 0; i < iterations; i++) {
+        const start = nowUs();
+        fn();
+        timings.push(nowUs() - start);
+    }
+    timings.sort((a, b) => a - b);
+    return timings;
+}
+/** Read a percentile (0..1) from a sorted array of samples. */
+export function percentile(sorted, p) {
+    if (sorted.length === 0) {
+        return 0;
+    }
+    const idx = Math.min(sorted.length - 1, Math.ceil(p * sorted.length) - 1);
+    return sorted[Math.max(0, idx)] ?? 0;
+}
+/**
+ * Benchmark the TLS ClientHello fingerprint computation (JA3 + JA4) over
+ * `iterations` runs against the chrome-140 golden capture. Reports
+ * p50/p95/p99 latency in milliseconds.
+ */
+export function benchmarkTlsHandshake(iterations, _options) {
     void _options;
-    throw new Error("not implemented — see PLAN.md");
+    // Load the chrome-140 golden capture once; the benchmark measures the
+    // parsing + fingerprinting cost, not the live handshake (which needs a
+    // functional TLS stack + loopback server — future work).
+    const bytes = fileSystem.readFileSync(path.join(capturesDir, "chrome-140", "tls", "client_hello.bin"));
+    const iters = Math.max(1, iterations);
+    const timings = measure(iters, () => {
+        computeJa3(bytes);
+        computeJa4(bytes);
+    });
+    const avgMs = timings.reduce((a, b) => a + b, 0) / timings.length / 1000;
+    return {
+        iterations: iters,
+        avgMs,
+        p50: percentile(timings, 0.5) / 1000,
+        p95: percentile(timings, 0.95) / 1000,
+        p99: percentile(timings, 0.99) / 1000,
+    };
 }
-/** Benchmark an HTTP/2 request round-trip over `iterations` runs. */
-export function benchmarkHttp2Request(_iterations, _options) {
-    void _iterations;
+/**
+ * Benchmark the golden-comparison path (load + byte-compare) over
+ * `iterations` runs. This exercises the Category 14 packet-capture
+ * comparison core. Reports p50/p95/p99 latency in milliseconds.
+ */
+export function benchmarkHttp2Request(iterations, _options) {
     void _options;
-    throw new Error("not implemented — see PLAN.md");
+    // The HTTP/2 SETTINGS frame is small and deterministic — ideal for
+    // repeated comparison benchmarking without a live server.
+    const bytes = fileSystem.readFileSync(path.join(capturesDir, "chrome-140", "http2", "settings.bin"));
+    const iters = Math.max(1, iterations);
+    // Pre-compress a payload for the compression round-trip sub-benchmark.
+    const payload = detBuffer(8192);
+    const compressed = compression.gzip(payload);
+    const timings = measure(iters, () => {
+        // Golden comparison path: compare the SETTINGS bytes against themselves.
+        compareBytes(bytes, bytes);
+        // Compression round-trip: representative of per-request work.
+        compression.gunzip(compressed);
+    });
+    const avgMs = timings.reduce((a, b) => a + b, 0) / timings.length / 1000;
+    return {
+        iterations: iters,
+        avgMs,
+        p50: percentile(timings, 0.5) / 1000,
+        p95: percentile(timings, 0.95) / 1000,
+        p99: percentile(timings, 0.99) / 1000,
+    };
 }
 //# sourceMappingURL=bench.js.map

package/dist/bench/bench.js.map

@@ -1 +1 @@
-{"version":3,"file":"bench.js","sourceRoot":"","sources":["../../src/bench/bench.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,+DAA+D;AAC/D,MAAM,UAAU,qBAAqB,CACjC,WAAmB,EACnB,QAA6D;IAE7D,KAAK,WAAW,CAAC;IACjB,KAAK,QAAQ,CAAC;IACd,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;AACrD,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CACjC,WAAmB,EACnB,QAA4E;IAE5E,KAAK,WAAW,CAAC;IACjB,KAAK,QAAQ,CAAC;IACd,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;AACrD,CAAC"}
+{"version":3,"file":"bench.js","sourceRoot":"","sources":["../../src/bench/bench.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEjD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;AACtC,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;AAE1B,MAAM,WAAW,GAAG;IAChB,IAAI,EAAE,CAAC,IAAgB,EAAc,EAAE,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,EAAE,CAAC,IAAgB,EAAc,EAAE,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;CAC7E,CAAC;AAEF,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,OAAO,CAAC;AACjC,yCAAyC;AACzC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAE5D,6EAA6E;AAC7E,SAAS,SAAS,CAAC,MAAc;IAC7B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,yEAAyE;AACzE,SAAS,KAAK;IACV,OAAO,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,SAAS,OAAO,CAAC,UAAkB,EAAE,EAAc;IAC/C,WAAW;IACX,EAAE,EAAE,CAAC;IACL,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,KAAK,GAAG,KAAK,EAAE,CAAC;QACtB,EAAE,EAAE,CAAC;QACL,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,MAAgB,EAAE,CAAS;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACb,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACjC,UAAkB,EAClB,QAA6D;IAE7D,KAAK,QAAQ,CAAC;IACd,sEAAsE;IACtE,uEAAuE;IACvE,yDAAyD;IACzD,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,CACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAClE,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAEtC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE;QAChC,UAAU,CAAC,KAAK,CAAC,CAAC;QAClB,UAAU,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IACzE,OAAO;QACH,UAAU,EAAE,KAAK;QACjB,KAAK;QACL,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,IAAI;QACpC,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI;QACrC,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI;KACxC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACjC,UAAkB,EAClB,QAA4E;IAE5E,KAAK,QAAQ,CAAC;IACd,mEAAmE;IACnE,0DAA0D;IAC1D,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,CACjC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc,CAAC,CAChE,CAAC;IACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IAEtC,uEAAuE;IACvE,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE;QAChC,yEAAyE;QACzE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3B,8DAA8D;QAC9D,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IACzE,OAAO;QACH,UAAU,EAAE,KAAK;QACjB,KAAK;QACL,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,IAAI;QACpC,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI;QACrC,GAAG,EAAE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,IAAI;KACxC,CAAC;AACN,CAAC"}

package/dist/captures/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/captures/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC9B;AAeD,eAAO,MAAM,QAAQ,EAAE,SAAS,YAAY,EA8C3C,CAAC"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/captures/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAU/C,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC9B;AAeD,eAAO,MAAM,QAAQ,EAAE,SAAS,YAAY,EA8C3C,CAAC"}

package/dist/captures/manifest.js

@@ -7,21 +7,21 @@
  * providers discover captures through this array rather than hard-coding paths
  * (no magic strings — see CODING_STANDARDS.md).
  */
-import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-const here = dirname(fileURLToPath(import.meta.url));
+import { createFileSystem, createPath } from "../node-provider.js";
+const fileSystem = createFileSystem();
+const path = createPath();
+const here = import.meta.dirname;
 // src/captures -> package root -> captures/
-const capturesDir = join(here, "..", "..", "captures");
+const capturesDir = path.join(here, "..", "..", "captures");
 function id(s) {
     return s;
 }
 function entry(relativePath, meta) {
-    const abs = join(capturesDir, relativePath);
+    const abs = path.join(capturesDir, relativePath);
     return {
         path: relativePath,
         meta,
-        bytes: readFileSync(abs),
+        bytes: fileSystem.readFileSync(abs),
     };
 }
 export const captures = [

package/dist/captures/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/captures/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAI1C,MAAM,IAAI,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACrD,4CAA4C;AAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AASvD,SAAS,EAAE,CAAC,CAAS;IACjB,OAAO,CAAc,CAAC;AAC1B,CAAC;AAED,SAAS,KAAK,CAAC,YAAoB,EAAE,IAAiB;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAC5C,OAAO;QACH,IAAI,EAAE,YAAY;QAClB,IAAI;QACJ,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC;KAC3B,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAA4B;IAC7C,KAAK,CACD,iCAAiC,EACjC;QACI,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC;QACzB,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,cAAc;QACtB,WAAW,EACP,yDAAyD;QAC7D,gBAAgB,EAAE;YACd,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;YAChD,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE;SAC1D;QACD,SAAS,EAAE,sBAAsB;KACpC,CACJ;IACD,KAAK,CACD,+BAA+B,EAC/B;QACI,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC;QACzB,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,UAAU;QAClB,WAAW,EACP,iEAAiE;QACrE,gBAAgB,EAAE,EAAE;QACpB,SAAS,EAAE,sBAAsB;KACpC,CACJ;IACD,KAAK,CACD,kCAAkC,EAClC;QACI,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC;QAC1B,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,cAAc;QACtB,WAAW,EACP,0DAA0D;QAC9D,gBAAgB,EAAE;YACd,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;YAChD,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE;SAC1D;QACD,SAAS,EAAE,sBAAsB;KACpC,CACJ;CACJ,CAAC"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/captures/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEnE,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;AACtC,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC;AAE1B,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,OAAO,CAAC;AACjC,4CAA4C;AAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;AAS5D,SAAS,EAAE,CAAC,CAAS;IACjB,OAAO,CAAc,CAAC;AAC1B,CAAC;AAED,SAAS,KAAK,CAAC,YAAoB,EAAE,IAAiB;IAClD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACjD,OAAO;QACH,IAAI,EAAE,YAAY;QAClB,IAAI;QACJ,KAAK,EAAE,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC;KACtC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAA4B;IAC7C,KAAK,CACD,iCAAiC,EACjC;QACI,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC;QACzB,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,cAAc;QACtB,WAAW,EACP,yDAAyD;QAC7D,gBAAgB,EAAE;YACd,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;YAChD,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE;SAC1D;QACD,SAAS,EAAE,sBAAsB;KACpC,CACJ;IACD,KAAK,CACD,+BAA+B,EAC/B;QACI,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC;QACzB,QAAQ,EAAE,OAAO;QACjB,MAAM,EAAE,UAAU;QAClB,WAAW,EACP,iEAAiE;QACrE,gBAAgB,EAAE,EAAE;QACpB,SAAS,EAAE,sBAAsB;KACpC,CACJ;IACD,KAAK,CACD,kCAAkC,EAClC;QACI,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC;QAC1B,QAAQ,EAAE,KAAK;QACf,MAAM,EAAE,cAAc;QACtB,WAAW,EACP,0DAA0D;QAC9D,gBAAgB,EAAE;YACd,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE;YAChD,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE;SAC1D;QACD,SAAS,EAAE,sBAAsB;KACpC,CACJ;CACJ,CAAC"}

package/dist/categories/compression.d.ts

@@ -2,10 +2,12 @@
  * Test Category 9 — Compression.
  *
  * Verify gzip, brotli, deflate decoding behavior matches the Node.js reference
- * oracle (`nodeZlib`). The system under test is `@browsercore/compression`;
- * `nodeZlib` is the spec reference for these primitive layers. See
- * docs/TEST-SUITE.md ("Test Category 9 — Compression") for full acceptance
- * criteria.
+ * oracle (`nodeZlib`). The system under test is a `CompressionProvider`
+ * implementation backed by node:zlib; `nodeZlib` is the spec reference for
+ * these primitive layers. The runtime implementation lives in browsersmith
+ * (Layer 5), so this repo exercises the `CompressionProvider` contract with a
+ * local Node-backed double. See docs/TEST-SUITE.md ("Test Category 9 —
+ * Compression") for full acceptance criteria.
  */
 export declare const CATEGORY_ID: "compression";
 //# sourceMappingURL=compression.d.ts.map

package/dist/categories/compression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/categories/compression.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,eAAO,MAAM,WAAW,eAA2B,CAAC"}
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/categories/compression.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkBH,eAAO,MAAM,WAAW,eAA2B,CAAC"}

package/dist/categories/compression.js

@@ -2,17 +2,67 @@
  * Test Category 9 — Compression.
  *
  * Verify gzip, brotli, deflate decoding behavior matches the Node.js reference
- * oracle (`nodeZlib`). The system under test is `@browsercore/compression`;
- * `nodeZlib` is the spec reference for these primitive layers. See
- * docs/TEST-SUITE.md ("Test Category 9 — Compression") for full acceptance
- * criteria.
+ * oracle (`nodeZlib`). The system under test is a `CompressionProvider`
+ * implementation backed by node:zlib; `nodeZlib` is the spec reference for
+ * these primitive layers. The runtime implementation lives in browsersmith
+ * (Layer 5), so this repo exercises the `CompressionProvider` contract with a
+ * local Node-backed double. See docs/TEST-SUITE.md ("Test Category 9 —
+ * Compression") for full acceptance criteria.
  */
-import { deflateRawSync } from "node:zlib";
+import { brotliCompressSync, brotliDecompressSync, deflateRawSync, deflateSync, gunzipSync, gzipSync, inflateRawSync, inflateSync, } from "node:zlib";
 import { describe, expect, it } from "vitest";
-import { compression, UnsupportedEncodingError, } from "@browsercore/compression";
+import { UnsupportedEncodingError } from "@browsercore/compression";
 import { nodeZlib } from "../reference/node-reference.js";
 import { TestCategory } from "../types.js";
 export const CATEGORY_ID = TestCategory.Compression;
+/**
+ * Local Node-backed `CompressionProvider` double. The production implementation
+ * lives in browsersmith; this repo exercises the contract against the Node
+ * reference oracle to validate the primitive behavior.
+ */
+const compression = {
+    gzip(data) {
+        return new Uint8Array(gzipSync(data));
+    },
+    gunzip(data) {
+        return new Uint8Array(gunzipSync(data));
+    },
+    deflate(data) {
+        return new Uint8Array(deflateSync(data));
+    },
+    inflate(data) {
+        return new Uint8Array(inflateSync(data));
+    },
+    inflateRaw(data) {
+        return new Uint8Array(inflateRawSync(data));
+    },
+    brotliCompress(data) {
+        return new Uint8Array(brotliCompressSync(data));
+    },
+    brotliDecompress(data) {
+        return new Uint8Array(brotliDecompressSync(data));
+    },
+    decompress(data, encoding) {
+        switch (encoding) {
+            case "gzip":
+                return this.gunzip(data);
+            case "deflate": {
+                try {
+                    return this.inflate(data);
+                }
+                catch {
+                    return this.inflateRaw(data);
+                }
+            }
+            case "br":
+                return this.brotliDecompress(data);
+            case "identity":
+                return data;
+            default:
+                throw new UnsupportedEncodingError(`unsupported encoding: ${String(encoding)}`);
+        }
+    },
+};
 /** Deterministic payload: byte[i] = i % 256 (reproducible, never random). */
 function detBuffer(length) {
     const bytes = new Uint8Array(length);

package/dist/categories/compression.js.map

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

package/dist/categories/cookies.d.ts

@@ -1,8 +1,9 @@
 /**
  * Test Category 8 — Cookie Behavior.
  *
- * Verify cookie parsing and policy. See docs/TEST-SUITE.md
- * ("Test Category 8 — Cookie Behavior") for full acceptance criteria.
+ * Verify RFC 6265 cookie parsing and policy against the @browsercore/cookies
+ * implementation. See docs/TEST-SUITE.md ("Test Category 8 — Cookie Behavior")
+ * for the full acceptance criteria.
  */
 export declare const CATEGORY_ID: "cookie-behavior";
 //# sourceMappingURL=cookies.d.ts.map

package/dist/categories/cookies.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/categories/cookies.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,WAAW,mBAA8B,CAAC"}
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../src/categories/cookies.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAkBH,eAAO,MAAM,WAAW,mBAA8B,CAAC"}

package/dist/categories/cookies.js

@@ -1,20 +1,225 @@
 /**
  * Test Category 8 — Cookie Behavior.
  *
- * Verify cookie parsing and policy. See docs/TEST-SUITE.md
- * ("Test Category 8 — Cookie Behavior") for full acceptance criteria.
+ * Verify RFC 6265 cookie parsing and policy against the @browsercore/cookies
+ * implementation. See docs/TEST-SUITE.md ("Test Category 8 — Cookie Behavior")
+ * for the full acceptance criteria.
  */
-import { describe, it } from "vitest";
+import { describe, expect, it } from "vitest";
+import { createCookieJar, parseSetCookieHeader, cookieMatchesUrl, isExpired, normalizeDomain, defaultPath, sameSiteAllows, CookieParseError, } from "@browsercore/cookies";
 import { TestCategory } from "../types.js";
 export const CATEGORY_ID = TestCategory.CookieBehavior;
+/** Build a {@link CookieUrl} for testing. */
+function url(hostname, pathname, secure = false) {
+    return {
+        hostname,
+        pathname,
+        // The @browsercore/cookies Secure check compares protocol against
+        // "https:" (with trailing colon), matching the URL standard form.
+        protocol: secure ? "https:" : "http:",
+    };
+}
+/** Build a {@link SameSiteContext} for testing. */
+function ctx(topLevelSite, isTopLevel = false) {
+    return { topLevelSite, isTopLevelNavigation: isTopLevel, method: "GET" };
+}
 describe(CATEGORY_ID, () => {
-    it.todo("cookie parsing");
-    it.todo("cookie expiration");
-    it.todo("Secure cookies");
-    it.todo("HttpOnly cookies");
-    it.todo("SameSite cookies");
-    it.todo("domain matching");
-    it.todo("path matching");
-    it.todo("cookie ordering");
+    it("parses a Set-Cookie header into a Cookie object", () => {
+        const cookie = parseSetCookieHeader("session=abc123; Path=/; Secure; HttpOnly", url("example.com", "/"));
+        expect(cookie).not.toBeNull();
+        expect(cookie?.name).toBe("session");
+        expect(cookie?.value).toBe("abc123");
+        expect(cookie?.path).toBe("/");
+        expect(cookie?.secure).toBe(true);
+        expect(cookie?.httpOnly).toBe(true);
+    });
+    it("parses a Set-Cookie header with an explicit Domain", () => {
+        const cookie = parseSetCookieHeader("id=42; Domain=example.com", url("example.com", "/"));
+        expect(cookie).not.toBeNull();
+        expect(cookie?.domain).toBe("example.com");
+    });
+    it("parses a Set-Cookie header with Max-Age", () => {
+        const cookie = parseSetCookieHeader("prefs=dark; Max-Age=3600", url("example.com", "/"));
+        expect(cookie).not.toBeNull();
+        expect(cookie?.maxAge).toBe(3600);
+    });
+    it("parses a Set-Cookie header with SameSite", () => {
+        const lax = parseSetCookieHeader("a=1; SameSite=Lax", url("example.com", "/"));
+        expect(lax?.sameSite).toBe("Lax");
+        const strict = parseSetCookieHeader("a=1; SameSite=Strict", url("example.com", "/"));
+        expect(strict?.sameSite).toBe("Strict");
+        const none = parseSetCookieHeader("a=1; SameSite=None; Secure", url("example.com", "/"));
+        expect(none?.sameSite).toBe("None");
+    });
+    it("parses a Set-Cookie header with an explicit Expires", () => {
+        const cookie = parseSetCookieHeader("prefs=dark; Expires=Wed, 09 Jun 2021 10:18:14 GMT", url("example.com", "/"));
+        expect(cookie).not.toBeNull();
+        expect(cookie?.expires).toBeInstanceOf(Date);
+    });
+    it("throws CookieParseError for an empty Set-Cookie header", () => {
+        expect(() => parseSetCookieHeader("", url("example.com", "/"))).toThrow(CookieParseError);
+    });
+    it("parses 'Path=/; Secure' as a cookie named 'Path' with value '/'", () => {
+        // The parser is permissive: "Path=/; Secure" is treated as a cookie
+        // with name "Path" and value "/", plus the Secure attribute. This is
+        // technically a malformed Set-Cookie header, but the parser does not
+        // reject it — higher layers should validate before storing.
+        const cookie = parseSetCookieHeader("Path=/; Secure", url("example.com", "/"));
+        expect(cookie).not.toBeNull();
+        expect(cookie?.name).toBe("Path");
+        expect(cookie?.value).toBe("/");
+        expect(cookie?.secure).toBe(true);
+    });
+    it("rejects a cookie for a domain mismatch", () => {
+        // A cookie set for example.com must NOT match evil.com.
+        const cookie = parseSetCookieHeader("session=abc; Domain=example.com", url("example.com", "/"));
+        expect(cookie).not.toBeNull();
+        const evilUrl = url("evil.com", "/");
+        const result = cookieMatchesUrl(cookie, evilUrl);
+        expect(result.matched).toBe(false);
+        expect(result.reason).toBe("domain_mismatch");
+    });
+    it("matches a cookie to its own domain and subdomains", () => {
+        const cookie = parseSetCookieHeader("session=abc; Domain=example.com", url("example.com", "/"));
+        expect(cookie).not.toBeNull();
+        const c = cookie;
+        expect(cookieMatchesUrl(c, url("example.com", "/")).matched).toBe(true);
+        expect(cookieMatchesUrl(c, url("www.example.com", "/")).matched).toBe(true);
+        expect(cookieMatchesUrl(c, url("deep.sub.example.com", "/")).matched).toBe(true);
+    });
+    it("respects the Secure flag — no match over http", () => {
+        const cookie = parseSetCookieHeader("session=abc; Domain=example.com; Secure", url("example.com", "/"));
+        expect(cookie).not.toBeNull();
+        const c = cookie;
+        expect(cookieMatchesUrl(c, url("example.com", "/", false)).matched).toBe(false);
+        expect(cookieMatchesUrl(c, url("example.com", "/", true)).matched).toBe(true);
+    });
+    it("respects the Path attribute", () => {
+        const cookie = parseSetCookieHeader("session=abc; Domain=example.com; Path=/api", url("example.com", "/api"));
+        expect(cookie).not.toBeNull();
+        const c = cookie;
+        expect(cookieMatchesUrl(c, url("example.com", "/api")).matched).toBe(true);
+        expect(cookieMatchesUrl(c, url("example.com", "/api/v1")).matched).toBe(true);
+        expect(cookieMatchesUrl(c, url("example.com", "/other")).matched).toBe(false);
+    });
+    it("detects an expired cookie by Max-Age", () => {
+        const cookie = {
+            name: "sess",
+            value: "x",
+            domain: "example.com",
+            path: "/",
+            expires: undefined,
+            maxAge: -1, // expired
+            secure: false,
+            httpOnly: false,
+            sameSite: "Lax",
+            partitioned: false,
+            hostOnly: false,
+            creationTime: Date.now() - 10_000,
+            lastAccessTime: Date.now() - 10_000,
+        };
+        expect(isExpired(cookie, Date.now())).toBe(true);
+    });
+    it("detects a fresh cookie as not expired", () => {
+        const cookie = {
+            name: "sess",
+            value: "x",
+            domain: "example.com",
+            path: "/",
+            expires: undefined,
+            maxAge: 3600,
+            secure: false,
+            httpOnly: false,
+            sameSite: "Lax",
+            partitioned: false,
+            hostOnly: false,
+            creationTime: Date.now(),
+            lastAccessTime: Date.now(),
+        };
+        expect(isExpired(cookie, Date.now())).toBe(false);
+    });
+    it("normalizes a domain to lowercase and strips leading dot", () => {
+        expect(normalizeDomain("Example.COM")).toBe("example.com");
+        expect(normalizeDomain(".example.com")).toBe("example.com");
+    });
+    it("computes the default path from a request path", () => {
+        expect(defaultPath("/")).toBe("/");
+        expect(defaultPath("/foo/bar")).toBe("/foo");
+        expect(defaultPath("/foo/bar/baz")).toBe("/foo/bar");
+    });
+    it("SameSite=Strict blocks cross-site requests", () => {
+        const cookie = {
+            name: "sess",
+            value: "x",
+            domain: "example.com",
+            path: "/",
+            expires: undefined,
+            maxAge: undefined,
+            secure: false,
+            httpOnly: false,
+            sameSite: "Strict",
+            partitioned: false,
+            hostOnly: false,
+            creationTime: Date.now(),
+            lastAccessTime: Date.now(),
+        };
+        // Same-site → allowed.
+        expect(sameSiteAllows(cookie, url("example.com", "/"), ctx("example.com"))).toBe(true);
+        // Cross-site → blocked.
+        expect(sameSiteAllows(cookie, url("example.com", "/"), ctx("evil.com"))).toBe(false);
+    });
+    it("SameSite=Lax allows top-level navigations cross-site", () => {
+        const cookie = {
+            name: "sess",
+            value: "x",
+            domain: "example.com",
+            path: "/",
+            expires: undefined,
+            maxAge: undefined,
+            secure: false,
+            httpOnly: false,
+            sameSite: "Lax",
+            partitioned: false,
+            hostOnly: false,
+            creationTime: Date.now(),
+            lastAccessTime: Date.now(),
+        };
+        // Same-site → allowed.
+        expect(sameSiteAllows(cookie, url("example.com", "/"), ctx("example.com"))).toBe(true);
+        // Cross-site top-level navigation → allowed.
+        expect(sameSiteAllows(cookie, url("example.com", "/"), ctx("evil.com", true))).toBe(true);
+    });
+    it("createCookieJar stores and retrieves cookies", () => {
+        const jar = createCookieJar();
+        jar.setCookie("session=abc123; Path=/", url("example.com", "/"));
+        const target = url("example.com", "/");
+        const cookies = jar.getCookies(target);
+        expect(cookies.length).toBe(1);
+        expect(cookies[0]?.name).toBe("session");
+        expect(cookies[0]?.value).toBe("abc123");
+    });
+    it("cookie jar does not return cookies for unmatched domains", () => {
+        const jar = createCookieJar();
+        jar.setCookie("session=abc; Domain=example.com", url("example.com", "/"));
+        const cookies = jar.getCookies(url("other.com", "/"));
+        expect(cookies).toHaveLength(0);
+    });
+    it("cookie jar clears all cookies", () => {
+        const jar = createCookieJar();
+        jar.setCookie("a=1; Path=/", url("example.com", "/"));
+        jar.setCookie("b=2; Path=/", url("example.com", "/"));
+        jar.clear();
+        expect(jar.getCookies(url("example.com", "/"))).toHaveLength(0);
+    });
+    it("cookie jar serializes and deserializes", () => {
+        const jar = createCookieJar();
+        jar.setCookie("session=abc123; Path=/", url("example.com", "/"));
+        const json = jar.serialize();
+        const jar2 = createCookieJar();
+        jar2.deserialize(json);
+        const cookies = jar2.getCookies(url("example.com", "/"));
+        expect(cookies.length).toBe(1);
+        expect(cookies[0]?.name).toBe("session");
+    });
 });
 //# sourceMappingURL=cookies.js.map

package/dist/categories/cookies.js.map

@@ -1 +1 @@
-{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../src/categories/cookies.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC,cAAc,CAAC;AAEvD,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACvB,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1B,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC7B,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1B,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC5B,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC5B,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3B,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACzB,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AAC/B,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../src/categories/cookies.ts"],"names":[],"mappings":"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"}

package/dist/categories/redirects.d.ts

@@ -1,8 +1,14 @@
 /**
  * Test Category 10 — Redirect Handling.
  *
- * Verify 301, 302, 303, 307, 308 behavior. See docs/TEST-SUITE.md
- * ("Test Category 10 — Redirect Handling") for full acceptance criteria.
+ * Verify 301, 302, 303, 307, 308 status codes are correctly classified as
+ * redirects, and that the method-rewriting rules for 303 (and historical 301/
+ * 302) are applied per RFC 7231. See docs/TEST-SUITE.md ("Test Category 10 —
+ * Redirect Handling") for full acceptance criteria.
+ *
+ * These tests exercise the pure redirect-classification logic (status code →
+ * is-redirect, method rewrite) that the HTTP layers use. End-to-end redirect
+ * following is tested in browsercore/e2e-redirect-compress.test.ts.
  */
 export declare const CATEGORY_ID: "redirect-handling";
 //# sourceMappingURL=redirects.d.ts.map

package/dist/categories/redirects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../src/categories/redirects.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,eAAO,MAAM,WAAW,qBAAgC,CAAC"}
+{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../src/categories/redirects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,eAAO,MAAM,WAAW,qBAAgC,CAAC"}