@koda-sl/baker-cli 0.306.8 → 0.306.9

package/dist/cli.js

@@ -12194,13 +12194,25 @@ registerSchema({
   }
 });
 function extractFields(rows) {
-  if (rows.length === 0) return [];
-  const first = rows[0];
-  return first ? Object.keys(first) : [];
+  const keys = /* @__PURE__ */ new Set();
+  foldObservedFields(rows, keys);
+  return [...keys];
+}
+function resultColumns(gaql, rows) {
+  const observed = extractFields(rows);
+  const columns = [];
+  for (const field of parseSelectedFields(gaql)) {
+    const leaves = observed.filter((key) => key.startsWith(`${field}.`));
+    columns.push(...leaves.length > 0 ? leaves : [field]);
+  }
+  for (const key of observed) columns.push(key);
+  return [...new Set(columns)];
+}
+function isCsvPath(filePath) {
+  return filePath.split(".").pop()?.toLowerCase() === "csv";
 }
 function writeRowsToFile(filePath, rows, fields, append) {
-  const ext = filePath.split(".").pop()?.toLowerCase();
-  if (ext === "csv") {
+  if (isCsvPath(filePath)) {
     if (!append || !existsSync2(filePath)) {
       writeFileSync(filePath, `${toCsvRow(fields)}
 `, "utf-8");
@@ -12208,7 +12220,7 @@ function writeRowsToFile(filePath, rows, fields, append) {
     const csvRows = rows.map((row) => toCsvRow(fields.map((f) => String(row[f] ?? ""))));
     appendFileSync(filePath, `${csvRows.join("\n")}
 `, "utf-8");
-  } else if (ext === "jsonl") {
+  } else if (filePath.split(".").pop()?.toLowerCase() === "jsonl") {
     const lines = rows.map((row) => JSON.stringify(row));
     if (append && existsSync2(filePath)) {
       appendFileSync(filePath, `${lines.join("\n")}
@@ -12298,16 +12310,25 @@ var writeJsonlRows = (rows, _fields, notices) => {
   for (const line of notices) writeLine(line);
   for (const row of rows) writeLine(JSON.stringify(row));
 };
+var OMITTED = "(omitted)";
+var OMITTED_FALSE = `false ${OMITTED}`;
+var OMITTED_LEGEND = `> ${OMITTED} = Google left this field off the row, which is how it sends false, 0 and "not set": the field WAS read. A field with no column here was not read.`;
+function mdCell(row, field, booleanColumns) {
+  if (!(field in row)) return booleanColumns.has(field) ? OMITTED_FALSE : OMITTED;
+  return String(row[field] ?? "").replace(/\|/g, "\\|");
+}
 var writeMdRows = (rows, fields, notices) => {
+  const booleanColumns = new Set(fields.filter((f) => rows.some((row) => typeof row[f] === "boolean")));
   for (const line of notices) writeLine(line);
   writeLine(`| ${fields.join(" | ")} |`);
   writeLine(`| ${fields.map(() => "---").join(" | ")} |`);
-  for (const row of rows) writeLine(`| ${fields.map((f) => String(row[f] ?? "")).join(" | ")} |`);
+  for (const row of rows) writeLine(`| ${fields.map((f) => mdCell(row, f, booleanColumns)).join(" | ")} |`);
+  if (rows.some((row) => fields.some((f) => !(f in row)))) writeLine(OMITTED_LEGEND);
 };
 var ROW_WRITERS = { csv: writeCsvRows, jsonl: writeJsonlRows, md: writeMdRows };
-function writeRows(format, rows, notices) {
+function writeRows(format, rows, columns, notices) {
   const write2 = ROW_WRITERS[format] ?? writeMdRows;
-  write2(rows, Object.keys(rows[0] ?? {}), notices);
+  write2(rows, columns, notices);
   if (rows.length > REPEAT_NOTICE_ABOVE_ROWS) {
     for (const line of notices) writeLine(line);
   }
@@ -12334,7 +12355,7 @@ function outputResults(rows, fieldDescs, warnings, args, cached, read) {
     );
     return;
   }
-  writeRows(format, rows, warningLines(allWarnings, format));
+  writeRows(format, rows, resultColumns(read.gaql, rows), warningLines(allWarnings, format));
 }
 function resolveGaql(args, limit) {
   if (args.preset) {
@@ -12453,15 +12474,27 @@ function missingFieldWarningsFor(gaql, observed, rowCount2) {
     }
   ];
 }
+function unwrittenColumnWarnings(header, observed) {
+  const written = new Set(header);
+  const unwritten = [...observed].filter((key) => !written.has(key));
+  if (unwritten.length === 0) return [];
+  return [
+    {
+      code: "UNWRITTEN_COLUMNS",
+      message: `The file has no column for ${unwritten.join(", ")}: the header was fixed on the first page, which carried none of them, so their values from later pages are NOT in the file. Do not read those columns as empty. SELECT these fields by name instead of their parent, or write to a .jsonl file, then re-run.`
+    }
+  ];
+}
 function keywordServingOptions(gaql) {
   return { statusReasonsSelected: parseSelectedFields(gaql).includes("ad_group_criterion.primary_status_reasons") };
 }
-async function fetchAllPages(body, args, servingOptions) {
+async function fetchAllPages(gaql, body, args, servingOptions) {
   let allRows = [];
   let pageToken = args.cursor;
   let totalRowsWritten = 0;
   let keywordLimits;
   const observedFields = /* @__PURE__ */ new Set();
+  let fileColumns;
   do {
     const requestBody2 = { ...body };
     if (pageToken) requestBody2.pageToken = pageToken;
@@ -12470,7 +12503,8 @@ async function fetchAllPages(body, args, servingOptions) {
     pageToken = response.pageToken;
     if (args.out) {
       const shouldAppend = args.append || totalRowsWritten > 0;
-      writeRowsToFile(resolve(args.out), rows, extractFields(rows), shouldAppend);
+      fileColumns ??= resultColumns(gaql, rows);
+      writeRowsToFile(resolve(args.out), rows, fileColumns, shouldAppend);
       totalRowsWritten += rows.length;
       keywordLimits = collectKeywordLimits(rows, servingOptions, keywordLimits);
       foldObservedFields(rows, observedFields);
@@ -12484,7 +12518,8 @@ async function fetchAllPages(body, args, servingOptions) {
     lastPageToken: pageToken,
     totalRowsWritten,
     keywordLimits: keywordLimits ?? collectKeywordLimits([], servingOptions),
-    observedFields
+    observedFields,
+    fileColumns: fileColumns ?? []
   };
 }
 async function executeQuery(finalQuery, args, customerId, limit, warnings, useCache, cacheKey) {
@@ -12494,7 +12529,8 @@ async function executeQuery(finalQuery, args, customerId, limit, warnings, useCa
   if (args.cursor) body.pageToken = args.cursor;
   if (!useCache) body.skipCache = true;
   const servingOptions = keywordServingOptions(finalQuery);
-  const { allRows, lastPageToken, totalRowsWritten, keywordLimits, observedFields } = await fetchAllPages(
+  const { allRows, lastPageToken, totalRowsWritten, keywordLimits, observedFields, fileColumns } = await fetchAllPages(
+    finalQuery,
     body,
     args,
     servingOptions
@@ -12510,6 +12546,8 @@ async function executeQuery(finalQuery, args, customerId, limit, warnings, useCa
       ...warnings,
       ...renderKeywordLimits(keywordLimits),
       ...missingFieldWarningsFor(finalQuery, observedFields, totalRowsWritten),
+      // Only a CSV has a header to fall out of; json and jsonl files carry every row whole.
+      ...isCsvPath(args.out) ? unwrittenColumnWarnings(fileColumns, observedFields) : [],
       ...conversionMixWarnings(finalQuery),
       ...truncation
     ];
@@ -12541,6 +12579,7 @@ async function executeQuery(finalQuery, args, customerId, limit, warnings, useCa
     args,
     false,
     {
+      gaql: finalQuery,
       effectiveLimit: effectiveRowLimit(finalQuery, limit, Boolean(args.all)),
       all: Boolean(args.all),
       nextCursor: lastPageToken
@@ -12658,7 +12697,11 @@ Examples:
           ],
           args,
           true,
-          { effectiveLimit: effectiveRowLimit(finalQuery, limit, Boolean(args.all)), all: Boolean(args.all) }
+          {
+            gaql: finalQuery,
+            effectiveLimit: effectiveRowLimit(finalQuery, limit, Boolean(args.all)),
+            all: Boolean(args.all)
+          }
         );
         return;
       }
@@ -21723,7 +21766,26 @@ var OPTIMIZATION_GOALS = [
   "THRUPLAY",
   "VALUE",
   "CONVERSATIONS",
-  "DERIVED_EVENTS"
+  "DERIVED_EVENTS",
+  // Added 2026-09-18 from Meta's own generated enum spec
+  // (facebook-business-sdk-codegen › AdSet_optimization_goal). Every one of these
+  // is a goal Meta accepts and Baker used to refuse at stage time — the messaging
+  // and Instagram-profile goals are the ones that cost real campaigns, because a
+  // click-to-WhatsApp ad set cannot be expressed without them.
+  "ADVERTISER_SILOED_VALUE",
+  "APP_INSTALLS_AND_OFFSITE_CONVERSIONS",
+  "AUTOMATIC_OBJECTIVE",
+  "ENGAGED_PAGE_VIEWS",
+  "IN_APP_VALUE",
+  "MEANINGFUL_CALL_ATTEMPT",
+  "MESSAGING_APPOINTMENT_CONVERSION",
+  "MESSAGING_DEEP_CONVERSATION_AND_FOLLOW",
+  "MESSAGING_PURCHASE_CONVERSION",
+  "PROFILE_AND_PAGE_ENGAGEMENT",
+  "PROFILE_VISIT",
+  "REMINDERS_SET",
+  "SUBSCRIBERS",
+  "VISIT_INSTAGRAM_PROFILE"
 ];
 var OPTIMIZATION_GOALS_REQUIRING_PAGE = [
   "LEAD_GENERATION",
@@ -21745,7 +21807,23 @@ var DESTINATION_TYPES = [
   "WHATSAPP",
   "PHONE_CALL",
   "INSTAGRAM_PROFILE",
-  "SHOP_AUTOMATIC"
+  "SHOP_AUTOMATIC",
+  // Added 2026-09-18 from adcampaign_destination_type. The four MESSAGING_* values
+  // are the click-to-message destinations (Messenger / Instagram Direct / WhatsApp
+  // in every combination Meta ships); without them Baker could not stage a
+  // click-to-WhatsApp ad set at all.
+  "APPLINKS_AUTOMATIC",
+  "FACEBOOK",
+  "FACEBOOK_LIVE",
+  "FACEBOOK_PAGE",
+  "IMAGINE",
+  "INSTAGRAM_LIVE",
+  "INSTAGRAM_PROFILE_AND_FACEBOOK_PAGE",
+  "MESSAGING_INSTAGRAM_DIRECT_MESSENGER",
+  "MESSAGING_INSTAGRAM_DIRECT_MESSENGER_WHATSAPP",
+  "MESSAGING_INSTAGRAM_DIRECT_WHATSAPP",
+  "MESSAGING_MESSENGER_WHATSAPP",
+  "ON_EVENT"
 ];
 var CUSTOM_EVENT_TYPES = [
   "PURCHASE",
@@ -21759,7 +21837,28 @@ var CUSTOM_EVENT_TYPES = [
   "SUBSCRIBE",
   "START_TRIAL",
   "CONTACT",
-  "OTHER"
+  "OTHER",
+  // Added 2026-09-18 from AdPromotedObject_custom_event_type. SCHEDULE,
+  // SUBMIT_APPLICATION, SERVICE_BOOKING_REQUEST and
+  // MESSAGING_CONVERSATION_STARTED_7D are the conversions service businesses and
+  // click-to-message campaigns actually optimize toward.
+  "ACHIEVEMENT_UNLOCKED",
+  "ADD_TO_WISHLIST",
+  "AD_IMPRESSION",
+  "CUSTOMIZE_PRODUCT",
+  "D2_RETENTION",
+  "D7_RETENTION",
+  "DONATE",
+  "FIND_LOCATION",
+  "LEVEL_ACHIEVED",
+  "LISTING_INTERACTION",
+  "MESSAGING_CONVERSATION_STARTED_7D",
+  "RATE",
+  "SCHEDULE",
+  "SERVICE_BOOKING_REQUEST",
+  "SPENT_CREDITS",
+  "SUBMIT_APPLICATION",
+  "TUTORIAL_COMPLETION"
 ];
 var ATTRIBUTION_EVENT_TYPES = ["CLICK_THROUGH", "VIEW_THROUGH", "ENGAGED_VIDEO_VIEW"];
 var ADVANTAGE_AUDIENCE_OPEN_AGE_MAX = 65;
@@ -21878,7 +21977,37 @@ var CTA_TYPES2 = [
   "LINK_CARD",
   "DIAL_CODE",
   "FIND_YOUR_GROUPS",
-  "START_ORDER"
+  "START_ORDER",
+  // Added 2026-09-18 from Meta's generated enum spec
+  // (AdCreative_call_to_action_type). Additive on purpose: 37 of the values above
+  // are absent from that spec and present in the live 400, which is the
+  // disagreement the note above is about — so the spec widens this list and never
+  // prunes it.
+  "AUDIO_CALL",
+  "BROWSE_SHOP",
+  "CONTACT",
+  "FIND_A_GROUP",
+  "FIND_OUT_MORE",
+  "FOLLOW_NEWS_STORYLINE",
+  "FOLLOW_PAGE",
+  "FOLLOW_USER",
+  "GET_DETAILS",
+  "GET_STARTED",
+  "SAY_THANKS",
+  "SEE_SHOP",
+  "SEND_A_GIFT",
+  "SEND_GIFT_MONEY",
+  "SHARE",
+  "SHOP_WITH_AI",
+  "SOTTO_SUBSCRIBE",
+  "TRY_ON_WITH_AI",
+  "VIDEO_ANNOTATION",
+  "VIDEO_CALL",
+  "VIEW_CART",
+  "VIEW_IN_CART",
+  "VISIT_PAGES_FEED",
+  "VISIT_WEBSITE",
+  "WOODHENGE_SUPPORT"
 ];
 var ASSET_FEED_CTA_TYPES = [
   "OPEN_LINK",
@@ -21997,6 +22126,11 @@ var ENROLL_STATUSES = ["OPT_IN", "OPT_OUT"];
 var STAGEABLE_CREATE_STATUSES4 = ["ACTIVE", "PAUSED"];
 var UPDATE_STATUSES = ["ACTIVE", "PAUSED", "ARCHIVED"];
 var CUSTOM_AUDIENCE_SUBTYPES = ["CUSTOM", "WEBSITE", "ENGAGEMENT", "LOOKALIKE"];
+var CUSTOMER_FILE_SOURCES = [
+  "USER_PROVIDED_ONLY",
+  "PARTNER_PROVIDED_ONLY",
+  "BOTH_USER_AND_PARTNER_PROVIDED"
+];
 var MEDIA_KINDS = ["image", "video"];
 var CURRENCY_MINIMUMS2 = {
   USD: { dailyBudgetMin: 1 },
@@ -22014,6 +22148,119 @@ import { z as z30 } from "zod";
 // ../api/src/ads-meta/placements.ts
 var FACEBOOK_POSITIONS_REQUIRING_FEED = ["marketplace", "search", "profile_feed", "notification"];
 var PLACEMENT_TARGETING_DOC = "https://developers.facebook.com/docs/marketing-api/audiences/reference/placement-targeting/";
+var PUBLISHER_PLATFORMS = ["facebook", "instagram", "threads", "messenger", "audience_network"];
+var FACEBOOK_POSITIONS = [
+  "feed",
+  "right_hand_column",
+  "marketplace",
+  "video_feeds",
+  "story",
+  "search",
+  "instream_video",
+  "facebook_reels",
+  "facebook_reels_overlay",
+  "profile_feed",
+  "notification"
+];
+var INSTAGRAM_POSITIONS = [
+  "stream",
+  "story",
+  "explore",
+  "explore_home",
+  "reels",
+  "profile_feed",
+  "ig_search",
+  "profile_reels"
+];
+var AUDIENCE_NETWORK_POSITIONS = ["classic", "rewarded_video"];
+var MESSENGER_POSITIONS = ["sponsored_messages", "story"];
+var THREADS_POSITIONS = ["threads_stream"];
+var DEVICE_PLATFORMS = ["mobile", "desktop", "connected_tv"];
+var PLACEMENT_VOCABULARIES = {
+  publisher_platforms: PUBLISHER_PLATFORMS,
+  facebook_positions: FACEBOOK_POSITIONS,
+  instagram_positions: INSTAGRAM_POSITIONS,
+  audience_network_positions: AUDIENCE_NETWORK_POSITIONS,
+  messenger_positions: MESSENGER_POSITIONS,
+  threads_positions: THREADS_POSITIONS,
+  device_platforms: DEVICE_PLATFORMS
+};
+var SAME_SURFACE_ON_THIS_PLATFORM = {
+  facebook_positions: { reels: "facebook_reels", stream: "feed", stories: "story", ig_search: "search" },
+  instagram_positions: {
+    feed: "stream",
+    facebook_reels: "reels",
+    stories: "story",
+    search: "ig_search"
+  }
+};
+function placementFieldsAccepting(value, except) {
+  return Object.keys(PLACEMENT_VOCABULARIES).filter(
+    (field) => field !== except && PLACEMENT_VOCABULARIES[field].includes(value)
+  );
+}
+function placementValueIssue(field, value) {
+  const renamed = SAME_SURFACE_ON_THIS_PLATFORM[field]?.[value];
+  if (renamed) {
+    return {
+      field,
+      value,
+      kind: "wrong-field",
+      fix: `Meta calls that surface "${renamed}" in ${field} \u2014 use "${renamed}"`
+    };
+  }
+  const elsewhere = placementFieldsAccepting(value, field);
+  if (elsewhere.length > 0) {
+    return {
+      field,
+      value,
+      kind: "wrong-field",
+      fix: `"${value}" belongs to ${elsewhere.join(" / ")}, not ${field} \u2014 move it there or drop it`
+    };
+  }
+  return {
+    field,
+    value,
+    kind: "unknown",
+    fix: `"${value}" is not a placement Baker knows; ${field} accepts ${PLACEMENT_VOCABULARIES[field].join(", ")}`
+  };
+}
+function invalidPlacementValues(targeting) {
+  const issues = [];
+  for (const field of Object.keys(PLACEMENT_VOCABULARIES)) {
+    const allowed = PLACEMENT_VOCABULARIES[field];
+    const selected = targeting?.[field] ?? [];
+    for (const value of selected) {
+      if (!allowed.includes(value)) {
+        issues.push(placementValueIssue(field, value));
+      }
+    }
+  }
+  return issues;
+}
+function placementCoRequirementIssues(targeting) {
+  const facebook = targeting?.facebook_positions ?? [];
+  const instagram = targeting?.instagram_positions ?? [];
+  const threads = targeting?.threads_positions ?? [];
+  const devices = targeting?.device_platforms;
+  const issues = [];
+  if (facebook.includes("story")) {
+    if (!facebook.includes("feed") && !instagram.includes("story")) {
+      issues.push(
+        'Meta refuses Facebook "story" on its own \u2014 select "feed" in facebook_positions or "story" in instagram_positions alongside it'
+      );
+    }
+    if (devices && !devices.includes("mobile")) {
+      issues.push(
+        'Facebook "story" only runs on mobile \u2014 add "mobile" to device_platforms or drop the story placement'
+      );
+    }
+  }
+  if (threads.includes("threads_stream") && !instagram.includes("stream")) {
+    issues.push('Threads "threads_stream" cannot be selected alone \u2014 add "stream" to instagram_positions');
+  }
+  return issues;
+}
 var CONSTRAINED_PLACEMENTS = [
   {
     position: "facebook_reels_overlay",
@@ -22128,6 +22375,7 @@ var metaTargetingSchema = z30.object({
   instagram_positions: z30.array(z30.string()).optional(),
   audience_network_positions: z30.array(z30.string()).optional(),
   messenger_positions: z30.array(z30.string()).optional(),
+  threads_positions: z30.array(z30.string()).optional(),
   device_platforms: z30.array(z30.string()).optional(),
   targeting_automation: z30.object({ advantage_audience: z30.union([z30.literal(0), z30.literal(1)]) }).partial().optional()
 }).catchall(z30.unknown());
@@ -22259,6 +22507,13 @@ var adSetFields = {
   start_time: z30.number().int().positive().optional(),
   end_time: z30.number().int().positive().optional(),
   targeting: metaTargetingSchema,
+  /**
+   * The live ad set this one was copied from, verbatim, by `duplicate`. Baker
+   * only — `adSetCommonBody` never sends it to Meta. Set exclusively when the
+   * targeting IS the source's targeting, because that is what it licenses:
+   * placement validation is skipped for it (see `validateAdSetPlacements`).
+   */
+  clonedFrom: z30.string().regex(NUMERIC_ID_REGEX3).optional(),
   /** EU Digital Services Act: who benefits from / pays for the ad. Auto-filled from the account for EU geo when omitted. */
   dsa_beneficiary: z30.string().min(1).max(100).optional(),
   dsa_payor: z30.string().min(1).max(100).optional()
@@ -22359,6 +22614,9 @@ function validateAdvantageAudience(p, ctx) {
   }
 }
 function validateAdSetPlacements(p, ctx) {
+  if (p.clonedFrom) {
+    return;
+  }
   const missingFeed = positionsMissingRequiredFeed(p.targeting);
   if (missingFeed.length > 0) {
     ctx.addIssue({
@@ -22367,6 +22625,19 @@ function validateAdSetPlacements(p, ctx) {
       message: `Meta requires "feed" alongside ${missingFeed.join(", ")} \u2014 add "feed" to facebook_positions or drop those positions (${PLACEMENT_TARGETING_DOC})`
     });
   }
+  for (const issue of invalidPlacementValues(p.targeting)) {
+    if (issue.kind !== "wrong-field") {
+      continue;
+    }
+    ctx.addIssue({
+      code: "custom",
+      path: ["targeting", issue.field],
+      message: `${issue.field} does not accept "${issue.value}". ${issue.fix} (${PLACEMENT_TARGETING_DOC})`
+    });
+  }
+  for (const message of placementCoRequirementIssues(p.targeting)) {
+    ctx.addIssue({ code: "custom", path: ["targeting"], message: `${message} (${PLACEMENT_TARGETING_DOC})` });
+  }
 }
 var adSetCreateSchema = z30.object(adSetFields).superRefine((p, ctx) => {
   validateAdSetBudgetAndBid(p, ctx);
@@ -22683,7 +22954,7 @@ var customAudienceCreateSchema = z30.object({
   name: z30.string().min(1).max(META_LIMITS.audience.nameMax),
   subtype: z30.enum(CUSTOM_AUDIENCE_SUBTYPES),
   description: z30.string().max(500).optional(),
-  customer_file_source: z30.string().optional(),
+  customer_file_source: z30.enum(CUSTOMER_FILE_SOURCES).optional(),
   retention_days: z30.number().int().min(1).max(META_LIMITS.audience.retentionDaysMax).optional(),
   lookalike_spec: lookalikeSpecSchema.optional(),
   /** Website/engagement rule — structural passthrough validated by Meta. */
@@ -57359,7 +57630,7 @@ registerSchema({
     },
     sort: {
       type: "string",
-      description: "Sort: relevance, search_volume, competition, cpc (default: search_volume)",
+      description: "Sort: search_volume, competition, cpc (default: search_volume)",
       required: false
     },
     type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
@@ -57388,7 +57659,7 @@ Examples:
     target: { type: "positional", description: "Domain or URL to analyze", required: true },
     location: { type: "string", description: "Country code or location code (default: us)", required: false },
     language: { type: "string", description: "Language code or name (default: en)", required: false },
-    sort: { type: "string", description: "Sort: relevance, search_volume, competition, cpc", required: false },
+    sort: { type: "string", description: "Sort: search_volume, competition, cpc", required: false },
     type: { type: "string", description: "Filter: paid, organic, all (default: all)", required: false },
     limit: { type: "string", description: "Max results (default: 50, max: 1000)", required: false },
     output: { type: "string", description: "Format: json|csv|md|jsonl", required: false, default: "json" },