@koda-sl/baker-cli 0.449.0 → 0.451.0-dev.b2a4eba2b

package/dist/chunk-XUOZ6VAL.js

@@ -0,0 +1,496 @@
+import {
+  repeatedValues
+} from "./chunk-ERSX3MKH.js";
+import {
+  adCopyHints,
+  booleanWordPositionalError,
+  capabilityFix
+} from "./chunk-YSW3BBNR.js";
+import {
+  hintLines,
+  withHints
+} from "./chunk-D5FY4FAK.js";
+import {
+  handleConnectionError,
+  isNotConnectedError,
+  writeJsonEnvelope
+} from "./chunk-XNMSJP2X.js";
+import {
+  GOOGLE_DRAFT_BATCH_MAX,
+  googleDraftOpInputSchema,
+  toMicros
+} from "./chunk-NE4F3FHN.js";
+import {
+  ApiError,
+  apiPost
+} from "./chunk-PCKVSSVT.js";
+import {
+  requireChatId,
+  resolveChatId
+} from "./chunk-UW36KPPH.js";
+
+// src/commands/ads/google/write-shared.ts
+import { readFileSync } from "fs";
+
+// src/commands/ads/google/copy-list-usage.ts
+var AD_COPY_LIST_USAGE = `repeat the flag once per item, or pass one comma-separated list and wrap an item that contains a comma in double quotes: '"Fast, free quotes",Book today'. A flag given once is read as a list, so a lone item with a comma needs its double quotes too: '"Fast, free quotes"'`;
+var COPY_LIST_FLAG = {
+  headlines: "--headlines",
+  descriptions: "--descriptions",
+  longHeadlines: "--long-headlines"
+};
+function valueAt(root, path) {
+  let node = root;
+  for (const key of path) {
+    if (node === null || typeof node !== "object") return void 0;
+    node = node[key];
+  }
+  return node;
+}
+function countRefusal(op, issue) {
+  if (issue.code !== "too_big" && issue.code !== "too_small" || issue.origin !== "array") return void 0;
+  const flag = COPY_LIST_FLAG[String(issue.path.at(-1))];
+  if (!flag) return void 0;
+  const value = valueAt(op, issue.path);
+  const count = Array.isArray(value) ? value.length : void 0;
+  return issue.code === "too_big" ? { flag, count, bound: `at most ${issue.maximum}`, tooMany: true } : { flag, count, bound: `at least ${issue.minimum}`, tooMany: false };
+}
+function copyListCountFix(op, issues) {
+  const refusals = issues.map((issue) => countRefusal(op, issue));
+  if (refusals.length === 0 || refusals.some((refusal) => refusal === void 0)) return void 0;
+  const counted = refusals.filter((refusal) => refusal !== void 0);
+  const limits = counted.map(({ flag, count, bound }) => `${flag} has ${count ?? "the wrong number of"} items; this ad takes ${bound}.`).join(" ");
+  const commaCause = counted.some((refusal) => refusal.tooMany) ? ` If you meant fewer items, the copy was cut at its commas: a flag given once is read as a comma-separated list, so an item with a comma in it ("Fast, free quotes", a decimal like "4,5/5") becomes two. To keep a comma, ${AD_COPY_LIST_USAGE} \u2014 or put the content in --file as JSON.` : "";
+  return {
+    action: "fix_copy_list_count",
+    explanation: `${limits}${commaCause} ${commaCause ? "Otherwise add" : "Add"} or drop items to fit the limit, then stage again; the field names are right.`
+  };
+}
+
+// src/commands/ads/google/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;
+  if (label) {
+    return label;
+  }
+  return node.existing ? "on Google Ads" : "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}`);
+  }
+  if ((collection.updated ?? 0) > 0) {
+    parts.push(`~${collection.updated}`);
+  }
+  return parts.length > 0 ? `${collection.label}: ${parts.join(", ")}` : void 0;
+}
+function accountsInTree(nodes) {
+  const accounts = /* @__PURE__ */ new Set();
+  const walk = (node) => {
+    accounts.add(node.customerId);
+    for (const child of node.children) {
+      walk(child);
+    }
+  };
+  for (const node of nodes) {
+    walk(node);
+  }
+  return accounts;
+}
+function renderNode(node, depth, lines, showAccount) {
+  const indent = "  ".repeat(depth);
+  const account = showAccount ? ` \xB7 account ${node.customerId}` : "";
+  lines.push(`${indent}\u2022 ${node.name} \xB7 ${badge(node)}${account}`);
+  for (const warning of node.warnings ?? []) {
+    lines.push(`${indent}    \u26A0 ${warning}`);
+  }
+  for (const collection of node.collections) {
+    const line = collectionLine(collection);
+    if (line) {
+      lines.push(`${indent}    ${line}`);
+    }
+  }
+  for (const child of node.children) {
+    renderNode(child, depth + 1, lines, showAccount);
+  }
+}
+var RESOURCE_ENTITIES = /* @__PURE__ */ new Set([
+  "sharedSet",
+  "biddingStrategy",
+  "audience",
+  "conversionAction",
+  "label",
+  "budget",
+  "asset"
+]);
+function renderSection(title, nodes, lines, showAccount) {
+  if (nodes.length === 0) {
+    return;
+  }
+  lines.push("");
+  lines.push(title);
+  for (const node of nodes) {
+    renderNode(node, 1, lines, showAccount);
+  }
+}
+function renderAdvisories(data, lines) {
+  const advisories = data.advisories ?? [];
+  if (advisories.length === 0 || data.status === "applied") {
+    return;
+  }
+  lines.push("");
+  lines.push("Advisories (non-blocking, checked across the whole draft \u2014 settle these before you publish)");
+  for (const advisory of advisories) {
+    lines.push(`  \u2022 ${advisory.message}`);
+  }
+}
+function renderOutcome(data, lines) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const op of data.ops) {
+    const status = op.result?.status ?? "pending";
+    counts.set(status, (counts.get(status) ?? 0) + 1);
+  }
+  const summary = [...counts].map(([status, count]) => `${count} ${status}`).join(", ");
+  lines.push(`Google Ads \u2014 published \xB7 ${summary || `${data.count} op(s)`} \xB7 ${data.mode}`);
+  for (const op of data.ops) {
+    const status = op.result?.status;
+    if (status !== "failed" && status !== "skipped") {
+      continue;
+    }
+    const reason = op.result?.error ?? op.result?.skippedBecause ?? "no reason recorded";
+    lines.push(`  \u2717 ${op.summary} \u2014 ${status}: ${reason}`);
+  }
+}
+function renderDraftStatus(data) {
+  if (data.status === "none" || data.count === 0) {
+    return "No staged Google Ads changes on this chat.";
+  }
+  const modeNote = data.mode === "live" ? "Live \u2014 publishing writes directly to Google Ads." : "Simulated \u2014 publishing completes the whole draft without calling Google Ads.";
+  const lines = [];
+  if (data.status === "applied") {
+    renderOutcome(data, lines);
+  } else if (data.status === "publishing") {
+    lines.push(`Google Ads \u2014 publishing ${data.count} change${data.count === 1 ? "" : "s"} \xB7 ${data.mode}`);
+  } else {
+    lines.push(`Google Ads \u2014 ${data.count} staged change${data.count === 1 ? "" : "s"} \xB7 ${data.mode}`);
+  }
+  lines.push(modeNote);
+  const tree = data.tree ?? [];
+  const showAccount = accountsInTree(tree).size > 1;
+  renderSection(
+    "Shared resources",
+    tree.filter((node) => RESOURCE_ENTITIES.has(node.entity)),
+    lines,
+    showAccount
+  );
+  renderSection(
+    "Campaigns",
+    tree.filter((node) => node.entity === "campaign"),
+    lines,
+    showAccount
+  );
+  const rest = tree.filter((node) => !RESOURCE_ENTITIES.has(node.entity) && node.entity !== "campaign");
+  renderSection("Other", rest, lines, showAccount);
+  renderAdvisories(data, lines);
+  return lines.join("\n");
+}
+
+// src/commands/ads/google/write-shared.ts
+function failWriteValidation(message) {
+  writeJsonEnvelope({ ok: false, error: { code: "VALIDATION_ERROR", message } });
+  process.exit(1);
+}
+function requireCustomerId(args) {
+  const raw = args["customer-id"] ?? args.customerId;
+  if (!raw || !/^\d{10}$/.test(raw)) {
+    failWriteValidation("pass --customer-id as the 10-digit Google Ads customer id (no dashes)");
+  }
+  return raw;
+}
+function requireTarget(args, entity) {
+  const booleanWord = booleanWordPositionalError(args, entity);
+  if (booleanWord) {
+    failWriteValidation(booleanWord);
+  }
+  const positional = Array.isArray(args._) ? args._[0] : void 0;
+  const target = args.id ?? args.target ?? args.ref ?? positional;
+  if (typeof target !== "string" || target.length === 0) {
+    failWriteValidation(`pass the ${entity} resource name or id as the positional argument`);
+  }
+  return target;
+}
+function requireStringFlag(value, flag) {
+  if (typeof value !== "string" || value.length === 0) {
+    failWriteValidation(`${flag} is required`);
+  }
+  return value;
+}
+function microsFlag(value, flag) {
+  if (value === void 0 || value === null || value === "") {
+    return void 0;
+  }
+  const num = Number(value);
+  if (Number.isNaN(num) || num <= 0) {
+    failWriteValidation(`${flag} must be a positive amount (major currency units, e.g. 50 or 50.00)`);
+  }
+  return toMicros(num);
+}
+function listFlag(value) {
+  if (typeof value !== "string" || value.length === 0) {
+    return void 0;
+  }
+  const items = value.split(",").map((v) => v.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+var MATCH_TYPES = /* @__PURE__ */ new Set(["EXACT", "PHRASE", "BROAD"]);
+function parseKeywordEntry(raw, defaultMatch) {
+  const colon = raw.lastIndexOf(":");
+  if (colon > 0) {
+    const suffix = raw.slice(colon + 1).trim().toUpperCase();
+    if (MATCH_TYPES.has(suffix)) {
+      return { text: raw.slice(0, colon).trim(), matchType: suffix };
+    }
+    failWriteValidation(`"${raw}": ":${raw.slice(colon + 1)}" is not a match type (EXACT | PHRASE | BROAD)`);
+  }
+  if (!defaultMatch) {
+    failWriteValidation(`"${raw}" has no match type \u2014 add a :EXACT/:PHRASE/:BROAD suffix or pass --match-type`);
+  }
+  return { text: raw, matchType: defaultMatch };
+}
+function rawTextEntries(value, rawArgs) {
+  return repeatedValues(rawArgs, "text", value).flatMap((v) => v.split(",")).map((v) => v.trim()).filter(Boolean);
+}
+function rawFileEntries(path) {
+  if (typeof path !== "string" || path.length === 0) {
+    return [];
+  }
+  return readFileSync(path, "utf8").split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !line.startsWith("#"));
+}
+function keywordEntries(args, rawArgs) {
+  const defaultMatch = typeof args["match-type"] === "string" ? args["match-type"].toUpperCase() : void 0;
+  const raw = [...rawTextEntries(args.text, rawArgs), ...rawFileEntries(args.file)];
+  if (raw.length === 0) {
+    failWriteValidation("pass keywords via --text (comma-separated) and/or --file (one per line)");
+  }
+  if (raw.length > GOOGLE_DRAFT_BATCH_MAX) {
+    failWriteValidation(`${raw.length} keywords exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX}`);
+  }
+  const entries = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const item of raw) {
+    const entry = parseKeywordEntry(item, defaultMatch);
+    const key = JSON.stringify([entry.text, entry.matchType]);
+    if (!seen.has(key)) {
+      seen.add(key);
+      entries.push(entry);
+    }
+  }
+  return entries;
+}
+function loadJsonFileArg(path) {
+  if (typeof path !== "string" || path.length === 0) {
+    return {};
+  }
+  const inline = path.trimStart().startsWith("{");
+  const source = inline ? "inline JSON" : path;
+  try {
+    const parsed = JSON.parse(inline ? path : readFileSync(path, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      failWriteValidation(`${source} must contain a JSON object`);
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      failWriteValidation(`${source} is not valid JSON: ${err.message}`);
+    }
+    throw err;
+  }
+}
+function mergePayload(file, flags) {
+  const merged = { ...file };
+  for (const [key, value] of Object.entries(flags)) {
+    if (value !== void 0) {
+      merged[key] = value;
+    }
+  }
+  return merged;
+}
+function loadPatchArg(args) {
+  const file = typeof args.file === "string" && args.file.length > 0 ? args.file : void 0;
+  const inline = typeof args.patch === "string" && args.patch.length > 0 ? args.patch : void 0;
+  if (Boolean(file) === Boolean(inline)) {
+    failWriteValidation("pass exactly one of --file <patch.json> or --patch '<json>'");
+  }
+  if (file) {
+    return loadJsonFileArg(file);
+  }
+  try {
+    const parsed = JSON.parse(inline);
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      failWriteValidation("--patch must be a JSON object");
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof SyntaxError) {
+      failWriteValidation(`--patch is not valid JSON: ${err.message}`);
+    }
+    throw err;
+  }
+}
+function handleGoogleError(err) {
+  if (err instanceof ApiError) {
+    if (isNotConnectedError(err.code, err.message)) {
+      handleConnectionError("google_ads", err.message);
+    }
+    writeJsonEnvelope({ ok: false, error: { code: err.code ?? "API_ERROR", message: err.message } });
+    process.exit(1);
+  }
+  writeJsonEnvelope({
+    ok: false,
+    error: { code: "UNKNOWN", message: err instanceof Error ? err.message : String(err) }
+  });
+  process.exit(1);
+}
+function noopHints(data) {
+  return data.staged ? [] : [`NOT STAGED \u2014 ${data.reason}. Nothing to publish for this change; say so rather than reporting it as done.`];
+}
+function skippedHints(skipped, total) {
+  if (skipped.length === 0) {
+    return [];
+  }
+  const detail = skipped.map((s) => `${s.summary} \u2014 ${s.reason}`).join("; ");
+  return [
+    `${skipped.length} of ${total} op(s) NOT STAGED: ${detail}. Don't re-stage them; tell the user which changes couldn't be made and why, then carry on with the rest.`
+  ];
+}
+async function stageGoogleOp(raw, hints) {
+  const preflight = googleDraftOpInputSchema.safeParse(raw);
+  if (!preflight.success) {
+    const fields = preflight.error.issues.map((issue) => ({ path: issue.path.join("."), message: issue.message }));
+    writeJsonEnvelope({
+      ok: false,
+      error: {
+        code: "VALIDATION_ERROR",
+        message: fields.map((f) => f.path ? `${f.path}: ${f.message}` : f.message).join("; "),
+        fields,
+        fix: copyListCountFix(raw, preflight.error.issues) ?? capabilityFix("google-ads")
+      }
+    });
+    process.exit(1);
+  }
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/google/draft/stage", { chatId, op: preflight.data });
+    const allHints = [...noopHints(response.data), ...hints ?? [], ...await adCopyHints(preflight.data)];
+    writeJsonEnvelope(withHints(response, allHints));
+  } catch (err) {
+    handleGoogleError(err);
+  }
+}
+async function stageCreate(kind, customerId, payload, hints) {
+  await stageGoogleOp({ kind, customerId, payload }, hints);
+}
+async function stageGoogleOps(rawOps, hints) {
+  if (rawOps.length === 1 && rawOps[0]) {
+    await stageGoogleOp(rawOps[0], hints);
+    return;
+  }
+  const ops = [];
+  for (const [index, raw] of rawOps.entries()) {
+    const preflight = googleDraftOpInputSchema.safeParse(raw);
+    if (!preflight.success) {
+      const fields = preflight.error.issues.map((issue) => ({
+        path: `ops[${index}].${issue.path.join(".")}`,
+        message: issue.message
+      }));
+      writeJsonEnvelope({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message: fields.map((f) => `${f.path}: ${f.message}`).join("; "),
+          fields,
+          fix: copyListCountFix(raw, preflight.error.issues) ?? capabilityFix("google-ads")
+        }
+      });
+      process.exit(1);
+    }
+    ops.push(preflight.data);
+  }
+  try {
+    const chatId = requireChatId();
+    const response = await apiPost("/api/ads/google/draft/stage-batch", { chatId, ops });
+    const allHints = [
+      ...skippedHints(response.data.skipped ?? [], ops.length),
+      ...hints ?? [],
+      ...await adCopyHints(ops)
+    ];
+    writeJsonEnvelope(withHints(response, allHints));
+  } catch (err) {
+    handleGoogleError(err);
+  }
+}
+async function stageUpdate(kind, customerId, target, payload, hints) {
+  await stageGoogleOp({ kind, customerId, target, payload }, hints);
+}
+async function stageTarget(kind, customerId, target, hints) {
+  await stageGoogleOp({ kind, customerId, target }, hints);
+}
+async function draftAction(path, body, chat) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost(path, { chatId, ...body });
+    writeJsonEnvelope(response);
+  } catch (err) {
+    handleGoogleError(err);
+  }
+}
+async function draftListAction(json, chat) {
+  try {
+    const chatId = resolveChatId(chat);
+    const response = await apiPost("/api/ads/google/draft", { chatId });
+    if (json || !response.ok || !response.data) {
+      writeJsonEnvelope(response);
+      return;
+    }
+    process.stdout.write(`${renderDraftStatus(response.data)}${hintLines(response)}
+`);
+  } catch (err) {
+    handleGoogleError(err);
+  }
+}
+
+export {
+  AD_COPY_LIST_USAGE,
+  failWriteValidation,
+  requireCustomerId,
+  requireTarget,
+  requireStringFlag,
+  microsFlag,
+  listFlag,
+  keywordEntries,
+  loadJsonFileArg,
+  mergePayload,
+  loadPatchArg,
+  stageGoogleOp,
+  stageCreate,
+  stageGoogleOps,
+  stageUpdate,
+  stageTarget,
+  draftAction,
+  draftListAction
+};
+//# sourceMappingURL=chunk-XUOZ6VAL.js.map

package/dist/chunk-YCOP4FGJ.js

@@ -0,0 +1,57 @@
+import {
+  formEventKey
+} from "./chunk-SSJK7FEV.js";
+import {
+  flowNodeTriggers
+} from "./chunk-BAUSWB7O.js";
+
+// ../api/src/analytics/flowEventKeys.ts
+function flowNodes(node, acc = []) {
+  if (!node || typeof node !== "object") return acc;
+  const record = node;
+  acc.push(record);
+  if (Array.isArray(record.children)) for (const child of record.children) flowNodes(child, acc);
+  return acc;
+}
+function flowEventKeys(tree, slug) {
+  const primary = [];
+  const secondary = [];
+  const nodes = flowNodes(tree).filter((node) => typeof node.id === "string" && node.id !== "");
+  if (nodes.length === 0) return [];
+  for (const node of nodes) {
+    const id = node.id;
+    const triggers = flowNodeTriggers(node.nodeData);
+    for (const triggerId of triggers.available) {
+      const candidate = {
+        eventKey: formEventKey(slug, id, triggerId),
+        nodeId: id,
+        nodeName: typeof node.name === "string" ? node.name : id,
+        nodeType: triggers.type,
+        triggerId,
+        isCompletion: triggers.completion === triggerId
+      };
+      (candidate.isCompletion ? primary : secondary).push(candidate);
+    }
+  }
+  return [
+    ...primary,
+    ...secondary,
+    {
+      eventKey: `submit:${slug}`,
+      nodeId: null,
+      nodeName: "the Form ran out of steps",
+      nodeType: null,
+      triggerId: null,
+      // A Form reaching its last node is as primary as an outcome gets for a
+      // Form with no widget in it — but it never fires on one that ends in a
+      // booking widget or a redirect, so it does not lead the list.
+      isCompletion: false
+    }
+  ];
+}
+
+export {
+  flowNodes,
+  flowEventKeys
+};
+//# sourceMappingURL=chunk-YCOP4FGJ.js.map