mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 16:08:56 +00:00
* feat(studio): load GSAP from the CLI's bundled copy by default Studio preview now loads the GSAP, CustomEase and MotionPathPlugin scripts it adds from files the CLI ships and serves same-origin at /api/vendor/npm, instead of jsDelivr. HYPERFRAMES_GSAP_BASE_URL still wins when set, and a composition on another GSAP version gets its plugin from jsDelivr. Renders now honor HYPERFRAMES_GSAP_BASE_URL when they replace a missing local GSAP script, and the setting accepts plain http only for loopback hosts. Closes #6205 Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> * refactor(studio): keep comment share flat for the GSAP local root Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> * fix(cli): find the installed gsap with node resolution when run from source The Windows CI lane installs with the hoisted linker, so gsap is not under packages/core/node_modules there. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> * fix(producer): load a nested composition's missing GSAP from the mirror A sub-composition's missing local gsap/dist script was hoisted into the render unchanged, so HYPERFRAMES_GSAP_BASE_URL (and the jsDelivr fallback) only reached the entry document. Run the same rewrite on every sub-composition before it is compiled, resolving its path the way the inliner will hoist it. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
144 lines
6.5 KiB
TypeScript
144 lines
6.5 KiB
TypeScript
import { afterEach, beforeEach, describe, expect, it } from "vitest";
|
|
import * as fs from "node:fs";
|
|
import * as path from "node:path";
|
|
import { createStudioServer, type StudioServer } from "./studioServer.js";
|
|
import { cleanupStudioServerRoot, makeStudioServerRoot } from "./studioServerTestFixture.js";
|
|
|
|
const COMPOSITION = `<!doctype html>
|
|
<html><head><style>@font-face{font-family:Brand;src:url(assets/brand.ttf)}</style></head>
|
|
<body><div id="root" data-composition-id="main" data-width="320" data-height="180">
|
|
<img id="pic" src="assets/pic.png" data-start="0" data-duration="1">
|
|
<img id="again" src="assets/pic.png" data-start="1" data-duration="1">
|
|
<img id="responsive" src="assets/pic.png" srcset="assets/pic.png 1x, assets/pic@2x.png 2x" data-start="0" data-duration="1">
|
|
<video id="clip" src="assets/clip.mp4" poster="assets/pic.png" muted data-start="0" data-duration="1"></video>
|
|
<div id="scene-host" data-composition-id="scene" data-composition-src="compositions/scene.html" data-start="0" data-duration="1"></div>
|
|
</div></body></html>`;
|
|
|
|
const SCENE = `<template id="scene-template">
|
|
<div data-composition-id="scene" data-width="320" data-height="180">
|
|
<img id="nested" src="../assets/pic@2x.png">
|
|
</div>
|
|
</template>`;
|
|
|
|
const PIC = Buffer.alloc(4096, 7);
|
|
const PIC_2X = Buffer.alloc(8192, 9);
|
|
|
|
let root: string;
|
|
let projectDir: string;
|
|
let server: StudioServer;
|
|
|
|
beforeEach(() => {
|
|
({ root, projectDir } = makeStudioServerRoot("hf-preview-assets-"));
|
|
fs.mkdirSync(path.join(projectDir, "assets"));
|
|
fs.mkdirSync(path.join(projectDir, "compositions"));
|
|
fs.writeFileSync(path.join(projectDir, "index.html"), COMPOSITION);
|
|
fs.writeFileSync(path.join(projectDir, "compositions", "scene.html"), SCENE);
|
|
fs.writeFileSync(path.join(projectDir, "assets", "pic.png"), PIC);
|
|
fs.writeFileSync(path.join(projectDir, "assets", "pic@2x.png"), PIC_2X);
|
|
fs.writeFileSync(path.join(projectDir, "assets", "brand.ttf"), Buffer.alloc(1024, 3));
|
|
fs.writeFileSync(path.join(projectDir, "assets", "clip.mp4"), Buffer.alloc(1024, 5));
|
|
server = createStudioServer({ projectDir, projectName: "film" });
|
|
});
|
|
|
|
afterEach(() => {
|
|
cleanupStudioServerRoot(server, root);
|
|
});
|
|
|
|
async function fetchAsset(url: string): Promise<Buffer> {
|
|
const response = await server.app.request(`/api/projects/film/preview/${url}`);
|
|
expect(response.status).toBe(200);
|
|
return Buffer.from(await response.arrayBuffer());
|
|
}
|
|
|
|
describe("studio preview document", () => {
|
|
it("keeps every asset URL instead of inlining it as base64", async () => {
|
|
const response = await server.app.request("/api/projects/film/preview");
|
|
const html = await response.text();
|
|
|
|
expect(response.status).toBe(200);
|
|
// Served by the bundler, not the raw-HTML fallback, so the assertions below mean something.
|
|
expect(html).toContain('data-hyperframes-preview-runtime="1" src="/api/runtime.js"');
|
|
expect(html).not.toContain("base64,");
|
|
expect(html.match(/src="assets\/pic\.png"/g)?.length).toBeGreaterThanOrEqual(3);
|
|
expect(html).toContain("url(assets/brand.ttf)");
|
|
expect(html).toContain('poster="assets/pic.png"');
|
|
expect(html).toContain('srcset="assets/pic.png 1x, assets/pic@2x.png 2x"');
|
|
// Kept URLs resolve against the preview's <base href> through the asset route.
|
|
expect(html).toContain('<base href="/api/projects/film/preview/">');
|
|
expect(await fetchAsset("assets/pic.png")).toEqual(PIC);
|
|
const nested = html.match(/<img [^>]*id="nested" src="([^"]+)"/)?.[1];
|
|
expect(nested).toBe("assets/pic%402x.png");
|
|
expect(await fetchAsset(nested ?? "")).toEqual(PIC_2X);
|
|
});
|
|
|
|
it("tags no asset a copy tool just rewrote with its old mtime", async () => {
|
|
const clip = path.join(projectDir, "assets", "clip.mp4");
|
|
fs.writeFileSync(clip, Buffer.alloc(1024, 6));
|
|
const copied = new Date("2026-01-01T00:00:00Z");
|
|
fs.utimesSync(clip, copied, copied);
|
|
|
|
const response = await server.app.request("/api/projects/film/preview/assets/clip.mp4");
|
|
|
|
expect(response.status).toBe(200);
|
|
expect(response.headers.get("ETag")).toBeNull();
|
|
});
|
|
});
|
|
|
|
describe("bundled GSAP", () => {
|
|
const plugin = "/api/vendor/npm/gsap@3.15.0/dist/MotionPathPlugin.min.js";
|
|
|
|
function writeMotionPathComposition(): void {
|
|
fs.writeFileSync(
|
|
path.join(projectDir, "index.html"),
|
|
`<!doctype html>
|
|
<html><head><script src="vendor/gsap.min.js"></script></head>
|
|
<body><div id="root" data-composition-id="main" data-width="320" data-height="180">
|
|
<div id="card"></div>
|
|
<script>gsap.to("#card", { motionPath: { path: [{ x: 10, y: 10 }] } });</script>
|
|
</div></body></html>`,
|
|
);
|
|
}
|
|
|
|
it("serves Studio's GSAP dependencies same-origin instead of from jsDelivr", async () => {
|
|
writeMotionPathComposition();
|
|
expect(server.adapter.gsapLocalRoot).toBe("/api/vendor/npm");
|
|
const html = await (await server.app.request("/api/projects/film/preview")).text();
|
|
expect(html).toContain(`src="${plugin}"`);
|
|
expect(html).toContain('<meta name="hyperframes-gsap-base-url" content="/api/vendor/npm">');
|
|
expect(html).not.toContain("jsdelivr");
|
|
|
|
for (const file of ["gsap.min.js", "CustomEase.min.js", "MotionPathPlugin.min.js"]) {
|
|
const response = await server.app.request(`/api/vendor/npm/gsap@3.15.0/dist/${file}`);
|
|
expect(response.status).toBe(200);
|
|
expect(response.headers.get("Content-Type")).toContain("javascript");
|
|
expect(await response.text()).toMatch(/^\/\*!\n \* \w+ 3\.15\.0/);
|
|
}
|
|
});
|
|
|
|
it.each([
|
|
"/api/vendor/npm/gsap@3.14.2/dist/gsap.min.js",
|
|
"/api/vendor/npm/gsap@3.15.0/dist/package.json",
|
|
"/api/vendor/npm/gsap@3.15.0/dist/..%2Fpackage.json",
|
|
"/api/vendor/npm/react@3.15.0/dist/gsap.min.js",
|
|
])("serves only the bundled GSAP files: %s", async (url) => {
|
|
expect((await server.app.request(url)).status).toBe(404);
|
|
});
|
|
|
|
it("uses HYPERFRAMES_GSAP_BASE_URL over the bundled copy", async () => {
|
|
writeMotionPathComposition();
|
|
const mirror = "https://mirror.example/npm";
|
|
const previous = process.env.HYPERFRAMES_GSAP_BASE_URL;
|
|
process.env.HYPERFRAMES_GSAP_BASE_URL = mirror;
|
|
try {
|
|
server.watcher.close();
|
|
server = createStudioServer({ projectDir, projectName: "film" });
|
|
const html = await (await server.app.request("/api/projects/film/preview")).text();
|
|
expect(html).toContain(`src="${mirror}/gsap@3.15.0/dist/MotionPathPlugin.min.js"`);
|
|
expect(html).not.toContain("/api/vendor/npm");
|
|
} finally {
|
|
if (previous === undefined) delete process.env.HYPERFRAMES_GSAP_BASE_URL;
|
|
else process.env.HYPERFRAMES_GSAP_BASE_URL = previous;
|
|
}
|
|
});
|
|
});
|