@koda-sl/baker-cli 0.536.0 → 0.538.0-dev.fc2958a1d

package/dist/crm-JMIIB55O.js

@@ -0,0 +1,323 @@
+import {
+  crmColumnMeanings,
+  crmColumnQuestions
+} from "./chunk-CFVVZKSU.js";
+import {
+  crmBatchFromSheet,
+  crmColumnReading,
+  crmPushBrief,
+  crmPushRequestSchema,
+  crmPushUrl,
+  exactCrmColumns,
+  judgeCrmBatch,
+  sheetDelimiter
+} from "./chunk-RM5T4MA6.js";
+import "./chunk-GRQ2AXDX.js";
+import {
+  holdWorkspaceSpend
+} from "./chunk-W3PJ7V4W.js";
+import "./chunk-CM2LECNX.js";
+import {
+  askJevQuestions
+} from "./chunk-ZPF253G5.js";
+import "./chunk-AXSSATJW.js";
+import "./chunk-DNRXEP4A.js";
+import "./chunk-OYYAR5TD.js";
+import {
+  failApi
+} from "./chunk-XBMZNFN7.js";
+import "./chunk-XXS6SUVM.js";
+import "./chunk-QV6AST5T.js";
+import "./chunk-WCU362Z6.js";
+import "./chunk-GIWHHCD6.js";
+import "./chunk-SOPVIIUW.js";
+import "./chunk-G4FG5EQO.js";
+import "./chunk-NSBNIPIW.js";
+import "./chunk-BNO3EFGR.js";
+import {
+  ApiError,
+  apiGet,
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import {
+  getEnv
+} from "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/accounts/crm.ts
+import { readFileSync } from "fs";
+import { defineCommand } from "citty";
+import { parse } from "csv-parse/sync";
+var MAX_REJECTIONS_SHOWN = 20;
+var SAMPLES_MAX = 3;
+function jsonKind(batch) {
+  const body = batch;
+  const companies = (body?.companies?.length ?? 0) > 0;
+  const deals = (body?.deals?.length ?? 0) > 0;
+  if (companies && deals) return "both";
+  return companies ? "companies" : "deals";
+}
+async function readBatch(name, text, readColumns) {
+  if (name.toLowerCase().endsWith(".json")) {
+    const batch = JSON.parse(text);
+    return { format: "json", kind: jsonKind(batch), batch, ignoredColumns: [], unread: [] };
+  }
+  const rows = parse(text, {
+    bom: true,
+    columns: true,
+    delimiter: sheetDelimiter(text),
+    skip_empty_lines: true,
+    relax_column_count: true,
+    trim: true
+  });
+  const headers = Object.keys(rows[0] ?? {});
+  const exact = exactCrmColumns(headers);
+  const rest = headers.filter((header) => exact[header] === void 0).map((header) => ({
+    header,
+    samples: rows.map((row) => row[header] ?? "").filter(Boolean).slice(0, SAMPLES_MAX)
+  }));
+  const answers = rest.length > 0 ? await readColumns(crmColumnQuestions(rest, headers)) : [];
+  const meanings = answers ? { ...crmColumnMeanings(rest, answers), ...exact } : exact;
+  const sheet = crmBatchFromSheet(rows, crmColumnReading(meanings));
+  return {
+    format: "csv",
+    kind: sheet.kind,
+    batch: sheet.batch,
+    ignoredColumns: sheet.ignoredColumns,
+    unread: answers ? [] : rest.map((column) => column.header)
+  };
+}
+async function checkCrmFile(name, text, readColumns) {
+  const { format, kind, batch, ignoredColumns, unread } = await readBatch(name, text, readColumns);
+  const body = crmPushRequestSchema.safeParse(batch);
+  if (!body.success) throw new Error(body.error.issues[0]?.message ?? "not a batch of companies and deals");
+  const judged = judgeCrmBatch(body.data);
+  const kept = (items) => items.filter((item) => !item.deleted).length;
+  const rejectedOf = (kind2) => judged.rejected.filter((r) => r.kind === kind2).length;
+  const data = {
+    file: name,
+    format,
+    kind,
+    received: {
+      companies: judged.companies.length + rejectedOf("company"),
+      deals: judged.deals.length + rejectedOf("deal")
+    },
+    accepted: { companies: kept(judged.companies), deals: kept(judged.deals) },
+    rejected: judged.rejected.slice(0, MAX_REJECTIONS_SHOWN),
+    rejectedCount: judged.rejected.length,
+    ignoredColumns
+  };
+  const hints = [];
+  if (judged.rejected.length > 0) {
+    hints.push(
+      `${judged.rejected.length} record(s) would be refused \u2014 fix them in the file (each message names the field) and check again. The rest would still be accepted.`
+    );
+  }
+  if (kind === "companies") {
+    hints.push(
+      "Read as a company list (one row per company). A website or LinkedIn page is enough to know a company by; deals sent later with the same website land on it."
+    );
+  }
+  if (unread.length > 0) {
+    hints.push(
+      `These columns could not be read just now, so this check leaves them out: ${unread.join(", ")}. The upload reads them again; check once more to see what they hold.`
+    );
+  }
+  const left = ignoredColumns.filter((header) => !unread.includes(header));
+  if (left.length > 0) {
+    hints.push(`These columns are left behind and never sent: ${left.join(", ")}.`);
+  }
+  hints.push(
+    format === "csv" ? "Nothing was sent. The user uploads this file themselves in Measure \u2192 Sources \u2192 Deals \u2192 Send your deals \u2192 Upload a file \u2014 or keeps it in a Google Sheet and links it there (Google Sheets), which Baker then reads every night." : "Nothing was sent. This is the body their system posts to the address in `baker accounts crm contract`, with their CRM sending key."
+  );
+  return { data, hints };
+}
+registerSchema({
+  command: "accounts.crm.status",
+  description: "Start here when a client's deals are not in HubSpot. Where Account insights reads deals from (source: hubspot | api \u2014 api means the client sends them), the address their system sends to, the last live send and the last test send (when, via upload | sheet | api, how many companies and deals, the first refusals and why), the Google Sheets Baker reads every night (each with its last read, or why it failed), and what Baker holds now (companies, deals, deals per pipeline and stage, and how many were sent as won or lost).",
+  args: {}
+});
+var statusCommand = defineCommand({
+  meta: {
+    name: "status",
+    description: "Where the client's deals come from and what has arrived. Example: baker accounts crm status"
+  },
+  args: {},
+  run: async () => {
+    try {
+      const response = await apiGet("/api/accounts/crm/status");
+      writeJson({ ...response, hints: statusHints(response.data) });
+    } catch (err) {
+      failApi(err);
+    }
+  }
+});
+function sheetHints(sheets) {
+  return sheets.filter((sheet) => sheet.lastRead !== null && !sheet.lastRead.ok).map(
+    (sheet) => `Baker could not read the linked Google Sheet "${sheet.spreadsheetName} \xB7 ${sheet.tab}": ${sheet.lastRead?.message ?? "no reason given"} Tell the user; they fix it in Measure \u2192 Sources \u2192 Deals \u2192 Google Sheets (Read now, or link it again). What it brought stays in Baker until then.`
+  );
+}
+function refusedHints(lastLive) {
+  if (lastLive === null || lastLive.rejected === 0) return [];
+  const reasons = [...new Set(lastLive.samples.map((sample) => sample.message))].join("; ");
+  return [
+    `${lastLive.rejected} record(s) in the last send were refused and are not in Baker (${reasons}). The rest arrived. Tell the user what to fix in their file, sheet or system; the next send takes the corrected rows.`
+  ];
+}
+function statusHints(data) {
+  if (data.source === null) {
+    return [
+      "Nobody has said where the deals are yet. The user chooses in Measure \u2192 Accounts: HubSpot, or Another CRM (they send the deals)."
+    ];
+  }
+  if (data.source === "hubspot") return ["Deals are read from HubSpot; nothing needs sending."];
+  const failing = [...sheetHints(data.sheets), ...refusedHints(data.lastLive)];
+  if (data.lastLive === null && data.sheets.length === 0) {
+    return [
+      "Another CRM is chosen and nothing has arrived. Offer the three ways in, all in Measure \u2192 Sources \u2192 Deals: a CSV of deals or of companies uploaded there (check it first with `baker accounts crm check --file`), a Google Sheet they link there and Baker reads every night, or their developer sending from their system (`baker accounts crm contract`)."
+    ];
+  }
+  if ((data.contents?.companies ?? 0) > 0 && (data.contents?.deals ?? 0) === 0) {
+    return [
+      ...failing,
+      "Only companies have arrived, no deals. Baker matches them to the companies the LinkedIn ads reach, but no pipeline or revenue counts as influenced until deals arrive: offer the same ways in for a deals export (a deal names its company by the same website)."
+    ];
+  }
+  const sentStatus = (data.contents?.stages ?? []).some((stage) => stage.won > 0 || stage.lost > 0);
+  if (sentStatus || (data.contents?.deals ?? 0) === 0) return failing;
+  return [
+    ...failing,
+    "The deals arrived without a status (open, won, lost). Unless the user has picked which stages mean won and lost in Measure \u2192 Sources \u2192 Deals, no deal counts as won: send status with each deal, or ask them to pick."
+  ];
+}
+var CHECK_ARGS = {
+  file: {
+    type: "string",
+    description: "A CSV of deals or of companies (one row each), or a JSON body { companies, deals }",
+    required: true
+  }
+};
+registerSchema({
+  command: "accounts.crm.check",
+  description: "Check a client's CRM file before they send it: judged by exactly the rules the upload, a linked Google Sheet and the endpoint use, nothing stored. A CSV is a deals export (the deal's id, name, company, website, LinkedIn page, amount, currency, pipeline, stage, status, created and closed dates) or a company list (the company's id, name, website, LinkedIn page \u2014 a website alone is enough), told apart by its columns. Headers are read in any language or CRM wording, as the upload reads them; columns that are none of these are left behind. Dates may be YYYY-MM-DD or 15/03/2026. Returns {kind, received, accepted, rejected (each with the field and why), ignoredColumns}. Records naming a person (contact, owner, email, phone) are refused.",
+  args: CHECK_ARGS
+});
+var checkCommand = defineCommand({
+  meta: {
+    name: "check",
+    description: "Check a CRM export will be accepted, without sending it. Example: baker accounts crm check --file deals.csv"
+  },
+  args: CHECK_ARGS,
+  run: async ({ args }) => {
+    try {
+      const spent = [];
+      const { data, hints } = await checkCrmFile(
+        args.file,
+        readFileSync(args.file, "utf8"),
+        (questions) => askJevQuestions(questions, (usage) => spent.push(usage))
+      );
+      await holdWorkspaceSpend(spent);
+      writeJson({ ok: true, data, hints });
+    } catch (error) {
+      writeJson({
+        ok: false,
+        error: {
+          code: "INVALID_FILE",
+          message: `${args.file} could not be read as CSV or JSON: ${error instanceof Error ? error.message : String(error)}`
+        }
+      });
+      process.exit(1);
+    }
+  }
+});
+registerSchema({
+  command: "accounts.crm.contract",
+  description: "The whole contract for a client's developer (or their coding assistant) as Markdown: the address, the key to use, test mode, every company and deal field, the answer and an example. Hand it over as it is; never put a key in it.",
+  args: {}
+});
+var contractCommand = defineCommand({
+  meta: {
+    name: "contract",
+    description: "What a client's system sends, for their developer. Example: baker accounts crm contract"
+  },
+  args: {},
+  run: () => {
+    const env = getEnv();
+    process.stdout.write(crmPushBrief(crmPushUrl(env.BAKER_PUBLIC_API_URL, env.BAKER_API_URL)));
+  }
+});
+var SHEET_ARGS = {
+  account: {
+    type: "string",
+    description: "The Google Drive connection to create it with, when the company has more than one",
+    required: false
+  }
+};
+registerSchema({
+  command: "accounts.crm.sheet",
+  description: `Create the deals sheet LinkedIn's Account insights reads, for a company running LinkedIn campaigns whose CRM Baker cannot read (anything but HubSpot). Makes "Deals and companies for Baker" in the client's Google Drive \u2014 a Deals tab and a Companies tab headed by the columns Baker reads \u2014 and links both, so Baker reads it every night; chooses Another CRM first when nobody has said where the deals are. Applies at once (it is a real file) and goes on the chat's change list. Empty: nothing counts until the client fills it or pastes their CRM export into it. Asking again returns the sheet already linked. Needs a Google Drive connection and a chat owned by an admin of the company; refused when HubSpot is where the deals come from. Returns {created, spreadsheetName, url, tabs}.`,
+  args: SHEET_ARGS
+});
+function sheetFailureFix(code, message) {
+  if (code === "NOT_FOUND" && message.startsWith("No Google Drive account is connected")) {
+    return {
+      action: "request_connection",
+      explanation: 'Google Drive is not connected, and the sheet is made in it. Don\'t send the user to Settings or end the turn \u2014 call the `request_connection` tool with { platform: "google-drive", reason: "so I can create the sheet of your deals that LinkedIn Account insights reads" }; once they connect, run `baker accounts crm sheet` again. If they decline or the call fails, carry on with the rest of the work and leave a Task saying the deals sheet is still to create.'
+    };
+  }
+  if (message.startsWith("Only an admin")) {
+    return {
+      action: "continue_without",
+      explanation: "Carry on with the rest of the work and leave a Task for an admin: create the deals sheet for LinkedIn Account insights."
+    };
+  }
+  return null;
+}
+var sheetCommand = defineCommand({
+  meta: {
+    name: "sheet",
+    description: "Start here when the client runs LinkedIn ads and their deals are not in HubSpot: create and link the Google Sheet of deals Account insights reads. Example: baker accounts crm sheet"
+  },
+  args: SHEET_ARGS,
+  run: async ({ args }) => {
+    try {
+      const account = typeof args.account === "string" && args.account.trim() !== "" ? args.account.trim() : void 0;
+      const response = await apiPost("/api/accounts/crm/sheet", account ? { account } : {});
+      writeJson({
+        ...response,
+        hints: [
+          `Give the user the link (${response.data.url}). The client fills the Deals tab \u2014 or pastes their CRM's deals export into it \u2014 and keeps it up to date; Baker reads it every night, and "Read now" in Measure \u2192 Sources \u2192 Deals reads it at once. A website on each deal is enough to match it to the companies the LinkedIn ads reach.`,
+          "Check what arrived later with `baker accounts crm status`."
+        ]
+      });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        const fix = sheetFailureFix(err.code, err.message);
+        if (fix) {
+          writeJson({ ok: false, error: { code: err.code, message: err.message, fix } });
+          process.exit(1);
+        }
+      }
+      failApi(err);
+    }
+  }
+});
+var crmCommand = defineCommand({
+  meta: {
+    name: "crm",
+    description: "A CRM Baker cannot read (Salesforce, Pipedrive, a Google Sheet, their own): where the deals and companies stand, create the deals sheet Baker reads, check a file before it is sent, and the contract a developer sends to. Nothing here sends a deal."
+  },
+  subCommands: { status: statusCommand, sheet: sheetCommand, check: checkCommand, contract: contractCommand }
+});
+export {
+  checkCrmFile,
+  crmCommand,
+  sheetFailureFix,
+  statusHints
+};
+//# sourceMappingURL=crm-JMIIB55O.js.map

package/dist/crop-JRVHX3PX.js

@@ -0,0 +1,113 @@
+import {
+  atomicWrite,
+  isRemoteUrl,
+  readImageBuffer,
+  resolveOutputPath
+} from "./chunk-JD4DSJPT.js";
+import "./chunk-OYYAR5TD.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/images/crop.ts
+import { defineCommand } from "citty";
+
+// src/lib/image/crop-sprite.ts
+import sharp from "sharp";
+function cropSprite(input, region) {
+  return sharp(input).extract({
+    left: Math.round(region.x),
+    top: Math.round(region.y),
+    width: Math.round(region.width),
+    height: Math.round(region.height)
+  }).png().toBuffer();
+}
+
+// src/commands/images/crop.ts
+registerSchema({
+  command: "images.crop",
+  description: "Crop a rectangular region from a local image or remote URL. Coordinate-based extract.",
+  args: {
+    file: { type: "string", description: "Local file path or remote http(s) URL", required: true },
+    x: { type: "number", description: "Left coordinate (px)", required: true },
+    y: { type: "number", description: "Top coordinate (px)", required: true },
+    width: { type: "number", description: "Region width (px)", required: true },
+    height: { type: "number", description: "Region height (px)", required: true },
+    output: {
+      type: "string",
+      description: "Output path. Default: in-place for local files, ./crop.png for URLs.",
+      required: false
+    }
+  }
+});
+var ValidationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ValidationError";
+  }
+};
+function parseRegion(args) {
+  const result = { x: 0, y: 0, width: 0, height: 0 };
+  for (const key of ["x", "y", "width", "height"]) {
+    const raw = args[key];
+    const n = typeof raw === "number" ? raw : raw !== void 0 && raw !== "" ? Number(raw) : Number.NaN;
+    if (!Number.isFinite(n) || n < 0) {
+      throw new ValidationError(`--${key} must be a non-negative number`);
+    }
+    result[key] = n;
+  }
+  if (result.width === 0 || result.height === 0) {
+    throw new ValidationError("--width and --height must be > 0");
+  }
+  return result;
+}
+function emitError(err) {
+  if (err instanceof ValidationError) {
+    writeJson({ ok: false, error: { code: "VALIDATION_ERROR", message: err.message } });
+  } else {
+    const message = err instanceof Error ? err.message : "Unexpected error";
+    writeJson({ ok: false, error: { code: "IMAGE_PROCESSING_ERROR", message } });
+  }
+  process.exit(1);
+}
+var cropCommand = defineCommand({
+  meta: {
+    name: "crop",
+    description: "Crop a rectangular region from an image.\n\nExample: baker images crop sprite.png --x 0 --y 0 --width 64 --height 64 --output icon.png"
+  },
+  args: {
+    file: { type: "positional", description: "Local file path or remote http(s) URL", required: false },
+    x: { type: "string", description: "Left coordinate (px)", required: false },
+    y: { type: "string", description: "Top coordinate (px)", required: false },
+    width: { type: "string", description: "Region width (px)", required: false },
+    height: { type: "string", description: "Region height (px)", required: false },
+    output: { type: "string", description: "Output path", required: false }
+  },
+  run: async ({ args }) => {
+    try {
+      const file = args.file;
+      if (!file) {
+        throw new ValidationError("file argument is required");
+      }
+      const region = parseRegion(args);
+      const outputArg = typeof args.output === "string" && args.output.length > 0 ? args.output : void 0;
+      const inputBuffer = await readImageBuffer(file);
+      const output = await cropSprite(inputBuffer, region);
+      const outputPath = isRemoteUrl(file) ? outputArg ?? "./crop.png" : await resolveOutputPath(file, outputArg, { multipleInputs: false, newExtension: ".png" });
+      await atomicWrite(outputPath, output);
+      writeJson({
+        ok: true,
+        data: { input: file, output: outputPath, sizeBytes: output.length, region }
+      });
+    } catch (err) {
+      emitError(err);
+    }
+  }
+});
+export {
+  cropCommand
+};
+//# sourceMappingURL=crop-JRVHX3PX.js.map

package/dist/currency-HQW6FJS5.js

@@ -0,0 +1,88 @@
+import {
+  parseApiError
+} from "./chunk-JZ6XRIXG.js";
+import "./chunk-GCFC2MNR.js";
+import {
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  resolveCustomerId,
+  writeAdsJson
+} from "./chunk-EAHBTBVR.js";
+import "./chunk-BNO3EFGR.js";
+import {
+  ApiError,
+  apiGet
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/google/currency.ts
+import { defineCommand } from "citty";
+registerSchema({
+  command: "ads.google.currency",
+  description: "Get the currency code for a Google Ads account. Returns currency_code, customer_id, account_name, and access_type. Call this before interpreting cost_micros values.",
+  args: {
+    "customer-id": {
+      type: "string",
+      description: "Google Ads customer ID (10 digits, no dashes). Falls back to BAKER_GOOGLE_ADS_CUSTOMER_ID env var.",
+      required: false
+    },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  }
+});
+var currencyCommand = defineCommand({
+  meta: {
+    name: "currency",
+    description: `Get account currency code. Use this to interpret metrics.cost_micros values.
+
+Examples:
+  baker ads google currency --customer-id 1234567890`
+  },
+  args: {
+    "customer-id": { type: "string", description: "Google Ads customer ID (10 digits)", required: false },
+    "no-cache": { type: "boolean", description: "Skip cache", required: false }
+  },
+  run: async ({ args }) => {
+    const customerId = await resolveCustomerId(args);
+    const useCache = !args["no-cache"];
+    const cacheKey = `currency:${customerId}`;
+    if (useCache) {
+      const cached = cacheGet("accounts", cacheKey);
+      if (cached) {
+        writeAdsJson({ ok: true, data: cached.data, cached: true });
+        return;
+      }
+    }
+    try {
+      const params = { "customer-id": customerId };
+      const managerId = getManagerIdForCustomer(customerId);
+      if (managerId) params["manager-id"] = managerId;
+      if (!useCache) params["skip-cache"] = "true";
+      const raw = await apiGet("/api/ads/google/currency", params);
+      const data = {
+        currency_code: raw.currencyCode,
+        customer_id: raw.customerId
+      };
+      if (useCache) {
+        cacheSet("accounts", cacheKey, data, 24 * 60 * 60 * 1e3);
+      }
+      writeAdsJson({ ok: true, data });
+    } catch (err) {
+      if (err instanceof ApiError) {
+        writeAdsJson(parseApiError(err.message, "", customerId, err.code));
+        process.exit(1);
+      }
+      writeAdsJson({ ok: false, error: { code: "NETWORK_ERROR", message: "Unexpected error" } });
+      process.exit(1);
+    }
+  }
+});
+export {
+  currencyCommand
+};
+//# sourceMappingURL=currency-HQW6FJS5.js.map

package/dist/custom-conversions-OVUDN3HH.js

@@ -0,0 +1,128 @@
+import {
+  csvOrJson,
+  handleMetaError,
+  resolveAccountIdArg
+} from "./chunk-KDDHMKTU.js";
+import "./chunk-QALAJNBG.js";
+import {
+  writeAdsOutput,
+  writeJsonEnvelope
+} from "./chunk-EAHBTBVR.js";
+import {
+  NO_CACHE_ARG
+} from "./chunk-3PG7O3ZW.js";
+import {
+  apiGet
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/ads/meta/custom-conversions.ts
+import { defineCommand } from "citty";
+function compactCustomConversion(row) {
+  return {
+    id: row.id,
+    name: row.name,
+    custom_event_type: row.custom_event_type,
+    counts: row.rule_summary,
+    pixel_id: row.pixel?.id,
+    last_fired_time: row.last_fired_time,
+    ...row.is_archived ? { archived: true } : {},
+    ...row.is_unavailable ? { unavailable: true } : {}
+  };
+}
+function customConversionHints(rows) {
+  if (rows.length === 0) {
+    return [
+      "This account has no custom conversions. Optimize toward a standard pixel event instead (`--pixel-id` + `--custom-event-type`), or stage one: `baker ads meta custom-conversions create --name \u2026 --pixel-id \u2026 --custom-event-type LEAD --url-contains /thank-you`."
+    ];
+  }
+  const hints = [
+    "To optimize an ad set toward one: `baker ads meta adsets create \u2026 --optimization-goal OFFSITE_CONVERSIONS --custom-conversion-id <id>`. Baker fills the pixel and the event category from the conversion \u2014 do not also pass --pixel-id or --custom-event-type."
+  ];
+  const neverFired = rows.filter((row) => !row.is_archived && !row.last_fired_time);
+  if (neverFired.length > 0) {
+    hints.push(
+      `${neverFired.length === 1 ? "This conversion has" : `${neverFired.length} of these have`} never fired (${neverFired.map((row) => row.name ?? row.id).join(
+        ", "
+      )}). Meta cannot optimize toward an event it has never seen, so an ad set pointed at one delivers without learning \u2014 check the rule matches a page the site actually serves before spending on it.`
+    );
+  }
+  return hints;
+}
+registerSchema({
+  command: "ads.meta.custom-conversions",
+  description: "List the Custom Conversions defined on a Meta ad account \u2014 the measurement objects a marketer sets up in Events Manager (a pixel event narrowed by a rule, e.g. 'PageView on /thank-you'). Start here whenever the user talks about their own conversions rather than a standard event: an ad set optimizes toward one with `adsets create --custom-conversion-id <id>`.",
+  args: {
+    "account-id": { type: "string", description: "Meta ad account ID (act_123)", required: false },
+    full: { type: "boolean", description: "Include the raw rule JSON, retention and creation times", required: false },
+    limit: { type: "string", description: "Max rows", required: false },
+    "no-cache": { type: "boolean", description: "Bypass the cache", required: false },
+    output: { type: "string", description: "json|csv", required: false, default: "json" }
+  }
+});
+var listArgs = {
+  "account-id": { type: "string", description: "Meta ad account ID" },
+  full: { type: "boolean", description: "Include the raw rule JSON, retention and creation times" },
+  limit: { type: "string", description: "Max rows" },
+  "no-cache": NO_CACHE_ARG,
+  output: { type: "string", description: "Output format: json|csv|jsonl|md", default: "json" }
+};
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List custom conversions. Runs by default when no subcommand is given. Example: baker ads meta custom-conversions --account-id act_123"
+  },
+  args: listArgs,
+  run: async ({ args }) => {
+    const accountId = await resolveAccountIdArg(args);
+    try {
+      const params = { "account-id": accountId };
+      if (args.limit) params.limit = args.limit;
+      if (args["no-cache"]) params["skip-cache"] = "true";
+      const rows = await apiGet("/api/ads/meta/custom-conversions", params);
+      const data = args.full ? rows.map((row) => ({ ...row })) : rows.map((row) => ({ ...compactCustomConversion(row) }));
+      const fmt = csvOrJson(args);
+      if (fmt !== "json") {
+        writeAdsOutput(data, fmt);
+        return;
+      }
+      writeJsonEnvelope({ ok: true, data, hints: customConversionHints(rows) });
+    } catch (err) {
+      handleMetaError(err);
+    }
+  }
+});
+var customConversionsCommand = defineCommand({
+  meta: {
+    name: "custom-conversions",
+    description: `List the Custom Conversions on an ad account, or stage a new one \u2014 a pixel event narrowed by a rule, set up in Events Manager.
+Use this whenever the user says "my conversions" rather than naming a standard event: the id here is what an ad set optimizes toward.
+
+Examples:
+  baker ads meta custom-conversions --account-id act_123
+  baker ads meta custom-conversions --account-id act_123 --full   # raw rule JSON
+  baker ads meta custom-conversions create --name "Lead formulario" --pixel-id 9988 --custom-event-type LEAD --url-contains "/gracias"`
+  },
+  subCommands: {
+    list: listCommand,
+    create: () => import("./write-commands-TPPJHGMT.js").then((m) => m.customConversionsCreateCommand),
+    update: () => import("./asset-writes-ZMSJSFTD.js").then((m) => m.customConversionsUpdateCommand),
+    delete: () => import("./asset-writes-ZMSJSFTD.js").then((m) => m.customConversionsDeleteCommand)
+  },
+  // `args` stays even though the parent has no `run`: citty scans rawArgs for
+  // the subcommand name using THIS command's arg defs. `default` (not `run`)
+  // dispatches the bare invocation.
+  args: listArgs,
+  default: "list"
+});
+export {
+  compactCustomConversion,
+  customConversionHints,
+  customConversionsCommand
+};
+//# sourceMappingURL=custom-conversions-OVUDN3HH.js.map

package/dist/custom-conversions-OVUDN3HH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/ads/meta/custom-conversions.ts"],"sourcesContent":["import { defineCommand } from \"citty\";\nimport { NO_CACHE_ARG } from \"../../../cache-flag.ts\";\nimport { apiGet } from \"../../../client.ts\";\nimport { registerSchema } from \"../../../schemas.ts\";\nimport { writeAdsOutput, writeJsonEnvelope } from \"../output.ts\";\nimport { csvOrJson, handleMetaError, resolveAccountIdArg } from \"./shared.ts\";\n\n/** A Custom Conversion as the backend returns it, rule already read back as a phrase. */\nexport interface MetaCustomConversion {\n  id: string;\n  name?: string;\n  description?: string;\n  custom_event_type?: string;\n  event_source_type?: string;\n  pixel?: { id?: string; name?: string };\n  rule?: string;\n  rule_summary?: string;\n  default_conversion_value?: number;\n  retention_days?: number;\n  is_archived?: boolean;\n  is_unavailable?: boolean;\n  creation_time?: string;\n  first_fired_time?: string;\n  last_fired_time?: string;\n}\n\n/** What the caller needs to pick one. The raw rule and the timestamps sit behind --full. */\ninterface CompactCustomConversion {\n  id: string;\n  name?: string;\n  custom_event_type?: string;\n  counts?: string;\n  pixel_id?: string;\n  last_fired_time?: string;\n  archived?: true;\n  unavailable?: true;\n}\n\nexport function compactCustomConversion(row: MetaCustomConversion): CompactCustomConversion {\n  return {\n    id: row.id,\n    name: row.name,\n    custom_event_type: row.custom_event_type,\n    counts: row.rule_summary,\n    pixel_id: row.pixel?.id,\n    last_fired_time: row.last_fired_time,\n    ...(row.is_archived ? { archived: true as const } : {}),\n    ...(row.is_unavailable ? { unavailable: true as const } : {}),\n  };\n}\n\n/**\n * What to say about a listing, once.\n *\n * A conversion that has never fired is the one thing that reads as \"broken\" and\n * usually is not — Meta creates it counting nothing until the rule matches a\n * real event — while pointing an ad set at one is a real decision with a real\n * cost, because Meta cannot optimize toward an event it has never seen. Saying\n * so here is cheaper than the chat where it gets discovered after a week of\n * delivery.\n */\nexport function customConversionHints(rows: MetaCustomConversion[]): string[] {\n  if (rows.length === 0) {\n    return [\n      \"This account has no custom conversions. Optimize toward a standard pixel event instead (`--pixel-id` + `--custom-event-type`), or stage one: `baker ads meta custom-conversions create --name … --pixel-id … --custom-event-type LEAD --url-contains /thank-you`.\",\n    ];\n  }\n  const hints: string[] = [\n    \"To optimize an ad set toward one: `baker ads meta adsets create … --optimization-goal OFFSITE_CONVERSIONS --custom-conversion-id <id>`. Baker fills the pixel and the event category from the conversion — do not also pass --pixel-id or --custom-event-type.\",\n  ];\n  const neverFired = rows.filter((row) => !row.is_archived && !row.last_fired_time);\n  if (neverFired.length > 0) {\n    hints.push(\n      `${neverFired.length === 1 ? \"This conversion has\" : `${neverFired.length} of these have`} never fired (${neverFired\n        .map((row) => row.name ?? row.id)\n        .join(\n          \", \",\n        )}). Meta cannot optimize toward an event it has never seen, so an ad set pointed at one delivers without learning — check the rule matches a page the site actually serves before spending on it.`,\n    );\n  }\n  return hints;\n}\n\nregisterSchema({\n  command: \"ads.meta.custom-conversions\",\n  description:\n    \"List the Custom Conversions defined on a Meta ad account — the measurement objects a marketer sets up in Events Manager (a pixel event narrowed by a rule, e.g. 'PageView on /thank-you'). Start here whenever the user talks about their own conversions rather than a standard event: an ad set optimizes toward one with `adsets create --custom-conversion-id <id>`.\",\n  args: {\n    \"account-id\": { type: \"string\", description: \"Meta ad account ID (act_123)\", required: false },\n    full: { type: \"boolean\", description: \"Include the raw rule JSON, retention and creation times\", required: false },\n    limit: { type: \"string\", description: \"Max rows\", required: false },\n    \"no-cache\": { type: \"boolean\", description: \"Bypass the cache\", required: false },\n    output: { type: \"string\", description: \"json|csv\", required: false, default: \"json\" },\n  },\n});\n\nconst listArgs = {\n  \"account-id\": { type: \"string\", description: \"Meta ad account ID\" },\n  full: { type: \"boolean\", description: \"Include the raw rule JSON, retention and creation times\" },\n  limit: { type: \"string\", description: \"Max rows\" },\n  \"no-cache\": NO_CACHE_ARG,\n  output: { type: \"string\", description: \"Output format: json|csv|jsonl|md\", default: \"json\" },\n} as const;\n\nconst listCommand = defineCommand({\n  meta: {\n    name: \"list\",\n    description:\n      \"List custom conversions. Runs by default when no subcommand is given. Example: baker ads meta custom-conversions --account-id act_123\",\n  },\n  args: listArgs,\n  run: async ({ args }) => {\n    const accountId = await resolveAccountIdArg(args);\n    try {\n      const params: Record<string, string> = { \"account-id\": accountId };\n      if (args.limit) params.limit = args.limit as string;\n      if (args[\"no-cache\"]) params[\"skip-cache\"] = \"true\";\n      const rows = await apiGet<MetaCustomConversion[]>(\"/api/ads/meta/custom-conversions\", params);\n      const data: Array<Record<string, unknown>> = args.full\n        ? rows.map((row) => ({ ...row }))\n        : rows.map((row) => ({ ...compactCustomConversion(row) }));\n      const fmt = csvOrJson(args);\n      if (fmt !== \"json\") {\n        writeAdsOutput(data, fmt);\n        return;\n      }\n      writeJsonEnvelope({ ok: true, data, hints: customConversionHints(rows) });\n    } catch (err) {\n      handleMetaError(err);\n    }\n  },\n});\n\nexport const customConversionsCommand = defineCommand({\n  meta: {\n    name: \"custom-conversions\",\n    description: `List the Custom Conversions on an ad account, or stage a new one — a pixel event narrowed by a rule, set up in Events Manager.\nUse this whenever the user says \"my conversions\" rather than naming a standard event: the id here is what an ad set optimizes toward.\n\nExamples:\n  baker ads meta custom-conversions --account-id act_123\n  baker ads meta custom-conversions --account-id act_123 --full   # raw rule JSON\n  baker ads meta custom-conversions create --name \"Lead formulario\" --pixel-id 9988 --custom-event-type LEAD --url-contains \"/gracias\"`,\n  },\n  subCommands: {\n    list: listCommand,\n    create: () => import(\"./write-commands.ts\").then((m) => m.customConversionsCreateCommand),\n    update: () => import(\"./asset-writes.ts\").then((m) => m.customConversionsUpdateCommand),\n    delete: () => import(\"./asset-writes.ts\").then((m) => m.customConversionsDeleteCommand),\n  },\n  // `args` stays even though the parent has no `run`: citty scans rawArgs for\n  // the subcommand name using THIS command's arg defs. `default` (not `run`)\n  // dispatches the bare invocation.\n  args: listArgs,\n  default: \"list\",\n});\n"],"mappings":"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","names":[]}