@koda-sl/baker-cli 0.139.0 → 0.140.1

package/README.md

@@ -672,6 +672,7 @@ baker ads meta campaigns create   --account-id act_123 --name "Q3 Prospecting" -
 baker ads meta adsets create      --account-id act_123 --campaign meta_temp_camp --name "US 25-54" \
   --optimization-goal OFFSITE_CONVERSIONS --billing-event IMPRESSIONS --pixel-id 111 --custom-event-type LEAD \
   --targeting-file targeting.json   # → meta_temp_as
+# lead-form goals (LEAD_GENERATION / QUALITY_LEAD) and PAGE_LIKES require --page-id (the Facebook Page), else Meta rejects the ad set
 baker ads meta creatives create   --account-id act_123 --page 555 --instagram-user 777 \
   --message "Save money on pet insurance" --link https://example.com --headline "Best cover" \
   --image-ref meta_temp_img --cta SHOP_NOW --standard-enhancements on   # → meta_temp_cr

package/dist/cli.js

@@ -73,7 +73,7 @@ import {
 } from "./chunk-RK67WL4O.js";
 
 // src/cli.ts
-import { defineCommand as defineCommand174, runMain } from "citty";
+import { defineCommand as defineCommand175, runMain } from "citty";
 
 // src/commands/actions/index.ts
 import { defineCommand as defineCommand18 } from "citty";
@@ -1008,6 +1008,33 @@ var followResponseSchema = z2.object({
   preview: resolvePreviewSchema.nullable(),
   candidates: z2.array(corpusAdvertiserSchema).nullable()
 });
+var FOLLOW_BATCH_MAX = 50;
+var followBatchRequestSchema = z2.object({
+  // One entry per brand — a domain (best; resolves both Meta + LinkedIn), a
+  // profile / ad-library URL, or a brand name.
+  inputs: z2.array(z2.string().min(1)).min(1).max(FOLLOW_BATCH_MAX),
+  // How to read every input (not a tracking limit — a domain still resolves
+  // every platform we can). Defaults to reading inputs as Meta identities.
+  platform: adLibraryPlatformSchema.default("meta")
+});
+var followBatchResultSchema = z2.object({
+  // Echoes the input so the caller can line results up with what it sent.
+  input: z2.string(),
+  // "following"/"added" mirror the single-follow statuses; "ambiguous" needs a
+  // manual pick; "failed" = we couldn't resolve or add it (see `error`).
+  status: z2.enum(["following", "added", "ambiguous", "failed"]),
+  advertiser: followedAdvertiserSchema.nullable(),
+  // Present only when status is "failed" — a plain-language reason.
+  error: z2.string().nullable()
+});
+var followBatchResponseSchema = z2.object({
+  results: z2.array(followBatchResultSchema),
+  // Rollup counts across the batch for a one-glance summary.
+  followed_count: z2.number(),
+  added_count: z2.number(),
+  ambiguous_count: z2.number(),
+  failed_count: z2.number()
+});
 var unfollowRequestSchema = z2.object({
   // Accept either the Baker subscription id or the corpus advertiser id.
   followed_id: z2.string().optional(),
@@ -11365,6 +11392,11 @@ var OPTIMIZATION_GOALS = [
   "CONVERSATIONS",
   "DERIVED_EVENTS"
 ];
+var OPTIMIZATION_GOALS_REQUIRING_PAGE = [
+  "LEAD_GENERATION",
+  "QUALITY_LEAD",
+  "PAGE_LIKES"
+];
 var DESTINATION_TYPES = [
   "WEBSITE",
   "APP",
@@ -11582,8 +11614,18 @@ function validateAdSetBudgetAndBid(p, ctx) {
     ctx.addIssue({ code: "custom", path: ["end_time"], message: "end_time must be after start_time" });
   }
 }
+function validateAdSetPromotedObject(p, ctx) {
+  if (p.optimization_goal && OPTIMIZATION_GOALS_REQUIRING_PAGE.includes(p.optimization_goal) && !p.promoted_object?.page_id) {
+    ctx.addIssue({
+      code: "custom",
+      path: ["promoted_object", "page_id"],
+      message: `optimization_goal ${p.optimization_goal} needs promoted_object.page_id \u2014 pass --page-id with the Facebook Page the leads/likes belong to`
+    });
+  }
+}
 var adSetCreateSchema = z14.object(adSetFields).superRefine((p, ctx) => {
   validateAdSetBudgetAndBid(p, ctx);
+  validateAdSetPromotedObject(p, ctx);
 });
 var adSetUpdateSchema = z14.object({
   name: adSetFields.name.optional(),
@@ -11604,6 +11646,9 @@ var adSetUpdateSchema = z14.object({
     ctx.addIssue({ code: "custom", message: "update needs at least one field" });
   }
   validateAdSetBudgetAndBid(p, ctx);
+  if (p.optimization_goal) {
+    validateAdSetPromotedObject(p, ctx);
+  }
 });
 var messageSchema = z14.string().min(1).max(META_LIMITS.creative.messageHardMax);
 var headlineSchema2 = z14.string().min(1).max(META_LIMITS.creative.headlineMax);
@@ -12191,7 +12236,10 @@ var adSetWriteArgs = {
   end: { type: "string", description: "End time" },
   "targeting-file": { type: "string", description: "JSON file with the full Meta targeting spec" },
   "promoted-object-file": { type: "string", description: "JSON file with the promoted_object" },
-  "page-id": { type: "string", description: "promoted_object.page_id shortcut" },
+  "page-id": {
+    type: "string",
+    description: "promoted_object.page_id shortcut (required for LEAD_GENERATION / QUALITY_LEAD / PAGE_LIKES goals)"
+  },
   "pixel-id": { type: "string", description: "promoted_object.pixel_id shortcut" },
   "custom-event-type": { type: "string", description: "promoted_object.custom_event_type (PURCHASE|LEAD|\u2026)" },
   file: { type: "string", description: "JSON file with the full payload; flags override" }
@@ -12201,6 +12249,7 @@ var adSetsCreateCommand = defineCommand54({
     name: "create",
     description: `Stage a new ad set. ${STAGED_NOTE2}
 Chain to a campaign with --campaign (real id or meta_temp_* ref).
+Lead-form goals (LEAD_GENERATION, QUALITY_LEAD) and PAGE_LIKES need --page-id (the Facebook Page the leads/likes belong to).
 Example: baker ads meta adsets create --campaign meta_temp_ab12 --name "US 25-54" --optimization-goal LINK_CLICKS --billing-event IMPRESSIONS --daily-budget 50 --targeting-file t.json`
   },
   args: { campaign: { type: "string", description: "Parent campaign id or meta_temp_* ref" }, ...adSetWriteArgs },
@@ -12214,6 +12263,7 @@ var adSetsUpdateCommand = defineCommand54({
   meta: {
     name: "update",
     description: `Stage changes to an ad set. ${STAGED_NOTE2}
+Switching --optimization-goal to a lead-form goal (LEAD_GENERATION, QUALITY_LEAD) or PAGE_LIKES needs --page-id in the same change.
 Example: baker ads meta adsets update 6123 --daily-budget 80`
   },
   args: { id: { type: "positional", description: "Ad set id or meta_temp_* ref", required: true }, ...adSetWriteArgs },
@@ -27994,7 +28044,7 @@ Examples:
 });
 
 // src/commands/winning-ads/index.ts
-import { defineCommand as defineCommand173 } from "citty";
+import { defineCommand as defineCommand174 } from "citty";
 
 // src/commands/winning-ads/advertisers.ts
 import { defineCommand as defineCommand163 } from "citty";
@@ -28388,8 +28438,116 @@ var followCommand = defineCommand166({
   }
 });
 
-// src/commands/winning-ads/following.ts
+// src/commands/winning-ads/follow-competitors.ts
 import { defineCommand as defineCommand167 } from "citty";
+var PLATFORMS2 = ["meta", "linkedin"];
+var BATCH_TIMEOUT_MS = 3e5;
+function buildFollowBatchBody(input) {
+  const seen = /* @__PURE__ */ new Set();
+  const inputs = [];
+  for (const domain of splitList(input.domains)) {
+    const key = domain.toLowerCase();
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    inputs.push(domain);
+  }
+  return { inputs, platform: input.platform ?? "meta" };
+}
+registerSchema({
+  command: "winning-ads.follow-competitors",
+  description: "Follow MANY brands at once \u2014 the fast way to add every competitor to your library. Pass a comma-separated list of domains (best \u2014 each resolves both Meta + LinkedIn, every country). One brand failing never blocks the others: the response reports per-brand status (following/added/ambiguous/failed) plus rollup counts. Ideal right after a competitor scan.",
+  args: {
+    domains: {
+      type: "string",
+      description: `Comma-separated domains (best), profile/ad-library URLs, or brand names \u2014 up to ${FOLLOW_BATCH_MAX}. e.g. "deel.com,notion.so,hubspot.com"`,
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: "meta|linkedin \u2014 how to read each input, not a tracking limit (default meta). Domains resolve both.",
+      required: false,
+      default: "meta"
+    }
+  }
+});
+var followCompetitorsCommand = defineCommand167({
+  meta: {
+    name: "follow-competitors",
+    description: 'Follow many brands at once by domain \u2014 add every competitor in one call. Example: baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"'
+  },
+  args: {
+    domains: {
+      type: "positional",
+      description: "Comma-separated domains (best), URLs, or brand names",
+      required: true
+    },
+    platform: {
+      type: "string",
+      description: "meta|linkedin \u2014 how to read each input, not a tracking limit (default meta).",
+      required: false,
+      default: "meta"
+    }
+  },
+  run: async ({ args }) => {
+    try {
+      const platform = String(args.platform ?? "meta");
+      if (!PLATFORMS2.includes(platform)) {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "--platform must be one of: meta, linkedin" }
+        });
+        process.exit(1);
+      }
+      const body = buildFollowBatchBody({ domains: String(args.domains ?? ""), platform });
+      if (body.inputs.length === 0) {
+        writeJson({
+          ok: false,
+          error: { code: "VALIDATION_ERROR", message: "Pass at least one domain in --domains." }
+        });
+        process.exit(1);
+      }
+      if (body.inputs.length > FOLLOW_BATCH_MAX) {
+        writeJson({
+          ok: false,
+          error: {
+            code: "VALIDATION_ERROR",
+            message: `Too many brands (${body.inputs.length}). Follow at most ${FOLLOW_BATCH_MAX} per call.`
+          }
+        });
+        process.exit(1);
+      }
+      const data = await apiPost("/api/ad-library/follow-batch", body, {
+        timeoutMs: BATCH_TIMEOUT_MS
+      });
+      const hints = [];
+      if (data.failed_count > 0) {
+        const failed = data.results.filter((r) => r.status === "failed").map((r) => r.input);
+        hints.push(
+          `${data.failed_count} brand(s) couldn't be added: ${failed.join(", ")}. Retry each with its website or Facebook/LinkedIn URL via \`baker winning-ads follow\`.`
+        );
+      }
+      if (data.ambiguous_count > 0) {
+        const ambiguous = data.results.filter((r) => r.status === "ambiguous").map((r) => r.input);
+        hints.push(
+          `${data.ambiguous_count} brand(s) matched multiple advertisers: ${ambiguous.join(", ")}. Re-run \`baker winning-ads follow\` with an exact domain/URL to pick one.`
+        );
+      }
+      if (data.added_count > 0) {
+        hints.push(
+          "Newly added brands are ingesting now \u2014 their winners fill in over the next few minutes. Check `baker winning-ads following` or `baker winning-ads feed`."
+        );
+      }
+      writeJson({ ok: true, data, hints: hints.length > 0 ? hints : void 0 });
+    } catch (err) {
+      reportError(err);
+    }
+  }
+});
+
+// src/commands/winning-ads/following.ts
+import { defineCommand as defineCommand168 } from "citty";
 registerSchema({
   command: "winning-ads.following",
   description: "List the brands you follow in your ad-dna library, with each one's status (ready vs still adding) and cached ad counts.",
@@ -28422,7 +28580,7 @@ function followingNormalizer(record, full) {
     platforms: Array.isArray(record.platforms) ? record.platforms : []
   };
 }
-var followingCommand = defineCommand167({
+var followingCommand = defineCommand168({
   meta: {
     name: "following",
     description: "List brands you follow, with status (ready / adding\u2026) and cached counts. Example: baker winning-ads following --output md"
@@ -28457,7 +28615,7 @@ var followingCommand = defineCommand167({
 });
 
 // src/commands/winning-ads/patterns.ts
-import { defineCommand as defineCommand168 } from "citty";
+import { defineCommand as defineCommand169 } from "citty";
 registerSchema({
   command: "winning-ads.patterns",
   description: "Mine what separates two cohorts of ads: pass a comma-list of winning ad ids (--winners) and a comma-list of weaker ad ids (--duds). Returns the discriminating DNA fields.",
@@ -28496,7 +28654,7 @@ function discriminatorRow(record) {
     top_values_duds: Array.isArray(record.top_values_b) ? record.top_values_b.join(", ") : ""
   };
 }
-var patternsCommand = defineCommand168({
+var patternsCommand = defineCommand169({
   meta: {
     name: "patterns",
     description: "Discover what separates winning ads from weak ones. Example: baker winning-ads patterns --winners a_1,a_2,a_3 --duds a_9,a_8 --output md"
@@ -28552,7 +28710,7 @@ var patternsCommand = defineCommand168({
 });
 
 // src/commands/winning-ads/search.ts
-import { defineCommand as defineCommand169 } from "citty";
+import { defineCommand as defineCommand170 } from "citty";
 registerSchema({
   command: "winning-ads.search",
   description: "Search the ad-dna corpus of scored winning ads. Returns a lean shortlist (advertiser, summary, scores, media_url) to pick a reference to reproduce.",
@@ -28660,7 +28818,7 @@ function buildSearchBody(args) {
   }
   return body;
 }
-var searchCommand4 = defineCommand169({
+var searchCommand4 = defineCommand170({
   meta: {
     name: "search",
     description: "Search winning reference ads. Example: baker winning-ads search 'B2B SaaS before/after AI automation' --platform meta --format static --winner-category winner --exclude-advertiser adv_123 --output md"
@@ -28775,7 +28933,7 @@ var searchCommand4 = defineCommand169({
 });
 
 // src/commands/winning-ads/seeds.ts
-import { defineCommand as defineCommand170 } from "citty";
+import { defineCommand as defineCommand171 } from "citty";
 function leanRow(r) {
   return {
     key: r.key,
@@ -28803,7 +28961,7 @@ function makeSeedCommand(opts) {
       limit: { type: "number", description: "Max keys 1-100 (default 20)", required: false, default: 20 }
     }
   });
-  return defineCommand170({
+  return defineCommand171({
     meta: { name: opts.name, description: opts.description },
     args: {
       platform: { type: "string", description: "Single platform to segment on", required: false },
@@ -28852,7 +29010,7 @@ var formatsCommand = makeSeedCommand({
 });
 
 // src/commands/winning-ads/unfollow.ts
-import { defineCommand as defineCommand171 } from "citty";
+import { defineCommand as defineCommand172 } from "citty";
 registerSchema({
   command: "winning-ads.unfollow",
   description: "Stop following a brand \u2014 removes it from your ad-dna library by advertiser id.",
@@ -28860,7 +29018,7 @@ registerSchema({
     advertiser: { type: "string", description: "Advertiser id to unfollow", required: true }
   }
 });
-var unfollowCommand = defineCommand171({
+var unfollowCommand = defineCommand172({
   meta: {
     name: "unfollow",
     description: "Stop following a brand by advertiser id. Example: baker winning-ads unfollow adv_123"
@@ -28881,7 +29039,7 @@ var unfollowCommand = defineCommand171({
 });
 
 // src/commands/winning-ads/winners.ts
-import { defineCommand as defineCommand172 } from "citty";
+import { defineCommand as defineCommand173 } from "citty";
 registerSchema({
   command: "winning-ads.winners",
   description: "Top winning ads for one advertiser id (from `advertisers` or `following`). Returns lean winner cards; add --full for DNA + longevity.",
@@ -28891,7 +29049,7 @@ registerSchema({
     platform: { type: "string", description: "Filter to a single platform: meta|linkedin", required: false }
   }
 });
-var winnersCommand = defineCommand172({
+var winnersCommand = defineCommand173({
   meta: {
     name: "winners",
     description: "Top winning ads for a specific advertiser id. Example: baker winning-ads winners adv_123 --top 15 --output md"
@@ -28941,7 +29099,7 @@ var winnersCommand = defineCommand172({
 });
 
 // src/commands/winning-ads/index.ts
-var winningAdsCommand = defineCommand173({
+var winningAdsCommand = defineCommand174({
   meta: {
     name: "winning-ads",
     description: `Search the ad-dna corpus of scored "winning" ads for reference creatives to reproduce, and manage the brands your library tracks. Proxied through the Baker backend (BAKER_API_KEY) \u2014 no separate token needed.
@@ -28952,6 +29110,7 @@ Subcommands:
   baker winning-ads search "<free text>"      \u2014 semantic search across the corpus; lean shortlist (advertiser, summary, scores, media_url)
   baker winning-ads advertisers "<brand>"     \u2014 list corpus brands \u2192 advertiser ids (for --exclude-advertiser / --advertiser-id)
   baker winning-ads follow "<domain|url|brand>" --platform meta|linkedin   \u2014 add a brand's ads to your library
+  baker winning-ads follow-competitors "<domain,domain,...>"   \u2014 add MANY brands at once (every competitor by domain)
   baker winning-ads following                 \u2014 list brands you follow (status + counts)
   baker winning-ads feed                      \u2014 winners across EVERY brand you follow; trim with --advertiser
   baker winning-ads winners <advertiser>      \u2014 top winners for one advertiser id
@@ -28966,6 +29125,7 @@ Examples:
   baker winning-ads search "B2B SaaS before/after AI automation" --platform meta --format static --output md
   baker winning-ads advertisers "Acme" --output md
   baker winning-ads follow "deel.com" --platform meta
+  baker winning-ads follow-competitors "deel.com,notion.so,hubspot.com"
   baker winning-ads feed --per-advertiser 5 --output md
   baker winning-ads feed --advertiser adv_123,adv_456 --platform meta --output md
   baker winning-ads winners adv_123 --top 15 --output md
@@ -28977,6 +29137,7 @@ Examples:
     search: searchCommand4,
     advertisers: advertisersCommand2,
     follow: followCommand,
+    "follow-competitors": followCompetitorsCommand,
     following: followingCommand,
     feed: feedCommand,
     winners: winnersCommand,
@@ -29006,7 +29167,7 @@ function getCliVersion() {
 }
 
 // src/cli.ts
-var main = defineCommand174({
+var main = defineCommand175({
   meta: {
     name: "baker",
     version: getCliVersion(),