@koda-sl/baker-cli 0.442.0 → 0.443.0-dev.043c1d4ac

package/dist/download-7T6HIJKD.js

@@ -0,0 +1,299 @@
+import {
+  atomicWrite,
+  isDirectory,
+  isRemoteUrl
+} from "./chunk-PBA3YCZA.js";
+import {
+  MAX_REMOTE_IMAGE_BYTES,
+  fetchExternalBytes
+} from "./chunk-YBMVHGY3.js";
+import {
+  ApiError,
+  apiGet,
+  validateConvexId
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import "./chunk-NAWWC5I3.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/download.ts
+import { defineCommand } from "citty";
+
+// src/commands/images/downloadPaths.ts
+import { basename, extname, join } from "path";
+var CONTENT_TYPE_EXTENSIONS = {
+  "image/webp": ".webp",
+  "image/png": ".png",
+  "image/jpeg": ".jpg",
+  "image/jpg": ".jpg",
+  "image/gif": ".gif",
+  "image/svg+xml": ".svg",
+  "image/avif": ".avif",
+  "image/bmp": ".bmp",
+  "image/tiff": ".tiff",
+  "image/x-icon": ".ico",
+  "image/vnd.microsoft.icon": ".ico"
+};
+var KNOWN_EXTENSIONS = /* @__PURE__ */ new Set([".webp", ".png", ".jpg", ".jpeg", ".gif", ".svg", ".avif", ".bmp", ".tiff", ".ico"]);
+function urlPath(sourceUrl) {
+  try {
+    return new URL(sourceUrl).pathname;
+  } catch {
+    return sourceUrl.split(/[?#]/)[0] ?? "";
+  }
+}
+function extensionFromUrl(sourceUrl) {
+  const ext = extname(urlPath(sourceUrl)).toLowerCase();
+  return KNOWN_EXTENSIONS.has(ext) ? ext : null;
+}
+function deriveExtension(contentType, sourceUrl) {
+  const normalized = (contentType ?? "").split(";")[0]?.trim().toLowerCase() ?? "";
+  const fromType = CONTENT_TYPE_EXTENSIONS[normalized];
+  if (fromType) {
+    return fromType;
+  }
+  return extensionFromUrl(sourceUrl) ?? ".bin";
+}
+function looksLikeCdnHash(stem) {
+  return stem.length >= 32 && !/[-_.]/.test(stem);
+}
+function hostLabel(sourceUrl) {
+  try {
+    const host = new URL(sourceUrl).hostname.replace(/^www\./, "");
+    const label = host.split(".").filter((part) => part !== "cdn" && part !== "images")[0];
+    return label && /^[a-z0-9-]+$/.test(label) ? label : null;
+  } catch {
+    return null;
+  }
+}
+function sanitizeBaseName(raw) {
+  const stem = raw.trim().toLowerCase().replace(/\.[a-z0-9]{1,5}$/i, "").replace(/[^a-z0-9._-]+/g, "-").replace(/^[-.]+|[-.]+$/g, "").slice(0, 80);
+  return stem.length > 0 ? stem : "image";
+}
+function baseNameFromUrl(sourceUrl) {
+  const stem = sanitizeBaseName(basename(urlPath(sourceUrl)));
+  if (looksLikeCdnHash(stem)) {
+    const label = hostLabel(sourceUrl);
+    if (label) return `${label}-${stem.slice(0, 8)}`;
+  }
+  return stem;
+}
+function resolveDownloadPath({ baseName, extension, out, outIsDirectory: outIsDirectory2 }) {
+  const filename = `${baseName}${extension}`;
+  if (!out) {
+    return filename;
+  }
+  if (outIsDirectory2) {
+    return join(out, filename);
+  }
+  return out;
+}
+function disambiguate(paths) {
+  const taken = /* @__PURE__ */ new Set();
+  return paths.map((path) => {
+    if (!taken.has(path)) {
+      taken.add(path);
+      return path;
+    }
+    const ext = extname(path);
+    const stem = path.slice(0, path.length - ext.length);
+    let n = 2;
+    while (taken.has(`${stem}-${n}${ext}`)) n += 1;
+    const unique = `${stem}-${n}${ext}`;
+    taken.add(unique);
+    return unique;
+  });
+}
+
+// src/commands/images/download.ts
+registerSchema({
+  command: "images.download",
+  description: "Download remote images or library images to local files, so the local transforms (normalize, crop, dimensions) can read them.",
+  args: {
+    targets: {
+      type: "string",
+      description: "One or more image URLs and/or library image ids, space- or comma-separated (e.g. 'https://\u2026/logo.webp j57abc123').",
+      required: true
+    },
+    out: {
+      type: "string",
+      description: "Output directory (must exist) or, with a single target, an exact file path. Default: the working directory.",
+      required: false
+    }
+  }
+});
+var ValidationError = class extends Error {
+};
+var UnusableTargetError = class extends Error {
+  constructor(target) {
+    super(`"${target}" is neither an image URL nor a library image id.`);
+    this.target = target;
+  }
+};
+function readTargets(args) {
+  const positionals = Array.isArray(args._) ? args._ : [];
+  const named = typeof args.targets === "string" ? [args.targets] : [];
+  const all = positionals.length > 0 ? positionals : named;
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const value of all) {
+    if (typeof value !== "string") continue;
+    for (const part of value.split(",").map((p) => p.trim())) {
+      if (part.length > 0 && !seen.has(part)) {
+        seen.add(part);
+        out.push(part);
+      }
+    }
+  }
+  return out;
+}
+function classify(raw) {
+  if (isRemoteUrl(raw)) {
+    return { raw, kind: "url" };
+  }
+  try {
+    validateConvexId(raw);
+  } catch {
+    throw new UnusableTargetError(raw);
+  }
+  return { raw, kind: "imageId" };
+}
+async function resolveTarget(target) {
+  if (target.kind === "url") {
+    return { input: target.raw, url: target.raw, baseName: baseNameFromUrl(target.raw) };
+  }
+  const doc = await apiGet("/api/images/get", { id: target.raw });
+  const stem = sanitizeBaseName(doc.name.length > 0 ? doc.name : target.raw);
+  return { input: target.raw, url: doc.imageUrl, baseName: stem };
+}
+async function fetchBytes(url) {
+  return await fetchExternalBytes(url, { maxBytes: MAX_REMOTE_IMAGE_BYTES });
+}
+var NEXT_STEP_HINT = "Downloaded files are local paths \u2014 the local transforms take them directly: `baker images normalize <file> --color '#FFFFFF' --height 40`, `baker images crop <file> --x \u2026 --y \u2026 --width \u2026 --height \u2026`, `baker images dimensions <file>`. For a landing, page-scoped images belong in `src/pages/{landing}/_images/`.";
+var PARTIAL_FAILURE_HINT = "Some targets did not download. Carry on with the ones that did \u2014 a missing asset never blocks the rest of the job. Retry a failed URL only if it was a transient 5xx; a 403 means the host will not serve these bytes to anyone but a browser, so re-source it (`baker images extract <page>`) instead.";
+var ALL_FAILED_FIX = {
+  action: "use_different_resource",
+  explanation: "None of the targets could be downloaded. A 403/404 means the host will not serve these bytes \u2014 re-source the asset (`baker images extract <page-url>`, `baker images stock <query>`) or, for a library image, check the row is `ready` with `baker images get <id>`. Do not retry the same URLs in a loop, and do not fall back to `curl` \u2014 continue the job with a placeholder if nothing can be fetched."
+};
+async function outIsDirectory(out) {
+  if (!out) return false;
+  return out.endsWith("/") || await isDirectory(out);
+}
+async function buildPlan(args) {
+  const raw = readTargets(args);
+  if (raw.length === 0) {
+    throw new ValidationError("At least one image URL or library image id is required.");
+  }
+  const targets = raw.map(classify);
+  const out = typeof args.out === "string" && args.out.length > 0 ? args.out : void 0;
+  const outIsDir = await outIsDirectory(out);
+  if (out && !outIsDir && targets.length > 1) {
+    throw new ValidationError(
+      `--out must be an existing directory when downloading more than one image (got "${out}").`
+    );
+  }
+  return { targets, out, outIsDir };
+}
+function failureMessage(err, fallback) {
+  return err instanceof Error ? err.message : fallback;
+}
+async function runDownloads(plan) {
+  const failed = [];
+  const fetched = [];
+  for (const target of plan.targets) {
+    try {
+      const resolved = await resolveTarget(target);
+      const { buffer, contentType } = await fetchBytes(resolved.url);
+      fetched.push({
+        input: resolved.input,
+        buffer,
+        contentType,
+        path: resolveDownloadPath({
+          baseName: resolved.baseName,
+          extension: deriveExtension(contentType, resolved.url),
+          out: plan.out,
+          outIsDirectory: plan.outIsDir
+        })
+      });
+    } catch (err) {
+      failed.push({ input: target.raw, error: failureMessage(err, "Download failed") });
+    }
+  }
+  const paths = disambiguate(fetched.map((item) => item.path));
+  const downloaded = [];
+  for (const [index, item] of fetched.entries()) {
+    const path = paths[index] ?? item.path;
+    try {
+      await atomicWrite(path, item.buffer);
+      downloaded.push({ input: item.input, output: path, bytes: item.buffer.length, contentType: item.contentType });
+    } catch (err) {
+      failed.push({ input: item.input, error: failureMessage(err, "Write failed") });
+    }
+  }
+  return { downloaded, failed };
+}
+function emitError(err) {
+  if (err instanceof UnusableTargetError) {
+    writeJson({
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: err.message,
+        fix: {
+          action: "retry_with_changes",
+          explanation: "`download` takes remote image URLs (https://\u2026) and library image ids. A path that is already on disk needs no download \u2014 pass it straight to `baker images normalize` / `crop` / `dimensions`. To get a library id, run `baker images library <query>` and read `_id`."
+        }
+      }
+    });
+    process.exit(1);
+  }
+  if (err instanceof ValidationError) {
+    writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: err.message } });
+    process.exit(1);
+  }
+  if (err instanceof ApiError) {
+    writeJson({ ok: false, error: { code: err.code, message: err.message } });
+    process.exit(1);
+  }
+  writeJson({ ok: false, error: { code: "INTERNAL_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+var downloadCommand = defineCommand({
+  meta: {
+    name: "download",
+    description: "Download image URLs and/or library images to local files \u2014 the missing first half of `source \u2192 download \u2192 normalize \u2192 place`. Never use `curl` for this.\n\nExamples:\n  baker images download https://media.withbaker.com/\u2026/logo.webp\n  baker images download j57abc123 j57def456 --out src/pages/pricing/_images/\n  baker images download https://\u2026/hero.png --out ./hero.png"
+  },
+  args: {
+    targets: { type: "positional", description: "Image URLs and/or library image ids", required: false },
+    out: { type: "string", description: "Output directory (must exist), or exact file path for a single target" }
+  },
+  run: async ({ args }) => {
+    try {
+      const plan = await buildPlan(args);
+      const { downloaded, failed } = await runDownloads(plan);
+      if (downloaded.length === 0) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "DOWNLOAD_FAILED",
+            message: `None of the ${plan.targets.length} target(s) could be downloaded: ${failed.map((f) => `${f.input} (${f.error})`).join("; ")}`,
+            fix: ALL_FAILED_FIX
+          }
+        });
+        process.exit(1);
+      }
+      const hints = [NEXT_STEP_HINT, ...failed.length > 0 ? [PARTIAL_FAILURE_HINT] : []];
+      writeJson({ ok: true, data: { downloaded, failed }, hints });
+    } catch (err) {
+      emitError(err);
+    }
+  }
+});
+export {
+  downloadCommand
+};
+//# sourceMappingURL=download-7T6HIJKD.js.map

package/dist/download-7T6HIJKD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/images/download.ts","../src/commands/images/downloadPaths.ts"],"sourcesContent":["import type { ImagesGetResponse } from \"@baker/api\";\nimport { defineCommand } from \"citty\";\nimport { ApiError, apiGet, validateConvexId } from \"../../client.ts\";\nimport { fetchExternalBytes, MAX_REMOTE_IMAGE_BYTES } from \"../../lib/externalFetch.ts\";\nimport { atomicWrite, isDirectory, isRemoteUrl } from \"../../lib/image/io.ts\";\nimport { writeJson } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport {\n  baseNameFromUrl,\n  deriveExtension,\n  disambiguate,\n  resolveDownloadPath,\n  sanitizeBaseName,\n} from \"./downloadPaths.ts\";\n\n/**\n * Remote asset → local file.\n *\n * The docs have always described the pipeline as `source → download → normalize\n * → place` and told the agent \"local files only — download remote assets\n * first\", while no download command existed: `normalize` refuses URLs and takes\n * no library ids, and the only URL→disk writer was `crop`, which demands\n * rectangle coordinates. Agents filled the hole with `curl`, hand-assembling\n * media URLs out of JSON responses.\n *\n * Local-only by design, like `normalize` / `crop` / `dimensions` — the bytes go\n * to the sandbox, not through the backend. Library ids resolve through the\n * existing `GET /api/images/get` route, so no new backend surface is needed.\n */\n\nregisterSchema({\n  command: \"images.download\",\n  description:\n    \"Download remote images or library images to local files, so the local transforms (normalize, crop, dimensions) can read them.\",\n  args: {\n    targets: {\n      type: \"string\",\n      description:\n        \"One or more image URLs and/or library image ids, space- or comma-separated (e.g. 'https://…/logo.webp j57abc123').\",\n      required: true,\n    },\n    out: {\n      type: \"string\",\n      description:\n        \"Output directory (must exist) or, with a single target, an exact file path. Default: the working directory.\",\n      required: false,\n    },\n  },\n});\n\ninterface Target {\n  raw: string;\n  kind: \"url\" | \"imageId\";\n}\n\ninterface Downloaded {\n  input: string;\n  output: string;\n  bytes: number;\n  contentType: string | null;\n}\n\ninterface FailedDownload {\n  input: string;\n  error: string;\n}\n\nclass ValidationError extends Error {}\n\n/** A target that is neither a URL nor a library id — usually a local path,\n * which needs no download at all. */\nclass UnusableTargetError extends Error {\n  constructor(readonly target: string) {\n    super(`\"${target}\" is neither an image URL nor a library image id.`);\n  }\n}\n\n/** Every positional, each of which may itself be a comma-separated list. */\nfunction readTargets(args: Record<string, unknown>): string[] {\n  const positionals = Array.isArray(args._) ? args._ : [];\n  const named = typeof args.targets === \"string\" ? [args.targets] : [];\n  const all = positionals.length > 0 ? positionals : named;\n  const seen = new Set<string>();\n  const out: string[] = [];\n  for (const value of all) {\n    if (typeof value !== \"string\") continue;\n    for (const part of value.split(\",\").map((p) => p.trim())) {\n      if (part.length > 0 && !seen.has(part)) {\n        seen.add(part);\n        out.push(part);\n      }\n    }\n  }\n  return out;\n}\n\n/** A target is a URL or a library id — nothing else resolves to bytes. */\nfunction classify(raw: string): Target {\n  if (isRemoteUrl(raw)) {\n    return { raw, kind: \"url\" };\n  }\n  try {\n    validateConvexId(raw);\n  } catch {\n    throw new UnusableTargetError(raw);\n  }\n  return { raw, kind: \"imageId\" };\n}\n\ninterface Resolved {\n  input: string;\n  url: string;\n  baseName: string;\n}\n\n/** Turn a target into a fetchable URL plus the stem to name its file after. */\nasync function resolveTarget(target: Target): Promise<Resolved> {\n  if (target.kind === \"url\") {\n    return { input: target.raw, url: target.raw, baseName: baseNameFromUrl(target.raw) };\n  }\n  const doc = await apiGet<ImagesGetResponse>(\"/api/images/get\", { id: target.raw });\n  // The library row's own name is what the agent searched for; fall back to the\n  // id so a nameless row still writes a file it can find again.\n  const stem = sanitizeBaseName(doc.name.length > 0 ? doc.name : target.raw);\n  return { input: target.raw, url: doc.imageUrl, baseName: stem };\n}\n\nasync function fetchBytes(url: string): Promise<{ buffer: Buffer; contentType: string | null }> {\n  // These URLs come straight from agent argv, so the ceiling is not a formality:\n  // nothing upstream has looked at where they point or how big they are.\n  return await fetchExternalBytes(url, { maxBytes: MAX_REMOTE_IMAGE_BYTES });\n}\n\nconst NEXT_STEP_HINT =\n  \"Downloaded files are local paths — the local transforms take them directly: `baker images normalize <file> --color '#FFFFFF' --height 40`, `baker images crop <file> --x … --y … --width … --height …`, `baker images dimensions <file>`. For a landing, page-scoped images belong in `src/pages/{landing}/_images/`.\";\n\n// These two used to explain a 403 as \"the host refuses datacenter IPs, so\n// re-source it\". That was an accurate diagnosis and is now a stale instruction:\n// a refusal is retried from a different exit before this command ever reports\n// one, so a 403 that survives to here has already been answered from more than\n// one address and will not yield to another attempt. The advice is unchanged —\n// move on — but the reason is now \"this host will not serve us\", not \"try\n// somewhere our address is welcome\". Neither string may mention how that was\n// established; the agent has no proxy to reason about and no decision to make\n// about one.\nconst PARTIAL_FAILURE_HINT =\n  \"Some targets did not download. Carry on with the ones that did — a missing asset never blocks the rest of the job. Retry a failed URL only if it was a transient 5xx; a 403 means the host will not serve these bytes to anyone but a browser, so re-source it (`baker images extract <page>`) instead.\";\n\nconst ALL_FAILED_FIX = {\n  action: \"use_different_resource\",\n  explanation:\n    \"None of the targets could be downloaded. A 403/404 means the host will not serve these bytes — re-source the asset (`baker images extract <page-url>`, `baker images stock <query>`) or, for a library image, check the row is `ready` with `baker images get <id>`. Do not retry the same URLs in a loop, and do not fall back to `curl` — continue the job with a placeholder if nothing can be fetched.\",\n};\n\n/** Resolve `--out` once: an existing directory, or a trailing slash meaning one. */\nasync function outIsDirectory(out: string | undefined): Promise<boolean> {\n  if (!out) return false;\n  return out.endsWith(\"/\") || (await isDirectory(out));\n}\n\ninterface DownloadPlan {\n  targets: Target[];\n  out: string | undefined;\n  outIsDir: boolean;\n}\n\nasync function buildPlan(args: Record<string, unknown>): Promise<DownloadPlan> {\n  const raw = readTargets(args);\n  if (raw.length === 0) {\n    throw new ValidationError(\"At least one image URL or library image id is required.\");\n  }\n  const targets = raw.map(classify);\n  const out = typeof args.out === \"string\" && args.out.length > 0 ? args.out : undefined;\n  const outIsDir = await outIsDirectory(out);\n  if (out && !outIsDir && targets.length > 1) {\n    throw new ValidationError(\n      `--out must be an existing directory when downloading more than one image (got \"${out}\").`,\n    );\n  }\n  return { targets, out, outIsDir };\n}\n\ninterface FetchedTarget {\n  input: string;\n  buffer: Buffer;\n  contentType: string | null;\n  path: string;\n}\n\nfunction failureMessage(err: unknown, fallback: string): string {\n  return err instanceof Error ? err.message : fallback;\n}\n\n/**\n * Fetch every target, keeping going past a failure: one unreachable host must\n * not cost the agent the other five assets. Paths are resolved for the whole\n * batch before any write, so collisions can be renamed rather than overwritten.\n */\nasync function runDownloads(plan: DownloadPlan): Promise<{ downloaded: Downloaded[]; failed: FailedDownload[] }> {\n  const failed: FailedDownload[] = [];\n  const fetched: FetchedTarget[] = [];\n\n  for (const target of plan.targets) {\n    try {\n      const resolved = await resolveTarget(target);\n      const { buffer, contentType } = await fetchBytes(resolved.url);\n      fetched.push({\n        input: resolved.input,\n        buffer,\n        contentType,\n        path: resolveDownloadPath({\n          baseName: resolved.baseName,\n          extension: deriveExtension(contentType, resolved.url),\n          out: plan.out,\n          outIsDirectory: plan.outIsDir,\n        }),\n      });\n    } catch (err) {\n      failed.push({ input: target.raw, error: failureMessage(err, \"Download failed\") });\n    }\n  }\n\n  const paths = disambiguate(fetched.map((item) => item.path));\n  const downloaded: Downloaded[] = [];\n  for (const [index, item] of fetched.entries()) {\n    const path = paths[index] ?? item.path;\n    try {\n      await atomicWrite(path, item.buffer);\n      downloaded.push({ input: item.input, output: path, bytes: item.buffer.length, contentType: item.contentType });\n    } catch (err) {\n      failed.push({ input: item.input, error: failureMessage(err, \"Write failed\") });\n    }\n  }\n  return { downloaded, failed };\n}\n\nfunction emitError(err: unknown): never {\n  if (err instanceof UnusableTargetError) {\n    writeJson({\n      ok: false,\n      error: {\n        code: \"VALIDATION_ERROR\",\n        message: err.message,\n        fix: {\n          action: \"retry_with_changes\",\n          explanation:\n            \"`download` takes remote image URLs (https://…) and library image ids. A path that is already on disk needs no download — pass it straight to `baker images normalize` / `crop` / `dimensions`. To get a library id, run `baker images library <query>` and read `_id`.\",\n        },\n      },\n    });\n    process.exit(1);\n  }\n  if (err instanceof ValidationError) {\n    writeJson({ ok: false, error: { code: \"VALIDATION_ERROR\", message: err.message } });\n    process.exit(1);\n  }\n  if (err instanceof ApiError) {\n    writeJson({ ok: false, error: { code: err.code, message: err.message } });\n    process.exit(1);\n  }\n  writeJson({ ok: false, error: { code: \"INTERNAL_ERROR\", message: \"Unexpected error\" } });\n  process.exit(1);\n}\n\nexport const downloadCommand = defineCommand({\n  meta: {\n    name: \"download\",\n    description:\n      \"Download image URLs and/or library images to local files — the missing first half of `source → download → normalize → place`. Never use `curl` for this.\\n\\nExamples:\\n  baker images download https://media.withbaker.com/…/logo.webp\\n  baker images download j57abc123 j57def456 --out src/pages/pricing/_images/\\n  baker images download https://…/hero.png --out ./hero.png\",\n  },\n  args: {\n    targets: { type: \"positional\", description: \"Image URLs and/or library image ids\", required: false },\n    out: { type: \"string\", description: \"Output directory (must exist), or exact file path for a single target\" },\n  },\n  run: async ({ args }) => {\n    try {\n      const plan = await buildPlan(args as Record<string, unknown>);\n      const { downloaded, failed } = await runDownloads(plan);\n\n      if (downloaded.length === 0) {\n        writeJson({\n          ok: false,\n          error: {\n            code: \"DOWNLOAD_FAILED\",\n            message: `None of the ${plan.targets.length} target(s) could be downloaded: ${failed\n              .map((f) => `${f.input} (${f.error})`)\n              .join(\"; \")}`,\n            fix: ALL_FAILED_FIX,\n          },\n        });\n        process.exit(1);\n      }\n\n      const hints = [NEXT_STEP_HINT, ...(failed.length > 0 ? [PARTIAL_FAILURE_HINT] : [])];\n      writeJson({ ok: true, data: { downloaded, failed }, hints });\n    } catch (err) {\n      emitError(err);\n    }\n  },\n});\n","/**\n * Where a downloaded asset lands, and what it is called.\n *\n * Split out from the command so the naming rules are testable without a\n * network or a filesystem — the part that decides whether `normalize` can read\n * the file back is the extension, and deriving it from the URL alone is how\n * a `.png` URL serving webp bytes ends up misnamed.\n */\n\nimport { basename, extname, join } from \"node:path\";\n\nconst CONTENT_TYPE_EXTENSIONS: Record<string, string> = {\n  \"image/webp\": \".webp\",\n  \"image/png\": \".png\",\n  \"image/jpeg\": \".jpg\",\n  \"image/jpg\": \".jpg\",\n  \"image/gif\": \".gif\",\n  \"image/svg+xml\": \".svg\",\n  \"image/avif\": \".avif\",\n  \"image/bmp\": \".bmp\",\n  \"image/tiff\": \".tiff\",\n  \"image/x-icon\": \".ico\",\n  \"image/vnd.microsoft.icon\": \".ico\",\n};\n\nconst KNOWN_EXTENSIONS = new Set([\".webp\", \".png\", \".jpg\", \".jpeg\", \".gif\", \".svg\", \".avif\", \".bmp\", \".tiff\", \".ico\"]);\n\n/** The path portion of a URL, with the host and query removed. A bare host must\n * not leak into a filename — `https://media.withbaker.com/` names no file. */\nfunction urlPath(sourceUrl: string): string {\n  try {\n    return new URL(sourceUrl).pathname;\n  } catch {\n    return sourceUrl.split(/[?#]/)[0] ?? \"\";\n  }\n}\n\n/** The URL's own path extension, when it names an image format we recognise. */\nfunction extensionFromUrl(sourceUrl: string): string | null {\n  const ext = extname(urlPath(sourceUrl)).toLowerCase();\n  return KNOWN_EXTENSIONS.has(ext) ? ext : null;\n}\n\n/**\n * The extension to write under. The served `Content-Type` wins: Baker's media\n * host routinely serves webp from a `.png` URL, and a file named for the URL\n * would then lie to every local tool that reads it back.\n */\nexport function deriveExtension(contentType: string | null | undefined, sourceUrl: string): string {\n  const normalized = (contentType ?? \"\").split(\";\")[0]?.trim().toLowerCase() ?? \"\";\n  const fromType = CONTENT_TYPE_EXTENSIONS[normalized];\n  if (fromType) {\n    return fromType;\n  }\n  return extensionFromUrl(sourceUrl) ?? \".bin\";\n}\n\n/**\n * A stem long enough and featureless enough to be a CDN hash rather than a name.\n *\n * Pixabay serves every file under one — an 80-character token with no word\n * breaks — so a downloaded illustration landed in a client's `_images/` as\n * `g030ff139944c078854d52b34eb635c9f5...png`, and that name then goes in the\n * page's `src` and into their repo. Pexels' `pexels-photo-11982694` has word\n * breaks and is left alone.\n */\nfunction looksLikeCdnHash(stem: string): boolean {\n  return stem.length >= 32 && !/[-_.]/.test(stem);\n}\n\n/** The site a URL belongs to, as a short word usable in a filename. */\nfunction hostLabel(sourceUrl: string): string | null {\n  try {\n    const host = new URL(sourceUrl).hostname.replace(/^www\\./, \"\");\n    const label = host.split(\".\").filter((part) => part !== \"cdn\" && part !== \"images\")[0];\n    return label && /^[a-z0-9-]+$/.test(label) ? label : null;\n  } catch {\n    return null;\n  }\n}\n\n/** A filesystem-safe stem, with no extension. */\nexport function sanitizeBaseName(raw: string): string {\n  const stem = raw\n    .trim()\n    .toLowerCase()\n    .replace(/\\.[a-z0-9]{1,5}$/i, \"\")\n    .replace(/[^a-z0-9._-]+/g, \"-\")\n    .replace(/^[-.]+|[-.]+$/g, \"\")\n    .slice(0, 80);\n  return stem.length > 0 ? stem : \"image\";\n}\n\n/**\n * The stem for a remote URL: its last path segment, or `image`. A segment that\n * is only a CDN hash is replaced by the site it came from plus a short prefix of\n * the hash, which stays unique between two files from the same site while being\n * readable in a page's markup.\n */\nexport function baseNameFromUrl(sourceUrl: string): string {\n  const stem = sanitizeBaseName(basename(urlPath(sourceUrl)));\n  if (looksLikeCdnHash(stem)) {\n    const label = hostLabel(sourceUrl);\n    if (label) return `${label}-${stem.slice(0, 8)}`;\n  }\n  return stem;\n}\n\ninterface DownloadPathInput {\n  baseName: string;\n  extension: string;\n  /** `--out`, as given. */\n  out?: string;\n  /** Whether `--out` resolved to an existing directory (or is written as one). */\n  outIsDirectory: boolean;\n}\n\n/**\n * `--out` naming a directory keeps the derived filename; `--out` naming a file\n * is taken literally, extension included — the caller asked for that path.\n */\nexport function resolveDownloadPath({ baseName, extension, out, outIsDirectory }: DownloadPathInput): string {\n  const filename = `${baseName}${extension}`;\n  if (!out) {\n    return filename;\n  }\n  if (outIsDirectory) {\n    return join(out, filename);\n  }\n  return out;\n}\n\n/**\n * Make a batch of resolved paths collision-free.\n *\n * Two hits from different hosts routinely end in the same segment (`/a/logo.png`\n * and `/b/logo.png`), and writing both would leave one file where the agent\n * asked for two — silently, since each write succeeds.\n *\n * The names this mints are claimed too, which is the whole difference between\n * this and a per-name counter. `[\"logo.png\", \"logo.png\", \"logo-2.png\"]` used to\n * produce `logo-2.png` twice: the third entry was its own first sighting, so it\n * passed through untouched and collided with the name invented for the second.\n * That reproduced the exact failure the function exists to prevent, one step\n * further along.\n */\nexport function disambiguate(paths: string[]): string[] {\n  const taken = new Set<string>();\n  return paths.map((path) => {\n    if (!taken.has(path)) {\n      taken.add(path);\n      return path;\n    }\n    const ext = extname(path);\n    const stem = path.slice(0, path.length - ext.length);\n    // Step until free rather than trusting a count: the candidate can collide\n    // with a name that arrived on its own, not only with an earlier duplicate.\n    let n = 2;\n    while (taken.has(`${stem}-${n}${ext}`)) n += 1;\n    const unique = `${stem}-${n}${ext}`;\n    taken.add(unique);\n    return unique;\n  });\n}\n"],"mappings":"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","names":["outIsDirectory"]}

package/dist/draft-ABGQYDHP.js

@@ -0,0 +1,328 @@
+import {
+  failWriteValidation
+} from "./chunk-OKG6GX2F.js";
+import {
+  parseXApiError
+} from "./chunk-M6UNISGO.js";
+import "./chunk-C6U6UDHJ.js";
+import {
+  writeAdsJson,
+  writeJsonEnvelope
+} from "./chunk-VFIOJD5M.js";
+import {
+  CHAT_READ_ARG
+} from "./chunk-PFBQERWX.js";
+import "./chunk-XWH7CCBL.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-WYCVJIHD.js";
+import "./chunk-ZJWUBJYQ.js";
+import "./chunk-XML7AJM3.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-XBOK23HI.js";
+import "./chunk-IFWP3ZDO.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-NAWWC5I3.js";
+import {
+  registerSchema
+} from "./chunk-NU7JSWVA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/x/draft.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+
+// src/commands/ads/x/draft-status.ts
+var OPERATION_LABELS = {
+  create: "Creating",
+  update: "Updating",
+  pause: "Pausing",
+  resume: "Resuming",
+  remove: "Removing"
+};
+function badge(node) {
+  const label = node.operation ? OPERATION_LABELS[node.operation] : void 0;
+  return label ?? (node.existing ? "on X" : "staged");
+}
+function collectionLine(collection) {
+  const parts = [];
+  if (collection.added > 0) {
+    parts.push(`+${collection.added}`);
+  }
+  if (collection.existing > 0) {
+    parts.push(`${collection.existing} existing`);
+  }
+  if (collection.removed > 0) {
+    parts.push(`-${collection.removed}`);
+  }
+  return parts.length > 0 ? `${collection.label}: ${parts.join(", ")}` : void 0;
+}
+function accountsInTree(nodes) {
+  const accounts = /* @__PURE__ */ new Set();
+  const walk = (node) => {
+    accounts.add(node.accountId);
+    for (const child of node.children) {
+      walk(child);
+    }
+  };
+  for (const node of nodes) {
+    walk(node);
+  }
+  return accounts;
+}
+function renderNode(node, depth, showAccount, out) {
+  const indent = "  ".repeat(depth);
+  const account = showAccount ? ` [${node.accountId}]` : "";
+  out.push(`${indent}${node.entity}: ${node.name} \u2014 ${badge(node)}${account}`);
+  for (const collection of node.collections) {
+    const line = collectionLine(collection);
+    if (line) {
+      out.push(`${indent}  ${line}`);
+    }
+  }
+  for (const warning of node.warnings ?? []) {
+    out.push(`${indent}  ! ${warning}`);
+  }
+  for (const child of node.children) {
+    renderNode(child, depth + 1, showAccount, out);
+  }
+}
+var NO_CHANGES = "No X Ads changes staged";
+var STATUS_HEADINGS = {
+  active: "staged",
+  publishing: "publishing",
+  applied: "published",
+  discarded: "discarded"
+};
+function didNotApply(op) {
+  return op.result?.status === "failed" || op.result?.status === "skipped";
+}
+function didApply(op) {
+  return op.result?.status === "applied" || op.result?.status === "simulated";
+}
+function headingLine(draft) {
+  const heading = STATUS_HEADINGS[draft.status] ?? draft.status;
+  if (draft.status !== "applied" && draft.status !== "publishing") {
+    return `X Ads: ${draft.count} change${draft.count === 1 ? "" : "s"} ${heading}`;
+  }
+  const applied = draft.ops.filter(didApply).length;
+  const failed = draft.ops.filter(didNotApply).length;
+  return `X Ads: ${heading} \xB7 ${applied} applied${failed > 0 ? `, ${failed} failed` : ""}`;
+}
+function problemLines(draft) {
+  return draft.ops.filter(didNotApply).map((op) => {
+    const reason = op.result?.error ?? `skipped: waiting on ${op.result?.skippedBecause ?? "a change that did not apply"}`;
+    return `\u2717 ${op.summary} \u2014 failed: ${reason}`;
+  });
+}
+function renderDraftStatus(draft) {
+  if (draft.status === "none" || draft.count === 0) {
+    return NO_CHANGES;
+  }
+  const out = [headingLine(draft), ""];
+  const tree = draft.tree ?? [];
+  const showAccount = accountsInTree(tree).size > 1;
+  for (const node of tree) {
+    renderNode(node, 0, showAccount, out);
+  }
+  const problems = problemLines(draft);
+  if (problems.length > 0) {
+    out.push("", ...problems);
+  }
+  return out.join("\n");
+}
+
+// src/commands/ads/x/draft.ts
+function handleDraftError(err) {
+  if (err instanceof ApiError) {
+    writeAdsJson(parseXApiError(err.message, "\u2014"));
+    process.exit(1);
+  }
+  writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+  process.exit(1);
+}
+registerSchema({
+  command: "ads.x.draft",
+  description: "Review everything staged for X Ads on this chat as a Campaign \u25B8 Ad group \u25B8 Ad tree. After a publish this is the authoritative record: `published \xB7 N applied`, or a `\u2717 \u2026 failed:` line per op that did not land.",
+  args: {
+    json: { type: "boolean", description: "Raw JSON envelope instead of the readable tree", required: false },
+    chat: { type: "string", description: "Read another chat's draft instead of this one", required: false }
+  }
+});
+async function listDraft(json, chat) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/ads/x/draft", { chatId });
+    if (json || !response.ok || !response.data) {
+      writeJsonEnvelope(response);
+      return;
+    }
+    process.stdout.write(`${renderDraftStatus(response.data)}
+`);
+  } catch (err) {
+    handleDraftError(err);
+  }
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Review everything staged as a Campaign \u25B8 Ad group \u25B8 Ad tree. Example: baker ads x draft"
+  },
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    await listDraft(args.json === true, args.chat);
+  }
+});
+registerSchema({
+  command: "ads.x.draft.show",
+  description: "The full staged payload, warnings and before-snapshot for one op \u2014 the receipt to check before publishing.",
+  args: {
+    ref: { type: "string", description: "Op ref (x_temp_* for creates, the target id for updates)", required: true },
+    chat: { type: "string", description: "Read another chat's draft instead of this one", required: false }
+  }
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Show one staged op in full. Example: baker ads x draft show x_temp_abc123"
+  },
+  args: {
+    ref: { type: "positional", description: "Op ref, or the target id for a staged update", required: true },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = resolveChatId(args.chat);
+      const response = await apiPost("/api/ads/x/draft/show", {
+        chatId,
+        ref: String(args.ref)
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.x.draft.amend",
+  description: "Change a staged op in place instead of removing and re-staging it. The patch merges into the payload (JSON merge-patch: `null` deletes a key) and the whole op re-validates.",
+  args: {
+    ref: { type: "string", description: "Op ref or target id", required: true },
+    patch: { type: "string", description: "JSON object, or @path to a file holding one", required: true }
+  }
+});
+var amendCommand = defineCommand({
+  meta: {
+    name: "amend",
+    description: `Change a staged op in place.
+
+Example:
+  baker ads x draft amend x_temp_abc '{"dailyBudgetAmountLocalMicro": 20000000}'`
+  },
+  args: {
+    ref: { type: "positional", description: "Op ref or target id", required: true },
+    patch: { type: "positional", description: "JSON object, or @path to a file", required: true }
+  },
+  run: async ({ args }) => {
+    const raw = String(args.patch);
+    let patch;
+    try {
+      patch = JSON.parse(raw.startsWith("@") ? readFileSync(raw.slice(1), "utf8") : raw);
+    } catch {
+      failWriteValidation("patch must be a JSON object, or @path to a file holding one");
+    }
+    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
+      failWriteValidation("patch must be a JSON object");
+    }
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/x/draft/amend", {
+        chatId,
+        ref: String(args.ref),
+        patch
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.x.draft.remove",
+  description: "Drop one staged X op. Removing a create cascades to everything staged that depends on it.",
+  args: { ref: { type: "string", description: "Op ref or target id", required: true } }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop one staged op (cascades to its dependents). Example: baker ads x draft remove x_temp_abc123"
+  },
+  args: { ref: { type: "positional", description: "Op ref or target id", required: true } },
+  run: async ({ args }) => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/x/draft/remove", {
+        chatId,
+        ref: String(args.ref)
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+registerSchema({
+  command: "ads.x.draft.clear",
+  description: "Drop every staged X op on this chat. Nothing reached X, so nothing needs reversing.",
+  args: {}
+});
+var clearCommand = defineCommand({
+  meta: { name: "clear", description: "Drop every staged X op on this chat. Example: baker ads x draft clear" },
+  args: {},
+  run: async () => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/x/draft/clear", { chatId });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleDraftError(err);
+    }
+  }
+});
+var draftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: `Review and edit the X Ads changes staged on this chat.
+
+Nothing staged has reached X. Everything applies when the chat is published,
+and discarding the chat reverses all of it.
+
+Examples:
+  baker ads x draft                       \u2014 the Campaign \u25B8 Ad group \u25B8 Ad tree
+  baker ads x draft show x_temp_abc123    \u2014 one op in full
+  baker ads x draft amend x_temp_abc '{"name":"New"}'
+  baker ads x draft remove x_temp_abc123
+  baker ads x draft clear`
+  },
+  subCommands: {
+    list: listCommand,
+    show: showCommand,
+    amend: amendCommand,
+    remove: removeCommand,
+    clear: clearCommand
+  },
+  // A parent must never declare `run`: citty falls through to it AFTER running
+  // the matched subcommand, so every edit would also trigger a full list.
+  args: { json: { type: "boolean", description: "Raw JSON envelope" }, chat: CHAT_READ_ARG },
+  default: "list"
+});
+export {
+  draftCommand
+};
+//# sourceMappingURL=draft-ABGQYDHP.js.map