Files
hyperframes/packages/cli/src/commands/cloud.ts
T

71 lines
2.9 KiB
TypeScript

/**
* `hyperframes cloud` — top-level dispatcher for cloud-render subverbs.
*
* Each subverb lives in `./cloud/<name>.ts`. The dispatcher loads them
* dynamically so the cloud surface doesn't impact CLI cold-start when
* the user is running `render` / `preview` / etc.
*
* Auth is the existing `cli/src/auth/` chain — `cloud` subverbs call
* into `cloud/auth.ts` which bridges `resolveCredential` +
* `buildAuthHeaders` into the generated client. There is no new
* credentials store and no new env var.
*/
import { defineCommand } from "citty";
import type { Example } from "./_examples.js";
import { c } from "../ui/colors.js";
export const examples: Example[] = [
["Render the current directory in the cloud", "hyperframes cloud render"],
["Render a specific project", "hyperframes cloud render ./my-video"],
["Inspect the project zip without uploading", "hyperframes cloud render --dry-run"],
[
"Render at 60fps + high quality, save to a path",
"hyperframes cloud render ./my-video --fps 60 --quality high -o ./out.mp4",
],
[
"Fire-and-forget with a webhook",
"hyperframes cloud render ./my-video --callback-url https://example.com/hf-hook --no-wait",
],
["Resubmit an already-uploaded zip", "hyperframes cloud render --asset-id asst_abc123"],
[
"Render from a public HTTPS zip",
"hyperframes cloud render --url https://cdn.example.com/site.zip",
],
["List recent cloud renders", "hyperframes cloud list"],
["Fetch one render's status + signed URLs", "hyperframes cloud get hfr_abc123"],
["Soft-delete a render", "hyperframes cloud delete hfr_abc123"],
];
const HELP = `
${c.bold("hyperframes cloud")} ${c.dim("<subcommand> [args]")}
Render HyperFrames compositions on HeyGen's cloud infrastructure. The
project zip is uploaded, the render is dispatched, and the resulting
video is downloaded locally — without spinning up Chrome or ffmpeg
on your machine.
${c.bold("SUBCOMMANDS:")}
${c.accent("render")} ${c.dim("Submit a project (or asset_id / url) and download the result")}
${c.accent("list")} ${c.dim("List recent renders in your account")}
${c.accent("get")} ${c.dim("Fetch one render's status + signed URLs")}
${c.accent("delete")} ${c.dim("Soft-delete a render (GET 404s afterward)")}
${c.bold("AUTH:")}
Uses the credential you signed in with via ${c.accent("hyperframes auth login")}.
Override the API base with ${c.accent("HEYGEN_API_URL")} (default https://api.heygen.com).
`;
export default defineCommand({
meta: { name: "cloud", description: "Render HyperFrames compositions on the HeyGen cloud" },
subCommands: {
render: () => import("./cloud/render.js").then((m) => m.default),
list: () => import("./cloud/list.js").then((m) => m.default),
get: () => import("./cloud/get.js").then((m) => m.default),
delete: () => import("./cloud/delete.js").then((m) => m.default),
},
async run({ args }) {
if (!args._?.[0]) console.log(HELP);
},
});