import { describe, expect, it, vi } from "vitest";
import { runFontLocalize, stampFontVersions, type FontLocalizeIo } from "./fontLocalize.js";
function makeIo(input: string): {
io: FontLocalizeIo;
output: string[];
errors: string[];
} {
const output: string[] = [];
const errors: string[] = [];
return {
io: {
readInput: async () => input,
writeOutput: (value) => output.push(value),
writeError: (value) => errors.push(value),
},
output,
errors,
};
}
// Shaped like the producer's FontFetchError: runFontLocalize reads only its
// class name and structured `unresolvedFamilies`, never the message.
class FontFetchLikeError extends Error {
readonly unresolvedFamilies: readonly unknown[];
constructor(message: string, unresolvedFamilies: readonly unknown[]) {
super(message);
this.name = "FontFetchError";
this.unresolvedFamilies = unresolvedFamilies;
}
}
describe("runFontLocalize", () => {
it("writes only the localized document to stdout", async () => {
const harness = makeIo("source");
const localize = vi.fn(async () => "localized");
const exitCode = await runFontLocalize(harness.io, localize);
expect(exitCode).toBe(0);
expect(localize).toHaveBeenCalledWith("source");
expect(harness.output).toEqual(["localized"]);
expect(harness.errors).toEqual([]);
});
it("rejects blank input without calling the resolver", async () => {
const harness = makeIo(" \n");
const localize = vi.fn(async (html: string) => html);
const exitCode = await runFontLocalize(harness.io, localize);
expect(exitCode).toBe(2);
expect(localize).not.toHaveBeenCalled();
expect(harness.output).toEqual([]);
expect(harness.errors.join(" ")).toContain("input is empty");
});
it("fails without echoing source HTML or resolver details", async () => {
const source = '
';
const harness = makeIo(source);
const localize = vi.fn(async () => {
throw new Error(`fetch failed for ${source}`);
});
const exitCode = await runFontLocalize(harness.io, localize);
expect(exitCode).toBe(1);
expect(harness.output).toEqual([]);
expect(harness.errors.join(" ")).toContain("font localization failed (Error)");
expect(harness.errors.join(" ")).not.toContain("signed.example");
expect(harness.errors.join(" ")).not.toContain("");
});
it("names the unresolved font families after the unchanged failure prefix", async () => {
const harness = makeIo("source");
const exitCode = await runFontLocalize(harness.io, async () => {
throw new FontFetchLikeError("unresolved", ["Foo Bar", "Baz"]);
});
expect(exitCode).toBe(1);
expect(harness.errors).toEqual([
'font localization failed (FontFetchError): unresolved font families: "Foo Bar", "Baz"\n',
]);
});
it("never echoes a URL or signed query from the error message", async () => {
const harness = makeIo('');
const message =
"[Compiler] Unresolved fonts in fail-closed mode: Saira ExtraCondensed. " +
"fetch https://fonts.googleapis.com/css2?family=Saira&X-Amz-Signature=SECRETSIG failed";
await runFontLocalize(harness.io, async () => {
throw new FontFetchLikeError(message, ["Saira ExtraCondensed"]);
});
const stderr = harness.errors.join("");
expect(stderr).toBe(
'font localization failed (FontFetchError): unresolved font families: "Saira ExtraCondensed"\n',
);
expect(stderr).not.toContain("SECRETSIG");
expect(stderr).not.toContain("https://");
expect(stderr).not.toContain("Unresolved fonts in fail-closed mode");
});
it("drops URL-shaped family names whole and strips other characters", async () => {
const harness = makeIo("source");
await runFontLocalize(harness.io, async () => {
throw new FontFetchLikeError("unresolved", [
"https://signed.example/font?token=SECRETTOKEN",
'Evil"Name\n