@koda-sl/baker-cli 0.554.0 → 0.556.0

package/dist/draft-SGNQOUYH.js

@@ -1,557 +0,0 @@
-import {
-  draftRefs,
-  removeDraftRefs
-} from "./chunk-DSDI5DY3.js";
-import {
-  draftAction,
-  draftListAction,
-  failWriteValidation,
-  handleGoogleError,
-  loadJsonPayloads,
-  loadPatchArg,
-  requireTarget,
-  stageGoogleOps
-} from "./chunk-ZMTWQDFC.js";
-import "./chunk-ERSX3MKH.js";
-import "./chunk-P4MXGSSJ.js";
-import "./chunk-4NZ47VXO.js";
-import "./chunk-D5FY4FAK.js";
-import "./chunk-4H6XLX7E.js";
-import "./chunk-QALAJNBG.js";
-import "./chunk-SNWFM2DB.js";
-import {
-  writeJsonEnvelope
-} from "./chunk-QYH2UZAK.js";
-import "./chunk-Y3SK6EMU.js";
-import "./chunk-XB4NKZAQ.js";
-import "./chunk-E56V3RFO.js";
-import "./chunk-ZANXEMON.js";
-import "./chunk-G6U45QD3.js";
-import "./chunk-4ULGRGBG.js";
-import {
-  CHAT_READ_ARG,
-  DRAFT_FULL_ARG
-} from "./chunk-X32MFGWW.js";
-import "./chunk-R7XDGNZD.js";
-import {
-  GOOGLE_DRAFT_BATCH_MAX
-} from "./chunk-MSMTG6OC.js";
-import {
-  apiPost
-} from "./chunk-GFWWHCBF.js";
-import "./chunk-JXTNP3B5.js";
-import {
-  requireChatId
-} from "./chunk-45D6WRCJ.js";
-import {
-  registerSchema
-} from "./chunk-CCYZJMZ7.js";
-import "./chunk-YQSBHWOI.js";
-
-// src/commands/ads/google/draft.ts
-import { defineCommand } from "citty";
-
-// src/commands/ads/google/draft-batch.ts
-function refuseOversized(count, what) {
-  if (count > GOOGLE_DRAFT_BATCH_MAX) {
-    failWriteValidation(
-      `${count} ${what} exceeds the batch limit of ${GOOGLE_DRAFT_BATCH_MAX} \u2014 split the file and run the command once per part`
-    );
-  }
-}
-function stageFileOps(items, customerId) {
-  if (items.length === 0) {
-    failWriteValidation(
-      'pass --file with the ops to stage: a JSON array (or JSON Lines) of {"kind","customerId","target"?,"payload"?}'
-    );
-  }
-  refuseOversized(items.length, "ops");
-  return items.map((item, index) => {
-    if (typeof item.kind !== "string") {
-      failWriteValidation(
-        `item ${index} has no "kind" \u2014 every item is a whole op, e.g. {"kind":"google.keyword.add",\u2026}`
-      );
-    }
-    return item.customerId === void 0 && customerId ? { ...item, customerId } : item;
-  });
-}
-function amendBatchEntries(items) {
-  refuseOversized(items.length, "amends");
-  return items.map((item, index) => {
-    const { ref, patch } = item;
-    if (typeof ref !== "string" || ref.length === 0) {
-      failWriteValidation(`item ${index} has no "ref" \u2014 name the staged op (g_temp_* or its target) to amend`);
-    }
-    if (patch === null || typeof patch !== "object" || Array.isArray(patch)) {
-      failWriteValidation(`item ${index} has no "patch" object \u2014 {"ref":"\u2026","patch":{\u2026fields to change\u2026}}`);
-    }
-    return { ref, patch };
-  });
-}
-
-// src/commands/ads/google/draft-validate.ts
-var QUIET = /* @__PURE__ */ new Set(["accepted", "applied"]);
-function changes(n) {
-  return n === 1 ? "1 change" : `${n} changes`;
-}
-function validationHints(data) {
-  const { refused, blocked, unchecked } = data.counts;
-  const hints = [];
-  if (refused > 0) {
-    hints.push(
-      `${changes(refused)} would fail at publish. Fix each refused op in place with \`draft amend <ref>\` (or \`draft remove <ref>\` if it should not exist), then run \`draft validate\` again before asking the user to publish. Never tell the user a refused change will go live.`
-    );
-  }
-  if (blocked > 0) {
-    hints.push(
-      `${changes(blocked)} would not apply only because a refused change they depend on fails \u2014 fixing the refused one clears them.`
-    );
-  }
-  if (data.publishHeld) {
-    hints.push(
-      "Baker would hold this whole publish: a refused change stops a first publish from sending anything. Fix it first."
-    );
-  }
-  if (unchecked > 0) {
-    hints.push(
-      `${changes(unchecked)} can only be checked by Google at publish (the reason is on each one). Nothing here says they will fail.`
-    );
-  }
-  if (refused + blocked === 0 && !data.publishHeld && data.ops.length > 0) {
-    hints.push(
-      "Google accepted every change it was asked about. The draft is ready for the user to review and publish."
-    );
-  }
-  return hints;
-}
-function validationEnvelope(data, full = false) {
-  const ops = full ? data.ops : data.ops.filter((op) => !QUIET.has(op.verdict));
-  return { ok: true, data: { ...data, ops }, hints: validationHints(data) };
-}
-
-// src/commands/ads/google/draft-where.ts
-function parseDraftWhere(value) {
-  const where = { kinds: [], under: [], fields: {} };
-  const pairs = value.split(",").map((pair) => pair.trim()).filter(Boolean);
-  if (pairs.length === 0) return { error: "--where names no condition" };
-  for (const pair of pairs) {
-    const eq = pair.indexOf("=");
-    const key = pair.slice(0, eq).trim();
-    const values = pair.slice(eq + 1).split("|").map((v) => v.trim()).filter(Boolean);
-    if (eq <= 0 || values.length === 0) return { error: `--where condition "${pair}" is not key=value` };
-    if (key === "kind") where.kinds.push(...values.map((k) => k.startsWith("google.") ? k : `google.${k}`));
-    else if (key === "under") where.under.push(...values);
-    else where.fields[key] = [...where.fields[key] ?? [], ...values];
-  }
-  return where;
-}
-function payloadOf(op) {
-  return typeof op.payload === "object" && op.payload !== null ? op.payload : {};
-}
-function parentsOf(op, byRef) {
-  const seen = /* @__PURE__ */ new Set();
-  const queue = [op];
-  for (let current = queue.shift(); current; current = queue.shift()) {
-    const named = Object.values(payloadOf(current)).filter((v) => typeof v === "string");
-    for (const parent of [...current.dependsOn, ...named]) {
-      if (seen.has(parent)) continue;
-      seen.add(parent);
-      const staged = byRef.get(parent);
-      if (staged) queue.push(staged);
-    }
-  }
-  return seen;
-}
-function selectDraftRefs(ops, where) {
-  const byRef = new Map(ops.map((op) => [op.ref, op]));
-  return ops.filter((op) => {
-    if (where.kinds.length > 0 && !where.kinds.includes(op.kind)) return false;
-    if (where.under.length > 0) {
-      const parents = parentsOf(op, byRef);
-      if (!where.under.some((ref) => parents.has(ref))) return false;
-    }
-    const payload = payloadOf(op);
-    return Object.entries(where.fields).every(([key, values]) => {
-      const actual = payload[key];
-      if (typeof actual !== "string" && typeof actual !== "number" && typeof actual !== "boolean") return false;
-      return values.some((v) => v.toLowerCase() === String(actual).toLowerCase());
-    });
-  }).map((op) => op.ref);
-}
-
-// src/commands/ads/google/draft.ts
-var VALIDATE_DESCRIPTION = `Ask Google whether the whole staged draft would publish \u2014 without applying anything.
-
-Start here, after the last staged change and before telling the user the draft is ready:
-  baker ads google draft validate
-
-Every staged op is built, batched and sent exactly as publish sends it, with Google's validateOnly
-flag, so each verdict is the answer publish would get: accepted | refused | blocked (a change it
-depends on was refused) | unchecked (only publish can check it) | applied (an earlier publish did).
-Compact by default \u2014 counts, plus only the ops that need attention, each with Google's reason.
-Fix refused ops with \`draft amend <ref>\` and validate again.
-
-Examples:
-  baker ads google draft validate
-  baker ads google draft validate --full   # every op, with its built request and Google's raw answer`;
-registerSchema({
-  command: "ads.google.draft.validate",
-  description: VALIDATE_DESCRIPTION,
-  args: {
-    full: {
-      type: "boolean",
-      description: "List every op with its built request and Google's raw answer",
-      required: false
-    }
-  }
-});
-var STAGE_DESCRIPTION = `Stage many Google Ads changes from ONE file, in one call \u2014 any mix of kinds, up to 500 ops.
-
-Start here whenever a change touches more than a few rows (a keyword cleanup, bid changes, pausing
-ads, a list of negatives): write the ops to a file and stage them together instead of running one
-command per row.
-  baker ads google draft stage --file changes.json --customer-id 1234567890
-
-The file is a JSON array (or JSON Lines, one op per line). Each op is what the single commands
-build \u2014 kind, customerId (or --customer-id for all), target for a change to something that exists,
-payload. Read the shape for a kind with \`baker capabilities google-ads\`.
-  [
-    {"kind":"google.keyword.add","payload":{"adGroup":"customers/1234567890/adGroups/111","text":"solar panels","matchType":"PHRASE"}},
-    {"kind":"google.keyword.update","target":"customers/1234567890/adGroupCriteria/111~222","payload":{"status":"PAUSED"}},
-    {"kind":"google.negativeKeyword.add","payload":{"level":"campaign","parent":"222333","text":"free","matchType":"BROAD"}}
-  ]
-An op may name a g_temp_* ref an EARLIER call returned (a campaign or ad group staged before), but
-not another op in the same file \u2014 a ref exists only once its op is staged, so stage new parents first.
-All-or-nothing: one invalid op stages nothing. Ops already in effect come back as skipped.
-Then: baker ads google draft validate`;
-registerSchema({
-  command: "ads.google.draft.stage",
-  description: STAGE_DESCRIPTION,
-  args: {
-    file: {
-      type: "string",
-      description: "JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline",
-      required: true
-    },
-    "customer-id": {
-      type: "string",
-      description: "10-digit customer id for every op that does not name its own",
-      required: false
-    }
-  }
-});
-var IMPORT_DESCRIPTION = `Move another open chat's staged Google Ads changes into this chat, in one call \u2014 and out of that chat, so the two can never publish the same change twice.
-
-Start here when the user wants another chat's changes brought into this one ("bring over", "merge",
-"include what the other chat prepared", "all of them except \u2026"):
-  baker ads google draft import --from-chat <chat-id>
-  baker ads google draft import --from-chat <chat-id> --exclude g_temp_a,customers/123/adGroupAds/4~5
-  baker ads google draft import --from-chat <chat-id> --refs g_temp_b
-
-Every op moves exactly as it was staged \u2014 same ref, same payload, nothing retyped \u2014 so never copy
-another chat's changes with \`draft show --chat\` and re-stage them. An op moves with the creates it
-depends on and the ops that depend on it (an asset and the link that attaches it go together).
-The other chat must still be open; its other work (Knowledge, Tasks) stays where it is. Find chat ids
-with \`baker chats list\`, and refs with \`baker ads google draft list --chat <chat-id> --json\`.
-Then: baker ads google draft validate`;
-registerSchema({
-  command: "ads.google.draft.import",
-  description: IMPORT_DESCRIPTION,
-  args: {
-    "from-chat": { type: "string", description: "The other open chat whose staged changes move here", required: true },
-    refs: {
-      type: "string",
-      description: "Comma-separated refs to move (default: all); what they depend on comes too",
-      required: false
-    },
-    exclude: {
-      type: "string",
-      description: "Comma-separated refs to leave in the other chat, with the ops that depend on them",
-      required: false
-    }
-  }
-});
-var LIST_DESCRIPTION = "Review everything staged as a campaign \u25B8 ad group \u25B8 ad tree (--json for the raw envelope, --full for every op's payload too)";
-registerSchema({
-  command: "ads.google.draft.list",
-  description: LIST_DESCRIPTION,
-  args: {
-    json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree", required: false },
-    full: { type: "boolean", description: DRAFT_FULL_ARG.description, required: false },
-    chat: { type: "string", description: CHAT_READ_ARG.description, required: false }
-  }
-});
-var WHERE_ARGS = {
-  where: {
-    type: "string",
-    description: "Select staged ops instead of naming refs: comma-separated key=value \u2014 kind (op kind), under (a campaign/ad group ref or resource name the op sits under), or any payload field (matchType, text, level, parent\u2026); `|` for alternatives",
-    required: false
-  },
-  "dry-run": { type: "boolean", description: "Print the refs that would change, and change nothing", required: false }
-};
-var REMOVE_DESCRIPTION = `Remove staged ops \u2014 one, many, or every op a selector matches, in one call. Each removal cascades to the ops that depend on it.
-
-  baker ads google draft remove g_temp_a
-  baker ads google draft remove g_temp_a g_temp_b g_temp_c     # or g_temp_a,g_temp_b,g_temp_c
-  baker ads google draft remove --where 'kind=google.negativeKeyword.add,text=twilio|baileys'
-  baker ads google draft remove --where kind=google.keyword.add,under=g_temp_c1 --dry-run
-
-Prints one summary: every op removed (cascades listed once), and any ref the draft did not hold.`;
-var REMOVE_ARGS = {
-  ref: {
-    type: "positional",
-    description: "Staged op ref(s) (g_temp_* or target) \u2014 several, space- or comma-separated",
-    required: false
-  },
-  ...WHERE_ARGS
-};
-registerSchema({ command: "ads.google.draft.remove", description: REMOVE_DESCRIPTION, args: REMOVE_ARGS });
-var AMEND_DESCRIPTION = `Update staged ops in place \u2014 merges a JSON patch into each payload (RFC-7386: objects deep-merge, null deletes a key, arrays/scalars replace) and re-validates. Use this instead of remove + re-create.
-
-  baker ads google draft amend g_temp_a --patch '{"cpcBidMicros":1500000}'
-  baker ads google draft amend g_temp_a g_temp_b --patch '{"status":"ENABLED"}'      # same patch, many refs
-  baker ads google draft amend --where kind=google.keyword.add,under=g_temp_c1,matchType=EXACT --patch '{"matchType":"BROAD"}'
-  baker ads google draft amend --file amends.json      # [{"ref":"g_temp_\u2026","patch":{\u2026}}, \u2026] \u2014 a patch per ref
-
-Many refs are amended in one call, all or none: one refused amend changes nothing.`;
-var AMEND_ARGS = {
-  ref: {
-    type: "positional",
-    description: "Staged op ref(s) (g_temp_*) or target id/resource name \u2014 several, space- or comma-separated, take the same patch; leave out to amend many from --file",
-    required: false
-  },
-  file: {
-    type: "string",
-    description: 'JSON file with the patch object \u2014 or, with no ref, a JSON array of {"ref","patch"} amends',
-    required: false
-  },
-  patch: { type: "string", description: "Inline JSON patch object", required: false },
-  ...WHERE_ARGS
-};
-registerSchema({ command: "ads.google.draft.amend", description: AMEND_DESCRIPTION, args: AMEND_ARGS });
-async function refsWhere(args) {
-  if (typeof args.where !== "string") return void 0;
-  const where = parseDraftWhere(args.where);
-  if ("error" in where) failWriteValidation(where.error);
-  if (draftRefs(args._).length > 0) failWriteValidation("pass refs or --where, not both");
-  let ops = [];
-  try {
-    const response = await apiPost("/api/ads/google/draft", {
-      chatId: requireChatId(),
-      full: true
-    });
-    ops = response.data?.ops ?? [];
-  } catch (err) {
-    handleGoogleError(err);
-  }
-  const refs = selectDraftRefs(ops, where);
-  if (refs.length === 0) {
-    writeJsonEnvelope({
-      ok: false,
-      error: {
-        code: "NOT_FOUND",
-        message: `--where ${args.where} matches no staged op`,
-        fix: "Read the staged ops' kinds and payload fields with `baker ads google draft list --full`, then adjust the selector."
-      }
-    });
-    process.exit(1);
-  }
-  return refs;
-}
-function printDryRun(refs) {
-  writeJsonEnvelope({
-    ok: true,
-    data: { matched: refs.length, refs },
-    hints: ["Nothing changed. Run it again without --dry-run to apply it."]
-  });
-}
-function refList(value) {
-  if (typeof value !== "string") return void 0;
-  const refs = value.split(",").map((ref) => ref.trim()).filter((ref) => ref.length > 0);
-  return refs.length > 0 ? refs : null;
-}
-function importHints(fromChatId, data) {
-  const source = data.sourceRemaining > 0 ? `Chat ${fromChatId} still has ${data.sourceRemaining} Google Ads change(s) staged, which publish with that chat.` : `Chat ${fromChatId} has no Google Ads changes staged any more, so publishing it cannot apply these twice. Its other work stays there \u2014 never tell the user to discard it for this.`;
-  return [source, "Run `baker ads google draft validate` next."];
-}
-var BULK_STAGE_HINTS = [
-  "Run `baker ads google draft validate` next: it asks Google about every staged op at once and lists only the ones it would refuse.",
-  'To fix several staged ops, amend them together: `baker ads google draft amend --file amends.json` with [{"ref":"\u2026","patch":{\u2026}}, \u2026].'
-];
-var draftCommand = defineCommand({
-  meta: {
-    name: "draft",
-    description: "Stage many ops from one file, or list, validate, remove, clear, amend, or show staged Google Ads write ops for this chat. `list` and `show` take --chat <id> to read an earlier chat's changes instead; `import --from-chat <id>` moves another open chat's staged changes here."
-  },
-  subCommands: {
-    stage: defineCommand({
-      meta: { name: "stage", description: STAGE_DESCRIPTION },
-      args: {
-        file: {
-          type: "string",
-          description: "JSON array or JSON Lines of ops ({kind, customerId?, target?, payload?}), path or inline"
-        },
-        "customer-id": { type: "string", description: "10-digit customer id for every op that does not name its own" }
-      },
-      run: async ({ args }) => {
-        const customerId = typeof args["customer-id"] === "string" ? args["customer-id"] : void 0;
-        await stageGoogleOps(stageFileOps(loadJsonPayloads(args.file), customerId), BULK_STAGE_HINTS);
-      }
-    }),
-    import: defineCommand({
-      meta: { name: "import", description: IMPORT_DESCRIPTION },
-      args: {
-        "from-chat": { type: "string", description: "The other open chat whose staged changes move here" },
-        refs: { type: "string", description: "Comma-separated refs to move (default: all)" },
-        exclude: { type: "string", description: "Comma-separated refs to leave in the other chat" }
-      },
-      run: async ({ args }) => {
-        const fromChatId = typeof args["from-chat"] === "string" ? args["from-chat"].trim() : "";
-        if (!fromChatId) {
-          writeJsonEnvelope({
-            ok: false,
-            error: {
-              code: "VALIDATION_ERROR",
-              message: "--from-chat is required",
-              fix: "Name the other chat: baker ads google draft import --from-chat <chat-id> (ids from `baker chats list`)."
-            }
-          });
-          process.exit(1);
-        }
-        const refs = refList(args.refs);
-        const exclude = refList(args.exclude);
-        const empty = refs === null ? "--refs" : exclude === null ? "--exclude" : void 0;
-        if (empty) {
-          writeJsonEnvelope({
-            ok: false,
-            error: {
-              code: "VALIDATION_ERROR",
-              message: `${empty} names no change`,
-              fix: `Pass the refs, comma-separated (from \`baker ads google draft list --chat ${fromChatId} --json\`), or leave ${empty} off to move every change.`
-            }
-          });
-          process.exit(1);
-        }
-        try {
-          const response = await apiPost(
-            "/api/ads/google/draft/import",
-            { chatId: requireChatId(), fromChatId, refs: refs ?? void 0, exclude: exclude ?? void 0 }
-          );
-          writeJsonEnvelope(
-            response.ok && response.data ? { ...response, hints: importHints(fromChatId, response.data) } : response
-          );
-        } catch (err) {
-          handleGoogleError(err);
-        }
-      }
-    }),
-    list: defineCommand({
-      meta: {
-        name: "list",
-        description: LIST_DESCRIPTION
-      },
-      args: {
-        json: { type: "boolean", description: "Print the raw JSON envelope instead of the readable tree" },
-        full: DRAFT_FULL_ARG,
-        chat: CHAT_READ_ARG
-      },
-      run: async ({ args }) => {
-        await draftListAction(args.json === true, args.chat, args.full === true);
-      }
-    }),
-    remove: defineCommand({
-      meta: { name: "remove", description: REMOVE_DESCRIPTION },
-      args: REMOVE_ARGS,
-      run: async ({ args }) => {
-        const selected = await refsWhere(args);
-        const refs = selected ?? draftRefs(args._);
-        if (args["dry-run"] === true) {
-          printDryRun(refs);
-          return;
-        }
-        if (selected || refs.length > 1) {
-          await removeDraftRefs("/api/ads/google/draft/remove", refs);
-          return;
-        }
-        await draftAction("/api/ads/google/draft/remove", { ref: requireTarget(args, "op") });
-      }
-    }),
-    clear: defineCommand({
-      meta: { name: "clear", description: "Discard all staged ops on this chat" },
-      run: async () => {
-        await draftAction("/api/ads/google/draft/clear", {});
-      }
-    }),
-    amend: defineCommand({
-      meta: { name: "amend", description: AMEND_DESCRIPTION },
-      args: AMEND_ARGS,
-      run: async ({ args }) => {
-        const selected = await refsWhere(args);
-        const positional = Array.isArray(args._) ? args._[0] : void 0;
-        if (!selected && !(args.ref ?? positional) && typeof args.file === "string" && args.file.length > 0) {
-          const amends = amendBatchEntries(loadJsonPayloads(args.file));
-          if (args["dry-run"] === true) {
-            printDryRun(amends.map((amend) => amend.ref));
-            return;
-          }
-          await draftAction("/api/ads/google/draft/amend-batch", { amends });
-          return;
-        }
-        const refs = selected ?? draftRefs(args._);
-        if (args["dry-run"] === true) {
-          printDryRun(refs);
-          return;
-        }
-        if (selected || refs.length > 1) {
-          const patch2 = loadPatchArg(args);
-          await draftAction("/api/ads/google/draft/amend-batch", { amends: refs.map((ref2) => ({ ref: ref2, patch: patch2 })) });
-          return;
-        }
-        const ref = requireTarget(args, "op");
-        const patch = loadPatchArg(args);
-        await draftAction("/api/ads/google/draft/amend", { ref, patch });
-      }
-    }),
-    validate: defineCommand({
-      meta: { name: "validate", description: VALIDATE_DESCRIPTION },
-      args: {
-        full: { type: "boolean", description: "List every op with its built request and Google's raw answer" }
-      },
-      run: async ({ args }) => {
-        try {
-          const full = args.full === true;
-          const response = await apiPost(
-            "/api/ads/google/draft/validate",
-            { chatId: requireChatId(), full }
-          );
-          writeJsonEnvelope(response.ok && response.data ? validationEnvelope(response.data, full) : response);
-        } catch (err) {
-          handleGoogleError(err);
-        }
-      }
-    }),
-    show: 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)."
-      },
-      args: {
-        ref: {
-          type: "positional",
-          description: "Staged op ref (g_temp_*) or target id/resource name",
-          required: false
-        },
-        chat: CHAT_READ_ARG
-      },
-      run: async ({ args }) => {
-        await draftAction("/api/ads/google/draft/show", { ref: requireTarget(args, "op") }, args.chat);
-      }
-    })
-  }
-});
-export {
-  BULK_STAGE_HINTS,
-  draftCommand,
-  importHints
-};
-//# sourceMappingURL=draft-SGNQOUYH.js.map