Skip to content

Write HTML. Render video. Built for agents.

1.1 KB
Raw Blame
import { normalizeErrorMessage } from "./errorMessage.js";

export const DOCKER_BUILD_TIMEOUT_MINUTES = 10;

interface DockerBuildFailure {
  title: string;
  message: string;
  hint: string;
}

function isSpawnTimeout(error: unknown): boolean {
  return error instanceof Error && "code" in error && error.code === "ETIMEDOUT";
}

export function describeDockerBuildFailure(error: unknown): DockerBuildFailure {
  if (error instanceof Error && isSpawnTimeout(error.cause)) {
    return {
      title: "Docker image build timed out",
      message: `Building the render image took longer than ${DOCKER_BUILD_TIMEOUT_MINUTES} minutes, so it was stopped.`,
      hint: "Run the same command again. Docker keeps the layers it already built, so the build picks up where it stopped.",
    };
  }
  const message = normalizeErrorMessage(error);
  if (/connect|not found|ENOENT/i.test(message)) {
    return {
      title: "Docker not available",
      message,
      hint: "Install Docker: https://docs.docker.com/get-docker/",
    };
  }
  return {
    title: "Docker image build failed",
    message,
    hint: "Check Docker is running: docker info",
  };
}