Skip to content

Write HTML. Render video. Built for agents.

1.8 KB
Raw Blame
import { describe, expect, it, vi } from "vitest";
import {
  acceptStudioRuntimeMessage,
  acceptedRuntimeMessageFps,
  createRuntimeControlMessage,
  inspectStudioRuntimeMessage,
  postRuntimeControlMessage,
} from "./runtimeProtocol";

describe("Studio runtime protocol", () => {
  it("versions every control message and declares rational fps", () => {
    expect(createRuntimeControlMessage("seek", { timeSeconds: 1.25 }, 60)).toEqual({
      source: "hf-parent",
      type: "control",
      action: "seek",
      protocolVersion: 1,
      capabilities: [
        "seconds-time",
        "rational-fps",
        "seek-keep-playing",
        "composition-manifest-v1",
        "runtime-data",
        "play-range",
      ],
      fps: { numerator: 60, denominator: 1 },
      timeSeconds: 1.25,
    });
  });

  it("posts the typed message to the target window", () => {
    const target = { postMessage: vi.fn() };
    postRuntimeControlMessage(target as unknown as Window, "pause");
    expect(target.postMessage).toHaveBeenCalledWith(
      expect.objectContaining({ action: "pause", protocolVersion: 1 }),
      "*",
    );
  });

  it("preserves legacy 30fps messages and rejects unknown majors", () => {
    expect(inspectStudioRuntimeMessage({ source: "hf-preview" })).toEqual({
      status: "legacy",
      fps: 30,
    });
    expect(inspectStudioRuntimeMessage({ protocolVersion: 2 })).toMatchObject({
      status: "unsupported",
      code: "unsupported_protocol_version",
    });
  });

  it("reads explicit fps for accepted timeline messages", () => {
    const message = createRuntimeControlMessage("pause", {}, 60);
    expect(acceptedRuntimeMessageFps(message)).toBe(60);
    expect(acceptStudioRuntimeMessage(message)).toMatchObject({ status: "supported", fps: 60 });
  });
});