Skip to content

Write HTML. Render video. Built for agents.

3.8 KB
Raw Blame
import { describe, it, expect, afterEach, vi } from "vitest";
import {
  existsSync,
  mkdtempSync,
  writeFileSync,
  readFileSync,
  readdirSync,
  renameSync,
  rmSync,
} from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { stampFileHfIds } from "./hfIdPersist.js";

const hooks = vi.hoisted(() => ({ minting: undefined as (() => void) | undefined }));
vi.mock("@hyperframes/parsers/hf-ids", async (importOriginal) => {
  const actual = await importOriginal<typeof import("@hyperframes/parsers/hf-ids")>();
  return {
    ...actual,
    stampHfIdsInPlace: (html: string) => {
      hooks.minting?.();
      return actual.stampHfIdsInPlace(html);
    },
  };
});

describe("stampFileHfIds", () => {
  const tmpDirs: string[] = [];

  afterEach(() => {
    hooks.minting = undefined;
    for (const d of tmpDirs) rmSync(d, { recursive: true, force: true });
    tmpDirs.length = 0;
  });

  function tmpFile(content: string): string {
    const dir = mkdtempSync(join(tmpdir(), "hfid-stamp-test-"));
    tmpDirs.push(dir);
    const file = join(dir, "scene.html");
    writeFileSync(file, content, "utf-8");
    return file;
  }

  it("stamps ids and writes them back to the file", () => {
    const file = tmpFile(`<div class="clip" data-start="0" data-end="3">Hi</div>`);
    const returned = stampFileHfIds(file);
    expect(returned).toContain('data-hf-id="hf-');
    expect(readFileSync(file, "utf-8")).toBe(returned);
  });

  it("adds only the ids to the file, keeping its own formatting", () => {
    const html = `<div class='clip' data-start=0 data-end="3"><img src="a.png"/><input disabled>Hi</div>`;
    const file = tmpFile(html);
    stampFileHfIds(file);
    const written = readFileSync(file, "utf-8");
    expect(written).toContain('data-hf-id="hf-');
    expect(written.replace(/ data-hf-id="hf-[a-z0-9]{4}"/g, "")).toBe(html);
  });

  it("replaces the stamped file and removes its temporary sibling", () => {
    const file = tmpFile(`<div class="clip" data-start="0" data-end="3">Hi</div>`);

    const returned = stampFileHfIds(file);

    expect(readFileSync(file, "utf-8")).toBe(returned);
    expect(readdirSync(file.replace(/\/[^/]+$/, ""))).toEqual(["scene.html"]);
  });

  it.each([
    ["in place", (file: string, html: string) => writeFileSync(file, html)],
    [
      "by rename",
      (file: string, html: string) => {
        writeFileSync(`${file}.tmp`, html);
        renameSync(`${file}.tmp`, file);
      },
    ],
  ])("keeps a write that lands %s while ids are minted", (_, write) => {
    const file = tmpFile(`<div class="clip" data-start="0" data-end="3">Hi</div>`);
    const agentWrite = `<div class="clip" data-start="0" data-end="5">Agent</div>`;
    hooks.minting = () => write(file, agentWrite);

    stampFileHfIds(file);

    expect(readFileSync(file, "utf-8")).toBe(agentWrite);
  });

  it("leaves a file deleted while ids are minted deleted", () => {
    const file = tmpFile(`<div class="clip" data-start="0" data-end="3">Hi</div>`);
    hooks.minting = () => rmSync(file);

    stampFileHfIds(file);

    expect(existsSync(file)).toBe(false);
  });

  it("does not rewrite an already-stamped file", () => {
    const file = tmpFile(`<div data-hf-id="hf-keep">Hi</div>`);
    const before = readFileSync(file, "utf-8");
    const returned = stampFileHfIds(file);
    expect(returned).toContain('data-hf-id="hf-keep"');
    expect(readFileSync(file, "utf-8")).toBe(before); // byte-identical, no write
  });

  it("returns null for a missing file", () => {
    const dir = mkdtempSync(join(tmpdir(), "hfid-stamp-test-"));
    tmpDirs.push(dir);
    expect(stampFileHfIds(join(dir, "nope.html"))).toBeNull();
  });

  it("returns null for a directory", () => {
    const dir = mkdtempSync(join(tmpdir(), "hfid-stamp-test-"));
    tmpDirs.push(dir);
    expect(stampFileHfIds(dir)).toBeNull();
  });
});