@koda-sl/baker-cli 0.571.0-dev.6a3439a0a → 0.572.0-dev.61ba69c66

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

@@ -0,0 +1,440 @@
+import {
+  failWriteValidation,
+  requireCustomerId,
+  stageGoogleOps
+} from "./chunk-5U6OL4NN.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-HKKHOMEQ.js";
+import "./chunk-55AX6DOP.js";
+import "./chunk-MX5NQAK6.js";
+import "./chunk-D5FY4FAK.js";
+import "./chunk-VCDFBFPT.js";
+import "./chunk-QALAJNBG.js";
+import "./chunk-WZXMZFVB.js";
+import "./chunk-VF3W7CI7.js";
+import "./chunk-Q4O7ICAK.js";
+import "./chunk-4CYB33V3.js";
+import "./chunk-AGL7EWP2.js";
+import "./chunk-XQEHLDGP.js";
+import "./chunk-2B2JFTWI.js";
+import "./chunk-XKYFNMTB.js";
+import "./chunk-R7XDGNZD.js";
+import {
+  CONVERSION_UPLOAD_MAX_ROWS
+} from "./chunk-IMS53EQU.js";
+import "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import "./chunk-6LUDG5AB.js";
+import "./chunk-6V4UAC5I.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-Z7IOS6ZG.js.map

package/dist/conversion-upload-command-Z7IOS6ZG.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/google/conversion-upload-command.ts","../src/commands/ads/google/conversion-rows.ts"],"sourcesContent":["import { readFileSync } from \"node:fs\";\nimport { CONVERSION_UPLOAD_MAX_ROWS } from \"@baker/api/ads-google\";\nimport { defineCommand } from \"citty\";\nimport { chunkConversionRows, parseConversionRowsText } from \"./conversion-rows.ts\";\nimport { failWriteValidation, requireCustomerId, stageGoogleOps } from \"./write-shared.ts\";\n\n/**\n * `baker ads google conversions upload` — file conversions Google never received.\n *\n * This is a repair command, not a measurement one. The normal path for a conversion is the tag on\n * the page and the server-side send behind it; this exists for the days that path was broken — a\n * Google connection that had lost its permission, an outage, a tag pointed at the wrong action —\n * where the conversions really happened and the account has no record of them.\n *\n * It stages like every other Google change: nothing reaches Google until the chat is published, and\n * the change list shows how many conversions, into which action, worth how much, and how many of\n * them can be matched by click id rather than by customer details.\n */\n\nconst UPLOAD_HINTS = [\n  \"Nothing has been uploaded yet — the conversions are staged and go to Google when this chat is published.\",\n  \"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 — a made-up id cannot be taken back.\",\n  \"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.\",\n];\n\n/**\n * The command's own hints about what did not make it into the staged rows. A dropped column is\n * stated because the alternative — a value the user believed they sent, silently absent — is\n * indistinguishable from a working upload right up until the numbers are wrong.\n */\nfunction ignoredColumnHints(columns: readonly string[]): string[] {\n  if (columns.length === 0) {\n    return [];\n  }\n  return [\n    `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 — Google needs the first and last name separately, so split it before re-running.`,\n  ];\n}\n\nfunction readRowsFile(path: string): { rows: Record<string, unknown>[]; ignoredColumns: string[] } {\n  // Inline content is read the same way `--file` is everywhere else on this surface: a leading `[`\n  // or `{` is the data itself, anything else is a path.\n  const inline = path.trimStart().startsWith(\"[\") || path.trimStart().startsWith(\"{\");\n  let text: string;\n  try {\n    text = inline ? path : readFileSync(path, \"utf8\");\n  } catch (err) {\n    failWriteValidation(`could not read ${path}: ${err instanceof Error ? err.message : String(err)}`);\n  }\n  const parsed = parseConversionRowsText(text);\n  if (!parsed.ok) {\n    failWriteValidation(`${inline ? \"the conversions passed inline\" : path}: ${parsed.error}`);\n  }\n  return { rows: parsed.rows, ignoredColumns: parsed.ignoredColumns };\n}\n\n/** The single conversion described by flags, or undefined when none of them were used. */\nfunction rowFromFlags(args: Record<string, unknown>): Record<string, unknown> | undefined {\n  const entries: Array<[string, unknown]> = [\n    [\"orderId\", args[\"order-id\"]],\n    [\"conversionDateTime\", args.date],\n    [\"gclid\", args.gclid],\n    [\"gbraid\", args.gbraid],\n    [\"wbraid\", args.wbraid],\n    [\"email\", args.email],\n    [\"phone\", args.phone],\n    [\"currency\", args.currency],\n    [\"eventSource\", args[\"event-source\"]],\n    [\"givenName\", args[\"given-name\"]],\n    [\"familyName\", args[\"family-name\"]],\n    [\"regionCode\", args.country],\n    [\"postalCode\", args[\"postal-code\"]],\n  ];\n  const row: Record<string, unknown> = {};\n  for (const [key, value] of entries) {\n    if (typeof value === \"string\" && value.trim() !== \"\") {\n      row[key] = value.trim();\n    }\n  }\n  nestAddressFlags(row);\n  readNumericFlags(args, row);\n  return Object.keys(row).length > 0 ? row : undefined;\n}\n\n/**\n * The four address parts travel together into the nested identifier. A partial one is kept nested so\n * the contract refuses it by name — dropping it here would turn a fixable mistake into conversions\n * that match nobody.\n */\nfunction nestAddressFlags(row: Record<string, unknown>): void {\n  const address: Record<string, unknown> = {};\n  for (const key of [\"givenName\", \"familyName\", \"regionCode\", \"postalCode\"]) {\n    if (row[key] !== undefined) {\n      address[key] = row[key];\n      delete row[key];\n    }\n  }\n  if (Object.keys(address).length > 0) {\n    row.address = address;\n  }\n}\n\nfunction readNumericFlags(args: Record<string, unknown>, row: Record<string, unknown>): void {\n  if (args[\"conversion-count\"] !== undefined && args[\"conversion-count\"] !== \"\") {\n    const count = Number(args[\"conversion-count\"]);\n    if (!Number.isInteger(count) || count < 1) {\n      failWriteValidation(\"--conversion-count must be a whole number of conversions, e.g. 3\");\n    }\n    row.conversionCount = count;\n  }\n  if (args.value !== undefined && args.value !== \"\") {\n    const numeric = Number(args.value);\n    if (!Number.isFinite(numeric)) {\n      failWriteValidation(\"--value must be a number in major currency units, e.g. 49.90\");\n    }\n    row.value = numeric;\n  }\n}\n\nexport const conversionsUploadCommand = defineCommand({\n  meta: {\n    name: \"upload\",\n    description:\n      \"Upload conversions Google never received — 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\\\"\",\n  },\n  args: {\n    \"customer-id\": { type: \"string\", description: \"10-digit Google Ads customer id\" },\n    \"conversion-action\": {\n      type: \"string\",\n      description: \"The conversion action to record these against — its numeric id or resource name\",\n    },\n    file: {\n      type: \"string\",\n      description:\n        \"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\",\n    },\n    \"order-id\": { type: \"string\", description: \"Single conversion: its original order / submission id\" },\n    date: {\n      type: \"string\",\n      description:\n        \"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)\",\n    },\n    gclid: { type: \"string\", description: \"Single conversion: the Google click id it came from\" },\n    gbraid: { type: \"string\", description: \"Single conversion: the gbraid click id (app-to-web)\" },\n    wbraid: { type: \"string\", description: \"Single conversion: the wbraid click id (web-to-app)\" },\n    email: { type: \"string\", description: \"Single conversion: the customer's email — hashed before it is stored\" },\n    phone: {\n      type: \"string\",\n      description: \"Single conversion: the customer's phone in E.164 — hashed before it is stored\",\n    },\n    value: { type: \"string\", description: \"Single conversion: what it was worth, in major currency units\" },\n    currency: { type: \"string\", description: \"Single conversion: the value's 3-letter currency code, e.g. EUR\" },\n    \"conversion-count\": {\n      type: \"string\",\n      description:\n        \"Single conversion: how many conversions this row stands for. Only read on an EVERY-counting conversion action; defaults to 1\",\n    },\n    \"event-source\": {\n      type: \"string\",\n      description: \"Single conversion: where it happened — WEB (default), APP, IN_STORE, PHONE or OTHER\",\n    },\n    \"given-name\": {\n      type: \"string\",\n      description: \"Single conversion: the customer's first name — advanced matching, hashed before it is stored\",\n    },\n    \"family-name\": {\n      type: \"string\",\n      description: \"Single conversion: the customer's last name — advanced matching, hashed before it is stored\",\n    },\n    country: {\n      type: \"string\",\n      description:\n        \"Single conversion: the customer's 2-letter country code, e.g. ES — required with a name/address match\",\n    },\n    \"postal-code\": {\n      type: \"string\",\n      description: \"Single conversion: the customer's postcode — required with a name/address match\",\n    },\n  },\n  run: async ({ args }) => {\n    const customerId = requireCustomerId(args);\n    const conversionAction = typeof args[\"conversion-action\"] === \"string\" ? args[\"conversion-action\"].trim() : \"\";\n    if (conversionAction === \"\") {\n      failWriteValidation(\n        '--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\"',\n      );\n    }\n\n    const fromFile = typeof args.file === \"string\" && args.file.length > 0 ? readRowsFile(args.file) : undefined;\n    const fromFlags = rowFromFlags(args);\n    if (fromFile && fromFlags) {\n      failWriteValidation(\n        \"pass either --file (a list of conversions) or the single-conversion flags, not both — otherwise it is ambiguous which row the flags belong to\",\n      );\n    }\n    const rows = fromFile?.rows ?? (fromFlags ? [fromFlags] : []);\n    if (rows.length === 0) {\n      failWriteValidation(\n        \"no conversions to upload — pass --file with the conversions, or describe one with --order-id, --date and a --gclid / --email\",\n      );\n    }\n\n    // Chunked rather than refused: a month of lost conversions is routinely more rows than one\n    // staged change should carry, and splitting it here means the reviewer sees several readable\n    // cards instead of one they cannot check. Each chunk stages as its own op and succeeds or fails\n    // on its own at publish.\n    const chunks = chunkConversionRows(rows, CONVERSION_UPLOAD_MAX_ROWS);\n    const ops = chunks.map((conversions) => ({\n      kind: \"google.conversion.upload\",\n      customerId,\n      payload: { conversionAction, conversions },\n    }));\n    const chunkHint =\n      chunks.length > 1\n        ? [\n            `${rows.length} conversions staged as ${chunks.length} uploads of up to ${CONVERSION_UPLOAD_MAX_ROWS} each. They publish independently — report the result of all ${chunks.length}, not just the first.`,\n          ]\n        : [];\n    await stageGoogleOps(ops, [...chunkHint, ...ignoredColumnHints(fromFile?.ignoredColumns ?? []), ...UPLOAD_HINTS]);\n  },\n});\n","/**\n * Reading the conversions a manual upload is built from.\n *\n * A backfill arrives as whatever the client could export — a CSV out of a spreadsheet or their CRM,\n * a JSON dump, one row pasted on the command line. All three land here and leave as the same row\n * shape the `@baker/api` contract validates, so the schema stays the single source of truth about\n * what a conversion is and this module only has to answer \"which column was that\".\n *\n * Two decisions worth keeping:\n *\n *   - **Column names are matched loosely, values never are.** `Order ID`, `order_id` and\n *     `transaction_id` are the same column; what is inside it is passed through untouched, because a\n *     click id that has been \"helpfully\" trimmed is a click id that matches nothing.\n *   - **Unknown columns are dropped and named.** A real CRM export carries twenty columns we have no\n *     use for, so refusing the file would make the command unusable — but a column that vanishes\n *     without being mentioned is how a value the user believed they sent turns out never to have\n *     been sent. They are dropped and listed back.\n */\n\n/** Payload keys a row can carry, and the column names each is recognised by. */\nconst COLUMN_ALIASES: Record<string, readonly string[]> = {\n  orderId: [\"orderid\", \"order\", \"ordernumber\", \"transactionid\", \"transaction\", \"submissionid\", \"conversionid\", \"id\"],\n  conversionDateTime: [\n    \"conversiondatetime\",\n    \"conversiontime\",\n    \"conversiondate\",\n    \"datetime\",\n    \"date\",\n    \"time\",\n    \"timestamp\",\n    \"occurredat\",\n    \"createdat\",\n  ],\n  gclid: [\"gclid\"],\n  gbraid: [\"gbraid\"],\n  wbraid: [\"wbraid\"],\n  email: [\"email\", \"emailaddress\", \"useremail\", \"mail\"],\n  phone: [\"phone\", \"phonenumber\", \"telephone\", \"mobile\", \"tel\"],\n  value: [\"value\", \"conversionvalue\", \"amount\", \"revenue\", \"price\", \"total\"],\n  currency: [\"currency\", \"currencycode\", \"conversioncurrency\"],\n  conversionCount: [\"conversioncount\", \"quantity\", \"count\", \"units\"],\n  // Deliberately only the exact spelling: a `Source` or `Channel` column in a CRM export almost\n  // always holds an attribution channel, not one of Google's five event sources, and mapping it\n  // would refuse the whole file on a column an upload has no use for. Unmapped, it is dropped and\n  // named back in the hints, which is what those columns should get.\n  eventSource: [\"eventsource\"],\n  // Advanced matching. Each maps to one part of Google's address identifier; a row that carries the\n  // four required parts is matched on name + address as well as on whatever else it has.\n  // `name` is left out for the same reason: alone it produces a one-part `address`, and the\n  // contract requires all four parts, so a lone `Name` column would refuse the file.\n  givenName: [\"givenname\", \"firstname\", \"forename\"],\n  familyName: [\"familyname\", \"lastname\", \"surname\"],\n  regionCode: [\"regioncode\", \"country\", \"countrycode\"],\n  postalCode: [\"postalcode\", \"postcode\", \"zip\", \"zipcode\"],\n  addressLine: [\"addressline\", \"address\", \"street\", \"streetaddress\", \"addressline1\"],\n  city: [\"city\", \"town\", \"locality\"],\n  administrativeArea: [\"administrativearea\", \"state\", \"province\", \"region\"],\n};\n\n/** Numeric payload keys — everything else stays the string it arrived as. */\nconst NUMERIC_KEYS = new Set([\"value\", \"conversionCount\"]);\n\nfunction normalizeColumn(raw: string): string {\n  return raw\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9]/g, \"\");\n}\n\n/** The payload key a column name means, or undefined when it means nothing to an upload. */\nexport function payloadKeyForColumn(column: string): string | undefined {\n  const normalized = normalizeColumn(column);\n  for (const [key, aliases] of Object.entries(COLUMN_ALIASES)) {\n    if (normalizeColumn(key) === normalized || aliases.includes(normalized)) {\n      return key;\n    }\n  }\n  return undefined;\n}\n\nexport interface ParsedConversionRows {\n  rows: Record<string, unknown>[];\n  /** Column names that were present and carried nothing an upload uses. */\n  ignoredColumns: string[];\n}\n\nexport type ParseConversionRowsResult = ({ ok: true } & ParsedConversionRows) | { ok: false; error: string };\n\n/**\n * One raw record → the payload row shape. A blank cell is dropped rather than sent as `\"\"`: an empty\n * `gclid` column on a row matched by email would otherwise fail validation for carrying a click id\n * that is not one, which describes the spreadsheet rather than the conversion.\n */\n/** The address parts, in the flat column names a spreadsheet uses. */\nconst ADDRESS_KEYS = [\n  \"givenName\",\n  \"familyName\",\n  \"regionCode\",\n  \"postalCode\",\n  \"addressLine\",\n  \"city\",\n  \"administrativeArea\",\n] as const;\n\n/**\n * Fold the flat address columns into the nested `address` the contract takes.\n *\n * A row with none of them is left alone. A row with SOME of them keeps them nested and lets the\n * contract refuse it by name — Google needs all four of given name, family name, country and postal\n * code together, and quietly dropping a half-filled address would turn a fixable export mistake into\n * conversions that match nobody.\n */\nfunction nestAddress(row: Record<string, unknown>): Record<string, unknown> {\n  const address: Record<string, unknown> = {};\n  for (const key of ADDRESS_KEYS) {\n    if (row[key] !== undefined) {\n      address[key] = row[key];\n      delete row[key];\n    }\n  }\n  return Object.keys(address).length > 0 ? { ...row, address } : row;\n}\n\nfunction toRow(record: Record<string, unknown>): { row: Record<string, unknown>; ignored: string[] } {\n  const row: Record<string, unknown> = {};\n  const ignored: string[] = [];\n  for (const [column, raw] of Object.entries(record)) {\n    const key = payloadKeyForColumn(column);\n    if (!key) {\n      if (column.trim() !== \"\") {\n        ignored.push(column.trim());\n      }\n      continue;\n    }\n    const value = cellValue(key, raw);\n    if (value !== undefined) {\n      row[key] = value;\n    }\n  }\n  return { row: nestAddress(row), ignored };\n}\n\n/** One cell's payload value, or undefined when the cell is blank and the key should stay absent. */\nfunction cellValue(key: string, raw: unknown): unknown {\n  const value = typeof raw === \"string\" ? raw.trim() : raw;\n  if (value === \"\" || value === null || value === undefined) {\n    return undefined;\n  }\n  if (!NUMERIC_KEYS.has(key)) {\n    return typeof value === \"number\" ? String(value) : value;\n  }\n  // A spreadsheet writes money as \"€ 1234.50\" as readily as 1234.5, and a NaN here would reach the\n  // contract as \"expected a number\" with no hint of which cell. Read what is parseable and leave the\n  // rest for validation to name.\n  const numeric = typeof value === \"number\" ? value : Number(String(value).replace(/[^\\d.-]/g, \"\"));\n  return Number.isFinite(numeric) ? numeric : value;\n}\n\n/**\n * RFC-4180 fields of one CSV line, honouring `\"\"` escapes inside quotes. Deliberately line-based:\n * an embedded newline inside a quoted field is not something a conversion export produces, and\n * supporting it would mean a parser nobody can read for a case nobody has.\n */\nconst CSV_SEPARATORS = new Set([\",\", \";\", \"\\t\"]);\n\nfunction splitCsvLine(line: string): string[] {\n  const fields: string[] = [];\n  let current = \"\";\n  let quoted = false;\n  for (let i = 0; i < line.length; i++) {\n    const char = line[i];\n    if (quoted && char !== '\"') {\n      current += char;\n    } else if (quoted) {\n      // A doubled quote inside a quoted field is one literal quote; a single one closes the field.\n      quoted = line[i + 1] === '\"';\n      if (quoted) {\n        current += '\"';\n        i += 1;\n      }\n    } else if (char === '\"') {\n      quoted = true;\n    } else if (CSV_SEPARATORS.has(char ?? \"\")) {\n      fields.push(current);\n      current = \"\";\n    } else {\n      current += char;\n    }\n  }\n  fields.push(current);\n  return fields.map((field) => field.trim());\n}\n\nfunction parseCsv(text: string): ParseConversionRowsResult {\n  const lines = text\n    .split(/\\r?\\n/)\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n  const header = lines.shift();\n  if (!header) {\n    return { ok: false, error: \"the file is empty\" };\n  }\n  const columns = splitCsvLine(header);\n  if (!columns.some((column) => payloadKeyForColumn(column))) {\n    return {\n      ok: false,\n      error: `no column in \"${columns.join(\", \")}\" is a conversion field — the file needs at least an order id, a date and something to match on (gclid / email / phone)`,\n    };\n  }\n  const rows: Record<string, unknown>[] = [];\n  const ignored = new Set<string>();\n  for (const line of lines) {\n    const fields = splitCsvLine(line);\n    const record: Record<string, unknown> = {};\n    columns.forEach((column, index) => {\n      record[column] = fields[index] ?? \"\";\n    });\n    const parsed = toRow(record);\n    for (const column of parsed.ignored) {\n      ignored.add(column);\n    }\n    rows.push(parsed.row);\n  }\n  return { ok: true, rows, ignoredColumns: [...ignored] };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** The record list inside a JSON document: a bare array, or the `conversions` / `rows` / `data` key of an object. */\nfunction recordsOfJson(parsed: unknown): unknown[] | undefined {\n  if (Array.isArray(parsed)) {\n    return parsed;\n  }\n  if (!isRecord(parsed)) {\n    return undefined;\n  }\n  for (const key of [\"conversions\", \"rows\", \"data\", \"results\"]) {\n    const value = parsed[key];\n    if (Array.isArray(value)) {\n      return value;\n    }\n  }\n  return undefined;\n}\n\nfunction parseJsonRecords(records: unknown[]): ParseConversionRowsResult {\n  const rows: Record<string, unknown>[] = [];\n  const ignored = new Set<string>();\n  for (const [index, record] of records.entries()) {\n    if (!isRecord(record)) {\n      return { ok: false, error: `conversion ${index + 1} is not an object` };\n    }\n    const parsed = toRow(record);\n    for (const column of parsed.ignored) {\n      ignored.add(column);\n    }\n    rows.push(parsed.row);\n  }\n  return { ok: true, rows, ignoredColumns: [...ignored] };\n}\n\n/**\n * A JSON document's conversions. JSONL is tried first: a file of one object per line also starts\n * with `{`, and `JSON.parse` over the whole of it fails with a message that says nothing about what\n * the file actually is.\n */\nfunction parseJsonText(trimmed: string): ParseConversionRowsResult {\n  const lines = trimmed.split(/\\r?\\n/).filter((line) => line.trim().length > 0);\n  if (lines.length > 1 && lines.every((line) => line.trim().startsWith(\"{\"))) {\n    const records: unknown[] = [];\n    for (const [index, line] of lines.entries()) {\n      try {\n        records.push(JSON.parse(line));\n      } catch {\n        return { ok: false, error: `line ${index + 1} is not valid JSON` };\n      }\n    }\n    return parseJsonRecords(records);\n  }\n  let parsed: unknown;\n  try {\n    parsed = JSON.parse(trimmed);\n  } catch (err) {\n    return { ok: false, error: `not valid JSON: ${err instanceof Error ? err.message : String(err)}` };\n  }\n  const records = recordsOfJson(parsed);\n  if (!records) {\n    return { ok: false, error: \"expected a JSON array of conversions, or an object with a `conversions` array\" };\n  }\n  return parseJsonRecords(records);\n}\n\n/**\n * The conversions in a file's text, whatever shape it arrived in: JSON (an array or an object with a\n * `conversions` key), newline-delimited JSON, or CSV / TSV / semicolon-separated with a header row.\n * The format is read off the content, not off the extension — an export saved as `.txt` is the same\n * data.\n */\nexport function parseConversionRowsText(text: string): ParseConversionRowsResult {\n  const trimmed = text.trim();\n  if (trimmed === \"\") {\n    return { ok: false, error: \"the file is empty\" };\n  }\n  if (trimmed.startsWith(\"[\") || trimmed.startsWith(\"{\")) {\n    return parseJsonText(trimmed);\n  }\n  return parseCsv(trimmed);\n}\n\n/** Split a row list into staging-sized batches — one staged op per chunk. */\nexport function chunkConversionRows<T>(rows: readonly T[], size: number): T[][] {\n  const chunks: T[][] = [];\n  for (let i = 0; i < rows.length; i += size) {\n    chunks.push(rows.slice(i, i + size));\n  }\n  return chunks;\n}\n"],"mappings":"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","names":["records"]}

package/dist/conversion-writes-333V4OVR.js

@@ -0,0 +1,122 @@
+import {
+  compact,
+  lowerArg,
+  schemaArgs,
+  stageChatgptOp
+} from "./chunk-U5V4CIIG.js";
+import {
+  CHATGPT_ADS_REFERENCE,
+  runChatgptRead
+} from "./chunk-NT7NCSEB.js";
+import "./chunk-VF3W7CI7.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import {
+  apiGet
+} from "./chunk-UUDWZIDC.js";
+import "./chunk-S4V2GOKV.js";
+import "./chunk-6LUDG5AB.js";
+import {
+  registerSchema
+} from "./chunk-6V4UAC5I.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-333V4OVR.js.map