).rejects.toThrow(/invalid canvas\.snapshot payload/i);

expect(writtenFiles).toHaveLength(0);

});

it("rejects unsupported snapshot formats before invoking the node", async () => {

const program = new Command();

program.exitOverride();

const nodes = program.command("nodes");

const { deps, writtenFiles } = createCanvasCliDeps();

registerNodesCanvasCommands(nodes, deps);

await expect(

program.parseAsync(["nodes", "canvas", "snapshot", "--node", "ios-node", "--format", "gif"], {

from: "user",

}),

).rejects.toThrow(/invalid format: gif/i);

expect(deps.callGatewayCli).not.toHaveBeenCalled();

expect(writtenFiles).toHaveLength(0);

});

});

};

type CanvasNodeCandidate = NodeMatchCandidate;

type CanvasSnapshotRequestFormat = "png" | "jpeg";

function parseCanvasSnapshotRequestFormat(raw: unknown): CanvasSnapshotRequestFormat {

const format = normalizeLowercaseStringOrEmpty(normalizeOptionalString(raw) ?? "jpg");

switch (format) {

case "png":

return "png";

case "jpg":

case "jpeg":

return "jpeg";

default:

throw new Error(`invalid format: ${String(raw)} (expected png|jpg|jpeg)`);

}

}

function parseTimeoutMs(raw: unknown): number | undefined {

if (raw === undefined || raw === null) {

.option("--invoke-timeout <ms>", "Node invoke timeout in ms (default 20000)", "20000")

.action(async (opts: CanvasNodesRpcOpts) => {

await deps.runNodesCommand("canvas snapshot", async () => {

const formatOpt = normalizeLowercaseStringOrEmpty(

normalizeOptionalString(opts.format) ?? "jpg",

);

const formatForParams =

formatOpt === "jpg" ? "jpeg" : formatOpt === "jpeg" ? "jpeg" : "png";

if (formatForParams !== "png" && formatForParams !== "jpeg") {

throw new Error(`invalid format: ${String(opts.format)} (expected png|jpg|jpeg)`);

}

const format = parseCanvasSnapshotRequestFormat(opts.format);

const maxWidth = opts.maxWidth ? Number.parseInt(opts.maxWidth, 10) : undefined;

const quality = opts.quality ? Number.parseFloat(opts.quality) : undefined;

const raw = await invokeCanvas(deps, opts, "canvas.snapshot", {

format: formatForParams,

format,

maxWidth: Number.isFinite(maxWidth) ? maxWidth : undefined,

quality: Number.isFinite(quality) ? quality : undefined,

});