@koda-sl/baker-cli 0.458.0 → 0.459.0

package/dist/conversation-DCV3XLVJ.js

@@ -0,0 +1,92 @@
+import {
+  csvOrJson,
+  daysAgoIso,
+  handleLinkedinError,
+  todayIso
+} from "./chunk-QNEKQWJS.js";
+import {
+  writeAdsJson,
+  writeAdsOutput
+} from "./chunk-OAYHDIW2.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-X7ZODEXJ.js";
+import "./chunk-ZJVHZHYP.js";
+import "./chunk-GXDLWBOY.js";
+import "./chunk-XQIOCIDO.js";
+import "./chunk-ML7DLFFY.js";
+import {
+  apiPost
+} from "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import "./chunk-USFTTDIO.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-DCV3XLVJ.js.map

package/dist/conversation-DCV3XLVJ.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-5KFFJ2VU.js

@@ -0,0 +1,125 @@
+import {
+  CHATGPT_ADS_REFERENCE,
+  CHATGPT_CONVERSION_REPORT_LEVELS,
+  chatgptAdsConversionReportRequestSchema,
+  numberArg,
+  reportCsvArg,
+  runChatgptRead,
+  stringArg
+} from "./chunk-XN2OQQXR.js";
+import {
+  writeJsonEnvelope
+} from "./chunk-OAYHDIW2.js";
+import {
+  apiPost
+} from "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import {
+  registerSchema
+} from "./chunk-USFTTDIO.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-5KFFJ2VU.js.map

package/dist/conversion-upload-command-JU6ZSJBV.js

@@ -0,0 +1,438 @@
+import {
+  failWriteValidation,
+  requireCustomerId,
+  stageGoogleOps
+} from "./chunk-J2UCNSRR.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-WVABBPSH.js";
+import "./chunk-4NZ47VXO.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-SKAB7IBX.js";
+import "./chunk-7VHPAGPK.js";
+import "./chunk-OAYHDIW2.js";
+import "./chunk-OB6QMAE3.js";
+import "./chunk-S4EYRHCD.js";
+import "./chunk-3L4P5X7N.js";
+import "./chunk-JBDX74X5.js";
+import "./chunk-ULPPKJQH.js";
+import "./chunk-IK56IWZC.js";
+import "./chunk-XQIOCIDO.js";
+import {
+  CONVERSION_UPLOAD_MAX_ROWS
+} from "./chunk-ML7DLFFY.js";
+import "./chunk-NUHMHZTZ.js";
+import "./chunk-CE6IE364.js";
+import "./chunk-3XA4JVMY.js";
+import "./chunk-USFTTDIO.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/conversion-upload-command.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+
+// src/commands/ads/google/conversion-rows.ts
+var COLUMN_ALIASES = {
+  orderId: ["orderid", "order", "ordernumber", "transactionid", "transaction", "submissionid", "conversionid", "id"],
+  conversionDateTime: [
+    "conversiondatetime",
+    "conversiontime",
+    "conversiondate",
+    "datetime",
+    "date",
+    "time",
+    "timestamp",
+    "occurredat",
+    "createdat"
+  ],
+  gclid: ["gclid"],
+  gbraid: ["gbraid"],
+  wbraid: ["wbraid"],
+  email: ["email", "emailaddress", "useremail", "mail"],
+  phone: ["phone", "phonenumber", "telephone", "mobile", "tel"],
+  value: ["value", "conversionvalue", "amount", "revenue", "price", "total"],
+  currency: ["currency", "currencycode", "conversioncurrency"],
+  conversionCount: ["conversioncount", "quantity", "count", "units"],
+  // Deliberately only the exact spelling: a `Source` or `Channel` column in a CRM export almost
+  // always holds an attribution channel, not one of Google's five event sources, and mapping it
+  // would refuse the whole file on a column an upload has no use for. Unmapped, it is dropped and
+  // named back in the hints, which is what those columns should get.
+  eventSource: ["eventsource"],
+  // Advanced matching. Each maps to one part of Google's address identifier; a row that carries the
+  // four required parts is matched on name + address as well as on whatever else it has.
+  // `name` is left out for the same reason: alone it produces a one-part `address`, and the
+  // contract requires all four parts, so a lone `Name` column would refuse the file.
+  givenName: ["givenname", "firstname", "forename"],
+  familyName: ["familyname", "lastname", "surname"],
+  regionCode: ["regioncode", "country", "countrycode"],
+  postalCode: ["postalcode", "postcode", "zip", "zipcode"],
+  addressLine: ["addressline", "address", "street", "streetaddress", "addressline1"],
+  city: ["city", "town", "locality"],
+  administrativeArea: ["administrativearea", "state", "province", "region"]
+};
+var NUMERIC_KEYS = /* @__PURE__ */ new Set(["value", "conversionCount"]);
+function normalizeColumn(raw) {
+  return raw.trim().toLowerCase().replace(/[^a-z0-9]/g, "");
+}
+function payloadKeyForColumn(column) {
+  const normalized = normalizeColumn(column);
+  for (const [key, aliases] of Object.entries(COLUMN_ALIASES)) {
+    if (normalizeColumn(key) === normalized || aliases.includes(normalized)) {
+      return key;
+    }
+  }
+  return void 0;
+}
+var ADDRESS_KEYS = [
+  "givenName",
+  "familyName",
+  "regionCode",
+  "postalCode",
+  "addressLine",
+  "city",
+  "administrativeArea"
+];
+function nestAddress(row) {
+  const address = {};
+  for (const key of ADDRESS_KEYS) {
+    if (row[key] !== void 0) {
+      address[key] = row[key];
+      delete row[key];
+    }
+  }
+  return Object.keys(address).length > 0 ? { ...row, address } : row;
+}
+function toRow(record) {
+  const row = {};
+  const ignored = [];
+  for (const [column, raw] of Object.entries(record)) {
+    const key = payloadKeyForColumn(column);
+    if (!key) {
+      if (column.trim() !== "") {
+        ignored.push(column.trim());
+      }
+      continue;
+    }
+    const value = cellValue(key, raw);
+    if (value !== void 0) {
+      row[key] = value;
+    }
+  }
+  return { row: nestAddress(row), ignored };
+}
+function cellValue(key, raw) {
+  const value = typeof raw === "string" ? raw.trim() : raw;
+  if (value === "" || value === null || value === void 0) {
+    return void 0;
+  }
+  if (!NUMERIC_KEYS.has(key)) {
+    return typeof value === "number" ? String(value) : value;
+  }
+  const numeric = typeof value === "number" ? value : Number(String(value).replace(/[^\d.-]/g, ""));
+  return Number.isFinite(numeric) ? numeric : value;
+}
+var CSV_SEPARATORS = /* @__PURE__ */ new Set([",", ";", "	"]);
+function splitCsvLine(line) {
+  const fields = [];
+  let current = "";
+  let quoted = false;
+  for (let i = 0; i < line.length; i++) {
+    const char = line[i];
+    if (quoted && char !== '"') {
+      current += char;
+    } else if (quoted) {
+      quoted = line[i + 1] === '"';
+      if (quoted) {
+        current += '"';
+        i += 1;
+      }
+    } else if (char === '"') {
+      quoted = true;
+    } else if (CSV_SEPARATORS.has(char ?? "")) {
+      fields.push(current);
+      current = "";
+    } else {
+      current += char;
+    }
+  }
+  fields.push(current);
+  return fields.map((field) => field.trim());
+}
+function parseCsv(text) {
+  const lines = text.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0);
+  const header = lines.shift();
+  if (!header) {
+    return { ok: false, error: "the file is empty" };
+  }
+  const columns = splitCsvLine(header);
+  if (!columns.some((column) => payloadKeyForColumn(column))) {
+    return {
+      ok: false,
+      error: `no column in "${columns.join(", ")}" is a conversion field \u2014 the file needs at least an order id, a date and something to match on (gclid / email / phone)`
+    };
+  }
+  const rows = [];
+  const ignored = /* @__PURE__ */ new Set();
+  for (const line of lines) {
+    const fields = splitCsvLine(line);
+    const record = {};
+    columns.forEach((column, index) => {
+      record[column] = fields[index] ?? "";
+    });
+    const parsed = toRow(record);
+    for (const column of parsed.ignored) {
+      ignored.add(column);
+    }
+    rows.push(parsed.row);
+  }
+  return { ok: true, rows, ignoredColumns: [...ignored] };
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function recordsOfJson(parsed) {
+  if (Array.isArray(parsed)) {
+    return parsed;
+  }
+  if (!isRecord(parsed)) {
+    return void 0;
+  }
+  for (const key of ["conversions", "rows", "data", "results"]) {
+    const value = parsed[key];
+    if (Array.isArray(value)) {
+      return value;
+    }
+  }
+  return void 0;
+}
+function parseJsonRecords(records) {
+  const rows = [];
+  const ignored = /* @__PURE__ */ new Set();
+  for (const [index, record] of records.entries()) {
+    if (!isRecord(record)) {
+      return { ok: false, error: `conversion ${index + 1} is not an object` };
+    }
+    const parsed = toRow(record);
+    for (const column of parsed.ignored) {
+      ignored.add(column);
+    }
+    rows.push(parsed.row);
+  }
+  return { ok: true, rows, ignoredColumns: [...ignored] };
+}
+function parseJsonText(trimmed) {
+  const lines = trimmed.split(/\r?\n/).filter((line) => line.trim().length > 0);
+  if (lines.length > 1 && lines.every((line) => line.trim().startsWith("{"))) {
+    const records2 = [];
+    for (const [index, line] of lines.entries()) {
+      try {
+        records2.push(JSON.parse(line));
+      } catch {
+        return { ok: false, error: `line ${index + 1} is not valid JSON` };
+      }
+    }
+    return parseJsonRecords(records2);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(trimmed);
+  } catch (err) {
+    return { ok: false, error: `not valid JSON: ${err instanceof Error ? err.message : String(err)}` };
+  }
+  const records = recordsOfJson(parsed);
+  if (!records) {
+    return { ok: false, error: "expected a JSON array of conversions, or an object with a `conversions` array" };
+  }
+  return parseJsonRecords(records);
+}
+function parseConversionRowsText(text) {
+  const trimmed = text.trim();
+  if (trimmed === "") {
+    return { ok: false, error: "the file is empty" };
+  }
+  if (trimmed.startsWith("[") || trimmed.startsWith("{")) {
+    return parseJsonText(trimmed);
+  }
+  return parseCsv(trimmed);
+}
+function chunkConversionRows(rows, size) {
+  const chunks = [];
+  for (let i = 0; i < rows.length; i += size) {
+    chunks.push(rows.slice(i, i + size));
+  }
+  return chunks;
+}
+
+// src/commands/ads/google/conversion-upload-command.ts
+var UPLOAD_HINTS = [
+  "Nothing has been uploaded yet \u2014 the conversions are staged and go to Google when this chat is published.",
+  "Reuse each conversion's ORIGINAL order id (the Form submission id, the order number the site issued). Google recognises an upload it already holds by that id, which is what makes a re-send a correction instead of a second conversion \u2014 a made-up id cannot be taken back.",
+  "Say plainly what was uploaded and what it was for. A conversion upload changes what automated bidding optimises toward, so the client should hear the count and the action, not just that it worked."
+];
+function ignoredColumnHints(columns) {
+  if (columns.length === 0) {
+    return [];
+  }
+  return [
+    `Ignored ${columns.length} column(s) that are not part of a conversion: ${columns.join(", ")}. A conversion carries an order id, a date, and something to match on: a click id (gclid / gbraid / wbraid), an email, a phone, or all four of givenName + familyName + country + postalCode. Optionally a value + currency, conversionCount, and eventSource (WEB / APP / IN_STORE / PHONE / OTHER). A column named just \`Name\` is ignored on purpose \u2014 Google needs the first and last name separately, so split it before re-running.`
+  ];
+}
+function readRowsFile(path) {
+  const inline = path.trimStart().startsWith("[") || path.trimStart().startsWith("{");
+  let text;
+  try {
+    text = inline ? path : readFileSync(path, "utf8");
+  } catch (err) {
+    failWriteValidation(`could not read ${path}: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  const parsed = parseConversionRowsText(text);
+  if (!parsed.ok) {
+    failWriteValidation(`${inline ? "the conversions passed inline" : path}: ${parsed.error}`);
+  }
+  return { rows: parsed.rows, ignoredColumns: parsed.ignoredColumns };
+}
+function rowFromFlags(args) {
+  const entries = [
+    ["orderId", args["order-id"]],
+    ["conversionDateTime", args.date],
+    ["gclid", args.gclid],
+    ["gbraid", args.gbraid],
+    ["wbraid", args.wbraid],
+    ["email", args.email],
+    ["phone", args.phone],
+    ["currency", args.currency],
+    ["eventSource", args["event-source"]],
+    ["givenName", args["given-name"]],
+    ["familyName", args["family-name"]],
+    ["regionCode", args.country],
+    ["postalCode", args["postal-code"]]
+  ];
+  const row = {};
+  for (const [key, value] of entries) {
+    if (typeof value === "string" && value.trim() !== "") {
+      row[key] = value.trim();
+    }
+  }
+  nestAddressFlags(row);
+  readNumericFlags(args, row);
+  return Object.keys(row).length > 0 ? row : void 0;
+}
+function nestAddressFlags(row) {
+  const address = {};
+  for (const key of ["givenName", "familyName", "regionCode", "postalCode"]) {
+    if (row[key] !== void 0) {
+      address[key] = row[key];
+      delete row[key];
+    }
+  }
+  if (Object.keys(address).length > 0) {
+    row.address = address;
+  }
+}
+function readNumericFlags(args, row) {
+  if (args["conversion-count"] !== void 0 && args["conversion-count"] !== "") {
+    const count = Number(args["conversion-count"]);
+    if (!Number.isInteger(count) || count < 1) {
+      failWriteValidation("--conversion-count must be a whole number of conversions, e.g. 3");
+    }
+    row.conversionCount = count;
+  }
+  if (args.value !== void 0 && args.value !== "") {
+    const numeric = Number(args.value);
+    if (!Number.isFinite(numeric)) {
+      failWriteValidation("--value must be a number in major currency units, e.g. 49.90");
+    }
+    row.value = numeric;
+  }
+}
+var conversionsUploadCommand = defineCommand({
+  meta: {
+    name: "upload",
+    description: "Upload conversions Google never received \u2014 a backfill for a period where the tracking was broken. Start here: `conversions upload --customer-id 1234567890 --conversion-action 987654321 --file missing.csv`, where the file carries one conversion per row with an order id, a date, and a gclid and/or an email. Nothing reaches Google until the chat is published. Reuse each conversion's ORIGINAL order id so a re-send is treated as a correction rather than a second conversion. Read the account's actions first with: baker ads google query \"SELECT conversion_action.id, conversion_action.name, conversion_action.status FROM conversion_action\""
+  },
+  args: {
+    "customer-id": { type: "string", description: "10-digit Google Ads customer id" },
+    "conversion-action": {
+      type: "string",
+      description: "The conversion action to record these against \u2014 its numeric id or resource name"
+    },
+    file: {
+      type: "string",
+      description: "The conversions: a path to a CSV / JSON / JSONL file, or the JSON array written inline. Columns: orderId, conversionDateTime, gclid | gbraid | wbraid, email, phone, givenName + familyName + country + postalCode (advanced matching), value, currency, conversionCount, eventSource"
+    },
+    "order-id": { type: "string", description: "Single conversion: its original order / submission id" },
+    date: {
+      type: "string",
+      description: "Single conversion: when it happened, as an ISO-8601 instant WITH a timezone (2026-08-01T10:00:00Z or 2026-08-01T12:00:00+02:00)"
+    },
+    gclid: { type: "string", description: "Single conversion: the Google click id it came from" },
+    gbraid: { type: "string", description: "Single conversion: the gbraid click id (app-to-web)" },
+    wbraid: { type: "string", description: "Single conversion: the wbraid click id (web-to-app)" },
+    email: { type: "string", description: "Single conversion: the customer's email \u2014 hashed before it is stored" },
+    phone: {
+      type: "string",
+      description: "Single conversion: the customer's phone in E.164 \u2014 hashed before it is stored"
+    },
+    value: { type: "string", description: "Single conversion: what it was worth, in major currency units" },
+    currency: { type: "string", description: "Single conversion: the value's 3-letter currency code, e.g. EUR" },
+    "conversion-count": {
+      type: "string",
+      description: "Single conversion: how many conversions this row stands for. Only read on an EVERY-counting conversion action; defaults to 1"
+    },
+    "event-source": {
+      type: "string",
+      description: "Single conversion: where it happened \u2014 WEB (default), APP, IN_STORE, PHONE or OTHER"
+    },
+    "given-name": {
+      type: "string",
+      description: "Single conversion: the customer's first name \u2014 advanced matching, hashed before it is stored"
+    },
+    "family-name": {
+      type: "string",
+      description: "Single conversion: the customer's last name \u2014 advanced matching, hashed before it is stored"
+    },
+    country: {
+      type: "string",
+      description: "Single conversion: the customer's 2-letter country code, e.g. ES \u2014 required with a name/address match"
+    },
+    "postal-code": {
+      type: "string",
+      description: "Single conversion: the customer's postcode \u2014 required with a name/address match"
+    }
+  },
+  run: async ({ args }) => {
+    const customerId = requireCustomerId(args);
+    const conversionAction = typeof args["conversion-action"] === "string" ? args["conversion-action"].trim() : "";
+    if (conversionAction === "") {
+      failWriteValidation(
+        '--conversion-action is required: the action these conversions are recorded against. List them with: baker ads google query "SELECT conversion_action.id, conversion_action.name, conversion_action.status FROM conversion_action"'
+      );
+    }
+    const fromFile = typeof args.file === "string" && args.file.length > 0 ? readRowsFile(args.file) : void 0;
+    const fromFlags = rowFromFlags(args);
+    if (fromFile && fromFlags) {
+      failWriteValidation(
+        "pass either --file (a list of conversions) or the single-conversion flags, not both \u2014 otherwise it is ambiguous which row the flags belong to"
+      );
+    }
+    const rows = fromFile?.rows ?? (fromFlags ? [fromFlags] : []);
+    if (rows.length === 0) {
+      failWriteValidation(
+        "no conversions to upload \u2014 pass --file with the conversions, or describe one with --order-id, --date and a --gclid / --email"
+      );
+    }
+    const chunks = chunkConversionRows(rows, CONVERSION_UPLOAD_MAX_ROWS);
+    const ops = chunks.map((conversions) => ({
+      kind: "google.conversion.upload",
+      customerId,
+      payload: { conversionAction, conversions }
+    }));
+    const chunkHint = chunks.length > 1 ? [
+      `${rows.length} conversions staged as ${chunks.length} uploads of up to ${CONVERSION_UPLOAD_MAX_ROWS} each. They publish independently \u2014 report the result of all ${chunks.length}, not just the first.`
+    ] : [];
+    await stageGoogleOps(ops, [...chunkHint, ...ignoredColumnHints(fromFile?.ignoredColumns ?? []), ...UPLOAD_HINTS]);
+  }
+});
+export {
+  conversionsUploadCommand
+};
+//# sourceMappingURL=conversion-upload-command-JU6ZSJBV.js.map