Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
import { afterEach, describe, expect, it } from "vitest";
import { Hono } from "hono";
import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { registerProjectRoutes } from "./projects";
import type { StudioApiAdapter } from "../types";
const tempDirs: string[] = [];
afterEach(() => {
for (const dir of tempDirs.splice(0)) {
rmSync(dir, { recursive: true, force: true });
}
});
const COMPOSITION_HTML = '<html><body><div data-composition-id="main"></div></body></html>';
// Project layout for #1384: real compositions at the root and under
// compositions/, plus dot-directory content that exercises discovery gating
// and the file tree's backup-only hiding (#1366):
// - .cache/examples/ a vendored dot-dir. walkDir does NOT special-case
// it, so it stays listed in the file tree, but it is
// gated out of composition discovery (isInHiddenOrVendorDir).
// - .hyperframes/examples/ under the app's folder — gated out of discovery,
// and hidden from the tree like every non-Studio record.
// - .hyperframes/backup/ Studio's internal snapshots — hidden from the tree.
function createProjectDir(): string {
const projectDir = mkdtempSync(join(tmpdir(), "hf-projects-test-"));
tempDirs.push(projectDir);
writeFileSync(join(projectDir, "index.html"), COMPOSITION_HTML);
mkdirSync(join(projectDir, "compositions"));
writeFileSync(join(projectDir, "compositions", "scene.html"), COMPOSITION_HTML);
mkdirSync(join(projectDir, ".cache", "examples"), { recursive: true });
writeFileSync(join(projectDir, ".cache", "examples", "preset.html"), COMPOSITION_HTML);
mkdirSync(join(projectDir, ".hyperframes", "examples"), { recursive: true });
writeFileSync(join(projectDir, ".hyperframes", "examples", "preset.html"), COMPOSITION_HTML);
mkdirSync(join(projectDir, ".hyperframes", "backup"), { recursive: true });
writeFileSync(join(projectDir, ".hyperframes", "backup", "snapshot.html"), COMPOSITION_HTML);
return projectDir;
}
function createAdapter(projectDir: string): StudioApiAdapter {
return {
listProjects: () => [],
resolveProject: async (id: string) => ({ id, dir: projectDir }),
bundle: async () => null,
lint: async () => ({ findings: [] }),
runtimeUrl: "/api/runtime.js",
rendersDir: () => "/tmp/renders",
startRender: () => ({
id: "job-1",
status: "rendering",
progress: 0,
outputPath: "/tmp/out.mp4",
}),
};
}
describe("GET /projects/:id/signature", () => {
it("returns the adapter's cached signature when provided", async () => {
const projectDir = createProjectDir();
const app = new Hono();
registerProjectRoutes(app, {
...createAdapter(projectDir),
getProjectSignature: () => "cached-sig",
});
const response = await app.request("http://localhost/projects/demo/signature");
expect(response.status).toBe(200);
expect(await response.json()).toEqual({ signature: "cached-sig" });
});
it("computes a signature that moves when project files change", async () => {
const projectDir = createProjectDir();
const app = new Hono();
registerProjectRoutes(app, createAdapter(projectDir));
const first = (await (
await app.request("http://localhost/projects/demo/signature")
).json()) as {
signature: string;
};
expect(first.signature).toMatch(/^[0-9a-f]{24}$/);
writeFileSync(join(projectDir, "compositions", "scene.html"), "<html><body>new</body></html>");
const second = (await (
await app.request("http://localhost/projects/demo/signature")
).json()) as { signature: string };
expect(second.signature).not.toBe(first.signature);
});
it("ignores generated cache writes while detecting source edits", async () => {
const projectDir = createProjectDir();
const app = new Hono();
registerProjectRoutes(app, createAdapter(projectDir));
const getSignature = async () =>
(
(await (await app.request("http://localhost/projects/demo/signature")).json()) as {
signature: string;
}
).signature;
const initial = await getSignature();
const generatedFiles = [
[".transcode-cache", "proxy.mp4"],
[".thumbnails", "frame.jpg"],
[".waveform-cache", "peaks.json"],
] as const;
const generatedSignatures: string[] = [];
for (const [dir, file] of generatedFiles) {
mkdirSync(join(projectDir, dir));
writeFileSync(join(projectDir, dir, file), `generated ${dir}`);
generatedSignatures.push(await getSignature());
}
expect(generatedSignatures).toEqual([initial, initial, initial]);
mkdirSync(join(projectDir, "src"));
writeFileSync(join(projectDir, "src", "scene.ts"), "export const scene = true;");
expect(await getSignature()).not.toBe(initial);
});
it("404s for an unknown project", async () => {
const app = new Hono();
registerProjectRoutes(app, {
...createAdapter(createProjectDir()),
resolveProject: async () => null,
});
const response = await app.request("http://localhost/projects/nope/signature");
expect(response.status).toBe(404);
});
});
describe("registerProjectRoutes — composition discovery (#1384)", () => {
it("excludes HTML inside dot-directories from compositions", async () => {
const projectDir = createProjectDir();
const app = new Hono();
registerProjectRoutes(app, createAdapter(projectDir));
const response = await app.request("http://localhost/projects/demo");
const payload = (await response.json()) as { compositions?: string[] };
expect(response.status).toBe(200);
expect(payload.compositions).toContain("index.html");
expect(payload.compositions).toContain("compositions/scene.html");
expect(payload.compositions).not.toContain(".cache/examples/preset.html");
expect(payload.compositions).not.toContain(".hyperframes/examples/preset.html");
});
it("lists vendored dot-directory files in the file tree, but nothing under .hyperframes/ that isn't Studio's", async () => {
const projectDir = createProjectDir();
writeFileSync(join(projectDir, ".hyperframes", "app-history.jsonl"), "{}");
writeFileSync(join(projectDir, ".hyperframes", "studio-motion.json"), "{}");
const app = new Hono();
registerProjectRoutes(app, createAdapter(projectDir));
const response = await app.request("http://localhost/projects/demo");
const payload = (await response.json()) as { files?: string[] };
// Vendored dot-dirs stay browsable — discovery is gated, the file tree is not.
expect(payload.files).toContain(".cache/examples/preset.html");
expect(payload.files).toContain(".hyperframes/studio-motion.json");
for (const hidden of ["examples/preset.html", "backup/snapshot.html", "app-history.jsonl"])
expect(payload.files).not.toContain(`.hyperframes/${hidden}`);
});
it("omits generated cache files from the project file tree", async () => {
const projectDir = createProjectDir();
mkdirSync(join(projectDir, ".transcode-cache"));
writeFileSync(join(projectDir, ".transcode-cache", "proxy.mp4"), "proxy");
mkdirSync(join(projectDir, ".waveform-cache"));
writeFileSync(join(projectDir, ".waveform-cache", "peaks.json"), "[]");
const app = new Hono();
registerProjectRoutes(app, createAdapter(projectDir));
const response = await app.request("http://localhost/projects/demo");
const payload = (await response.json()) as { files?: string[] };
expect(payload.files).not.toContain(".transcode-cache/proxy.mp4");
expect(payload.files).not.toContain(".waveform-cache/peaks.json");
});
});