@koda-sl/baker-cli 0.501.0 → 0.503.0

package/dist/conversion-writes-7ODJDAUP.js

@@ -0,0 +1,120 @@
+import {
+  compact,
+  lowerArg,
+  schemaArgs,
+  stageChatgptOp
+} from "./chunk-5XTGG4PV.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-M7HD42M6.js";
+import "./chunk-ZRP7Y2DM.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/conversion-writes.ts
+import { defineCommand } from "citty";
+var REFERENCE = CHATGPT_ADS_REFERENCE.conversions;
+var CREATE_ARGS = {
+  name: {
+    type: "string",
+    description: "What the conversion is called in reports, e.g. Quote requests",
+    required: true
+  },
+  event: {
+    type: "string",
+    description: "lead_created, appointment_scheduled, registration_completed, order_created, checkout_started, items_added, contents_viewed, page_viewed, subscription_created, trial_started \u2014 or custom",
+    required: true
+  },
+  "custom-name": {
+    type: "string",
+    description: "With --event custom: the exact event name the site sends (1\u201364 letters, digits, _ or -)"
+  },
+  pixel: {
+    type: "string",
+    description: "The pixel it counts from \u2014 its Pixel ID, its source id, or a pixel staged in this chat (chatgpt_temp_\u2026). Default: the account's only pixel"
+  }
+};
+function conversionCreateOp(args) {
+  return {
+    kind: "conversionEvent.create",
+    payload: compact({
+      name: args.name,
+      eventType: lowerArg(args.event),
+      customEventName: args["custom-name"],
+      sourceId: args.pixel
+    })
+  };
+}
+registerSchema({
+  command: "ads.chatgpt.conversions.create",
+  description: "Stage a conversion \u2014 one event from the account's pixel that ChatGPT Ads counts, standard or custom. Applies when the chat is published; it can never be deleted, and only ChatGPT Ads Manager can rename it. A custom one only measures; a conversions campaign optimises for a standard one.",
+  args: schemaArgs(CREATE_ARGS)
+});
+var conversionsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: `Stage a conversion (applies when the chat is published).
+
+Examples:
+  baker ads chatgpt conversions create --name "Leads" --event lead_created
+  baker ads chatgpt conversions create --name "Quote requests" --event custom --custom-name quote_requested`
+  },
+  args: CREATE_ARGS,
+  run: async ({ args }) => {
+    await stageChatgptOp(conversionCreateOp(args), REFERENCE, (staged) => [
+      `Measure it on a campaign with --conversion-event-ids ${staged.ref} (campaigns create or update).`,
+      "After the publish, trigger the event on the live page and confirm it arrives with `baker ads chatgpt conversions events`."
+    ]);
+  }
+});
+var EVENTS_ARGS = {
+  pixel: { type: "string", description: "Pixel ID or source id (default: the account's only pixel)" }
+};
+registerSchema({
+  command: "ads.chatgpt.conversions.events",
+  description: "The events a pixel delivered to ChatGPT Ads in about the last 15 minutes \u2014 type, custom name, browser or server, when. Proof the site sends them, not attribution: trigger one on the page first.",
+  args: schemaArgs(EVENTS_ARGS)
+});
+function eventHints(recent) {
+  if (recent.events.length === 0) {
+    return [
+      "Nothing arrived in the last 15 minutes. Trigger the event on the live page (load it, submit the form), then read again \u2014 the stream keeps only about 15 minutes."
+    ];
+  }
+  return [];
+}
+var conversionsEventsCommand = defineCommand({
+  meta: {
+    name: "events",
+    description: `What the pixel sent in about the last 15 minutes \u2014 check a conversion really arrives.
+
+Examples:
+  baker ads chatgpt conversions events
+  baker ads chatgpt conversions events --pixel 2bow4Axzw2JK7H44AfsLeY`
+  },
+  args: EVENTS_ARGS,
+  run: async ({ args }) => {
+    await runChatgptRead(
+      REFERENCE,
+      () => apiGet(
+        "/api/ads/chatgpt/conversions/events",
+        typeof args.pixel === "string" && args.pixel ? { pixel: args.pixel } : void 0
+      ),
+      eventHints
+    );
+  }
+});
+export {
+  conversionCreateOp,
+  conversionsCreateCommand,
+  conversionsEventsCommand
+};
+//# sourceMappingURL=conversion-writes-7ODJDAUP.js.map

package/dist/conversions-4IMFJF2J.js

@@ -0,0 +1,138 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-6EJES6SY.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-ZRP7Y2DM.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-AGBBTTKA.js";
+import "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiGet
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/conversions.ts
+import { defineCommand } from "citty";
+var DAY_MS = 864e5;
+function healthOf(rules) {
+  const enabled = rules.filter((r) => r.enabled !== false);
+  const capi = enabled.filter((r) => r.conversionMethod === "CONVERSIONS_API");
+  const pixel = enabled.filter((r) => r.conversionMethod === "PIXEL");
+  const staleCapi = capi.filter(
+    (r) => !r.lastConversionReportedAt || Date.now() - r.lastConversionReportedAt > 7 * DAY_MS
+  );
+  const longView = enabled.filter(
+    (r) => r.viewThroughAttributionWindowSize !== void 0 && r.viewThroughAttributionWindowSize > 7
+  );
+  const leads = enabled.filter((r) => r.type === "LEAD");
+  const wrongDedup = leads.filter((r) => r.countingMethod && r.countingMethod !== "ONE_TIME_EACH_MEMBER");
+  return {
+    totalRules: rules.length,
+    enabledRules: enabled.length,
+    capiRules: capi.length,
+    pixelRules: pixel.length,
+    hasLeadEvent: leads.length > 0,
+    hasPurchaseEvent: enabled.some((r) => r.type === "PURCHASE"),
+    staleCapiRules: staleCapi,
+    longViewWindow: longView,
+    wrongLeadDedup: wrongDedup
+  };
+}
+var listCmd = defineCommand({
+  meta: {
+    name: "list",
+    description: `List conversion rules on the account.`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/conversions", params);
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var healthCmd = defineCommand({
+  meta: {
+    name: "health",
+    description: `5-point Insight Tag / CAPI health check (playbook \xA707).
+
+Surfaces:
+  - Are rules enabled?
+  - Do we have at least one LEAD or PURCHASE event?
+  - Do CAPI rules show recent activity (\u22647 days)?
+  - Is the view-through window \u22647 days?
+  - Do LEAD rules use ONE_TIME_EACH_MEMBER de-dup?`
+  },
+  args: {
+    "account-id": { type: "string", description: "Numeric account ID or urn:li:sponsoredAccount:N" },
+    "account-urn": { type: "string", description: "Alias for --account-id" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json", default: "json" }
+  },
+  run: async ({ args }) => {
+    const accountId = resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const data = await apiGet("/api/ads/linkedin/conversions", params);
+      writeAdsJson({ ok: true, data: healthOf(data) });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+var conversionsCommand = defineCommand({
+  meta: {
+    name: "conversions",
+    description: `Conversion rules \u2014 Insight Tag and Conversions API.
+
+Subcommands:
+  list                \u2014 every rule on the account
+  health              \u2014 playbook \xA707 5-point health check
+  create / update     \u2014 stage a conversion-rule write (applies on chat publish)
+  associate-campaign / dissociate-campaign
+                      \u2014 which ad sets a rule counts for (its own LinkedIn record, not a field on the rule)
+  upload              \u2014 stage CRM / offline conversions (deals won, qualified leads) into a Conversions API rule`
+  },
+  subCommands: {
+    list: listCmd,
+    health: healthCmd,
+    create: () => import("./write-commands-4TV7UNBY.js").then((m) => m.conversionsCreateCommand),
+    update: () => import("./write-commands-4TV7UNBY.js").then((m) => m.conversionsUpdateCommand),
+    "associate-campaign": () => import("./write-commands-4TV7UNBY.js").then((m) => m.conversionsAssociateCommand),
+    "dissociate-campaign": () => import("./write-commands-4TV7UNBY.js").then((m) => m.conversionsDissociateCommand),
+    upload: () => import("./write-commands-4TV7UNBY.js").then((m) => m.conversionsUploadCommand)
+  }
+});
+export {
+  conversionsCommand
+};
+//# sourceMappingURL=conversions-4IMFJF2J.js.map

package/dist/conversions-BKVGNNC6.js

@@ -0,0 +1,76 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-M7HD42M6.js";
+import "./chunk-ZRP7Y2DM.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/conversions.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.chatgpt.conversions",
+  description: "What the connected ChatGPT Ads account measures: its pixels (with the pixel id a landing page installs) and its conversion events (standard type, attribution window, sources, the campaigns using each).",
+  args: {}
+});
+function conversionHints(conversions) {
+  const hints = [];
+  if (conversions.pixels === null) {
+    hints.push(
+      "ChatGPT Ads does not let this account list its pixels through the API. The pixel id is in Ads Manager \u2192 Conversions."
+    );
+  } else if (conversions.pixels.length === 0) {
+    hints.push(
+      "No pixel yet: without one on the landing pages, ChatGPT Ads counts no conversions and cannot optimise for them."
+    );
+  }
+  if (conversions.events.filter((event) => !event.archived).length === 0) {
+    hints.push(
+      "No conversion is defined, so no campaign measures or optimises for one. Stage one with `baker ads chatgpt conversions create`."
+    );
+  }
+  return hints;
+}
+var conversionsListCommand = defineCommand({
+  meta: { name: "list", description: "Pixels and conversions. Example: baker ads chatgpt conversions" },
+  args: {},
+  run: async () => {
+    await runChatgptListRead(
+      CHATGPT_ADS_REFERENCE.conversions,
+      "/api/ads/chatgpt/conversions",
+      void 0,
+      conversionHints
+    );
+  }
+});
+var conversionsCommand = defineCommand({
+  meta: {
+    name: "conversions",
+    description: `What a ChatGPT Ads account measures \u2014 its pixels and conversions \u2014 define a new conversion, and check the pixel's events arrive.
+
+Examples:
+  baker ads chatgpt conversions
+  baker ads chatgpt conversions create --name "Quote requests" --event custom --custom-name quote_requested
+  baker ads chatgpt conversions events
+  baker ads chatgpt conversions report --ids cmpn_123 --days 30   \u2014 click-through and view-through`
+  },
+  subCommands: {
+    list: conversionsListCommand,
+    create: () => import("./conversion-writes-7ODJDAUP.js").then((m) => m.conversionsCreateCommand),
+    events: () => import("./conversion-writes-7ODJDAUP.js").then((m) => m.conversionsEventsCommand),
+    report: () => import("./conversion-report-DKXFHLLX.js").then((m) => m.conversionsReportCommand)
+  },
+  // A parent must never declare `run`: citty falls through to it after the matched subcommand.
+  args: {},
+  default: "list"
+});
+export {
+  conversionHints,
+  conversionsCommand
+};
+//# sourceMappingURL=conversions-BKVGNNC6.js.map

package/dist/copy-writes-JH2AECES.js

@@ -0,0 +1,168 @@
+import {
+  command
+} from "./chunk-YLQWWLCW.js";
+import {
+  bareAccountId,
+  failWriteValidation,
+  parseDateFlag,
+  requireTarget,
+  stageOp,
+  upper
+} from "./chunk-S335LT4B.js";
+import "./chunk-VIPKDXGU.js";
+import "./chunk-GDFJOCDO.js";
+import "./chunk-B2POVFR2.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-KJZPCLQE.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-QPESDKZC.js";
+import "./chunk-Y2JZX6JB.js";
+import "./chunk-ZRP7Y2DM.js";
+import "./chunk-E44NXCTL.js";
+import "./chunk-EJGAJHLB.js";
+import "./chunk-LNNTHEL7.js";
+import "./chunk-FOMFU2RX.js";
+import "./chunk-PSGIHSNC.js";
+import "./chunk-PONLPYD7.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/copy-writes.ts
+var STATUS_WORDS = {
+  PAUSED: "PAUSED",
+  ACTIVE: "ACTIVE",
+  INHERITED: "INHERITED_FROM_SOURCE",
+  INHERITED_FROM_SOURCE: "INHERITED_FROM_SOURCE",
+  SAME: "INHERITED_FROM_SOURCE"
+};
+var RENAME_WORDS = {
+  TOP: "ONLY_TOP_LEVEL_RENAME",
+  ONLY_TOP_LEVEL_RENAME: "ONLY_TOP_LEVEL_RENAME",
+  DEEP: "DEEP_RENAME",
+  ALL: "DEEP_RENAME",
+  DEEP_RENAME: "DEEP_RENAME",
+  NONE: "NO_RENAME",
+  NO_RENAME: "NO_RENAME"
+};
+function mapped(words, value, flag, allowed) {
+  const key = upper(value);
+  if (key === void 0) {
+    return void 0;
+  }
+  const word = words[key];
+  if (!word) {
+    failWriteValidation(`${flag} takes ${allowed}`);
+  }
+  return word;
+}
+function copyPayloadFromFlags(level, args) {
+  const payload = {
+    source_id: args.id,
+    status_option: mapped(STATUS_WORDS, args.status, "--status", "PAUSED, ACTIVE or INHERITED"),
+    rename_strategy: mapped(RENAME_WORDS, args.rename, "--rename", "top, deep or none"),
+    rename_prefix: args["rename-prefix"],
+    rename_suffix: args["rename-suffix"]
+  };
+  if (level !== "ad") {
+    payload.deep_copy = args.deep === true ? true : void 0;
+    payload.start_time = parseDateFlag(args.start, "--start");
+    payload.end_time = parseDateFlag(args.end, "--end");
+  }
+  if (level === "adSet") {
+    payload.campaign_id = args["to-campaign"];
+  }
+  if (level === "ad") {
+    payload.adset_id = args["to-adset"];
+  }
+  return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== void 0));
+}
+var accountArg = { type: "string", description: "Meta ad account ID (act_123)" };
+var naming = {
+  status: {
+    type: "string",
+    description: "PAUSED (default) | ACTIVE \u2014 the copy delivers and spends once published | INHERITED \u2014 the original's"
+  },
+  rename: {
+    type: "string",
+    description: "top (default: only the copied object is renamed) | deep (its ad sets and ads too) | none"
+  },
+  "rename-prefix": { type: "string", description: "Put this before each renamed name" },
+  "rename-suffix": {
+    type: "string",
+    description: `Put this after each renamed name instead of Meta's " - Copy" (in the account's language)`
+  }
+};
+var schedule = {
+  start: { type: "string", description: "When the copied ad sets start (ISO date or datetime); else the original's" },
+  end: { type: "string", description: "When the copied ad sets end; else the original's" }
+};
+var WHEN_TO_COPY = `copy is Meta's own copy: it keeps everything Meta holds \u2014 creatives, placements, every setting Baker cannot read back \u2014 and, with --deep, everything underneath. Use \`duplicate\` instead when the copy must differ in the same step (a new name, budget or targeting); or copy, then change the copy by its ref (\`adsets update <ref> --daily-budget 30\`), which applies once Meta has made it.`;
+function copyArgs(level, label) {
+  const args = {
+    id: { type: "positional", description: `${label} id to copy (a published one)`, required: true },
+    "account-id": accountArg
+  };
+  if (level !== "ad") {
+    const children = level === "campaign" ? "ad sets and ads" : "ads";
+    args.deep = { type: "boolean", description: `Copy its ${children} too (Meta copies at most 51 ads in one go)` };
+  }
+  if (level === "adSet") {
+    args["to-campaign"] = {
+      type: "string",
+      description: "Campaign id or meta_temp_* ref to put the copy in; else beside the original"
+    };
+  }
+  if (level === "ad") {
+    args["to-adset"] = {
+      type: "string",
+      description: "Ad set id or meta_temp_* ref to put the copy in; else beside the original"
+    };
+  }
+  Object.assign(args, naming, level === "ad" ? {} : schedule);
+  return args;
+}
+function copyCommand(level, input) {
+  return command({
+    schema: `ads.meta.${input.family}.copy`,
+    name: "copy",
+    description: `Stage Meta's own copy of a ${input.label}${level === "ad" ? "" : " (with --deep, of everything under it)"}, paused unless --status. Prints a meta_temp_* ref for the copy that later changes in this chat can name. ${WHEN_TO_COPY}
+Example: ${input.extra}`,
+    schemaDescription: `Stage a copy of a Meta ${input.label} through Meta's copies edge \u2014 applied at publish; the copy's ref resolves to its new id.`,
+    args: copyArgs(level, input.label),
+    run: async (args) => {
+      requireTarget(args, input.label);
+      await stageOp({
+        kind: `${level}.copy`,
+        accountId: bareAccountId(args),
+        payload: copyPayloadFromFlags(level, args)
+      });
+    }
+  });
+}
+var campaignsCopyCommand = copyCommand("campaign", {
+  family: "campaigns",
+  label: "campaign",
+  extra: 'baker ads meta campaigns copy 6123 --deep --rename-suffix " \u2013 Q4" --start 2026-11-01'
+});
+var adSetsCopyCommand = copyCommand("adSet", {
+  family: "adsets",
+  label: "ad set",
+  extra: "baker ads meta adsets copy 6124 --deep --to-campaign meta_temp_ab12"
+});
+var adsCopyCommand = copyCommand("ad", {
+  family: "ads",
+  label: "ad",
+  extra: "baker ads meta ads copy 6125 --to-adset 6130"
+});
+export {
+  adSetsCopyCommand,
+  adsCopyCommand,
+  campaignsCopyCommand,
+  copyPayloadFromFlags
+};
+//# sourceMappingURL=copy-writes-JH2AECES.js.map

package/dist/create-BPNXVQEI.js

@@ -0,0 +1,60 @@
+import {
+  failApi,
+  failValidation,
+  writeOk
+} from "./chunk-2VPNX7EZ.js";
+import "./chunk-JDJQKN27.js";
+import "./chunk-CAZGM2NX.js";
+import "./chunk-NZS3KEQ2.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-2TOIY2WN.js";
+import {
+  apiPost
+} from "./chunk-X7VQFLHI.js";
+import "./chunk-LU4HI4KI.js";
+import "./chunk-LGK7UWBN.js";
+import {
+  registerSchema
+} from "./chunk-Q7US4OOA.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/actions/tags/create.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "actions.tags.create",
+  description: "Create a company custom action tag, minting a new slug usable with --tags. The name is slugified (lowercased, spaces\u2192hyphens). Use when no existing tag fits the work.",
+  args: {
+    slug: { type: "string", description: "Tag name/slug (e.g. pmax, retargeting)", required: true },
+    description: { type: "string", description: "What this tag means", required: false }
+  }
+});
+var tagsCreateCommand = defineCommand({
+  meta: {
+    name: "create",
+    description: 'Create a custom action tag. Example: baker actions tags create --slug pmax --description "Performance Max work"'
+  },
+  args: {
+    slug: { type: "string", description: "Tag name/slug", required: false },
+    description: { type: "string", description: "Description", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const slug = args.slug;
+      if (!slug || slug.trim().length === 0) {
+        failValidation("--slug is required.");
+      }
+      const response = await apiPost("/api/actions/tags/create", {
+        name: slug,
+        description: args.description
+      });
+      writeOk(response.data);
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+export {
+  tagsCreateCommand
+};
+//# sourceMappingURL=create-BPNXVQEI.js.map