Skip to content

Write HTML. Render video. Built for agents.

2.9 KB
Raw Blame
/**
 * Boundary tests for the wire config emitted by `hyperframes lambda render`.
 * Pins that the aspect-agnostic resolution flag survives all the way into
 * `SerializableDistributedRenderConfig`, which is what the Lambda worker's
 * compile stage reads before remapping `landscape` → `portrait` for an
 * aspect-agnostic alias like `--output-resolution 1080p`.
 *
 * See `../cloudrun.test.ts` for the parseOutputResolution counterpart and
 * `../render.test.ts` for the local-CLI preflight guardrails.
 */

import { describe, expect, it } from "vitest";
import lambdaCommand from "../lambda.js";
import { buildLambdaRenderConfig, type RenderArgs } from "./render.js";

const BASE_ARGS: RenderArgs = {
  projectDir: "/tmp/hf-project",
  stackName: "hf-test",
  fps: 30,
  width: 1080,
  height: 1920,
  format: "mp4",
  json: false,
  wait: false,
  waitIntervalMs: 5000,
};

describe("buildLambdaRenderConfig — aspect-agnostic wire threading", () => {
  it("threads outputResolutionAspectAgnostic=true through for portrait 1080p", () => {
    // The exact bug shape: portrait 1080×1920 comp + `--output-resolution 1080p`.
    // Before the fix, the aspect-agnostic flag never reached the wire, so
    // the Lambda worker saw the explicit `landscape` preset and rejected
    // the portrait comp — reproducing the local-CLI regression on the
    // distributed path.
    const config = buildLambdaRenderConfig(
      { ...BASE_ARGS, outputResolution: "landscape", outputResolutionAspectAgnostic: true },
      undefined,
    );
    expect(config.outputResolution).toBe("landscape");
    expect(config.outputResolutionAspectAgnostic).toBe(true);
  });

  it("keeps the aspect-agnostic key absent when the flag is a canonical preset", () => {
    // Sparse-wire invariant: only forward `true`; canonical presets stay
    // strict and don't need the compile-stage remap.
    const config = buildLambdaRenderConfig(
      { ...BASE_ARGS, outputResolution: "portrait-4k" },
      undefined,
    );
    expect(config.outputResolution).toBe("portrait-4k");
    expect(config.outputResolutionAspectAgnostic).toBeUndefined();
  });

  it("carries variables verbatim through the wire config", () => {
    const config = buildLambdaRenderConfig(BASE_ARGS, { alice: "hello" });
    expect(config.variables).toEqual({ alice: "hello" });
  });
});

describe("lambda render chunk sizing", () => {
  it("hands the deploy's reserved concurrency to the planner", () => {
    expect(buildLambdaRenderConfig(BASE_ARGS, undefined, 64).workerConcurrency).toBe(64);
    expect(buildLambdaRenderConfig(BASE_ARGS, undefined).workerConcurrency).toBeUndefined();
  });

  it("help no longer claims --chunk-size defaults to 240", () => {
    const chunkSizeArg = lambdaCommand.args
      ? Reflect.get(lambdaCommand.args, "chunk-size")
      : undefined;
    expect(chunkSizeArg?.description).not.toContain("240");
    expect(chunkSizeArg?.description).toContain("timeout");
  });
});