@koda-sl/baker-cli 0.387.0 → 0.389.0-dev.8065ad8f0

package/dist/content-UYZC4AKN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/winning-ads/content.ts"],"sourcesContent":["import type { AdContentResponse } from \"@baker/api/ad-library\";\nimport { defineCommand } from \"citty\";\nimport { apiGet } from \"../../client.ts\";\nimport { adContentNormalizer, applyFieldMask, type OutputFormat, writeJson, writeOutput } from \"../../output.ts\";\nimport { registerSchema } from \"../../schemas.ts\";\nimport { reportError, splitList } from \"./shared.ts\";\n\nregisterSchema({\n  command: \"winning-ads.content\",\n  description:\n    \"Read what's INSIDE one winning ad: the spoken transcript, the on-screen text, and the ad copy. Use this after `search`/`winners`/`feed` return a shortlist — pass an ad_id to understand a reference before reproducing it. Static and carousel ads return the text drawn into the image with the job each piece does (headline, benefit, cta…), the card it sits on, and their format_pattern. It also says where the ad is in its life (stage: new, testing, proven, evergreen, killed_early, retired, unverified) and, when it is one version of a concept its brand tested, the test: whether this version was kept or cut and what the kept one did differently. Add --full for how it is built (composition, colours, CTA, markers), how it persuades (awareness, mechanism, pains, desires, proof, objections), what it offers (offer type, price, guarantee, urgency), plus speech, pacing and soundtrack for video.\",\n  args: {\n    \"ad-id\": { type: \"string\", description: \"The ad id to open (from search/winners/feed results)\", required: true },\n    platform: {\n      type: \"string\",\n      description: \"Which platform the ad id is on: meta|linkedin|tiktok|google (default meta)\",\n      required: false,\n    },\n  },\n});\n\nexport const contentCommand = defineCommand({\n  meta: {\n    name: \"content\",\n    description:\n      \"Read the transcript + on-screen text + copy of one winning ad; --full adds its build, persuasion and offer. Example: baker winning-ads content adg_123 --platform meta --full --output md\",\n  },\n  args: {\n    \"ad-id\": { type: \"positional\", description: \"Ad id (from search/winners/feed)\", required: true },\n    platform: {\n      type: \"string\",\n      description: \"Platform the ad id is on: meta|linkedin|tiktok|google (default meta)\",\n      required: false,\n    },\n    output: { type: \"string\", description: \"Output format: json|files|md\", required: false, default: \"json\" },\n    fields: { type: \"string\", description: \"Comma-separated field names to include\", required: false },\n    full: {\n      type: \"boolean\",\n      description:\n        \"Include build (layout, colours, CTA), persuasion (awareness, pains, proof), offer, and video speech/pacing/soundtrack\",\n      required: false,\n      default: false,\n    },\n  },\n  run: async ({ args }) => {\n    try {\n      const params: Record<string, string> = { id: String(args[\"ad-id\"]) };\n      if (args.platform) {\n        params.platform = String(args.platform);\n      }\n\n      const data = await apiGet<AdContentResponse>(\"/api/ad-library/ad-content\", params);\n      const output = (args.output as OutputFormat) || \"json\";\n      const full = args.full as boolean;\n      const ad = (data?.ad ?? {}) as unknown as Record<string, unknown>;\n\n      // Project to the lean/decision set for EVERY format (incl. json) so the\n      // agent's context only ever holds what it needs to understand the ad.\n      if (output === \"json\") {\n        const fields = splitList(args.fields as string | undefined);\n        const read = adContentNormalizer(ad, full);\n        writeJson({ ok: true, data: { ad: fields.length > 0 ? applyFieldMask(read, fields) : read } });\n        return;\n      }\n      writeOutput(\n        { ok: true, data: ad },\n        output,\n        args.fields ? (args.fields as string).split(\",\") : undefined,\n        full,\n        adContentNormalizer,\n      );\n    } catch (err) {\n      reportError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;AACA,SAAS,qBAAqB;AAM9B,eAAe;AAAA,EACb,SAAS;AAAA,EACT,aACE;AAAA,EACF,MAAM;AAAA,IACJ,SAAS,EAAE,MAAM,UAAU,aAAa,wDAAwD,UAAU,KAAK;AAAA,IAC/G,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,EACF;AACF,CAAC;AAEM,IAAM,iBAAiB,cAAc;AAAA,EAC1C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,SAAS,EAAE,MAAM,cAAc,aAAa,oCAAoC,UAAU,KAAK;AAAA,IAC/F,UAAU;AAAA,MACR,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,QAAQ,EAAE,MAAM,UAAU,aAAa,gCAAgC,UAAU,OAAO,SAAS,OAAO;AAAA,IACxG,QAAQ,EAAE,MAAM,UAAU,aAAa,0CAA0C,UAAU,MAAM;AAAA,IACjG,MAAM;AAAA,MACJ,MAAM;AAAA,MACN,aACE;AAAA,MACF,UAAU;AAAA,MACV,SAAS;AAAA,IACX;AAAA,EACF;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,QAAI;AACF,YAAM,SAAiC,EAAE,IAAI,OAAO,KAAK,OAAO,CAAC,EAAE;AACnE,UAAI,KAAK,UAAU;AACjB,eAAO,WAAW,OAAO,KAAK,QAAQ;AAAA,MACxC;AAEA,YAAM,OAAO,MAAM,OAA0B,8BAA8B,MAAM;AACjF,YAAM,SAAU,KAAK,UAA2B;AAChD,YAAM,OAAO,KAAK;AAClB,YAAM,KAAM,MAAM,MAAM,CAAC;AAIzB,UAAI,WAAW,QAAQ;AACrB,cAAM,SAAS,UAAU,KAAK,MAA4B;AAC1D,cAAM,OAAO,oBAAoB,IAAI,IAAI;AACzC,kBAAU,EAAE,IAAI,MAAM,MAAM,EAAE,IAAI,OAAO,SAAS,IAAI,eAAe,MAAM,MAAM,IAAI,KAAK,EAAE,CAAC;AAC7F;AAAA,MACF;AACA;AAAA,QACE,EAAE,IAAI,MAAM,MAAM,GAAG;AAAA,QACrB;AAAA,QACA,KAAK,SAAU,KAAK,OAAkB,MAAM,GAAG,IAAI;AAAA,QACnD;AAAA,QACA;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,kBAAY,GAAG;AAAA,IACjB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/conversation-Y3NB2VDI.js

@@ -0,0 +1,93 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-7F7MFMLI.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-BVM5IRZW.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-EF5DP6EB.js";
+import "./chunk-SMIENBNX.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-UI6BKYQD.js";
+import "./chunk-XX6ZMCY5.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/linkedin/conversation.ts
+import { defineCommand } from "citty";
+var conversationCommand = defineCommand({
+  meta: {
+    name: "conversation",
+    description: `Per-button click rates inside Sponsored Messaging / Conversation Ads.
+
+Returns one row per CONVERSATION_NODE_BUTTON pivot, sorted by clicks desc.
+Use this to A/B test button copy and the cascade tree.
+
+Examples:
+  baker ads linkedin conversation --campaign-id 1234
+  baker ads linkedin conversation --campaign-id 1234 --last-days 30 --output csv`
+  },
+  args: {
+    "campaign-id": {
+      type: "string",
+      description: "Comma-separated campaign IDs (Conversation Ad campaigns)",
+      required: true
+    },
+    start: { type: "string", description: "Start date YYYY-MM-DD" },
+    end: { type: "string", description: "End date YYYY-MM-DD" },
+    "last-days": { type: "string", description: "Window relative to today (default: 30)" },
+    "no-cache": NO_CACHE_ARG,
+    output: { type: "string", description: "json|csv|jsonl|md", default: "json" }
+  },
+  run: async ({ args }) => {
+    const campaignIdsRaw = args["campaign-id"];
+    if (!campaignIdsRaw) {
+      handleLinkedinError(new Error("--campaign-id is required"));
+    }
+    const ids = campaignIdsRaw.split(",").map((s) => s.trim()).filter(Boolean);
+    const start = args.start ?? daysAgoIso(args["last-days"] ? Number(args["last-days"]) : 30);
+    const end = args.end ?? todayIso();
+    try {
+      const data = await apiPost("/api/ads/linkedin/analytics", {
+        request: {
+          level: "campaign",
+          ids,
+          intent: "inmail",
+          pivot: "conversation-node-button",
+          start,
+          end,
+          granularity: "ALL",
+          limit: 500
+        },
+        skipCache: Boolean(args["no-cache"])
+      });
+      const sorted = [...data.rows].sort((a, b) => Number(b.clicks ?? 0) - Number(a.clicks ?? 0));
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(sorted, fmt, data.fields);
+        return;
+      }
+      writeAdsJson({
+        ok: true,
+        data: { query: { campaigns: ids, start, end }, rows: sorted, warnings: data.warnings }
+      });
+    } catch (err) {
+      handleLinkedinError(err);
+    }
+  }
+});
+export {
+  conversationCommand
+};
+//# sourceMappingURL=conversation-Y3NB2VDI.js.map

package/dist/conversation-Y3NB2VDI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/linkedin/conversation.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiPost } from \"../../../client.ts\";\nimport { writeAdsJson, writeAdsOutput } from \"../output.ts\";\nimport { csvOrJson, daysAgoIso, handleLinkedinError, todayIso } from \"./shared.ts\";\n\ninterface AnalyticsResponse {\n  rows: Array<Record<string, unknown>>;\n  fields: string[];\n  warnings: Array<{ code: string; message: string }>;\n}\n\n/**\n * Conversation Ads (Sponsored Messaging) per-button analytics. Wraps\n * --pivot conversation-node-button on /api/ads/linkedin/analytics.\n *\n * Lets agents see which CTA button inside a multi-step Sponsored Message\n * actually drives clicks — no other ad platform exposes this granularity.\n */\nexport const conversationCommand = defineCommand({\n  meta: {\n    name: \"conversation\",\n    description: `Per-button click rates inside Sponsored Messaging / Conversation Ads.\n\nReturns one row per CONVERSATION_NODE_BUTTON pivot, sorted by clicks desc.\nUse this to A/B test button copy and the cascade tree.\n\nExamples:\n  baker ads linkedin conversation --campaign-id 1234\n  baker ads linkedin conversation --campaign-id 1234 --last-days 30 --output csv`,\n  },\n  args: {\n    \"campaign-id\": {\n      type: \"string\",\n      description: \"Comma-separated campaign IDs (Conversation Ad campaigns)\",\n      required: true,\n    },\n    start: { type: \"string\", description: \"Start date YYYY-MM-DD\" },\n    end: { type: \"string\", description: \"End date YYYY-MM-DD\" },\n    \"last-days\": { type: \"string\", description: \"Window relative to today (default: 30)\" },\n    \"no-cache\": NO_CACHE_ARG,\n    output: { type: \"string\", description: \"json|csv|jsonl|md\", default: \"json\" },\n  },\n  run: async ({ args }) => {\n    const campaignIdsRaw = args[\"campaign-id\"] as string | undefined;\n    if (!campaignIdsRaw) {\n      handleLinkedinError(new Error(\"--campaign-id is required\"));\n    }\n    const ids = campaignIdsRaw\n      .split(\",\")\n      .map((s) => s.trim())\n      .filter(Boolean);\n    const start = (args.start as string | undefined) ?? daysAgoIso(args[\"last-days\"] ? Number(args[\"last-days\"]) : 30);\n    const end = (args.end as string | undefined) ?? todayIso();\n\n    try {\n      const data = await apiPost<AnalyticsResponse>(\"/api/ads/linkedin/analytics\", {\n        request: {\n          level: \"campaign\",\n          ids,\n          intent: \"inmail\",\n          pivot: \"conversation-node-button\",\n          start,\n          end,\n          granularity: \"ALL\",\n          limit: 500,\n        },\n        skipCache: Boolean(args[\"no-cache\"]),\n      });\n      const sorted = [...data.rows].sort((a, b) => Number(b.clicks ?? 0) - Number(a.clicks ?? 0));\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(sorted, fmt, data.fields);\n        return;\n      }\n      writeAdsJson({\n        ok: true,\n        data: { query: { campaigns: ids, start, end }, rows: sorted, warnings: data.warnings },\n      });\n    } catch (err) {\n      handleLinkedinError(err);\n    }\n  },\n});\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAS,qBAAqB;AAmBvB,IAAM,sBAAsB,cAAc;AAAA,EAC/C,MAAM;AAAA,IACJ,MAAM;AAAA,IACN,aAAa;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQf;AAAA,EACA,MAAM;AAAA,IACJ,eAAe;AAAA,MACb,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ;AAAA,IACA,OAAO,EAAE,MAAM,UAAU,aAAa,wBAAwB;AAAA,IAC9D,KAAK,EAAE,MAAM,UAAU,aAAa,sBAAsB;AAAA,IAC1D,aAAa,EAAE,MAAM,UAAU,aAAa,yCAAyC;AAAA,IACrF,YAAY;AAAA,IACZ,QAAQ,EAAE,MAAM,UAAU,aAAa,qBAAqB,SAAS,OAAO;AAAA,EAC9E;AAAA,EACA,KAAK,OAAO,EAAE,KAAK,MAAM;AACvB,UAAM,iBAAiB,KAAK,aAAa;AACzC,QAAI,CAAC,gBAAgB;AACnB,0BAAoB,IAAI,MAAM,2BAA2B,CAAC;AAAA,IAC5D;AACA,UAAM,MAAM,eACT,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AACjB,UAAM,QAAS,KAAK,SAAgC,WAAW,KAAK,WAAW,IAAI,OAAO,KAAK,WAAW,CAAC,IAAI,EAAE;AACjH,UAAM,MAAO,KAAK,OAA8B,SAAS;AAEzD,QAAI;AACF,YAAM,OAAO,MAAM,QAA2B,+BAA+B;AAAA,QAC3E,SAAS;AAAA,UACP,OAAO;AAAA,UACP;AAAA,UACA,QAAQ;AAAA,UACR,OAAO;AAAA,UACP;AAAA,UACA;AAAA,UACA,aAAa;AAAA,UACb,OAAO;AAAA,QACT;AAAA,QACA,WAAW,QAAQ,KAAK,UAAU,CAAC;AAAA,MACrC,CAAC;AACD,YAAM,SAAS,CAAC,GAAG,KAAK,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,EAAE,UAAU,CAAC,IAAI,OAAO,EAAE,UAAU,CAAC,CAAC;AAC1F,YAAM,MAAM,UAAU,IAAI;AAC1B,UAAI,QAAQ,QAAQ;AAClB,uBAAe,QAAQ,KAAK,KAAK,MAAM;AACvC;AAAA,MACF;AACA,mBAAa;AAAA,QACX,IAAI;AAAA,QACJ,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,IAAI,GAAG,MAAM,QAAQ,UAAU,KAAK,SAAS;AAAA,MACvF,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,0BAAoB,GAAG;AAAA,IACzB;AAAA,EACF;AACF,CAAC;","names":[]}

package/dist/conversion-report-R4GJWWTK.js

@@ -0,0 +1,125 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  CHATGPT_CONVERSION_REPORT_LEVELS,
+  chatgptAdsConversionReportRequestSchema,
+  numberArg,
+  reportCsvArg,
+  runChatgptRead,
+  stringArg
+} from "./chunk-IOCSDFF2.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-BVM5IRZW.js";
+import {
+  apiPost
+} from "./chunk-HREWXNTO.js";
+import "./chunk-HLXWKMTK.js";
+import "./chunk-O6QKCJE4.js";
+import {
+  registerSchema
+} from "./chunk-WOTDHRNF.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/chatgpt/conversion-report.ts
+import { defineCommand } from "citty";
+var ARGS = {
+  level: {
+    type: "string",
+    description: `What one row is: ${CHATGPT_CONVERSION_REPORT_LEVELS.join("|")} (default campaign)`
+  },
+  ids: {
+    type: "string",
+    description: "Campaign, ad group or ad ids, comma-separated \u2014 one row each. Left out: one total for the account"
+  },
+  days: { type: "string", description: "Last N complete days, ending the account's yesterday (default 7, max 365)" },
+  since: { type: "string", description: "First day, YYYY-MM-DD, account timezone (instead of --days)" },
+  until: { type: "string", description: "Last day, inclusive, YYYY-MM-DD" },
+  granularity: { type: "string", description: "none (default: one total) | daily" },
+  segment: { type: "string", description: "Break rows down by device or country" },
+  "click-window": { type: "string", description: "Days after a click that count: 7, 14 or 30 (default 30)" },
+  "view-window": { type: "string", description: "Days after a view that count: 1 (default) or 0 to leave views out" },
+  events: {
+    type: "string",
+    description: "Event names to detail, comma-separated, as the site sends them \u2014 goal or not (implies --with-events)"
+  },
+  "with-events": { type: "boolean", description: "Detail every attributed event, not just goal conversions" }
+};
+function conversionReportRequestFromArgs(args) {
+  return {
+    level: stringArg(args, "level"),
+    ids: reportCsvArg(args, "ids"),
+    since: stringArg(args, "since"),
+    until: stringArg(args, "until"),
+    days: numberArg(args, "days"),
+    granularity: stringArg(args, "granularity"),
+    segment: stringArg(args, "segment"),
+    clickWindowDays: numberArg(args, "click-window"),
+    viewWindowDays: numberArg(args, "view-window"),
+    events: reportCsvArg(args, "events"),
+    withEvents: args["with-events"] === true ? true : void 0
+  };
+}
+function reportHints(report) {
+  const nothing = report.rows.every((row) => row.conversions === 0 && (row.events ?? []).length === 0);
+  return nothing ? [
+    "No attributed conversions in this window. Before concluding the ads do not convert: `conversions events` shows whether the site's events arrive at all, and `campaigns` whether anything served."
+  ] : [
+    `Counted with a ${report.clickWindowDays}-day click and ${report.viewWindowDays}-day view window; a conversion eligible for both counts once, as a click. The latest days are still filling in.`
+  ];
+}
+registerSchema({
+  command: "ads.chatgpt.conversions.report",
+  description: "Conversions ChatGPT Ads attributes to campaigns, ad groups or ads: goal conversions split into click-through and view-through, purchase value, and optionally every attributed event (goal or not), per day and by device or country, with the click (7/14/30) and view (0/1) windows chosen. At most 365 days.",
+  args: {
+    level: { type: "string", description: ARGS.level.description, required: false },
+    ids: { type: "string", description: ARGS.ids.description, required: false },
+    days: { type: "string", description: ARGS.days.description, required: false },
+    since: { type: "string", description: ARGS.since.description, required: false },
+    until: { type: "string", description: ARGS.until.description, required: false },
+    granularity: { type: "string", description: ARGS.granularity.description, required: false },
+    segment: { type: "string", description: ARGS.segment.description, required: false },
+    "click-window": { type: "string", description: ARGS["click-window"].description, required: false },
+    "view-window": { type: "string", description: ARGS["view-window"].description, required: false },
+    events: { type: "string", description: ARGS.events.description, required: false },
+    "with-events": { type: "boolean", description: ARGS["with-events"].description, required: false }
+  }
+});
+var conversionsReportCommand = defineCommand({
+  meta: {
+    name: "report",
+    description: `Conversions ChatGPT Ads attributes, click-through beside view-through.
+
+Examples:
+  baker ads chatgpt conversions report                                   # account total, last 7 days
+  baker ads chatgpt conversions report --ids cmpn_1,cmpn_2 --days 30 --segment device
+  baker ads chatgpt conversions report --view-window 0 --click-window 7   # clicks only, 7-day window
+  baker ads chatgpt conversions report --events quote_requested --granularity daily`
+  },
+  args: ARGS,
+  run: async ({ args }) => {
+    const parsed = chatgptAdsConversionReportRequestSchema.safeParse(conversionReportRequestFromArgs(args));
+    if (!parsed.success) {
+      const message = parsed.error.issues[0]?.message ?? "Invalid conversion report request";
+      writeJsonEnvelope({
+        ok: false,
+        error: {
+          code: "VALIDATION_ERROR",
+          message,
+          fix: { action: "retry_with_modified_query", explanation: message },
+          retryable: false
+        }
+      });
+      process.exit(1);
+    }
+    await runChatgptRead(
+      CHATGPT_ADS_REFERENCE.conversions,
+      () => apiPost("/api/ads/chatgpt/conversions/report", parsed.data),
+      reportHints
+    );
+  }
+});
+export {
+  conversionReportRequestFromArgs,
+  conversionsReportCommand
+};
+//# sourceMappingURL=conversion-report-R4GJWWTK.js.map

package/dist/conversion-report-R4GJWWTK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/chatgpt/conversion-report.ts"],"sourcesContent":["import {\n  CHATGPT_CONVERSION_REPORT_LEVELS,\n  type ChatgptAdsConversionReport,\n  type ChatgptAdsConversionReportRequestInput,\n  chatgptAdsConversionReportRequestSchema,\n} from \"@baker/api/ads-chatgpt\";\nimport { defineCommand } from \"citty\";\nimport { apiPost } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeJsonEnvelope } from \"../output.ts\";\nimport { CHATGPT_ADS_REFERENCE, numberArg, reportCsvArg, runChatgptRead, stringArg } from \"./shared.ts\";\n\n/**\n * Conversions as ChatGPT Ads attributes them: goal conversions split into\n * click-through and view-through under the windows chosen, and — asked for —\n * every attributed event, goal or not. The general `insights` report has\n * spend beside conversions; this one has the attribution detail.\n */\n\nconst ARGS = {\n  level: {\n    type: \"string\",\n    description: `What one row is: ${CHATGPT_CONVERSION_REPORT_LEVELS.join(\"|\")} (default campaign)`,\n  },\n  ids: {\n    type: \"string\",\n    description: \"Campaign, ad group or ad ids, comma-separated — one row each. Left out: one total for the account\",\n  },\n  days: { type: \"string\", description: \"Last N complete days, ending the account's yesterday (default 7, max 365)\" },\n  since: { type: \"string\", description: \"First day, YYYY-MM-DD, account timezone (instead of --days)\" },\n  until: { type: \"string\", description: \"Last day, inclusive, YYYY-MM-DD\" },\n  granularity: { type: \"string\", description: \"none (default: one total) | daily\" },\n  segment: { type: \"string\", description: \"Break rows down by device or country\" },\n  \"click-window\": { type: \"string\", description: \"Days after a click that count: 7, 14 or 30 (default 30)\" },\n  \"view-window\": { type: \"string\", description: \"Days after a view that count: 1 (default) or 0 to leave views out\" },\n  events: {\n    type: \"string\",\n    description: \"Event names to detail, comma-separated, as the site sends them — goal or not (implies --with-events)\",\n  },\n  \"with-events\": { type: \"boolean\", description: \"Detail every attributed event, not just goal conversions\" },\n} as const;\n\nexport function conversionReportRequestFromArgs(args: Record<string, unknown>): ChatgptAdsConversionReportRequestInput {\n  return {\n    level: stringArg(args, \"level\") as ChatgptAdsConversionReportRequestInput[\"level\"],\n    ids: reportCsvArg(args, \"ids\"),\n    since: stringArg(args, \"since\"),\n    until: stringArg(args, \"until\"),\n    days: numberArg(args, \"days\"),\n    granularity: stringArg(args, \"granularity\") as ChatgptAdsConversionReportRequestInput[\"granularity\"],\n    segment: stringArg(args, \"segment\") as ChatgptAdsConversionReportRequestInput[\"segment\"],\n    clickWindowDays: numberArg(args, \"click-window\") as ChatgptAdsConversionReportRequestInput[\"clickWindowDays\"],\n    viewWindowDays: numberArg(args, \"view-window\") as ChatgptAdsConversionReportRequestInput[\"viewWindowDays\"],\n    events: reportCsvArg(args, \"events\"),\n    withEvents: args[\"with-events\"] === true ? true : undefined,\n  };\n}\n\nfunction reportHints(report: ChatgptAdsConversionReport): string[] {\n  const nothing = report.rows.every((row) => row.conversions === 0 && (row.events ?? []).length === 0);\n  return nothing\n    ? [\n        \"No attributed conversions in this window. Before concluding the ads do not convert: `conversions events` shows whether the site's events arrive at all, and `campaigns` whether anything served.\",\n      ]\n    : [\n        `Counted with a ${report.clickWindowDays}-day click and ${report.viewWindowDays}-day view window; a conversion eligible for both counts once, as a click. The latest days are still filling in.`,\n      ];\n}\n\nregisterSchema({\n  command: \"ads.chatgpt.conversions.report\",\n  description:\n    \"Conversions ChatGPT Ads attributes to campaigns, ad groups or ads: goal conversions split into click-through and view-through, purchase value, and optionally every attributed event (goal or not), per day and by device or country, with the click (7/14/30) and view (0/1) windows chosen. At most 365 days.\",\n  args: {\n    level: { type: \"string\", description: ARGS.level.description, required: false },\n    ids: { type: \"string\", description: ARGS.ids.description, required: false },\n    days: { type: \"string\", description: ARGS.days.description, required: false },\n    since: { type: \"string\", description: ARGS.since.description, required: false },\n    until: { type: \"string\", description: ARGS.until.description, required: false },\n    granularity: { type: \"string\", description: ARGS.granularity.description, required: false },\n    segment: { type: \"string\", description: ARGS.segment.description, required: false },\n    \"click-window\": { type: \"string\", description: ARGS[\"click-window\"].description, required: false },\n    \"view-window\": { type: \"string\", description: ARGS[\"view-window\"].description, required: false },\n    events: { type: \"string\", description: ARGS.events.description, required: false },\n    \"with-events\": { type: \"boolean\", description: ARGS[\"with-events\"].description, required: false },\n  },\n});\n\nexport const conversionsReportCommand = defineCommand({\n  meta: {\n    name: \"report\",\n    description: `Conversions ChatGPT Ads attributes, click-through beside view-through.\n\nExamples:\n  baker ads chatgpt conversions report                                   # account total, last 7 days\n  baker ads chatgpt conversions report --ids cmpn_1,cmpn_2 --days 30 --segment device\n  baker ads chatgpt conversions report --view-window 0 --click-window 7   # clicks only, 7-day window\n  baker ads chatgpt conversions report --events quote_requested --granularity daily`,\n  },\n  args: ARGS,\n  run: async ({ args }) => {\n    const parsed = chatgptAdsConversionReportRequestSchema.safeParse(conversionReportRequestFromArgs(args));\n    if (!parsed.success) {\n      const message = parsed.error.issues[0]?.message ?? \"Invalid conversion report request\";\n      writeJsonEnvelope({\n        ok: false,\n        error: {\n          code: \"VALIDATION_ERROR\",\n          message,\n          fix: { action: \"retry_with_modified_query\", explanation: message },\n          retryable: false,\n        },\n      });\n      process.exit(1);\n    }\n    await runChatgptRead(\n      CHATGPT_ADS_REFERENCE.conversions,\n      () => apiPost<ChatgptAdsConversionReport>(\"/api/ads/chatgpt/conversions/report\", parsed.data),\n      reportHints,\n    );\n  },\n});\n"],"mappings":"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","names":[]}