@browsercore/testing 0.1.0

package/dist/utils.js

@@ -0,0 +1,102 @@
+/**
+ * Small shared helpers for @browsercore/testing.
+ */
+/**
+ * Exhaustiveness check for `switch`/`if-else` over discriminated unions.
+ * Call in the `default` branch: `default: assertNever(x)`.
+ * Adding a new union member forces every handler to compile-error until handled.
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+export function assertNever(x) {
+    throw new Error(`Unexpected value: ${JSON.stringify(x)}`);
+}
+/** Generate a unique TestCaseId (not cryptographically random). */
+export function createId(prefix = "tc") {
+    return `${prefix}_${Date.now().toString(36)}_${Math.floor(Math.random() * 1e6).toString(36)}`;
+}
+/** Format bytes as a lowercase hex string with no separators. */
+export function bytesToHex(buf) {
+    let out = "";
+    for (let i = 0; i < buf.length; i++) {
+        out += buf[i].toString(16).padStart(2, "0");
+    }
+    return out;
+}
+/**
+ * Compare two byte arrays. Returns a {@link ComparisonResult} reporting whether
+ * they match, the first divergence index (if any), and a message.
+ */
+export function compareBytes(a, b) {
+    if (a.length !== b.length) {
+        return {
+            matches: false,
+            divergenceByteIndex: Math.min(a.length, b.length),
+            message: `Length mismatch: ${a.length} vs ${b.length}`,
+        };
+    }
+    for (let i = 0; i < a.length; i++) {
+        if (a[i] !== b[i]) {
+            return {
+                matches: false,
+                divergenceByteIndex: i,
+                message: `Byte ${i}: 0x${bytesToHex(a.subarray(i, i + 1))} vs 0x${bytesToHex(b.subarray(i, i + 1))}`,
+            };
+        }
+    }
+    return {
+        matches: true,
+        divergenceByteIndex: undefined,
+        message: "equal",
+    };
+}
+/**
+ * Compare two byte arrays while masking byte ranges that are intentionally
+ * randomized by the protocol spec (ephemeral keys, nonces, GREASE, random).
+ *
+ * Ranges in `ignore` are skipped when scanning for divergence. The returned
+ * {@link ComparisonResultWithIgnore.maskedReports} lists the ranges that were
+ * masked so callers can audit what was excluded.
+ */
+export function compareBytesWithIgnore(a, b, ignore) {
+    // Defensive copy, sorted ascending so masking checks are O(log n) per byte.
+    const ranges = [...ignore].sort((x, y) => x.byteOffset - y.byteOffset);
+    const isMasked = (index) => {
+        for (const range of ranges) {
+            if (index < range.byteOffset)
+                return false;
+            if (index < range.byteOffset + range.length)
+                return true;
+        }
+        return false;
+    };
+    const maxLen = Math.max(a.length, b.length);
+    for (let i = 0; i < maxLen; i++) {
+        const inA = i < a.length;
+        const inB = i < b.length;
+        if (!inA || !inB) {
+            if (isMasked(i))
+                continue;
+            return {
+                matches: false,
+                divergenceByteIndex: i,
+                message: `Length divergence at byte ${i}: ${a.length} vs ${b.length}`,
+                maskedRanges: ranges,
+            };
+        }
+        if (a[i] !== b[i] && !isMasked(i)) {
+            return {
+                matches: false,
+                divergenceByteIndex: i,
+                message: `Byte ${i}: 0x${bytesToHex(a.subarray(i, i + 1))} vs 0x${bytesToHex(b.subarray(i, i + 1))}`,
+                maskedRanges: ranges,
+            };
+        }
+    }
+    return {
+        matches: true,
+        divergenceByteIndex: undefined,
+        message: "equal",
+        maskedRanges: ranges,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@browsercore/testing",
+  "version": "0.1.0",
+  "description": "Protocol verification — RFC compliance tests, browser golden packet captures, integration tests, and benchmarking.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jverneuer/browsercore-testing.git"
+  },
+  "homepage": "https://github.com/jverneuer/browsercore-testing#readme",
+  "bugs": {
+    "url": "https://github.com/jverneuer/browsercore-testing/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "LICENSE", "README.md"],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run clean && npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.8"
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "dependencies": {
+    "@browsercore/cookies": "^0.1.0",
+    "@browsercore/crypto": "^0.1.0",
+    "@browsercore/fetch": "^0.1.0",
+    "@browsercore/http1": "^0.1.0",
+    "@browsercore/http2": "^0.1.0",
+    "@browsercore/profiles": "^0.1.0",
+    "@browsercore/tls": "^0.1.0",
+    "@browsercore/transport": "^0.1.0"
+  }
+}