@koda-sl/baker-cli 0.568.0 → 0.570.0

package/dist/conversion-writes-JZIJSQ7T.js

@@ -0,0 +1,122 @@
+import {
+  compact,
+  lowerArg,
+  schemaArgs,
+  stageChatgptOp
+} from "./chunk-C7KV5O5J.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-H7LKYGLJ.js";
+import "./chunk-MPTNN35I.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiGet
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.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-JZIJSQ7T.js.map

package/dist/conversions-2IFWDQKK.js

@@ -0,0 +1,140 @@
+import {
+  csvOrJson,
+  handleLinkedinError,
+  resolveAccountIdArg
+} from "./chunk-CDPX6WAL.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-MPTNN35I.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-HPF3USL2.js";
+import "./chunk-2Q7K4F4H.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-XHWHBGKX.js";
+import {
+  apiGet
+} from "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import "./chunk-NXNOXZGB.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?.startsWith("INSIGHT_TAG"));
+  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-R42DQEW6.js").then((m) => m.conversionsCreateCommand),
+    update: () => import("./write-commands-R42DQEW6.js").then((m) => m.conversionsUpdateCommand),
+    "associate-campaign": () => import("./write-commands-R42DQEW6.js").then((m) => m.conversionsAssociateCommand),
+    "dissociate-campaign": () => import("./write-commands-R42DQEW6.js").then((m) => m.conversionsDissociateCommand),
+    upload: () => import("./write-commands-R42DQEW6.js").then((m) => m.conversionsUploadCommand)
+  }
+});
+export {
+  conversionsCommand
+};
+//# sourceMappingURL=conversions-2IFWDQKK.js.map

package/dist/conversions-Q5EBTEXA.js

@@ -0,0 +1,78 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptListRead
+} from "./chunk-H7LKYGLJ.js";
+import "./chunk-MPTNN35I.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.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-JZIJSQ7T.js").then((m) => m.conversionsCreateCommand),
+    events: () => import("./conversion-writes-JZIJSQ7T.js").then((m) => m.conversionsEventsCommand),
+    report: () => import("./conversion-report-2FREFML5.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-Q5EBTEXA.js.map

package/dist/copy-writes-JVUX3YDL.js

@@ -0,0 +1,170 @@
+import {
+  command
+} from "./chunk-YAMKCMAS.js";
+import {
+  bareAccountId,
+  failWriteValidation,
+  parseDateFlag,
+  requireTarget,
+  stageOp,
+  upper
+} from "./chunk-2CC4CPDT.js";
+import "./chunk-GC5P4KWY.js";
+import "./chunk-GDFJOCDO.js";
+import "./chunk-4HFM5RCP.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-YRWCXYWW.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-BIBXZJZI.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-MPTNN35I.js";
+import "./chunk-Q3G4ZI2U.js";
+import "./chunk-DGHSXHZR.js";
+import "./chunk-Q736UFSD.js";
+import "./chunk-CBVUO7SK.js";
+import "./chunk-UK4XSLV2.js";
+import "./chunk-O5VSYBUA.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-R7XDGNZD.js";
+import "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import "./chunk-NXNOXZGB.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: await 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-JVUX3YDL.js.map

package/dist/countries-GRCU4IGM.js

@@ -0,0 +1,82 @@
+import {
+  writeResearchJson
+} from "./chunk-MTW2NDDD.js";
+import "./chunk-LJEJCIHR.js";
+import "./chunk-SIRRBWQ2.js";
+import "./chunk-B64KJW5C.js";
+import {
+  registerSchema
+} from "./chunk-NXNOXZGB.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/research/countries.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "research.countries",
+  description: "List all supported country codes for --location flag in research commands.",
+  args: {}
+});
+var COUNTRIES = [
+  { code: "us", name: "United States" },
+  { code: "uk", name: "United Kingdom" },
+  { code: "ca", name: "Canada" },
+  { code: "au", name: "Australia" },
+  { code: "de", name: "Germany" },
+  { code: "fr", name: "France" },
+  { code: "es", name: "Spain" },
+  { code: "it", name: "Italy" },
+  { code: "br", name: "Brazil" },
+  { code: "mx", name: "Mexico" },
+  { code: "nl", name: "Netherlands" },
+  { code: "be", name: "Belgium" },
+  { code: "at", name: "Austria" },
+  { code: "ch", name: "Switzerland" },
+  { code: "pt", name: "Portugal" },
+  { code: "se", name: "Sweden" },
+  { code: "no", name: "Norway" },
+  { code: "dk", name: "Denmark" },
+  { code: "fi", name: "Finland" },
+  { code: "ie", name: "Ireland" },
+  { code: "nz", name: "New Zealand" },
+  { code: "in", name: "India" },
+  { code: "jp", name: "Japan" },
+  { code: "kr", name: "South Korea" },
+  { code: "sg", name: "Singapore" },
+  { code: "ar", name: "Argentina" },
+  { code: "cl", name: "Chile" },
+  { code: "co", name: "Colombia" },
+  { code: "pe", name: "Peru" },
+  { code: "pl", name: "Poland" },
+  { code: "cz", name: "Czech Republic" },
+  { code: "ro", name: "Romania" },
+  { code: "hu", name: "Hungary" },
+  { code: "za", name: "South Africa" },
+  { code: "il", name: "Israel" },
+  { code: "ae", name: "United Arab Emirates" },
+  { code: "sa", name: "Saudi Arabia" },
+  { code: "tr", name: "Turkey" },
+  { code: "ph", name: "Philippines" },
+  { code: "th", name: "Thailand" },
+  { code: "my", name: "Malaysia" },
+  { code: "id", name: "Indonesia" },
+  { code: "vn", name: "Vietnam" },
+  { code: "tw", name: "Taiwan" },
+  { code: "hk", name: "Hong Kong" }
+];
+var FIELDS = {
+  code: "Country code to pass as --location",
+  name: "Country name"
+};
+var countriesCommand = defineCommand({
+  meta: {
+    name: "countries",
+    description: "List all supported country codes for --location flag."
+  },
+  run: () => {
+    writeResearchJson({ ok: true, data: COUNTRIES, fields: FIELDS });
+  }
+});
+export {
+  countriesCommand
+};
+//# sourceMappingURL=countries-GRCU4IGM.js.map