@koda-sl/baker-cli 0.572.0 → 0.574.0

package/dist/download-QH4VHDS6.js

@@ -0,0 +1,337 @@
+import {
+  atomicWrite,
+  isDirectory,
+  isRemoteUrl
+} from "./chunk-CP5IVVYM.js";
+import {
+  ExternalFetchError,
+  MAX_REMOTE_IMAGE_BYTES,
+  NO_ANSWER_MESSAGE,
+  OversizeFetchError,
+  fetchExternalBytes
+} from "./chunk-TJTCHTR4.js";
+import {
+  ApiError,
+  apiGet,
+  validateConvexId
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/download.ts
+import { mkdir } from "fs/promises";
+import { dirname } from "path";
+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 (created if missing; end it with `/`) 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 CAUSE_ADVICE = {
+  write: () => "Writing the file failed on this machine (the error names the path) \u2014 point `--out` at a writable folder and re-run; the host is not the problem.",
+  too_large: (failed) => `${failed.find((f) => f.cause === "too_large")?.error ?? "A file is over the download limit."} Pick a smaller version of that asset (another hit, a smaller size) rather than retrying it.`,
+  library: () => "For a library image, check the id and that the row is `ready` with `baker images get <id>`.",
+  refused: () => "A 403/404 (or another refusal: a security check, an address not on the public web) means these bytes will not be served \u2014 re-source the asset (`baker images extract <page-url>`, `baker images stock <query>`).",
+  unavailable: () => "The host failed on its side or did not answer (a 5xx or a timeout) \u2014 retry that URL once; if it fails again, re-source the asset (`baker images extract <page-url>`, `baker images stock <query>`)."
+};
+function fetchFailureCause(err, target) {
+  if (err instanceof OversizeFetchError) return "too_large";
+  if (err instanceof ApiError || target.kind === "imageId") return "library";
+  return err instanceof ExternalFetchError && isTransient(err) ? "unavailable" : "refused";
+}
+function isTransient(err) {
+  if (err.status !== null) return err.status >= 500;
+  return err.ourFault || err.message === NO_ANSWER_MESSAGE;
+}
+function allFailedAction(causes) {
+  if (causes.every((cause) => cause === "write")) return "retry_with_changes";
+  if (causes.every((cause) => cause === "unavailable")) return "retry_once";
+  return "use_different_resource";
+}
+function allFailedFix(failed) {
+  const causes = [...new Set(failed.map((f) => f.cause))];
+  const advice = causes.map((cause) => CAUSE_ADVICE[cause](failed)).join(" ");
+  return {
+    action: allFailedAction(causes),
+    explanation: `None of the targets could be downloaded. ${advice} 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 a directory when downloading more than one image (got "${out}"); end it with \`/\` to have it created.`
+    );
+  }
+  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"),
+        cause: fetchFailureCause(err, target)
+      });
+    }
+  }
+  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 mkdir(dirname(path), { recursive: true });
+      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"), cause: "write" });
+    }
+  }
+  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 (created if missing; end it with /), 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: allFailedFix(failed)
+          }
+        });
+        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-QH4VHDS6.js.map

package/dist/draft-3MYPEBSF.js

@@ -0,0 +1,260 @@
+import {
+  draftRefs,
+  removeDraftRefs
+} from "./chunk-MIBOIXCP.js";
+import {
+  handleMetaError
+} from "./chunk-FCD5BPC5.js";
+import {
+  hintLines
+} from "./chunk-D5FY4FAK.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-VJUVTMHY.js";
+import {
+  CHAT_READ_ARG,
+  DRAFT_FULL_ARG
+} from "./chunk-X32MFGWW.js";
+import {
+  apiPost
+} from "./chunk-JCFZ7ECN.js";
+import "./chunk-OFSUVUXT.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-OMLZ35HJ.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/draft.ts
+import { defineCommand } from "citty";
+
+// src/commands/ads/meta/draft-status.ts
+var STATUS_HEADINGS = {
+  active: "staged",
+  publishing: "publishing",
+  applied: "published",
+  partial: "published with failures",
+  discarded: "discarded",
+  none: "none"
+};
+function plural(count, word) {
+  return `${count} ${word}${count === 1 ? "" : "s"}`;
+}
+function headingLine(draft) {
+  const heading = STATUS_HEADINGS[draft.status];
+  if (draft.status === "active" || draft.status === "discarded") {
+    return `Meta Ads \u2014 ${plural(draft.count, "change")} ${heading} \xB7 ${draft.mode}`;
+  }
+  const counts = /* @__PURE__ */ new Map();
+  for (const op of draft.ops) {
+    const status = op.result?.status ?? "pending";
+    counts.set(status, (counts.get(status) ?? 0) + 1);
+  }
+  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(", ");
+  return `Meta Ads \u2014 ${heading} \xB7 ${summary} \xB7 ${draft.mode}`;
+}
+function failedPart(result) {
+  const landed = result.landed ? ` (${result.landed})` : "";
+  return `\u2717 failed: ${result.error ?? "no reason recorded"}${landed}`;
+}
+function resultPart(op) {
+  const result = op.result;
+  if (!result) {
+    return void 0;
+  }
+  if (result.status === "failed") {
+    return failedPart(result);
+  }
+  if (result.status === "skipped") {
+    const because = result.skippedBecause;
+    if (because && op.dependsOn.includes(because)) {
+      return `\u2717 skipped: ${because} did not apply`;
+    }
+    return `\u2717 skipped: ${because ?? "a change it needs did not apply"}`;
+  }
+  const id = result.id ?? result.hash;
+  const applied = `\u2713 ${result.status}${id ? ` \u2192 ${id}` : ""}`;
+  const verification = result.verification;
+  if (verification && verification.status !== "confirmed") {
+    return `${applied} (read-back ${verification.status}${verification.note ? `: ${verification.note}` : ""})`;
+  }
+  return applied;
+}
+function opLine(op, showAccount) {
+  const parts = [op.ref, op.kind, op.summary];
+  if (op.target && op.target !== op.ref) {
+    parts.push(`target ${op.target}`);
+  }
+  if (showAccount) {
+    parts.push(`account ${op.accountId}`);
+  }
+  if (op.dependsOn.length > 0) {
+    parts.push(`after ${op.dependsOn.join(", ")}`);
+  }
+  const result = resultPart(op);
+  if (result) {
+    parts.push(result);
+  }
+  return `  ${parts.join(" \xB7 ").replace(/[\r\n]+/g, " ")}`;
+}
+function renderDraftStatus(draft) {
+  if (draft.status === "none" || draft.count === 0) {
+    return "No staged Meta changes on this chat.";
+  }
+  const lines = [headingLine(draft)];
+  if (draft.status === "active") {
+    lines.push("Publishing makes every change real on the ad account.");
+  }
+  lines.push("");
+  const showAccount = new Set(draft.ops.map((op) => op.accountId)).size > 1;
+  for (const op of draft.ops) {
+    lines.push(opLine(op, showAccount));
+  }
+  if (draft.advisories.length > 0) {
+    lines.push("", "Advisories");
+    for (const advisory of draft.advisories) {
+      lines.push(`  ! ${advisory.ref}: ${advisory.message}`);
+    }
+  }
+  lines.push("", "Full staged payload for one op: baker ads meta draft show <ref> \xB7 raw envelope: --json");
+  return lines.join("\n");
+}
+
+// src/commands/ads/meta/draft.ts
+registerSchema({
+  command: "ads.meta.draft",
+  description: "Review every Meta op staged on this chat, one line each: ref \xB7 kind \xB7 summary \xB7 what it waits on, and after a publish \u2713 applied \u2192 id or \u2717 failed: <error>. `draft show <ref>` prints one op's full payload.",
+  args: {
+    json: { type: "boolean", description: "Raw JSON envelope instead of the readable list", required: false },
+    full: { type: "boolean", description: DRAFT_FULL_ARG.description, required: false },
+    chat: { type: "string", description: "Read another chat's draft instead of this one", required: false }
+  }
+});
+async function listDraft(json, chat, full = false) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/ads/meta/draft", {
+      chatId,
+      ...full ? { full: true } : {}
+    });
+    if (json || full || !response.ok || !response.data) {
+      writeJsonEnvelope(response);
+      return;
+    }
+    process.stdout.write(`${renderDraftStatus(response.data)}${hintLines(response)}
+`);
+  } catch (err) {
+    handleMetaError(err);
+  }
+}
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "Show every Meta write op staged in this chat, one line each (ref \xB7 kind \xB7 summary \xB7 dependencies \xB7 post-publish result); --json for the raw envelope, --full for every op's payload too. Publishing reaches the real ad account, so review this before you finish. Example: baker ads meta draft"
+  },
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" },
+    full: DRAFT_FULL_ARG,
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    await listDraft(args.json === true, args.chat, args.full === true);
+  }
+});
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Print the full staged payload for one op \u2014 the receipt to verify a change looks right before publish (never truncated). Example: baker ads meta draft show meta_temp_abc123"
+  },
+  args: {
+    ref: { type: "positional", description: "Op ref (meta_temp_* for creates, target id for updates)", required: true },
+    // `show` always prints the envelope; `--json` is the spelling `list` taught, so it is accepted here too.
+    json: { type: "boolean", description: "Accepted for symmetry with list; show always prints the JSON envelope" },
+    chat: CHAT_READ_ARG
+  },
+  run: async ({ args }) => {
+    try {
+      const chatId = resolveChatId(args.chat);
+      const response = await apiPost("/api/ads/meta/draft/show", {
+        chatId,
+        ref: args.ref
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Drop staged Meta ops \u2014 one, or many in one call. Removing a create cascades to everything that depends on it. Example: baker ads meta draft remove meta_temp_abc123 meta_temp_def456"
+  },
+  args: {
+    ref: {
+      type: "positional",
+      description: "Op ref(s) (meta_temp_* for creates, target id for updates) \u2014 several, space- or comma-separated",
+      required: true
+    }
+  },
+  run: async ({ args }) => {
+    const refs = draftRefs(args._);
+    if (refs.length > 1) {
+      await removeDraftRefs("/api/ads/meta/draft/remove", refs);
+      return;
+    }
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/meta/draft/remove", {
+        chatId,
+        ref: args.ref
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var clearCommand = defineCommand({
+  meta: {
+    name: "clear",
+    description: "Discard ALL staged Meta ops in this chat's draft \u2014 nothing will apply on publish. Example: baker ads meta draft clear"
+  },
+  run: async () => {
+    try {
+      const chatId = requireChatId();
+      const response = await apiPost("/api/ads/meta/draft/clear", {
+        chatId
+      });
+      writeJsonEnvelope(response);
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var metaDraftCommand = defineCommand({
+  meta: {
+    name: "draft",
+    description: "Review and edit the Meta write ops staged in this chat BEFORE publish. Subcommands: list (default), show, remove, clear. Ops never hit Meta until the chat is published. `list` and `show` take --chat <id> to read an earlier chat's changes instead."
+  },
+  // Declared on the parent too: `default: "list"` dispatches the bare `draft --chat <id>` form, and
+  // citty prints help for a flag the parent does not know instead of forwarding it.
+  args: {
+    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable list" },
+    full: DRAFT_FULL_ARG,
+    chat: CHAT_READ_ARG
+  },
+  subCommands: { list: listCommand, show: showCommand, remove: removeCommand, clear: clearCommand },
+  // `default` (not `run`) dispatches the bare invocation: citty falls through to `run`
+  // after dispatching a subcommand, so a `run` here would list the draft a second time
+  // on every `draft list` / `draft remove` / `draft clear`.
+  default: "list"
+});
+export {
+  metaDraftCommand
+};
+//# sourceMappingURL=draft-3MYPEBSF.js.map