@koda-sl/baker-cli 0.536.0 → 0.537.0

package/dist/crm-YVRIT2RL.js

@@ -0,0 +1,227 @@
+import {
+  failNotConnected
+} from "./chunk-FOD5VSHH.js";
+import {
+  writeAdsOutput
+} from "./chunk-EAHBTBVR.js";
+import "./chunk-THV7SMY6.js";
+import {
+  hubspotCompaniesSearchRequestSchema,
+  hubspotDealsListRequestSchema
+} from "./chunk-3LH5ANM4.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-TI4UL56R.js";
+import {
+  apiPost
+} from "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import {
+  registerSchema,
+  writeJson
+} from "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+
+// src/commands/hubspot/crm.ts
+import { defineCommand } from "citty";
+function dealsListHints(data, request) {
+  const hints = [];
+  if (data.deals.length === 0 && (request.pipelineIds.length > 0 || request.modifiedSince !== void 0)) {
+    hints.push(
+      "No deals matched. Widen the read: drop --pipeline, or pass an earlier --modified-since (`baker hubspot pipelines list` shows the pipeline ids)."
+    );
+  }
+  if (data.next !== null) {
+    hints.push(`More deals follow: run it again with --after ${data.next}.`);
+  }
+  if (data.restartFrom !== null) {
+    hints.push(
+      `HubSpot stops one search at 10,000 deals. Read on with --modified-since ${data.restartFrom} (no --after); the first deal repeats the last one here.`
+    );
+  }
+  if (!data.companiesReadable) {
+    hints.push(
+      "Deals came back without their companies: this HubSpot connection cannot read companies. Do not report a deal as having no company \u2014 you cannot tell. The user can enable it by reconnecting HubSpot."
+    );
+  }
+  return hints;
+}
+function companiesSearchHints(data, request) {
+  const hints = [];
+  if (data.notFound.length > 0) {
+    hints.push(
+      `${data.notFound.length} domain(s) are not in HubSpot: ${data.notFound.join(", ")}. Those companies are new to the CRM \u2014 not in pipeline \u2014 which is a finding, not a failed search.`
+    );
+  }
+  if (!request.withDeals && data.companies.length > 0) {
+    hints.push("Add --with-deals to see each company's deals: amount, stage, and whether it closed won.");
+  }
+  if (data.truncated) {
+    hints.push(
+      "More companies matched than --limit, so the search stopped before checking every domain: a domain with no row here may still be in HubSpot, and notFound leaves it out. Do not report a domain without a row as new to the CRM until a search returns every match: raise --limit (up to 500) or search fewer domains at a time."
+    );
+  }
+  return hints;
+}
+function list(raw, separator) {
+  if (typeof raw !== "string") return void 0;
+  const items = raw.split(separator).map((item) => item.trim()).filter(Boolean);
+  return items.length > 0 ? items : void 0;
+}
+function optionalNumber(raw) {
+  return typeof raw === "string" && raw.trim() !== "" ? Number(raw) : void 0;
+}
+function failInvalid(issues) {
+  writeJson({
+    ok: false,
+    error: {
+      code: "VALIDATION_ERROR",
+      message: issues.map((issue) => `${issue.path.map(String).join(".") || "args"}: ${issue.message}`).join("; ")
+    }
+  });
+  process.exit(1);
+}
+var OUTPUT_ARG = {
+  type: "string",
+  description: "json|csv|jsonl|md (default json). csv/jsonl/md print the rows only; hints go to stderr",
+  required: false,
+  default: "json"
+};
+var COMPANIES_SEARCH_ARGS = {
+  domains: {
+    type: "string",
+    description: "Comma-separated website domains, up to 100 (acme.com,globex.io). URLs and www. are fine",
+    required: false
+  },
+  names: {
+    type: "string",
+    description: "Semicolon-separated exact company names (names contain commas): 'Acme, Inc.;Globex'",
+    required: false
+  },
+  "with-deals": {
+    type: "boolean",
+    description: "Add each company's deals: amount, currency, pipeline, stage, closed/won, dates",
+    required: false,
+    default: false
+  },
+  limit: { type: "string", description: "Most companies to return, 1-500 (default 100)", required: false },
+  output: OUTPUT_ARG
+};
+registerSchema({
+  command: "hubspot.companies.search",
+  description: "Find the client's CRM companies (accounts) by website domain or name \u2014 start here to match an outside list of companies against HubSpot, e.g. the companies `baker ads linkedin companies --with-domains` says the ads reached: which are already accounts, which have deals, which are new. Rows: {id, name, domain, linkedinPage}; --with-deals adds each company's deals. `notFound` lists the domains no CRM company carries \u2014 new to the CRM, a finding; when `truncated`, it leaves out the domains the search did not reach. Reads records only; changes nothing in HubSpot.",
+  args: COMPANIES_SEARCH_ARGS
+});
+var COMPANY_CSV_FIELDS = ["id", "name", "domain", "linkedinPage", "deals"];
+var companiesSearchCommand = defineCommand({
+  meta: {
+    name: "search",
+    description: "Find CRM companies by domain or name, optionally with their deals. Example: baker hubspot companies search --domains acme.com,globex.io --with-deals"
+  },
+  args: COMPANIES_SEARCH_ARGS,
+  run: async ({ args }) => {
+    const input = {
+      domains: list(args.domains, ","),
+      names: list(args.names, ";"),
+      withDeals: Boolean(args["with-deals"]),
+      limit: optionalNumber(args.limit)
+    };
+    const parsed = hubspotCompaniesSearchRequestSchema.safeParse(input);
+    if (!parsed.success) failInvalid(parsed.error.issues);
+    try {
+      const response = await apiPost("/api/hubspot/companies/search", parsed.data);
+      const hints = companiesSearchHints(response.data, { withDeals: parsed.data.withDeals === true });
+      const format = String(args.output ?? "json");
+      if (format !== "json") {
+        writeAdsOutput(response.data.companies, format, COMPANY_CSV_FIELDS, hints);
+        return;
+      }
+      writeJson({
+        ...response,
+        meta: { count: response.data.companies.length },
+        ...hints.length > 0 ? { hints } : {}
+      });
+    } catch (err) {
+      failNotConnected(err, "so I can see which of your companies and deals the ads reached");
+    }
+  }
+});
+var DEALS_LIST_ARGS = {
+  pipeline: {
+    type: "string",
+    description: "Comma-separated pipeline ids, from `baker hubspot pipelines list` (default: every pipeline)",
+    required: false
+  },
+  "modified-since": {
+    type: "string",
+    description: "Only deals changed on or after this date (YYYY-MM-DD or ISO date-time)",
+    required: false
+  },
+  limit: { type: "string", description: "Most deals to return, 1-1000 (default 200)", required: false },
+  after: { type: "string", description: "Cursor from the previous page's `next`", required: false },
+  output: OUTPUT_ARG
+};
+registerSchema({
+  command: "hubspot.deals.list",
+  description: "The client's deals, oldest change first: {id, name, amount, currency, pipelineId, stageId, stageLabel, isClosed, isWon, createdAt, closedAt, modifiedAt, companyIds}. Start here for pipeline and revenue questions \u2014 which deals closed won, what is open, which companies they belong to (`companyIds` are HubSpot company ids, the same as `hubspot companies search` returns). Page with --after <next> until it is null. `amount: null` means no amount was entered, not zero.",
+  args: DEALS_LIST_ARGS
+});
+var DEAL_CSV_FIELDS = [
+  "id",
+  "name",
+  "amount",
+  "currency",
+  "pipelineId",
+  "stageId",
+  "stageLabel",
+  "isClosed",
+  "isWon",
+  "createdAt",
+  "closedAt",
+  "modifiedAt",
+  "companyIds"
+];
+var dealsListCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List deals with amount, stage and whether they closed won. Example: baker hubspot deals list --pipeline default --modified-since 2026-01-01"
+  },
+  args: DEALS_LIST_ARGS,
+  run: async ({ args }) => {
+    const input = {
+      pipelineIds: list(args.pipeline, ","),
+      modifiedSince: typeof args["modified-since"] === "string" ? args["modified-since"] : void 0,
+      limit: optionalNumber(args.limit),
+      after: typeof args.after === "string" && args.after !== "" ? args.after : void 0
+    };
+    const parsed = hubspotDealsListRequestSchema.safeParse(input);
+    if (!parsed.success) failInvalid(parsed.error.issues);
+    try {
+      const response = await apiPost("/api/hubspot/deals/list", parsed.data);
+      const hints = dealsListHints(response.data, {
+        pipelineIds: parsed.data.pipelineIds ?? [],
+        modifiedSince: parsed.data.modifiedSince
+      });
+      const format = String(args.output ?? "json");
+      if (format !== "json") {
+        writeAdsOutput(response.data.deals, format, DEAL_CSV_FIELDS, hints);
+        return;
+      }
+      writeJson({ ...response, meta: { count: response.data.deals.length }, ...hints.length > 0 ? { hints } : {} });
+    } catch (err) {
+      failNotConnected(err, "so I can see which of your companies and deals the ads reached");
+    }
+  }
+});
+export {
+  companiesSearchCommand,
+  companiesSearchHints,
+  dealsListCommand,
+  dealsListHints
+};
+//# sourceMappingURL=crm-YVRIT2RL.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-SH4DDE3X.js

@@ -0,0 +1,88 @@
+import {
+  parseApiError
+} from "./chunk-WAE4G3Q6.js";
+import "./chunk-UIPSSTMA.js";
+import {
+  cacheGet,
+  cacheSet,
+  getManagerIdForCustomer,
+  resolveCustomerId,
+  writeAdsJson
+} from "./chunk-EAHBTBVR.js";
+import "./chunk-TI4UL56R.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-SH4DDE3X.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":[]}

package/dist/customers-FSOXPMOU.js

@@ -0,0 +1,59 @@
+import {
+  FORCES,
+  INSIGHT_TYPES,
+  MAX_QUOTE_CHARS,
+  batchSources,
+  buildCustomersPrompt,
+  candidatesFrom,
+  customersCommand,
+  customersHints,
+  keepVerbatim,
+  planInsightWrites,
+  renderInsightFile,
+  researchCustomers,
+  sourcesFromPages,
+  sourcesFromReddit,
+  sourcesFromTestimonials
+} from "./chunk-BYZQ43VI.js";
+import "./chunk-KJOEW2PI.js";
+import "./chunk-EKQCHHZW.js";
+import "./chunk-UMQCYEAL.js";
+import "./chunk-ERSX3MKH.js";
+import "./chunk-W3PJ7V4W.js";
+import "./chunk-CM2LECNX.js";
+import "./chunk-4PWC4KAK.js";
+import "./chunk-MCJ5I5LR.js";
+import "./chunk-AXSSATJW.js";
+import "./chunk-DNRXEP4A.js";
+import "./chunk-OYYAR5TD.js";
+import "./chunk-3LH5ANM4.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-TI4UL56R.js";
+import "./chunk-C35UMKYG.js";
+import "./chunk-ELAYD7O3.js";
+import "./chunk-LBIF6FJY.js";
+import "./chunk-TRXGJZDL.js";
+import "./chunk-YQSBHWOI.js";
+export {
+  FORCES,
+  INSIGHT_TYPES,
+  MAX_QUOTE_CHARS,
+  batchSources,
+  buildCustomersPrompt,
+  candidatesFrom,
+  customersCommand,
+  customersHints,
+  keepVerbatim,
+  planInsightWrites,
+  renderInsightFile,
+  researchCustomers,
+  sourcesFromPages,
+  sourcesFromReddit,
+  sourcesFromTestimonials
+};
+//# sourceMappingURL=customers-FSOXPMOU.js.map