Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { mkdtempSync, writeFileSync, rmSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
// Drive `latest` through the REAL getUpdateMeta (defined in the module under
// test) via the mocked config store — self-mocking getUpdateMeta on
// "./updateCheck.js" would only override the export binding, not the internal
// call printStalePinNotice makes to it from within the same module.
let store: Record<string, unknown> = {};
let runningVersion = "0.7.55";
vi.mock("../version.js", () => ({
get VERSION() {
return runningVersion;
},
}));
// isDevMode() is true under vitest (module path ends in .ts), which would
// suppress the notice unconditionally — mock ./env.js like updateCheck.test.ts does.
vi.mock("./env.js", () => ({ isDevMode: () => false }));
// What a process-cached readConfig() returns; null means it matches disk.
let cachedRead: Record<string, unknown> | null = null;
vi.mock("../telemetry/config.js", () => ({
readConfig: () => ({ ...(cachedRead ?? store) }),
readConfigFresh: () => ({ ...store }),
writeConfig: (c: Record<string, unknown>) => {
store = { ...c };
return true;
},
}));
import { printStalePinNotice } from "./updateCheck.js";
describe("printStalePinNotice", () => {
let dir: string;
let writes: string[];
const origWrite = process.stderr.write.bind(process.stderr);
beforeEach(() => {
store = { latestVersion: "0.7.55" };
cachedRead = null;
runningVersion = "0.7.55";
writes = [];
dir = mkdtempSync(join(tmpdir(), "hf-pin-"));
process.stderr.write = ((s: unknown) => {
writes.push(String(s));
return true;
}) as typeof process.stderr.write;
delete process.env.CI;
delete process.env.HYPERFRAMES_NO_UPDATE_CHECK;
});
afterEach(() => {
process.stderr.write = origWrite;
rmSync(dir, { recursive: true, force: true });
});
it("keeps what the background check wrote after this process read the settings", () => {
writeFileSync(
join(dir, "package.json"),
JSON.stringify({ scripts: { render: "npx --yes [email protected] render" } }),
);
cachedRead = { ...store };
store = { ...store, lastUpdateCheck: "2026-09-27T00:00:00.000Z" };
printStalePinNotice(dir);
expect(store).toMatchObject({ lastUpdateCheck: "2026-09-27T00:00:00.000Z" });
expect(store["lastStalePinNoticeAt"]).toEqual(expect.any(Number));
});
it("warns once when the project pins an older version", () => {
writeFileSync(
join(dir, "package.json"),
JSON.stringify({ scripts: { render: "npx --yes [email protected] render" } }),
);
printStalePinNotice(dir);
printStalePinNotice(dir); // throttled — second call silent
expect(writes.join("")).toContain("0.7.48");
expect(writes.join("")).toContain("upgrade --project");
expect(writes.filter((w) => w.includes("upgrade --project")).length).toBe(1);
});
it("silent when project pin is current", () => {
writeFileSync(
join(dir, "package.json"),
JSON.stringify({ scripts: { render: "npx --yes [email protected] render" } }),
);
printStalePinNotice(dir);
expect(writes.join("")).toBe("");
});
it("warns on every run when an older CLI than the pin is running", () => {
store = { latestVersion: "0.8.71" };
runningVersion = "0.7.71";
writeFileSync(
join(dir, "package.json"),
JSON.stringify({ scripts: { check: "npx --yes [email protected] check" } }),
);
printStalePinNotice(dir);
printStalePinNotice(dir);
const mismatch = writes.filter((w) => w.includes("This is hyperframes 0.7.71"));
expect(mismatch.length).toBe(2);
expect(mismatch[0]).toContain("npx [email protected]");
expect(writes.join("")).not.toContain("upgrade --project");
});
it("silent under CI", () => {
process.env.CI = "true";
writeFileSync(
join(dir, "package.json"),
JSON.stringify({ scripts: { render: "npx --yes [email protected] render" } }),
);
printStalePinNotice(dir);
expect(writes.join("")).toBe("");
});
});