Write HTML. Render video. Built for agents.
JavaScript aiai-agentsanimationclaude-codeffmpegframeworkgsaphtmlhtml-to-videomcpmotion-graphicspuppeteerrenderingtypescriptvideo-editor
import { cloneCaptureWarnings } from "@hyperframes/engine";
import type { ProducerLogger } from "../../logger.js";
import type { ProgressCallback, RenderJob } from "../renderOrchestrator.js";
import { updateJobStatus } from "./shared.js";
function snapshotJob(job: RenderJob): RenderJob {
return {
...job,
warnings: cloneCaptureWarnings(job.warnings),
};
}
/** Serializes progress delivery and contains sink failures at the boundary. */
export class OrderedRenderEventPublisher {
private tail: Promise<void> = Promise.resolve();
constructor(
private readonly sink: ProgressCallback | undefined,
private readonly log: ProducerLogger,
) {}
publish(job: RenderJob, message: string): void {
if (!this.sink) return;
const snapshot = snapshotJob(job);
this.tail = this.tail
.then(() => this.sink?.(snapshot, message))
.then(() => undefined)
.catch((error: unknown) => {
try {
this.log.warn("Render event sink rejected an update", {
status: snapshot.status,
progress: snapshot.progress,
error: error instanceof Error ? error.message : String(error),
});
} catch {
// A broken logger must not reopen the contained sink failure.
}
});
}
async flush(): Promise<void> {
await this.tail;
}
}
type StructuredRenderFailure = {
error: string;
failedStage: string;
errorDetails: NonNullable<RenderJob["errorDetails"]>;
};
/** Populates the complete failure contract before publishing its immutable terminal snapshot. */
export function publishRenderFailure(
job: RenderJob,
failure: StructuredRenderFailure,
onProgress?: ProgressCallback,
): void {
job.error = failure.error;
job.failedStage = failure.failedStage;
job.errorDetails = failure.errorDetails;
updateJobStatus(job, "failed", `Failed: ${failure.error}`, job.progress, onProgress);
}