mirror of
https://github.com/heygen-com/hyperframes.git
synced 2026-11-18 16:08:56 +00:00
71 lines
2.9 KiB
TypeScript
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);
|
|
},
|
|
});
|