cloakhq--cloakbrowser/js/tests/config.test.ts

import { describe, it, expect } from "vitest";
import {
  CHROMIUM_VERSION,
  getArchiveExt,
  getChromiumVersion,
  getDefaultStealthArgs,
  getCacheDir,
  getBinaryDir,
  getDownloadUrl,
  getFallbackDownloadUrl,
  normalizeRequestedVersion,
  binarySupportsHeadlessNoViewport,
  binarySupportsMaximizedWindow,
} from "../src/config.js";
import { _buildArgsForTest, resolveTimezone } from "../src/playwright.js";

describe("config", () => {
  it("CHROMIUM_VERSION matches expected format", () => {
    expect(CHROMIUM_VERSION).toMatch(/^\d+\.\d+\.\d+\.\d+(\.\d+)?$/);
  });

  it("getDefaultStealthArgs returns expected flags", () => {
    const args = getDefaultStealthArgs();
    const isMac = process.platform === "darwin";

    expect(args).toContain("--no-sandbox");

    if (isMac) {
      expect(args).toContain("--fingerprint-platform=macos");
    } else {
      expect(args).toContain("--fingerprint-platform=windows");
    }

    // GPU flags removed — binary auto-generates from seed + platform
    expect(args.some((a) => a.includes("fingerprint-gpu-vendor"))).toBe(false);
    expect(args.some((a) => a.includes("fingerprint-gpu-renderer"))).toBe(false);

    // Should have a random fingerprint seed
    const fingerprintArg = args.find((a) => a.startsWith("--fingerprint="));
    expect(fingerprintArg).toBeDefined();
    const seed = Number(fingerprintArg!.split("=")[1]);
    expect(seed).toBeGreaterThanOrEqual(10000);
    expect(seed).toBeLessThanOrEqual(99999);
  });

  it("getDefaultStealthArgs generates different seeds", () => {
    const seeds = new Set<string>();
    for (let i = 0; i < 10; i++) {
      const args = getDefaultStealthArgs();
      const fp = args.find((a) => a.startsWith("--fingerprint="))!;
      seeds.add(fp);
    }
    // With 90k possible seeds, 10 calls should produce at least 2 unique
    expect(seeds.size).toBeGreaterThan(1);
  });

  it("getCacheDir returns ~/.cloakbrowser by default", () => {
    const dir = getCacheDir();
    expect(dir).toContain(".cloakbrowser");
  });

  it("getBinaryDir includes platform version", () => {
    const dir = getBinaryDir();
    expect(dir).toContain(`chromium-${getChromiumVersion()}`);
  });

  it("getDownloadUrl contains platform version and platform tag", () => {
    const url = getDownloadUrl();
    expect(url).toContain(getChromiumVersion());
    expect(url).toContain("cloakbrowser-");
    expect(url).toContain(".tar.gz");
    expect(url).toContain("cloakbrowser.dev");
  });
});

describe("version pin", () => {
  it("explicit value wins over env", () => {
    process.env.CLOAKBROWSER_VERSION = "146.0.0.0";
    try {
      expect(normalizeRequestedVersion("148.0.7778.215.2")).toBe("148.0.7778.215.2");
    } finally {
      delete process.env.CLOAKBROWSER_VERSION;
    }
  });

  it("reads CLOAKBROWSER_VERSION", () => {
    process.env.CLOAKBROWSER_VERSION = "148.0.7778.215.2";
    try {
      expect(normalizeRequestedVersion()).toBe("148.0.7778.215.2");
    } finally {
      delete process.env.CLOAKBROWSER_VERSION;
    }
  });

  it("rejects unsafe values", () => {
    expect(() => normalizeRequestedVersion("../../148.0.7778.215.2")).toThrow(
      "Invalid browser version pin"
    );
  });

  it("rejects non-ASCII digits (parity with Python/.NET)", () => {
    expect(() => normalizeRequestedVersion("١٤٦.0.7680.177")).toThrow(
      "Invalid browser version pin"
    );
  });
});

describe("archive helpers", () => {
  it("getArchiveExt returns correct extension for platform", () => {
    const ext = getArchiveExt();
    if (process.platform === "win32") {
      expect(ext).toBe(".zip");
    } else {
      expect(ext).toBe(".tar.gz");
    }
  });

  it("getFallbackDownloadUrl uses GitHub Releases", () => {
    const url = getFallbackDownloadUrl("145.0.0.0");
    expect(url).toContain("github.com/CloakHQ/cloakbrowser/releases/download");
    expect(url).toContain("chromium-v145.0.0.0");
  });

  it("getFallbackDownloadUrl uses default version", () => {
    const url = getFallbackDownloadUrl();
    expect(url).toContain(`chromium-v${getChromiumVersion()}`);
  });
});

describe("buildArgs timezone/locale", () => {
  it("injects --fingerprint-timezone when timezone is set", () => {
    const args = _buildArgsForTest({ timezone: "America/New_York" });
    expect(args).toContain("--fingerprint-timezone=America/New_York");
  });

  it("injects --lang and --fingerprint-locale when locale is set", () => {
    const args = _buildArgsForTest({ locale: "en-US" });
    expect(args).toContain("--lang=en-US");
    expect(args).toContain("--fingerprint-locale=en-US");
  });

  it("injects both when both are set", () => {
    const args = _buildArgsForTest({ timezone: "Europe/Berlin", locale: "de-DE" });
    expect(args).toContain("--fingerprint-timezone=Europe/Berlin");
    expect(args).toContain("--lang=de-DE");
    expect(args).toContain("--fingerprint-locale=de-DE");
  });

  it("injects timezone/locale even when stealthArgs=false", () => {
    const args = _buildArgsForTest({ stealthArgs: false, timezone: "America/New_York", locale: "en-US" });
    expect(args).toContain("--fingerprint-timezone=America/New_York");
    expect(args).toContain("--lang=en-US");
    expect(args).toContain("--fingerprint-locale=en-US");
    expect(args.some(a => a.startsWith("--fingerprint="))).toBe(false);
  });

  it("does not inject flags when not set", () => {
    const args = _buildArgsForTest({});
    expect(args.some(a => a.startsWith("--fingerprint-timezone="))).toBe(false);
    expect(args.some(a => a.startsWith("--lang="))).toBe(false);
    expect(args.some(a => a.startsWith("--fingerprint-locale="))).toBe(false);
  });
});

describe("buildArgs deduplication", () => {
  it("user --fingerprint overrides default seed", () => {
    const args = _buildArgsForTest({ args: ["--fingerprint=99887"] });
    const fpArgs = args.filter(a => a.startsWith("--fingerprint="));
    expect(fpArgs).toHaveLength(1);
    expect(fpArgs[0]).toBe("--fingerprint=99887");
  });

  it("user --fingerprint-platform overrides default", () => {
    const args = _buildArgsForTest({ args: ["--fingerprint-platform=linux"] });
    const platArgs = args.filter(a => a.startsWith("--fingerprint-platform="));
    expect(platArgs).toHaveLength(1);
    expect(platArgs[0]).toBe("--fingerprint-platform=linux");
  });

  it("timezone param overrides user --fingerprint-timezone arg", () => {
    const args = _buildArgsForTest({
      args: ["--fingerprint-timezone=Europe/London"],
      timezone: "America/New_York",
    });
    const tzArgs = args.filter(a => a.startsWith("--fingerprint-timezone="));
    expect(tzArgs).toHaveLength(1);
    expect(tzArgs[0]).toBe("--fingerprint-timezone=America/New_York");
  });

  it("locale param overrides user --lang and --fingerprint-locale args", () => {
    const args = _buildArgsForTest({
      args: ["--lang=de-DE", "--fingerprint-locale=de-DE"],
      locale: "en-US",
    });
    const langArgs = args.filter(a => a.startsWith("--lang="));
    expect(langArgs).toHaveLength(1);
    expect(langArgs[0]).toBe("--lang=en-US");
    const localeArgs = args.filter(a => a.startsWith("--fingerprint-locale="));
    expect(localeArgs).toHaveLength(1);
    expect(localeArgs[0]).toBe("--fingerprint-locale=en-US");
  });

  it("no duplicate flag keys in output", () => {
    const args = _buildArgsForTest({
      args: ["--fingerprint=99887", "--fingerprint-timezone=UTC", "--lang=fr-FR"],
      timezone: "Europe/Berlin",
      locale: "de-DE",
    });
    const keys = args.map(a => a.split("=")[0]);
    expect(new Set(keys).size).toBe(keys.length);
  });

  it("non-value flags preserved without dedup issues", () => {
    const args = _buildArgsForTest({ args: ["--disable-gpu", "--no-zygote"] });
    expect(args).toContain("--disable-gpu");
    expect(args).toContain("--no-zygote");
    expect(args).toContain("--no-sandbox");
  });
});

describe("buildArgs webrtc IP", () => {
  it("passes --fingerprint-webrtc-ip from args", () => {
    const args = _buildArgsForTest({ args: ["--fingerprint-webrtc-ip=1.2.3.4"] });
    expect(args).toContain("--fingerprint-webrtc-ip=1.2.3.4");
  });

  it("does not inject when not in args", () => {
    const args = _buildArgsForTest({});
    expect(args.some(a => a.startsWith("--fingerprint-webrtc-ip"))).toBe(false);
  });
});

describe("resolveTimezone alias", () => {
  it("resolves timezoneId to timezone", () => {
    const result = resolveTimezone({ timezoneId: "Europe/Paris" }) as unknown as { timezone: string };
    expect(result.timezone).toBe("Europe/Paris");
    expect(result).not.toHaveProperty("timezoneId");
  });

  it("preserves explicit timezone over timezoneId", () => {
    const result = resolveTimezone({ timezone: "UTC", timezoneId: "Europe/Paris" });
    expect(result.timezone).toBe("UTC");
    expect(result).not.toHaveProperty("timezoneId");
  });

  it("returns options unchanged when no timezoneId", () => {
    const opts = { timezone: "UTC" };
    const result = resolveTimezone(opts);
    expect(result).toBe(opts); // same reference, no copy
    expect(result.timezone).toBe("UTC");
  });

  it("returns options unchanged when neither is set", () => {
    const opts = {};
    const result = resolveTimezone(opts);
    expect(result).toBe(opts);
  });
});

describe("binarySupportsHeadlessNoViewport", () => {
  // Parity-critical: Python and .NET mirror this gate. Threshold is an unshipped
  // version, so the resolved-version path is a no-op today; the declared-version
  // path is what these tests pin.
  it("is OFF one build below the threshold (current live Pro version)", () => {
    expect(binarySupportsHeadlessNoViewport(undefined, "148.0.7778.215.3")).toBe(false);
  });

  it("is ON at the threshold", () => {
    expect(binarySupportsHeadlessNoViewport(undefined, "148.0.7778.215.4")).toBe(true);
  });

  it("is ON above the threshold", () => {
    expect(binarySupportsHeadlessNoViewport(undefined, "149.0.0.0")).toBe(true);
  });

  it("declared version wins over a local override", () => {
    const prev = process.env.CLOAKBROWSER_BINARY_PATH;
    process.env.CLOAKBROWSER_BINARY_PATH = "/fake/chrome";
    try {
      expect(binarySupportsHeadlessNoViewport(undefined, "149.0.0.0")).toBe(true);
    } finally {
      if (prev === undefined) delete process.env.CLOAKBROWSER_BINARY_PATH;
      else process.env.CLOAKBROWSER_BINARY_PATH = prev;
    }
  });

  it("is OFF for a local override with no declared version", () => {
    const prev = process.env.CLOAKBROWSER_BINARY_PATH;
    process.env.CLOAKBROWSER_BINARY_PATH = "/fake/chrome";
    try {
      expect(binarySupportsHeadlessNoViewport()).toBe(false);
    } finally {
      if (prev === undefined) delete process.env.CLOAKBROWSER_BINARY_PATH;
      else process.env.CLOAKBROWSER_BINARY_PATH = prev;
    }
  });

  it("fails OFF on a malformed declared version", () => {
    // parseVersion yields NaN rather than throwing — the gate must still fail safe.
    expect(binarySupportsHeadlessNoViewport(undefined, "not.a.version")).toBe(false);
  });
});

describe("binarySupportsMaximizedWindow", () => {
  // Parity-critical: Python and .NET mirror this gate. Shares the no_viewport
  // threshold today.
  it("is OFF one build below the threshold", () => {
    expect(binarySupportsMaximizedWindow(undefined, "148.0.7778.215.3")).toBe(false);
  });
  it("is ON at the threshold", () => {
    expect(binarySupportsMaximizedWindow(undefined, "148.0.7778.215.4")).toBe(true);
  });
  it("is ON above the threshold", () => {
    expect(binarySupportsMaximizedWindow(undefined, "149.0.0.0")).toBe(true);
  });
});

describe("buildArgs --start-maximized", () => {
  it("adds --start-maximized when the binary is gated ON", () => {
    const args = _buildArgsForTest({ browserVersion: "148.0.7778.215.4" });
    expect(args).toContain("--start-maximized");
  });
  it("does not add it below the gate", () => {
    const args = _buildArgsForTest({ browserVersion: "148.0.7778.215.3" });
    expect(args).not.toContain("--start-maximized");
  });
  it("is suppressed by a user --window-size", () => {
    const args = _buildArgsForTest({
      browserVersion: "148.0.7778.215.4",
      args: ["--window-size=1000,800"],
    });
    expect(args).not.toContain("--start-maximized");
    expect(args).toContain("--window-size=1000,800");
  });
  it("is suppressed by an explicit viewport", () => {
    const args = _buildArgsForTest({
      browserVersion: "148.0.7778.215.4",
      viewport: { width: 800, height: 600 },
    } as Parameters<typeof _buildArgsForTest>[0]);
    expect(args).not.toContain("--start-maximized");
  });
  it("does not double a user-supplied --start-maximized", () => {
    const args = _buildArgsForTest({
      browserVersion: "148.0.7778.215.4",
      args: ["--start-maximized"],
    });
    expect(args.filter(a => a === "--start-maximized")).toHaveLength(1);
  });
});